WAP3 MVP Prototype

This repository contains a minimum viable product prototype for WAP3, a programmable and verifiable payment layer for AI agents.

The goal of this MVP is to show how an agent workflow can move from natural language intent, to a structured intent schema, to verifiable execution and programmable settlement.

The current prototype focuses on three ideas.

1. Intent driven design
2. Deterministic and auditable decision logic
3. A clear separation between intent, verification, and settlement

Future work will extend this structure with on chain settlement on Sui and verifiable proof storage on Walrus.

Repository structure

• backend/app FastAPI based service that exposes intent and settlement endpoints
• agent client script that simulates an AI agent calling the backend
• docs short notes on architecture and flows
• connectors placeholders for Sui and Walrus integration
• tests basic tests for the intent and settlement logic

MVP capabilities

The MVP provides:

• A JSON intent schema for user goal, asset symbol, amount, risk preference, and constraints
• A simple compiler that normalizes the intent into an execution plan
• A small settlement engine that simulates an escrow style transfer and returns a receipt identifier
• HTTP endpoints that are friendly to agents or other services
• A client script that walks through the full flow end to end

This is not a production system. It is a starting point that keeps the architecture clear so that real chain connectors and proof storage can be added later.

Quick start

python -m venv .venv
source .venv/bin/activate  # Windows can use .venv\Scripts\activate
pip install -r requirements.txt
uvicorn backend.app.main:app --reload

The service runs on http://127.0.0.1:8000.

In another terminal:

source .venv/bin/activate
python agent/client_example.py

Roadmap

Short term

• Tighten the intent schema and validation
• Improve the simulation of market conditions and risk controls
• Add test coverage for edge cases

Medium term

• Add Sui smart contract connectors for on chain settlement
• Integrate Walrus for proof storage and verifiable receipts
• Publish a few reference examples for popular agent frameworks

Long term

• Turn WAP3 into a reusable payment and verification layer for enterprise agent ecosystems
• Support cross chain settlement and aggregated proofs
• Provide audit friendly layers for regulated use cases