genesis

Documentation

Index

• type Account
• type Approver
• type Authority
• type Builder
  • func (b *Builder) Build(stater *state.Stater) (blk *block.Block, events tx.Events, transfers tx.Transfers, err error)
  • func (b *Builder) Call(clause *tx.Clause, caller thor.Address) *Builder
  • func (b *Builder) ComputeID() (thor.Bytes32, error)
  • func (b *Builder) ExtraData(data [28]byte) *Builder
  • func (b *Builder) ForkConfig(fc thor.ForkConfig) *Builder
  • func (b *Builder) GasLimit(limit uint64) *Builder
  • func (b *Builder) State(proc func(state *state.State) error) *Builder
  • func (b *Builder) Timestamp(t uint64) *Builder
• type CustomGenesis
• type DevAccount
  • func DevAccounts() []DevAccount
• type Executor
• type Genesis
  • func NewCustomNet(gen *CustomGenesis) (*Genesis, error)
  • func NewDevnet() *Genesis
  • func NewMainnet() *Genesis
  • func NewTestnet() *Genesis
  • func (g *Genesis) Build(stater *state.Stater) (blk *block.Block, events tx.Events, transfers tx.Transfers, err error)
  • func (g *Genesis) ID() thor.Bytes32
  • func (g *Genesis) Name() string
• type HexOrDecimal256
  • func (i HexOrDecimal256) MarshalJSON() ([]byte, error)
  • func (i *HexOrDecimal256) UnmarshalJSON(input []byte) error
• type Params

Types

type Account

type Account struct {
	Address thor.Address            `json:"address"`
	Balance *HexOrDecimal256        `json:"balance"`
	Energy  *HexOrDecimal256        `json:"energy"`
	Code    string                  `json:"code"`
	Storage map[string]thor.Bytes32 `json:"storage"`
}

Account is the account will set to the genesis block

type Approver

type Approver struct {
	Address  thor.Address `json:"address"`
	Identity thor.Bytes32 `json:"identity"`
}

Approver is the approver info for executor contract

type Authority

type Authority struct {
	MasterAddress   thor.Address `json:"masterAddress"`
	EndorsorAddress thor.Address `json:"endorsorAddress"`
	Identity        thor.Bytes32 `json:"identity"`
}

Authority is the authority node info

type Builder

type Builder struct {
	// contains filtered or unexported fields
}

Builder helper to build genesis block.

func (*Builder) Build

func (b *Builder) Build(stater *state.Stater) (blk *block.Block, events tx.Events, transfers tx.Transfers, err error)

Build build genesis block according to presets.

func (*Builder) Call

func (b *Builder) Call(clause *tx.Clause, caller thor.Address) *Builder

Call add a contract call.

func (*Builder) ComputeID

func (b *Builder) ComputeID() (thor.Bytes32, error)

ComputeID compute genesis ID.

func (*Builder) ExtraData

func (b *Builder) ExtraData(data [28]byte) *Builder

ExtraData set extra data, which will be put into last 28 bytes of genesis parent id.

func (*Builder) ForkConfig

func (b *Builder) ForkConfig(fc thor.ForkConfig) *Builder

ForkConfig set fork config.

func (*Builder) GasLimit

func (b *Builder) GasLimit(limit uint64) *Builder

GasLimit set gas limit.

func (*Builder) State

func (b *Builder) State(proc func(state *state.State) error) *Builder

State add a state process !!!touch accounts's energy is mandatory if you touch its balance

func (*Builder) Timestamp

func (b *Builder) Timestamp(t uint64) *Builder

Timestamp set timestamp.

type CustomGenesis

type CustomGenesis struct {
	LaunchTime uint64           `json:"launchTime"`
	GasLimit   uint64           `json:"gaslimit"`
	ExtraData  string           `json:"extraData"`
	Accounts   []Account        `json:"accounts"`
	Authority  []Authority      `json:"authority"`
	Params     Params           `json:"params"`
	Executor   Executor         `json:"executor"`
	ForkConfig *thor.ForkConfig `json:"forkConfig"`
}

CustomGenesis is user customized genesis

type DevAccount

type DevAccount struct {
	Address    thor.Address
	PrivateKey *ecdsa.PrivateKey
}

DevAccount account for development.

func DevAccounts

func DevAccounts() []DevAccount

DevAccounts returns pre-alloced accounts for solo mode.

type Executor

type Executor struct {
	Approvers []Approver `json:"approvers"`
}

Executor is the params for executor info

type Genesis

type Genesis struct {
	// contains filtered or unexported fields
}

Genesis to build genesis block.

func NewCustomNet

func NewCustomNet(gen *CustomGenesis) (*Genesis, error)

NewCustomNet create custom network genesis.

func NewDevnet

func NewDevnet() *Genesis

NewDevnet create genesis for solo mode.

func NewMainnet

func NewMainnet() *Genesis

NewMainnet create mainnet genesis.

func NewTestnet

func NewTestnet() *Genesis

NewTestnet create genesis for testnet.

func (*Genesis) Build

func (g *Genesis) Build(stater *state.Stater) (blk *block.Block, events tx.Events, transfers tx.Transfers, err error)

Build build the genesis block.

func (*Genesis) ID

func (g *Genesis) ID() thor.Bytes32

ID returns genesis block ID.

func (*Genesis) Name

func (g *Genesis) Name() string

Name returns network name.

type HexOrDecimal256

type HexOrDecimal256 math.HexOrDecimal256

hexOrDecimal256 marshals big.Int as hex or decimal. Copied from go-ethereum/common/math and implement json. Marshaler

func (HexOrDecimal256) MarshalJSON

func (i HexOrDecimal256) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface.

func (*HexOrDecimal256) UnmarshalJSON

func (i *HexOrDecimal256) UnmarshalJSON(input []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

type Params

type Params struct {
	RewardRatio         *HexOrDecimal256 `json:"rewardRatio"`
	BaseGasPrice        *HexOrDecimal256 `json:"baseGasPrice"`
	ProposerEndorsement *HexOrDecimal256 `json:"proposerEndorsement"`
	ExecutorAddress     *thor.Address    `json:"executorAddress"`
	MaxBlockProposers   *uint64          `json:"maxBlockProposers"`
}

Params means the chain params for params contract