Files
defiQUG 849e6a8357
Some checks failed
CI / test (push) Has been cancelled
CI / security (push) Has been cancelled
CI / build (push) Has been cancelled
Initial commit
2025-12-12 15:02:56 -08:00

80 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# DBIS Global Payments Network (GPN)
## Overview
The DBIS Global Payments Network (GPN) is the universal, sovereign-grade payment network connecting 33 Sovereign Central Banks, private banks, CBDC wallets, commodity token networks, and security token infrastructures.
## Architecture
### Layer 1 Sovereign Access Layer
- SCB nodes authenticate via SDIP (Sovereign Digital Identity Passport)
- Sovereign traffic segmented by identity
- Zero-trust authentication
**Service**: `gpn-sovereign-access.service.ts`
**API Endpoint**: `POST /api/v1/gpn/authenticate`
### Layer 2 Global Switching Layer
- DBIS switch routes payments using:
- FX cost optimization
- Liquidity availability
- SRI-based risk weighting
**Service**: `gpn-switching.service.ts`
**API Endpoint**: `POST /api/v1/gpn/route`
### Layer 3 Finality Layer
- Atomic settlement achieved when:
- SCB ledger posts
- DBIS Master Ledger posts
- Hash-lock matches
**Service**: `gpn-finality.service.ts`
**API Endpoints**:
- `POST /api/v1/gpn/finality` - Verify finality
- `POST /api/v1/gpn/hash-lock` - Create hash-lock
## Supported Payment Types
- Person → Person (rCBDC)
- Bank → Bank (wCBDC)
- SCB → SCB (institutional payments)
- Commodity-backed payments (CDT → CBDC)
- Security-linked payments
- Cross-chain payments (multi-ledger)
## Messaging Standards
GPN uses ISO 20022 messages wrapped in Sovereign Message Envelope (SME):
- PACS.008 - FI to FI Credit Transfer
- PACS.002 - Payment Status Report
- FXMT.003 - FX Trade Execution Report
- CBDC_TX - CBDC transaction messages
- SCB_NOTIFY - SCB notification messages
- DBIS_COMMIT - DBIS commitment messages
**Service**: `gpn-message-handler.service.ts`
**API Endpoint**: `POST /api/v1/gpn/message/pacs008`
## Database Models
- `GpnPayment` - Payment routing records
- `GpnRoute` - Routing paths with cost/risk metrics
- `GpnSettlementLock` - Hash-lock records for finality
## Integration Points
- ISO 20022 service (existing)
- SIRE routing (existing)
- GSS Master Ledger (existing)
- SDIP identity (Volume V)