config

type Node struct {
	Name *string       `toml:"Name"`
	URL  *clconfig.URL `toml:"URL"`
	// Order is the node priority used as a tiebreak by the multinode selector (lower wins on
	// equal head). Defaults to 0 when unset.
	Order *int32 `toml:"Order"`
}

type Nodes []*Node

type TOMLConfig struct {
	// Enabled controls whether this chain is active. Nil means enabled (default).
	Enabled *bool `toml:"Enabled"`

	// ChainID is the unique identifier for this chain configuration
	ChainID string `toml:"ChainID"`

	// Nodes lists the Soroban RPC endpoints for this chain.
	Nodes Nodes `toml:"Nodes"`

	// TxManager holds optional Stellar transaction manager settings. Omitted
	// fields use defaults applied by SetDefaults (from docs.toml).
	TxManager TxManagerConfig `toml:"TxManager"`

	// MultiNode configures RPC node selection, health checking, and failover. Omitted fields
	// are filled by SetDefaults. See chainlink-framework/multinode.
	MultiNode mncfg.MultiNodeConfig `toml:"MultiNode"`

	// RequestTimeout bounds each individual Soroban RPC call (and the underlying HTTP client
	// timeout). Defaults to DefaultRequestTimeout when unset.
	RequestTimeout *clconfig.Duration `toml:"RequestTimeout"`
}

type TxManagerConfig struct {
	BroadcastChanSize   *uint              `toml:"BroadcastChanSize"`
	ConfirmPollInterval *clconfig.Duration `toml:"ConfirmPollInterval"`

	// Fee strategy: Stellar fees = InclusionFee + ResourceFee.
	// Only the inclusion fee is bumped on retries; the resource fee is deterministic from simulation.
	BaseInclusionFee  *int64   `toml:"BaseInclusionFee"`
	MaxInclusionFee   *int64   `toml:"MaxInclusionFee"`
	FeeBumpMultiplier *float64 `toml:"FeeBumpMultiplier"`
	ResourceFeeBuffer *int64   `toml:"ResourceFeeBuffer"`
	RestoreFeeBuffer  *int64   `toml:"RestoreFeeBuffer"`
	// FeeStatsPollInterval controls how often GetFeeStats is called to refresh
	// Soroban inclusion fee P50/P90 in the feeTracker; back-to-back broadcasts reuse values.
	// Zero disables reuse (every inclusion-fee decision calls GetFeeStats).
	FeeStatsPollInterval *clconfig.Duration `toml:"FeeStatsPollInterval"`

	// Retry & timeout
	MaxSimulateAttempts       *uint              `toml:"MaxSimulateAttempts"`
	MaxSubmitRetryAttempts    *uint              `toml:"MaxSubmitRetryAttempts"`
	SubmitRetryDelay          *clconfig.Duration `toml:"SubmitRetryDelay"`
	TxTimeoutSecs             *int64             `toml:"TxTimeoutSecs"`
	LedgerBoundsOffset        *uint32            `toml:"LedgerBoundsOffset"`
	MaxTxRetryAttempts        *uint64            `toml:"MaxTxRetryAttempts"`
	MaxGetClientRetryAttempts *uint64            `toml:"MaxGetClientRetryAttempts"`
	MaxRestoreAttempts        *uint              `toml:"MaxRestoreAttempts"`

	// SimulationTerminalHints are matched case-insensitively as substrings
	// against failed SimulateTransaction errors; any match means the error is
	// treated as terminal (do not retry). Resolve merges these with built-in
	// defaults (additive); list only extra hints to add on top of defaults.
	SimulationTerminalHints []string `toml:"SimulationTerminalHints"`
	// SimulationRetryableHints: any substring match means retry simulation when
	// attempts remain. Resolve merges with built-in defaults (additive).
	SimulationRetryableHints []string `toml:"SimulationRetryableHints"`

	// Pruning
	// PruneInterval controls how often the background prune loop scans for
	// expired terminal txs. This is independent of PruneTxExpiration (retention).
	// Set to 0 to disable the loop (no goroutine is started); terminal txs are
	// then evicted synchronously when they reach a terminal state instead of
	// being retained until the next periodic prune.
	PruneInterval *clconfig.Duration `toml:"PruneInterval"`
	// PruneTxExpiration is the minimum time a terminal tx (Finalized or Failed)
	// is retained after reaching its terminal state before being eligible for pruning.
	// Measured from TerminalTime. Ignored when PruneInterval is 0 (immediate eviction).
	PruneTxExpiration *clconfig.Duration `toml:"PruneTxExpiration"`
}