通过 API 创建受密码保护的 Tron 钱包
通过 API 创建带密码的 Tron 钱包,使 API 永不返回私钥。本文说明如何创建受密码保护的地址、从中转出资金、导出私钥、更改密码,以及将已有的未设密码地址迁移到密码保护之下,并说明密码丢失的后果,最后给出测试网上的检查清单。
审核: Maurice Sobiera
受密码保护的 Tron 钱包是通过 Chaingateway API 并附带 password 参数创建的一个地址。私钥会用该密码加密,且不会在响应中返回。若要从该地址转出资金,请传入密码而非私钥。Chaingateway 不保存密码,因此丢失的密码无法找回。
受密码保护的钱包有哪些变化?
直到 2025 年 2 月 18 日,通过 API 创建的 Tron 地址都会在响应中返回私钥。这对临时地址来说没有问题,但它会让私钥留在您的日志、数据库以及每个接触该响应的系统中。受密码保护的钱包是另一种选择。钱包管理文档称其为推荐方式,并说明私钥使用您的密码以及 Chaingateway 自有的加密机制进行加密。不设密码的版本仍然存在:如果您省略 password,就会直接拿到私钥,您必须自行保存。
如何创建受密码保护的 Tron 钱包?
向 /api/v2/tron/addresses 发送附带 password 的 POST 请求:
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。如果地址上没有 TRX 或质押的能量,TRC20 转账会以状态 422 失败,TronFuel 与 Paymaster 教程对此有所说明。Chaingateway Paymaster 已弃用,支付手续费的推荐方式是 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 钱包则作为余额有限的热钱包使用。
在转入真实资金之前,请执行以下检查清单:
- 在测试网上创建一个钱包,并使用密码发送一笔小额转账。
- 导出一次私钥,并确认其与该地址相符。
- 更改密码,并确认使用旧密码的转账失败、使用新密码的转账成功。
- 将密码保存在您的密钥管理器中,并从 Shell 历史记录和日志中删除它。
请先在测试网上操作。在上述每个请求中添加请求头 X-Network: testnet,在 Nile 上创建一个钱包,并依次完成创建、转账、导出和更改密码。支持的网络页面列出了测试网,Tron 网络文档说明了 Nile 和 Shasta。
最常见的问题有哪些?
密码钱包能用于其他链吗?
可以。钱包管理文档描述了 /api/v2/{blockchain}/addresses 的 password 参数,OpenAPI 文件则列出了以太坊、BNB Smart Chain、Polygon 和 Arbitrum 上采用相同模式的地址端点。
Chaingateway 能重置丢失的密码吗?
不能。文档指出,Chaingateway 无法恢复密码已丢失的钱包的私钥。请导出一次私钥,并将其保存在您自己的保险库中。
Webhook 需要钱包密码吗?
不需要。Webhook 监控的是地址,只需要地址、URL 和过滤条件。密码用于签署交易、导出私钥和更改密码。
我能否同时使用受密码保护的钱包和未设密码的钱包?
可以。每个地址要么在创建时设置密码,要么不设。在请求中,请传入 password 或 privatekey 之一,具体如 OpenAPI 文件所述的交易端点那样。
准备好自己动手构建了吗? 获取你的 API key — 7 天试用,无需信用卡 — 或查看 Tron API 获取完整的 endpoint 参考。