π§ Produk & Teknologi
Apa yang berjalan membuktikan segalanya.
Kebanyakan kertas putih token menerangkan perisian yang belum wujud. Bab ini menerangkan perisian yang boleh anda muat turun hari ini. Tiga aplikasi iOS asli telah dilancarkan dan tersedia di App Store, platform web berada dalam pengeluaran, dan perkhidmatan token Solana sudah pun mengeluarkan NFT sebenar dan mengesahkan pembayaran sebenar di mainnet. Dua kontrak pintar yang akan mentadbir ekonomi jangka panjang token sudah lengkap kod dan bergerak melalui audit berperingkat β dan kami menyebut tepat itu, tidak lebih.
Suit sekali imbasβ
Setiap klien β iOS atau web β bercakap dengan satu backend Django, dan hanya backend yang bercakap dengan Solana. Aplikasi tidak pernah menyentuh rantaian secara terus: peraturannya sentiasa aplikasi β Django β Solana.
β©οΈ Matsuri β aplikasi penggunaβ
Aplikasi utama untuk tetamu dan penduduk: tempahan, pembayaran, membeli-belah, pendanaan awam, strim langsung, perlombongan, dan talian hayat bencana luar talian penuh β di satu tempat, mesra mod tetamu.
Aplikasi ini disusun sekitar lima tab β Acara, Kedai, Restoran, Pendanaan Awam, MyPage β dengan strim langsung, carian, dompet, NFT, dan hab bencana boleh dicapai dari mana-mana. Setiap permukaan mempunyai babnya sendiri; jadual ini hanyalah peta.
| Permukaan | Dalam satu baris |
|---|---|
| Acara & pengalaman | Tempah lawatan, acara, pertemuan, dan kelas; tiket QR dan daftar masuk kakitangan β Pengalaman |
| Restoran | Penemuan dengan penapis keperluan pemakanan serta enjin tempahan meja sebenar β Restoran |
| Kedai | Pasaran penjual disahkan KYC dengan pesanan eskrow dan produk NFT β Kedai |
| Pendanaan Awam | Kempen All-or-Nothing dengan pulangan tunai MTC berperingkat β Pendanaan Awam |
| Langsung | Strim dengan sembang, drop, dan tip merentasi lima saluran β Langsung |
| Perlombongan, dompet & NFT | εζγγ€γγ³γ° (sanpai mining β perlombongan ziarah), omikuji AR, dompet MTC, galeri NFT β Perlombongan |
| Talian Hayat Bencana | Peta tempat perlindungan luar talian, pemesejan mesh, suar SOS β Talian Hayat Bencana |
| Pembayaran | Stripe (kad, Apple Pay), Solana Pay / Phantom, baki MTC β harga sentiasa dikira semula di sisi pelayan |
Melangkaui ciri, aplikasi ini bersandar kuat pada platform iOS: widget skrin utama, App Intents Siri, pengindeksan Spotlight, Live Activities untuk pesanan, ikrar, dan strim langsung, serta pemberitahuan tolak yang disetempatkan di sisi pelayan bagi setiap pengguna.
Talian Hayat Bencana di sebalik tabirβ
Bab Talian Hayat Bencana meliputi apa yang dilakukannya; di sini ialah mengapa ia berfungsi ketika segala yang lain gagal. Kekangan reka bentuknya kejam dan mudah: setiap alat talian hayat mesti berfungsi sepenuhnya luar talian dan tanpa log masuk.
Set data tempat perlindungan pemindahan seluruh negara dihantar di dalam binari aplikasi β peta tempat perlindungan, senarai jarak, dan Kompas Tempat Perlindungan bulatan agung memerlukan sifar rangkaian. Panduan keselamatan dalam 5 bahasa dibungkus dengan cara yang sama.
Apabila rangkaian selular mati, telefon menjadi rangkaian: papan buletin mesh rakan-ke-rakan luar talian menyampaikan siaran peranti-ke-peranti dengan penyampaian berbilang lompatan, dan setiap mesej ditandatangani secara kriptografi oleh peranti asalnya β jadi siaran yang telah melalui lima lompatan tidak boleh dipalsukan di sepanjang jalan.
Perkhidmatan DisasterWatchdog meninjau suapan awam JMA (Agensi Meteorologi Jepun) pada pelancaran dan latar depan; kejadian besar mempersembahkan Hab Bencana skrin penuh secara automatik β untuk tetamu dan pengguna berdaftar.
"Saya selamat" keluar melalui mana-mana saluran yang terselamat: mesh, SMS, helaian kongsi sistem, atau web171 β papan mesej bencana rasmi Jepun.
π‘οΈ GCF Admin β aplikasi pengendaliβ
Aplikasi operasi untuk ahli dan kakitangan GCF (Global Community Friends): segala yang boleh dilakukan portal admin web (gcf.works), di telefon.
| Permukaan | Dalam satu baris |
|---|---|
| Papan pemuka | Kad KPI, carta hasil, tindakan pantas |
| Ahli | Senarai ahli, perincian, dan pengurusan peringkat β GCF |
| Hasil | Penjejakan komisen dan pengurusan pembayaran |
| Kandungan | Cipta dan terbitkan acara, artikel, podcast, dan video |
| Slot pemandu | Terbitkan dan pantau pasaran pemandu β Pengalaman |
| Tapak suci & beacon | Pengurusan tapak dan konfigurasi Sponsored Beacon β Perlombongan |
| Konfigurasi perlombongan | Kebarangkalian omikuji dalam mata asas, pengganda dinamik ditala dalam masa nyata β Perlombongan |
| Rujukan | Penjanaan kod QR berjenama dan penjejakan rujukan |
Aplikasi inilah tempat ekonomi perlombongan dikemudi: pengganda dinamik (0.01Γβ50Γ) yang menolak pengunjung ke wilayah susut penduduk, jadual kebarangkalian omikuji, dan Sponsored Beacons yang dibiayai majlis perbandaran dan peniaga β semuanya dikendalikan dari sini, bukan dikodkan tetap.
π° J-Times β aplikasi mediaβ
"ζ₯ζ¬γγδΈηγΈ / Jepun, kepada Dunia." Aplikasi media budaya: artikel, podcast, dan video β di mana membaca itu sendiri memperoleh MTC.
| Permukaan | Dalam satu baris |
|---|---|
| Artikel | Pembaca kaya dengan kemajuan bacaan; susunan bilik berita merangkumi penjanaan artikel AI dan TTS β Media |
| Podcast | 6 siri, termasuk Japan Decoded dan Tech Japan Forward |
| Video | Siri serta video bentuk pendek |
| Perlombongan media | Membaca, mendengar, menonton, dan kuiz membayar MTC β had harian 50 MTC β Media |
| Pelan | Peringkat pembaca Free / Premium / Pro; item premium dijual sekali beli melalui Stripe |
Penglibatan dijejaki kemajuannya setiap pengguna setiap kandungan, dengan kadar ganjaran boleh ditala admin, tempoh bertenang 5 minit antara ganjaran, dan had harian 50 MTC β perlombongan yang memberi ganjaran kepada perhatian tanpa menjadi paip terbuka.
π¦ Satu teras dikongsi: JCCoreβ
Ketiga-tiga aplikasi dibina di atas JCCore, pakej Swift dikongsi β satu pelaksanaan saluran paip berisiko dan bukannya tiga salinan yang menyimpang.
| Modul | Peranan |
|---|---|
| JCAuth | Penyimpanan token berasaskan Keychain, pengurusan sesi, pengesahan biometrik (Face ID / Touch ID) |
| JCNetworking | Klien API selamat jenis, sokongan WebSocket, penukaran wire snake_case automatik |
| JCModels | Model data dikongsi β pengguna, token, penomboran halaman, pelan keahlian |
| JCDesign | Protokol tema dan token reka bentuk (jarak, jejari) |
| JCUtilities | Utiliti tarikh dan rentetan |
Satu akibat yang dirasai pengguna: tangga keahlian 4 peringkat kanonik (Tahap & Peringkat) bermaksud perkara yang sama dalam setiap aplikasi, kerana ia dinyahkodkan oleh kod yang sama.
π₯οΈ Platform backendβ
Backend ialah satu monolit Django yang menjalankan seluruh ekonomi β tempahan, eskrow, lejar pendanaan awam, strim langsung, perlombongan, dan setiap yen serta setiap MTC yang bergerak.
- Rangka kerja
- Django 4.2 + Django REST Framework
- Kerja async
- Barisan tugas Celery untuk kerja latar belakang
- Masa nyata
- WebSocket Django Channels β sembang, interaksi langsung, kehadiran
- Pangkalan data
- PostgreSQL
- Video langsung
- LiveKit, dihoskan sendiri di Hetzner β tiada kebergantungan penstriman pihak ketiga
- Saluran fiat
- Stripe untuk kad dan Apple Pay; Stripe Connect untuk penerimaan masuk penjual dan pembayaran
- Keselamatan pembayaran
- Kunci idempotensi diwajibkan pada setiap panggilan pembayaran yang mengubah keadaan
- Penetapan harga
- Harga sentiasa dikira semula di sisi pelayan β klien tidak boleh menamakan harganya sendiri
- Akses rantaian
- aplikasi β Django β Solana, tiada pengecualian
Aliran pembayaran kripto menunjukkan peraturan seni bina dalam amalan. Aplikasi tidak pernah membina atau mengesahkan transaksi Solana sendiri β ia menyerahkan pengguna kepada Phantom dan menyerahkan bukti kepada Django.
Jika pengguna terganggu di tengah pembayaran β panggilan, bateri mati, rangkaian terputus β aplikasi menyambung semula pembayaran Phantom yang tertangguh pada pelancaran seterusnya, dan kunci idempotensi menjamin tempahan diselesaikan tepat sekali.
π Perkhidmatan token β pengeluaran atas permintaanβ
Susunan tiga peringkat khusus (aktif di mainnet) mengendalikan segala yang benar-benar menyentuh Solana:
- API Pengeluaran (Django + DRF + Celery) β titik akhir yang disahkan kunci API yang dipanggil platform Matsuri, GCF, dan J-Times untuk terbitan NFT/SBT automatik, operasi token, dan pengurusan metadata dalam rantaian.
- Penandatangan Solana (Node.js + Fastify) β satu-satunya perkhidmatan yang memegang keupayaan menandatangani: penciptaan dan pemindahan token SPL, pembatalan kuasa, kemas kini metadata, pengeluaran SBT, dan pengurusan Metaplex Core Collection, dengan toleransi cubaan semula/undur untuk kelewatan pengindeks.
- Papan pemuka admin (Next.js) β pengurusan koin dan metadata: muat naik Arweave untuk pengehosan metadata kekal, maklumat pencipta, dan bendera pengesahan.
Inilah susunan yang mengeluarkan aset sebenar platform: drop NFT kehadiran acara, NFT omikuji εΎ‘ζ±ε° (goshuin β cap mohor kuil), dan sijil SBT GCF Platinum β semuanya aset Metaplex Core yang dikumpulkan ke dalam koleksi supaya dompet seperti Phantom memaparkannya dengan betul, semuanya boleh disahkan di Solscan.
π Keselamatan & privasiβ
Token pengesahan disimpan tersulit dalam Keychain iOS; Face ID / Touch ID memagari tindakan sensitif.
HTTPS di mana-mana dengan pin sijil antara aplikasi dan backend.
Platform tidak pernah memegang kunci persendirian pengguna. Penandatanganan diwakilkan kepada Phantom β aplikasi menghantar permintaan, dompet menandatangani, backend mengesahkan dalam rantaian.
Memautkan dompet ke akaun memerlukan penandatanganan cabaran segar yang dikeluarkan pelayan, jadi tandatangan yang dipintas tidak boleh diulang untuk menuntut dompet orang lain.
Daftar masuk perlombongan ziarah menguatkuasakan pagar geo 200 m, semakan ketepatan GPS dan kedekatan, serta satu daftar masuk setiap pengguna setiap tapak setiap hari β bot yang berteleportasi tidak memperoleh apa-apa.
Baki MTC berada dalam lejar tambah-sahaja teraudit; pengeluaran ke jagaan sendiri melalui had, tempoh bertenang, dan saringan penipuan.
β Kualiti kejuruteraanβ
Kontrak Rust memegang piawaian lebih ketat daripada aplikasi: sifar amaran clippy, sifar unwrap atau panic dalam kod pengeluaran, dan ujian berasaskan sifat di samping ujian unit β kerana kod kontrak, setelah digunakan, tidak boleh menghantar tampalan pada hari Selasa.
βοΈ Kontrak pintar β reka bentuk sumber terbukaβ
Dalam rantaian hari ini: token SPL MTC (900M tetap, kuasa mint dan pembekuan dibatalkan), kunci Streamflow 550M MTC (klif 2027-06-01), LP Raydium MTC/SOL awal, dan pengesahan pembayaran Solana Pay / Phantom dalam aplikasi pengeluaran. Tiada yang lain.
Program-program di bawah lengkap kod dan BELUM digunakan pada mana-mana kluster. Keselamatan berjalan sebagai audit berperingkat dengan Hashlock (dimulakan April 2026, TEAMZ Summit Tokyo): Fasa 1 meliputi matsuri-buyback β pakej penyerahan lengkap, permulaan disasarkan Ogos 2026, penemuan September, laporan akhir Oktober, penggunaan mainnet disasarkan OktβDis 2026 selepas penyenaraian DEX. Fasa 1.5 meliputi matsuri-vesting serta matsuri-distribution pada S1 2027, beroperasi pada Grand Unlock 2027-06-01. Kami tidak menyifatkan mana-mana daripada ini sebagai "telah diaudit" β persediaan audit lengkap dan audit berperingkat sedang berjalan.
Semua kod kontrak adalah sumber terbuka: github.com/Cootakahashi/matsuri-contracts. Keselamatan bersandar pada reka bentuk yang boleh dilihat, bukan kekaburan. Seni bina sasaran:
matsuri-buyback β pengambilan hasilβ
Program yang menukar komitmen belian balik β 20% daripada jualan Matsuri HQ dan 25% daripada yuran keahlian GCF β kepada permintaan MTC dalam rantaian. Sifat penentunya: ia adalah penghantar, bukan perbendaharaan.
- Peranan
- Tukar-dan-majukan atomik hasil kepada MTC β menerima token disenarai putih, menukar, memajukan
- Laluan tukaran
- Jupiter v6 melalui CPI, dengan id program Jupiter yang dipin dan tidak boleh ubah
- Token diterima
- MTC, USDC, SOL pada pelancaran β senarai putih diurus oleh pihak berkuasa
- Pertahanan gelinciran
- Tiga lapisan: bps masa jalan dalam had masa-init tidak boleh ubah dalam siling keras masa-kompilasi 10%
- Kunci masa
- Perubahan penerima dan pihak berkuasa ialah aliran cadang/laksana/batal, terikat 24 jam β 30 hari
- Tidak pernah memegang baki
- Pascasyarat baki sifar dikuatkuasakan selepas setiap tukaran β tiada apa untuk dicuri antara transaksi
- Saiz & ujian
- 1,797 LOC, 17 ujian (13 unit + 4 sifat)
- Status
- Lengkap kod, sasaran audit Fasa 1 Hashlock β BELUM digunakan
Dalam Fasa 1 penerima pemajuan ialah multisig Squads; dalam Fasa 2 ia menjadi Buyback Splitter yang mengagihkan hasil ke suntikan LP dan kolam ekosistem.
matsuri-vesting β satu bilik kebal, satu penerima, satu jamβ
Program yang melaksanakan jadual Grand Unlock. Ia sengaja membosankan: tiada pelombong, tiada pemarkahan, tiada tuntutan β hanya aritmetik pada jam.
- Reka bentuk
- Satu bilik kebal, satu penerima dilindungi kunci masa, satu jam
- Kolam
- 550M MTC, tiba daripada klif Streamflow pada 2027-06-01
- Epok
- Epok 730 hari (2 tahun); setiap satu melepaskan 50% daripada kolam berbaki
- Laluan pelepasan
- advance_epoch_and_release ialah engkol tanpa kebenaran β sesiapa boleh mencetuskan pelepasan yang matang
- Ketidakbolehubahan
- Faktor pengurangan separuh, panjang epok, dan jumlah kolam terkunci pada permulaan dan tidak boleh diubah
- Saiz & ujian
- 1,629 LOC, 26 ujian (22 unit + 4 sifat)
- Status
- Lengkap kod, sasaran audit Fasa 1.5 (S1 2027) β BELUM digunakan
Rujukan reka bentuk Fasa 2β
Tiga lagi program wujud sebagai rujukan reka bentuk terbuka β diterbitkan demi ketelusan, ditandakan secara eksplisit bukan-untuk-penggunaan, dan dijadualkan untuk pengukuhan dalam fasa audit kemudian:
| Program | Niat reka bentuk |
|---|---|
| matsuri-worship | Enjin penghalaan ziarah β rakan dalam rantaian bagi pengganda anti pelancongan berlebihan dalam Perlombongan |
| matsuri-referral | Pokok rujukan ηΈ (en β ikatan) untuk En-Mining β Perlombongan |
| matsuri-distribution | Pengagihan pengurangan separuh dengan pemarkahan setiap pelombong β sedang digilap ke dalam skop audit Fasa 1.5 |
Distribution Router Fasa 2 (pengagihan peletakhakan ke kolam ziarah, rujukan, dan umum) dan Buyback Splitter hanya di peringkat reka bentuk. Sehingga setiap program melepasi fasa auditnya, logik berkenaan berjalan luar rantaian dalam Django sebagai oracle β peraturan yang sama, dinaik taraf kepada pelaksanaan tanpa perlu percaya secara berperingkat.
Prinsip reka bentuk dikongsiβ
- Aritmetik tersemak di mana-mana β tiada matematik tanpa semakan, dan sifar unwrap atau panic dalam laluan kod pengeluaran.
- Modul matematik tulen β pengiraan ganjaran dan pelepasan diasingkan dalam modul
mathbebas kesan sampingan yang diuji secara menyeluruh. - Pengasingan kuasa β pihak berkuasa hanya boleh mencadangkan perubahan melalui kunci masa terikat; jeda menghentikan program tetapi tidak boleh menggerakkan atau merampas dana.
- Ekonomi tidak boleh ubah β parameter yang menakrifkan kekurangan token dikunci pada permulaan, dengan sengaja.
Aplikasi telah dihantar. Backend aktif. Kontrak telah ditulis, diuji, dan menunggu giliran audit. Yang tinggal ialah penjujukan β dan Pelan Hala Tuju membentangkannya tarikh demi tarikh.