Guides

Eight things you can run against https://testnet.permafrost.live, front to back. Each page opens with what you will have at the end and closes with something you can check, and each carries a badge naming the run that drove it on this instance — or saying plainly that nobody has driven it yet.

If you have a credential already, the Quickstart is the short path: every command on these pages, in order, in one shell.

Getting a credential

There are two, and they are alternatives rather than steps.

1. Onboard with an invite — we send a one-time link, you redeem it, and you hold a key. The quickest first touch.
2. Bring your own issuer — your users’ signed tokens are their credentials, a tenant appears on first use, and no key is ever minted or mailed. The integration path.

Storing and reading

3. Store, read back, and know when it is certified — a bucket, a byte-equal round trip, the two headers that tell you where an object stands, and a delete.
4. Upload media in parts, read by range — a many-part upload, a whole-object read, a byte range, and the one thing this path does not do for you.

Holding and proving

5. Hold, serve, incinerate — and the certificate — material your app holds on a user’s behalf, deleted by destroying its key, with a certificate on Sui.
6. Verify a file by hash, with no account — the one route that answers anybody, and what its verdict does and does not say.
7. Read your receipt on Sui — find the receipt for something you stored, open it in an explorer, read it without us.

Managing your own access

8. Keys, rotation, and the portal — the self-service page and the two routes behind it. Key lane only.

For the exact routes, headers and ceilings behind all of this, see the Reference. For why it is shaped this way, see the Explanation pages.