{"id":51222362,"url":"https://github.com/tempoxyz/bridgerton","last_synced_at":"2026-06-28T08:03:50.795Z","repository":{"id":347445556,"uuid":"1191056006","full_name":"tempoxyz/bridgerton","owner":"tempoxyz","description":"CLI and MCP server for Bridge.xyz stablecoin infrastructure","archived":false,"fork":false,"pushed_at":"2026-06-06T06:06:46.000Z","size":142,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-06T07:14:54.128Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/bridgerton","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tempoxyz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-24T21:59:29.000Z","updated_at":"2026-06-06T06:00:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"97c82d8d-23ca-4b7a-9496-e740da315afd","html_url":"https://github.com/tempoxyz/bridgerton","commit_stats":null,"previous_names":["struong/bridgerton","tempoxyz/bridgerton"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/tempoxyz/bridgerton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tempoxyz%2Fbridgerton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tempoxyz%2Fbridgerton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tempoxyz%2Fbridgerton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tempoxyz%2Fbridgerton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tempoxyz","download_url":"https://codeload.github.com/tempoxyz/bridgerton/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tempoxyz%2Fbridgerton/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34881389,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-28T08:03:50.154Z","updated_at":"2026-06-28T08:03:50.786Z","avatar_url":"https://github.com/tempoxyz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bridgerton\n\nCLI and MCP server for [Bridge.xyz](https://www.bridge.xyz) stablecoin infrastructure.\n\n## Install\n\n```bash\nnpm install -g bridgerton\n```\n\nOr run directly:\n\n```bash\nnpx bridgerton --help\n```\n\n## Setup\n\nOn first run with no arguments, bridgerton prompts for your API key interactively. Or configure it explicitly:\n\n```bash\nbridgerton configure api-key sk-test-...\n```\n\nYou can also set it via environment variable:\n\n```bash\nexport BRIDGE_API_KEY=sk-test-...\n```\n\nEnvironment is auto-detected from the key prefix — `sk-test-*` routes to sandbox, `sk-live-*` to production.\n\nStripe Issuing commands use a Stripe secret key from `STRIPE_SECRET_KEY`, then `STRIPE_API_KEY`, then the saved config:\n\n```bash\nbridgerton configure stripe-api-key sk_live_...\n```\n\n## Usage\n\n```bash\n# check exchange rates\nbridgerton rates --from usd --to usdc\n\n# list customers\nbridgerton customers list\n\n# create a customer\nbridgerton customers create -f John -l Doe -e john@example.com\n\n# create a wallet on tempo\nbridgerton wallets create \u003ccustomer-id\u003e --chain tempo\n\n# create a liquidation address\nbridgerton liquidation create \u003ccustomer-id\u003e \\\n  --chain tempo --currency usdc \\\n  --destination-address 0x...\n\n# create a transfer\nbridgerton transfers create \\\n  --on-behalf-of \u003ccustomer-id\u003e \\\n  --source-rail bridge_wallet --source-currency usdc \\\n  --dest-rail tempo --dest-currency usdc \\\n  --dest-address 0x...\n\n# create a transfer to another Bridge wallet\nbridgerton transfers create \\\n  --on-behalf-of \u003ccustomer-id\u003e \\\n  --source-rail bridge_wallet --source-currency usdc \\\n  --source-wallet-id \u003csource-wallet-id\u003e \\\n  --dest-rail tempo --dest-currency usdc \\\n  --dest-wallet-id \u003cdestination-wallet-id\u003e \\\n  --amount 1.50\n\n# set default output format\nbridgerton configure format json\n\n# save a Stripe API key for Issuing commands\nbridgerton configure stripe-api-key sk_live_...\n\n# see \"Tempo Wallet-Backed Cards\" below for the full Bridge + Stripe flow\n```\n\n## Tempo Wallet-Backed Cards\n\nFor Bridge-managed consumer cardholders, Bridge owns onboarding, ToS, KYC, endorsements, and the link to the Stripe Issuing cardholder. Stripe owns new Tempo wallet-backed card issuance after Bridge returns a `stripe_cardholder_id`.\n\nStart with Bridge and wait for the customer to complete hosted ToS and KYC:\n\n```bash\nbridgerton customers create -f John -l Doe -e john@example.com\n\nbridgerton customers tos-acceptance-link \u003ccustomer-id\u003e\nbridgerton customers kyc-link \u003ccustomer-id\u003e --endorsement cards\n\nbridgerton customers get \u003ccustomer-id\u003e\n```\n\nSend the hosted ToS and KYC links to the customer, then poll `customers get` until ToS/KYC are approved, the `cards` endorsement is approved, and the customer includes a `stripe_cardholder_id`.\n\nThen create the Tempo wallet-backed Stripe card:\n\n```bash\nbridgerton cards create \\\n  --cardholder \u003cstripe-cardholder-id\u003e \\\n  --wallet-address \u003ctempo-wallet-address\u003e \\\n  --idempotency-key tempo-cards-\u003cbridge-customer-id\u003e \\\n  --bridge-customer-id \u003cbridge-customer-id\u003e\n```\n\nBridge's deprecated Cards API operation is card account provisioning (`POST /customers/{customerID}/card_accounts`). New stablecoin card issuance and management for Tempo wallet-backed cards lives under `bridgerton cards`. Existing Bridge card-account utility endpoints such as list, get, update, freeze, unfreeze, transactions, authorizations, withdrawals, PIN update URL, ephemeral keys, card-account statements, card designs, and program summary remain available under `bridgerton bridge-cards`.\n\nFor non-custodial Tempo wallets, approve Bridge's issuer contract before testing live spend:\n\n```bash\ntempo wallet whoami --json-output\n\nexport TEMPO_ROOT_ACCOUNT=0x...\nexport USDC_E=0x20c000000000000000000000b9537d11c60e8b50\nexport ISSUER=0x3e8f24b686aa8c036038f7d557b70e6ce0e7b56b\n\ncast erc20-token approve \"$USDC_E\" \"$ISSUER\" \u003callowance-base-units\u003e \\\n  --rpc-url https://rpc.tempo.xyz \\\n  --chain 4217 \\\n  --from \"$TEMPO_ROOT_ACCOUNT\" \\\n  --browser\n\ncast call \"$USDC_E\" \"allowance(address,address)(uint256)\" \"$TEMPO_ROOT_ACCOUNT\" \"$ISSUER\" \\\n  --rpc-url https://rpc.tempo.xyz\n```\n\nUse the Tempo wallet signer for approval. Do not store Tempo access keys in Bridgerton config.\n\nCard statements include sensitive financial data and must be written to a file:\n\n```bash\nbridgerton cards statements create \\\n  --cardholder \u003cstripe-cardholder-id\u003e \\\n  --card \u003cstripe-card-id\u003e \\\n  --period 202605 \\\n  --output statement-202605.pdf\n```\n\nCard issuance smoke test checklist:\n\n1. Retrieve the cardholder with `bridgerton cards cardholders get \u003cstripe-cardholder-id\u003e`.\n2. Create the card with a stable `--idempotency-key`, then rerun the same command and confirm the same card is returned.\n3. Retrieve the card with `bridgerton cards get \u003ccard-id\u003e` and confirm `type=virtual`, `status=active`, `currency=usd`, and the Tempo wallet metadata.\n4. Run a small live authorization, then check Stripe Issuing activity and the wallet allowance/balance on Tempo.\n\n## Commands\n\n| Group | Commands |\n|---|---|\n| `customers` | `create`, `get`, `list`, `update`, `delete`, `tos-link`, `kyc-link`, `tos-acceptance-link`, `transfers` |\n| `wallets` | `create`, `get`, `list`, `list-all`, `total-balances`, `history` |\n| `transfers` | `create`, `get`, `list` |\n| `liquidation` | `create`, `get`, `list`, `update`, `drains`, `all-drains` |\n| `external-accounts` | `create`, `get`, `list`, `delete` |\n| `virtual-accounts` | `create`, `get`, `list`, `list-all`, `update`, `deactivate`, `reactivate`, `activity`, `all-activity` |\n| `prefunded-accounts` | `list`, `get`, `history` |\n| `cards` | `create`, `list`, `get`, `update`, `freeze`, `unfreeze`, `cancel`, `cardholders list`, `cardholders get`, `transactions list`, `transactions get`, `authorizations list`, `authorizations get`, `statements create` |\n| `bridge-cards` | `list`, `get`, `update`, `freeze`, `unfreeze`, `pin-update-url`, `ephemeral-key`, `statement`, `transactions`, `transaction`, `authorizations`, `authorization-controls`, `withdraw`, `withdrawals`, `get-withdrawal`, `add-deposit-address`, `mobile-provision`, `designs`, `program-summary` |\n| `configure` | `api-key`, `stripe-api-key`, `format`, `show` |\n| `rates` | Get current exchange rates |\n\nAll commands support `--format toon|json|yaml|md|jsonl` and `--help`.\n\n## Agent Setup\n\nGive your AI agent (Claude Code, Amp, Cursor, Copilot, etc.) full access to Bridge.xyz:\n\n```bash\nnpx bridgerton mcp add      # register as MCP server — gives agents direct tool access\nnpx bridgerton skills add   # install skill files — gives agents context on available commands\n```\n\nThat's it. Your agent can now run commands like \"create a wallet on tempo for a customer\" or \"list all transfers\".\n\nYou can also run the MCP server directly in stdio mode:\n\n```bash\nbridgerton --mcp\n```\n\n## Development\n\n```bash\nbun install\nbun run build        # tsc + chmod\nbun run typecheck    # tsc --noEmit\n```\n\n## Built with\n\n[incur](https://github.com/wevm/incur) — one CLI router that gives you a CLI, MCP server, and agent skills for free.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftempoxyz%2Fbridgerton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftempoxyz%2Fbridgerton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftempoxyz%2Fbridgerton/lists"}