# SDK Version Matrix

This page is the version reference for Switchboard docs, examples, and verifier tooling.

* Baseline date: **March 24, 2026**
* Source of truth: [`tooling/sdk-versions.lock.json`](https://github.com/switchboard-xyz/gitbook-on-demand/blob/main/tooling/sdk-versions.lock.json)
* The lock file now tracks two different views:
  * `sdk_versions` / `companion_versions`: the **canonical verifier pin set** used by local audit scripts
  * `observed_example_versions`: the **exact versions currently pinned in the checked-in `sb-on-demand-examples` manifests**

## Observed Versions In Current Examples

| Package / Crate                       | Observed Version(s)           | Current Example References                                                                                                                                     | Notes                                                            |
| ------------------------------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `@switchboard-xyz/on-demand`          | `^3.9.0`                      | `common`, `solana/feeds/*`, `solana/prediction-market`, `solana/randomness/coin-flip`, `solana/surge`, `solana/x402`, `sui/feeds/basic`, `sui/surge/basic`     | Current TypeScript examples are aligned.                         |
| `@switchboard-xyz/common`             | `^5.7.0`                      | `common`, `common/twitter-follower-count`, `evm/*`, `solana/feeds/*`, `solana/prediction-market`, `solana/randomness/coin-flip`, `solana/surge`, `solana/x402` | Current TypeScript examples are aligned.                         |
| `@switchboard-xyz/on-demand-solidity` | `^0.0.4`, `^1.1.0`            | `evm/price-feeds`, `evm/randomness/*`                                                                                                                          | Price-feeds and randomness are on different package generations. |
| `@switchboard-xyz/sui-sdk`            | `^0.1.14`                     | `sui/feeds/basic`, `sui/surge/basic`                                                                                                                           | Aligned across current Sui examples.                             |
| `switchboard-on-demand`               | `0.11.3`, `=0.10.3`, `0.10.0` | `common/rust-feed-creation`, `solana/feeds/*`, `solana/prediction-market`, `solana/randomness/coin-flip`                                                       | Rust examples are also split by flow.                            |
| `switchboard-protos`                  | `^0.2.1`                      | `solana/prediction-market`                                                                                                                                     | Only used by the prediction-market program.                      |

## Canonical Verifier Pin Set

These are the pins currently used by `scripts/verify-switchboard-deps.sh` and related tooling when it normalizes manifests for compatibility checks.

| Package / Crate                       | Canonical Pin | Notes                                                                    |
| ------------------------------------- | ------------- | ------------------------------------------------------------------------ |
| `@switchboard-xyz/on-demand`          | `3.9.0`       | Matches the current TypeScript example set.                              |
| `@switchboard-xyz/common`             | `5.7.0`       | Matches the current shared EVM and Solana TypeScript examples.           |
| `@switchboard-xyz/on-demand-solidity` | `1.1.0`       | Canonical Solidity interface pin for verifier runs.                      |
| `@switchboard-xyz/sui-sdk`            | `0.1.14`      | Matches current Sui examples.                                            |
| `@switchboard-xyz/aptos-sdk`          | `0.1.5`       | Used in smoke projects.                                                  |
| `@switchboard-xyz/iota-sdk`           | `0.0.3`       | Used in smoke projects.                                                  |
| `switchboard-on-demand`               | `0.11.3`      | Verifier pin; actual Solana program manifests currently vary by example. |
| `switchboard-protos`                  | `0.2.4`       | Verifier pin for Rust compatibility checks.                              |

## Companion Dependencies

| Dependency           | Canonical Pin | Notes                                                     |
| -------------------- | ------------- | --------------------------------------------------------- |
| `@solana/web3.js`    | `1.98.0`      | Matches current Solana examples.                          |
| `@mysten/sui`        | `1.38.0`      | Compatible with current Sui docs/examples import surface. |
| `@aptos-labs/ts-sdk` | `6.1.0`       | Aptos + Movement smoke projects.                          |
| `@iota/iota-sdk`     | `1.11.0`      | Iota smoke projects.                                      |
| `ethers`             | `6.13.1`      | Matches the current EVM price-feeds example manifest.     |
| `@coral-xyz/anchor`  | `0.31.1`      | Matches the current Solana example manifests.             |

## Toolchain Baseline

| Tool              | Version                                                       |
| ----------------- | ------------------------------------------------------------- |
| Node.js           | `23.11.0` (verified, `>=24` recommended for `@iota/iota-sdk`) |
| Bun               | `1.3.6`                                                       |
| Rust              | `1.89.0-nightly`                                              |
| Anchor CLI        | `0.31.1`                                                      |
| Solana CLI        | `2.3.11`                                                      |
| Foundry (`forge`) | `1.5.0`                                                       |
| Aptos CLI         | `8.1.0`                                                       |
| Sui CLI           | `1.66.2`                                                      |

## Known Notes

* Current TypeScript example manifests are aligned on `@switchboard-xyz/on-demand@^3.9.0` and `@switchboard-xyz/common@^5.7.0`.
* `@mysten/sui` latest `2.x` still breaks the import surface used in current docs/examples, so `1.38.0` remains pinned.
* `@switchboard-xyz/on-demand-solidity` is still split by flow: `evm/price-feeds` uses `^0.0.4` while the randomness examples use `^1.1.0`.
* `solana/prediction-market` may hit `edition2024` dependency parsing under current Solana toolchains. If `cargo build-sbf` fails there, fall back to a host-side cargo check.
* `sui/feeds/basic` defaults its checked-in `Move.toml` to testnet. Use the explicit `build:testnet`, `build:mainnet`, `deploy:testnet`, and `deploy:mainnet` scripts when documenting or verifying flows.