pkg/solana/config: config enhancements

Author: jmank88

go.mod

@@ -21,7 +21,7 @@ require (
 	github.com/prometheus/client_model v0.6.1
 	github.com/smartcontractkit/chainlink-ccip v0.0.0-20250417161444-6af45cb2bf9e
 	github.com/smartcontractkit/chainlink-ccip/chains/solana v0.0.0-20250411163110-21a13ceb3ac4
-	github.com/smartcontractkit/chainlink-common v0.7.1-0.20250429205337-7ee5f91ed065
+	github.com/smartcontractkit/chainlink-common v0.7.1-0.20250430133340-d04a3b64e331
 	github.com/smartcontractkit/chainlink-common/pkg/monitoring v0.0.0-20250415235644-8703639403c7
 	github.com/smartcontractkit/chainlink-framework/metrics v0.0.0-20250502210357-2df484128afa
 	github.com/smartcontractkit/chainlink-framework/multinode v0.0.0-20250502210357-2df484128afa

go.sum

@@ -407,8 +407,8 @@ github.com/smartcontractkit/chainlink-ccip v0.0.0-20250417161444-6af45cb2bf9e h1
 github.com/smartcontractkit/chainlink-ccip v0.0.0-20250417161444-6af45cb2bf9e/go.mod h1:Jb05WL6lj5H89XGcaaOinxTf4Gdj+vXO4TcUhqTgqIM=
 github.com/smartcontractkit/chainlink-ccip/chains/solana v0.0.0-20250411163110-21a13ceb3ac4 h1:ujhHdxB3+K6lOnhku7lqpj3WsoOhyvOAAkdsGtwon/o=
 github.com/smartcontractkit/chainlink-ccip/chains/solana v0.0.0-20250411163110-21a13ceb3ac4/go.mod h1:k3/Z6AvwurPUlfuDFEonRbkkiTSgNSrtVNhJEWNlUZA=
-github.com/smartcontractkit/chainlink-common v0.7.1-0.20250429205337-7ee5f91ed065 h1:8UsqHv+LkrO2KdXbfZd5qejsy4Z4Xz5/DNVfUGT6gTM=
-github.com/smartcontractkit/chainlink-common v0.7.1-0.20250429205337-7ee5f91ed065/go.mod h1:vHs/mPpAztdKJtzRKLnmLinmpS78fBh9sAuyKqQrQ+I=
+github.com/smartcontractkit/chainlink-common v0.7.1-0.20250430133340-d04a3b64e331 h1:+bN5yuawZeQeVw7vG+Me7kXLFK1vcesVeku3mdgRwqI=
+github.com/smartcontractkit/chainlink-common v0.7.1-0.20250430133340-d04a3b64e331/go.mod h1:UGZVg18zzyJ1KimGM5SSmxG5jb7aCSq3OwQQKfhHGyE=
 github.com/smartcontractkit/chainlink-common/pkg/monitoring v0.0.0-20250415235644-8703639403c7 h1:9wh1G+WbXwPVqf0cfSRSgwIcaXTQgvYezylEAfwmrbw=
 github.com/smartcontractkit/chainlink-common/pkg/monitoring v0.0.0-20250415235644-8703639403c7/go.mod h1:yaDOAZF6MNB+NGYpxGCUc+owIdKrjvFW0JODdTcQ3V0=
 github.com/smartcontractkit/chainlink-framework/metrics v0.0.0-20250502210357-2df484128afa h1:NNFspORov2OGt7ex+mYFm+7nTUvjrUWBbCQBYvVXKK4=

integration-tests/go.mod

@@ -266,6 +266,7 @@ require (
 	github.com/klauspost/cpuid/v2 v2.2.9 // indirect
 	github.com/kr/pretty v0.3.1 // indirect
 	github.com/kr/text v0.2.0 // indirect
+	github.com/kylelemons/godebug v1.1.0 // indirect
 	github.com/leanovate/gopter v0.2.11 // indirect
 	github.com/leodido/go-urn v1.4.0 // indirect
 	github.com/liggitt/tabwriter v0.0.0-20181228230101-89fcab3d43de // indirect

integration-tests/testconfig/testconfig.go

@@ -281,7 +281,6 @@ func (c *TestConfig) GetNodeConfigTOML() (string, error) {
 		// Increase timeout for TransactionSender
 		TxTimeout: config.MustNewDuration(2 * time.Minute),
 	}
-	chainCfg.SetDefaults()
 
 	solConfig := solcfg.TOMLConfig{
 		Enabled:   ptr.Ptr(true),

pkg/solana/CONFIG.md

@@ -0,0 +1,361 @@
+[//]: # (Documentation generated from docs.toml - DO NOT EDIT.)
+This document describes the TOML format for configuration.
+## Example
+
+```toml
+# TODO
+```
+
+## Global
+```toml
+ChainID = 'mainnet' # Example
+Enabled = false # Default
+BlockTime = '500ms' # Default
+BalancePollPeriod = '5s' # Default
+ConfirmPollPeriod = '500ms' # Default
+OCR2CachePollPeriod = '1s' # Default
+OCR2CacheTTL = '1m' # Default
+TxTimeout = '1m' # Default
+TxRetryTimeout = '10s' # Default
+TxConfirmTimeout = '30s' # Default
+TxExpirationRebroadcast = false # Default
+TxRetentionTimeout = '0s' # Default
+SkipPreflight = true # Default
+Commitment = 'confirmed' # Default
+MaxRetries = 0 # Default
+FeeEstimatorMode = 'fixed' # Default
+ComputeUnitPriceMax = 1000 # Default
+ComputeUnitPriceMin = 0 # Default
+ComputeUnitPriceDefault = 0 # Default
+FeeBumpPeriod = '3s' # Default
+BlockHistoryPollPeriod = '5s' # Default
+BlockHistorySize = 1 # Default
+BlockHistoryBatchLoadSize = 20 # Default
+ComputeUnitLimitDefault = 200_000 # Default
+EstimateComputeUnitLimit = false # Default
+LogPollerStartingLookback = '24h' # Default
+```
+
+
+### ChainID
+```toml
+ChainID = 'mainnet' # Example
+```
+ChainID is the Solana chain ID. Must be one of: mainnet, testnet, devnet, localnet. Mandatory.
+
+### Enabled
+```toml
+Enabled = false # Default
+```
+Enabled enables this chain.
+
+### BlockTime
+```toml
+BlockTime = '500ms' # Default
+```
+BlockTime specifies the average time between blocks on this chain
+
+### BalancePollPeriod
+```toml
+BalancePollPeriod = '5s' # Default
+```
+BalancePollPeriod is the rate to poll for SOL balance and update Prometheus metrics.
+
+### ConfirmPollPeriod
+```toml
+ConfirmPollPeriod = '500ms' # Default
+```
+ConfirmPollPeriod is the rate to poll for signature confirmation.
+
+### OCR2CachePollPeriod
+```toml
+OCR2CachePollPeriod = '1s' # Default
+```
+OCR2CachePollPeriod is the rate to poll for the OCR2 state cache.
+
+### OCR2CacheTTL
+```toml
+OCR2CacheTTL = '1m' # Default
+```
+OCR2CacheTTL is the stale OCR2 cache deadline.
+
+### TxTimeout
+```toml
+TxTimeout = '1m' # Default
+```
+TxTimeout is the timeout for sending txes to an RPC endpoint.
+
+### TxRetryTimeout
+```toml
+TxRetryTimeout = '10s' # Default
+```
+TxRetryTimeout is the duration for tx manager to attempt rebroadcasting to RPC, before giving up.
+
+### TxConfirmTimeout
+```toml
+TxConfirmTimeout = '30s' # Default
+```
+TxConfirmTimeout is the duration to wait when confirming a tx signature, before discarding as unconfirmed.
+
+### TxExpirationRebroadcast
+```toml
+TxExpirationRebroadcast = false # Default
+```
+TxExpirationRebroadcast enables or disables transaction rebroadcast if expired. Expiration check is performed every `ConfirmPollPeriod`
+A transaction is considered expired if the blockhash it was sent with is 150 blocks older than the latest blockhash.
+
+### TxRetentionTimeout
+```toml
+TxRetentionTimeout = '0s' # Default
+```
+TxRetentionTimeout is the duration to retain transactions in storage after being marked as finalized or errored. Set to 0 to immediately drop transactions.
+
+### SkipPreflight
+```toml
+SkipPreflight = true # Default
+```
+SkipPreflight enables or disables preflight checks when sending txs.
+
+### Commitment
+```toml
+Commitment = 'confirmed' # Default
+```
+Commitment is the confirmation level for solana state and transactions. ([documentation](https://docs.solana.com/developing/clients/jsonrpc-api#configuring-state-commitment))
+
+### MaxRetries
+```toml
+MaxRetries = 0 # Default
+```
+MaxRetries is the maximum number of times the RPC node will automatically rebroadcast a tx.
+The default is 0 for custom txm rebroadcasting method, set to -1 to use the RPC node's default retry strategy.
+
+### FeeEstimatorMode
+```toml
+FeeEstimatorMode = 'fixed' # Default
+```
+FeeEstimatorMode is the method used to determine the base fee
+
+### ComputeUnitPriceMax
+```toml
+ComputeUnitPriceMax = 1000 # Default
+```
+ComputeUnitPriceMax is the maximum price per compute unit that a transaction can be bumped to
+
+### ComputeUnitPriceMin
+```toml
+ComputeUnitPriceMin = 0 # Default
+```
+ComputeUnitPriceMin is the minimum price per compute unit that transaction can have
+
+### ComputeUnitPriceDefault
+```toml
+ComputeUnitPriceDefault = 0 # Default
+```
+ComputeUnitPriceDefault is the default price per compute unit price, and the starting base fee when FeeEstimatorMode = 'fixed'
+
+### FeeBumpPeriod
+```toml
+FeeBumpPeriod = '3s' # Default
+```
+FeeBumpPeriod is the amount of time before a tx is retried with a fee bump. WARNING: If FeeBumpPeriod is shorter than blockhash expiration, multiple valid transactions can exist in parallel. This can result in higher costs and can cause unexpected behaviors if contracts do not de-dupe txs
+
+### BlockHistoryPollPeriod
+```toml
+BlockHistoryPollPeriod = '5s' # Default
+```
+BlockHistoryPollPeriod is the rate to poll for blocks in the block history fee estimator
+
+### BlockHistorySize
+```toml
+BlockHistorySize = 1 # Default
+```
+BlockHistorySize is the number of blocks to take into consideration when using FeeEstimatorMode = 'blockhistory' to determine compute unit price.
+If set to 1, the compute unit price will be determined by the median of the last block's compute unit prices.
+If set N > 1, the compute unit price will be determined by the average of the medians of the last N blocks' compute unit prices.
+DISCLAIMER: If set to a value greater than BlockHistoryBatchLoadSize, initial estimations during startup would be over smaller block ranges until the cache is filled.
+
+### BlockHistoryBatchLoadSize
+```toml
+BlockHistoryBatchLoadSize = 20 # Default
+```
+BlockHistoryBatchLoadSize is the number of latest blocks to fetch from the chain to store in the cache every BlockHistoryPollPeriod.
+This config is only relevant if BlockHistorySize > 1 and if BlockHistorySize is greater than BlockHistoryBatchLoadSize.
+Ensure the value is greater than the number of blocks that would be produced between each BlockHistoryPollPeriod to avoid gaps in block history.
+
+### ComputeUnitLimitDefault
+```toml
+ComputeUnitLimitDefault = 200_000 # Default
+```
+ComputeUnitLimitDefault is the compute units limit applied to transactions unless overriden during the txm enqueue
+
+### EstimateComputeUnitLimit
+```toml
+EstimateComputeUnitLimit = false # Default
+```
+EstimateComputeUnitLimit enables or disables compute unit limit estimations per transaction. If estimations return 0 used compute, the ComputeUnitLimitDefault value is used, if set.
+
+### LogPollerStartingLookback
+```toml
+LogPollerStartingLookback = '24h' # Default
+```
+LogPollerStartingLookback
+
+## MultiNode
+```toml
+[MultiNode]
+Enabled = false # Default
+PollFailureThreshold = 5 # Default
+PollInterval = '15s' # Default
+SelectionMode = 'PriorityLevel' # Default
+SyncThreshold = 10 # Default
+NodeIsSyncingEnabled = false # Default
+LeaseDuration = '1m' # Default
+NewHeadsPollInterval = '5s' # Default
+FinalizedBlockPollInterval = '5s' # Default
+EnforceRepeatableRead = true # Default
+DeathDeclarationDelay = '20s' # Default
+VerifyChainID = true # Default
+NodeNoNewHeadsThreshold = '20s' # Default
+NoNewFinalizedHeadsThreshold = '20s' # Default
+FinalityDepth = 0 # Default
+FinalityTagEnabled = true # Default
+FinalizedBlockOffset = 50 # Default
+```
+
+
+### Enabled
+```toml
+Enabled = false # Default
+```
+Enabled enables the multinode feature.
+
+### PollFailureThreshold
+```toml
+PollFailureThreshold = 5 # Default
+```
+PollFailureThreshold is the number of consecutive poll failures before a node is considered unhealthy.
+
+### PollInterval
+```toml
+PollInterval = '15s' # Default
+```
+PollInterval is the rate to poll for node health.
+
+### SelectionMode
+```toml
+SelectionMode = 'PriorityLevel' # Default
+```
+SelectionMode is the method used to select the next best node to use.
+
+### SyncThreshold
+```toml
+SyncThreshold = 10 # Default
+```
+SyncThreshold is the number of blocks behind the best node that a node can be before it is considered out of sync.
+
+### NodeIsSyncingEnabled
+```toml
+NodeIsSyncingEnabled = false # Default
+```
+NodeIsSyncingEnabled enables the feature to avoid sending transactions to nodes that are syncing. Not relavant for Solana.
+
+### LeaseDuration
+```toml
+LeaseDuration = '1m' # Default
+```
+LeaseDuration is the max duration a node can be leased for.
+
+### NewHeadsPollInterval
+```toml
+NewHeadsPollInterval = '5s' # Default
+```
+NewHeadsPollInterval is the rate to poll for new heads.
+
+### FinalizedBlockPollInterval
+```toml
+FinalizedBlockPollInterval = '5s' # Default
+```
+FinalizedBlockPollInterval is the rate to poll for the finalized block.
+
+### EnforceRepeatableRead
+```toml
+EnforceRepeatableRead = true # Default
+```
+EnforceRepeatableRead enforces the repeatable read guarantee for multinode.
+
+### DeathDeclarationDelay
+```toml
+DeathDeclarationDelay = '20s' # Default
+```
+DeathDeclarationDelay is the duration to wait before declaring a node dead.
+
+### VerifyChainID
+```toml
+VerifyChainID = true # Default
+```
+VerifyChainID enforces RPC Client ChainIDs to match configured ChainID
+
+### NodeNoNewHeadsThreshold
+```toml
+NodeNoNewHeadsThreshold = '20s' # Default
+```
+NodeNoNewHeadsThreshold is the duration to wait before declaring a node unhealthy due to no new heads.
+
+### NoNewFinalizedHeadsThreshold
+```toml
+NoNewFinalizedHeadsThreshold = '20s' # Default
+```
+NoNewFinalizedHeadsThreshold is the duration to wait before declaring a node unhealthy due to no new finalized heads.
+
+### FinalityDepth
+```toml
+FinalityDepth = 0 # Default
+```
+FinalityDepth is not used when finality tags are enabled.
+
+### FinalityTagEnabled
+```toml
+FinalityTagEnabled = true # Default
+```
+FinalityTagEnabled enables the use of finality tags.
+
+### FinalizedBlockOffset
+```toml
+FinalizedBlockOffset = 50 # Default
+```
+FinalizedBlockOffset is the offset from the finalized block to use for finality tags.
+
+## Nodes
+```toml
+[[Nodes]]
+Name = 'primary' # Example
+URL = 'http://solana.web' # Example
+SendOnly = false # Default
+Order = 100 # Default
+```
+
+
+### Name
+```toml
+Name = 'primary' # Example
+```
+Name is a unique (per-chain) identifier for this node.
+
+### URL
+```toml
+URL = 'http://solana.web' # Example
+```
+URL is the HTTP(S) endpoint for this node.
+
+### SendOnly
+```toml
+SendOnly = false # Default
+```
+SendOnly is a multinode config that only sends transactions to a node and does not read state
+
+### Order
+```toml
+Order = 100 # Default
+```
+Order specifies the priority for each node. 1 is highest priority down to 100 being the lowest.
+