Guides
Task guides for BitBadges. Start with the AI builder, then follow CLI, TypeScript SDK, and JSON examples for direct integration.
Each guide takes one job (create a token, distribute it, gate access, sign users in) and connects the creation flow to working commands. Concepts are not re-explained here; each step links to the canonical page in the Token Standard tab.
For the pitch behind each build (which two or three approval fields turn the standard into a stablecoin, a subscription, or an agent vault), read Use Cases first.
Start with a Prompt
Set up your AI and describe the result you want. The builder assembles and checks the transaction; you review and sign through a browser link.
Create a 100-piece NFT collection called Demo NFTs where only I can mint,
validate and simulate it, and give me the review link.Follow Your First Collection for a complete prompt-to-collection walkthrough. To embed this creation flow in application code, see Programmatic Agent.
Follow the Implementation
The CLI, SDK, and JSON examples below show how each build works and support repeatable integrations. For these examples:
- Install
bbusing the Quickstart. - Examples target mainnet. Replace example addresses, collection IDs, metadata URIs, and dates with your own values before signing. The signer needs BADGE for fees and any coins or tokens the transaction spends. See Testnet for availability.
- Review transaction JSON with
bb checkandbb preview, then sign with your wallet. See Deploy or the SDK signing client.
Guides
| Task | Surfaces | Guide |
|---|---|---|
| Create an NFT or fungible collection | bb CLI, SDK, JSON | Create a Collection |
| Mint tokens and hand them out (creator mint, public mint, paid mint, escrow payouts) | bb CLI, SDK, JSON | Mint and Distribute |
| Decide who can transfer, burn, or force-move tokens | SDK, JSON | Set Transferability |
| Freeze supply, approvals, metadata, or the whole collection | JSON, SDK | Lock Permissions |
| Distribute with codes, allowlists, socials, and other claim plugins | BitBadges site, BitBadges API | Distribute with Claims |
| Write your own claim plugin | BitBadges API | Build a Claim Plugin |
| Gate an API route or page by token ownership (BB-402) | BitBadges API, SDK | Gate access |
| Add "Sign in with BitBadges" to an app | BitBadges API | Sign In Users |
| Make tokens spendable as an x/bank coin and over IBC | bb CLI, SDK, JSON | Wrap to an IBC Denom |
| Create pools, swap, and add liquidity | bb CLI, BitBadges API | Trade on the DEX |
| Sell recurring subscriptions, prepaid credits, and expiring tokens | bb CLI, JSON | Subscriptions and Time-Based Tokens |
| Issue a 1:1 backed token or an AI agent vault | bb CLI, SDK, JSON | Smart Tokens and Vaults |
Reading Order
For a new token, read the first four guides in order. They build one collection: create it, add mint approvals, set post-mint transferability, then lock what must never change. The remaining guides stand alone.