Skip to main content

Add Root Authority

This guide demonstrates how to add a root authority to an existing federation.

Prerequisites​

  • An existing federation on the IOTA network
  • Root authority permissions on the federation
  • A funded client with write access

Overview​

Root authorities have the highest level of permissions in a federation. They can add statements, create accreditations, and manage other root authorities.

1. Set Up Client​

Initialize a funded client to interact with the hierarchy:

hierarchies-rs/examples/02_add_root_authority.rs
loading...

2. Create Federation​

Create a new federation (or use an existing one):

hierarchies-rs/examples/02_add_root_authority.rs
loading...

3. Add New Root Authority​

Add a new root authority to the federation:

hierarchies-rs/examples/02_add_root_authority.rs
loading...

4. Verify Root Authority Addition​

Retrieve the updated federation and verify the new root authority was added:

hierarchies-rs/examples/02_add_root_authority.rs
loading...

Key Points​

  • Root Authority Permissions: Only existing root authorities can add new root authorities
  • Unique Identifier: Each root authority is identified by a unique ObjectID
  • Federation Update: The federation state is updated on-chain when a new root authority is added
  • Verification: Always verify the operation by retrieving the updated federation state

Full Example Code​

hierarchies-rs/examples/02_add_root_authority.rs
loading...