-
Notifications
You must be signed in to change notification settings - Fork 1.7k
/
contract_transmitter.go
272 lines (247 loc) · 10.1 KB
/
contract_transmitter.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
package functions
import (
"bytes"
"context"
"database/sql"
"encoding/hex"
"fmt"
"math/big"
"sync/atomic"
"github.com/ethereum/go-ethereum"
"github.com/ethereum/go-ethereum/accounts/abi"
"github.com/ethereum/go-ethereum/common"
"github.com/pkg/errors"
"github.com/smartcontractkit/libocr/offchainreporting2plus/chains/evmutil"
ocrtypes "github.com/smartcontractkit/libocr/offchainreporting2plus/types"
"github.com/smartcontractkit/chainlink/v2/core/chains/evm/logpoller"
"github.com/smartcontractkit/chainlink/v2/core/chains/evm/txmgr"
"github.com/smartcontractkit/chainlink/v2/core/logger"
"github.com/smartcontractkit/chainlink/v2/core/services"
"github.com/smartcontractkit/chainlink/v2/core/services/ocr2/plugins/functions/encoding"
"github.com/smartcontractkit/chainlink/v2/core/services/pg"
evmRelayTypes "github.com/smartcontractkit/chainlink/v2/core/services/relay/evm/types"
"github.com/smartcontractkit/chainlink/v2/core/utils"
)
type FunctionsContractTransmitter interface {
services.ServiceCtx
ocrtypes.ContractTransmitter
}
type Transmitter interface {
CreateEthTransaction(ctx context.Context, toAddress common.Address, payload []byte, txMeta *txmgr.TxMeta) error
FromAddress() common.Address
}
type ReportToEthMetadata func([]byte) (*txmgr.TxMeta, error)
func reportToEvmTxMetaNoop([]byte) (*txmgr.TxMeta, error) {
return nil, nil
}
type contractTransmitter struct {
contractAddress atomic.Pointer[common.Address]
contractABI abi.ABI
transmitter Transmitter
transmittedEventSig common.Hash
contractReader contractReader
lp logpoller.LogPoller
lggr logger.Logger
reportToEvmTxMeta ReportToEthMetadata
contractVersion uint32
reportCodec encoding.ReportCodec
}
var _ FunctionsContractTransmitter = &contractTransmitter{}
var _ evmRelayTypes.RouteUpdateSubscriber = &contractTransmitter{}
func transmitterFilterName(addr common.Address) string {
return logpoller.FilterName("FunctionsOCR2ContractTransmitter", addr.String())
}
func NewFunctionsContractTransmitter(
caller contractReader,
contractABI abi.ABI,
transmitter Transmitter,
lp logpoller.LogPoller,
lggr logger.Logger,
reportToEvmTxMeta ReportToEthMetadata,
contractVersion uint32,
) (*contractTransmitter, error) {
transmitted, ok := contractABI.Events["Transmitted"]
if !ok {
return nil, errors.New("invalid ABI, missing transmitted")
}
if reportToEvmTxMeta == nil {
reportToEvmTxMeta = reportToEvmTxMetaNoop
}
codec, err := encoding.NewReportCodec(contractVersion)
if err != nil {
return nil, err
}
return &contractTransmitter{
contractABI: contractABI,
transmitter: transmitter,
transmittedEventSig: transmitted.ID,
lp: lp,
contractReader: caller,
lggr: lggr.Named("OCRContractTransmitter"),
reportToEvmTxMeta: reportToEvmTxMeta,
contractVersion: contractVersion,
reportCodec: codec,
}, nil
}
// Transmit sends the report to the on-chain smart contract's Transmit method.
func (oc *contractTransmitter) Transmit(ctx context.Context, reportCtx ocrtypes.ReportContext, report ocrtypes.Report, signatures []ocrtypes.AttributedOnchainSignature) error {
var rs [][32]byte
var ss [][32]byte
var vs [32]byte
if len(signatures) > 32 {
return errors.New("too many signatures, maximum is 32")
}
for i, as := range signatures {
r, s, v, err := evmutil.SplitSignature(as.Signature)
if err != nil {
panic("eventTransmit(ev): error in SplitSignature")
}
rs = append(rs, r)
ss = append(ss, s)
vs[i] = v
}
rawReportCtx := evmutil.RawReportContext(reportCtx)
txMeta, err := oc.reportToEvmTxMeta(report)
if err != nil {
oc.lggr.Warnw("failed to generate tx metadata for report", "err", err)
}
var destinationContract common.Address
if oc.contractVersion == 0 {
destinationContractPtr := oc.contractAddress.Load()
if destinationContractPtr == nil {
return errors.New("destination contract address not set")
}
destinationContract = *destinationContractPtr
} else if oc.contractVersion == 1 {
oc.lggr.Debugw("FunctionsContractTransmitter: start", "reportLenBytes", len(report))
requests, err2 := oc.reportCodec.DecodeReport(report)
if err2 != nil {
return errors.Wrap(err2, "FunctionsContractTransmitter: DecodeReport failed")
}
if len(requests) == 0 {
return errors.New("FunctionsContractTransmitter: no requests in report")
}
if len(requests[0].CoordinatorContract) != common.AddressLength {
return fmt.Errorf("FunctionsContractTransmitter: incorrect length of CoordinatorContract field: %d", len(requests[0].CoordinatorContract))
}
destinationContract.SetBytes(requests[0].CoordinatorContract)
if destinationContract == (common.Address{}) {
return errors.New("FunctionsContractTransmitter: destination coordinator contract is zero")
}
// Sanity check - every report should contain requests with the same coordinator contract.
for _, req := range requests[1:] {
if !bytes.Equal(req.CoordinatorContract, destinationContract.Bytes()) {
oc.lggr.Errorw("FunctionsContractTransmitter: non-uniform coordinator addresses in a batch - still sending to a single destination",
"requestID", hex.EncodeToString(req.RequestID),
"destinationContract", destinationContract,
"requestCoordinator", hex.EncodeToString(req.CoordinatorContract),
)
}
}
oc.lggr.Debugw("FunctionsContractTransmitter: ready", "nRequests", len(requests), "coordinatorContract", destinationContract.Hex())
} else {
return fmt.Errorf("unsupported contract version: %d", oc.contractVersion)
}
payload, err := oc.contractABI.Pack("transmit", rawReportCtx, []byte(report), rs, ss, vs)
if err != nil {
return errors.Wrap(err, "abi.Pack failed")
}
oc.lggr.Debugw("FunctionsContractTransmitter: transmitting report", "contractAddress", destinationContract, "txMeta", txMeta, "payloadSize", len(payload))
return errors.Wrap(oc.transmitter.CreateEthTransaction(ctx, destinationContract, payload, txMeta), "failed to send Eth transaction")
}
type contractReader interface {
CallContract(ctx context.Context, call ethereum.CallMsg, blockNumber *big.Int) ([]byte, error)
}
func parseTransmitted(log []byte) ([32]byte, uint32, error) {
var args abi.Arguments = []abi.Argument{
{
Name: "configDigest",
Type: utils.MustAbiType("bytes32", nil),
},
{
Name: "epoch",
Type: utils.MustAbiType("uint32", nil),
},
}
transmitted, err := args.Unpack(log)
if err != nil {
return [32]byte{}, 0, err
}
if len(transmitted) < 2 {
return [32]byte{}, 0, errors.New("transmitted event log has too few arguments")
}
configDigest := *abi.ConvertType(transmitted[0], new([32]byte)).(*[32]byte)
epoch := *abi.ConvertType(transmitted[1], new(uint32)).(*uint32)
return configDigest, epoch, err
}
func callContract(ctx context.Context, addr common.Address, contractABI abi.ABI, method string, args []interface{}, caller contractReader) ([]interface{}, error) {
input, err := contractABI.Pack(method, args...)
if err != nil {
return nil, err
}
output, err := caller.CallContract(ctx, ethereum.CallMsg{To: &addr, Data: input}, nil)
if err != nil {
return nil, err
}
return contractABI.Unpack(method, output)
}
// LatestConfigDigestAndEpoch retrieves the latest config digest and epoch from the OCR2 contract.
// It is plugin independent, in particular avoids use of the plugin specific generated evm wrappers
// by using the evm client Call directly for functions/events that are part of OCR2Abstract.
func (oc *contractTransmitter) LatestConfigDigestAndEpoch(ctx context.Context) (ocrtypes.ConfigDigest, uint32, error) {
contractAddr := oc.contractAddress.Load()
if contractAddr == nil {
return ocrtypes.ConfigDigest{}, 0, errors.New("destination contract address not set")
}
latestConfigDigestAndEpoch, err := callContract(ctx, *contractAddr, oc.contractABI, "latestConfigDigestAndEpoch", nil, oc.contractReader)
if err != nil {
return ocrtypes.ConfigDigest{}, 0, err
}
// Panic on these conversions erroring, would mean a broken contract.
scanLogs := *abi.ConvertType(latestConfigDigestAndEpoch[0], new(bool)).(*bool)
configDigest := *abi.ConvertType(latestConfigDigestAndEpoch[1], new([32]byte)).(*[32]byte)
epoch := *abi.ConvertType(latestConfigDigestAndEpoch[2], new(uint32)).(*uint32)
if !scanLogs {
return configDigest, epoch, nil
}
// Otherwise, we have to scan for the logs.
if err != nil {
return ocrtypes.ConfigDigest{}, 0, err
}
latest, err := oc.lp.LatestLogByEventSigWithConfs(
oc.transmittedEventSig, *contractAddr, 1, pg.WithParentCtx(ctx))
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
// No transmissions yet
return configDigest, 0, nil
}
return ocrtypes.ConfigDigest{}, 0, err
}
return parseTransmitted(latest.Data)
}
// FromAccount returns the account from which the transmitter invokes the contract
func (oc *contractTransmitter) FromAccount() (ocrtypes.Account, error) {
return ocrtypes.Account(oc.transmitter.FromAddress().String()), nil
}
func (oc *contractTransmitter) Start(ctx context.Context) error { return nil }
func (oc *contractTransmitter) Close() error { return nil }
// Has no state/lifecycle so it's always healthy and ready
func (oc *contractTransmitter) Ready() error { return nil }
func (oc *contractTransmitter) HealthReport() map[string]error {
return map[string]error{oc.Name(): nil}
}
func (oc *contractTransmitter) Name() string { return oc.lggr.Name() }
func (oc *contractTransmitter) UpdateRoutes(activeCoordinator common.Address, proposedCoordinator common.Address) error {
// transmitter only cares about the active coordinator
previousContract := oc.contractAddress.Swap(&activeCoordinator)
if previousContract != nil && *previousContract == activeCoordinator {
return nil
}
oc.lggr.Debugw("FunctionsContractTransmitter: updating routes", "previousContract", previousContract, "activeCoordinator", activeCoordinator)
err := oc.lp.RegisterFilter(logpoller.Filter{Name: transmitterFilterName(activeCoordinator), EventSigs: []common.Hash{oc.transmittedEventSig}, Addresses: []common.Address{activeCoordinator}})
if err != nil {
return err
}
// TODO: unregister old filter (needs refactor to get pg.Queryer)
return nil
}