# rpc.d-bis.org – Canonical Mapping

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Desired mapping (use both WebSocket URLs):**

| Public URL | Backend |
|------------|---------|
| `https://rpc.d-bis.org` | `http://192.168.11.221:8545` (HTTP RPC) |
| `wss://rpc.d-bis.org` | `http://192.168.11.221:8546` (WebSocket RPC) |
| `wss://ws.rpc.d-bis.org` | `http://192.168.11.221:8546` (WebSocket RPC, same backend) |

Backend: VMID 2201 (besu-rpc-public-1) @ 192.168.11.221.

---

## Current implementation

- **https://rpc.d-bis.org** → `http://192.168.11.221:8545`  
  Implemented in NPMplus: proxy host `rpc.d-bis.org` → 8545, WebSocket upgrade allowed.

- **wss://ws.rpc.d-bis.org** → `http://192.168.11.221:8546`  
  Implemented in NPMplus: proxy host `ws.rpc.d-bis.org` → 8546. **Use this URL for WebSocket** (always works).

- **wss://rpc.d-bis.org** → `http://192.168.11.221:8546`  
  Same backend as `wss://ws.rpc.d-bis.org`. To have it work on the same hostname as HTTPS, NPMplus needs custom Nginx that routes by `Upgrade: websocket` to 8546 and normal HTTP to 8545. See **Enabling wss://rpc.d-bis.org** below.

---

## Enabling wss://rpc.d-bis.org (optional)

NPM uses one proxy host per domain → one backend. To have both `https://rpc.d-bis.org` → 8545 and `wss://rpc.d-bis.org` → 8546, add custom Nginx so WebSocket requests to `rpc.d-bis.org` are sent to 8546.

1. In NPMplus, edit proxy host **rpc.d-bis.org** → **Advanced** tab.
2. In **Custom Nginx Configuration**, add the snippet from `docs/04-configuration/NPM_CUSTOM_RPC_D_BIS_ORG_WSS.md` (map + conditional or variable `proxy_pass`).  
   If your NPM version does not allow variable `proxy_pass`, add the equivalent config to `/data/nginx/custom/` on the NPM container and reload Nginx.

Alternatively, use **wss://ws.rpc.d-bis.org** for WebSocket (no custom config).

---

## Scripts

- Create/update proxy hosts: `scripts/nginx-proxy-manager/create-npmplus-rpc-d-bis-hosts.sh`, `update-npmplus-proxy-hosts-api.sh`
- `rpc.d-bis.org` → 8545, `ws.rpc.d-bis.org` → 8546 (both with WebSocket enabled in NPM).

---

## Summary

| URL | Backend | Implemented as |
|-----|---------|----------------|
| https://rpc.d-bis.org | http://192.168.11.221:8545 | ✅ rpc.d-bis.org → 8545 |
| wss://rpc.d-bis.org | http://192.168.11.221:8546 | Optional: custom Nginx (see above) |
| wss://ws.rpc.d-bis.org | http://192.168.11.221:8546 | ✅ ws.rpc.d-bis.org → 8546 |