Documentation ¶
Overview ¶
Package types contains data types related to Ethereum consensus.
Index ¶
- Constants
- Variables
- func Bloom9(data []byte) []byte
- func BloomLookup(bin Bloom, topic bytesBacked) bool
- func CalcUncleHash(uncles []*Header) common.Hash
- func DeriveSha(list DerivableList, hasher TrieHasher) common.Hash
- func FullAccountRLP(data []byte) ([]byte, error)
- func HashDifference(a, b []common.Hash) []common.Hash
- func HeaderParentHashFromRLP(header []byte) common.Hash
- func LogsBloom(logs []*Log) []byte
- func Sender(signer Signer, tx *Transaction) (common.Address, error)
- func SetFallbackError(msg string, code int)
- func SlimAccountRLP(account StateAccount) []byte
- func TrieRootHash(hash common.Hash) common.Hash
- type AccessList
- type AccessListTx
- type AccessTuple
- type Account
- type ArbitrumContractTx
- type ArbitrumDepositTx
- type ArbitrumInternalTx
- type ArbitrumLegacyTxData
- type ArbitrumRetryTx
- type ArbitrumSubmitRetryableTx
- type ArbitrumUnsignedTx
- type BlobTx
- type BlobTxSidecar
- type Block
- func (b *Block) BaseFee() *big.Int
- func (b *Block) BeaconRoot() *common.Hash
- func (b *Block) BlobGasUsed() *uint64
- func (b *Block) Bloom() Bloom
- func (b *Block) Body() *Body
- func (b *Block) Coinbase() common.Address
- func (b *Block) DecodeRLP(s *rlp.Stream) error
- func (b *Block) Difficulty() *big.Int
- func (b *Block) EncodeRLP(w io.Writer) error
- func (b *Block) ExcessBlobGas() *uint64
- func (b *Block) Extra() []byte
- func (b *Block) GasLimit() uint64
- func (b *Block) GasUsed() uint64
- func (b *Block) Hash() common.Hash
- func (b *Block) Header() *Header
- func (b *Block) MixDigest() common.Hash
- func (b *Block) Nonce() uint64
- func (b *Block) Number() *big.Int
- func (b *Block) NumberU64() uint64
- func (b *Block) ParentHash() common.Hash
- func (b *Block) ReceiptHash() common.Hash
- func (b *Block) Root() common.Hash
- func (b *Block) SanityCheck() error
- func (b *Block) Size() uint64
- func (b *Block) Time() uint64
- func (b *Block) Transaction(hash common.Hash) *Transaction
- func (b *Block) Transactions() Transactions
- func (b *Block) TxHash() common.Hash
- func (b *Block) UncleHash() common.Hash
- func (b *Block) Uncles() []*Header
- func (b *Block) WithBody(transactions []*Transaction, uncles []*Header) *Block
- func (b *Block) WithSeal(header *Header) *Block
- func (b *Block) WithWithdrawals(withdrawals []*Withdrawal) *Block
- func (b *Block) Withdrawals() Withdrawals
- type BlockNonce
- type Blocks
- type Bloom
- type Body
- type DerivableList
- type DynamicFeeTx
- type EIP155Signer
- func (s EIP155Signer) ChainID() *big.Int
- func (s EIP155Signer) Equal(s2 Signer) bool
- func (s EIP155Signer) Hash(tx *Transaction) common.Hash
- func (s EIP155Signer) Sender(tx *Transaction) (common.Address, error)
- func (s EIP155Signer) SignatureValues(tx *Transaction, sig []byte) (R, S, V *big.Int, err error)
- type FallbackClient
- type FrontierSigner
- func (s FrontierSigner) ChainID() *big.Int
- func (s FrontierSigner) Equal(s2 Signer) bool
- func (fs FrontierSigner) Hash(tx *Transaction) common.Hash
- func (fs FrontierSigner) Sender(tx *Transaction) (common.Address, error)
- func (fs FrontierSigner) SignatureValues(tx *Transaction, sig []byte) (r, s, v *big.Int, err error)
- type GenesisAlloc
- type Header
- func (h *Header) EmptyBody() bool
- func (h *Header) EmptyReceipts() bool
- func (obj *Header) EncodeRLP(_w io.Writer) error
- func (h *Header) Hash() common.Hash
- func (h Header) MarshalJSON() ([]byte, error)
- func (h *Header) SanityCheck() error
- func (h *Header) Size() common.StorageSize
- func (h *Header) UnmarshalJSON(input []byte) error
- type HeaderInfo
- type HomesteadSigner
- type LegacyTx
- type Log
- type Receipt
- func (r *Receipt) DecodeRLP(s *rlp.Stream) error
- func (r *Receipt) EncodeRLP(w io.Writer) error
- func (r *Receipt) GasUsedForL2() uint64
- func (r *Receipt) MarshalBinary() ([]byte, error)
- func (r Receipt) MarshalJSON() ([]byte, error)
- func (r *Receipt) Size() common.StorageSize
- func (r *Receipt) UnmarshalBinary(b []byte) error
- func (r *Receipt) UnmarshalJSON(input []byte) error
- type ReceiptForStorage
- type Receipts
- type Signer
- func LatestSigner(config *params.ChainConfig) Signer
- func LatestSignerForChainID(chainID *big.Int) Signer
- func MakeSigner(config *params.ChainConfig, blockNumber *big.Int, blockTime uint64) Signer
- func NewArbitrumSigner(signer Signer) Signer
- func NewCancunSigner(chainId *big.Int) Signer
- func NewEIP2930Signer(chainId *big.Int) Signer
- func NewLondonSigner(chainId *big.Int) Signer
- type SlimAccount
- type StateAccount
- type Transaction
- func MustSignNewTx(prv *ecdsa.PrivateKey, s Signer, txdata TxData) *Transaction
- func NewArbitrumLegacyTx(origTx *Transaction, hashOverride common.Hash, effectiveGas uint64, ...) (*Transaction, error)
- func NewContractCreation(nonce uint64, amount *big.Int, gasLimit uint64, gasPrice *big.Int, data []byte) *Transaction
- func NewTransaction(nonce uint64, to common.Address, amount *big.Int, gasLimit uint64, ...) *Transaction
- func NewTx(inner TxData) *Transaction
- func SignNewTx(prv *ecdsa.PrivateKey, s Signer, txdata TxData) (*Transaction, error)
- func SignTx(tx *Transaction, s Signer, prv *ecdsa.PrivateKey) (*Transaction, error)
- func (tx *Transaction) AccessList() AccessList
- func (tx *Transaction) BlobGas() uint64
- func (tx *Transaction) BlobGasFeeCap() *big.Int
- func (tx *Transaction) BlobGasFeeCapCmp(other *Transaction) int
- func (tx *Transaction) BlobGasFeeCapIntCmp(other *big.Int) int
- func (tx *Transaction) BlobHashes() []common.Hash
- func (tx *Transaction) BlobTxSidecar() *BlobTxSidecar
- func (tx *Transaction) ChainId() *big.Int
- func (tx *Transaction) Cost() *big.Int
- func (tx *Transaction) Data() []byte
- func (tx *Transaction) DecodeRLP(s *rlp.Stream) error
- func (tx *Transaction) EffectiveGasTip(baseFee *big.Int) (*big.Int, error)
- func (tx *Transaction) EffectiveGasTipCmp(other *Transaction, baseFee *big.Int) int
- func (tx *Transaction) EffectiveGasTipIntCmp(other *big.Int, baseFee *big.Int) int
- func (tx *Transaction) EffectiveGasTipValue(baseFee *big.Int) *big.Int
- func (tx *Transaction) EncodeRLP(w io.Writer) error
- func (tx *Transaction) Gas() uint64
- func (tx *Transaction) GasFeeCap() *big.Int
- func (tx *Transaction) GasFeeCapCmp(other *Transaction) int
- func (tx *Transaction) GasFeeCapIntCmp(other *big.Int) int
- func (tx *Transaction) GasPrice() *big.Int
- func (tx *Transaction) GasTipCap() *big.Int
- func (tx *Transaction) GasTipCapCmp(other *Transaction) int
- func (tx *Transaction) GasTipCapIntCmp(other *big.Int) int
- func (tx *Transaction) GetInner() TxData
- func (tx *Transaction) Hash() common.Hash
- func (tx *Transaction) MarshalBinary() ([]byte, error)
- func (tx *Transaction) MarshalJSON() ([]byte, error)
- func (tx *Transaction) Nonce() uint64
- func (tx *Transaction) Protected() bool
- func (tx *Transaction) RawSignatureValues() (v, r, s *big.Int)
- func (tx *Transaction) SetTime(t time.Time)
- func (tx *Transaction) Size() uint64
- func (tx *Transaction) SkipAccountChecks() bool
- func (tx *Transaction) Time() time.Time
- func (tx *Transaction) To() *common.Address
- func (tx *Transaction) Type() uint8
- func (tx *Transaction) UnmarshalBinary(b []byte) error
- func (tx *Transaction) UnmarshalJSON(input []byte) error
- func (tx *Transaction) Value() *big.Int
- func (tx *Transaction) WithBlobTxSidecar(sideCar *BlobTxSidecar) *Transaction
- func (tx *Transaction) WithSignature(signer Signer, sig []byte) (*Transaction, error)
- func (tx *Transaction) WithoutBlobTxSidecar() *Transaction
- type Transactions
- type TrieHasher
- type TxByNonce
- type TxData
- type Withdrawal
- type Withdrawals
Constants ¶
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 )
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) )
const ( ArbitrumDepositTxType = 0x64 ArbitrumUnsignedTxType = 0x65 ArbitrumContractTxType = 0x66 ArbitrumRetryTxType = 0x68 ArbitrumSubmitRetryableTxType = 0x69 ArbitrumInternalTxType = 0x6A ArbitrumLegacyTxType = 0x78 LegacyTxType = 0x00 AccessListTxType = 0x01 DynamicFeeTxType = 0x02 BlobTxType = 0x03 )
Transaction types.
Variables ¶
var ( // EmptyRootHash is the known root hash of an empty merkle trie. EmptyRootHash = common.HexToHash("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") // EmptyUncleHash is the known hash of the empty uncle set. EmptyUncleHash = rlpHash([]*Header(nil)) // 1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347 // EmptyCodeHash is the known hash of the empty EVM bytecode. EmptyCodeHash = crypto.Keccak256Hash(nil) // c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470 // EmptyTxsHash is the known hash of the empty transaction set. EmptyTxsHash = common.HexToHash("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") // EmptyReceiptsHash is the known hash of the empty receipt set. EmptyReceiptsHash = common.HexToHash("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") // EmptyWithdrawalsHash is the known hash of the empty withdrawal set. EmptyWithdrawalsHash = common.HexToHash("56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") // EmptyVerkleHash is the known hash of an empty verkle trie. EmptyVerkleHash = common.Hash{} )
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") ErrGasFeeCapTooLow = errors.New("fee cap less than base fee") )
var ArbAddressTableAddress = common.HexToAddress("0x66")
var ArbAggregatorAddress = common.HexToAddress("0x6d")
var ArbBLSAddress = common.HexToAddress("0x67")
var ArbDebugAddress = common.HexToAddress("0xff")
var ArbFunctionTableAddress = common.HexToAddress("0x68")
var ArbGasInfoAddress = common.HexToAddress("0x6c")
var ArbInfoAddress = common.HexToAddress("0x65")
var ArbOwnerAddress = common.HexToAddress("0x70")
var ArbOwnerPublicAddress = common.HexToAddress("0x6b")
var ArbRetryableTxAddress = common.HexToAddress("0x6e")
var ArbStatisticsAddress = common.HexToAddress("0x6f")
var ArbSysAddress = common.HexToAddress("0x64")
var ArbWasmAddress = common.HexToAddress("0x71")
var ArbWasmCacheAddress = common.HexToAddress("0x72")
var ArbosAddress = common.HexToAddress("0xa4b05")
var ArbosStateAddress = common.HexToAddress("0xA4B05FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF")
var ArbosTestAddress = common.HexToAddress("0x69")
var ErrInvalidChainId = errors.New("invalid chain id for signer")
var ErrUseFallback = fallbackError{}
var NodeInterfaceAddress = common.HexToAddress("0xc8")
var NodeInterfaceDebugAddress = common.HexToAddress("0xc9")
Functions ¶
func BloomLookup ¶
BloomLookup is a convenience-method to check presence in the bloom filter
func CalcUncleHash ¶
func DeriveSha ¶
func DeriveSha(list DerivableList, hasher TrieHasher) common.Hash
DeriveSha creates the tree hashes of transactions, receipts, and withdrawals in a block header.
func FullAccountRLP ¶
FullAccountRLP converts data on the 'slim RLP' format into the full RLP-format.
func HashDifference ¶
HashDifference returns a new set which is the difference between a and b.
func HeaderParentHashFromRLP ¶
HeaderParentHashFromRLP returns the parentHash of an RLP-encoded header. If 'header' is invalid, the zero hash is returned.
func Sender ¶
func Sender(signer Signer, tx *Transaction) (common.Address, 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.
func SetFallbackError ¶
func SlimAccountRLP ¶
func SlimAccountRLP(account StateAccount) []byte
SlimAccountRLP encodes the state account in 'slim RLP' format.
Types ¶
type AccessList ¶
type AccessList []AccessTuple
AccessList is an EIP-2930 access list.
func (AccessList) StorageKeys ¶
func (al AccessList) StorageKeys() int
StorageKeys returns the total number of storage keys in the access list.
type AccessListTx ¶
type AccessListTx struct { ChainID *big.Int // destination chain ID Nonce uint64 // nonce of sender account GasPrice *big.Int // wei per gas Gas uint64 // gas limit To *common.Address `rlp:"nil"` // nil means contract creation Value *big.Int // wei amount Data []byte // contract invocation input data AccessList AccessList // EIP-2930 access list V, R, S *big.Int // signature values }
AccessListTx is the data of EIP-2930 access list transactions.
type AccessTuple ¶
type AccessTuple struct { Address common.Address `json:"address" gencodec:"required"` StorageKeys []common.Hash `json:"storageKeys" gencodec:"required"` }
AccessTuple is the element type of an access list.
func (AccessTuple) MarshalJSON ¶
func (a AccessTuple) MarshalJSON() ([]byte, error)
MarshalJSON marshals as JSON.
func (*AccessTuple) UnmarshalJSON ¶
func (a *AccessTuple) UnmarshalJSON(input []byte) error
UnmarshalJSON unmarshals from JSON.
type Account ¶
type Account struct { Code []byte `json:"code,omitempty"` Storage map[common.Hash]common.Hash `json:"storage,omitempty"` Balance *big.Int `json:"balance" gencodec:"required"` Nonce uint64 `json:"nonce,omitempty"` // used in tests PrivateKey []byte `json:"secretKey,omitempty"` }
Account represents an Ethereum account and its attached data. This type is used to specify accounts in the genesis block state, and is also useful for JSON encoding/decoding of accounts.
func (Account) MarshalJSON ¶
MarshalJSON marshals as JSON.
func (*Account) UnmarshalJSON ¶
UnmarshalJSON unmarshals from JSON.
type ArbitrumContractTx ¶
type ArbitrumDepositTx ¶
type ArbitrumInternalTx ¶
type ArbitrumLegacyTxData ¶
type ArbitrumLegacyTxData struct { LegacyTx HashOverride common.Hash // Hash cannot be locally computed from other fields EffectiveGasPrice uint64 L1BlockNumber uint64 Sender *common.Address `rlp:"optional,nil"` // only used in unsigned Txs }
func (*ArbitrumLegacyTxData) EncodeOnlyLegacyInto ¶
func (tx *ArbitrumLegacyTxData) EncodeOnlyLegacyInto(w *bytes.Buffer)
type ArbitrumRetryTx ¶
type ArbitrumRetryTx struct { ChainId *big.Int Nonce uint64 From common.Address GasFeeCap *big.Int // wei per gas Gas uint64 // gas limit To *common.Address `rlp:"nil"` // nil means contract creation Value *big.Int // wei amount Data []byte // contract invocation input data TicketId common.Hash RefundTo common.Address MaxRefund *big.Int // the maximum refund sent to RefundTo (the rest goes to From) SubmissionFeeRefund *big.Int // the submission fee to refund if successful (capped by MaxRefund) }
type ArbitrumSubmitRetryableTx ¶
type ArbitrumSubmitRetryableTx struct { ChainId *big.Int RequestId common.Hash From common.Address L1BaseFee *big.Int DepositValue *big.Int GasFeeCap *big.Int // wei per gas Gas uint64 // gas limit RetryTo *common.Address `rlp:"nil"` // nil means contract creation RetryValue *big.Int // wei amount Beneficiary common.Address MaxSubmissionFee *big.Int FeeRefundAddr common.Address RetryData []byte // contract invocation input data }
type ArbitrumUnsignedTx ¶
type ArbitrumUnsignedTx struct { ChainId *big.Int From common.Address Nonce uint64 // nonce of sender account GasFeeCap *big.Int // wei per gas Gas uint64 // gas limit To *common.Address `rlp:"nil"` // nil means contract creation Value *big.Int // wei amount Data []byte // contract invocation input data }
type BlobTx ¶
type BlobTx struct { ChainID *uint256.Int Nonce uint64 GasTipCap *uint256.Int // a.k.a. maxPriorityFeePerGas GasFeeCap *uint256.Int // a.k.a. maxFeePerGas Gas uint64 To common.Address Value *uint256.Int Data []byte AccessList AccessList BlobFeeCap *uint256.Int // a.k.a. maxFeePerBlobGas BlobHashes []common.Hash // A blob transaction can optionally contain blobs. This field must be set when BlobTx // is used to create a transaction for signing. Sidecar *BlobTxSidecar `rlp:"-"` // Signature values V *uint256.Int `json:"v" gencodec:"required"` R *uint256.Int `json:"r" gencodec:"required"` S *uint256.Int `json:"s" gencodec:"required"` }
BlobTx represents an EIP-4844 transaction.
type BlobTxSidecar ¶
type BlobTxSidecar struct { Blobs []kzg4844.Blob // Blobs needed by the blob pool Commitments []kzg4844.Commitment // Commitments needed by the blob pool Proofs []kzg4844.Proof // Proofs needed by the blob pool }
BlobTxSidecar contains the blobs of a blob transaction.
func (*BlobTxSidecar) BlobHashes ¶
func (sc *BlobTxSidecar) BlobHashes() []common.Hash
BlobHashes computes the blob hashes of the given blobs.
type Block ¶
type Block struct { // These fields are used by package eth to track // inter-peer block relay. ReceivedAt time.Time ReceivedFrom interface{} // contains filtered or unexported fields }
Block represents an Ethereum block.
Note the Block type tries to be 'immutable', and contains certain caches that rely on that. The rules around block immutability are as follows:
We copy all data when the block is constructed. This makes references held inside the block independent of whatever value was passed in.
We copy all header data on access. This is because any change to the header would mess up the cached hash and size values in the block. Calling code is expected to take advantage of this to avoid over-allocating!
When new body data is attached to the block, a shallow copy of the block is returned. This ensures block modifications are race-free.
We do not copy body data on access because it does not affect the caches, and also because it would be too expensive.
func NewBlock ¶
func NewBlock(header *Header, txs []*Transaction, uncles []*Header, receipts []*Receipt, hasher TrieHasher) *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 and Bloom in header are ignored and set to values derived from the given txs, uncles and receipts.
func NewBlockWithHeader ¶
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 NewBlockWithWithdrawals ¶
func NewBlockWithWithdrawals(header *Header, txs []*Transaction, uncles []*Header, receipts []*Receipt, withdrawals []*Withdrawal, hasher TrieHasher) *Block
NewBlockWithWithdrawals creates a new block with withdrawals. The input data is copied, changes to header and to the field values will not affect the block.
The values of TxHash, UncleHash, ReceiptHash and Bloom in header are ignored and set to values derived from the given txs, uncles and receipts.
func (*Block) BeaconRoot ¶
func (*Block) BlobGasUsed ¶
func (*Block) Body ¶
Body returns the non-header content of the block. Note the returned data is not an independent copy.
func (*Block) Difficulty ¶
func (*Block) ExcessBlobGas ¶
func (*Block) Hash ¶
Hash returns the keccak256 hash of b's header. The hash is computed on the first call and cached thereafter.
func (*Block) ParentHash ¶
func (*Block) ReceiptHash ¶
func (*Block) SanityCheck ¶
SanityCheck can be used to prevent that unbounded fields are stuffed with junk data to add processing overhead
func (*Block) Size ¶
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) Transaction ¶
func (b *Block) Transaction(hash common.Hash) *Transaction
func (*Block) Transactions ¶
func (b *Block) Transactions() Transactions
func (*Block) WithBody ¶
func (b *Block) WithBody(transactions []*Transaction, uncles []*Header) *Block
WithBody returns a copy of the block with the given transaction and uncle contents.
func (*Block) WithSeal ¶
WithSeal returns a new block with the data from b but the header replaced with the sealed one.
func (*Block) WithWithdrawals ¶
func (b *Block) WithWithdrawals(withdrawals []*Withdrawal) *Block
WithWithdrawals returns a copy of the block containing the given withdrawals.
func (*Block) Withdrawals ¶
func (b *Block) Withdrawals() Withdrawals
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 Bloom ¶
type Bloom [BloomByteLength]byte
Bloom represents a 2048 bit bloom filter.
func BytesToBloom ¶
BytesToBloom converts a byte slice to a bloom filter. It panics if b is not of suitable size.
func CreateBloom ¶
CreateBloom creates a bloom filter out of the give Receipts (+Logs)
func (Bloom) Big ¶
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) MarshalText ¶
MarshalText encodes b as a hex string with 0x prefix.
func (*Bloom) SetBytes ¶
SetBytes sets the content of b to the given bytes. It panics if d is not of suitable size.
func (*Bloom) UnmarshalText ¶
UnmarshalText b as a hex string with 0x prefix.
type Body ¶
type Body struct { Transactions []*Transaction Uncles []*Header Withdrawals []*Withdrawal `rlp:"optional"` }
Body is a simple (mutable, non-safe) data container for storing and moving a block's data contents (transactions and uncles) together.
type DerivableList ¶
DerivableList is the input to DeriveSha. It is implemented by the 'Transactions' and 'Receipts' types. This is internal, do not use these methods.
type DynamicFeeTx ¶
type DynamicFeeTx struct { ChainID *big.Int Nonce uint64 GasTipCap *big.Int // a.k.a. maxPriorityFeePerGas GasFeeCap *big.Int // a.k.a. maxFeePerGas Gas uint64 To *common.Address `rlp:"nil"` // nil means contract creation Value *big.Int Data []byte AccessList AccessList // Signature values V *big.Int `json:"v" gencodec:"required"` R *big.Int `json:"r" gencodec:"required"` S *big.Int `json:"s" gencodec:"required"` }
DynamicFeeTx represents an EIP-1559 transaction.
type EIP155Signer ¶
type EIP155Signer struct {
// contains filtered or unexported fields
}
EIP155Signer implements Signer using the EIP-155 rules. This accepts transactions which are replay-protected as well as unprotected homestead transactions.
func NewEIP155Signer ¶
func NewEIP155Signer(chainId *big.Int) EIP155Signer
func (EIP155Signer) ChainID ¶
func (s EIP155Signer) ChainID() *big.Int
func (EIP155Signer) Equal ¶
func (s EIP155Signer) Equal(s2 Signer) bool
func (EIP155Signer) Hash ¶
func (s EIP155Signer) Hash(tx *Transaction) common.Hash
Hash returns the hash to be signed by the sender. It does not uniquely identify the transaction.
func (EIP155Signer) Sender ¶
func (s EIP155Signer) Sender(tx *Transaction) (common.Address, error)
func (EIP155Signer) SignatureValues ¶
func (s EIP155Signer) SignatureValues(tx *Transaction, sig []byte) (R, S, V *big.Int, err error)
SignatureValues returns signature values. This signature needs to be in the [R || S || V] format where V is 0 or 1.
type FallbackClient ¶
type FrontierSigner ¶
type FrontierSigner struct{}
FrontierSigner implements Signer interface using the frontier rules.
func (FrontierSigner) ChainID ¶
func (s FrontierSigner) ChainID() *big.Int
func (FrontierSigner) Equal ¶
func (s FrontierSigner) Equal(s2 Signer) bool
func (FrontierSigner) Hash ¶
func (fs FrontierSigner) Hash(tx *Transaction) common.Hash
Hash returns the hash to be signed by the sender. It does not uniquely identify the transaction.
func (FrontierSigner) Sender ¶
func (fs FrontierSigner) Sender(tx *Transaction) (common.Address, error)
func (FrontierSigner) SignatureValues ¶
func (fs FrontierSigner) SignatureValues(tx *Transaction, sig []byte) (r, s, v *big.Int, err error)
SignatureValues returns signature values. This signature needs to be in the [R || S || V] format where V is 0 or 1.
type GenesisAlloc ¶
GenesisAlloc specifies the initial state of a genesis block.
func (*GenesisAlloc) UnmarshalJSON ¶
func (ga *GenesisAlloc) UnmarshalJSON(data []byte) error
type Header ¶
type Header struct { ParentHash common.Hash `json:"parentHash" gencodec:"required"` UncleHash common.Hash `json:"sha3Uncles" gencodec:"required"` Coinbase common.Address `json:"miner"` Root common.Hash `json:"stateRoot" gencodec:"required"` TxHash common.Hash `json:"transactionsRoot" gencodec:"required"` ReceiptHash common.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 common.Hash `json:"mixHash"` Nonce BlockNonce `json:"nonce"` // BaseFee was added by EIP-1559 and is ignored in legacy headers. BaseFee *big.Int `json:"baseFeePerGas" rlp:"optional"` // WithdrawalsHash was added by EIP-4895 and is ignored in legacy headers. WithdrawalsHash *common.Hash `json:"withdrawalsRoot" rlp:"optional"` // BlobGasUsed was added by EIP-4844 and is ignored in legacy headers. BlobGasUsed *uint64 `json:"blobGasUsed" rlp:"optional"` // ExcessBlobGas was added by EIP-4844 and is ignored in legacy headers. ExcessBlobGas *uint64 `json:"excessBlobGas" rlp:"optional"` // ParentBeaconRoot was added by EIP-4788 and is ignored in legacy headers. ParentBeaconRoot *common.Hash `json:"parentBeaconBlockRoot" rlp:"optional"` }
Header represents a block header in the Ethereum blockchain.
func CopyHeader ¶
CopyHeader creates a deep copy of a block header.
func (*Header) EmptyBody ¶
EmptyBody returns true if there is no additional 'body' to complete the header that is: no transactions, no uncles and no withdrawals.
func (*Header) EmptyReceipts ¶
EmptyReceipts returns true if there are no receipts for this header/block.
func (*Header) Hash ¶
Hash returns the block hash of the header, which is simply the keccak256 hash of its RLP encoding.
func (Header) MarshalJSON ¶
MarshalJSON marshals as JSON.
func (*Header) SanityCheck ¶
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 ¶
UnmarshalJSON unmarshals from JSON.
type HeaderInfo ¶
type HeaderInfo struct { SendRoot common.Hash SendCount uint64 L1BlockNumber uint64 ArbOSFormatVersion uint64 }
func DeserializeHeaderExtraInformation ¶
func DeserializeHeaderExtraInformation(header *Header) HeaderInfo
func (HeaderInfo) UpdateHeaderWithInfo ¶
func (info HeaderInfo) UpdateHeaderWithInfo(header *Header)
type HomesteadSigner ¶
type HomesteadSigner struct{ FrontierSigner }
HomesteadSigner implements Signer interface using the homestead rules.
func (HomesteadSigner) ChainID ¶
func (s HomesteadSigner) ChainID() *big.Int
func (HomesteadSigner) Equal ¶
func (s HomesteadSigner) Equal(s2 Signer) bool
func (HomesteadSigner) Sender ¶
func (hs HomesteadSigner) Sender(tx *Transaction) (common.Address, error)
func (HomesteadSigner) SignatureValues ¶
func (hs HomesteadSigner) SignatureValues(tx *Transaction, sig []byte) (r, s, v *big.Int, err error)
SignatureValues returns signature values. This signature needs to be in the [R || S || V] format where V is 0 or 1.
type LegacyTx ¶
type LegacyTx struct { Nonce uint64 // nonce of sender account GasPrice *big.Int // wei per gas Gas uint64 // gas limit To *common.Address `rlp:"nil"` // nil means contract creation Value *big.Int // wei amount Data []byte // contract invocation input data V, R, S *big.Int // signature values }
LegacyTx is the transaction data of the original Ethereum transactions.
type Log ¶
type Log struct { // Consensus fields: // address of the contract that generated the event Address common.Address `json:"address" gencodec:"required"` // list of topics provided by the contract. Topics []common.Hash `json:"topics" gencodec:"required"` // supplied by the contract, usually ABI-encoded Data []byte `json:"data" gencodec:"required"` // 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" rlp:"-"` // hash of the transaction TxHash common.Hash `json:"transactionHash" gencodec:"required" rlp:"-"` // index of the transaction in the block TxIndex uint `json:"transactionIndex" rlp:"-"` // hash of the block in which the transaction was included BlockHash common.Hash `json:"blockHash" rlp:"-"` // index of the log in the block Index uint `json:"logIndex" rlp:"-"` // 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" rlp:"-"` }
Log represents a contract log event. These events are generated by the LOG opcode and stored/indexed by the node.
func (*Log) UnmarshalJSON ¶
UnmarshalJSON unmarshals from JSON.
type Receipt ¶
type Receipt struct { // Arbitrum Implementation fields GasUsedForL1 uint64 `json:"gasUsedForL1"` // Consensus fields: These fields are defined by the Yellow Paper Type uint8 `json:"type,omitempty"` PostState []byte `json:"root"` Status uint64 `json:"status"` CumulativeGasUsed uint64 `json:"cumulativeGasUsed" gencodec:"required"` Bloom Bloom `json:"logsBloom" gencodec:"required"` Logs []*Log `json:"logs" gencodec:"required"` // Implementation fields: These fields are added by geth when processing a transaction. TxHash common.Hash `json:"transactionHash" gencodec:"required"` ContractAddress common.Address `json:"contractAddress"` GasUsed uint64 `json:"gasUsed" gencodec:"required"` EffectiveGasPrice *big.Int `json:"effectiveGasPrice"` // required, but tag omitted for backwards compatibility BlobGasUsed uint64 `json:"blobGasUsed,omitempty"` BlobGasPrice *big.Int `json:"blobGasPrice,omitempty"` // Inclusion information: These fields provide information about the inclusion of the // transaction corresponding to this receipt. BlockHash common.Hash `json:"blockHash,omitempty"` BlockNumber *big.Int `json:"blockNumber,omitempty"` TransactionIndex uint `json:"transactionIndex"` }
Receipt represents the results of a transaction.
func NewReceipt ¶
NewReceipt creates a barebone transaction receipt, copying the init fields. Deprecated: create receipts using a struct literal instead.
func (*Receipt) DecodeRLP ¶
DecodeRLP implements rlp.Decoder, and loads the consensus fields of a receipt from an RLP stream.
func (*Receipt) EncodeRLP ¶
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) GasUsedForL2 ¶
func (*Receipt) MarshalBinary ¶
MarshalBinary returns the consensus encoding of the receipt.
func (Receipt) MarshalJSON ¶
MarshalJSON marshals as JSON.
func (*Receipt) Size ¶
func (r *Receipt) 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 (*Receipt) UnmarshalBinary ¶
UnmarshalBinary decodes the consensus encoding of receipts. It supports legacy RLP receipts and EIP-2718 typed receipts.
func (*Receipt) UnmarshalJSON ¶
UnmarshalJSON unmarshals from JSON.
type ReceiptForStorage ¶
type ReceiptForStorage Receipt
ReceiptForStorage is a wrapper around a Receipt with RLP serialization that omits the Bloom field and deserialization that re-computes it.
type Receipts ¶
type Receipts []*Receipt
Receipts implements DerivableList for receipts.
func (Receipts) DeriveFields ¶
func (rs Receipts) DeriveFields(config *params.ChainConfig, hash common.Hash, number uint64, time uint64, baseFee *big.Int, blobGasPrice *big.Int, txs []*Transaction) error
DeriveFields fills the receipts with their computed fields based on consensus data and contextual infos like containing block and transactions.
func (Receipts) EncodeIndex ¶
EncodeIndex encodes the i'th receipt to w.
type Signer ¶
type Signer interface { // Sender returns the sender address of the transaction. Sender(tx *Transaction) (common.Address, error) // SignatureValues returns the raw R, S, V values corresponding to the // given signature. SignatureValues(tx *Transaction, sig []byte) (r, s, v *big.Int, err error) ChainID() *big.Int // Hash returns 'signature hash', i.e. the transaction hash that is signed by the // private key. This hash does not uniquely identify the transaction. Hash(tx *Transaction) common.Hash // Equal returns true if the given signer is the same as the receiver. Equal(Signer) bool }
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 *params.ChainConfig) Signer
func LatestSignerForChainID ¶
func MakeSigner ¶
MakeSigner returns a Signer based on the given chain config and block number.
func NewArbitrumSigner ¶
func NewCancunSigner ¶
NewCancunSigner returns a signer that accepts - EIP-4844 blob transactions - EIP-1559 dynamic fee transactions - EIP-2930 access list transactions, - EIP-155 replay protected transactions, and - legacy Homestead transactions.
func NewEIP2930Signer ¶
NewEIP2930Signer returns a signer that accepts EIP-2930 access list transactions, EIP-155 replay protected transactions, and legacy Homestead transactions.
func NewLondonSigner ¶
NewLondonSigner returns a signer that accepts - EIP-1559 dynamic fee transactions - EIP-2930 access list transactions, - EIP-155 replay protected transactions, and - legacy Homestead transactions.
type SlimAccount ¶
type SlimAccount struct { Nonce uint64 Balance *uint256.Int Root []byte // Nil if root equals to types.EmptyRootHash CodeHash []byte // Nil if hash equals to types.EmptyCodeHash }
SlimAccount is a modified version of an Account, where the root is replaced with a byte slice. This format can be used to represent full-consensus format or slim format which replaces the empty root and code hash as nil byte slice.
type StateAccount ¶
type StateAccount struct { Nonce uint64 Balance *uint256.Int Root common.Hash // merkle root of the storage trie CodeHash []byte }
StateAccount is the Ethereum consensus representation of accounts. These objects are stored in the main account trie.
func FullAccount ¶
func FullAccount(data []byte) (*StateAccount, error)
FullAccount decodes the data on the 'slim RLP' format and returns the consensus format account.
func NewEmptyStateAccount ¶
func NewEmptyStateAccount() *StateAccount
NewEmptyStateAccount constructs an empty state account.
func (*StateAccount) Copy ¶
func (acct *StateAccount) Copy() *StateAccount
Copy returns a deep-copied state account object.
type Transaction ¶
type Transaction struct { // Arbitrum cache: must be atomically accessed CalldataUnits uint64 // contains filtered or unexported fields }
Transaction is an Ethereum transaction.
func MustSignNewTx ¶
func MustSignNewTx(prv *ecdsa.PrivateKey, s Signer, txdata TxData) *Transaction
MustSignNewTx creates a transaction and signs it. This panics if the transaction cannot be signed.
func NewArbitrumLegacyTx ¶
func NewArbitrumLegacyTx(origTx *Transaction, hashOverride common.Hash, effectiveGas uint64, l1Block uint64, senderOverride *common.Address) (*Transaction, error)
func NewContractCreation ¶
func NewContractCreation(nonce uint64, amount *big.Int, gasLimit uint64, gasPrice *big.Int, data []byte) *Transaction
NewContractCreation creates an unsigned legacy transaction. Deprecated: use NewTx instead.
func NewTransaction ¶
func NewTransaction(nonce uint64, to common.Address, amount *big.Int, gasLimit uint64, gasPrice *big.Int, data []byte) *Transaction
NewTransaction creates an unsigned legacy transaction. Deprecated: use NewTx instead.
func SignNewTx ¶
func SignNewTx(prv *ecdsa.PrivateKey, s Signer, txdata TxData) (*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 (*Transaction) AccessList ¶
func (tx *Transaction) AccessList() AccessList
AccessList returns the access list of the transaction.
func (*Transaction) BlobGas ¶
func (tx *Transaction) BlobGas() uint64
BlobGas returns the blob gas limit of the transaction for blob transactions, 0 otherwise.
func (*Transaction) BlobGasFeeCap ¶
func (tx *Transaction) BlobGasFeeCap() *big.Int
BlobGasFeeCap returns the blob gas fee cap per blob gas of the transaction for blob transactions, nil otherwise.
func (*Transaction) BlobGasFeeCapCmp ¶
func (tx *Transaction) BlobGasFeeCapCmp(other *Transaction) int
BlobGasFeeCapCmp compares the blob fee cap of two transactions.
func (*Transaction) BlobGasFeeCapIntCmp ¶
func (tx *Transaction) BlobGasFeeCapIntCmp(other *big.Int) int
BlobGasFeeCapIntCmp compares the blob fee cap of the transaction against the given blob fee cap.
func (*Transaction) BlobHashes ¶
func (tx *Transaction) BlobHashes() []common.Hash
BlobHashes returns the hashes of the blob commitments for blob transactions, nil otherwise.
func (*Transaction) BlobTxSidecar ¶
func (tx *Transaction) BlobTxSidecar() *BlobTxSidecar
BlobTxSidecar returns the sidecar of a blob transaction, nil otherwise.
func (*Transaction) ChainId ¶
func (tx *Transaction) ChainId() *big.Int
ChainId returns the EIP155 chain ID of the transaction. The return value will always be non-nil. For legacy transactions which are not replay-protected, the return value is zero.
func (*Transaction) Cost ¶
func (tx *Transaction) Cost() *big.Int
Cost returns (gas * gasPrice) + (blobGas * blobGasPrice) + value.
func (*Transaction) Data ¶
func (tx *Transaction) Data() []byte
Data returns the input data of the transaction.
func (*Transaction) DecodeRLP ¶
func (tx *Transaction) DecodeRLP(s *rlp.Stream) error
DecodeRLP implements rlp.Decoder
func (*Transaction) EffectiveGasTip ¶
EffectiveGasTip returns the effective miner gasTipCap for the given base fee. Note: if the effective gasTipCap is negative, this method returns both error the actual negative value, _and_ ErrGasFeeCapTooLow
func (*Transaction) EffectiveGasTipCmp ¶
func (tx *Transaction) EffectiveGasTipCmp(other *Transaction, baseFee *big.Int) int
EffectiveGasTipCmp compares the effective gasTipCap of two transactions assuming the given base fee.
func (*Transaction) EffectiveGasTipIntCmp ¶
EffectiveGasTipIntCmp compares the effective gasTipCap of a transaction to the given gasTipCap.
func (*Transaction) EffectiveGasTipValue ¶
func (tx *Transaction) EffectiveGasTipValue(baseFee *big.Int) *big.Int
EffectiveGasTipValue is identical to EffectiveGasTip, but does not return an error in case the effective gasTipCap is negative
func (*Transaction) EncodeRLP ¶
func (tx *Transaction) EncodeRLP(w io.Writer) error
EncodeRLP implements rlp.Encoder
func (*Transaction) Gas ¶
func (tx *Transaction) Gas() uint64
Gas returns the gas limit of the transaction.
func (*Transaction) GasFeeCap ¶
func (tx *Transaction) GasFeeCap() *big.Int
GasFeeCap returns the fee cap per gas of the transaction.
func (*Transaction) GasFeeCapCmp ¶
func (tx *Transaction) GasFeeCapCmp(other *Transaction) int
GasFeeCapCmp compares the fee cap of two transactions.
func (*Transaction) GasFeeCapIntCmp ¶
func (tx *Transaction) GasFeeCapIntCmp(other *big.Int) int
GasFeeCapIntCmp compares the fee cap of the transaction against the given fee cap.
func (*Transaction) GasPrice ¶
func (tx *Transaction) GasPrice() *big.Int
GasPrice returns the gas price of the transaction.
func (*Transaction) GasTipCap ¶
func (tx *Transaction) GasTipCap() *big.Int
GasTipCap returns the gasTipCap per gas of the transaction.
func (*Transaction) GasTipCapCmp ¶
func (tx *Transaction) GasTipCapCmp(other *Transaction) int
GasTipCapCmp compares the gasTipCap of two transactions.
func (*Transaction) GasTipCapIntCmp ¶
func (tx *Transaction) GasTipCapIntCmp(other *big.Int) int
GasTipCapIntCmp compares the gasTipCap of the transaction against the given gasTipCap.
func (*Transaction) GetInner ¶
func (tx *Transaction) GetInner() TxData
func (*Transaction) Hash ¶
func (tx *Transaction) Hash() common.Hash
Hash returns the transaction hash.
func (*Transaction) MarshalBinary ¶
func (tx *Transaction) MarshalBinary() ([]byte, 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 (*Transaction) MarshalJSON ¶
func (tx *Transaction) MarshalJSON() ([]byte, error)
MarshalJSON marshals as JSON with a hash.
func (*Transaction) Nonce ¶
func (tx *Transaction) Nonce() uint64
Nonce returns the sender account nonce of the transaction.
func (*Transaction) Protected ¶
func (tx *Transaction) Protected() bool
Protected says whether the transaction is replay-protected.
func (*Transaction) RawSignatureValues ¶
func (tx *Transaction) RawSignatureValues() (v, r, s *big.Int)
RawSignatureValues returns the V, R, S signature values of the transaction. The return values should not be modified by the caller. The return values may be nil or zero, if the transaction is unsigned.
func (*Transaction) SetTime ¶
func (tx *Transaction) SetTime(t time.Time)
SetTime sets the decoding time of a transaction. This is used by tests to set arbitrary times and by persistent transaction pools when loading old txs from disk.
func (*Transaction) Size ¶
func (tx *Transaction) Size() uint64
Size returns the true encoded storage size of the transaction, either by encoding and returning it, or returning a previously cached value.
func (*Transaction) SkipAccountChecks ¶
func (tx *Transaction) SkipAccountChecks() bool
Returns true if nonce checks should be skipped based on inner's isFake() This also disables requiring that sender is an EOA and not a contract
func (*Transaction) Time ¶
func (tx *Transaction) Time() time.Time
Time returns the time when the transaction was first seen on the network. It is a heuristic to prefer mining older txs vs new all other things equal.
func (*Transaction) To ¶
func (tx *Transaction) To() *common.Address
To returns the recipient address of the transaction. For contract-creation transactions, To returns nil.
func (*Transaction) UnmarshalBinary ¶
func (tx *Transaction) UnmarshalBinary(b []byte) error
UnmarshalBinary decodes the canonical encoding of transactions. It supports legacy RLP transactions and EIP-2718 typed transactions.
func (*Transaction) UnmarshalJSON ¶
func (tx *Transaction) UnmarshalJSON(input []byte) error
UnmarshalJSON unmarshals from JSON.
func (*Transaction) Value ¶
func (tx *Transaction) Value() *big.Int
Value returns the ether amount of the transaction.
func (*Transaction) WithBlobTxSidecar ¶
func (tx *Transaction) WithBlobTxSidecar(sideCar *BlobTxSidecar) *Transaction
WithBlobTxSidecar returns a copy of tx with the blob sidecar added.
func (*Transaction) WithSignature ¶
func (tx *Transaction) WithSignature(signer Signer, sig []byte) (*Transaction, error)
WithSignature returns a new transaction with the given signature. This signature needs to be in the [R || S || V] format where V is 0 or 1.
func (*Transaction) WithoutBlobTxSidecar ¶
func (tx *Transaction) WithoutBlobTxSidecar() *Transaction
WithoutBlobTxSidecar returns a copy of tx with the blob sidecar removed.
type Transactions ¶
type Transactions []*Transaction
Transactions implements DerivableList for 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.
type TrieHasher ¶
TrieHasher is the tool used to calculate the hash of derivable list. This is internal, do not use.
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.
type TxData ¶
type TxData interface {
// contains filtered or unexported methods
}
TxData is the underlying data of a transaction.
This is implemented by DynamicFeeTx, LegacyTx and AccessListTx.
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 common.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.
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.
Source Files ¶
- account.go
- arb_types.go
- arbitrum_legacy_tx.go
- arbitrum_signer.go
- block.go
- bloom9.go
- gen_access_tuple.go
- gen_account.go
- gen_account_rlp.go
- gen_header_json.go
- gen_header_rlp.go
- gen_log_json.go
- gen_log_rlp.go
- gen_receipt_json.go
- gen_withdrawal_json.go
- gen_withdrawal_rlp.go
- hashes.go
- hashing.go
- log.go
- receipt.go
- receipt_arbitrum.go
- state_account.go
- transaction.go
- transaction_marshalling.go
- transaction_signing.go
- tx_access_list.go
- tx_blob.go
- tx_dynamic_fee.go
- tx_legacy.go
- withdrawal.go