types

package
v0.0.0-...-1f8a15b Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 12, 2023 License: GPL-3.0 Imports: 44 Imported by: 0

Documentation

Overview

Package types contains data types related to Ethereum consensus.

Index

Constants

View Source
const (
	// BloomByteLength represents the number of bytes used in a header log bloom.
	BloomByteLength = 256

	// BloomBitLength represents the number of bits used in a header log bloom.
	BloomBitLength = 8 * BloomByteLength
)
View Source
const (
	// ReceiptStatusFailed is the status code of a transaction if execution failed.
	ReceiptStatusFailed = uint64(0)

	// ReceiptStatusSuccessful is the status code of a transaction if execution succeeded.
	ReceiptStatusSuccessful = uint64(1)
)
View Source
const (
	LegacyTxType = iota
	AccessListTxType
	DynamicFeeTxType
	BlobTxType
)

Transaction types.

View Source
const BorTxKeyPrefix string = "matic-bor-receipt-"
View Source
const (
	LEN_48 = 48 // KZGCommitment & KZGProof sizes
)

Variables

View Source
var (
	EmptyRootHash  = libcommon.HexToHash("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421")
	EmptyUncleHash = rlpHash([]*Header(nil))

	ExtraVanityLength = 32 // Fixed number of extra-data prefix bytes reserved for signer vanity
	ExtraSealLength   = 65 // Fixed number of extra-data suffix bytes reserved for signer seal
)
View Source
var (
	ErrInvalidSig           = errors.New("invalid transaction v, r, s values")
	ErrUnexpectedProtection = errors.New("transaction type does not supported EIP-155 protected signatures")
	ErrInvalidTxType        = errors.New("transaction type not valid in this context")
	ErrTxTypeNotSupported   = errors.New("transaction type not supported")
)
View Source
var ErrGenesisNoConfig = errors.New("genesis has no chain configuration")
View Source
var ErrInvalidChainId = errors.New("invalid chain id for signer")
View Source
var NanoBlackList = []libcommon.Address{
	libcommon.HexToAddress("0x489A8756C18C0b8B24EC2a2b9FF3D4d447F79BEc"),
	libcommon.HexToAddress("0xFd6042Df3D74ce9959922FeC559d7995F3933c55"),

	libcommon.HexToAddress("0xdb789Eb5BDb4E559beD199B8b82dED94e1d056C9"),
}

This is introduced because of the Tendermint IAVL Merkle Proof verification exploitation.

Functions

func Bloom9

func Bloom9(data []byte) []byte

Bloom9 returns the bloom filter for the given data

func BloomLookup

func BloomLookup(bin Bloom, topic bytesBacked) bool

BloomLookup is a convenience-method to check presence int he bloom filter

func BorReceiptKey

func BorReceiptKey(number uint64) []byte

BorReceiptKey = num (uint64 big endian)

func CalcUncleHash

func CalcUncleHash(uncles []*Header) libcommon.Hash

func ComputeBorTxHash

func ComputeBorTxHash(blockNumber uint64, blockHash libcommon.Hash) libcommon.Hash

ComputeBorTxHash get derived tx hash from block number and hash

func DecodeOnlyTxMetadataFromBody

func DecodeOnlyTxMetadataFromBody(payload []byte) (baseTxId uint64, txAmount uint32, err error)

func DecodeSSZ

func DecodeSSZ(data []byte, dest codec.Deserializable) error

func DeriveChainId

func DeriveChainId(v *uint256.Int) *uint256.Int

deriveChainID derives the chain id from the given v parameter

func DeriveFieldsForBorLogs

func DeriveFieldsForBorLogs(logs []*Log, blockHash libcommon.Hash, blockNumber uint64, txIndex uint, logIndex uint)

DeriveFieldsForBorLogs fills the receipts with their computed fields based on consensus data and contextual infos like containing block and transactions.

func DeriveFieldsForBorReceipt

func DeriveFieldsForBorReceipt(receipt *Receipt, blockHash libcommon.Hash, blockNumber uint64, receipts Receipts) error

DeriveFieldsForBorReceipt fills the receipts with their computed fields based on consensus data and contextual infos like containing block and transactions.

func DeriveSha

func DeriveSha(list DerivableList) libcommon.Hash

func EncodeSSZ

func EncodeSSZ(w io.Writer, obj codec.Serializable) error

func EncodeStructSizePrefix

func EncodeStructSizePrefix(size int, w io.Writer, b []byte) error

func LogsBloom

func LogsBloom(logs []*Log) []byte

LogsBloom returns the bloom bytes for the given logs

func MarshalTransactionsBinary

func MarshalTransactionsBinary(txs Transactions) ([][]byte, error)

func RawRlpHash

func RawRlpHash(rawRlpData rlp.RawValue) (h libcommon.Hash)

func TypedTransactionMarshalledAsRlpString

func TypedTransactionMarshalledAsRlpString(data []byte) bool

Types

type AccessListTx

type AccessListTx struct {
	LegacyTx
	ChainID    *uint256.Int
	AccessList types2.AccessList // EIP-2930 access list
}

AccessListTx is the data of EIP-2930 access list transactions.

func (AccessListTx) AsMessage

func (tx AccessListTx) AsMessage(s Signer, _ *big.Int, rules *chain.Rules) (Message, error)

AsMessage returns the transaction as a core.Message.

func (*AccessListTx) DecodeRLP

func (tx *AccessListTx) DecodeRLP(s *rlp.Stream) error

func (AccessListTx) EncodeRLP

func (tx AccessListTx) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder

func (AccessListTx) EncodingSize

func (tx AccessListTx) EncodingSize() int

EncodingSize returns the RLP encoding size of the whole transaction envelope

func (*AccessListTx) FakeSign

func (tx *AccessListTx) FakeSign(address libcommon.Address) (Transaction, error)

func (AccessListTx) GetAccessList

func (tx AccessListTx) GetAccessList() types2.AccessList

func (AccessListTx) GetChainID

func (tx AccessListTx) GetChainID() *uint256.Int

func (*AccessListTx) Hash

func (tx *AccessListTx) Hash() libcommon.Hash

Hash computes the hash (but not for signatures!)

func (AccessListTx) MarshalBinary

func (tx AccessListTx) MarshalBinary(w io.Writer) error

MarshalBinary returns the canonical encoding of the transaction. For legacy transactions, it returns the RLP encoding. For EIP-2718 typed transactions, it returns the type and payload.

func (AccessListTx) MarshalJSON

func (tx AccessListTx) MarshalJSON() ([]byte, error)

func (AccessListTx) Protected

func (tx AccessListTx) Protected() bool

func (AccessListTx) RawSignatureValues

func (tx AccessListTx) RawSignatureValues() (*uint256.Int, *uint256.Int, *uint256.Int)

func (*AccessListTx) Sender

func (tx *AccessListTx) Sender(signer Signer) (libcommon.Address, error)

func (AccessListTx) SigningHash

func (tx AccessListTx) SigningHash(chainID *big.Int) libcommon.Hash

func (AccessListTx) Type

func (tx AccessListTx) Type() byte

func (*AccessListTx) UnmarshalJSON

func (tx *AccessListTx) UnmarshalJSON(input []byte) error

func (*AccessListTx) Unwrap

func (tx *AccessListTx) Unwrap() Transaction

func (*AccessListTx) WithSignature

func (tx *AccessListTx) WithSignature(signer Signer, sig []byte) (Transaction, error)

type BinaryTransactions

type BinaryTransactions [][]byte

RLP-marshalled legacy transactions and binary-marshalled (not wrapped into an RLP string) typed (EIP-2718) transactions

func (BinaryTransactions) EncodeIndex

func (t BinaryTransactions) EncodeIndex(i int, w *bytes.Buffer)

func (BinaryTransactions) Len

func (t BinaryTransactions) Len() int

type Blob

type Blob [fixedgas.BlobSize]byte

type BlobKzgs

type BlobKzgs []KZGCommitment

func (*BlobKzgs) DecodeRLP

func (li *BlobKzgs) DecodeRLP(s *rlp.Stream) error

type BlobTx

type BlobTx struct {
	DynamicFeeTransaction
	MaxFeePerBlobGas    *uint256.Int
	BlobVersionedHashes []libcommon.Hash
}

func (BlobTx) AsMessage

func (stx BlobTx) AsMessage(s Signer, baseFee *big.Int, rules *chain.Rules) (Message, error)

func (*BlobTx) DecodeRLP

func (stx *BlobTx) DecodeRLP(s *rlp.Stream) error

func (BlobTx) EncodeRLP

func (stx BlobTx) EncodeRLP(w io.Writer) error

func (BlobTx) GetBlobGas

func (stx BlobTx) GetBlobGas() uint64

func (BlobTx) GetBlobHashes

func (stx BlobTx) GetBlobHashes() []libcommon.Hash

func (BlobTx) Hash

func (stx BlobTx) Hash() libcommon.Hash

func (BlobTx) MarshalBinary

func (stx BlobTx) MarshalBinary(w io.Writer) error

func (BlobTx) MarshalJSON

func (tx BlobTx) MarshalJSON() ([]byte, error)

func (BlobTx) SigningHash

func (stx BlobTx) SigningHash(chainID *big.Int) libcommon.Hash

func (BlobTx) Type

func (stx BlobTx) Type() byte

type BlobTxWrapper

type BlobTxWrapper struct {
	Tx          BlobTx
	Commitments BlobKzgs
	Blobs       Blobs
	Proofs      KZGProofs
}

func (*BlobTxWrapper) AsMessage

func (txw *BlobTxWrapper) AsMessage(s Signer, baseFee *big.Int, rules *chain.Rules) (Message, error)

func (*BlobTxWrapper) Cost

func (txw *BlobTxWrapper) Cost() *uint256.Int

func (*BlobTxWrapper) DecodeRLP

func (txw *BlobTxWrapper) DecodeRLP(s *rlp.Stream) error

func (BlobTxWrapper) EncodeRLP

func (txw BlobTxWrapper) EncodeRLP(w io.Writer) error

func (BlobTxWrapper) EncodingSize

func (txw BlobTxWrapper) EncodingSize() int

We deliberately encode only the transaction payload because the only case we need to serialize blobs/commitments/proofs is when we reply to GetPooledTransactions (and that's handled by the txpool).

func (*BlobTxWrapper) FakeSign

func (txw *BlobTxWrapper) FakeSign(address libcommon.Address) (Transaction, error)

func (*BlobTxWrapper) GetAccessList

func (txw *BlobTxWrapper) GetAccessList() types2.AccessList

func (*BlobTxWrapper) GetBlobGas

func (txw *BlobTxWrapper) GetBlobGas() uint64

func (*BlobTxWrapper) GetBlobHashes

func (txw *BlobTxWrapper) GetBlobHashes() []libcommon.Hash

func (*BlobTxWrapper) GetChainID

func (txw *BlobTxWrapper) GetChainID() *uint256.Int

func (*BlobTxWrapper) GetData

func (txw *BlobTxWrapper) GetData() []byte

func (*BlobTxWrapper) GetEffectiveGasTip

func (txw *BlobTxWrapper) GetEffectiveGasTip(baseFee *uint256.Int) *uint256.Int

func (*BlobTxWrapper) GetFeeCap

func (txw *BlobTxWrapper) GetFeeCap() *uint256.Int

func (*BlobTxWrapper) GetGas

func (txw *BlobTxWrapper) GetGas() uint64

func (*BlobTxWrapper) GetNonce

func (txw *BlobTxWrapper) GetNonce() uint64

func (*BlobTxWrapper) GetPrice

func (txw *BlobTxWrapper) GetPrice() *uint256.Int

func (*BlobTxWrapper) GetSender

func (txw *BlobTxWrapper) GetSender() (libcommon.Address, bool)

func (*BlobTxWrapper) GetTip

func (txw *BlobTxWrapper) GetTip() *uint256.Int

func (*BlobTxWrapper) GetTo

func (txw *BlobTxWrapper) GetTo() *libcommon.Address

func (*BlobTxWrapper) GetValue

func (txw *BlobTxWrapper) GetValue() *uint256.Int

func (*BlobTxWrapper) Hash

func (txw *BlobTxWrapper) Hash() libcommon.Hash

func (*BlobTxWrapper) IsContractDeploy

func (txw *BlobTxWrapper) IsContractDeploy() bool

func (*BlobTxWrapper) MarshalBinary

func (txw *BlobTxWrapper) MarshalBinary(w io.Writer) error

func (BlobTxWrapper) MarshalJSON

func (tx BlobTxWrapper) MarshalJSON() ([]byte, error)

func (*BlobTxWrapper) Protected

func (txw *BlobTxWrapper) Protected() bool

func (*BlobTxWrapper) RawSignatureValues

func (txw *BlobTxWrapper) RawSignatureValues() (*uint256.Int, *uint256.Int, *uint256.Int)

func (*BlobTxWrapper) Sender

func (txw *BlobTxWrapper) Sender(s Signer) (libcommon.Address, error)

func (*BlobTxWrapper) SetSender

func (txw *BlobTxWrapper) SetSender(address libcommon.Address)

func (*BlobTxWrapper) SigningHash

func (txw *BlobTxWrapper) SigningHash(chainID *big.Int) libcommon.Hash

func (*BlobTxWrapper) Time

func (txw *BlobTxWrapper) Time() time.Time

func (*BlobTxWrapper) Type

func (txw *BlobTxWrapper) Type() byte

Implement transaction interface

func (*BlobTxWrapper) Unwrap

func (txw *BlobTxWrapper) Unwrap() Transaction

func (*BlobTxWrapper) ValidateBlobTransactionWrapper

func (txw *BlobTxWrapper) ValidateBlobTransactionWrapper() error

validateBlobTransactionWrapper implements validate_blob_transaction_wrapper from EIP-4844

func (*BlobTxWrapper) WithSignature

func (txw *BlobTxWrapper) WithSignature(signer Signer, sig []byte) (Transaction, error)

type Blobs

type Blobs []Blob

func (Blobs) ComputeCommitmentsAndProofs

func (blobs Blobs) ComputeCommitmentsAndProofs() (commitments []KZGCommitment, versionedHashes []libcommon.Hash, proofs []KZGProof, err error)

Return KZG commitments, versioned hashes and the proofs that correspond to these blobs

func (*Blobs) DecodeRLP

func (blobs *Blobs) DecodeRLP(s *rlp.Stream) error

type Block

type Block struct {
	// contains filtered or unexported fields
}

Block represents an entire block in the Ethereum blockchain.

func NewBlock

func NewBlock(header *Header, txs []Transaction, uncles []*Header, receipts []*Receipt, withdrawals []*Withdrawal) *Block

NewBlock creates a new block. The input data is copied, changes to header and to the field values will not affect the block.

The values of TxHash, UncleHash, ReceiptHash, Bloom, and WithdrawalHash in the header are ignored and set to the values derived from the given txs, uncles, receipts, and withdrawals.

func NewBlockFromStorage

func NewBlockFromStorage(hash libcommon.Hash, header *Header, txs []Transaction, uncles []*Header, withdrawals []*Withdrawal) *Block

NewBlockFromStorage like NewBlock but used to create Block object when read it from DB in this case no reason to copy parts, or re-calculate headers fields - they are all stored in DB

func NewBlockWithHeader

func NewBlockWithHeader(header *Header) *Block

NewBlockWithHeader creates a block with the given header data. The header data is copied, changes to header and to the field values will not affect the block.

func (*Block) BaseFee

func (b *Block) BaseFee() *big.Int

func (*Block) Bloom

func (b *Block) Bloom() Bloom

func (*Block) Body

func (b *Block) Body() *Body

Body returns the non-header content of the block.

func (*Block) Coinbase

func (b *Block) Coinbase() libcommon.Address

func (*Block) Copy

func (b *Block) Copy() *Block

Copy creates a deep copy of the Block.

func (*Block) DecodeRLP

func (bb *Block) DecodeRLP(s *rlp.Stream) error

DecodeRLP decodes the Ethereum

func (*Block) Difficulty

func (b *Block) Difficulty() *big.Int

func (Block) EncodeRLP

func (bb Block) EncodeRLP(w io.Writer) error

EncodeRLP serializes b into the Ethereum RLP block format.

func (Block) EncodingSize

func (bb Block) EncodingSize() int

func (*Block) Extra

func (b *Block) Extra() []byte

func (*Block) GasLimit

func (b *Block) GasLimit() uint64

func (*Block) GasUsed

func (b *Block) GasUsed() uint64

func (*Block) Hash

func (b *Block) Hash() libcommon.Hash

Hash returns the keccak256 hash of b's header. The hash is computed on the first call and cached thereafter.

func (*Block) HashCheck

func (b *Block) HashCheck() error

HashCheck checks that transactions, receipts, uncles and withdrawals hashes are correct.

func (*Block) Header

func (b *Block) Header() *Header

Header returns a deep-copy of the entire block header using CopyHeader()

func (*Block) HeaderNoCopy

func (b *Block) HeaderNoCopy() *Header

func (*Block) MixDigest

func (b *Block) MixDigest() libcommon.Hash

func (*Block) Nonce

func (b *Block) Nonce() BlockNonce

func (*Block) NonceU64

func (b *Block) NonceU64() uint64

func (*Block) Number

func (b *Block) Number() *big.Int

func (*Block) NumberU64

func (b *Block) NumberU64() uint64

func (*Block) ParentBeaconBlockRoot

func (b *Block) ParentBeaconBlockRoot() *libcommon.Hash

func (*Block) ParentHash

func (b *Block) ParentHash() libcommon.Hash

func (*Block) RawBody

func (b *Block) RawBody() *RawBody

RawBody creates a RawBody based on the block. It is not very efficient, so will probably be removed in favour of RawBlock. Also it panics

func (*Block) ReceiptHash

func (b *Block) ReceiptHash() libcommon.Hash

func (*Block) Root

func (b *Block) Root() libcommon.Hash

func (*Block) SanityCheck

func (b *Block) SanityCheck() error

SanityCheck can be used to prevent that unbounded fields are stuffed with junk data to add processing overhead

func (*Block) SendersToTxs

func (b *Block) SendersToTxs(senders []libcommon.Address)

func (*Block) Size

func (b *Block) Size() common.StorageSize

Size returns the true RLP encoded storage size of the block, either by encoding and returning it, or returning a previously cached value.

func (*Block) Time

func (b *Block) Time() uint64

func (*Block) Transaction

func (b *Block) Transaction(hash libcommon.Hash) Transaction

func (*Block) Transactions

func (b *Block) Transactions() Transactions

func (*Block) TxHash

func (b *Block) TxHash() libcommon.Hash

func (*Block) UncleHash

func (b *Block) UncleHash() libcommon.Hash

func (*Block) Uncles

func (b *Block) Uncles() []*Header

func (*Block) WithSeal

func (b *Block) WithSeal(header *Header) *Block

WithSeal returns a new block with the data from b but the header replaced with the sealed one.

func (*Block) Withdrawals

func (b *Block) Withdrawals() Withdrawals

func (*Block) WithdrawalsHash

func (b *Block) WithdrawalsHash() *libcommon.Hash

type BlockNonce

type BlockNonce [8]byte

A BlockNonce is a 64-bit hash which proves (combined with the mix-hash) that a sufficient amount of computation has been carried out on a block.

func EncodeNonce

func EncodeNonce(i uint64) BlockNonce

EncodeNonce converts the given integer to a block nonce.

func (BlockNonce) MarshalText

func (n BlockNonce) MarshalText() ([]byte, error)

MarshalText encodes n as a hex string with 0x prefix.

func (BlockNonce) Uint64

func (n BlockNonce) Uint64() uint64

Uint64 returns the integer value of a block nonce.

func (*BlockNonce) UnmarshalText

func (n *BlockNonce) UnmarshalText(input []byte) error

UnmarshalText implements encoding.TextUnmarshaler.

type BlockWithReceipts

type BlockWithReceipts struct {
	Block    *Block
	Receipts Receipts
}

type Blocks

type Blocks []*Block

type Bloom

type Bloom [BloomByteLength]byte

Bloom represents a 2048 bit bloom filter.

func BytesToBloom

func BytesToBloom(b []byte) Bloom

BytesToBloom converts a byte slice to a bloom filter. It panics if b is not of suitable size.

func CreateBloom

func CreateBloom(receipts Receipts) Bloom

func (*Bloom) Add

func (b *Bloom) Add(d []byte)

Add adds d to the filter. Future calls of Test(d) will return true.

func (Bloom) Big

func (b Bloom) Big() *big.Int

Big converts b to a big integer. Note: Converting a bloom filter to a big.Int and then calling GetBytes does not return the same bytes, since big.Int will trim leading zeroes

func (Bloom) Bytes

func (b Bloom) Bytes() []byte

Bytes returns the backing byte slice of the bloom

func (Bloom) MarshalText

func (b Bloom) MarshalText() ([]byte, error)

MarshalText encodes b as a hex string with 0x prefix.

func (*Bloom) SetBytes

func (b *Bloom) SetBytes(d []byte)

SetBytes sets the content of b to the given bytes. It panics if d is not of suitable size.

func (Bloom) Test

func (b Bloom) Test(topic []byte) bool

Test checks if the given topic is present in the bloom filter

func (*Bloom) UnmarshalText

func (b *Bloom) UnmarshalText(input []byte) error

UnmarshalText b as a hex string with 0x prefix.

type Body

type Body struct {
	Transactions []Transaction
	Uncles       []*Header
	Withdrawals  []*Withdrawal
}

Body is a simple (mutable, non-safe) data container for storing and moving a block's data contents (transactions and uncles) together.

func (*Body) DecodeRLP

func (bb *Body) DecodeRLP(s *rlp.Stream) error

func (Body) EncodeRLP

func (bb Body) EncodeRLP(w io.Writer) error

func (Body) EncodingSize

func (bb Body) EncodingSize() int

func (*Body) RawBody

func (b *Body) RawBody() *RawBody

RawBody creates a RawBody based on the body.

func (*Body) SendersFromTxs

func (b *Body) SendersFromTxs() []libcommon.Address

Copy transaction senders from transactions to the body

func (*Body) SendersToTxs

func (b *Body) SendersToTxs(senders []libcommon.Address)

Copy transaction senders from body into the transactions

type BodyForStorage

type BodyForStorage struct {
	BaseTxId    uint64
	TxAmount    uint32
	Uncles      []*Header
	Withdrawals []*Withdrawal
}

func (*BodyForStorage) DecodeRLP

func (bfs *BodyForStorage) DecodeRLP(s *rlp.Stream) error

func (BodyForStorage) EncodeRLP

func (bfs BodyForStorage) EncodeRLP(w io.Writer) error

type CommonTx

type CommonTx struct {
	TransactionMisc

	Nonce   uint64             // nonce of sender account
	Gas     uint64             // gas limit
	To      *libcommon.Address `rlp:"nil"` // nil means contract creation
	Value   *uint256.Int       // wei amount
	Data    []byte             // contract invocation input data
	V, R, S uint256.Int        // signature values
}

func (CommonTx) GetBlobGas

func (ct CommonTx) GetBlobGas() uint64

func (*CommonTx) GetBlobHashes

func (ct *CommonTx) GetBlobHashes() []libcommon.Hash

func (CommonTx) GetData

func (ct CommonTx) GetData() []byte

func (CommonTx) GetGas

func (ct CommonTx) GetGas() uint64

func (CommonTx) GetNonce

func (ct CommonTx) GetNonce() uint64

func (CommonTx) GetSender

func (ct CommonTx) GetSender() (libcommon.Address, bool)

func (CommonTx) GetTo

func (ct CommonTx) GetTo() *libcommon.Address

func (CommonTx) GetValue

func (ct CommonTx) GetValue() *uint256.Int

func (CommonTx) IsContractDeploy

func (ct CommonTx) IsContractDeploy() bool

func (CommonTx) Protected

func (ct CommonTx) Protected() bool

func (*CommonTx) SetSender

func (ct *CommonTx) SetSender(addr libcommon.Address)

type DerivableList

type DerivableList interface {
	Len() int
	EncodeIndex(i int, w *bytes.Buffer)
}

type DynamicFeeTransaction

type DynamicFeeTransaction struct {
	CommonTx
	ChainID    *uint256.Int
	Tip        *uint256.Int
	FeeCap     *uint256.Int
	AccessList types2.AccessList
}

func NewEIP1559Transaction

func NewEIP1559Transaction(chainID uint256.Int, nonce uint64, to libcommon.Address, amount *uint256.Int, gasLimit uint64, gasPrice *uint256.Int, gasTip *uint256.Int, gasFeeCap *uint256.Int, data []byte) *DynamicFeeTransaction

NewEIP1559Transaction creates an unsigned eip1559 transaction.

func (DynamicFeeTransaction) AsMessage

func (tx DynamicFeeTransaction) AsMessage(s Signer, baseFee *big.Int, rules *chain.Rules) (Message, error)

AsMessage returns the transaction as a core.Message.

func (DynamicFeeTransaction) Cost

func (tx DynamicFeeTransaction) Cost() *uint256.Int

func (*DynamicFeeTransaction) DecodeRLP

func (tx *DynamicFeeTransaction) DecodeRLP(s *rlp.Stream) error

func (DynamicFeeTransaction) EncodeRLP

func (tx DynamicFeeTransaction) EncodeRLP(w io.Writer) error

func (DynamicFeeTransaction) EncodingSize

func (tx DynamicFeeTransaction) EncodingSize() int

func (*DynamicFeeTransaction) FakeSign

func (tx *DynamicFeeTransaction) FakeSign(address libcommon.Address) (Transaction, error)

func (DynamicFeeTransaction) GetAccessList

func (tx DynamicFeeTransaction) GetAccessList() types2.AccessList

func (DynamicFeeTransaction) GetChainID

func (tx DynamicFeeTransaction) GetChainID() *uint256.Int

func (DynamicFeeTransaction) GetEffectiveGasTip

func (tx DynamicFeeTransaction) GetEffectiveGasTip(baseFee *uint256.Int) *uint256.Int

func (*DynamicFeeTransaction) GetFeeCap

func (tx *DynamicFeeTransaction) GetFeeCap() *uint256.Int

func (DynamicFeeTransaction) GetPrice

func (tx DynamicFeeTransaction) GetPrice() *uint256.Int

func (*DynamicFeeTransaction) GetTip

func (tx *DynamicFeeTransaction) GetTip() *uint256.Int

func (*DynamicFeeTransaction) Hash

Hash computes the hash (but not for signatures!)

func (DynamicFeeTransaction) MarshalBinary

func (tx DynamicFeeTransaction) MarshalBinary(w io.Writer) error

MarshalBinary returns the canonical encoding of the transaction. For legacy transactions, it returns the RLP encoding. For EIP-2718 typed transactions, it returns the type and payload.

func (DynamicFeeTransaction) MarshalJSON

func (tx DynamicFeeTransaction) MarshalJSON() ([]byte, error)

func (DynamicFeeTransaction) RawSignatureValues

func (tx DynamicFeeTransaction) RawSignatureValues() (*uint256.Int, *uint256.Int, *uint256.Int)

func (*DynamicFeeTransaction) Sender

func (tx *DynamicFeeTransaction) Sender(signer Signer) (libcommon.Address, error)

func (DynamicFeeTransaction) SigningHash

func (tx DynamicFeeTransaction) SigningHash(chainID *big.Int) libcommon.Hash

func (DynamicFeeTransaction) Type

func (tx DynamicFeeTransaction) Type() byte

accessors for innerTx.

func (*DynamicFeeTransaction) UnmarshalJSON

func (tx *DynamicFeeTransaction) UnmarshalJSON(input []byte) error

func (*DynamicFeeTransaction) Unwrap

func (tx *DynamicFeeTransaction) Unwrap() Transaction

func (*DynamicFeeTransaction) WithSignature

func (tx *DynamicFeeTransaction) WithSignature(signer Signer, sig []byte) (Transaction, error)

type ErigonLog

type ErigonLog struct {
	Address     libcommon.Address `json:"address" gencodec:"required" codec:"1"`
	Topics      []libcommon.Hash  `json:"topics" gencodec:"required" codec:"2"`
	Data        []byte            `json:"data" gencodec:"required" codec:"3"`
	BlockNumber uint64            `json:"blockNumber" codec:"-"`
	TxHash      libcommon.Hash    `json:"transactionHash" gencodec:"required" codec:"-"`
	TxIndex     uint              `json:"transactionIndex" codec:"-"`
	BlockHash   libcommon.Hash    `json:"blockHash" codec:"-"`
	Index       uint              `json:"logIndex" codec:"-"`
	Removed     bool              `json:"removed" codec:"-"`
	Timestamp   uint64            `json:"timestamp" codec:"-"`
}

func (ErigonLog) MarshalJSON

func (l ErigonLog) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*ErigonLog) UnmarshalJSON

func (l *ErigonLog) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type ErigonLogs

type ErigonLogs []*ErigonLog

type Genesis

type Genesis struct {
	Config     *chain.Config  `json:"config"`
	Nonce      uint64         `json:"nonce"`
	Timestamp  uint64         `json:"timestamp"`
	ExtraData  []byte         `json:"extraData"`
	GasLimit   uint64         `json:"gasLimit"   gencodec:"required"`
	Difficulty *big.Int       `json:"difficulty" gencodec:"required"`
	Mixhash    common.Hash    `json:"mixHash"`
	Coinbase   common.Address `json:"coinbase"`
	Alloc      GenesisAlloc   `json:"alloc"      gencodec:"required"`

	AuRaStep uint64 `json:"auRaStep"`
	AuRaSeal []byte `json:"auRaSeal"`

	// These fields are used for consensus tests. Please don't use them
	// in actual genesis blocks.
	Number     uint64      `json:"number"`
	GasUsed    uint64      `json:"gasUsed"`
	ParentHash common.Hash `json:"parentHash"`

	// Header fields added in London and later hard forks
	BaseFee               *big.Int     `json:"baseFeePerGas"`         // EIP-1559
	BlobGasUsed           *uint64      `json:"blobGasUsed"`           // EIP-4844
	ExcessBlobGas         *uint64      `json:"excessBlobGas"`         // EIP-4844
	ParentBeaconBlockRoot *common.Hash `json:"parentBeaconBlockRoot"` // EIP-4788
}

Genesis specifies the header fields, state of a genesis block. It also defines hard fork switch-over blocks through the chain configuration.

func (*Genesis) ConfigOrDefault

func (g *Genesis) ConfigOrDefault(genesisHash common.Hash) *chain.Config

func (Genesis) MarshalJSON

func (g Genesis) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*Genesis) UnmarshalJSON

func (g *Genesis) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type GenesisAccount

type GenesisAccount struct {
	Constructor []byte                      `json:"constructor,omitempty"` // deployment code
	Code        []byte                      `json:"code,omitempty"`        // final contract code
	Storage     map[common.Hash]common.Hash `json:"storage,omitempty"`
	Balance     *big.Int                    `json:"balance" gencodec:"required"`
	Nonce       uint64                      `json:"nonce,omitempty"`
	PrivateKey  []byte                      `json:"secretKey,omitempty"` // for tests
}

GenesisAccount is an account in the state of the genesis block. Either use "constructor" for deployment code or "code" directly for the final code.

func (GenesisAccount) MarshalJSON

func (g GenesisAccount) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*GenesisAccount) UnmarshalJSON

func (g *GenesisAccount) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type GenesisAlloc

type GenesisAlloc map[common.Address]GenesisAccount

GenesisAlloc specifies the initial state that is part of the genesis block.

func DecodeGenesisAlloc

func DecodeGenesisAlloc(i interface{}) (GenesisAlloc, error)

func (*GenesisAlloc) UnmarshalJSON

func (ga *GenesisAlloc) UnmarshalJSON(data []byte) error

type GenesisMismatchError

type GenesisMismatchError struct {
	Stored, New common.Hash
}

GenesisMismatchError is raised when trying to overwrite an existing genesis block with an incompatible one.

func (*GenesisMismatchError) Error

func (e *GenesisMismatchError) Error() string
type Header struct {
	ParentHash  libcommon.Hash    `json:"parentHash"       gencodec:"required"`
	UncleHash   libcommon.Hash    `json:"sha3Uncles"       gencodec:"required"`
	Coinbase    libcommon.Address `json:"miner"`
	Root        libcommon.Hash    `json:"stateRoot"        gencodec:"required"`
	TxHash      libcommon.Hash    `json:"transactionsRoot" gencodec:"required"`
	ReceiptHash libcommon.Hash    `json:"receiptsRoot"     gencodec:"required"`
	Bloom       Bloom             `json:"logsBloom"        gencodec:"required"`
	Difficulty  *big.Int          `json:"difficulty"       gencodec:"required"`
	Number      *big.Int          `json:"number"           gencodec:"required"`
	GasLimit    uint64            `json:"gasLimit"         gencodec:"required"`
	GasUsed     uint64            `json:"gasUsed"          gencodec:"required"`
	Time        uint64            `json:"timestamp"        gencodec:"required"`
	Extra       []byte            `json:"extraData"        gencodec:"required"`
	MixDigest   libcommon.Hash    `json:"mixHash"` // prevRandao after EIP-4399
	Nonce       BlockNonce        `json:"nonce"`
	// AuRa extensions (alternative to MixDigest & Nonce)
	AuRaStep uint64
	AuRaSeal []byte

	BaseFee         *big.Int        `json:"baseFeePerGas"`   // EIP-1559
	WithdrawalsHash *libcommon.Hash `json:"withdrawalsRoot"` // EIP-4895

	// BlobGasUsed & ExcessBlobGas were added by EIP-4844 and are ignored in legacy headers.
	BlobGasUsed   *uint64 `json:"blobGasUsed"`
	ExcessBlobGas *uint64 `json:"excessBlobGas"`

	ParentBeaconBlockRoot *libcommon.Hash `json:"parentBeaconBlockRoot"` // EIP-4788

	// The verkle proof is ignored in legacy headers
	Verkle        bool
	VerkleProof   []byte
	VerkleKeyVals []verkle.KeyValuePair
}

Header represents a block header in the Ethereum blockchain. DESCRIBED: docs/programmers_guide/guide.md#organising-ethereum-state-into-a-merkle-tree

func CopyHeader

func CopyHeader(h *Header) *Header

CopyHeader creates a deep copy of a block header to prevent side effects from modifying a header variable.

func (*Header) DecodeRLP

func (h *Header) DecodeRLP(s *rlp.Stream) error

func (*Header) EncodeRLP

func (h *Header) EncodeRLP(w io.Writer) error

func (*Header) EncodingSize

func (h *Header) EncodingSize() int

func (*Header) Hash

func (h *Header) Hash() libcommon.Hash

Hash returns the block hash of the header, which is simply the keccak256 hash of its RLP encoding.

func (Header) MarshalJSON

func (h Header) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*Header) SanityCheck

func (h *Header) SanityCheck() error

SanityCheck checks a few basic things -- these checks are way beyond what any 'sane' production values should hold, and can mainly be used to prevent that the unbounded fields are stuffed with junk data to add processing overhead

func (*Header) Size

func (h *Header) Size() common.StorageSize

Size returns the approximate memory used by all internal contents. It is used to approximate and limit the memory consumption of various caches.

func (*Header) UnmarshalJSON

func (h *Header) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type KZGCommitment

type KZGCommitment [LEN_48]byte // Compressed BLS12-381 G1 element

func (KZGCommitment) ComputeVersionedHash

func (c KZGCommitment) ComputeVersionedHash() libcommon.Hash

type KZGProof

type KZGProof [LEN_48]byte

type KZGProofs

type KZGProofs []KZGProof

func (*KZGProofs) DecodeRLP

func (li *KZGProofs) DecodeRLP(s *rlp.Stream) error

type LegacyTx

type LegacyTx struct {
	CommonTx
	GasPrice *uint256.Int // wei per gas
}

LegacyTx is the transaction data of regular Ethereum transactions.

func NewBorTransaction

func NewBorTransaction() *LegacyTx

NewBorTransaction create new bor transaction for bor receipt

func NewContractCreation

func NewContractCreation(nonce uint64, amount *uint256.Int, gasLimit uint64, gasPrice *uint256.Int, data []byte) *LegacyTx

NewContractCreation creates an unsigned legacy transaction. Deprecated: use NewTx instead.

func NewTransaction

func NewTransaction(nonce uint64, to libcommon.Address, amount *uint256.Int, gasLimit uint64, gasPrice *uint256.Int, data []byte) *LegacyTx

NewTransaction creates an unsigned legacy transaction. Deprecated: use NewTx instead.

func (LegacyTx) AsMessage

func (tx LegacyTx) AsMessage(s Signer, _ *big.Int, _ *chain.Rules) (Message, error)

AsMessage returns the transaction as a core.Message.

func (LegacyTx) Cost

func (tx LegacyTx) Cost() *uint256.Int

func (*LegacyTx) DecodeRLP

func (tx *LegacyTx) DecodeRLP(s *rlp.Stream, encodingSize uint64) error

DecodeRLP decodes LegacyTx but with the list token already consumed and encodingSize being presented

func (LegacyTx) EncodeRLP

func (tx LegacyTx) EncodeRLP(w io.Writer) error

func (LegacyTx) EncodingSize

func (tx LegacyTx) EncodingSize() int

func (*LegacyTx) FakeSign

func (tx *LegacyTx) FakeSign(address libcommon.Address) (Transaction, error)

func (LegacyTx) GetAccessList

func (tx LegacyTx) GetAccessList() types2.AccessList

func (LegacyTx) GetChainID

func (tx LegacyTx) GetChainID() *uint256.Int

func (LegacyTx) GetEffectiveGasTip

func (tx LegacyTx) GetEffectiveGasTip(baseFee *uint256.Int) *uint256.Int

func (LegacyTx) GetFeeCap

func (tx LegacyTx) GetFeeCap() *uint256.Int

func (LegacyTx) GetPrice

func (tx LegacyTx) GetPrice() *uint256.Int

func (LegacyTx) GetTip

func (tx LegacyTx) GetTip() *uint256.Int

func (*LegacyTx) Hash

func (tx *LegacyTx) Hash() libcommon.Hash

Hash computes the hash (but not for signatures!)

func (LegacyTx) MarshalBinary

func (tx LegacyTx) MarshalBinary(w io.Writer) error

func (LegacyTx) MarshalJSON

func (tx LegacyTx) MarshalJSON() ([]byte, error)

func (LegacyTx) Protected

func (tx LegacyTx) Protected() bool

func (LegacyTx) RawSignatureValues

func (tx LegacyTx) RawSignatureValues() (*uint256.Int, *uint256.Int, *uint256.Int)

func (*LegacyTx) Sender

func (tx *LegacyTx) Sender(signer Signer) (libcommon.Address, error)

func (LegacyTx) SigningHash

func (tx LegacyTx) SigningHash(chainID *big.Int) libcommon.Hash

func (LegacyTx) Type

func (tx LegacyTx) Type() byte

func (*LegacyTx) UnmarshalJSON

func (tx *LegacyTx) UnmarshalJSON(input []byte) error

func (*LegacyTx) Unwrap

func (tx *LegacyTx) Unwrap() Transaction

func (*LegacyTx) WithSignature

func (tx *LegacyTx) WithSignature(signer Signer, sig []byte) (Transaction, error)

type Log

type Log struct {
	// Consensus fields:
	// address of the contract that generated the event
	Address libcommon.Address `json:"address" gencodec:"required" codec:"1"`
	// list of topics provided by the contract.
	Topics []libcommon.Hash `json:"topics" gencodec:"required" codec:"2"`
	// supplied by the contract, usually ABI-encoded
	Data []byte `json:"data" gencodec:"required" codec:"3"`

	// Derived fields. These fields are filled in by the node
	// but not secured by consensus.
	// block in which the transaction was included
	BlockNumber uint64 `json:"blockNumber" codec:"-"`

	// hash of the transaction
	TxHash libcommon.Hash `json:"transactionHash" gencodec:"required" codec:"-"`
	// index of the transaction in the block
	TxIndex uint `json:"transactionIndex" codec:"-"`
	// hash of the block in which the transaction was included
	BlockHash libcommon.Hash `json:"blockHash" codec:"-"`
	// index of the log in the block
	Index uint `json:"logIndex" codec:"-"`

	// The Removed field is true if this log was reverted due to a chain reorganisation.
	// You must pay attention to this field if you receive logs through a filter query.
	Removed bool `json:"removed" codec:"-"`
}

Log represents a contract log event. These events are generated by the LOG opcode and stored/indexed by the node.

func MergeBorLogs

func MergeBorLogs(logs []*Log, borLogs []*Log) []*Log

MergeBorLogs merges receipt logs and block receipt logs

func (*Log) CodecDecodeSelf

func (x *Log) CodecDecodeSelf(d *codec1978.Decoder)

func (*Log) CodecEncodeSelf

func (x *Log) CodecEncodeSelf(e *codec1978.Encoder)

func (*Log) Copy

func (l *Log) Copy() *Log

Copy creates a deep copy of the Log.

func (*Log) DecodeRLP

func (l *Log) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder.

func (*Log) EncodeRLP

func (l *Log) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder.

func (*Log) IsCodecEmpty

func (x *Log) IsCodecEmpty() bool

func (Log) MarshalJSON

func (l Log) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*Log) UnmarshalJSON

func (l *Log) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type LogForStorage

type LogForStorage Log

LogForStorage is a wrapper around a Log that flattens and parses the entire content of a log including non-consensus fields.

func (*LogForStorage) DecodeRLP

func (l *LogForStorage) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder.

Note some redundant fields(e.g. block number, tx hash etc) will be assembled later.

func (*LogForStorage) EncodeRLP

func (l *LogForStorage) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder.

type Logs

type Logs []*Log

func (*Logs) CodecDecodeSelf

func (x *Logs) CodecDecodeSelf(d *codec1978.Decoder)

func (Logs) CodecEncodeSelf

func (x Logs) CodecEncodeSelf(e *codec1978.Encoder)

func (Logs) CointainTopics

func (logs Logs) CointainTopics(addrMap map[libcommon.Address]struct{}, topicsMap map[libcommon.Hash]struct{}) Logs

func (Logs) Filter

func (logs Logs) Filter(addrMap map[libcommon.Address]struct{}, topics [][]libcommon.Hash) Logs

func (Logs) FilterOld

func (logs Logs) FilterOld(addresses map[libcommon.Address]struct{}, topics [][]libcommon.Hash) Logs

type Message

type Message struct {
	// contains filtered or unexported fields
}

Message is a fully derived transaction and implements core.Message

func NewMessage

func NewMessage(from libcommon.Address, to *libcommon.Address, nonce uint64, amount *uint256.Int, gasLimit uint64,
	gasPrice *uint256.Int, feeCap, tip *uint256.Int, data []byte, accessList types2.AccessList, checkNonce bool,
	isFree bool, maxFeePerBlobGas *uint256.Int,
) Message

func (Message) AccessList

func (m Message) AccessList() types2.AccessList

func (Message) BlobGas

func (m Message) BlobGas() uint64

func (Message) BlobHashes

func (m Message) BlobHashes() []libcommon.Hash

func (*Message) ChangeGas

func (m *Message) ChangeGas(globalGasCap, desiredGas uint64)

func (Message) CheckNonce

func (m Message) CheckNonce() bool

func (Message) Data

func (m Message) Data() []byte

func (Message) FeeCap

func (m Message) FeeCap() *uint256.Int

func (Message) From

func (m Message) From() libcommon.Address

func (Message) Gas

func (m Message) Gas() uint64

func (Message) GasPrice

func (m Message) GasPrice() *uint256.Int

func (Message) IsFree

func (m Message) IsFree() bool

func (Message) MaxFeePerBlobGas

func (m Message) MaxFeePerBlobGas() *uint256.Int

func (Message) Nonce

func (m Message) Nonce() uint64

func (*Message) SetCheckNonce

func (m *Message) SetCheckNonce(checkNonce bool)

func (*Message) SetIsFree

func (m *Message) SetIsFree(isFree bool)

func (Message) Tip

func (m Message) Tip() *uint256.Int

func (Message) To

func (m Message) To() *libcommon.Address

func (Message) Value

func (m Message) Value() *uint256.Int

type RawBlock

type RawBlock struct {
	Header *Header
	Body   *RawBody
}

Alternative representation of the Block.

func (RawBlock) AsBlock

func (r RawBlock) AsBlock() (*Block, error)

type RawBody

type RawBody struct {
	Transactions [][]byte
	Uncles       []*Header
	Withdrawals  []*Withdrawal
}

RawBody is semi-parsed variant of Body, where transactions are still unparsed RLP strings It is useful in the situations when actual transaction context is not important, for example when downloading Block bodies from other peers or serving them to other peers

func (*RawBody) DecodeRLP

func (rb *RawBody) DecodeRLP(s *rlp.Stream) error

func (RawBody) EncodeRLP

func (rb RawBody) EncodeRLP(w io.Writer) error

func (RawBody) EncodingSize

func (rb RawBody) EncodingSize() int

type Receipt

type Receipt struct {
	// Consensus fields: These fields are defined by the Yellow Paper
	Type              uint8  `json:"type,omitempty"`
	PostState         []byte `json:"root" codec:"1"`
	Status            uint64 `json:"status" codec:"2"`
	CumulativeGasUsed uint64 `json:"cumulativeGasUsed" gencodec:"required" codec:"3"`
	Bloom             Bloom  `json:"logsBloom"         gencodec:"required" codec:"-"`
	Logs              Logs   `json:"logs"              gencodec:"required" codec:"-"`

	// Implementation fields: These fields are added by geth when processing a transaction.
	// They are stored in the chain database.
	TxHash          libcommon.Hash    `json:"transactionHash" gencodec:"required" codec:"-"`
	ContractAddress libcommon.Address `json:"contractAddress" codec:"-"`
	GasUsed         uint64            `json:"gasUsed" gencodec:"required" codec:"-"`

	// Inclusion information: These fields provide information about the inclusion of the
	// transaction corresponding to this receipt.
	BlockHash        libcommon.Hash `json:"blockHash,omitempty" codec:"-"`
	BlockNumber      *big.Int       `json:"blockNumber,omitempty" codec:"-"`
	TransactionIndex uint           `json:"transactionIndex" codec:"-"`
}

Receipt represents the results of a transaction. DESCRIBED: docs/programmers_guide/guide.md#organising-ethereum-state-into-a-merkle-tree

func NewReceipt

func NewReceipt(failed bool, cumulativeGasUsed uint64) *Receipt

NewReceipt creates a barebone transaction receipt, copying the init fields. Deprecated: create receipts using a struct literal instead.

func (*Receipt) CodecDecodeSelf

func (x *Receipt) CodecDecodeSelf(d *codec1978.Decoder)

func (*Receipt) CodecEncodeSelf

func (x *Receipt) CodecEncodeSelf(e *codec1978.Encoder)

func (*Receipt) Copy

func (r *Receipt) Copy() *Receipt

Copy creates a deep copy of the Receipt.

func (*Receipt) DecodeRLP

func (r *Receipt) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder, and loads the consensus fields of a receipt from an RLP stream.

func (Receipt) EncodeRLP

func (r Receipt) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder, and flattens the consensus fields of a receipt into an RLP stream. If no post state is present, byzantium fork is assumed.

func (*Receipt) IsCodecEmpty

func (x *Receipt) IsCodecEmpty() bool

func (Receipt) MarshalJSON

func (r Receipt) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*Receipt) UnmarshalJSON

func (r *Receipt) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type ReceiptForStorage

type ReceiptForStorage Receipt

ReceiptForStorage is a wrapper around a Receipt that flattens and parses the entire content of a receipt, as opposed to only the consensus fields originally.

func (*ReceiptForStorage) DecodeRLP

func (r *ReceiptForStorage) DecodeRLP(s *rlp.Stream) error

DecodeRLP implements rlp.Decoder, and loads both consensus and implementation fields of a receipt from an RLP stream.

func (*ReceiptForStorage) EncodeRLP

func (r *ReceiptForStorage) EncodeRLP(w io.Writer) error

EncodeRLP implements rlp.Encoder, and flattens all content fields of a receipt into an RLP stream.

type Receipts

type Receipts []*Receipt

Receipts implements DerivableList for receipts.

func (*Receipts) CodecDecodeSelf

func (x *Receipts) CodecDecodeSelf(d *codec1978.Decoder)

func (Receipts) CodecEncodeSelf

func (x Receipts) CodecEncodeSelf(e *codec1978.Encoder)

func (Receipts) DeriveFields

func (r Receipts) DeriveFields(hash libcommon.Hash, number uint64, txs Transactions, senders []libcommon.Address) error

DeriveFields fills the receipts with their computed fields based on consensus data and contextual infos like containing block and transactions.

func (Receipts) EncodeIndex

func (rs Receipts) EncodeIndex(i int, w *bytes.Buffer)

EncodeIndex encodes the i'th receipt to w.

func (Receipts) Len

func (rs Receipts) Len() int

Len returns the number of receipts in this list.

type ReceiptsForStorage

type ReceiptsForStorage []*ReceiptForStorage

type Signer

type Signer struct {
	// contains filtered or unexported fields
}

Signer encapsulates transaction signature handling. The name of this type is slightly misleading because Signers don't actually sign, they're just for validating and processing of signatures.

Note that this interface is not a stable API and may change at any time to accommodate new protocol rules.

func LatestSigner

func LatestSigner(config *chain.Config) *Signer

LatestSigner returns the 'most permissive' Signer available for the given chain configuration. Specifically, this enables support of EIP-155 replay protection and EIP-2930 access list transactions when their respective forks are scheduled to occur at any block number in the chain config.

Use this in transaction-handling code where the current block number is unknown. If you have the current block number available, use MakeSigner instead.

func LatestSignerForChainID

func LatestSignerForChainID(chainID *big.Int) *Signer

LatestSignerForChainID returns the 'most permissive' Signer available. Specifically, this marks support for EIP-155 replay protection, EIP-2718 typed transactions and EIP-1559 dynamic fee transaction types if chainID is non-nil.

Use this in transaction-handling code where the current block number and fork configuration are unknown. If you have a ChainConfig, use LatestSigner instead. If you have a ChainConfig and know the current block number, use MakeSigner instead.

func MakeFrontierSigner

func MakeFrontierSigner() *Signer

func MakeSigner

func MakeSigner(config *chain.Config, blockNumber uint64, blockTime uint64) *Signer

MakeSigner returns a Signer based on the given chain config and block number.

func (Signer) ChainID

func (sg Signer) ChainID() *uint256.Int

func (Signer) Equal

func (sg Signer) Equal(other Signer) bool

Equal returns true if the given signer is the same as the receiver.

func (Signer) Sender

func (sg Signer) Sender(tx Transaction) (libcommon.Address, error)

Sender returns the sender address of the transaction.

func (Signer) SenderWithContext

func (sg Signer) SenderWithContext(context *secp256k1.Context, tx Transaction) (libcommon.Address, error)

SenderWithContext returns the sender address of the transaction.

func (Signer) SignatureValues

func (sg Signer) SignatureValues(tx Transaction, sig []byte) (R, S, V *uint256.Int, err error)

SignatureValues returns the raw R, S, V values corresponding to the given signature.

func (Signer) String

func (sg Signer) String() string

type StateSyncData

type StateSyncData struct {
	ID       uint64
	Contract libcommon.Address
	Data     string
	TxHash   libcommon.Hash
}

StateSyncData represents state received from Ethereum Blockchain

type Transaction

type Transaction interface {
	Type() byte
	GetChainID() *uint256.Int
	GetNonce() uint64
	GetPrice() *uint256.Int
	GetTip() *uint256.Int
	GetEffectiveGasTip(baseFee *uint256.Int) *uint256.Int
	GetFeeCap() *uint256.Int
	Cost() *uint256.Int
	GetBlobHashes() []libcommon.Hash
	GetGas() uint64
	GetBlobGas() uint64
	GetValue() *uint256.Int
	Time() time.Time
	GetTo() *libcommon.Address
	AsMessage(s Signer, baseFee *big.Int, rules *chain.Rules) (Message, error)
	WithSignature(signer Signer, sig []byte) (Transaction, error)
	FakeSign(address libcommon.Address) (Transaction, error)
	Hash() libcommon.Hash
	SigningHash(chainID *big.Int) libcommon.Hash
	GetData() []byte
	GetAccessList() types2.AccessList
	Protected() bool
	RawSignatureValues() (*uint256.Int, *uint256.Int, *uint256.Int)
	EncodingSize() int
	EncodeRLP(w io.Writer) error
	MarshalBinary(w io.Writer) error
	// Sender returns the address derived from the signature (V, R, S) using secp256k1
	// elliptic curve and an error if it failed deriving or upon an incorrect
	// signature.
	//
	// Sender may cache the address, allowing it to be used regardless of
	// signing method. The cache is invalidated if the cached signer does
	// not match the signer used in the current call.
	Sender(Signer) (libcommon.Address, error)
	GetSender() (libcommon.Address, bool)
	SetSender(libcommon.Address)
	IsContractDeploy() bool
	Unwrap() Transaction // If this is a network wrapper, returns the unwrapped tx. Otherwise returns itself.
}

Transaction is an Ethereum transaction.

func DecodeRLPTransaction

func DecodeRLPTransaction(s *rlp.Stream) (Transaction, error)

func DecodeTransaction

func DecodeTransaction(data []byte) (Transaction, error)

DecodeTransaction decodes a transaction either in RLP or canonical format

func DecodeTransactions

func DecodeTransactions(txs [][]byte) ([]Transaction, error)

func DecodeWrappedTransaction

func DecodeWrappedTransaction(data []byte) (Transaction, error)

DecodeWrappedTransaction decodes network encoded transaction with or without envelope. When transaction is not network encoded use DecodeTransaction.

func MustSignNewTx

func MustSignNewTx(prv *ecdsa.PrivateKey, s Signer, tx Transaction) Transaction

MustSignNewTx creates a transaction and signs it. This panics if the transaction cannot be signed.

func SignNewTx

func SignNewTx(prv *ecdsa.PrivateKey, s Signer, tx Transaction) (Transaction, error)

SignNewTx creates a transaction and signs it.

func SignTx

func SignTx(tx Transaction, s Signer, prv *ecdsa.PrivateKey) (Transaction, error)

SignTx signs the transaction using the given signer and private key.

func UnmarshalBlobTxJSON

func UnmarshalBlobTxJSON(input []byte) (Transaction, error)

func UnmarshalTransactionFromBinary

func UnmarshalTransactionFromBinary(data []byte) (Transaction, error)

Parse transaction without envelope.

func UnmarshalTransactionFromJSON

func UnmarshalTransactionFromJSON(input []byte) (Transaction, error)

func UnmarshalWrappedTransactionFromBinary

func UnmarshalWrappedTransactionFromBinary(data []byte) (Transaction, error)

Parse network encoded transaction without envelope.

type TransactionMisc

type TransactionMisc struct {
	// contains filtered or unexported fields
}

TransactionMisc is collection of miscelaneous fields for transaction that is supposed to be embedded into concrete implementations of different transaction types

func (TransactionMisc) From

func (tm TransactionMisc) From() *atomic.Value

func (TransactionMisc) Time

func (tm TransactionMisc) Time() time.Time

type Transactions

type Transactions []Transaction

Transactions implements DerivableList for transactions.

func CopyTxs

func CopyTxs(in Transactions) Transactions

func TxDifference

func TxDifference(a, b Transactions) Transactions

TxDifference returns a new set which is the difference between a and b.

func (Transactions) EncodeIndex

func (s Transactions) EncodeIndex(i int, w *bytes.Buffer)

EncodeIndex encodes the i'th transaction to w. Note that this does not check for errors because we assume that *Transaction will only ever contain valid txs that were either constructed by decoding or via public API in this package.

func (Transactions) Len

func (s Transactions) Len() int

Len returns the length of s.

type TransactionsByPriceAndNonce

type TransactionsByPriceAndNonce struct {
	// contains filtered or unexported fields
}

TransactionsByPriceAndNonce represents a set of transactions that can return transactions in a profit-maximizing sorted order, while supporting removing entire batches of transactions for non-executable accounts.

func NewTransactionsByPriceAndNonce

func NewTransactionsByPriceAndNonce(signer Signer, txs TransactionsGroupedBySender) *TransactionsByPriceAndNonce

NewTransactionsByPriceAndNonce creates a transaction set that can retrieve price sorted transactions in a nonce-honouring way.

Note, the input map is reowned so the caller should not interact any more with if after providing it to the constructor.

func (*TransactionsByPriceAndNonce) Empty

func (t *TransactionsByPriceAndNonce) Empty() bool

func (*TransactionsByPriceAndNonce) Peek

Peek returns the next transaction by price.

func (*TransactionsByPriceAndNonce) Pop

func (t *TransactionsByPriceAndNonce) Pop()

Pop removes the best transaction, *not* replacing it with the next one from the same account. This should be used when a transaction cannot be executed and hence all subsequent ones should be discarded from the same account.

func (*TransactionsByPriceAndNonce) Shift

func (t *TransactionsByPriceAndNonce) Shift()

Shift replaces the current best head with the next one from the same account.

type TransactionsFixedOrder

type TransactionsFixedOrder struct {
	Transactions
}

TransactionsFixedOrder represents a set of transactions that can return transactions in a profit-maximizing sorted order, while supporting removing entire batches of transactions for non-executable accounts.

func NewTransactionsFixedOrder

func NewTransactionsFixedOrder(txs Transactions) *TransactionsFixedOrder

NewTransactionsFixedOrder creates a transaction set that can retrieve price sorted transactions in a nonce-honouring way.

Note, the input map is reowned so the caller should not interact any more with if after providing it to the constructor.

func (*TransactionsFixedOrder) Empty

func (t *TransactionsFixedOrder) Empty() bool

func (*TransactionsFixedOrder) Peek

Peek returns the next transaction by price.

func (*TransactionsFixedOrder) Pop

func (t *TransactionsFixedOrder) Pop()

Pop removes the best transaction, *not* replacing it with the next one from the same account. This should be used when a transaction cannot be executed and hence all subsequent ones should be discarded from the same account.

func (*TransactionsFixedOrder) Shift

func (t *TransactionsFixedOrder) Shift()

Shift replaces the current best head with the next one from the same account.

type TransactionsGroupedBySender

type TransactionsGroupedBySender []Transactions

TransactionsGroupedBySender - lists of transactions grouped by sender

type TransactionsStream

type TransactionsStream interface {
	Empty() bool
	Peek() Transaction
	Shift()
	Pop()
}

type TxByNonce

type TxByNonce Transactions

TxByNonce implements the sort interface to allow sorting a list of transactions by their nonces. This is usually only useful for sorting transactions from a single account, otherwise a nonce comparison doesn't make much sense.

func (TxByNonce) Len

func (s TxByNonce) Len() int

func (TxByNonce) Less

func (s TxByNonce) Less(i, j int) bool

func (TxByNonce) Swap

func (s TxByNonce) Swap(i, j int)

type TxByPriceAndTime

type TxByPriceAndTime Transactions

TxByPriceAndTime implements both the sort and the heap interface, making it useful for all at once sorting as well as individually adding and removing elements.

func (TxByPriceAndTime) Len

func (s TxByPriceAndTime) Len() int

func (TxByPriceAndTime) Less

func (s TxByPriceAndTime) Less(i, j int) bool

func (*TxByPriceAndTime) Pop

func (s *TxByPriceAndTime) Pop() interface{}

func (*TxByPriceAndTime) Push

func (s *TxByPriceAndTime) Push(x interface{})

func (TxByPriceAndTime) Swap

func (s TxByPriceAndTime) Swap(i, j int)

type Withdrawal

type Withdrawal struct {
	Index     uint64            `json:"index"`          // monotonically increasing identifier issued by consensus layer
	Validator uint64            `json:"validatorIndex"` // index of validator associated with withdrawal
	Address   libcommon.Address `json:"address"`        // target address for withdrawn ether
	Amount    uint64            `json:"amount"`         // value of withdrawal in GWei
}

Withdrawal represents a validator withdrawal from the consensus layer. See EIP-4895: Beacon chain push withdrawals as operations.

func (*Withdrawal) Clone

func (*Withdrawal) Clone() clonable.Clonable

func (*Withdrawal) DecodeRLP

func (obj *Withdrawal) DecodeRLP(s *rlp.Stream) error

func (*Withdrawal) EncodeRLP

func (obj *Withdrawal) EncodeRLP(w io.Writer) error

func (*Withdrawal) EncodingSize

func (obj *Withdrawal) EncodingSize() int

func (Withdrawal) MarshalJSON

func (w Withdrawal) MarshalJSON() ([]byte, error)

MarshalJSON marshals as JSON.

func (*Withdrawal) UnmarshalJSON

func (w *Withdrawal) UnmarshalJSON(input []byte) error

UnmarshalJSON unmarshals from JSON.

type Withdrawals

type Withdrawals []*Withdrawal

Withdrawals implements DerivableList for withdrawals.

func (Withdrawals) EncodeIndex

func (s Withdrawals) EncodeIndex(i int, w *bytes.Buffer)

EncodeIndex encodes the i'th withdrawal to w. Note that this does not check for errors because we assume that *Withdrawal will only ever contain valid withdrawals that were either constructed by decoding or via public API in this package.

func (Withdrawals) Len

func (s Withdrawals) Len() int

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL