Lab: Prove¶
Have a fact confirmed, keep it in your app, and show only part of it. Then check it the way a service would. It takes about 15 minutes.
You need the app, signed in. For the last part, you also need Python.
1. Confirm something¶
An attestation is something someone else confirms about you. Here, you play both parts.
Choose New → Attestation and fill in:
| Field | Enter |
|---|---|
| Kind | lab_member |
| Detail (yes/no) | member: yes |
| Detail (text) | member_since: 2026 |
Choose Create offer. Copy the link right away, because it's shown only once.
You should see the attestation under Issued, reading Offered.
2. Accept it¶
Open the link with New → Open or scan a link.
You should see who confirms it, what it confirms, and which identity gets it. Press Accept. Your identity's key signs, and nothing else is sent.
You should see it under Held, with the status Verified.
3. Ask to see it¶
Now play the service. Choose New → See someone's attestation:
| Field | Enter |
|---|---|
| Kind | lab_member |
| Details you need | member |
Choose Create check, and copy the link. It works once, for ten minutes.
4. Show only part of it¶
Open the link.
You should see who is asking, and a tick box for each detail. member starts
ticked and member_since doesn't. Leave them that way, and press Show it.
The proof is made on your device and made for this one request. The service can't pass it on.
5. See what the service sees¶
Open Attestations → Checked.
You should see member with its value and member_since marked Withheld.
The service can tell there's more, but not what.
6. Check it from your own code¶
A service asks with a link and receives the proof at an address of its own. Start the listener:
python3 examples/labs/listen.py 8000
Open this link in the app, on the same computer:
revoked://present?client_id=http%3A%2F%2Flocalhost%3A8000&response_uri=http%3A%2F%2Flocalhost%3A8000%2Fpresent&nonce=lab-nonce-12345678&type=lab_member&issuers=api.revoked.link&claims=member
Press Show it.
You should see the proof in your listener's window, as
{ "presentation": "…" }. Copy it, and ask any Revoked server to check it:
curl "https://api.revoked.link/api/attestations/verify" \
-H "Content-Type: application/json" \
-d '{ "presentation": "<the proof>",
"audience": "http://localhost:8000",
"nonce": "lab-nonce-12345678" }'
You should see an answer like this:
{
"state": "verified",
"issuer": "api.revoked.link",
"type": "lab_member",
"claims": { "member": true },
"withheld": 1,
"status": "valid",
"keyBound": true
}
Run it again with a different nonce.
You should see that it's no longer verified. A proof only works for the
request it was made for, so a copy is no use to anyone else.
7. Withdraw it¶
Under Issued, press Revoke. Then run the check from step 6 again.
You should see "state": "revoked". Anyone who checks is told within
minutes.
What just happened¶
The service never contacted whoever confirmed it. It checked two things: that the domain really signed this, and that the person holding it made this proof.
sequenceDiagram
participant C as Who confirms it
participant Y as Your app
participant S as The service
participant V as A Revoked server
C->>Y: Offer
Y->>C: Accept, signed with your key
C-->>Y: The attestation
S->>Y: Ask, with a fresh nonce
Y->>Y: You tick the details
Y-->>S: Proof for this request only
S->>V: Check the proof
V->>V: DNS, signature, status, key
V-->>S: verified, and the ticked details
If something doesn't match¶
| What you see | What to do |
|---|---|
| New → Attestation is missing | You need the Issue attestations permission, and the server needs ALLOW_ATTESTATIONS=true. |
| The offer link is gone | Make a new offer. A link is shown only once. |
| The check link no longer works | It works once, for ten minutes. Make a new one. |
unverified |
A check couldn't finish, or you left out audience and nonce. |
dnsMissing |
The domain has no _revoked DNS record. On your own server, publish it. |
| Nothing fits in the app | The kind must match. Check that you held lab_member in step 2. |
Next¶
- Attestations has the whole picture for people.
- Attestations for developers has the format and every state.
- Trust chain explains each check.