Skip to main content

Revoke Root Authority

This guide demonstrates how to revoke a root authority from a federation.

Prerequisites​

  • An existing federation with multiple root authorities
  • Root authority permissions to revoke other root authorities
  • A funded client with write access

Overview​

Revoking root authority removes the highest level of permissions from an entity in the federation. This action is irreversible and requires careful consideration.

1. Set Up Client​

Initialize a funded client to interact with the hierarchy:

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...

2. Create Federation and Add Second Root Authority​

Create a federation and add a second root authority (to ensure we can revoke one):

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...

3. Verify Root Authority Status​

Confirm the second root authority is active:

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...

4. Revoke Root Authority​

Revoke the second root authority:

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...

5. Verify Revocation​

Confirm the root authority has been successfully revoked:

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...

Key Points​

  • Irreversible Action: Once revoked, root authority cannot be restored to the same entity
  • Multiple Authorities Required: Cannot revoke the last remaining root authority
  • Immediate Effect: Revocation takes effect immediately on-chain
  • Tracked History: Revoked root authorities are recorded in the federation's history

Full Example Code​

hierarchies-rs/examples/08_revoke_root_authority.rs
loading...