Skip to content

Sessions and forks

31 endpoints. Every path below is served by trilocore-backend behind the gateway at https://api.trilocore.ai.

POST /api/v1/bevm/sessions

The resource id is a per-caller slot id, derived from the caller and their session tag — not a per-instance id. It is reused: deleting and recreating returns the same id, and so does acting on a different target. current is accepted in its place. Another caller's id answers 404.

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 201
Upstream trilocore-backend

Request body

Field Type Required Constraints
apply_fundings boolean no —
auditor_address string no maxLength 66
auto_link_contracts boolean no —
block string | integer no —
bytecode_lmdb string | null no maxLength 4096
fresh boolean no —
fundings array no maxItems 64
lean boolean no —
mdbx_cache_dir string | null no maxLength 4096
network string no maxLength 32
offline boolean no —
project_id string | null no maxLength 128
related_targets array no maxItems 8
rpc_cache_dir string | null no maxLength 4096
rpc_url string yes maxLength 2048
skip_analysis boolean no —
target_address string yes maxLength 66
workspace_id string | null no maxLength 128
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rpc_url": "…", "target_address": "…"}'

DELETE /api/v1/bevm/sessions/{uid}

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend
curl -X DELETE https://api.trilocore.ai/api/v1/bevm/sessions/{uid} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET /api/v1/bevm/sessions/{uid}

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Query parameters

Parameter Type Required Constraints Description
lean boolean no — —
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

GET /api/v1/bevm/sessions/{uid}/balances/{address}

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Query parameters

Parameter Type Required Constraints Description
erc20 string no — —
token string no — —
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/balances/{address} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/balances:batchGet

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
actors array no maxItems 32
discover boolean no —
tokens array no maxItems 32
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/balances:batchGet \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"actors": [], "discover": false, "tokens": []}'

POST /api/v1/bevm/sessions/{uid}/blocks

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

  • application/json: a JSON object
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/blocks \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

POST /api/v1/bevm/sessions/{uid}/contracts:call

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
abi array no —
address string yes maxLength 66
args array no —
force_send boolean no —
function string no maxLength 512
gas_limit integer no —
gas_price integer | null no —
raw_calldata string | null no maxLength 1000000
sender string no maxLength 66
value_wei integer | string | number no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/contracts:call \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "…"}'

▶ Run this example in the sandbox

POST /api/v1/bevm/sessions/{uid}/deployments

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
abi array | null no —
artifact string | integer | null no maxLength 256
bytecode string | null no maxLength 2000000
compilation_id string | null no maxLength 64
constructor_args array no —
constructor_args_hex string | null no maxLength 1000000
contract_name string no maxLength 256
entrypoint string | null no maxLength 4096
evm_version string | null no maxLength 32
expected_state_revision integer | null no minimum 0
gas_limit integer no —
gas_price integer | null no —
optimize boolean no —
optimize_runs integer no —
remappings array | null no —
sender string no maxLength 66
solc_version string | null no maxLength 32
source string | null no maxLength 1000000
sources object | null no —
value_wei integer | string | number no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/deployments \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"abi": [], "artifact": "…", "bytecode": "…"}'

GET /api/v1/bevm/sessions/{uid}/differentials

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/differentials \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST /api/v1/bevm/sessions/{uid}/differentials

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
args array no —
expected_state_revision one of no —
fundings array no —
gas_limit one of no —
gas_price one of no —
overrides object no —
persist boolean no —
raw_calldata one of no —
selector string no —
sender string no —
signature one of no —
timeout_ms one of no —
to string yes —
value_wei integer no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/differentials \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "…"}'

GET /api/v1/bevm/sessions/{uid}/engagement-exports

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/engagement-exports \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/explanations

Not available

This endpoint belongs to the AI plane, which is not currently running. Calls reach the gateway and then fail upstream.

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
context string no —
error_or_revert string no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/explanations \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"context": "…", "error_or_revert": "…"}'

POST /api/v1/bevm/sessions/{uid}/facets:resolve

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
address string | null no maxLength 66
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/facets:resolve \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "…"}'

POST /api/v1/bevm/sessions/{uid}/fundings:apply

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
expected_state_revision one of no —
fundings array no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/fundings:apply \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expected_state_revision": 0, "fundings": []}'

POST /api/v1/bevm/sessions/{uid}/gas-fuzz-traces

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

  • application/json: a JSON object
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/gas-fuzz-traces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/introspections

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
capture_memory boolean no —
capture_stack boolean no —
data string no maxLength 1000000
max_steps integer no —
sender string no maxLength 66
to string no maxLength 66
tx_hash string no maxLength 66
value string no maxLength 66
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/introspections \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"capture_memory": false, "capture_stack": false, "data": "…"}'

POST /api/v1/bevm/sessions/{uid}/logs:query

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
address string | null no maxLength 66
addresses array no —
fromBlock string | integer | null no —
limit integer no maximum 5000, minimum 1
toBlock string | integer | null no —
topics array no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/logs:query \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "…", "addresses": [], "fromBlock": "…"}'

POST /api/v1/bevm/sessions/{uid}/proposals

Not available

This endpoint belongs to the AI plane, which is not currently running. Calls reach the gateway and then fail upstream.

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

This operation takes no request body.

curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/proposals \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET /api/v1/bevm/sessions/{uid}/provenance-seals

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/provenance-seals \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

▶ Run this example in the sandbox

POST /api/v1/bevm/sessions/{uid}/recordings

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

  • application/json: a JSON object
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/recordings \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/snapshots

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

This operation takes no request body.

curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/snapshots \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/snapshots:restore

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
expected_state_revision integer | null no minimum 0
resume_isolation boolean no —
snapshot_id string yes maxLength 128
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/snapshots:restore \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"snapshot_id": "…"}'

POST /api/v1/bevm/sessions/{uid}/storage-slots:read

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
address string yes maxLength 66
range_end string | null no maxLength 66
range_start string | null no maxLength 66
slots array no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/storage-slots:read \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "…"}'

POST /api/v1/bevm/sessions/{uid}/storage-slots:write

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
address string yes maxLength 66
expected_state_revision integer | null no minimum 0
slot string | null no maxLength 66
value string | null no maxLength 66
writes array no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/storage-slots:write \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"address": "…"}'

POST /api/v1/bevm/sessions/{uid}/storage-traces

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
capture_reads boolean no —
data string no maxLength 1000000
max_steps integer no —
merge_graph boolean no —
sender string no maxLength 66
to string yes maxLength 66
track_taint boolean no —
value string no maxLength 66
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/storage-traces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "…"}'

POST /api/v1/bevm/sessions/{uid}/traces

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

  • application/json: a JSON object
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/traces \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

GET /api/v1/bevm/sessions/{uid}/traces/{tx_hash}

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Query parameters

Parameter Type Required Constraints Description
network string no — —
rpc_url string no — —
curl -X GET https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/traces/{tx_hash} \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"

POST /api/v1/bevm/sessions/{uid}/transactions

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
args array no —
expected_state_revision integer | null no minimum 0
fundings array no —
gas_limit integer | null no maximum 1000000000, minimum 21000
gas_price integer | null no maximum 1000000000000000000000000000000, minimum 0
overrides object no —
persist boolean no —
raw_calldata string | null no maxLength 1000000
selector string no maxLength 512
sender string no maxLength 66
signature string | null no maxLength 512
timeout_ms integer | null no maximum 180000, minimum 1000
to string yes maxLength 66
value_wei integer | string | number no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/transactions \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"to": "…"}'

POST /api/v1/bevm/sessions/{uid}/transactions:replay

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
fund_sender_gas one of no —
persist boolean no —
steps array no maxItems 256
stop_on_revert boolean no —
verify_fundings boolean no —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/transactions:replay \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"fund_sender_gas": 0, "persist": false, "steps": []}'

POST /api/v1/bevm/sessions/{uid}/transactions:resolve

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

Request body

Field Type Required Constraints
network string | null no —
rpc_url string no —
tx_hash string yes —
curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/transactions:resolve \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tx_hash": "…"}'

POST /api/v1/bevm/sessions/{uid}/transient-analyses

Property Value
Authentication Authorization: Bearer (jns_ key or SSO session)
Idempotency-Key not required
Success 200
Upstream trilocore-backend

This operation takes no request body.

curl -X POST https://api.trilocore.ai/api/v1/bevm/sessions/{uid}/transient-analyses \
  -H "Authorization: Bearer $TRILOCORE_API_KEY"