Changelog

Carbon's release history, from 0.3.0 to 2.0.0, with the breaking changes and migration notes for each version.

What changed in each Carbon release. 2.0.0 comes from CHANGELOG.md at the v2.0.0 tag; earlier versions come from the GitHub release notes, which are the only record for them. Numbers like (#587) are pull requests in sevenlabs-hq/carbon. To upgrade from Carbon 1, follow Migrate to 2.0.

2.0.0 (2026-09-04)#

Carbon 2.0 is the Agave 4 compatibility release. It upgrades the supported Solana dependency cohort, adds end-to-end Transaction V1 handling, and standardizes account-closure delivery without introducing the larger datasource and pipeline redesign planned for Carbon 3.

Highlights#

Upgraded the workspace to the Agave 4.2-compatible Solana crates and Rust 1.96.1 (#587).
Added Transaction V1 conversion and instruction traversal, including runtime inner instructions and V1 account metadata.
Added strict Yellowstone protobuf conversion for legacy, V0 and V1 transactions.
Classified zero-lamport account updates as Update::AccountDeletion consistently while preserving the final Account state.
Added an optional starting slot to Helius LaserStream (#585) and opt-in tonic client reconnection to Yellowstone (#589).
Added native Codama event rendering (#575, #578), event-CPI discriminator exports (#583), encoded discriminator handling, and base58 instruction-metadata serialization (#576).
Hardened instruction handling for short log events (#582) and invalid CPI stack heights (#584), and sanitized exported Prometheus metric names (#570).
Updated projects generated by @sevenlabs-hq/carbon-cli and @sevenlabs-hq/carbon-codama-renderer to depend on Carbon 2 crates.
Corrected the CLI package's ESM and CommonJS export paths.
Made the CLI reject GraphQL scaffolds without the Postgres storage layer they require.
Fixed template lookup through the renderer's CommonJS entry point.
Raised the npm packages' runtime requirement to Node.js 20.18.0.

Also in this release#

carbon-token-program-decoder decodes accounts with the SPL Pack layout (#569).
Yellowstone gRPC datasource: accepts a ping as the first event after a disconnect (#573), backs off between failed subscribe attempts (#581), and keeps the subscription filters on the ping resubscribe (#588).
carbon-helius-atlas-ws-datasource uses the latest published Helius SDK crate (#567).

Migration from Carbon 1#

Toolchain and dependencies#

Carbon 2 requires Rust 1.96.1. The companion CLI, renderer and version-registry packages require Node.js 20.18.0 or newer. Update every directly declared Carbon crate to 2.0.0 and keep direct Solana dependencies compatible with the Agave 4.2 cohort. Do not mix Carbon 2 with Carbon 1 datasource or decoder crates in one dependency graph.

If Carbon types appear in your public API, update imports and fix type mismatches after resolving the new Solana crates. A single version of each Solana type crate should resolve in the final graph.

Transaction source configuration#

Caller-owned RPC block configurations must opt into Transaction V1 and request a binary transaction encoding. Carbon cannot reconstruct the original transaction from Json or JsonParsed payloads.

Rust

RpcBlockSubscribeConfig {
    encoding: Some(UiTransactionEncoding::Base64),
    transaction_details: Some(TransactionDetails::Full),
    max_supported_transaction_version: Some(1),
    ..RpcBlockSubscribeConfig::default()
}

Use the equivalent fields on RpcBlockConfig when constructing RpcBlockCrawler. Carbon's RPC transaction crawler and Helius GTFA datasource set V1 and Base64 internally.

For Helius Atlas transaction subscriptions, override the SDK's JSON-parsed default and keep V1 enabled:

Rust

TransactionSubscribeOptions {
    encoding: Some(UiEnhancedTransactionEncoding::Base64),
    max_supported_transaction_version: Some(1),
    ..TransactionSubscribeOptions::default()
}

Account deletions#

AccountDeletion now contains the source's final account: Account. Custom datasources should construct an AccountUpdate and call into_update() so every zero-lamport account is normalized at the same boundary.

The former account_deletions_tracked constructor argument and fields were removed. Remove that argument when constructing:

HeliusWebsocket
LaserStreamGeyserClient
YellowstoneGrpcGeyserClient
StreamMessageClient

If you construct AccountDeletion directly, provide its new account field.

Datasource configuration changes#

LaserStreamClientConfig::new has a new trailing from_slot: Option<u64> argument. Pass None to preserve the previous starting behavior, or use LaserStreamClientConfig::default() and set the field.
Yellowstone tonic client reconnection is disabled by default. Opt in with YellowstoneGrpcClientConfig::with_reconnect(ReconnectConfig) when the upstream supports replay appropriate for your pipeline.

SPL Token account helpers#

The Mint::decode, Multisig::decode and Token::decode convenience methods in carbon-token-program-decoder were removed. Direct callers should unpack with solana_program_pack::Pack and convert the result:

Rust

let token = spl_token_interface::state::Account::unpack(data)
    .ok()
    .map(carbon_token_program_decoder::accounts::token::Token::from);

Normal decoding through TokenProgramDecoder requires no special migration.

The step-by-step version of this section, with before-and-after code, is Migrate to 2.0.

Carbon 2 datasource set#

The Carbon 2 publication contains these twelve datasource crates:

Helius Atlas WS, GPA V2, GTFA and LaserStream
RPC block crawler, block subscribe, GPA, program subscribe and transaction crawler
Stream message
Validator snapshot
Yellowstone gRPC

carbon-jito-shredstream-grpc-datasource and carbon-jetstreamer-datasource are not published on the 2.0 line. Jito ShredStream does not yet support Transaction V1, while Jetstreamer does not yet support the Solana v4 stack. Existing versions remain available, but they must not be selected as Carbon 2 dependencies.

1.0.0 (2026-06-04)#

The first stable release: a core refactor with atomic metrics, a filtering redesign, versioned decoders and CPI events, four new datasources, and regenerated decoders. Release notes.

Core#

Atomic metrics (#531) and datasource-level metrics flushing (#538).
Filtering redesign (#534).
Versioned decoders (#535).
Transaction pipe refactor (#537) and performance updates (#532).
ArrangeAccounts refactor (#529).
CPI events support (#550).
Transaction index field on TransactionUpdate and TransactionMetadata (#503).
Datasource disconnection tracking with gap detection (#471).
Better identification of writable accounts (#542).
Precompile offsets handled in instruction log extraction (#526).
Consistency pass and workspace doc comments (#562).
Rust toolchain 1.88.0 (#488).

Datasources#

New: Jetstreamer (#487), RPC GPA (#492), Helius GPA v2 (#493), Helius GTFA (#505) and validator snapshot (#497).
Helius WebSocket: configurable timeouts and reconnection on idle transaction streams (#507).

Decoders#

New: Onchain Labs DEX router v1 (#518) and v2 (#519), Jupiter Lend Liquidity (#524).
Optional base58 serialization for Pubkey fields in decoder structs (#514).
All decoders regenerated with the new generator (#540) and updated from the latest IDLs (#564).
Fixes: Token-2022 accounts without extensions (#510) and an extensions panic (#513); Pump.fun, PumpSwap and Pump fees decoders (#517, #545), including OptionBool deserialization (#555, #556); program ID validation in the Meteora DBC decoder (#516); Meteora DAMM v2 from the latest IDL (#522); Orca Whirlpool event discriminator (#547); Jupiter swap (#490); bugs found in a decoder survey (#565).

CLI and tooling#

The CLI generates workspace decoders (#539) and passes clippy on generated decoders (#536); CI fixes for generated decoders and indexers (#489).
Packages: removed an unused base64 dependency and made serde-big-array conditional (#523).
New examples (#544, #558).
Corrected path typos in workspace.dependencies (#557).

2.0.0 (2026-09-04)#

Highlights#

Also in this release#

Migration from Carbon 1#

Toolchain and dependencies#

Transaction source configuration#

Account deletions#

Datasource configuration changes#

SPL Token account helpers#

Carbon 2 datasource set#

1.0.0 (2026-06-04)#

Core#

Datasources#

Decoders#

CLI and tooling#

0.12.0 (2025-11-27)#

0.11.0 (2025-10-18)#

0.10.0 (2025-09-16)#

0.9.1 (2025-07-18)#

0.9.0 (2025-07-06)#

0.8.1 (2025-05-12)#

0.8.0 (2025-04-18)#

0.7.0 (2025-03-30)#

0.6.2 (2025-03-21)#

0.6.1 (2025-03-17)#

0.6.0 (2025-03-12)#

0.5.1 (2025-02-22)#

0.5.0 (2025-02-20)#

0.4.1 (2025-02-18)#

0.4.0 (2024-12-19)#

0.3.1 (2024-12-02)#

0.3.0 (2024-11-21)#

Added#

Changed#

Fixed#