Solana MCP Wallet Agent API

Solana MCP Wallet Agent API

A complete Express API for Solana blockchain wallet operations. This API provides functionality for managing Solana wallets, transferring SOL, and working with SPL tokens.

Features

• 🔐 Wallet Management: Create and manage Solana wallets
• 💰 SOL Transfers: Transfer SOL between wallets
• 🪙 Token Management: Create, mint, and transfer SPL tokens
• 📚 API Documentation: Interactive Swagger documentation
• 🔄 Error Handling: Robust error handling system
• 🧪 Development Ready: Easy to set up and use

Prerequisites

• Node.js (v16+)
• npm or yarn
• [Optional] Solana CLI tools for additional testing

Installation

1. Clone the repository:

2. Install dependencies:

3. Create a .env file in the root directory with the following contents:

Development

Start the development server:

The server will start at http://localhost:3000 with hot-reloading enabled.

Build and Production

Build the project:

Start the production server:

API Documentation

Once the server is running, access the Swagger documentation at:

The documentation provides a complete overview of all available endpoints with request/response examples.

API Endpoints

Wallet Endpoints

Token Endpoints

Security Considerations

• IMPORTANT: This project uses environment variables for keys. In a production environment, you should use proper key management services.
• Never expose your private keys in client-side code.
• For production, consider implementing additional authentication and authorization mechanisms.

Solana Integrations

This API interacts with the Solana blockchain to:

1. Create and manage wallets
2. Transfer SOL between wallets
3. Create new SPL tokens
4. Mint tokens to addresses
5. Transfer tokens between wallets

Error Handling

The API includes comprehensive error handling with the following features:

• Detailed error messages in development mode
• Sanitized error messages in production
• Proper HTTP status codes
• Operational vs programming error distinction

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the ISC License - see the LICENSE file for details.

Support

For support, please create an issue in the repository or contact the repository maintainers.