Skip to Content
OperationConfig

OperationConfig

Configuration options used by all operations.

Properties

NameTypeDefault
maxRetries
number
Maximum retry attempts on transient errors.
3
timeoutMs
number
Overall timeout per operation (milliseconds).
60000
confirmationStrategy
'processed' | 'confirmed' | 'finalized'
Confirmation level to wait for.
'confirmed'
priorityFee
number
Additional fee in lamports to prioritize the transaction.
enableLogging
boolean
Enable structured logs for the operation.
true
enableSimulation
boolean
Run a pre-flight simulation before sending.
true
validateBalance
boolean
Check payer balance before executing.
true
logLevel
'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'
Minimum log level.
'info'
enableMetrics
boolean
Collect basic timing metrics.
true
enablePerformanceTracking
boolean
Collect detailed stage timings.
true
customRetryConfig
customRetryConfig
Retry tuning. See details below.
healthCheckTimeout
number
Timeout for connection health checks (ms).
5000
enableCircuitBreaker
boolean
Temporarily halt operations after repeated failures.
true
connectionFeatureCheck
boolean
Probe connection features (e.g., support for versioned tx).
true
computeUnitLimit
number
Optional limit for compute units.
computeUnitPrice
number
Optional price for compute units (micro‑lamports).
enableVersionedTransactions
boolean
Use v0 versioned transactions when appropriate.
true
strictValidation
boolean
Stricter parameter checks with clearer errors.
true
allowUnsafeOperations
boolean
Allow explicitly marked risky flows (not recommended).
false
requireSignatureValidation
boolean
Validate expected signers are present.
false

customRetryConfig

NameTypeDefault
baseDelay
number
Initial delay before first retry (ms).
maxDelay
number
Upper bound for retry delay (ms).
backoffFactor
number
Multiplier applied to delay after each attempt.
jitter
boolean
Randomize delays slightly to reduce thundering herd.
true
Last updated on