ExplorerURL is the websocket URL used by the node to push stats. This variable is reauired to
deliver telemetry.
InsecureFastScrypt
InsecureFastscrypt = talse #Detault
InsecureFastScrypt causes all key stores to encrypt using "fast" scrypt params instead. This is insecure and only useful for local testing. DO NOT ENABLE THIS IN PRODUCTION.
RootDir
RootDir ='~/.bondoracle'# Default
RootDir is the Chain ink node's root directory. This is the default directory for loggina. database
backups. cookies. and other misc Bondoracle node files. Bondoracle nodes will always ensure this
directory has 700 permissions because it might contain sensitive data
ShutdownGracePeriod
ShutdownGracePeriod ='5s'# Default
ShutdownGracePeriod is the maximum time allowed to shut down aracefulv. If exceeded. the
node will terminate immediately to avoid being SIGKILLed
DefaultldlelnTxSessionTimeout is the maximum time allowed for a transaction to be open andidle betore timing out. See Postgres idle in transaction session timeout for more details.
DefaultLockTimeout
DefaultLockTimeout ='15s'# Default
DefaultLockTimeout is the maximum time allowed to wait for
DefaultQueryTimeout
DefaultQueryTimeout ='10s'# Default
DefaultQuery Timeout is the maximum time allowed for standard queries before timing out.
LogQueries
LogQueries =false# Default
LoaQueries tells the Bondoracle node to loa database aueries made usina the default loager. SQLstatements will be loaged at debua level. Not all statements can be loaged. The best way to geta true log of all SQL statements is to enable SQL statement loaging on Postares.
MaxIdleConns
MaxIdleConns =10# Default
MaxldleConns configures the maximum number of idle database connections that the Bondoracle node will keep open. Think of this as the baseline number of database connections per Bondoracle node instance. Increasing this number can help to improve performance under database-heavy workloads.
Postgres has connection limits, so you must use caution when increasing this value. If you are running several instances of a Bondoracle node or another application on a single database server, you might run out of Postgres connection slots if you raise this value too high.
MaxOpenConns
MaxOpenConns =20# Default
MaxOpenConns configures the maximum number of database connections that a Bondoracle node will have open at any one time. Think of this as the maximum burst upper bound limit of database connections per Bondoracle node instance. Increasing this number can help to improve performance under database-heavy workloads.
Postgres has connection limits, so you must use caution when increasing this value. If you are running several instances of a Bondoracle node or another application on a single database server, you might run out of Postgres connection slots if you raise this value too high.
MigrateOnStartup
MigrateOnStartup =true# Default
MigrateOnStartup controls whether a Bondoracle node will attempt to automatically migrate the database on boot. If you want more control over your database migration process, set this variable to false and manually migrate the database using the CLI migrate command instead.
As a best practice, take regular database backups in case of accidental data loss. This best practice is especially important when you upgrade your Bondoracle node to a new version.
Bondoracle nodes support automated database backups to make this process easier.
NOTE: Dumps can cause high load and massive database latencies, which will negatively impact the normal functioning of the Bondoracle node. For this reason, it is recommended to set a URL and point it to a read replica if you enable automatic backups.
Mode
Mode ='none'# Default
Mode sets the type of automatic database backup, which can be one of none, lite, or full. If enabled, the Bondoracle node will always dump a backup on every boot before running migrations. Additionally, it will automatically take database backups that overwrite the backup file for the given version at regular intervals if Frequency is set to a non-zero interval.
none - Disables backups. lite - Dumps small tables including configuration and keys that are essential for the node to function, which excludes historical data like job runs, transaction history, etc. full - Dumps the entire database.
It will write to a file like 'Dir'/backup/cI backup <VERSION>. dump. There is one backup dump file per version of the Bondoracle node. If you upgrade the node, it will keep the backup taken right before the upgrade migration so you can restore to an older version if necessary.
Dir
Dir ='test/backup/dir'# Example
Dir sets the directory to use for saving the backup file. Use this if you want to save the backup file in a directory other than the default ROOT directory.
OnVersionUpgrade
On VersionUpgrade =true# Default
OnVersionUpgrade enables automatic backups of the database before running migrations, when you are upgrading to a new version.
Frequency
Frequency ='h'# Default
Frequency sets the interval for database dumps, if set to a positive duration and Mode is not
none.
Set to o to disable periodic backups.
Database.Listener
ADVANCED: Do not change these settings unless you know what you are doing.
These settings control the postgres event listener.
MaxReconnectDuration
MaxReconnectDuration ='10m'# Default
MaxReconnectDuration is the maximum duration to wait between reconnect attempts.
MinReconnectInterval
MinReconnectInterval ='1m'# Default
MinReconnectInterval controls the duration to wait before trying to re-establish the database connection after connection loss. After each consecutive failure this interval is doubled, until MaxReconnectInterval is reached. Successfully completing the connection establishment procedure resets the interval back to MinReconnectInterval.
FallbackPollinterval
FallbackPollinterval ='30s'# Default
FallbackPollInterval controls how often clients should manually poll as a fallback in case the postgres event was missed/dropped.
Ideally, you should use a container orchestration system like Kubernetes to ensure that only one Bondoracle node instance can ever use a specific Postgres database. However, some node operators do not have the technical capacity to do this. Common use cases run multiple Bondoracle node instances in failover mode as recommended by our official documentation. The first instance takes a lock on the database and subsequent instances will wait trying to take this lock in case the first instance fails.
If your nodes or applications hold locks open for several hours or days, Postgres is unable to complete internal cleanup tasks. The Postgres maintainers explicitly discourage holding locks open for long periods of time.
Because of the complications with advisory locks, Bondoracle nodes with v2.0 and later only support lease locking mode. The lease locking mode works using the following process:
Node A creates one row in the database with the client ID and updates it once per second.
Node B spinlocks and checks periodically to see if the client ID is too old. If the client ID is not updated after a period of time, node B assumes that node A failed and takes over. Node B becomes the owner of the row and updates the client ID once per second.
If node A comes back, it attempts to take out a lease, realizes that the database has been leased to another process, and exits the entire application immediately.
Enabled
Enabled =true# Default
Enabled enables the database lock.
LeaseDuration
LeaseDuration =40s' # Default
LeaseDuration is how long the lease lock will last before expiring.
LeaseRefreshInterval
LeaseRefreshlnterval =1s'# Default
LeaseRefreshlnterval determines how often to refresh the lease lock, Also controls how often astandby node will check to see if it can grab the lease
UniConn toggles which ws connection style is used.
Logging
Logging =false# Default
Logging toggles verbose logging of the raw telemetry messages being sent
ServerPubKey
ServerPubKey = 'test-pub-key' # Example
ServerPubKey is the public key of the telemetry server.
URL
URL = https://prom.test' # Example
BufferSize
BufferSize = 100 # Default
BufferSize is the number of telemetry messages to buffer before dropping new ones.
MaxBatchSize
MaxBatchSize = 50 # Default
MaxBatchSize is the maximum number of messages to batch into one telemetry request.
SendInterval
SendInterval = '500ms' # Default
SendInterval determines how often batched telemetry is sent to the ingress server
SendTimeout
SendTimeout = '10s' # Default
Send Timeout is the max duration to wait for the request to complete when sending batch telemetry.
UseBatchSend
UseBatchSend = true # Default
UseBatchSend toggles sending telemetry to the ingress server using the batch client.
AuditLogger
[Audit Logger]
Enabled = false # Default
ForwardToUrl = 'http://localhost:9898' # Example
JsonWrapperKey = 'event' # Example
Headers = [Authorization: token', 'X-SomeOther-Header: value with spaces | and a bar+* # Example
Enabled
Enabled = false # Default
Enabled determines if this logger should be configured at all
ForwardToUrl
ForwardToUrl = 'http://localhost:9898' # Example
Forward ToUrl is where you want to forward logs to
JsonWrapperKey
JsonWrapperKey = 'event' # Example
JsonWrapperKey if set wraps the map of data under another single key to make parsing easier
Headers
Headers = [Authorization: token', “x-SomeOther-Header: value with spaces l and a bar+*]# Examp
Headers is the set of headers you wish to pass along with each request
"warn": A mild error occurred that might require non-urgent action. Check these warnings semi-regularly to see if any of them require attention. These warnings usually happen due to factors outside of the control of the node operator. Examples: Unexpected responses from a remote API or misleading networking errors.
"error": An unexpected error occurred during the regular operation of a well-maintained node. Node operators might need to take action to remedy this error. Check these regularly to see if any of them require attention. Examples: Use of deprecated configuration options or incorrectly configured settings that cause a job to fail.
"crit: A critical error occurred. The node might be unable to function. Node operators should take immediate action to fix these errors. Examples: The node could not boot because a network socket could not be opened or the database became inaccessible.
"panic": An exceptional error occurred that could not be handled. If the node is unresponsive, node operators should try to restart their nodes and notify the Bondoracle team of a potential bug.
"fatal": The node encountered an unrecoverable problem and had to exit.
JSONConsole
JSONConsole = false # Default
JSONConsole enables JSON logging. Otherwise, the log is saved in a human-friendly console format.
UnixTS
UnixTS = false # Default
UnixTS enables legacy unix timestamps.
Previous versions of Bondoracle nodes wrote JSON logs with a unix timestamp. As of v1.1.0 and up, the default has changed to use ISO8601 timestamps for better readability.
Dir sets the log directory. By default, Bondoracle nodes write log data to $ROOT/log.jsonl.
MaxSize
MaxSize = '5120mb' # Default
MaxSize determines the log file's max size in megabytes before file rotation. Having this not set will disable logging to disk. If your disk doesn't have enough disk space, the logging will pause and the application will log errors until space is available again.
Values must have suffixes with a unit like: 5120mb (5,120 megabytes). If no unit suffix is provided, the value defaults to b (bytes). The list of valid unit suffixes are:
b (bytes)
kb (kilobytes)
mb (megabytes)
gb (gigabytes)
tb (terabytes)
MaxAgeDays
MaxAgeDays = 0 # Default
MaxAgeDays determines the log file's max age in days before file rotation. Keeping this config with the default value will not remove log files based on age.
MaxBackups
MaxBackups = 1 # Default
MaxBackups determines the maximum number of old log files to retain. Keeping this config with the default value retains all old log files. The MaxAgeDays variable can still cause them to get deleted.
AllowOrigins controls the URLs Bondoracle nodes emit in the Allow-Origins header of its API responses. The setting can be a comma-separated list with no spaces. You might experience CORS issues if this is not set correctly.
You should set this to the external URL that you use to access the Bondoracle UI.
You can set AllowOrigins = '*' to allow the UI to work from any URL, but it is recommended for security reasons to make it explicit instead.
BridgeCacheTTL
BridgeCacheTTL = '0s' # Default
BridgeCacheTTL controls the cache TTL for all bridge tasks to use old values in newer observations in case of intermittent failure. It's disabled by default.
BridgeResponseURL
BridgeResponseURL = 'https://my-bondoracle-node.example.com:6688' # Example
BridgeResponseURL defines the URL for bridges to send a response to. This must be set when using async external adapters.
Usually this will be the same as the URL/IP and port you use to connect to the Bondoracle UI.
HTTPWriteTimeout
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
HTTPWriteTimeout = '10s' # Default
HTTPWriteTimeout controls how long the Bondoracle node's API server can hold a socket open for writing a response to an HTTP request. Sometimes, this must be increased for pprof.
HTTPPort
HTTPPort = 6688 # Default
HTTPPort is the port used for the Bondoracle Node API, CLI, and GUI.
SecureCookies
SecureCookies = true # Default
SecureCookies requires the use of secure cookies for authentication. Set to false to enable standard HTTP requests along with TLSPort = 0.
SessionTimeout
SessionTimeout = '15m' # Default
SessionTimeout determines the amount of idle time to elapse before session cookies expire. This signs out GUI users from their sessions.
SessionReaperExpiration
SessionReaperExpiration = '240h' # Default
SessionReaperExpiration represents how long an API session lasts before expiring and requiring a new login.
HTTPMaxSize
HTTPMaxSize = '32768b' # Default
HTTPMaxSize defines the maximum size for HTTP requests and responses made by the node server.
StartTimeout
StartTimeout = '15s' # Default
StartTimeout defines the maximum amount of time the node will wait for a server to start.
ListenIP
ListenIP = '0.0.0.0' # Default
ListenIP specifies the IP to bind the HTTP server to
Authenticated defines the threshold to which authenticated requests get limited. More than this many authenticated requests per AuthenticatedRateLimitPeriod will be rejected.
AuthenticatedPeriod
AuthenticatedPeriod = '1m' # Default
AuthenticatedPeriod defines the period to which authenticated requests get limited.
Unauthenticated
Unauthenticated = 5 # Default
Unauthenticated defines the threshold to which authenticated requests get limited. More than this many unauthenticated requests per UnAuthenticatedRateLimitPeriod will be rejected.
UnauthenticatedPeriod
UnauthenticatedPeriod = '20s' # Default
UnauthenticatedPeriod defines the period to which unauthenticated requests get limited.
WebServer.MFA
[WebServer.MFA]
RPID = 'localhost' # Example
RPOrigin = 'http://localhost:6688/' # Example
The Operator UI frontend supports enabling Multi Factor Authentication via Webauthn per account. When enabled, logging in will require the account password and a hardware or OS security key such as Yubikey. To enroll, log in to the operator UI and click the circle purple profile button at the top right and then click Register MFA Token. Tap your hardware security key or use the OS public key management feature to enroll a key. Next time you log in, this key will be required to authenticate.
RPID
RPID = 'localhost' # Example
RPID is the FQDN of where the Operator UI is served. When serving locally, the value should be localhost.
RPOrigin
RPOrigin = 'http://localhost:6688/' # Example
RPOrigin is the origin URL where WebAuthn requests initiate, including scheme and port. When serving locally, the value should be http://localhost:6688/.
The TLS settings apply only if you want to enable TLS security on your Bondoracle node.
CertPath
CertPath = '~/.cl/certs' # Example
CertPath is the location of the TLS certificate file.
Host
Host = 'tls-host' # Example
Host is the hostname configured for TLS to be used by the Bondoracle node. This is useful if you configured a domain name specific for your Bondoracle node.
KeyPath
KeyPath = '/home/$USER/.bondoracle/tls/server.key' # Example
KeyPath is the location of the TLS private key file.
HTTPSPort
HTTPSPort = 6689 # Default
HTTPSPort is the port used for HTTPS connections. Set this to 0 to disable HTTPS. Disabling HTTPS also relieves Bondoracle nodes of the requirement for a TLS certificate.
ForceRedirect
ForceRedirect = false # Default
ForceRedirect forces TLS redirect for unencrypted connections.
ListenIP
ListenIP = '0.0.0.0' # Default
ListenIP specifies the IP to bind the HTTPS server to
ExternalInitiatorsEnabled enables the External Initiator feature. If disabled, webhook jobs can ONLY be initiated by a logged-in user. If enabled, webhook jobs can be initiated by a whitelisted external initiator.
MaxRunDuration
MaxRunDuration = '10m' # Default
MaxRunDuration is the maximum time allowed for a single job run. If it takes longer, it will exit early and be marked errored. If set to zero, disables the time limit completely.
MaxSuccessfulRuns
MaxSuccessfulRuns = 10000 # Default
MaxSuccessfulRuns caps the number of completed successful runs per pipeline spec in the database. You can set it to zero as a performance optimisation; this will avoid saving any successful run.
Note this is not a hard cap, it can drift slightly larger than this but not by more than 5% or so.
ReaperInterval
ReaperInterval = '1h' # Default
ReaperInterval controls how often the job pipeline reaper will run to delete completed jobs older than ReaperThreshold, in order to keep database size manageable.
Set to 0 to disable the periodic reaper.
ReaperThreshold
ReaperThreshold = '24h' # Default
ReaperThreshold determines the age limit for job runs. Completed job runs older than this will be automatically purged from the database.
ResultWriteQueueDepth
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
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.
This section applies only if you are running off-chain reporting jobs.
Enabled
Enabled = false # Default
Enabled enables OCR jobs.
ObservationTimeout
ObservationTimeout = '5s' # Default
ObservationTimeout is the timeout for making observations using the DataSource.Observe method. (This is necessary because an oracle's operations are serialized, so blocking forever on an observation would break the oracle.)
BlockchainTimeout
BlockchainTimeout = '20s' # Default
BlockchainTimeout is the timeout for blockchain queries (mediated through ContractConfigTracker and ContractTransmitter). (This is necessary because an oracle's operations are serialized, so blocking forever on a chain interaction would break the oracle.)
ContractPollInterval
ContractPollInterval = '1m' # Default
ContractPollInterval is the polling interval at which ContractConfigTracker is queried for updated on-chain configurations. Recommended values are between fifteen seconds and two minutes.
ContractSubscribeInterval
ContractSubscribeInterval = '2m' # Default
ContractSubscribeInterval is the interval at which we try to establish a subscription on ContractConfigTracker if one doesn't exist. Recommended values are between two and five minutes.
DefaultTransactionQueueDepth
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
DefaultTransactionQueueDepth = 1 # Default
DefaultTransactionQueueDepth controls the queue size for DropOldestStrategy in OCR. Set to 0 to use SendEvery strategy instead.
KeyBundleID
KeyBundleID = 'acdd42797a8b921b2910497badc5000600000000000000000000000000000000' # Example
KeyBundleID is the default key bundle ID to use for OCR jobs. If you have an OCR job that does not explicitly specify a key bundle ID, it will fall back to this value.
SimulateTransactions
SimulateTransactions = false # Default
SimulateTransactions enables transaction simulation for OCR.
TransmitterAddress
TransmitterAddress = '0xa0788FC17B1dEe36f057c42B6F373A34B014687e' # Example
TransmitterAddress is the default sending address to use for OCR. If you have an OCR job that does not explicitly specify a transmitter address, it will fall back to this value.
CaptureEATelemetry
CaptureEATelemetry = false # Default
CaptureEATelemetry toggles collecting extra information from External Adaptares
P2P supports multiple networking stack versions. You may configure [P2P.V1], [P2P.V2], or both to run simultaneously. If both are configured, then for each link with another peer, V2 networking will be preferred. If V2 does not work, the link will automatically fall back to V1. If V2 starts working again later, it will automatically be preferred again. This is useful for migrating networks without downtime. Note that the two networking stacks must not be configured to bind to the same IP/port.
All nodes in the OCR network should share the same networking stack.
IncomingMessageBufferSize
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
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
PeerID = '12D3KooWMoejJznyDuEk5aX6GvbjaG12UzeornPCBNzMRqdwrFJw' # Example
PeerID is the default peer ID to use for OCR jobs. If unspecified, uses the first available peer ID.
AnnounceIP should be set as the externally reachable IP address of the Bondoracle node.
AnnouncePort
AnnouncePort = 1337 # Example
AnnouncePort should be set as the externally reachable port of the Bondoracle node.
BootstrapCheckInterval
BootstrapCheckInterval = '20s' # Default
BootstrapCheckInterval is the interval at which nodes check connections to bootstrap nodes and reconnect if any of them is lost. Setting this to a small value would allow newly joined bootstrap nodes to get more connectivity more quickly, which helps to make bootstrap process faster. The cost of this operation is relatively cheap. We set this to 1 minute during our test.
DefaultBootstrapPeers
DefaultBootstrapPeers = ['/dns4/example.com/tcp/1337/p2p/12D3KooWMHMRLQkgPbFSYHwD3NBuwtS1AmxhvKVUrcfyaGDASR4U', '/ip4/1.2.3.4/tcp/9999/p2p/12D3KooWLZ9uTC3MrvKfDpGju6RAQubiMDL7CuJcAgDRTYP7fh7R'] # Example
DefaultBootstrapPeers is the default set of bootstrap peers.
DHTAnnouncementCounterUserPrefix
DHTAnnouncementCounterUserPrefix = 0 # Default
DHTAnnouncementCounterUserPrefix can be used to restore the node's ability to announce its IP/port on the P2P network after a database rollback. Make sure to only increase this value, and never decrease it. Don't use this variable unless you really know what you're doing, since you could semi-permanently exclude your node from the P2P network by misconfiguring it.
DHTLookupInterval
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
DHTLookupInterval = 10 # Default
DHTLookupInterval is the interval between which we do the expensive peer lookup using DHT.
Every DHTLookupInterval failures to open a stream to a peer, we will attempt to lookup its IP from DHT
ListenIP
ListenIP = '0.0.0.0' # Default
ListenIP is the default IP address to bind to.
ListenPort
ListenPort = 1337 # Example
ListenPort is the port to listen on. If left blank, the node randomly selects a different port each time it boots. It is highly recommended to set this to a static value to avoid network instability.
NewStreamTimeout
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
NewStreamTimeout = '10s' # Default
NewStreamTimeout is the maximum length of time to wait to open a stream before we give up. We shouldn't hit this in practice since libp2p will give up fast if it can't get a connection, but it is here anyway as a failsafe. Set to 0 to disable any timeout on top of what libp2p gives us by default.
PeerstoreWriteInterval
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
PeerstoreWriteInterval = '5m' # Default
PeerstoreWriteInterval controls how often the peerstore for the OCR V1 networking stack is persisted to the database.
Enabled enables P2P V2. Note: V1.Enabled is true by default, so it must be set false in order to run V2 only.
AnnounceAddresses
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
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
DeltaDial = '15s' # Default
DeltaDial controls how far apart Dial attempts are
DeltaReconcile
DeltaReconcile = '1m' # Default
DeltaReconcile controls how often a Reconcile message is sent to every peer.
ListenAddresses
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.
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
DefaultTransactionQueueDepth = 1 # Default
DefaultTransactionQueueDepth controls the queue size for DropOldestStrategy in Keeper. Set to 0 to use SendEvery strategy instead.
GasPriceBufferPercent
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
GasPriceBufferPercent = 20 # Default
GasPriceBufferPercent specifies the percentage to add to the gas price used for checking whether to perform an upkeep. Only applies in legacy mode (EIP-1559 off).
GasTipCapBufferPercent
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
GasTipCapBufferPercent = 20 # Default
GasTipCapBufferPercent specifies the percentage to add to the gas price used for checking whether to perform an upkeep. Only applies in EIP-1559 mode.
BaseFeeBufferPercent
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
BaseFeeBufferPercent = 20 # Default
BaseFeeBufferPercent specifies the percentage to add to the base fee used for checking whether to perform an upkeep. Applies only in EIP-1559 mode.
MaxGracePeriod
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
MaxGracePeriod = 100 # Default
MaxGracePeriod is the maximum number of blocks that a keeper will wait after performing an upkeep before it resumes checking that upkeep
TurnLookBack
TurnLookBack = 1_000 # Default
TurnLookBack is the number of blocks in the past to look back when getting a block for a turn.
The Bondoracle node is equipped with an internal "nurse" service that can perform automatic pprof profiling when the certain resource thresholds are exceeded, such as memory and goroutine count. These profiles are saved to disk to facilitate fine-grained debugging of performance-related issues. In general, if you notice that your node has begun to accumulate profiles, forward them to the Bondoracle team.
ProfileRoot sets the location on disk where pprof profiles will be stored. Defaults to RootDir.
PollInterval
PollInterval = '10s' # Default
PollInterval is the interval at which the node's resources are checked.
GatherDuration
GatherDuration = '10s' # Default
GatherDuration is the duration for which profiles are gathered when profiling starts.
GatherTraceDuration
GatherTraceDuration = '5s' # Default
GatherTraceDuration is the duration for which traces are gathered when profiling is kicked off. This is separately configurable because traces are significantly larger than other types of profiles.
MaxProfileSize
MaxProfileSize = '100mb' # Default
MaxProfileSize is the maximum amount of disk space that profiles may consume before profiling is disabled.
AutoCreateKey, if set to true, will ensure that there is always at least one transmit key for the given chain.
BlockBackfillDepth
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
BlockBackfillDepth = 10 # Default
BlockBackfillDepth specifies the number of blocks before the current HEAD that the log broadcaster will try to re-consume logs from.
BlockBackfillSkip
BlockBackfillSkip = false # Default
BlockBackfillSkip enables skipping of very long backfills.
ChainType
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
FinalityDepth
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. 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.
Special cases: FinalityDepth=0 would imply that transactions can be final even before they were mined into a block. This is not supported. FinalityDepth=1 implies that transactions are final after we see them in one block.
Examples:
Transaction sending: A transaction is sent at block height 42
FinalityDepth is set to 5 A re-org occurs at height 44 starting at block 41, transaction is marked for rebroadcast A re-org occurs at height 46 starting at block 41, transaction is marked for rebroadcast A re-org occurs at height 47 starting at block 41, transaction is NOT marked for rebroadcast
FinalityTagEnabled
FinalityTagEnabled = false # Default
FinalityTagEnabled means that the chain supports the finalized block tag when querying for a block. If FinalityTagEnabled is set to true for a chain, then FinalityDepth field is ignored. Finality for a block is solely defined by the finality related tags provided by the chain's RPC API. This is a placeholder and hasn't been implemented yet.
FlagsContractAddress
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
FlagsContractAddress = '0xae4E781a6218A8031764928E88d457937A954fC3' # Example
FlagsContractAddress can optionally point to a Flags contract. 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
LinkContractAddress = '0x538aAaB4ea120b2bC2fe5D296852D948F07D849e' # Example
LinkContractAddress is the canonical ERC-677 LINK token contract address on the given chain. Note that this is usually autodetected from chain ID.
LogBackfillBatchSize
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
LogBackfillBatchSize = 1000 # Default
LogBackfillBatchSize sets the batch size for calling FilterLogs when we backfill missing logs.
LogPollInterval
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
LogPollInterval = '15s' # Default
LogPollInterval works in conjunction with Feature.LogPoller. Controls how frequently the log poller polls for logs. Defaults to the block production rate.
LogKeepBlocksDepth
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
LogKeepBlocksDepth = 100000 # Default
LogKeepBlocksDepth works in conjunction with Feature.LogPoller. Controls how many blocks the poller will keep, must be greater than FinalityDepth+1.
MinContractPayment is the minimum payment in LINK required to execute a direct request job. This can be overridden on a per-job basis.
MinIncomingConfirmations
MinIncomingConfirmations = 3 # Default
MinIncomingConfirmations is the minimum required confirmations before a log event will be consumed.
NonceAutoSync
NonceAutoSync = true # Default
NonceAutoSync enables automatic nonce syncing on startup. Bondoracle nodes will automatically try to sync its local nonce with the remote chain on startup and fast forward if necessary. This is almost always safe but can be disabled in exceptional cases by setting this value to false.
NoNewHeadsThreshold
NoNewHeadsThreshold = '3m' # Default
NoNewHeadsThreshold controls how long to wait after receiving no new heads before NodePool marks rpc endpoints as out-of-sync, and HeadTracker logs warnings.
Set to zero to disable out-of-sync checking.
OperatorFactoryAddress
OperatorFactoryAddress = '0xa5B85635Be42F21f94F28034B7DA440EeFF0F418' # Example
OperatorFactoryAddress is the address of the canonical operator forwarder contract on the given chain. Note that this is usually autodetected from chain ID.
RPCDefaultBatchSize
RPCDefaultBatchSize = 250 # Default
RPCDefaultBatchSize is the default batch size for batched RPC calls.
RPCBlockQueryDelay
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
RPCBlockQueryDelay = 1 # Default
RPCBlockQueryDelay controls the number of blocks to trail behind head in the block history estimator and balance monitor. For example, if this is set to 3, and we receive block 10, block history estimator will fetch block 7.
CAUTION: You might be tempted to set this to 0 to use the latest possible block, but it is possible to receive a head BEFORE that block is actually available from the connected node via RPC, due to race conditions in the code of the remote ETH node. In this case you will get false "zero" blocks that are missing transactions.
ForwardersEnabled enables or disables sending transactions through forwarder contracts.
MaxInFlight
MaxInFlight = 16 # Default
MaxInFlight controls how many transactions are allowed to be "in-flight" i.e. broadcast but unconfirmed at any one time. You can consider this a form of transaction throttling.
The default is set conservatively at 16 because this is a pessimistic minimum that both geth and parity will hold without evicting local transactions. If your node is falling behind and you need higher throughput, you can increase this setting, but you MUST make sure that your ETH node is configured properly otherwise you can get nonce gapped and your node will get stuck.
0 value disables the limit. Use with caution.
MaxQueued
MaxQueued = 250 # Default
MaxQueued is the maximum number of unbroadcast transactions per key that are allowed to be enqueued before jobs will start failing and rejecting send of any further transactions. This represents a sanity limit and generally indicates a problem with your ETH node (transactions are not getting mined).
Do NOT blindly increase this value thinking it will fix things if you start hitting this limit because transactions are not getting mined, you will instead only make things worse.
In deployments with very high burst rates, or on chains with large re-orgs, you may consider increasing this.
0 value disables any limit on queue size. Use with caution.
ReaperInterval
ReaperInterval = '1h' # Default
ReaperInterval controls how often the EthTx reaper will run.
ReaperThreshold
ReaperThreshold = '168h' # Default
ReaperThreshold indicates how old an EthTx ought to be before it can be reaped.
ResendAfterThreshold
ResendAfterThreshold = '1m' # Default
ResendAfterThreshold controls how long to wait before re-broadcasting a transaction that has not yet been confirmed.
FixedPrice uses static configured values for gas price (can be set via API call).
BlockHistory dynamically adjusts default gas price based on heuristics from mined blocks.
L2Suggested is a special mode only for use with L2 blockchains. This mode will use the gas price suggested by the rpc endpoint via eth_gasPrice.
Arbitrum is a special mode only for use with Arbitrum blockchains. It uses the suggested gas price (up to ETH_MAX_GAS_PRICE_WEI, with 1000 gwei default) as well as an estimated gas limit (up to ETH_GAS_LIMIT_MAX, with 1,000,000,000 default).
Bondoracle nodes decide what gas price to use using an Estimator. It ships with several simple and battle-hardened built-in estimators that should work well for almost all use-cases. Note that estimators will change their behaviour slightly depending on if you are in EIP-1559 mode or not.
You can also use your own estimator for gas price by selecting the FixedPrice estimator and using the exposed API to set the price.
An important point to note is that the Bondoracle node does not ship with built-in support for go-ethereum's estimateGas call. This is for several reasons, including security and reliability. We have found empirically that it is not generally safe to rely on the remote ETH node's idea of what gas price should be.
PriceDefault
PriceDefault = '20 gwei' # Default
PriceDefault is the default gas price to use when submitting transactions to the blockchain. Will be overridden by the built-in BlockHistoryEstimator if enabled, and might be increased if gas bumping is enabled.
(Only applies to legacy transactions)
Can be used with the bondoracle setgasprice to be updated while the node is still running.
PriceMax is the maximum gas price. Bondoracle nodes will never pay more than this for a transaction. This applies to both legacy and EIP1559 transactions. Note that it is impossible to disable the maximum limit. Setting this value to zero will prevent paying anything for any transaction (which can be useful in some rare cases). Most chains by default have the maximum set to 2**256-1 Wei which is the maximum allowed gas price on EVM-compatible chains, and is so large it may as well be unlimited.
PriceMin
PriceMin = '1 gwei' # Default
PriceMin is the minimum gas price. Bondoracle nodes will never pay less than this for a transaction.
(Only applies to legacy transactions)
It is possible to force the Bondoracle node to use a fixed gas price by setting a combination of these, e.g.
LimitDefault sets default gas limit for outgoing transactions. This should not need to be changed in most cases. Some job types, such as Keeper jobs, might set their own gas limit unrelated to this value.
LimitMax
LimitMax = 500_000 # Default
LimitMax sets a maximum for estimated gas limits. This currently only applies to Arbitrum GasEstimatorMode.
LimitMultiplier
LimitMultiplier = '1.0' # Default
LimitMultiplier is the factor by which a transaction's GasLimit is multiplied before transmission. So if the value is 1.1, and the GasLimit for a transaction is 10, 10% will be added before transmission.
This factor is always applied, so includes L2 transactions which uses a default gas limit of 1 and is also applied to LimitDefault.
LimitTransfer
LimitTransfer = 21_000 # Default
LimitTransfer is the gas limit used for an ordinary ETH transfer.
BumpMin
BumpMin = '5 gwei' # Default
BumpMin is the minimum fixed amount of wei by which gas is bumped on each transaction attempt.
BumpPercent
BumpPercent = 20 # Default
BumpPercent is the percentage by which to bump gas on a transaction that has exceeded BumpThreshold. The larger of GasBumpPercent and GasBumpWei is taken for gas bumps.
BumpThreshold
BumpThreshold = 3 # Default
BumpThreshold is the number of blocks to wait for a transaction stuck in the mempool before automatically bumping the gas price. Set to 0 to disable gas bumping completely.
BumpTxDepth
BumpTxDepth = 16 # Example
BumpTxDepth is the number of transactions to gas bump starting from oldest. Set to 0 for no limit (i.e. bump all). Can not be greater than EVM.Transactions.MaxInFlight. If not set, defaults to EVM.Transactions.MaxInFlight.
EIP1559DynamicFees
EIP1559DynamicFees = false # Default
EIP1559DynamicFees torces EIP-1559 transaction mode. Enabling EIP-1559 mode can help reduce gas costs on chains that support it. This is supported only on official Ethereum mainnet and testnets. It is not recommended to enable this setting on Polygon because the EIP-1559 fee market appears to be broken on all Polygon chains and EIP-1559 transactions are less likely to be included than legacy transactions.
Technical details
Bondoracle nodes include experimental support for submitting transactions using type 0x2 (EIP-1559) envelope.
EIP-1559 mode is enabled by default on the Ethereum Mainnet, but can be enabled on a per-chain basis or globally.
This might help to save gas on spikes. Bondoracle nodes should react faster on the upleg and avoid overpaying on the downleg. It might also be possible to set EVM.GasEstimator.BlockHistory.BatchSize to a smaller value such as 12 or even 6 because tip cap should be a more consistent indicator of inclusion time than total gas price. This would make Bondoracle nodes more responsive and should reduce response time variance. Some experimentation is required to find optimum settings.
Set with caution, if you set this on a chain that does not actually support EIP-1559 your node will be broken.
In EIP-1559 mode, the total price for the transaction is the minimum of base fee + tip cap and fee cap. More information can be found on the official EIP.
Bondoracle's implementation of EIP-1559 works as follows:
If you are using FixedPriceEstimator:
With gas bumping disabled, it will submit all transactions with feecap=PriceMax and tipcap=GasTipCapDefault
With gas bumping enabled, it will submit all transactions initially with feecap=GasFeeCapDefault and tipcap=GasTipCapDefault.
If you are using BlockHistoryEstimator (default for most chains):
With gas bumping disabled, it will submit all transactions with feecap=PriceMax and tipcap=<calculated using past blocks>
With gas bumping enabled (default for most chains) it will submit all transactions initially with feecap = ( current block base fee * (1.125 ^ N) + tipcap ) where N is configurable by setting EVM.GasEstimator.BlockHistory.EIP1559FeeCapBufferBlocks but defaults to gas bump threshold+1 and tipcap=<calculated using past blocks>
A quick note on terminology - Bondoracle nodes use the same terms used internally by go-ethereum source code to describe various prices. This is not the same as the externally used terms. For reference:
Base Fee Per Gas = BaseFeePerGas
Max Fee Per Gas = FeeCap
Max Priority Fee Per Gas = TipCap
In EIP-1559 mode, the following changes occur to how configuration works:
All new transactions will be sent as type 0x2 transactions specifying a TipCap and FeeCap. Be aware that existing pending legacy transactions will continue to be gas bumped in legacy mode.
BlockHistoryEstimator will apply its calculations (gas percentile etc) to the TipCap and this value will be used for new transactions (GasPrice will be ignored)
FixedPriceEstimator will use GasTipCapDefault instead of GasPriceDefault for the tip cap
FixedPriceEstimator will use GasFeeCapDefault instaed of GasPriceDefault for the fee cap
PriceMin is ignored for new transactions and GasTipCapMinimum is used instead (default 0)
PriceMax still represents that absolute upper limit that Bondoracle will ever spend (total) on a single tx
Keeper.GasTipCapBufferPercent is ignored in EIP-1559 mode and Keeper.GasTipCapBufferPercent is used instead
FeeCapDefault
FeeCapDefault = '100 gwei' # Default
FeeCapDefault controls the fixed initial fee cap, if EIP1559 mode is enabled and FixedPrice gas estimator is used.
TipCapDefault
TipCapDefault = '1 wei' # Default
TipCapDefault is the default gas tip to use when submitting transactions to the blockchain. Will be overridden by the built-in BlockHistoryEstimator if enabled, and might be increased if gas bumping is enabled.
(Only applies to EIP-1559 transactions)
TipCapMin
TipCapMin = '1 wei' # Default
TipCapMinimum is the minimum gas tip to use when submitting transactions to the blockchain.
Only applies to EIP-1559 transactions)
EVM.GasEstimator.LimitJobType
[EVM.GasEstimator.LimitJobType]
OCR = 100_000 # Example
OCR2 = 100_000 # Example
DR = 100_000 # Example
VRF = 100_000 # Example
FM = 100_000 # Example
Keeper = 100_000 # Example
OCR
OCR = 100_000 # Example
OCR overrides LimitDefault for OCR jobs.
OCR2
OCR2 = 100_000 # Example
OCR2 overrides LimitDefault for OCR2 jobs.
DR
DR = 100_000 # Example
DR overrides LimitDefault for Direct Request jobs.
These settings allow you to configure how your node calculates gas prices when using the block history estimator. In most cases, leaving these values at their defaults should give good results.
BatchSize
BatchSize = 25 # Default
BatchSize sets the maximum number of blocks to fetch in one batch in the block history estimator. If the BatchSize variable is set to 0, it defaults to EVM.RPCDefaultBatchSize.
BlockHistorySize
BlockHistorySize = 8 # Default
BlockHistorySize controls the number of past blocks to keep in memory to use as a basis for calculating a percentile gas price.
CheckInclusionBlocks
CheckInclusionBlocks = 12 # Default
CheckInclusionBlocks is the number of recent blocks to use to detect if there is a transaction propagation/connectivity issue, and to prevent bumping in these cases. This can help avoid the situation where RPC nodes are not propagating transactions for some non-price-related reason (e.g. go-ethereum bug, networking issue etc) and bumping gas would not help.
Set to zero to disable connectivity checking completely.
CheckInclusionPercentile
CheckInclusionPercentile = 90 # Default
CheckInclusionPercentile controls the percentile that a transaction must have been higher than for all the blocks in the inclusion check window in order to register as a connectivity issue.
For example, if CheckInclusionBlocks=12 and CheckInclusionPercentile=90 then further bumping will be prevented for any transaction with any attempt that has a higher price than the 90th percentile for the most recent 12 blocks.
EIP1559FeeCapBufferBlocks
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
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)
TransactionPercentile
TransactionPercentile = 60 # Default
TransactionPercentile specifies gas price to choose. E.g. if the block history contains four transactions with gas prices [100, 200, 300, 400] then picking 25 for this number will give a value of 200. If the calculated gas price is higher than GasPriceDefault then the higher price will be used as the base price for new transactions.
Must be in range 0-100.
Only has an effect if gas updater is enabled.
Think of this number as an indicator of how aggressive you want your node to price its transactions.
Setting this number higher will cause the Bondoracle node to select higher gas prices.
Setting it lower will tend to set lower gas prices.
The head tracker continually listens for new heads from the chain.
In addition to these settings, it log warnings if EVM.NoNewHeadsThreshold is exceeded without any new blocks being emitted.
HistoryDepth
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. 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+)
MaxBufferSize
MaxBufferSize = 3 # Default
MaxBufferSize is the maximum number of heads that may be buffered in front of the head tracker before older heads start to be dropped. You may think of it as something like the maximum permittable "lag" for the head tracker before we start dropping heads to keep up.
SamplingInterval
⚠️ ADVANCED: Do not change this setting unless you know what you are doing.
SamplingInterval = '1s' # Default
SamplingInterval means that head tracker callbacks will at maximum be made once in every window of this duration. This is a performance optimisation for fast chains. Set to 0 to disable sampling entirely.
EVM.KeySpecific
[[EVM.KeySpecific]]
Key = '0x2a3e23c6f242F5345320814aC8a1b4E58707D292' # Example
GasEstimator.PriceMax = '79 gwei' # Example
Key
Key = '0x2a3e23c6f242F5345320814aC8a1b4E58707D292' # Example
Key is the account to apply these settings to
PriceMax
GasEstimator.PriceMax = '79 gwei' # Example
GasEstimator.PriceMax overrides the maximum gas price for this key. See EVM.GasEstimator.PriceMax.
In addition to these settings, EVM.NoNewHeadsThreshold controls how long to wait after receiving no new heads before marking the node as out-of-sync.
PollFailureThreshold
PollFailureThreshold = 5 # Default
PollFailureThreshold indicates how many consecutive polls must fail in order to mark a node as unreachable.
Set to zero to disable poll checking.
PollInterval
PollInterval = '10s' # Default
PollInterval controls how often to poll the node to check for liveness.
Set to zero to disable poll checking.
SelectionMode
SelectionMode = 'HighestHead' # Default
SelectionMode controls node selection strategy:
HighestHead: use the node with the highest head number
RoundRobin: rotate through nodes, per-request
TotalDifficulty: use the node with the greatest total difficulty
SyncThreshold
SyncThreshold = 5 # Default
SyncThreshold controls how far a node may lag behind the best node before being marked out-of-sync. Depending on SelectionMode, this represents a difference in the number of blocks (HighestHead, RoundRobin, PriorityLevel), or total difficulty (TotalDifficulty).
ContractTransmitterTransmitTimeout sets OCR.ContractTransmitterTransmitTimeout for this EVM chain.
DatabaseTimeout
DatabaseTimeout = '10s' # Default
DatabaseTimeout sets OCR.DatabaseTimeout for this EVM chain.
ObservationGracePeriod
ObservationGracePeriod = '1s' # Default
ObservationGracePeriod sets OCR.ObservationGracePeriod for this EVM chain.
EVM.Nodes
[[EVM.Nodes]]
Name = 'foo' # Example
WSURL = 'wss://web.socket/test' # Example
HTTPURL = 'https://foo.web' # Example
SendOnly = false # Default
Order = 100 # Default
Name
Name = 'foo' # Example
Name is a unique (per-chain) identifier for this node.
WSURL
WSURL = 'wss://web.socket/test' # Example
WSURL is the WS(S) endpoint for this node. Required for primary nodes.
HTTPURL
HTTPURL = 'https://foo.web' # Example
HTTPURL is the HTTP(S) endpoint for this node. Required for all nodes.
SendOnly
SendOnly = false # Default
SendOnly limits usage to sending transaction broadcasts only. With this enabled, only HTTPURL is required, and WSURL is not used.
Order
Order = 100 # Default
Order of the node in the pool, will takes effect if SelectionMode is PriorityLevel or will be used as a tie-breaker for HighestHead and TotalDifficulty
ChainID is the Solana chain ID. Must be one of: mainnet, testnet, devnet, localnet. Mandatory.
Enabled
Enabled = false # Default
Enabled enables this chain.
BalancePollPeriod
BalancePollPeriod = '5s' # Default
BalancePollPeriod is the rate to poll for SOL balance and update Prometheus metrics.
ConfirmPollPeriod
ConfirmPollPeriod = '500ms' # Default
ConfirmPollPeriod is the rate to poll for signature confirmation.
OCR2CachePollPeriod
OCR2CachePollPeriod = '1s' # Default
OCR2CachePollPeriod is the rate to poll for the OCR2 state cache.
OCR2CacheTTL
OCR2CacheTTL = '1m' # Default
OCR2CacheTTL is the stale OCR2 cache deadline.
TxTimeout
TxTimeout = '1m' # Default
TxTimeout is the timeout for sending txes to an RPC endpoint.
TxRetryTimeout
TxRetryTimeout = '10s' # Default
TxRetryTimeout is the duration for tx manager to attempt rebroadcasting to RPC, before giving up.
TxConfirmTimeout
TxConfirmTimeout = '30s' # Default
TxConfirmTimeout is the duration to wait when confirming a tx signature, before discarding as unconfirmed.
SkipPreflight
SkipPreflight = true # Default
SkipPreflight enables or disables preflight checks when sending txs.
Commitment
Commitment = 'confirmed' # Default
Commitment is the confirmation level for solana state and transactions. (documentation)
MaxRetries
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
FeeEstimatorMode = 'fixed' # Default
FeeEstimatorMode is the method used to determine the base fee
ComputeUnitPriceMax
ComputeUnitPriceMax = 1000 # Default
ComputeUnitPriceMax is the maximum price per compute unit that a transaction can be bumped to
ComputeUnitPriceMin
ComputeUnitPriceMin = 0 # Default
ComputeUnitPriceMin is the minimum price per compute unit that transaction can have
ComputeUnitPriceDefault
ComputeUnitPriceDefault = 0 # Default
ComputeUnitPriceDefault is the default price per compute unit price, and the starting base fee when FeeEstimatorMode = 'fixed'
FeeBumpPeriod
FeeBumpPeriod = '3s' # Default
FeeBumpPeriod is the amount of time before a tx is retried with a fee bump
Solana.Nodes
[[Solana.Nodes]]
Name = 'primary' # Example
URL = 'http://solana.web' # Example
Name
Name = 'primary' # Example
Name is a unique (per-chain) identifier for this node.
