Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions ccip/config/evm/fallback.toml
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,8 @@ SyncThreshold = 5
LeaseDuration = '0s'
NodeIsSyncingEnabled = false
FinalizedBlockPollInterval = '5s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = false
DeathDeclarationDelay = '10s'
NewHeadsPollInterval = '0s'
Expand Down
13 changes: 13 additions & 0 deletions core/config/docs/chains-evm.toml
Original file line number Diff line number Diff line change
Expand Up @@ -464,6 +464,17 @@ NodeIsSyncingEnabled = false # Default
#
# Set to 0 to disable.
FinalizedBlockPollInterval = '5s' # Default
# HistoricalBalanceCheckAddress is the probe account used by the historical balance health check.
# The check executes `eth_getBalance` for this address at the latest finalized block.
# Finalized block selection follows chain finality settings:
# - `FinalityTagEnabled = true`: use `finalized` tag
# - `FinalityTagEnabled = false`: use `latest - FinalityDepth`
# The check is only active when `FinalizedStateCheckFailureThreshold > 0`.
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000' # Default
# FinalizedStateCheckFailureThreshold is the number of consecutive failures of the finalized state availability check
# before the node is marked as FinalizedStateNotAvailable.
# Set to 0 to disable the check.
FinalizedStateCheckFailureThreshold = 0 # Default
# EnforceRepeatableRead defines if Core should only use RPCs whose most recently finalized block is greater or equal to
# `highest finalized block - FinalizedBlockOffset`. In other words, exclude RPCs lagging on latest finalized
# block.
Expand Down Expand Up @@ -523,6 +534,8 @@ ServiceUnavailable = '(: |^)service unavailable' # Example
TooManyResults = '(: |^)too many results' # Example
# MissingBlocks is a regex pattern to match an eth_getLogs error indicating the rpc server is permanently missing some blocks in the requested block range
MissingBlocks = '(: |^)missing blocks' # Example
# FinalizedStateUnavailable is a regex pattern to match errors indicating the RPC cannot serve historical state at the finalized block (e.g., pruned/non-archive node)
FinalizedStateUnavailable = '(missing trie node|state not available|historical state unavailable)' # Example

[EVM.OCR]
# ContractConfirmations sets `OCR.ContractConfirmations` for this EVM chain.
Expand Down
2 changes: 2 additions & 0 deletions core/config/docs/chains-solana.toml
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,8 @@ FinalityDepth = 0 # Default
FinalityTagEnabled = true # Default
# FinalizedBlockOffset is the offset from the finalized block to use for finality tags.
FinalizedBlockOffset = 0 # Default
# FinalizedStateCheckFailureThreshold defines the number of consecutive finalized state check failures before declaring a node unhealthy. 0 means disabled.
FinalizedStateCheckFailureThreshold = 0 # Default

[[Solana.Nodes]]
# Name is a unique (per-chain) identifier for this node.
Expand Down
10 changes: 5 additions & 5 deletions core/scripts/go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ require (
github.com/smartcontractkit/chainlink-common/keystore v1.0.2
github.com/smartcontractkit/chainlink-data-streams v0.1.13
github.com/smartcontractkit/chainlink-deployments-framework v0.86.3
github.com/smartcontractkit/chainlink-evm v0.3.4-0.20260320152158-2191d797b5ce
github.com/smartcontractkit/chainlink-evm v0.3.4-0.20260318170523-1db6705c90a1
github.com/smartcontractkit/chainlink-evm/gethwrappers v0.0.0-20260119171452-39c98c3b33cd
github.com/smartcontractkit/chainlink-protos/cre/go v0.0.0-20260226130359-963f935e0396
github.com/smartcontractkit/chainlink-protos/job-distributor v0.18.0
Expand All @@ -60,7 +60,7 @@ require (
github.com/smartcontractkit/chainlink-testing-framework/seth v1.51.5
github.com/smartcontractkit/chainlink/core/scripts/cre/environment/examples/workflows/v1/proof-of-reserve/cron-based v0.0.0-20251020210257-0a6ec41648b4
github.com/smartcontractkit/chainlink/core/scripts/cre/environment/examples/workflows/v1/proof-of-reserve/web-trigger-based v0.0.0-20251020210257-0a6ec41648b4
github.com/smartcontractkit/chainlink/system-tests/lib v0.0.0-20251020210257-0a6ec41648b4
github.com/smartcontractkit/chainlink/system-tests/lib v0.0.0-00010101000000-000000000000
github.com/smartcontractkit/cre-sdk-go/capabilities/scheduler/cron v1.3.0
github.com/smartcontractkit/libocr v0.0.0-20260304194147-a03701e2c02e
github.com/spf13/cobra v1.10.2
Expand Down Expand Up @@ -497,8 +497,8 @@ require (
github.com/smartcontractkit/chainlink-feeds v0.1.2-0.20250227211209-7cd000095135 // indirect
github.com/smartcontractkit/chainlink-framework/capabilities v0.0.0-20250818175541-3389ac08a563 // indirect
github.com/smartcontractkit/chainlink-framework/chains v0.0.0-20260317132927-e8bc2c7b01f1 // indirect
github.com/smartcontractkit/chainlink-framework/metrics v0.0.0-20251210101658-1c5c8e4c4f15 // indirect
github.com/smartcontractkit/chainlink-framework/multinode v0.0.0-20251021173435-e86785845942 // indirect
github.com/smartcontractkit/chainlink-framework/metrics v0.0.0-20260310180305-3ee91a6d9ae9 // indirect
github.com/smartcontractkit/chainlink-framework/multinode v0.0.0-20260317161400-793ab9bc5b53 // indirect
github.com/smartcontractkit/chainlink-protos/billing/go v0.0.0-20251024234028-0988426d98f4 // indirect
github.com/smartcontractkit/chainlink-protos/chainlink-ccv/committee-verifier v0.0.0-20251211142334-5c3421fe2c8d // indirect
github.com/smartcontractkit/chainlink-protos/chainlink-ccv/heartbeat v0.0.0-20260115142640-f6b99095c12e // indirect
Expand All @@ -512,7 +512,7 @@ require (
github.com/smartcontractkit/chainlink-protos/storage-service v0.3.0 // indirect
github.com/smartcontractkit/chainlink-protos/svr v1.1.1-0.20260203131522-bb8bc5c423b3 // indirect
github.com/smartcontractkit/chainlink-protos/workflows/go v0.0.0-20260217043601-5cc966896c4f // indirect
github.com/smartcontractkit/chainlink-solana v1.1.2-0.20260320011913-f2205f8506c7 // indirect
github.com/smartcontractkit/chainlink-solana v1.1.2-0.20260318193457-448a9b497985 // indirect
github.com/smartcontractkit/chainlink-solana/contracts v0.0.0-20260217175957-8f1af02c5075 // indirect
github.com/smartcontractkit/chainlink-sui v0.0.0-20260304150206-c64e48eb0cb0 // indirect
github.com/smartcontractkit/chainlink-sui/deployment v0.0.0-20260304150206-c64e48eb0cb0 // indirect
Expand Down
16 changes: 8 additions & 8 deletions core/scripts/go.sum

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

78 changes: 44 additions & 34 deletions core/services/chainlink/config_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -172,15 +172,16 @@ var (
NodeIsSyncingEnabled: ptr(false),
LeaseDuration: &minute,
NewHeadsPollInterval: &second,
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
FinalizedStateCheckFailureThreshold: ptr[uint32](0),
},
},
Nodes: []*solcfg.Node{
Expand All @@ -202,15 +203,16 @@ var (
NodeIsSyncingEnabled: ptr(false),
LeaseDuration: &minute,
NewHeadsPollInterval: &second,
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
FinalizedStateCheckFailureThreshold: ptr[uint32](0),
},
},
Nodes: []*solcfg.Node{
Expand Down Expand Up @@ -810,12 +812,14 @@ func TestConfig_Marshal(t *testing.T) {
SyncThreshold: ptr[uint32](13),
LeaseDuration: &zeroSeconds,
NodeIsSyncingEnabled: ptr(true),
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NewHeadsPollInterval: &zeroSeconds,
ExternalRequestMaxResponseSize: ptr[uint32](10),
FinalizedBlockPollInterval: &second,
HistoricalBalanceCheckAddress: ptr(types.MustEIP55Address("0x0000000000000000000000000000000000000000")),
FinalizedStateCheckFailureThreshold: ptr[uint32](0),
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NewHeadsPollInterval: &zeroSeconds,
ExternalRequestMaxResponseSize: ptr[uint32](10),
Errors: evmcfg.ClientErrors{
NonceTooLow: ptr[string]("(: |^)nonce too low"),
NonceTooHigh: ptr[string]("(: |^)nonce too high"),
Expand All @@ -833,6 +837,7 @@ func TestConfig_Marshal(t *testing.T) {
ServiceUnavailable: ptr[string]("(: |^)service unavailable"),
TooManyResults: ptr[string]("(: |^)too many results"),
MissingBlocks: ptr[string]("(: |^)missing blocks"),
FinalizedStateUnavailable: ptr[string](""),
},
},
OCR: evmcfg.OCR{
Expand Down Expand Up @@ -914,16 +919,17 @@ func TestConfig_Marshal(t *testing.T) {
SyncThreshold: ptr[uint32](5),
NodeIsSyncingEnabled: ptr(false),
LeaseDuration: &minute,
NewHeadsPollInterval: &second,
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
NewHeadsPollInterval: &second,
FinalizedBlockPollInterval: &second,
EnforceRepeatableRead: ptr(true),
DeathDeclarationDelay: &minute,
VerifyChainID: ptr(true),
NodeNoNewHeadsThreshold: &minute,
NoNewFinalizedHeadsThreshold: &minute,
FinalityDepth: ptr[uint32](0),
FinalityTagEnabled: ptr(true),
FinalizedBlockOffset: ptr[uint32](0),
FinalizedStateCheckFailureThreshold: ptr[uint32](0),
},
},
Nodes: []*solcfg.Node{
Expand Down Expand Up @@ -1339,6 +1345,8 @@ SyncThreshold = 13
LeaseDuration = '0s'
NodeIsSyncingEnabled = true
FinalizedBlockPollInterval = '1s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = true
DeathDeclarationDelay = '1m0s'
NewHeadsPollInterval = '0s'
Expand All @@ -1362,6 +1370,7 @@ Fatal = '(: |^)fatal'
ServiceUnavailable = '(: |^)service unavailable'
TooManyResults = '(: |^)too many results'
MissingBlocks = '(: |^)missing blocks'
FinalizedStateUnavailable = ''

[EVM.OCR]
ContractConfirmations = 11
Expand Down Expand Up @@ -1454,6 +1463,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'primary'
Expand Down
4 changes: 4 additions & 0 deletions core/services/chainlink/testdata/config-full.toml
Original file line number Diff line number Diff line change
Expand Up @@ -556,6 +556,8 @@ SyncThreshold = 13
LeaseDuration = '0s'
NodeIsSyncingEnabled = true
FinalizedBlockPollInterval = '1s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = true
DeathDeclarationDelay = '1m0s'
NewHeadsPollInterval = '0s'
Expand All @@ -579,6 +581,7 @@ Fatal = '(: |^)fatal'
ServiceUnavailable = '(: |^)service unavailable'
TooManyResults = '(: |^)too many results'
MissingBlocks = '(: |^)missing blocks'
FinalizedStateUnavailable = ''

[EVM.OCR]
ContractConfirmations = 11
Expand Down Expand Up @@ -671,6 +674,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'primary'
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -498,6 +498,8 @@ SyncThreshold = 5
LeaseDuration = '0s'
NodeIsSyncingEnabled = false
FinalizedBlockPollInterval = '5s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = true
DeathDeclarationDelay = '1m0s'
NewHeadsPollInterval = '0s'
Expand Down Expand Up @@ -621,6 +623,8 @@ SyncThreshold = 5
LeaseDuration = '0s'
NodeIsSyncingEnabled = false
FinalizedBlockPollInterval = '5s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = true
DeathDeclarationDelay = '1m0s'
NewHeadsPollInterval = '0s'
Expand Down Expand Up @@ -738,6 +742,8 @@ SyncThreshold = 10
LeaseDuration = '0s'
NodeIsSyncingEnabled = false
FinalizedBlockPollInterval = '5s'
HistoricalBalanceCheckAddress = '0x0000000000000000000000000000000000000000'
FinalizedStateCheckFailureThreshold = 0
EnforceRepeatableRead = true
DeathDeclarationDelay = '1m0s'
NewHeadsPollInterval = '0s'
Expand Down Expand Up @@ -823,6 +829,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'primary'
Expand Down Expand Up @@ -887,6 +894,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'secondary'
Expand Down
2 changes: 2 additions & 0 deletions core/services/chainlink/testdata/config-multi-chain.toml
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'primary'
Expand Down Expand Up @@ -128,6 +129,7 @@ NoNewFinalizedHeadsThreshold = '1m0s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 0
FinalizedStateCheckFailureThreshold = 0

[[Solana.Nodes]]
Name = 'secondary'
Expand Down
1 change: 1 addition & 0 deletions core/web/chains_controller_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -305,6 +305,7 @@ NoNewFinalizedHeadsThreshold = '20s'
FinalityDepth = 0
FinalityTagEnabled = true
FinalizedBlockOffset = 50
FinalizedStateCheckFailureThreshold = 0
`,
}
},
Expand Down
Loading
Loading