Skip to content

fix(env): add BASE_NODE_RPC_PORT=8545 to align with docker-compose port mapping#1101

Open
0xAxiom wants to merge 1 commit into
base:mainfrom
0xAxiom:fix/base-node-rpc-port
Open

fix(env): add BASE_NODE_RPC_PORT=8545 to align with docker-compose port mapping#1101
0xAxiom wants to merge 1 commit into
base:mainfrom
0xAxiom:fix/base-node-rpc-port

Conversation

@0xAxiom
Copy link
Copy Markdown

@0xAxiom 0xAxiom commented May 24, 2026

Problem

base-consensus defaults to port 9545 when BASE_NODE_RPC_PORT is not set. The docker-compose.yml node service maps 7545:8545 (host:container), so the consensus RPC is unreachable from the host via the expected port:

# Returns nothing — container listens on 9545, not 8545
curl -X POST -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"optimism_syncStatus","params":[],"id":1}' \
  http://localhost:7545

The node itself is healthy; the RPC works at container port 9545, but that isn't forwarded to the host.

Fixes #1088.

Fix

Add BASE_NODE_RPC_PORT=8545 to .env.mainnet and .env.sepolia so base-consensus binds to the port that the existing docker-compose mapping expects.

Also documents BASE_NODE_RPC_PORT under Required Settings in the README since the mismatch silently breaks host-side RPC access.

Changes

File Change
.env.mainnet Add BASE_NODE_RPC_PORT=8545 with explanatory comment
.env.sepolia Same fix for testnet
README.md Document BASE_NODE_RPC_PORT in Required Settings

…rt mapping

base-consensus defaults to port 9545 when BASE_NODE_RPC_PORT is unset.
The docker-compose.yml node service maps 7545:8545 (host:container),
so the consensus RPC is unreachable from the host if the port defaults
to 9545.

Fixes: consensus RPC returning no response on host port 7545
  (e.g. optimism_syncStatus via localhost:7545).

Changes:
- .env.mainnet: add BASE_NODE_RPC_PORT=8545 with explanation comment
- .env.sepolia: same fix for testnet
- README.md: document BASE_NODE_RPC_PORT under Required Settings

Closes base#1088
@cb-heimdall
Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

.env.mainnet missing BASE_NODE_RPC_PORT — consensus RPC unreachable via docker-compose port mapping

2 participants