Installation

Install

bun add @cypher-zk/sdk @solana/web3.js

npm install @cypher-zk/sdk @solana/web3.js

yarn add @cypher-zk/sdk @solana/web3.js

pnpm add @cypher-zk/sdk @solana/web3.js

Pin @solana/web3.js to ^1.95.4. The SDK is not compatible with @solana/web3.js v2 or @solana/kit.

Import paths

The package ships three entry points. Only import what you need.

Path	Use for
`@cypher-zk/sdk`	Core client, actions, account types, utilities
`@cypher-zk/sdk/react`	React hooks (`usePlaceBet`, `useMarkets`, etc.)

Never import @cypher-zk/sdk/react in a Node.js script - it pulls in React and TanStack Query which are browser-only.

Buffer polyfill (Next.js / Vite)

The SDK uses Node’s Buffer internally. In browser bundlers, Buffer is not available by default.

Next.js (Turbopack)
Next.js (Webpack)
Vite

Create src/lib/buffer-polyfill.ts and import it at the top of your root layout:

TypeScript

// src/lib/buffer-polyfill.ts
import { Buffer } from "buffer";
if (typeof window !== "undefined") {
  window.Buffer = window.Buffer ?? Buffer;
}

TypeScript

// src/app/layout.tsx
import "@/lib/buffer-polyfill";

Then add to next.config.ts:

TypeScript

const nextConfig = {
  experimental: {
    turbo: {
      resolveAlias: {
        buffer: "buffer",
      },
    },
  },
};

TypeScript

// next.config.ts
const nextConfig = {
  webpack: (config) => {
    config.resolve.fallback = {
      ...config.resolve.fallback,
      fs: false,
      buffer: require.resolve("buffer/"),
    };
    return config;
  },
};

Install the buffer package:

bun add buffer

npm install buffer

yarn add buffer

pnpm add buffer

TypeScript

// vite.config.ts
import { defineConfig } from "vite";
import { nodePolyfills } from "vite-plugin-node-polyfills";

export default defineConfig({
  plugins: [nodePolyfills()],
});

bun add vite-plugin-node-polyfills

npm install vite-plugin-node-polyfills

yarn add vite-plugin-node-polyfills

pnpm add vite-plugin-node-polyfills

What’s next

Quickstart - initialize the client and place your first bet
React setup - wire up CypherProvider in your app

Get started

React

Actions

Reference

Changelog

Install

Import paths

Buffer polyfill (Next.js / Vite)

What’s next

​Install

​Import paths

​Buffer polyfill (Next.js / Vite)

​What’s next

Install

Import paths

Buffer polyfill (Next.js / Vite)

What’s next