Documentation

1. 1

   Publish with a file

   Open Private file in the publish form. actUploadData with an empty grantee list. Arkiv stores name, size, type and the three ACT references.
2. 2

   Buyer purchases

   The pass and the sale record the buyer's Swarm sharing key (buyer_pubkey).
3. 3

   Provider grants

   My APIs, File access, Grant access. actAddGrantees runs in the provider's browser; POST /api/grants records the new history reference as a grant entity.
4. 4

   Buyer downloads

   Service page, "Private file", Download. actDownloadData decrypts with the buyer's own Swarm ID. No shared key ever travels.

   Expect · the file opens; a non-granted identity gets a decryption error

1. 1

   Run the app

   Follow the Run it instructions. bun demo:check ends with READY. Open http://localhost:3000.

   Expect · home page with Enter with Swarm ID

2. 2

   Create the provider identity

   Enter with Swarm ID, click the button in the dialog, create a new identity in the popup, then choose Provider. On My APIs, then open your account menu in the header to check storage and the Arkiv writer.

   Expect · Storage ready and a funded writer

3. 3

   Publish an API

   Publish API: name, category, price 0.50 USDC, duration 30 seconds (demo), one operation getQuote(symbol: string). Payout wallet is your Swarm wallet, fixed. Optionally attach a small private file.

   Expect · success screen with Swarm gateway, Arkiv entity and transaction links; open both

4. 4

   Create and fund the buyer

   Switch to Client: the app signs you out and asks for Swarm ID again. Sign in and open the service from the marketplace. Only the access card asks for MetaMask or Rabby on Avalanche Fuji (the app offers the network). Open Fund wallet and copy your address, fund it with AVAX and USDC from the faucets, click refresh.

   Expect · USDC ≥ 0.50 and some AVAX

5. 5

   Buy access

   Buy access · 0.50 USDC. Approve, buy() on the contract, confirmation, mint on Arkiv. Two Fuji transactions signed by your wallet, then one signature that claims the pass for your Swarm ID, which seals the API key with its own key.

   Expect · Active access with expiry and a link to My passes; the service page keeps describing the API

6. 6

   Call the API

   In My passes, under the pass: Try API with getQuote, BTC; the private file, when the provider granted it, downloads there too. From a terminal: bun call:service <serviceId> "<passKey>.<secret>" getQuote '{"symbol":"ETH"}'. See Access pass for error responses.

   Expect · Pass verified on Arkiv with expiry block, a live price, 401/403 on every negative check

7. 7

   Private file (optional)

   My APIs, File access, Grant access for the buyer. Buyer: service page, Private file, Download.

   Expect · the file decrypts for the granted buyer only

8. 8

   See the sale

   My APIs: recorded sales and revenue update. Open Sales receipts for pass and payment links.

   Expect · the sale receipt opens in the Arkiv data explorer

9. 9

   Claim the money

   Send a little AVAX to the provider's Swarm wallet. In Sales, tab Payment activity, select Claim USDC. Optional: withdraw USDC to any address, reveal the private key for MetaMask.

   Expect · USDC balance goes up, claim tx on the explorer

10. 10

    Verify without the app

    Arkiv data explorer with $owner = addr(0x401629d4…); the contract's Purchased and Claimed events on the explorer; manifest bytes at https://api.gateway.ethswarm.org/bytes/<manifest_ref>.

    Expect · every entity, event and byte reachable outside APIritivo

ETHRome 2026 ↗