Hedera Token Service(HTS)是 Hedera 的原生代币引擎,可在不编写智能合约的情况下创建和管理同质化代币与 NFT。通过 HTS 创建的是网络一等实体,内置 KYC、冻结、清除、暂停等合规控制及自定义费用表。
用途:使用 @hiero-ledger/sdk 在 Hedera 上创建、铸造、转移、销毁、删除代币,并执行合规与空投操作。
主要能力:支持同质化代币与 NFT(TokenType.NonFungibleUnique);交易遵循 configure→freeze→sign→execute→receipt 流程;支持 Client+setOperator 或 Wallet+LocalProvider 两种初始化方式;代币关联(TokenAssociateTransaction 或 setMaxAutomaticTokenAssociations);转移(TransferTransaction,金额有符号且需净额为零,可混合 Hbar);关键角色包括 adminKey、supplyKey、freezeKey、kycKey、wipeKey、pauseKey、feeScheduleKey、metadataKey;合规操作含 KYC 授予、冻结/解冻、清除、暂停/恢复;铸造与销毁;TokenInfoQuery、TokenNftInfoQuery 查询;空投(TokenAirdropTransaction、TokenClaimAirdropTransaction、TokenCancelAirdropTransaction、TokenRejectTransaction);自定义费用(CustomFixedFee、CustomFractionalFee、CustomRoyaltyFee)。
使用方式:从 @hiero-ledger/sdk 导入类,配置客户端或钱包,按交易生命周期执行;多签时先 freezeWith(client) 再链式 .sign(key)。
限制与注意事项:接收方须先关联代币或具备自动关联槽位,否则报 TOKEN_NOT_ASSOCIATED_TO_ACCOUNT;NFT 无小数位和初始供应量,需逐个铸造序列号;未设置 adminKey 则代币不可更新或删除;有 kycKey 时账户须先获 KYC 批准;铸造/销毁需在创建时设置 supplyKey;财库账户自动关联。完整 API 与自定义费用细节见 references/api-reference.md 和 references/custom-fees.md。