feat(stacks): add CAIP-19 asset specification #167
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Adds comprehensive CAIP-19 specification for Stacks token assets,
supporting SIP-010 fungible tokens and SIP-009 non-fungible tokens.
Asset reference format: {address}.{contract}.{token-name}
This addresses the feedback from PR ChainAgnostic#68 including:
- Clear documentation of all syntax components
- Case sensitivity handling (addresses vs contract/token names)
- Complete RegEx validation patterns
- Semantics section for each token type
Examples verified against on-chain data (sBTC, Megapont Ape Club).
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Author
|
cc @kyranjamie as well! |
whoabuddy
added a commit
to aibtcdev/docs
that referenced
this pull request
Jan 28, 2026
Address review feedback: - Flatten sidebar to one level (no nested Reference group) - Remove redundant reference index page Directory improvements: - AIBTC services pattern: mainnet on aibtc.com, testnet on aibtc.dev - Fix endpoint paths: /docs, /dashboard at base route (not subdomains) - Add Facilitator /health, Biwas /analytics endpoints - Remove redundant repos section (link to github org instead) - Remove redundant external resources (fold key links into More section) Token reference: - Add Circle Xreserve mention for USDCx - Link to Stacks bridging docs - Link to our CAIP-19 PR (ChainAgnostic/namespaces#167) Network reference: - Fix dashboard/docs paths (at base route, not subdomains) Homepage: - Cleaner quick reference tables - Condensed community links Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
whoabuddy
added a commit
to aibtcdev/docs
that referenced
this pull request
Jan 28, 2026
* docs: restructure as canonical reference layer Replace tutorial/guide content with reference documentation that ties together the AIBTC ecosystem. Landing page (aibtc.com) handles getting started; docs.aibtc.com is now the "phone book" for looking things up. New structure: - /directory/ — Services, tools, SDKs, templates, repositories - /reference/tokens/ — Contract addresses, CAIP identifiers, decimals - /reference/networks/ — Mainnet/testnet configs, API endpoints - /glossary/ — Term definitions (unchanged) Removed: - /guides/what-is-x402/ — Landing page covers this better - /guides/services/ — Replaced by /directory/ - /guides/tokens/ — Replaced by /reference/tokens/ Homepage redesigned as navigation hub with quick reference tables. Closes #2 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * docs: flatten navigation and refine content Address review feedback: - Flatten sidebar to one level (no nested Reference group) - Remove redundant reference index page Directory improvements: - AIBTC services pattern: mainnet on aibtc.com, testnet on aibtc.dev - Fix endpoint paths: /docs, /dashboard at base route (not subdomains) - Add Facilitator /health, Biwas /analytics endpoints - Remove redundant repos section (link to github org instead) - Remove redundant external resources (fold key links into More section) Token reference: - Add Circle Xreserve mention for USDCx - Link to Stacks bridging docs - Link to our CAIP-19 PR (ChainAgnostic/namespaces#167) Network reference: - Fix dashboard/docs paths (at base route, not subdomains) Homepage: - Cleaner quick reference tables - Condensed community links Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a comprehensive CAIP-19 specification for Stacks token assets, addressing the feedback from #68.
stacks/caip19.mdwith support for SIP-010 (fungible) and SIP-009 (non-fungible) tokensstacks/README.mdto reference CAIP-19Relationship to #68
This is an updated implementation that addresses all review feedback from #68:
.contractsyntax{address}.{contract}.{token-name}Key Design Decisions
Asset Reference Format:
.as separator (CAIP-19 compliant, since:is not permitted in asset_reference)::syntaxNamespaces:
sip010sip009Examples (verified on-chain):
Test plan
References
🤖 Generated with Claude Code