Skip to content

Commit 4614a3f

Browse files
committed
Added a bit about manually creating a revoc reg tails file
Signed-off-by: Ian Costanzo <ian@anon-solutions.ca>
1 parent 22ca606 commit 4614a3f

1 file changed

Lines changed: 30 additions & 0 deletions

File tree

docs/GettingStartedAriesDev/CredentialRevocation.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,3 +151,33 @@ further customize notification handling.
151151
If the argument `--monitor-revocation-notification` is used on startup, a
152152
webhook with the topic `revocation-notification` and a payload containing the
153153
thread ID and comment is emitted to registered webhook urls.
154+
155+
## Manually Creating Revocation Registries
156+
157+
The process for creating revocation registries is completely automated - when you create a Credential Definition with revocation enabled, a revocation registry is automatically created (in fact 2 registries are created), and when a registry fills up, a new one is automatically created.
158+
159+
However the Aca-Py admin api supports endpoints to explicitely create a new revocation registry, if you desire.
160+
161+
There are several endpoints that must be called, and they must be called in this order:
162+
163+
1. Create revoc registry `POST /revocation/create-registry`
164+
165+
- you need to provide the credential definition id and the size of the registry
166+
167+
2. Fix the tails file URI `PATCH /revocation/registry/{rev_reg_id}`
168+
169+
- here you need to provide the full URI that will be written to the ledger, for example:
170+
171+
```
172+
{
173+
"tails_public_uri": "http://host.docker.internal:6543/VDKEEMMSRTEqK4m7iiq5ZL:4:VDKEEMMSRTEqK4m7iiq5ZL:3:CL:8:faber.agent.degree_schema:CL_ACCUM:3cb5c439-928c-483c-a9a8-629c307e6b2d"
174+
}
175+
```
176+
177+
3. Post the revoc def to the ledger `POST /revocation/registry/{rev_reg_id}/definition`
178+
179+
- if you are an author (i.e. have a DID with restricted ledger write access) then this transaction may need to go through an endorser
180+
181+
4. Write the tails file `PUT /revocation/registry/{rev_reg_id}/tails-file`
182+
183+
- the tails server will check that the registry definition is already written to the ledger

0 commit comments

Comments
 (0)