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...