Delegator Map

The concept of a delegator is crucial for establishing the validator set and providing gas tokens when building a genesis with a migrated state, i.e., a state representing the latest stage of the Stardust mainnet ledger. The delegator is an existing address present in the migrated state that holds IOTA Foundation funds. These funds are partially allocated to meet the staking requirements for validators and to supply them gas tokens during the genesis.

The delegations are needed because:

  • all validators participating to the genesis ceremony need to have at least a minimum required stake to qualify as validators on the new network;
  • validators also require gas tokens to execute transactions during the initial phases of the network.

It is REQUIRED that, given the migrated state, delegators hold at least the amount of IOTA/timelocked IOTA tokens indicated in the Delegator Map. The genesis building process will take care of re-allocating these funds as indicated in the map.

Creating delegations

During a genesis building, a delegator-map.csv file is used to define the relationship between delegators and validators. This file specifies different rows where:

  • Delegator Address: The address contributing funds.
  • Validator Address: The address receiving funds.
  • Staked Amount: The amount of tokens (in nanos) allocated to the validator's stake.
  • Gas Token Amount: The amount of tokens (in nanos) allocated for gas.

Example of delegator-map.csv:

delegator,validator,amount-nanos-to-stake,amount-nanos-to-pay-gas
0x4f72f788cdf4bb478cf9809e878e6163d5b351c82c11f1ea28750430752e7892,0xc05734060fc9ced23bc92a0998e86e4edecf051098de432ccc8c73aa87f745da,50000000000000000,10000000000
  • Delegator Address: 0x4f72f788cdf4bb478cf9809e878e6163d5b351c82c11f1ea28750430752e7892
  • Validator Address: 0xc05734060fc9ced23bc92a0998e86e4edecf051098de432ccc8c73aa87f745da
  • Staked Amount: 50,000,000,000,000,000 nanos.
  • Gas Tokens: 10,000,000,000 nanos.

This mapping ensures validators receive the necessary resources to join the validator set and participate in the network.