Sharpy is a payment splitting protocol built on Stellar Soroban. It enables creators to issue on-chain invoices that automatically distribute funds to multiple recipients according to configurable rules — with recurring schedules, escrow protection, agentic payment support, and a full TypeScript SDK.

See Sharpy in action with real on-chain transactions:

• Create Invoice #3 — invoice creation
• Batch Creation — Multiple invoices in one transaction
• Multi-recipient Split — Payment split to multiple addresses
• Escrow Protection — Invoice with time-locked escrow
• Recurring Billing — Subscription invoice setup

Test Account: GD4Q2BH6...RS63

graph TD
User["User / Browser"]
Agent["AI Agent / HTTP Client"]
Freighter["Freighter Wallet"]
App["sharpy-app\nNext.js 14 · Vercel"]
SDK["@stellar-sharpy/sdk\nTypeScript SDK"]
X402["x402 Protocol\nHTTP 402 Payments"]
RPC["Soroban RPC\nstellar-sdk 16.0.1"]
Contract["Sharpy Contract\nSoroban · Protocol 27"]
Stellar["Stellar Network"]
Horizon["Horizon API"]
User -->|"connects wallet"| Freighter
User -->|"interacts"| App
Agent -->|"GET /api/x402/[id]"| X402
App -->|"calls methods"| SDK
X402 -->|"settles payment"| SDK
Freighter -->|"signs auth entry"| SDK
SDK -->|"simulate + submit"| RPC
RPC -->|"executes"| Contract
Contract -->|"state + events"| Stellar
Stellar -->|"event polling"| Horizon
Horizon -->|"invoice history"| App

• Multi-recipient invoices — split funds to any number of recipients in one transaction
• Batch creation — create up to 10 invoices in a single transaction
• Recurring/subscription invoices — auto-generate the next invoice on release
• Cancel & refund — creator can cancel and refund all payers at any time

• Pay — single payment toward an invoice
• Pool pay — pay multiple invoices in one call
• Multi-token support — USDC, XLM, AQUA, yXLM per recipient
• x402 agentic payments — AI agents and HTTP clients pay invoices via the HTTP 402 protocol

• Escrow protection — hold funds with configurable release delay
• Escrow dispute mechanism — optional arbitrator can intervene before release
• Audit log — full on-chain audit trail per invoice
• Admin circuit breaker — pause/unpause contract

• Public shareable /pay/[id] page — no login required to view
• Dashboard with search and filter
• QR code for invoice payment links
• Copy-to-clipboard for invoice URLs
• Transaction confirmation step indicators
• Dark/light mode with system preference detection
• Public on-chain verification page (/verify/[id]) with fingerprint display

npm install @stellar-sharpy/sdk

import{SharpyClient,connectWallet,parseAmount,deadlineFromDays,NETWORKS}from"@stellar-sharpy/sdk";// Connect Freighter walletconstpublicKey=awaitconnectWallet();// Initialize client (testnet pre-configured)constclient=newSharpyClient(NETWORKS.testnet);// Create a split invoice — 60/40 between two recipientsconst{ invoiceId }=awaitclient.createInvoice({creator: publicKey,recipients: [{address: "GABC...RECIPIENT1",amount: parseAmount("60")},{address: "GDEF...RECIPIENT2",amount: parseAmount("40")},],token: NETWORKS.testnet.contractId,deadline: deadlineFromDays(7),});// Pay the invoiceawaitclient.pay(publicKey,invoiceId,parseAmount("100"));// Check statusconstinvoice=awaitclient.getInvoice(invoiceId);console.log(invoice.status);// "Released"

# Any HTTP client or AI agent can pay an invoice:
curl -i https://sharpy-sigma.vercel.app/api/x402/1
# → 402 Payment Required with payment requirements# After signing auth entry:
curl -X POST https://sharpy-sigma.vercel.app/api/x402/1 \
-H "X-Payment: <signed-payload>"# → 200 OK with receipt

We welcome contributions across all three repositories. See each repo's CONTRIBUTING.md for setup instructions.

• Contract contributing guide
• SDK contributing guide
• App contributing guide

Please read our Code of Conduct before contributing.

To report a vulnerability, please use the GitHub Security Advisory — do not open a public issue.

MIT License — see LICENSE

Built on Stellar · Protocol 27 · Soroban