Download OpenAPI specification:
Smart Rollup Node RPC API for protocol ProtoALphaALphaALphaALphaALphaALphaALphaALphaDdp3zK
Get operation queues of injectors
tag | string A kind of operation for the injector. |
[- {
- "tags": [
- "add_messages"
], - "queue": [
- {
- "kind": "add_messages",
- "message": [
- "string"
], - "errors": {
- "count": -1073741824,
- "last": null
}
}
]
}
]
{- "smart-rollup-address": "string",
- "etherlink": true,
- "boot-sector": "string",
- "smart-rollup-node-operator": {
- "operating": "string",
- "batching": "string",
- "cementing": "string",
- "recovering": "string",
- "executing_outbox": "string"
}, - "rpc-addr": "string",
- "rpc-port": 65535,
- "acl": [
- {
- "address": "string",
- "whitelist": [
- "string"
]
}
], - "metrics-addr": "string",
- "performance-metrics": true,
- "reconnection_delay": 0,
- "fee-parameters": {
- "publish": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "add_messages": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "cement": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "timeout": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "refute": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "recover": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "execute_outbox_message": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}, - "publish_dal_commitment": {
- "minimal-fees": "string",
- "minimal-nanotez-per-byte": [
- "string"
], - "minimal-nanotez-per-gas-unit": [
- "string"
], - "force-low-fee": true,
- "fee-cap": "string",
- "burn-cap": "string"
}
}, - "mode": {
- "custom": [
- "add_messages"
]
}, - "loser-mode": [
- {
- "level": -1073741824,
- "message_index": -1073741824,
- "message_tick": "string"
}
], - "apply-unsafe-patches": true,
- "unsafe-pvm-patches": [
- {
- "increase_max_nb_tick": "string"
}
], - "execute-outbox-messages-filter": [
- {
- "transaction": {
- "destination": "any",
- "entrypoint": "any"
}
}
], - "DAL node endpoint": "string",
- "pre-images-endpoint": "string",
- "batcher": {
- "min_batch_elements": -1073741824,
- "min_batch_size": -1073741824,
- "max_batch_elements": -1073741824,
- "max_batch_size": -1073741824
}, - "injector": {
- "retention_period": 65535,
- "attempts": 65535,
- "injection_ttl": 65535
}, - "l1_blocks_cache_size": -1073741824,
- "l2_blocks_cache_size": -1073741824,
- "prefetch_blocks": -1073741824,
- "l1_rpc_timeout": 0,
- "loop_retry_delay": 0,
- "index_buffer_size": -1073741824,
- "irmin_cache_size": -1073741824,
- "log-kernel-debug": true,
- "unsafe-disable-wasm-kernel-checks": true,
- "no-degraded": true,
- "gc-parameters": {
- "frequency": -2147483648,
- "context_splitting_period": -1073741824
}, - "history-mode": "full",
- "cors": {
- "allowed_headers": [
- "string"
], - "allowed_origins": [
- "string"
]
}, - "bail-on-disagree": true,
- "opentelemetry": {
- "enable": true,
- "instance_id": "string",
- "debug": true,
- "url_traces": "string",
- "headers": [
- [
- "string"
]
], - "batch_traces": -1073741824,
- "batch_timeout_ms": -1073741824
}
}
RPCs documentation and input/output schema
recurse required | string |
{- "static": {
- "get_service": {
- "meth": "PATCH",
- "path": [
- "string"
], - "description": "string",
- "query": [
- {
- "name": "string",
- "description": "string",
- "kind": {
- "single": {
- "id": "single",
- "name": "string",
- "descr": "string"
}
}
}
], - "input": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "output": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "error": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}
}, - "post_service": {
- "meth": "PATCH",
- "path": [
- "string"
], - "description": "string",
- "query": [
- {
- "name": "string",
- "description": "string",
- "kind": {
- "single": {
- "id": "single",
- "name": "string",
- "descr": "string"
}
}
}
], - "input": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "output": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "error": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}
}, - "delete_service": {
- "meth": "PATCH",
- "path": [
- "string"
], - "description": "string",
- "query": [
- {
- "name": "string",
- "description": "string",
- "kind": {
- "single": {
- "id": "single",
- "name": "string",
- "descr": "string"
}
}
}
], - "input": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "output": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "error": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}
}, - "put_service": {
- "meth": "PATCH",
- "path": [
- "string"
], - "description": "string",
- "query": [
- {
- "name": "string",
- "description": "string",
- "kind": {
- "single": {
- "id": "single",
- "name": "string",
- "descr": "string"
}
}
}
], - "input": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "output": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "error": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}
}, - "patch_service": {
- "meth": "PATCH",
- "path": [
- "string"
], - "description": "string",
- "query": [
- {
- "name": "string",
- "description": "string",
- "kind": {
- "single": {
- "id": "single",
- "name": "string",
- "descr": "string"
}
}
}
], - "input": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "output": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}, - "error": {
- "json_schema": null,
- "binary_schema": {
- "toplevel": {
- "fields": [
- {
- "name": "string",
- "layout": {
- "kind": "Zero_width"
}, - "data_kind": {
- "size": -1073741824,
- "kind": "Fixed"
}, - "kind": "named"
}
]
}, - "fields": [
- {
- "description": {
- "title": "string",
- "description": "string"
}, - "encoding": {
- "fields": [
- {
- "name": null,
- "layout": null,
- "data_kind": null,
- "kind": null
}
]
}
}
]
}
}
}, - "subdirs": {
- "suffixes": [
- {
- "name": "string",
- "tree": {
- "static": { }
}
}
]
}
}
}
Layer-2 block of the layer-2 chain with respect to a Layer 1 block identifier
block_id required | string An L1 block identifier. |
outbox required | string |
{- "block_hash": "string",
- "level": -2147483648,
- "predecessor": "string",
- "commitment_hash": "string",
- "previous_commitment_hash": "string",
- "context": "string",
- "inbox_witness": "string",
- "inbox_hash": "string",
- "inbox": {
- "level": -2147483648,
- "old_levels_messages": {
- "index": "string",
- "content": {
- "hash": "string",
- "level": -2147483648
}, - "back_pointers": [
- "string"
]
}
}, - "messages": [
- "string"
], - "commitment": {
- "compressed_state": "string",
- "inbox_level": -2147483648,
- "predecessor": "string",
- "number_of_ticks": "string"
}, - "outbox": [
- {
- "message_index": -1073741824,
- "whitelist_update": [
- "string"
]
}
], - "initial_tick": "string",
- "num_ticks": "string"
}
Commitment status of the rollup state which will include content of this block
block_id required | string An L1 block identifier. |
{- "uncommitted": {
- "commitment_level": -2147483648,
- "estimated_commitment_time": "string",
- "estimated_cementation_time": "string"
}
}
Retrieve number of bytes in raw representation of value by key from PVM durable storage. PVM state is taken with respect to the specified block level.
block_id required | string An L1 block identifier. |
key required | string |
"string"
Retrieve subkeys of the specified key from PVM durable storage. PVM state is taken with respect to the specified block level.
block_id required | string An L1 block identifier. |
key required | string |
[- "string"
]
Retrieve value by key from PVM durable storage. PVM state is taken with respect to the specified block level. Value returned in hex format.
block_id required | string An L1 block identifier. |
key required | string |
"string"
Retrieve values directly under a given key from PVM durable storage. PVM state is taken with respect to the specified block level.
block_id required | string An L1 block identifier. |
key required | string |
[- {
- "key": "string",
- "value": "string"
}
]
Generate serialized output proof for some outbox message at level and index
block_id required | string An L1 block identifier. |
level required | string |
index | string |
{- "commitment": "string",
- "proof": "string"
}
Rollup inbox for block
block_id required | string An L1 block identifier. |
{- "level": -2147483648,
- "old_levels_messages": {
- "index": "string",
- "content": {
- "hash": "string",
- "level": -2147483648
}, - "back_pointers": [
- "string"
]
}
}
Outbox at block for a given outbox level
block_id required | string An L1 block identifier. |
outbox_level | string |
[- {
- "outbox_level": 2147483647,
- "message_index": "string",
- "message": {
- "transactions": [
- {
- "parameters": {
- "int": "string"
}, - "destination": "string",
- "entrypoint": "string"
}
], - "kind": "untyped"
}
}
]
Outbox at block for a given outbox level
block_id required | string An L1 block identifier. |
level required | string |
[- {
- "outbox_level": 2147483647,
- "message_index": "string",
- "message": {
- "transactions": [
- {
- "parameters": {
- "int": "string"
}, - "destination": "string",
- "entrypoint": "string"
}
], - "kind": "untyped"
}
}
]
Simulate messages evaluation by the PVM
block_id required | string An L1 block identifier. |
messages required | Array of strings[ items^([a-zA-Z0-9][a-zA-Z0-9])*$ ] Serialized messages for simulation. |
reveal_pages | Array of strings[ items^([a-zA-Z0-9][a-zA-Z0-9])*$ ] Pages (at most 4kB) to be used for revelation ticks |
Array of pvm_state (object) or durable_storage (object) Paths in the PVM to inspect after the simulation | |
(Universal string representation (Universal string representation (string) or Universal string representation (object))) File in which to emit kernel logs. This file will be created in |
{- "messages": [
- "string"
], - "reveal_pages": [
- "string"
], - "insight_requests": [
- {
- "kind": "pvm_state",
- "key": [
- "string"
]
}
], - "log_kernel_debug_file": "string"
}
{- "state_hash": "string",
- "status": "string",
- "output": [
- {
- "outbox_level": 2147483647,
- "message_index": "string",
- "message": {
- "transactions": [
- {
- "parameters": {
- "int": "string"
}, - "destination": "string",
- "entrypoint": "string"
}
], - "kind": "untyped"
}
}
], - "inbox_level": -2147483648,
- "num_ticks": "string",
- "insights": [
- "string"
]
}
{- "block_hash": "string",
- "level": -2147483648,
- "predecessor": "string",
- "commitment_hash": "string",
- "previous_commitment_hash": "string",
- "context": "string",
- "inbox_witness": "string",
- "inbox_hash": "string",
- "initial_tick": "string",
- "num_ticks": "string",
- "property1": null,
- "property2": null
}
{- "healthy": true,
- "degraded": true,
- "l1": {
- "connection": "connected",
- "blocks_late": -2147483648,
- "last_seen_head": {
- "hash": "string",
- "level": -2147483648,
- "timestamp": "string"
}
}, - "active_workers": [
- [
- "string"
]
]
}
Inject messages in the batcher's queue
order | string |
drop_duplicate required | string |
A hex encoded smart rollup message
[- "string"
]
[- "string"
]
Commitment computed and published by the node
commitment_hash required | string A commitment hash. |
{- "commitment": {
- "compressed_state": "string",
- "inbox_level": -2147483648,
- "predecessor": "string",
- "number_of_ticks": "string"
}, - "hash": "string",
- "first_published_at_level": -2147483648,
- "published_at_level": -2147483648
}
Inject the given messages in the DAL queue, even in case of duplicates
Either a plain UTF8 string, or a sequence of bytes for strings that contain invalid byte sequences.
[- "string"
]
null
Forget information about the injection whose id is given
injector_operation_hash required | string injector_operation_hash (Base58Check-encoded) |
null
null
Provide the (new) list of slot indices to use to the rollup node's DAL injector
indices required | Array of integers[ items [ 0 .. 255 ] ] |
{- "indices": [
- 255
]
}
null
Retrieve the status of the injected operation using its injector ID.
injector_operation_hash required | string injector_operation_hash (Base58Check-encoded) |
{- "status": "unknown"
}
{- "commitment": {
- "compressed_state": "string",
- "inbox_level": -2147483648,
- "predecessor": "string",
- "number_of_ticks": "string"
}, - "hash": "string",
- "first_published_at_level": -2147483648,
- "published_at_level": -2147483648
}
Pending outbox messages with their status (executable, pending, or lost)
outbox_level | string |
[- {
- "outbox_level": -2147483648,
- "messages": [
- {
- "message_index": -1073741824,
- "message": {
- "whitelist_update": [
- "string"
]
}
}
], - "status": "pending"
}
]
Pending outbox messages which cannot yet be executed
outbox_level | string |
[- {
- "outbox_level": -2147483648,
- "messages": [
- {
- "message_index": -1073741824,
- "message": {
- "whitelist_update": [
- "string"
]
}
}
]
}
]
{- "minor_words": 0,
- "promoted_words": 0,
- "major_words": 0,
- "minor_collections": -1073741824,
- "major_collections": -1073741824,
- "forced_major_collections": -1073741824,
- "heap_words": -1073741824,
- "heap_chunks": -1073741824,
- "live_words": -1073741824,
- "live_blocks": -1073741824,
- "free_words": -1073741824,
- "free_blocks": -1073741824,
- "largest_free": -1073741824,
- "fragments": -1073741824,
- "compactions": -1073741824,
- "top_heap_words": -1073741824,
- "stack_size": -1073741824
}