testutils

Jan 11, 2023

Changes in this version

+ func InsecureRandomKey(rng *rand.Rand) *ecdsa.PrivateKey

+ func RandomBlock(rng *rand.Rand, txCount uint64) (*types.Block, []*types.Receipt)

+ func RandomHeader(rng *rand.Rand) *types.Header

+ func RandomLog(rng *rand.Rand) *types.Log

+ func RandomReceipt(rng *rand.Rand, signer types.Signer, tx *types.Transaction, txIndex uint64, ...) *types.Receipt

+ func RandomTo(rng *rand.Rand) *common.Address

+ func RandomTx(rng *rand.Rand, baseFee *big.Int, signer types.Signer) *types.Transaction

Dec 23, 2022

Changes in this version

type MockEthClient

+ func (m *MockEthClient) ExpectGetStorageAt(ctx context.Context, address common.Address, storageSlot common.Hash, ...)

+ func (m *MockEthClient) ExpectReadStorageAt(ctx context.Context, address common.Address, storageSlot common.Hash, ...)

+ func (m *MockEthClient) GetStorageAt(ctx context.Context, address common.Address, storageSlot common.Hash, ...) (common.Hash, error)

+ func (m *MockEthClient) ReadStorageAt(ctx context.Context, address common.Address, storageSlot common.Hash, ...) (common.Hash, error)

+ type MockRuntimeConfig struct

+ P2PSeqAddress common.Address

+ func (m *MockRuntimeConfig) P2PSequencerAddress() common.Address

Aug 26, 2022

Changes in this version

type MockEthClient

+ func (m *MockEthClient) ExpectFetch(hash common.Hash, info eth.BlockInfo, transactions types.Transactions, ...)

+ func (m *MockEthClient) ExpectInfoByRpcNumber(num rpc.BlockNumber, info eth.BlockInfo, err error)

+ func (m *MockEthClient) Fetch(ctx context.Context, blockHash common.Hash) (eth.BlockInfo, types.Transactions, eth.ReceiptsFetcher, error)

+ func (m *MockEthClient) InfoByRpcNumber(ctx context.Context, num rpc.BlockNumber) (eth.BlockInfo, error)

Aug 10, 2022

Changes in this version

type MockL1Source

+ func (m *MockL1Source) ExpectInfoByHash(hash common.Hash, info eth.L1Info, err error)

+ func (m *MockL1Source) InfoByHash(ctx context.Context, hash common.Hash) (eth.L1Info, error)

+ func (m *MockL1Source) L1HeadBlockRef(ctx context.Context) (eth.L1BlockRef, error)

Jul 12, 2022

Changes in this version

+ func MakeL1Info(fn func(l *MockL1Info)) func(rng *rand.Rand) *MockL1Info

type FakeChainSource

+ func (m *FakeChainSource) L1HeadBlockRef(ctx context.Context) (eth.L1BlockRef, error)

+ func (m *FakeChainSource) L2BlockRefHead(ctx context.Context) (eth.L2BlockRef, error)

type MockEngine

+ func (m *MockEngine) ExpectL2BlockRefByHash(l2Hash common.Hash, ref eth.L1BlockRef, err error)

+ func (m *MockEngine) ExpectL2BlockRefHead(ref eth.L1BlockRef, err error)

+ func (m *MockEngine) ExpectPayloadByHash(hash common.Hash, payload *eth.ExecutionPayload, err error)

+ func (m *MockEngine) ExpectPayloadByNumber(hash common.Hash, payload *eth.ExecutionPayload, err error)

+ func (m *MockEngine) L2BlockRefByHash(ctx context.Context, l2Hash common.Hash) (eth.L2BlockRef, error)

+ func (m *MockEngine) L2BlockRefHead(ctx context.Context) (eth.L2BlockRef, error)

+ func (m *MockEngine) PayloadByHash(ctx context.Context, hash common.Hash) (*eth.ExecutionPayload, error)

+ func (m *MockEngine) PayloadByNumber(ctx context.Context, n uint64) (*eth.ExecutionPayload, error)

+ type MockL1Info struct

+ InfoBaseFee *big.Int

+ InfoHash common.Hash

+ InfoMixDigest [32]byte

+ InfoNum uint64

+ InfoParentHash common.Hash

+ InfoReceiptRoot common.Hash

+ InfoRoot common.Hash

+ InfoSequenceNumber uint64

+ InfoTime uint64

+ func RandomL1Info(rng *rand.Rand) *MockL1Info

+ func (l *MockL1Info) BaseFee() *big.Int

+ func (l *MockL1Info) BlockRef() eth.L1BlockRef

+ func (l *MockL1Info) Hash() common.Hash

+ func (l *MockL1Info) ID() eth.BlockID

+ func (l *MockL1Info) MixDigest() common.Hash

+ func (l *MockL1Info) NumberU64() uint64

+ func (l *MockL1Info) ParentHash() common.Hash

+ func (l *MockL1Info) ReceiptHash() common.Hash

+ func (l *MockL1Info) Root() common.Hash

+ func (l *MockL1Info) SequenceNumber() uint64

+ func (l *MockL1Info) Time() uint64

type MockL1Source

+ func (m *MockL1Source) ExpectFetch(hash common.Hash, info eth.L1Info, transactions types.Transactions, ...)

+ func (m *MockL1Source) ExpectInfoAndTxsByHash(hash common.Hash, info eth.L1Info, transactions types.Transactions, err error)

+ func (m *MockL1Source) Fetch(ctx context.Context, blockHash common.Hash) (eth.L1Info, types.Transactions, types.Receipts, error)

+ func (m *MockL1Source) InfoAndTxsByHash(ctx context.Context, hash common.Hash) (eth.L1Info, types.Transactions, error)

Dec 6, 2022

Changes in this version

+ func BigEqual(a, b *big.Int) bool

+ func FakeGenesis(l1 rune, l2 rune, l1GenesisNumber int) rollup.Genesis

+ func GenerateDeposit(sourceHash common.Hash, rng *rand.Rand) *types.DepositTx

+ func GenerateLog(addr common.Address, topics []common.Hash, data []byte) *types.Log

+ func MakeBlockInfo(fn func(l *MockBlockInfo)) func(rng *rand.Rand) *MockBlockInfo

+ func NextRandomL2Ref(rng *rand.Rand, l2BlockTime uint64, parent eth.L2BlockRef, origin eth.BlockID) eth.L2BlockRef

+ func NextRandomRef(rng *rand.Rand, parent eth.L1BlockRef) eth.L1BlockRef

+ func RandomAddress(rng *rand.Rand) (out common.Address)

+ func RandomBlockID(rng *rand.Rand) eth.BlockID

+ func RandomBlockRef(rng *rand.Rand) eth.L1BlockRef

+ func RandomData(rng *rand.Rand, size int) []byte

+ func RandomETH(rng *rand.Rand, max int64) *big.Int

+ func RandomHash(rng *rand.Rand) (out common.Hash)

+ func RandomKey() *ecdsa.PrivateKey

+ func RandomL2BlockRef(rng *rand.Rand) eth.L2BlockRef

+ func RequireBigEqual(t *testing.T, exp, actual *big.Int)

+ type FakeChainSource struct

+ func NewFakeChainSource(l1 []string, l2 []string, l1GenesisNumber int, log log.Logger) *FakeChainSource

+ func (m *FakeChainSource) AdvanceL1() eth.L1BlockRef

+ func (m *FakeChainSource) ForkchoiceUpdate(ctx context.Context, state *eth.ForkchoiceState, attr *eth.PayloadAttributes) (*eth.ForkchoiceUpdatedResult, error)

+ func (m *FakeChainSource) L1BlockRefByHash(ctx context.Context, l1Hash common.Hash) (eth.L1BlockRef, error)

+ func (m *FakeChainSource) L1BlockRefByLabel(ctx context.Context, label eth.BlockLabel) (eth.L1BlockRef, error)

+ func (m *FakeChainSource) L1BlockRefByNumber(ctx context.Context, l1Num uint64) (eth.L1BlockRef, error)

+ func (m *FakeChainSource) L1Head() eth.L1BlockRef

+ func (m *FakeChainSource) L1Range(ctx context.Context, base eth.BlockID, max uint64) ([]eth.BlockID, error)

+ func (m *FakeChainSource) L2BlockRefByHash(ctx context.Context, l2Hash common.Hash) (eth.L2BlockRef, error)

+ func (m *FakeChainSource) L2BlockRefByLabel(ctx context.Context, label eth.BlockLabel) (eth.L2BlockRef, error)

+ func (m *FakeChainSource) L2BlockRefByNumber(ctx context.Context, l2Num *big.Int) (eth.L2BlockRef, error)

+ func (m *FakeChainSource) ReorgL1()

+ func (m *FakeChainSource) SetL2Finalized(finalized common.Hash)

+ func (m *FakeChainSource) SetL2Head(head int) eth.L2BlockRef

+ func (m *FakeChainSource) SetL2Safe(safe common.Hash)

+ type MockBlockInfo struct

+ InfoBaseFee *big.Int

+ InfoCoinbase common.Address

+ InfoHash common.Hash

+ InfoMixDigest [32]byte

+ InfoNum uint64

+ InfoParentHash common.Hash

+ InfoReceiptRoot common.Hash

+ InfoRoot common.Hash

+ InfoTime uint64

+ func RandomBlockInfo(rng *rand.Rand) *MockBlockInfo

+ func (l *MockBlockInfo) BaseFee() *big.Int

+ func (l *MockBlockInfo) BlockRef() eth.L1BlockRef

+ func (l *MockBlockInfo) Coinbase() common.Address

+ func (l *MockBlockInfo) Hash() common.Hash

+ func (l *MockBlockInfo) ID() eth.BlockID

+ func (l *MockBlockInfo) MixDigest() common.Hash

+ func (l *MockBlockInfo) NumberU64() uint64

+ func (l *MockBlockInfo) ParentHash() common.Hash

+ func (l *MockBlockInfo) ReceiptHash() common.Hash

+ func (l *MockBlockInfo) Root() common.Hash

+ func (l *MockBlockInfo) Time() uint64

+ type MockEngine struct

+ func (m *MockEngine) ExpectForkchoiceUpdate(state *eth.ForkchoiceState, attr *eth.PayloadAttributes, ...)

+ func (m *MockEngine) ExpectGetPayload(payloadId eth.PayloadID, payload *eth.ExecutionPayload, err error)

+ func (m *MockEngine) ExpectNewPayload(payload *eth.ExecutionPayload, result *eth.PayloadStatusV1, err error)

+ func (m *MockEngine) ForkchoiceUpdate(ctx context.Context, state *eth.ForkchoiceState, attr *eth.PayloadAttributes) (*eth.ForkchoiceUpdatedResult, error)

+ func (m *MockEngine) GetPayload(ctx context.Context, payloadId eth.PayloadID) (*eth.ExecutionPayload, error)

+ func (m *MockEngine) NewPayload(ctx context.Context, payload *eth.ExecutionPayload) (*eth.PayloadStatusV1, error)

+ type MockEthClient struct

+ func (m *MockEthClient) ExpectFetchReceipts(hash common.Hash, info eth.BlockInfo, receipts types.Receipts, err error)

+ func (m *MockEthClient) ExpectGetProof(address common.Address, blockTag string, result *eth.AccountResult, err error)

+ func (m *MockEthClient) ExpectInfoAndTxsByHash(hash common.Hash, info eth.BlockInfo, transactions types.Transactions, ...)

+ func (m *MockEthClient) ExpectInfoAndTxsByLabel(label eth.BlockLabel, info eth.BlockInfo, transactions types.Transactions, ...)

+ func (m *MockEthClient) ExpectInfoAndTxsByNumber(number uint64, info eth.BlockInfo, transactions types.Transactions, err error)

+ func (m *MockEthClient) ExpectInfoByHash(hash common.Hash, info eth.BlockInfo, err error)

+ func (m *MockEthClient) ExpectInfoByLabel(label eth.BlockLabel, info eth.BlockInfo, err error)

+ func (m *MockEthClient) ExpectInfoByNumber(number uint64, info eth.BlockInfo, err error)

+ func (m *MockEthClient) ExpectPayloadByHash(hash common.Hash, payload *eth.ExecutionPayload, err error)

+ func (m *MockEthClient) ExpectPayloadByLabel(label eth.BlockLabel, payload *eth.ExecutionPayload, err error)

+ func (m *MockEthClient) ExpectPayloadByNumber(hash common.Hash, payload *eth.ExecutionPayload, err error)

+ func (m *MockEthClient) FetchReceipts(ctx context.Context, blockHash common.Hash) (eth.BlockInfo, types.Receipts, error)

+ func (m *MockEthClient) GetProof(ctx context.Context, address common.Address, blockTag string) (*eth.AccountResult, error)

+ func (m *MockEthClient) InfoAndTxsByHash(ctx context.Context, hash common.Hash) (eth.BlockInfo, types.Transactions, error)

+ func (m *MockEthClient) InfoAndTxsByLabel(ctx context.Context, label eth.BlockLabel) (eth.BlockInfo, types.Transactions, error)

+ func (m *MockEthClient) InfoAndTxsByNumber(ctx context.Context, number uint64) (eth.BlockInfo, types.Transactions, error)

+ func (m *MockEthClient) InfoByHash(ctx context.Context, hash common.Hash) (eth.BlockInfo, error)

+ func (m *MockEthClient) InfoByLabel(ctx context.Context, label eth.BlockLabel) (eth.BlockInfo, error)

+ func (m *MockEthClient) InfoByNumber(ctx context.Context, number uint64) (eth.BlockInfo, error)

+ func (m *MockEthClient) PayloadByHash(ctx context.Context, hash common.Hash) (*eth.ExecutionPayload, error)

+ func (m *MockEthClient) PayloadByLabel(ctx context.Context, label eth.BlockLabel) (*eth.ExecutionPayload, error)

+ func (m *MockEthClient) PayloadByNumber(ctx context.Context, n uint64) (*eth.ExecutionPayload, error)

+ type MockL1Source struct

+ func (m *MockL1Source) ExpectL1BlockRefByHash(hash common.Hash, ref eth.L1BlockRef, err error)

+ func (m *MockL1Source) ExpectL1BlockRefByLabel(label eth.BlockLabel, ref eth.L1BlockRef, err error)

+ func (m *MockL1Source) ExpectL1BlockRefByNumber(num uint64, ref eth.L1BlockRef, err error)

+ func (m *MockL1Source) L1BlockRefByHash(ctx context.Context, hash common.Hash) (eth.L1BlockRef, error)

+ func (m *MockL1Source) L1BlockRefByLabel(ctx context.Context, label eth.BlockLabel) (eth.L1BlockRef, error)

+ func (m *MockL1Source) L1BlockRefByNumber(ctx context.Context, num uint64) (eth.L1BlockRef, error)

+ type MockL2Client struct

+ func (c *MockL2Client) L2BlockRefByHash(ctx context.Context, hash common.Hash) (eth.L2BlockRef, error)

+ func (c *MockL2Client) L2BlockRefByLabel(ctx context.Context, label eth.BlockLabel) (eth.L2BlockRef, error)

+ func (c *MockL2Client) L2BlockRefByNumber(ctx context.Context, num uint64) (eth.L2BlockRef, error)

+ func (m *MockL2Client) ExpectL2BlockRefByHash(hash common.Hash, ref eth.L2BlockRef, err error)

+ func (m *MockL2Client) ExpectL2BlockRefByLabel(label eth.BlockLabel, ref eth.L2BlockRef, err error)

+ func (m *MockL2Client) ExpectL2BlockRefByNumber(num uint64, ref eth.L2BlockRef, err error)

+ func (m *MockL2Client) ExpectSystemConfigByL2Hash(hash common.Hash, cfg eth.SystemConfig, err error)

+ func (m *MockL2Client) SystemConfigByL2Hash(ctx context.Context, hash common.Hash) (eth.SystemConfig, error)

+ type RPCErrFaker struct

+ ErrFn func() error

+ RPC client.RPC

+ func (r RPCErrFaker) BatchCallContext(ctx context.Context, b []rpc.BatchElem) error

+ func (r RPCErrFaker) CallContext(ctx context.Context, result interface{}, method string, args ...interface{}) error

+ func (r RPCErrFaker) Close()

+ func (r RPCErrFaker) EthSubscribe(ctx context.Context, channel interface{}, args ...interface{}) (ethereum.Subscription, error)

+ type TestDerivationMetrics struct

+ FnRecordL1Ref func(name string, ref eth.L1BlockRef)

+ FnRecordL1ReorgDepth func(d uint64)

+ FnRecordL2Ref func(name string, ref eth.L2BlockRef)

+ FnRecordUnsafePayloads func(length uint64, memSize uint64, next eth.BlockID)

+ func (t *TestDerivationMetrics) RecordL1Ref(name string, ref eth.L1BlockRef)

+ func (t *TestDerivationMetrics) RecordL1ReorgDepth(d uint64)

+ func (t *TestDerivationMetrics) RecordL2Ref(name string, ref eth.L2BlockRef)

+ func (t *TestDerivationMetrics) RecordUnsafePayloadsBuffer(length uint64, memSize uint64, next eth.BlockID)

+ type TestID string

+ func (id TestID) ID() eth.BlockID

+ type TestRPCMetrics struct

+ func (n *TestRPCMetrics) RecordRPCServerRequest(method string) func()