gnoland

type AppOptions struct {
	DB                         dbm.DB             // required
	Logger                     *slog.Logger       // required
	EventSwitch                events.EventSwitch // required
	VMOutput                   io.Writer          // optional
	SkipGenesisSigVerification bool               // default to verify genesis transactions
	SkipUpgradeHeight          int64              // if set, skip the halt_min_version check at this height
	InitChainerConfig                             // options related to InitChainer
	MinGasPrices               string             // optional
	PruneStrategy              types.PruneStrategy
}

type Balance struct {
	Address bft.Address
	Amount  std.Coins
}

type Balances map[crypto.Address]Balance

type BitSet uint64

type GenesisAppConfig struct {
	SkipFailingTxs      bool // does not stop the chain from starting if any tx fails
	SkipSigVerification bool // does not verify the transaction signatures in genesis
}

type GenesisSigner interface {
	PubKey() crypto.PubKey
	Sign(msg []byte) ([]byte, error)
}

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

type GenesisTxResultHandler func(ctx sdk.Context, tx std.Tx, res sdk.Result)

type GnoAccount struct {
	std.BaseAccount
	Attributes BitSet `json:"attributes" yaml:"attributes"`
}

type GnoGenesisState struct {
	Balances []Balance         `json:"balances"`
	Txs      []TxWithMetadata  `json:"txs"`
	Auth     auth.GenesisState `json:"auth"`
	Bank     bank.GenesisState `json:"bank"`
	VM       vm.GenesisState   `json:"vm"`
	// Chain upgrade fields
	PastChainIDs  []string `json:"past_chain_ids,omitempty"` // Allowlist of chain IDs valid for historical tx signature verification
	InitialHeight int64    `json:"initial_height,omitempty"` // Block height to start from after genesis replay
	// GasReplayMode controls how historical txs (metadata.BlockHeight > 0) are
	// metered during replay. Valid values:
	//   "" or "strict" — use the new VM's gas meter (default; may fail txs
	//       that worked on the source chain if gas requirements changed)
	//   "source"       — bypass the new gas meter for historical txs; they
	//       execute with unlimited gas and the response records
	//       metadata.GasUsed from the source chain. This preserves the
	//       historical outcome even if the VM's gas metering changed.
	GasReplayMode string `json:"gas_replay_mode,omitempty"`
}

type GnoSessionAccount struct {
	std.BaseSessionAccount
	AllowPaths []string `json:"allow_paths,omitempty" yaml:"allow_paths,omitempty"`
}

type GnoTxMetadata struct {
	Timestamp   int64               `json:"timestamp"`
	BlockHeight int64               `json:"block_height,omitempty"` // Original block height for historical tx replay
	ChainID     string              `json:"chain_id,omitempty"`     // Originating chain ID, populated by tx-archive export
	Failed      bool                `json:"failed,omitempty"`       // True if tx had non-zero return code on source chain
	SignerInfo  []SignerAccountInfo `json:"signer_info,omitempty"`  // Per-signer account metadata for signature verification
	GasUsed     int64               `json:"gas_used,omitempty"`     // Gas consumed on source chain (used when GasReplayMode="source")
	GasWanted   int64               `json:"gas_wanted,omitempty"`   // Gas requested on source chain (informational / report)
}

type InMemoryNodeConfig struct {
	PrivValidator              bft.PrivValidator // identity of the validator
	Genesis                    *bft.GenesisDoc
	TMConfig                   *tmcfg.Config
	DB                         db.DB     // will be initialized if nil
	VMOutput                   io.Writer // optional
	SkipGenesisSigVerification bool

	// If StdlibDir not set, then it's filepath.Join(TMConfig.RootDir, "gnovm", "stdlibs")
	InitChainerConfig
}

type InitChainerConfig struct {
	// Handles the results of each genesis transaction.
	GenesisTxResultHandler

	// Standard library directory.
	StdlibDir string
	// Whether to keep a record of the DB operations to load standard libraries,
	// so they can be quickly replicated on additional genesis executions.
	// This should be used for integration testing, where InitChainer will be
	// called several times.
	CacheStdlibLoad bool

	// StrictReplay refuses to boot the chain if any non-skipped genesis tx
	// fails replay. Hardfork operators should enable this so a corrupted
	// genesis aborts InitChain loudly instead of producing a chain whose
	// AppHash silently diverges from the source.
	//
	// Skipped txs (those carrying metadata.Failed = true, which were
	// intentionally non-applied on the source chain) do not count as
	// failures.
	StrictReplay bool

	// SkipValoperCoverageAssertion turns off the hardfork-mode
	// AssertGenesisValopersConsistent auto-call. Useful for paths that
	// boot a chain with PastChainIDs set but a synthetic req.Validators
	// that won't match any seeded valoper profile — e.g. gnogenesis
	// fork test replaces genDoc.Validators with a fresh MockPV whose
	// signing addr is never registered, so the assertion would fire
	// spuriously. Production hardfork boots leave this false.
	SkipValoperCoverageAssertion bool
	// contains filtered or unexported fields
}

type ReplayCategory string

type SignerAccountInfo struct {
	Address    crypto.Address `json:"address"`
	AccountNum uint64         `json:"account_num"` // Stable, never changes once assigned
	Sequence   uint64         `json:"sequence"`    // Pre-tx sequence (value used in GetSignBytes)
}

type TxWithMetadata struct {
	Tx       std.Tx         `json:"tx"`
	Metadata *GnoTxMetadata `json:"metadata,omitempty"`
}