transfer

Transfer Skill

Stacks L2 向けの統合資産転送スキルです。STX、SIP-010 代替可能トークン、SIP-009 NFT を受取人のアドレスに送信します。3 つのサブコマンドはいずれも、ウォレットのロックが解除されている必要があります。

Usage

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

Subcommands

stx

STX を受取人のアドレスに送信します。金額は micro-STX 単位で指定します（1 STX = 1,000,000 micro-STX）。

bun run transfer/transfer.ts stx \
  --recipient <address> \
  --amount <microStx> \
  [--memo <text>] \
  [--fee low|medium|high|<microStx>]

オプション：

• --recipient（必須）— 受取人の Stacks アドレス（SP または ST で始まります）
• --amount（必須）— micro-STX 単位の金額（例：2 STX の場合は 2000000）
• --memo（任意）— 転送に添付するメモのテキスト（最大 34 バイト）
• --fee（任意）— 手数料プリセット（low、medium、high）または micro-STX 単位の金額。省略すると自動で推定されます

出力：

{
  "success": true,
  "txid": "abc123...",
  "from": "SP2...",
  "recipient": "SP3...",
  "amount": "2 STX",
  "amountMicroStx": "2000000",
  "memo": null,
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123..."
}

token

任意の SIP-010 代替可能トークンを受取人に転送します。よく知られたトークンシンボル（sBTC、USDCx、ALEX、DIKO）または完全なコントラクト ID を指定できます。

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

オプション：

• --recipient（必須）— 受取人の Stacks アドレス
• --amount（必須）— トークンの最小単位での金額（トークンの小数桁数を確認してください）
• --contract（必須）— トークンシンボル（例：sBTC）または完全なコントラクト ID（例：SP2...my-token）
• --memo（任意）— メモのテキスト（最大 34 バイト）
• --fee（任意）— 手数料プリセットまたは micro-STX 単位の金額。省略すると自動で推定されます

出力：

{
  "success": true,
  "txid": "abc123...",
  "from": "SP2...",
  "recipient": "SP3...",
  "contract": "SP2...my-token",
  "amount": "1000000",
  "memo": null,
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123..."
}

nft

SIP-009 NFT を受取人に転送します。NFT コレクションのコントラクト ID と、対象のトークン ID が必要です。

bun run transfer/transfer.ts nft \
  --recipient <address> \
  --token-id <uint> \
  --contract <contract-id> \
  [--fee low|medium|high|<microStx>]

オプション：

• --recipient（必須）— 受取人の Stacks アドレス
• --token-id（必須）— 転送する NFT の整数トークン ID
• --contract（必須）— NFT コレクションのコントラクト ID（例：SP2...my-nft）
• --fee（任意）— 手数料プリセットまたは micro-STX 単位の金額。省略すると自動で推定されます

出力：

{
  "success": true,
  "txid": "abc123...",
  "from": "SP2...",
  "recipient": "SP3...",
  "contract": "SP2...my-nft",
  "tokenId": 42,
  "network": "mainnet",
  "explorerUrl": "https://explorer.hiro.so/txid/abc123..."
}

Notes

• 転送する前に、ウォレットのロックを解除する必要があります。最初に bun run wallet/wallet.ts unlock を実行してください。
• STX の場合、1 STX = 1,000,000 micro-STX です。トークンの場合は、tokens スキルの get-info サブコマンドで小数桁数を確認してください。
• NFT のトークン ID は整数です。所有しているトークン ID を一覧表示するには、nft スキルの get-holdings サブコマンドを使用してください。
• 転送する資産の種類にかかわらず、手数料は STX で支払います。手数料を支払えるだけの STX 残高があることを確認してください。
• --memo オプションは STX とトークンの転送で使用できますが、NFT の転送では使用できません（SIP-009 標準には含まれていません）。