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

ウォレットアドレスの 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 フィールドを確認してください