Skip to content

docs(azul): add BASE_NODE_L2_ENGINE_AUTH_RAW to env mapping table and FAQ #1506

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
erhnysr wants to merge 2 commits into
base: master
Choose a base branch
from
+5 −0
Open

docs(azul): add BASE_NODE_L2_ENGINE_AUTH_RAW to env mapping table and FAQ #1506

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b6b9847
docs: add RPC usage clarification note
erhnysr Apr 6, 2026
c406366
docs(azul): add BASE_NODE_L2_ENGINE_AUTH_RAW to env mapping table and…
erhnysr May 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -164,3 +164,6 @@ The core team will review opened PRs. The SLA is 2 weeks, generally on a first-c
## Storybook for UI components

See `storybook/README.md` for details on local Storybook and component docs.
## Additional Note

When building on Base, always ensure that you are using the correct RPC endpoint for the intended network (mainnet or testnet). Misconfiguration can lead to failed transactions or unexpected behavior.
2 changes: 2 additions & 0 deletions docs/base-chain/node-operators/base-v1-upgrade.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,7 @@ If you use [base/node](https://github.com/base/node), most variables are already
| `OP_NODE_L1_TRUST_RPC` | `BASE_NODE_L1_TRUST_RPC` |
| `OP_NODE_L2_ENGINE_RPC` | `BASE_NODE_L2_ENGINE_RPC` |
| `OP_NODE_L2_ENGINE_AUTH` | `BASE_NODE_L2_ENGINE_AUTH` |
| — | `BASE_NODE_L2_ENGINE_AUTH_RAW` |
| — | `BASE_NODE_L2_ENGINE_AUTH_ENCODED` |
| `OP_NODE_P2P_BOOTNODES` | `BASE_NODE_P2P_BOOTNODES` |
| `OP_NODE_P2P_LISTEN_IP` | `BASE_NODE_P2P_LISTEN_IP` |
Expand Down Expand Up @@ -151,6 +152,7 @@ If you use [base/node](https://github.com/base/node), most variables are already

## FAQ

- **Do I need to set `BASE_NODE_L2_ENGINE_AUTH_RAW`?** Yes — this must be set to a secure random hex string shared between the execution and consensus containers. Generate one with `openssl rand -hex 32`. Nodes using host networking or custom port mappings that rely on the default placeholder value are exposed to unauthenticated Engine API access.
- **Do I need to re-sync?** Not if you are already running OP Reth. Existing data is compatible.
- **What if I'm on `op-geth` or `nethermind`?** You need to switch to `base-reth-node`. Use a [Reth snapshot](/base-chain/node-operators/snapshots) to bootstrap.
- **Do OP namespace RPCs still work?** Yes, all existing RPCs are supported.