solana-zk-token-sdk

RPC

Breaking

• Added a slot property to EpochRewardsPeriodActiveErrorData
• Added error data containing a slot property to RpcCustomError::SlotNotEpochBoundary

Changes

• The subscription server now prioritizes processing received messages before sending out responses. This ensures that new subscription requests and time-sensitive messages like PING opcodes take priority over notifications.

Validator

Breaking

• When XDP is enabled, the validator process requires the CAP_NET_RAW, CAP_NET_ADMIN, CAP_BPF, and CAP_PERFMON capabilities. These can be configured in the systemd service file by setting CapabilityBoundingSet=CAP_NET_RAW CAP_NET_ADMIN CAP_BPF CAP_PERFMON under the [Service] section or directly on the binary with the command sudo setcap cap_net_raw,cap_net_admin,cap_bpf,cap_perfmon=p <path/to/agave-validator> (this command must be run each time the binary is replaced)
• Enabling XDP zero copy on systems configured with LACP bond requires manually passing --experimental-retransmit-xdp-interface <real-interface> (e.g.: eno17395np0 not bond0), as zero copy is only available on physical interfaces.
• Require increased memlock limits - recommended setting is LimitMEMLOCK=2000000000 in systemd service configuration. Lack of sufficient limit (on Linux) will cause startup error.
• Remove deprecated arguments
  • --accounts-index-memory-limit-mb
  • --accountsdb-repl-bind-address, --accountsdb-repl-port, --accountsdb-repl-threads, --enable-accountsdb-repl
  • --disable-quic-servers, --enable-quic-servers
  • --etcd-cacert-file, --etcd-cert-file, --etcd-domain-name, --etcd-endpoint, --etcd-key-file, --tower-storage
  • --no-check-vote-account
  • --no-rocksdb-compaction, --rocksdb-compaction-interval-slots, --rocksdb-max-compaction-jitter-slots
  • --replay-slots-concurrently
    • Use --replay-forks-threads with a value of 4 to match preexisting behavior
  • --rpc-pubsub-max-connections, --rpc-pubsub-max-fragment-size, --rpc-pubsub-max-in-buffer-capacity, --rpc-pubsub-max-out-buffer-capacity, --enable-cpi-and-log-storage, --minimal-rpc-api
  • --skip-poh-verify
• Deprecated snapshot archive formats have been removed and are no longer loadable.
• Using --snapshot-interval-slots 0 to disable generating snapshots has been removed. Use --no-snapshots instead.
• Validator will now bind all ports within provided --dynamic-port-range, including the client ports. A range of at least 25 ports is recommended to avoid failures to bind during startup.
• Agave and agave-ledger-tool can no longer operate with legacy shreds. Legacy shreds have not been in circulation since the activation of https://explorer.solana.com/address/GV49KKQdBNaiv2pgqhS2Dy3GWYJGXMTVYbYkdk91orRy. This change may break operations with old ledgers that may still contain legacy shreds.

Changes

• --transaction-structure view is now the default.
• The default full snapshot interval is now 100,000 slots.
• SOLANA_BANKING_THREADS environment variable is no longer supported. Use --block-prouduction-num-workers instead.
• By default, agave-validator exit will now wait for the validator process to terminate before returning. The --wait-for-exit flag has been deprecated, but operators can still opt out with the new --no-wait-for-exit flag.