Skip to main content

Convex Adapter

Sometimes agents need shared state that no single party controls — balances, registries, commitments between organisations that don't trust each other's databases. The Convex adapter provides it by connecting the venue to the Convex network — the decentralised lattice technology Covia itself is built on. convex:query runs read-only Convex Lisp against a peer; convex:transact submits signed transactions: verifiable, decentralised state and settlement as ordinary grid operations.

Operations​

convex:query — Read​

{
  "operation": "v/ops/convex/query",
  "input": {
    "peer": "peer.convex.live:18888",
    "address": "#13",
    "source": "(* 2 3)"
  }
}

Returns the Convex result as {result, value} — here {"result": "6", "value": 6}. peer is optional (the shipped operation defaults to the public peer.convex.live peer); address is optional for queries.

convex:transact — Write​

Submits a signed transaction: address (origin account), source (Convex Lisp), and seed (the Ed25519 signing seed) are required. The seed is marked secret in the schema — prefer a secret reference over a literal wherever one is accepted.

CVM-level errors (an undefined symbol, a bad signature) come back as a completed job with errorCode set — the network answered; the answer was an error. Connection and input failures fail the job. A 60-second backstop ensures an unresponsive peer can never park a job forever.

  • The Grid — how Covia uses lattice technology itself
  • Secrets — keeping signing seeds out of inputs