Pectra Readiness Upgrade

Do not upgrade your node yet - this guide is for reference only. AltLayer did not upgrade the rollup yet.

This guide outlines the process for upgrading your Swellchain node to version 1.11.1. The upgrade introduces improvements in node performance and stability. Choose the appropriate upgrade path based on your deployment method.

Do not upgrade your node yet - this guide is for reference only. AltLayer did not upgrade the rollup yet.

Pre-upgrade Checks

Before proceeding with the upgrade, verify your current node status:

curl localhost:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'

Ensure your node is fully synced before proceeding with the upgrade.

Backup Process

Create backups of your critical configuration files:

cp .env .env.backup
cp jwt.txt jwt.txt.backup

Upgrade Steps

Stop your current node:

docker compose down

Update the repository:

git fetch origin
git pull

Update your .env file with the new image versions:

# Update these specific lines in your .env file
GETH_IMAGE=us-docker.pkg.dev/oplabs-tools-artifacts/images/op-geth:v1.101411.1
NODE_IMAGE=us-docker.pkg.dev/oplabs-tools-artifacts/images/op-node:v1.11.1

Clean the Docker environment:

docker compose down -v
docker system prune -f

Pull the new images:

docker compose pull

Start the upgraded node:

docker compose up -d

Post-upgrade Verification

After the upgrade, verify your node is operating correctly:

Check the node sync status:

curl localhost:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'

Monitor the logs for any errors:

docker compose logs -f node
docker compose logs -f geth

Verify the current block height:

curl localhost:8545 -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Troubleshooting

If you encounter issues during the upgrade:

Check the node logs for specific error messages
Verify all environment variables are correctly set in your .env file
Ensure sufficient disk space is available
Confirm network connectivity to L1 endpoints

If problems persist, revert to the backup configuration:

# For Standard Upgrade
cp .env.backup .env
cp jwt.txt.backup jwt.txt
docker compose down
docker compose up -d
 
# For AltLayer Upgrade
cd ../your-old-node-directory
docker compose up -d

The node upgrade process typically takes 10-15 minutes to complete. Monitor the logs to ensure proper synchronization after the upgrade.