types

package
v1.5.9 Latest Latest
Warning

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

Go to latest
Published: Jan 25, 2024 License: LGPL-3.0 Imports: 20 Imported by: 82

Documentation

Index

Constants

View Source
const (
	H128Length = 16
)

Variables

This section is empty.

Functions

func NewBigInt

func NewBigInt(x uint64) *hexutil.Big

NewBigInt creates a big number with specified uint64 value.

func NewBigIntByRaw added in v0.1.1

func NewBigIntByRaw(x *big.Int) *hexutil.Big

NewBigIntByRaw creates a hexutil.big with specified big.int value.

func NewBytes added in v0.1.1

func NewBytes(input []byte) hexutil.Bytes

NewBytes creates a hexutil.Bytes with specified input value.

func NewUint added in v0.1.1

func NewUint(x uint) *hexutil.Uint

NewUint creates a hexutil.Uint with specified uint value.

func NewUint64 added in v0.1.1

func NewUint64(x uint64) *hexutil.Uint64

NewUint64 creates a hexutil.Uint64 with specified uint64 value.

Types

type AccountInfo added in v0.1.1

type AccountInfo struct {
	Address Address `json:"address"`

	Balance *hexutil.Big `json:"balance"`
	// : U256,
	Nonce *hexutil.Big `json:"nonce"`
	// : U256,
	CodeHash Hash `json:"codeHash"`
	//  : H256,
	StakingBalance *hexutil.Big `json:"stakingBalance"`
	// : U256,
	CollateralForStorage *hexutil.Big `json:"collateralForStorage"`
	// : U256,
	AccumulatedInterestReturn *hexutil.Big `json:"accumulatedInterestReturn"`
	// : U256,
	Admin Address `json:"admin"`
}

type AccountPendingInfo added in v0.1.1

type AccountPendingInfo struct {
	LocalNonce    *hexutil.Big `json:"localNonce"`
	PendingCount  *hexutil.Big `json:"pendingCount"`
	PendingNonce  *hexutil.Big `json:"pendingNonce"`
	NextPendingTx Hash         `json:"nextPendingTx"`
}

type AccountPendingTransactions added in v0.1.1

type AccountPendingTransactions struct {
	PendingTransactions []Transaction `json:"pendingTransactions"`
	// type maybe string/Pending
	FirstTxStatus *TransactionStatus `json:"firstTxStatus"`
	PendingCount  hexutil.Uint64     `json:"pendingCount"`
}

type ActionType added in v0.1.1

type ActionType string

type Address

type Address = address.Address

type Block

type Block struct {
	BlockHeader
	Transactions []Transaction `json:"transactions"`
}

Block represents a block in Conflux, including block header and a list of detailed transactions.

func (*Block) DecodeRLP added in v0.1.1

func (block *Block) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (Block) EncodeRLP added in v0.1.1

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

EncodeRLP implements the rlp.Encoder interface.

type BlockHeader

type BlockHeader struct {
	Hash                  Hash             `json:"hash"`
	ParentHash            Hash             `json:"parentHash"`
	Height                *hexutil.Big     `json:"height"`
	Miner                 Address          `json:"miner"`
	DeferredStateRoot     Hash             `json:"deferredStateRoot"`
	DeferredReceiptsRoot  Hash             `json:"deferredReceiptsRoot"`
	DeferredLogsBloomHash Hash             `json:"deferredLogsBloomHash"`
	Blame                 hexutil.Uint64   `json:"blame"`
	TransactionsRoot      Hash             `json:"transactionsRoot"`
	EpochNumber           *hexutil.Big     `json:"epochNumber"`
	BlockNumber           *hexutil.Big     `json:"blockNumber"`
	GasLimit              *hexutil.Big     `json:"gasLimit"`
	GasUsed               *hexutil.Big     `json:"gasUsed"`
	Timestamp             *hexutil.Big     `json:"timestamp"`
	Difficulty            *hexutil.Big     `json:"difficulty"`
	PowQuality            *hexutil.Big     `json:"powQuality"`
	RefereeHashes         []Hash           `json:"refereeHashes"`
	Adaptive              bool             `json:"adaptive"`
	Nonce                 *hexutil.Big     `json:"nonce"`
	Size                  *hexutil.Big     `json:"size"`
	Custom                []cmptutil.Bytes `json:"custom"`
	PosReference          *Hash            `json:"posReference"`
}

BlockHeader represents a block header in Conflux.

func (*BlockHeader) DecodeRLP added in v0.1.1

func (bh *BlockHeader) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (BlockHeader) EncodeRLP added in v0.1.1

func (bh BlockHeader) EncodeRLP(w io.Writer) error

EncodeRLP implements the rlp.Encoder interface.

type BlockSummary

type BlockSummary struct {
	BlockHeader
	Transactions []Hash `json:"transactions"`
}

BlockSummary includes block header and a list of transaction hashes

func (*BlockSummary) DecodeRLP added in v0.1.1

func (bs *BlockSummary) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (BlockSummary) EncodeRLP added in v0.1.1

func (bs BlockSummary) EncodeRLP(w io.Writer) error

EncodeRLP implements the rlp.Encoder interface.

type Bloom

type Bloom string

Bloom is a hash type with 256 bytes.

type Call added in v0.1.1

type Call struct {
	Space    SpaceType     `json:"space"`
	From     Address       `json:"from"`
	To       Address       `json:"to"`
	Value    hexutil.Big   `json:"value"`
	Gas      hexutil.Big   `json:"gas"`
	Input    hexutil.Bytes `json:"input"`
	CallType CallType      `json:"callType"`
}

independent action structs

type CallRequest

type CallRequest struct {
	From     *Address     `json:"from,omitempty"`
	To       *Address     `json:"to,omitempty"`
	GasPrice *hexutil.Big `json:"gasPrice,omitempty"`
	Gas      *hexutil.Big `json:"gas,omitempty"`
	Value    *hexutil.Big `json:"value,omitempty"`
	// NOTE, cannot use *hexutil.Bytes or hexutil.Bytes here.
	// Otherwise, hexutil.Bytes.UnmarshalJSON will called to
	// unmarshal from nil and cause to errNonString error.
	Data         *string         `json:"data,omitempty"`
	Nonce        *hexutil.Big    `json:"nonce,omitempty"`
	StorageLimit *hexutil.Uint64 `json:"storageLimit,omitempty"`
}

CallRequest represents a request to execute contract.

func (*CallRequest) FillByCallOption added in v0.1.1

func (request *CallRequest) FillByCallOption(option *ContractMethodCallOption)

FillByCallOption fills CallRequest fields by

func (*CallRequest) FillByUnsignedTx

func (request *CallRequest) FillByUnsignedTx(tx *UnsignedTransaction)

FillByUnsignedTx fills CallRequest fields by tx

type CallResult added in v0.1.1

type CallResult struct {
	Outcome    OutcomeType   `json:"outcome"`
	GasLeft    hexutil.Big   `json:"gasLeft"`
	ReturnData hexutil.Bytes `json:"returnData"`
}

type CallType added in v0.1.1

type CallType string
const (
	CALL_NONE         CallType = "none"
	CALL_CALL         CallType = "call"
	CALL_CALLCODE     CallType = "callcode"
	CALL_DELEGATECALL CallType = "delegatecall"
	CALL_STATICCALL   CallType = "staticcall"
)

type CfxFilterChanges added in v1.5.4

type CfxFilterChanges struct {
	Type   string
	Logs   []*SubscriptionLog
	Hashes []Hash
}

func (CfxFilterChanges) MarshalJSON added in v1.5.4

func (u CfxFilterChanges) MarshalJSON() ([]byte, error)

func (*CfxFilterChanges) UnmarshalJSON added in v1.5.4

func (u *CfxFilterChanges) UnmarshalJSON(data []byte) error

type ChainReorg added in v0.1.1

type ChainReorg struct {
	RevertTo *hexutil.Big `json:"revertTo"`
}

type CheckBalanceAgainstTransactionResponse added in v0.1.1

type CheckBalanceAgainstTransactionResponse struct {
	/// Whether the account should pay transaction fee by self.
	WillPayTxFee bool `json:"willPayTxFee"`
	/// Whether the account should pay collateral by self.
	WillPayCollateral bool `json:"willPayCollateral"`
	/// Whether the account balance is enough for this transaction.
	IsBalanceEnough bool `json:"isBalanceEnough"`
}

type ContractDeployOption

type ContractDeployOption struct {
	UnsignedTransactionBase
	// TimeoutInSecond represents the timeout of deploy contract,
	// default value is 0 which means never timeout
	Timeout time.Duration
}

ContractDeployOption for setting option when deploying contract

type ContractMethodCallOption

type ContractMethodCallOption struct {
	From         *Address
	Nonce        *hexutil.Big
	GasPrice     *hexutil.Big
	Gas          *hexutil.Big
	Value        *hexutil.Big
	StorageLimit *hexutil.Uint64
	ChainID      *hexutil.Big
	Epoch        *Epoch
}

ContractMethodCallOption for setting option when call contract method

type ContractMethodSendOption

type ContractMethodSendOption UnsignedTransactionBase

ContractMethodSendOption for setting option when call contract method

type Create added in v0.1.1

type Create struct {
	Space      SpaceType     `json:"space"`
	From       Address       `json:"from"`
	Value      hexutil.Big   `json:"value"`
	Gas        hexutil.Big   `json:"gas"`
	Init       hexutil.Bytes `json:"init"`
	CreateType CreateType    `json:"createType"`
}

type CreateResult added in v0.1.1

type CreateResult struct {
	Outcome    OutcomeType   `json:"outcome"`
	Addr       Address       `json:"addr"`
	GasLeft    hexutil.Big   `json:"gasLeft"`
	ReturnData hexutil.Bytes `json:"returnData"`
}

type CreateType added in v0.1.1

type CreateType string
const (
	CREATE_NONE    CreateType = "none"
	CREATE_CREATE  CreateType = "create"
	CREATE_CREATE2 CreateType = "create2"
)

type DepositInfo added in v0.1.1

type DepositInfo struct {
	AccumulatedInterestRate *hexutil.Big `json:"accumulatedInterestRate"`
	Amount                  *hexutil.Big `json:"amount"`
	DepositTime             *hexutil.Big `json:"depositTime"`
}

DepositInfo represents user deposit history

type Epoch

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

Epoch represents an epoch in Conflux.

var (
	EpochEarliest         *Epoch = &Epoch{"earliest", nil}
	EpochLatestCheckpoint *Epoch = &Epoch{"latest_checkpoint", nil}
	EpochLatestConfirmed  *Epoch = &Epoch{"latest_confirmed", nil}
	EpochLatestState      *Epoch = &Epoch{"latest_state", nil}
	EpochLatestMined      *Epoch = &Epoch{"latest_mined", nil}
	EpochLatestFinalized  *Epoch = &Epoch{"latest_finalized", nil}
)

Const epoch definitions

func NewEpochNumber

func NewEpochNumber(number *hexutil.Big) *Epoch

NewEpochNumber creates an instance of Epoch with specified number.

func NewEpochNumberBig added in v0.1.1

func NewEpochNumberBig(number *big.Int) *Epoch

NewEpochNumberBig creates an instance of Epoch with specified big number.

func NewEpochNumberUint64 added in v0.1.1

func NewEpochNumberUint64(number uint64) *Epoch

NewEpochNumberUint64 creates an instance of Epoch with specified uint64 number.

func (*Epoch) Equals added in v0.1.1

func (e *Epoch) Equals(target *Epoch) bool

Equals checks if e equals target

func (Epoch) MarshalText

func (e Epoch) MarshalText() ([]byte, error)

MarshalText implements the encoding.TextMarshaler interface.

func (*Epoch) String

func (e *Epoch) String() string

String implements the fmt.Stringer interface

func (*Epoch) ToInt added in v0.1.1

func (e *Epoch) ToInt() (result *big.Int, isSuccess bool)

ToInt returns epoch number in type big.Int

func (*Epoch) UnmarshalJSON added in v0.1.1

func (e *Epoch) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

type EpochOrBlockHash added in v1.5.4

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

func NewEpochOrBlockHashWithBlockHash added in v1.5.4

func NewEpochOrBlockHashWithBlockHash(blockHash Hash, requirePivot ...bool) *EpochOrBlockHash

NewEpochOrBlockHashWithBlockHash creates an instance of Epoch with specified block hash.

func NewEpochOrBlockHashWithEpoch added in v1.5.4

func NewEpochOrBlockHashWithEpoch(epoch *Epoch) *EpochOrBlockHash

NewEpochOrBlockHashWithEpoch creates an instance of Epoch with specified epoch.

func (*EpochOrBlockHash) IsBlockHash added in v1.5.7

func (e *EpochOrBlockHash) IsBlockHash() (*common.Hash, bool, bool)

IsBlockHash returns "block hash" and "require pivot" if it is blockhash, and the 3rd return value represents if is block hash.

func (*EpochOrBlockHash) IsEpoch added in v1.5.7

func (e *EpochOrBlockHash) IsEpoch() (*Epoch, bool)

IsEpoch returns epoch if it is epoch, and the 2rd return value represents if is epoch.

func (EpochOrBlockHash) MarshalJSON added in v1.5.4

func (e EpochOrBlockHash) MarshalJSON() ([]byte, error)

func (EpochOrBlockHash) MarshalText added in v1.5.4

func (e EpochOrBlockHash) MarshalText() ([]byte, error)

MarshalText implements the encoding.TextMarshaler interface.

func (*EpochOrBlockHash) String added in v1.5.4

func (e *EpochOrBlockHash) String() string

String implements the fmt.Stringer interface

func (*EpochOrBlockHash) UnmarshalJSON added in v1.5.4

func (e *EpochOrBlockHash) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

type EpochReceiptProof added in v1.5.7

type EpochReceiptProof struct {
	BlockIndexProof   TrieProof `json:"block_index_proof"`
	BlockReceiptProof TrieProof `json:"block_receipt_proof"`
}

type EpochTrace added in v1.5.4

type EpochTrace struct {
	CfxTraces        []*LocalizedTrace                     `json:"cfxTraces"`
	EthTraces        []*web3gotypes.LocalizedTrace         `json:"ethTraces"`
	MirrorAddressMap map[common.Address]cfxaddress.Address `json:"mirrorAddressMap"`
}

type Estimate

type Estimate struct {
	GasLimit              *hexutil.Big `json:"gasLimit"`
	GasUsed               *hexutil.Big `json:"gasUsed"`
	StorageCollateralized *hexutil.Big `json:"storageCollateralized"`
}

Estimate represents estimated gas will be used and storage will be collateralized when transaction excutes

type H128 added in v1.5.4

type H128 [H128Length]byte

func HexToH128 added in v1.5.4

func HexToH128(s string) H128

func (H128) Hex added in v1.5.4

func (h H128) Hex() string

func (H128) MarshalText added in v1.5.4

func (h H128) MarshalText() ([]byte, error)

func (*H128) SetBytes added in v1.5.4

func (h *H128) SetBytes(b []byte)

SetBytes sets the H128 to the value of b. If b is larger than len(h), b will be cropped from the left.

func (H128) String added in v1.5.4

func (h H128) String() string

func (*H128) UnmarshalJSON added in v1.5.4

func (h *H128) UnmarshalJSON(data []byte) error

func (*H128) UnmarshalText added in v1.5.4

func (h *H128) UnmarshalText(input []byte) error

type Hash

type Hash string

Hash represents the 32 byte Keccak256 hash of arbitrary data in HEX format.

func (Hash) String

func (hash Hash) String() string

String implements the interface stringer

func (Hash) ToCommonHash added in v0.1.1

func (hash Hash) ToCommonHash() *common.Hash

ToCommonHash converts hash to common.Hash

func (*Hash) UnmarshalJSON added in v0.1.1

func (hash *Hash) UnmarshalJSON(input []byte) error

type InternalTransferAction added in v0.1.1

type InternalTransferAction struct {
	From       Address     `json:"from"`
	FromPocket PocketType  `json:"fromPocket"`
	FromSpace  SpaceType   `json:"fromSpace"`
	To         Address     `json:"to"`
	ToPocket   PocketType  `json:"toPocket"`
	ToSpace    SpaceType   `json:"toSpace"`
	Value      hexutil.Big `json:"value"`
}

type LocalizedBlockTrace added in v0.1.1

type LocalizedBlockTrace struct {
	TransactionTraces []LocalizedTransactionTrace `json:"transactionTraces"`
	EpochHash         Hash                        `json:"epochHash"`
	EpochNumber       hexutil.Big                 `json:"epochNumber"`
	BlockHash         Hash                        `json:"blockHash"`
}

type LocalizedTrace added in v0.1.1

type LocalizedTrace struct {
	Action              interface{}     `json:"action"`
	Valid               bool            `json:"valid"`
	Type                TraceType       `json:"type"`
	EpochHash           *Hash           `json:"epochHash,omitempty"`
	EpochNumber         *hexutil.Big    `json:"epochNumber,omitempty"`
	BlockHash           *Hash           `json:"blockHash,omitempty"`
	TransactionPosition *hexutil.Uint64 `json:"transactionPosition,omitempty"`
	TransactionHash     *Hash           `json:"transactionHash,omitempty"`
}

func (*LocalizedTrace) UnmarshalJSON added in v0.1.1

func (l *LocalizedTrace) UnmarshalJSON(data []byte) error

UnmarshalJSON unmarshals Input and Init type from []byte to hexutil.Bytes

type LocalizedTraceNode added in v0.1.1

type LocalizedTraceNode struct {
	Type                TraceType       `json:"type"`
	Valid               bool            `json:"valid"`
	EpochHash           *Hash           `json:"epochHash,omitempty"`
	EpochNumber         *hexutil.Big    `json:"epochNumber,omitempty"`
	BlockHash           *Hash           `json:"blockHash,omitempty"`
	TransactionPosition *hexutil.Uint64 `json:"transactionPosition,omitempty"`
	TransactionHash     *Hash           `json:"transactionHash,omitempty"`

	CallWithResult         *TraceCallWithResult    `json:"callWithResult,omitempty"`
	CreateWithResult       *TraceCreateWithResult  `json:"createWithResult,omitempty"`
	InternalTransferAction *InternalTransferAction `json:"internalTransferAction,omitempty"`

	Childs []*LocalizedTraceNode `json:"childs"`
}

func (LocalizedTraceNode) Flatten added in v0.1.1

func (l LocalizedTraceNode) Flatten() (flattened []*LocalizedTraceNode)

type LocalizedTraceTire added in v0.1.1

type LocalizedTraceTire []*LocalizedTraceNode

func TraceInTire added in v0.1.1

func TraceInTire(traces []LocalizedTrace) (tier LocalizedTraceTire, err error)

TraceInTire convert flattened trace to trie, the convered tiers are stored in the order of the flattened trace like follow.

InternalTransfer
call
create
createResult
callResult
InternalTransfer
============>
InternalTransfer
call + callResult
	|- create + createResult
InternalTransfer

func (LocalizedTraceTire) Flatten added in v0.1.1

func (t LocalizedTraceTire) Flatten() (flattened []*LocalizedTraceNode)

type LocalizedTransactionTrace added in v0.1.1

type LocalizedTransactionTrace struct {
	Traces              []LocalizedTrace `json:"traces"`
	TransactionPosition hexutil.Uint64   `json:"transactionPosition"`
	TransactionHash     Hash             `json:"transactionHash"`
}

type Log

type Log struct {
	Address             Address       `json:"address"`
	Topics              []Hash        `json:"topics"`
	Data                hexutil.Bytes `json:"data"`
	BlockHash           *Hash         `json:"blockHash,omitempty"`
	EpochNumber         *hexutil.Big  `json:"epochNumber,omitempty"`
	TransactionHash     *Hash         `json:"transactionHash,omitempty"`
	TransactionIndex    *hexutil.Big  `json:"transactionIndex,omitempty"`
	LogIndex            *hexutil.Big  `json:"logIndex,omitempty"`
	TransactionLogIndex *hexutil.Big  `json:"transactionLogIndex,omitempty"`
	Space               *SpaceType    `json:"space,omitempty"`
}

Log represents the event in a smart contract

func (*Log) DecodeRLP added in v0.1.1

func (log *Log) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (Log) EncodeRLP added in v0.1.1

func (log Log) EncodeRLP(w io.Writer) error

EncodeRLP implements the rlp.Encoder interface.

type LogFilter

type LogFilter struct {
	FromEpoch   *Epoch       `json:"fromEpoch,omitempty"`
	ToEpoch     *Epoch       `json:"toEpoch,omitempty"`
	FromBlock   *hexutil.Big `json:"fromBlock,omitempty"`
	ToBlock     *hexutil.Big `json:"toBlock,omitempty"`
	BlockHashes []Hash       `json:"blockHashes,omitempty"`
	Address     []Address    `json:"address,omitempty"`
	Topics      [][]Hash     `json:"topics,omitempty"`
}

LogFilter represents the filter of event in a smart contract.

func (*LogFilter) UnmarshalJSON added in v0.1.1

func (l *LogFilter) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

type NonceType added in v1.5.3

type NonceType int
const (
	NONCE_TYPE_AUTO NonceType = iota
	NONCE_TYPE_NONCE
	NONCE_TYPE_PENDING_NONCE
)

type OutcomeType added in v0.1.1

type OutcomeType string
const (
	OUTCOME_SUCCESS  OutcomeType = "success"
	OUTCOME_REVERTED OutcomeType = "reverted"
	OUTCOME_FAIL     OutcomeType = "fail"
)

type PendingReason added in v1.5.7

type PendingReason string
const (
	PENDING_REASON_FUTURE_NONCE     PendingReason = "futureNonce"
	PENDING_REASON_NOT_ENOUGH_CASH  PendingReason = "notEnoughCash"
	PENDING_REASON_OLD_EPOCH_HEIGHT PendingReason = "oldEpochHeight"
	PENDING_REASON_OUTDATED_STATUS  PendingReason = "outdatedStatus"
)

type PoSEconomics added in v0.1.1

type PoSEconomics struct {
	TotalPosStakingTokens    *hexutil.Big   `json:"totalPosStakingTokens"`
	DistributablePosInterest *hexutil.Big   `json:"distributablePosInterest"`
	LastDistributeBlock      hexutil.Uint64 `json:"lastDistributeBlock"`
}

type PocketType added in v0.1.1

type PocketType string
const (
	POCKET_BALANCE                     PocketType = "balance"
	POCKET_STAKING_BALANCE             PocketType = "staking_balance"
	POCKET_STORAGE_COLLATERAL          PocketType = "storage_collateral"
	POCKET_SPONSOR_BALANCE_FOR_GAS     PocketType = "sponsor_balance_for_gas"
	POCKET_SPONSOR_BALANCE_FOR_STORAGE PocketType = "sponsor_balance_for_collateral"
	POCKET_MINT_BURN                   PocketType = "mint_or_burn"
	POCKET_GAS_PAYMENT                 PocketType = "gas_payment"
)

type RewardInfo added in v0.1.1

type RewardInfo struct {
	BlockHash Hash `json:"blockHash"`
	// H256,
	Author Address `json:"author"`
	// H160,
	TotalReward *hexutil.Big `json:"totalReward"`
	// U256,
	BaseReward *hexutil.Big `json:"baseReward"`
	// U256,
	TxFee *hexutil.Big `json:"txFee"`
}

type SignedTransaction

type SignedTransaction struct {
	UnsignedTransaction UnsignedTransaction
	V                   byte
	R                   hexutil.Bytes
	S                   hexutil.Bytes
}

SignedTransaction represents a transaction with signature, it is the transaction information for sending transaction.

func (*SignedTransaction) Decode

func (tx *SignedTransaction) Decode(data []byte, networkID uint32) error

Decode decodes RLP encoded data to tx

func (*SignedTransaction) Encode

func (tx *SignedTransaction) Encode() ([]byte, error)

Encode encodes tx and returns its RLP encoded data

func (*SignedTransaction) Hash added in v0.1.1

func (tx *SignedTransaction) Hash() ([]byte, error)

Hash calculates the hash of the transaction rlp encode result

func (*SignedTransaction) Sender added in v0.1.1

func (tx *SignedTransaction) Sender(networkId uint32) (Address, error)

Sender recovers the sender from a signed transaction

func (*SignedTransaction) Signature added in v0.1.1

func (tx *SignedTransaction) Signature() []byte

Signature returns the signature of the transaction

type SpaceType added in v0.1.1

type SpaceType string
const (
	SPACE_EVM    SpaceType = "evm"
	SPACE_NATIVE SpaceType = "native"
	SPACE_NONE   SpaceType = "none"
)

type SponsorInfo added in v0.1.1

type SponsorInfo struct {
	SponsorForGas               Address      `json:"sponsorForGas"`
	SponsorForCollateral        Address      `json:"sponsorForCollateral"`
	SponsorGasBound             *hexutil.Big `json:"sponsorGasBound"`
	SponsorBalanceForGas        *hexutil.Big `json:"sponsorBalanceForGas"`
	SponsorBalanceForCollateral *hexutil.Big `json:"sponsorBalanceForCollateral"`
	AvailableStoragePoints      *hexutil.Big `json:"availableStoragePoints"`
	UsedStoragePoints           *hexutil.Big `json:"usedStoragePoints"`
}

type Status added in v0.1.1

type Status struct {
	BestHash             Hash           `json:"bestHash"`
	ChainID              hexutil.Uint64 `json:"chainId"`
	EthereumSpaceChainId hexutil.Uint64 `json:"ethereumSpaceChainId"`
	NetworkID            hexutil.Uint64 `json:"networkId"`
	EpochNumber          hexutil.Uint64 `json:"epochNumber"`
	BlockNumber          hexutil.Uint64 `json:"blockNumber"`
	PendingTxNumber      hexutil.Uint64 `json:"pendingTxNumber"`
	LatestCheckpoint     hexutil.Uint64 `json:"latestCheckpoint"`
	LatestConfirmed      hexutil.Uint64 `json:"latestConfirmed"`
	LatestState          hexutil.Uint64 `json:"latestState"`
	LatestFinalized      hexutil.Uint64 `json:"latestFinalized"`
}

Status represents current blockchain status

type StorageChange added in v0.1.1

type StorageChange struct {
	Address Address `json:"address"`
	/// Number of storage collateral units to deposit / refund (absolute value).
	Collaterals hexutil.Uint64 `json:"collaterals"`
}

StorageChange represents storage change information of the address

type StorageCollateralInfo added in v1.5.7

type StorageCollateralInfo struct {
	TotalStorageTokens     *hexutil.Big `json:"totalStorageTokens"`
	ConvertedStoragePoints *hexutil.Big `json:"convertedStoragePoints"`
	UsedStoragePoints      *hexutil.Big `json:"usedStoragePoints"`
}

type StorageRoot added in v0.1.1

type StorageRoot struct {
	Delta        *Hash `json:"delta"`        //delta: H256,
	Intermediate *Hash `json:"intermediate"` //intermediate: H256,
	Snapshot     *Hash `json:"snapshot"`     //snapshot: H256,
}

type SubscriptionLog added in v0.1.1

type SubscriptionLog struct {
	*Log
	*ChainReorg
}

func (*SubscriptionLog) DecodeRLP added in v0.1.1

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

func (SubscriptionLog) EncodeRLP added in v0.1.1

func (s SubscriptionLog) EncodeRLP(w io.Writer) error

func (SubscriptionLog) IsRevertLog added in v0.1.1

func (s SubscriptionLog) IsRevertLog() bool

func (SubscriptionLog) MarshalJSON added in v0.1.1

func (s SubscriptionLog) MarshalJSON() ([]byte, error)

type TokenSupplyInfo added in v0.1.1

type TokenSupplyInfo struct {
	TotalCirculating  *hexutil.Big `json:"totalCirculating"`
	TotalIssued       *hexutil.Big `json:"totalIssued"`
	TotalStaking      *hexutil.Big `json:"totalStaking"`
	TotalCollateral   *hexutil.Big `json:"totalCollateral"`
	TotalEspaceTokens *hexutil.Big `json:"totalEspaceTokens"`
}

type TraceCallWithResult added in v0.1.1

type TraceCallWithResult struct {
	*Call       `json:"call"`
	*CallResult `json:"callResult"`
}

type TraceCreateWithResult added in v0.1.1

type TraceCreateWithResult struct {
	*Create       `json:"create"`
	*CreateResult `json:"createResult"`
}

type TraceFilter added in v0.1.1

type TraceFilter struct {
	FromEpoch   *Epoch    `json:"fromEpoch"`
	ToEpoch     *Epoch    `json:"toEpoch"`
	FromAddress []Address `json:"fromAddress"`
	ToAddress   []Address `json:"toAddress"`
	BlockHashes []Hash    `json:"blockHashes"`
	// action types could be "call","create","callResult","createResult","internalTransferAction"
	ActionTypes []TraceType     `json:"actionTypes"`
	After       *hexutil.Uint64 `json:"after"`
	Count       *hexutil.Uint64 `json:"count"`
}

type TraceType added in v0.1.1

type TraceType string
const (
	TRACE_CALL                      TraceType = "call"
	TRACE_CALL_RESULT               TraceType = "call_result"
	TRACE_CREATE                    TraceType = "create"
	TRACE_CREATE_RESULT             TraceType = "create_result"
	TRACE_INTERNAL_TRANSFER_ACTIION TraceType = "internal_transfer_action"
)

type Transaction

type Transaction struct {
	// Space            *string          `json:"space,omitempty"` //currently it is always "nil", so comment it now and uncomment it if need later
	Hash             Hash            `json:"hash"`
	Nonce            *hexutil.Big    `json:"nonce"`
	BlockHash        *Hash           `json:"blockHash"`
	TransactionIndex *hexutil.Uint64 `json:"transactionIndex"`
	From             Address         `json:"from"`
	To               *Address        `json:"to"`
	Value            *hexutil.Big    `json:"value"`
	GasPrice         *hexutil.Big    `json:"gasPrice"`
	Gas              *hexutil.Big    `json:"gas"`
	ContractCreated  *Address        `json:"contractCreated"`
	Data             string          `json:"data"`
	StorageLimit     *hexutil.Big    `json:"storageLimit"`
	EpochHeight      *hexutil.Big    `json:"epochHeight"`
	ChainID          *hexutil.Big    `json:"chainId"`
	Status           *hexutil.Uint64 `json:"status"`

	//signature
	V *hexutil.Big `json:"v"`
	R *hexutil.Big `json:"r"`
	S *hexutil.Big `json:"s"`
}

Transaction represents a transaction with signature in Conflux. it is the response from conflux node when sending rpc request, such as cfx_getTransactionByHash

func (*Transaction) DecodeRLP added in v0.1.1

func (tx *Transaction) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (Transaction) EncodeRLP added in v0.1.1

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

EncodeRLP implements the rlp.Encoder interface.

type TransactionReceipt

type TransactionReceipt struct {
	TransactionHash    Hash            `json:"transactionHash"`
	Index              hexutil.Uint64  `json:"index"`
	BlockHash          Hash            `json:"blockHash"`
	EpochNumber        *hexutil.Uint64 `json:"epochNumber"`
	From               Address         `json:"from"`
	To                 *Address        `json:"to"`
	GasUsed            *hexutil.Big    `json:"gasUsed"`
	AccumulatedGasUsed *hexutil.Big    `json:"accumulatedGasUsed,omitempty"`
	GasFee             *hexutil.Big    `json:"gasFee"`
	ContractCreated    *Address        `json:"contractCreated"`
	Logs               []Log           `json:"logs"`
	LogsBloom          Bloom           `json:"logsBloom"`
	StateRoot          Hash            `json:"stateRoot"`
	OutcomeStatus      hexutil.Uint64  `json:"outcomeStatus"`
	TxExecErrorMsg     *string         `json:"txExecErrorMsg"`
	// Whether gas costs were covered by the sponsor.
	GasCoveredBySponsor bool `json:"gasCoveredBySponsor"`
	// Whether storage costs were covered by the sponsor.
	StorageCoveredBySponsor bool `json:"storageCoveredBySponsor"`
	// The amount of storage collateralized by the sender.
	StorageCollateralized hexutil.Uint64 `json:"storageCollateralized"`
	// Storage collaterals released during the execution of the transaction.
	StorageReleased []StorageChange `json:"storageReleased"`
	Space           *SpaceType      `json:"space,omitempty"`
}

TransactionReceipt represents the transaction execution result in Conflux. it is the response from conflux node when sending rpc request, such as cfx_getTransactionReceipt

func (*TransactionReceipt) DecodeRLP added in v0.1.1

func (tr *TransactionReceipt) DecodeRLP(r *rlp.Stream) error

DecodeRLP implements the rlp.Decoder interface.

func (TransactionReceipt) EncodeRLP added in v0.1.1

func (tr TransactionReceipt) EncodeRLP(w io.Writer) error

EncodeRLP implements the rlp.Encoder interface.

func (*TransactionReceipt) GetOutcomeType added in v1.5.7

func (r *TransactionReceipt) GetOutcomeType() (enums.TransactionOutcome, error)

func (*TransactionReceipt) MustGetOutcomeType added in v1.5.7

func (r *TransactionReceipt) MustGetOutcomeType() enums.TransactionOutcome

type TransactionStatus added in v0.1.1

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

func (*TransactionStatus) IsPending added in v0.1.1

func (ts *TransactionStatus) IsPending() (bool, PendingReason)

func (TransactionStatus) MarshalJSON added in v0.1.1

func (ts TransactionStatus) MarshalJSON() ([]byte, error)

func (TransactionStatus) String added in v0.1.1

func (ts TransactionStatus) String() string

func (*TransactionStatus) UnmarshalJSON added in v0.1.1

func (ts *TransactionStatus) UnmarshalJSON(data []byte) error

type TrieProof added in v1.5.7

type TrieProof []VanillaTrieNode

type TxPoolPendingNonceRange added in v0.1.1

type TxPoolPendingNonceRange struct {
	MinNonce *hexutil.Big `json:"minNonce"`
	MaxNonce *hexutil.Big `json:"maxNonce"`
}

type TxPoolStatus added in v0.1.1

type TxPoolStatus struct {
	Deferred   hexutil.Uint64 `json:"deferred"`
	Ready      hexutil.Uint64 `json:"ready"`
	Received   hexutil.Uint64 `json:"received"`
	Unexecuted hexutil.Uint64 `json:"unexecuted"`
}

type TxWithPoolInfo added in v0.1.1

type TxWithPoolInfo struct {
	Exist              bool         `json:"exist"`
	Packed             bool         `json:"packed"`
	LocalNonce         *hexutil.Big `json:"localNonce"`
	LocalBalance       *hexutil.Big `json:"localBalance"`
	StateNonce         *hexutil.Big `json:"stateNonce"`
	StateBalance       *hexutil.Big `json:"stateBalance"`
	LocalBalanceEnough bool         `json:"localBalanceEnough"`
	StateBalanceEnough bool         `json:"stateBalanceEnough"`
}

type UnsignedTransaction

type UnsignedTransaction struct {
	UnsignedTransactionBase
	To   *Address
	Data hexutil.Bytes
}

UnsignedTransaction represents a transaction without signature, it is the transaction information for sending transaction.

func (*UnsignedTransaction) ApplyDefault

func (tx *UnsignedTransaction) ApplyDefault()

ApplyDefault applys default value for these fields if they are empty

func (*UnsignedTransaction) Decode

func (tx *UnsignedTransaction) Decode(data []byte, networkID uint32) error

Decode decodes RLP encoded data to tx

func (*UnsignedTransaction) Encode

func (tx *UnsignedTransaction) Encode() ([]byte, error)

Encode encodes tx and returns its RLP encoded data

func (*UnsignedTransaction) EncodeWithSignature

func (tx *UnsignedTransaction) EncodeWithSignature(v byte, r, s []byte) ([]byte, error)

EncodeWithSignature encodes tx with signature and return its RLP encoded data

func (*UnsignedTransaction) Hash

func (tx *UnsignedTransaction) Hash() ([]byte, error)

Hash hashes the tx by keccak256 and returns the result

type UnsignedTransactionBase

type UnsignedTransactionBase struct {
	From         *Address
	Nonce        *hexutil.Big
	GasPrice     *hexutil.Big
	Gas          *hexutil.Big
	Value        *hexutil.Big
	StorageLimit *hexutil.Uint64
	EpochHeight  *hexutil.Uint64
	ChainID      *hexutil.Uint
}

UnsignedTransactionBase represents a transaction without To, Data and signature

type VanillaTrieNode added in v1.5.7

type VanillaTrieNode struct {
	ChildrenTable  []common.Hash `json:"childrenTable"`
	CompressedPath struct {
		PathMask  hexutil.Uint  `json:"pathMask"`
		PathSlice hexutil.Bytes `json:"pathSlice"`
	} `json:"compressedPath"`
	MerkleHash common.Hash    `json:"merkleHash"`
	MptValue   *hexutil.Bytes `json:"mptValue"`
}

type VoteStakeInfo added in v0.1.1

type VoteStakeInfo struct {
	/// This is the number of tokens should be locked before
	/// `unlock_block_number`.
	Amount *hexutil.Big `json:"amount"`
	/// This is the timestamp when the vote right will be invalid, measured in
	/// the number of past blocks.
	UnlockBlockNumber uint64 `json:"unlockBlockNumber"`
}

VoteStakeInfo represents user vote history

func (*VoteStakeInfo) UnmarshalJSON added in v0.1.1

func (v *VoteStakeInfo) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

type WebsocketEpochResponse added in v0.1.1

type WebsocketEpochResponse struct {
	EpochHashesOrdered []Hash       `json:"epochHashesOrdered"`
	EpochNumber        *hexutil.Big `json:"epochNumber"`
}

WebsocketEpochResponse represents result of epoch websocket subscription

type WrapTransaction added in v1.5.4

type WrapTransaction struct {
	NativeTransaction *Transaction       `json:"nativeTransaction"`
	EthTransaction    *types.Transaction `json:"ethTransaction"`
}

Directories

Path Synopsis

Jump to

Keyboard shortcuts

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