lium fund
Fund your account with TAO — or alpha — from your wallet.
lium fund [OPTIONS]
Run without flags for an interactive prompt that walks you through wallet and amount — and,
under --alpha, the origin hotkey.
With --alpha, the transfer uses your free alpha only — your stake minus any locked
amount. If you ask to move more alpha than you have free, the transfer is not attributed
and your balance is not credited at all. Keep the amount at or below your free alpha.
Without --netuid, lium fund --alpha pays from Lium's primary subnet. With --netuid <N>
(not released yet) it pays from any subnet Lium accepts: the CLI checks <N> against the live
list before it asks for your password, and refuses a subnet that is not on it. Either way the
command aborts if the quoted subnet changes mid-flight. You can also pay from
Top up → Alpha on lium.io/billing. Its Pay from subnet
picker is the live list of subnets you can pay from, and the BTCLI command tab prints
the matching command with the netuid, destination coldkey and alpha amount already filled in:
btcli stake transfer --origin-netuid <netuid> --dest-netuid <netuid> --dest <lium-coldkey> --amount <alpha>
Copy that command from the modal; do not type it by hand: <lium-coldkey> is
resolved per account, and the wallet you send from must be verified there first — an
unverified sender is not attributed and your balance is not credited. A deposit on a subnet
Lium does not accept is likewise not credited, and not refunded.
Options
| Flag | Effect |
|---|---|
--wallet, -w NAME | Wallet name |
--hotkey, -k NAME | Origin hotkey the alpha is staked under. Alpha only — required with --alpha, ignored otherwise. |
--amount, -a AMOUNT | Amount to fund. TAO by default; USD when --alpha is set.1 The coins go on-chain from your wallet and are credited at the amount received. |
--alpha | Fund with free alpha stake via transfer_stake. Without this flag the command sends TAO. |
--json | Print machine-readable JSON (non-interactive; pass --yes). |
--netuid N | Alpha only (not released yet): the subnet whose alpha pays. It must be one Lium accepts right now; without it, Lium's primary subnet. |
--yes, -y | Skip confirmation |
Examples
lium fund # Interactive (TAO)
lium fund -w default -a 10.0 # Fund 10 TAO
lium fund -w mywallet -a 5.0 -y # No prompts (TAO)
# Alpha funding — -a is USD, -k (origin hotkey) is required
lium fund --alpha -k <hotkey-ss58> -a 25 # Fund ~$25 of free alpha
lium fund --alpha -w default -k myhotkey -a 25 # -k may be a wallet hotkey name
lium fund --alpha -k <hotkey-ss58> -a 25 -y --json # Non-interactive, JSON output
lium fund --alpha -k <hotkey-ss58> -a 25 --netuid 64 # Alpha from subnet 64 (not released yet)
See also
lium ps— see hourly burn rate after funding