Technical DeepDive

1. User & Identity Layer
Social (Login/Signup): creates frictionless in-app wallets, boots the paymaster config, triggers SBT mint flow.
In-App Wallet: abstracted wallet UX; users do not need external wallets.
SBT Identity Contract: mints a non-transferable SBT as on-chain identity/DID. Used as an attestable credential for provisioning and entitlement checks.
Label: minimum-KYC* (asterisk → see compliance footnote).
2. Frontend (Vercel, TypeScript)
Handles signup/login, plan browsing, purchase flow, activation QR, device pairing, and status UI.
Propagates intent_id with each operation for correlation.
Interacts with Paymaster for gasless meta-transactions (frontend triggers payment or relayed calls).
3. Paymaster & social login Facilities
Paymaster: gas sponsorship for meta-txs, used for UX (user doesn’t need gas).
Top-up semantics: paymaster can be topped-up by user (optional) or by GeSIM (promotional). Paymaster operations are instrumented and fees (gas margin) flow to protocol revenue.
Feature Set (in-app wallet + top-up + key extraction option): users may optionally extract their private keys/seed phrase (explicit UX flow).
4. Backend / Orchestration (Node.js on Render + Supabase)
Core microservices: Intent Manager, Provisioner, Metering Engine, Smart Switch Engine, Billing Engine, Relayer Controller.
Supabase DB: stores only non-PII metadata (plans, intent states, profile hashes, session hashes). No PII stored (No-KYC).
Relayer / Indexer connector: watches on-chain events, pushes proofs to contracts, and ingests signed provisioning receipts.
5. AI Layer — Optimization & Insights (new)
Inputs: network telemetry (signal/QoS), active users per region, usage patterns, historical profile success, pricing data, carrier SLAs.
Functions: run Smart Network Switch decisions (choose best carrier + timing), price optimization (spot vs fixed), anomaly detection (fraud), predictive provisioning (pre-warm profiles).
Outputs: recommended carrier, switch intent, preferred pricing, real-time feed to Backend and Observability.
Privacy: uses hashed/aggregated signals (no PII), and can use secure enclaves/DP techniques for privacy.
6. Telecom Integration Layer
EsimAccess (SM-DP+): Profile creation and profile delivery.
SM-DP+, SM-DS, RSP: clearly represented as separate subcomponents in Telecom box:
SM-DP+ — Data Preparation and storage; generates encrypted eSIM profile packages.
SM-DS — Subscription Manager – Data Storage / Security functions (if applicable for secure descriptor storage).
RSP — Remote SIM Provisioning protocol used by device to fetch profiles.
Flows: Backend triggers SM-DP+ to prepare profiles; SM-DP+ signs provisioning receipts. RSP used by device to download. SM-DP+/SM-DS connect to carriers (MNO/MVNO).
7. Blockchain & Payments Layer
SBT Contract (identity) and Escrow / Intent Contract (createIntent, fundIntent, releaseToCarrier, refund).
Settlement Contract: merkle roots, usage commits, periodic settle.
Pay-on-Usage Contract: accepts usage proofs and releases payments pro-rata.
Safe.global: multisig treasury for protocol fees, batched payouts, and fiat conversion orchestration.
Stable staking (e.g., USDC pools) for liquidity providers.
Option: FHE / INCO (experimental): privacy-preserving payment channel to MNOs - provide as advanced feature where MNO supports FHE/INCO-style protocol for encrypted settlement (note: advanced R&D item).
8. Settlement & Billing Layer
Pay-as-You-Go Billing Engine: back-end microservice that aggregates usage, creates merkle roots, posts usageCommitment to chain.
Payout flow: Settlement contract triggers transfer to MNO address (stablecoin) → Safe.global for fiat conversion.
Paymaster interactions: Paymaster covers gas for users in purchase UX; fees and paymaster margin are recorded and a % flows to protocol treasury.
9. Observability / OSS-BSS / Dashboards
Dashboards: User, Carrier, Finance (payouts), Developer.
Logs: immutable signed provisioning receipts and merkle roots; store cryptographic proofs off-chain (hashed) and on-chain anchors.
AI telemetry feeds into dashboards for analytical views, SLAs, and enforcement.
10. External Verifiability (EigenLayer, Oracles, Relayers)
EigenLayer (or similar) for staking/verifiable compute to back off-chain attestations (prove relayer honesty or indexer proofs).
Oracles: exchange rates, sanctions lists, external compliance signals.
Relayers: meta-tx relayers (funded via Paymaster) to submit proofs & sign transactions.
Last updated