# munnavuyyuru/agentmarketplace-smart-contract architecture

> Architecture diagram of the GitHub repository munnavuyyuru/agentmarketplace-smart-contract, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-06-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/munnavuyyuru/agentmarketplace-smart-contract
- Repository: https://github.com/munnavuyyuru/agentmarketplace-smart-contract

## Overview

1. **Repository shape**
   - This is a three-part monorepo: a **Solidity/Hardhat contract layer**, a **TypeScript backend API**, and a **React/Vite frontend**.
   - The central product appears to be an **agent/service marketplace** with on-chain transactions plus off-chain metadata, ratings, reputation, and deliverables.

2. **On-chain subsystem**
   - The smart contract area is anchored by `contracts/` and the compiled artifact `backend/src/blockchain/AgentMarketplace.json`.
   - `hardhat.config.ts` and `scripts/deploy.ts` indicate Hardhat is used for compiling and deploying the marketplace contract.
   - `deployment/fuji.json` suggests at least one target network is **Avalanche Fuji**, so chain deployment is part of the architecture, not just local testing.

3. **Backend application boundary**
   - The backend is a **Node.js + TypeScript API** under `backend/src`.
   - `app.ts` likely assembles middleware and routes; `server.ts` is the process entrypoint.
   - Route modules separate the domain into `agent`, `service`, `rating`, `reputation`, `dashboard`, `payment`, and `agentProfile`, which is a strong hint that the backend is the orchestration layer for marketplace operations.

4. **Backend controller structure**
   - Controllers under `backend/src/controllers` map HTTP requests to domain actions.
   - `agent.controller.ts`, `service.controller.ts`, `payment.controller.ts`, `rating.controller.ts`, `reputation.controller.ts`, and `dashboard.controller.ts` imply the backend exposes CRUD-like and workflow endpoints for marketplace entities and user-facing dashboards.
   - `paid.routes.ts` stands out as a protected API surface for paid operations.

5. **Payment and access-control flow**
   - `backend/src/middleware/x402.middleware.ts` indicates the backend enforces a payment-related gate, likely before allowing access to certain paid routes.
   - The presence of `payment.controller.ts` and `paid.routes.ts` suggests a request flow where a client calls the API, payment or entitlement is checked, and only then the protected service is executed.

6. **Blockchain integration layer**
   - `backend/src/blockchain/contract.ts` is the backend’s abstraction for interacting with the smart contract.
   - `execution.service.ts` and `serviceInvocation.service.ts` suggest the backend can both **submit on-chain transactions** and **invoke service logic** tied to marketplace execution.
   - `eventSync.service.ts` and `backfill.service.ts` indicate the backend also **consumes chain events** and can replay historical events to reconstruct or repair off-chain state.

7. **Off-chain state and persistence**
   - `backend/src/config/supabase.ts` shows the backend uses **Supabase** for persistence or auxiliary data storage.
   - `env.ts` centralizes runtime configuration, so the backend likely depends on environment-driven secrets for both blockchain and database connectivity.
   - This creates a split architecture: **chain for trust/minimal settlement**, **Supabase for indexed app data, profiles, ratings, and dashboards**.

8. **Frontend application boundary**
   - The frontend is a **React + TypeScript + Vite** app in `frontend/src`.
   - `main.tsx`, `App.tsx`, and `layouts/HomeLayout.tsx` establish the UI shell, while pages handle user journeys such as `HomePage`, `ServicePage`, `AgentProfilePage`, `CreateServicePage`, `PurchasesPage`, and `DeliverablePage`.
   - `services/api.ts` is the frontend’s API boundary to the backend, so the UI does not talk to blockchain directly in the visible structure.

9. **Frontend component model**
   - Shared UI components include `ServiceCard`, `ReviewCard`, `ReputationCard`, `DynamicForm`, and `ResponseRenderer`.
   - That suggests the frontend is designed around marketplace browsing plus interactive submission of service parameters and display of structured outputs or deliverables.
   - `Navbar.tsx` and the CSS files indicate a fairly standard client-side SPA layout rather than server-rendered pages.

10. **Domain model implied by the UI and API**
   - The top-level concepts are **agents**, **services**, **profiles**, **ratings/reviews**, **reputation**, **payments**, and **deliverables**.
   - The architecture likely supports a lifecycle of: create agent/service → publish to marketplace → pay for access or purchase → execute/invoke service → receive deliverable → rate/repute the provider.
   - `dashboard` suggests aggregated state across these entities for a user or operator view.

11. **Operational scripts and developer workflow**
   - Root `scripts/` includes `deploy.ts`, `set-backend.ts`, `register-buyer.ts`, `test-agent.ts`, `test-service.ts`, and `check-backend.ts`.
   - These scripts imply operational tasks for wiring the backend to contract addresses, registering actors, and validating service/agent behavior across the chain/backend boundary.
   - `backend/src/test-x402.ts` also hints at direct testing of the payment gate or paid-route mechanism.

12. **Most important architectural boundary**
   - The key boundary in this repository is between **trusted on-chain contract state** and **off-chain application services**.
   - The backend bridges that gap by syncing chain events, invoking contract methods, enforcing paid access, and storing extra metadata in Supabase.
   - The frontend is purely a consumer of the backend API and is responsible for presenting marketplace state and initiating user actions.

13. **How to draw the diagram**
   - Show three major tiers: **frontend SPA**, **backend API/orchestration**, and **blockchain + deployment artifacts**.
   - Add Supabase as a separate persistence dependency off the backend.
   - Highlight event flow from chain to backend sync services, and request flow from frontend to backend routes, with paid endpoints guarded by x402 middleware.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/services/api.ts) (API client), [`frontend/src/layouts/HomeLayout.tsx`](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/layouts/HomeLayout.tsx) (Home layout), [`backend/src/blockchain/AgentMarketplace.json`](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/blockchain/AgentMarketplace.json) (Marketplace contract), [`backend/src/routes/service.routes.ts`](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/routes/service.routes.ts) (Route layer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend SPA"]
  node_frontend_app["App shell<br/>React entry<br/>[main.tsx]"]
  node_frontend_layout["Home layout<br/>UI layout<br/>[HomeLayout.tsx]"]
  node_frontend_home["Home page<br/>Marketplace page<br/>[HomePage.tsx]"]
  node_frontend_service["Service page<br/>Marketplace page<br/>[ServicePage.tsx]"]
  node_frontend_agent_profile["Agent profile<br/>Profile page"]
  node_frontend_create_service["Create service<br/>Submission page"]
  node_frontend_purchases["Purchases<br/>Account page<br/>[PurchasesPage.tsx]"]
  node_frontend_deliverable["Deliverable<br/>Result page"]
  node_frontend_api["API client<br/>HTTP client<br/>[api.ts]"]
end

subgraph group_backend["Backend API"]
  node_backend_server["Server entry<br/>Node entry<br/>[server.ts]"]
  node_backend_app["App assembly<br/>Express app<br/>[app.ts]"]
  node_backend_routes["Route layer<br/>HTTP routes<br/>[service.routes.ts]"]
  node_backend_controllers["Controllers"]
  node_backend_paid["Paid access<br/>Payment gate<br/>[paid.routes.ts]"]
  node_backend_x402["x402 guard<br/>Middleware<br/>[x402.middleware.ts]"]
  node_backend_contract["Contract bridge<br/>Chain adapter<br/>[contract.ts]"]
  node_backend_sync["Event sync<br/>Chain sync"]
  node_backend_backfill["Backfill<br/>Replay sync"]
  node_backend_exec["Execution<br/>Marketplace runtime"]
  node_backend_invoke["Service invoke<br/>Invocation service"]
  node_backend_supabase[("Supabase<br/>Persistence<br/>[supabase.ts]")]
end

subgraph group_chain["Chain Layer"]
  node_chain_contract{{"Marketplace contract<br/>Solidity contract"}}
  node_chain_deploy["Fuji deploy<br/>Network config<br/>[fuji.json]"]
end

subgraph group_ops["Ops Scripts"]
  node_ops_deploy["Deploy script<br/>Hardhat script<br/>[deploy.ts]"]
  node_ops_backend["Set backend<br/>Ops script<br/>[set-backend.ts]"]
  node_ops_register["Register buyer<br/>Ops script<br/>[register-buyer.ts]"]
end

node_frontend_app -->|"renders"| node_frontend_layout
node_frontend_layout -->|"navigates to"| node_frontend_home
node_frontend_layout -->|"navigates to"| node_frontend_service
node_frontend_layout -->|"navigates to"| node_frontend_agent_profile
node_frontend_layout -->|"navigates to"| node_frontend_create_service
node_frontend_layout -->|"navigates to"| node_frontend_purchases
node_frontend_layout -->|"navigates to"| node_frontend_deliverable
node_frontend_home -->|"loads data"| node_frontend_api
node_frontend_service -->|"loads data"| node_frontend_api
node_frontend_agent_profile -->|"loads data"| node_frontend_api
node_frontend_create_service -->|"submits"| node_frontend_api
node_frontend_purchases -->|"loads data"| node_frontend_api
node_frontend_deliverable -->|"loads data"| node_frontend_api
node_backend_server -->|"starts"| node_backend_app
node_backend_app -->|"mounts"| node_backend_routes
node_backend_routes -->|"dispatches to"| node_backend_controllers
node_backend_routes -->|"includes"| node_backend_paid
node_backend_paid -->|"guards with"| node_backend_x402
node_backend_controllers -->|"uses"| node_backend_contract
node_backend_controllers -->|"stores/reads"| node_backend_supabase
node_backend_contract -->|"targets"| node_chain_contract
node_backend_sync -->|"writes"| node_backend_supabase
node_backend_backfill -.->|"repairs"| node_backend_sync
node_backend_exec -->|"submits"| node_backend_contract
node_backend_exec -->|"orchestrates"| node_backend_invoke
node_backend_invoke -->|"reads/writes"| node_backend_supabase
node_chain_deploy -->|"deploys"| node_chain_contract
node_ops_deploy -->|"builds/deploys"| node_chain_contract
node_ops_backend -->|"configures"| node_backend_contract
node_ops_register -.->|"prepares"| node_backend_paid
node_frontend_api -->|"calls"| node_backend_routes
node_frontend_api -->|"accesses"| node_backend_paid
node_backend_sync -->|"listens to"| node_chain_contract
node_backend_backfill -->|"replays"| node_chain_contract

click node_frontend_app "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/main.tsx"
click node_frontend_layout "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/layouts/HomeLayout.tsx"
click node_frontend_home "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/HomePage.tsx"
click node_frontend_service "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/ServicePage.tsx"
click node_frontend_agent_profile "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/AgentProfilePage.tsx"
click node_frontend_create_service "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/CreateServicePage.tsx"
click node_frontend_purchases "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/PurchasesPage.tsx"
click node_frontend_deliverable "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/DeliverablePage.tsx"
click node_frontend_api "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/services/api.ts"
click node_backend_server "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/server.ts"
click node_backend_app "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/app.ts"
click node_backend_routes "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/routes/service.routes.ts"
click node_backend_controllers "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/controllers/service.controller.ts"
click node_backend_paid "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/routes/paid.routes.ts"
click node_backend_x402 "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/middleware/x402.middleware.ts"
click node_backend_contract "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/blockchain/contract.ts"
click node_backend_sync "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/eventSync.service.ts"
click node_backend_backfill "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/backfill.service.ts"
click node_backend_exec "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/execution.service.ts"
click node_backend_invoke "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/serviceInvocation.service.ts"
click node_backend_supabase "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/config/supabase.ts"
click node_chain_contract "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/blockchain/AgentMarketplace.json"
click node_chain_deploy "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/deployment/fuji.json"
click node_ops_deploy "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/deploy.ts"
click node_ops_backend "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/set-backend.ts"
click node_ops_register "https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/register-buyer.ts"

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_frontend_app,node_frontend_layout,node_frontend_home,node_frontend_service,node_frontend_agent_profile,node_frontend_create_service,node_frontend_purchases,node_frontend_deliverable,node_frontend_api toneBlue
class node_backend_server,node_backend_app,node_backend_routes,node_backend_controllers,node_backend_paid,node_backend_x402,node_backend_contract,node_backend_sync,node_backend_backfill,node_backend_exec,node_backend_invoke,node_backend_supabase toneAmber
class node_chain_contract,node_chain_deploy toneMint
class node_ops_deploy,node_ops_backend,node_ops_register toneRose
```

## Components

### Frontend SPA

React/Vite client for browsing agents, services, purchases, and deliverables.

- [App shell](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/main.tsx): React entry · Bootstraps the client application and global UI shell. · `frontend/src/main.tsx`
- [Home layout](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/layouts/HomeLayout.tsx): UI layout · Provides the main page structure and navigation chrome. · `frontend/src/layouts/HomeLayout.tsx`
- [Home page](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/HomePage.tsx): Marketplace page · Landing and discovery view for the marketplace. · `frontend/src/pages/HomePage.tsx`
- [Service page](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/ServicePage.tsx): Marketplace page · Service browsing and service detail experience. · `frontend/src/pages/ServicePage.tsx`
- [Agent profile](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/AgentProfilePage.tsx): Profile page · Shows an agent's profile, reputation, and related marketplace data. · `frontend/src/pages/AgentProfilePage.tsx`
- [Create service](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/CreateServicePage.tsx): Submission page · UI for publishing or editing marketplace services. · `frontend/src/pages/CreateServicePage.tsx`
- [Purchases](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/PurchasesPage.tsx): Account page · User view for purchased items and transaction history. · `frontend/src/pages/PurchasesPage.tsx`
- [Deliverable](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/pages/DeliverablePage.tsx): Result page · Displays service output or produced deliverables. · `frontend/src/pages/DeliverablePage.tsx`
- [API client](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/frontend/src/services/api.ts): HTTP client · Frontend boundary to the backend API. · `frontend/src/services/api.ts`

### Backend API

TypeScript orchestration layer for marketplace operations and paid access.

- [Server entry](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/server.ts): Node entry · Starts the backend process. · `backend/src/server.ts`
- [App assembly](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/app.ts): Express app · Composes middleware, routes, and runtime wiring. · `backend/src/app.ts`
- [Route layer](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/routes/service.routes.ts): HTTP routes · Domain route modules for marketplace operations. · `backend/src/routes/service.routes.ts`
- [Controllers](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/controllers/service.controller.ts): API controllers · HTTP-to-domain adapters for agents, services, ratings, reputation, payments, and dashboard views. · `backend/src/controllers/service.controller.ts`
- [Paid access](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/routes/paid.routes.ts): Payment gate · Protected route surface for entitlement-gated operations. · `backend/src/routes/paid.routes.ts`
- [x402 guard](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/middleware/x402.middleware.ts): Middleware · Enforces payment-related access control on protected requests. · `backend/src/middleware/x402.middleware.ts`
- [Contract bridge](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/blockchain/contract.ts): Chain adapter · Backend abstraction for interacting with the marketplace contract. · `backend/src/blockchain/contract.ts`
- [Event sync](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/eventSync.service.ts): Chain sync · Consumes chain events to update off-chain state. · `backend/src/services/eventSync.service.ts`
- [Backfill](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/backfill.service.ts): Replay sync · Replays historical events to repair or reconstruct state. · `backend/src/services/backfill.service.ts`
- [Execution](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/execution.service.ts): Marketplace runtime · Coordinates service execution and on-chain or off-chain work. · `backend/src/services/execution.service.ts`
- [Service invoke](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/services/serviceInvocation.service.ts): Invocation service · Triggers service logic tied to marketplace requests. · `backend/src/services/serviceInvocation.service.ts`
- [Supabase](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/config/supabase.ts): Persistence · Off-chain storage for indexed marketplace data and metadata. · `backend/src/config/supabase.ts`

### Chain Layer

Smart contracts, compiled artifacts, and deployment targets.

- [Marketplace contract](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/backend/src/blockchain/AgentMarketplace.json): Solidity contract · Compiled on-chain marketplace artifact used by the backend. · `backend/src/blockchain/AgentMarketplace.json`
- [Fuji deploy](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/deployment/fuji.json): Network config · Deployment target configuration for Avalanche Fuji. · `deployment/fuji.json`

### Ops Scripts

Developer and deployment workflows that connect backend and chain.

- [Deploy script](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/deploy.ts): Hardhat script · Deploys the marketplace contract. · `scripts/deploy.ts`
- [Set backend](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/set-backend.ts): Ops script · Wires backend configuration to deployed chain addresses. · `scripts/set-backend.ts`
- [Register buyer](https://github.com/munnavuyyuru/agentmarketplace-smart-contract/blob/main/scripts/register-buyer.ts): Ops script · Registers buyer-side actors for marketplace flows. · `scripts/register-buyer.ts`

## Connections

- App shell → Home layout: renders · The app shell mounts the primary layout and navigation.
- Home layout → Home page: navigates to · Home layout routes users into the marketplace landing page.
- Home layout → Service page: navigates to · Layout hosts service discovery and detail views.
- Home layout → Agent profile: navigates to · Layout exposes agent profile pages.
- Home layout → Create service: navigates to · Layout provides access to publishing flows.
- Home layout → Purchases: navigates to · Layout exposes purchase history and account views.
- Home layout → Deliverable: navigates to · Layout leads to deliverable/result views.
- Home page → API client: loads data · Home page fetches marketplace state through the API client.
- Service page → API client: loads data · Service pages use the backend API for service details and actions.
- Agent profile → API client: loads data · Profile pages request agent metadata and reputation data.
- Create service → API client: submits · Create-service flow sends marketplace mutations to the backend.
- Purchases → API client: loads data · Purchases view reads user-specific marketplace state.
- Deliverable → API client: loads data · Deliverable page fetches produced outputs from the backend.
- Server entry → App assembly: starts · Server entry initializes the application assembly.
- App assembly → Route layer: mounts · App assembly registers domain route modules.
- Route layer → Controllers: dispatches to · Routes forward requests to controller handlers.
- Route layer → Paid access: includes · Route set includes protected paid-operation endpoints.
- Paid access → x402 guard: guards with · Paid routes are protected by payment middleware.
- Controllers → Contract bridge: uses · Controllers call into the blockchain adapter when contract state is involved.
- Controllers → Supabase: stores/reads · Controllers and services persist off-chain marketplace data in Supabase.
- Contract bridge → Marketplace contract: targets · Backend adapter speaks to the marketplace contract artifact.
- Event sync → Supabase: writes · Event sync updates indexed off-chain state.
- Backfill → Event sync: repairs · Backfill reuses sync logic to replay historical chain activity.
- Execution → Contract bridge: submits · Execution layer submits contract interactions.
- Execution → Service invoke: orchestrates · Execution coordinates service invocation flows.
- Service invoke → Supabase: reads/writes · Invocation services use persistent metadata and outputs.
- Fuji deploy → Marketplace contract: deploys · Deployment configuration targets the compiled marketplace contract.
- Deploy script → Marketplace contract: builds/deploys · Deploy script compiles and deploys the contract.
- Set backend → Contract bridge: configures · Operational script connects the backend to the deployed contract.
- Register buyer → Paid access: prepares · Buyer registration supports paid access and purchase flows.
- API client → Route layer: calls · The client talks to backend route endpoints over HTTP.
- API client → Paid access: accesses · Paid client actions reach protected backend endpoints.
- Event sync → Marketplace contract: listens to · Event sync consumes chain activity from the marketplace contract.
- Backfill → Marketplace contract: replays · Backfill reconstructs state from historical contract events.
