A comprehensive collection of specialized AI subagents for Claude Code, designed to enhance blockchain development workflows with domain-specific expertise. Built for developers who need intelligent assistance with Smart Contract (Solidity) Development, Solana programs, smart contract testing, Web3 frontend development, security audit program / smart contract and blockchain documentation.
This repository contains blockchain-specialized subagents that extend Claude Code's capabilities for blockchain development. Each subagent is an expert in a specific domain, automatically invoked based on context or explicitly called when needed. All agents are configured with Claude models optimized for task complexity to deliver optimal performance and cost-effectiveness.
Purpose: Create comprehensive technical documentation for blockchain programs and smart contracts
Capabilities:
- Generate detailed documentation for Solana programs and EVM smart contracts
- Create Mermaid diagrams for data flows, PDA relationships, and system architecture
- Produce sequence diagrams for transaction flows and contract interactions
- Document program-derived addresses (PDAs), account structures, and instruction handlers
- Create visual representations of complex blockchain architectures
Best for: Program documentation, architectural diagrams, technical specifications, onboarding materials
Purpose: Build comprehensive test suites for Solana programs
Capabilities:
- Write unit tests, integration tests, and end-to-end tests
- Expert knowledge of
litesvm,mollusksvm, andsolana-program-testframeworks - Test PDA operations, Cross-Program Invocations (CPIs), and token operations
- Create test coverage for edge cases, error conditions, and security constraints
- Migrate tests between different testing frameworks
Best for: Test-driven development, quality assurance, regression testing, test framework migration
Purpose: Expert guidance for building production-grade Web3 frontend applications
Capabilities:
- Build React/Next.js components with Solana blockchain integration
- Implement wallet connection flows for multiple providers (Phantom, Solflare, etc.)
- Create robust transaction handling with error recovery and retry mechanisms
- Optimize performance with Core Web Vitals >90 and bundle size <200KB
- Develop comprehensive testing strategies (unit, integration, E2E)
- Implement PWA features and offline support
- Ensure WCAG 2.1 AA accessibility compliance
Best for: DApp frontend development, wallet integration, performance optimization, component architecture
- Claude Code installed and configured
- Solana development environment (for Solana-specific agents)
- Rust and Anchor framework (recommended)
-
Clone the repository:
git clone https://github.com/mads-finance/blockchain-agents.git cd blockchain-agents -
Configure Claude Code subagents: Copy the subagent configuration files to your Claude Code workspace:
# Copy subagent files to your Claude Code subagents directory cp *.md /path/to/your/claude-code/subagents/
-
Verify installation: The subagents will automatically become available in Claude Code and can be invoked contextually or explicitly.
user: "Document my escrow program's PDA architecture"
claude: "I'll use the blockchain-documentation-architect agent to create comprehensive documentation with Mermaid diagrams showing the PDA relationships."
user: "I need tests for my new transfer_authority instruction"
claude: "I'll use the solana-qa-engineer agent to create comprehensive tests for your transfer_authority instruction using the appropriate testing framework."
user: "I need a wallet connection component that supports multiple Solana wallets"
claude: "I'll use the solana-web3-frontend-architect agent to create a robust wallet connection component with support for Phantom, Solflare, and other popular wallets."
The subagents are automatically invoked when Claude Code detects relevant context:
- Creating or modifying Solana programs
- Working with blockchain documentation
- Writing or debugging tests for smart contracts
- Building React/Next.js components with Web3 integration
Each subagent is designed as a specialized expert with:
- Domain Expertise: Deep knowledge in specific blockchain development areas
- Tool Integration: Seamless integration with Claude Code's tool ecosystem
- Context Awareness: Automatic activation based on development context
- Extensibility: Easy to modify and extend for specific project needs
We welcome contributions from the blockchain development community!
- Fork the repository
- Create a feature branch:
git checkout -b feature/new-subagent - Make your changes:
- Add new subagents in the same markdown format
- Update documentation and examples
- Test your subagents thoroughly
- Submit a pull request
- Follow the existing subagent structure and formatting
- Include comprehensive documentation and examples
- Test all functionality before submitting
- Update the main README.md with new subagents
- EVM Smart Contract Specialist: For Ethereum/EVM development
- Cross-Chain Bridge Expert: For interoperability solutions
- DeFi Protocol Architect: For decentralized finance applications
- NFT Marketplace Developer: For NFT-related functionality
- Governance Protocol Designer: For DAO and governance systems
- Smart Contract Security Auditor: For security analysis and vulnerability detection
This project is licensed under the MIT License - see the LICENSE file for details.
- Built for the Claude Code ecosystem
- Inspired by the Solana and broader blockchain development communities
- Thanks to all contributors and users who help improve these tools
- Issues: Report bugs and request features via GitHub Issues
- Discussions: Join conversations in GitHub Discussions
- Documentation: Additional docs and examples available in individual subagent files
Happy Blockchain Building! 🏗️⛓️