runtime

type BCLookup interface {
	Lookup(alias string) (ids.ID, error)
	PrimaryAlias(id ids.ID) (string, error)
	Aliases(id ids.ID) ([]string, error)
}

type Context = Runtime

type GetValidatorOutput = validators.GetValidatorOutput

type IDs struct {
	NetworkID    uint32
	ChainID      ids.ID
	NodeID       ids.NodeID
	PublicKey    []byte
	UTXOAssetID  ids.ID
	ChainDataDir string `json:"chainDataDir"`
}

type Keystore interface {
	GetDatabase(username, password string) (interface{}, error)
	NewAccount(username, password string) error
}

type Logger interface {
	Debug(msg string, fields ...interface{})
	Info(msg string, fields ...interface{})
	Warn(msg string, fields ...interface{})
	Error(msg string, fields ...interface{})
	Fatal(msg string, fields ...interface{})
	IsZero() bool
}

type Metrics interface {
	metric.Gatherer
	Register(name string, gatherer metric.Gatherer) error
}

type Runtime struct {
	// NetworkID is the numeric network identifier (1=mainnet, 2=testnet)
	NetworkID uint32 `json:"networkID"`

	// ChainID identifies the specific chain within the network
	ChainID ids.ID `json:"chainID"`

	// NodeID identifies this node
	NodeID ids.NodeID `json:"nodeID"`

	// PublicKey is the node's BLS public key bytes
	PublicKey []byte `json:"publicKey"`

	// XChainID is the X-Chain identifier
	XChainID ids.ID `json:"xChainID"`

	// CChainID is the C-Chain identifier
	CChainID ids.ID `json:"cChainID"`

	// UTXOAssetID is the primary network's UTXO fee asset — burned to
	// pay fees on P-chain (CreateChainTx, AddChainValidatorTx, …) and
	// X-chain transfers. Sourced from the chain's genesis (the X-chain's
	// native asset by upstream convention; on a sovereign L1 it's
	// whatever native the chain bootstraps with — LUX on Lux primary,
	// LQDTY on a Liquidity-sovereign primary). Same number on P and X
	// by construction; named for the function, not the chain.
	UTXOAssetID ids.ID `json:"utxoAssetID"`

	// ChainDataDir is the directory for chain-specific data
	ChainDataDir string `json:"chainDataDir"`

	// StartTime is when the node started
	StartTime time.Time `json:"startTime"`

	// PChainHeight is the optional proposer P-Chain height for block-specific operations.
	PChainHeight uint64 `json:"pChainHeight"`

	// ValidatorState provides validator information (uses consensus/validators.State)
	ValidatorState validators.State

	// Keystore provides key management
	Keystore Keystore

	// Metrics provides metrics tracking
	Metrics Metrics

	// Log provides logging
	Log Logger

	// SharedMemory provides cross-chain atomic operations
	SharedMemory SharedMemory

	// BCLookup provides blockchain alias lookup
	BCLookup BCLookup

	// WarpSigner provides BLS signing for Warp messages
	WarpSigner WarpSigner

	// Sender is the canonical warp sender
	Sender warp.Sender

	// Lock for thread-safe access to runtime fields
	Lock sync.RWMutex
}

type SharedMemory = atomic.SharedMemory

type VMContext interface {
	GetNetworkID() uint32
	GetChainID() ids.ID
	GetNodeID() ids.NodeID
	GetPublicKey() []byte
	GetXChainID() ids.ID
	GetCChainID() ids.ID
	GetAssetID() ids.ID
	GetChainDataDir() string
	GetLog() Logger
	GetSharedMemory() SharedMemory
	GetMetrics() Metrics
	GetValidatorState() ValidatorState
	GetBCLookup() BCLookup
	GetWarpSigner() WarpSigner
	GetSender() warp.Sender
}

type ValidatorState = validators.State

type WarpSigner = warp.Signer