Documentation ¶
Index ¶
- Constants
- Variables
- func Batch(chunkSize uint, cb func(offset, limit uint) (uint, error)) error
- func EnvVarName(field string) string
- type Config
- func (c Config) AllowOrigins() string
- func (c Config) BalanceMonitorEnabled() bool
- func (c Config) BlockBackfillDepth() uint64
- func (c Config) BridgeResponseURL() *url.URL
- func (c Config) CertFile() string
- func (c Config) ChainID() *big.Int
- func (c Config) ClientNodeURL() string
- func (c Config) CreateProductionLogger() *logger.Logger
- func (c Config) DatabaseListenerMaxReconnectDuration() time.Duration
- func (c Config) DatabaseListenerMinReconnectInterval() time.Duration
- func (c Config) DatabaseMaximumTxDuration() time.Duration
- func (c Config) DatabaseTimeout() models.Duration
- func (c Config) DatabaseURL() string
- func (c Config) DefaultHTTPAllowUnrestrictedNetworkAccess() bool
- func (c Config) DefaultHTTPLimit() int64
- func (c Config) DefaultHTTPTimeout() models.Duration
- func (c Config) DefaultMaxHTTPAttempts() uint
- func (c Config) Dev() bool
- func (c Config) EnableExperimentalAdapters() bool
- func (c Config) EthBalanceMonitorBlockDelay() uint16
- func (c Config) EthFinalityDepth() uint
- func (c Config) EthGasBumpPercent() uint16
- func (c Config) EthGasBumpThreshold() uint64
- func (c Config) EthGasBumpTxDepth() uint16
- func (c Config) EthGasBumpWei() *big.Int
- func (c Config) EthGasLimitDefault() uint64
- func (c Config) EthGasPriceDefault() *big.Int
- func (c Config) EthHeadTrackerHistoryDepth() uint
- func (c Config) EthHeadTrackerMaxBufferSize() uint
- func (c Config) EthMaxGasPriceWei() *big.Int
- func (c Config) EthereumDisabled() bool
- func (c Config) EthereumSecondaryURL() string
- func (c Config) EthereumURL() string
- func (c Config) ExplorerAccessKey() string
- func (c Config) ExplorerSecret() string
- func (c Config) ExplorerURL() *url.URL
- func (c Config) FeatureExternalInitiators() bool
- func (c Config) FeatureFluxMonitor() bool
- func (c Config) FeatureOffchainReporting() bool
- func (c Config) FlagsContractAddress() string
- func (c Config) GasUpdaterBlockDelay() uint16
- func (c Config) GasUpdaterBlockHistorySize() uint16
- func (c Config) GasUpdaterEnabled() bool
- func (c Config) GasUpdaterTransactionPercentile() uint16
- func (c Config) GetAdvisoryLockIDConfiguredOrDefault() int64
- func (c Config) GetDatabaseDialectConfiguredOrDefault() DialectName
- func (c Config) InsecureFastScrypt() bool
- func (c Config) JSONConsole() bool
- func (c Config) JobPipelineDBPollInterval() time.Duration
- func (c Config) JobPipelineMaxTaskDuration() time.Duration
- func (c Config) JobPipelineParallelism() uint8
- func (c Config) JobPipelineReaperInterval() time.Duration
- func (c Config) JobPipelineReaperThreshold() time.Duration
- func (c Config) KeyFile() string
- func (c Config) KeysDir() string
- func (c Config) LinkContractAddress() string
- func (c Config) LogLevel() LogLevel
- func (c Config) LogSQLMigrations() bool
- func (c Config) LogSQLStatements() bool
- func (c Config) LogToDisk() bool
- func (c Config) MaximumServiceDuration() models.Duration
- func (c Config) MigrateDatabase() bool
- func (c Config) MinIncomingConfirmations() uint32
- func (c Config) MinRequiredOutgoingConfirmations() uint64
- func (c Config) MinimumContractPayment() *assets.Link
- func (c Config) MinimumRequestExpiration() uint64
- func (c Config) MinimumServiceDuration() models.Duration
- func (c Config) OCRBootstrapCheckInterval() time.Duration
- func (c Config) OCRContractTransmitterTransmitTimeout() time.Duration
- func (c Config) OCRDHTLookupInterval() int
- func (c Config) OCRDatabaseTimeout() time.Duration
- func (c Config) OCRIncomingMessageBufferSize() int
- func (c Config) OCRNewStreamTimeout() time.Duration
- func (c Config) OCROutgoingMessageBufferSize() int
- func (c Config) OCRTraceLogging() bool
- func (c Config) OperatorContractAddress() common.Address
- func (c Config) P2PAnnounceIP() net.IP
- func (c Config) P2PAnnouncePort() uint16
- func (c Config) P2PListenIP() net.IP
- func (c Config) P2PListenPort() uint16
- func (c Config) Port() uint16
- func (c Config) ReaperExpiration() models.Duration
- func (c Config) ReplayFromBlock() int64
- func (c Config) RootDir() string
- func (c Config) SecureCookies() bool
- func (c Config) SessionOptions() sessions.Options
- func (c Config) SessionSecret() ([]byte, error)
- func (c Config) SessionTimeout() models.Duration
- func (c Config) Set(name string, value interface{})
- func (c Config) SetEthGasPriceDefault(value *big.Int) error
- func (c *Config) SetRuntimeStore(orm *ORM)
- func (c Config) TLSCertPath() string
- func (c Config) TLSHost() string
- func (c Config) TLSKeyPath() string
- func (c Config) TLSPort() uint16
- func (c Config) TLSRedirect() bool
- func (c Config) TxAttemptLimit() uint16
- func (c *Config) Validate() error
- type ConfigReader
- type ConfigSchema
- type Connection
- type DialectName
- type LockingStrategy
- type LogLevel
- type ORM
- func (orm *ORM) AllKeys() ([]models.Key, error)
- func (orm *ORM) AllSyncEvents(cb func(models.SyncEvent) error) error
- func (orm *ORM) AnyJobWithType(taskTypeName string) (bool, error)
- func (orm *ORM) ArchiveEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
- func (orm *ORM) ArchiveJob(ID *models.ID) error
- func (orm *ORM) ArchiveKey(address []byte) error
- func (orm *ORM) AuthorizedUserWithSession(sessionID string, sessionDuration time.Duration) (models.User, error)
- func (orm *ORM) BridgeTypes(offset int, limit int) ([]models.BridgeType, int, error)
- func (orm *ORM) BulkDeleteRuns(bulkQuery *models.BulkDeleteRunRequest) error
- func (orm *ORM) Chain(hash common.Hash, lookback uint) (models.Head, error)
- func (orm *ORM) ClearNonCurrentSessions(sessionID string) error
- func (orm *ORM) ClearSessions() error
- func (orm *ORM) ClobberDiskKeyStoreWithDBKeys(keysDir string) error
- func (orm *ORM) Close() error
- func (orm *ORM) CountOf(t interface{}) (int, error)
- func (orm *ORM) CreateBridgeType(bt *models.BridgeType) error
- func (orm *ORM) CreateExternalInitiator(externalInitiator *models.ExternalInitiator) error
- func (orm *ORM) CreateInitiator(initr *models.Initiator) error
- func (orm *ORM) CreateJob(job *models.JobSpec) error
- func (orm *ORM) CreateJobRun(run *models.JobRun) error
- func (orm *ORM) CreateKeyIfNotExists(k models.Key) error
- func (orm *ORM) CreateServiceAgreement(sa *models.ServiceAgreement) error
- func (orm *ORM) CreateSession(sr models.SessionRequest) (string, error)
- func (orm *ORM) DeleteBridgeType(bt *models.BridgeType) error
- func (orm *ORM) DeleteEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
- func (orm *ORM) DeleteExternalInitiator(name string) error
- func (orm *ORM) DeleteFluxMonitorRoundsBackThrough(aggregator common.Address, roundID uint32) error
- func (orm *ORM) DeleteJobSpecError(ID int64) error
- func (orm *ORM) DeleteKey(address []byte) error
- func (orm *ORM) DeleteStaleSessions(before time.Time) error
- func (orm *ORM) DeleteUser() (models.User, error)
- func (orm *ORM) DeleteUserSession(sessionID string) error
- func (orm *ORM) EthTransactionsWithAttempts(offset, limit int) ([]models.EthTx, int, error)
- func (orm *ORM) EthTxAttempts(offset, limit int) ([]models.EthTxAttempt, int, error)
- func (orm *ORM) FindBridge(name models.TaskType) (models.BridgeType, error)
- func (orm *ORM) FindBridgesByNames(names []string) ([]models.BridgeType, error)
- func (orm *ORM) FindEncryptedSecretVRFKeys(where ...vrfkey.EncryptedVRFKey) (retrieved []*vrfkey.EncryptedVRFKey, err error)
- func (orm *ORM) FindEthTaskRunTxByTaskRunID(taskRunID uuid.UUID) (*models.EthTaskRunTx, error)
- func (orm *ORM) FindEthTxAttempt(hash common.Hash) (*models.EthTxAttempt, error)
- func (orm *ORM) FindEthTxWithAttempts(etxID int64) (models.EthTx, error)
- func (orm *ORM) FindExternalInitiator(eia *auth.Token) (*models.ExternalInitiator, error)
- func (orm *ORM) FindExternalInitiatorByName(iname string) (models.ExternalInitiator, error)
- func (orm *ORM) FindInitiator(ID int64) (models.Initiator, error)
- func (orm *ORM) FindJob(id *models.ID) (models.JobSpec, error)
- func (orm *ORM) FindJobRun(id *models.ID) (models.JobRun, error)
- func (orm *ORM) FindJobSpecError(jobID *models.ID, description string) (*models.JobSpecError, error)
- func (orm *ORM) FindJobWithErrors(id *models.ID) (models.JobSpec, error)
- func (orm *ORM) FindOffChainReportingJob(id int32) (models.JobSpecV2, error)
- func (orm *ORM) FindOrCreateFluxMonitorRoundStats(aggregator common.Address, roundID uint32) (models.FluxMonitorRoundStats, error)
- func (orm *ORM) FindServiceAgreement(id string) (models.ServiceAgreement, error)
- func (orm *ORM) FindUser() (models.User, error)
- func (orm *ORM) FirstOrCreateEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
- func (orm *ORM) GetConfigValue(field string, value encoding.TextUnmarshaler) error
- func (orm *ORM) GetLastNonce(address common.Address) (uint64, error)
- func (orm *ORM) GetRoundRobinAddress(addresses ...common.Address) (address common.Address, err error)
- func (orm *ORM) HasConsumedLog(blockHash common.Hash, logIndex uint, jobID *models.ID) (bool, error)
- func (orm *ORM) HasConsumedLogV2(blockHash common.Hash, logIndex uint, jobID int32) (bool, error)
- func (orm *ORM) HeadByHash(hash common.Hash) (*models.Head, error)
- func (orm *ORM) IdempotentInsertEthTaskRunTx(taskRunID models.ID, fromAddress common.Address, toAddress common.Address, ...) error
- func (orm *ORM) IdempotentInsertHead(h models.Head) error
- func (orm *ORM) JobRunsCountFor(jobSpecID *models.ID) (int, error)
- func (orm *ORM) JobRunsFor(jobSpecID *models.ID, limit ...int) ([]models.JobRun, error)
- func (orm *ORM) JobRunsSorted(sort SortType, offset int, limit int) ([]models.JobRun, int, error)
- func (orm *ORM) JobRunsSortedFor(id *models.ID, order SortType, offset int, limit int) ([]models.JobRun, int, error)
- func (orm *ORM) Jobs(cb func(*models.JobSpec) bool, initrTypes ...string) error
- func (orm *ORM) JobsSorted(sort SortType, offset int, limit int) ([]models.JobSpec, int, error)
- func (orm *ORM) KeyByAddress(address common.Address) (models.Key, error)
- func (orm *ORM) KeyExists(address []byte) (bool, error)
- func (orm *ORM) LastHead() (*models.Head, error)
- func (orm *ORM) LinkEarnedFor(spec *models.JobSpec) (*assets.Link, error)
- func (orm *ORM) MarkLogConsumed(blockHash common.Hash, logIndex uint, jobID *models.ID, blockNumber uint64) error
- func (orm *ORM) MarkLogConsumedV2(blockHash common.Hash, logIndex uint, jobID int32, blockNumber uint64) error
- func (orm *ORM) MarkRan(i models.Initiator, ran bool) error
- func (orm *ORM) MostRecentFluxMonitorRoundID(aggregator common.Address) (uint32, error)
- func (orm *ORM) MustEnsureAdvisoryLock()
- func (orm *ORM) OffChainReportingJobRuns(jobID int32, offset, size int) ([]pipeline.Run, int, error)
- func (orm *ORM) OffChainReportingJobs() ([]models.JobSpecV2, error)
- func (orm *ORM) PendingBridgeType(jr models.JobRun) (models.BridgeType, error)
- func (orm *ORM) RawDB(fn func(*gorm.DB) error) error
- func (orm *ORM) RemoveUnstartedTransactions() error
- func (orm *ORM) SaveJobRun(run *models.JobRun) error
- func (orm *ORM) SaveSession(session *models.Session) error
- func (orm *ORM) SaveUser(user *models.User) error
- func (orm *ORM) SendKeys() ([]models.Key, error)
- func (orm *ORM) Sessions(offset, limit int) ([]models.Session, error)
- func (orm *ORM) SetConfigValue(field string, value encoding.TextMarshaler) error
- func (orm *ORM) SetLogging(enabled bool)
- func (orm *ORM) Transaction(fc func(tx *gorm.DB) error) (err error)
- func (orm *ORM) TrimOldHeads(n uint) (err error)
- func (orm *ORM) Unscoped() *ORM
- func (orm *ORM) UnscopedJobRunsWithStatus(cb func(*models.JobRun), statuses ...models.RunStatus) error
- func (orm *ORM) UpdateBridgeType(bt *models.BridgeType, btr *models.BridgeTypeRequest) error
- func (orm *ORM) UpdateFluxMonitorRoundStats(aggregator common.Address, roundID uint32, jobRunID *models.ID) error
- func (orm *ORM) UpsertErrorFor(jobID *models.ID, description string)
- type PostgresLockingStrategy
- type SecretGenerator
- type SortType
Constants ¶
const BatchSize = 100
BatchSize is the safe number of records to cache during Batch calls for SQLite without causing load problems. NOTE: Now we no longer support SQLite, perhaps this can be tuned?
Variables ¶
var ( // ErrorNotFound is returned when finding a single value fails. ErrorNotFound = gorm.ErrRecordNotFound // ErrNoAdvisoryLock is returned when an advisory lock can't be acquired. ErrNoAdvisoryLock = errors.New("can't acquire advisory lock") // ErrReleaseLockFailed is returned when releasing the advisory lock fails. ErrReleaseLockFailed = errors.New("advisory lock release failed") // ErrOptimisticUpdateConflict is returned when a record update failed // because another update occurred while the model was in memory and the // differences must be reconciled. ErrOptimisticUpdateConflict = errors.New("conflict while updating record") )
Functions ¶
func EnvVarName ¶
EnvVarName gets the environment variable name for a config schema field
Types ¶
type Config ¶
type Config struct { SecretGenerator SecretGenerator Dialect DialectName AdvisoryLockID int64 // contains filtered or unexported fields }
Config holds parameters used by the application which can be overridden by setting environment variables.
If you add an entry here which does not contain sensitive information, you should also update presenters.ConfigWhitelist and cmd_test.TestClient_RunNodeShowsEnv.
func NewConfig ¶
func NewConfig() *Config
NewConfig returns the config with the environment variables set to their respective fields, or their defaults if environment variables are not set.
func (Config) AllowOrigins ¶
AllowOrigins returns the CORS hosts used by the frontend.
func (Config) BalanceMonitorEnabled ¶
BalanceMonitorEnabled enables the balance monitor
func (Config) BlockBackfillDepth ¶
BlockBackfillDepth specifies the number of blocks before the current HEAD that the log broadcaster will try to re-consume logs from
func (Config) BridgeResponseURL ¶
BridgeResponseURL represents the URL for bridges to send a response to.
func (Config) ClientNodeURL ¶
ClientNodeURL is the URL of the Ethereum node this Chainlink node should connect to.
func (Config) CreateProductionLogger ¶
CreateProductionLogger returns a custom logger for the config's root directory and LogLevel, with pretty printing for stdout. If LOG_TO_DISK is false, the logger will only log to stdout.
func (Config) DatabaseListenerMaxReconnectDuration ¶
func (Config) DatabaseListenerMinReconnectInterval ¶
func (Config) DatabaseMaximumTxDuration ¶
func (Config) DatabaseTimeout ¶
DatabaseTimeout represents how long to tolerate non response from the DB.
func (Config) DatabaseURL ¶
DatabaseURL configures the URL for chainlink to connect to. This must be a properly formatted URL, with a valid scheme (postgres://)
func (Config) DefaultHTTPAllowUnrestrictedNetworkAccess ¶
DefaultHTTPAllowUnrestrictedNetworkAccess controls whether http requests are unrestricted by default It is recommended that this be left disabled
func (Config) DefaultHTTPLimit ¶
DefaultHTTPLimit defines the size limit for HTTP requests and responses
func (Config) DefaultHTTPTimeout ¶
DefaultHTTPTimeout defines the default timeout for http requests
func (Config) DefaultMaxHTTPAttempts ¶
DefaultMaxHTTPAttempts defines the limit for HTTP requests.
func (Config) EnableExperimentalAdapters ¶
EnableExperimentalAdapters enables support for experimental adapters
func (Config) EthBalanceMonitorBlockDelay ¶
EthBalanceMonitorBlockDelay is the number of blocks that the balance monitor trails behind head. This is required e.g. for Infura because they will often announce a new head, then route a request to a different node which does not have this head yet.
func (Config) EthFinalityDepth ¶
EthFinalityDepth is the number of blocks after which an ethereum transaction is considered "final" 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.
func (Config) EthGasBumpPercent ¶
EthGasBumpPercent is the minimum percentage by which gas is bumped on each transaction attempt Change with care since values below geth's default will fail with "underpriced replacement transaction"
func (Config) EthGasBumpThreshold ¶
EthGasBumpThreshold is the number of blocks to wait for confirmations before bumping gas again
func (Config) EthGasBumpTxDepth ¶
EthGasBumpTxDepth is the number of transactions to gas bump starting from oldest. Set to 0 for no limit (i.e. bump all)
func (Config) EthGasBumpWei ¶
EthGasBumpWei is the minimum fixed amount of wei by which gas is bumped on each transaction attempt
func (Config) EthGasLimitDefault ¶
EthGasLimitDefault sets the default gas limit for outgoing transactions.
func (Config) EthGasPriceDefault ¶
EthGasPriceDefault is the starting gas price for every transaction
func (Config) EthHeadTrackerHistoryDepth ¶
EthHeadTrackerHistoryDepth is the number of heads to keep in the `heads` database table. This number should be at least as large as `EthFinalityDepth`. There may be a small performance penalty to setting this to something very large (10,000+)
func (Config) EthHeadTrackerMaxBufferSize ¶
EthHeadTrackerMaxBufferSize 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.
func (Config) EthMaxGasPriceWei ¶
EthMaxGasPriceWei is the maximum amount in Wei that a transaction will be bumped to before abandoning it and marking it as errored.
func (Config) EthereumDisabled ¶
EthereumDisabled shows whether Ethereum interactions are supported.
func (Config) EthereumSecondaryURL ¶
EthereumSecondaryURL is an optional backup RPC URL Must be http(s) format If specified, transactions will also be broadcast to this ethereum node
func (Config) EthereumURL ¶
EthereumURL represents the URL of the Ethereum node to connect Chainlink to.
func (Config) ExplorerAccessKey ¶
ExplorerAccessKey returns the access key for authenticating with explorer
func (Config) ExplorerSecret ¶
ExplorerSecret returns the secret for authenticating with explorer
func (Config) ExplorerURL ¶
ExplorerURL returns the websocket URL for this node to push stats to, or nil.
func (Config) FeatureExternalInitiators ¶
FeatureExternalInitiators enables the External Initiator feature.
func (Config) FeatureFluxMonitor ¶
FeatureFluxMonitor enables the Flux Monitor feature.
func (Config) FeatureOffchainReporting ¶
FeatureOffchainReporting enables the Flux Monitor feature.
func (Config) FlagsContractAddress ¶
FlagsContractAddress represents the Flags contract address
func (Config) GasUpdaterBlockDelay ¶
GasUpdaterBlockDelay is the number of blocks that the gas updater trails behind head. E.g. if this is set to 3, and we receive block 10, gas updater 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. In this case you will get false "zero" blocks that are missing transactions.
func (Config) GasUpdaterBlockHistorySize ¶
GasUpdaterBlockHistorySize is the number of past blocks to keep in memory to use as a basis for calculating a percentile gas price
func (Config) GasUpdaterEnabled ¶
GasUpdaterEnabled turns on the automatic gas updater if set to true It is disabled by default
func (Config) GasUpdaterTransactionPercentile ¶
GasUpdaterTransactionPercentile is the percentile gas price to choose. E.g. if the past transaction history contains four transactions with gas prices: [100, 200, 300, 400], picking 25 for this number will give a value of 200
func (Config) GetAdvisoryLockIDConfiguredOrDefault ¶
func (Config) GetDatabaseDialectConfiguredOrDefault ¶
func (c Config) GetDatabaseDialectConfiguredOrDefault() DialectName
func (Config) InsecureFastScrypt ¶
InsecureFastScrypt causes all key stores to encrypt using "fast" scrypt params instead This is insecure and only useful for local testing. DO NOT SET THIS IN PRODUCTION
func (Config) JSONConsole ¶
JSONConsole enables the JSON console.
func (Config) JobPipelineDBPollInterval ¶
func (Config) JobPipelineMaxTaskDuration ¶
func (Config) JobPipelineParallelism ¶
JobPipelineParallelism controls how many workers the pipeline.Runner uses in parallel
func (Config) JobPipelineReaperInterval ¶
func (Config) JobPipelineReaperThreshold ¶
func (Config) LinkContractAddress ¶
LinkContractAddress represents the address
func (Config) LogSQLMigrations ¶
LogSQLMigrations tells chainlink to log all SQL migrations made using the default logger
func (Config) LogSQLStatements ¶
LogSQLStatements tells chainlink to log all SQL statements made using the default logger
func (Config) MaximumServiceDuration ¶
MaximumServiceDuration is the maximum time that a service agreement can run from after the time it is created. Default 1 year = 365 * 24h = 8760h
func (Config) MigrateDatabase ¶
MigrateDatabase determines whether the database will be automatically migrated on application startup if set to true
func (Config) MinIncomingConfirmations ¶
MinIncomingConfirmations represents the minimum number of block confirmations that need to be recorded since a job run started before a task can proceed.
func (Config) MinRequiredOutgoingConfirmations ¶
MinRequiredOutgoingConfirmations represents the default minimum number of block confirmations that need to be recorded on an outgoing ethtx task before the run can move onto the next task. This can be overridden on a per-task basis by setting the `MinRequiredOutgoingConfirmations` parameter.
func (Config) MinimumContractPayment ¶
MinimumContractPayment represents the minimum amount of LINK that must be supplied for a contract to be considered.
func (Config) MinimumRequestExpiration ¶
MinimumRequestExpiration is the minimum allowed request expiration for a Service Agreement.
func (Config) MinimumServiceDuration ¶
MinimumServiceDuration is the shortest duration from now that a service is allowed to run.
func (Config) OCRBootstrapCheckInterval ¶
FIXME: Add comments to all of these
func (Config) OCRContractTransmitterTransmitTimeout ¶
func (Config) OCRDHTLookupInterval ¶
func (Config) OCRDatabaseTimeout ¶
func (Config) OCRIncomingMessageBufferSize ¶
func (Config) OCRNewStreamTimeout ¶
func (Config) OCROutgoingMessageBufferSize ¶
func (Config) OCRTraceLogging ¶
OCRTraceLogging determines whether OCR logs at TRACE level are enabled. The option to turn them off is given because they can be very verbose
func (Config) OperatorContractAddress ¶
OperatorContractAddress represents the address where the Operator.sol contract is deployed, this is used for filtering RunLog requests
func (Config) P2PAnnounceIP ¶
P2PAnnounceIP is an optional override. If specified it will force the p2p layer to announce this IP as the externally reachable one to the DHT If this is set, P2PAnnouncePort MUST also be set.
func (Config) P2PAnnouncePort ¶
P2PAnnouncePort is an optional override. If specified it will force the p2p layer to announce this port as the externally reachable one to the DHT. If this is set, P2PAnnounceIP MUST also be set.
func (Config) P2PListenIP ¶
P2PListenIP is the ip that libp2p willl bind to and listen on
func (Config) P2PListenPort ¶
P2PListenPort is the port that libp2p willl bind to and listen on
func (Config) ReaperExpiration ¶
ReaperExpiration represents
func (Config) ReplayFromBlock ¶
func (Config) RootDir ¶
RootDir represents the location on the file system where Chainlink should keep its files.
func (Config) SecureCookies ¶
SecureCookies allows toggling of the secure cookies HTTP flag
func (Config) SessionOptions ¶
SessionOptions returns the sesssions.Options struct used to configure the session store.
func (Config) SessionSecret ¶
SessionSecret returns a sequence of bytes to be used as a private key for session signing or encryption.
func (Config) SessionTimeout ¶
SessionTimeout is the maximum duration that a user session can persist without any activity.
func (Config) SetEthGasPriceDefault ¶
SetEthGasPriceDefault saves a runtime value for the default gas price for transactions
func (*Config) SetRuntimeStore ¶
SetRuntimeStore tells the configuration system to use a store for retrieving configuration variables that can be configured at runtime.
func (Config) TLSCertPath ¶
TLSCertPath represents the file system location of the TLS certificate Chainlink should use for HTTPS.
func (Config) TLSHost ¶
TLSHost represents the hostname to use for TLS clients. This should match the TLS certificate.
func (Config) TLSKeyPath ¶
TLSKeyPath represents the file system location of the TLS key Chainlink should use for HTTPS.
func (Config) TLSPort ¶
TLSPort represents the port Chainlink should listen on for encrypted client requests.
func (Config) TLSRedirect ¶
TLSRedirect forces TLS redirect for unencrypted connections
func (Config) TxAttemptLimit ¶
TxAttemptLimit is the maximum number of transaction attempts (gas bumps) that will occur before giving a transaction up as errored NOTE: That initial transactions are retried forever until they succeed
type ConfigReader ¶
type ConfigReader interface { AllowOrigins() string BlockBackfillDepth() uint64 BridgeResponseURL() *url.URL ChainID() *big.Int ClientNodeURL() string DatabaseTimeout() models.Duration DatabaseURL() string DatabaseMaximumTxDuration() time.Duration DefaultMaxHTTPAttempts() uint DefaultHTTPLimit() int64 DefaultHTTPTimeout() models.Duration DefaultHTTPAllowUnrestrictedNetworkAccess() bool Dev() bool FeatureExternalInitiators() bool FeatureFluxMonitor() bool FeatureOffchainReporting() bool MaximumServiceDuration() models.Duration MinimumServiceDuration() models.Duration EnableExperimentalAdapters() bool EthBalanceMonitorBlockDelay() uint16 EthGasBumpPercent() uint16 EthGasBumpThreshold() uint64 EthGasBumpTxDepth() uint16 EthGasBumpWei() *big.Int EthGasLimitDefault() uint64 EthGasPriceDefault() *big.Int EthMaxGasPriceWei() *big.Int EthFinalityDepth() uint EthHeadTrackerHistoryDepth() uint EthHeadTrackerMaxBufferSize() uint SetEthGasPriceDefault(value *big.Int) error EthereumURL() string EthereumSecondaryURL() string GasUpdaterBlockDelay() uint16 GasUpdaterBlockHistorySize() uint16 GasUpdaterTransactionPercentile() uint16 JSONConsole() bool LinkContractAddress() string ExplorerURL() *url.URL ExplorerAccessKey() string ExplorerSecret() string OperatorContractAddress() common.Address LogLevel() LogLevel LogToDisk() bool LogSQLStatements() bool MinIncomingConfirmations() uint32 MinRequiredOutgoingConfirmations() uint64 MinimumContractPayment() *assets.Link MinimumRequestExpiration() uint64 MigrateDatabase() bool OCRTraceLogging() bool Port() uint16 ReaperExpiration() models.Duration RootDir() string SecureCookies() bool SessionTimeout() models.Duration TLSCertPath() string TLSHost() string TLSKeyPath() string TLSPort() uint16 TLSRedirect() bool TxAttemptLimit() uint16 KeysDir() string KeyFile() string CertFile() string CreateProductionLogger() *logger.Logger SessionSecret() ([]byte, error) SessionOptions() sessions.Options // contains filtered or unexported methods }
ConfigReader represents just the read side of the config
type ConfigSchema ¶
type ConfigSchema struct { AllowOrigins string `env:"ALLOW_ORIGINS" default:"http://localhost:3000,http://localhost:6688"` BalanceMonitorEnabled bool `env:"BALANCE_MONITOR_ENABLED" default:"true"` BlockBackfillDepth string `env:"BLOCK_BACKFILL_DEPTH" default:"10"` BridgeResponseURL url.URL `env:"BRIDGE_RESPONSE_URL"` ChainID big.Int `env:"ETH_CHAIN_ID" default:"1"` ClientNodeURL string `env:"CLIENT_NODE_URL" default:"http://localhost:6688"` DatabaseTimeout models.Duration `env:"DATABASE_TIMEOUT" default:"500ms"` DatabaseURL string `env:"DATABASE_URL"` DatabaseListenerMinReconnectInterval time.Duration `env:"DATABASE_LISTENER_MIN_RECONNECT_INTERVAL" default:"1m"` DatabaseListenerMaxReconnectDuration time.Duration `env:"DATABASE_LISTENER_MAX_RECONNECT_DURATION" default:"10m"` DatabaseMaximumTxDuration time.Duration `env:"DATABASE_MAXIMUM_TX_DURATION" default:"30m"` DefaultHTTPLimit int64 `env:"DEFAULT_HTTP_LIMIT" default:"32768"` DefaultHTTPTimeout models.Duration `env:"DEFAULT_HTTP_TIMEOUT" default:"15s"` DefaultHTTPAllowUnrestrictedNetworkAccess bool `env:"DEFAULT_HTTP_ALLOW_UNRESTRICTED_NETWORK_ACCESS" default:"false"` Dev bool `env:"CHAINLINK_DEV" default:"false"` EnableExperimentalAdapters bool `env:"ENABLE_EXPERIMENTAL_ADAPTERS" default:"false"` FeatureExternalInitiators bool `env:"FEATURE_EXTERNAL_INITIATORS" default:"false"` FeatureFluxMonitor bool `env:"FEATURE_FLUX_MONITOR" default:"true"` FeatureOffchainReporting bool `env:"FEATURE_OFFCHAIN_REPORTING" default:"false"` MaximumServiceDuration models.Duration `env:"MAXIMUM_SERVICE_DURATION" default:"8760h" ` MinimumServiceDuration models.Duration `env:"MINIMUM_SERVICE_DURATION" default:"0s" ` EthGasBumpThreshold uint64 `env:"ETH_GAS_BUMP_THRESHOLD" default:"3" ` EthGasBumpWei big.Int `env:"ETH_GAS_BUMP_WEI" default:"5000000000"` EthGasBumpPercent uint16 `env:"ETH_GAS_BUMP_PERCENT" default:"20"` EthGasBumpTxDepth uint16 `env:"ETH_GAS_BUMP_TX_DEPTH" default:"10"` EthGasLimitDefault uint64 `env:"ETH_GAS_LIMIT_DEFAULT" default:"500000"` EthGasPriceDefault big.Int `env:"ETH_GAS_PRICE_DEFAULT" default:"20000000000"` EthMaxGasPriceWei uint64 `env:"ETH_MAX_GAS_PRICE_WEI" default:"1500000000000"` EthFinalityDepth uint `env:"ETH_FINALITY_DEPTH" default:"50"` EthHeadTrackerHistoryDepth uint `env:"ETH_HEAD_TRACKER_HISTORY_DEPTH" default:"100"` EthHeadTrackerMaxBufferSize uint `env:"ETH_HEAD_TRACKER_MAX_BUFFER_SIZE" default:"3"` EthBalanceMonitorBlockDelay uint16 `env:"ETH_BALANCE_MONITOR_BLOCK_DELAY" default:"1"` EthereumURL string `env:"ETH_URL" default:"ws://localhost:8546"` EthereumSecondaryURL string `env:"ETH_SECONDARY_URL" default:""` EthereumDisabled bool `env:"ETH_DISABLED" default:"false"` FlagsContractAddress string `env:"FLAGS_CONTRACT_ADDRESS"` GasUpdaterBlockDelay uint16 `env:"GAS_UPDATER_BLOCK_DELAY" default:"3"` GasUpdaterBlockHistorySize uint16 `env:"GAS_UPDATER_BLOCK_HISTORY_SIZE" default:"24"` GasUpdaterTransactionPercentile uint16 `env:"GAS_UPDATER_TRANSACTION_PERCENTILE" default:"60"` GasUpdaterEnabled bool `env:"GAS_UPDATER_ENABLED" default:"true"` InsecureFastScrypt bool `env:"INSECURE_FAST_SCRYPT" default:"false"` JobPipelineDBPollInterval time.Duration `env:"JOB_PIPELINE_DB_POLL_INTERVAL" default:"10s"` JobPipelineMaxTaskDuration time.Duration `env:"JOB_PIPELINE_MAX_TASK_DURATION" default:"10m"` JobPipelineParallelism uint8 `env:"JOB_PIPELINE_PARALLELISM" default:"4"` JobPipelineReaperInterval time.Duration `env:"JOB_PIPELINE_REAPER_INTERVAL" default:"1h"` JobPipelineReaperThreshold time.Duration `env:"JOB_PIPELINE_REAPER_THRESHOLD" default:"7d"` JSONConsole bool `env:"JSON_CONSOLE" default:"false"` LinkContractAddress string `env:"LINK_CONTRACT_ADDRESS" default:"0x514910771AF9Ca656af840dff83E8264EcF986CA"` ExplorerURL *url.URL `env:"EXPLORER_URL"` ExplorerAccessKey string `env:"EXPLORER_ACCESS_KEY"` ExplorerSecret string `env:"EXPLORER_SECRET"` LogLevel LogLevel `env:"LOG_LEVEL" default:"info"` LogToDisk bool `env:"LOG_TO_DISK" default:"true"` LogSQLStatements bool `env:"LOG_SQL" default:"false"` LogSQLMigrations bool `env:"LOG_SQL_MIGRATIONS" default:"true"` DefaultMaxHTTPAttempts uint `env:"MAX_HTTP_ATTEMPTS" default:"5"` MigrateDatabase bool `env:"MIGRATE_DATABASE" default:"true"` MinIncomingConfirmations uint32 `env:"MIN_INCOMING_CONFIRMATIONS" default:"3"` MinRequiredOutgoingConfirmations uint64 `env:"MIN_OUTGOING_CONFIRMATIONS" default:"12"` MinimumContractPayment assets.Link `env:"MINIMUM_CONTRACT_PAYMENT" default:"1000000000000000000"` MinimumRequestExpiration uint64 `env:"MINIMUM_REQUEST_EXPIRATION" default:"300"` OCRBootstrapCheckInterval time.Duration `env:"OCR_BOOTSTRAP_CHECK_INTERVAL" default:"20s"` OCRContractTransmitterTransmitTimeout time.Duration `env:"OCR_CONTRACT_TRANSMITTER_TRANSMIT_TIMEOUT" default:"10s"` OCRDatabaseTimeout time.Duration `env:"OCR_DATABASE_TIMEOUT" default:"10s"` OCRIncomingMessageBufferSize int `env:"OCR_INCOMING_MESSAGE_BUFFER_SIZE" default:"10"` OCROutgoingMessageBufferSize int `env:"OCR_OUTGOING_MESSAGE_BUFFER_SIZE" default:"10"` OCRNewStreamTimeout time.Duration `env:"OCR_NEW_STREAM_TIMEOUT" default:"10s"` OCRDHTLookupInterval int `env:"OCR_DHT_LOOKUP_INTERVAL" default:"10"` OCRTraceLogging bool `env:"OCR_TRACE_LOGGING" default:"false"` OperatorContractAddress common.Address `env:"OPERATOR_CONTRACT_ADDRESS"` P2PAnnounceIP net.IP `env:"P2P_ANNOUNCE_IP"` P2PAnnouncePort uint16 `env:"P2P_ANNOUNCE_PORT"` P2PListenIP net.IP `env:"P2P_LISTEN_IP" default:"0.0.0.0"` P2PListenPort uint16 `env:"P2P_LISTEN_PORT"` Port uint16 `env:"CHAINLINK_PORT" default:"6688"` ReaperExpiration models.Duration `env:"REAPER_EXPIRATION" default:"240h"` ReplayFromBlock int64 `env:"REPLAY_FROM_BLOCK" default:"-1"` RootDir string `env:"ROOT" default:"~/.chainlink"` SecureCookies bool `env:"SECURE_COOKIES" default:"true"` SessionTimeout models.Duration `env:"SESSION_TIMEOUT" default:"15m"` TLSCertPath string `env:"TLS_CERT_PATH" ` TLSHost string `env:"CHAINLINK_TLS_HOST" ` TLSKeyPath string `env:"TLS_KEY_PATH" ` TLSPort uint16 `env:"CHAINLINK_TLS_PORT" default:"6689"` TLSRedirect bool `env:"CHAINLINK_TLS_REDIRECT" default:"false"` TxAttemptLimit uint16 `env:"CHAINLINK_TX_ATTEMPT_LIMIT" default:"10"` }
ConfigSchema records the schema of configuration at the type level
type Connection ¶
type Connection struct {
// contains filtered or unexported fields
}
Connection manages all of the possible database connection setup and config.
func NewConnection ¶
func NewConnection(dialect DialectName, uri string, advisoryLockID int64) (Connection, error)
NewConnection returns a Connection which holds all of the configuration necessary for managing the database connection.
type DialectName ¶
type DialectName string
DialectName is a compiler enforced type used that maps to gorm's dialect names.
const ( // DialectPostgres represents the postgres dialect. DialectPostgres DialectName = "postgres" // DialectTransactionWrappedPostgres is useful for tests. // When the connection is opened, it starts a transaction and all // operations performed on the DB will be within that transaction. // // HACK: This must be the string 'cloudsqlpostgres' because of an absolutely // horrible design in gorm. We need gorm to enable postgres-specific // features for the txdb driver, but it can only do that if the dialect is // called "postgres" or "cloudsqlpostgres". // // Since "postgres" is already taken, "cloudsqlpostgres" is our only // remaining option // // See: https://github.com/jinzhu/gorm/blob/master/dialect_postgres.go#L15 DialectTransactionWrappedPostgres DialectName = "cloudsqlpostgres" // DialectPostgresWithoutLock represents the postgres dialect but it does not // wait for a lock to connect. Intended to be used for read only access. DialectPostgresWithoutLock DialectName = "postgresWithoutLock" )
type LockingStrategy ¶
type LockingStrategy interface { Lock(timeout models.Duration) error Unlock(timeout models.Duration) error }
LockingStrategy employs the locking and unlocking of an underlying resource for exclusive access, usually a file or database.
func NewLockingStrategy ¶
func NewLockingStrategy(ct Connection) (LockingStrategy, error)
NewLockingStrategy returns the locking strategy for a particular dialect to ensure exlusive access to the orm.
func NewPostgresLockingStrategy ¶
func NewPostgresLockingStrategy(ct Connection) (LockingStrategy, error)
NewPostgresLockingStrategy returns a new instance of the PostgresLockingStrategy.
type ORM ¶
ORM contains the database object used by Chainlink.
func NewORM ¶
func NewORM(uri string, timeout models.Duration, shutdownSignal gracefulpanic.Signal, dialect DialectName, advisoryLockID int64) (*ORM, error)
NewORM initializes the orm with the configured uri
func (*ORM) AllKeys ¶
AllKeys returns all of the keys recorded in the database including the funding key. This method is deprecated! You should use SendKeys() to retrieve all but the funding keys.
func (*ORM) AllSyncEvents ¶
AllSyncEvents returns all sync events
func (*ORM) AnyJobWithType ¶
AnyJobWithType returns true if there is at least one job associated with the type name specified and false otherwise
func (*ORM) ArchiveEncryptedSecretVRFKey ¶
func (orm *ORM) ArchiveEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
ArchiveEncryptedVRFKey soft-deletes k from the encrypted keys table, or errors
func (*ORM) ArchiveJob ¶
ArchiveJob soft deletes the job, job_runs and its initiator.
func (*ORM) ArchiveKey ¶
ArchiveKey soft-deletes a key whose address matches the supplied bytes.
func (*ORM) AuthorizedUserWithSession ¶
func (orm *ORM) AuthorizedUserWithSession(sessionID string, sessionDuration time.Duration) (models.User, error)
AuthorizedUserWithSession will return the one API user if the Session ID exists and hasn't expired, and update session's LastUsed field.
func (*ORM) BridgeTypes ¶
BridgeTypes returns bridge types ordered by name filtered limited by the passed params.
func (*ORM) BulkDeleteRuns ¶
func (orm *ORM) BulkDeleteRuns(bulkQuery *models.BulkDeleteRunRequest) error
BulkDeleteRuns removes JobRuns and their related records: TaskRuns and RunResults.
RunResults and RunRequests are pointed at by JobRuns so we must use two CTEs to remove both parents in one hit.
TaskRuns are removed by ON DELETE CASCADE when the JobRuns and RunResults are deleted.
func (*ORM) Chain ¶
Chain returns the chain of heads starting at hash and up to lookback parents Returns RecordNotFound if no head with the given hash exists
func (*ORM) ClearNonCurrentSessions ¶
ClearNonCurrentSessions removes all sessions but the id passed in.
func (*ORM) ClearSessions ¶
ClearSessions removes all sessions.
func (*ORM) ClobberDiskKeyStoreWithDBKeys ¶
ClobberDiskKeyStoreWithDBKeys writes all keys stored in the orm to the keys folder on disk, deleting anything there prior.
func (*ORM) CreateBridgeType ¶
func (orm *ORM) CreateBridgeType(bt *models.BridgeType) error
CreateBridgeType saves the bridge type.
func (*ORM) CreateExternalInitiator ¶
func (orm *ORM) CreateExternalInitiator(externalInitiator *models.ExternalInitiator) error
CreateExternalInitiator inserts a new external initiator
func (*ORM) CreateInitiator ¶
CreateInitiator saves the initiator.
func (*ORM) CreateJobRun ¶
CreateJobRun inserts a new JobRun
func (*ORM) CreateKeyIfNotExists ¶
CreateKeyIfNotExists inserts a key if a key with that address doesn't exist already If a key with this address exists, it does nothing
func (*ORM) CreateServiceAgreement ¶
func (orm *ORM) CreateServiceAgreement(sa *models.ServiceAgreement) error
CreateServiceAgreement saves a Service Agreement, its JobSpec and its associations to the database.
func (*ORM) CreateSession ¶
func (orm *ORM) CreateSession(sr models.SessionRequest) (string, error)
CreateSession will check the password in the SessionRequest against the hashed API User password in the db.
func (*ORM) DeleteBridgeType ¶
func (orm *ORM) DeleteBridgeType(bt *models.BridgeType) error
DeleteBridgeType removes the bridge type
func (*ORM) DeleteEncryptedSecretVRFKey ¶
func (orm *ORM) DeleteEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
DeleteEncryptedVRFKey deletes k from the encrypted keys table, or errors
func (*ORM) DeleteExternalInitiator ¶
DeleteExternalInitiator removes an external initiator
func (*ORM) DeleteFluxMonitorRoundsBackThrough ¶
DeleteFluxMonitorRoundsBackThrough deletes all the RoundStat records for a given oracle address starting from the most recent round back through the given round
func (*ORM) DeleteJobSpecError ¶
DeleteJobSpecError removes a JobSpecError
func (*ORM) DeleteStaleSessions ¶
DeleteStaleSessions deletes all sessions before the passed time.
func (*ORM) DeleteUser ¶
DeleteUser will delete the API User in the db.
func (*ORM) DeleteUserSession ¶
DeleteUserSession will erase the session ID for the sole API User.
func (*ORM) EthTransactionsWithAttempts ¶
EthTransactionsWithAttempts returns all eth transactions with at least one attempt limited by passed parameters. Attempts are sorted by created_at.
func (*ORM) EthTxAttempts ¶
EthTxAttempts returns the last tx attempts sorted by created_at descending.
func (*ORM) FindBridge ¶
FindBridge looks up a Bridge by its Name.
func (*ORM) FindBridgesByNames ¶
func (orm *ORM) FindBridgesByNames(names []string) ([]models.BridgeType, error)
FindBridgesByNames finds multiple bridges by their names.
func (*ORM) FindEncryptedSecretVRFKeys ¶
func (orm *ORM) FindEncryptedSecretVRFKeys(where ...vrfkey.EncryptedVRFKey) ( retrieved []*vrfkey.EncryptedVRFKey, err error)
FindEncryptedVRFKeys retrieves matches to where from the encrypted keys table, or errors
func (*ORM) FindEthTaskRunTxByTaskRunID ¶
FindEthTaskRunTxByTaskRunID finds the EthTaskRunTx with its EthTxes and EthTxAttempts preloaded
func (*ORM) FindEthTxAttempt ¶
FindEthTxAttempt returns an individual EthTxAttempt
func (*ORM) FindEthTxWithAttempts ¶
FindEthTxWithAttempts finds the EthTx with its attempts and receipts preloaded
func (*ORM) FindExternalInitiator ¶
FindExternalInitiator finds an external initiator given an authentication request
func (*ORM) FindExternalInitiatorByName ¶
func (orm *ORM) FindExternalInitiatorByName(iname string) (models.ExternalInitiator, error)
FindExternalInitiatorByName finds an external initiator given an authentication request
func (*ORM) FindInitiator ¶
FindInitiator returns the single initiator defined by the passed ID.
func (*ORM) FindJobRun ¶
FindJobRun looks up a JobRun by its ID.
func (*ORM) FindJobSpecError ¶
func (orm *ORM) FindJobSpecError(jobID *models.ID, description string) (*models.JobSpecError, error)
FindJobSpecError looks for a JobSpecError record with the given jobID and description
func (*ORM) FindJobWithErrors ¶
FindJobWithErrors looks up a Job by its ID and preloads JobSpecErrors.
func (*ORM) FindOffChainReportingJob ¶
FindOffChainReportingJob returns OCR job spec by ID
func (*ORM) FindOrCreateFluxMonitorRoundStats ¶
func (orm *ORM) FindOrCreateFluxMonitorRoundStats(aggregator common.Address, roundID uint32) (models.FluxMonitorRoundStats, error)
FindOrCreateFluxMonitorRoundStats find the round stats record for a given oracle on a given round, or creates it if no record exists
func (*ORM) FindServiceAgreement ¶
func (orm *ORM) FindServiceAgreement(id string) (models.ServiceAgreement, error)
FindServiceAgreement looks up a ServiceAgreement by its ID.
func (*ORM) FirstOrCreateEncryptedSecretVRFKey ¶
func (orm *ORM) FirstOrCreateEncryptedSecretVRFKey(k *vrfkey.EncryptedVRFKey) error
FirstOrCreateEncryptedVRFKey returns the first key found or creates a new one in the orm.
func (*ORM) GetConfigValue ¶
func (orm *ORM) GetConfigValue(field string, value encoding.TextUnmarshaler) error
GetConfigValue returns the value for a named configuration entry
func (*ORM) GetLastNonce ¶
GetLastNonce retrieves the last known nonce in the database for an account
func (*ORM) GetRoundRobinAddress ¶
func (orm *ORM) GetRoundRobinAddress(addresses ...common.Address) (address common.Address, err error)
GetRoundRobinAddress queries the database for the address of a random ethereum key derived from the id. This takes an optional param for a slice of addresses it should pick from. Leave empty to pick from all addresses in the database. NOTE: We can add more advanced logic here later such as sorting by priority etc
func (*ORM) HasConsumedLog ¶
func (orm *ORM) HasConsumedLog(blockHash common.Hash, logIndex uint, jobID *models.ID) (bool, error)
HasConsumedLog reports whether the given consumer had already consumed the given log
func (*ORM) HasConsumedLogV2 ¶
HasConsumedLogV2 reports whether the given consumer had already consumed the given log
func (*ORM) HeadByHash ¶
HeadByHash fetches the head with the given hash from the db, returns nil if none exists
func (*ORM) IdempotentInsertEthTaskRunTx ¶
func (orm *ORM) IdempotentInsertEthTaskRunTx(taskRunID models.ID, fromAddress common.Address, toAddress common.Address, encodedPayload []byte, gasLimit uint64) error
IdempotentInsertEthTaskRunTx creates both eth_task_run_transaction and eth_tx in one hit It can be called multiple times without error as long as the outcome would have resulted in the same database state
func (*ORM) IdempotentInsertHead ¶
IdempotentInsertHead inserts a head only if the hash is new. Will do nothing if hash exists already. No advisory lock required because this is thread safe.
func (*ORM) JobRunsCountFor ¶
JobRunsCountFor returns the current number of runs for the job
func (*ORM) JobRunsFor ¶
JobRunsFor fetches all JobRuns with a given Job ID, sorted by their created at time.
func (*ORM) JobRunsSorted ¶
JobRunsSorted returns job runs ordered and filtered by the passed params.
func (*ORM) JobRunsSortedFor ¶
func (orm *ORM) JobRunsSortedFor(id *models.ID, order SortType, offset int, limit int) ([]models.JobRun, int, error)
JobRunsSortedFor returns job runs for a specific job spec ordered and filtered by the passed params.
func (*ORM) JobsSorted ¶
JobsSorted returns many JobSpecs sorted by CreatedAt from the store adhering to the passed parameters.
func (*ORM) KeyByAddress ¶
KeyByAddress returns the key matching provided address
func (*ORM) LastHead ¶
LastHead returns the head with the highest number. In the case of ties (e.g. due to re-org) it returns the most recently seen head entry.
func (*ORM) LinkEarnedFor ¶
LinkEarnedFor shows the total link earnings for a job
func (*ORM) MarkLogConsumed ¶
func (orm *ORM) MarkLogConsumed(blockHash common.Hash, logIndex uint, jobID *models.ID, blockNumber uint64) error
MarkLogConsumed creates a new LogConsumption record
func (*ORM) MarkLogConsumedV2 ¶
func (orm *ORM) MarkLogConsumedV2(blockHash common.Hash, logIndex uint, jobID int32, blockNumber uint64) error
MarkLogConsumedV2 creates a new LogConsumption record
func (*ORM) MostRecentFluxMonitorRoundID ¶
MostRecentFluxMonitorRoundID finds roundID of the most recent round that the provided oracle address submitted to
func (*ORM) MustEnsureAdvisoryLock ¶
func (orm *ORM) MustEnsureAdvisoryLock()
MustEnsureAdvisoryLock sends a shutdown signal to the ORM if it an advisory lock cannot be acquired.
func (*ORM) OffChainReportingJobRuns ¶
func (orm *ORM) OffChainReportingJobRuns(jobID int32, offset, size int) ([]pipeline.Run, int, error)
OffChainReportingJobRuns returns OCR job runs
func (*ORM) OffChainReportingJobs ¶
OffChainReportingJobs returns OCR job specs
func (*ORM) PendingBridgeType ¶
PendingBridgeType returns the bridge type of the current pending task, or error if not pending bridge.
func (*ORM) RemoveUnstartedTransactions ¶
func (*ORM) SaveJobRun ¶
SaveJobRun updates UpdatedAt for a JobRun and saves it
func (*ORM) SaveSession ¶
SaveSession saves the session.
func (*ORM) SetConfigValue ¶
func (orm *ORM) SetConfigValue(field string, value encoding.TextMarshaler) error
SetConfigValue returns the value for a named configuration entry
func (*ORM) SetLogging ¶
SetLogging turns on SQL statement logging
func (*ORM) Transaction ¶
NOTE: Copied verbatim from gorm master Transaction start a transaction as a block, return error will rollback, otherwise to commit.
func (*ORM) TrimOldHeads ¶
TrimOldHeads deletes heads such that only the top N block numbers remain
func (*ORM) Unscoped ¶
Unscoped returns a new instance of this ORM that includes soft deleted items.
func (*ORM) UnscopedJobRunsWithStatus ¶
func (orm *ORM) UnscopedJobRunsWithStatus(cb func(*models.JobRun), statuses ...models.RunStatus) error
UnscopedJobRunsWithStatus passes all JobRuns to a callback, one by one, including those that were soft deleted.
func (*ORM) UpdateBridgeType ¶
func (orm *ORM) UpdateBridgeType(bt *models.BridgeType, btr *models.BridgeTypeRequest) error
UpdateBridgeType updates the bridge type.
func (*ORM) UpdateFluxMonitorRoundStats ¶
func (orm *ORM) UpdateFluxMonitorRoundStats(aggregator common.Address, roundID uint32, jobRunID *models.ID) error
UpdateFluxMonitorRoundStats trys to create a RoundStat record for the given oracle at the given round. If one already exists, it increments the num_submissions column.
type PostgresLockingStrategy ¶
type PostgresLockingStrategy struct {
// contains filtered or unexported fields
}
PostgresLockingStrategy uses a postgres advisory lock to ensure exclusive access.
type SecretGenerator ¶
SecretGenerator is the interface for objects that generate a secret used to sign or encrypt.