@joinbankroll/sdk

Typed client for Build on Bankroll apps — a thin wrapper over the window.bankroll bridge the Bankroll app injects, plus server-side verification of the Bankroll session token.

npm install @joinbankroll/sdk

import { bankroll } from '@joinbankroll/sdk'

bankroll.status()                    // 'unavailable' | 'update_required' | 'ready' — sync, SSR-safe
await bankroll.session()             // the session token, scoped to your origin
await bankroll.session({ identity: true }) // ...resolving only for a verified real person
await bankroll.pay({ amountCents: 500 })   // charge $5.00 to your payment address

import { verifyToken } from '@joinbankroll/sdk/server'

const session = await verifyToken(token, { audience: 'https://yourapp.example' })
if (!session) return unauthorized()
// session.user.wallet — the user's stable id, and payout target

📚 Read the docs →

Everything lives there and stays current: Quickstart · The session token · The manifest · Payments · Paying a user

Package

Two entry points, so server-only code never reaches the browser:

• @joinbankroll/sdk — browser client. Zero dependencies, SSR-safe.
• @joinbankroll/sdk/server — token verification. Node ≥ 20, uses jose. Never imports the client.

ESM only. Types are bundled.

License

MIT