decentralised.art Chain Runner API (0.4.0)

Download OpenAPI specification:

License: MIT

Connector execution endpoints, on chain and in the local simulation EVM.

runner

Operations related to connector execution.

CORS preflight

CORS preflight

Responses

Execute on chain

eth_call of Runner.gen on the configured runner, pinned to the block the server's execute block tag resolves to. The chain decides whether the connector exists; the server's own registry is not consulted. No login is required: an eth_call sends no transaction and costs no gas.

Request Body schema: application/json
required
connector_name
required
string

Connector name to execute.

required
integer or string

Number of particles to generate. The backend accepts protobuf JSON uint32 values between 1 and 65536.

object

Dynamic running-instance overrides keyed by canonical decimal RI position. Omitted means no overrides. At most 4096 entries.

Responses

Request samples

Content type
application/json
{
  • "connector_name": "string",
  • "particles_count": 1,
  • "dynamic_ri": {
    }
}

Response samples

Content type
application/json
{
  • "block_number": 0,
  • "block_hash": "string",
  • "runner": "string",
  • "particles": [
    ]
}

CORS preflight

CORS preflight

Responses

Simulate locally

Execute a registered connector in this server's local simulation EVM: entities created through the create endpoints before they are published, and connectors published on chain. A connector that exists only on chain is first deployed locally together with its dependencies, from their verified artifacts. No login is required, and the result carries no chain provenance.

Request Body schema: application/json
required
connector_name
required
string

Connector name to execute.

required
integer or string

Number of particles to generate. The backend accepts protobuf JSON uint32 values between 1 and 65536.

object

Dynamic running-instance overrides keyed by canonical decimal RI position. Omitted means no overrides. At most 4096 entries.

Responses

Request samples

Content type
application/json
{
  • "connector_name": "string",
  • "particles_count": 1,
  • "dynamic_ri": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]