Skip to content

Latest commit

 

History

History
 
 

genesis

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
generate
generate
 
 
README.md
README.md
 
 
aliases.go
aliases.go
 
 
bootstrappers.go
bootstrappers.go
 
 
bootstrappers.json
bootstrappers.json
 
 
bootstrappers_test.go
bootstrappers_test.go
 
 
checkpoints.go
checkpoints.go
 
 
checkpoints.json
checkpoints.json
 
 
config.go
config.go
 
 
config_test.go
config_test.go
 
 
genesis.go
genesis.go
 
 
genesis_fuji.go
genesis_fuji.go
 
 
genesis_fuji.json
genesis_fuji.json
 
 
genesis_local.go
genesis_local.go
 
 
genesis_local.json
genesis_local.json
 
 
genesis_mainnet.go
genesis_mainnet.go
 
 
genesis_mainnet.json
genesis_mainnet.json
 
 
genesis_test.go
genesis_test.go
 
 
genesis_test.json
genesis_test.json
 
 
params.go
params.go
 
 
unparsed_config.go
unparsed_config.go
 
 
validators.go
validators.go
 
 
validators.json
validators.json
 
 

README.md

Genesis

The Genesis package converts formatted JSON files into the genesis of the Primary Network. For the simplest example, see the Local Genesis JSON file.

The genesis JSON file contains the following properties:

  • networkID: A unique identifier for the blockchain, must be a number in the range [0, 2^32).
  • allocations: The list of initial addresses, their initial balances and the unlock schedule for each.
  • startTime: The time of the beginning of the blockchain, it must be a Unix timestamp and it can't be a time in the future.
  • initialStakeDuration: The stake duration, in seconds, of the validators that exist at network genesis.
  • initialStakeDurationOffset: The offset, in seconds, between the end times of the validators that exist at genesis.
  • initialStakedFunds: A list of addresses that own the funds staked at genesis (each address must be present in allocations as well)
  • initialStakers: The validators that exist at genesis. Each element contains the rewardAddress, NodeID and the delegationFee of the validator.
  • cChainGenesis: The genesis info to be passed to the C-Chain.
  • message: A message to include in the genesis. Not required.

Allocations and Genesis Stakers

Each allocation contains the following fields:

  • ethAddr: Annotation of corresponding Ethereum address holding an ERC-20 token
  • avaxAddr: X/P Chain address to receive the allocation
  • initialAmount: Initial unlocked amount minted to the avaxAddr on the X-Chain
  • unlockSchedule: List of locked, stakeable UTXOs minted to avaxAddr on the P-Chain

Note: if an avaxAddr from allocations is included in initialStakers, the genesis includes all the UTXOs specified in the unlockSchedule as part of the locked stake of the corresponding genesis validator. Otherwise, the locked UTXO is created directly on the P-Chain.