SlabtestnetRun a node

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://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://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.