Skip to main content

Create Federation

This guide demonstrates how to create a new Federation and publish it on chain.

Prerequisites​

  • A funded IOTA account
  • Access to an IOTA network (testnet, devnet, or local)
  • Hierarchies client SDK installed

Overview​

A Federation is the core structure in hierarchies that manages accreditations and attestations. Creating a federation is the first step in setting up a hierarchy system.

1. Set Up Funded Client​

Initialize a funded client to interact with the IOTA network:

hierarchies-rs/examples/01_create_federation.rs
loading...

2. Create Federation​

Create a new Federation on the IOTA network:

hierarchies-rs/examples/01_create_federation.rs
loading...

3. Verify Federation Creation​

After creation, verify the federation has been successfully created:

hierarchies-rs/examples/01_create_federation.rs
loading...

Key Points​

  • Federation ID: Each federation receives a unique ID upon creation
  • Root Authority: The creator automatically becomes the first root authority
  • On-chain: The federation is published and stored on the IOTA blockchain
  • Immutable Record: Once created, the federation's existence is permanently recorded

Full Example Code​

hierarchies-rs/examples/01_create_federation.rs
loading...