路线 0:完全初学者

从 TRON 基本对象和测试账户开始,在 Shasta 上完成并确认第一笔 TRX 转账。

本路线可以作为了解 TRON 的起点,适合第一次接触 TRON 或区块链的开发者。

可以从这条路线了解什么

这条路线从 账户、地址、Token(链上表示价值或权益的数字资产)、区块 和 交易 等基本对象出发,依次介绍 测试网、资源 和交易确认,并通过一笔 TRX 转账把这些概念连接起来。

路线以在 Shasta 测试网 完成并确认第一笔 TRX 转账为贯穿任务。实践将从准备测试账户开始,经过领取测试 TRX、理解转账所需的 签名 与 Bandwidth,最后发送交易,并保存交易 ID(txID),用于查询 执行结果和固化状态。

如果希望一边阅读一边实践,可以跟随各阶段的实践任务,逐步完成这笔转账。整个过程只使用测试账户和测试 TRX,不涉及真实资产。

开始前不必掌握区块链或 TRON 的相关概念。可以先通过下方概览了解各阶段的重点,再按照文档逐步实践;遇到不熟悉的术语或操作时,再回到推荐阅读补充所需信息。

路线概览

阶段主要内容第一笔转账中的任务
1. 认识 TRON 的基本对象了解账户、地址、Token、区块、交易、主网和测试网之间的关系梳理一笔 TRX 转账从账户发起到进入区块的基本流程
2. 准备测试账户了解钱包、私钥、地址和测试网之间的关系创建仅用于 Shasta 的发送和接收账户,并为发送账户领取测试 TRX
3. 理解资源与交易了解 TRX、sun、Bandwidth、签名和交易生命周期核对转账金额、账户资源和交易授权方式
4. 发送并确认交易了解交易构造、签名、广播、执行和固化发送 TRX,保存 txID,查询链上结果并记录资源消耗

开始前

本路线没有区块链知识方面的前置要求。如需完成阶段实践,请准备仍在维护期内的 Node.js LTS 版本、npm,以及能够运行 Bash 或 Zsh 命令的终端。阶段 2 将创建两个仅用于 Shasta 的测试账户;这些账户的 私钥和助记词 不应与主网账户共用,也不应提供给他人或写入公开文档和版本库。

本路线主要梳理各阶段的核心知识,并通过相关文档呈现第一笔 TRON 交易的整体脉络。具体命令、代码和操作步骤请参考 发送第一笔交易。

路线阶段

1. 认识 TRON 的基本对象

开始第一笔转账前,可以先了解账户、地址、Token、交易和区块之间的关系。账户由地址标识,并通过对应的私钥授权交易;TRX 是 TRON 网络的原生 Token;交易是账户发出的链上指令;区块则记录已经被网络打包的交易。

这些对象运行在具体的网络中。Mainnet 承载真实资产,Shasta 用于本路线的测试,不同网络的账户状态和交易记录彼此独立。本路线后续领取和转出的都是没有财务价值的 Shasta 测试 TRX。

推荐阅读

  1. 什么是 TRON — 核心特性与 TRX

    阅读“核心特性”和紧随其后的“TRX:原生 Token”,理解出块、资源、智能合约和 TRX 的基本作用;本阶段不需要继续打开其中的进阶链接。

  2. 架构概览 — 应用层

    先了解钱包和应用如何通过 SDK 或接口连接节点。交易如何被广播、打包和固化将在阶段 3 集中阅读。

  3. 网络 — Shasta 测试网

    只需核对 Shasta 的 HTTP endpoint、水龙头和区块浏览器;Mainnet 节点、Nile 和私有网络不属于本路线的第一次转账任务。

阶段实践

以即将完成的第一笔转账为对象,先梳理发送账户、接收地址、TRX、交易、区块和 Shasta 之间的关系。此时不需要发送交易,重点是确认哪些内容由账户提供、哪些内容会写入链上,以及为什么实践应在测试网上完成。

准备测试账户前:先确认能够区分账户、地址和钱包,并了解 Shasta 与 Mainnet 的用途不同。下一阶段将创建只用于 Shasta 的测试账户。

2. 准备测试账户

账户由私钥控制,地址用于识别账户和接收资产。钱包可以帮助生成和管理密钥、展示链上余额并请求交易签名,但资产记录在链上,并不保存在钱包软件中。任何获得私钥或助记词的人都可以控制对应账户,因此测试账户也需要遵守基本的密钥安全要求。

第一笔转账需要一个发送账户和一个接收地址。发送账户需要持有足够的测试 TRX,接收地址则用于核对转账结果。测试 TRX 可以通过 Shasta 水龙头 领取,仅用于学习、开发和调试。

推荐阅读

  1. 账户与密钥 — 地址格式与密钥对 和 钱包与账户 — 钱包与账户的关系

    在账户页读完“地址格式”和“密钥对”后停止;在钱包页理解钱包只管理密钥、不保存资产,再查看 安全实操要点 中的下载、备份和防钓鱼要求。

  2. 领取测试网 Token — 水龙头网站

    按“水龙头网站”的步骤选择 Shasta 入口,并读完“关键约束”;只有网站水龙头不可用时,才需要继续查看 TronFAQBot 等备选方式。

阶段实践

完成 发送第一笔交易 的第一步至第三步:安装教程指定的 TronWeb 版本,生成仅用于 Shasta 的发送账户和接收账户,并记录各自的 Base58Check 地址。妥善保存两组私钥,只向发送账户申请测试 TRX。随后运行 查询 TRX 余额与资源,确认发送账户的测试 TRX 余额已经更新,并记录当前可用的 Bandwidth。

新生成的接收地址在收到第一笔 TRX 前可能还没有链上账户状态;向这类地址转账会同时激活账户,发送方还需要承担 账户创建费用 及相关 Bandwidth 成本。TRON 各网络使用相同的地址格式,后续查询和广播都必须继续使用 Shasta endpoint。私钥只用于本地签名,不应粘贴到网页、聊天工具或版本库中。

理解交易成本前:确认当前网络为 Shasta,发送账户已经收到测试 TRX,并已准备好接收地址。下一阶段将根据这组信息核对转账金额、签名和资源消耗。

3. 理解资源与交易

TRX 转账不仅包含发送地址、接收地址和金额,还需要由发送账户签名。金额在底层交易中以 sun 表示,1 TRX 等于 1,000,000 sun。签名用于证明发送账户同意这笔转账,私钥本身不应随交易发送到网络。

向已激活账户发送的普通 TRX 转账主要消耗 Bandwidth,不消耗用于智能合约执行的 Energy。账户可以使用免费 Bandwidth、质押获得的资源或他人代理的资源;Bandwidth 不足时,网络会从账户余额中燃烧 TRX 支付资源成本。如果接收地址尚未激活,还需要另外计入账户激活成本;相关费用由当前链参数决定。

一笔交易会经历 构造、签名、广播、打包和固化 等阶段。广播调用未返回错误,不证明节点仍保留或已传播该交易,也不证明交易已经进入区块或完成固化。

推荐阅读

  1. 资源模型 — 带宽

    重点了解普通 TRX 转账为什么消耗 Bandwidth,以及免费额度、质押、资源代理和燃烧 TRX 这几种支付来源;其他资源章节可在进入合约或治理路线时再读。

  2. 交易 — 交易生命周期

    阅读创建与签名、广播与校验、打包进区块和区块固化四个阶段;交易结构、过期时间、TAPOS 和 API 留到需要手动构造或排查交易时再读。

阶段实践

发送前,记录目标网络、发送地址、接收地址和转账金额,并把 TRX 金额换算为 sun。运行 查询 TRX 余额与资源,核对账户的 TRX 余额和可用 Bandwidth,并使用其中的 sun ↔ TRX 换算确认转账金额。查询接收地址是否已激活,再确认余额足以覆盖转账金额、资源成本和可能的账户激活成本。签名只在本地使用发送账户的测试私钥完成。

这一阶段先不发送交易。完成准备后,应能够说明这笔转账由谁授权、会消耗什么资源,以及下一阶段广播后为什么还需要继续查询链上状态。

发送交易前:确认转账网络、发送地址、接收地址和金额无误,并了解签名与 Bandwidth 在这笔交易中的作用。下一阶段将构造、签名并广播同一笔交易。

4. 发送并确认交易

准备工作完成后,可以按照教程构造 TRX 转账,使用发送账户的测试私钥在本地签名,并在广播前保存已签名交易的 txID,再把同一笔交易提交到 Shasta。这样即使广播请求报错或结果未知,也可以继续查询原交易,而不必立即重新构建另一笔转账。

取得 txID 并不是转账流程的终点。交易广播后,还需要查询它是否已经进入区块、执行是否成功以及所在区块是否已经固化。发送地址、接收地址、金额、交易结果和资源消耗也应与发送前记录的信息一致。

推荐阅读

  1. 发送第一笔交易 — Shasta 完整实践

    继续完成第四步和第五步,使用阶段 2 已准备的发送账户与接收账户,不要重新生成账户。只有使用 Java 时才读 Trident 示例;底层链路解析可在操作成功后选读。

  2. TRONSCAN — Web 界面

    重点了解如何用 txID 搜索交易,并在详情页核对状态、金额、区块和资源消耗;API、MCP、SKILLS 和 CLI 本阶段无需阅读。

  3. 发送第一笔交易 Recipe

    Recipe 是教程第四步的替代实现。已完成账户和测试 TRX 准备时,可以选择运行页面顶部代码,再查看“在 TRONSCAN 上验证”和“常见错误”;同一次实践不要同时运行教程和 Recipe 中的两套发送代码。

阶段实践

选择 发送第一笔交易 的第四步或对应 Recipe,使用阶段 2 准备的两个账户完成一笔 Shasta TRX 转账。签名后、广播前保存生成的 txID;不要为同一次实践同时运行两套发送代码。随后在 Shasta TRONSCAN 中搜索该 txID,核对发送地址、接收地址、金额、所在区块和执行结果。

如果需要通过节点接口判断交易是否已经执行并最终固化,先阅读 确认语义,避免把广播响应误当成最终成功。对完全初学者,本路线以 Shasta TRONSCAN 作为主要验证入口;查询期间应始终使用同一个 txID。

记录这笔交易的 txID、执行结果、所在区块和资源消耗,并比较转账前后的账户余额。如果交易暂时无法查询,应继续使用原 txID 检查状态,不要立即重复发送;超过正常等待时间仍未出现时,按照 广播后查询不到交易时,如何安全重试? 中的步骤排查。

验证实践结果:确认 Shasta 上已经存在一笔执行成功并完成固化的 TRX 转账。保存的记录应包含 txID、发送地址、接收地址、金额、执行结果和资源消耗。

后续实践与扩展

完成第一笔转账后,可以继续通过 TRONSCAN——区块链浏览器与数据平台 查看账户、区块和其他交易,或者阅读 Token 标准概览,了解 TRX 与 TRC-10、TRC-20、TRC-721 和 TRC-1155 的区别。

当前路线建立的是各类开发角色共同需要的基础。接下来可以回到 按角色划分的阅读路线,根据目标选择钱包、DApp、智能合约、节点或其他角色路线。

如果暂时只完成了其中一部分,可以保留测试账户地址、当前余额和已经记录的 txID,之后再从相应阶段继续。测试私钥和助记词不应写入学习记录。

如果某个阶段仍然无法继续,请 提交路线反馈,选择“报告某一页的具体错误”,并填写当前页面链接、所在阶段、已经完成的步骤和实际错误信息;不要提交私钥或助记词。