从零开始：45 分钟学会在 TON 链上挖掘首个 NFT

关键词：TON、智能合约、区块链入门、NFT 挖掘、Tonkeeper 钱包、TypeScript SDK、测试网、主网

“TON 的异步思维就像海浪，把每一次交易都推向下一个区块。”

🛳 你将收获什么

在这条 45 分钟 的新手友好路径里，你能完成：

安装并启用 Tonkeeper 钱包（支持测试网与主网）。
使用 Testnet 水龙头 领取免费 TON 代币。
理解 智能合约地址、Cell 与 PoW 复杂度，掌握 NFT 挖掘的核心原理。
借助 TypeScript SDK 与 toncenter API 调用链上数据。
编译并广播第一条 挖掘 NFT 的交易，成本仅 0.05 TON。

👉 点击体验在 30 秒内启动云端 IDE，直接开干！

一、新手必备环境 5 分钟搞定

1.1 钱包准备

iOS / Android：去应用商店搜索 Tonkeeper → 安装 → 设置 → Advanced → Testnet Mode ON。

1.2 模板仓库

登录 GitHub → 访问 ton-onboarding-challenge → “Use this template”。
创建私有仓库，方便后续版本管理。

1.3 运行环境

云开发（推荐）
打开仓库 → Code → Create codespace on master → 自动拉起 VSCode Online。

本地开发

git clone <your-template-repo>
cd <repo>
npm install

二、链上连接：获取挖矿参数

2.1 三行代码拿到最新数据

// scripts/mine.ts
import { TonClient, Address } from "@ton/ton";

const client = new TonClient({
  endpoint: "https://testnet.toncenter.com/api/v2/jsonRPC",
});

const collection = Address.parse("YOUR_COLLECTION_ADDR");
const miningData = await client.runMethod(collection, "get_mining_data");

2.2 解析关键参数

const complexity = miningData.stack.readBigNumber();
const seed = miningData.stack.readBigNumber();

👉 查看完整示例与注释，帮你 1 秒定位错误！

三、创建 NFT Miner：用代码迎接随机挑战

3.1 挖矿消息结构

import { Queries, MineMessageParams } from "../wrappers/NftGiver";

const mineParams: MineMessageParams = {
  expire: unixNow() + 300,
  mintTo: walletAddress,
  data1: 0n,
  seed,
};

let msg = Queries.mine(mineParams);

3.2 工作量证明循环

while (bufferToBigint(msg.hash()) > complexity) {
  mineParams.data1 += 1n;
  msg = Queries.mine(mineParams);
}
console.log("💎 找到有效哈希！");

四、签名广播：把第一枚 NFT 收入囊中

4.1 Testnet 版完整流程

在 t.me/testgiver_ton_bot 领取 10 Test TON。
npm start 初始化 Blueprint，让终端弹出一个二维码。
Tonkeeper → 扫描 → 确认交易 → 30-60 秒后，钱包里出现 “Rocket NFT”。

4.2 主网操作（多两小步）

将 endpoint 改成主网：https://toncenter.com/api/v2/jsonRPC。
使用 主网钱包地址，确保余额 ≥ 0.1 TON（NFT 手续费 + gas）。

❓ 常见问题解答

Q1. 以太坊不是也能挖 NFT 吗？TON 有啥不同？
A：TON 使用 异步消息 + Bag of Cells 架构，同样 gas 更低（0.05 TON ≈ 0.005 USD）、出块更快（≈5 秒）。

Q2. Testnet 水龙头领不到币怎么办？
A：请确认 Tonkeeper 开启 Testnet Mode；如仍排队，加入 Telegram 群 @tondeveng 领取帮助。

Q3. 为何每次部署前要重新获取 seed？
A：seed 变化是 PoW 共识 的反垃圾机制，每隔成功一次就会更新，防止重复利用老哈希。

Q4. 想给 NFT 改图可以吗？
A：可以！这属于 Metadata 可升级 NFT，教程的挖矿合约预留了升级接口，后续可参考官方 NFT-Editable 模板。

Q5. 我必须用 toncenter 的 RPC 吗？
A：不是，任何支持 HTTP JSON-RPC 的 TON 网关都行；只需保持一致、低延迟即可。

🧙 进阶路线图

完成本篇后，你已经拿到 TON DeFi 通行证。下一步：

探索 TON 支付通道 —— 零费转账、秒级确认。
学习 FunC 语法，发布自定义 智能合约。
结合 Telegram Bot API，打造 NFT 游戏或打赏机器人。

欢迎把你的 Rocket NFT 截图晒到 Twitter 并打上 #TON45minChallenge 标签，成为社区榜样！