← Блог
10 мин чтения
|
Опубликовано
|
Обновлено

Кошельки Tron с защитой паролем через API

Создавайте кошельки Tron с паролем, чтобы API никогда не возвращал приватный ключ. Как создать адрес, отправить с него, экспортировать ключ и сменить пароль.

Главы
C
Chaingateway Team
Эксперты по блокчейну

Проверил(а) Maurice Sobiera

Кошелёк Tron с защитой паролем — это адрес, который вы создаёте через API Chaingateway с параметром password. Приватный ключ шифруется этим паролем и не возвращается в ответе. Чтобы отправить средства с адреса, вы передаёте пароль вместо ключа. Chaingateway не хранит пароль, поэтому утерянный пароль восстановить нельзя.

Что изменилось с кошельками, защищёнными паролем?

До 18 февраля 2025 года адреса Tron, созданные через API, возвращали приватный ключ в ответе. Это подходит для временных адресов, но ключ остаётся в ваших логах, базе данных и во всех системах, которые работают с ответом. Альтернатива — кошельки с защитой паролем. Документация по управлению кошельками называет их рекомендуемым способом и описывает ключ как зашифрованный вашим паролем и собственными механизмами шифрования Chaingateway. Небезопасный вариант тоже сохраняется: если не передать password, вы получаете приватный ключ напрямую и должны хранить его сами.

Как создать кошелёк Tron с защитой паролем?

Отправьте POST-запрос на /api/v2/tron/addresses с password:

Terminal window
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:

Terminal window
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/importaddress, privatekey, password

Импорт — это способ перевести существующий незащищённый адрес под защиту паролем. После импорта отправляйте с адреса с паролем и перестаньте передавать ключ. Удалите ключ из собственного хранилища, когда проверите тестовый перевод в тестовой сети. Экспорт — это запасной выход: он позволяет уйти из сервиса с вашим ключом, и для него нужен пароль.

Каковы ограничения защиты паролем?

Аккаунтом Tron управляет его приватный ключ, как сказано в документации Tron, поэтому защищать нужно именно ключ. Пароль защищает ключ в состоянии покоя. Он не защищает от компрометации сервера, который уже знает пароль, и не помогает при утере пароля. По данным документации, Chaingateway не может восстановить кошелёк, если пароль утерян. Сделайте резервную копию пароля и один раз проверьте экспорт, прежде чем переводить реальные средства. Крупные суммы держите в кошельке, ключ которого у вас на руках, а кошельки API используйте как горячие с ограниченным балансом.

Перед переводом реальных средств пройдите этот контрольный список:

  1. Создайте кошелёк в тестовой сети и отправьте небольшой перевод с паролем.
  2. Экспортируйте приватный ключ один раз и убедитесь, что он соответствует адресу.
  3. Смените пароль и убедитесь, что отправка со старым паролем не проходит, а с новым работает.
  4. Храните пароль в менеджере секретов и уберите его из истории оболочки и логов.

Начните с тестовой сети. Добавьте заголовок 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 для полного справочника по эндпоинтам.

C
Chaingateway Team
Эксперты по блокчейну

Команда Chaingateway стремится упростить интеграцию блокчейна для разработчиков по всему миру.