Skip to main content

Reinstate Root Authority

This guide demonstrates how to reinstate a previously revoked root authority in a federation.

Prerequisites

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

Overview

Reinstating a root authority restores full permissions to a previously revoked entity. This allows for flexible authority management where temporary revocations can be reversed when needed.

1. Set Up Client

Initialize a funded client to interact with the hierarchy:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

2. Create Federation and Add Second Root Authority

Create a federation and add a second root authority that will be revoked and then reinstated:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

3. Revoke Root Authority

First, revoke the root authority that will later be reinstated:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

4. Verify Revocation Status

Check the federation state after revocation:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

5. Reinstate Root Authority

Reinstate the previously revoked root authority:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

6. Verify Reinstatement

Confirm the root authority has been successfully reinstated:

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...

Key Points

  • Flexibility: Allows temporary revocation and restoration of root authority permissions
  • Authority Required: Only existing root authorities can reinstate revoked authorities
  • State Tracking: The federation tracks both active and revoked root authorities
  • Immediate Effect: Reinstatement takes effect immediately, restoring full permissions
  • Reversible Action: Unlike permanent removal, revoked authorities can be restored

Full Example Code

hierarchies-rs/examples/09_reinstate_root_authority.rs
loading...