> loading_
# Upgrading your local RSKj node to 9.1.0
# This walkthrough covers pulling, building, and verifying the new release.
# Step 1: Clone or update the RSKj repository
# If you already have the repo, pull the latest changes including the version bump.
git clone https://github.com/rsksmart/rskj.git
cd rskj
git fetch --all --tags
# Step 2: Checkout the 9.1.0 release (once formally tagged)
# For now, you can work from the merged commit on the main branch.
git checkout main
git pull origin main
# Step 3: Build RSKj from source using Gradle
# RootStock uses Gradle for builds. Ensure you have JDK 17+ installed.
./gradlew clean build -x test
# The '-x test' flag skips tests for a faster build.
# Remove it if you want to run the full test suite locally (recommended).
# Step 4: Verify the built version
# After building, confirm the JAR reports 9.1.0.
java -jar rskj-core/build/libs/rskj-core-9.1.0-all.jar --version
# Expected output should include: RSKj version 9.1.0
# Step 5: Run the node against Testnet first
# Always validate against Testnet before touching your Mainnet infrastructure.
java -jar rskj-core/build/libs/rskj-core-9.1.0-all.jar --testnet
# Monitor logs for any deprecation warnings or new configuration requirements.
# Step 6: Run your dApp integration tests against the upgraded node
# Point your test suite at the local Testnet node (default RPC: http://localhost:4444)
curl -X POST http://localhost:4444 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
# Confirm your RPC calls return expected formats and values.
# Step 7: Compare gas estimates between 9.0.x and 9.1.0
# If your contracts are gas-sensitive, run a quick comparison.
curl -X POST http://localhost:4444 \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{"to":"0xYOUR_CONTRACT","data":"0xYOUR_CALLDATA"}],"id":1}'
# Document any differences — they may indicate optimizer or opcode pricing changes.
# Step 8: Review the full changelog and PR #3492 for breaking changes
# https://github.com/rsksmart/rskj/pull/3492
# Pay attention to any consensus rule changes or deprecated RPC methods.