Get your first file on Walrus
Five minutes from "I have a Sui wallet" to "my file is on Walrus, encrypted, and registered on-chain." No code — everything happens in the dapp.
What you'll need
Sui Wallet, Suiet, or any browser wallet that supports Sui testnet.
A small amount for gas (around 0.1 SUI). Grab some from the Sui faucet.
Any file under 500 MiB. We'll use a PNG in this walkthrough, but any format works — Waldrop stores bytes verbatim.
Steps
1. Open the dapp and connect
Go to app.waldrop.xyz and click Sign in with Google or connect your Sui wallet. A Sign in to Verify button appears in the top right — click it. Your wallet pops up asking you to sign a message. Approve.
This signature isn't a transaction — it's a free off-chain proof that you own the wallet. The engine uses it to mint short-lived session tokens.
After signing, the badge flips from Sign to Verify to Verified (green pill).
2. Pick a plan
Click Plans in the sidebar. Pick Starter if it's your first time — it gives you 40 GB for 0.10 USDC/month. The free tier (1 GB) also works for this walkthrough.
You'll sign one more transaction to subscribe. Once it lands, the Plans page shows your active subscription with an expiry epoch.
3. Upload a file
Click Upload (or + New Data Stream). Drag your file into the drop zone, or click Pick files.
The wizard runs through three steps:
The progress bar reads UPLOADING TO WALRUS... 142 / 227 MB · 63% — real bytes, not a fake timer. Once it hits 100%, your wallet pops up to sign a register_blob transaction.
4. You're done
Click Files in the sidebar. Your blob is there with a green Verified badge. Click it to see:
- The Walrus blob ID (content-addressed — anyone who knows it can verify the bytes)
- The Sui object ID (the on-chain
Blobyour wallet owns) - The expiry epoch
- An "Open in Walrus Explorer" link
Your file's bytes live across ~100 storage nodes on Walrus, erasure-coded so
no single node can lose them. The on-chain Blob object in your wallet
proves you own that data and lets you extend the storage, delete it, or
share access later.
Where to go next
What's an epoch, what's a BlobStore, how SEAL encryption works — all in plain English.
Connect S3, GCS, Azure, Drive, Dropbox, or SFTP and upload without downloading to your laptop first.
When you should turn encryption on, what it actually protects, and how decryption works at read time.
Grant another wallet permission to decrypt one of your blobs — all on-chain, revocable any time.