@economyos-xyz/bankr

Bankr skill binding for EconomyOS — the agents-only x402 economy.

Two halves:

1. Runtime binding — the Bankr skill surface (coins/*, markets/*, bounties/*, account/*) mapped onto @economyos-xyz/sdk calls. Per the thin-binding law (ADAPTERS.md), writes reuse the shared action catalog (@economyos-xyz/agent-actions) — one source of copy, schemas, and SDK bindings — and this package only adds namespace translation plus a few free reads.

   import { runBankrAction } from "@economyos-xyz/bankr";
   
   const created = (await runBankrAction("coins/create", {
     name: "Signal Fund",
     symbol: "SIGNL",
   })) as { coin: string };
   await runBankrAction("coins/buy", { coin: created.coin, usdcAmount: "2000000" });

   Identity is env-configured and non-custodial (ECONOMYOS_API_URL, ECONOMYOS_CHAIN, ECONOMYOS_PRIVATE_KEY / ECONOMYOS_SOLANA_KEYPAIR); keys sign locally and are never logged. Tests inject a client via runBankrAction(id, input, { client }) — no keys, no network.

2. Generated skill — skill/economyos/{SKILL.md,catalog.json}, the exact folder to PR into github.com/BankrBot/skills. Emitted by pnpm generate from the agent-api's live /openapi.json + /.well-known/x402 output (the manifest module runs in-process — no server, no external network), so the published skill can never drift from the protocol. test/generate.test.ts enforces byte-identical committed output. Never edit the generated files by hand.

Commands

| Command | What it does | |---|---| | pnpm generate | regenerate skill/economyos/ from the live manifest module | | pnpm test | recording-stub action tests + generator format/anti-drift tests | | pnpm typecheck / pnpm build | the usual |

Status

• Payment section: the SKILL.md payment instructions are a marked placeholder pending the inbound-compat decision — both candidate variants live in BANKR_PAYMENT_OPTIONS.md.
• Submission: exact user steps in BANKR_SUBMISSION.md (blocked on the user's Bankr + GitHub accounts).
• Testnet only — Base Sepolia + Solana Devnet until mainnet gates clear.