JIL Sovereign Architecture Reference

Version: DEVNET-GA-1 Last Updated: January 30, 2026 Status: Production Ready (Devnet)

This document provides a comprehensive overview of the JIL Sovereign system architecture, covering the complete technology stack from L1 blockchain to microservices.

Executive Summary

Table of Contents

1. System Overview
2. L1 Blockchain Layer
3. Compliance & Policy Engine
4. Proof Layer
5. Trading & Liquidity
6. Wallet & Account Management
7. Security & Cryptography
8. Deployment Architecture
9. Documentation Index

1. System Overview

Architecture Diagram

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           JIL SOVEREIGN L1 STACK                                 │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                  │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                         APPLICATION LAYER                                │    │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐      │    │
│  │  │wallet-ui │ │wallet-api│ │launchpad │ │explorer  │ │telemetry │      │    │
│  │  │ (Next.js)│ │(Express) │ │   -api   │ │   -api   │ │   -ui    │      │    │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘      │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                      │                                           │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                           PROOF LAYER (14 services)                      │    │
│  │  proof-gateway │ proof-verifier │ proof-orchestrator │ proof-bulletin   │    │
│  │  proof-mesh    │ proof-capsule  │ proof-redactor     │ zk-receipts      │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                      │                                           │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                        COMPLIANCE LAYER (10 services)                    │    │
│  │  compliance-api │ corridor-switchboard │ consent-killswitch              │    │
│  │  policy-registry│ ledger-compliance    │ fraud-firewall                  │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                      │                                           │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                         TRADING LAYER (11 services)                      │    │
│  │  dex-order-manager │ rfq-service │ settlement-router │ pool-bootstrapper│    │
│  │  liquidity-*       │ ramps-api   │                                       │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                      │                                           │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                      L1 BLOCKCHAIN CORE (Rust)                           │    │
│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐  ┌────────────┐         │    │
│  │  │jil5600-core│  │  jil-abci  │  │   jil-vm   │  │ ammv5-core │         │    │
│  │  │  (State)   │  │(Consensus) │  │    (VM)    │  │   (DEX)    │         │    │
│  │  │  5 tests ✅ │  │ 43 tests ✅ │  │ integrated │  │ integrated │         │    │
│  │  └────────────┘  └────────────┘  └────────────┘  └────────────┘         │    │
│  │  ┌────────────┐  ┌────────────┐  ┌────────────┐  ┌────────────┐         │    │
│  │  │ jil-zones  │  │jil-identity│  │jil-tokens  │  │jil-factory │         │    │
│  │  │  (Policy)  │  │  (KYC/KYB) │  │  (JIL20)   │  │  (Deploy)  │         │    │
│  │  │  5 tests ✅ │  │ integrated │  │ integrated │  │ integrated │         │    │
│  │  └────────────┘  └────────────┘  └────────────┘  └────────────┘         │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                      │                                           │
│  ┌─────────────────────────────────────────────────────────────────────────┐    │
│  │                        INFRASTRUCTURE                                    │    │
│  │  CometBFT (Consensus) │ Kafka (Events) │ PostgreSQL │ Redis │ Vault     │    │
│  └─────────────────────────────────────────────────────────────────────────┘    │
│                                                                                  │
└─────────────────────────────────────────────────────────────────────────────────┘

Technology Stack

2. L1 Blockchain Layer

Core Components

Zone Architecture

pub enum ZoneKind {
    Protected,    // Full KYC, passkey auth, MPC cosigning
    Unprotected,  // Permissionless, crypto-native
    Quarantine,   // Lifeline transfers only
    Internal,     // System accounts
    External,     // Bridge/external chains
}

Validator Slashing

3. Compliance & Policy Engine

Services

Policy Decision Flow

Transaction
    │
    ▼
[Zone Policy] ──► Check zone restrictions
    │
    ▼
[Identity Check] ──► Verify KYC/KYB status
    │
    ▼
[Compliance Engine] ──► Evaluate rules
    │
    ├── ALLOW ──► Execute transaction
    ├── DENY ──► Reject with reason
    └── REVIEW ──► Queue for manual review

Containment Levels

4. Proof Layer

Services (14 Core)

Proof Pack Structure

proof_pack
├── tx_id
├── corridor_policy
├── policy_chain
├── policy_receipt (signed)
├── policy_anchors
├── external_anchors
├── verification
├── quorum
├── bulletin
└── bulletin_checkpoint

Trust Score Weights

5. Trading & Liquidity

AMM V5 Features

Fee Structure

Trading Services

6. Wallet & Account Management

Services

Recovery Ceremony

PENDING
    │
    ▼ [Quorum Met: 2-of-3 guardians]
TIMELOCK (30s default)
    │
    ▼ [Timelock Elapsed]
ACTIVATED ──► Key rotation executed

7. Security & Cryptography

Production Safety

All services include production safety checks that block startup with devnet secrets:

const IS_PRODUCTION = ["production", "mainnet", "prod"].includes(
  (process.env.JIL_ENV || process.env.NODE_ENV || "").toLowerCase()
);

function validateSecret(name, value) {
  if (IS_PRODUCTION && value.toLowerCase().includes("devnet")) {
    console.error(`FATAL: Cannot start with devnet secret: ${name}`);
    process.exit(1);
  }
}

Cryptographic Services

Signature Schemes

8. Deployment Architecture

Directory Structure

deploy/
├── bin/              # 87 pre-compiled services
│   └── <service>/
│       ├── index.js        # Compiled JavaScript
│       ├── package.json    # Dependencies
│       ├── Dockerfile      # Container build
│       ├── docker-compose.yml
│       └── k8s/            # Kubernetes manifests
├── config/           # Environment templates
├── docker/           # Docker build files
├── helm/             # Helm charts
├── k8s/              # Global K8s manifests
├── terraform/        # Infrastructure as code
└── lib/              # Shared libraries
    ├── startup-validation/   # Production safety
    ├── secrets-manager/      # Vault/AWS integration
    └── proof-verification/   # ZK verification

Multi-Jurisdiction Deployment

┌─────────────┐    ┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ SWITZERLAND │    │  SINGAPORE  │    │    ADGM     │    │     USA     │
│  (Primary)  │    │             │    │             │    │             │
├─────────────┤    ├─────────────┤    ├─────────────┤    ├─────────────┤
│ Ledger (P)  │    │ Validator   │    │ Validator   │    │ Validator   │
│ Compliance  │    │ Wallet API  │    │ Wallet API  │    │ Wallet API  │
│ Proof Store │    │ MPC Node    │    │ MPC Node    │    │ MPC Node    │
└──────┬──────┘    └──────┬──────┘    └──────┬──────┘    └──────┬──────┘
       │                  │                  │                  │
       └──────────────────┼──────────────────┼──────────────────┘
                          │
                   ┌──────┴──────┐
                   │ GLOBAL MESH │
                   │  Kafka/DNS  │
                   └─────────────┘

Service Tiers

9. Documentation Index

Core Guides

Key File Locations

Appendix: Test Summary

This document is the property of GIC Foundation, Inc. (TX). All Rights Reserved. 2025 Patent Pending.