🔧 프로덕트 & 기술

돌아가고 있는 것이 모든 것을 증명합니다.

대부분의 토큰 백서는 아직 존재하지 않는 소프트웨어를 설명합니다. 이 장은 오늘 다운로드할 수 있는 소프트웨어를 설명합니다. 3개의 네이티브 iOS 앱이 출시되어 App Store에서 라이브 중이고, 웹 플랫폼은 프로덕션에서 운영되며, Solana 토큰 서비스는 이미 메인넷에서 실제 NFT를 발행하고 실제 결제를 검증하고 있습니다. 토큰의 장기 경제를 관장할 두 개의 스마트 컨트랙트는 코드 완성 상태로 단계별 감사를 통과하는 중입니다 — 그리고 우리는 그 이상도 이하도 아닌, 정확히 그렇게 말합니다.

하나의 플랫폼, 세 개의 앱: 게스트를 위한 Matsuri, 운영자를 위한 GCF Admin, 독자를 위한 J-Times.

한눈에 보는 스위트

3네이티브 iOS 앱모두 출시, App Store에서 라이브

827+자동화된 앱 테스트세 앱 전체 합산

43스마트 컨트랙트 테스트바이백 17 + 베스팅 26, 경고 0건

모든 클라이언트 — iOS든 웹이든 — 는 하나의 Django 백엔드와 통신하고, 오직 백엔드만이 Solana와 통신합니다. 앱은 절대 체인을 직접 건드리지 않습니다: 규칙은 언제나 앱 → Django → Solana입니다.

⛩️ Matsuri — 소비자 앱

상태: 출시 완료 — App Store에서 라이브

게스트와 거주자를 위한 메인 앱: 예약, 결제, 쇼핑, 크라우드펀딩, 라이브 스트림, 마이닝, 그리고 완전한 오프라인 재난 라이프라인 — 게스트 모드 친화적으로, 한곳에.

Matsuri — App Store에서 라이브 중인 문화 체험 앱.

App Store에서 Matsuri 열기 →

홈 — 이벤트와 체험

지갑 — MTC 잔액과 이력

Phantom으로 결제 — 승인 한 번

앱은 다섯 개의 탭 — 이벤트, 숍, 레스토랑, 크라우드펀딩, 마이페이지 — 을 중심으로 구성되며, 라이브 스트림, 검색, 지갑, NFT, 재난 허브는 어디서든 접근할 수 있습니다. 각 지면에는 각자의 장이 있습니다. 이 표는 지도일 뿐입니다.

지면	한 줄 설명
이벤트 & 체험	투어, 이벤트, 밋업, 클래스 예약; QR 티켓과 스태프 체크인 — 체험
레스토랑	식이 요구 필터가 있는 탐색과 실제 테이블 예약 엔진 — 레스토랑
숍	에스크로 주문과 NFT 상품이 있는 KYC 인증 셀러 마켓플레이스 — 숍
크라우드펀딩	티어별 MTC 캐시백이 있는 All-or-Nothing 캠페인 — 크라우드펀딩
라이브	채팅, 드롭, 다섯 가지 수단의 팁이 있는 스트림 — 라이브
마이닝·지갑·NFT	参拝マイニング(산파이 마이닝 — 참배 마이닝), AR 오미쿠지, MTC 지갑, NFT 갤러리 — 마이닝
재난 라이프라인	오프라인 대피소 지도, 메시 메시징, SOS 비컨 — 재난 라이프라인
결제	Stripe(카드, Apple Pay), Solana Pay / Phantom, MTC 잔액 — 가격은 항상 서버 측에서 재계산

기능을 넘어, 앱은 iOS 플랫폼에 깊이 기대고 있습니다: 홈 화면 위젯, Siri App Intents, Spotlight 인덱싱, 주문·후원·라이브 스트림을 위한 Live Activities, 그리고 사용자별로 서버 측에서 현지화되는 푸시 알림.

재난 라이프라인의 내부

재난 라이프라인 장은 그것이 무엇을 하는지를 다룹니다. 여기서는 다른 모든 것이 실패할 때 왜 그것이 작동하는지를 다룹니다. 설계 제약은 가혹할 만큼 단순합니다: 모든 라이프라인 도구는 완전한 오프라인에서, 로그인 없이 작동해야 합니다.

구조적으로 오프라인 우선

전국 대피소 데이터셋이 앱 바이너리 안에 실려 나갑니다 — 대피소 지도, 거리순 목록, 대권 방위 대피소 나침반은 네트워크가 전혀 필요 없습니다. 5개 언어 안전 가이드도 같은 방식으로 내장됩니다.

서명된 메시지의 P2P 메시

셀룰러 네트워크가 죽으면 휴대폰이 네트워크가 됩니다: 오프라인 P2P 메시 게시판이 멀티홉 릴레이로 게시물을 기기에서 기기로 전달하며, 모든 메시지는 발신 기기가 암호학적으로 서명하므로 — 다섯 홉을 여행한 게시물도 도중에 위조될 수 없습니다.

자동 활성화

DisasterWatchdog 서비스가 실행·포그라운드 시 JMA(일본 기상청) 공개 피드를 폴링합니다. 대형 이벤트가 발생하면 전체 화면 재난 허브가 자동으로 표시됩니다 — 게스트든 로그인 사용자든.

어떤 채널로든 안부 확인

"저는 안전합니다"는 살아남은 어떤 채널로든 나갑니다: 메시, SMS, 시스템 공유 시트, 또는 일본의 공식 재해 전언판인 web171.

🛡️ GCF Admin — 운영자 앱

상태: 출시 완료 — App Store에서 라이브

GCF (Global Community Friends) 멤버와 스태프를 위한 운영 앱: 웹 관리 포털(gcf.works)이 할 수 있는 모든 것을, 휴대폰에서.

GCF Admin — App Store에서 라이브 중인 호스트·가이드 앱.

App Store에서 GCF 열기 →

대시보드 — KPI와 수익

멤버 관리

수익과 커미션

지면	한 줄 설명
대시보드	KPI 카드, 수익 차트, 퀵 액션
멤버	멤버 목록, 상세, 티어 관리 — GCF
수익	커미션 추적과 정산 관리
콘텐츠	이벤트, 기사, 팟캐스트, 영상 생성 및 발행
가이드 슬롯	가이드 마켓플레이스 게시와 모니터링 — 체험
성지 & 비컨	장소 관리와 Sponsored Beacon 설정 — 마이닝
마이닝 설정	베이시스 포인트 단위 오미쿠지 확률, 실시간으로 조정되는 동적 배수 — 마이닝
추천	브랜드 QR 코드 생성과 추천 추적

이 앱이 마이닝 경제의 조타실입니다: 방문객을 인구 감소 지역으로 이끄는 동적 배수(0.01×–50×), 오미쿠지 확률표, 지자체와 상인이 자금을 대는 Sponsored Beacon — 모두 하드코딩이 아니라 여기서 운영됩니다.

📰 J-Times — 미디어 앱

상태: 출시 완료 — App Store에서 라이브

"日本を、世界へ / Japan, to the World." 문화 미디어 앱: 기사, 팟캐스트, 영상 — 읽는 것 자체가 MTC를 버는 곳.

J-Times — App Store에서 라이브 중인 문화 미디어 앱.

App Store에서 J-Times 열기 →

기사 리더 — 진행률 추적

팟캐스트 플레이어

지면	한 줄 설명
기사	읽기 진행률을 추적하는 리치 리더; 뉴스룸 스택에는 AI 기사 생성과 TTS 포함 — 미디어
팟캐스트	Japan Decoded, Tech Japan Forward를 포함한 6개 시리즈
영상	시리즈와 숏폼 영상
미디어 마이닝	읽기, 듣기, 보기, 퀴즈가 MTC를 지급 — 일일 상한 50 MTC — 미디어
플랜	Free / Premium / Pro 독자 티어; 프리미엄 콘텐츠는 Stripe로 단건 판매

참여는 사용자별·콘텐츠별로 진행률이 추적되며, 관리자가 조정 가능한 보상 요율, 보상 간 5분 쿨다운, 일일 50 MTC 상한이 적용됩니다 — 수도꼭지가 되지 않으면서 관심에 보상하는 마이닝입니다.

📦 하나의 공유 코어: JCCore

세 앱 모두 공유 Swift 패키지인 JCCore 위에 만들어졌습니다 — 위험한 배관을 세 개의 어긋나는 복사본이 아니라 하나의 구현으로.

모듈	역할
JCAuth	Keychain 기반 토큰 저장, 세션 관리, 생체 인증 (Face ID / Touch ID)
JCNetworking	타입 안전 API 클라이언트, WebSocket 지원, snake_case 와이어 자동 변환
JCModels	공유 데이터 모델 — 사용자, 토큰, 페이지네이션, 멤버십 플랜
JCDesign	테마 프로토콜과 디자인 토큰 (간격, 라운딩)
JCUtilities	날짜·문자열 유틸리티

사용자가 체감하는 한 가지 결과: 공식 4단계 멤버십 사다리(레벨 & 티어)는 같은 코드로 디코딩되기 때문에 모든 앱에서 같은 의미를 가집니다.

🖥️ 백엔드 플랫폼

백엔드는 경제 전체를 운영하는 단일 Django 모놀리스입니다 — 예약, 에스크로, 크라우드펀딩 원장, 라이브 스트림, 마이닝, 그리고 움직이는 모든 엔과 모든 MTC.

프레임워크

Django 4.2 + Django REST Framework

비동기 작업

백그라운드 작업을 위한 Celery 태스크 큐

실시간

Django Channels WebSocket — 채팅, 라이브 인터랙션, 프레즌스

데이터베이스

PostgreSQL

라이브 영상

LiveKit, Hetzner에 셀프 호스팅 — 서드파티 스트리밍 의존성 없음

법정화폐 레일

카드와 Apple Pay는 Stripe; 셀러 온보딩과 정산은 Stripe Connect

결제 안전

상태를 변경하는 모든 결제 호출에 멱등성 키 필수

가격 책정

가격은 항상 서버 측에서 재계산 — 클라이언트는 결코 스스로 가격을 정할 수 없음

체인 접근

앱 → Django → Solana, 예외 없음

암호화폐 결제 플로우는 이 아키텍처 규칙이 실제로 작동하는 모습을 보여줍니다. 앱은 결코 Solana 트랜잭션을 스스로 구성하거나 검증하지 않습니다 — 사용자를 Phantom에게 넘기고, 증명을 Django에게 넘깁니다.

기본으로 견고하게

결제 도중 사용자가 중단되면 — 전화, 배터리 방전, 네트워크 끊김 — 앱은 다음 실행 시 보류 중인 Phantom 결제를 재개하고, 멱등성 키가 예약이 정확히 한 번만 정산되는 것을 보장합니다.

🔏 토큰 서비스 — 온디맨드 민팅

Solana를 실제로 건드리는 모든 것은 전용 3계층 스택(메인넷에서 라이브)이 처리합니다:

• 민팅 API (Django + DRF + Celery) — Matsuri, GCF, J-Times 플랫폼이 자동 NFT/SBT 발행, 토큰 작업, 온체인 메타데이터 관리를 위해 호출하는 API 키 인증 엔드포인트.
• Solana 사이너 (Node.js + Fastify) — 서명 능력을 보유한 유일한 서비스: SPL 토큰 생성·전송, 권한 소각, 메타데이터 업데이트, SBT 민팅, Metaplex Core Collection 관리, 인덱서 지연에 대한 재시도/백오프 내성 포함.
• 관리 대시보드 (Next.js) — 코인과 메타데이터 관리: 영구 메타데이터 호스팅을 위한 Arweave 업로드, 크리에이터 정보, 검증 플래그.

이것이 플랫폼의 실제 자산을 발행하는 스택입니다: 이벤트 참석 NFT 드롭, 御朱印(고슈인 — 사찰 인장) 오미쿠지 NFT, GCF Platinum SBT 인증서 — 모두 Phantom 같은 지갑이 제대로 표시하도록 컬렉션으로 묶인 Metaplex Core 자산이며, 모두 Solscan에서 검증할 수 있습니다.

🔐 보안 & 프라이버시

Keychain + 생체 인증

인증 토큰은 iOS Keychain에 암호화되어 저장되고, Face ID / Touch ID가 민감한 작업을 지킵니다.

핀 고정 전송 계층

앱과 백엔드 사이에 인증서 피닝을 적용한 전면 HTTPS.

키는 지갑을 떠나지 않습니다

플랫폼은 사용자의 프라이빗 키를 결코 보유하지 않습니다. 서명은 Phantom에 위임됩니다 — 앱이 요청을 전달하고, 지갑이 서명하고, 백엔드가 온체인에서 검증합니다.

리플레이 방지 지갑 연결

지갑을 계정에 연결하려면 서버가 발급한 새로운 챌린지에 서명해야 하므로, 탈취된 서명을 재사용해 남의 지갑을 가로챌 수 없습니다.

GPS 스푸핑 방지 게이트

참배 마이닝 체크인은 200 m 지오펜스, GPS 정확도·근접성 검사, 사용자당 장소당 하루 1회 체크인을 강제합니다 — 순간이동하는 봇은 아무것도 벌지 못합니다.

감사받는 자금 이동

MTC 잔액은 감사받는 추가 전용(append-only) 원장에 있으며, 셀프 커스터디 출금은 한도, 쿨다운, 사기 심사를 거칩니다.

✅ 엔지니어링 품질

827+앱 테스트모델, 뷰모델, 네트워크, 보안, E2E

43컨트랙트 테스트바이백 17 + 베스팅 26, 프로퍼티 테스트 포함

0빌드 경고Swift strict concurrency; clippy -D warnings 클린

3,426감사 범위 LOC프로덕션 Rust에 unwrap/panic 0건

Rust 컨트랙트는 앱보다 더 엄격한 기준을 스스로에게 적용합니다: clippy 경고 0건, 프로덕션 코드의 unwrap·panic 0건, 그리고 단위 테스트와 나란히 프로퍼티 기반 테스트 — 컨트랙트 코드는 일단 배포되면 화요일에 패치를 내보낼 수 없기 때문입니다.

⚖️ 스마트 컨트랙트 — 오픈소스 설계

정직한 상태 — 먼저 읽어주세요

오늘 온체인에 있는 것: MTC SPL 토큰(9억 개 고정, mint·freeze 권한 소각), 5.5억 MTC의 Streamflow 락업(클리프 2027-06-01), 초기 Raydium MTC/SOL LP, 그리고 프로덕션 앱의 Solana Pay / Phantom 결제 검증. 그 외에는 없습니다.

아래 프로그램들은 코드 완성 상태이며 어떤 클러스터에도 배포되지 않았습니다. 보안은 Hashlock과의 단계별 감사(2026년 4월, TEAMZ Summit Tokyo에서 개시)로 진행됩니다: Phase 1은 matsuri-buyback을 다룹니다 — 제출 패키지 완료, 킥오프 목표 2026년 8월, 발견 사항 9월, 최종 보고서 10월, 메인넷 배포 목표는 DEX 상장 이후인 2026년 10–12월. Phase 1.5는 matsuri-vesting과 matsuri-distribution을 2027년 1분기에 다루며, 2027-06-01 그랜드 언락 시점에 라이브됩니다. 우리는 이 중 어떤 것도 "감사 완료"라고 표현하지 않습니다 — 감사 준비가 완료되었고 단계별 감사가 진행 중입니다.

모든 컨트랙트 코드는 오픈소스입니다: github.com/Cootakahashi/matsuri-contracts. 보안은 은폐가 아니라 보이는 설계 위에 서 있습니다. 목표 아키텍처:

matsuri-buyback — 수익 인입구

바이백 약속 — Matsuri HQ 매출의 20%와 GCF 멤버십 회비의 25% — 을 온체인 MTC 수요로 바꾸는 프로그램입니다. 그 결정적 속성: 이것은 트레저리가 아니라 컨베이어입니다.

역할

수익을 MTC로 원자적으로 스왑 후 전달 — 화이트리스트 토큰 수취, 스왑, 전달

스왑 경로

CPI를 통한 Jupiter v6, 고정된 불변 Jupiter 프로그램 id

수취 토큰

출시 시점 MTC, USDC, SOL — 권한자가 화이트리스트 관리

슬리피지 방어

3중 계층: 런타임 bps ⊂ 불변 초기화 시 상한 ⊂ 컴파일 타임 하드 실링 10%

타임락

수취인·권한자 변경은 제안/실행/취소 플로우, 24시간–30일 범위

잔액을 보유하지 않음

모든 스왑 후 잔액 0 사후 조건 강제 — 트랜잭션 사이에 훔칠 것이 없음

규모 & 테스트

1,797 LOC, 17개 테스트 (단위 13 + 프로퍼티 4)

상태

코드 완성, Hashlock Phase 1 감사 대상 — 배포되지 않음

Phase 1에서 전달 수취인은 Squads 멀티시그이며, Phase 2에서는 수익을 LP 주입과 생태계 풀로 분배하는 Buyback Splitter가 됩니다.

matsuri-vesting — 하나의 금고, 하나의 수취인, 하나의 시계

그랜드 언락 일정을 실행하는 프로그램입니다. 의도적으로 지루합니다: 마이너도, 점수 계산도, 클레임도 없습니다 — 시계 위의 산수뿐입니다.

설계

하나의 금고, 타임락으로 보호되는 하나의 수취인, 하나의 시계

풀

2027-06-01 Streamflow 클리프에서 도착하는 5.5억 MTC

에포크

730일(2년) 에포크; 각 에포크는 남은 풀의 50%를 방출

방출 경로

advance_epoch_and_release는 무허가 크랭크 — 누구나 만기 방출을 트리거 가능

불변성

반감 계수, 에포크 길이, 총 풀은 초기화 시 잠기며 결코 변경 불가

규모 & 테스트

1,629 LOC, 26개 테스트 (단위 22 + 프로퍼티 4)

상태

코드 완성, Phase 1.5 감사 대상 (2027년 1분기) — 배포되지 않음

반감기 일정에포크 1 (2027–2029) ≈ 2.75억 → 에포크 2 (2029–2031) ≈ 1.375억 → 에포크 3 (2031–2033) ≈ 6,875만 MTC …

Phase 2 설계 레퍼런스

세 개의 추가 프로그램이 공개 설계 레퍼런스로 존재합니다 — 투명성을 위해 공개되었고, 배포용이 아님이 명시되어 있으며, 이후 감사 단계에서의 강화가 예정되어 있습니다:

프로그램	설계 의도
matsuri-worship	참배 라우팅 엔진 — 마이닝의 오버투어리즘 방지 배수의 온체인 대응물
matsuri-referral	En-Mining을 위한 縁(엔 — 인연) 추천 트리 — 마이닝
matsuri-distribution	마이너별 점수 계산이 있는 반감기 배분 — Phase 1.5 감사 범위로 다듬는 중

Phase 2의 Distribution Router(베스팅을 참배·추천·일반 풀로 분배)와 Buyback Splitter는 설계 단계뿐입니다. 각 프로그램이 감사 단계를 통과하기 전까지, 해당 로직은 Django에서 오라클로서 오프체인으로 돌아갑니다 — 같은 규칙이, 단계적으로 트러스트리스 실행으로 업그레이드됩니다.

공유 설계 원칙

• 모든 곳에 검사된 산술 — 검사되지 않은 연산 없음, 프로덕션 코드 경로의 unwrap·panic 0건.
• 순수 수학 모듈 — 보상·방출 계산은 부작용 없는, 빠짐없이 테스트된 math 모듈에 격리.
• 권력 분립 — 권한자는 범위가 제한된 타임락을 통해서만 변경을 제안할 수 있고, 일시정지는 프로그램을 멈출 뿐 자금을 옮기거나 압류할 수 없습니다.
• 불변의 경제 — 토큰의 희소성을 정의하는 파라미터는 의도적으로 초기화 시 잠깁니다.

앱은 출시되었습니다. 백엔드는 라이브 중입니다. 컨트랙트는 작성되고, 테스트되고, 감사를 기다리고 있습니다. 남은 것은 순서뿐입니다 — 로드맵이 그것을 날짜별로 펼쳐 보입니다.