Configuration

Once you have an App ID, initialize the SDK with a configuration object specifying your endpoints and target chain.

Required Parameters

Parameter	Type	Description
`serverUrl`	`string`	URL of the Privacy Boost server
`appId`	`string`	Your application identifier (see App Setup)

Optional Parameters

Parameter	Type	Description
`chainId`	`number`	EVM chain ID for the target network (auto-discovered from server)
`shieldContractAddress`	`string`	Address of the deployed Shield contract (auto-discovered from server)
`wethContractAddress`	`string`	WETH contract address (required for native ETH deposits)
`rpcUrl`	`string`	JSON-RPC URL for on-chain reads (token registry lookups)
`logLevel`	`string`	Console log verbosity: `"silent"` (default), `"error"`, `"warn"`, `"info"`, `"debug"`

Example

import { PrivacyBoost } from '@sunnyside-io/privacy-boost';

const sdk = await PrivacyBoost.create({
  serverUrl: 'https://optimism.sepolia.privacyboost.io',
  wethContractAddress: '0x4200000000000000000000000000000000000006',
  appId: 'app_abc123xyz',
});

import PrivacyBoost

let config = PrivacyBoostConfig(
    serverUrl: "https://optimism.sepolia.privacyboost.io",
    wethContractAddress: "0x4200000000000000000000000000000000000006",
    appId: "app_abc123xyz"
)
let sdk = try await PrivacyBoost(config: config)

import com.privacyboost.sdk.*

val config = PrivacyBoostConfig(
    serverUrl = "https://optimism.sepolia.privacyboost.io",
    wethContractAddress = "0x4200000000000000000000000000000000000006",
    appId = "app_abc123xyz"
)
val sdk = PrivacyBoost(config)

# Via environment variables
export PRIVACY_BOOST_APP_ID=app_abc123xyz
export SERVER_URL=https://optimism.sepolia.privacyboost.io
export WETH_CONTRACT_ADDRESS=0x4200000000000000000000000000000000000006
export RPC_URL=https://sepolia.optimism.io

privacy-boost login

# Or use a network preset
privacy-boost --network op-sepolia login

Supported Networks

Network	Chain ID	`serverUrl`	Description
OP Mainnet	`10`	`https://optimism.privacyboost.io`	Optimism mainnet (production)
OP Sepolia	`11155420`	`https://optimism.sepolia.privacyboost.io`	Optimism Sepolia testnet (recommended for development)

CLI Environment Variables

The CLI reads configuration from environment variables:

Variable	Description
`PRIVACY_BOOST_APP_ID` or `APP_ID`	Application identifier
`SERVER_URL`	Privacy Boost server URL
`SHIELD_CONTRACT_ADDRESS`	Shield contract address (auto-discovered if omitted)
`WETH_CONTRACT_ADDRESS`	WETH contract address
`RPC_URL`	JSON-RPC URL

export PRIVACY_BOOST_APP_ID=app_abc123xyz
export SERVER_URL=https://optimism.sepolia.privacyboost.io

privacy-boost login

Logging

By default, the SDK produces no console output (silent). Set logLevel to control verbosity during development or debugging:

Level	Output
`"silent"`	No output (default)
`"error"`	Errors only
`"warn"`	Errors and warnings
`"info"`	Errors, warnings, and informational messages
`"debug"`	All messages including verbose debug output

const sdk = await PrivacyBoost.create({
  serverUrl: 'https://optimism.sepolia.privacyboost.io',
  appId: 'app_abc123xyz',
  logLevel: 'debug', // Enable verbose logging for development
});

Use "debug" during development to trace SDK operations. In production, leave it as "silent" (the default) or "error" to avoid leaking internal state to the browser console.

All log messages are tagged with the originating module (e.g., [Vault], [Auth]) for easy filtering in browser dev tools.

Multi-Chain Configuration

To operate on additional chains beyond your primary one, create chain clients with sdk.forChain(). Only serverUrl is required — all other parameters are auto-discovered:

const ethereum = sdk.forChain({ serverUrl: 'https://eth.example.com' });
const base = sdk.forChain({
  serverUrl: 'https://base.example.com',
  chainId: 8453,
  wethContractAddress: '0x4200000000000000000000000000000000000006',
});

Parameter	Type	Required	Description
`serverUrl`	`string`	Yes	URL of this chain’s server
`chainId`	`number`	No	EVM chain ID (auto-discovered)
`shieldContractAddress`	`string`	No	Shield contract address (auto-discovered)
`wethContractAddress`	`string`	No	WETH contract address
`rpcUrl`	`string`	No	RPC URL for on-chain reads
`tokenRegistryAddress`	`string`	No	Token registry contract (auto-discovered)
`teePublicKey`	`string`	No	TEE public key (auto-discovered)

See Multi-Chain for the full guide.

Next Steps

Authentication

Connect a wallet and log in

Key Management

Key derivation, persistence, and recovery

Multi-Chain

Operate across multiple blockchains

Quickstart

Setup

SDKs

Configuration

Configuration

Required Parameters

Optional Parameters

Example

Supported Networks

CLI Environment Variables

Logging

Multi-Chain Configuration

Next Steps

Authentication

Key Management

Multi-Chain

​Configuration

​Required Parameters

​Optional Parameters

​Example

​Supported Networks

​CLI Environment Variables

​Logging

​Multi-Chain Configuration

​Next Steps

Authentication

Key Management

Multi-Chain

Configuration

Required Parameters

Optional Parameters

Example

Supported Networks

CLI Environment Variables

Logging

Multi-Chain Configuration

Next Steps