Pick an integration path based on where your code runs and which network preset you target. Core concepts are multi-chain; the Stellar preset is documented as the first shipped path.

Choose your runtime

Stellar preset path

For Stellar + Soroban applications:
  1. Install @arcanetech/privacy-sdk-stellar and a state adapter — see Quick start or Install.
  2. Load bundled runtime assets with loadDefaultStellarBrowserAssets() (browser) or filesystem paths via @arcanetech/privacy-sdk-stellar/node.
  3. Implement a Stellar wallet adapter (getAddress, authorizeMessage, signTransactionPayload).
  4. Pass transactEnvironment with Soroban RPC URL, pool/registry contract IDs, KYT config, and signTransaction.
  5. Create the client once at app startup.
Full React + Redux wiring: Setup.

Node path (Stellar preset)

Use @arcanetech/privacy-sdk-stellar/node when assets load from disk and a server-side wallet holds signing keys.
Supply filesystem paths for bundled runtime assets and the same network, wallet, and state adapters as the browser path.

Test path (Stellar preset)

Use @arcanetech/privacy-sdk-stellar/testing to inject a fake transact engine and @arcanetech/privacy-sdk-state-memory for isolated state:
Tests can call prepare and execute without a live Soroban RPC endpoint.

What you bring vs what the SDK brings

  1. Introduction and Packages
  2. Domain model and Operation lifecycle
  3. Quick start (Stellar preset)
  4. State integration and Data sources
  5. Stellar application development for production React wiring

Quick start (Stellar preset)

Minimal in-memory bootstrap.

State integration

Memory vs Redux adapters.

Setup

Production Stellar React shell.