@babbage/go

A production-minded BRC-100 WalletInterface wrapper that keeps onboarding, error handling, and funding flows conversion-focused. Babbage Go now ships with an opinionated emotional design system so Metanet apps can feel branded from the very first modal.

Quick start

npm i @bsv/sdk @babbage/go

import BabbageGo from '@babbage/go'

const wallet = new BabbageGo()
await wallet.createAction({
  description: 'Launchpad mint',
  outputs: [{
    satoshis: 1,
    script: '016a',
    outputDescription: 'Generic Token'
  }]
})

Pulse Bloom design system

Our new Pulse Bloom system gives every interaction an immediate tone without forcing you to hand-roll CSS. It blends glassy layers, tactile buttons, and emotional color grading while remaining fully overridable.

| preset | vibe | When to use | | --- | --- | --- | | auroraPulse (default) | cool neon optimism | consumer onboarding, read receipts, progressive disclosure | | emberLagoon | warm ritualized concierge | premium drops, tips, funding prompts | | midnightHalo | crisp editorial minimalism | enterprise dashboards, light-mode sites |

Custom controls

• Token overrides for every color, shadow, font, and card radius (design.tokens).
• Button geometry via buttonShape: 'pill' | 'soft' | 'sharp'.
• Drop-in brand CSS with design.customCss (legacy styles still works and is merged automatically).
• Modal copy for wallet-unavailable + funding flows remains configurable via their respective option blocks.

Wallet unavailable handoff

When a wallet is missing, the default CTA now points to https://getmetanet.com/open. Babbage Go includes the current page URL, app host, page title, and source=babbage-go so GetMetanet can show a welcoming handoff and open the exact page in Metanet Explorer when it is installed.

Existing walletUnavailable.ctaHref overrides still work. The library appends handoff parameters with URLSearchParams, preserving any existing query string. On Android, the CTA still uses an app intent first and falls back to the web handoff when Metanet Explorer is not installed.

Examples

1. Aurora Pulse onboarding

const wallet = new BabbageGo(undefined, {
  showModal: true,
  design: {
    preset: 'auroraPulse',
  },
})

2. Ember Lagoon funding concierge

const wallet = new BabbageGo(undefined, {
  design: { preset: 'emberLagoon' },
  funding: {
    title: 'Need a quick top up?',
    introText: 'Add a little fuel then smash retry — we will hold your action in place.',
    postPurchaseText: 'Sats topped? Hit retry and we will complete everything instantly.',
    buySatsText: 'Buy sats fast',
    retryText: 'Retry the action',
    cancelText: 'Cancel for now',
    buySatsUrl: 'https://satoshis.babbage.systems',
  },
})

3. brand-tuned tokens & custom css

const wallet = new babbagego(undefined, {
  design: {
    preset: 'midnighthalo',
    tokens: {
      accentbackground: 'linear-gradient(135deg, #ff6fdb, #855cff)',
      accenttext: '#080814',
      accenthoverbackground: '#ffe8f9',
      accenthovertext: '#320845',
      buttonshape: 'pill',
      cardradius: '32px',
    },
    customcss: `
      .bgo-card {
        border-width: 2px;
        animation: bgo-fade 320ms ease;
      }
      @keyframes bgo-fade {
        from { transform: translatey(12px); opacity: 0; }
        to { transform: translatey(0); opacity: 1; }
      }
    `,
  },
})

4. Babbage todo-ts Application With SatoshiShopClient Funding Integration

const wallet = new babbagego(undefined, {
  monetization: {
    developerIdentity: '02a0647.....1149ea1291d1a73783d1b7b3a7a220',
    developerFeeSats: 300
  },
  funding: {
    title: 'More Satoshis Needed',
    introText: 'Satoshis are needed perform this action, or you can cancel it.',
    buySatsText: 'Buy Satoshis',
    source: 'satoshiShopClient'
  }
})

License

Open BSV © 2025 P2PPSR