Project Docs

HashSwap

HashSwap is a minimal stable swap demo built natively on Hedera using HTS tokens. Users always sign in wallet; the frontend never stores private keys.

Open App View Metrics

Problem & solution

Problem: Hedera needs simple, HTS-native liquidity rails for stable-to-stable swaps and commerce-like settlement flows (transparent reserves, low fees, fast finality).

Solution: HashSwap provides a lightweight stable AMM demo (hUSD/hEUR) with wallet-signed actions, testable liquidity, faucet onboarding, and Mirror Node-based metrics for on-chain verification.

Why Hedera

HTS-native tokens (no wrapped assets) + clear token accounting.
Low, predictable fees paid in HBAR — friendly for frequent swaps.
Fast finality and good UX for consumer/commercial flows.
Mirror Node transparency for public analytics (TVL, reserves, tx history).

What HashSwap includes

Swap: hUSD ↔ hEUR quoting + wallet-signed swap execution.
Liquidity: add liquidity via wallet-sign; UI shows your deposited amounts (not LP share).
Faucet: claim hUSD or hEUR via wallet-sign; rate-limited onboarding.
Metrics: TVL/reserves + explorer/Mirror links for on-chain proof.

Tokens (HTS)

Two demo stable tokens on Hedera testnet:

hUSD — mock USD stable token
hEUR — mock EUR stable token

Supply, seeding amounts, faucet caps, and fee parameters are configured in the backend config.

User flows

Connect wallet → shows Account ID (0.0.xxxx).
Faucet → click → sign in wallet → receive hUSD/hEUR.
Swap → enter amount → auto-estimated out → sign swap.
Liquidity → add amounts (auto ratio) → sign deposit.

Security model

Non-custodial frontend: no private keys in browser.
Wallet-sign required for any asset-moving action.
Backend relays what the user signed (submit signed bytes → schedule execute).
Optional rate limits & basic checks to reduce faucet abuse.

Milestone deliverables (for reviewers)

Testnet app: Swap + Liquidity + Faucet + Metrics (this deployment).
On-chain proof: reserves/TVL and transaction history via Mirror Node links (see Metrics).
Demo video: recorded walkthrough (Loom) showing connect → faucet → swap → liquidity.
Repository: GitHub code for frontend + backend + deployment notes.

Tip: reviewers can verify pool state quickly in Metrics using the provided Mirror Node URLs.

Roadmap

v1 (Testnet) — Completed: stable swap + faucet + liquidity + metrics.
v1.1: improve liquidity UX + clearer errors + better deposit history.
v2 (Mainnet): mainnet pools + fee model + expanded analytics dashboard.
v3 (Traction): multiple stable pools + growth dashboard + ecosystem integrations.