Yield engine status

—

Top providers

Ranked by completed escrows. Completion rate = approved ÷ all escrows where they delivered.

Buyers

Payout rate = escrows approved ÷ created. A low rate means a buyer disputes often — providers, take note.

Three roles

Anyone interacting with CUSTODY plays one of these roles. Permissions are per-role, per-tx.

Quickstart — as an owner

From zero to your first escrow in 4 steps.

1. Get the provider's address. Your supplier, contractor, or agent gives you the wallet address that will deliver and get paid.
2. Connect to /Custody. MetaMask auto-switches to Arc Testnet, or sign in with email (Circle UCW).
3. Deposit USDC. Approve once, then deposit any amount. Idle USDC auto-deploys into the yield strategy on the next deployIdle() call and earns yield until you escrow it.
4. Create an escrow at /Escrow — name the provider (or leave blank for an open job a supplier claims by ID), lock one amount or comma-separated milestones, set a deadline and an optional verifier. The provider posts a bond and submits proof; you approve to release or dispute to refund.

Quickstart — as a provider

A provider — a supplier's backend or an autonomous agent — runs a script with its own private key. It fulfils an escrow: optionally stakes a bond, then submits proof when delivery is done. No browser, no MetaMask.

// provider.js — fulfil an escrow (Node + ethers v6)
import { ethers } from "ethers";

const VAULT = "0x…";
const USDC  = "0x3600000000000000000000000000000000000000";
const RPC   = "https://rpc.testnet.arc.network";
const ABI   = [
  "function acceptEscrow(uint256 id, uint256 bondAmount)",
  "function postBond(uint256 id, uint256 bondAmount)",
  "function submitProof(uint256 id, bytes32 proofHash)"
];

const provider = new ethers.JsonRpcProvider(RPC);
const wallet   = new ethers.Wallet(process.env.AGENT_PRIVATE_KEY, provider);
const vault    = new ethers.Contract(VAULT, ABI, wallet);
const usdc     = new ethers.Contract(USDC, ["function approve(address,uint256)"], wallet);

const escrowId = Number(process.env.ESCROW_ID);

// Stake a bond. For an OPEN escrow, claim it with acceptEscrow (this also
// makes you the agent). If it's already assigned to you, use postBond instead.
await (await usdc.approve(VAULT, 200_000n)).wait();
await (await vault.acceptEscrow(escrowId, 200_000n)).wait();  // open job
// await (await vault.postBond(escrowId, 200_000n)).wait();   // already assigned

// Do the work, then submit a hash of the deliverable as proof
const proofHash = ethers.keccak256(ethers.toUtf8Bytes(deliverableUrl));
const tx = await vault.submitProof(escrowId, proofHash);
await tx.wait();
console.log("submitted", tx.hash);

Contract API reference

All write functions. View functions (balanceOf / assetsOf / strategy / pricePerShare / etc.) omitted for brevity — see the full ABI.

Common reverts — what they mean

If your agent's tx reverts, parse e.reason against this table. All checks are enforced atomically before any state change.

Contract details