storage

Documentation

Index

• type AccountIndexer
• type AccountTestSuite
  • func (a *AccountTestSuite) TestNonce()
• type BlockIndexer
• type BlockTestSuite
  • func (b *BlockTestSuite) TestGet()
  • func (b *BlockTestSuite) TestHeights()
  • func (b *BlockTestSuite) TestStore()
• type ReceiptIndexer
• type ReceiptTestSuite
  • func (s *ReceiptTestSuite) TestBloomsForBlockRange()
  • func (s *ReceiptTestSuite) TestGetReceiptByBlockID()
  • func (s *ReceiptTestSuite) TestGetReceiptByTransactionID()
  • func (s *ReceiptTestSuite) TestStoreReceipt()
• type TransactionIndexer
• type TransactionTestSuite
  • func (s *TransactionTestSuite) TestGetTransaction()
  • func (s *TransactionTestSuite) TestStoreTransaction()

Types

type AccountIndexer

type AccountIndexer interface {
	// Update account with executed transactions.
	Update(tx *gethTypes.Transaction, receipt *gethTypes.Receipt) error

	// GetNonce gets an account nonce. If no nonce was indexed it returns 0.
	// todo add getting nonce at provided block height / hash
	GetNonce(address *common.Address) (uint64, error)

	// GetBalance gets an account balance. If no balance was indexed it returns 0.
	GetBalance(address *common.Address) (*big.Int, error)
}

type AccountTestSuite

type AccountTestSuite struct {
	suite.Suite
	AccountIndexer AccountIndexer
}

func (*AccountTestSuite) TestNonce

func (a *AccountTestSuite) TestNonce()

type BlockIndexer

type BlockIndexer interface {
	// Store provided EVM block with the matching Cadence height.
	// Expected errors:
	// - errors.Duplicate if the block already exists
	Store(cadenceHeight uint64, block *types.Block) error

	// GetByHeight returns an EVM block stored by EVM height.
	// Expected errors:
	// - errors.NotFound if the block is not found
	GetByHeight(height uint64) (*types.Block, error)

	// GetByID returns an EVM block stored by ID.
	// Expected errors:
	// - errors.NotFound if the block is not found
	GetByID(ID common.Hash) (*types.Block, error)

	// LatestEVMHeight returns the latest stored EVM block height.
	// Expected errors:
	// - errors.NotInitialized if the storage was not initialized
	LatestEVMHeight() (uint64, error)

	// LatestCadenceHeight return the latest stored Cadence height.
	// Expected errors:
	// - errors.NotInitialized if the storage was not initialized
	LatestCadenceHeight() (uint64, error)

	// SetLatestCadenceHeight sets the latest Cadence height.
	SetLatestCadenceHeight(height uint64) error

	// GetCadenceHeight returns the Cadence height that matches the
	// provided EVM height. Each EVM block indexed contains a link
	// to the Cadence height.
	// - errors.NotFound if the height is not found
	GetCadenceHeight(evmHeight uint64) (uint64, error)
}

type BlockTestSuite

type BlockTestSuite struct {
	suite.Suite
	Blocks BlockIndexer
}

func (*BlockTestSuite) TestGet

func (b *BlockTestSuite) TestGet()

func (*BlockTestSuite) TestHeights

func (b *BlockTestSuite) TestHeights()

func (*BlockTestSuite) TestStore

func (b *BlockTestSuite) TestStore()

type ReceiptIndexer

type ReceiptIndexer interface {
	// Store provided receipt.
	// Expected errors:
	// - errors.Duplicate if the block already exists.
	Store(receipt *gethTypes.Receipt) error

	// GetByTransactionID returns the receipt for the transaction ID.
	// Expected errors:
	// - errors.NotFound if the receipt is not found
	GetByTransactionID(ID common.Hash) (*gethTypes.Receipt, error)

	// GetByBlockHeight returns the receipt for the block height.
	// Expected errors:
	// - errors.NotFound if the receipt is not found
	// TODO right now one transaction per block, but this might change in future so the API needs to be updated.
	GetByBlockHeight(height *big.Int) (*gethTypes.Receipt, error)

	// BloomsForBlockRange returns slice of bloom values and a slice of block heights
	// corresponding to each item in the bloom slice. It only matches the blooms between
	// inclusive start and end block height.
	// Expected errors:
	// - errors.InvalidRange if the block by the height was not indexed or if the end and start values are invalid.
	BloomsForBlockRange(start, end *big.Int) ([]*gethTypes.Bloom, []*big.Int, error)
}

type ReceiptTestSuite

type ReceiptTestSuite struct {
	suite.Suite
	ReceiptIndexer ReceiptIndexer
}

func (*ReceiptTestSuite) TestBloomsForBlockRange

func (s *ReceiptTestSuite) TestBloomsForBlockRange()

func (*ReceiptTestSuite) TestGetReceiptByBlockID

func (s *ReceiptTestSuite) TestGetReceiptByBlockID()

func (*ReceiptTestSuite) TestGetReceiptByTransactionID

func (s *ReceiptTestSuite) TestGetReceiptByTransactionID()

func (*ReceiptTestSuite) TestStoreReceipt

func (s *ReceiptTestSuite) TestStoreReceipt()

type TransactionIndexer

type TransactionIndexer interface {
	// Store provided transaction.
	// Expected errors:
	// - errors.Duplicate if the transaction with the ID already exists.
	Store(tx *gethTypes.Transaction) error

	// Get transaction by the ID.
	// Expected errors:
	// - errors.NotFound if the transaction with the ID is not found.
	Get(ID common.Hash) (*gethTypes.Transaction, error)
}

type TransactionTestSuite

type TransactionTestSuite struct {
	suite.Suite
	TransactionIndexer TransactionIndexer
}

func (*TransactionTestSuite) TestGetTransaction

func (s *TransactionTestSuite) TestGetTransaction()

func (*TransactionTestSuite) TestStoreTransaction

func (s *TransactionTestSuite) TestStoreTransaction()