Invoke a smart contract method

post

https://api.sandbox.layer1.com/digital/v1/contract-invocations

Invokes a state-changing method on a smart contract from an address in the given asset pool. Read-only methods must be queried through contract calls instead. Processed asynchronously.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

assetPoolId

uuid

Unique identifier of the asset pool.

network

string

Name of the blockchain network.

address

string

Blockchain address the method will be called from.

deploymentId

uuid

Identifier of a previous deployment made through this API whose resulting contract is the target of this call. Exactly one of deploymentId or (contractId and contractAddress) must be supplied.

contractId

uuid

Identifier of the registered smart contract artifact describing the target of this call, for a contract deployed outside of this API. Must be supplied together with contractAddress. Exactly one of deploymentId or (contractId and contractAddress) must be supplied.

contractAddress

string

Address of the externally deployed contract to call. Must be supplied together with contractId. Exactly one of deploymentId or (contractId and contractAddress) must be supplied.

method

string

Name of the contract method to invoke.

params

object

Named arguments for the method call, keyed by parameter name. Omit if the method takes no arguments. Integer and bytes values should be sent as strings ("1000000000000000000"), addresses as 0x-prefixed hex, arrays as JSON arrays and tuples as JSON objects. A bare JSON number is accepted, but a string is the documented form and the only one that is exact for values above 2^63-1.

value

string

Native asset amount to send with the call, for payable methods.

reference

string

Custom identifier supplied for the transaction. Used to link a transaction to a specific customer or use case.

metadata

object

Additional metadata for the invocation.

Responses

Language

Credentials

http

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

202Accepted

400Standard error response

503Service Unavailable