context

type AtomicPutRequest struct {
	Key    []byte   // The key to store
	Value  []byte   // The value to store
	Traits [][]byte // Traits for indexing
}

type AtomicRequests struct {
	RemoveRequests [][]byte            // Keys to remove
	PutRequests    []*AtomicPutRequest // Key-value pairs to put
}

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

type BlockchainIDLookup = BCLookup

type Context struct {
	// NetworkID is the numeric network identifier (1=mainnet, 2=testnet)
	// EVM chain IDs are derived: mainnet=96369, testnet=96368
	NetworkID uint32 `json:"networkID"`
	// ChainID identifies the specific chain within the network
	ChainID      ids.ID     `json:"chainID"`
	NodeID       ids.NodeID `json:"nodeID"`
	PublicKey    []byte     `json:"publicKey"`
	XChainID     ids.ID     `json:"xChainID"`
	CChainID     ids.ID     `json:"cChainID"`
	XAssetID     ids.ID     `json:"xAssetID"` // Primary asset ID (X-chain native)
	ChainDataDir string     `json:"chainDataDir"`

	// Timing
	StartTime time.Time `json:"startTime"`

	ValidatorState  interface{} // validators.State or ValidatorState interface
	Keystore        Keystore
	Metrics         interface{} // metrics.MultiGatherer or Metrics interface
	Log             interface{} // logging.Logger
	SharedMemory    interface{} // atomic.SharedMemory
	BCLookup        BCLookup    // Blockchain alias lookup
	WarpSigner      interface{} // warp.Signer
	NetworkUpgrades interface{} // upgrade.Config

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

type GetValidatorOutput struct {
	NodeID    ids.NodeID
	PublicKey []byte
	Weight    uint64
}

type IDs struct {
	NetworkID    uint32 // 1=mainnet, 2=testnet
	ChainID      ids.ID
	NodeID       ids.NodeID
	PublicKey    []byte
	XAssetID     ids.ID // Primary asset ID (X-chain native)
	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{})
}

type Metrics interface {
	Register(namespace string, registerer interface{}) error
}

type NetworkUpgrades interface {
	// IsApricotPhase3Activated returns true if the Apricot Phase 3 upgrade is activated
	IsApricotPhase3Activated(timestamp time.Time) bool
	// IsApricotPhase5Activated returns true if the Apricot Phase 5 upgrade is activated
	IsApricotPhase5Activated(timestamp time.Time) bool
	// IsBanffActivated returns true if the Banff upgrade is activated
	IsBanffActivated(timestamp time.Time) bool
	// IsCortinaActivated returns true if the Cortina upgrade is activated
	IsCortinaActivated(timestamp time.Time) bool
	// IsDurangoActivated returns true if the Durango upgrade is activated
	IsDurangoActivated(timestamp time.Time) bool
	// IsEtnaActivated returns true if the Etna upgrade is activated
	IsEtnaActivated(timestamp time.Time) bool
}

type SharedMemory interface {
	Get(peerChainID ids.ID, keys [][]byte) (values [][]byte, err error)
	Indexed(
		peerChainID ids.ID,
		traits [][]byte,
		startTrait, startKey []byte,
		limit int,
	) (values [][]byte, lastTrait, lastKey []byte, err error)
	// Apply applies atomic requests to shared memory
	Apply(requests map[ids.ID]*AtomicRequests, batch interface{}) error
}

type ValidatorState interface {
	GetChainID(ids.ID) (ids.ID, error)
	GetNetworkID(ids.ID) (ids.ID, error)
	GetValidatorSet(uint64, ids.ID) (map[ids.NodeID]uint64, error)
	GetCurrentHeight(context.Context) (uint64, error)
	GetMinimumHeight(context.Context) (uint64, error)
}

type WarpSigner interface {
	// Sign signs the given message and returns the signature
	Sign(msg interface{}) ([]byte, error)
	// PublicKey returns the BLS public key bytes
	PublicKey() []byte
	// NodeID returns the node ID associated with this signer
	NodeID() ids.NodeID
}