Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
173 lines
5.3 KiB
Markdown
173 lines
5.3 KiB
Markdown
# Domain Structure
|
|
|
|
**Last Updated:** 2025-01-03
|
|
**Document Version:** 1.0
|
|
**Status:** Active Documentation
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
This document defines the domain structure for the infrastructure, clarifying which domains are used for different purposes.
|
|
|
|
---
|
|
|
|
## Domain Assignments
|
|
|
|
### 1. sankofa.nexus - Hardware Infrastructure
|
|
|
|
**Purpose:** Physical hardware hostnames and internal network DNS
|
|
|
|
**Usage:**
|
|
- All physical servers (ml110, r630-01 through r630-04)
|
|
- Internal network DNS resolution
|
|
- SSH access via FQDN
|
|
- Internal service discovery
|
|
|
|
**Examples:**
|
|
- `ml110.sankofa.nexus` → 192.168.11.10
|
|
- `r630-01.sankofa.nexus` → 192.168.11.11
|
|
- `r630-02.sankofa.nexus` → 192.168.11.12
|
|
- `r630-03.sankofa.nexus` → 192.168.11.13
|
|
- `r630-04.sankofa.nexus` → 192.168.11.14
|
|
|
|
**DNS Configuration:**
|
|
- Internal DNS server (typically on ER605 or Omada controller)
|
|
- Not publicly resolvable (internal network only)
|
|
- Used for local network service discovery
|
|
|
|
**Related Documentation:**
|
|
- [Physical Hardware Inventory](./PHYSICAL_HARDWARE_INVENTORY.md)
|
|
|
|
---
|
|
|
|
### 2. d-bis.org - ChainID 138 Services
|
|
|
|
**Purpose:** Public-facing services for ChainID 138 blockchain network
|
|
|
|
**Usage:**
|
|
- RPC endpoints (public and permissioned)
|
|
- Block explorer
|
|
- WebSocket endpoints
|
|
- Cloudflare tunnels for Proxmox hosts
|
|
- All ChainID 138 blockchain-related services
|
|
|
|
**Examples:**
|
|
- `rpc.d-bis.org` - Primary RPC endpoint
|
|
- `rpc2.d-bis.org` - Secondary RPC endpoint
|
|
- `explorer.d-bis.org` - Block explorer (Blockscout)
|
|
- `ml110-01.d-bis.org` - Proxmox UI (via Cloudflare tunnel)
|
|
- `r630-01.d-bis.org` - Proxmox UI (via Cloudflare tunnel)
|
|
- `r630-02.d-bis.org` - Proxmox UI (via Cloudflare tunnel)
|
|
- `r630-03.d-bis.org` - Proxmox UI (via Cloudflare tunnel)
|
|
- `r630-04.d-bis.org` - Proxmox UI (via Cloudflare tunnel)
|
|
|
|
**DNS Configuration:**
|
|
- Cloudflare DNS (proxied)
|
|
- Publicly resolvable
|
|
- SSL/TLS via Cloudflare
|
|
|
|
**Related Documentation:**
|
|
- [Cloudflare Tunnel Setup](../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md)
|
|
- [RPC Configuration](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)
|
|
- [Blockscout Setup](../archive/completion/BLOCKSCOUT_COMPLETE_SUMMARY.md)
|
|
|
|
---
|
|
|
|
### 3. defi-oracle.io - ChainID 138 Legacy (ThirdWeb RPC)
|
|
|
|
**Purpose:** Legacy RPC endpoint for ThirdWeb integration
|
|
|
|
**Usage:**
|
|
- ThirdWeb RPC endpoint (VMID 2400)
|
|
- Legacy compatibility for existing integrations
|
|
- Public RPC access for ChainID 138
|
|
|
|
**Examples:**
|
|
- `rpc.defi-oracle.io` - Legacy RPC endpoint
|
|
- `rpc.public-0138.defi-oracle.io` - Specific ChainID 138 RPC endpoint
|
|
|
|
**DNS Configuration:**
|
|
- Cloudflare DNS (proxied)
|
|
- Publicly resolvable
|
|
- SSL/TLS via Cloudflare
|
|
|
|
**Note:** This domain is maintained for backward compatibility with ThirdWeb integrations. New integrations should use `d-bis.org` endpoints.
|
|
|
|
**Related Documentation:**
|
|
- [ThirdWeb RPC Setup](/docs/04-configuration/THIRDWEB_RPC_CLOUDFLARE_SETUP.md)
|
|
- [VMID 2400 DNS Structure](/docs/04-configuration/VMID2400_DNS_STRUCTURE.md)
|
|
|
|
---
|
|
|
|
## Domain Summary Table
|
|
|
|
| Domain | Purpose | Public | DNS Provider | SSL/TLS |
|
|
|--------|---------|--------|--------------|---------|
|
|
| `sankofa.nexus` | Hardware infrastructure | No (internal) | Internal DNS | Self-signed |
|
|
| `d-bis.org` | ChainID 138 services | Yes | Cloudflare | Cloudflare |
|
|
| `defi-oracle.io` | ChainID 138 legacy (ThirdWeb) | Yes | Cloudflare | Cloudflare |
|
|
|
|
---
|
|
|
|
## Domain Usage Guidelines
|
|
|
|
### When to Use sankofa.nexus
|
|
|
|
- Internal network communication
|
|
- SSH access to physical hosts
|
|
- Internal service discovery
|
|
- Local network DNS resolution
|
|
- Proxmox cluster communication
|
|
|
|
### When to Use d-bis.org
|
|
|
|
- Public blockchain RPC endpoints
|
|
- Block explorer access
|
|
- Public-facing Proxmox UI (via tunnels)
|
|
- ChainID 138 service endpoints
|
|
- New integrations and services
|
|
|
|
### When to Use defi-oracle.io
|
|
|
|
- ThirdWeb RPC endpoint (legacy)
|
|
- Backward compatibility
|
|
- Existing integrations that reference this domain
|
|
|
|
---
|
|
|
|
## Migration Notes
|
|
|
|
### From defi-oracle.io to d-bis.org
|
|
|
|
For new services and integrations:
|
|
- **Use `d-bis.org`** as the primary domain
|
|
- `defi-oracle.io` is maintained for legacy ThirdWeb RPC compatibility
|
|
- All new ChainID 138 services should use `d-bis.org`
|
|
|
|
### DNS Record Management
|
|
|
|
- **sankofa.nexus**: Managed via internal DNS (Omada controller or local DNS server)
|
|
- **d-bis.org**: Managed via Cloudflare DNS
|
|
- **defi-oracle.io**: Managed via Cloudflare DNS
|
|
|
|
---
|
|
|
|
## Related Documentation
|
|
|
|
### Architecture Documents
|
|
- **[PHYSICAL_HARDWARE_INVENTORY.md](PHYSICAL_HARDWARE_INVENTORY.md)** ⭐⭐⭐ - Physical hardware inventory
|
|
- **[NETWORK_ARCHITECTURE.md](NETWORK_ARCHITECTURE.md)** ⭐⭐⭐ - Complete network architecture
|
|
- **[ORCHESTRATION_DEPLOYMENT_GUIDE.md](ORCHESTRATION_DEPLOYMENT_GUIDE.md)** ⭐⭐⭐ - Deployment orchestration
|
|
|
|
### Configuration Documents
|
|
- **[../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md](../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md)** - Cloudflare tunnel configuration
|
|
- **[../04-configuration/RPC_DNS_CONFIGURATION.md](/docs/04-configuration/RPC_DNS_CONFIGURATION.md)** - RPC DNS configuration
|
|
- **[../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md](../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md)** - Cloudflare routing architecture
|
|
|
|
---
|
|
|
|
**Last Updated:** 2025-01-03
|
|
**Document Version:** 1.0
|
|
**Review Cycle:** Quarterly
|