如何在 TON 区块链上用 FunC 和 Blueprint 部署红包智能合约（第二部分）

riyad

! N9 Q! r# n' x% s8 S在上篇教程中，我分享了如何用 FunC 和 Blueprint 编写并编译一个红包智能合约。今天，我们将把这个合约部署到 TON 测试网，使用 测试币 来完成部署过程。这篇教程将详细介绍如何通过 Telegram 机器人 @testgiver_ton_bot 获取测试币、配置环境并成功部署合约。让我们开始吧！
前提条件
" C8 h+ W# N5 E部署到测试网需要以下准备：

• 完成第一部分：你已经编写并编译了红包合约（参考上一教程）。
• 测试网 TON 币：我们将通过 @testgiver_ton_bot 获取免费测试币。
• 测试网钱包助记词：一个 TON 测试网钱包的 24 字助记词，用于支付部署费用。
  

获取测试币
. A/ u. M1 ?. n! N" \* @' @由于这是测试网，我们需要测试币来支付部署费用。以下是通过 @testgiver_ton_bot 获取测试币的步骤：
2 x7 V, {1 z% J8 H9 j# |  a4 w" p创建测试网钱包：

• 下载 TON Wallet 或使用支持测试网的钱包。
• 切换到测试网模式（例如在 wallet.ton.org 上启用 ?testnet=true）。
• 生成新钱包并保存 24 字助记词。
  

3 g! Z$ p. u, z; D& v. {访问 @testgiver_ton_bot：
& \+ s. H) L# m( [1 j9 N6 M& U

• 打开 Telegram，搜索 @testgiver_ton_bot 并启动它。
• 点击 “Start” 开始使用。
  

% D$ y. V1 A/ R) v6 u; X领取测试币：
4 U2 o6 X  M6 y! w+ T: Y

• 在机器人界面点击 [ GET 2 TON ]。
• 返回你的测试网钱包，点击 “Deposit”（存款），复制钱包地址。
• 在机器人中完成验证码（captcha），粘贴你的钱包地址。
• 提交后，你将收到 2 TON 测试币（每小时可领取一次）。
• 如果需要更多测试币，可以在 TON 开发者社区（如 @tondev_eng）请求帮助。
  

) s9 p# j5 v5 ]4 ]4 `! q" C3 S& g步骤 1：配置测试网环境
$ W' t8 g& q6 ~. s8 g! v; g我们将使用 TypeScript 和 TON SDK 连接测试网并部署合约。
$ g; }7 Q- {, V; b+ w- k- C安装依赖： 在项目根目录运行：
0 k/ T  r. `& t9 }4 n" I' f8 z

1. npm install @ton/ton @ton/crypto @ton/core dotenv

复制代码

1. MNEMONIC="word1 word2 word3 ... word24"

复制代码

注意：这是测试网助记词，仅用于测试环境。

6 P( b# s6 E9 @步骤 2：编写测试网部署脚本

我在 scripts/deploy.ts 中编写了部署逻辑，以下是完整代码和说明：

1. import { TonClient, WalletContractV4, toNano, Address, Sender } from "@ton/ton";
   ' V, y% @  T, s
2. import { mnemonicToWalletKey } from "@ton/crypto";
   0 t" B- p/ x  l$ ]2 T) f) c, f/ L3 |
3. import { Cell, beginCell, SendMode } from "@ton/core";
   
4. import { RedPacket, redPacketConfigToCell } from "../wrappers/RedPacket";
   # F7 C( J7 d# c% B$ p: l6 o
5. import * as dotenv from "dotenv";
   " [  N# P5 @- [/ p: p9 s9 k
6. 
   
7. dotenv.config();
   ! l/ T7 r5 }% }3 [$ V
8. 
   ' c& f/ o" s# u' l& K; v& x
9. async function main() {
   
10.   // 从 .env 加载测试网助记词
    
11.   const mnemonic = process.env.MNEMONIC;
    
12.   if (!mnemonic) {
    % f7 N2 w4 R5 e% t$ g8 G
13.     throw new Error("请在 .env 文件中设置测试网 MNEMONIC");
    ) A. x: b( W# h. Y
14.   }
    8 O/ O* t" ^- E# O1 ]
15. 
    
16.   // 将助记词转换为钱包密钥
    
17.   const key = await mnemonicToWalletKey(mnemonic.split(" "));
    
18. 
    
19.   // 初始化 TON 测试网客户端
    
20.   const client = new TonClient({
    9 m4 T& O& z! I" l( P
21.     endpoint: "https://testnet.toncenter.com/api/v2/jsonRPC", // 测试网节点
    
22.   });
    
23. 
    
24.   // 创建 V4 版本钱包（测试网）
    
25.   const wallet = WalletContractV4.create({
    - v6 D& C/ Z5 O
26.     publicKey: key.publicKey,
    
27.     workchain: 0, // 测试网使用基础链
    8 t3 ~$ j( O5 `! m! ]8 z
28.   });
    
29. 
    
30.   // 打开钱包合约
    : K7 a/ f5 D* F; Z5 t- J
31.   const walletContract = client.open(wallet);
    : F7 d" U3 ?3 F
32. 
    0 w1 i2 x6 {/ |" P; _
33.   // 获取测试网钱包地址和余额
    ) h- c/ |$ z: R' J; w. i0 N
34.   const walletAddress = walletContract.address.toString();
    9 s1 q, s& x6 j, s$ }1 I& ^
35.   console.log("从测试网钱包部署:", walletAddress);
    * R$ v7 y+ }: g! ]
36. 
    5 x% P/ P" V9 s/ a! c0 p
37.   const balance = await walletContract.getBalance();
    - C& u5 l) [% P
38.   console.log("测试网钱包余额:", balance.toString(), "nanoTON");
    
39. 
    - \8 v9 M) u+ r( U; e* M  X% w, Y
40.   // 检查余额是否足够（至少 0.5 测试 TON）
    
41.   if (balance < toNano("0.5")) {
    1 S- v' F# Z6 ^0 U
42.     throw new Error("测试网余额不足，至少需要 0.5 测试 TON 用于部署");
    
43.   }
    
44. 
    0 ]7 W1 f! S) N# {, B0 ]
45.   // 加载编译后的合约代码
    ' Y4 Z3 t6 r2 Z. M, ~' T2 Q
46.   const compiledJson = require("../build/RedPacket.compiled.json");
    
47.   const code = Cell.fromBoc(Buffer.from(compiledJson.hex, "hex"))[0];
    1 }' Z+ X7 a' s
48. 
    
49.   // 初始化红包合约（无初始配置）
    
50.   const config = {};
    
51.   const redPacket = RedPacket.createFromConfig(config, code, 0); // workchain 0
    
52.   const redPacketAddress = redPacket.address;
    & @6 S, H$ T, U1 o5 m  O4 ]
53. 
    ) J1 M( K3 F/ q& s2 M
54.   // 创建 Sender 对象
    ! d3 R* d. R$ N+ C' V! o. [
55.   const sender: Sender = walletContract.sender(key.secretKey);
    
56. 
    9 j# @1 m8 _; p# u& g% g) C
57.   // 部署合约到测试网
    
58.   const deployAmount = toNano("0.1"); // 部署费用 0.1 测试 TON
    
59.   console.log("部署合约到测试网地址:", redPacketAddress.toString());
    
60. 
    ' c7 h, J/ r- _% v
61.   const provider = client.open(redPacket) as any; // 类型转换简化处理
    
62.   await redPacket.sendDeploy(provider, sender, deployAmount);
    9 M* f: o: w8 u: ~
63. 
    
64.   console.log("测试网部署交易已发送，等待确认...");
    * v" k& _6 i& z: T
65. 
    
66.   // 轮询检查部署状态
    ! x* C' Q+ g4 N1 n/ N' K* A; z' g& [
67.   let isDeployed = false;
    & I; _$ Q  K- q7 h
68.   for (let i = 0; i < 10; i++) {
    / W& i9 u. g$ O1 B/ J
69.     const state = await client.getContractState(redPacketAddress);
    5 H9 u- `8 j; L
70.     if (state.state === "active") {
    
71.       isDeployed = true;
    
72.       break;
    
73.     }
    " O1 t/ `5 u1 f* P
74.     console.log("等待测试网部署... 第", i + 1, "次尝试");
    3 u! B2 e% }5 d; _) s& q/ |5 w5 B4 V
75.     await new Promise((resolve) => setTimeout(resolve, 3000)); // 等待 3 秒
    
76.   }
    2 p2 T5 g- f9 l& l1 o
77. 
    
78.   if (isDeployed) {
      U: J) m. V) c  a* E2 c$ B* C
79.     console.log("合约成功部署到测试网，地址:", redPacketAddress.toString());
    
80.   } else {
    * R' }( N4 {+ s$ d. S  |: _2 @# {7 l
81.     console.log("测试网部署可能失败或耗时较长，请检查地址:", redPacketAddress.toString());
    
82.   }
    
83. }
    - r, o! x2 F& Q6 p9 f
84. 
    ) S0 O3 P) S( R1 u
85. main().catch(console.error);

复制代码

代码说明

• 加载测试网助记词：从 .env 获取测试网钱包助记词。
• 生成密钥：将助记词转为公私钥对。
• 连接测试网：使用 TonClient 连接 TON 测试网节点。
• 创建测试网钱包：初始化 V4 版本钱包，检查余额（需至少 0.5 测试 TON）。
• 加载合约代码：读取编译后的代码。
• 初始化合约：生成红包合约实例和测试网地址。
• 部署到测试网：发送 0.1 测试 TON 部署合约。
• 确认部署：轮询检查合约状态变为 "active"。
  ' i4 l7 j2 D, U# k( Z- b! B7 b8 A

步骤 3：运行部署脚本
0 D3 I# _  z$ g- o) n$ q( W安装依赖：
/ P% G( V: n& U7 h. D

1. npm install

复制代码

执行部署：

1. npx ts-node scripts/deploy.ts

复制代码

输出示例：

1. 从测试网钱包部署: EQ...xyz
   
2. 测试网钱包余额: 2000000000 nanoTON
   6 X( Q# B( Q+ {
3. 部署合约到测试网地址: EQ...abc
   & b  x+ E, P  h" P9 s1 X
4. 测试网部署交易已发送，等待确认...
   
5. 合约成功部署到测试网，地址: EQ...abc

复制代码

+ N# H+ d5 S! }+ E. \  @6 I6 v/ e5 e下一步计划
合约已部署到测试网，接下来我计划：
' }, `8 X8 [  g1 K, m# Q/ r

• 测试交互：用测试币测试创建和领取红包。
• 前端开发：做一个界面，让用户在测试网上体验红包功能。
  & c- u0 m9 t% `0 B; l$ u

" H6 v  t4 h3 A, E) w% m6 x总结
这篇教程展示了如何通过 @testgiver_ton_bot 获取测试币并将红包合约部署到 TON 测试网。测试网为我们提供了一个免费的实验环境，完整代码已分享，你可以跟着部署自己的合约。如果测试币领取有问题或部署失败，欢迎留言交流！下次我会分享如何在测试网上与合约交互，敬请期待！