用途:面向 BSV21 同质化代币的链上操作,围绕 @1sat/actions 提供发送、查询、部署与铸造能力。CLI 组名为 bsv21(原 tokens)。
主要能力(动作):listBsv21 列出 BSV21 代币 UTXO;getBsv21Balances 按 token ID 聚合余额;sendBsv21 按数量发送(tokenId + amounts + destinations);buyBsv21 购买市场 OrdLock 挂单;deployBsv21Mint 固定供应量部署并铸造;deployBsv21Auth 可铸造部署加授权;mintBsv21 花费授权进行铸造、重发或终止。
使用方式:先通过 createContext(wallet, { services }) 创建上下文,再以 action.execute(ctx, {...}) 调用。例如 getBsv21Balances.execute(ctx, {}) 返回余额,listBsv21.execute(ctx, { limit: 100 }) 列出 UTXO,sendBsv21.execute 传入 tokenId 与 recipients 数组(含 amount、destination),buyBsv21.execute 传 tokenId、outpoint、amount、可选 marketplaceAddress 与 marketplaceRate。部署可用 deployBsv21Mint.execute 传 symbol、amount、decimals、icon 得到 tokenId;可铸造代币用 deployBsv21Auth.execute 部署后,再用 mintBsv21.execute 传 tokenId 与 mint 参数铸造。
限制与注意:同质化 API 基于数量而非按 ID 花费,但 Basket UTXO 内部仍携带 id;自转目标必须加入 basket 或打标签。amount 为原始单位,需按 dec 换算显示;Overlay 校验需要 services;外部 UTXO 依赖 services/overlay 提供的 BEEF。依赖安装:bun add @1sat/actions @1sat/wallet @1sat/templates @bsv/sdk。