|
| 1 | +# AgenticPay Public Roadmap |
| 2 | + |
| 3 | +AgenticPay is an AI-powered decentralized payment infrastructure built on Stellar, enabling trustless escrow and automated work verification between clients and contributors. This roadmap reflects current development priorities, upcoming features, and the long-term vision for the platform. |
| 4 | + |
| 5 | +> **Last updated:** March 2026 |
| 6 | +> **Network:** Stellar Testnet (Mainnet launch planned — see [Long-Term Goals](#long-term-goals)) |
| 7 | +
|
| 8 | +--- |
| 9 | + |
| 10 | +## Current Milestone |
| 11 | + |
| 12 | +**v0.4 — Production Hardening & Developer Experience** |
| 13 | + |
| 14 | +The team is focused on stabilizing the existing feature set and making the platform reliable enough for broader public use. Work in this milestone includes: |
| 15 | + |
| 16 | +- **Advanced invoice editing** — Full CRUD editing for generated invoices, including line items, tax fields, and custom metadata (PR #167) |
| 17 | +- **Backend environment validation** — Zod-based schema validation for all environment variables at startup, preventing misconfigured deployments from silently failing |
| 18 | +- **Transaction failure recovery** — Retry logic and user-facing error recovery flows for failed Stellar transactions, including fee-bump support |
| 19 | +- **Response caching with ETags** — Per-route TTL caching with `ETag` / `If-None-Match` support across the Express API, reducing redundant blockchain lookups |
| 20 | +- **Infrastructure as code** — Terraform modules for dev/staging/prod environments with cost tagging, auto-scaling, and automated rollback scripts |
| 21 | +- **Tiered rate limiting** — Separate limits for free, pro, and enterprise API consumers, backed by a configurable custom store |
| 22 | + |
| 23 | +--- |
| 24 | + |
| 25 | +## Upcoming Features |
| 26 | + |
| 27 | +These items are planned for the next one to two milestones. Ordering reflects rough priority, not a fixed schedule. |
| 28 | + |
| 29 | +### Payment & Escrow |
| 30 | +- **Multi-token escrow** — Support USDC and other Stellar assets (currently XLM-only) so clients and freelancers can settle in stablecoins |
| 31 | +- **Partial payment releases** — Allow milestone-based partial fund releases before full project completion, reducing lock-up risk for longer engagements |
| 32 | +- **Dispute dashboard** — A dedicated UI for tracking open disputes, viewing arbitration status, and submitting evidence |
| 33 | + |
| 34 | +### AI Verification |
| 35 | +- **Pluggable verifier backends** — Abstract the OpenAI dependency behind a provider interface so teams can use Anthropic, local models, or custom verification logic |
| 36 | +- **Structured verification reports** — Return per-criterion pass/fail breakdowns instead of a single boolean, giving both parties transparency into what was checked |
| 37 | +- **Human-in-the-loop override** — Allow clients to optionally require a human review step before AI approval triggers fund release |
| 38 | + |
| 39 | +### Developer & Platform |
| 40 | +- **Webhook notifications** — Push project lifecycle events (funded, work submitted, verified, disputed) to user-configured endpoints |
| 41 | +- **SDK / npm package** — A typed JavaScript/TypeScript client library wrapping the Soroban contract calls and REST API, making integrations easier for external developers |
| 42 | +- **Contract event indexing** — A lightweight indexer that listens to on-chain `ProjectCreated` and state-change events and exposes them via a queryable API |
| 43 | +- **Role-based access control** — Support team accounts where multiple members can manage projects under a shared organization |
| 44 | + |
| 45 | +### Observability & Quality |
| 46 | +- **Distributed tracing** — Propagate trace IDs from the frontend through the backend to Stellar Horizon calls, enabling end-to-end request tracing |
| 47 | +- **SLA alerting** — Integrate the existing SLA tracking middleware with PagerDuty or a configurable webhook so on-call engineers are notified when p99 latency exceeds thresholds |
| 48 | +- **Expanded test coverage** — Integration tests covering the full escrow lifecycle (create → fund → submit → verify → release) against a local Stellar sandbox |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +## Long-Term Goals |
| 53 | + |
| 54 | +These represent the broader vision for where AgenticPay is headed over the next several development cycles. |
| 55 | + |
| 56 | +### Stellar Mainnet Launch |
| 57 | +Move from Testnet to the Stellar public network with a formal security audit of the Soroban smart contracts. This includes a responsible disclosure policy, bug bounty program, and a staged rollout starting with a capped deployment. |
| 58 | + |
| 59 | +### Autonomous Agent-to-Agent Payments |
| 60 | +Enable AI agents to participate in the payment network without human intermediaries — an agent can create a project, fund it, submit work, and trigger payment entirely programmatically. This aligns with the broader agentic-AI ecosystem where LLM-powered tools need native payment primitives. |
| 61 | + |
| 62 | +### Cross-Chain Compatibility |
| 63 | +Extend escrow support beyond Stellar to EVM-compatible networks (using the existing Wagmi/Viem infrastructure already in the frontend) and eventually to other chains via bridges or a chain-agnostic settlement layer. |
| 64 | + |
| 65 | +### Reputation & Trust Layer |
| 66 | +Build an on-chain reputation system that aggregates a contributor's history of approvals, disputes, and resolution outcomes. Reputation scores could influence default escrow terms, dispute resolution weight, and platform fee tiers. |
| 67 | + |
| 68 | +### Decentralized Governance |
| 69 | +Transition platform parameter changes (fee structures, verifier whitelisting, dispute resolution rules) to an on-chain governance process, reducing reliance on a central admin key. |
| 70 | + |
| 71 | +### Enterprise & DAO Integrations |
| 72 | +Provide first-class support for DAOs paying contributors for bounties and grants, including multi-sig approval flows, treasury management integrations, and bulk payout tooling. |
| 73 | + |
| 74 | +--- |
| 75 | + |
| 76 | +## How to Contribute Ideas |
| 77 | + |
| 78 | +AgenticPay is built in public through the **Stellar Wave Program via Drips**, and community input directly shapes what gets built. |
| 79 | + |
| 80 | +### Submit a Feature Request |
| 81 | +Open an issue on GitHub using the **Feature Request** template. A good feature request includes: |
| 82 | +- The problem you're trying to solve (not just the solution) |
| 83 | +- Who would benefit and how often the use case arises |
| 84 | +- Any constraints or tradeoffs you've thought through |
| 85 | + |
| 86 | +### Join the Discussion |
| 87 | +Check the existing GitHub Issues and Discussions before opening something new — your idea may already have a thread. Upvoting and adding context to existing issues is often more valuable than creating duplicates. |
| 88 | + |
| 89 | +### Work on a Bounty |
| 90 | +Open tasks eligible for Stellar Wave Program bounties are labeled `bounty` in the issue tracker. Before starting, comment on the issue to claim it and avoid duplicate work. See [CONTRIBUTING.md](../CONTRIBUTING.md) for the full contribution workflow, code style guide, and PR review process. |
| 91 | + |
| 92 | +### Share Feedback on This Roadmap |
| 93 | +This document is not set in stone. If you think a priority is wrong, a use case is missing, or an item in the long-term section should be pulled forward, open an issue titled `[Roadmap Feedback]: <your topic>` and make your case. The maintainers review roadmap feedback each milestone. |
0 commit comments