Documentation ¶
Overview ¶
Package types contains data types related to Ethereum consensus.
Index ¶
- Constants
- Variables
- func BloomLookup(bin Bloom, topic bytesBacked) bool
- func ConvertLegacyStoredReceipts(raw []byte) ([]byte, error)
- func DeriveSha(list DerivableList, hasher TrieHasher) common.Hash
- func IsLegacyStoredReceipts(raw []byte) (bool, error)
- func LogsBloom(logs []*Log) *big.Int
- func MakeNonce(otprn []byte, coinbase []byte) uint64
- func Number(b1, b2 *Block) bool
- func RlpHash(x interface{}) (h common.Hash)
- func Sender(signer Signer, tx *Transaction) (common.Address, error)
- func StatusToProto(status FnStatus) proto.ProcessStatus
- func WrapProof(proofBytes [][]byte) (wrappedProof []hexutil.Bytes)
- type AccountWrapper
- type Block
- 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) DeprecatedTd() *big.Int
- func (b *Block) Difficulty() *big.Int
- func (b *Block) EncodeRLP(w io.Writer) error
- func (b *Block) Extra() []byte
- func (b *Block) FairnodeSign() []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) Nonce() uint64
- func (b *Block) Number() *big.Int
- func (b *Block) NumberU64() uint64
- func (b *Block) Otprn() []byte
- func (b *Block) ParentHash() common.Hash
- func (b *Block) ReceiptHash() common.Hash
- func (b *Block) Root() common.Hash
- func (b *Block) SetDifficulty(difficulty *big.Int)
- func (b *Block) SetFairnodeSign(fairnodeSing []byte)
- func (b *Block) SetOtprn(otprn []byte)
- func (b *Block) Size() common.StorageSize
- func (b *Block) Time() *big.Int
- func (b *Block) Transaction(hash common.Hash) *Transaction
- func (b *Block) Transactions() Transactions
- func (b *Block) TxHash() common.Hash
- func (b *Block) VoterHash() common.Hash
- func (b *Block) Voters() Voters
- func (b *Block) WithBody(txs []*Transaction, voters []*Voter) *Block
- func (b *Block) WithFairnodeSign(fnSign []byte) *Block
- func (b *Block) WithSeal(header *Header) *Block
- func (b *Block) WithVoter(voters Voters, hasher TrieHasher) *Block
- type BlockBy
- type BlockNonce
- type BlockTrace
- type BlockVoter
- type Blocks
- type Bloom
- func (b *Bloom) Add(d *big.Int)
- func (b Bloom) Big() *big.Int
- func (b Bloom) Bytes() []byte
- func (b Bloom) MarshalText() ([]byte, error)
- func (b *Bloom) SetBytes(d []byte)
- func (b Bloom) Test(test *big.Int) bool
- func (b Bloom) TestBytes(test []byte) bool
- func (b *Bloom) UnmarshalText(input []byte) error
- type Body
- type ChainConfig
- type ChainEvent
- type ChainHeadEvent
- type ChainSideEvent
- type ClientClose
- type CurrentInfo
- type DerivableList
- 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 ExecutionResult
- type ExtraData
- type FairnodeStatusEvent
- type FnStatus
- 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 Header
- type HeartBeat
- type HomesteadSigner
- type L1MessageTx
- type LegacyTx
- func (tx *LegacyTx) CheckNonce() bool
- func (tx *LegacyTx) Data() []byte
- func (tx *LegacyTx) From() common.Address
- func (tx *LegacyTx) Gas() uint64
- func (tx *LegacyTx) GasPrice() *big.Int
- func (tx *LegacyTx) IsL1MessageTx() bool
- func (tx *LegacyTx) Nonce() uint64
- func (tx *LegacyTx) To() *common.Address
- func (tx *LegacyTx) Value() *big.Int
- type Log
- type LogForStorage
- type Message
- func (m Message) CheckNonce() bool
- func (m Message) Data() []byte
- func (m Message) From() common.Address
- func (m Message) Gas() uint64
- func (m Message) GasPrice() *big.Int
- func (m Message) IsL1MessageTx() bool
- func (m Message) Nonce() uint64
- func (m Message) To() *common.Address
- func (m Message) Value() *big.Int
- type Network
- type NewJoinTxsEvent
- type NewLeagueBlockEvent
- type NewMinedBlockEvent
- type NewTxsEvent
- type Otprn
- func (otprn *Otprn) EncodeOtprn() ([]byte, error)
- func (otprn *Otprn) GetChainConfig() *ChainConfig
- func (otprn *Otprn) GetValue() (cMiner uint64, mMiner uint64, rand [20]byte)
- func (otprn *Otprn) HashOtprn() common.Hash
- func (otprn *Otprn) RandToByte() []byte
- func (otprn *Otprn) SignOtprn(prv *ecdsa.PrivateKey) error
- func (otprn *Otprn) ValidateSignature() error
- type PendingLogsEvent
- type Price
- type Receipt
- func (r *Receipt) DecodeRLP(s *rlp.Stream) error
- func (r *Receipt) EncodeRLP(w io.Writer) error
- func (r *Receipt) MarshalBinary() ([]byte, error)
- func (r Receipt) MarshalJSON() ([]byte, error)
- func (r *Receipt) Size() common.StorageSize
- func (r *Receipt) UnmarshalBinary(b []byte) (*receiptRLP, error)
- func (r *Receipt) UnmarshalJSON(input []byte) error
- type ReceiptForStorage
- type Receipts
- type RemovedLogsEvent
- type RowConsumption
- type RowUsage
- type Signer
- type StateAccount
- type StorageBlock
- type StorageTrace
- type StorageWrapper
- type StructLogRes
- type SubCircuitRowUsage
- type Transaction
- func ConvertEthTransaction(nonce uint64, to *common.Address, amount *big.Int, gasLimit uint64, ...) *Transaction
- func NewContractCreation(nonce uint64, amount *big.Int, gasLimit uint64, gasPrice *big.Int, data []byte) *Transaction
- func NewJoinTransaction(nonce, joinNonce uint64, otprn []byte, coinase common.Address) *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) AsL1MessageTx() *L1MessageTx
- func (tx *Transaction) AsMessage(s Signer) (Message, error)
- func (tx *Transaction) ChainId() *big.Int
- func (tx *Transaction) CheckNonce() bool
- func (tx *Transaction) Cost() *big.Int
- func (tx *Transaction) Data() []byte
- func (tx *Transaction) DecodeRLP(s *rlp.Stream) error
- func (tx *Transaction) EncodeRLP(w io.Writer) error
- func (tx *Transaction) Gas() uint64
- func (tx *Transaction) GasPrice() *big.Int
- func (tx *Transaction) Hash() common.Hash
- func (tx *Transaction) IsL1MessageTx() bool
- func (tx *Transaction) JoinNonce() (uint64, error)
- func (tx *Transaction) L1MessageQueueIndex() uint64
- func (tx *Transaction) MarshalBinary() ([]byte, error)
- func (tx *Transaction) MarshalJSON() ([]byte, error)
- func (tx *Transaction) Nonce() uint64
- func (tx *Transaction) Otprn() ([]byte, error)
- func (tx *Transaction) Payload() []byte
- func (tx *Transaction) PayloadHash() ([]byte, error)
- func (tx *Transaction) Protected() bool
- func (tx *Transaction) RawSignatureValues() (*big.Int, *big.Int, *big.Int)
- func (tx *Transaction) Sender(signer Signer) (common.Address, error)
- func (tx *Transaction) Size() common.StorageSize
- func (tx *Transaction) To() *common.Address
- func (tx *Transaction) TransactionId() uint64
- func (tx *Transaction) Type() uint64
- func (tx *Transaction) UnmarshalBinary(b []byte) error
- func (tx *Transaction) UnmarshalJSON(input []byte) error
- func (tx *Transaction) Value() *big.Int
- func (tx *Transaction) WithSignature(signer Signer, sig []byte) (*Transaction, error)
- type TransactionData
- type Transactions
- type TransactionsByPriceAndNonce
- type TrieHasher
- type TxByNonce
- type TxByPrice
- type TxData
- type VoteBlock
- type Voter
- type Voters
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 ( GeneralTx uint64 = iota JoinTx EthTx L1MessageTxType = 0x7E )
Variables ¶
var ( EmptyRootHash = common.HexToHash("0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") EmptyReceiptHash = common.HexToHash("0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") EmptyVoteHash = common.HexToHash("0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421") )
var Bloom9 = bloom9
var (
ErrInvalidChainId = errors.New("invalid chain id for signer")
)
var (
ErrInvalidLength = errors.New("StateAccount: invalid input length")
)
var (
ErrInvalidSig = errors.New("invalid transaction v, r, s values")
)
Functions ¶
func BloomLookup ¶
func ConvertLegacyStoredReceipts ¶ added in v0.8.6
ConvertLegacyStoredReceipts takes the RLP encoding of an array of legacy stored receipts and returns a fresh RLP-encoded stored receipt.
func DeriveSha ¶
func DeriveSha(list DerivableList, hasher TrieHasher) common.Hash
func IsLegacyStoredReceipts ¶ added in v0.8.6
IsLegacyStoredReceipts tries to parse the RLP-encoded blob first as an array of v3 stored receipt, then v4 stored receipt and returns true if successful.
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 StatusToProto ¶ added in v0.6.12
func StatusToProto(status FnStatus) proto.ProcessStatus
Types ¶
type AccountWrapper ¶ added in v0.8.6
type AccountWrapper struct { Address common.Address `json:"address"` Nonce uint64 `json:"nonce"` Balance *hexutil.Big `json:"balance"` KeccakCodeHash common.Hash `json:"keccakCodeHash,omitempty"` PoseidonCodeHash common.Hash `json:"poseidonCodeHash,omitempty"` CodeSize uint64 `json:"codeSize"` Storage *StorageWrapper `json:"storage,omitempty"` // StorageWrapper can be empty if irrelated to storage operation }
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 entire block in the Anduschain blockchain.
func NewBlock ¶
func NewBlock(header *Header, txs []*Transaction, receipts []*Receipt, voters []*Voter, 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 (*Block) DeprecatedTd ¶
DeprecatedTd is an old relic for extracting the TD of a block. It is in the code solely to facilitate upgrading the database from the old format to the new, after which it should be deleted. Do not use!
func (*Block) Difficulty ¶
func (*Block) FairnodeSign ¶ added in v0.6.12
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) SetDifficulty ¶ added in v0.8.1
func (*Block) SetFairnodeSign ¶ added in v0.8.1
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 previsouly 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(txs []*Transaction, voters []*Voter) *Block
WithBody returns a new block with the given transaction and uncle contents.
func (*Block) WithFairnodeSign ¶ added in v0.6.12
WithFairnodeSign returns a new block with the data from b but the header replaced with the sealed one.
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 BlockTrace ¶ added in v0.8.6
type BlockTrace struct { ChainID uint64 `json:"chainID"` Version string `json:"version"` Coinbase *AccountWrapper `json:"coinbase"` Header *Header `json:"header"` Transactions []*TransactionData `json:"transactions"` StorageTrace *StorageTrace `json:"storageTrace"` TxStorageTraces []*StorageTrace `json:"txStorageTraces,omitempty"` ExecutionResults []*ExecutionResult `json:"executionResults"` MPTWitness *json.RawMessage `json:"mptwitness,omitempty"` WithdrawTrieRoot common.Hash `json:"withdraw_trie_root,omitempty"` StartL1QueueIndex uint64 `json:"startL1QueueIndex"` }
BlockTrace contains block execution traces and results required for rollers.
type BlockVoter ¶ added in v0.8.1
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 ¶
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 //transactions Voters []*Voter }
Body is a simple (mutable, non-safe) data container for storing and moving a block's data contents (transactions and uncles) together.
type ChainConfig ¶ added in v0.6.12
type ChainConfig struct { MinMiner uint64 `json:"minMiner"` // minimum count node for making block in league BlockNumber uint64 `json:"blockNumber"` // applying rule starting block number FnFee string `json:"fairnodeFee"` Mminer uint64 `json:"mMiner"` // target node count in league Epoch uint64 `json:"epoch"` // league change term NodeVersion string `json:"nodeVersion"` Price Price `json:"price"` Sign []byte `json:"sign"` }
otprn data
func (*ChainConfig) Hash ¶ added in v0.6.12
func (cf *ChainConfig) Hash() common.Hash
type ChainEvent ¶ added in v0.6.12
type ChainHeadEvent ¶ added in v0.6.12
type ChainHeadEvent struct{ Block *Block }
type ChainSideEvent ¶ added in v0.6.12
type ChainSideEvent struct {
Block *Block
}
type ClientClose ¶ added in v0.6.12
type ClientClose struct{}
type CurrentInfo ¶ added in v0.6.12
type DerivableList ¶
type EIP155Signer ¶
type EIP155Signer struct {
// contains filtered or unexported fields
}
EIP155Transaction implements Signer using the EIP155 rules.
func NewEIP155Signer ¶
func NewEIP155Signer(chainId *big.Int) EIP155Signer
func (EIP155Signer) ChainID ¶ added in v0.8.6
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)
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.
type ExecutionResult ¶ added in v0.8.6
type ExecutionResult struct { L1DataFee *hexutil.Big `json:"l1DataFee,omitempty"` Gas uint64 `json:"gas"` Failed bool `json:"failed"` ReturnValue string `json:"returnValue"` // Sender's account state (before Tx) From *AccountWrapper `json:"from,omitempty"` // Receiver's account state (before Tx) To *AccountWrapper `json:"to,omitempty"` // AccountCreated record the account if the tx is "create" // (for creating inside a contract, we just handle CREATE op) AccountCreated *AccountWrapper `json:"accountCreated,omitempty"` // Record all accounts' state which would be affected AFTER tx executed // currently they are just `from` and `to` account AccountsAfter []*AccountWrapper `json:"accountAfter"` // `PoseidonCodeHash` only exists when tx is a contract call. PoseidonCodeHash *common.Hash `json:"poseidonCodeHash,omitempty"` // If it is a contract call, the contract code is returned. ByteCode string `json:"byteCode,omitempty"` StructLogs []*StructLogRes `json:"structLogs"` }
ExecutionResult groups all structured logs emitted by the EVM while replaying a transaction in debug mode as well as transaction execution status, the amount of gas used and the return value
type ExtraData ¶ added in v0.8.6
type ExtraData struct { // Indicate the call succeeds or not for CALL/CREATE op CallFailed bool `json:"callFailed,omitempty"` // CALL | CALLCODE | DELEGATECALL | STATICCALL: [tx.to address’s code, stack.nth_last(1) address’s code] // CREATE | CREATE2: [created contract’s code] // CODESIZE | CODECOPY: [contract’s code] // EXTCODESIZE | EXTCODECOPY: [stack.nth_last(0) address’s code] CodeList []string `json:"codeList,omitempty"` // SSTORE | SLOAD: [storageProof] // SELFDESTRUCT: [contract address’s account, stack.nth_last(0) address’s account] // SELFBALANCE: [contract address’s account] // BALANCE | EXTCODEHASH: [stack.nth_last(0) address’s account] // CREATE | CREATE2: [created contract address’s account (before constructed), // created contract address's account (after constructed)] // CALL | CALLCODE: [caller contract address’s account, // stack.nth_last(1) (i.e. callee) address’s account, // callee contract address's account (value updated, before called)] // STATICCALL: [stack.nth_last(1) (i.e. callee) address’s account, // callee contract address's account (before called)] StateList []*AccountWrapper `json:"proofList,omitempty"` // The status of caller, it would be captured twice: // 1. before execution and 2. updated in CaptureEnter (for CALL/CALLCODE it duplicated with StateList[0]) Caller []*AccountWrapper `json:"caller,omitempty"` }
type FairnodeStatusEvent ¶ added in v0.6.12
type FairnodeStatusEvent struct { Status FnStatus Payload interface{} }
type FnStatus ¶ added in v0.6.12
type FnStatus uint64
func ProtoToStatus ¶ added in v0.6.12
func ProtoToStatus(status proto.ProcessStatus) FnStatus
type FrontierSigner ¶
type FrontierSigner struct{}
func (FrontierSigner) ChainID ¶ added in v0.8.6
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 Header ¶
type Header struct { ParentHash common.Hash `json:"parentHash" gencodec:"required"` Coinbase common.Address `json:"miner" gencodec:"required"` Root common.Hash `json:"stateRoot" gencodec:"required"` TxHash common.Hash `json:"transactionsRoot" gencodec:"required"` VoteHash common.Hash `json:"voteRoot" 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 *big.Int `json:"timestamp" gencodec:"required"` Extra []byte `json:"extraData" gencodec:"required"` Nonce BlockNonce `json:"nonce" gencodec:"required"` Otprn []byte `json:"otprn" gencodec:"required"` // otprn with fairnode signature FairnodeSign []byte `json:"fairnodeSign" gencodec:"required"` // fairnode signature, not import header hash - from fairnode }
Header represents a block header in the Anduschain blockchain.
func CopyHeader ¶
CopyHeader creates a deep copy of a block header to prevent side effects from modifying a header variable.
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) 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 HeartBeat ¶ added in v0.6.12
type HeartBeat struct { Enode string MinerAddress string ChainID string NodeVersion string Host string Port int64 Time *big.Int Head common.Hash Sign []byte }
for miner heart beat
type HomesteadSigner ¶
type HomesteadSigner struct{ FrontierSigner }
HomesteadTransaction implements TransactionInterface using the homestead rules.
func (HomesteadSigner) ChainID ¶ added in v0.8.6
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 L1MessageTx ¶ added in v0.8.6
type L1MessageTx struct { QueueIndex uint64 Gas uint64 // gas limit To *common.Address // can not be nil, we do not allow contract creation from L1 Value *big.Int Data []byte Sender common.Address }
payload, RLP encoded
type LegacyTx ¶ added in v0.8.6
type LegacyTx struct { Type uint64 `json:"type" gencodec:"required"` AccountNonce uint64 `json:"nonce" gencodec:"required"` Price *big.Int `json:"gasPrice" gencodec:"required"` GasLimit uint64 `json:"gas" gencodec:"required"` Recipient *common.Address `json:"to" rlp:"nil"` // nil means contract creation Amount *big.Int `json:"value" gencodec:"required"` Payload []byte `json:"input" gencodec:"required"` // Signature values V *big.Int `json:"v" gencodec:"required"` R *big.Int `json:"r" gencodec:"required"` S *big.Int `json:"s" gencodec:"required"` // This is only used when marshaling to JSON. Hash *common.Hash `json:"hash" rlp:"-"` }
func (*LegacyTx) CheckNonce ¶ added in v0.8.6
func (*LegacyTx) IsL1MessageTx ¶ added in v0.8.6
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"` // hash of the transaction TxHash common.Hash `json:"transactionHash" gencodec:"required"` // index of the transaction in the block TxIndex uint `json:"transactionIndex" gencodec:"required"` // hash of the block in which the transaction was included BlockHash common.Hash `json:"blockHash"` // index of the log in the receipt Index uint `json:"logIndex" gencodec:"required"` // 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"` }
Log represents a contract log event. These events are generated by the LOG opcode and stored/indexed by the node.
func (Log) MarshalJSON ¶
func (*Log) UnmarshalJSON ¶
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.
type Message ¶
type Message struct {
// contains filtered or unexported fields
}
Message is a fully derived transaction and implements core.Message
NOTE: In a future PR this will be removed.
func NewMessage ¶
func (Message) CheckNonce ¶
func (Message) IsL1MessageTx ¶ added in v0.8.6
type NewJoinTxsEvent ¶ added in v0.6.12
type NewJoinTxsEvent struct{ Txs Transactions }
NewJoinTxsEvent is posted when a batch of join transactions enter the join transaction pool.
type NewLeagueBlockEvent ¶ added in v0.6.12
for deb consensus
type NewMinedBlockEvent ¶ added in v0.6.12
type NewMinedBlockEvent struct{ Block *Block }
NewMinedBlockEvent is posted when a block has been imported.
type NewTxsEvent ¶ added in v0.6.12
type NewTxsEvent struct{ Txs Transactions }
NewTxsEvent is posted when a batch of transactions enter the transaction pool.
type Otprn ¶ added in v0.6.12
type Otprn struct { Rand [20]byte FnAddr common.Address Cminer uint64 Data ChainConfig Sign []byte }
func DecodeOtprn ¶ added in v0.6.12
func NewDefaultOtprn ¶ added in v0.8.1
func NewDefaultOtprn() *Otprn
func NewOtprn ¶ added in v0.6.12
func NewOtprn(cMiner uint64, fnAddr common.Address, data ChainConfig) *Otprn
func (*Otprn) EncodeOtprn ¶ added in v0.6.12
func (*Otprn) GetChainConfig ¶ added in v0.6.21
func (otprn *Otprn) GetChainConfig() *ChainConfig
func (*Otprn) RandToByte ¶ added in v0.6.12
func (*Otprn) SignOtprn ¶ added in v0.6.12
func (otprn *Otprn) SignOtprn(prv *ecdsa.PrivateKey) error
func (*Otprn) ValidateSignature ¶ added in v0.6.12
type PendingLogsEvent ¶ added in v0.6.12
type PendingLogsEvent struct {
Logs []*Log
}
PendingLogsEvent is posted pre mining and notifies of pending logs.
type Receipt ¶
type Receipt struct { // Consensus fields 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 (don't reorder!) TxHash common.Hash `json:"transactionHash" gencodec:"required"` ContractAddress common.Address `json:"contractAddress"` GasUsed uint64 `json:"gasUsed" gencodec:"required"` // 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.
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) MarshalBinary ¶ added in v0.8.1
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 ¶ added in v0.8.1
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 that flattens and parses the entire content of a receipt, as opposed to only the consensus fields originally.
type Receipts ¶
type Receipts []*Receipt
Receipts is a wrapper around a Receipt array to implement DerivableList.
func (Receipts) DeriveFields ¶ added in v0.8.1
func (rs Receipts) DeriveFields(config *params.ChainConfig, hash common.Hash, number uint64, txs Transactions) error
DeriveFields fills the receipts with their computed fields based on consensus data and contextual infos like containing block and transactions.
type RemovedLogsEvent ¶ added in v0.6.12
type RemovedLogsEvent struct{ Logs []*Log }
RemovedLogsEvent is posted when a reorg happens
type RowConsumption ¶ added in v0.8.6
type RowConsumption []SubCircuitRowUsage
type RowUsage ¶ added in v0.8.6
type RowUsage struct { IsOk bool `json:"is_ok"` RowNumber uint64 `json:"row_number"` RowUsageDetails []SubCircuitRowUsage `json:"row_usage_details"` }
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) // Hash returns the hash to be signed. Hash(tx *Transaction) common.Hash // Equal returns true if the given signer is the same as the receiver. Equal(Signer) bool ChainID() *big.Int }
Signer encapsulates transaction signature handling. Note that this interface is not a stable API and may change at any time to accommodate new protocol rules.
func LatestSigner ¶ added in v0.8.1
func LatestSigner(config *params.ChainConfig) Signer
func LatestSignerForChainID ¶ added in v0.8.1
func MakeSigner ¶
func MakeSigner(config *params.ChainConfig, blockNumber *big.Int) Signer
MakeSigner returns a Signer based on the given chain config and block number.
type StateAccount ¶ added in v0.8.6
type StateAccount struct { JoinNonce uint64 Nonce uint64 Balance *big.Int Root common.Hash // merkle root of the storage trie CodeHash []byte // StateAccount Scroll extensions PoseidonCodeHash []byte CodeSize uint64 }
StateAccount is the Ethereum consensus representation of accounts. These objects are stored in the main account trie.
func UnmarshalStateAccount ¶ added in v0.8.6
func UnmarshalStateAccount(bytes []byte) (*StateAccount, error)
func (*StateAccount) EncodeRLP ¶ added in v0.8.6
func (obj *StateAccount) EncodeRLP(_w io.Writer) error
func (*StateAccount) MarshalFields ¶ added in v0.8.6
func (s *StateAccount) MarshalFields() ([]zkt.Byte32, uint32)
MarshalFields marshalls a StateAccount into a sequence of bytes. The bytes scheme is: [0:32] (bytes in big-endian)
[0:16] Reserved with all 0 [16:24] CodeSize, uint64 in big-endian [24:32] Nonce, uint64 in big-endian
[32:64] Balance [64:96] StorageRoot [96:128] KeccakCodeHash [128:160] PoseidonCodehash (total 160 bytes)
type StorageBlock ¶
type StorageBlock Block
[deprecated by eth/63] StorageBlock defines the RLP encoding of a Block stored in the state database. The StorageBlock encoding contains fields that would otherwise need to be recomputed.
type StorageTrace ¶ added in v0.8.6
type StorageTrace struct { // Root hash before block execution: RootBefore common.Hash `json:"rootBefore,omitempty"` // Root hash after block execution, is nil if execution has failed RootAfter common.Hash `json:"rootAfter,omitempty"` // All proofs BEFORE execution, for accounts which would be used in tracing Proofs map[string][]hexutil.Bytes `json:"proofs"` // All storage proofs BEFORE execution StorageProofs map[string]map[string][]hexutil.Bytes `json:"storageProofs,omitempty"` // Node entries for deletion, no need to distinguish what it is from, just read them // into the partial db DeletionProofs []hexutil.Bytes `json:"deletionProofs,omitempty"` }
StorageTrace stores proofs of storage needed by storage circuit
type StorageWrapper ¶ added in v0.8.6
type StorageWrapper struct { Key string `json:"key,omitempty"` Value string `json:"value,omitempty"` }
StorageWrapper while key & value can also be retrieved from StructLogRes.Storage, we still stored in here for roller's processing convenience.
type StructLogRes ¶ added in v0.8.6
type StructLogRes struct { Pc uint64 `json:"pc"` Op string `json:"op"` Gas uint64 `json:"gas"` GasCost uint64 `json:"gasCost"` Depth int `json:"depth"` Error string `json:"error,omitempty"` Stack []string `json:"stack,omitempty"` Memory []string `json:"memory,omitempty"` Storage map[string]string `json:"storage,omitempty"` RefundCounter uint64 `json:"refund,omitempty"` ExtraData *ExtraData `json:"extraData,omitempty"` }
StructLogRes stores a structured log emitted by the EVM while replaying a transaction in debug mode
func NewStructLogResBasic ¶ added in v0.8.6
func NewStructLogResBasic(pc uint64, op string, gas, gasCost uint64, depth int, refundCounter uint64, err error) *StructLogRes
NewStructLogResBasic Basic StructLogRes skeleton, Stack&Memory&Storage&ExtraData are separated from it for GC optimization; still need to fill in with Stack&Memory&Storage&ExtraData
type SubCircuitRowUsage ¶ added in v0.8.6
type Transaction ¶
type Transaction struct {
// contains filtered or unexported fields
}
func ConvertEthTransaction ¶ added in v0.7.6
func NewContractCreation ¶
func NewJoinTransaction ¶ added in v0.6.12
func NewJoinTransaction(nonce, joinNonce uint64, otprn []byte, coinase common.Address) *Transaction
func NewTransaction ¶
func SignNewTx ¶ added in v0.8.1
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) AsL1MessageTx ¶ added in v0.8.6
func (tx *Transaction) AsL1MessageTx() *L1MessageTx
AsL1MessageTx casts the tx into an L1 cross-domain tx.
func (*Transaction) AsMessage ¶
func (tx *Transaction) AsMessage(s Signer) (Message, error)
AsMessage returns the transaction as a core.Message.
AsMessage requires a signer to derive the sender.
XXX Rename message to something less arbitrary?
func (*Transaction) ChainId ¶
func (tx *Transaction) ChainId() *big.Int
ChainId returns which chain id this transaction was signed for (if at all)
func (*Transaction) CheckNonce ¶
func (tx *Transaction) CheckNonce() bool
func (*Transaction) Cost ¶
func (tx *Transaction) Cost() *big.Int
Cost returns amount + gasprice * gaslimit.
func (*Transaction) Data ¶
func (tx *Transaction) Data() []byte
func (*Transaction) DecodeRLP ¶
func (tx *Transaction) DecodeRLP(s *rlp.Stream) error
DecodeRLP implements rlp.Decoder
func (*Transaction) EncodeRLP ¶
func (tx *Transaction) EncodeRLP(w io.Writer) error
EncodeRLP implements rlp.Encoder
func (*Transaction) Gas ¶
func (tx *Transaction) Gas() uint64
func (*Transaction) GasPrice ¶
func (tx *Transaction) GasPrice() *big.Int
func (*Transaction) Hash ¶
func (tx *Transaction) Hash() common.Hash
Hash hashes the RLP encoding of tx. It uniquely identifies the transaction.
func (*Transaction) IsL1MessageTx ¶ added in v0.8.6
func (tx *Transaction) IsL1MessageTx() bool
IsL1MessageTx returns true if the transaction is an L1 cross-domain tx.
func (*Transaction) JoinNonce ¶ added in v0.6.12
func (tx *Transaction) JoinNonce() (uint64, error)
for join transaction
func (*Transaction) L1MessageQueueIndex ¶ added in v0.8.6
func (tx *Transaction) L1MessageQueueIndex() uint64
L1MessageQueueIndex returns the L1 queue index if `tx` is of type `L1MessageTx`. It returns 0 otherwise.
func (*Transaction) MarshalBinary ¶ added in v0.8.1
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 encodes the web3 RPC transaction format.
func (*Transaction) Nonce ¶
func (tx *Transaction) Nonce() uint64
func (*Transaction) Otprn ¶ added in v0.6.12
func (tx *Transaction) Otprn() ([]byte, error)
for join transaction
func (*Transaction) Payload ¶ added in v0.8.1
func (tx *Transaction) Payload() []byte
func (*Transaction) PayloadHash ¶ added in v0.6.12
func (tx *Transaction) PayloadHash() ([]byte, error)
for join transaction
func (*Transaction) Protected ¶
func (tx *Transaction) Protected() bool
Protected returns whether the transaction is protected from replay protection.
func (*Transaction) RawSignatureValues ¶
func (*Transaction) Sender ¶ added in v0.6.12
func (tx *Transaction) Sender(signer Signer) (common.Address, error)
func (*Transaction) Size ¶
func (tx *Transaction) Size() common.StorageSize
Size returns the true RLP encoded storage size of the transaction, either by encoding and returning it, or returning a previsouly cached value.
func (*Transaction) To ¶
func (tx *Transaction) To() *common.Address
To returns the recipient address of the transaction. It returns nil if the transaction is a contract creation.
func (*Transaction) TransactionId ¶ added in v0.6.12
func (tx *Transaction) TransactionId() uint64
func (*Transaction) Type ¶ added in v0.8.6
func (tx *Transaction) Type() uint64
Type returns the transaction type.
func (*Transaction) UnmarshalBinary ¶ added in v0.8.1
func (tx *Transaction) UnmarshalBinary(b []byte) error
UnmarshalBinary decodes the canonical encoding of transactions. It supports legacy RLP transactions and Ethereum typed transactions.
func (*Transaction) UnmarshalJSON ¶
func (tx *Transaction) UnmarshalJSON(input []byte) error
UnmarshalJSON decodes the web3 RPC transaction format.
func (*Transaction) Value ¶
func (tx *Transaction) Value() *big.Int
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 formatted as described in the yellow paper (v+27).
type TransactionData ¶ added in v0.8.6
type TransactionData struct { Type uint64 `json:"type"` Nonce uint64 `json:"nonce"` TxHash string `json:"txHash"` Gas uint64 `json:"gas"` GasPrice *hexutil.Big `json:"gasPrice"` From common.Address `json:"from"` To *common.Address `json:"to"` ChainId *hexutil.Big `json:"chainId"` Value *hexutil.Big `json:"value"` Data string `json:"data"` IsCreate bool `json:"isCreate"` V *hexutil.Big `json:"v"` R *hexutil.Big `json:"r"` S *hexutil.Big `json:"s"` }
func NewTransactionData ¶ added in v0.8.6
func NewTransactionData(tx *Transaction, blockNumber uint64, config *params.ChainConfig) *TransactionData
NewTransactionData returns a transaction that will serialize to the trace representation, with the given location metadata set (if available).
type Transactions ¶
type Transactions []*Transaction
Transactions is a Transaction slice type for basic sorting.
func TxDifference ¶
func TxDifference(a, b Transactions) Transactions
TxDifference returns a new set which is the difference between a and b.
func (Transactions) GetRlp ¶
func (s Transactions) GetRlp(i int) []byte
GetRlp implements Rlpable and returns the i'th element of s in rlp.
func (Transactions) Swap ¶
func (s Transactions) Swap(i, j int)
Swap swaps the i'th and the j'th element in 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 map[common.Address]Transactions) *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) Peek ¶
func (t *TransactionsByPriceAndNonce) Peek() *Transaction
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 TrieHasher ¶ added in v0.8.6
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 TxByPrice ¶
type TxByPrice Transactions
TxByPrice implements both the sort and the heap interface, making it useful for all at once sorting as well as individually adding and removing elements.
type VoteBlock ¶ added in v0.8.1
type VoteBlock struct { Block Block Voters []BlockVoter }
type Voter ¶
type Voter struct { Header []byte `json:"blockHeader" gencodec:"required"` Voter common.Address `json:"voter" gencodec:"required"` VoteSign []byte `json:"voterSign" gencodec:"required"` }
func (Voter) MarshalJSON ¶ added in v0.6.12
MarshalJSON marshals as JSON.
func (*Voter) Size ¶
func (v *Voter) Size() common.StorageSize
func (*Voter) UnmarshalJSON ¶ added in v0.6.12
UnmarshalJSON unmarshals from JSON.
Source Files ¶
- block.go
- bloom9.go
- events.go
- gen_account_rlp.go
- gen_header_json.go
- gen_log_json.go
- gen_receipt_json.go
- gen_voter_json.go
- hashing.go
- l1_message_tx.go
- l2trace.go
- legacy.go
- log.go
- otprn.go
- receipt.go
- row_consumption.go
- state_account.go
- state_account_marshalling.go
- transaction.go
- transaction_eth.go
- transaction_signing.go
- transactions_type.go
- types.go
- voter.go