Skip to main content

MarloweQuery sub-protocol

The MarloweQuery sub-protocol is defined here:

The MarloweSyncRequest type is a set of requests for use with the generic query protocol that allows clients to query the current state of on-chain Marlowe contracts.

Request types

The following requests are supported:

RequestParameterDescription
StatusReturns status information about the runtime, including node, chain indexer and marlowe indexer tip blocks, network ID, and runtime version.
ContractHeaders filter rangeReturns a page of contract headers, or nothing if the range specified an invalid starting point.
filterA list of tags, a list of role token currencies, and a list of parties to limit the results.
rangeThe ID of the contract to start from, offset, size, and sort direction that describes the page to fetch.
ContractState idReturns the current state of a contract by its ID.
idThe ID of the contract.
Transactions idReturns the apply inputs transaction of a contract by its ID.
idThe ID of the contract.
Transaction idReturns an apply inputs transaction by its ID.
idThe ID of the transaction.
Withdrawals filter rangeReturns a page of withdrawal transactions, or nothing if the range specified an invalid starting point.
filterA list of role token currencies to limit the results.
rangeThe ID of the withdrawal to start from, offset, size, and sort direction that describes the page to fetch.
Withdrawal idReturns a withdraw transaction by its ID.
idThe ID of the withdraw transaction.
PayoutHeaders filter rangeReturns a page of role payout headers, or nothing if the range specified an invalid starting point.
filterA list of contract IDs, a list of role tokens, and an optional status (withdrawn or available) to limit the results.
rangeThe ID of the payout to start from, offset, size, and sort direction that describes the page to fetch.
Payout idReturns a role payout transaction output by its ID.
idThe ID of the role payout transaction output.