v1

type AccountAssets struct {
	// Address of the account.
	Address string `json:"address"`

	// Assets assigned to this account.
	Assets []string `json:"assets"`
}

type AppSpec struct {
	// Container image to be used.
	// +kubebuilder:validation:MinLength=1
	Image string `json:"image"`

	// Image tag to be used. Once there are completed or skipped upgrades this will be ignored.
	// For a new node that will be state-synced, this will be the version used during state-sync. Only after
	// that, the cosmopilot will switch to the version of last upgrade.
	// Defaults to `latest`.
	// +optional
	// +default="latest"
	Version *string `json:"version,omitempty"`

	// Indicates the desired pull policy when creating nodes. Defaults to `Always` if `version`
	// is `latest` and `IfNotPresent` otherwise.
	// +optional
	ImagePullPolicy corev1.PullPolicy `json:"imagePullPolicy,omitempty"`

	// Binary name of the application to be run.
	// +kubebuilder:validation:MinLength=1
	App string `json:"app"`

	// SdkVersion specifies the version of cosmos-sdk used by this app.
	// Valid options are:
	// - "v0.47" (default)
	// - "v0.45"
	// +optional
	// +default="v0.47"
	SdkVersion *SdkVersion `json:"sdkVersion,omitempty"`

	// Whether cosmopilot should query gov proposals to find and schedule upgrades.
	// Defaults to `true`.
	// +optional
	// +default=true
	CheckGovUpgrades *bool `json:"checkGovUpgrades,omitempty"`

	// List of upgrades to schedule for this node.
	// +optional
	Upgrades []UpgradeSpec `json:"upgrades,omitempty"`
}

type ChainNode struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ChainNodeSpec   `json:"spec,omitempty"`
	Status ChainNodeStatus `json:"status,omitempty"`
}

type ChainNodeAssets struct {
	// Name of the ChainNode.
	ChainNode string `json:"chainNode"`

	// Assets assigned to this account.
	Assets []string `json:"assets"`
}

type ChainNodeList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ChainNode `json:"items"`
}

type ChainNodePhase string

type ChainNodeSet struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ChainNodeSetSpec   `json:"spec,omitempty"`
	Status ChainNodeSetStatus `json:"status,omitempty"`
}

type ChainNodeSetList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ChainNodeSet `json:"items"`
}

type ChainNodeSetNodeStatus struct {
	// Name of the node.
	Name string `json:"name"`

	// Whether this node can be accessed publicly.
	Public bool `json:"public"`

	// Indicates if this node is running in seed mode.
	Seed bool `json:"seed"`

	// ID of this node.
	ID string `json:"id"`

	// Hostname or IP address to reach this node internally.
	Address string `json:"address"`

	// Hostname or IP address to reach this node publicly.
	// +optional
	PublicAddress string `json:"publicAddress,omitempty"`

	// Port to reach this node publicly.
	// +optional
	PublicPort int `json:"publicPort,omitempty"`

	// P2P port for connecting to this node.
	Port int `json:"port"`

	// Group to which this ChainNode belongs.
	// +optional
	Group string `json:"group,omitempty"`
}

type ChainNodeSetPhase string

type ChainNodeSetSpec struct {
	// Specifies image, version and binary name of the chain application to run. It also allows to schedule upgrades,
	// or setting/updating the image for an on-chain upgrade.
	App AppSpec `json:"app"`

	// Indicates where this node will get the genesis from. Can be omitted when .spec.validator.init is specified.
	// +optional
	Genesis *GenesisConfig `json:"genesis"`

	// Indicates this node set will run a validator and allows configuring it.
	// +optional
	Validator *NodeSetValidatorConfig `json:"validator,omitempty"`

	// List of groups of ChainNodes to be run.
	Nodes []NodeGroupSpec `json:"nodes"`

	// Ensures that changes to ChainNodeSet are propagated to ChainNode resources one at a time. Cosmopilot will wait
	// for each ChainNode to be in either Running or Syncing state before proceeding to the next one. Note that this
	// does not apply to upgrades, as those are handled directly by the ChainNode controller. Defaults to `false`.
	// +optional
	RollingUpdates *bool `json:"rollingUpdates,omitempty"`

	// List of ingresses to create for this ChainNodeSet. This allows to create ingresses targeting
	// multiple groups of nodes.
	// +optional
	Ingresses []GlobalIngressConfig `json:"ingresses,omitempty"`
}

type ChainNodeSetStatus struct {
	// Indicates the current phase for this ChainNodeSet.
	// +optional
	Phase ChainNodeSetPhase `json:"phase,omitempty"`

	// Indicates the chain ID.
	// +optional
	ChainID string `json:"chainID,omitempty"`

	// Indicates the total number of ChainNode instances on this ChainNodeSet.
	// +optional
	Instances int `json:"instances,omitempty"`

	// The application version currently deployed.
	// +optional
	AppVersion string `json:"appVersion,omitempty"`

	// Nodes available on this nodeset. Excludes validator node.
	// +optional
	Nodes []ChainNodeSetNodeStatus `json:"nodes,omitempty"`

	// Validator address of the validator in this ChainNodeSet if one is available.
	// Omitted when no validator is present in the ChainNodeSet.
	// +optional
	ValidatorAddress string `json:"validatorAddress,omitempty"`

	// Current status of validator if this ChainNodeSet has one.
	// +optional
	ValidatorStatus ValidatorStatus `json:"validatorStatus,omitempty"`

	// Public key of the validator if this ChainNodeSet has one.
	// +optional
	PubKey string `json:"pubKey,omitempty"`

	// All scheduled/completed upgrades performed by cosmopilot on ChainNodes of this CHainNodeSet.
	// +optional
	Upgrades []Upgrade `json:"upgrades,omitempty"`

	// Last height read on the nodes by cosmopilot.
	// +optional
	LatestHeight int64 `json:"latestHeight,omitempty"`
}

type ChainNodeSpec struct {
	// Indicates where this node will get the genesis from. Can be omitted when .spec.validator.init is specified.
	// +optional
	Genesis *GenesisConfig `json:"genesis"`

	// Specifies image, version and binary name of the chain application to run. It also allows to schedule upgrades,
	// or setting/updating the image for an on-chain upgrade.
	App AppSpec `json:"app"`

	// Allows setting specific configurations for this node.
	// +optional
	Config *Config `json:"config,omitempty"`

	// Configures PVC for persisting data. Automated data snapshots can also be configured in
	// this section.
	// +optional
	Persistence *Persistence `json:"persistence,omitempty"`

	// Indicates this node is going to be a validator and allows configuring it.
	// +optional
	Validator *ValidatorConfig `json:"validator,omitempty"`

	// Ensures peers with same chain ID are connected with each other. Enabled by default.
	// +optional
	AutoDiscoverPeers *bool `json:"autoDiscoverPeers,omitempty"`

	// Configures this node to find a state-sync snapshot on the network and restore from it.
	// This is disabled by default.
	// +optional
	StateSyncRestore *bool `json:"stateSyncRestore,omitempty"`

	// Additional persistent peers that should be added to this node.
	// +optional
	Peers []Peer `json:"peers,omitempty"`

	// Allows exposing P2P traffic to public.
	// +optional
	Expose *ExposeConfig `json:"expose,omitempty"`

	// Compute Resources required by the app container.
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// Selector which must be true for the pod to fit on a node.
	// Selector which must match a node's labels for the pod to be scheduled on that node.
	// +optional
	NodeSelector map[string]string `json:"nodeSelector,omitempty"`

	// If specified, the pod's scheduling constraints.
	// +optional
	Affinity *corev1.Affinity `json:"affinity,omitempty"`

	// Whether ChainNodeSet group label should be ignored on pod disruption checks.
	// This is useful to ensure no downtime globally or per global ingress, instead of just per group.
	// Defaults to `false`.
	// +optional
	IgnoreGroupOnDisruptionChecks *bool `json:"ignoreGroupOnDisruptionChecks,omitempty"`

	// Vertical Pod Autoscaling configuration for this node.
	// +optional
	VPA *VerticalAutoscalingConfig `json:"vpa,omitempty"`
}

type ChainNodeStatus struct {
	// Indicates the current phase for this ChainNode.
	// +optional
	Phase ChainNodePhase `json:"phase,omitempty"`

	// Conditions to track state of the ChainNode.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// Indicates this node's ID.
	// +optional
	NodeID string `json:"nodeID,omitempty"`

	// Internal IP address of this node.
	// +optional
	IP string `json:"ip,omitempty"`

	// Public address for P2P when enabled.
	// +optional
	PublicAddress string `json:"publicAddress,omitempty"`

	// Indicates the chain ID.
	// +optional
	ChainID string `json:"chainID,omitempty"`

	// Current size of the data PVC for this node.
	// +optional
	PvcSize string `json:"pvcSize,omitempty"`

	// Usage percentage of data volume.
	// +optional
	DataUsage string `json:"dataUsage,omitempty"`

	// Indicates if this node is a validator.
	Validator bool `json:"validator"`

	// Account address of this validator. Omitted when not a validator.
	// +optional
	AccountAddress string `json:"accountAddress,omitempty"`

	// Validator address is the valoper address of this validator. Omitted when not a validator.
	// +optional
	ValidatorAddress string `json:"validatorAddress,omitempty"`

	// Indicates if this validator is jailed. Always false if not a validator node.
	// +optional
	Jailed bool `json:"jailed,omitempty"`

	// Application version currently deployed.
	// +optional
	AppVersion string `json:"appVersion,omitempty"`

	// Last height read on the node by cosmopilot.
	// +optional
	LatestHeight int64 `json:"latestHeight,omitempty"`

	// Indicates if this node is running with seed mode enabled.
	// +optional
	SeedMode bool `json:"seedMode,omitempty"`

	// All scheduled/completed upgrades performed by cosmopilot on this ChainNode.
	// +optional
	Upgrades []Upgrade `json:"upgrades,omitempty"`

	// Public key of the validator.
	// +optional
	PubKey string `json:"pubKey,omitempty"`

	// Indicates the current status of validator if this node is one.
	// +optional
	ValidatorStatus ValidatorStatus `json:"validatorStatus,omitempty"`
}

type Config struct {
	// Allows overriding configs on `.toml` configuration files.
	// +optional
	// +kubebuilder:pruning:PreserveUnknownFields
	// +kubebuilder:validation:Schemaless
	Override *map[string]runtime.RawExtension `json:"override,omitempty"`

	// Allows configuring additional containers to run alongside the node.
	// +optional
	Sidecars []SidecarSpec `json:"sidecars,omitempty"`

	// Optional list of references to secrets in the same namespace to use for pulling any of the images used by this node.
	// +optional
	ImagePullSecrets []corev1.LocalObjectReference `json:"imagePullSecrets,omitempty"`

	// The time to wait for a block before considering node unhealthy.
	// Defaults to `15s`.
	// +optional
	// +default="15s"
	// +kubebuilder:validation:Format=duration
	BlockThreshold *string `json:"blockThreshold,omitempty"`

	// Period at which a reconcile loop will happen for this ChainNode.
	// Defaults to `15s`.
	// +optional
	// +default="15s"
	// +kubebuilder:validation:Format=duration
	ReconcilePeriod *string `json:"reconcilePeriod,omitempty"`

	// Allows configuring this node to perform state-sync snapshots.
	// +optional
	StateSync *StateSyncConfig `json:"stateSync,omitempty"`

	// Configures this node to run on seed mode. Defaults to `false`.
	// +optional
	// +default=false
	SeedMode *bool `json:"seedMode,omitempty"`

	// List of environment variables to set in the app container.
	// +optional
	Env []corev1.EnvVar `json:"env,omitempty"`

	// SafeToEvict sets cluster-autoscaler.kubernetes.io/safe-to-evict annotation to the given value. It allows/disallows
	// cluster-autoscaler to evict this node's pod.
	// +optional
	SafeToEvict *bool `json:"safeToEvict,omitempty"`

	// Deploys CosmoGuard to protect API endpoints of the node.
	// +optional
	CosmoGuard *CosmoGuardConfig `json:"cosmoGuard,omitempty"`

	// Log level for node-utils container. Defaults to `info`.
	// +optional
	NodeUtilsLogLevel *string `json:"nodeUtilsLogLevel,omitempty"`

	// The time after which a node will be restarted if it does not start properly.
	// Defaults to `1h`.
	// +optional
	// +default="1h"
	// +kubebuilder:validation:Format=duration
	StartupTime *string `json:"startupTime,omitempty"`

	// Marks the node as ready even when it is catching up. This is useful when a chain
	// is halted, but you still need the node to be ready for querying existing data.
	// Defaults to `false`.
	// +optional
	IgnoreSyncing *bool `json:"ignoreSyncing,omitempty"`

	// Compute Resources for node-utils container.
	// +optional
	NodeUtilsResources *corev1.ResourceRequirements `json:"nodeUtilsResources,omitempty"`

	// Whether to persist address book file in data directory. Defaults to `false`.
	// +optional
	PersistAddressBook *bool `json:"persistAddressBook,omitempty"`

	// Optional duration in seconds the pod needs to terminate gracefully.
	// +optional
	TerminationGracePeriodSeconds *int64 `json:"terminationGracePeriodSeconds,omitempty"`

	// Whether EVM is enabled on this node. Will add evm-rpc port to services. Defaults to `false`.
	// +optional
	EvmEnabled *bool `json:"evmEnabled,omitempty"`

	// List of flags to be appended to app container when starting the node.
	// +optional
	RunFlags []string `json:"runFlags,omitempty"`

	// Additional volumes to be created and mounted on this node.
	// +optional
	Volumes []VolumeSpec `json:"volumes,omitempty"`

	// Whether field naming in config.toml should use dashes instead of underscores. Defaults to `false`.
	// +optional
	DashedConfigToml *bool `json:"dashedConfigToml,omitempty"`

	// The block height at which the node should stop.
	// Cosmopilot will not attempt to restart the node beyond this height.
	// +optional
	HaltHeight *int64 `json:"haltHeight,omitempty"`
}

type CosmoGuardConfig struct {
	// Whether to enable CosmoGuard on this node.
	Enable bool `json:"enable"`

	// ConfigMap which CosmoGuard configuration for this node.
	Config *corev1.ConfigMapKeySelector `json:"config"`

	// Whether the node's pod should be restarted when CosmoGuard fails.
	// +optional
	RestartPodOnFailure *bool `json:"restartPodOnFailure,omitempty"`

	// Compute Resources for CosmoGuard container.
	// +optional
	Resources *corev1.ResourceRequirements `json:"resources,omitempty"`
}

type CreateValidatorConfig struct {
	// Name of the secret containing the mnemonic of the account to be used by
	// this validator. Defaults to `<chainnode>-account`. Will be created if it does not exist.
	// +optional
	AccountMnemonicSecret *string `json:"accountMnemonicSecret,omitempty"`

	// HD path of accounts. Defaults to `m/44'/118'/0'/0/0`.
	// +optional
	// +default="m/44'/118'/0'/0/0"
	AccountHDPath *string `json:"accountHDPath,omitempty"`

	// Prefix for accounts. Defaults to `nibi`.
	// +optional
	// +default="nibi"
	AccountPrefix *string `json:"accountPrefix,omitempty"`

	// Prefix for validator operator accounts. Defaults to `nibivaloper`.
	// +optional
	// +default="nibivaloper"
	ValPrefix *string `json:"valPrefix,omitempty"`

	// Maximum commission change rate percentage (per day). Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionMaxChangeRate *string `json:"commissionMaxChangeRate,omitempty"`

	// Maximum commission rate percentage. Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionMaxRate *string `json:"commissionMaxRate,omitempty"`

	// Initial commission rate percentage. Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionRate *string `json:"commissionRate,omitempty"`

	// Minimum self delegation required on the validator. Defaults to `1`.
	// +optional
	// +default="1"
	MinSelfDelegation *string `json:"minSelfDelegation,omitempty"`

	// Amount to be staked by this validator.
	StakeAmount string `json:"stakeAmount"`

	// Gas prices in decimal format to determine the transaction fee.
	GasPrices string `json:"gasPrices"`
}

type ExportTarballConfig struct {
	// Suffix to add to archive name. The name of the tarball will be `<chain-id>-<timestamp>-<suffix>`.
	// +optional
	Suffix *string `json:"suffix,omitempty"`

	// Whether to delete the tarball when the snapshot expires. Default is `false`.
	// +optional
	// +default=false
	DeleteOnExpire *bool `json:"deleteOnExpire,omitempty"`

	// Configuration to upload tarballs to a GCS bucket.
	// +optional
	GCS *GcsExportConfig `json:"gcs,omitempty"`
}

type ExposeConfig struct {
	// Whether to expose p2p endpoint for this node. Defaults to `false`.
	// +optional
	// +default=false
	P2P *bool `json:"p2p,omitempty"`

	// P2pServiceType indicates how P2P port will be exposed.
	// Valid values are:
	// - `LoadBalancer`
	// - `NodePort` (default)
	// +optional
	// +default="NodePort"
	P2pServiceType *corev1.ServiceType `json:"p2pServiceType,omitempty"`

	// Annotations to be appended to the p2p service.
	// +optional
	Annotations map[string]string `json:"annotations,omitempty"`
}

type FromNodeRPCConfig struct {
	// Defines protocol to use. Defaults to `false`.
	// +optional
	// +default=false
	Secure bool `json:"secure,omitempty"`

	// Hostname or IP address of the RPC server
	// +kubebuilder:validation:MinLength=1
	Hostname string `json:"hostname"`

	// TCP port used for RPC queries on the RPC server. Defaults to `26657`.
	// +optional
	// +default=26657
	Port *int `json:"port,omitempty"`
}

type GcsExportConfig struct {
	// Name of the bucket to upload tarballs to.
	Bucket string `json:"bucket"`

	// Secret with the JSON credentials to upload to bucket.
	CredentialsSecret *corev1.SecretKeySelector `json:"credentialsSecret"`

	// Size limit at which the file will be split into multiple parts. Defaults to `5TB`.
	SizeLimit *string `json:"sizeLimit,omitempty"`

	// Size of each part when size-limit is crossed. Defaults to `500GB`.
	PartSize *string `json:"partSize,omitempty"`

	// Size of each chunk uploaded in parallel to GCS. Defaults to `250MB`.
	ChunkSize *string `json:"chunkSize,omitempty"`

	// Size of the buffer when streaming data to GCS. Defaults to `32MB`.
	BufferSize *string `json:"bufferSize,omitempty"`

	// Number of concurrent upload or delete jobs. Defaults to `10`.
	ConcurrentJobs *int `json:"concurrentJobs,omitempty"`
}

type GenesisConfig struct {
	// URL to download the genesis from.
	// +optional
	Url *string `json:"url,omitempty"`

	// Get the genesis from an existing node using its RPC endpoint.
	// +optional
	FromNodeRPC *FromNodeRPCConfig `json:"fromNodeRPC,omitempty"`

	// SHA256 to validate the genesis.
	// +optional
	GenesisSHA *string `json:"genesisSHA,omitempty"`

	// ConfigMap specifies a configmap to load the genesis from. It can also be used to specify the name of the
	// configmap to store the genesis when retrieving genesis using other methods.
	// +optional
	ConfigMap *string `json:"configMap,omitempty"`

	// UseDataVolume indicates that cosmopilot should save the genesis in the same volume as node data
	// instead of a ConfigMap. This is useful for genesis whose size is bigger than ConfigMap limit of 1MiB.
	// Ignored when genesis source is a ConfigMap. Defaults to `false`.
	// +optional
	UseDataVolume *bool `json:"useDataVolume,omitempty"`

	// The chain-id of the network. This is only used when useDataVolume is true. If not set, cosmopilot will download
	// the genesis and extract chain-id from it. If set, cosmopilot will not download it and use a container to download
	// the genesis directly into the volume instead. This is useful for huge genesis that might kill cosmopilot container
	// for using too much memory.
	// +optional
	ChainID *string `json:"chainID,omitempty"`
}

type GenesisInitConfig struct {
	// ChainID of the chain to initialize.
	// +kubebuilder:validation:MinLength=1
	ChainID string `json:"chainID"`

	// Name of the secret containing the mnemonic of the account to be used by
	// this validator. Defaults to `<chainnode>-account`. Will be created if it does not exist.
	// +optional
	AccountMnemonicSecret *string `json:"accountMnemonicSecret,omitempty"`

	// HD path of accounts. Defaults to `m/44'/118'/0'/0/0`.
	// +optional
	// +default="m/44'/118'/0'/0/0"
	AccountHDPath *string `json:"accountHDPath,omitempty"`

	// Prefix for accounts. Defaults to `nibi`.
	// +optional
	// +default="nibi"
	AccountPrefix *string `json:"accountPrefix,omitempty"`

	// Prefix for validator operator accounts. Defaults to `nibivaloper`.
	// +optional
	// +default="nibivaloper"
	ValPrefix *string `json:"valPrefix,omitempty"`

	// Maximum commission change rate percentage (per day). Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionMaxChangeRate *string `json:"commissionMaxChangeRate,omitempty"`

	// Maximum commission rate percentage. Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionMaxRate *string `json:"commissionMaxRate,omitempty"`

	// Initial commission rate percentage. Defaults to `0.1`.
	// +optional
	// +default="0.1"
	CommissionRate *string `json:"commissionRate,omitempty"`

	// Minimum self delegation required on the validator. Defaults to `1`.
	// NOTE: In most chains this is a required flag. However, in a few other chains (Cosmos Hub for example),
	// this flag does not even exist anymore. In those cases, set it to an empty string and cosmopilot will skip it.
	// +optional
	// +default="1"
	MinSelfDelegation *string `json:"minSelfDelegation,omitempty"`

	// Assets is the list of tokens and their amounts to be assigned to this validators account.
	Assets []string `json:"assets"`

	// Amount to be staked by this validator.
	StakeAmount string `json:"stakeAmount"`

	// Accounts specify additional accounts and respective assets to be added to this chain.
	// +optional
	Accounts []AccountAssets `json:"accounts,omitempty"`

	// List of ChainNodes whose accounts should be included in genesis.
	// NOTE: Cosmopilot will wait for the ChainNodes to exist and have accounts before proceeding.
	ChainNodeAccounts []ChainNodeAssets `json:"chainNodeAccounts,omitempty"`

	// Time required to totally unbond delegations. Defaults to `1814400s` (21 days).
	// +optional
	// +default="1814400s"
	// +kubebuilder:validation:Format=duration
	UnbondingTime *string `json:"unbondingTime,omitempty"`

	// Voting period for this chain. Defaults to `120h`.
	// +optional
	// +default="120h"
	// +kubebuilder:validation:Format=duration
	VotingPeriod *string `json:"votingPeriod,omitempty"`

	// Additional commands to run on genesis initialization.
	// Note: App home is at `/home/app` and `/temp` is a temporary volume shared by all init containers.
	// +optional
	AdditionalInitCommands []InitCommand `json:"additionalInitCommands,omitempty"`
}

type GlobalIngressConfig struct {
	// The name of this ingress
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`

	// Groups of nodes to which this ingress will point to.
	// +kubebuilder:validation:MinItems=1
	Groups []string `json:"groups"`

	// Enable RPC endpoint.
	// +optional
	EnableRPC bool `json:"enableRPC,omitempty"`

	// Enable gRPC endpoint.
	// +optional
	EnableGRPC bool `json:"enableGRPC,omitempty"`

	// Enable LCD endpoint.
	// +optional
	EnableLCD bool `json:"enableLCD,omitempty"`

	// Enable EVM RPC endpoint.
	// +optional
	EnableEvmRPC bool `json:"enableEvmRPC,omitempty"`

	// Enable EVM RPC Websocket endpoint.
	// +optional
	EnableEvmRpcWs bool `json:"enableEvmRpcWS,omitempty"`

	// Host in which endpoints will be exposed. Endpoints are exposed on corresponding
	// subdomain of this host. An example host `nodes.example.com` will have endpoints exposed at
	// `rpc.nodes.example.com`, `grpc.nodes.example.com` and `lcd.nodes.example.com`.
	Host string `json:"host"`

	// Annotations to be appended to the ingress.
	// +optional
	Annotations map[string]string `json:"annotations,omitempty"`

	// Whether to disable TLS on ingress resource.
	// +optional
	DisableTLS bool `json:"disableTLS,omitempty"`

	// Name of the secret containing TLS certificate.
	// +optional
	TlsSecretName *string `json:"tlsSecretName,omitempty"`
}

type IngressConfig struct {
	// Enable RPC endpoint.
	// +optional
	EnableRPC bool `json:"enableRPC,omitempty"`

	// Enable gRPC endpoint.
	// +optional
	EnableGRPC bool `json:"enableGRPC,omitempty"`

	// Enable LCD endpoint.
	// +optional
	EnableLCD bool `json:"enableLCD,omitempty"`

	// Enable EVM RPC endpoint.
	// +optional
	EnableEvmRPC bool `json:"enableEvmRPC,omitempty"`

	// Enable EVM RPC Websocket endpoint.
	// +optional
	EnableEvmRpcWs bool `json:"enableEvmRpcWS,omitempty"`

	// Host in which endpoints will be exposed. Endpoints are exposed on corresponding
	// subdomain of this host. An example host `nodes.example.com` will have endpoints exposed at
	// `rpc.nodes.example.com`, `grpc.nodes.example.com` and `lcd.nodes.example.com`.
	Host string `json:"host"`

	// Annotations to be appended to the ingress.
	// +optional
	Annotations map[string]string `json:"annotations,omitempty"`

	// Whether to disable TLS on ingress resource.
	// +optional
	DisableTLS bool `json:"disableTLS,omitempty"`

	// Name of the secret containing TLS certificate.
	// +optional
	TlsSecretName *string `json:"tlsSecretName,omitempty"`
}

type InitCommand struct {
	// Image to be used to run this command. Defaults to app image.
	// +optional
	Image *string `json:"image,omitempty"`

	// Command to be used. Defaults to image entrypoint.
	// +optional
	Command []string `json:"command,omitempty"`

	// Args to be passed to this command.
	Args []string `json:"args"`
}

type LimitSource string

type LimitUpdateStrategy string

type NodeGroupSpec struct {
	// Name of this group.
	Name string `json:"name"`

	// Number of ChainNode instances to run on this group.
	// +optional
	// +default=1
	Instances *int `json:"instances,omitempty"`

	// Specific configurations for these nodes.
	// +optional
	Config *Config `json:"config,omitempty"`

	// Configures PVC for persisting data. Automated data snapshots can also be configured in
	// this section.
	// +optional
	Persistence *Persistence `json:"persistence,omitempty"`

	// Additional persistent peers that should be added to these nodes.
	// +optional
	Peers []Peer `json:"peers,omitempty"`

	// Allows exposing P2P traffic to public.
	// +optional
	Expose *ExposeConfig `json:"expose,omitempty"`

	// Indicates if an ingress should be created to access API endpoints of these nodes and configures it.
	// +optional
	Ingress *IngressConfig `json:"ingress,omitempty"`

	// Compute Resources required by the app container.
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// Selector which must be true for the pod to fit on a node.
	// Selector which must match a node's labels for the pod to be scheduled on that node.
	// +optional
	NodeSelector map[string]string `json:"nodeSelector,omitempty"`

	// If specified, the pod's scheduling constraints.
	// +optional
	Affinity *corev1.Affinity `json:"affinity,omitempty"`

	// Configures these nodes to find state-sync snapshots on the network and restore from it.
	// This is disabled by default.
	// +optional
	StateSyncRestore *bool `json:"stateSyncRestore,omitempty"`

	// Whether these nodes should inherit gas price from validator (if there is not configured on this ChainNodeSet)
	// Defaults to `true`.
	// +optional
	InheritValidatorGasPrice *bool `json:"inheritValidatorGasPrice,omitempty"`

	// Whether ChainNodeSet group label should be ignored on pod disruption checks.
	// This is useful to ensure no downtime globally or per global ingress, instead of just per group.
	// Defaults to `false`.
	// +optional
	IgnoreGroupOnDisruptionChecks *bool `json:"ignoreGroupOnDisruptionChecks,omitempty"`

	// Vertical Pod Autoscaling configuration for this node.
	// +optional
	VPA *VerticalAutoscalingConfig `json:"vpa,omitempty"`

	// Pod Disruption Budget configuration for this group.
	// +optional
	PDB *PdbConfig `json:"pdb,omitempty"`
}

type NodeSetValidatorConfig struct {
	// Secret containing the private key to be used by this validator.
	// Defaults to `<chainnode>-priv-key`. Will be created if it does not exist.
	// +optional
	PrivateKeySecret *string `json:"privateKeySecret,omitempty"`

	// Contains information details about the validator.
	// +optional
	Info *ValidatorInfo `json:"info,omitempty"`

	// Specifies configs and initialization commands for creating a new genesis.
	// +optional
	Init *GenesisInitConfig `json:"init,omitempty"`

	// Allows setting specific configurations for the validator.
	// +optional
	Config *Config `json:"config,omitempty"`

	// Configures PVC for persisting data. Automated data snapshots can also be configured in
	// this section.
	// +optional
	Persistence *Persistence `json:"persistence,omitempty"`

	// Compute Resources required by the app container.
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// Selector which must be true for the pod to fit on a node.
	// Selector which must match a node's labels for the pod to be scheduled on that node.
	// +optional
	NodeSelector map[string]string `json:"nodeSelector,omitempty"`

	// If specified, the pod's scheduling constraints.
	// +optional
	Affinity *corev1.Affinity `json:"affinity,omitempty"`

	// TmKMS configuration for signing commits for this validator.
	// When configured, .spec.validator.privateKeySecret will not be mounted on the validator node.
	// +optional
	TmKMS *TmKMS `json:"tmKMS,omitempty"`

	// Configures this node to find a state-sync snapshot on the network and restore from it.
	// This is disabled by default.
	// +optional
	StateSyncRestore *bool `json:"stateSyncRestore,omitempty"`

	// Indicates cosmopilot should run create-validator tx to make this node a validator.
	// +optional
	CreateValidator *CreateValidatorConfig `json:"createValidator,omitempty"`

	// Vertical Pod Autoscaling configuration for this node.
	// +optional
	VPA *VerticalAutoscalingConfig `json:"vpa,omitempty"`

	// Pod Disruption Budget configuration for the validator pod.
	// This is mainly useful in testnets where multiple validators might run in the same namespace.
	// In production mainnet environments, where typically only one validator runs per namespace,
	// this is rarely needed.
	// +optional
	PDB *PdbConfig `json:"pdb,omitempty"`
}

type PdbConfig struct {
	// Whether to deploy a Pod Disruption Budget
	Enabled bool `json:"enabled"`

	// MinAvailable indicates minAvailable field set in PDB.
	// Defaults to the number of instances in the group minus 1,
	// i.e. it allows only a single disruption.
	// +optional
	MinAvailable *int `json:"minAvailable,omitempty"`
}

type Peer struct {
	// Tendermint node ID for this node.
	ID string `json:"id"`

	// Hostname or IP address of this peer.
	Address string `json:"address"`

	// P2P port to be used. Defaults to `26656`.
	// +optional
	// +default=26656
	Port *int `json:"port,omitempty"`

	// Indicates this peer is unconditional.
	// +optional
	Unconditional *bool `json:"unconditional,omitempty"`

	// Indicates this peer is private.
	// +optional
	Private *bool `json:"private,omitempty"`
}

type Persistence struct {
	// Size of the persistent volume for storing data. Can't be updated when autoResize is enabled.
	// Defaults to `50Gi`.
	// +optional
	// +default="50Gi"
	Size *string `json:"size,omitempty"`

	// Name of the storage class to use for the PVC. Uses the default class if not specified.
	// to create persistent volumes.
	// +optional
	StorageClassName *string `json:"storageClass,omitempty"`

	// Automatically resize PVC.
	// Defaults to `true`.
	// +optional
	// +default=true
	AutoResize *bool `json:"autoResize,omitempty"`

	// Percentage of data usage at which an auto-resize event should occur.
	// Defaults to `80`.
	// +optional
	// +default=80
	AutoResizeThreshold *int `json:"autoResizeThreshold,omitempty"`

	// Increment size on each auto-resize event.
	// Defaults to `50Gi`.
	// +optional
	// +default="50Gi"
	AutoResizeIncrement *string `json:"autoResizeIncrement,omitempty"`

	// Size at which auto-resize will stop incrementing PVC size.
	// Defaults to `2Ti`.
	// +optional
	// +default="2Ti"
	AutoResizeMaxSize *string `json:"autoResizeMaxSize,omitempty"`

	// Additional commands to run on data initialization. Useful for downloading and
	// extracting snapshots.
	// App home is at `/home/app` and data dir is at `/home/app/data`. There is also `/temp`, a temporary volume
	// shared by all init containers.
	// +optional
	AdditionalInitCommands []InitCommand `json:"additionalInitCommands,omitempty"`

	// Whether cosmopilot should create volume snapshots according to this config.
	// +optional
	Snapshots *VolumeSnapshotsConfig `json:"snapshots,omitempty"`

	// Restore from the specified snapshot when creating the PVC for this node.
	// +optional
	RestoreFromSnapshot *PvcSnapshot `json:"restoreFromSnapshot,omitempty"`

	// Time to wait for data initialization pod to be successful. Defaults to `5m`.
	// +optional
	InitTimeout *string `json:"initTimeout,omitempty"`
}

type PvcSnapshot struct {
	// Name of the volume snapshot being referenced.
	Name string `json:"name"`
}

type ScalingDirection string

type SdkVersion string

type SidecarSpec struct {
	// Name to be assigned to the container.
	// +kubebuilder:validation:MinLength=1
	Name string `json:"name"`

	// Container image to be used.
	// Defaults to app image being used by ChainNode.
	// +kubebuilder:validation:MinLength=1
	// +optional
	Image *string `json:"image"`

	// Indicates the desired pull policy when creating nodes. Defaults to `Always` if `version`
	// is `latest` and `IfNotPresent` otherwise.
	// +optional
	ImagePullPolicy corev1.PullPolicy `json:"imagePullPolicy,omitempty"`

	// Where data volume will be mounted on this container. It is not mounted if not specified.
	// +optional
	MountDataVolume *string `json:"mountDataVolume,omitempty"`

	// Directory where config files from ConfigMap will be mounted on this container. They are not mounted if not specified.
	// +optional
	MountConfig *string `json:"mountConfig,omitempty"`

	// Command to be run by this container. Defaults to entrypoint defined in image.
	// +optional
	Command []string `json:"command,omitempty"`

	// Args to be passed to this container. Defaults to cmd defined in image.
	// +optional
	Args []string `json:"args,omitempty"`

	// Environment variables to be passed to this container.
	// +optional
	Env []corev1.EnvVar `json:"env,omitempty"`

	// Security options the container should be run with.
	// +optional
	SecurityContext *corev1.SecurityContext `json:"securityContext,omitempty"`

	// Compute Resources for the sidecar container.
	// +optional
	Resources corev1.ResourceRequirements `json:"resources,omitempty"`

	// Whether the pod of this node should be restarted when this sidecar container fails. Defaults to `false`.
	// +optional
	RestartPodOnFailure *bool `json:"restartPodOnFailure,omitempty"`

	// When enabled, this container turns into an init container instead of a sidecar
	// as it will have to finish before the node container starts. Defaults to `false`.
	// +optional
	RunBeforeNode *bool `json:"runBeforeNode,omitempty"`
}

type StateSyncConfig struct {
	// Block interval at which local state sync snapshots are taken (0 to disable).
	SnapshotInterval int `json:"snapshotInterval"`

	// Number of recent snapshots to keep and serve (0 to keep all). Defaults to 2.
	// +optional
	SnapshotKeepRecent *int `json:"snapshotKeepRecent,omitempty"`
}

type TmKMS struct {
	// Signing provider to be used by tmkms. Currently only `vault` is supported.
	Provider TmKmsProvider `json:"provider"`

	// Format and type of key for chain.
	// Defaults to `{"type": "bech32", "account_key_prefix": "nibipub", "consensus_key_prefix": "nibivalconspub"}`.
	// +optional
	// +default={"type": "bech32", "account_key_prefix": "nibipub", "consensus_key_prefix": "nibivalconspub"}
	KeyFormat *TmKmsKeyFormat `json:"keyFormat,omitempty"`

	// Tendermint's protocol version to be used.
	// Valid options are:
	// - `v0.34` (default)
	// - `v0.33`
	// - `legacy`
	// +optional
	// +default="v0.34"
	ValidatorProtocol *tmkms.ProtocolVersion `json:"validatorProtocol,omitempty"`

	// Whether to persist "priv_validator_state.json" file on a PVC. Defaults to `true`.
	// +optional
	PersistState *bool `json:"persistState,omitempty"`

	// Compute Resources for tmkms container.
	// +optional
	Resources *corev1.ResourceRequirements `json:"resources,omitempty"`
}

type TmKmsHashicorpProvider struct {
	// Full address of the Vault cluster.
	Address string `json:"address"`

	// Key to be used by this validator.
	Key string `json:"key"`

	// Secret containing the CA certificate of the Vault cluster.
	// +optional
	CertificateSecret *corev1.SecretKeySelector `json:"certificateSecret,omitempty"`

	// Secret containing the token to be used.
	TokenSecret *corev1.SecretKeySelector `json:"tokenSecret"`

	// UploadGenerated indicates if the controller should upload the generated private key to vault.
	// Defaults to `false`. Will be set to `true` if this validator is initializing a new genesis.
	// This should not be used in production.
	// +optional
	UploadGenerated bool `json:"uploadGenerated,omitempty"`

	// Whether to automatically renew vault token. Defaults to `false`.
	// +optional
	AutoRenewToken bool `json:"autoRenewToken,omitempty"`

	// Whether to skip certificate verification. Defaults to `false`.
	// +optional
	SkipCertificateVerify bool `json:"skipCertificateVerify,omitempty"`
}

type TmKmsKeyFormat struct {
	// Key type
	Type string `json:"type"`

	// Account keys prefixes
	AccountKeyPrefix string `json:"account_key_prefix"`

	// Consensus keys prefix
	ConsensusKeyPrefix string `json:"consensus_key_prefix"`
}

type TmKmsProvider struct {
	// Hashicorp provider.
	// +optional
	Hashicorp *TmKmsHashicorpProvider `json:"hashicorp,omitempty"`
}

type Upgrade struct {
	// Height at which the upgrade should occur.
	Height int64 `json:"height"`

	// Container image replacement to be used in the upgrade.
	Image string `json:"image"`

	// Upgrade status.
	Status UpgradePhase `json:"status"`

	// Where cosmopilot got this upgrade from.
	Source UpgradeSource `json:"source"`
}

type UpgradePhase string

type UpgradeSource string

type UpgradeSpec struct {
	// Height at which the upgrade should occur.
	Height int64 `json:"height"`

	// Container image replacement to be used in the upgrade.
	Image string `json:"image"`

	// Whether to force this upgrade to be processed as a gov planned upgrade.
	// Defaults to `false`.
	// +optional
	ForceOnChain *bool `json:"forceOnChain,omitempty"`
}

type ValidatorConfig struct {
	// Indicates the secret containing the private key to be used by this validator.
	// Defaults to `<chainnode>-priv-key`. Will be created if it does not exist.
	// +optional
	PrivateKeySecret *string `json:"privateKeySecret,omitempty"`

	// Contains information details about this validator.
	// +optional
	Info *ValidatorInfo `json:"info,omitempty"`

	// Specifies configs and initialization commands for creating a new genesis.
	// +optional
	Init *GenesisInitConfig `json:"init,omitempty"`

	// TmKMS configuration for signing commits for this validator.
	// When configured, .spec.validator.privateKeySecret will not be mounted on the validator node.
	// +optional
	TmKMS *TmKMS `json:"tmKMS,omitempty"`

	// Indicates that cosmopilot should run create-validator tx to make this node a validator.
	// +optional
	CreateValidator *CreateValidatorConfig `json:"createValidator,omitempty"`
}

type ValidatorInfo struct {
	// Moniker to be used by this validator. Defaults to the ChainNode name.
	// +optional
	Moniker *string `json:"moniker,omitempty"`

	// Details of this validator.
	// +optional
	Details *string `json:"details,omitempty"`

	// Website of the validator.
	// +optional
	Website *string `json:"website,omitempty"`

	// Identity signature of this validator.
	// +optional
	Identity *string `json:"identity,omitempty"`
}

type ValidatorStatus string

type VerticalAutoscalingConfig struct {
	// Enables vertical autoscaling for the pod.
	Enabled bool `json:"enabled"`

	// CPU resource autoscaling configuration.
	// +optional
	CPU *VerticalAutoscalingMetricConfig `json:"cpu,omitempty"`

	// Memory resource autoscaling configuration.
	// +optional
	Memory *VerticalAutoscalingMetricConfig `json:"memory,omitempty"`
}

type VerticalAutoscalingMetricConfig struct {
	// Source determines whether to base autoscaling decisions on requests, limits, or effective limit.
	// Valid values are:
	// `effective-limit` (default) (use limits if set; otherwise fallback to requests)
	// `requests` (use the pod’s requested resource value)
	// `limits` (use the pod’s resource limit value)
	// +optional
	// +default="effective-limit"
	Source *LimitSource `json:"source,omitempty"`

	// Minimum resource value allowed during scaling (e.g. "100m" or "128Mi").
	Min resource.Quantity `json:"min"`

	// Maximum resource value allowed during scaling (e.g. "8000m" or "2Gi").
	Max resource.Quantity `json:"max"`

	// Rules define when and how scaling should occur based on sustained usage levels.
	Rules []*VerticalAutoscalingRule `json:"rules"`

	// Cooldown is the minimum duration to wait between consecutive scaling actions.
	// Defaults to "5m".
	// +optional
	// +default="5m"
	// +kubebuilder:validation:Format=duration
	Cooldown *string `json:"cooldown,omitempty"`

	// LimitStrategy controls how resource limits should be updated after autoscaling.
	// Valid values are:
	// `retain` (default) (keep original limits)
	// `equal` (match request value)
	// `max` (use configured VPA Max)
	// `percentage` (request × percentage)
	// `unset` (remove the limits field entirely)
	// +optional
	// +default="retain"
	LimitStrategy *LimitUpdateStrategy `json:"limitStrategy,omitempty"`

	// LimitPercentage defines the percentage multiplier to apply when using "percentage" LimitStrategy.
	// For example, 150 means limit = request * 1.5.
	// Only used when LimitStrategy = "percentage". Defaults to `150` when not set.
	// +optional
	LimitPercentage *int `json:"limitPercentage,omitempty"`
}

type VerticalAutoscalingRule struct {
	// Direction of scaling: "up" or "down".
	Direction ScalingDirection `json:"direction"`

	// UsagePercent is the resource usage percentage (0–100) that must be met.
	// Usage is compared against the selected Source value.
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=100
	UsagePercent int `json:"usagePercent"`

	// Duration is the length of time the usage must remain above/below the threshold before scaling.
	// Defaults to "5m".
	// +optional
	// +default="5m"
	// +kubebuilder:validation:Format=duration
	Duration *string `json:"duration,omitempty"`

	// StepPercent defines how much to adjust the resource by, as a percentage of the current value.
	// For example, 50 = scale by 50% of current value.
	// +kubebuilder:validation:Minimum=1
	// +kubebuilder:validation:Maximum=100
	StepPercent int `json:"stepPercent"`
}

type VolumeSnapshotsConfig struct {
	// How often a snapshot should be created.
	// +kubebuilder:validation:Format=duration
	Frequency string `json:"frequency"`

	// How long a snapshot should be retained. Default is indefinite retention.
	// +optional
	// +kubebuilder:validation:Format=duration
	Retention *string `json:"retention,omitempty"`

	// Name of the volume snapshot class to be used. Uses the default class if not specified.
	// +optional
	SnapshotClassName *string `json:"snapshotClass,omitempty"`

	// Whether the node should be stopped while the snapshot is taken. Defaults to `false`.
	// +optional
	// +default=false
	StopNode *bool `json:"stopNode,omitempty"`

	// Whether to create a tarball of data directory in each snapshot and upload it to external storage.
	// +optional
	ExportTarball *ExportTarballConfig `json:"exportTarball,omitempty"`

	// Whether cosmopilot should verify the snapshot for corruption after it is ready. Defaults to `false`.
	// +optional
	// +default=false
	Verify *bool `json:"verify,omitempty"`

	// Whether to disable snapshots while the node is syncing
	// +optional
	DisableWhileSyncing *bool `json:"disableWhileSyncing,omitempty"`
}

type VolumeSpec struct {
	// The name of the volume.
	Name string `json:"name"`

	// Size of the volume.
	Size string `json:"size"`

	// The path at which this volume should be mounted
	Path string `json:"path"`

	// Name of the storage class to use for this volume. Uses the default class if not specified.
	// +optional
	StorageClassName *string `json:"storageClass,omitempty"`

	// Whether this volume should be deleted when node is deleted. Defaults to `false`.
	// +optional
	DeleteWithNode *bool `json:"deleteWithNode,omitempty"`
}