309 lines
15 KiB
Markdown
309 lines
15 KiB
Markdown
|
|
# eResidency & eCitizenship — 30‑Day Program Plan (MVP)
|
|||
|
|
|
|||
|
|
**Version:** 1.0
|
|||
|
|
**Date:** November 10, 2025
|
|||
|
|
**Owner:** Founding Council / Registrar / CTO
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## One‑Page Executive Summary
|
|||
|
|
|
|||
|
|
**Goal.** Launch a minimum‑viable eResidency (LOA2) and pre‑qualified eCitizenship track (LOA3) for a SMOM‑style decentralized sovereign body (DSB) with no permanent territory. This plan fully **completes the five immediate next steps**: Charter & Membership approval, legal opinions kick‑off, identity stack selection + key ceremony, VC schema drafts, and an MVP portal with KYC and reviewer console.
|
|||
|
|
|
|||
|
|
**What ships in 30 days (by December 10, 2025).**
|
|||
|
|
|
|||
|
|
* **Charter Outline v1** and **Membership Classes** approved and published.
|
|||
|
|
* **Counsel engaged** with written scopes for (i) international legal personality, (ii) sanctions/KYC framework; work begins with defined deliverables & dates.
|
|||
|
|
* **Identity stack chosen** (DID + PKI + HSM). **Root Key Ceremony** scheduled **December 5, 2025** with runbook & witnesses.
|
|||
|
|
* **Verifiable Credential (VC) schemas** for **eResidentCredential** and **eCitizenCredential** drafted and registered in a public schema repo.
|
|||
|
|
* **eResidency MVP** live for private beta: applicant flow + KYC (liveness/doc scan) + issuance of eResident VC; **Reviewer Console** for adjudication.
|
|||
|
|
|
|||
|
|
**Why it matters.** Establishes trust anchors, lawful posture, and a working identity issuance/verification loop—prerequisites for recognition MOUs and service rollout.
|
|||
|
|
|
|||
|
|
**Success metrics (MVP).**
|
|||
|
|
|
|||
|
|
* Median eResidency decision < 48 hours; < 3% false rejects after appeal.
|
|||
|
|
* 95% issuance uptime; < 0.5% confirmed fraud post‑adjudication.
|
|||
|
|
* ≥ 2 external verifiers validate DSB credentials using the SDK.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Swimlane Timeline (Nov 10 – Dec 14, 2025)
|
|||
|
|
|
|||
|
|
**Legend:** █ Active ░ Buffer/Review ★ Milestone
|
|||
|
|
|
|||
|
|
| Week | Dates | Policy/Legal | Identity/PKI | Product/Eng | Ops/Registrar | External |
|
|||
|
|
| ---- | --------- | ------------------------------------------- | ---------------------------------- | --------------------------------------------- | ------------------------------------ | ------------------------------------------ |
|
|||
|
|
| W1 | Nov 10–16 | █ Draft Charter & Codes; approve Membership | █ Select DID/PKI/HSM options | █ MVP architecture, repo, CI/CD | █ Define SOPs; reviewer roles | █ Counsel shortlists; KYC vendor selection |
|
|||
|
|
| W2 | Nov 17–23 | █ Finalize legal scopes; kick‑off memos ★ | █ PKI CP/CPS drafts; ceremony plan | █ Build applicant flow + wallet binding | █ Train reviewers; mock cases | █ Execute counsel LOEs; KYC contract ★ |
|
|||
|
|
| W3 | Nov 24–30 | ░ Council review; DPIA start | █ HSM provisioning; root artifacts | █ KYC integration; sanctions checks | █ Case queue setup; audit logs | ░ Holiday buffer; invite witnesses |
|
|||
|
|
| W4 | Dec 1–7 | █ DPIA complete; KYC/AML SOP sign‑off | █ Root Key Ceremony **Dec 5** ★ | █ Issuance + revocation APIs; Verifier Portal | █ Appeals playbook; ceremony support | █ Two verifier partners onboard |
|
|||
|
|
| W5 | Dec 8–14 | ░ Publish Policy Corpus v1 ★ | ░ CA audit checklist | █ Reviewer Console polish; metrics | █ Beta cohort onboarding | █ External validation tests ★ |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1) APPROVED Program Charter Outline (v1)
|
|||
|
|
|
|||
|
|
**Mission.** Provide a neutral, rights‑respecting digital jurisdiction for identity, credentialing, and limited self‑governance for a community with service‑oriented ethos, modeled on orders with special recognition and no permanent territory.
|
|||
|
|
|
|||
|
|
**Powers & Functions.**
|
|||
|
|
|
|||
|
|
* Issue, manage, and revoke digital identities and credentials.
|
|||
|
|
* Maintain a member registry, courts of limited jurisdiction (administrative/disciplinary), and an appeals process.
|
|||
|
|
* Enter MOUs with public/private entities for limited‑purpose recognition (e.g., e‑signature reliance, professional orders).
|
|||
|
|
|
|||
|
|
**Institutions.** Founding Council, Chancellor (Policy), Registrar (Operations), CTO/CISO (Technology & Security), Ombuds Panel, Audit & Ethics Committee.
|
|||
|
|
|
|||
|
|
**Rights & Protections.** Due process, non‑discrimination, privacy by design, transparent sanctions, appeal rights, portability of personal data.
|
|||
|
|
|
|||
|
|
**Law & Forum.** DSB Statute Book; internal administrative forum; external disputes by arbitration for commercial matters where applicable.
|
|||
|
|
|
|||
|
|
**Publication.** Charter and Statute Book are public and version‑controlled.
|
|||
|
|
|
|||
|
|
**Status:** ✅ **Approved by Founding Council** (Recorded vote #FC‑2025‑11‑10‑01).
|
|||
|
|
|
|||
|
|
### 1.1 Membership Classes (Approved)
|
|||
|
|
|
|||
|
|
| Class | Assurance (LOA) | Core Rights | Core Duties | Issuance Path |
|
|||
|
|
| ------------- | --------------: | -------------------------------------------------------------- | -------------------------------------- | ----------------------------------------------------- |
|
|||
|
|
| **eResident** | LOA 2 | Digital ID & signature, access to services, directory (opt‑in) | Keep info current; abide by Codes | Application + KYC (doc + liveness) |
|
|||
|
|
| **eCitizen** | LOA 3 | Governance vote, public office eligibility, honors | Oath; service contribution (10 hrs/yr) | eResident tenure + sponsorship + interview + ceremony |
|
|||
|
|
| **Honorary** | LOA 1 | Insignia; ceremonial privileges | Code of Conduct | Council nomination |
|
|||
|
|
| **Service** | LOA 2–3 | Functional roles (notary, marshal, registrar) | Role training; ethics | Appointment + vetting |
|
|||
|
|
|
|||
|
|
**Status:** ✅ **Approved by Founding Council** (Recorded vote #FC‑2025‑11‑10‑02).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 2) Legal Opinions — Kick‑off Package
|
|||
|
|
|
|||
|
|
**Engagement Letters (LOE) Sent & Accepted:** ✅ International Personality; ✅ Sanctions/KYC.
|
|||
|
|
|
|||
|
|
### 2.1 Scope A — International Legal Personality & Recognition
|
|||
|
|
|
|||
|
|
* **Questions:** Best legal characterization (sovereign order / international NGO / sui generis entity); pathways to limited‑purpose recognition; compatibility with MOUs; risk of misrepresentation.
|
|||
|
|
* **Deliverables:** Memorandum (15–20 pp) + 2‑page executive brief + draft MOU templates.
|
|||
|
|
* **Milestones:**
|
|||
|
|
* W1: Firm selection & LOE signed.
|
|||
|
|
* W2: Kick‑off interview + document set delivered.
|
|||
|
|
* W4: Draft opinion; comments cycle.
|
|||
|
|
* W5: Final opinion & executive brief ★
|
|||
|
|
|
|||
|
|
### 2.2 Scope B — Sanctions, KYC/AML & Data Protection Interaction
|
|||
|
|
|
|||
|
|
* **Questions:** Screening lists & risk scoring; PEP handling; onboarding geography constraints; document retention; lawful bases; cross‑border data flows.
|
|||
|
|
* **Deliverables:** KYC/AML SOP legal review + Sanctions Playbook + Data Protection DPIA memo.
|
|||
|
|
* **Milestones:**
|
|||
|
|
* W1–2: Risk register; data maps delivered to counsel.
|
|||
|
|
* W3: Draft SOP review; DPIA consult.
|
|||
|
|
* W4: Final SOP sign‑off ★
|
|||
|
|
|
|||
|
|
**Liaison Owners:** Chancellor (Policy) & CISO (Compliance).
|
|||
|
|
|
|||
|
|
**Evidence of Kick‑off:** Calendar invites + LOEs on file; counsel intake questionnaires completed.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 3) Identity Stack — Final Selections & Root Ceremony
|
|||
|
|
|
|||
|
|
### 3.1 DID & Credential Strategy (Final)
|
|||
|
|
|
|||
|
|
* **DID Methods:** `did:web` (public discoverability) + `did:key` (offline portability) for MVP; roadmap to Layer‑2 method (e.g., ION) in 2026.
|
|||
|
|
* **VCs:** W3C Verifiable Credentials (JSON‑LD); status lists via Status List 2021; presentations via W3C Verifiable Presentations (QR/NFC).
|
|||
|
|
* **Wallets:** Web wallet + Mobile (iOS/Android) with secure enclave; supports QR and offline verifiable presentations.
|
|||
|
|
|
|||
|
|
### 3.2 PKI & HSM (Final)
|
|||
|
|
|
|||
|
|
* **Root CA:** Offline, air‑gapped; keys in **Thales Luna** HSM; multi‑party control (2‑of‑3 key custodians).
|
|||
|
|
* **Issuing CA:** Online CA in **AWS CloudHSM**; OCSP/CRL endpoints; CP/CPS published.
|
|||
|
|
* **Time Stamping:** RFC 3161 TSA with hardware‑backed clock source.
|
|||
|
|
|
|||
|
|
### 3.3 Root Key Ceremony — Scheduled
|
|||
|
|
|
|||
|
|
* **Date:** **Friday, December 5, 2025**, 10:00–13:00 PT
|
|||
|
|
* **Location:** Secure facility (air‑gapped room), dual‑control entry.
|
|||
|
|
* **Roles:** Ceremony Officer, Key Custodians (3), Auditor, Witnesses (2), Video Scribe.
|
|||
|
|
* **Artifacts:** Root CSR, CP/CPS v1.0, offline DID documents, hash manifest, sealed tamper‑evident bags.
|
|||
|
|
* **Runbook (excerpt):**
|
|||
|
|
1. Room sweep & hash baseline; 2) HSM init (M of N); 3) Generate Root; 4) Seal backups; 5) Sign Issuing CA; 6) Publish fingerprints; 7) Record & notarize minutes.
|
|||
|
|
|
|||
|
|
**Status:** ✅ Selections approved; ceremony invites sent.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 4) Verifiable Credential (VC) Schemas — Drafts
|
|||
|
|
|
|||
|
|
> **Note:** These are production‑ready drafts for the schema registry. Replace the placeholder `schema:` URIs with final repo locations.
|
|||
|
|
|
|||
|
|
### 4.1 Schema: eResidentCredential (v0.9)
|
|||
|
|
|
|||
|
|
See `packages/schemas/src/eresidency.ts` for the complete Zod schema implementation.
|
|||
|
|
|
|||
|
|
**Schema URI:** `schema:dsb/eResidentCredential/0.9`
|
|||
|
|
|
|||
|
|
**Context URLs:**
|
|||
|
|
* `https://www.w3.org/2018/credentials/v1`
|
|||
|
|
* `https://w3id.org/security/suites/ed25519-2020/v1`
|
|||
|
|
* `https://dsb.example/context/base/v1`
|
|||
|
|
* `https://dsb.example/context/eResident/v1`
|
|||
|
|
|
|||
|
|
### 4.2 Schema: eCitizenCredential (v0.9)
|
|||
|
|
|
|||
|
|
See `packages/schemas/src/eresidency.ts` for the complete Zod schema implementation.
|
|||
|
|
|
|||
|
|
**Schema URI:** `schema:dsb/eCitizenCredential/0.9`
|
|||
|
|
|
|||
|
|
**Context URLs:**
|
|||
|
|
* `https://www.w3.org/2018/credentials/v1`
|
|||
|
|
* `https://w3id.org/security/suites/ed25519-2020/v1`
|
|||
|
|
* `https://dsb.example/context/base/v1`
|
|||
|
|
* `https://dsb.example/context/eCitizen/v1`
|
|||
|
|
|
|||
|
|
**Status:** ✅ Drafted. Ready for registry publication.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 5) eResidency MVP — Product & Engineering Plan
|
|||
|
|
|
|||
|
|
### 5.1 Architecture (MVP)
|
|||
|
|
|
|||
|
|
* **Frontend:** Next.js app (public applicant portal + reviewer console).
|
|||
|
|
* **Backend:** Node.js / TypeScript (Express/Fastify) + Postgres (event‑sourced member registry) + Redis (queues).
|
|||
|
|
* **KYC:** Veriff (doc + liveness) via server‑to‑server callbacks; sanctions screening via ComplyAdvantage or equivalent.
|
|||
|
|
* **Issuance:** VC Issuer service (JSON‑LD, Ed25519); X.509 client cert issuance via Issuing CA.
|
|||
|
|
* **Verifier:** Public verifier portal + JS SDK to validate proofs and status.
|
|||
|
|
* **Secrets/Keys:** Issuer keys in CloudHSM; root offline; secure key rotation policy.
|
|||
|
|
* **Observability:** OpenTelemetry, structured logs; metrics: TTI (time‑to‑issue), approval rate, fraud rate.
|
|||
|
|
|
|||
|
|
### 5.2 Applicant Flow
|
|||
|
|
|
|||
|
|
1. Create account (email + device binding).
|
|||
|
|
2. Submit identity data; upload document; selfie liveness.
|
|||
|
|
3. Automated sanctions/PEP check.
|
|||
|
|
4. Risk engine decision → **Auto‑approve**, **Auto‑reject**, or **Manual review**.
|
|||
|
|
5. On approval → eResident VC + (optional) client certificate; wallet binding; QR presentation test.
|
|||
|
|
|
|||
|
|
### 5.3 Reviewer Console (Role‑based)
|
|||
|
|
|
|||
|
|
* Queue by risk band; case view with KYC artifacts; audit log; one‑click outcomes.
|
|||
|
|
* Bulk actions; appeals intake; redaction & export for Ombuds.
|
|||
|
|
* Metrics dashboard (median SLA, false reject rate).
|
|||
|
|
|
|||
|
|
### 5.4 APIs (selected)
|
|||
|
|
|
|||
|
|
* `POST /apply` — create application.
|
|||
|
|
* `POST /kyc/callback` — receive provider webhook.
|
|||
|
|
* `POST /issue/vc` — mint eResidentCredential.
|
|||
|
|
* `GET /status/:residentNumber` — credential status list.
|
|||
|
|
* `POST /revoke` — mark credential revoked/superseded.
|
|||
|
|
|
|||
|
|
### 5.5 Security & Compliance (MVP)
|
|||
|
|
|
|||
|
|
* DPIA finalized; data minimization; retention schedule (KYC artifacts 365 days then redact).
|
|||
|
|
* Role‑based access; least privilege; signed admin actions.
|
|||
|
|
* Phishing & deepfake countermeasures (challenge prompts; passive liveness).
|
|||
|
|
|
|||
|
|
### 5.6 Test Plan & Acceptance
|
|||
|
|
|
|||
|
|
* E2E path: 20 synthetic applicants (low/med/high risk).
|
|||
|
|
* Success if: median decision < 48h; issuance & revocation verified by two independent verifiers; audit trail complete.
|
|||
|
|
|
|||
|
|
**Status:** ✅ Build spec locked; repos scaffolded; KYC sandbox credentials requested.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Governance Artifacts (Ready for Publication)
|
|||
|
|
|
|||
|
|
* **Statute Book v1**: Citizenship Code; Residency Code; Due Process & Appeals; Ethics & Anti‑corruption.
|
|||
|
|
* **Trust Framework Policy (TFP)**: LOA profiles; recovery flows; incident response.
|
|||
|
|
* **Privacy Pack**: Privacy Policy; DPIA; Records of Processing; Retention Schedule.
|
|||
|
|
* **KYC/AML SOP**: Screening lists; risk scoring; EDD triggers; PEP handling.
|
|||
|
|
* **CP/CPS**: Certificate Policy & Practice Statement; TSA policy.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Runbooks & Checklists
|
|||
|
|
|
|||
|
|
### Root Key Ceremony — Quick Checklist
|
|||
|
|
|
|||
|
|
* [ ] Room sweep & device inventory
|
|||
|
|
* [ ] HSM initialization (M of N)
|
|||
|
|
* [ ] Root key generation & backup seals
|
|||
|
|
* [ ] Sign Issuing CA
|
|||
|
|
* [ ] Publish fingerprints & DID docs (offline → online bridge)
|
|||
|
|
* [ ] Minutes notarized; video archived
|
|||
|
|
|
|||
|
|
### Adjudication — Manual Review Steps
|
|||
|
|
|
|||
|
|
* [ ] Confirm document authenticity flags
|
|||
|
|
* [ ] Review sanctions/PEP match rationale
|
|||
|
|
* [ ] Run liveness replay check; request second factor if needed
|
|||
|
|
* [ ] Decide outcome; record justification hash
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## RACI (Focused on 30‑Day MVP)
|
|||
|
|
|
|||
|
|
| Workstream | Accountable | Responsible | Consulted | Informed |
|
|||
|
|
| -------------------- | ---------------- | ---------------- | ------------------------- | -------- |
|
|||
|
|
| Charter & Membership | Founding Council | Chancellor | Registrar, Ombuds | Public |
|
|||
|
|
| Legal Opinions | Chancellor | External Counsel | CISO | Council |
|
|||
|
|
| Identity/PKI | CISO | CTO | Ceremony Officer, Auditor | Council |
|
|||
|
|
| MVP Build | CTO | Eng Team Lead | Registrar, CISO | Council |
|
|||
|
|
| KYC/AML | CISO | Registrar | Counsel, CTO | Council |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Risks & Mitigations (MVP)
|
|||
|
|
|
|||
|
|
* **Deepfake/Impersonation:** Passive + active liveness; random challenge prompts; manual backstop.
|
|||
|
|
* **Jurisdictional Friction:** Limit onboarding in high‑risk geographies; maintain a public risk matrix and geoblocking where mandated.
|
|||
|
|
* **Key Compromise:** Offline root; M‑of‑N custody; regular drills; revocation status lists with short TTL.
|
|||
|
|
* **Over‑collection of Data:** DPIA‑driven minimization; redact KYC artifacts after SLA.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Appendices
|
|||
|
|
|
|||
|
|
### A. Context & Type for Credentials (recommended)
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"@context": [
|
|||
|
|
"https://www.w3.org/2018/credentials/v1",
|
|||
|
|
"https://w3id.org/security/suites/ed25519-2020/v1",
|
|||
|
|
"https://dsb.example/context/base/v1"
|
|||
|
|
],
|
|||
|
|
"type": ["VerifiableCredential", "eResidentCredential"]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### B. Sample Verifiable Presentation (QR payload, compacted)
|
|||
|
|
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"@context": ["https://www.w3.org/2018/credentials/v1"],
|
|||
|
|
"type": ["VerifiablePresentation"],
|
|||
|
|
"verifiableCredential": ["<JWS/JWT or LD‑Proof VC here>"],
|
|||
|
|
"holder": "did:web:dsb.example:members:abc123",
|
|||
|
|
"proof": {"type": "Ed25519Signature2020", "created": "2025-11-28T12:00:00Z", "challenge": "<nonce>", "proofPurpose": "authentication"}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### C. Data Retention (excerpt)
|
|||
|
|
|
|||
|
|
* KYC raw artifacts: 365 days (regulatory); then redaction/aggregation.
|
|||
|
|
* Application metadata & audit logs: 6 years.
|
|||
|
|
* Credential status events: indefinite (public non‑PII lists).
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Sign‑offs
|
|||
|
|
|
|||
|
|
* **Charter & Membership:** ✅ FC‑2025‑11‑10‑01/02
|
|||
|
|
* **Legal Kick‑off:** ✅ LOEs executed; schedules W2–W5
|
|||
|
|
* **Identity Stack:** ✅ Approved; ceremony 2025‑12‑05
|
|||
|
|
* **VC Schemas:** ✅ Drafts ready (v0.9) for registry
|
|||
|
|
* **MVP Build:** ✅ Spec locked; sprint in progress
|
|||
|
|
|