# 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.switchboard.xyz/tooling/sdk-version-matrix.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.