Documentation

Determica Docs

Deterministic eval runtime for onchain capital workflows.

Determica turns onchain reads, candidate calldata, forked EVM simulations, and policy checks into deterministic evidence. Query contracts as typed SQL. Pin chain state. Fork branches. Execute candidate actions. Inspect asset deltas, touched contracts, calls, logs, storage, and policy output. Emit evidence JSON and a receipt hash before routing, approval, or signing.

Not a block explorer. Not an indexer. Not a wallet. Determica is the eval layer between intent and execution.

First query

Start with one live read

If you can read a contract, you can build every higher-level workflow: historical analysis, route scoring, simulation, policy gates, and pre-signing evidence.

The result is typed SQL, not raw RPC hex. From there you can join oracle reads, decode logs, build calldata, fork state, simulate candidates, and emit an evidence hash.

Read guide
read_contract get_logs
1
-- Chainlink ETH/USD, read live from Ethereum mainnet.
2
WITH feed AS (
3
SELECT read_contract(
4
$transport,
5
'0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419'::ADDRESS,
6
$feed_abi,
7
'latestRoundData'
8
) AS data
9
)
10
SELECT
11
format_units((data).answer, 8) AS eth_usd,
12
to_timestamp((data).updatedAt) AS updated_at
13
FROM feed;
Notebook ready in readonly mode.

Workflows

What are you trying to do?

Choose a job, start with the primitives, then move into the guide when you need the full workflow.

Reference

Find the primitive you need

Reference map

Connect to a chain http_transport Call a contract read_contract Decode event history get_logs Convert human token amounts parse_units Format raw balances format_units Build calldata encode_function_data Create a simulation evm_create_sim_at Fork candidate branches evm_create_run_branch Execute one candidate evm_execute_candidate Execute a bundle evm_execute_candidate_bundle Inspect asset movement evm_run_asset_deltas Inspect touched contracts evm_run_touched_contracts Apply policy evm_evaluate_policy Emit evidence JSON evm_run_evidence_json Hash pre-signing evidence evm_promote_candidate_evidence Predict deployment address create2_predict Mine CREATE2 salts create2_mine

Key types

ADDRESS 20-byte EVM account or contract address BYTES Dynamic calldata, bytecode, or return data BYTES32 Event topics, hashes, storage slots, and fixed words UINT256 Raw unsigned EVM integer, usually balances or amounts INT256 Signed EVM integer, often deltas or oracle answers TRANSPORT RPC connection configuration SIGNABLE Unsigned transaction or deployment payload RUN Simulation evidence window returned by candidate execution
Open the full type reference

Capital-moving workflows

Answer the question before state changes

Determica is designed for teams and agents that need to answer high-stakes questions before state changes:

What does this contract return right now?What changed in this historical block range?What calldata are we about to evaluate?What happens if this route executes?Which branch gives the best outcome?What contracts, storage, logs, and assets did it touch?Did the run satisfy policy?What evidence can we attach before signing?
read encode fork execute inspect policy evidence sign or revise