memory

type AssetConfig struct {
	// Name is the human-readable name of the asset (e.g., "USD Coin")
	// If empty, it will inherit the Symbol value during validation
	Name string `yaml:"name"`
	// Symbol is the ticker symbol for the asset (e.g., "USDC")
	// This field is required for enabled assets
	Symbol string `yaml:"symbol"`
	// Decimals is the number of decimal places for the asset
	Decimals uint8
	// SuggestedBlockchainID is the chain ID of the blockchain where this asset is primarily used
	SuggestedBlockchainID uint64 `yaml:"suggested_blockchain_id"`
	// Disabled determines if this asset should be processed
	Disabled bool `yaml:"disabled"`
	// Tokens contains the blockchain-specific token implementations
	Tokens []TokenConfig `yaml:"tokens"`
}

type AssetsConfig struct {
	Assets []AssetConfig `yaml:"assets"`
}

type BlockchainConfig struct {
	// Name is the blockchain identifier (e.g., "polygon_amoy", "base_sepolia")
	// Must match pattern: lowercase letters and underscores only
	Name string `yaml:"name"`
	// ID is the chain ID used for RPC validation
	ID uint64 `yaml:"id"`
	// TODO: blockchains must not be disabled in prod deployment
	Disabled bool `yaml:"disabled"`
	// BlockStep defines the block range for scanning (default: 10000)
	BlockStep uint64 `yaml:"block_step"`
	// ChannelHubAddress is the address of the ChannelHub contract on this blockchain
	ChannelHubAddress string `yaml:"channel_hub_address"`
	// ChannelHubSigValidators maps validator IDs to the addresses of signature validators for the ChannelHub contract on this blockchain
	ChannelHubSigValidators map[uint8]string `yaml:"channel_hub_sig_validators"`
	// LockingContractAddress is the address of the locking contract on this blockchain
	LockingContractAddress string `yaml:"locking_contract_address"`
}

type BlockchainsConfig struct {
	Blockchains []BlockchainConfig `yaml:"blockchains"`
}

type MemoryStore interface {
	// GetBlockchains retrieves the list of supported blockchains.
	GetBlockchains() ([]core.Blockchain, error)

	// GetAssets retrieves the list of supported assets.
	// If blockchainID is provided, filters assets to only include tokens on that blockchain.
	GetAssets(blockchainID *uint64) ([]core.Asset, error)

	// GetChannelSigValidators retrieves the channel signature validators for a specific blockchain.
	GetChannelSigValidators(blockchainID uint64) (map[uint8]string, error)

	// GetTokenAddress retrieves the token address for a given asset on a specific blockchain.
	GetTokenAddress(asset string, blockchainID uint64) (string, error)

	// IsAssetSupported checks if a given asset (token) is supported on the specified blockchain.
	IsAssetSupported(asset, tokenAddress string, blockchainID uint64) (bool, error)

	// GetAssetDecimals checks if an asset exists and returns its decimals in YN
	GetAssetDecimals(asset string) (uint8, error)

	// GetTokenDecimals returns the decimals for a token on a specific blockchain
	GetTokenDecimals(blockchainID uint64, tokenAddress string) (uint8, error)
}

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

type TokenConfig struct {
	// Name is the token name on this blockchain (e.g., "Bridged USDC")
	// If empty, it will inherit from the parent asset's Name
	Name string `yaml:"name"`
	// Symbol is the token symbol on this blockchain
	// If empty, it will inherit from the parent asset's Symbol
	Symbol string `yaml:"symbol"`
	// BlockchainID is the chain ID where this token is deployed
	BlockchainID uint64 `yaml:"blockchain_id"`
	// Disabled determines if this token should be processed
	Disabled bool `yaml:"disabled"`
	// Address is the token's contract address on the blockchain
	// Must be a valid Ethereum address (0x followed by 40 hex characters)
	Address string `yaml:"address"`
	// Decimals is the number of decimal places for the token
	Decimals uint8 `yaml:"decimals"`
}