Documentation

How Auraloy works

Auraloy is a Metal-native marketplace for verifiable, paid AI work. Independent workers serve AI outputs, evaluators score quality, customers pay in stablecoins, and reward tracks real demand — not emissions. AI runs off-chain; settlement lives on Metal C-Chain.

Architecture

On-chain (Metal C-Chain)

Only value and tamper-evident facts: escrowed payments, operator bonds, output/score commitments (hashes), aggregated scores, settlements, and disputes. Never prompts, outputs, or PII.

Off-chain (coordinator + operators)

AI execution, evaluation, routing, and customer data. A coordinator orchestrates the request lifecycle and can be independently recomputed by anyone from the on-chain commitments — so it's a liveness layer, not a trusted arbiter.

Smart contracts

Metal Tahoe · 381932
ContractWhat it doesAddress
EscrowHolds a customer's stablecoin payment per request; releases it across settlement lines that must sum exactly to the escrow (conservation-checked). Only the settlement module may settle/refund.0x5f1C5a91… ↗
BondVaultCustody of operator collateral in native METAL, with a 7-day unbonding lock and slashing. Workers/evaluators bond to participate; a proven offense slashes a fraction to a beneficiary.0x94368C97… ↗
MarketSettlementThe money spine — records aggregated scores and reward distributions, and forwards conservation-checked settlement to Escrow. Coordinator-gated.0xf0d09e00… ↗
DisputesChallenges: a challenger bonds to freeze a target's collateral; an upheld challenge slashes via BondVault, a rejected one forfeits the challenger's bond.0xA8Bd33d6… ↗
CommitmentsCheap, tamper-evident log of output/score commitments (hashes). Enables commit-reveal so no worker can copy another's answer.0xffF2E360… ↗
Payment token (mXMD)Test stablecoin (mXMD, 6 decimals) standing in for XMD-equivalent settlement on testnet. Public mint on the Testnet page.0x2C7cdA2b… ↗

The single most important invariant: settlement is conservation-checked — payouts must sum exactly to the escrowed amount, so a settlement can never mint or leak value.

Request lifecycle

  1. 01Submit + escrowcustomer submits a request; payment is escrowed on-chain (only the input hash is stored, never the content).
  2. 02Routethe coordinator selects workers deterministically, weighted by reputation and price.
  3. 03Commiteach worker commits a hash of its output before any reveal, so answers can't be copied.
  4. 04Reveal + evaluateoutputs are revealed; a VRF-selected evaluator committee scores them under commit-reveal.
  5. 05Aggregatescores are combined with a stake × reputation-weighted, trimmed median + a concentration cap (anti-collusion, anti-plutocracy).
  6. 06Settleescrow is released across worker/evaluator/creator/treasury/insurance/validator lines that sum exactly to the escrow.
  7. 07Reward + reputationepoch emission (capped by real fee revenue) is distributed by composite score; reputation updates as an EMA of quality.
  8. 08Challengeanyone can dispute a score or output within the window; an upheld challenge slashes the offender.

For developers

Connect to Metal Tahoe
chainId
381932
rpc
tahoe.metalblockchain.org/ext/bc/C/rpc
explorer
tahoe.metalscan.io
currency
METAL

Standard EVM. Use Foundry / Hardhat / viem / ethers. Connect a wallet via the button top-right (MetaMask or WalletConnect — including Metallicus WebAuth). Try it on the Testnet page.

Use the AI (OpenAI-compatible)
# any OpenAI SDK — just change the base URL
base_url = "https://chat.auraloy.com/v1"
POST /v1/chat/completions { model, messages }

Responses include an x_min metering receipt (worker, tokens, XMD price). Full machine-readable spec at /llms.txt · chat llms.txt.

Source, protocol, SDKs, 29 passing contract tests, and 21 design docs live in the repository (private).