Tooling
Installed CLI and MCP support, lifecycle limits, and frontend routes for every standard family.
Start with the installed CLI. This reference is generated from the SDK operation catalog and frontend route registry; it does not evaluate any live collection.
bb dev standards
bb dev standards subscription
bb dev standards payment-request-v2
bb dev capabilities standard_subscriptions_cancelMCP uses get_standards with an optional id. Download the machine-readable catalog. The installed CLI may differ from this documentation snapshot; inspect its own catalog before building.
Source SDK revision: 1fa9a8cba2c28a2aaf1a7b479c0d867037bdb795. Source package version: 0.45.6.
Installed tooling and lifecycle limitations, not live collection conformance or transaction eligibility. Tags are discovery hints. Structural schemas do not prove semantic correctness. Read current state, review exact terms and fees, simulate, then request signing separately.
Create and update routes identify interfaces, not authorization or mutability guarantees. Frozen catalog products remain frozen even when the generic update route exists. Replace {collectionId} with the real collection ID. Developer lists may require a connected wallet and filters.
Frontend Routes
| Family | Create | Collection | Manage | Update |
|---|---|---|---|---|
address-list | /mint/address-list | /collections/{collectionId} | /developer?tab=badges | /update/address-list/{collectionId} |
auction | /mint/auction | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
bounty | /mint/bounty | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
credit-token | /mint/credit-token | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
crowdfund | /mint/crowdfund | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
custom-2fa | /mint/custom-2fa | /collections/{collectionId} | /developer?tab=badges | /update/custom-2fa/{collectionId} |
ibc-token | /mint/ibc-token | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
issuer-controlled | /mint/issuer-controlled | /collections/{collectionId} | /developer?tab=badges | /update/issuer-controlled/{collectionId} |
nft | /mint/nft | /collections/{collectionId} | /developer?tab=badges | /update/nft/{collectionId} |
one-of-one | /mint/one-of-one | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
payment-request | /mint/payment-request | /collections/{collectionId} | /developer?tab=invoices | /update/{collectionId} |
prediction-market | /mint/prediction-market | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
product-catalog | /mint/product-catalog | /collections/{collectionId} | /developer?tab=products | /update/{collectionId} |
quests | /mint/quests | /collections/{collectionId} | /developer?tab=badges | /update/quests/{collectionId} |
smart-token | /mint/smart-token | /collections/{collectionId} | /developer?tab=smart-tokens | /update/smart-token/{collectionId} |
subscriptions | /mint/subscriptions | /collections/{collectionId} | /developer?tab=subscriptions | /update/subscriptions/{collectionId} |
tradable-fungible | /mint/tradable-fungible | /collections/{collectionId} | /developer?tab=badges | /update/tradable-fungible/{collectionId} |
vault | /mint/vault | /collections/{collectionId} | /developer?tab=badges | /update/{collectionId} |
Lifecycle Support
Required inputs below come from the installed operation schema. Conditional options and state-dependent limits still apply; read the linked schema command and native help. Shared MCP actions only return state or unsigned proposals. Use the CLI browser signing flow separately.
address-list
Membership and address-list collection configuration.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_address_list | bb build address-list | build_address_list | None structurally required |
standard_standards_inspect | bb standards inspect --family address-list | standard_standards_inspect | collectionId, family |
Read any operation schema with bb dev capabilities <operation-id>.
Membership rules and manager permissions determine eligibility.
Shared inspection requires family=address-list and a collectionId. It reports bounded configuration support, not balances, permissions, or live eligibility.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Identity uniqueness or proof of personhood from an address alone.
auction
Timed bidding followed by seller acceptance.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_auction | bb build auction | build_auction | None structurally required |
standard_auctions_accept_bid | bb auctions accept-bid | standard_auctions_accept_bid | collectionId, bidApprovalId, creator, bidder |
standard_auctions_cancel_bid | bb auctions cancel-bid | standard_auctions_cancel_bid | collectionId, approvalId, creator |
standard_auctions_list | bb auctions list | standard_auctions_list | None structurally required |
standard_auctions_place_bid | bb auctions place-bid | standard_auctions_place_bid | collectionId, creator, amount, denom |
standard_auctions_show | bb auctions show | standard_auctions_show | collectionId |
standard_auctions_status | bb auctions status | standard_auctions_status | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
A bid is an approval, not guaranteed escrow funding. Acceptance must satisfy live approval and balance state.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed bidder funding and autonomous settlement without a submitted transaction.
bid
User incoming approval for marketplace bids.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_bid | bb build bid | build_bid | address, collectionId, price, denom |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb nfts --help.
A bid does not reserve the bidder payment balance.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed bidder liquidity.
bounty
Acceptance, denial, and expiry branches for a funded reward.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_bounty | bb build bounty | build_bounty | amount, denom, verifier, recipient, submitter |
standard_bounties_accept | bb bounties accept | standard_bounties_accept | collectionId, creator |
standard_bounties_claim_refund | bb bounties claim-refund | standard_bounties_claim_refund | collectionId, creator |
standard_bounties_deny | bb bounties deny | standard_bounties_deny | collectionId, creator |
standard_bounties_list | bb bounties list | standard_bounties_list | None structurally required |
standard_bounties_show | bb bounties show | standard_bounties_show | collectionId |
standard_bounties_status | bb bounties status | standard_bounties_status | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Acceptance depends on the configured decision authority. Expiry alone does not submit a refund transaction.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Automatic work verification and external dispute arbitration.
credit-token
Purchase exact credit quantities using fixed or scaled tiers.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_credit_token | bb build credit-token | build_credit_token | paymentDenom, recipient |
standard_standards_inspect | bb standards inspect --family credit-token | standard_standards_inspect | collectionId, family |
standard_credit_tokens_list | bb credit-tokens list | standard_credit_tokens_list | collectionId |
standard_credit_tokens_purchase | bb credit-tokens purchase | standard_credit_tokens_purchase | creator, units |
standard_credit_tokens_quote | bb credit-tokens quote | standard_credit_tokens_quote | collectionId, units |
standard_credit_tokens_show | bb credit-tokens show | standard_credit_tokens_show | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Select a tier explicitly when multiple tiers exist. Scaled purchases obey integer increments and maximum multipliers.
Quotes exclude fees and do not prove current eligibility. On-chain balances are not an external service usage ledger.
Shared inspection requires family=credit-token and a collectionId. It reports bounded configuration support, not balances, permissions, or live eligibility.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Automatic service consumption accounting, refunds, and credit-to-cash redemption.
crowdfund
Deadline and target based contributions, withdrawal, and refunds.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_crowdfund | bb build crowdfund | build_crowdfund | goal, denom |
standard_crowdfunds_contribute | bb crowdfunds contribute | standard_crowdfunds_contribute | collectionId, creator, amount |
standard_crowdfunds_list | bb crowdfunds list | standard_crowdfunds_list | None structurally required |
standard_crowdfunds_refund | bb crowdfunds refund | standard_crowdfunds_refund | collectionId, creator, amount |
standard_crowdfunds_show | bb crowdfunds show | standard_crowdfunds_show | collectionId |
standard_crowdfunds_status | bb crowdfunds status | standard_crowdfunds_status | collectionId |
standard_crowdfunds_withdraw | bb crowdfunds withdraw | standard_crowdfunds_withdraw | collectionId, creator |
Read any operation schema with bb dev capabilities <operation-id>.
Withdrawal and refund eligibility depend on the configured approval branches and live trackers.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Off-chain project delivery guarantees and dispute arbitration.
custom-2fa
A collection used for additional authorization conditions.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_custom_2fa | bb build custom-2fa | build_custom_2fa | None structurally required |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb custom-2fa --help.
Authorization strength depends on the configured approval conditions and verification source.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Universal protection of unrelated wallet transactions.
ibc-token
IBC token factory collection family.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
| Dedicated adapter | Not provided | Not provided | See generic collection tools |
Read any operation schema with bb dev capabilities <operation-id>.
IBC denominations, aliases, and configured backing must be inspected independently. No dedicated one-shot builder is mapped here.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: A dedicated standard builder or lifecycle action adapter in this catalog.
intent
User approval for a constrained exchange.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_intent | bb build intent | build_intent | address, collectionId, payDenom, payAmount, receiveDenom, receiveAmount |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb intents --help.
An intent is not reserved liquidity. Concurrent updates require reading current user approvals.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed fills and atomic compare-and-swap for whole approval-list replacement.
issuer-controlled
Tokens with issuer-defined transfer controls.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
| Dedicated adapter | Not provided | Not provided | See generic collection tools |
Read any operation schema with bb dev capabilities <operation-id>.
Inspect issuer authority and mutable permissions before accepting custody or transfer restrictions.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: A dedicated one-shot builder or standard action adapter in this catalog.
listing
User outgoing approval for marketplace sales.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_listing | bb build listing | build_listing | address, collectionId, tokenIds, price, denom |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb nfts --help.
Listings require current ownership and approval state at execution.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed buyer demand and automatic delivery of off-chain assets.
nft
Non-fungible collections with optional marketplace approvals.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
| Dedicated adapter | Not provided | Not provided | See generic collection tools |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb nfts --help.
Use general collection session tools to create a collection. Marketplace commands manage user orders and transfers, not collection creation.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: A dedicated NFT collection builder or shared MCP marketplace action adapter in this catalog.
one-of-one
Single-token collection family.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
| Dedicated adapter | Not provided | Not provided | See generic collection tools |
Read any operation schema with bb dev capabilities <operation-id>.
A display tag alone does not prove immutable single supply. Inspect mint approvals, valid IDs, and permissions.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: A dedicated one-shot builder or standard action adapter in this catalog.
payment-request
Legacy single-payment request.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_payment_request | bb build payment-request | build_payment_request | amount, denom, payer, recipient |
standard_pay_requests_deny | bb pay-requests deny | standard_pay_requests_deny | collectionId, creator |
standard_pay_requests_list | bb pay-requests list | standard_pay_requests_list | None structurally required |
standard_pay_requests_pay | bb pay-requests pay | standard_pay_requests_pay | collectionId, creator |
standard_pay_requests_show | bb pay-requests show | standard_pay_requests_show | collectionId |
standard_pay_requests_status | bb pay-requests status | standard_pay_requests_status | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Legacy payment requests differ structurally from invoice v2 and reusable payment links.
A public invoice uses payer All and exactly one Pay approval; any connected payer may pay. Deny is only available for a specific payer invoice. Public Pay/Deny configurations are unsupported.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Invoice v2 multi-payer and partial-payment behavior in the legacy builder.
payment-request-v2
Invoices and payment links with explicit payer rules and tracked obligations.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_payment_request_v2 | bb build payment-request-v2 | build_payment_request_v2 | version, kind, obligations |
standard_pay_requests_list | bb pay-requests list | standard_pay_requests_list | None structurally required |
standard_pay_requests_pay | bb pay-requests pay | standard_pay_requests_pay | collectionId, creator |
standard_pay_requests_show | bb pay-requests show | standard_pay_requests_show | collectionId |
standard_pay_requests_status | bb pay-requests status | standard_pay_requests_status | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Payments go directly to configured recipients; this is not escrow.
Amounts use base-unit strings. Partial payments use integer payout quanta.
Tracker reads may be unavailable or stale. Reconcile before submitting another payment.
Deny is a legacy payment-request action; invoice v2 and payment links do not expose that lifecycle branch.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Automatic refunds, prorations, and escrow-based conditional release.
| Payment category | Behavior | Example |
|---|---|---|
specific | One named payer pays once. | bb build payment-request-v2 --example specific |
anyone | First eligible public payer pays once; recipients are excluded. | bb build payment-request-v2 --example anyone |
one | One of two eligible payers settles a shared obligation. | bb build payment-request-v2 --example one |
all | Each named payer owes an independent share. | bb build payment-request-v2 --example all |
threshold | Two distinct payers from a three-person roster. | bb build payment-request-v2 --example threshold |
installments | One payer owes two independently timed payments. | bb build payment-request-v2 --example installments |
partial | One payer settles a target in integer payout quanta. | bb build payment-request-v2 --example partial |
target | Public contributors share an integer-quantum target. | bb build payment-request-v2 --example target |
link | Reusable fixed payments with no finite completion target. | bb build payment-request-v2 --example link |
custom | Validated combinations that do not match one predefined display category. | Compose validated terms |
pm-buy-intent
User incoming approval for prediction outcome purchases.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_pm_buy_intent | bb build pm-buy-intent | build_pm_buy_intent | address, collectionId, token, amount, price, denom |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb prediction-markets --help.
Live outcome state, approvals, and balances govern execution.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed fills.
pm-sell-intent
User outgoing approval for prediction outcome sales.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_pm_sell_intent | bb build pm-sell-intent | build_pm_sell_intent | address, collectionId, token, amount, price, denom |
Read any operation schema with bb dev capabilities <operation-id>.
Additional native CLI surface: bb prediction-markets --help.
Live outcome state, approvals, and balances govern execution.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Guaranteed fills.
prediction-market
Binary outcome positions with a configured resolver.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_prediction_market | bb build prediction-market | build_prediction_market | verifier |
standard_prediction_markets_buy_no | bb prediction-markets buy-no | standard_prediction_markets_buy_no | collectionId, creator, tokenAmount, paymentAmount, denom |
standard_prediction_markets_buy_yes | bb prediction-markets buy-yes | standard_prediction_markets_buy_yes | collectionId, creator, tokenAmount, paymentAmount, denom |
standard_prediction_markets_cancel | bb prediction-markets cancel | standard_prediction_markets_cancel | collectionId, approvalId, creator, side |
standard_prediction_markets_deposit | bb prediction-markets deposit | standard_prediction_markets_deposit | collectionId, creator, amount |
standard_prediction_markets_list | bb prediction-markets list | standard_prediction_markets_list | None structurally required |
standard_prediction_markets_quote | bb prediction-markets quote | standard_prediction_markets_quote | collectionId, state |
standard_prediction_markets_redeem | bb prediction-markets redeem | standard_prediction_markets_redeem | collectionId, creator, state |
standard_prediction_markets_resolve | bb prediction-markets resolve | standard_prediction_markets_resolve | collectionId, creator, outcome |
standard_prediction_markets_sell_no | bb prediction-markets sell-no | standard_prediction_markets_sell_no | collectionId, creator, tokenAmount, paymentAmount, denom |
standard_prediction_markets_sell_yes | bb prediction-markets sell-yes | standard_prediction_markets_sell_yes | collectionId, creator, tokenAmount, paymentAmount, denom |
standard_prediction_markets_show | bb prediction-markets show | standard_prediction_markets_show | collectionId |
standard_prediction_markets_status | bb prediction-markets status | standard_prediction_markets_status | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Outcome resolution trusts the configured resolver. Settlement requires live approval, outcome, and balance state.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Trustless external event verification and automatic dispute arbitration.
product-catalog
A frozen catalog of separately priced products and payout recipients.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_product_catalog | bb build product-catalog | build_product_catalog | products, storeAddress |
standard_products_list | bb products list | standard_products_list | collectionId |
standard_products_purchase | bb products purchase | standard_products_purchase | collectionId, creator, tokenId |
standard_products_show | bb products show | standard_products_show | collectionId |
Read any operation schema with bb dev capabilities <operation-id>.
Creation freezes product approvals. Each product may override the catalog payout recipient.
A purchase records a token transfer; fulfillment remains the merchant responsibility.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Editing frozen catalog products, delivery verification, automatic returns, and refunds.
quests
Claim and reward approval configuration.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_quests | bb dev tools call build_quests | build_quests | reward, denom, maxClaims |
Read any operation schema with bb dev capabilities <operation-id>.
External task completion requires its configured verification source.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Automatic verification of arbitrary off-chain tasks.
smart-token
Programmable deposit and withdrawal relationships.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_smart_token | bb build smart-token | build_smart_token | backingCoin |
standard_standards_inspect | bb standards inspect --family smart-token | standard_standards_inspect | collectionId, family |
standard_smart_tokens_deposit | bb smart-tokens deposit | standard_smart_tokens_deposit | collectionId, creator, amount |
standard_smart_tokens_list | bb smart-tokens list | standard_smart_tokens_list | None structurally required |
standard_smart_tokens_show | bb smart-tokens show | standard_smart_tokens_show | collectionId |
standard_smart_tokens_status | bb smart-tokens status | standard_smart_tokens_status | collectionId |
standard_smart_tokens_withdraw | bb smart-tokens withdraw | standard_smart_tokens_withdraw | collectionId, creator, amount |
Read any operation schema with bb dev capabilities <operation-id>.
Configured approvals determine backing and transfer eligibility; a standard tag is not proof of collateral or conformance.
Shared inspection requires family=smart-token and a collectionId. It reports bounded configuration support, not balances, permissions, or live eligibility.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Native interest accrual, lending liquidation, and yield guarantees.
subscription
Time-bounded access with separately authorized renewal payments.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_subscription | bb build subscription | build_subscription | interval |
standard_subscriptions_cancel | bb subscriptions cancel | standard_subscriptions_cancel | collectionId, creator |
standard_subscriptions_charge_due | bb subscriptions charge-due | standard_subscriptions_charge_due | collectionId, creator |
standard_subscriptions_claim | bb subscriptions claim | standard_subscriptions_claim | collectionId, creator |
standard_subscriptions_enable_renewal | bb subscriptions enable-renewal | standard_subscriptions_enable_renewal | collectionId, creator |
standard_subscriptions_list | bb subscriptions list | standard_subscriptions_list | collectionId |
standard_subscriptions_status | bb subscriptions status | standard_subscriptions_status | collectionId, address |
standard_subscriptions_subscribe | bb subscriptions subscribe | standard_subscriptions_subscribe | collectionId, creator |
Read any operation schema with bb dev capabilities <operation-id>.
Paid access and renewal consent are independent. Future access is not current access.
Recorded consent does not guarantee balance, executor availability, or successful renewal.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Automatic plan switching, prorations, and refunds of paid access.
tradable-fungible
Tradable fungible token collection family.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
| Dedicated adapter | Not provided | Not provided | See generic collection tools |
Read any operation schema with bb dev capabilities <operation-id>.
Use the general collection session tools for supply, approvals, and permissions. Transferability depends on actual rules.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: A dedicated one-shot builder or standard action adapter in this catalog.
vault
A vault builder using existing smart-token primitives.
| Operation | CLI | MCP | Required inputs |
|---|---|---|---|
build_vault | bb build vault | build_vault | backingCoin |
standard_standards_inspect | bb standards inspect --family smart-token | standard_standards_inspect | collectionId, family |
Read any operation schema with bb dev capabilities <operation-id>.
Review exact spend approvals, recipients, limits, and permissions. Builder availability is not a certification of agent custody safety.
Shared inspection requires family=smart-token and a collectionId. It reports bounded configuration support, not balances, permissions, or live eligibility.
Unsigned proposals do not sign or broadcast. Permission to create does not imply permission to manage an existing collection.
Unsupported: Unbounded autonomous spending and native interest accrual.
Approval Updates
Reading and preserving current approvals does not provide atomic compare-and-swap. Another writer or a delayed signing request can make a whole-list replacement stale. Re-read and rebuild after another edit, and reconcile unknown transaction outcomes before retrying.
See Lifecycle, Payments, and Subscriptions for end-to-end workflows.