Read smart contract state

post

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

Calls a view or pure method and returns its decoded return values. No transaction is created, no fee is incurred and no funds move.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

network

string

Name of the blockchain network.

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 call.

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.

assetPoolId

uuid

Unique identifier of an asset pool to authorize this read against, and to resolve the owning tenant. Optional; when omitted the tenant is taken from the caller's token. The chain queried is determined by network, not by this field.

Responses

200OK

400Standard error response

503Service Unavailable