API агента кошелька MCP Solana

Полный Express API для операций с кошельком блокчейна Solana. Этот API обеспечивает функциональность для управления кошельками Solana, передачи SOL и работы с токенами SPL.

Функции

🔐 Управление кошельком : создание и управление кошельками Solana
💰 Переводы SOL : перевод SOL между кошельками
🪙 Управление токенами : создание, выпуск и передача токенов SPL
📚 Документация API : интерактивная документация Swagger
🔄 Обработка ошибок : надежная система обработки ошибок
🧪 Готов к разработке : легко настраивать и использовать

Предпосылки

Node.js (v16+)
нпм или пряжа
[Необязательно] Инструменты Solana CLI для дополнительного тестирования

Установка

Клонируйте репозиторий:

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

Установить зависимости:

npm install

Создайте в корневом каталоге файл .env со следующим содержимым:

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=

Разработка

Запустите сервер разработки:

npm run dev

Сервер запустится по адресу http://localhost:3000 с включенной горячей перезагрузкой.

Сборка и производство

Создайте проект:

npm run build

Запустите производственный сервер:

npm start

API-документация

После запуска сервера откройте документацию Swagger по адресу:

http://localhost:3000/api-docs

Документация содержит полный обзор всех доступных конечных точек с примерами запросов/ответов.

Конечные точки API

Конечные точки кошелька

Метод	Конечная точка	Описание
ПОЧТА	`/api/wallet`	Создать новый кошелек
ПОЛУЧАТЬ	`/api/wallet/:publicKey`	Получить информацию о кошельке
ПОЧТА	`/api/wallet/transfer`	Перевести SOL на другой кошелек

Конечные точки токена

Метод	Конечная точка	Описание
ПОЧТА	`/api/wallet/token`	Создать новый токен SPL
ПОЧТА	`/api/wallet/token/mint`	Чеканить токены по адресу
ПОЧТА	`/api/wallet/token/transfer`	Перевести токены на другой кошелек

Соображения безопасности

ВАЖНО : Этот проект использует переменные среды для ключей. В производственной среде следует использовать надлежащие службы управления ключами.
Никогда не раскрывайте свои закрытые ключи в клиентском коде.
Для производства рассмотрите возможность внедрения дополнительных механизмов аутентификации и авторизации.

Интеграции Соланы

Этот API взаимодействует с блокчейном Solana для:

Создавайте и управляйте кошельками
Перевод SOL между кошельками
Создать новые токены SPL
Чеканить токены по адресам
Перевод токенов между кошельками

Обработка ошибок

API включает в себя комплексную обработку ошибок со следующими функциями:

Подробные сообщения об ошибках в режиме разработки
Очищенные сообщения об ошибках в производстве
Правильные коды статуса HTTP
Различие между эксплуатационными и программными ошибками

Внося вклад

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии ISC — подробности см. в файле ЛИЦЕНЗИЯ.

Поддерживать

Для получения поддержки создайте проблему в репозитории или свяжитесь с разработчиками репозитория.

Solana MCP Wallet Agent API

Integrations