> For the complete documentation index, see [llms.txt](https://docs.switchboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.switchboard.xyz/tooling/sdk-version-matrix.md). # SDK Version Matrix This page is the version reference for Switchboard docs, examples, and verifier tooling. * Baseline date: **June 12, 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 docs pin set** used by current docs and compatibility checks * `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.10.3` | `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.8.2` | `common`, `common/twitter-follower-count`, `common/variable-overrides`, `evm/*`, `solana/feeds/*`, `solana/prediction-market`, `solana/randomness/coin-flip`, `solana/surge`, `solana/x402` | Current TypeScript examples are aligned. | | `@switchboard-xyz/on-demand-solidity` | `^1.1.0` | `evm/price-feeds`, `evm/randomness/*` | Current EVM examples are aligned. | | `@switchboard-xyz/sui-sdk` | `^0.1.16` | `sui/feeds/basic`, `sui/surge/basic` | Aligned across current Sui examples. | | `switchboard-on-demand` | `0.13.0` | `common/rust-feed-creation`, `solana/feeds/*`, `solana/prediction-market`, `solana/randomness/coin-flip` | Current Rust examples are aligned. | | `switchboard-protos` | `0.2.6` | `solana/prediction-market` | Only used by the prediction-market program. | | `pinocchio` | `0.11.2` | `solana/feeds/advanced` | Companion dependency for the low-CU Pinocchio example. | ## Canonical Docs Pin Set These are the current docs pins. Example-backed pins match the observed versions above; docs-only pins are listed as the versions already used by their pages. | Package / Crate | Canonical Pin | Notes | | ------------------------------------- | ------------- | -------------------------------------------------------------- | | `@switchboard-xyz/on-demand` | `3.10.3` | Matches the current TypeScript example set. | | `@switchboard-xyz/common` | `5.8.2` | Matches the current shared EVM and Solana TypeScript examples. | | `@switchboard-xyz/on-demand-solidity` | `1.1.0` | Current Solidity interface pin. | | `@switchboard-xyz/sui-sdk` | `0.1.16` | Matches current Sui examples. | | `@switchboard-xyz/aptos-sdk` | `0.1.5` | Used by the Aptos and Movement docs. | | `@switchboard-xyz/iota-sdk` | `0.0.3` | Current docs pin. | | `switchboard-on-demand` | `0.13.0` | Matches current Rust examples. | | `switchboard-protos` | `0.2.6` | Matches the current prediction-market example. | ## 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` | Used by the Aptos and Movement docs. | | `@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. | | `pinocchio` | `0.11.2` | Matches the advanced Solana price-feed example. | ## 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.73.1` | ## Known Notes * Current TypeScript example manifests are aligned on `@switchboard-xyz/on-demand@^3.10.3` and `@switchboard-xyz/common@^5.8.2`. * `@mysten/sui` latest `2.x` still breaks the import surface used in current docs/examples, so `1.38.0` remains pinned. * Current Solana Rust examples use `switchboard-on-demand = "0.13.0"`. The advanced Pinocchio price-feed example uses `pinocchio = "0.11.2"` and the `AccountView` API. * `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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.