Skip to content

transfer.md

Latest commit

 

History

History
58 lines (44 loc) · 2.29 KB

transfer.md

File metadata and controls

58 lines (44 loc) · 2.29 KB
Raw

transfer — TAO Transfer Operations

Send TAO tokens between accounts. Uses the Substrate Balances pallet (not SubtensorModule).

Subcommands

transfer

Send a specific amount of TAO to another account.

agcli transfer --dest 5Dest... --amount 10.0 [--password PW] [--yes]

On-chain: Balances::transfer_keep_alive(origin, dest, value) — ensures sender stays above existential deposit.

  • 1 TAO = 1,000,000,000 RAO (u64)
  • Events: Transfer { from, to, amount }
  • Pre-checks: balance >= amount (checked client-side before submission)
  • Confirmation prompt unless --yes or --batch
  • Errors: InsufficientBalance, ExistentialDeposit (if transfer would kill sender account)

Output (JSON mode):

{"tx_hash": "0x...", "message": "Transaction submitted."}

transfer-all

Send entire balance to another account (minus transaction fees).

agcli transfer-all --dest 5Dest... [--keep-alive] [--password PW] [--yes]

On-chain: Balances::transfer_all(origin, dest, keep_alive)

  • If keep_alive=false: sends everything, account may be reaped
  • If keep_alive=true: leaves existential deposit (500,000 RAO = 0.0005 TAO)
  • Extra confirmation required: "Transfer ALL funds? This will empty your account."

Common Errors

Error Cause Fix
InsufficientBalance Not enough TAO Check agcli balance
ExistentialDeposit Transfer would kill account Use --keep-alive or transfer less
Invalid SS58 Bad destination address Verify address format (prefix 42)

Fees

  • Transaction fee: ~0.000125 TAO per transfer (linear weight-to-fee, 1 RAO per byte length fee)
  • Existential deposit: 500 RAO (0.0000005 TAO) — the minimum balance to keep an account alive
  • Fee handler: SubtensorTxFeeHandler (custom Bittensor fee logic)

Source Code

agcli handler: src/cli/commands.rs — Transfer at L238, TransferAll at L269

Substrate pallet: Uses Balances::transfer_keep_alive and Balances::transfer_all from the standard Substrate Balances pallet (not SubtensorModule).

Related Commands

  • agcli balance — Check balance before transfer
  • agcli view history — See recent transactions
  • agcli stake add — Stake TAO instead of transferring