Docs
Quickstart
Upload a file, share it, read it back. About five minutes.
You need the slab binary (from your invite, or cargo build --release --bin slab from source) and the
control-plane URL.
1. Create a wallet and buy vouchers
A voucher stores one slab. On the testnet, deposits are simulated euro cents.
slab wallet --file wallet.json init --ctl https://<ctl-url> --issuer-key issuer.pub
slab wallet --file wallet.json deposit 200 # 200 simulated cents
slab wallet --file wallet.json buy 50 # 50 vouchers
slab wallet --file wallet.json show
Pass --issuer-key (from your invite) so the wallet only trusts the testnet’s real voucher key.
2. Upload
slab --testnet put --wallet wallet.json holiday.mp4
# slab://3f9c…e1#a71b…0c
--testnet finds the network through bootstrap.slab.me.uk. The last line printed is the file’s link.
The link contains the decryption key. Anyone who has it can read the file; nobody without it can.
Directories work the same way: slab put photos/ uploads the whole tree, with small files packed together.
3. Download
The CLI reads links from stdin or $SLAB_URI, never from the command line, because command lines are
visible to other users on the same machine.
printf '%s\n' "$LINK" | slab --testnet get holiday-copy.mp4
SLAB_URI="$LINK" slab --testnet ls # list a directory
SLAB_URI="$LINK" slab --testnet get cat.jpg --path img/cat.jpg
4. Share over HTTP
A gateway serves the same data to browsers. Turn the link into a reference by joining root and key:
ref=$(printf '%s' "$LINK" | sed -E 's|slab://([0-9a-f]{64})#([0-9a-f]{64})|\1\2|')
echo "https://files.slab.me.uk/slab/$ref/"
5. Publish something that changes
A feed is a pointer you can move. Create an owner key once, then point a topic at any link:
slab --testnet feed new --file site-feed.json # prints the owner public key
printf '%s\n' "$LINK" | slab --testnet feed set --file site-feed.json --topic notes --wallet wallet.json
slab --testnet feed get --owner <owner> --topic notes
Readers follow https://files.slab.me.uk/feeds/<owner>/notes/. Feeds are public: whoever knows the owner and topic,
and every node that stores the feed, can read what it points at. Private feeds are on the roadmap.