snowrail-a2a

# Snowrail A2A A compliance agent system that implements both Agent-to-Agent (A2A) and Model Context Protocol (MCP) servers for blockchain compliance monitoring. ## Description Snowrail A2A is a compliance agent designed to monitor and analyze blockchain transactions for regulatory compliance. It provides dual server implementations: - **A2A Server**: Agent-to-Agent communication protocol - **MCP Server**: Model Context Protocol integration ## Features - Blockchain transaction monitoring using Viem - AI-powered compliance analysis with OpenAI - Agent-to-Agent communication protocol - Model Context Protocol server - EVM chain support via @x402 libraries ## Prerequisites - Node.js (v20 or higher recommended) - pnpm (v8 or higher) - TypeScript 5.3+ - Access to EVM-compatible blockchain networks ## Installation ```bash pnpm install ``` ## Configuration Create a `.env` file in the root directory with your configuration: ```env # Add your environment variables here OPENAI_API_KEY=your_api_key_here # Add other required configuration ``` ## Usage ### Build the project ```bash pnpm build ``` ### Register the agent ```bash pnpm register ``` ### Start the A2A server ```bash pnpm start:a2a ``` ### Start the MCP server ```bash pnpm start:mcp ``` ## Tech Stack - **TypeScript**: Type-safe development - **Viem**: Ethereum library for blockchain interaction - **OpenAI**: AI-powered analysis - **Express**: Web server framework - **@x402**: Agent protocol libraries - **@modelcontextprotocol/sdk**: MCP protocol implementation ## Project Structure ``` snowrail-a2a/ ├── src/ │ ├── a2a-server.ts # A2A server implementation │ ├── mcp-server.ts # MCP server implementation │ └── register.ts # Agent registration ├── .well-known/ # Protocol configuration ├── package.json ├── tsconfig.json └── README.md ``` ## License MIT License - see [LICENSE](LICENSE) file for details ## Author Luis F. Ushiña <wolfcito> ## Contributing Contributions are welcome! Please feel free to submit a Pull Request.