Skip to main content

Reference Projects

Two official reference projects, each a real, runnable application against the real public Ishtaran Sandbox — not a slide deck, not a mocked demo. Every claim on these pages is backed by code you can clone and run yourself.

Mercatto — Marketplace​

Alice buys from Bob through Mercatto. Ishtaran holds the payment in escrow until delivery is confirmed, then splits it between the seller and the marketplace — escrow, Settlement, and Split, with either party able to keep self-custody of their own wallet.

A full, 16-chapter walkthrough lives right here on this site: Build a Marketplace with Ishtaran. The source is also mirrored as a standalone, clonable repository: github.com/taylorjeftedasilva/ishtaran-mercatto-example.

Wallet & Payment App — Self-Custody Wallet​

A self-custody wallet and payment app: the private key stays entirely client-side, the balance shown is the wallet's own observed on-chain state (never the Ledger), and Send and Pay are kept structurally distinct throughout — a direct wallet-to-wallet transfer versus fulfilling a Payment Request through the real Settlement pipeline. The app also demonstrates app-owner-configurable monetization, deciding who absorbs the platform fee on a payment without writing any custom fee or settlement logic.

This project doesn't yet have its own chapter-by-chapter tutorial on this site — read its own developer-facing README and run it yourself directly from the repository: github.com/taylorjeftedasilva/ishtaran-wallet-example.

What both projects have in common​

  • Real code against a real, published SDK — never a hand-simplified copy of the underlying logic.
  • Run against the real public Sandbox from a clean clone, no private access needed.
  • Every real platform limitation encountered is documented in the project's own GAPS.md, never hidden or silently worked around.