Overview
Palm Rail is a browser settlement console backed by a Solana program. It is built for service work where payment needs funded commitment, delivery evidence, milestone release, and a dispute path.
Palm Rail turns compliant stablecoin capital into milestone-based service settlement.
The product combines PUSD funding, delivery evidence, review windows, deterministic dispute outcomes, and Solana program custody into one commercial workflow for cross-border services.
Protocol
The program uses a deal PDA, milestone PDAs, and a program-owned PUSD vault ATA. Milestone state drives release, revision, dispute, refund, and close behavior.
1Create scoped deal2Fund PUSD vault3Provider accepts4Submit delivery5Review or dispute6Release or refund
Demo Guide
The demo uses three browser wallets: client, provider, and arbiter. The current devnet mode uses a Token-2022 dPUSD fixture because Palm USD does not publish a Solana devnet faucet.
- Client creates a deal with terms and percentage milestones.
- Client funds one PUSD vault for the full agreement.
- Provider imports the deal, accepts funded terms, and submits evidence.
- Client approves, requests revision, or opens a dispute.
- Arbiter marks disputed work valid or invalid, then settlement follows program rules.
PUSD
PUSD's institutional and Shariah-aligned stablecoin posture is most useful when paired with structured settlement: funded work, evidence, review, and deterministic outcomes.
Torque
Palm Rail can emit useful growth signals: funded rails, submitted milestones, released milestones, dispute-free completions, and responsive arbiter resolutions.
Developer Setup
Configure devnet env vars, deploy the program, mint the dPUSD fixture, fund demo wallets, and run LiteSVM tests before recording or judging.
Settlement State Map
The demo should make these state changes visible instead of hiding them behind token transfers.
Funded
Accepted
Submitted
Review / Dispute
Released / Refunded
Technology Stack
The project is intentionally low-level on-chain, with a focused browser console for the demo flow.
Program
Pinocchio SBF program with deal, milestone, escrow, and vault PDAs.
Token
Token-2022 PUSD-compatible mint with program-owned vault custody.
Client
Next.js, React, TypeScript, lucide-react, and Wallet Standard.
Solana
@solana/kit for RPC, addresses, transactions, and instructions.
RPC
Next.js server route proxies Helius so API keys stay server-side.
Tests
LiteSVM integration tests plus build, lint, and devnet scripts.