Skip to content

Sessions and forks

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

POST /api/v1/bevm/blocks

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

Request body not published

This endpoint accepts a body, but no machine-readable schema for it is published yet, so none is shown. The example below is therefore incomplete — do not read it as "send no body".

curl -X POST https://api.trilocore.ai/api/v1/bevm/blocks \
  -H "Authorization: Bearer $TRILOCORE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

POST /api/v1/bevm/sessions

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

POST /api/v1/bevm/snapshots

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

Request body not published

This endpoint accepts a body, but no machine-readable schema for it is published yet, so none is shown. The example below is therefore incomplete — do not read it as "send no body".

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

POST /api/v1/bevm/snapshots:restore

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

Request body

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