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 |
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 |
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 |
— |
— |
▶ 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 |
— |
— |
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 |
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
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 |
— |
▶ 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 |
— |
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 |
▶ 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 |
— |
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 |
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 |
— |
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 |
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 |
— |
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
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 |
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 |
— |
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.
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 |
▶ 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
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.
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 |
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 |
— |
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 |
— |
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 |
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
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 |
— |
— |
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 |
— |
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 |
— |
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 |
— |
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.