ShadowWire SDK

TypeScript SDK for private payments on Solana using Bulletproof zero-knowledge proofs.

Overview

ShadowWire enables private transfers on Solana by hiding transaction amounts using Bulletproofs while maintaining on-chain verifiability. The protocol supports 22 tokens.

Installation

npm install @radr/shadowwire

Quick Start

import { ShadowWireClient } from '@radr/shadowwire';

const client = new ShadowWireClient();

const balance = await client.getBalance('YOUR_WALLET');

await client.transfer({
  sender: 'YOUR_WALLET',
  recipient: 'RECIPIENT_WALLET',
  amount: 0.5,
  token: 'SOL',
  type: 'internal'
});

Transfer Types

Internal Transfer: Amount is hidden using zero-knowledge proofs.

External Transfer: Amount is visible but sender remains anonymous. Works with any Solana wallet.

API Reference

Client Configuration

const client = new ShadowWireClient({
  apiBaseUrl: 'https://custom-api.com',
  debug: true
});

Balance

const balance = await client.getBalance('WALLET_ADDRESS', 'SOL');

Deposit

const response = await client.deposit({
  wallet: 'YOUR_WALLET',
  amount: 100000000
});

Withdraw

const response = await client.withdraw({
  wallet: 'YOUR_WALLET',
  amount: 50000000
});

Transfer

const result = await client.transfer({
  sender: 'YOUR_WALLET',
  recipient: 'RECIPIENT_WALLET',
  amount: 0.1,
  token: 'SOL',
  type: 'internal',
  wallet: { signMessage }
});

Fee Calculation

const fee = client.getFeePercentage('SOL');
const minimum = client.getMinimumAmount('SOL');
const breakdown = client.calculateFee(1.0, 'SOL');

Wallet Authentication

All transfers require wallet signature authentication:

import { useWallet } from '@solana/wallet-adapter-react';

const { signMessage, publicKey } = useWallet();

await client.transfer({
  sender: publicKey.toBase58(),
  recipient: 'RECIPIENT_ADDRESS',
  amount: 1.0,
  token: 'SOL',
  type: 'internal',
  wallet: { signMessage }
});

Client-Side Proof Generation

For maximum privacy, generate proofs in the browser:

import { initWASM, generateRangeProof, isWASMSupported } from '@radr/shadowwire';

if (isWASMSupported()) {
  await initWASM('/wasm/settler_wasm_bg.wasm');
  
  const proof = await generateRangeProof(100000000, 64);
  
  await client.transferWithClientProofs({
    sender: 'YOUR_WALLET',
    recipient: 'RECIPIENT_WALLET',
    amount: 0.1,
    token: 'SOL',
    type: 'internal',
    customProof: proof
  });
}

Supported Tokens

| Token | Decimals | Fee | |-------|----------|-----| | SOL | 9 | 0.5% | | RADR | 9 | 0.3% | | USDC | 6 | 1% | | ORE | 11 | 0.3% | | BONK | 5 | 1% | | JIM | 9 | 1% | | GODL | 11 | 1% | | HUSTLE | 9 | 0.3% | | ZEC | 9 | 1% | | CRT | 9 | 1% | | BLACKCOIN | 6 | 1% | | GIL | 6 | 1% | | ANON | 9 | 1% | | WLFI | 6 | 1% | | USD1 | 6 | 1% | | AOL | 6 | 1% | | IQLABS | 9 | 0.5% | | SANA | 6 | 1% | | POKI | 9 | 1% | | RAIN | 6 | 2% | | HOSICO | 9 | 1% | | SKR | 6 | 0.5% |

Token Utilities

import { TokenUtils } from '@radr/shadowwire';

TokenUtils.toSmallestUnit(0.1, 'SOL');
TokenUtils.fromSmallestUnit(100000000, 'SOL');

Error Handling

import { 
  RecipientNotFoundError, 
  InsufficientBalanceError,
  TransferError 
} from '@radr/shadowwire';

try {
  await client.transfer({ ... });
} catch (error) {
  if (error instanceof RecipientNotFoundError) {
  }
}

Browser Compatibility

Client-side proof generation requires WebAssembly support:

• Chrome 57+
• Firefox 52+
• Safari 11+
• Edge 16+

See Browser Setup Guide for framework-specific configuration.

Links

• Telegram: https://t.me/radrportal
• Twitter: https://x.com/radrdotfun
• Email: [email protected]

License

MIT