← 博客
10 分钟阅读
|
发布于
|
更新于

通过 API 创建受密码保护的 Tron 钱包

通过 API 创建带密码的 Tron 钱包,使 API 永不返回私钥。本文说明如何创建受密码保护的地址、从中转出资金、导出私钥、更改密码,以及将已有的未设密码地址迁移到密码保护之下,并说明密码丢失的后果,最后给出测试网上的检查清单。

章节
C
Chaingateway Team
区块链专家

审核: Maurice Sobiera

受密码保护的 Tron 钱包是通过 Chaingateway API 并附带 password 参数创建的一个地址。私钥会用该密码加密,且不会在响应中返回。若要从该地址转出资金,请传入密码而非私钥。Chaingateway 不保存密码,因此丢失的密码无法找回。

受密码保护的钱包有哪些变化?

直到 2025 年 2 月 18 日,通过 API 创建的 Tron 地址都会在响应中返回私钥。这对临时地址来说没有问题,但它会让私钥留在您的日志、数据库以及每个接触该响应的系统中。受密码保护的钱包是另一种选择。钱包管理文档称其为推荐方式,并说明私钥使用您的密码以及 Chaingateway 自有的加密机制进行加密。不设密码的版本仍然存在:如果您省略 password,就会直接拿到私钥,您必须自行保存。

如何创建受密码保护的 Tron 钱包?

向 /api/v2/tron/addresses 发送附带 password 的 POST 请求:

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。如果地址上没有 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/importaddress、privatekey、password

导入是将已有的、未设密码的地址迁移到密码保护之下的方式。导入之后,请使用密码从该地址转出,并停止传入私钥。在测试网上验证过一笔测试转账后,请从您自己的存储中删除私钥。导出则是退出方案:它让您带着私钥离开该服务,但需要密码。

密码保护有哪些局限?

正如 Tron 文档所述,一个 Tron 账户由其私钥控制,因此需要保护的是私钥。密码保护的是静态存储中的私钥。它无法保护一台已经掌握密码的被入侵服务器,也无法挽救丢失的密码。根据文档,Chaingateway 无法恢复密码已丢失的钱包。在转入真实资金之前,请备份密码,并至少测试一次导出。大额余额应保存在您自己持有私钥的钱包中,API 钱包则作为余额有限的热钱包使用。

在转入真实资金之前,请执行以下检查清单:

  1. 在测试网上创建一个钱包,并使用密码发送一笔小额转账。
  2. 导出一次私钥,并确认其与该地址相符。
  3. 更改密码,并确认使用旧密码的转账失败、使用新密码的转账成功。
  4. 将密码保存在您的密钥管理器中,并从 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 参考。

C
Chaingateway Team
区块链专家

Chaingateway 团队致力于为全球开发者简化区块链集成。