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

riyad

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

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

获取测试币
由于这是测试网，我们需要测试币来支付部署费用。以下是通过 @testgiver_ton_bot 获取测试币的步骤：
创建测试网钱包：

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

) B$ u* d; {5 w; x7 k, w访问 @testgiver_ton_bot：
% a9 q% V# n- A% Y- b0 G! E  q

• 打开 Telegram，搜索 @testgiver_ton_bot 并启动它。
• 点击 “Start” 开始使用。
  : A. b/ c& n+ j( P  a

领取测试币：
7 _+ D, w7 ]+ K; Y# I

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

步骤 1：配置测试网环境
" R  b& W. O* O9 H# V/ F& W我们将使用 TypeScript 和 TON SDK 连接测试网并部署合约。
安装依赖： 在项目根目录运行：
( ~" `' {: G; r& [

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

复制代码

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

复制代码

注意：这是测试网助记词，仅用于测试环境。
4 }2 f! p3 A% u
0 F! |2 c" b$ t2 H" R( f* u- A步骤 2：编写测试网部署脚本
3 x0 G4 c. A* J' m3 L  F% q% z: E
& C7 k- g5 ]9 w2 z$ u* k

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

1. import { TonClient, WalletContractV4, toNano, Address, Sender } from "@ton/ton";
   
2. import { mnemonicToWalletKey } from "@ton/crypto";
   3 w: b" ]" a- S- H0 d" u
3. import { Cell, beginCell, SendMode } from "@ton/core";
   
4. import { RedPacket, redPacketConfigToCell } from "../wrappers/RedPacket";
   
5. import * as dotenv from "dotenv";
   2 F4 Q  @6 x9 A' c2 d0 ]3 Q
6. 
   / y% M. M% P8 u' A0 o
7. dotenv.config();
   
8. 
   4 f$ }6 b; O  O/ v0 o, E, U% O
9. async function main() {
   
10.   // 从 .env 加载测试网助记词
    
11.   const mnemonic = process.env.MNEMONIC;
    
12.   if (!mnemonic) {
    1 y0 J$ x: E1 ^. h" c! g
13.     throw new Error("请在 .env 文件中设置测试网 MNEMONIC");
    0 P: P0 E8 r3 T$ U$ o. o
14.   }
    . t; ?: j. P! p7 s5 ~
15. 
    
16.   // 将助记词转换为钱包密钥
    
17.   const key = await mnemonicToWalletKey(mnemonic.split(" "));
    0 k$ w# G1 c. {8 p) F2 ]
18. 
    
19.   // 初始化 TON 测试网客户端
    / V' Y: n# x, {8 Z& ]4 [& {' F4 U
20.   const client = new TonClient({
    
21.     endpoint: "https://testnet.toncenter.com/api/v2/jsonRPC", // 测试网节点
    1 t: A2 B7 i7 _
22.   });
    
23. 
    
24.   // 创建 V4 版本钱包（测试网）
    2 M. L/ {% |! C6 S/ I  k/ i
25.   const wallet = WalletContractV4.create({
    
26.     publicKey: key.publicKey,
    
27.     workchain: 0, // 测试网使用基础链
    ) m. k$ y3 k; ~  Z" [" m! M9 z
28.   });
    ' r; W! z9 t8 y4 F, t3 R, Q, T6 M
29. 
    
30.   // 打开钱包合约
    
31.   const walletContract = client.open(wallet);
    
32. 
    * D5 W" |1 t% V
33.   // 获取测试网钱包地址和余额
    
34.   const walletAddress = walletContract.address.toString();
    8 p0 v) D/ E1 w# D' e
35.   console.log("从测试网钱包部署:", walletAddress);
    8 _$ v0 H3 R8 s* x8 o
36. 
    / ~9 J9 S; P/ i  [2 j/ W
37.   const balance = await walletContract.getBalance();
    $ L+ Z) O( R6 j* d; ]0 b9 X
38.   console.log("测试网钱包余额:", balance.toString(), "nanoTON");
    
39. 
    
40.   // 检查余额是否足够（至少 0.5 测试 TON）
    
41.   if (balance < toNano("0.5")) {
    4 b3 B$ j5 y* {- E0 @  J
42.     throw new Error("测试网余额不足，至少需要 0.5 测试 TON 用于部署");
      U2 p: j. p8 V4 @9 I( m  [! @( n
43.   }
    ) i. \: g% O* m2 K5 O. c
44. 
    
45.   // 加载编译后的合约代码
    $ p- R$ N1 I* G6 v
46.   const compiledJson = require("../build/RedPacket.compiled.json");
    
47.   const code = Cell.fromBoc(Buffer.from(compiledJson.hex, "hex"))[0];
    / Y3 ~/ I/ w; ?3 o5 C+ e
48. 
    $ k  P8 Y) w$ `/ B2 p
49.   // 初始化红包合约（无初始配置）
    + y3 ]) @( Y3 n! D& M4 o
50.   const config = {};
    " Q+ M) U; R& R$ t# F
51.   const redPacket = RedPacket.createFromConfig(config, code, 0); // workchain 0
    2 s! ?$ W% E: e3 [/ V/ q/ O$ j5 b* e
52.   const redPacketAddress = redPacket.address;
    
53. 
    # Q, h$ t3 N: f5 A! u
54.   // 创建 Sender 对象
    
55.   const sender: Sender = walletContract.sender(key.secretKey);
    % b% c3 k8 T- _' p7 F
56. 
    & O: a. G+ D; V$ I
57.   // 部署合约到测试网
    
58.   const deployAmount = toNano("0.1"); // 部署费用 0.1 测试 TON
    3 V- w5 q/ A6 j+ @2 _. F7 s
59.   console.log("部署合约到测试网地址:", redPacketAddress.toString());
    
60. 
    
61.   const provider = client.open(redPacket) as any; // 类型转换简化处理
    , A( k8 A( i+ G
62.   await redPacket.sendDeploy(provider, sender, deployAmount);
    " M3 B9 ?7 q# J2 t. \
63. 
    ! L+ q0 Z! B+ w3 s( X3 W+ [. ~7 T. Y
64.   console.log("测试网部署交易已发送，等待确认...");
    
65. 
    
66.   // 轮询检查部署状态
    ! e5 d. g0 r7 [& g: l8 _0 M9 U
67.   let isDeployed = false;
    - \6 w# q- V4 L
68.   for (let i = 0; i < 10; i++) {
    
69.     const state = await client.getContractState(redPacketAddress);
    $ d# u+ M  r. }/ p1 E
70.     if (state.state === "active") {
    
71.       isDeployed = true;
    : }' A( `+ @1 y
72.       break;
    
73.     }
    
74.     console.log("等待测试网部署... 第", i + 1, "次尝试");
    
75.     await new Promise((resolve) => setTimeout(resolve, 3000)); // 等待 3 秒
    
76.   }
    
77. 
    
78.   if (isDeployed) {
    ( B+ x2 m, B+ V- c; Z0 @3 t- u
79.     console.log("合约成功部署到测试网，地址:", redPacketAddress.toString());
    
80.   } else {
    
81.     console.log("测试网部署可能失败或耗时较长，请检查地址:", redPacketAddress.toString());
    
82.   }
    ) n7 z5 ~, a; R. Z! a4 j
83. }
    
84. 
    
85. main().catch(console.error);

复制代码

代码说明
; ^4 u' y! t- ]. L) l, N8 y

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

步骤 3：运行部署脚本
安装依赖：

1. npm install

复制代码

执行部署：

1. npx ts-node scripts/deploy.ts

复制代码

输出示例：

1. 从测试网钱包部署: EQ...xyz
   9 v$ X. {; [7 p2 p- N: f
2. 测试网钱包余额: 2000000000 nanoTON
   ; R* `6 W6 J$ a/ G+ {1 v( z
3. 部署合约到测试网地址: EQ...abc
   / _( ~. a% R5 E" g8 y5 ]
4. 测试网部署交易已发送，等待确认...
   
5. 合约成功部署到测试网，地址: EQ...abc

复制代码

% t% j; t8 L9 Y, ?& r* ~5 M下一步计划
合约已部署到测试网，接下来我计划：
% @" t" i1 H$ z. E

• 测试交互：用测试币测试创建和领取红包。
• 前端开发：做一个界面，让用户在测试网上体验红包功能。
  & s/ h& `0 w" k: Q3 \& t5 k$ p

* J" U/ c& y( [3 s$ {& M3 D总结
( M, `. I, y: U5 f' X这篇教程展示了如何通过 @testgiver_ton_bot 获取测试币并将红包合约部署到 TON 测试网。测试网为我们提供了一个免费的实验环境，完整代码已分享，你可以跟着部署自己的合约。如果测试币领取有问题或部署失败，欢迎留言交流！下次我会分享如何在测试网上与合约交互，敬请期待！
0 H, ~9 E9 z  G% N! s& i' L