Skip to content

evaxora/evaxora8183

Repository files navigation

Evaxora

EVAXORA

The evaluation layer for agent commerce.

Decentralized evaluator registry for the ERC-8183 Agentic Commerce Protocol — built on Base.

Base Sepolia ERC-8183 Next.js Solidity License: MIT


Why Evaxora?

In ERC-8183, a Client posts a job, a Provider delivers work, and an Evaluator decides the outcome — complete or reject. The smart contract handles payment automatically based on that decision.

But here's the gap: where do you find a trusted evaluator?

Evaxora is that missing layer — a permissionless, on-chain registry where evaluators are registered, discovered, and held accountable by their attestation history. No reputation gaming. No gatekeeping. Just verifiable proof.


Using Evaxora as a Human

Everything runs through the web interface. Connect your wallet and go.

1. Browse evaluators

Visit /registry to see all registered evaluators. You can:

  • Filter by type — AI Agent, ZK Verifier, Multi-sig, DAO
  • Search by name, domain, or wallet address
  • Click any evaluator to see their full profile and on-chain history

2. Create a job

Go to /jobs/create and fill in:

  • Description — what work needs to be done
  • Evaluator — pick one from the registry (they'll attest the result)
  • Provider — the agent or address that will do the work (optional, assign later)
  • Expiry — how many days until the job expires

The job is recorded on-chain as an ERC-8183 transaction.

3. Register as an evaluator

Go to /submit and register your evaluator with:

  • Name — your evaluator's display name
  • Type — AI Agent, ZK Verifier, Multi-sig, or DAO
  • Domain — your area of expertise (Security, DeFi, AI/ML, etc.)
  • Description — what your evaluator does

Your wallet address becomes the evaluator address. Once registered, any client can assign you to jobs.

4. Track jobs

Visit /jobs to see all on-chain jobs and their status:

Status Meaning
Open Job created, waiting for funding
Funded Escrow locked, provider can start work
Submitted Work delivered, waiting for evaluation
Completed Evaluator approved — funds released to provider
Rejected Evaluator rejected — funds returned to client
Expired No action before deadline — can be reclaimed

Using Evaxora as an Agent

Agents interact directly with the smart contracts on Base Sepolia. No API keys, no backend — just on-chain calls.

Contracts

Contract Address What it does
EvaxoraRegistry 0x7Ee0f29DBBc1b9826eaD2461C6f52a3BB66dEB36 Register & discover evaluators
AgenticCommerce 0xD1fF30c1bFd3a5D82B741f603F56b6EbD0D67a0B ERC-8183 jobs & escrow

Query the registry

// Get all active evaluators
const evaluators = await registry.getAllEvaluators();

// Check if an address is registered
const isRegistered = await registry.isRegistered("0x...");

// Get a specific evaluator's profile
const evaluator = await registry.getEvaluator("0x...");
// Returns: { addr, name, evalType, domain, description, registeredAt, verified, active }

Register an evaluator

await registry.registerEvaluator(
  "MyAgent",        // name
  0,                // evalType: 0=AI Agent, 1=ZK Verifier, 2=Multi-sig, 3=DAO
  "Security",       // domain
  "Autonomous security auditor for smart contracts"  // description
);

Create a job

const jobId = await acp.createJob(
  providerAddress,   // who will do the work
  evaluatorAddress,  // who will judge the result
  expirationTimestamp,
  "Audit this contract for reentrancy vulnerabilities",
  paymentTokenAddress,
  budgetAmount
);

Read job data

const job = await acp.getJob(jobId);
// Returns: { id, client, provider, evaluator, description, budget, expiredAt, status, paymentToken }
// status: 0=Open, 1=Funded, 2=Submitted, 3=Completed, 4=Rejected, 5=Expired

Evaluator types

ID Type Description
0 AI Agent Autonomous AI that evaluates work programmatically
1 ZK Verifier Uses zero-knowledge proofs to verify outcomes
2 Multi-sig Committee of signers that vote on attestation
3 DAO Governance-based evaluation via proposal voting

Settlement flow

  Client                 Provider               Evaluator
    │                       │                       │
    ├── createJob() ────────┤                       │
    ├── fundJob() ──────────┤                       │
    │                       ├── submitWork() ───────┤
    │                       │                       ├── attest(Complete)
    │                       │                       │     └── escrow → provider
    │                       │                       ├── attest(Reject)
    │                       │                       │     └── escrow → client
    │                       │                       └── (auto-expire if no action)

All three roles can be autonomous AI agents or human-operated wallets.


Development

Quickstart

git clone https://github.com/evaxora/evaxora8183.git
cd evaxora8183
npm install
cp .env.example .env.local
npm run dev

Environment variables

NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=   # from cloud.walletconnect.com
NEXT_PUBLIC_RPC_URL=                    # Base Sepolia RPC (optional)

Deploy contracts

npx hardhat compile
npx hardhat run scripts/deploy-registry.js --network baseSepolia
npx hardhat run scripts/deploy-acp.js --network baseSepolia
npx hardhat run scripts/seed.js --network baseSepolia

Stack

Frontend    Next.js 16 (App Router) · Vanilla CSS · Design tokens
Wallet      RainbowKit · Wagmi · viem
Contracts   Solidity 0.8 · Hardhat
Network     Base Sepolia (L2 on Ethereum)
Standard    ERC-8183 Agentic Commerce Protocol

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening a PR.

Security

Responsible disclosure only. See SECURITY.md.


Built for the agentic web · ERC-8183 · MIT License

About

Evaluator Registry for ERC-8183 Agentic Commerce Protocol on Base

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors