Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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: 2 additions & 1 deletion content/validators/bradbury.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ rollup:
# The WebSocket refuses a connection without an API key. The chain is
# operated by Conduit: create a key at https://app.conduit.xyz/rpc-keys and
# set it in the environment as
# GENLAYERNODE_ROLLUP_GENLAYERCHAINRPCKEY, never in these URLs or this file.
# GENLAYERNODE_ROLLUP_GENLAYERCHAINRPCKEY (or in the file that
# genlayerchainrpckeyfile names), never in these URLs or this file.
# The node sends it in the X-AccessKey header on the RPC and WebSocket
# connections.
provider: "conduit" # Rollup operator name; surfaces as the "provider" label on RPC-driven metrics.
Expand Down
8 changes: 4 additions & 4 deletions content/validators/changelog/v0.2.0-testnet001.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@

- Updated genvm to v0.0.16

### Misc

- Updated module golang.org/x/net to v0.38.0 (security)

### Bug fixes

- Log level is no longer ignored
- Revived trie dumping and enhanced logging
- Always kill genvm modules

### Misc

- Updated module golang.org/x/net to v0.38.0 (security)
10 changes: 5 additions & 5 deletions content/validators/changelog/v0.2.0-testnet007.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@
- Log file support for node
- Ability to export private key in account command

### Misc

- Updated module github.com/btcsuite/btcd to v0.24.2 (security)
- Improved sync speed on node startup

### Bug fixes

- Build info logs now display correctly
- Fixed config relative path
- Node now fails fast when accepted transaction processing fails

### Misc

- Updated module github.com/btcsuite/btcd to v0.24.2 (security)
- Improved sync speed on node startup
8 changes: 4 additions & 4 deletions content/validators/changelog/v0.3.11.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@

- Add validator telemetry push monitoring

### Bug fixes

- Validator banning on parallel transactions executions

### Misc

- Document health RPC endpoint

### Bug fixes

- Validator banning on parallel transactions executions
26 changes: 13 additions & 13 deletions content/validators/changelog/v0.4.0.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,19 @@
- Store and expose genvm execution information
- Add sign admin endpoint for genvm

### Misc

- Simplify environment variable configuration using .env file
- Add environment variable override support for config values
- Update webdriver image to v0.0.9
- Update RPC and WebSocket endpoints in config.yaml.example
- Correct status for validatorTimeout after appeal time window
- Validate presence of abigen in dependency check
- Rename environment validation functions for clarity
- Use cockroachdb errors package for error handling
- Remove wallet.yaml file handling
- Rename archive to full

### Bug fixes

- GenVM architecture on arm64
Expand All @@ -57,16 +70,3 @@
- Leader idleness
- Accidental deadlock in genvm
- Lazy validators commit order

### Misc

- Simplify environment variable configuration using .env file
- Add environment variable override support for config values
- Update webdriver image to v0.0.9
- Update RPC and WebSocket endpoints in config.yaml.example
- Correct status for validatorTimeout after appeal time window
- Validate presence of abigen in dependency check
- Rename environment validation functions for clarity
- Use cockroachdb errors package for error handling
- Remove wallet.yaml file handling
- Rename archive to full
16 changes: 8 additions & 8 deletions content/validators/changelog/v0.4.4.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,14 @@
- Refactor ZkSync client to split RPC and WSS connections for better reliability
- Move storage writing to genvm for improved performance

### Misc

- Fix signer for full nodes
- Improve logs for http servers
- Improve signer initialization for faster and more reliable transaction signing
- Add logs for previous activator on idleness checks
- Migrate zksync-go to go-ethereum

### Bug fixes

- Skip priming check for full nodes
Expand All @@ -15,11 +23,3 @@
- Fix memory leak in consensus processing
- Fix bug in latest transaction with effect calculation
- Fix wallet mutex using read lock instead of write lock when unlocking accounts

### Misc

- Fix signer for full nodes
- Improve logs for http servers
- Improve signer initialization for faster and more reliable transaction signing
- Add logs for previous activator on idleness checks
- Migrate zksync-go to go-ethereum
12 changes: 6 additions & 6 deletions content/validators/changelog/v0.4.5.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@
- Implement sync waiting mechanism to ensure GenVM has latest state before contract execution
- Add `genlayer_node_info` Prometheus metric exposing node and protocol version

### Bug fixes

- Add canPrime check to verify epoch state before validator priming, preventing priming when epochs are out of sync
- Return user-friendly error instead of system error when sync times out
- Fix genvm executor process handling

### Misc

- Improve GenVM logging with context-aware logger
- Update health checker to use ZkSync connectivity checks
- Increase default genvm permits to 8 in config.yaml.example

### Bug fixes

- Add canPrime check to verify epoch state before validator priming, preventing priming when epochs are out of sync
- Return user-friendly error instead of system error when sync times out
- Fix genvm executor process handling
14 changes: 7 additions & 7 deletions content/validators/changelog/v0.5.0.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,13 @@
- Add gen_getContractCode endpoint
- Return full VMResult data from gen_call

### Misc

- Inject txID into context for automatic log propagation
- Enable validator idle reveal idleness
- Add profiling with pyroscope
- Fix to handle zksync local-node compatibility

### Bug fixes

- Check pending queue head before activation
Expand All @@ -24,10 +31,3 @@
- Prevent panic on closing done channel during event processing
- Handle new consensus ResultType
- New behavior for finalizing epochs

### Misc

- Inject txID into context for automatic log propagation
- Enable validator idle reveal idleness
- Add profiling with pyroscope
- Fix to handle zksync local-node compatibility
12 changes: 6 additions & 6 deletions content/validators/changelog/v0.5.10.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,12 @@

- Resilient WS RPC for fallback path

### Misc

- Label RPC metrics with provider
- Add chain nonce and desync gauges metrics
- Log timestamps after acquireTransaction

### Bug fixes

- Close activator-binding race
Expand All @@ -16,9 +22,3 @@
- Make chain-submit buffer configurable and stop collapsing on short step_timeout
- Add fault label to RPC error metric
- Unwedge replay and filter sync

### Misc

- Label RPC metrics with provider
- Add chain nonce and desync gauges metrics
- Log timestamps after acquireTransaction
8 changes: 4 additions & 4 deletions content/validators/changelog/v0.5.2.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@

- Add recovery for missing TxData

### Misc

- Use CtxLogger in HTTP handler constructors

### Bug fixes

- Invalidate timeout cache on SetTimeouts
Expand All @@ -14,7 +18,3 @@
- Reject stale block in idle check
- Increment leader revealed metric counter
- Sync commit idle timeout with contract timestamps

### Misc

- Use CtxLogger in HTTP handler constructors
8 changes: 4 additions & 4 deletions content/validators/changelog/v0.5.5.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@
- Add network label to logger and all metrics
- Add metrics to rollup RPC transport and WebSocket

### Misc

- Downgrade finalized-not-in-cache log to Debug

### Bug fixes

- Recover from cache miss on late lifecycle events
Expand All @@ -14,7 +18,3 @@
- Raise gas bump ceiling and retries
- Stuck nonce and finalize resilience
- Patch GenVM dylib references on macOS during download

### Misc

- Downgrade finalized-not-in-cache log to Debug
10 changes: 5 additions & 5 deletions content/validators/changelog/v0.5.7.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,15 +4,15 @@

- Add LLM greyboxing with configurable chain order via YAML meta

### Misc

- Include Alloy healthcheck script in release tarball
- Increase Alloy push intervals to 60s

### Bug fixes

- Use PendingAt for idle activator rotation
- Remove unnecessary workaround from view calls
- Restart sync pipeline after RPC failures
- Suppress shutdown errors in watchers
- Reduce FindAcceptanceBlock range to fit RPC limit

### Misc

- Include Alloy healthcheck script in release tarball
- Increase Alloy push intervals to 60s
12 changes: 6 additions & 6 deletions content/validators/changelog/v0.5.8.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@
- Add bounded sync wait for RPC readiness
- Add per-IP per-method RPC rate limiting

### Misc

- Consolidate genvm configs
- Add `gen_getTransactionStatus` docs
- Add `gen_syncing` API docs and clarify RPC config group vs method precedence

### Bug fixes

- Defer GenVM precompile to container startup to avoid AVX-512 incompatibility
Expand All @@ -18,9 +24,3 @@
- Pass transaction value to GenVM
- Standardize RPC error codes per EIP-1474
- Retry tx lookup for RPC indexing lag

### Misc

- Consolidate genvm configs
- Add `gen_getTransactionStatus` docs
- Add `gen_syncing` API docs and clarify RPC config group vs method precedence
14 changes: 7 additions & 7 deletions content/validators/changelog/v0.5.9.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
## v0.5.9

### Misc

- Use RFC3339Nano for zerolog timestamps
- Extract encoding functions into dedicated encoding package
- Move consensus entity types to entities package
- Add gen_dbg_traceTransaction API doc

### Bug fixes

- Count real provider failures on SLA
Expand All @@ -9,10 +16,3 @@
- Self-cancel stuck nonce on mempool replacement exhaustion
- Prevent sync panic and self-dependency cycle during tx replay
- Resume sync after WS reconnect

### Misc

- Use RFC3339Nano for zerolog timestamps
- Extract encoding functions into dedicated encoding package
- Move consensus entity types to entities package
- Add gen_dbg_traceTransaction API doc
42 changes: 42 additions & 0 deletions content/validators/changelog/v0.6.0-rc.3.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
## v0.6.0-rc.3

Before you upgrade, check the alert rules that read `/health`. The `chain.sync` reasons `sync_stalled` and `sync_feed_frozen` are gone: a node far behind that still syncs returns 200, and a sync that fails at the same block for 5 minutes returns 503 with reason `sync_blocked`. A self-stake below the minimum now sets `consensus.stake` to `warning` (HTTP 200), not 503. At its first start, this release moves the node's nonce ledger from `genvm.db` to `ops.db` (log line `moved the nonce ledger from genvm.db to ops.db`); if you then go back to v0.6.0-rc.2, that node does not start while a transaction it signed is still pending.

### New features

- `doctor` checks that the operator key unlocks when you give the node password (`--password` or `GENLAYERNODE_PASSWORD`, as for the node); without a password it shows a warning and does not fail
- `doctor --output json` writes one JSON document with a stable `code` and `action` for each finding, and exits `0` (start), `1` (blocked) or `2` (doctor could not run); the codes are in `docs/deploy/troubleshooting.md`
- Change the chain RPC key without a restart: put the key in a file and set `rollup.genlayerchainrpckeyfile` to its path; the node reads the file again at most every 30 s
- do not also set `GENLAYERNODE_ROLLUP_GENLAYERCHAINRPCKEY`: the node then does not start
- Contract-state pruning: set `node.state.enabled: true` to delete old contract-state versions behind finalized ones after `node.state.retention` (default `336h` of chain time); it is off by default, so the node keeps all history; read `docs/deploy/state-pruning.md` first
- The node makes fewer chain RPC calls: it keeps repeated transaction reads in memory and does no reorg check for blocks at or below the chain's `finalized` block
- the cache is on by default; its settings are under `consensus.transaction_cache`
- `genlayernode snapshot restore <directory|tar.gz> --datadir <empty-directory>` installs a `genvm` snapshot, and the node continues its sync after the snapshot block
- to take a snapshot at a known block, a full node can stop its sync at `consensus.sync_halt_block` and keep RPC and ops serving
- The RPC API answers `net_version` with the configured chain id

### Misc

- The node runs contracts through the WebSocket endpoint (`/ws`) of the GenVM manager, not its HTTP run API; a manager that you run yourself (`genvm.start_manager: false`) must serve that endpoint, as the shipped GenVM does
- Update the release image to Alpine 3.24.3, the Alloy image of the release compose file to v1.21.2, and `go-ethereum` to v1.17.10

### Bug fixes

- A leader no longer gets a strike when the commit phase ends on a timeout with enough commits: the leader did not reveal in that case, and now it does
- A new validator whose self-stake is still a pending deposit no longer fails `doctor` or gets a 503 from `/health`: both show a warning (`VALIDATOR_STAKE_PENDING`, reason `self_stake_pending`) until the next epoch moves the deposit into the stake
- a self-stake below the minimum is a warning too, and `doctor` exits 0
- `/health` no longer returns 503 for hours while a node far behind syncs from genesis; `chain.sync` is `unavailable` only when the sync fails at the same block for 5 minutes (`sync_blocked`) or cannot read the logs of a block (`sync_block_unreadable`)
- When the node cannot read a recent transaction of a contract from the chain, a GenVM or RPC read of that contract's latest state now fails, instead of giving an older state
- The nonce ledger of the transactions the node signed is now in `ops.db`, not `genvm.db`: a resync that deletes `genvm.db` no longer deletes it, and a `genvm` snapshot no longer carries it
- A start-up failure now logs its cause in `node.log` (`Failed to build dependencies`), and the error no longer says only `previously failed`
- `gen_dbg_traceTransaction` now reads all the fee inputs of a replayed transaction at its processing block; some came from the latest block
- Correct the API reference: the `directory` label of the `genlayer_node_disk_*` metrics is `genvm.db`, `ops.db`, `logs` or `keystore`

### Removed

- The node no longer renames a v0.5 `<datadir>/genlayer.db` to `genvm.db` at start: it ignores that folder and syncs from genesis into a new `genvm.db`; you can delete the old folder

### Security

- Build with Go 1.26.10, which has the fix for `GO-2026-6809` in the standard library
- Update `labstack/echo` to v4.16.3 for `GHSA-246p-cpwv-v3jq` (a rate-limit bypass with a spoofed `X-Forwarded-For` header)
27 changes: 26 additions & 1 deletion content/validators/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@ rollup:
genlayerchainrpcurl: "TODO: Set your GenLayer Chain HTTP RPC URL here" # GenLayer Chain RPC URL
genlayerchainwebsocketurl: "TODO: Set your GenLayer Chain WebSocket RPC URL here" # GenLayer Chain WebSocket URL
# An API key of the RPC provider never goes in these URLs or in this file:
# set it in the environment as GENLAYERNODE_ROLLUP_GENLAYERCHAINRPCKEY.
# set it in the environment as GENLAYERNODE_ROLLUP_GENLAYERCHAINRPCKEY,
# or, for a key that changes while the node runs, in a file named here:
# genlayerchainrpckeyfile: "/run/secrets/genlayer-rpc/key"
# The node sends it in this header (default X-AccessKey):
# genlayerchainrpckeyheader: "X-AccessKey"
provider: "TODO: Set your GenLayer Chain provider" # Rollup operator name; surfaces as the "provider" label on RPC-driven metrics. Set explicitly per deployment.
Expand All @@ -14,8 +16,22 @@ consensus:
manifestpath: "configs/node/protocol-manifest.json" # Trusted producer protocol manifest for this deployment: save your network's manifest (from its documentation) at this path; a dev-env deploy places its own here too. Relative paths resolve against the node root. A mismatch with consensusaddress is refused at startup.
chainid: "" # DECIMAL chain id this deployment was made on (not hex, no leading zeros). Held independently of the manifest so a manifest describing another deployment is caught.
# genesis: 47930 # (Optional) Genesis block number for this consensus deployment. If not provided, it will be auto-detected by searching for the first log from the ConsensusMain contract.
# sync_halt_block: 20000 # Node-local, full mode only; stop replay exactly here and keep RPC/ops serving. Zero disables.
# chain_submit_buffer: "30s" # (Optional) Slack reserved at the end of each consensus step to submit the resulting on-chain tx (commit vote, reveal vote, proposed receipt) before the slot closes. Tune to underlying settlement chain latency. Default 30s.
# admissiontimeout: "15s" # (Optional) Bound on the startup deployment admission check. Never unbounded. Default 15s.
# Cache of repeated transaction reads; on by default. A value read at a finalized
# block cannot change; one read above it can be replaced by a reorg, so it is kept
# shorter, and a detected reorg empties the cache. Tune with the
# genlayer_node_transaction_read_cache_* metrics.
# transaction_cache:
# enabled: true
# settled_ttl: 15m # values read at or below the finalized block
# unsettled_ttl: 30s # snapshots read above it
# unsettled_long_ttl: 10m # fee states and history answers read above it
# max_snapshots: 1024
# max_fee_states: 1024
# max_history: 4096
# preload_workers: 5 # sync filter history preloads reading the chain at a time
# data directory
datadir: "./data/node"
# logging configuration
Expand Down Expand Up @@ -193,6 +209,15 @@ node:
# # output, so its size is contract-controlled. Over the cap, the field is
# # truncated and the cut is marked in-band. 0 takes the default.
# max_debug_field_bytes: 262144 # 256 KB per field
# Contract-state history pruning; off by default (archive node). Past the
# window (chain time) the node keeps only the finalized state, so reads at
# older blocks fail. The window is raised at run time to the sum of
# the phase timeouts times the maximum rounds. Irreversible: read
# docs/deploy/state-pruning.md before enabling.
# state:
# enabled: false
# retention: 336h # two weeks
# sweep_interval: 10m # how often aged-out history is scheduled for pruning
# genvm configuration
genvm:
root_dir: ./opt/genvm/v0.6.0-rc10
Expand Down
Loading