🔧 Sản phẩm & Công nghệ
Những gì đang chạy chứng minh tất cả.
Hầu hết whitepaper token mô tả phần mềm chưa tồn tại. Chương này mô tả phần mềm bạn có thể tải về ngay hôm nay. Ba ứng dụng iOS gốc đã phát hành và đang trên App Store, nền tảng web đang vận hành production, và các dịch vụ token Solana đã mint NFT thật và xác minh thanh toán thật trên mainnet. Hai hợp đồng thông minh sẽ chi phối kinh tế dài hạn của token đã hoàn tất về mã và đang đi qua một cuộc kiểm toán theo giai đoạn — và chúng tôi nói chính xác như vậy, không hơn.
Toàn cảnh bộ sản phẩm
Mọi client — iOS hay web — nói chuyện với một backend Django duy nhất, và chỉ backend nói chuyện với Solana. Ứng dụng không bao giờ chạm trực tiếp vào chuỗi: quy tắc luôn là ứng dụng → Django → Solana.
⛩️ Matsuri — ứng dụng cho người dùng cuối
Ứng dụng chính cho khách và cư dân: đặt chỗ, thanh toán, mua sắm, gọi vốn cộng đồng, livestream, mining, và một bộ cứu sinh thiên tai ngoại tuyến đầy đủ — trong một nơi, thân thiện với chế độ khách.
Ứng dụng tổ chức quanh năm tab — Sự kiện, Shop, Nhà hàng, Gọi vốn cộng đồng, MyPage — với livestream, tìm kiếm, ví, NFT và trung tâm ứng phó thiên tai truy cập được từ mọi nơi. Mỗi bề mặt có chương riêng; bảng này chỉ là tấm bản đồ.
| Bề mặt | Trong một dòng |
|---|---|
| Sự kiện & trải nghiệm | Đặt tour, sự kiện, gặp gỡ và lớp học; vé QR và check-in bởi nhân viên — Experiences |
| Nhà hàng | Khám phá với bộ lọc nhu cầu ăn uống cùng hệ thống đặt bàn thực thụ — Restaurants |
| Shop | Chợ người bán đã xác minh KYC với đơn hàng ký quỹ và sản phẩm NFT — Shop |
| Gọi vốn cộng đồng | Chiến dịch All-or-Nothing với hoàn MTC theo hạng — Crowdfunding |
| Live | Luồng phát với chat, drop và tip qua năm kênh — Live |
| Mining, ví & NFT | 参拝マイニング (sanpai mining — worship mining), omikuji AR, ví MTC, thư viện NFT — Mining |
| Cứu sinh Thiên tai | Bản đồ nơi trú ẩn ngoại tuyến, nhắn tin mesh, đèn hiệu SOS — Disaster Lifeline |
| Thanh toán | Stripe (thẻ, Apple Pay), Solana Pay / Phantom, số dư MTC — giá luôn được tính lại phía máy chủ |
Ngoài các tính năng, ứng dụng tận dụng triệt để nền tảng iOS: widget màn hình chính, Siri App Intents, lập chỉ mục Spotlight, Live Activities cho đơn hàng, cam kết gọi vốn và livestream, cùng thông báo đẩy được bản địa hóa phía máy chủ theo từng người dùng.
Bên trong Cứu sinh Thiên tai
Chương Cứu sinh Thiên tai nói về nó làm gì; đây là lý do nó hoạt động khi mọi thứ khác thất bại. Ràng buộc thiết kế tàn nhẫn và đơn giản: mọi công cụ cứu sinh phải hoạt động hoàn toàn ngoại tuyến và không cần đăng nhập.
Bộ dữ liệu nơi trú ẩn sơ tán toàn quốc được đóng gói trong file ứng dụng — bản đồ nơi trú ẩn, danh sách theo khoảng cách và La bàn Nơi trú ẩn theo phương vị vòng tròn lớn không cần mạng chút nào. Hướng dẫn an toàn 5 ngôn ngữ được đóng gói theo cùng cách.
Khi mạng di động chết, những chiếc điện thoại trở thành mạng lưới: một bảng tin mesh ngang hàng ngoại tuyến chuyển tiếp bài đăng từ thiết bị này sang thiết bị khác với chuyển tiếp đa chặng, và mỗi tin nhắn được ký bằng mật mã bởi thiết bị gốc — nên một bài đăng đã đi qua năm chặng không thể bị giả mạo dọc đường.
Dịch vụ DisasterWatchdog thăm dò các nguồn cấp công khai của JMA (Cơ quan Khí tượng Nhật Bản) khi khởi động và trở lại nền trước; một sự kiện lớn tự động hiển thị Disaster Hub toàn màn hình — cho cả khách vãng lai lẫn người dùng đã đăng nhập.
Tin "Tôi an toàn" đi ra qua bất kỳ kênh nào còn sống: mesh, SMS, share sheet của hệ thống, hoặc web171 — bảng tin nhắn thảm họa chính thức của Nhật Bản.
🛡️ GCF Admin — ứng dụng cho người vận hành
Ứng dụng vận hành cho thành viên và nhân sự GCF (Global Community Friends): mọi thứ cổng quản trị web (gcf.works) làm được, ngay trên điện thoại.
| Bề mặt | Trong một dòng |
|---|---|
| Bảng điều khiển | Thẻ KPI, biểu đồ doanh thu, thao tác nhanh |
| Thành viên | Danh sách, chi tiết và quản lý hạng thành viên — GCF |
| Doanh thu | Theo dõi hoa hồng và quản lý chi trả |
| Nội dung | Tạo và xuất bản sự kiện, bài viết, podcast và video |
| Guide slot | Công bố và giám sát chợ hướng dẫn viên — Experiences |
| Thánh địa & beacon | Quản lý địa điểm và cấu hình Sponsored Beacon — Mining |
| Cấu hình mining | Xác suất omikuji theo basis point, hệ số động tinh chỉnh theo thời gian thực — Mining |
| Giới thiệu | Tạo mã QR có thương hiệu và theo dõi giới thiệu |
Đây là nơi nền kinh tế mining được điều khiển: các hệ số động (0.01×–50×) đẩy du khách về các vùng thưa dân, các bảng xác suất omikuji, và các Sponsored Beacon do chính quyền địa phương và nhà bán hàng tài trợ — tất cả được vận hành từ đây, không viết cứng.
📰 J-Times — ứng dụng truyền thông
"日本を、世界へ / Nhật Bản, vươn ra Thế giới." Ứng dụng truyền thông văn hóa: bài viết, podcast và video — nơi chính việc đọc cũng kiếm MTC.
| Bề mặt | Trong một dòng |
|---|---|
| Bài viết | Trình đọc phong phú với tiến độ đọc; hệ thống tòa soạn gồm sinh bài viết AI và TTS — Media |
| Podcast | 6 series, bao gồm Japan Decoded và Tech Japan Forward |
| Video | Series cùng video dạng ngắn |
| Media mining | Đọc, nghe, xem và quiz trả MTC — trần ngày 50 MTC — Media |
| Gói | Các hạng độc giả Free / Premium / Pro; nội dung premium bán theo lượt qua Stripe |
Tương tác được theo dõi tiến độ theo từng người dùng, từng nội dung, với mức thưởng quản trị viên tinh chỉnh được, thời gian chờ 5 phút giữa các lần thưởng, và trần ngày 50 MTC — mining thưởng cho sự chú ý mà không trở thành vòi phát token.
📦 Một lõi dùng chung: JCCore
Cả ba ứng dụng được xây trên JCCore, một gói Swift dùng chung — một hiện thực duy nhất cho phần đường ống rủi ro thay vì ba bản sao trôi dạt.
| Module | Vai trò |
|---|---|
| JCAuth | Lưu trữ token trên Keychain, quản lý phiên, xác thực sinh trắc (Face ID / Touch ID) |
| JCNetworking | API client an toàn kiểu, hỗ trợ WebSocket, tự động chuyển đổi wire snake_case |
| JCModels | Các model dữ liệu dùng chung — người dùng, token, phân trang, gói thành viên |
| JCDesign | Giao thức theme và design token (khoảng cách, bo góc) |
| JCUtilities | Tiện ích ngày tháng và chuỗi |
Một hệ quả người dùng cảm nhận được: thang thành viên 4 hạng chuẩn (Levels & Tiers) mang cùng một ý nghĩa trong mọi ứng dụng, vì nó được giải mã bởi cùng một đoạn mã.
🖥️ Nền tảng backend
Backend là một khối Django monolith duy nhất vận hành cả nền kinh tế — đặt chỗ, ký quỹ, sổ cái gọi vốn, livestream, mining, và mỗi đồng yên, mỗi MTC di chuyển.
- Framework
- Django 4.2 + Django REST Framework
- Xử lý bất đồng bộ
- Hàng đợi tác vụ Celery cho công việc chạy nền
- Thời gian thực
- WebSockets Django Channels — chat, tương tác trực tiếp, hiện diện
- Cơ sở dữ liệu
- PostgreSQL
- Video trực tiếp
- LiveKit, tự vận hành trên Hetzner — không phụ thuộc streaming bên thứ ba
- Kênh tiền pháp định
- Stripe cho thẻ và Apple Pay; Stripe Connect cho onboarding và chi trả người bán
- An toàn thanh toán
- Idempotency key bắt buộc trên mọi lời gọi thanh toán thay đổi trạng thái
- Định giá
- Giá luôn được tính lại phía máy chủ — client không bao giờ tự đặt giá của mình
- Truy cập chuỗi
- ứng dụng → Django → Solana, không ngoại lệ
Luồng thanh toán crypto cho thấy quy tắc kiến trúc trong thực tế. Ứng dụng không bao giờ tự soạn hay xác minh một giao dịch Solana — nó trao người dùng cho Phantom và trao bằng chứng cho Django.
Nếu người dùng bị gián đoạn giữa chừng thanh toán — một cuộc gọi, hết pin, rớt mạng — ứng dụng tiếp tục khoản thanh toán Phantom đang chờ ở lần khởi động kế tiếp, và idempotency key bảo đảm lượt đặt chỗ được chốt chính xác một lần.
🔏 Dịch vụ token — mint theo yêu cầu
Một hệ ba tầng chuyên biệt (đang chạy trên mainnet) xử lý mọi thứ thực sự chạm vào Solana:
- API mint (Django + DRF + Celery) — các endpoint xác thực bằng API key mà các nền tảng Matsuri, GCF và J-Times gọi để phát hành NFT/SBT tự động, các thao tác token, và quản lý metadata on-chain.
- Bộ ký Solana (Node.js + Fastify) — dịch vụ duy nhất nắm khả năng ký: tạo và chuyển token SPL, thu hồi quyền, cập nhật metadata, mint SBT, và quản lý Metaplex Core Collection, với cơ chế retry/backoff chịu được độ trễ của indexer.
- Bảng quản trị (Next.js) — quản lý coin và metadata: tải lên Arweave cho lưu trữ metadata vĩnh viễn, thông tin creator, và cờ xác minh.
Đây là hệ thống mint các tài sản thật của nền tảng: các đợt NFT tham dự sự kiện, NFT omikuji 御朱印 (goshuin — ấn triện đền chùa), và các chứng nhận SBT GCF Platinum — tất cả là tài sản Metaplex Core gom vào các collection để các ví như Phantom hiển thị đúng cách, tất cả xác minh được trên Solscan.
🔐 Bảo mật & riêng tư
Token xác thực nằm mã hóa trong iOS Keychain; Face ID / Touch ID chốt các hành động nhạy cảm.
HTTPS ở mọi nơi với certificate pinning giữa các ứng dụng và backend.
Nền tảng không bao giờ giữ khóa riêng của người dùng. Việc ký được ủy quyền cho Phantom — ứng dụng chuyển yêu cầu, ví ký, backend xác minh on-chain.
Liên kết một ví với tài khoản đòi hỏi ký một challenge mới do máy chủ phát hành, nên một chữ ký bị chặn bắt không thể được phát lại để chiếm ví của người khác.
Check-in worship mining thực thi geofence 200 m, kiểm tra độ chính xác GPS và khoảng cách, cùng một check-in mỗi người dùng mỗi địa điểm mỗi ngày — bot dịch chuyển tức thời không kiếm được gì.
Số dư MTC nằm trong sổ cái chỉ-ghi-thêm đã kiểm toán; lệnh rút về ví tự quản đi qua giới hạn, thời gian chờ và sàng lọc gian lận.
✅ Chất lượng kỹ thuật
Các hợp đồng Rust tự đặt ra tiêu chuẩn khắt khe hơn cả các ứng dụng: không cảnh báo clippy, không unwrap hay panic trong mã production, cùng property-based test bên cạnh unit test — bởi mã hợp đồng, một khi đã triển khai, không thể phát bản vá vào thứ Ba.
⚖️ Hợp đồng thông minh — thiết kế mã nguồn mở
On-chain hôm nay: token SPL MTC (900M cố định, quyền mint và freeze đã thu hồi), khoản khóa Streamflow 550M MTC (cliff 2027-06-01), LP MTC/SOL ban đầu trên Raydium, và xác minh thanh toán Solana Pay / Phantom trong các ứng dụng production. Không gì khác.
Các chương trình bên dưới đã hoàn tất về mã và CHƯA triển khai lên bất kỳ cluster nào. Bảo mật tiến hành theo một cuộc kiểm toán theo giai đoạn với Hashlock (khởi động tháng 4 năm 2026, TEAMZ Summit Tokyo): Phase 1 bao phủ matsuri-buyback — gói hồ sơ nộp đã hoàn tất, kickoff nhắm tháng 8 năm 2026, phát hiện tháng 9, báo cáo cuối tháng 10, triển khai mainnet nhắm tháng 10–12 năm 2026 sau khi niêm yết DEX. Phase 1.5 bao phủ matsuri-vesting cùng matsuri-distribution vào Q1 2027, vận hành tại Grand Unlock ngày 2027-06-01. Chúng tôi không mô tả bất kỳ điều nào ở đây là "đã kiểm toán" — công tác chuẩn bị kiểm toán đã hoàn tất và cuộc kiểm toán theo giai đoạn đang tiến hành.
Toàn bộ mã hợp đồng là mã nguồn mở: github.com/Cootakahashi/matsuri-contracts. Bảo mật dựa trên thiết kế công khai, không phải sự che giấu. Kiến trúc mục tiêu:
matsuri-buyback — cửa nạp doanh thu
Chương trình biến các cam kết mua lại — 20% doanh thu Matsuri HQ và 25% phí thành viên GCF — thành nhu cầu MTC on-chain. Thuộc tính định nghĩa của nó: nó là một băng chuyền, không phải một két bạc.
- Vai trò
- Hoán đổi và chuyển tiếp doanh thu thành MTC một cách nguyên tử — nhận token trong whitelist, hoán đổi, chuyển tiếp
- Tuyến hoán đổi
- Jupiter v6 qua CPI, với program id Jupiter được ghim, bất biến
- Token chấp nhận
- MTC, USDC, SOL khi ra mắt — whitelist do authority quản lý
- Phòng thủ trượt giá
- Ba lớp: bps lúc chạy nằm trong trần bất biến đặt lúc init, nằm trong trần cứng 10% lúc biên dịch
- Timelock
- Thay đổi người nhận và authority là các luồng đề xuất/thực thi/hủy, giới hạn 24 giờ – 30 ngày
- Không bao giờ giữ số dư
- Hậu điều kiện số dư bằng không được thực thi sau mỗi lần hoán đổi — không có gì để đánh cắp giữa các giao dịch
- Kích thước & test
- 1,797 LOC, 17 test (13 unit + 4 property)
- Trạng thái
- Hoàn tất về mã, mục tiêu kiểm toán Hashlock Phase 1 — CHƯA triển khai
Trong Phase 1, người nhận chuyển tiếp là một multisig Squads; trong Phase 2, nó trở thành Buyback Splitter tỏa doanh thu ra bơm LP và các quỹ hệ sinh thái.
matsuri-vesting — một vault, một người nhận, một chiếc đồng hồ
Chương trình thực thi lịch Grand Unlock. Nó nhàm chán một cách có chủ đích: không miner, không chấm điểm, không claim — chỉ là số học trên một chiếc đồng hồ.
- Thiết kế
- Một vault, một người nhận được bảo vệ bằng timelock, một chiếc đồng hồ
- Quỹ
- 550M MTC, đến từ cliff Streamflow vào 2027-06-01
- Epoch
- Epoch 730 ngày (2 năm); mỗi epoch giải phóng 50% quỹ còn lại
- Đường giải phóng
- advance_epoch_and_release là một crank không cần quyền — bất kỳ ai cũng có thể kích hoạt đợt giải phóng đến hạn
- Tính bất biến
- Hệ số halving, độ dài epoch và tổng quỹ khóa lúc initialize và không bao giờ thay đổi được
- Kích thước & test
- 1,629 LOC, 26 test (22 unit + 4 property)
- Trạng thái
- Hoàn tất về mã, mục tiêu kiểm toán Phase 1.5 (Q1 2027) — CHƯA triển khai
Các tham chiếu thiết kế Phase 2
Ba chương trình nữa tồn tại dưới dạng tham chiếu thiết kế mở — công bố vì minh bạch, đánh dấu rõ ràng là chưa-để-triển-khai, và dự kiến gia cố trong các giai đoạn kiểm toán sau:
| Chương trình | Ý đồ thiết kế |
|---|---|
| matsuri-worship | Động cơ định tuyến worship — bản đối ứng on-chain của các hệ số chống quá tải du lịch trong Mining |
| matsuri-referral | Cây giới thiệu 縁 (en — duyên) cho En-Mining — Mining |
| matsuri-distribution | Phân phối halving với chấm điểm theo từng miner — đang được hoàn thiện vào phạm vi kiểm toán Phase 1.5 |
Một Distribution Router Phase 2 (tỏa vesting ra các quỹ worship, referral và tổng quát) và Buyback Splitter mới chỉ ở giai đoạn thiết kế. Cho đến khi mỗi chương trình vượt qua giai đoạn kiểm toán của mình, logic tương ứng chạy off-chain trong Django như một oracle — cùng bộ quy tắc, được nâng cấp lên thực thi phi tín nhiệm theo từng giai đoạn.
Nguyên tắc thiết kế dùng chung
- Số học có kiểm tra ở mọi nơi — không phép toán không kiểm tra, và không unwrap hay panic trong các đường mã production.
- Module toán thuần túy — tính toán thưởng và giải phóng được cô lập trong các module
mathkhông tác dụng phụ, được test triệt để. - Phân quyền — authority chỉ có thể đề xuất thay đổi qua các timelock có giới hạn; pause dừng chương trình nhưng không bao giờ có thể di chuyển hay chiếm giữ tiền.
- Kinh tế học bất biến — các tham số định nghĩa sự khan hiếm của token được khóa lúc khởi tạo, một cách có chủ đích.
Các ứng dụng đã xuất xưởng. Backend đang chạy. Các hợp đồng đã viết xong, đã test, và xếp hàng chờ kiểm toán. Điều còn lại là trình tự — và Roadmap trải nó ra theo từng mốc ngày.