Documentation Context for AI Agents

This file provides quick reference for AI agents about available documentation sources.

Available Documentation Sources

MCP (Model Context Protocol)
- URL: https://docs.bitbadges.io/~gitbook/mcp
- Best for: Real-time documentation access via MCP
Documentation Site
- URL: https://docs.bitbadges.io
- Best for: Human-readable documentation
GitHub Repository
- URL: https://github.com/trevormil/bitbadges-docs
- Best for: Source code and version control
Full .txt Dump
- URL: https://github.com/trevormil/bitbadges-docs/blob/master/for-llms.txt
- Best for: Complete context in a single file

After running bun run setup, the following local documentation will be available:

_docs/SDK_AI_AGENT_GUIDE.md - SDK AI Agent guide for bitbadgesjs-sdk
docs/METADATA_HOSTING.md - Comprehensive guide for hosting metadata externally (static, tracked in git)
docs/TRANSACTION_HANDLING.md - Complete guide for transaction handling, TxContext, simulation, and polling (static, tracked in git)
_docs/proto/ - Protocol buffer definitions
_docs/chain-registry/bitbadges/ - Chain registry information including:
- chain.json - Chain configuration
- _IBC/ - IBC connection information (filtered: bitbadges*.json only)
_docs/bitbadges-docs/ - Full documentation repository (only if DOWNLOAD_FULL_DOCS=true in .env)
- token-standard/learn/ - ⚠️ REQUIRED READING: Token Standard Learn section

APIs: https://api.bitbadges.io (mainnet), https://api.bitbadges.io/testnet (testnet)
LCD: https://lcd.bitbadges.io (mainnet), https://lcd-testnet.bitbadges.io (testnet)
RPC: https://rpc.bitbadges.io (mainnet), https://rpc-testnet.bitbadges.io (testnet)
Explorer: https://explorer.bitbadges.io
Chain ID: bitbadges-1 (mainnet)
Bech32 Prefix: bb