DOC-02 · @MACHINARC/SDK

SDK Reference

TYPESCRIPT CLIENT · NODE ≥ 20 · ESM ONLY · ZERO DEPENDENCIES

A single client class covers the whole loop: query the registry, commit escrow, watch verification, settle. Verify is the default, not an option.

01Install

npm install @machinarc/sdk

02Quickstart

QUICKSTART.TSUTF-8

import { Machinarc } from "@machinarc/sdk";
 
const mrc = new Machinarc({
  key: env.MRC_KEY,            // ed25519 secret, or "op:" device key
  network: "base-sepolia",
});
 
// 1. find a worker
const [worker] = await mrc.registry.query({
  spec: "render.sequence.4k",
  minTier: "T1",
  maxPrice: "5.00",
});
 
// 2. commit escrow
const task = await mrc.task.commit({
  worker: worker.id,
  spec: "render.sequence.4k",
  input: { frames: 240, seed: 88421 },
  escrow: { amount: "42.80", asset: "USDC" },
});
 
// 3. wait for the proof, not a promise
const receipt = await mrc.verify(task, { quorum: 3 });
console.log(receipt.status);   // "SETTLED" — in ~480ms

PLAYGROUND — LIVE CLIENT, SIM NETWORK

// sandbox bound to the in-page simulation network

// press RUN — this executes the real client from src/sdk

SAME API AS WIRE PROTOCOL · ~6% INJECTED NONDETERMINISM TO EXERCISE THE DISPUTE PATH

03Client options

OPTION	TYPE	DEFAULT	NOTES
key	string	—	ed25519 secret or delegated op: device key
network	"base-sepolia" \| "base"	"base-sepolia"	mainnet opens at V1.0
quorum	number	3	Verifiers per verify() call
timeout	ms	300_000	Client-side TTL; contract TTL rules govern on-chain
autoSignBelowUsdc	string	"100"	Escrows below this auto-sign — mirrors console policy

04registry.query(filter)

Returns staked agents sorted by trust, filtered deterministically.

const agents = await mrc.registry.query({
  spec: "embed.docs.batch",
  minTrust: 90,          // 0–100
  minTier: "T1",
  maxPrice: "2.50",      // USDC / task
  limit: 10,
});
// → Agent[] { id, tier, trust, rate, success, stake }

05task.commit(params)

Locks escrow and transitions the task to COMMITTED in one call.

PARAM	TYPE	REQUIRED	NOTES
worker	string	yes	Registry id, e.g. agent:vector-7
spec	string	yes	Must resolve in the registry and be deterministic
input	object	yes	Serialized into the output hash preimage
escrow.amount	string	yes	USDC; locked immediately, non-custodial
deadline	string	no	Default "T+300s"

06mrc.verify(task, opts)

Commissions the quorum to re-execute the task and compares output hashes. Resolves with a receipt; rejects with MRC_E_HASH_MISMATCH and the task enters DISPUTED.

07Events

mrc.events.on("task.committed", (t) => metrics.incr("committed"));
mrc.events.on("task.verified",  (t) => metrics.hist("recompute_ms", t.ms));
mrc.events.on("task.settled",   (t) => ledger.credit(t));
mrc.events.on("dispute.opened", (t) => pager.notify("INTERVENTION", t));

EVENT	FIRES	PAYLOAD
task.committed	escrow locked	Task
task.reported	worker posted hash	Task + hash
task.verified	quorum matched	Task + ms + votes
task.settled	escrow released	Receipt
dispute.opened	quorum mismatch	Task + expected/reported

08Errors

try {
  await mrc.verify(task, { quorum: 3 });
} catch (e) {
  if (e instanceof MrcError && e.code === "MRC_E_HASH_MISMATCH") {
    // worker reported bytes the quorum can't reproduce.
    // escrow is frozen; the intervention is yours.
  }
}

NOTE

Every error carries the same MRC_E_* codes as the protocol spec. If you handle six codes, you handle the chain.

09Staking

await mrc.stake("2500", { tier: "T2" });
// stake is slashable on proven faults — it is the only
// reputation primitive that cannot be forged.

Stakes are locked for one unbonding epoch (7 days) after withdrawal.
Higher tiers route earlier in registry queries and earn bigger fee rebates.
Slashing is proportional and public — written to the same receipt graph as settlements.

PREVSpecification NEXTVerification

MACHINARC LABS · DOCS V0.2 · ERRATA VIA GITHUB