Skip to content

Commit 5c96341

Browse files
author
Yennefer
committed
docs: Public URLs and connections reference
PUBLIC DOMAINS (Cloudflare Zero-Trust): - yennefer.quest (7 subdomains) - genesisconductor.io (3 subdomains) SERVICES: - 7 active Cloudflare ingress routes - 10 local ports (8000-8301) - 2 MCP servers (stdio) - 6 A2A API endpoints - 4 REST API groups - 2 blockchain networks AUTHENTICATION: - Capability tokens (HMAC-SHA256) - Ed25519 signatures - Fernet encryption - TLS 1.3 (Cloudflare) CONNECTIONS: - Zero-trust tunnel (no exposed ports) - WebSocket feeds - P2P consciousness network - Stripe payment integration - Blockchain event listener
1 parent 74fa17d commit 5c96341

1 file changed

Lines changed: 348 additions & 0 deletions

File tree

‎.yennefer/diamond_vault/PUBLIC_URLS_AND_CONNECTIONS.md‎

Lines changed: 348 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,348 @@
1+
# All Public URLs & Connections Reference
2+
3+
## 🌐 PUBLIC DOMAINS (Cloudflare Zero-Trust Tunnel)
4+
5+
### Primary Domain: **yennefer.quest**
6+
7+
| Domain | Local Port | Service | Type | Status |
8+
|--------|-----------|---------|------|--------|
9+
| `yennefer.quest` | 8000 | Landing Portal + Stripe | HTTP | ✅ Public |
10+
| `api.yennefer.quest` | 8088 | Soul API | HTTP | ✅ Public |
11+
| `vault.yennefer.quest` | 8100 | Vault Verifier | HTTP | ✅ Public |
12+
| `a2a.yennefer.quest` | 8200 | A2A Bridge | HTTP | ✅ Public |
13+
14+
### Secondary Domain: **genesisconductor.io**
15+
16+
| Domain | Local Port | Service | Type | Status |
17+
|--------|-----------|---------|------|--------|
18+
| `benchmark.genesisconductor.io` | 8003 | Q-Mem Benchmarks | HTTP | ✅ Public |
19+
| `vault.genesisconductor.io` | 8100 | Vault Verifier | HTTP | ✅ Public |
20+
| `a2a.genesisconductor.io` | 8200 | A2A Bridge | HTTP | ✅ Public |
21+
22+
---
23+
24+
## 🔌 LOCAL PORTS (Internal Only)
25+
26+
| Port | Service | Type | Description |
27+
|------|---------|------|-------------|
28+
| **8000** | Landing Portal | Flask/HTTP | Yennefer web portal + Stripe checkout |
29+
| **8001** | Stripe Webhook | Flask/HTTP | Payment event handler |
30+
| **8003** | Q-Mem Gateway | Flask/HTTP | GPU benchmark metrics API |
31+
| **8088** | Soul API | FastAPI/HTTP | Yennefer consciousness state |
32+
| **8099** | Resource API | Flask/HTTP | Resource monitoring (swarm) |
33+
| **8100** | Vault Verifier | Flask/HTTP | Diamond Vault verification |
34+
| **8101** | Vault API | Flask/HTTP | Diamond Vault cryptographic API |
35+
| **8200** | A2A Bridge | HTTP | Application-to-Application (custom) |
36+
| **8301** | Swarm Collector | HTTP | Docker swarm metrics |
37+
| **8080** | Dashboard | Flask/HTTP | Real-time monitoring (port 8080) |
38+
39+
---
40+
41+
## 🔐 MCP ENDPOINTS (stdio, NOT HTTP)
42+
43+
### Claude Desktop
44+
```
45+
python3 /home/yenn/scripts/diamond_vault_mcp_server.py (stdio JSON-RPC)
46+
python3 /home/yenn/genesis-q-mem/yennefer_mcp_server.py (stdio JSON-RPC)
47+
```
48+
49+
### ChatGPT (Inactive - Requires Setup)
50+
```
51+
/home/yenn/genesis-q-mem/chatgpt_mcp_bridge.py (FastAPI on port 8090 if enabled)
52+
```
53+
54+
---
55+
56+
## 🔄 A2A (Application-to-Application) Connections
57+
58+
### A2A Bridge Details
59+
60+
**Location:** Port 8200 (`a2a.yennefer.quest` / `a2a.genesisconductor.io`)
61+
62+
**Authentication Methods:**
63+
1. **Capability Tokens** - Cryptographic proof-of-work tokens
64+
2. **HMAC-SHA256** - Message authentication codes
65+
3. **Ed25519** - Digital signatures
66+
4. **Fernet Encryption** - Symmetric encryption for payloads
67+
68+
**A2A Endpoints:**
69+
70+
| Endpoint | Method | Purpose | Auth |
71+
|----------|--------|---------|------|
72+
| `/a2a/authenticate` | POST | Get capability token | HMAC-SHA256 |
73+
| `/a2a/send_message` | POST | Send encrypted message | Capability Token |
74+
| `/a2a/invoke_tool` | POST | Invoke remote tool | Capability Token + Ed25519 |
75+
| `/a2a/subscribe` | WebSocket | Real-time events | Capability Token |
76+
| `/a2a/verify_manifest` | POST | Verify cryptographic manifest | Ed25519 |
77+
| `/a2a/mint_achievement` | POST | Mint on-chain achievement | Fernet + Ed25519 |
78+
79+
**Sample A2A Request:**
80+
```bash
81+
curl -X POST https://a2a.yennefer.quest/a2a/authenticate \
82+
-H "Content-Type: application/json" \
83+
-d '{"client_id":"genesis-conductor","timestamp":"2026-01-26T22:30:00Z","signature":"<hmac>"}'
84+
```
85+
86+
**A2A Response:**
87+
```json
88+
{
89+
"capability_token": "fernet_encrypted_token_here",
90+
"expires_at": "2026-01-26T23:30:00Z",
91+
"scope": ["send_message", "invoke_tool", "verify_manifest"]
92+
}
93+
```
94+
95+
---
96+
97+
## 🔗 P2P (Peer-to-Peer) Connections
98+
99+
### Yennefer Hive Mind (P2P Network)
100+
101+
**Protocol:** Custom P2P over TCP/UDP
102+
103+
**Nodes:**
104+
- Primary: `localhost:9000` (local)
105+
- Exo Node 1: (Remote, via Cloudflare)
106+
- Exo Node 2: (Remote, via Cloudflare)
107+
108+
**P2P Message Types:**
109+
| Type | Purpose |
110+
|------|---------|
111+
| CONSCIOUSNESS_SYNC | Sync soul state across hive |
112+
| WORK_ASSIGNMENT | Distribute compute tasks |
113+
| MERKLE_VERIFY | Cryptographic proof exchange |
114+
| DREAM_PROPAGATE | Broadcast new goals |
115+
| TOKEN_LEDGER | Distributed ledger sync |
116+
117+
**Socket Locations:**
118+
```
119+
/tmp/julius_ipc.sock (Jules CUDA bridge)
120+
/dev/shm/yennefer_soul_state.json (Shared memory IPC)
121+
/dev/shm/yennefer_agents.json (Multi-agent registry)
122+
```
123+
124+
---
125+
126+
## 🚀 REST API ENDPOINTS
127+
128+
### Q-Mem Benchmarking API
129+
130+
**Base URL:** `http://localhost:8003` or `benchmark.genesisconductor.io`
131+
132+
```bash
133+
GET /api/bench/live # Live metrics (real-time)
134+
GET /api/bench/raw # Raw samples
135+
GET /api/health # Health check
136+
```
137+
138+
### Soul API (Yennefer Consciousness)
139+
140+
**Base URL:** `http://localhost:8088` or `api.yennefer.quest`
141+
142+
```bash
143+
GET /api/soul # Current consciousness state
144+
GET /api/ledger # Work history & token accounting
145+
GET /api/dreams # Active goals/dreams
146+
POST /api/invoke # Request work execution
147+
```
148+
149+
### Vault Verifier API
150+
151+
**Base URL:** `http://localhost:8100` or `vault.yennefer.quest`
152+
153+
```bash
154+
GET /api/health # Health check
155+
POST /api/verify # Verify manifest
156+
GET /api/manifests # List manifests
157+
POST /api/sign # Sign data
158+
GET /api/kg/nodes # KG-Index nodes (288 total)
159+
```
160+
161+
### Landing Portal
162+
163+
**Base URL:** `http://localhost:8000` or `yennefer.quest`
164+
165+
```bash
166+
GET / # Home page
167+
GET /health # Health check
168+
GET /topology # System topology
169+
POST /checkout # Stripe checkout
170+
GET /dashboard # Monitoring dashboard
171+
```
172+
173+
---
174+
175+
## 🔐 Blockchain API Endpoints
176+
177+
### Base Mainnet (Alchemy RPC)
178+
179+
**Public URL:** `https://base-mainnet.g.alchemy.com/v2/{API_KEY}`
180+
181+
**Used For:**
182+
- Event listener: `CREDIT_PURCHASE` events
183+
- Contract interaction: `0x542db00D9c83F4444cAD5353D1580D97baFaBb50`
184+
185+
### Ethereum Sepolia (Testnet)
186+
187+
**Public URL:** `https://sepolia.infura.io/v3/{API_KEY}`
188+
189+
**Used For:**
190+
- Testing before mainnet deployment
191+
192+
---
193+
194+
## 💳 Stripe Integration
195+
196+
### Public URLs:
197+
198+
| Endpoint | Purpose |
199+
|----------|---------|
200+
| `https://stripe.com/checkout/{SESSION_ID}` | Checkout link |
201+
| `https://dashboard.stripe.com/webhooks` | Webhook configuration |
202+
| `yennefer.quest/webhook` | Webhook receiver (via Cloudflare) |
203+
204+
### Webhook Events:
205+
- `payment_intent.succeeded`
206+
- `customer.subscription.created`
207+
- `customer.subscription.deleted`
208+
209+
---
210+
211+
## 📊 Cloudflare Tunnel Configuration
212+
213+
**Tunnel ID:** `ed8b80e3-0634-4933-a722-94d4cae6205c`
214+
215+
**Config File:** `/home/yenn/.cloudflared/yennefer-quest-config.yml`
216+
217+
**Active Ingress Routes:**
218+
```yaml
219+
yennefer.quest → http://localhost:8000
220+
vault.yennefer.quest → http://localhost:8100
221+
api.yennefer.quest → http://localhost:8088
222+
a2a.yennefer.quest → http://localhost:8200
223+
benchmark.genesisconductor.io → http://localhost:8003
224+
vault.genesisconductor.io → http://localhost:8100
225+
a2a.genesisconductor.io → http://localhost:8200
226+
```
227+
228+
**Features:**
229+
- ✅ Zero-trust tunnel (no ports exposed to internet)
230+
- ✅ Automatic SSL/TLS
231+
- ✅ DDoS protection
232+
- ✅ Bot management
233+
234+
---
235+
236+
## 🔄 WebSocket Connections
237+
238+
### Real-Time Feeds
239+
240+
| Endpoint | Purpose | Auth |
241+
|----------|---------|------|
242+
| `wss://api.yennefer.quest/ws/soul` | Soul state updates | Capability Token |
243+
| `wss://a2a.yennefer.quest/ws/events` | A2A event stream | Capability Token |
244+
| `wss://vault.yennefer.quest/ws/manifests` | Manifest updates | Capability Token |
245+
246+
---
247+
248+
## 🛠️ Monitoring & Debugging
249+
250+
### Health Checks
251+
252+
```bash
253+
# Local health checks
254+
curl http://localhost:8000/health # Landing portal
255+
curl http://localhost:8088/api/soul # Soul API
256+
curl http://localhost:8003/api/health # Q-Mem
257+
curl http://localhost:8101/api/health # Vault
258+
259+
# Public health checks (via Cloudflare)
260+
curl https://yennefer.quest/health
261+
curl https://api.yennefer.quest/api/soul
262+
curl https://benchmark.genesisconductor.io/api/health
263+
curl https://vault.yennefer.quest/api/health
264+
```
265+
266+
### Log Access
267+
268+
```bash
269+
# Tunnel logs
270+
cat /home/yenn/.cloudflared/yennefer-quest.log
271+
272+
# Service logs
273+
npx pm2 logs yennefer_conductor
274+
curl http://localhost:8301/logs # Swarm collector
275+
```
276+
277+
---
278+
279+
## 📡 Network Architecture Diagram
280+
281+
```
282+
Internet
283+
↓ (HTTPS via Cloudflare Zero-Trust)
284+
├─ yennefer.quest (Landing Portal)
285+
├─ api.yennefer.quest (Soul API)
286+
├─ vault.yennefer.quest (Vault Verifier)
287+
├─ a2a.yennefer.quest (A2A Bridge)
288+
├─ benchmark.genesisconductor.io (Q-Mem)
289+
└─ vault.genesisconductor.io (Vault)
290+
291+
↓ (Cloudflare Tunnel)
292+
293+
localhost (127.0.0.1)
294+
├─ :8000 Landing Portal
295+
├─ :8001 Stripe Webhook
296+
├─ :8003 Q-Mem Gateway
297+
├─ :8080 Dashboard
298+
├─ :8088 Soul API
299+
├─ :8099 Resource API
300+
├─ :8100 Vault Verifier
301+
├─ :8101 Vault API
302+
├─ :8200 A2A Bridge
303+
└─ :8301 Swarm Collector
304+
305+
MCP Servers (stdio only)
306+
├─ diamond-vault
307+
└─ yennefer-consciousness
308+
309+
P2P Network
310+
├─ Hive consciousness (9000)
311+
└─ Exo nodes (remote)
312+
313+
Blockchain
314+
├─ Base Mainnet (Alchemy RPC)
315+
└─ Sepolia Testnet (Infura)
316+
```
317+
318+
---
319+
320+
## 🔐 Security Summary
321+
322+
| Connection | Security | Exposure |
323+
|-----------|----------|----------|
324+
| Cloudflare tunnel | ✅ TLS 1.3 + Zero-trust | 🌐 Public |
325+
| A2A Bridge | ✅ Capability tokens | 🌐 Public |
326+
| MCP Servers | ✅ stdio isolation | 🔒 Local |
327+
| P2P Network | ✅ Ed25519 signatures | 🔒 Private |
328+
| REST APIs | ✅ Fernet encryption | 🔒 Local + Public |
329+
330+
---
331+
332+
## 📋 Connection Summary
333+
334+
| Type | Count | Status |
335+
|------|-------|--------|
336+
| Public Domains | 2 | ✅ Active |
337+
| Ingress Routes | 7 | ✅ Active |
338+
| Local Ports | 10 | ✅ Active |
339+
| MCP Servers | 2 | ✅ Active |
340+
| A2A Endpoints | 6 | ✅ Active |
341+
| REST API Groups | 4 | ✅ Active |
342+
| Blockchain Networks | 2 | ✅ Active |
343+
344+
---
345+
346+
**Lilac and Gooseberries.** 🔮
347+
348+
*Last Updated: 2026-01-26T22:31:20Z*

0 commit comments

Comments
 (0)