chainclient

Documentation

Index

• type Client
  • func New(layer1Client l1connection.Client, waspClient *client.WaspClient, ...) *Client
  • func (c *Client) CallView(hContract isc.Hname, functionName string, args dict.Dict, ...) (dict.Dict, error)
  • func (c *Client) CheckRequestResult(reqID isc.RequestID) error
  • func (c *Client) DepositFunds(n uint64) (*iotago.Transaction, error)
  • func (c *Client) GetChainRecord() (*registry.ChainRecord, error)
  • func (c *Client) Post1Request(contractHname isc.Hname, entryPoint isc.Hname, params ...PostRequestParams) (*iotago.Transaction, error)
  • func (c *Client) PostNRequests(contractHname isc.Hname, entryPoint isc.Hname, requestsCount int, ...) ([]*iotago.Transaction, error)
  • func (c *Client) PostOffLedgerRequest(contractHname isc.Hname, entrypoint isc.Hname, params ...PostRequestParams) (isc.OffLedgerRequest, error)
  • func (c *Client) RequestIDByEVMTransactionHash(txHash common.Hash) (isc.RequestID, error)
  • func (c *Client) StateGet(key string) ([]byte, error)
  • func (c *Client) UploadBlob(fields dict.Dict) (hashing.HashValue, isc.OffLedgerRequest, *isc.Receipt, error)
• type PostRequestParams
  • func NewPostRequestParams(p ...interface{}) *PostRequestParams
  • func (par *PostRequestParams) WithBaseTokens(i uint64) *PostRequestParams
  • func (par *PostRequestParams) WithGasBudget(budget uint64) *PostRequestParams
  • func (par *PostRequestParams) WithTransfer(transfer *isc.FungibleTokens) *PostRequestParams

Types

type Client

type Client struct {
	Layer1Client l1connection.Client
	WaspClient   *client.WaspClient
	ChainID      *isc.ChainID
	KeyPair      *cryptolib.KeyPair
	// contains filtered or unexported fields
}

Client allows to interact with a specific chain in the node, for example to send on-ledger or off-ledger requests

func New

func New(
	layer1Client l1connection.Client,
	waspClient *client.WaspClient,
	chainID *isc.ChainID,
	keyPair *cryptolib.KeyPair,
) *Client

New creates a new chainclient.Client

func (*Client) CallView

func (c *Client) CallView(hContract isc.Hname, functionName string, args dict.Dict, optimisticReadTimeout ...time.Duration) (dict.Dict, error)

CallView sends a request to call a view function of a given contract, and returns the result of the call

func (*Client) CheckRequestResult

func (c *Client) CheckRequestResult(reqID isc.RequestID) error

CheckRequestResult fetches the receipt for the given request ID, and returns an error indicating whether the request was processed successfully.

func (*Client) DepositFunds

func (c *Client) DepositFunds(n uint64) (*iotago.Transaction, error)

func (*Client) GetChainRecord

func (c *Client) GetChainRecord() (*registry.ChainRecord, error)

GetChainRecord fetches the chain's Record

func (*Client) Post1Request

func (c *Client) Post1Request(
	contractHname isc.Hname,
	entryPoint isc.Hname,
	params ...PostRequestParams,
) (*iotago.Transaction, error)

Post1Request sends an on-ledger transaction with one request on it to the chain

func (*Client) PostNRequests

func (c *Client) PostNRequests(
	contractHname isc.Hname,
	entryPoint isc.Hname,
	requestsCount int,
	params ...PostRequestParams,
) ([]*iotago.Transaction, error)

PostNRequest sends n consecutive on-ledger transactions with one request on each, to the chain

func (*Client) PostOffLedgerRequest

func (c *Client) PostOffLedgerRequest(
	contractHname isc.Hname,
	entrypoint isc.Hname,
	params ...PostRequestParams,
) (isc.OffLedgerRequest, error)

PostOffLedgerRequest sends an off-ledger tx via the wasp node web api

func (*Client) RequestIDByEVMTransactionHash

func (c *Client) RequestIDByEVMTransactionHash(txHash common.Hash) (isc.RequestID, error)

func (*Client) StateGet

func (c *Client) StateGet(key string) ([]byte, error)

StateGet fetches the raw value associated with the given key in the chain state

func (*Client) UploadBlob

func (c *Client) UploadBlob(fields dict.Dict) (hashing.HashValue, isc.OffLedgerRequest, *isc.Receipt, error)

UploadBlob sends an off-ledger request to call 'store' in the blob contract.

type PostRequestParams

type PostRequestParams struct {
	Transfer  *isc.FungibleTokens
	Args      dict.Dict
	Nonce     uint64
	NFT       *isc.NFT
	Allowance *isc.Allowance
	GasBudget *uint64
}

func NewPostRequestParams

func NewPostRequestParams(p ...interface{}) *PostRequestParams

NewPostRequestParams simplifies encoding of request parameters

func (*PostRequestParams) WithBaseTokens

func (par *PostRequestParams) WithBaseTokens(i uint64) *PostRequestParams

func (*PostRequestParams) WithGasBudget

func (par *PostRequestParams) WithGasBudget(budget uint64) *PostRequestParams

func (*PostRequestParams) WithTransfer

func (par *PostRequestParams) WithTransfer(transfer *isc.FungibleTokens) *PostRequestParams