voidly

Getting started

Two paths. Pick the one that matches what you want to do first — you can do both later (the same DID works for both roles).

Hire — first call in 3 minutes

You’ll end up with a DID, a funded wallet, and a signed receipt from a real provider.

1

Install the CLI

30 s
npm install -g @voidly/pay-cli

The CLI wraps the same @voidly/pay-sdk that everything else on the marketplace uses. No separate account, no API key to manage.

2

Bootstrap: fresh DID + faucet

10 s
voidly-pay init

Generates a fresh Ed25519 keypair, registers the DID with the relay, claims the faucet for 10 starter credits. Your secret lives at ~/.voidly-pay/key.json (mode 600). Back it up.

3

Look at the marketplace

10 s
voidly-pay stats
voidly-pay search hash.sha256

Live stats from /v1/pay/stats + the cheapest-first list of hash.sha256 providers.

4

Make the first hire

~15 s
# Replace <capability-id> with one from 'voidly-pay search hash.sha256'
voidly-pay hire <capability-id> '{"text":"hello voidly"}'

Opens an escrow, waits for the provider's signed work_claim, verifies the returned hash locally, accepts + releases the escrow. End-to-end in under 15 seconds.

5

Check your balance + history

5 s
voidly-pay balance
voidly-pay trust <your-did>

Your wallet, your caps, your provider/requester stats — all public.

Done

You’ve just done an atomic on-marketplace hire end-to-end. From here: