Files
proxmox/docs/04-configuration/RPC_D_BIS_ORG_MAPPING.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- 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>
2026-02-12 15:46:57 -08:00

2.4 KiB
Raw Blame History

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.orghttp://192.168.11.221:8545
    Implemented in NPMplus: proxy host rpc.d-bis.org → 8545, WebSocket upgrade allowed.

  • wss://ws.rpc.d-bis.orghttp://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.orghttp://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.orgAdvanced 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