API del agente de billetera Solana MCP

Una API Express completa para las operaciones de la billetera blockchain de Solana. Esta API proporciona funcionalidad para gestionar billeteras de Solana, transferir SOL y trabajar con tokens SPL.

Características

🔐 Gestión de billeteras : crea y administra billeteras Solana
Transferencias SOL : Transfiere SOL entre billeteras
🪙 Gestión de tokens : crea, acuña y transfiere tokens SPL
Documentación de la API : Documentación interactiva de Swagger
🔄 Manejo de errores : Sistema robusto de manejo de errores
Listo para el desarrollo : fácil de configurar y usar

Prerrequisitos

Node.js (v16+)
npm o hilo
[Opcional] Herramientas CLI de Solana para pruebas adicionales

Instalación

Clonar el repositorio:

git clone https://github.com/MindLayer25/Wallet-MCP-Agent.git
cd Wallet-MCP-Agent

Instalar dependencias:

npm install

Cree un archivo .env en el directorio raíz con el siguiente contenido:

PORT=3000
NODE_ENV=development
# Solana connection (devnet by default)
SOLANA_RPC_URL=https://api.devnet.solana.com
# For your wallet - get this from Solana keygen or a wallet export (JSON format)
WALLET_PRIVATE_KEY=

Desarrollo

Inicie el servidor de desarrollo:

npm run dev

El servidor se iniciará en http://localhost:3000 con la recarga en caliente habilitada.

Construcción y producción

Construir el proyecto:

npm run build

Inicie el servidor de producción:

npm start

Documentación de la API

Una vez que el servidor esté en funcionamiento, acceda a la documentación de Swagger en:

http://localhost:3000/api-docs

La documentación proporciona una descripción completa de todos los puntos finales disponibles con ejemplos de solicitud/respuesta.

Puntos finales de API

Puntos finales de la billetera

Método	Punto final	Descripción
CORREO	`/api/wallet`	Crear una nueva billetera
CONSEGUIR	`/api/wallet/:publicKey`	Obtener información de la billetera
CORREO	`/api/wallet/transfer`	Transferir SOL a otra billetera

Puntos finales de token

Método	Punto final	Descripción
CORREO	`/api/wallet/token`	Crear un nuevo token SPL
CORREO	`/api/wallet/token/mint`	Acuñar tokens en una dirección
CORREO	`/api/wallet/token/transfer`	Transferir tokens a otra billetera

Consideraciones de seguridad

IMPORTANTE : Este proyecto utiliza variables de entorno para las claves. En un entorno de producción, se recomienda utilizar servicios de gestión de claves adecuados.
Nunca exponga sus claves privadas en el código del lado del cliente.
Para la producción, considere implementar mecanismos de autenticación y autorización adicionales.

Integraciones de Solana

Esta API interactúa con la cadena de bloques Solana para:

Crear y administrar billeteras
Transferir SOL entre billeteras
Crear nuevos tokens SPL
Acuñar tokens para direcciones
Transferir tokens entre billeteras

Manejo de errores

La API incluye un manejo integral de errores con las siguientes características:

Mensajes de error detallados en el modo de desarrollo
Mensajes de error desinfectados en producción
Códigos de estado HTTP adecuados
Distinción entre errores operativos y de programación

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia ISC: consulte el archivo de LICENCIA para obtener más detalles.

Apoyo

Para obtener ayuda, cree un problema en el repositorio o comuníquese con los mantenedores del repositorio.

Solana MCP Wallet Agent API

Integrations