Sharpy is an open-source 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.

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 wallet
const publicKey = await connectWallet();

// Initialize client (testnet pre-configured)
const client = new SharpyClient(NETWORKS.testnet);

// Create a split invoice — 60/40 between two recipients
const { invoiceId } = await client.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 invoice
await client.pay(publicKey, invoiceId, parseAmount("100"));

// Check status
const invoice = await client.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