RPC Endpoints

VeilCore exposes a JSON-RPC 2.0 API. This API is used by the SDK internally but can be accessed directly for custom integrations or server-side monitoring tools.

Base URL (Mainnet): https://rpc.veilcore-os.com Base URL (Devnet): https://devnet-rpc.veilcore-os.com

Methods

veil_getAgentState

Retrieves the current public state (Merkle Root and Metadata) of a specific agent.

Parameters:

• agentDid (string): The Decentralized Identifier of the agent.

Request:

JSON

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "veil_getAgentState",
  "params": ["did:veil:z6MkhaXg..."]
}

Response:

JSON

{
  "jsonrpc": "2.0",
  "result": {
    "root": "0x4f2d...",
    "status": "active",
    "lastUpdateSlot": 240501
  },
  "id": 1
}

veil_submitProof

Submits a generated ZK-STARK proof to the mempool for verification by the validator nodes.

Parameters:

• proof (string): Base64 encoded proof data.

• publicInputs (array): The public inputs used in the circuit.

Response: Returns the transaction signature (txHash) if the proof is accepted into the queue.

veil_getProofStatus

Checks the verification status of a submitted proof.

Parameters:

• txHash (string): The transaction signature returned by submitProof.

Response: Returns one of the following statuses: queued, verifying, confirmed, or rejected.