TON 区块链入门：从钱包到现场转账的 Hello World 完整指南

核心关键词：TON 钱包、TON 智能合约、主网与测试网、TON 区块浏览器、TON SDK、24 个助记词、24 字恢复短语、TON 转账、TON NFT

为什么从 TON 钱包开始最能降低门槛

在 TON 区块链上，钱包本身就是一个能执行代码的智能合约。只要把钱包地址弄懂、把转账跑通，你就同时理解了「账户—合约」双层结构和手续费模型。接下来的开发，无论是发币、部署 NFT 还是写机器人，都只是换种方式与同一个底层交互。因此本文先用一条 Hello World 级示例链 带你从 0 到 1 完成「创建钱包 → 充值 → 部署 → 转账 → 查链」全流程，并用代码复现所有操作。

主网还是测试网？一分钟做出选择

主网特点：真实 TON 币、高安全性、真实用户与资产；单笔 gas 仅 ~0.01 美元。
测试网特点：免费领测试币、随时重置、不稳定、调试时偶有 500 错。

实测经验：如果你只想验证逻辑，5 美元主网预算 足够跑上百笔交易，省去测试网 faucet 等候和可能的重放失败。下文默认先主网，如需切测试网只需在 Tonkeeper 里连击 Logo 5 次即可。

👉 想直接跳到主网部署的避坑清单？点击查看

步骤 1：3 分钟创建 TON 钱包

下载 Tonkeeper（iOS / Android 均可）。
选择「创建新钱包」，按部就班即可。
立刻抄写 24 字恢复短语，任何截图、网盘、聊天工具保存都属高危。

小贴士：词表里全是英文单词，顺序不能乱；建议金属铭牌或高强度纸笔离线保管。

步骤 2：给钱包「充气」并触发第一次部署

把地址粘贴到 OKX / Binance / Kucoin TON 提币页面，首次至少提 1 TON。
打开 Tonscan 查询地址：
- 刚入账显示 Inactive，余额可见但未触发合约上链。
用 Tonkeeper 转出 0.01 TON 到任何地方（可回自己另一地址）——这笔交易会在链上 自动部署 钱包合约，状态即变 Active。

步骤 3：浏览器深度查账

刷新 Tonscan，现在可以看到：

状态：Active
合约类型：wallet v4 r2（或 v3 等版本）
历史交易列表中多出 out 记录，点开即见手续费与脚本哈希。
同一 24 个助记词可派生多个版本钱包地址，因此见到余额归零不要慌张，先核对版本号。

步骤 4：本地开发环境 5 行命令搞定

安装 Node.js v18+
项目目录执行：npm i -D typescript && npx tsc --init

继续安装 SDK：

npm install @ton/ton @ton/crypto @ton/core @orbs-network/ton-access

IDE 推荐 VS Code + TON 代码高亮插件，开箱即用。

步骤 5：离线生成地址验证一致性

将 24 个助记词填进 step7.ts（核心代码见下），终端 npx ts-node step7.ts。打印出来的地址与 Tonkeeper、Tonscan 完全一致，就证明 publicKey↔地址 计算无悬念。

import { mnemonicToWalletKey } from "@ton/crypto";
import { WalletContractV4 } from "@ton/ton";

const mnemonic = "unfold sugar ..."; // ←替换成你的24词
(async () => {
  const { publicKey } = await mnemonicToWalletKey(mnemonic.split(" "));
  const wallet = WalletContractV4.create({ publicKey, workchain: 0 });
  console.log("地址(主网):", wallet.address.toString());
})();

步骤 6：实时读链——余额 & seqno

上方的 step8.ts 通过 @orbs-network/ton-access 免费 RPC 读链，展示：

getBalance：实时余额（分单位转 TON）
getSeqno：最新交易序号，发转账时填入防重放。

运行示例：npx ts-node step8.ts

👉 想体验首次链上查询却不想搭环境？先把脚本跑起来再说

步骤 7：链上写操作——发 0.05 TON 并收 NFT 奖励

step9.ts 最关键几行：

await walletContract.sendTransfer({
  secretKey: key.secretKey,
  seqno,
  messages: [
    internal({
      to: "EQA4V9tF4lY2S_J-sEQR7aUj9IwW-Ou2vJQlCn--2DLOLR5e",
      value: "0.05",
      body: "Hello TON",
      bounce: false,
    }),
  ],
});

运行后 Tonscan 会多一条Out Tx，30 秒左右 NFT 就自动空投到当前钱包——打开 Tonkeeper NFT 页即可看到。

FAQ：开发者最常见的六个疑惑

Q：同一助记词能同时存 USDT 和 NFT 吗？
A：完全可以。一个 TON 地址可同时持有 TON、Jetton（USDT 等）、NFT，无需分开生成。
Q：24 个词丢了怎么办？
A：如果私钥也从未导出过，钱包归属权将全部丧失；任何客服都无法帮你找回。
Q：为什么 Tonscan 里地址大写字母会变化？
A：这是 TON 的 友好型地址格式（bounceable / non-bounceable），内容一样，不影响转账。
Q：主网 gas 真的永远这么低吗？
A：网络拥堵时会上浮几倍，但也能通过调整 max_fee 控制上限，极限仍低于以太坊 L2。
Q：可以只用 JavaScript 部署任意智能合约吗？
A：可以。钱包合约本身只是众多合约之一，后续改写 sendDeploy 即可部署自定义 Tact 或 FunC 合约。
Q：有没有浏览器插件签名，免去 24 词泄露风险？
A：借助 TON Connect 协议，你可以把 Tonkeeper 安装在浏览器或手机硬件签名，实现 DApp 免私钥交互。

结语与下一步

走完本文 9 步，你已经具备：

亲手掌控的 主网 TON 钱包
明确主网 & 测试网适用场景
本地 Typescript 全栈调试通道（读 / 写 / 查）

下一步，无论是挖 Jetton 经济模型的精髓，还是对接 DApp 机器人，TON SDK 的这一套流程只需把地址和版本号替换即可。祝你链上旅程顺畅！