tonweb
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseBased on tonweb v0.0.66, generated 2026-02-25.
TonWeb is the JavaScript API for the TON blockchain: wallet contracts, BOC/Cell, TonCenter HttpProvider, NFT/Jetton, DNS, payments, block subscription.
基于tonweb v0.0.66版本生成，生成时间：2026-02-25。
TonWeb是面向TON区块链的JavaScript API，提供钱包合约、BOC/Cell、TonCenter HttpProvider、NFT/Jetton、DNS、支付、区块订阅等功能。
Core References
核心参考文档
| Topic | Description | Reference |
|---|---|---|
| Overview | Installation, provider, root API | core-overview |
| TonWeb instance | Root class, getTransactions, getBalance, sendBoc, call | core-tonweb-instance |
| Address and utils | Address, toNano/fromNano, bytes/hex/base64, BN, nacl | core-address-utils |
| BOC | Cell, BitString, fromBoc/oneFromBoc | core-boc |
| Slice | Parsing BOC: beginParse, loadBit, loadUint, loadAddress, loadRef | core-slice |
| Contract base | deploy, methods, getQuery/send/estimateFee, createStateInit | core-contract |
| HttpProvider | getAddressInfo, getWalletInfo, sendBoc, call/call2 | core-http-provider |
| HttpProviderUtils | parseResponse, parseObject — parse get-method stack to BN/Cell | core-http-provider-utils |
| Transfer URL | parseTransferUrl, formatTransferUrl (ton://transfer/...) | core-transfer-url |
| Workchain | WorkchainId Master/Basic, wc for addresses and contracts | core-workchain |
| Utils extra | AdnlAddress, StorageBagId; keyPairFromSeed, newKeyPair, newSeed | core-utils-extra |
| Estimate fee | estimateFee on methods, getEstimateFee(boc) on provider | core-estimate-fee |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 概览 | 安装、Provider、根API | core-overview |
| TonWeb实例 | 根类、getTransactions、getBalance、sendBoc、call方法 | core-tonweb-instance |
| 地址与工具函数 | 地址、toNano/fromNano、bytes/hex/base64、BN、nacl | core-address-utils |
| BOC | Cell、BitString、fromBoc/oneFromBoc | core-boc |
| Slice | BOC解析：beginParse、loadBit、loadUint、loadAddress、loadRef | core-slice |
| 合约基础 | 部署、方法、getQuery/send/estimateFee、createStateInit | core-contract |
| HttpProvider | getAddressInfo、getWalletInfo、sendBoc、call/call2 | core-http-provider |
| HttpProviderUtils | parseResponse、parseObject — 将get-method栈解析为BN/Cell | core-http-provider-utils |
| 转账URL | parseTransferUrl、formatTransferUrl（ton://transfer/...格式） | core-transfer-url |
| 工作链 | WorkchainId主链/基础链、地址与合约的wc参数 | core-workchain |
| 扩展工具函数 | AdnlAddress、StorageBagId；keyPairFromSeed、newKeyPair、newSeed | core-utils-extra |
| 费用估算 | 方法中的estimateFee、Provider上的getEstimateFee(boc) | core-estimate-fee |
Features
功能特性
| Topic | Description | Reference |
|---|---|---|
| Wallet | create, deploy, transfer, seqno, V2/V3/V4 | features-wallet |
| Highload wallet | HighloadWalletContractV3, HighloadQueryId | features-highload-wallet |
| Lockup wallet | liquid/locked/restricted balances | features-lockup-wallet |
| Lockup vesting | VestingWalletV1: vesting schedule, getLockedAmount, getVestingData | features-lockup-vesting |
| NFT | NftCollection, NftItem, NftMarketplace, NftSale | features-nft |
| Jetton | JettonMinter, JettonWallet, transfer, burn | features-jetton |
| NFT content & royalty | NftUtils: offchain URI cell, parseOffchainUriCell, getRoyaltyParams | features-nft-content-royalty |
| DNS | resolve, getWalletAddress, getSiteAddress | features-dns |
| Ledger | AppTon, getPublicKey, getAddress, sign, transfer; TransportWebUSB/HID/BLE | features-ledger |
| Payments | PaymentChannel, createChannel | features-payments |
| Block subscription | BlockSubscription, InMemoryBlockStorage | features-block-subscription |
| Subscription contract | Recurring payments: pay, getSubscriptionData | features-subscription |
| Wallet parsing | parseTransferQuery, parseTransferBody (V3/V4 transfer BOC) | features-wallet-parsing |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 钱包 | 创建、部署、转账、seqno、V2/V3/V4版本 | features-wallet |
| 高负载钱包 | HighloadWalletContractV3、HighloadQueryId | features-highload-wallet |
| 锁仓钱包 | 可提现/锁定/受限余额 | features-lockup-wallet |
| 锁仓Vesting | VestingWalletV1：vesting时间表、getLockedAmount、getVestingData | features-lockup-vesting |
| NFT | NftCollection、NftItem、NftMarketplace、NftSale | features-nft |
| Jetton | JettonMinter、JettonWallet、转账、销毁 | features-jetton |
| NFT内容与版税 | NftUtils：链下URI Cell、parseOffchainUriCell、getRoyaltyParams | features-nft-content-royalty |
| DNS | 解析、获取钱包地址、获取站点地址 | features-dns |
| Ledger | AppTon、获取公钥、获取地址、签名、转账；TransportWebUSB/HID/BLE | features-ledger |
| 支付 | PaymentChannel、创建通道 | features-payments |
| 区块订阅 | BlockSubscription、InMemoryBlockStorage | features-block-subscription |
| 订阅合约 | 定期支付：pay、getSubscriptionData | features-subscription |
| 钱包解析 | parseTransferQuery、parseTransferBody（V3/V4转账BOC） | features-wallet-parsing |
Best practices
最佳实践
| Topic | Description | Reference |
|---|---|---|
| Custom contract | Extend Contract, createDataCell, message builders | best-practices-custom-contract |
| Error handling | exit_code, parseResponse throws, provider/send errors | best-practices-error-handling |
| 主题 | 描述 | 参考链接 |
|---|---|---|
| 自定义合约 | 扩展Contract、创建DataCell、消息构建器 | best-practices-custom-contract |
| 错误处理 | exit_code、parseResponse抛出异常、Provider/发送错误 | best-practices-error-handling |