DogeOS69/dogeos-rpc-package v0.1.1-testnet

DogeOS RPC Package v0.1.1-testnet

on GitHub

This release updates existing v0.3.0 testnet RPC and follower deployments from RPC Package v0.1.0-testnet.

Changes

• L2Reth bugfix update. Update the image from dogeos69/rollup-node:v0.3.0-beta.1c to dogeos69/rollup-node:v0.3.0-beta.1c-ca.20261021.1-stateroot@sha256:ae9af79d24d585edb0a644f246a62517318f9cd6ed872295e8d369c4dcc0429f, pinned by digest for reproducible deployments.
• Automatic restart. Set L2Reth's restart policy to unless-stopped so Docker can bring it back after signer-rotation exits and host or Docker restarts. Manually stopped containers stay stopped.
• Shutdown grace period. Give L2Reth 30 seconds to shut down cleanly before Docker forces termination.
• Safer snapshot restore. Abort snapshot activation if stopping L2Reth fails, protecting the active data directory.
• Configuration cleanup. Remove the unused L2RETH_VALID_SIGNER entry from the testnet environment file. The node reads the authorized signer through L1 Interface.
• Operations documentation. Add guidance for data-disk mounting before Docker starts, restart monitoring, and troubleshooting.

Upgrade

Apply this update to testnet RPC and follower nodes. The replacement image supports Linux amd64.

1. Update the deployment checkout to v0.1.1-testnet after this release is published.
2. Keep your existing .env.testnet, Compose project name, DATA_ROOT, Dogecoin volume name, and RPC credentials.
3. From the deployment directory, pull the image and recreate L2Reth. Retain any custom env-file path or Compose options in both commands.

docker compose --env-file .env.testnet pull l2reth-node
docker compose --env-file .env.testnet up -d --no-deps --force-recreate l2reth-node

Recreating the container applies the image, restart policy, and shutdown grace period. Existing chain data is reused. L2 RPC will be briefly unavailable during the restart.

Because containers restart automatically after a host reboot, ensure the data disk is mounted before Docker starts. See the README for the systemd mount dependency and monitoring guidance.

Verify

docker compose --env-file .env.testnet ps l2reth-node
docker compose --env-file .env.testnet logs --tail=100 l2reth-node

curl --fail \
  -H 'content-type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  http://localhost:8545

Use your configured HTTP port if it differs from 8545. Repeat the block-height query after a short interval and confirm that the height advances. Compare the height and the block hash at a common height with a trusted testnet RPC, and check logs for startup or synchronization errors.