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