SDKs

SDKs

Client libraries for Solvela — TypeScript, Python, Go, Rust CLI, MCP, and the Claude Code drop-in sidecar

Official SDKs are available for four languages, plus an MCP server and a Claude Code drop-in sidecar. All SDKs handle the x402 payment handshake automatically — pass a private key and the SDK signs transactions for you.

Note

@solvela/sdk@0.3.0 converts post-signing 402s to PaymentRejectedError on both paths, atop 0.2.4's opt-in escrow-program-id pinning and the native escrow-deposit signing from 0.2.3, and is wire-aligned with the live gateway. Pin to ^0.3.00.2.x releases before 0.2.2 predate the v2 payment envelope and will not complete a real payment against api.solvela.ai.

Comparison

LanguagePackageInstallx402 Auto-paymentAsync
TypeScript@solvela/sdknpm install @solvela/sdk@^0.3.0YesYes
Pythonsolvela-sdkpip install "solvela-sdk>=0.3.0"YesYes (async-only)
Gogithub.com/solvela-ai/solvela/sdks/gogo get github.com/solvela-ai/solvela/sdks/goYes (built-in KeypairSigner, escrow scheme; exact needs a custom Signer)Yes (context-based)
Rust CLIsolvela-clicargo install solvela-cliYes
MCP Server@solvela/mcp-servernpm install -g @solvela/mcp-serverYes
Claude Code sidecar@solvela/dropinnpx solvela-dropinYes (spend-down channel vouchers)
Signer primitives@solvela/signer-corenpm install @solvela/signer-coreLibrary — x402 signing + channel ChannelTracker

Source code

All four language SDKs live in the solvela-ai/solvela monorepo under sdks/. The standalone single-SDK repositories were consolidated and archived 2026-05-12; legacy clone URLs redirect to the new monorepo paths.

The Rust client SDK was consolidated into the monorepo on 2026-05-16 (#316) at sdks/rust/; the standalone solvela-ai/solvela-client repo is archived. The four legacy Rust crates (solvela-client, solvela-client-cli, solvela-client-cli-args, solvela-client-proxy) remain published on crates.io (currently 0.4.0) — cargo install solvela-client-cli still works, and they now publish from the monorepo via a tag-triggered workflow. The monorepo's flagship CLI is solvela-cli (cargo install solvela-cli).