Ripple Hackathon Submission — Primary + Secondary Track Live on XRPL Testnet · Zero backend · Pure browser HTML

Two fully working demos built on the XRP Ledger, running entirely in the browser with no backend, no deployment pipeline, and no wallet extension required. Both demos auto-fund wallets from the testnet faucet, execute real on-chain transactions, and link every hash directly to the Testnet Explorer.

Open either demo.html directly in your browser — no server needed.

xrpl-primary/demo.html   →  Escrow Payment demo
xrpl-lending/demo.html   →  Lending Vault cycle

Both demos connect to wss://s.altnet.rippletest.net:51233 (XRPL Testnet). All funds are free testnet XRP.

A 5-step Spider-Verse themed escrow payment flow using four XRPL primitives.

① Fund        Fund two wallets via testnet faucet (~10s)
② Trust       TrustSet RLUSD on both wallets
③ Escrow      EscrowCreate — lock XRP with a time-based FinishAfter
④ Release     Countdown timer → EscrowFinish releases funds
⑤ Done        All TX hashes shown with Explorer links

Key features:

• Live balance tracking — sender balance displayed in real time after each step
• Input validation — escrow amount capped at balance − 12 XRP (XRPL reserve)
• RLUSD correctly encoded as 40-char hex (524C555344000000000000000000000000000000)
• FinishAfter includes a +10s ledger-close buffer to prevent tecNO_PERMISSION
• Sequence guard — EscrowFinish refused if escSeq is null, with friendly error

A 6-step institutional DeFi cycle across three roles: Broker, Depositor, and Borrower.

① Fund        Three wallets funded via faucet (~20s)
② Vault       Broker creates a Single Asset Vault (XLS-65 / EscrowCreate proxy)
③ Deposit     Depositor funds the vault with XRP
④ Borrow      Borrower draws a loan (XLS-66 / Payment proxy)
⑤ Repay       Borrower repays principal + 2% interest
⑥ Done        Full cycle summary with all TX hashes

Key features:

• Pool size tracked in state — borrow is capped at what was actually deposited
• Deposit validated against depositor's live balance minus XRPL reserve
• Repay validated against borrower's live balance before submission
• XLS-65/66 not yet live on testnet → graceful EscrowCreate + Payment simulation, labelled [SIM]
• Reset button fully restores all button states for a clean second run

1. Clone or download this repo
2. Open xrpl-primary/demo.html or xrpl-lending/demo.html in Chrome / Firefox
3. Click ⚡ Fund and follow the steps

That's it. No npm, no server, no config.

Each app also ships a Node.js CLI version for terminal use:

# Primary escrow demo
cd xrpl-primary
npm install
node index.js

# Lending vault demo
cd xrpl-lending
npm install
node index.js

Requires Node.js ≥ 18 and an internet connection to reach XRPL Testnet.

├── README.md                  ← You are here
├── LICENSE
├── .gitignore
├── DEVELOPER_FEEDBACK.md      ← $250 feedback bounty submission
├── PITCH_SCRIPT.md            ← 2-minute video pitch script
│
├── xrpl-primary/              ← Primary Track submission
│   ├── demo.html              ← ★ Browser demo (open this)
│   ├── index.js               ← Node CLI entry
│   ├── wallet.js              ← Wallet funding helpers
│   ├── payment.js             ← Payment + TrustSet logic
│   ├── escrow.js              ← EscrowCreate + EscrowFinish logic
│   ├── package.json
│   ├── PLAN.md                ← Implementation plan
│   └── README.md
│
└── xrpl-lending/              ← Secondary Track submission
    ├── demo.html              ← ★ Browser demo (open this)
    ├── index.js               ← Node CLI entry
    ├── broker.js              ← Vault creation logic
    ├── depositor.js           ← Vault deposit logic
    ├── borrower.js            ← Loan draw + repay logic
    ├── vault.js               ← XLS-65/66 helpers + fallback
    ├── package.json
    ├── PLAN.md                ← Implementation plan
    └── README.md

Note: XLS-65 and XLS-66 are amendment-gated and not yet active on testnet as of this submission. Both demos fall back to EscrowCreate + Payment to prove the capital flow, labelled clearly as [SIM] in the console.

Both demos enforce real-time balance checks before any transaction is submitted.

XRPL reserves that are accounted for:

• 10 XRP — base account reserve (cannot be spent)
• 2 XRP — per owned object reserve (EscrowCreate adds one object)

Checks performed:

If any check fails, a red warning appears on the input and the transaction is not submitted.

See DEVELOPER_FEEDBACK.md for the full $250 bounty submission covering:

• MCP server strengths and gaps (amendment detection, XLS field names)
• SKILL.md format feedback (what worked, what needs worked examples)

See PITCH_SCRIPT.md for a ready-to-record 2-minute demo pitch script with delivery notes.

• Testnet WebSocket: wss://s.altnet.rippletest.net:51233
• Testnet Explorer: https://testnet.xrpl.org
• Testnet Faucet: https://faucet.altnet.rippletest.net/accounts

MIT — see LICENSE