Transfer Skill

Unified asset transfer skill for the Stacks L2 — sends STX, SIP-010 fungible tokens, and SIP-009 NFTs to a recipient address. All three subcommands require an unlocked wallet.

Usage

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

Subcommands

stx

Transfer STX to a recipient address. Amount is specified in 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>]

Options:

```
--recipient
```
(required) — Stacks address of the recipient (starts with SP or ST)
```
--amount
```
(required) — Amount in micro-STX (e.g.,
```
2000000
```
for 2 STX)
```
--memo
```
(optional) — Memo text to attach to the transfer (max 34 bytes)
```
--fee
```
(optional) — Fee preset (
```
low
```
,
```
medium
```
,
```
high
```
) or micro-STX amount; auto-estimated if omitted

Output:

json

{
  "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

Transfer any SIP-010 fungible token to a recipient. Accepts a well-known token symbol (

sBTC

USDCx

ALEX

DIKO

) or a full contract ID.

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

Options:

```
--recipient
```
(required) — Stacks address of the recipient
```
--amount
```
(required) — Amount in the token's smallest unit (check token decimals)
```
--contract
```
(required) — Token symbol (e.g.,
```
sBTC
```
) or full contract ID (e.g.,
```
SP2...my-token
```
)
```
--memo
```
(optional) — Memo text (max 34 bytes)
```
--fee
```
(optional) — Fee preset or micro-STX amount; auto-estimated if omitted

Output:

json

{
  "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

Transfer a SIP-009 NFT to a recipient. Requires the NFT collection contract ID and the specific token ID.

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

Options:

```
--recipient
```
(required) — Stacks address of the recipient
```
--token-id
```
(required) — Integer token ID of the NFT to transfer
```
--contract
```
(required) — NFT collection contract ID (e.g.,
```
SP2...my-nft
```
)
```
--fee
```
(optional) — Fee preset or micro-STX amount; auto-estimated if omitted

Output:

json

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

Notes

Wallet must be unlocked before any transfer. Use
```
bun run wallet/wallet.ts unlock
```
first.
For STX, 1 STX = 1,000,000 micro-STX. For tokens, check decimals with the
```
tokens
```
skill's
```
get-info
```
subcommand.
NFT token IDs are integers. Use the
```
nft
```
skill's
```
get-holdings
```
subcommand to list owned token IDs.
Fee is paid in STX regardless of the asset being transferred. Ensure sufficient STX balance for the fee.
The
```
--memo
```
option is available for STX and token transfers, but not NFT transfers (not part of the SIP-009 standard).

transfer

NPX Install

Tags

SKILL.md Content

Transfer Skill

Usage

Subcommands

stx

token

nft

Notes