proxmox/docs/02-architecture/DOMAIN_STRUCTURE.md

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

---

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
• RPC Configuration
• EXPLORER_LINKS_AND_ISSUES_DIAGNOSTIC.md · EXPLORER_FRONTEND_404_FIX_RUNBOOK.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
• VMID 2400 DNS Structure

---

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
• NETWORK_ARCHITECTURE.md ⭐⭐⭐ - Complete network architecture
• ORCHESTRATION_DEPLOYMENT_GUIDE.md ⭐⭐⭐ - Deployment orchestration

Configuration Documents

• ../04-configuration/cloudflare/CLOUDFLARE_TUNNEL_CONFIGURATION_GUIDE.md - Cloudflare tunnel configuration
• ../04-configuration/RPC_DNS_CONFIGURATION.md - RPC DNS configuration
• ../05-network/CLOUDFLARE_TUNNEL_ROUTING_ARCHITECTURE.md - Cloudflare routing architecture

---

Last Updated: 2025-01-03
Document Version: 1.0
Review Cycle: Quarterly