Кошельки Tron с защитой паролем через API
Создавайте кошельки Tron с паролем, чтобы API никогда не возвращал приватный ключ. Как создать адрес, отправить с него, экспортировать ключ и сменить пароль.
Проверил(а) Maurice Sobiera
Кошелёк Tron с защитой паролем — это адрес, который вы создаёте через API Chaingateway с параметром password. Приватный ключ шифруется этим паролем и не возвращается в ответе. Чтобы отправить средства с адреса, вы передаёте пароль вместо ключа. Chaingateway не хранит пароль, поэтому утерянный пароль восстановить нельзя.
Что изменилось с кошельками, защищёнными паролем?
До 18 февраля 2025 года адреса Tron, созданные через API, возвращали приватный ключ в ответе. Это подходит для временных адресов, но ключ остаётся в ваших логах, базе данных и во всех системах, которые работают с ответом. Альтернатива — кошельки с защитой паролем. Документация по управлению кошельками называет их рекомендуемым способом и описывает ключ как зашифрованный вашим паролем и собственными механизмами шифрования Chaingateway. Небезопасный вариант тоже сохраняется: если не передать password, вы получаете приватный ключ напрямую и должны хранить его сами.
Как создать кошелёк Tron с защитой паролем?
Отправьте POST-запрос на /api/v2/tron/addresses с password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/addresses \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "password": "your_secure_password" }'Ответ содержит новый адрес в data. Приватного ключа в нём нет. Используйте длинный случайный пароль из менеджера паролей. Шпаргалка OWASP по аутентификации считает слабыми пароли короче 15 символов, если их не защищает второй фактор, а у пароля кошелька такого фактора нет. Храните его в хранилище секретов, потому что тот же пароль нужен для каждого последующего запроса с этим адресом.
Как отправить средства с кошелька, защищённого паролем?
Передайте поле password вместо privatekey. Для перевода TRX нужны from, to, amount и password:
curl --request POST \ --url https://app.chaingateway.io/api/v2/tron/transactions \ --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \ --header 'Content-Type: application/json' \ --data '{ "from": "TSenderAddress", "to": "TDestinationAddress", "amount": 100, "password": "your_secure_password"}'То же поле password работает в POST /api/v2/tron/transactions/trc20, .../trc721 и .../trc10. Переводам TRC20 также нужен contractaddress. Перевод TRC20 с адреса без TRX или застейканной Energy завершается со статусом 422, как объясняет руководство TronFuel и Paymaster. Paymaster Chaingateway устарел, а для покрытия комиссии рекомендуется TronFuel.
Как экспортировать ключ, сменить пароль или импортировать ключ?
Жизненный цикл кошелька завершают ещё три эндпоинта. Каждый принимает адрес в пути:
| Задача | Запрос | Тело |
|---|---|---|
| Экспорт приватного ключа | POST /api/v2/tron/addresses/export/{address} | password |
| Смена пароля | POST /api/v2/tron/addresses/{address} | old_password, new_password |
| Импорт существующего ключа | POST /api/v2/tron/addresses/import | address, privatekey, password |
Импорт — это способ перевести существующий незащищённый адрес под защиту паролем. После импорта отправляйте с адреса с паролем и перестаньте передавать ключ. Удалите ключ из собственного хранилища, когда проверите тестовый перевод в тестовой сети. Экспорт — это запасной выход: он позволяет уйти из сервиса с вашим ключом, и для него нужен пароль.
Каковы ограничения защиты паролем?
Аккаунтом Tron управляет его приватный ключ, как сказано в документации Tron, поэтому защищать нужно именно ключ. Пароль защищает ключ в состоянии покоя. Он не защищает от компрометации сервера, который уже знает пароль, и не помогает при утере пароля. По данным документации, Chaingateway не может восстановить кошелёк, если пароль утерян. Сделайте резервную копию пароля и один раз проверьте экспорт, прежде чем переводить реальные средства. Крупные суммы держите в кошельке, ключ которого у вас на руках, а кошельки API используйте как горячие с ограниченным балансом.
Перед переводом реальных средств пройдите этот контрольный список:
- Создайте кошелёк в тестовой сети и отправьте небольшой перевод с паролем.
- Экспортируйте приватный ключ один раз и убедитесь, что он соответствует адресу.
- Смените пароль и убедитесь, что отправка со старым паролем не проходит, а с новым работает.
- Храните пароль в менеджере секретов и уберите его из истории оболочки и логов.
Начните с тестовой сети. Добавьте заголовок X-Network: testnet к каждому запросу выше, создайте кошелёк в Nile и пройдите создание, отправку, экспорт и смену пароля. Тестовые сети перечислены на странице поддерживаемых сетей, а документация по сетям Tron объясняет Nile и Shasta.
Какие вопросы возникают чаще всего?
Работает ли кошелёк с паролем в других сетях?
Да. Документация по управлению кошельками описывает параметр password для /api/v2/{blockchain}/addresses, а файл OpenAPI перечисляет эндпоинты адресов с тем же шаблоном для Ethereum, BNB Smart Chain, Polygon и Arbitrum.
Может ли Chaingateway сбросить утерянный пароль?
Нет. Документация указывает, что Chaingateway не может восстановить приватный ключ кошелька, если пароль утерян. Экспортируйте ключ один раз и храните его в собственном хранилище.
Нужен ли вебхукам пароль кошелька?
Нет. Вебхук следит за адресом и требует только адрес, URL и фильтр. Пароль нужен для подписи транзакций, экспорта ключа и смены пароля.
Можно ли смешивать кошельки с паролем и без защиты?
Да. Каждый адрес создаётся либо с паролем, либо без него. В запросе передавайте либо password, либо privatekey, как описано в файле OpenAPI для эндпоинтов транзакций.
Готовы собрать это сами? Получите свой API-ключ — 7-дневный пробный период, без карты — или посмотрите API Tron для полного справочника по эндпоинтам.