企业官网建设流程全解析

TonWeb Jetton代币开发终极指南：发行、转账与合约交互详解

【免费下载链接】tonwebJavaScript SDK for TON (The Open Network)项目地址: https://gitcode.com/gh_mirrors/to/tonweb

TON区块链上的Jetton代币开发从未如此简单！🚀 通过TonWeb JavaScript SDK，开发者可以轻松创建和管理自己的代币。本文将为您提供完整的Jetton代币开发指南，涵盖从发行到转账的每个关键步骤。

什么是Jetton代币？🤔

Jetton是TON区块链上的可替代代币标准，类似于以太坊上的ERC-20标准。每个Jetton代币都有自己的智能合约系统，包括代币铸造器（Minter）和代币钱包（Wallet）。TonWeb SDK为开发者提供了完整的工具集来与这些合约进行交互。

快速开始：环境搭建

首先安装TonWeb SDK：

npm install tonweb

或使用CDN：

<script src="tonweb.js"></script>

初始化TonWeb实例：

import TonWeb from "tonweb"; // 使用TonCenter API（测试网） const tonweb = new TonWeb(new TonWeb.HttpProvider( 'https://testnet.toncenter.com/api/v2/jsonRPC', {apiKey: 'YOUR_TESTNET_TONCENTER_API_KEY'} ));

Jetton代币发行完整教程

1. 创建Jetton铸造器（Minter）

JettonMinter是代币的核心合约，负责代币的发行和管理：

const {JettonMinter, JettonWallet} = TonWeb.token.jetton; const minter = new JettonMinter(tonweb.provider, { adminAddress: walletAddress, // 管理员地址 jettonContentUri: 'https://your-domain.com/jetton-metadata.json', // 代币元数据 jettonWalletCodeHex: JettonWallet.codeHex // 钱包合约代码 }); const minterAddress = await minter.getAddress(); console.log('Jetton Minter地址:', minterAddress.toString(true, true, true));

2. 部署Jetton铸造器合约

部署Minter合约到TON区块链：

const deployMinter = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: minterAddress.toString(true, true, true), amount: TonWeb.utils.toNano('0.05'), // 部署费用 seqno: seqno, payload: null, sendMode: 3, stateInit: (await minter.createStateInit()).stateInit }).send(); }

3. 查询代币信息

获取已部署代币的详细信息：

const getMinterInfo = async () => { const data = await minter.getJettonData(); console.log('总供应量:', data.totalSupply.toString()); console.log('管理员地址:', data.adminAddress.toString(true, true, true)); console.log('代币元数据URI:', data.jettonContentUri); console.log('是否可变:', data.isMutable); }

代币铸造与分发

1. 铸造新代币

向指定地址铸造新代币：

const mint = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: minterAddress.toString(true, true, true), amount: TonWeb.utils.toNano('0.05'), seqno: seqno, payload: await minter.createMintBody({ jettonAmount: TonWeb.utils.toNano('1000000'), // 铸造100万个代币 destination: recipientAddress, // 接收地址 amount: TonWeb.utils.toNano('0.04') // 铸造费用 }), sendMode: 3, }).send(); }

2. 获取用户代币钱包地址

每个用户都有一个独立的Jetton钱包合约：

const getJettonWalletAddress = async (ownerAddress) => { const jettonWalletAddress = await minter.getJettonWalletAddress(ownerAddress); console.log('代币钱包地址:', jettonWalletAddress.toString(true, true, true)); return jettonWalletAddress; }

代币转账操作指南

1. 创建Jetton钱包实例

const JETTON_WALLET_ADDRESS = 'EQBGpCSFJpAb1guZHVWIO8b_8g0e8yxp2ZfZWcTXvTjvvyFd'; const jettonWallet = new JettonWallet(tonweb.provider, { address: JETTON_WALLET_ADDRESS });

2. 查询代币余额

const getJettonWalletInfo = async () => { const data = await jettonWallet.getData(); console.log('代币余额:', data.balance.toString()); console.log('所有者地址:', data.ownerAddress.toString(true, true, true)); console.log('代币铸造器地址:', data.jettonMinterAddress.toString(true, true, true)); }

3. 执行代币转账

const transfer = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; // 创建转账备注 const comment = new Uint8Array([ ...new Uint8Array(4), // 前4个字节为0（文本注释标签） ...new TextEncoder().encode('gift') // 转账备注 ]); await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: JETTON_WALLET_ADDRESS, amount: TonWeb.utils.toNano('0.05'), // 交易费用 seqno: seqno, payload: await jettonWallet.createTransferBody({ jettonAmount: TonWeb.utils.toNano('500'), // 转账500个代币 toAddress: recipientAddress, // 接收方地址 forwardAmount: TonWeb.utils.toNano('0.01'), // 转发金额 forwardPayload: comment, // 转发数据 responseAddress: walletAddress // 响应地址 }), sendMode: 3, }).send(); }

高级管理功能

1. 更新代币元数据

const editContent = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: minterAddress.toString(true, true, true), amount: TonWeb.utils.toNano('0.05'), seqno: seqno, payload: await minter.createEditContentBody({ jettonContentUri: 'https://new-domain.com/updated-metadata.json', }), sendMode: 3, }).send(); }

2. 转移管理员权限

const changeAdmin = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: minterAddress.toString(true, true, true), amount: TonWeb.utils.toNano('0.05'), seqno: seqno, payload: await minter.createChangeAdminBody({ newAdminAddress: new TonWeb.Address('NEW_ADMIN_ADDRESS') }), sendMode: 3, }).send(); }

3. 销毁代币

const burn = async () => { const seqno = (await wallet.methods.seqno().call()) || 0; await wallet.methods.transfer({ secretKey: keyPair.secretKey, toAddress: JETTON_WALLET_ADDRESS, amount: TonWeb.utils.toNano('0.05'), seqno: seqno, payload: await jettonWallet.createBurnBody({ jettonAmount: TonWeb.utils.toNano('400'), // 销毁400个代币 responseAddress: walletAddress }), sendMode: 3, }).send(); }

最佳实践与注意事项

1. 费用估算

在执行任何交易前，始终估算费用：

const fee = await wallet.methods.transfer({ secretKey, toAddress: minterAddress.toString(true, true, true), amount: TonWeb.utils.toNano('0.01'), seqno: seqno, payload: await minter.createMintBody({ jettonAmount: TonWeb.utils.toNano('1000'), destination: recipientAddress, amount: TonWeb.utils.toNano('0.04') }), sendMode: 3, }).estimateFee(); console.log('预估费用:', fee.toString());

2. 错误处理

try { const result = await wallet.methods.transfer({ // ... 交易参数 }).send(); console.log('交易成功:', result); } catch (error) { console.error('交易失败:', error.message); // 检查余额、序列号等 }

3. 测试网部署

始终先在TON测试网上测试您的合约：

// 测试网配置 const testnetProvider = new TonWeb.HttpProvider( 'https://testnet.toncenter.com/api/v2/jsonRPC', {apiKey: 'YOUR_TESTNET_API_KEY'} ); const tonwebTestnet = new TonWeb(testnetProvider);

核心源码文件参考

深入了解TonWeb Jetton实现：

• JettonMinter类:src/contract/token/ft/JettonMinter.js- 代币铸造器核心逻辑
• JettonWallet类:src/contract/token/ft/JettonWallet.js- 代币钱包合约交互
• 代币测试示例:src/test-jetton.js- 完整的Jetton使用示例
• 代币模块入口:src/contract/token/ft/index.js- 模块导出

常见问题解答

Q: 如何选择合适的Gas费用？

A: 使用estimateFee()方法预估费用，并根据网络状况适当增加。

Q: 代币元数据应该包含什么？

A: 元数据JSON应包含代币名称、符号、小数位数、图标URL等标准字段。

Q: 如何处理交易失败？

A: 检查钱包余额、序列号是否正确，确保目标地址有效，并使用try-catch捕获异常。

Q: 如何批量转账？

A: 创建循环，为每个接收者单独发送交易，注意序列号递增。

总结

TonWeb SDK为TON区块链上的Jetton代币开发提供了完整的解决方案。通过本文的指南，您可以：

1. ✅ 轻松创建和部署Jetton代币合约
2. ✅ 实现代币的铸造、转账和销毁功能
3. ✅ 管理代币元数据和管理员权限
4. ✅ 与用户代币钱包进行交互
5. ✅ 在测试网和生产环境安全部署

TON区块链的高性能和低费用使其成为代币发行的理想选择。借助TonWeb SDK的强大功能，您可以快速构建功能完整的代币应用，为用户提供流畅的区块链体验。

开始您的Jetton代币开发之旅，在TON生态系统中创建下一个热门代币！🎉

【免费下载链接】tonwebJavaScript SDK for TON (The Open Network)项目地址: https://gitcode.com/gh_mirrors/to/tonweb