List Applications

Example Request

{
  "jsonrpc": "2.0",
  "method": "cartesi_listApplications",
  "params": {
    "limit": 10,
    "offset": 0
  },
  "id": 1
}

The cartesi_listApplications method returns a paginated list of applications registered in the Cartesi Rollups instance.

Parameters

Name	Type	Required	Description
limit	number	No	Maximum number of applications to return (default: 50, minimum: 1)
offset	number	No	Starting point for the list (default: 0, minimum: 0)

Response

{
  "jsonrpc": "2.0",
  "result": {
    "data": [
      {
        "name": "calculator",
        "iapplication_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "iconsensus_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "iinputbox_address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "template_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "epoch_length": "0x100",
        "data_availability": "0x",
        "state": "ENABLED",
        "reason": "",
        "iinputbox_block": "0x1",
        "last_input_check_block": "0x1",
        "last_output_check_block": "0x1",
        "processed_inputs": "0x1",
        "created_at": "2024-01-01T00:00:00Z",
        "updated_at": "2024-01-01T00:00:00Z",
        "execution_parameters": {
          "snapshot_policy": "NONE",
          "advance_inc_cycles": "0x1000",
          "advance_max_cycles": "0x10000",
          "inspect_inc_cycles": "0x1000",
          "inspect_max_cycles": "0x10000",
          "advance_inc_deadline": "0x1000000",
          "advance_max_deadline": "0x10000000",
          "inspect_inc_deadline": "0x1000000",
          "inspect_max_deadline": "0x10000000",
          "load_deadline": "0x1000000",
          "store_deadline": "0x1000000",
          "fast_deadline": "0x1000000",
          "max_concurrent_inspects": 1,
          "created_at": "2024-01-01T00:00:00Z",
          "updated_at": "2024-01-01T00:00:00Z"
        }
      }
    ],
    "pagination": {
      "total_count": 1,
      "limit": 50,
      "offset": 0
    }
  },
  "id": 1
}

Response Fields

Data

Name	Type	Description
name	string	The name of the application
iapplication_address	string	The Ethereum address of the application contract
iconsensus_address	string	The Ethereum address of the consensus contract
iinputbox_address	string	The Ethereum address of the input box contract
template_hash	string	The hash of the application template
epoch_length	string	The length of each epoch in blocks
data_availability	string	The data availability configuration
state	string	Current state of the application (ENABLED/DISABLED/INOPERABLE)
reason	string	Reason for the current state
iinputbox_block	string	The block number of the input box contract
last_input_check_block	string	The last block checked for inputs
last_output_check_block	string	The last block checked for outputs
processed_inputs	string	The number of processed inputs
created_at	string	Timestamp when the application was created
updated_at	string	Timestamp when the application was last updated
execution_parameters	object	Configuration parameters for application execution

Execution Parameters

Name	Type	Description
snapshot_policy	string	The snapshot policy (NONE/EVERY_INPUT/EVERY_EPOCH)
advance_inc_cycles	string	Incremental cycles for advance state
advance_max_cycles	string	Maximum cycles for advance state
inspect_inc_cycles	string	Incremental cycles for inspect state
inspect_max_cycles	string	Maximum cycles for inspect state
advance_inc_deadline	string	Incremental deadline for advance state (ns)
advance_max_deadline	string	Maximum deadline for advance state (ns)
inspect_inc_deadline	string	Incremental deadline for inspect state (ns)
inspect_max_deadline	string	Maximum deadline for inspect state (ns)
load_deadline	string	Deadline for loading state (ns)
store_deadline	string	Deadline for storing state (ns)
fast_deadline	string	Deadline for fast operations (ns)
max_concurrent_inspects	number	Maximum number of concurrent inspect operations
created_at	string	Timestamp when parameters were created
updated_at	string	Timestamp when parameters were last updated

Pagination

Name	Type	Description
total_count	number	Total number of applications available
limit	number	Number of applications returned in this response
offset	number	Starting point of the returned applications

Error Codes

Code	Message	Description
-32602	Invalid params	Invalid parameter values
-32603	Internal error	An internal error occurred