Installation

Curvy SDK can be installed with a Node package manager:

pnpm add @0xcurvy/curvy-sdk

The SDK exposes a config object and action functions through focused package exports. Create a config before calling an action:

import { createCurvyConfig, destroyConfig } from "@0xcurvy/curvy-sdk/config";

const config = await createCurvyConfig({
  environment: "mainnet",
  apiBaseUrl: "https://api.curvy.box",
});

// Pass `config` explicitly in server or multi-config contexts.
await destroyConfig({ config });

For browser apps, prefer the convenience helper. It defaults to persistent IndexedDB storage plus session-scoped key rehydration:

import { createBrowserCurvyConfig } from "@0xcurvy/curvy-sdk/config";

const config = await createBrowserCurvyConfig({ apiBaseUrl });

Curvy's backend is a set of independent microservices. Everything routes through apiBaseUrl by default, but you can point any individual service at its own host:

const config = await createCurvyConfig({
  environment: "mainnet",
  apiBaseUrl: "https://api.curvy.box",
  metadataBaseUrl: "https://<your-metadata-host>", // networks, currencies, Curvy ID, auth
  indexerBaseUrl: "https://<your-indexer-host>",   // note + nullifier sync
  relayerBaseUrl: "https://<your-relayer-host>",   // proof submission + status
});

TIP

createCurvyConfig registers itself as the ambient/global config by default, so browser actions can resolve it without you threading config through every call. In multi-tenant contexts, prefer createServerCurvyConfig, which disables ambient registration by default, and pass config explicitly to avoid cross-tenant bleed.