diff --git a/src/content/chainlink-nodes/node-versions.mdx b/src/content/chainlink-nodes/node-versions.mdx index ef6d316712b..ce01efc89a2 100644 --- a/src/content/chainlink-nodes/node-versions.mdx +++ b/src/content/chainlink-nodes/node-versions.mdx @@ -12,6 +12,26 @@ import { Aside } from "@components" You can find a list of release notes for Chainlink nodes in the [smartcontractkit GitHub repository](https://github.com/smartcontractkit/chainlink/releases). Docker images are available in the [Chainlink Docker hub](https://hub.docker.com/r/smartcontract/chainlink/tags). +## Changes in v2.11.0 nodes - 2024-05-01 + +**[v2.11.0 release notes](https://github.com/smartcontractkit/chainlink/releases/tag/v2.11.0)** + +### Added + +- Added a tx simulation feature to the chain client to enable testing for zk out-of-counter (OOC) errors +- Add the `pool_rpc_node_highest_finalized_block` metric that tracks the highest finalized block seen per RPC. If `FinalityTagEnabled = true`, a positive NodePool.FinalizedBlockPollInterval is needed to collect the metric. If the finality tag is not enabled, the metric is populated with a calculated latest finalized block based on the latest head and finality depth. + +### Updated + +- Moved `JuelsPerFeeCoinCacheDuration` under the `JuelsPerFeeCoinCache` struct in config. Rename `JuelsPerFeeCoinCacheDuration` to updateInterval. Add `stalenessAlertThreshold` to `JuelsPerFeeCoinCache` config. The `StalenessAlertThreshold` config option has a default of 24 hours which means that it doesn't have to be set unless we want to override the duration after which a stale cache should start throwing errors. +- Updated config for Polygon zkEVM chains. +- HeadTracker now respects the `FinalityTagEnabled` config option. If the flag is enabled, HeadTracker backfills blocks up to the latest finalized block provided by the corresponding RPC call. To address potential misconfigurations, `HistoryDepth` is now calculated from the latest finalized block instead of the head. Note that consumers like TXM and LogPoller do not fully use the Finality Tag yet. +- Change LimitTransfer gasLimit type from uint32 to uint64 + +### Upcoming changes in v2.13.0 + +- The `xdai` `ChainType` has been renamed to `gnosis` to match the chain's new name. The old value is still supported but has been deprecated and will be removed in v2.13.0. + ## Changes in v2.10.0 nodes - 2024-04-08 **[v2.10.0 release notes](https://github.com/smartcontractkit/chainlink/releases/tag/v2.10.0)** diff --git a/src/content/chainlink-nodes/v1/node-config.mdx b/src/content/chainlink-nodes/v1/node-config.mdx index 6aa82200db5..c646a9184bc 100644 --- a/src/content/chainlink-nodes/v1/node-config.mdx +++ b/src/content/chainlink-nodes/v1/node-config.mdx @@ -100,7 +100,7 @@ DefaultLockTimeout = '15s' # Default DefaultQueryTimeout = '10s' # Default LogQueries = false # Default MaxIdleConns = 10 # Default -MaxOpenConns = 20 # Default +MaxOpenConns = 100 # Default MigrateOnStartup = true # Default ``` @@ -149,7 +149,7 @@ Postgres has connection limits, so you must use caution when increasing this val ### MaxOpenConns ```toml -MaxOpenConns = 20 # Default +MaxOpenConns = 100 # Default ``` MaxOpenConns configures the maximum number of database connections that a Chainlink node will have open at any one time. Think of this as the maximum burst upper bound limit of database connections per Chainlink node instance. Increasing this number can help to improve performance under database-heavy workloads. @@ -972,6 +972,7 @@ MaxSuccessfulRuns = 10000 # Default ReaperInterval = '1h' # Default ReaperThreshold = '24h' # Default ResultWriteQueueDepth = 100 # Default +VerboseLogging = true # Default ``` ### ExternalInitiatorsEnabled @@ -1031,6 +1032,18 @@ ResultWriteQueueDepth = 100 # Default ResultWriteQueueDepth controls how many writes will be buffered before subsequent writes are dropped, for jobs that write results asynchronously for performance reasons, such as OCR. +### VerboseLogging + +```toml +VerboseLogging = true # Default +``` + +VerboseLogging enables detailed logging of pipeline execution steps. +This can be useful for debugging failed runs without relying on the UI +or database. + +You may disable if this results in excessive log volume. + ## JobPipeline.HTTPRequest ```toml @@ -1478,6 +1491,125 @@ ListenAddresses = ['1.2.3.4:9999', '[a52d:0:a88:1274::abcd]:1337'] # Example ListenAddresses is the addresses the peer will listen to on the network in `host:port` form as accepted by `net.Listen()`, but the host and port must be fully specified and cannot be empty. You can specify `0.0.0.0` (IPv4) or `::` (IPv6) to listen on all interfaces, but that is not recommended. +## Capabilities.Peering + +```toml +[Capabilities.Peering] +IncomingMessageBufferSize = 10 # Default +OutgoingMessageBufferSize = 10 # Default +PeerID = '12D3KooWMoejJznyDuEk5aX6GvbjaG12UzeornPCBNzMRqdwrFJw' # Example +TraceLogging = false # Default +``` + +### IncomingMessageBufferSize + +```toml +IncomingMessageBufferSize = 10 # Default +``` + +IncomingMessageBufferSize is the per-remote number of incoming +messages to buffer. Any additional messages received on top of those +already in the queue will be dropped. + +### OutgoingMessageBufferSize + +```toml +OutgoingMessageBufferSize = 10 # Default +``` + +OutgoingMessageBufferSize is the per-remote number of outgoing +messages to buffer. Any additional messages send on top of those +already in the queue will displace the oldest. +NOTE: OutgoingMessageBufferSize should be comfortably smaller than remote's +IncomingMessageBufferSize to give the remote enough space to process +them all in case we regained connection and now send a bunch at once + +### PeerID + +```toml +PeerID = '12D3KooWMoejJznyDuEk5aX6GvbjaG12UzeornPCBNzMRqdwrFJw' # Example +``` + +PeerID is the default peer ID to use for OCR jobs. If unspecified, uses the first available peer ID. + +### TraceLogging + +```toml +TraceLogging = false # Default +``` + +TraceLogging enables trace level logging. + +## Capabilities.Peering.V2 + +```toml +[Capabilities.Peering.V2] +Enabled = false # Default +AnnounceAddresses = ['1.2.3.4:9999', '[a52d:0:a88:1274::abcd]:1337'] # Example +DefaultBootstrappers = ['12D3KooWMHMRLQkgPbFSYHwD3NBuwtS1AmxhvKVUrcfyaGDASR4U@1.2.3.4:9999', '12D3KooWM55u5Swtpw9r8aFLQHEtw7HR4t44GdNs654ej5gRs2Dh@example.com:1234'] # Example +DeltaDial = '15s' # Default +DeltaReconcile = '1m' # Default +ListenAddresses = ['1.2.3.4:9999', '[a52d:0:a88:1274::abcd]:1337'] # Example +``` + +### Enabled + +```toml +Enabled = false # Default +``` + +Enabled enables P2P V2. + +### AnnounceAddresses + +```toml +AnnounceAddresses = ['1.2.3.4:9999', '[a52d:0:a88:1274::abcd]:1337'] # Example +``` + +AnnounceAddresses is the addresses the peer will advertise on the network in `host:port` form as accepted by the TCP version of Go’s `net.Dial`. +The addresses should be reachable by other nodes on the network. When attempting to connect to another node, +a node will attempt to dial all of the other node’s AnnounceAddresses in round-robin fashion. + +### DefaultBootstrappers + +```toml +DefaultBootstrappers = ['12D3KooWMHMRLQkgPbFSYHwD3NBuwtS1AmxhvKVUrcfyaGDASR4U@1.2.3.4:9999', '12D3KooWM55u5Swtpw9r8aFLQHEtw7HR4t44GdNs654ej5gRs2Dh@example.com:1234'] # Example +``` + +DefaultBootstrappers is the default bootstrapper peers for libocr's v2 networking stack. + +Oracle nodes typically only know each other’s PeerIDs, but not their hostnames, IP addresses, or ports. +DefaultBootstrappers are special nodes that help other nodes discover each other’s `AnnounceAddresses` so they can communicate. +Nodes continuously attempt to connect to bootstrappers configured in here. When a node wants to connect to another node +(which it knows only by PeerID, but not by address), it discovers the other node’s AnnounceAddresses from communications +received from its DefaultBootstrappers or other discovered nodes. To facilitate discovery, +nodes will regularly broadcast signed announcements containing their PeerID and AnnounceAddresses. + +### DeltaDial + +```toml +DeltaDial = '15s' # Default +``` + +DeltaDial controls how far apart Dial attempts are + +### DeltaReconcile + +```toml +DeltaReconcile = '1m' # Default +``` + +DeltaReconcile controls how often a Reconcile message is sent to every peer. + +### ListenAddresses + +```toml +ListenAddresses = ['1.2.3.4:9999', '[a52d:0:a88:1274::abcd]:1337'] # Example +``` + +ListenAddresses is the addresses the peer will listen to on the network in `host:port` form as accepted by `net.Listen()`, +but the host and port must be fully specified and cannot be empty. You can specify `0.0.0.0` (IPv4) or `::` (IPv6) to listen on all interfaces, but that is not recommended. + ## Keeper ```toml @@ -2061,6 +2193,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2072,7 +2205,7 @@ ObservationGracePeriod = '1s' [OCR2] [OCR2.Automation] -GasLimit = 5400000 +GasLimit = 10500000 ``` ### Ethereum Ropsten (3) @@ -2143,6 +2276,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2225,6 +2359,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2307,6 +2442,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2390,6 +2526,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -2472,6 +2609,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2554,6 +2692,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2637,6 +2776,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2719,6 +2859,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2800,6 +2941,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2881,6 +3023,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2963,6 +3106,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -2983,7 +3127,7 @@ GasLimit = 5400000 AutoCreateKey = true BlockBackfillDepth = 10 BlockBackfillSkip = false -ChainType = 'xdai' +ChainType = 'gnosis' FinalityDepth = 50 FinalityTagEnabled = false LinkContractAddress = '0xE2e73A1c69ecF83F464EFCE6A5be353a37cA09b2' @@ -3046,6 +3190,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3128,6 +3273,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3210,6 +3356,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3292,6 +3439,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3374,6 +3522,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -3456,6 +3605,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3538,6 +3688,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3620,6 +3771,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -3703,6 +3855,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -3785,6 +3938,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -3866,6 +4020,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -3948,6 +4103,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -3968,7 +4124,7 @@ GasLimit = 5400000 AutoCreateKey = true BlockBackfillDepth = 10 BlockBackfillSkip = false -FinalityDepth = 1 +FinalityDepth = 500 FinalityTagEnabled = false LogBackfillBatchSize = 1000 LogPollInterval = '30s' @@ -4018,7 +4174,7 @@ CheckInclusionPercentile = 90 TransactionPercentile = 60 [HeadTracker] -HistoryDepth = 50 +HistoryDepth = 2000 MaxBufferSize = 3 SamplingInterval = '1s' @@ -4029,6 +4185,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4111,6 +4268,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4193,6 +4351,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4274,6 +4433,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4294,7 +4454,7 @@ GasLimit = 5400000 AutoCreateKey = true BlockBackfillDepth = 10 BlockBackfillSkip = false -FinalityDepth = 1 +FinalityDepth = 500 FinalityTagEnabled = false LogBackfillBatchSize = 1000 LogPollInterval = '30s' @@ -4344,7 +4504,7 @@ CheckInclusionPercentile = 90 TransactionPercentile = 60 [HeadTracker] -HistoryDepth = 50 +HistoryDepth = 2000 MaxBufferSize = 3 SamplingInterval = '1s' @@ -4355,6 +4515,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4437,6 +4598,89 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' + +[OCR] +ContractConfirmations = 1 +ContractTransmitterTransmitTimeout = '10s' +DatabaseTimeout = '10s' +DeltaCOverride = '168h0m0s' +DeltaCJitterOverride = '1h0m0s' +ObservationGracePeriod = '1s' + +[OCR2] +[OCR2.Automation] +GasLimit = 5400000 +``` + +### Polygon Zkevm Cardona (2442) + +```toml +AutoCreateKey = true +BlockBackfillDepth = 10 +BlockBackfillSkip = false +FinalityDepth = 500 +FinalityTagEnabled = false +LogBackfillBatchSize = 1000 +LogPollInterval = '30s' +LogKeepBlocksDepth = 100000 +LogPrunePageSize = 0 +BackupLogPollerBlockDelay = 100 +MinIncomingConfirmations = 1 +MinContractPayment = '0.00001 link' +NonceAutoSync = true +NoNewHeadsThreshold = '12m0s' +RPCDefaultBatchSize = 100 +RPCBlockQueryDelay = 1 + +[Transactions] +ForwardersEnabled = false +MaxInFlight = 16 +MaxQueued = 250 +ReaperInterval = '1h0m0s' +ReaperThreshold = '168h0m0s' +ResendAfterThreshold = '3m0s' + +[BalanceMonitor] +Enabled = true + +[GasEstimator] +Mode = 'BlockHistory' +PriceDefault = '20 gwei' +PriceMax = '115792089237316195423570985008687907853269984665.640564039457584007913129639935 tether' +PriceMin = '50 mwei' +LimitDefault = 500000 +LimitMax = 500000 +LimitMultiplier = '1' +LimitTransfer = 21000 +BumpMin = '20 mwei' +BumpPercent = 40 +BumpThreshold = 3 +EIP1559DynamicFees = false +FeeCapDefault = '100 gwei' +TipCapDefault = '1 wei' +TipCapMin = '1 wei' + +[GasEstimator.BlockHistory] +BatchSize = 25 +BlockHistorySize = 12 +CheckInclusionBlocks = 12 +CheckInclusionPercentile = 90 +TransactionPercentile = 60 + +[HeadTracker] +HistoryDepth = 2000 +MaxBufferSize = 3 +SamplingInterval = '1s' + +[NodePool] +PollFailureThreshold = 5 +PollInterval = '10s' +SelectionMode = 'HighestHead' +SyncThreshold = 5 +LeaseDuration = '0s' +NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4519,6 +4763,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -4600,6 +4845,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4682,6 +4928,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4702,7 +4949,7 @@ GasLimit = 6500000 AutoCreateKey = true BlockBackfillDepth = 10 BlockBackfillSkip = false -ChainType = 'xdai' +ChainType = 'gnosis' FinalityDepth = 100 FinalityTagEnabled = false LogBackfillBatchSize = 1000 @@ -4764,6 +5011,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -4847,6 +5095,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -4929,6 +5178,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5011,6 +5261,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5093,6 +5344,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5175,6 +5427,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5256,6 +5509,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -5337,6 +5591,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -5419,6 +5674,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -5501,6 +5757,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5583,6 +5840,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5666,6 +5924,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5749,6 +6008,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5831,6 +6091,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 10 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5913,6 +6174,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -5995,6 +6257,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 1 @@ -6077,6 +6340,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -6088,7 +6352,90 @@ ObservationGracePeriod = '1s' [OCR2] [OCR2.Automation] -GasLimit = 5400000 +GasLimit = 10500000 +``` + +### Optimism Sepolia (11155420) + +```toml +AutoCreateKey = true +BlockBackfillDepth = 10 +BlockBackfillSkip = false +ChainType = 'optimismBedrock' +FinalityDepth = 200 +FinalityTagEnabled = false +LogBackfillBatchSize = 1000 +LogPollInterval = '2s' +LogKeepBlocksDepth = 100000 +LogPrunePageSize = 0 +BackupLogPollerBlockDelay = 100 +MinIncomingConfirmations = 1 +MinContractPayment = '0.00001 link' +NonceAutoSync = true +NoNewHeadsThreshold = '40s' +RPCDefaultBatchSize = 250 +RPCBlockQueryDelay = 1 + +[Transactions] +ForwardersEnabled = false +MaxInFlight = 16 +MaxQueued = 250 +ReaperInterval = '1h0m0s' +ReaperThreshold = '168h0m0s' +ResendAfterThreshold = '30s' + +[BalanceMonitor] +Enabled = true + +[GasEstimator] +Mode = 'BlockHistory' +PriceDefault = '20 gwei' +PriceMax = '115792089237316195423570985008687907853269984665.640564039457584007913129639935 tether' +PriceMin = '1 wei' +LimitDefault = 500000 +LimitMax = 500000 +LimitMultiplier = '1' +LimitTransfer = 21000 +BumpMin = '100 wei' +BumpPercent = 20 +BumpThreshold = 3 +EIP1559DynamicFees = true +FeeCapDefault = '100 gwei' +TipCapDefault = '1 wei' +TipCapMin = '1 wei' + +[GasEstimator.BlockHistory] +BatchSize = 25 +BlockHistorySize = 60 +CheckInclusionBlocks = 12 +CheckInclusionPercentile = 90 +TransactionPercentile = 60 + +[HeadTracker] +HistoryDepth = 300 +MaxBufferSize = 3 +SamplingInterval = '1s' + +[NodePool] +PollFailureThreshold = 5 +PollInterval = '10s' +SelectionMode = 'HighestHead' +SyncThreshold = 10 +LeaseDuration = '0s' +NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' + +[OCR] +ContractConfirmations = 1 +ContractTransmitterTransmitTimeout = '10s' +DatabaseTimeout = '10s' +DeltaCOverride = '168h0m0s' +DeltaCJitterOverride = '1h0m0s' +ObservationGracePeriod = '1s' + +[OCR2] +[OCR2.Automation] +GasLimit = 6500000 ``` ### Harmony Mainnet (1666600000) @@ -6159,6 +6506,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -6241,6 +6589,7 @@ SelectionMode = 'HighestHead' SyncThreshold = 5 LeaseDuration = '0s' NodeIsSyncingEnabled = false +FinalizedBlockPollInterval = '5s' [OCR] ContractConfirmations = 4 @@ -6304,7 +6653,9 @@ ChainType = 'arbitrum' # Example ``` ChainType is automatically detected from chain ID. Set this to force a certain chain type regardless of chain ID. -Available types: arbitrum, metis, optimismBedrock, xdai, celo, kroma, wemix, zksync, scroll +Available types: `arbitrum`, `celo`, `gnosis`, `kroma`, `metis`, `optimismBedrock`, `scroll`, `wemix`, `zksync` + +`xdai` has been deprecated and will be removed in v2.13.0, use `gnosis` instead. ### FinalityDepth @@ -6312,12 +6663,12 @@ Available types: arbitrum, metis, optimismBedrock, xdai, celo, kroma, wemix, zks FinalityDepth = 50 # Default ``` -FinalityDepth is the number of blocks after which an ethereum transaction is considered "final". Note that the default is automatically set based on chain ID so it should not be necessary to change this under normal operation. +FinalityDepth is the number of blocks after which an ethereum transaction is considered "final". Note that the default is automatically set based on chain ID, so it should not be necessary to change this under normal operation. BlocksConsideredFinal determines how deeply we look back to ensure that transactions are confirmed onto the longest chain There is not a large performance penalty to setting this relatively high (on the order of hundreds) It is practically limited by the number of heads we store in the database and should be less than this with a comfortable margin. If a transaction is mined in a block more than this many blocks ago, and is reorged out, we will NOT retransmit this transaction and undefined behaviour can occur including gaps in the nonce sequence that require manual intervention to fix. -Therefore this number represents a number of blocks we consider large enough that no re-org this deep will ever feasibly happen. +Therefore, this number represents a number of blocks we consider large enough that no re-org this deep will ever feasibly happen. Special cases: `FinalityDepth`=0 would imply that transactions can be final even before they were mined into a block. This is not supported. @@ -6350,7 +6701,7 @@ Finality for a block is solely defined by the finality related tags provided by FlagsContractAddress = '0xae4E781a6218A8031764928E88d457937A954fC3' # Example ``` -FlagsContractAddress can optionally point to a [Flags contract](https://github.com/smartcontractkit/chainlink/blob/develop/contracts/src/v0.8/Flags.sol). If set, the node will lookup that contract for each job that supports flags contracts (currently OCR and FM jobs are supported). If the job's contractAddress is set as hibernating in the FlagsContractAddress address, it overrides the standard update parameters (such as heartbeat/threshold). +FlagsContractAddress can optionally point to a [Flags contract](https://github.com/smartcontractkit/chainlink/blob/v2.11.0/contracts/src/v0.8/Flags.sol). If set, the node will lookup that contract for each job that supports flags contracts (currently OCR and FM jobs are supported). If the job's contractAddress is set as hibernating in the FlagsContractAddress address, it overrides the standard update parameters (such as heartbeat/threshold). ### LinkContractAddress @@ -6797,7 +7148,7 @@ TipCapMin = '1 wei' # Default TipCapMinimum is the minimum gas tip to use when submitting transactions to the blockchain. -Only applies to EIP-1559 transactions) +(Only applies to EIP-1559 transactions) ## EVM.GasEstimator.LimitJobType @@ -6922,7 +7273,7 @@ EIP1559FeeCapBufferBlocks = 13 # Example EIP1559FeeCapBufferBlocks controls the buffer blocks to add to the current base fee when sending a transaction. By default, the gas bumping threshold + 1 block is used. -Only applies to EIP-1559 transactions) +(Only applies to EIP-1559 transactions) ### TransactionPercentile @@ -6961,8 +7312,8 @@ In addition to these settings, it log warnings if `EVM.NoNewHeadsThreshold` is e HistoryDepth = 100 # Default ``` -HistoryDepth tracks the top N block numbers to keep in the `heads` database table. -Note that this can easily result in MORE than N records since in the case of re-orgs we keep multiple heads for a particular block height. +HistoryDepth tracks the top N blocks on top of the latest finalized block to keep in the `heads` database table. +Note that this can easily result in MORE than `N + finality depth` records since in the case of re-orgs we keep multiple heads for a particular block height. This number should be at least as large as `FinalityDepth`. There may be a small performance penalty to setting this to something very large (10,000+) @@ -7021,6 +7372,7 @@ SelectionMode = 'HighestHead' # Default SyncThreshold = 5 # Default LeaseDuration = '0s' # Default NodeIsSyncingEnabled = false # Default +FinalizedBlockPollInterval = '5s' # Default ``` The node pool manages multiple RPC endpoints. @@ -7096,6 +7448,20 @@ All of the requests to node in state `Syncing` are rejected. Set true to enable this check +### FinalizedBlockPollInterval + +```toml +FinalizedBlockPollInterval = '5s' # Default +``` + +FinalizedBlockPollInterval controls how often to poll RPC for new finalized blocks. +The finalized block is only used to report to the `pool_rpc_node_highest_finalized_block` metric. We plan to use it +in RPCs health assessment in the future. +If `FinalityTagEnabled = false`, poll is not performed and `pool_rpc_node_highest_finalized_block` is +reported based on latest block and finality depth. + +Set to 0 to disable. + ## EVM.OCR ```toml @@ -7588,6 +7954,7 @@ URL is the HTTP(S) endpoint for this node. ```toml [[Starknet]] ChainID = 'foobar' # Example +FeederURL = 'http://feeder.url' # Example Enabled = true # Default OCR2CachePollPeriod = '5s' # Default OCR2CacheTTL = '1m' # Default @@ -7604,6 +7971,14 @@ ChainID = 'foobar' # Example ChainID is the Starknet chain ID. +### FeederURL + +```toml +FeederURL = 'http://feeder.url' # Example +``` + +FeederURL is required to get tx metadata (that the RPC can't) + ### Enabled ```toml @@ -7658,6 +8033,7 @@ ConfirmationPoll is how often to confirmer checks for tx inclusion on chain. [[Starknet.Nodes]] Name = 'primary' # Example URL = 'http://stark.node' # Example +APIKey = 'key' # Example ``` ### Name @@ -7675,3 +8051,11 @@ URL = 'http://stark.node' # Example ``` URL is the base HTTP(S) endpoint for this node. + +### APIKey + +```toml +APIKey = 'key' # Example +``` + +APIKey Header is optional and only required for Nethermind RPCs