Documentation ¶
Index ¶
- Constants
- Variables
- func BloomLookup(bin Bloom, topic bytesBacked) bool
- func GetJsonStr(output string) (string, error)
- func LogsBloom(logs []*Log) *big.Int
- func Sender(signer Signer, tx *Transaction) (common.Address, error)
- func TransferToJson(code int) (string, error)
- 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 EIP155Signer
- type FrontierSigner
- type HomesteadSigner
- type Log
- type LogForStorage
- type Message
- type NewLog
- type Receipt
- func (r *Receipt) GetBlockHash() string
- func (r *Receipt) GetBlockNumber() string
- func (r *Receipt) GetContractAddress() common.Address
- func (r *Receipt) GetErrorMessage() string
- func (r *Receipt) GetFrom() string
- func (r *Receipt) GetGasUsed() string
- func (r *Receipt) GetInput() string
- func (r *Receipt) GetOutput() string
- func (r *Receipt) GetRoot() string
- func (r *Receipt) GetStatus() int
- func (r *Receipt) GetTo() string
- func (r *Receipt) GetTransactionHash() string
- func (r *Receipt) GetTransactionIndex() string
- func (r *Receipt) String() string
- type Signer
- type Transaction
- func NewContractCreation(nonce *big.Int, amount *big.Int, gasLimit *big.Int, gasPrice *big.Int, ...) *Transaction
- func NewTransaction(nonce *big.Int, to common.Address, amount *big.Int, gasLimit *big.Int, ...) *Transaction
- func SignTx(tx *Transaction, s Signer, prv *ecdsa.PrivateKey) (*Transaction, error)
- func (tx *Transaction) AsMessage(s Signer) (Message, error)
- func (tx *Transaction) ChainID() *big.Int
- func (tx *Transaction) CheckNonce() bool
- func (tx *Transaction) ConverToNewRawTx() *newTransactionStruct
- 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() *big.Int
- func (tx *Transaction) GasPrice() *big.Int
- func (tx *Transaction) Hash() common.Hash
- func (tx *Transaction) MarshalJSON() ([]byte, error)
- func (tx *Transaction) Nonce() *big.Int
- func (tx *Transaction) Protected() bool
- func (tx *Transaction) SM3HashNonSig() (h common.Hash)
- func (tx *Transaction) SignatureValues() (v, r, s *big.Int)
- func (tx *Transaction) Size() common.StorageSize
- func (tx *Transaction) To() *common.Address
- func (tx *Transaction) UnmarshalJSON(input []byte) error
- func (tx *Transaction) Value() *big.Int
- func (tx *Transaction) WithSM2Signature(signer Signer, sig []byte) (*Transaction, error)
- func (tx *Transaction) WithSignature(signer Signer, sig []byte) (*Transaction, error)
- type Transactions
- type TransactionsByPriceAndNonce
- type TxByNonce
- type TxByPrice
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 ( Success = iota Unknown BadRLP InvalidFormat OutOfGasIntrinsic InvalidSignature InvalidNonce NotEnoughCash OutOfGasBase BlockGasLimitReached BadInstruction BadJumpDestination OutOfGas OutOfStack StackUnderflow NonceCheckFail BlockLimitCheckFail FilterCheckFail NoDeployPermission NoCallPermission NoTxPermission PrecompiledError RevertInstruction InvalidZeroSignatureFormat AddressAlreadyUsed PermissionDenied CallAddressError )
const ( // precompile BCOS_RC1 string = "2.0.0-rc1" BCOS_RC2 string = "2.0.0-rc2" BCOS_RC3 string = "2.0.0-rc3" // system table for authority control USER_TABLE_PREFIX string = "_user_" SYS_TABLE string = "_sys_tables_" SYS_TABLE_ACCESS string = "_sys_table_access_" SYS_CONSENSUS string = "_sys_consensus_" SYS_CNS string = "_sys_cns_" SYS_CONFIG string = "_sys_config_" // precompile success PreSuccess int = 0 PermissionDenied_RC1 int = 80 PermissionDenied_RC3 int = -50000 TableExist int = 50001 TableExist_RC3 int = -50001 TableNameAndAddressExist_RC1 int = 56 TableNameAndAddressExist int = 51000 TableNameAndAddressExist_RC3 int = -51000 TableNameAndAddressNotExist_RC1 int = 57 TableNameAndAddressNotExist int = 51001 TableNameAndAddressNotExist_RC3 int = -51001 InvalidNodeId int = -51100 LastSealer_RC1 int = 100 LastSealer int = 51101 LastSealer_RC3 int = -51101 P2pNetwork int = -51102 GroupPeers int = -51103 SealerList int = -51104 ObserverList int = -51105 ContractNameAndVersionExist int = -51200 VersionExceeds int = -51201 InvalidKey_RC1 int = 157 InvalidKey int = 51300 InvalidKey_RC3 int = -51300 TABLE_KEY_MAX_LENGTH int = 255 BCOS_VERSION string = "" )
Variables ¶
var Bloom9 = bloom9
var (
ErrInvalidChainID = errors.New("invalid chain id for signer")
)
var (
ErrInvalidSig = errors.New("invalid raw transaction v, r, s values")
)
Functions ¶
func BloomLookup ¶
func GetJsonStr ¶
GetJsonStr returns the json string according to the output
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 TransferToJson ¶
TransferToJson returns the message json according to the status code
Types ¶
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 (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 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) 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 FrontierSigner ¶
type FrontierSigner struct{}
func (FrontierSigner) Equal ¶
func (fs 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 HomesteadSigner ¶
type HomesteadSigner struct{ FrontierSigner }
HomesteadTransaction implements TransactionInterface using the homestead rules.
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 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 block 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.
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 ¶
type NewLog ¶
type NewLog struct { // 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"` // index of the log in the block LogIndex string `json:"logIndex" ` // index of the transaction in the block TransactionIndex string `json:"transactionIndex" ` // hash of the transaction TransactionHash string `json:"transactionHash"` // hash of the block in which the transaction was included BlockHash string `json:"blockHash"` // Derived fields. These fields are filled in by the node // but not secured by consensus. // block in which the transaction was included BlockNumber string `json:"blockNumber"` // Consensus fields: // address of the contract that generated the event Address string `json:"address"` // supplied by the contract, usually ABI-encoded Data string `json:"data"` // Type for FISCO BCOS Type string `json:"type"` // list of topics provided by the contract. Topics []common.Hash `json:"topics" ` }
NewLog is used for the receipt
type Receipt ¶
type Receipt struct { TransactionHash string `json:"transactionHash"` TransactionIndex string `json:"transactionIndex"` BlockHash string `json:"blockHash"` BlockNumber string `json:"blockNumber"` GasUsed string `json:"gasUsed"` ContractAddress common.Address `json:"contractAddress"` Root string `json:"root"` Status int `json:"status"` From string `json:"from"` To string `json:"to"` Input string `json:"input"` Output string `json:"output"` Logs []*NewLog `json:"logs"` LogsBloom string `json:"logsBloom"` }
Receipt represents the results of a transaction.
func (*Receipt) GetBlockHash ¶
GetBlockHash returns the block hash string
func (*Receipt) GetBlockNumber ¶
GetBlockNumber returns the block number string
func (*Receipt) GetContractAddress ¶
GetContractAddress returns the contract address
func (*Receipt) GetErrorMessage ¶
ParseErrorMessage gets unusual output value from Receipt
func (*Receipt) GetTransactionHash ¶
GetTransactionHash returns the transaction hash string
func (*Receipt) GetTransactionIndex ¶
GetTransactionIndex returns the transaction index string
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 }
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 MakeSigner ¶
func MakeSigner(config *params.ChainConfig, blockNumber *big.Int) Signer
MakeSigner returns a Signer based on the given chain config and block number.
type Transaction ¶
type Transaction struct {
// contains filtered or unexported fields
}
func NewContractCreation ¶
func NewContractCreation(nonce *big.Int, amount *big.Int, gasLimit *big.Int, gasPrice *big.Int, blockLimit *big.Int, data []byte, chainId *big.Int, groupId *big.Int, extraData []byte, smcrypto bool) *Transaction
NewContractCreation creates a contract transaction
func NewTransaction ¶
func NewTransaction(nonce *big.Int, to common.Address, amount *big.Int, gasLimit *big.Int, gasPrice *big.Int, blockLimit *big.Int, data []byte, chainId *big.Int, groupId *big.Int, extraData []byte, smcrypto bool) *Transaction
NewTransaction returns a new transaction
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) 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) ConverToNewRawTx ¶
func (tx *Transaction) ConverToNewRawTx() *newTransactionStruct
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() *big.Int
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) MarshalJSON ¶
func (tx *Transaction) MarshalJSON() ([]byte, error)
MarshalJSON encodes the web3 RPC transaction format.
func (*Transaction) Nonce ¶
func (tx *Transaction) Nonce() *big.Int
func (*Transaction) Protected ¶
func (tx *Transaction) Protected() bool
Protected returns whether the transaction is protected from replay protection.
func (*Transaction) SM3HashNonSig ¶
func (tx *Transaction) SM3HashNonSig() (h common.Hash)
SM3HashNonSig hashes the RLP encoding of tx use sm3. It uniquely identifies the transaction.
func (*Transaction) SignatureValues ¶
func (tx *Transaction) SignatureValues() (v, r, s *big.Int)
SignatureValues returns the V, R, S signature values of the transaction. The return values should not be modified by the caller.
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) 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) WithSM2Signature ¶
func (tx *Transaction) WithSM2Signature(signer Signer, sig []byte) (*Transaction, error)
WithSM2Signature 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) 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.
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 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.