TypeScript SDK

The Solvela TypeScript SDK lives in the monorepo at sdks/typescript/.

Status

Note

@solvela/sdk@0.3.0 converts post-signing 402s to PaymentRejectedError on both paths; 0.2.4 (published 2026-06-06) added opt-in escrow-program-id pinning (atop the native escrow-deposit signing from 0.2.3) and is wire-aligned with the production gateway at api.solvela.ai. Pin to ^0.3.0 — earlier 0.2.x releases emit a PaymentPayload envelope shape the gateway no longer accepts.

As of 0.3.0, a post-signing 402 on the retry — after a Payment-Signature was attached — is converted to PaymentRejectedError on both the non-streaming and streaming paths, exactly like the Go and Python SDKs — instanceof PaymentRejectedError distinguishes "signed and rejected" from a pre-signing PaymentRequiredError challenge on both paths.

For low-level use inside or outside the monorepo, the @solvela/signer-core package exposes the x402 parser + payment-signer primitives that sdks/mcp/, sdks/openclaw-provider/, and sdks/ai-sdk-provider/ build on.

Documentation

Source: sdks/typescript/ in the monorepo
npm package: @solvela/sdk (current: 0.3.0)

History

The TypeScript SDK previously lived in a standalone repository at solvela-ai/solvela-ts. It was consolidated into the monorepo on 2026-05-12 (PR #259) so wire-format drift between the gateway and SDK becomes a same-PR CI failure rather than a post-hoc incident. The standalone repository is archived; clones of the old URL land on a redirect README.