π§ Produkto at Teknolohiya
Ang tumatakbo ang nagpapatunay ng lahat.
Karamihan sa mga token whitepaper ay naglalarawan ng software na hindi pa umiiral. Ang kabanatang ito ay naglalarawan ng software na maida-download mo ngayon. Tatlong native iOS app ang inilabas na at live sa App Store, ang web platform ay nasa production, at ang mga Solana token service ay nagmi-mint na ng tunay na NFT at nagve-verify ng tunay na bayad sa mainnet. Ang dalawang smart contract na mamamahala sa pangmatagalang ekonomiya ng token ay code-complete at dumadaan sa isang staged audit β at iyan mismo ang sinasabi namin, hindi hihigit.
Ang suite sa isang sulyapβ
Bawat client β iOS man o web β ay nakikipag-usap sa iisang Django backend, at tanging ang backend ang nakikipag-usap sa Solana. Hindi kailanman direktang hinahawakan ng mga app ang chain: ang panuntunan ay laging app β Django β Solana.
β©οΈ Matsuri β ang consumer appβ
Ang pangunahing app para sa mga bisita at residente: booking, mga bayad, pamimili, crowdfunding, mga live stream, mining, at isang buong offline na disaster lifeline β sa iisang lugar, magiliw sa guest mode.
Buksan ang Matsuri sa App Store β
Ang app ay nakaayos sa limang tab β Events, Shop, Restaurants, Crowdfunding, MyPage β na ang mga live stream, paghahanap, wallet, mga NFT, at disaster hub ay maaabot mula saanman. Bawat bahagi ay may sariling kabanata; ang talahanayang ito ay mapa lamang.
| Bahagi | Sa isang linya |
|---|---|
| Mga event at karanasan | Mag-book ng mga tour, event, meetup, at klase; mga QR ticket at staff check-in β Mga Karanasan |
| Mga restaurant | Pagtuklas na may mga filter sa pangangailangan sa pagkain at tunay na table-booking engine β Mga Restaurant |
| Shop | Marketplace ng mga KYC-verified na seller na may mga escrow order at NFT product β Shop |
| Crowdfunding | Mga All-or-Nothing campaign na may tiered na MTC cashback β Crowdfunding |
| Live | Mga stream na may chat, mga drop, at tipping sa limang rail β Live |
| Mining, wallet at mga NFT | εζγγ€γγ³γ° (sanpai mining β pagmimina sa pagdalaw sa dambana), AR omikuji, MTC wallet, NFT gallery β Mining at Pagkita |
| Disaster Lifeline | Mga offline na mapa ng shelter, mesh messaging, SOS beacon β Disaster Lifeline |
| Mga bayad | Stripe (mga card, Apple Pay), Solana Pay / Phantom, MTC balance β laging muling kinukuwenta server-side ang mga presyo |
Lampas sa mga feature, buong-buo ang pagyakap ng app sa iOS platform: mga home-screen widget, Siri App Intents, Spotlight indexing, Live Activities para sa mga order, pledge, at live stream, at mga push notification na naka-localize server-side bawat user.
Ang Disaster Lifeline sa ilalim ng hoodβ
Sinasaklaw ng kabanatang Disaster Lifeline kung ano ang ginagawa nito; narito kung bakit ito gumagana kapag bumagsak ang lahat ng iba. Ang design constraint ay malupit at simple: bawat lifeline tool ay kailangang gumana nang buong offline at nang walang login.
Ang pambansang dataset ng mga evacuation shelter ay kasama mismo sa app binary β ang mapa ng shelter, listahan ng distansiya, at great-circle na Shelter Compass ay nangangailangan ng zero network. Ang mga gabay sa kaligtasan sa 5 wika ay naka-bundle sa parehong paraan.
Kapag namatay ang mga cell network, ang mga telepono ang nagiging network: isang offline na peer-to-peer mesh bulletin board ang nagre-relay ng mga post mula device patungong device na may multi-hop relay, at bawat mensahe ay cryptographically signed ng pinagmulang device nito β kaya ang isang post na naglakbay ng limang hop ay hindi mapepeke sa daan.
Isang DisasterWatchdog service ang nagpo-poll sa mga pampublikong feed ng JMA (Japan Meteorological Agency β ahensiya ng panahon ng Japan) sa paglulunsad at sa foreground; isang malaking pangyayari ay awtomatikong naglalabas ng full-screen na Disaster Hub β para sa mga guest at naka-log-in na user.
Ang "Ligtas ako" ay lumalabas sa alinmang channel na nakaligtas: mesh, SMS, ang system share sheet, o web171 β ang opisyal na disaster message board ng Japan.
π‘οΈ GCF Admin β ang operator appβ
Ang operations app para sa mga miyembro at staff ng GCF (Global Community Friends): lahat ng kaya ng web admin portal (gcf.works), sa isang telepono.
Buksan ang GCF sa App Store β
| Bahagi | Sa isang linya |
|---|---|
| Dashboard | Mga KPI card, mga chart ng kita, mga quick action |
| Mga miyembro | Listahan ng miyembro, detalye, at pamamahala ng tier β GCF |
| Kita | Pagsubaybay sa komisyon at pamamahala ng payout |
| Nilalaman | Lumikha at maglathala ng mga event, artikulo, podcast, at video |
| Mga guide slot | Ilathala at bantayan ang guide marketplace β Mga Karanasan |
| Mga sagradong lugar at beacon | Pamamahala ng lugar at configuration ng Sponsored Beacon β Mining at Pagkita |
| Configuration ng mining | Mga tsansa ng omikuji sa basis points, mga dynamic na multiplier na ina-adjust sa real time β Mining at Pagkita |
| Mga referral | Paggawa ng branded na QR code at pagsubaybay sa referral |
Ang app na ito ang timon ng ekonomiya ng mining: ang mga dynamic na multiplier (0.01Γβ50Γ) na nagtutulak sa mga bisita patungo sa mga rehiyong nauubusan ng populasyon, ang mga probability table ng omikuji, at ang mga Sponsored Beacon na pinopondohan ng mga munisipalidad at negosyante β lahat ay pinapatakbo mula rito, hindi naka-hard-code.
π° J-Times β ang media appβ
"ζ₯ζ¬γγδΈηγΈ / Ang Japan, sa Mundo." Ang culture media app: mga artikulo, podcast, at video β kung saan ang mismong pagbabasa ay kumikita ng MTC.
Buksan ang J-Times sa App Store β
| Bahagi | Sa isang linya |
|---|---|
| Mga artikulo | Mayamang reader na may reading progress; kabilang sa newsroom stack ang AI article generation at TTS β Media |
| Mga podcast | 6 serye, kabilang ang Japan Decoded at Tech Japan Forward |
| Video | Mga serye at short-form na video |
| Media mining | Ang pagbabasa, pakikinig, panonood, at mga quiz ay nagbabayad ng MTC β daily cap na 50 MTC β Media |
| Mga plano | Free / Premium / Pro reader tier; mga premium item na ibinebenta nang isa-isa sa pamamagitan ng Stripe |
Ang engagement ay sinusubaybayan bawat user bawat nilalaman, na may mga admin-tunable na reward rate, 5-minutong cooldown sa pagitan ng mga gantimpala, at ang 50 MTC daily cap β mining na gumagantimpala sa atensiyon nang hindi nagiging gripo.
π¦ Iisang shared core: JCCoreβ
Ang tatlong app ay nakatayo sa JCCore, isang shared Swift package β iisang implementasyon ng mapanganib na tubero sa halip na tatlong kopyang nagkakalayo.
| Module | Papel |
|---|---|
| JCAuth | Keychain-based na token storage, pamamahala ng session, biometric auth (Face ID / Touch ID) |
| JCNetworking | Type-safe na API client, suporta sa WebSocket, awtomatikong snake_case wire conversion |
| JCModels | Mga shared data model β mga user, token, pagination, membership plan |
| JCDesign | Theme protocol at mga design token (spacing, radius) |
| JCUtilities | Mga utility ng petsa at string |
Isang epekto na ramdam ng mga user: ang canonical na 4-tier na hagdan ng membership (Mga Level at Tier) ay pareho ang kahulugan sa bawat app, dahil dine-decode ito ng iisang code.
π₯οΈ Ang backend platformβ
Ang backend ay iisang Django monolith na nagpapatakbo ng buong ekonomiya β mga booking, escrow, mga ledger ng crowdfunding, mga live stream, mining, at bawat yen at bawat MTC na gumagalaw.
- Framework
- Django 4.2 + Django REST Framework
- Async na trabaho
- Mga Celery task queue para sa mga background job
- Realtime
- Django Channels WebSockets β chat, mga live na interaksiyon, presence
- Database
- PostgreSQL
- Live na video
- LiveKit, self-hosted sa Hetzner β walang third-party na streaming dependency
- Mga fiat rail
- Stripe para sa mga card at Apple Pay; Stripe Connect para sa onboarding at payout ng mga seller
- Kaligtasan ng bayad
- Kinakailangan ang mga idempotency key sa bawat state-mutating na payment call
- Pagpepresyo
- Laging muling kinukuwenta server-side ang mga presyo β hindi kailanman makapagtatakda ang client ng sarili nitong presyo
- Access sa chain
- app β Django β Solana, walang eksepsiyon
Ipinapakita ng daloy ng crypto payment ang panuntunan ng arkitektura sa praktika. Hindi kailanman mismong bumubuo o nagve-verify ang app ng Solana transaction β inaabot nito ang user sa Phantom at inaabot ang patunay sa Django.
Kung maputol ang user sa gitna ng pagbabayad β isang tawag, naubos na baterya, nawalan ng network β ipinagpapatuloy ng app ang nakabinbing Phantom payment sa susunod na paglulunsad, at ginagarantiya ng mga idempotency key na ang booking ay mase-settle nang eksaktong isang beses.
π Mga token service β pag-mint kapag kailanganβ
Isang dedikadong three-tier stack (live sa mainnet) ang humahawak sa lahat ng talagang humahawak sa Solana:
- Minting API (Django + DRF + Celery) β mga API-key-authenticated na endpoint na tinatawag ng mga platform ng Matsuri, GCF, at J-Times para sa awtomatikong pag-i-isyu ng NFT/SBT, mga operasyon sa token, at pamamahala ng on-chain metadata.
- Solana signer (Node.js + Fastify) β ang tanging service na may kakayahang mag-sign: paglikha at paglilipat ng SPL token, pagbawi ng authority, mga update sa metadata, pag-mint ng SBT, at pamamahala ng Metaplex Core Collection, na may retry/backoff tolerance para sa indexer lag.
- Admin dashboard (Next.js) β pamamahala ng coin at metadata: mga Arweave upload para sa permanenteng metadata hosting, impormasyon ng creator, at mga verification flag.
Ito ang stack na nagmi-mint ng mga tunay na asset ng platform: mga NFT drop sa pagdalo sa event, mga NFT ng εΎ‘ζ±ε° (goshuin β selyo ng templo) mula sa omikuji, at ang mga GCF Platinum SBT na sertipiko β lahat ay mga Metaplex Core na asset na nakapangkat sa mga collection para maipakita ang mga ito nang maayos ng mga wallet tulad ng Phantom, lahat ay mave-verify sa Solscan.
π Seguridad at privacyβ
Ang mga auth token ay nakatago nang naka-encrypt sa iOS Keychain; hinaharangan ng Face ID / Touch ID ang mga sensitibong aksiyon.
HTTPS sa lahat ng dako na may certificate pinning sa pagitan ng mga app at ng backend.
Hindi kailanman hinahawakan ng platform ang private key ng user. Ang pag-sign ay ipinauubaya sa Phantom β nagpapasa ang app ng request, nag-sign ang wallet, nagve-verify on-chain ang backend.
Ang pag-link ng wallet sa isang account ay nangangailangan ng pag-sign sa isang sariwang server-issued na challenge, kaya ang isang nakuhang signature ay hindi magagamit muli para angkinin ang wallet ng iba.
Ang mga check-in ng worship mining ay nagpapatupad ng 200 m na geofence, mga pagsusuri sa GPS accuracy at kalapitan, at isang check-in bawat user bawat lugar bawat araw β walang kinikita ang mga bot na nagte-teleport.
Ang mga MTC balance ay nasa isang na-audit na append-only ledger; ang mga withdrawal sa self-custody ay dumadaan sa mga limitasyon, cooldown, at fraud screening.
β Kalidad ng engineeringβ
Mas mahigpit ang pamantayang ipinapataw ng mga Rust contract sa sarili kaysa sa mga app: zero clippy warning, zero unwrap o panic sa production code, at mga property-based test kasabay ng mga unit test β dahil ang contract code, kapag na-deploy na, ay hindi makapagpapadala ng patch sa Martes.
βοΈ Mga smart contract β open-source na disenyoβ
On-chain ngayon: ang MTC SPL token (900M na nakapirmi, binawi ang mint at freeze authority), ang Streamflow lockup ng 550M MTC (cliff 2027-06-01), ang paunang Raydium MTC/SOL LP, at ang Solana Pay / Phantom payment verification sa mga production app. Wala nang iba.
Ang mga program sa ibaba ay code-complete at HINDI na-deploy sa anumang cluster. Ang seguridad ay isinasagawa bilang isang staged audit kasama ang Hashlock (sinimulan Abril 2026, TEAMZ Summit Tokyo): Sinasaklaw ng Phase 1 ang matsuri-buyback β kumpleto na ang submission package, target ang kickoff sa Agosto 2026, mga finding sa Setyembre, final report sa Oktubre, mainnet deploy na target sa OktβDis 2026 pagkatapos ng DEX listing. Sinasaklaw ng Phase 1.5 ang matsuri-vesting at matsuri-distribution sa Q1 2027, na maglalive sa 2027-06-01 na Grand Unlock. Hindi namin inilalarawan ang alinman dito bilang "audited" β kumpleto ang audit-prep at isinasagawa ang staged audit.
Ang lahat ng contract code ay open source: github.com/Cootakahashi/matsuri-contracts. Nakasalig ang seguridad sa nakikitang disenyo, hindi sa pagtatago. Ang target na arkitektura:
matsuri-buyback β ang tanggapan ng kitaβ
Ang program na gumagawa sa mga commitment sa buyback β 20% ng benta ng Matsuri HQ at 25% ng bayarin sa GCF membership β na on-chain na demand para sa MTC. Ang katangiang tumutukoy dito: ito ay isang conveyor, hindi treasury.
- Papel
- Atomic na swap-and-forward ng kita patungong MTC β tumatanggap ng mga whitelisted na token, nag-i-swap, nagpapasa
- Ruta ng swap
- Jupiter v6 sa pamamagitan ng CPI, na may pinned at immutable na Jupiter program id
- Mga tinatanggap na token
- MTC, USDC, SOL sa paglulunsad β whitelist na pinamamahalaan ng authority
- Depensa sa slippage
- Tatlong layer: runtime bps sa loob ng isang immutable na init-time cap sa loob ng isang compile-time na hard ceiling na 10%
- Mga timelock
- Ang mga pagbabago sa recipient at authority ay mga propose/execute/cancel na daloy, saklaw 24 oras β 30 araw
- Hindi kailanman may hawak na balanse
- Isang zero-balance post-condition ang ipinapatupad pagkatapos ng bawat swap β walang manakaw sa pagitan ng mga transaksiyon
- Laki at mga test
- 1,797 LOC, 17 test (13 unit + 4 property)
- Katayuan
- Code-complete, target ng Hashlock Phase 1 audit β HINDI na-deploy
Sa Phase 1 ang forwarding recipient ay isang Squads multisig; sa Phase 2 magiging isang Buyback Splitter ito na naghahati ng kita patungo sa LP injection at sa mga ecosystem pool.
matsuri-vesting β isang vault, isang recipient, isang orasanβ
Ang program na nagsasagawa ng iskedyul ng Grand Unlock. Sadya itong boring: walang mga miner, walang scoring, walang mga claim β aritmetika lamang sa isang orasan.
- Disenyo
- Isang vault, isang timelock-protected na recipient, isang orasan
- Pool
- 550M MTC, darating mula sa Streamflow cliff sa 2027-06-01
- Mga epoch
- 730-araw (2-taong) na mga epoch; bawat isa ay nagpapalabas ng 50% ng natitirang pool
- Daan ng release
- Ang advance_epoch_and_release ay isang permissionless na crank β sinuman ay makapagta-trigger ng nakatakdang release
- Immutability
- Ang halving factor, haba ng epoch, at kabuuang pool ay nala-lock sa initialize at hindi na mababago kailanman
- Laki at mga test
- 1,629 LOC, 26 test (22 unit + 4 property)
- Katayuan
- Code-complete, target ng Phase 1.5 audit (Q1 2027) β HINDI na-deploy
Mga design reference ng Phase 2β
Tatlo pang program ang umiiral bilang mga bukas na design reference β inilathala para sa transparency, hayagang minarkahang hindi para sa deployment, at nakatakdang patibayin sa mga susunod na yugto ng audit:
| Program | Layunin ng disenyo |
|---|---|
| matsuri-worship | Ang worship routing engine β on-chain na katapat ng mga anti-overtourism multiplier sa Mining at Pagkita |
| matsuri-referral | Mga referral tree ng ηΈ (en β mga ugnayan) para sa En-Mining β Mining at Pagkita |
| matsuri-distribution | Halving distribution na may scoring bawat miner β pinakikinis papasok sa saklaw ng Phase 1.5 audit |
Ang isang Phase 2 na Distribution Router (fan-out ng vesting patungo sa worship, referral, at mga pangkalahatang pool) at ang Buyback Splitter ay nasa design stage pa lamang. Hanggang malampasan ng bawat program ang yugto nito ng audit, ang katumbas na lohika ay tumatakbo off-chain sa Django bilang isang oracle β parehong mga panuntunan, ia-upgrade sa trustless na pagpapatupad nang paisa-isang yugto.
Mga saligang prinsipyo ng disenyoβ
- Checked arithmetic sa lahat ng dako β walang unchecked na matematika, at zero unwrap o panic sa mga production code path.
- Mga purong math module β ang pagkuwenta ng gantimpala at release ay nakabukod sa mga side-effect-free at lubusang na-test na
mathmodule. - Paghahati ng kapangyarihan β makapagpapanukala lamang ng mga pagbabago ang authority sa pamamagitan ng mga may-hangganang timelock; pinahihinto ng pause ang program ngunit hindi nito kailanman magagalaw o masasamsam ang pondo.
- Immutable na ekonomiya β ang mga parameter na tumutukoy sa kakapusan ng token ay nala-lock sa initialization, nang sinasadya.
Naipadala na ang mga app. Live na ang backend. Naisulat na, na-test, at nakapila sa audit ang mga contract. Ang natitira ay pagkakasunud-sunod β at inilalatag iyon ng Roadmap petsa por petsa.