Documentation ¶
Overview ¶
Package gvnt contains the simplified mobile APIs to go-ethereum.
The scope of this package is *not* to allow writing a custom VNT client with pieces plucked from go-ethereum, rather to allow writing native dapps on mobile platforms. Keep this in mind when using or extending this package!
API limitations ¶
Since gomobile cannot bridge arbitrary types between Go and Android/iOS, the exposed APIs need to be manually wrapped into simplified types, with custom constructors and getters/setters to ensure that they can be meaninfully used from Java/ObjC too.
With this in mind, please try to limit the scope of this package and only add essentials without which mobile support cannot work, especially since manually syncing the code will be unwieldy otherwise. In the long term we might consider writing custom library generators, but those are out of scope now.
Content wise each file in this package corresponds to an entire Go package from the go-ethereum repository. Please adhere to this scoping to prevent this package getting unmaintainable.
Wrapping guidelines:
Every type that is to be exposed should be wrapped into its own plain struct, which internally contains a single field: the original go-ethereum version. This is needed because gomobile cannot expose named types for now.
Whenever a method argument or a return type is a custom struct, the pointer variant should always be used as value types crossing over between language boundaries might have strange behaviors.
Slices of types should be converted into a single multiplicative type wrapping a go slice with the methods `Size`, `Get` and `Set`. Further slice operations should not be provided to limit the remote code complexity. Arrays should be avoided as much as possible since they complicate bounds checking.
If a method has multiple return values (e.g. some return + an error), those are generated as output arguments in ObjC. To avoid weird generated names like ret_0 for them, please always assign names to output variables if tuples.
Note, a panic *cannot* cross over language boundaries, instead will result in an undebuggable SEGFAULT in the process. For error handling only ever use error returns, which may be the only or the second return.
Index ¶
- Constants
- func SetVerbosity(level int)
- type Account
- type Accounts
- type Address
- type Addresses
- type BigInt
- func (bi *BigInt) GetBytes() []byte
- func (bi *BigInt) GetInt64() int64
- func (bi *BigInt) GetString(base int) string
- func (bi *BigInt) SetBytes(buf []byte)
- func (bi *BigInt) SetInt64(x int64)
- func (bi *BigInt) SetString(x string, base int)
- func (bi *BigInt) Sign() int
- func (bi *BigInt) String() string
- type BigInts
- type Block
- func (b *Block) EncodeJSON() (string, error)
- func (b *Block) EncodeRLP() ([]byte, error)
- func (b *Block) GetBloom() *Bloom
- func (b *Block) GetCoinbase() *Address
- func (b *Block) GetDifficulty() *BigInt
- func (b *Block) GetExtra() []byte
- func (b *Block) GetGasLimit() int64
- func (b *Block) GetGasUsed() int64
- func (b *Block) GetHash() *Hash
- func (b *Block) GetHashNoNonce() *Hash
- func (b *Block) GetHeader() *Header
- func (b *Block) GetNumber() int64
- func (b *Block) GetParentHash() *Hash
- func (b *Block) GetReceiptHash() *Hash
- func (b *Block) GetRoot() *Hash
- func (b *Block) GetTime() int64
- func (b *Block) GetTransaction(hash *Hash) *Transaction
- func (b *Block) GetTransactions() *Transactions
- func (b *Block) GetTxHash() *Hash
- type Bloom
- type BoundContract
- func (c *BoundContract) Call(opts *CallOpts, out *Interfaces, method string, args *Interfaces) error
- func (c *BoundContract) GetAddress() *Address
- func (c *BoundContract) GetDeployer() *Transaction
- func (c *BoundContract) Transact(opts *TransactOpts, method string, args *Interfaces) (tx *Transaction, _ error)
- func (c *BoundContract) Transfer(opts *TransactOpts) (tx *Transaction, _ error)
- type CallMsg
- func (msg *CallMsg) GetData() []byte
- func (msg *CallMsg) GetFrom() *Address
- func (msg *CallMsg) GetGas() int64
- func (msg *CallMsg) GetGasPrice() *BigInt
- func (msg *CallMsg) GetTo() *Address
- func (msg *CallMsg) GetValue() *BigInt
- func (msg *CallMsg) SetData(data []byte)
- func (msg *CallMsg) SetFrom(address *Address)
- func (msg *CallMsg) SetGas(gas int64)
- func (msg *CallMsg) SetGasPrice(price *BigInt)
- func (msg *CallMsg) SetTo(address *Address)
- func (msg *CallMsg) SetValue(value *BigInt)
- type CallOpts
- type Context
- type FilterLogsHandler
- type FilterQuery
- func (fq *FilterQuery) GetAddresses() *Addresses
- func (fq *FilterQuery) GetFromBlock() *BigInt
- func (fq *FilterQuery) GetToBlock() *BigInt
- func (fq *FilterQuery) GetTopics() *Topics
- func (fq *FilterQuery) SetAddresses(addresses *Addresses)
- func (fq *FilterQuery) SetFromBlock(fromBlock *BigInt)
- func (fq *FilterQuery) SetToBlock(toBlock *BigInt)
- func (fq *FilterQuery) SetTopics(topics *Topics)
- type Hash
- type Hashes
- type Header
- func (h *Header) EncodeJSON() (string, error)
- func (h *Header) EncodeRLP() ([]byte, error)
- func (h *Header) GetBloom() *Bloom
- func (h *Header) GetCoinbase() *Address
- func (h *Header) GetDifficulty() *BigInt
- func (h *Header) GetExtra() []byte
- func (h *Header) GetGasLimit() int64
- func (h *Header) GetGasUsed() int64
- func (h *Header) GetHash() *Hash
- func (h *Header) GetNumber() int64
- func (h *Header) GetParentHash() *Hash
- func (h *Header) GetReceiptHash() *Hash
- func (h *Header) GetRoot() *Hash
- func (h *Header) GetTime() int64
- func (h *Header) GetTxHash() *Hash
- type Headers
- type Interface
- func (i *Interface) GetAddress() *Address
- func (i *Interface) GetAddresses() *Addresses
- func (i *Interface) GetBigInt() *BigInt
- func (i *Interface) GetBigInts() *BigInts
- func (i *Interface) GetBinaries() [][]byte
- func (i *Interface) GetBinary() []byte
- func (i *Interface) GetBool() bool
- func (i *Interface) GetBools() []bool
- func (i *Interface) GetHash() *Hash
- func (i *Interface) GetHashes() *Hashes
- func (i *Interface) GetInt16() int16
- func (i *Interface) GetInt32() int32
- func (i *Interface) GetInt64() int64
- func (i *Interface) GetInt8() int8
- func (i *Interface) GetString() string
- func (i *Interface) GetStrings() *Strings
- func (i *Interface) GetUint16() *BigInt
- func (i *Interface) GetUint32() *BigInt
- func (i *Interface) GetUint64() *BigInt
- func (i *Interface) GetUint8() *BigInt
- func (i *Interface) SetAddress(address *Address)
- func (i *Interface) SetAddresses(addrs *Addresses)
- func (i *Interface) SetBigInt(bigint *BigInt)
- func (i *Interface) SetBigInts(bigints *BigInts)
- func (i *Interface) SetBinaries(binaries [][]byte)
- func (i *Interface) SetBinary(binary []byte)
- func (i *Interface) SetBool(b bool)
- func (i *Interface) SetBools(bs []bool)
- func (i *Interface) SetDefaultAddress()
- func (i *Interface) SetDefaultAddresses()
- func (i *Interface) SetDefaultBigInt()
- func (i *Interface) SetDefaultBigInts()
- func (i *Interface) SetDefaultBinaries()
- func (i *Interface) SetDefaultBinary()
- func (i *Interface) SetDefaultBool()
- func (i *Interface) SetDefaultBools()
- func (i *Interface) SetDefaultHash()
- func (i *Interface) SetDefaultHashes()
- func (i *Interface) SetDefaultInt16()
- func (i *Interface) SetDefaultInt32()
- func (i *Interface) SetDefaultInt64()
- func (i *Interface) SetDefaultInt8()
- func (i *Interface) SetDefaultString()
- func (i *Interface) SetDefaultStrings()
- func (i *Interface) SetDefaultUint16()
- func (i *Interface) SetDefaultUint32()
- func (i *Interface) SetDefaultUint64()
- func (i *Interface) SetDefaultUint8()
- func (i *Interface) SetHash(hash *Hash)
- func (i *Interface) SetHashes(hashes *Hashes)
- func (i *Interface) SetInt16(n int16)
- func (i *Interface) SetInt32(n int32)
- func (i *Interface) SetInt64(n int64)
- func (i *Interface) SetInt8(n int8)
- func (i *Interface) SetString(str string)
- func (i *Interface) SetStrings(strs *Strings)
- func (i *Interface) SetUint16(bigint *BigInt)
- func (i *Interface) SetUint32(bigint *BigInt)
- func (i *Interface) SetUint64(bigint *BigInt)
- func (i *Interface) SetUint8(bigint *BigInt)
- type Interfaces
- type KeyStore
- func (ks *KeyStore) DeleteAccount(account *Account, passphrase string) error
- func (ks *KeyStore) ExportKey(account *Account, passphrase, newPassphrase string) (key []byte, _ error)
- func (ks *KeyStore) GetAccounts() *Accounts
- func (ks *KeyStore) HasAddress(address *Address) bool
- func (ks *KeyStore) ImportECDSAKey(key []byte, passphrase string) (account *Account, _ error)
- func (ks *KeyStore) ImportKey(keyJSON []byte, passphrase, newPassphrase string) (account *Account, _ error)
- func (ks *KeyStore) ImportPreSaleKey(keyJSON []byte, passphrase string) (ccount *Account, _ error)
- func (ks *KeyStore) Lock(address *Address) error
- func (ks *KeyStore) NewAccount(passphrase string) (*Account, error)
- func (ks *KeyStore) SignHash(address *Address, hash []byte) (signature []byte, _ error)
- func (ks *KeyStore) SignHashPassphrase(account *Account, passphrase string, hash []byte) (signature []byte, _ error)
- func (ks *KeyStore) SignTx(account *Account, tx *Transaction, chainID *BigInt) (*Transaction, error)
- func (ks *KeyStore) SignTxPassphrase(account *Account, passphrase string, tx *Transaction, chainID *BigInt) (*Transaction, error)
- func (ks *KeyStore) TimedUnlock(account *Account, passphrase string, timeout int64) error
- func (ks *KeyStore) Unlock(account *Account, passphrase string) error
- func (ks *KeyStore) UpdateAccount(account *Account, passphrase, newPassphrase string) error
- type Log
- type Logs
- type NewHeadHandler
- type Node
- type NodeConfig
- type NodeInfo
- func (ni *NodeInfo) GetDiscoveryPort() int
- func (ni *NodeInfo) GetID() string
- func (ni *NodeInfo) GetIP() string
- func (ni *NodeInfo) GetListenerAddress() string
- func (ni *NodeInfo) GetListenerPort() int
- func (ni *NodeInfo) GetName() string
- func (ni *NodeInfo) GetProtocols() *Strings
- func (ni *NodeInfo) GetVNTNode() string
- type PeerInfo
- type PeerInfos
- type Receipt
- func (r *Receipt) EncodeJSON() (string, error)
- func (r *Receipt) EncodeRLP() ([]byte, error)
- func (r *Receipt) GetBloom() *Bloom
- func (r *Receipt) GetContractAddress() *Address
- func (r *Receipt) GetCumulativeGasUsed() int64
- func (r *Receipt) GetGasUsed() int64
- func (r *Receipt) GetLogs() *Logs
- func (r *Receipt) GetPostState() []byte
- func (r *Receipt) GetStatus() int
- func (r *Receipt) GetTxHash() *Hash
- type Signer
- type Strings
- type Subscription
- type SyncProgress
- type Topics
- type TransactOpts
- func (opts *TransactOpts) GetChainID() *BigInt
- func (opts *TransactOpts) GetFrom() *Address
- func (opts *TransactOpts) GetGasLimit() int64
- func (opts *TransactOpts) GetGasPrice() *BigInt
- func (opts *TransactOpts) GetNonce() int64
- func (opts *TransactOpts) GetValue() *BigInt
- func (opts *TransactOpts) SetChainID(chainID *BigInt)
- func (opts *TransactOpts) SetContext(context *Context)
- func (opts *TransactOpts) SetFrom(from *Address)
- func (opts *TransactOpts) SetGasLimit(limit int64)
- func (opts *TransactOpts) SetGasPrice(price *BigInt)
- func (opts *TransactOpts) SetNonce(nonce int64)
- func (opts *TransactOpts) SetSigner(s Signer)
- func (opts *TransactOpts) SetValue(value *BigInt)
- type Transaction
- func (tx *Transaction) EncodeJSON() (string, error)
- func (tx *Transaction) EncodeRLP() ([]byte, error)
- func (tx *Transaction) GetCost() *BigInt
- func (tx *Transaction) GetData() []byte
- func (tx *Transaction) GetFrom(chainID *BigInt) (address *Address, _ error)deprecated
- func (tx *Transaction) GetGas() int64
- func (tx *Transaction) GetGasPrice() *BigInt
- func (tx *Transaction) GetHash() *Hash
- func (tx *Transaction) GetNonce() int64
- func (tx *Transaction) GetSigHash(chainID *BigInt) *Hashdeprecated
- func (tx *Transaction) GetTo() *Address
- func (tx *Transaction) GetValue() *BigInt
- func (tx *Transaction) WithSignature(sig []byte, chainID *BigInt) (signedTx *Transaction, _ error)
- type Transactions
- type VNTClient
- func (ec *VNTClient) CallContract(ctx *Context, msg *CallMsg, number int64) (output []byte, _ error)
- func (ec *VNTClient) EstimateGas(ctx *Context, msg *CallMsg) (gas int64, _ error)
- func (ec *VNTClient) FilterLogs(ctx *Context, query *FilterQuery) (logs *Logs, _ error)
- func (ec *VNTClient) GetBalanceAt(ctx *Context, account *Address, number int64) (balance *BigInt, _ error)
- func (ec *VNTClient) GetBlockByHash(ctx *Context, hash *Hash) (block *Block, _ error)
- func (ec *VNTClient) GetBlockByNumber(ctx *Context, number int64) (block *Block, _ error)
- func (ec *VNTClient) GetCodeAt(ctx *Context, account *Address, number int64) (code []byte, _ error)
- func (ec *VNTClient) GetHeaderByHash(ctx *Context, hash *Hash) (header *Header, _ error)
- func (ec *VNTClient) GetHeaderByNumber(ctx *Context, number int64) (header *Header, _ error)
- func (ec *VNTClient) GetNonceAt(ctx *Context, account *Address, number int64) (nonce int64, _ error)
- func (ec *VNTClient) GetPendingBalanceAt(ctx *Context, account *Address) (balance *BigInt, _ error)
- func (ec *VNTClient) GetPendingCodeAt(ctx *Context, account *Address) (code []byte, _ error)
- func (ec *VNTClient) GetPendingNonceAt(ctx *Context, account *Address) (nonce int64, _ error)
- func (ec *VNTClient) GetPendingStorageAt(ctx *Context, account *Address, key *Hash) (storage []byte, _ error)
- func (ec *VNTClient) GetPendingTransactionCount(ctx *Context) (count int, _ error)
- func (ec *VNTClient) GetStorageAt(ctx *Context, account *Address, key *Hash, number int64) (storage []byte, _ error)
- func (ec *VNTClient) GetTransactionByHash(ctx *Context, hash *Hash) (tx *Transaction, _ error)
- func (ec *VNTClient) GetTransactionCount(ctx *Context, hash *Hash) (count int, _ error)
- func (ec *VNTClient) GetTransactionInBlock(ctx *Context, hash *Hash, index int) (tx *Transaction, _ error)
- func (ec *VNTClient) GetTransactionReceipt(ctx *Context, hash *Hash) (receipt *Receipt, _ error)
- func (ec *VNTClient) GetTransactionSender(ctx *Context, tx *Transaction, blockhash *Hash, index int) (sender *Address, _ error)
- func (ec *VNTClient) PendingCallContract(ctx *Context, msg *CallMsg) (output []byte, _ error)
- func (ec *VNTClient) SendTransaction(ctx *Context, tx *Transaction) error
- func (ec *VNTClient) SubscribeFilterLogs(ctx *Context, query *FilterQuery, handler FilterLogsHandler, buffer int) (sub *Subscription, _ error)
- func (ec *VNTClient) SubscribeNewHead(ctx *Context, handler NewHeadHandler, buffer int) (sub *Subscription, _ error)
- func (ec *VNTClient) SuggestGasPrice(ctx *Context) (price *BigInt, _ error)
- func (ec *VNTClient) SyncProgress(ctx *Context) (progress *SyncProgress, _ error)
Constants ¶
const ( // StandardScryptN is the N parameter of Scrypt encryption algorithm, using 256MB // memory and taking approximately 1s CPU time on a modern processor. StandardScryptN = int(keystore.StandardScryptN) // StandardScryptP is the P parameter of Scrypt encryption algorithm, using 256MB // memory and taking approximately 1s CPU time on a modern processor. StandardScryptP = int(keystore.StandardScryptP) // LightScryptN is the N parameter of Scrypt encryption algorithm, using 4MB // memory and taking approximately 100ms CPU time on a modern processor. LightScryptN = int(keystore.LightScryptN) // LightScryptP is the P parameter of Scrypt encryption algorithm, using 4MB // memory and taking approximately 100ms CPU time on a modern processor. LightScryptP = int(keystore.LightScryptP) )
Variables ¶
This section is empty.
Functions ¶
func SetVerbosity ¶
func SetVerbosity(level int)
SetVerbosity sets the global verbosity level (between 0 and 6 - see logger/verbosity.go).
Types ¶
type Account ¶
type Account struct {
// contains filtered or unexported fields
}
Account represents a stored key.
func (*Account) GetAddress ¶
GetAddress retrieves the address associated with the account.
type Accounts ¶
type Accounts struct {
// contains filtered or unexported fields
}
Accounts represents a slice of accounts.
type Address ¶
type Address struct {
// contains filtered or unexported fields
}
Address represents the 20 byte address of an VNT account.
func NewAddressFromBytes ¶
NewAddressFromBytes converts a slice of bytes to a hash value.
func NewAddressFromHex ¶
NewAddressFromHex converts a hex string to a address value.
type Addresses ¶
type Addresses struct {
// contains filtered or unexported fields
}
Addresses represents a slice of addresses.
func NewAddresses ¶
NewAddresses creates a slice of uninitialized addresses.
func NewAddressesEmpty ¶
func NewAddressesEmpty() *Addresses
NewAddressesEmpty creates an empty slice of Addresses values.
type BigInt ¶
type BigInt struct {
// contains filtered or unexported fields
}
A BigInt represents a signed multi-precision integer.
func (*BigInt) GetInt64 ¶
GetInt64 returns the int64 representation of x. If x cannot be represented in an int64, the result is undefined.
func (*BigInt) GetString ¶
GetString returns the value of x as a formatted string in some number base.
func (*BigInt) SetBytes ¶
SetBytes interprets buf as the bytes of a big-endian unsigned integer and sets the big int to that value.
func (*BigInt) SetString ¶
SetString sets the big int to x.
The string prefix determines the actual conversion base. A prefix of "0x" or "0X" selects base 16; the "0" prefix selects base 8, and a "0b" or "0B" prefix selects base 2. Otherwise the selected base is 10.
type BigInts ¶
type BigInts struct {
// contains filtered or unexported fields
}
BigInts represents a slice of big ints.
type Block ¶
type Block struct {
// contains filtered or unexported fields
}
Block represents an entire block in the VNT blockchain.
func NewBlockFromJSON ¶
NewBlockFromJSON parses a block from a JSON data dump.
func NewBlockFromRLP ¶
NewBlockFromRLP parses a block from an RLP data dump.
func (*Block) EncodeJSON ¶
EncodeJSON encodes a block into a JSON data dump.
func (*Block) GetCoinbase ¶
func (*Block) GetDifficulty ¶
func (*Block) GetGasLimit ¶
func (*Block) GetGasUsed ¶
func (*Block) GetHashNoNonce ¶
func (*Block) GetParentHash ¶
func (*Block) GetReceiptHash ¶
func (*Block) GetTransaction ¶
func (b *Block) GetTransaction(hash *Hash) *Transaction
func (*Block) GetTransactions ¶
func (b *Block) GetTransactions() *Transactions
type Bloom ¶
type Bloom struct {
// contains filtered or unexported fields
}
Bloom represents a 256 bit bloom filter.
type BoundContract ¶
type BoundContract struct {
// contains filtered or unexported fields
}
BoundContract is the base wrapper object that reflects a contract on the VNT network. It contains a collection of methods that are used by the higher level contract bindings to operate.
func BindContract ¶
func BindContract(address *Address, abiJSON string, client *VNTClient) (contract *BoundContract, _ error)
BindContract creates a low level contract interface through which calls and transactions may be made through.
func DeployContract ¶
func DeployContract(opts *TransactOpts, abiJSON string, bytecode []byte, client *VNTClient, args *Interfaces) (contract *BoundContract, _ error)
DeployContract deploys a contract onto the VNT blockchain and binds the deployment address with a wrapper.
func (*BoundContract) Call ¶
func (c *BoundContract) Call(opts *CallOpts, out *Interfaces, method string, args *Interfaces) error
Call invokes the (constant) contract method with params as input values and sets the output to result.
func (*BoundContract) GetAddress ¶
func (c *BoundContract) GetAddress() *Address
func (*BoundContract) GetDeployer ¶
func (c *BoundContract) GetDeployer() *Transaction
func (*BoundContract) Transact ¶
func (c *BoundContract) Transact(opts *TransactOpts, method string, args *Interfaces) (tx *Transaction, _ error)
Transact invokes the (paid) contract method with params as input values.
func (*BoundContract) Transfer ¶
func (c *BoundContract) Transfer(opts *TransactOpts) (tx *Transaction, _ error)
Transfer initiates a plain transaction to move funds to the contract, calling its default method if one is available.
type CallMsg ¶
type CallMsg struct {
// contains filtered or unexported fields
}
CallMsg contains parameters for contract calls.
func NewCallMsg ¶
func NewCallMsg() *CallMsg
NewCallMsg creates an empty contract call parameter list.
func (*CallMsg) GetGasPrice ¶
func (*CallMsg) SetGasPrice ¶
type CallOpts ¶
type CallOpts struct {
// contains filtered or unexported fields
}
CallOpts is the collection of options to fine tune a contract call request.
func NewCallOpts ¶
func NewCallOpts() *CallOpts
NewCallOpts creates a new option set for contract calls.
func (*CallOpts) GetGasLimit ¶
func (*CallOpts) SetContext ¶
func (*CallOpts) SetGasLimit ¶
func (*CallOpts) SetPending ¶
type Context ¶
type Context struct {
// contains filtered or unexported fields
}
Context carries a deadline, a cancelation signal, and other values across API boundaries.
func NewContext ¶
func NewContext() *Context
NewContext returns a non-nil, empty Context. It is never canceled, has no values, and has no deadline. It is typically used by the main function, initialization, and tests, and as the top-level Context for incoming requests.
func (*Context) WithCancel ¶
WithCancel returns a copy of the original context with cancellation mechanism included.
Canceling this context releases resources associated with it, so code should call cancel as soon as the operations running in this Context complete.
func (*Context) WithDeadline ¶
WithDeadline returns a copy of the original context with the deadline adjusted to be no later than the specified time.
Canceling this context releases resources associated with it, so code should call cancel as soon as the operations running in this Context complete.
func (*Context) WithTimeout ¶
WithTimeout returns a copy of the original context with the deadline adjusted to be no later than now + the duration specified.
Canceling this context releases resources associated with it, so code should call cancel as soon as the operations running in this Context complete.
type FilterLogsHandler ¶
FilterLogsHandler is a client-side subscription callback to invoke on events and subscription failure.
type FilterQuery ¶
type FilterQuery struct {
// contains filtered or unexported fields
}
FilterQuery contains options for contact log filtering.
func NewFilterQuery ¶
func NewFilterQuery() *FilterQuery
NewFilterQuery creates an empty filter query for contact log filtering.
func (*FilterQuery) GetAddresses ¶
func (fq *FilterQuery) GetAddresses() *Addresses
func (*FilterQuery) GetFromBlock ¶
func (fq *FilterQuery) GetFromBlock() *BigInt
func (*FilterQuery) GetToBlock ¶
func (fq *FilterQuery) GetToBlock() *BigInt
func (*FilterQuery) GetTopics ¶
func (fq *FilterQuery) GetTopics() *Topics
func (*FilterQuery) SetAddresses ¶
func (fq *FilterQuery) SetAddresses(addresses *Addresses)
func (*FilterQuery) SetFromBlock ¶
func (fq *FilterQuery) SetFromBlock(fromBlock *BigInt)
func (*FilterQuery) SetToBlock ¶
func (fq *FilterQuery) SetToBlock(toBlock *BigInt)
func (*FilterQuery) SetTopics ¶
func (fq *FilterQuery) SetTopics(topics *Topics)
type Hash ¶
type Hash struct {
// contains filtered or unexported fields
}
Hash represents the 32 byte Keccak256 hash of arbitrary data.
func NewHashFromBytes ¶
NewHashFromBytes converts a slice of bytes to a hash value.
func NewHashFromHex ¶
NewHashFromHex converts a hex string to a hash value.
type Hashes ¶
type Hashes struct {
// contains filtered or unexported fields
}
Hashes represents a slice of hashes.
func NewHashesEmpty ¶
func NewHashesEmpty() *Hashes
NewHashesEmpty creates an empty slice of Hashes values.
type Header ¶
type Header struct {
// contains filtered or unexported fields
}
Header represents a block header in the VNT blockchain.
func NewHeaderFromJSON ¶
NewHeaderFromJSON parses a header from a JSON data dump.
func NewHeaderFromRLP ¶
NewHeaderFromRLP parses a header from an RLP data dump.
func (*Header) EncodeJSON ¶
EncodeJSON encodes a header into a JSON data dump.
func (*Header) GetCoinbase ¶
func (*Header) GetDifficulty ¶
func (*Header) GetGasLimit ¶
func (*Header) GetGasUsed ¶
func (*Header) GetParentHash ¶
func (*Header) GetReceiptHash ¶
type Headers ¶
type Headers struct {
// contains filtered or unexported fields
}
Headers represents a slice of headers.
type Interface ¶
type Interface struct {
// contains filtered or unexported fields
}
Interface represents a wrapped version of Go's interface{}, with the capacity to store arbitrary data types.
Since it's impossible to get the arbitrary-ness converted between Go and mobile platforms, we're using explicit getters and setters for the conversions. There is of course no point in enumerating everything, just enough to support the contract bindins requiring client side generated code.
func NewInterface ¶
func NewInterface() *Interface
NewInterface creates a new empty interface that can be used to pass around generic types.
func (*Interface) GetAddress ¶
func (*Interface) GetAddresses ¶
func (*Interface) GetBigInts ¶
func (*Interface) GetBinaries ¶
func (*Interface) GetStrings ¶
func (*Interface) SetAddress ¶
func (*Interface) SetAddresses ¶
func (*Interface) SetBigInts ¶
func (*Interface) SetBinaries ¶
func (*Interface) SetDefaultAddress ¶
func (i *Interface) SetDefaultAddress()
func (*Interface) SetDefaultAddresses ¶
func (i *Interface) SetDefaultAddresses()
func (*Interface) SetDefaultBigInt ¶
func (i *Interface) SetDefaultBigInt()
func (*Interface) SetDefaultBigInts ¶
func (i *Interface) SetDefaultBigInts()
func (*Interface) SetDefaultBinaries ¶
func (i *Interface) SetDefaultBinaries()
func (*Interface) SetDefaultBinary ¶
func (i *Interface) SetDefaultBinary()
func (*Interface) SetDefaultBool ¶
func (i *Interface) SetDefaultBool()
func (*Interface) SetDefaultBools ¶
func (i *Interface) SetDefaultBools()
func (*Interface) SetDefaultHash ¶
func (i *Interface) SetDefaultHash()
func (*Interface) SetDefaultHashes ¶
func (i *Interface) SetDefaultHashes()
func (*Interface) SetDefaultInt16 ¶
func (i *Interface) SetDefaultInt16()
func (*Interface) SetDefaultInt32 ¶
func (i *Interface) SetDefaultInt32()
func (*Interface) SetDefaultInt64 ¶
func (i *Interface) SetDefaultInt64()
func (*Interface) SetDefaultInt8 ¶
func (i *Interface) SetDefaultInt8()
func (*Interface) SetDefaultString ¶
func (i *Interface) SetDefaultString()
func (*Interface) SetDefaultStrings ¶
func (i *Interface) SetDefaultStrings()
func (*Interface) SetDefaultUint16 ¶
func (i *Interface) SetDefaultUint16()
func (*Interface) SetDefaultUint32 ¶
func (i *Interface) SetDefaultUint32()
func (*Interface) SetDefaultUint64 ¶
func (i *Interface) SetDefaultUint64()
func (*Interface) SetDefaultUint8 ¶
func (i *Interface) SetDefaultUint8()
func (*Interface) SetStrings ¶
type Interfaces ¶
type Interfaces struct {
// contains filtered or unexported fields
}
Interfaces is a slices of wrapped generic objects.
func NewInterfaces ¶
func NewInterfaces(size int) *Interfaces
NewInterfaces creates a slice of uninitialized interfaces.
func (*Interfaces) Get ¶
func (i *Interfaces) Get(index int) (iface *Interface, _ error)
Get returns the bigint at the given index from the slice.
func (*Interfaces) Set ¶
func (i *Interfaces) Set(index int, object *Interface) error
Set sets the big int at the given index in the slice.
func (*Interfaces) Size ¶
func (i *Interfaces) Size() int
Size returns the number of interfaces in the slice.
type KeyStore ¶
type KeyStore struct {
// contains filtered or unexported fields
}
KeyStore manages a key storage directory on disk.
func NewKeyStore ¶
NewKeyStore creates a keystore for the given directory.
func NewKeyStoreWithSecureEnclave ¶ added in v0.6.2
NewKeyStoreWithSecureEnclave creates a keystore for the given directory.
func (*KeyStore) DeleteAccount ¶
DeleteAccount deletes the key matched by account if the passphrase is correct. If a contains no filename, the address must match a unique key.
func (*KeyStore) ExportKey ¶
func (ks *KeyStore) ExportKey(account *Account, passphrase, newPassphrase string) (key []byte, _ error)
ExportKey exports as a JSON key, encrypted with newPassphrase.
func (*KeyStore) GetAccounts ¶
GetAccounts returns all key files present in the directory.
func (*KeyStore) HasAddress ¶
HasAddress reports whether a key with the given address is present.
func (*KeyStore) ImportECDSAKey ¶
ImportECDSAKey stores the given encrypted JSON key into the key directory.
func (*KeyStore) ImportKey ¶
func (ks *KeyStore) ImportKey(keyJSON []byte, passphrase, newPassphrase string) (account *Account, _ error)
ImportKey stores the given encrypted JSON key into the key directory.
func (*KeyStore) ImportPreSaleKey ¶
ImportPreSaleKey decrypts the given VNT presale wallet and stores a key file in the key directory. The key file is encrypted with the same passphrase.
func (*KeyStore) NewAccount ¶
NewAccount generates a new key and stores it into the key directory, encrypting it with the passphrase.
func (*KeyStore) SignHash ¶
SignHash calculates a ECDSA signature for the given hash. The produced signature is in the [R || S || V] format where V is 0 or 1.
func (*KeyStore) SignHashPassphrase ¶
func (ks *KeyStore) SignHashPassphrase(account *Account, passphrase string, hash []byte) (signature []byte, _ error)
SignHashPassphrase signs hash if the private key matching the given address can be decrypted with the given passphrase. The produced signature is in the [R || S || V] format where V is 0 or 1.
func (*KeyStore) SignTx ¶
func (ks *KeyStore) SignTx(account *Account, tx *Transaction, chainID *BigInt) (*Transaction, error)
SignTx signs the given transaction with the requested account.
func (*KeyStore) SignTxPassphrase ¶
func (ks *KeyStore) SignTxPassphrase(account *Account, passphrase string, tx *Transaction, chainID *BigInt) (*Transaction, error)
SignTxPassphrase signs the transaction if the private key matching the given address can be decrypted with the given passphrase.
func (*KeyStore) TimedUnlock ¶
TimedUnlock unlocks the given account with the passphrase. The account stays unlocked for the duration of timeout (nanoseconds). A timeout of 0 unlocks the account until the program exits. The account must match a unique key file.
If the account address is already unlocked for a duration, TimedUnlock extends or shortens the active unlock timeout. If the address was previously unlocked indefinitely the timeout is not altered.
type Log ¶
type Log struct {
// contains filtered or unexported fields
}
Log represents a contract log event. These events are generated by the LOG opcode and stored/indexed by the node.
func (*Log) GetAddress ¶
func (*Log) GetBlockHash ¶
func (*Log) GetBlockNumber ¶
func (*Log) GetTxIndex ¶
type Logs ¶
type Logs struct {
// contains filtered or unexported fields
}
Logs represents a slice of VM logs.
type NewHeadHandler ¶
NewHeadHandler is a client-side subscription callback to invoke on events and subscription failure.
type Node ¶
type Node struct {
// contains filtered or unexported fields
}
Node represents a Gvnt VNT node instance.
func NewNode ¶
func NewNode(datadir string, config *NodeConfig) (stack *Node, _ error)
NewNode creates and configures a new Gvnt node.
func (*Node) GetNodeInfo ¶
GetNodeInfo gathers and returns a collection of metadata known about the host.
func (*Node) GetPeersInfo ¶
GetPeersInfo returns an array of metadata objects describing connected peers.
func (*Node) GetVNTClient ¶
GetVNTClient retrieves a client to access the VNT subsystem.
type NodeConfig ¶
type NodeConfig struct { // MaxPeers is the maximum number of peers that can be connected. If this is // set to zero, then only the configured static and trusted peers can connect. MaxPeers int // EthereumEnabled specifies whether the node should run the VNT protocol. VntEnabled bool // HubbleNetworkID is the network identifier used by the VNT protocol to // decide if remote peers should be accepted or not. HubbleNetworkID int64 // uint64 in truth, but Java can't handle that... // HubbleGenesis is the genesis JSON to use to seed the blockchain with. An // empty genesis state is equivalent to using the mainnet's state. HubbleGenesis string // HubbleDatabaseCache is the system memory in MB to allocate for database caching. // A minimum of 16MB is always reserved. HubbleDatabaseCache int // HubbleNetStats is a netstats connection string to use to report various // chain, transaction and node stats to a monitoring server. // // It has the form "nodename:secret@host:port" HubbleNetStats string // WhisperEnabled specifies whether the node should run the Whisper protocol. WhisperEnabled bool // Listening address of pprof server. PprofAddress string }
NodeConfig represents the collection of configuration values to fine tune the Gvnt node embedded into a mobile process. The available values are a subset of the entire API provided by go-ethereum to reduce the maintenance surface and dev complexity.
func NewNodeConfig ¶
func NewNodeConfig() *NodeConfig
NewNodeConfig creates a new node option set, initialized to the default values.
type NodeInfo ¶
type NodeInfo struct {
// contains filtered or unexported fields
}
NodeInfo represents pi short summary of the information known about the host.
func (*NodeInfo) GetDiscoveryPort ¶
func (*NodeInfo) GetListenerAddress ¶
func (*NodeInfo) GetListenerPort ¶
func (*NodeInfo) GetProtocols ¶
func (*NodeInfo) GetVNTNode ¶
type PeerInfo ¶
type PeerInfo struct {
// contains filtered or unexported fields
}
PeerInfo represents pi short summary of the information known about pi connected peer.
func (*PeerInfo) GetLocalAddress ¶
func (*PeerInfo) GetRemoteAddress ¶
type PeerInfos ¶
type PeerInfos struct {
// contains filtered or unexported fields
}
PeerInfos represents a slice of infos about remote peers.
type Receipt ¶
type Receipt struct {
// contains filtered or unexported fields
}
Receipt represents the results of a transaction.
func NewReceiptFromJSON ¶
NewReceiptFromJSON parses a transaction receipt from a JSON data dump.
func NewReceiptFromRLP ¶
NewReceiptFromRLP parses a transaction receipt from an RLP data dump.
func (*Receipt) EncodeJSON ¶
EncodeJSON encodes a transaction receipt into a JSON data dump.
func (*Receipt) GetContractAddress ¶
func (*Receipt) GetCumulativeGasUsed ¶
func (*Receipt) GetGasUsed ¶
func (*Receipt) GetPostState ¶
type Signer ¶
type Signer interface {
Sign(*Address, *Transaction) (tx *Transaction, _ error)
}
Signer is an interaface defining the callback when a contract requires a method to sign the transaction before submission.
type Strings ¶
type Strings struct {
// contains filtered or unexported fields
}
Strings represents s slice of strs.
type Subscription ¶
type Subscription struct {
// contains filtered or unexported fields
}
Subscription represents an event subscription where events are delivered on a data channel.
func (*Subscription) Unsubscribe ¶
func (s *Subscription) Unsubscribe()
Unsubscribe cancels the sending of events to the data channel and closes the error channel.
type SyncProgress ¶
type SyncProgress struct {
// contains filtered or unexported fields
}
SyncProgress gives progress indications when the node is synchronising with the VNT network.
func (*SyncProgress) GetCurrentBlock ¶
func (p *SyncProgress) GetCurrentBlock() int64
func (*SyncProgress) GetHighestBlock ¶
func (p *SyncProgress) GetHighestBlock() int64
func (*SyncProgress) GetKnownStates ¶
func (p *SyncProgress) GetKnownStates() int64
func (*SyncProgress) GetPulledStates ¶
func (p *SyncProgress) GetPulledStates() int64
func (*SyncProgress) GetStartingBlock ¶
func (p *SyncProgress) GetStartingBlock() int64
type Topics ¶
type Topics struct {
// contains filtered or unexported fields
}
Topics is a set of topic lists to filter events with.
func NewTopicsEmpty ¶
func NewTopicsEmpty() *Topics
NewTopicsEmpty creates an empty slice of Topics values.
type TransactOpts ¶
type TransactOpts struct {
// contains filtered or unexported fields
}
TransactOpts is the collection of authorization data required to create a valid VNT transaction.
func (*TransactOpts) GetChainID ¶ added in v0.6.2
func (opts *TransactOpts) GetChainID() *BigInt
func (*TransactOpts) GetFrom ¶
func (opts *TransactOpts) GetFrom() *Address
func (*TransactOpts) GetGasLimit ¶
func (opts *TransactOpts) GetGasLimit() int64
func (*TransactOpts) GetGasPrice ¶
func (opts *TransactOpts) GetGasPrice() *BigInt
func (*TransactOpts) GetNonce ¶
func (opts *TransactOpts) GetNonce() int64
func (*TransactOpts) GetValue ¶
func (opts *TransactOpts) GetValue() *BigInt
func (*TransactOpts) SetChainID ¶ added in v0.6.2
func (opts *TransactOpts) SetChainID(chainID *BigInt)
func (*TransactOpts) SetContext ¶
func (opts *TransactOpts) SetContext(context *Context)
func (*TransactOpts) SetFrom ¶
func (opts *TransactOpts) SetFrom(from *Address)
func (*TransactOpts) SetGasLimit ¶
func (opts *TransactOpts) SetGasLimit(limit int64)
func (*TransactOpts) SetGasPrice ¶
func (opts *TransactOpts) SetGasPrice(price *BigInt)
func (*TransactOpts) SetNonce ¶
func (opts *TransactOpts) SetNonce(nonce int64)
func (*TransactOpts) SetSigner ¶
func (opts *TransactOpts) SetSigner(s Signer)
func (*TransactOpts) SetValue ¶
func (opts *TransactOpts) SetValue(value *BigInt)
type Transaction ¶
type Transaction struct {
// contains filtered or unexported fields
}
Transaction represents a single VNT transaction.
func NewTransaction ¶
func NewTransaction(nonce int64, to *Address, amount *BigInt, gasLimit int64, gasPrice *BigInt, data []byte) *Transaction
NewTransaction creates a new transaction with the given properties.
func NewTransactionFromJSON ¶
func NewTransactionFromJSON(data string) (*Transaction, error)
NewTransactionFromJSON parses a transaction from a JSON data dump.
func NewTransactionFromRLP ¶
func NewTransactionFromRLP(data []byte) (*Transaction, error)
NewTransactionFromRLP parses a transaction from an RLP data dump.
func (*Transaction) EncodeJSON ¶
func (tx *Transaction) EncodeJSON() (string, error)
EncodeJSON encodes a transaction into a JSON data dump.
func (*Transaction) EncodeRLP ¶
func (tx *Transaction) EncodeRLP() ([]byte, error)
EncodeRLP encodes a transaction into an RLP data dump.
func (*Transaction) GetCost ¶
func (tx *Transaction) GetCost() *BigInt
func (*Transaction) GetData ¶
func (tx *Transaction) GetData() []byte
func (*Transaction) GetFrom
deprecated
func (tx *Transaction) GetFrom(chainID *BigInt) (address *Address, _ error)
Deprecated: use VNTClient.TransactionSender
func (*Transaction) GetGas ¶
func (tx *Transaction) GetGas() int64
func (*Transaction) GetGasPrice ¶
func (tx *Transaction) GetGasPrice() *BigInt
func (*Transaction) GetHash ¶
func (tx *Transaction) GetHash() *Hash
func (*Transaction) GetNonce ¶
func (tx *Transaction) GetNonce() int64
func (*Transaction) GetSigHash
deprecated
func (tx *Transaction) GetSigHash(chainID *BigInt) *Hash
Deprecated: GetSigHash cannot know which signer to use.
func (*Transaction) GetTo ¶
func (tx *Transaction) GetTo() *Address
func (*Transaction) GetValue ¶
func (tx *Transaction) GetValue() *BigInt
func (*Transaction) WithSignature ¶
func (tx *Transaction) WithSignature(sig []byte, chainID *BigInt) (signedTx *Transaction, _ error)
type Transactions ¶
type Transactions struct {
// contains filtered or unexported fields
}
Transactions represents a slice of transactions.
func (*Transactions) Get ¶
func (txs *Transactions) Get(index int) (tx *Transaction, _ error)
Get returns the transaction at the given index from the slice.
func (*Transactions) Size ¶
func (txs *Transactions) Size() int
Size returns the number of transactions in the slice.
type VNTClient ¶
type VNTClient struct {
// contains filtered or unexported fields
}
VNTClient provides access to the VNT APIs.
func NewVNTClient ¶
NewVNTClient connects a client to the given URL.
func (*VNTClient) CallContract ¶
func (ec *VNTClient) CallContract(ctx *Context, msg *CallMsg, number int64) (output []byte, _ error)
CallContract executes a message call transaction, which is directly executed in the VM of the node, but never mined into the blockchain.
blockNumber selects the block height at which the call runs. It can be <0, in which case the code is taken from the latest known block. Note that state from very old blocks might not be available.
func (*VNTClient) EstimateGas ¶
EstimateGas tries to estimate the gas needed to execute a specific transaction based on the current pending state of the backend blockchain. There is no guarantee that this is the true gas limit requirement as other transactions may be added or removed by miners, but it should provide a basis for setting a reasonable default.
func (*VNTClient) FilterLogs ¶
func (ec *VNTClient) FilterLogs(ctx *Context, query *FilterQuery) (logs *Logs, _ error)
FilterLogs executes a filter query.
func (*VNTClient) GetBalanceAt ¶
func (ec *VNTClient) GetBalanceAt(ctx *Context, account *Address, number int64) (balance *BigInt, _ error)
GetBalanceAt returns the wei balance of the given account. The block number can be <0, in which case the balance is taken from the latest known block.
func (*VNTClient) GetBlockByHash ¶
GetBlockByHash returns the given full block.
func (*VNTClient) GetBlockByNumber ¶
GetBlockByNumber returns a block from the current canonical chain. If number is <0, the latest known block is returned.
func (*VNTClient) GetCodeAt ¶
GetCodeAt returns the contract code of the given account. The block number can be <0, in which case the code is taken from the latest known block.
func (*VNTClient) GetHeaderByHash ¶
GetHeaderByHash returns the block header with the given hash.
func (*VNTClient) GetHeaderByNumber ¶
GetHeaderByNumber returns a block header from the current canonical chain. If number is <0, the latest known header is returned.
func (*VNTClient) GetNonceAt ¶
func (ec *VNTClient) GetNonceAt(ctx *Context, account *Address, number int64) (nonce int64, _ error)
GetNonceAt returns the account nonce of the given account. The block number can be <0, in which case the nonce is taken from the latest known block.
func (*VNTClient) GetPendingBalanceAt ¶
GetPendingBalanceAt returns the wei balance of the given account in the pending state.
func (*VNTClient) GetPendingCodeAt ¶
GetPendingCodeAt returns the contract code of the given account in the pending state.
func (*VNTClient) GetPendingNonceAt ¶
GetPendingNonceAt returns the account nonce of the given account in the pending state. This is the nonce that should be used for the next transaction.
func (*VNTClient) GetPendingStorageAt ¶
func (ec *VNTClient) GetPendingStorageAt(ctx *Context, account *Address, key *Hash) (storage []byte, _ error)
GetPendingStorageAt returns the value of key in the contract storage of the given account in the pending state.
func (*VNTClient) GetPendingTransactionCount ¶
GetPendingTransactionCount returns the total number of transactions in the pending state.
func (*VNTClient) GetStorageAt ¶
func (ec *VNTClient) GetStorageAt(ctx *Context, account *Address, key *Hash, number int64) (storage []byte, _ error)
GetStorageAt returns the value of key in the contract storage of the given account. The block number can be <0, in which case the value is taken from the latest known block.
func (*VNTClient) GetTransactionByHash ¶
func (ec *VNTClient) GetTransactionByHash(ctx *Context, hash *Hash) (tx *Transaction, _ error)
GetTransactionByHash returns the transaction with the given hash.
func (*VNTClient) GetTransactionCount ¶
GetTransactionCount returns the total number of transactions in the given block.
func (*VNTClient) GetTransactionInBlock ¶
func (ec *VNTClient) GetTransactionInBlock(ctx *Context, hash *Hash, index int) (tx *Transaction, _ error)
GetTransactionInBlock returns a single transaction at index in the given block.
func (*VNTClient) GetTransactionReceipt ¶
GetTransactionReceipt returns the receipt of a transaction by transaction hash. Note that the receipt is not available for pending transactions.
func (*VNTClient) GetTransactionSender ¶
func (ec *VNTClient) GetTransactionSender(ctx *Context, tx *Transaction, blockhash *Hash, index int) (sender *Address, _ error)
GetTransactionSender returns the sender address of a transaction. The transaction must be included in blockchain at the given block and index.
func (*VNTClient) PendingCallContract ¶
PendingCallContract executes a message call transaction using the EVM. The state seen by the contract call is the pending state.
func (*VNTClient) SendTransaction ¶
func (ec *VNTClient) SendTransaction(ctx *Context, tx *Transaction) error
SendTransaction injects a signed transaction into the pending pool for execution.
If the transaction was a contract creation use the TransactionReceipt method to get the contract address after the transaction has been mined.
func (*VNTClient) SubscribeFilterLogs ¶
func (ec *VNTClient) SubscribeFilterLogs(ctx *Context, query *FilterQuery, handler FilterLogsHandler, buffer int) (sub *Subscription, _ error)
SubscribeFilterLogs subscribes to the results of a streaming filter query.
func (*VNTClient) SubscribeNewHead ¶
func (ec *VNTClient) SubscribeNewHead(ctx *Context, handler NewHeadHandler, buffer int) (sub *Subscription, _ error)
SubscribeNewHead subscribes to notifications about the current blockchain head on the given channel.
func (*VNTClient) SuggestGasPrice ¶
SuggestGasPrice retrieves the currently suggested gas price to allow a timely execution of a transaction.
func (*VNTClient) SyncProgress ¶
func (ec *VNTClient) SyncProgress(ctx *Context) (progress *SyncProgress, _ error)
SyncProgress retrieves the current progress of the sync algorithm. If there's no sync currently running, it returns nil.