feat: SolaceNet gateway rails, IRU marketplace hardening, and docs
- Gateway adapter registry, rails routes, optional SOLACENET_GATEWAY_RAILS_ENFORCE; HTTP integration tests. - IRU marketplace: rate limits, public routes, notifications/SMTP env docs; marketplace UI constants and flows. - Quantum proxy legacy protocol types; debank/tezos/GSDS touch-ups; .env.example operator notes. - SolaceNet doc set (gaps, runbooks, telecom schema example). Tests: npm run test:iru-marketplace, npm run test:gateway (pass). Note: full-repo tsc still reports unrelated legacy errors outside this change set. Made-with: Cursor
This commit is contained in:
defiQUG
59
docs/solacenet/public/GAPS_AND_INCONSISTENCIES.md
Normal file
59
docs/solacenet/public/GAPS_AND_INCONSISTENCIES.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# SolaceNet — gaps and inconsistencies (consolidated)
|
||||
|
||||
**Purpose:** Single list of **protocol gaps**, **product/documentation mismatches**, and **structural inconsistencies** relevant to SolaceNet, gateway rails, and public messaging. For **actionable gap IDs** and close criteria, use [PROTOCOL_GAPS_CHECKLIST.md](../PROTOCOL_GAPS_CHECKLIST.md). For a **delta audit** (missing CI, naming drift, dual edge), see [AUDIT_GAPS_INCONSISTENCIES_MISSING.md](../AUDIT_GAPS_INCONSISTENCIES_MISSING.md).
|
||||
|
||||
**Last updated:** 2026-04-07
|
||||
|
||||
---
|
||||
|
||||
## 1. Protocol and implementation gaps (summary)
|
||||
|
||||
- **Carrier signaling (SS7/SIGTRAN/MAP/CAP/Diameter):** Not implemented in application repos; only a **northbound integration contract** is in scope for SolaceNet if a telecom boundary service is added.
|
||||
- **All TypeScript gateway rail adapters** under `src/core/gateway/adapters/` remain **scaffolds** (synthetic success or evidence-only stubs) until replaced with live connectors.
|
||||
- **KTT evidence adapter:** `send` is explicitly unsupported; **validate** is trivial; no system-of-record match.
|
||||
- **DBIS Rail on-chain contracts** (RootRegistry, ParticipantRegistry, SignerRegistry, SettlementRouter, GRU_MintController): **not deployed** per Proxmox DBIS Rail master status; **owner mint** vs **router-only mint** remains a gap.
|
||||
- **Quantum / QPS** — **Partial:** `LegacyProtocol` now includes SolaceNet-aligned rails (KTT evidence, TT, DTC/DTCC, gpi, Mojaloop, RTGS, card); scoring remains **scaffold** until field contracts are frozen.
|
||||
- **Admin dashboards** (`gas-qps`, `global-overview`, `scb-overview`): **placeholder** rail metrics and profiles.
|
||||
- **RTGS / external bank protocols:** Many matrix rows **Planned** or **Partial** (Mojaloop, BNI, correspondent/SWIFT live contracts, ISO evidence packages, etc.)—see `docs/03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md` in the Proxmox repo.
|
||||
|
||||
---
|
||||
|
||||
## 2. Inconsistencies (architecture and naming)
|
||||
|
||||
| Topic | Issue |
|
||||
|--------|--------|
|
||||
| **Dual adapter systems** | **Mitigated (doc):** [PLUGIN_AND_GATEWAY_BRIDGE.md](../PLUGIN_AND_GATEWAY_BRIDGE.md). **Remaining:** optional facade in code if one physical connector serves both shapes. |
|
||||
| **KTT vs other rails** | Marketplace lists **KTT Legacy** next to full **send/receive** rails; code is **evidence-only** and **send** fails by design. |
|
||||
| **Synthetic success** | SWIFT FIN / TT scaffolds return **SENT** without network I/O; **KTT** returns **FAILED** on send—mixed semantics for “outbox” testing. |
|
||||
| **Thirdweb in gateway folder** | Shares adapter plane with **bank rails**; not a messaging rail—boundary should stay documented for integrators. |
|
||||
| **Offering copy vs reality** | `gateway-microservices-offering.json` describes a regulated fabric; **implementations are not production-grade** connectors yet. |
|
||||
| **QPS dashboard “SWIFT” volume** | Derived from `iso_messages` heuristics (`messageType.includes('SWIFT')`)—**not** true SWIFT FIN volume. |
|
||||
|
||||
---
|
||||
|
||||
## 3. Public web and documentation gaps
|
||||
|
||||
| Topic | Issue |
|
||||
|--------|--------|
|
||||
| **info.defi-oracle.io** | **Mitigated:** `/solacenet` SPA page and nav link; `agent-hints.json`, `sitemap.xml`, `llms.txt`, and `verify:info-defi-oracle-public` updated. Deep technical docs remain in repo markdown only. |
|
||||
| **Cross-repo discovery** | **Mitigated:** `docs/04-configuration/SOLACENET_PUBLIC_HUB.md` indexes public web + `dbis_core/docs/solacenet/`. |
|
||||
| **Agent hints / sitemap** | Ongoing hygiene: any **new** public routes must update the same artifacts. |
|
||||
|
||||
---
|
||||
|
||||
## 4. Recommended next steps (ordered)
|
||||
|
||||
1. Keep **PROTOCOL_GAPS_CHECKLIST.md** statuses current as code changes.
|
||||
2. Enforce **SolaceNet capability checks** on any new rail ingress path.
|
||||
3. Replace scaffolds **rail-by-rail** with sandbox then production connectors; update **public** pages to reflect “generally available” only when true.
|
||||
4. Unify or document **PluginRegistry ↔ gateway adapters** with one facade.
|
||||
5. Align **quantum** protocol enums with **marketplace** rails or explicitly exclude them.
|
||||
|
||||
---
|
||||
|
||||
## Related documents
|
||||
|
||||
- [PROTOCOL_GAPS_CHECKLIST.md](../PROTOCOL_GAPS_CHECKLIST.md)
|
||||
- [RAIL_AND_PROTOCOL_GOVERNANCE.md](../RAIL_AND_PROTOCOL_GOVERNANCE.md)
|
||||
- Proxmox: [DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md](../../../../docs/03-deployment/DBIS_RTGS_E2E_REQUIREMENTS_MATRIX.md)
|
||||
- Proxmox: [DBIS_RAIL_AND_PROJECT_COMPLETION_MASTER_V1.md](../../../../docs/dbis-rail/DBIS_RAIL_AND_PROJECT_COMPLETION_MASTER_V1.md)
|
||||
39
docs/solacenet/public/OVERVIEW.md
Normal file
39
docs/solacenet/public/OVERVIEW.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# SolaceNet — public overview
|
||||
|
||||
**Audience:** Institutions, integrators, and supervisors evaluating how **capabilities, policy, and rails** are governed in the DBIS Core stack. This page is **non-operational**: it does not expose credentials, internal endpoints, or live tenant data.
|
||||
|
||||
---
|
||||
|
||||
## What SolaceNet is
|
||||
|
||||
**SolaceNet** is the **capability and control plane** in DBIS Core: it registers **what** product functions may run (payment gateway, tokenization, limits, fees, **gateway microservices / rail adapters**), for **whom** (tenant, program, region, channel), and under **which policy** (allow/deny, kill switch, audit). The **Go API gateway** (`dbis_core/gateway/go/`) can enforce capability checks at the edge before traffic reaches Node services.
|
||||
|
||||
**Rail and messaging protocols** (for example SWIFT families, DTC/DTCC, telegraphic transfer routes, legacy evidence ingest such as KTT) are **maintained under SolaceNet**—see internal governance: `docs/solacenet/RAIL_AND_PROTOCOL_GOVERNANCE.md`.
|
||||
|
||||
---
|
||||
|
||||
## What the public should expect
|
||||
|
||||
| Topic | Public | Authenticated / contract |
|
||||
|--------|--------|---------------------------|
|
||||
| **Existence and scope** of SolaceNet | Yes — this document and the info hub page | — |
|
||||
| **Capability names and high-level behavior** | Summarized | Full API schemas and runbooks |
|
||||
| **Rail adapter wire protocols** | Described at category level only | Message formats, endpoints, keys, IPs |
|
||||
| **Production status** | “Integration in progress” where adapters are scaffolds | Environment-specific readiness |
|
||||
| **Chain 138 settlement** | Via [info.defi-oracle.io](https://info.defi-oracle.io) hub and explorer | DBIS Rail / RTGS runbooks (restricted) |
|
||||
|
||||
---
|
||||
|
||||
## Related reading (repository)
|
||||
|
||||
- **Governance:** `dbis_core/docs/solacenet/RAIL_AND_PROTOCOL_GOVERNANCE.md`
|
||||
- **Protocol gap tracking:** `dbis_core/docs/solacenet/PROTOCOL_GAPS_CHECKLIST.md`
|
||||
- **Gaps and inconsistencies (product/doc):** `dbis_core/docs/solacenet/public/GAPS_AND_INCONSISTENCIES.md`
|
||||
- **Operator quick reference:** `dbis_core/SOLACENET_QUICK_REFERENCE.md`
|
||||
- **Proxmox public hub pointer:** `docs/04-configuration/SOLACENET_PUBLIC_HUB.md`
|
||||
- **Authenticated API (integrators):** `GET /api/v1/gateway/rails` and related routes on DBIS Core (see `gateway.routes.ts`); optional `SOLACENET_GATEWAY_RAILS_ENFORCE` — `dbis_core/.env.example`
|
||||
|
||||
---
|
||||
|
||||
**Version:** 1.0
|
||||
**Last updated:** 2026-04-07
|
||||
12
docs/solacenet/public/README.md
Normal file
12
docs/solacenet/public/README.md
Normal file
@@ -0,0 +1,12 @@
|
||||
# SolaceNet — public documentation (markdown)
|
||||
|
||||
Markdown in this folder is the **canonical source** for public-facing SolaceNet narrative. The live **web** summary is published on **https://info.defi-oracle.io/solacenet** (see `info-defi-oracle-138` in the Proxmox repo).
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| [OVERVIEW.md](OVERVIEW.md) | What SolaceNet is; public vs authenticated expectations; repo pointers |
|
||||
| [GAPS_AND_INCONSISTENCIES.md](GAPS_AND_INCONSISTENCIES.md) | Consolidated gaps and doc/product inconsistencies |
|
||||
|
||||
**Internal** (not necessarily reproduced on the public site): [RAIL_AND_PROTOCOL_GOVERNANCE.md](../RAIL_AND_PROTOCOL_GOVERNANCE.md), [PROTOCOL_GAPS_CHECKLIST.md](../PROTOCOL_GAPS_CHECKLIST.md), [REMAINING_TASKS_FULL_LIST.md](../REMAINING_TASKS_FULL_LIST.md) (prioritized backlog), [AUDIT_GAPS_INCONSISTENCIES_MISSING.md](../AUDIT_GAPS_INCONSISTENCIES_MISSING.md) (delta audit), [PLUGIN_AND_GATEWAY_BRIDGE.md](../PLUGIN_AND_GATEWAY_BRIDGE.md).
|
||||
|
||||
**Operator index:** `docs/04-configuration/SOLACENET_PUBLIC_HUB.md` (Proxmox repo root).
|
||||
Reference in New Issue
Block a user