Install
npm install @x0-protocol/sdk
yarn add @x0-protocol/sdk
pnpm add @x0-protocol/sdk
Peer Dependencies
The SDK requires the following Solana packages:
npm install @solana/web3.js @coral-xyz/anchor bn.js
| Package | Version | Purpose |
|---|
@solana/web3.js | ^1.87.0 | Solana RPC and transaction primitives |
@coral-xyz/anchor | ^0.30.1 | IDL deserialization and instruction building |
bn.js | ^5.2.0 | Arbitrary-precision integers for token amounts |
WASM Module (Optional)
For zero-knowledge proof generation in the browser or Node.js:
npm install @x0-protocol/zk-proofs-wasm
TypeScript Configuration
The SDK ships with full TypeScript declarations. Recommended tsconfig.json settings:
{
"compilerOptions": {
"target": "ES2020",
"module": "ESNext",
"moduleResolution": "bundler",
"esModuleInterop": true,
"strict": true
}
}
Environment Setup
import { createDevnetClient } from '@x0-protocol/sdk';
const client = createDevnetClient(wallet);
import { createMainnetClient } from '@x0-protocol/sdk';
const client = createMainnetClient(wallet, 'https://your-rpc.com');
import { createX0Client } from '@x0-protocol/sdk';
import { Connection, clusterApiUrl } from '@solana/web3.js';
const client = createX0Client({
connection: new Connection(clusterApiUrl('devnet')),
wallet: walletAdapter,
commitment: 'confirmed',
});
Package Exports
The SDK exports everything from a single entry point:
// All managers, types, constants, and utilities
import {
X0Client,
PolicyManager,
EscrowManager,
RegistryManager,
ReputationManager,
TokenClient,
WrapperClient,
ConfidentialClient,
ZkVerifierClient,
// types
AgentPolicyConfig,
EscrowAccount,
AgentRegistryEntry,
// constants
X0_GUARD_PROGRAM_ID,
PROTOCOL_FEE_BASIS_POINTS,
// utilities
calculateProtocolFee,
deriveAgentPolicyPda,
// ... and more
} from '@x0-protocol/sdk';
Last modified on February 8, 2026
