solana-transaction-status

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.

CLI

Changes

• Add global --skip-preflight option for skipping preflight checks on all transactions sent through RPC. This flag, along with --use-rpc, can improve success rate with program deployments using the public RPC nodes.
• Add new command solana feature revoke for revoking pending feature activations. When a feature is activated, solana feature revoke <feature-keypair> <cluster> can be used to deallocate and reassign the account to the System program, undoing the operation. This can only be done before the feature becomes active.

Validator

Breaking

• Blockstore Index column format change
  • The Blockstore Index column format has been updated. The column format written in v2.2 is compatible with v2.1, but incompatible with v2.0 and older.
• Snapshot format change
  • The snapshot format has been modified to implement SIMD-215. Since only adjacent versions are guaranteed to maintain snapshot compatibility, this means snapshots created with v2.2 are compatible with v2.1 and incompatible with v2.0 and older.

Changes

• Add new variant to --block-production-method for central-scheduler-greedy. This is a simplified scheduler that has much better performance than the more strict central-scheduler variant.
• Unhide --accounts-db-access-storages-method for agave-validator and agave-ledger-tool and change default to file
• Remove tracer stats from banking-trace. banking-trace directory should be cleared when restarting on v2.2 for first time. It will not break if not cleared, but the file will be a mix of new/old format. (#4043)
• Add --snapshot-zstd-compression-level to set the compression level when archiving snapshots with zstd.

Deprecations

• Deprecate --tower-storage and all --etcd-* arguments

SDK

Changes

• cargo-build-sbf: add --skip-tools-install flag to avoid downloading platform tools and --no-rustup-override flag to not use rustup when invoking cargo. Useful for immutable environments like Nix.

• Breaking:
  • SDK:
    • cargo-build-bpf and cargo-test-bpf have been deprecated for two years and have now been definitely removed. Use cargo-build-sbf and cargo-test-sbf instead.
    • dependency: curve25519-dalek upgraded to new major version 4 (#1693). This causes breakage when mixing v2.0 and v2.1 Solana crates, so be sure to use all of one or the other. Please use only crates compatible with v2.1.
  • Stake:
    • removed the unreleased redelegate instruction processor and CLI commands (#2213)
  • Banks-client:
    • relax functions to use &self instead of &mut self (#2591)
  • agave-validator:
    • Remove the deprecated value of fifo for --rocksdb-shred-compaction (#3451)
• Changes
  • SDK:
    • removed the respan macro. This was marked as "internal use only" and was no longer used internally.
    • add entrypoint_no_alloc!, a more performant program entrypoint that avoids allocations, saving 20-30 CUs per unique account
    • cargo-build-sbf: a workspace or package-level Cargo.toml may specify tools-version for overriding the default platform tools version when building on-chain programs. For example:

[package.metadata.solana]
tools-version = "1.43"

or

[workspace.metadata.solana]
tools-version = "1.43"

The order of precedence for the chosen tools version goes: --tools-version argument, package version, workspace version, and finally default version.

• package-metadata: specify a program's id in Cargo.toml for easy consumption by downstream users and tools using solana-package-metadata (#1806). For example:

[package.metadata.solana]
program-id = "MyProgram1111111111111111111111111111111111"

Can be consumed in the program crate:

solana_package_metadata::declare_id_with_package_metadata!("solana.program-id");

This is equivalent to writing:

solana_pubkey::declare_id!("MyProgram1111111111111111111111111111111111");

• agave-validator: Update PoH speed check to compare against current hash rate from a Bank (#2447)
• solana-test-validator: Add --clone-feature-set flag to mimic features from a target cluster (#2480)
• solana-genesis: the --cluster-type parameter now clones the feature set from the target cluster (#2587)
• unified-scheduler as default option for --block-verification-method (#2653)
• warn that thread-local-multi-iterator option for --block-production-method is deprecated (#3113)