Documentation
¶
Index ¶
- Constants
- Variables
- func ArrayFromStackItem(param stackitem.Item) ([]stackitem.Item, error)
- func BigIntFromStackItem(param stackitem.Item) (*big.Int, error)
- func BoolFromStackItem(param stackitem.Item) (bool, error)
- func BytesFromStackItem(param stackitem.Item) ([]byte, error)
- func IntFromStackItem(param stackitem.Item) (int64, error)
- func NNSAlphabetContractName(index int) string
- func StringFromStackItem(param stackitem.Item) (string, error)
- type AlphabetKeys
- type Client
- func (c *Client) BlockCount() (res uint32, err error)
- func (c *Client) Committee() (res keys.PublicKeys, err error)
- func (c *Client) DepositNotary(amount fixedn.Fixed8, delta uint32) (res util.Uint256, err error)
- func (c *Client) EnableNotarySupport(opts ...NotaryOption) error
- func (c *Client) GasBalance() (res int64, err error)
- func (c *Client) GetDesignateHash() (res util.Uint160, err error)
- func (c *Client) GetNotaryDeposit() (res int64, err error)
- func (c *Client) Invoke(contract util.Uint160, fee fixedn.Fixed8, method string, args ...interface{}) error
- func (c *Client) MagicNumber() (res uint64, err error)
- func (c *Client) NNSContractAddress(name string) (sh util.Uint160, err error)
- func (c *Client) NeoFSAlphabetList() (res keys.PublicKeys, err error)
- func (c *Client) NotaryInvoke(contract util.Uint160, fee fixedn.Fixed8, nonce uint32, method string, ...) error
- func (c *Client) NotaryInvokeNotAlpha(contract util.Uint160, fee fixedn.Fixed8, method string, args ...interface{}) error
- func (c *Client) NotarySignAndInvokeTX(mainTx *transaction.Transaction) error
- func (c *Client) ProbeNotary() (res bool)
- func (c *Client) TestInvoke(contract util.Uint160, method string, args ...interface{}) (res []stackitem.Item, err error)
- func (c *Client) TransferGas(receiver util.Uint160, amount fixedn.Fixed8) error
- func (c *Client) TxHalt(h util.Uint256) (res bool, err error)
- func (c *Client) UpdateNeoFSAlphabetList(list keys.PublicKeys) error
- func (c *Client) UpdateNotaryList(list keys.PublicKeys) error
- func (c *Client) Wait(ctx context.Context, n uint32) error
- type NotaryOption
- type Option
- type StaticClient
- type StaticClientOption
Constants ¶
const ( // NNSAuditContractName is a name of the audit contract in NNS. NNSAuditContractName = "audit.neofs" // NNSBalanceContractName is a name of the balance contract in NNS. NNSBalanceContractName = "balance.neofs" // NNSContainerContractName is a name of the container contract in NNS. NNSContainerContractName = "container.neofs" // NNSNeoFSIDContractName is a name of the neofsid contract in NNS. NNSNeoFSIDContractName = "neofsid.neofs" // NNSNetmapContractName is a name of the netmap contract in NNS. NNSNetmapContractName = "netmap.neofs" // NNSProxyContractName is a name of the proxy contract in NNS. NNSProxyContractName = "proxy.neofs" // NNSReputationContractName is a name of the reputation contract in NNS. NNSReputationContractName = "reputation.neofs" )
const HaltState = "HALT"
HaltState returned if TestInvoke function processed without panic.
Variables ¶
var ErrNilClient = errors.New("client is nil")
ErrNilClient is returned by functions that expect a non-nil Client pointer, but received nil.
var ErrNilStaticClient = errors.New("static client is nil")
ErrNilStaticClient is returned by functions that expect a non-nil StaticClient pointer, but received nil.
Functions ¶
func ArrayFromStackItem ¶ added in v0.12.0
ArrayFromStackItem returns the slice contract parameters from passed parameter.
If passed parameter carries boolean false value, (nil, nil) returns.
func BigIntFromStackItem ¶ added in v0.12.0
BigIntFromStackItem receives numerical value from the value of a smart contract parameter.
func BoolFromStackItem ¶ added in v0.12.0
BoolFromStackItem receives boolean value from the value of a smart contract parameter.
func BytesFromStackItem ¶ added in v0.12.0
BytesFromStackItem receives binary value from the value of a smart contract parameter.
func IntFromStackItem ¶ added in v0.12.0
IntFromStackItem receives numerical value from the value of a smart contract parameter.
func NNSAlphabetContractName ¶ added in v0.25.0
NNSAlphabetContractName returns contract name of the alphabet contract in NNS based on alphabet index.
Types ¶
type AlphabetKeys ¶ added in v0.19.0
type AlphabetKeys func() (keys.PublicKeys, error)
type Client ¶
type Client struct {
// contains filtered or unexported fields
}
Client is a wrapper over multiple neo-go clients that provides smart-contract invocation interface.
Each operation accesses all nodes in turn until the first success, and returns the error of the very first client on failure.
Working client must be created via constructor New. Using the Client that has been created with new(Client) expression (or just declaring a Client variable) is unsafe and can lead to panic.
func New ¶
New creates, initializes and returns the Client instance. Notary support should be enabled with EnableNotarySupport client method separately.
If private key is nil, it panics.
Other values are set according to provided options, or by default:
- client context: Background;
- dial timeout: 5s;
- blockchain network type: netmode.PrivNet;
- logger: zap.L().
If desired option satisfies the default value, it can be omitted. If multiple options of the same config value are supplied, the option with the highest index in the arguments will be used.
func (*Client) BlockCount ¶ added in v0.23.0
BlockCount returns block count of the network to which the underlying RPC node client is connected.
func (*Client) Committee ¶ added in v0.18.0
func (c *Client) Committee() (res keys.PublicKeys, err error)
Committee returns keys of chain committee from neo native contract.
func (*Client) DepositNotary ¶ added in v0.17.0
DepositNotary calls notary deposit method. Deposit is required to operate with notary contract. It used by notary contract in to produce fallback tx if main tx failed to create. Deposit isn't last forever, so it should be called periodically. Notary support should be enabled in client to use this function.
This function must be invoked with notary enabled otherwise it throws panic.
func (*Client) EnableNotarySupport ¶ added in v0.17.0
func (c *Client) EnableNotarySupport(opts ...NotaryOption) error
EnableNotarySupport creates notary structure in client that provides ability for client to get alphabet keys from committee or provided source and use proxy contract script hash to create tx for notary contract.
func (*Client) GasBalance ¶ added in v0.17.0
GasBalance returns GAS amount in the client's wallet.
func (*Client) GetDesignateHash ¶ added in v0.21.0
GetDesignateHash returns hash of the native `RoleManagement` contract.
func (*Client) GetNotaryDeposit ¶ added in v0.17.0
GetNotaryDeposit returns deposit of client's account in notary contract. Notary support should be enabled in client to use this function.
This function must be invoked with notary enabled otherwise it throws panic.
func (*Client) Invoke ¶
func (c *Client) Invoke(contract util.Uint160, fee fixedn.Fixed8, method string, args ...interface{}) error
Invoke invokes contract method by sending transaction into blockchain. Supported args types: int64, string, util.Uint160, []byte and bool.
func (*Client) MagicNumber ¶ added in v0.16.0
MagicNumber returns the magic number of the network to which the underlying RPC node client is connected.
Returns 0 in case of connection problems.
func (*Client) NNSContractAddress ¶ added in v0.25.0
NNSContractAddress returns contract address script hash based on its name in NNS contract.
func (*Client) NeoFSAlphabetList ¶ added in v0.18.0
func (c *Client) NeoFSAlphabetList() (res keys.PublicKeys, err error)
NeoFSAlphabetList returns keys that stored in NeoFS Alphabet role. Main chain stores alphabet node keys of inner ring there, however side chain stores both alphabet and non alphabet node keys of inner ring.
func (*Client) NotaryInvoke ¶ added in v0.17.0
func (c *Client) NotaryInvoke(contract util.Uint160, fee fixedn.Fixed8, nonce uint32, method string, args ...interface{}) error
NotaryInvoke invokes contract method by sending tx to notary contract in blockchain. Fallback tx is a `RET`. If Notary support is not enabled it fallbacks to a simple `Invoke()`.
This function must be invoked with notary enabled otherwise it throws panic.
func (*Client) NotaryInvokeNotAlpha ¶ added in v0.25.0
func (c *Client) NotaryInvokeNotAlpha(contract util.Uint160, fee fixedn.Fixed8, method string, args ...interface{}) error
NotaryInvokeNotAlpha does the same as NotaryInvoke but does not use client's private key in Invocation script. It means that main TX of notary request is not expected to be signed by the current node.
Considered to be used by non-IR nodes.
func (*Client) NotarySignAndInvokeTX ¶ added in v0.25.0
func (c *Client) NotarySignAndInvokeTX(mainTx *transaction.Transaction) error
NotarySignAndInvokeTX signs and sends notary request that was received from Notary service. NOTE: does not fallback to simple `Invoke()`. Expected to be used only for TXs retrieved from the received notary requests.
func (*Client) ProbeNotary ¶ added in v0.23.0
ProbeNotary checks if native `Notary` contract is presented on chain.
func (*Client) TestInvoke ¶
func (c *Client) TestInvoke(contract util.Uint160, method string, args ...interface{}) (res []stackitem.Item, err error)
TestInvoke invokes contract method locally in neo-go node. This method should be used to read data from smart-contract.
func (*Client) TransferGas ¶
TransferGas to the receiver from local wallet
func (*Client) TxHalt ¶ added in v0.19.0
TxHalt returns true if transaction has been successfully executed and persisted.
func (*Client) UpdateNeoFSAlphabetList ¶ added in v0.18.0
func (c *Client) UpdateNeoFSAlphabetList(list keys.PublicKeys) error
UpdateNeoFSAlphabetList updates list of alphabet nodes in designate contract. As for side chain list should contain all inner ring nodes. Requires committee multi signature.
This function must be invoked with notary enabled otherwise it throws panic.
func (*Client) UpdateNotaryList ¶ added in v0.18.0
func (c *Client) UpdateNotaryList(list keys.PublicKeys) error
UpdateNotaryList updates list of notary nodes in designate contract. Requires committee multi signature.
This function must be invoked with notary enabled otherwise it throws panic.
type NotaryOption ¶ added in v0.17.0
type NotaryOption func(*notaryCfg)
func WithAlphabetSource ¶ added in v0.19.0
func WithAlphabetSource(t AlphabetKeys) NotaryOption
WithAlphabetSource returns a notary support option for client that specifies function to return list of alphabet node keys. By default notary subsystem uses committee as a source. This is valid for side chain but notary in main chain should override it.
func WithFallbackTime ¶ added in v0.17.0
func WithFallbackTime(t uint32) NotaryOption
WithFallbackTime returns a notary support option for client that specifies amount of blocks before fallbackTx will be sent. Should be less than TxValidTime.
func WithProxyContract ¶ added in v0.22.0
func WithProxyContract(h util.Uint160) NotaryOption
WithProxyContract sets proxy contract hash.
func WithRoundTime ¶ added in v0.17.0
func WithRoundTime(t uint32) NotaryOption
WithRoundTime returns a notary support option for client that specifies extra blocks to synchronize side chain height diff of inner ring nodes.
func WithTxValidTime ¶ added in v0.17.0
func WithTxValidTime(t uint32) NotaryOption
WithTxValidTime returns a notary support option for client that specifies minimum amount of blocks when mainTx will be valid.
type Option ¶
type Option func(*cfg)
Option is a client configuration change function.
func WithContext ¶
WithContext returns a client constructor option that specifies the neo-go client context.
Ignores nil value. Has no effect if WithSingleClient is provided.
If option not provided, context.Background() is used.
func WithDialTimeout ¶
WithDialTimeout returns a client constructor option that specifies neo-go client dial timeout duration.
Ignores non-positive value. Has no effect if WithSingleClient is provided.
If option not provided, 5s timeout is used.
func WithExtraEndpoints ¶ added in v0.25.0
WithExtraEndpoints returns a client constructor option that specifies additional Neo rpc endpoints.
Has no effect if WithSingleClient is provided.
func WithLogger ¶
WithLogger returns a client constructor option that specifies the component for writing log messages.
Ignores nil value.
If option not provided, zap.L() is used.
func WithSigner ¶ added in v0.24.0
func WithSigner(signer *transaction.Signer) Option
WithSigner returns a client constructor option that specifies the signer and the scope of the transaction.
Ignores nil value.
If option not provided, signer with global scope is used.
func WithSingleClient ¶ added in v0.25.0
WithSingleClient returns a client constructor option that specifies single neo-go client and forces Client to use it and only it for requests.
Passed client must already be initialized.
type StaticClient ¶
type StaticClient struct {
// contains filtered or unexported fields
}
StaticClient is a wrapper over Neo:Morph client that invokes single smart contract methods with fixed fee.
Working static client must be created via constructor NewStatic. Using the StaticClient that has been created with new(StaticClient) expression (or just declaring a StaticClient variable) is unsafe and can lead to panic.
func NewStatic ¶
func NewStatic(client *Client, scriptHash util.Uint160, fee fixedn.Fixed8, opts ...StaticClientOption) (*StaticClient, error)
NewStatic creates, initializes and returns the StaticClient instance.
If provided Client instance is nil, ErrNilClient is returned.
func (StaticClient) Invoke ¶
func (s StaticClient) Invoke(method string, args ...interface{}) error
Invoke calls Invoke method of Client with static internal script hash and fee. Supported args types are the same as in Client.
If TryNotary is provided, calls NotaryInvoke on Client.
func (StaticClient) Morph ¶ added in v0.25.0
func (s StaticClient) Morph() *Client
Morph return wrapped raw morph client.
func (StaticClient) TestInvoke ¶
func (s StaticClient) TestInvoke(method string, args ...interface{}) ([]stackitem.Item, error)
TestInvoke calls TestInvoke method of Client with static internal script hash.
type StaticClientOption ¶ added in v0.21.0
type StaticClientOption func(*staticOpts)
StaticClientOption allows to set an optional parameter of StaticClient.
func AsAlphabet ¶ added in v0.25.0
func AsAlphabet() StaticClientOption
AsAlphabet returns option to sign main TX of notary requests with client's private key.
Considered to be used by IR nodes only.
func TryNotary ¶ added in v0.21.0
func TryNotary() StaticClientOption
TryNotary returns option to enable notary invocation tries.