# ankieroar/ai-agent-marketplace-on-avalanche architecture

> Architecture diagram of the GitHub repository ankieroar/ai-agent-marketplace-on-avalanche, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ankieroar/ai-agent-marketplace-on-avalanche
- Repository: https://github.com/ankieroar/ai-agent-marketplace-on-avalanche

## Overview

This repository is a planned Avalanche AI marketplace with private dispute resolution; the sampled implementation is an early foundation, not the complete documented product. The intended user journey is discover and buy a curated service, execute it, then accept or dispute the result and settle escrow. The graph preserves that documented journey alongside the existing wallet, API, agent, encrypted-evidence, and ping/pong relay code. Marketplace contracts and dispute/ZK stages are documented capabilities, but their implementation was not shown; those links are therefore documented-design relationships, not evidence of a working end-to-end flow.

Main entry points: [`project/apps/api/src/server.mjs`](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/server.mjs) (Backend API), [`project/contracts/contracts`](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts) (Dispute workflow), [`project/apps/web/app/page.tsx`](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/web/app/page.tsx) (Marketplace UI), [`project/services/agents/index.mjs`](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/services/agents/index.mjs) (Dispute agents)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Marketplace UI<br/>[page.tsx]"]
  node_wallet["Wallet providers<br/>[providers.tsx]"]
end

subgraph group_service["Service and API"]
  node_registry["Curated listings"]
  node_orders["Orders and escrow"]
  node_api["Backend API<br/>[server.mjs]"]
  node_agents["Dispute agents<br/>[index.mjs]"]
  node_schema["Request schemas<br/>[index.mjs]"]
  node_evidence["Encrypted evidence<br/>[crypto.mjs]"]
  node_database[("Evidence database<br/>[db.mjs]")]
end

subgraph group_dispute["Dispute protocol"]
  node_dispute["Dispute workflow"]
  node_proof{{"Policy ZK proof"}}
end

subgraph group_chains["Cross-chain plumbing"]
  node_fuji["Fuji contracts<br/>[PingSender.sol]"]
  node_l1["Dispute L1 receiver<br/>[PongReceiver.sol]"]
  node_relayer["Relay monitor<br/>[relayer.js]"]
end

node_buyer(("Buyer"))
node_seller(("Seller"))
node_reviewer(("Reviewer"))
node_llm{{"OpenRouter API"}}

node_buyer -->|"uses"| node_web
node_seller -.->|"registers listing"| node_registry
node_web -->|"configures"| node_wallet
node_web -.->|"buys or accepts"| node_orders
node_registry -.->|"supplies listing"| node_orders
node_orders -.->|"purchase event"| node_api
node_api -->|"runs pipeline"| node_agents
node_api -->|"validates with"| node_schema
node_agents -->|"validates results"| node_schema
node_agents -->|"requests completions"| node_llm
node_api -->|"encrypts and decrypts"| node_evidence
node_api -->|"reads and writes"| node_database
node_web -.->|"opens dispute"| node_dispute
node_dispute -.->|"notifies case"| node_api
node_api -.->|"submits proof"| node_proof
node_proof -.->|"gates resolution"| node_dispute
node_reviewer -.->|"approves decision"| node_dispute
node_dispute -.->|"settles escrow"| node_orders
node_fuji -->|"sends ping"| node_l1
node_relayer -->|"polls events"| node_fuji
node_relayer -->|"delivers message"| node_l1

click node_web "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/web/app/page.tsx"
click node_wallet "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/web/app/providers.tsx"
click node_registry "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts"
click node_orders "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts"
click node_api "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/server.mjs"
click node_agents "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/services/agents/index.mjs"
click node_schema "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/packages/schema/index.mjs"
click node_evidence "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/crypto.mjs"
click node_database "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/db.mjs"
click node_dispute "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts"
click node_proof "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/circuits/policy-eligibility"
click node_fuji "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/contracts/contracts/c-chain/PingSender.sol"
click node_l1 "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/contracts/contracts/dispute-l1/PongReceiver.sol"
click node_relayer "https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/services/relayer-monitor/relayer.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_wallet,node_reviewer toneBlue
class node_registry,node_orders,node_api,node_agents,node_schema,node_evidence,node_database toneAmber
class node_dispute,node_proof,node_llm toneMint
class node_fuji,node_l1,node_relayer toneRose
class node_buyer,node_seller toneIndigo
```

## Components

### User experience

- [Marketplace UI](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/web/app/page.tsx): `project/apps/web/app/page.tsx`
- [Wallet providers](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/web/app/providers.tsx): `project/apps/web/app/providers.tsx`

### Service and API

- [Curated listings](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts): `project/contracts/contracts`
- [Orders and escrow](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts): `project/contracts/contracts`
- [Backend API](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/server.mjs): `project/apps/api/src/server.mjs`
- [Dispute agents](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/services/agents/index.mjs): `project/services/agents/index.mjs`
- [Request schemas](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/packages/schema/index.mjs): `project/packages/schema/index.mjs`
- [Encrypted evidence](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/crypto.mjs): `project/apps/api/src/crypto.mjs`
- [Evidence database](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/apps/api/src/db.mjs): `project/apps/api/src/db.mjs`

### Dispute protocol

- [Dispute workflow](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/contracts/contracts): `project/contracts/contracts`
- [Policy ZK proof](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/tree/main/project/circuits/policy-eligibility): `project/circuits/policy-eligibility`

### Cross-chain plumbing

- [Fuji contracts](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/contracts/contracts/c-chain/PingSender.sol): `project/contracts/contracts/c-chain/PingSender.sol`
- [Dispute L1 receiver](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/contracts/contracts/dispute-l1/PongReceiver.sol): `project/contracts/contracts/dispute-l1/PongReceiver.sol`
- [Relay monitor](https://github.com/ankieroar/ai-agent-marketplace-on-avalanche/blob/main/project/services/relayer-monitor/relayer.js): `project/services/relayer-monitor/relayer.js`

### Other components

- **Buyer**
- **Seller**
- **Reviewer**
- **OpenRouter API**

## Connections

- Buyer → Marketplace UI: uses
- Seller → Curated listings: registers listing
- Marketplace UI → Wallet providers: configures
- Marketplace UI → Orders and escrow: buys or accepts
- Curated listings → Orders and escrow: supplies listing
- Orders and escrow → Backend API: purchase event
- Backend API → Dispute agents: runs pipeline (evidence: `project/apps/api/src/server.mjs`)
- Backend API → Request schemas: validates with (evidence: `project/apps/api/src/server.mjs`)
- Dispute agents → Request schemas: validates results (evidence: `project/services/agents/index.mjs`)
- Dispute agents → OpenRouter API: requests completions (evidence: `project/services/agents/index.mjs`)
- Backend API → Encrypted evidence: encrypts and decrypts (evidence: `project/apps/api/src/server.mjs`)
- Backend API → Evidence database: reads and writes (evidence: `project/apps/api/src/server.mjs`)
- Marketplace UI → Dispute workflow: opens dispute
- Dispute workflow → Backend API: notifies case
- Backend API → Policy ZK proof: submits proof
- Policy ZK proof → Dispute workflow: gates resolution
- Reviewer → Dispute workflow: approves decision
- Dispute workflow → Orders and escrow: settles escrow
- Fuji contracts → Dispute L1 receiver: sends ping
- Relay monitor → Fuji contracts: polls events (evidence: `project/services/relayer-monitor/relayer.js`)
- Relay monitor → Dispute L1 receiver: delivers message (evidence: `project/services/relayer-monitor/relayer.js`)
