Project documentation
Every development document for Tukar, grouped by what it is for. These pages are rendered from the markdown files in the repository at build time, so there is one copy of each document and it is the one the code is built from.
Architecture and on-chain
How the corridor is built, what is deployed, and how each integration works.
- Project README
Tukar started in June 2026, so it is not a from-scratch build. This is what changed during Find Your Way, so judges can tell the new work from the old:
README.md
- Architecture
Tukar is a private cross-border remittance corridor. Money enters in one country, moves across the corridor with its amount and counterparties hidden on-chain in the shielded transfer leg,…
docs/ARCHITECTURE.md
- On-chain verification
How Tukar verifies a Groth16 proof inside a Soroban smart contract using Stellar's native BN254 host functions. They arrived in Protocol 25 "X-Ray" and 26 "Yardstick"; testnet has run…
docs/ONCHAIN.md
- Passkey smart wallets
Sign in to Tukar with a passkey (Face ID, Touch ID, Windows Hello) instead of a browser extension or a seed phrase. Built on passkey-kit 0.16.5 and the OpenZeppelin Stellar Relayer Channels…
docs/PASSKEY.md
- Off-ramp anchor integration
Tukar's corridor is confidential in the middle and public at the fiat edges by design. The receiving edge (USDC → local fiat in a recipient's bank/wallet/cash) is an anchor problem, not a…
docs/ANCHOR.md
- Alternatives to gated integrations
A few "deepen the ecosystem integration" opportunities normally require an external, gated resource (a Launchtube API token, a Mercury account, a WebAuthn authenticator, or a KYC'd anchor…
docs/ALTERNATIVES.md
Security and threat model
The assets, the trust boundaries, what an attacker can and cannot do, and the trusted setup.
- Threat model and monitoring plan
Status: testnet (Stellar testnet, Protocol 28 "Adapter"). Scope: the deployed testnet system (15 Soroban contracts, of which the 8-contract core corridor of pool plus 7 verifiers is what…
docs/THREAT_MODEL.md
- Security notes
This is the security spine of the project: what Tukar protects, the attacks it defends against, and how each defense is verified (unit test, on-chain error, or live browser test). Tukar is…
docs/SECURITY.md
- Trusted setup ceremony
Tukar's proving keys are Groth16 over BN254, which needs a two-phase trusted setup.
docs/CEREMONY.md
Testing and verification
The test plan, what each suite covers, and how to reproduce the deployed contract builds.
- QA and testing
A full QA pass covering repo hygiene, circuit soundness, contract unit tests, and on-chain behaviour (positive + negative) on Stellar testnet.
docs/TESTING.md
- Build attestation (SEP-0055)
Status on 2026-08-27: workflow added, not yet run. Every deployed Tukar contract on stellar.expert still reads validation: unverified, and the section "What flips a contract to Build…
docs/BUILD-ATTESTATION.md
Product, design, and roadmap
What the product is, the design system it is built from, and what has since been built.
- Product
<!-- impeccable:product-schema 1 -->
PRODUCT.md
- Design system
A remittance is a sealed parcel. Nobody on the road sees what is inside; every box carries a label the customs desk can stamp. The page is the top of a kraft corrugate box (a produced 256px…
DESIGN.md
- User guide
Tukar is a private cross-border remittance corridor on Stellar. Money enters in one country and leaves in another. The deposit and the withdrawal are public at the edges by design, but the…
docs/USER_GUIDE.md
- Testnet pilot kit
This is the runbook for putting the Tukar corridor in front of real people on Stellar testnet, watching what happens, and writing down the result honestly. It is the pilot method that…
docs/ONBOARDING.md
- User interview kit
An instrument for collecting evidence, not a record of evidence. Nothing in this file is a finding. Every example below is labelled as a format example and is invented purely to show the…
docs/USER_INTERVIEWS.md
- Roadmap and what was built
This file used to list six roadmap items as "none of it is done yet". Five of the six are now built and running on Stellar testnet. This version records what shipped, where the evidence is,…
docs/ROADMAP_IMPLEMENTATION.md
- Where Tukar sits
Stellar's privacy tier is real and getting crowded (a good sign, because that's where Stellar is investing). This is an honest map of the neighbours and where Tukar is genuinely different,…
docs/COMPETITIVE.md
SCF submission materials
The Build Award proposal, the interest form, and the questions reviewers have asked.
- SCF Build Award proposal
Tukar is a private cross-border remittance corridor on Stellar whose differentiator is compliant privacy. Someone working abroad deposits USDC, the transfer across the corridor hides the…
docs/SCF_BUILD_PROPOSAL.md
- SCF Build submission answers
Each fenced block below is the verbatim answer to the named form field. The submission is self-contained: the threat model, the monitoring signals, the competitor comparison and the…
docs/SCF_SUBMISSION.md
- SCF Build interest form answers
Answers as resubmitted on 2026-10-13 through the SCF dashboard at communityfund.stellar.org (the 2026-08-14 form was declined on 2026-08-24). The form caps Current Traction at 1000…
docs/SCF_INTEREST_FORM.md
- Judge questions and answers
Prep for the 2-minute Q&A. Written as if a judge is pushing. Panel is two investors (Spartan Group, DWF Ventures), three technical (Stellar DevRel, Noether DEX founders, Lumen Loop), and…
docs/JUDGE_QA.md
- Questions the deck does not answer
These are the gaps. The 9-slide deck and the demo video cover the problem, the moat, the market, the tech depth, and the on-chain verification. They do NOT cover team, traction, regulatory…
docs/JUDGE_QA_UNCOVERED.md
- Penjelasan lengkap (Bahasa Indonesia)
Versi belajar buat paham proyek sendiri. Istilah teknis dibiarin English karena itu yang dipakai di pitch (yang di panggung English).
docs/OVERVIEW_ID.md
- Pertanyaan juri (Bahasa Indonesia)
Persiapan untuk sesi Q&A 2 menit. Ditulis seolah-olah seorang juri sedang menekan. Panelnya dua investor (Spartan Group, DWF Ventures), tiga orang teknis (Stellar DevRel, para founder…
docs/JUDGE_QA_ID.md
- Pertanyaan tak terjawab (Bahasa Indonesia)
Ini adalah celah-celahnya. Deck 9 slide dan demo 90 detik sudah mencakup masalah, moat (keunggulan yang sulit ditiru), pasar, kedalaman teknis, dan verifikasi on-chain (langsung di ledger…
docs/JUDGE_QA_UNCOVERED_ID.md
Demo and pitch material
The recorded demo, the deck, and the scripts read over each of them.
- Demo video script
Open https://tukar-six.vercel.app, click Launch the live demo, wait for "Ready", click Use testnet key. ~300 words of voiceover ≈ 2:00 at a calm pace.
docs/DEMO_SCRIPT.md
- Demo video shot list
The shot list for the current demo video. Twenty scenes in five acts, 3 minutes 10 seconds as rendered. Nothing in it is staged: Playwright drives the deployed app, makes a real testnet…
docs/DEMO_VIDEO_V2.md
- Team presentation video
The SCF Open Track asks for "a well-put together video presentation showcasing the team". This is it, 1 minute 50 seconds, served at https://tukar-six.vercel.app/team.mp4 and embedded on…
docs/TEAM_VIDEO.md
- Narasi deck, slide per slide (Bahasa Indonesia)
Panduan baca untuk presentasi TUKARSCFDECK.pptx (21 slide, Bahasa Indonesia). Tiap slide di bawah punya empat bagian: tujuan slide itu, yang dikatakan, yang ditunjuk di layar, dan jangan…
docs/deck/NARASI_DECK.md
- Demo voiceover and subtitles
A complete, feature-by-feature walkthrough for a screen recording. You read the VO; the SUBTITLE lines double as captions. Keep each spoken line short so it fits on screen. Timings are a…
docs/DEMO_VO_SUBTITLES.md
- Live demo reading script
This is what the demo driver reads and follows on stage, click by click. It runs the cross-actor loop across the four role apps: Sender deposits real testnet USDC with a ZK compliance…
docs/LIVE_DEMO_SCRIPT.md
- Deck script
Word for word, one short block per slide. The whole deck talk (slides 1 to 7 and 9) is about 85 to 90 seconds, roughly 10 seconds a slide. Slide 8 is the demo, about 90 seconds if you run…
docs/DECK_SCRIPT.md
- Pitch preparation
Format: 3 minutes to present (pitch AND demo), then 2 minutes of Q&A. Judges penalize overruns, so rehearse the present to land at ~2:50 with a visible timer. 3 minutes is tight: the demo…
docs/PITCH_PREP.md
- Three-minute pitch script
Read this out loud like a founder on stage, not like an essay. Short sentences. Contractions. Real pauses.
docs/PITCH_SCRIPT_3MIN.md
- Skrip pitch (Bahasa Indonesia)
Referensi narasi per slide untuk deck di https://tukar-six.vercel.app/deck (11 slide; slide 10 memutar demo on-chain). Tekan F untuk fullscreen, panah kiri/kanan untuk pindah slide.
docs/PITCH_SCRIPT.md
- Narasi demo (Bahasa Indonesia)
Dipakai kalau audio video demo mati saat presentasi. Bisukan videonya, lalu baca skrip ini sambil video jalan. Setiap baris punya penanda waktu yang cocok dengan versi video sekitar 1 menit…
docs/DEMO_NARRATION.md
Diagrams and interface
The parts of the record that are not prose: the drawn architecture, captures of the shipped screens, the deck, and the deployment file every contract id is read from.
- Architecture diagram
The corridor drawn end to end: browser, pool, verifiers, anchor.
- Interface screenshots
Eight captures of the shipped apps, desktop and 390px mobile.
- Pitch deck
The deck as it is presented, in the browser.
- Deployment record
Every deployed contract id, wasm hash, and deploy transaction.
- Source repository
Contracts, circuits, the web app, and these documents.