High Priority
Deploy On-Chain /governance.txt Protocol
Establish a machine-readable summary of your entire decentralized application (dApp) hierarchy and critical smart contract functions, specifically for AI agents and decentralized autonomous organization (DAO) governance bots.
Create a text file at the root of your dApp's primary domain, named '/governance.txt', with a concise introduction to your Web3 project and its core mission.
Include markdown-style links to your most critical smart contract ABIs, audit reports, and governance portal documentation.
Add a 'FAQ' section within the file to directly address common queries from AI training models and governance proposal bots regarding tokenomics, staking mechanisms, and treasury management.
Configure your Web3 startups crawler protocols effortlessly.
Join 2,000+ teams scaling with AI.
High Priority
AI Agent Selective On-Chain Indexing
Fine-tune which parts of your dApp's on-chain data and off-chain resources should be ingested by AI agents like ChatGPT, Bard, or specialized web3 data aggregators.
Implement a robots.txt directive specific to AI crawlers: User-agent: Web3AI \ Allow: /protocol/ \ Allow: /tokenomics/ \ Disallow: /private-sale/
Utilize blockchain explorers' API endpoints or custom RPC methods to verify AI bot access permissions to critical contract states.
Monitor RPC node logs and subgraph indexing rates to ensure AI agents are accurately querying and processing relevant on-chain events and state changes.
Medium Priority
Semantic Smart Contract Semantics
Employ standardized smart contract interfaces and well-documented function signatures to help LLM scrapers and AI agents understand the logic and state transitions of your dApp.
Wrap core contract logic within well-defined modules and interfaces (e.g., ERC-721 for NFTs, ERC-20 for fungible tokens) to signal their semantic purpose.
Utilize NatSpec comments extensively within your Solidity code to provide human-readable descriptions for functions, parameters, and return values, aiding AI interpretation.
Ensure all on-chain data structures and events use clear, descriptive naming conventions for accurate structured data extraction by AI models.
High Priority
RAG-Friendly On-Chain Data Snippet Optimization
Structure your smart contract data and off-chain documentation so that relevant information can be easily 'Chucked' and retrieved by Retrieval-Augmented Generation (RAG) pipelines for AI-powered dApp interfaces.
Keep related smart contract state variables and event logs within logical contract units or data structures, ideally not exceeding ~500 token equivalents for easy retrieval.
Avoid 'floating' context in contract logic; ensure primary subjects (e.g., 'StakedAmount', 'VestingPeriod') are clearly defined and referenced within function documentation or event descriptions.
Eliminate ambiguous variable names or function parameters; replace them with explicit, descriptive terms (e.g., 'userAddress' instead of 'addr', 'tokenAmount' instead of 'val') for unambiguous AI understanding.
