mcpField
T
tokens

tokens

github.com/aibtcdev其他11156 次安装今天更新
代码仓库

关于 tokens

用于在 Stacks L2 上操作 SIP-010 同质化代币的命令行技能，支持余额、元数据和持有人查询，以及需解锁钱包的代币转账。

主要功能

  1. 01查询代币余额
  2. 02读取代币元数据
  3. 03列出地址持有的代币
  4. 04分页查看主要持有人
  5. 05设置费用并转账

适用场景

  1. 01查询钱包的 SIP-010 代币余额
  2. 02使用前查看代币元数据
  3. 03检查代币持有人情况
  4. 04从已解锁钱包发送代币

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aibtcdev/skills --skill tokens

安装后在 Claude Code 中输入/tokens确认已加载。

附带文件AGENT.mdtokens.ts

详细介绍

Tokens 技能

提供 Stacks L2 上的 SIP-010 同质化代币操作。转账操作需要已解锁的钱包（请先运行 bun run wallet/wallet.ts unlock）。查询余额和信息无需钱包。

支持通过代号使用知名代币：sBTC、USDCx、ALEX、DIKO 也可以使用完整合约 ID：SP2...address.contract-name

用法

bun run tokens/tokens.ts <subcommand> [options]

子命令

get-balance

查询任意 Stacks 地址的 SIP-010 代币余额。

bun run tokens/tokens.ts get-balance --token <symbol-or-id> [--address <addr>]

选项：

  • --token（必填）— 代币代号（例如 USDCx、sBTC）或合约 ID
  • --address（可选）— 要查询的 Stacks 地址（若省略，则使用当前钱包）

输出：

{
  "address": "SP2...",
  "network": "mainnet",
  "token": {
    "contractId": "SP2...address.usdc-token",
    "symbol": "USDCx",
    "name": "USD Coin",
    "decimals": 6
  },
  "balance": {
    "raw": "1000000",
    "formatted": "1 USDCx"
  }
}
transfer

向收款地址转账任意 SIP-010 代币。需要已解锁的钱包。

bun run tokens/tokens.ts transfer --token <symbol-or-id> --recipient <addr> --amount <amount> [--memo <text>] [--fee low|medium|high|<microStx>]

选项：

  • --token（必填）— 代币代号或合约 ID
  • --recipient（必填）— 要转入的 Stacks 地址
  • --amount（必填）— 最小单位的金额（取决于代币的小数位数）
  • --memo（可选）— 备注消息（最多 34 字节）
  • --fee（可选）— 费用预设（low|medium|high）或 micro-STX 金额；若省略则自动估算

输出：

{
  "success": true,
  "txid": "abc123...",
  "from": "SP2...",
  "recipient": "SP3...",
  "token": "USDCx",
  "amount": "1000000",
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123...?chain=mainnet"
}
get-info

获取 SIP-010 代币的元数据（名称、代号、小数位数、总供应量）。

bun run tokens/tokens.ts get-info --token <symbol-or-id>

选项：

  • --token（必填）— 代币代号或合约 ID

输出：

{
  "network": "mainnet",
  "contractId": "SP2...address.usdc-token",
  "name": "USD Coin",
  "symbol": "USDCx",
  "decimals": 6,
  "totalSupply": "1000000000000",
  "tokenUri": "https://..."
}
list-user-tokens

列出某个地址持有的所有同质化代币。

bun run tokens/tokens.ts list-user-tokens [--address <addr>]

选项：

  • --address（可选）— 要查询的 Stacks 地址（若省略，则使用当前钱包）

输出：

{
  "address": "SP2...",
  "network": "mainnet",
  "tokenCount": 2,
  "tokens": [
    { "contractId": "SP2....usdc-token::usdcx", "balance": "1000000" },
    { "contractId": "SP3....alex-token::alex", "balance": "500000000" }
  ]
}
get-holders

获取 SIP-010 代币的主要持有者。

bun run tokens/tokens.ts get-holders --token <symbol-or-id> [--limit <n>] [--offset <n>]

选项：

  • --token（必填）— 代币代号或合约 ID
  • --limit（可选）— 返回的持有者数量上限（默认值：20）
  • --offset（可选）— 分页偏移量（默认值：0）

输出：

{
  "token": "USDCx",
  "network": "mainnet",
  "total": 1234,
  "holders": [
    { "address": "SP2...", "balance": "50000000000" },
    { "address": "SP3...", "balance": "25000000000" }
  ]
}

注意事项

  • 代币余额和信息查询使用公开的 Hiro API（无需身份验证）
  • 转账操作需要已解锁的钱包
  • 知名代币代号：sBTC、USDCx、ALEX、DIKO — 或使用完整合约 ID
  • 代币金额以最小单位表示 — 请查看 decimals 字段，将其转换为便于阅读的数值

评论

支持 Markdown