VORQ Docs
Guides

Read contract state with cast

Read jobs, providers, quotes and configuration, query logs, and decode revert reasons with cast.

The examples use the Base Sepolia deployment. For the local fork, use http://localhost:8545 and the addresses from fork/state/addresses.json.

export RPC=https://sepolia.base.org
export JOBS=0x87019B9305D80EBfDC87E2DD80C80F624E05e77d
export PROVIDERS=0xE09698C32e73F86D8227cDB3588fc219d8ce0471
export ASKS=0xBA8eC092e701E4F60536d19443F12E441403743D

Read a job

A job id is keccak256(abi.encodePacked(owner, c)):

JOB=$(cast keccak $(cast concat-hex <owner address> <c>))

getJob returns a JobView and never reverts. Pass the full tuple as the return type:

cast call $JOBS "getJob(bytes32)((bool,bytes32,address,bytes32,uint8,uint8,uint32,uint32,uint32,uint128,uint128,uint32,uint32,uint32,uint32,uint64,uint64,bytes,bytes))" $JOB --rpc-url $RPC

Fields in order: found, jobId, owner, c, state, endedBecause, providerId, designated, modelId, rateIn, rateOut, unitsIn, unitsOut, completionTok, slaSecs, expiresAt, claimedAt, taskCid, resultCid. An unknown id returns found == false and zeros. See Job lifecycle for state and endedBecause.

The escrow cap is not in JobView:

cast call $JOBS "capOf(bytes32)(uint128)" $JOB --rpc-url $RPC

Read a provider

cast call $PROVIDERS "idOf(address)(uint32)" <operator address> --rpc-url $RPC
cast call $PROVIDERS "operatorOf(uint32)(address)" 1 --rpc-url $RPC
cast call $PROVIDERS "isListed(uint32)(bool)" 1 --rpc-url $RPC
cast call $PROVIDERS "reputationOf(uint32)(uint16)" 1 --rpc-url $RPC
cast call $PROVIDERS "effectiveCap(uint32)(uint32)" 1 --rpc-url $RPC
cast call $JOBS "activeJobs(uint32)(uint32)" 1 --rpc-url $RPC
cast call $PROVIDERS "modelAllowed(uint32,uint32)(bool)" 1 2 --rpc-url $RPC
cast call $PROVIDERS "boxKeyOf(uint32)(bytes32)" 1 --rpc-url $RPC

idOf returns 0 for an address that is not an operator. The other provider views revert UnknownProviderId() for an id that was never registered.

Read the model catalog

Model ids run from 1 to nextModelId() - 1:

cast call $PROVIDERS "nextModelId()(uint32)" --rpc-url $RPC
cast call $PROVIDERS "modelEnabled(uint32)(bool)" 2 --rpc-url $RPC

Model names are only in ModelRegistered logs.

Read a quote

cast call $ASKS "getQuote(uint32,uint32,uint32)(uint128,uint128)" <providerId> <modelId> <slaSecs> --rpc-url $RPC
cast call $ASKS "lastSignedAt(uint32)(uint64)" <providerId> --rpc-url $RPC

(0, 0) means no quote. Rates are scaled by RATE_SCALE; see Escrow and fees.

Read configuration

cast call $JOBS "feeBps()(uint16)" --rpc-url $RPC
cast call $JOBS "gasFee()(uint128)" --rpc-url $RPC
cast call $JOBS "treasury()(address)" --rpc-url $RPC
cast call $JOBS "allowedSla(uint32)(bool)" 86400 --rpc-url $RPC
cast call $PROVIDERS "isJobRegistry(address)(bool)" $JOBS --rpc-url $RPC

allowedSla is a mapping; the set of allowed values is only enumerable from SlaAllowedChanged logs.

Use the make targets

From the repository root, the read-only targets bind to the address book in deployments/ for the RPC's chain id, check the domain separators, and print formatted output. They send nothing.

make read-config RPC=$RPC                           # every live parameter, models, SLAs
make read-provider ID=1 RPC=$RPC
make read-job JOB=0x… RPC=$RPC
make read-asks ID=1 MODEL=2 SLA=86400 RPC=$RPC
make read-allowlist MEASUREMENT=<64 hex, no 0x> RPC=$RPC
make doctor RPC=$RPC                                # wiring, separators, treasury, fees

They work only on networks that have an address book, not on the local fork.

Query logs

Event signatures and topic0 values are in the contract references. Filter by topic0 and, for indexed fields, by topic. For example, every Posted for one job:

cast logs --address $JOBS \
  "Posted(bytes32 indexed,uint32 indexed,uint32 indexed,address,bytes32,uint64,uint32,uint128,uint128,uint32,uint32,bytes)" \
  $JOB --from-block <start> --to-block <end> --rpc-url $RPC

Public endpoints cap the block range of eth_getLogs (https://sepolia.base.org allows 1,000 blocks; the local fork proxy allows 5,000). Query in chunks.

Decode a revert or a skipped line

Every custom error takes no arguments, so revert data is a 4-byte selector. PostSkipped.reason is the same selector for the line post refused; an empty reason means the line ran out of gas. Look it up in the error tables of the JobRegistry reference, or:

cast decode-error 0x5276902d    # StaleOp()

Run the local fork

Start a disposable Base Sepolia fork with the VORQ contracts deployed and a client funded in USDC.

Verify an EIP-712 signature

Rebuild a domain separator, struct hash and digest with cast, and check a signature against the published test vectors.

On this page

Read a jobRead a providerRead the model catalogRead a quoteRead configurationUse the make targetsQuery logsDecode a revert or a skipped line