Docs
CLI reference
The slab command encrypts, erasure-codes and moves data. It talks to nodes directly; no gateway needed.
Global options
| Option | Meaning |
|---|---|
--testnet | join the public testnet through its built-in bootstrap nodes |
--peer <host:port> | bootstrap from this node instead (repeatable), e.g. a local cluster |
--store <dir> | no network: keep shards in a local directory (default ./slab-local-data) |
Without --testnet or --peer, the CLI works against a local shard directory, which is handy for tests.
Data
| Command | Does |
|---|---|
slab put [--wallet W] <path> | upload a file or directory; prints its slab:// link (one voucher per slab) |
slab get <out> [--path P] | download the link from stdin or $SLAB_URI; --path picks a file inside a directory (default index.html) |
slab ls | list the directory link from stdin or $SLAB_URI |
Links are never accepted as arguments: argv is visible to every local user through ps.
Feeds
| Command | Does |
|---|---|
slab feed new --file F | create an owner key file (mode 0600) and print its public key |
slab feed set --file F --topic T [--wallet W] | point topic T at the link from stdin or $SLAB_URI; the first update of a topic spends one voucher |
slab feed get --owner O --topic T | print the link a feed points at now |
Wallet
| Command | Does |
|---|---|
slab wallet init --ctl URL [--issuer-key K] | create an account at the control plane and a wallet file |
slab wallet deposit <cents> | deposit simulated euro cents (no real money on the testnet) |
slab wallet buy <n> | buy n vouchers; one voucher stores one slab |
slab wallet show | balance and vouchers left |
slab wallet register-node <proof> --stake-cents N | attach a node to this account and stake for it (Run a node) |
slab wallet node <node id> | a node’s stake and earnings |
slab wallet epoch [n] | the payout report of an epoch (default: the last settled one) |
slab wallet rotate-key <pub> | pin the control plane’s new voucher key after a rotation |
All wallet commands take --file <wallet.json> (default slab-wallet.json). The wallet holds unspent
vouchers; keep it like you would keep cash.
Releases
slab release publish signs and publishes a node release for auto-update. Only the release key holder uses
it; see the operator guide.