API

{
  "program": "9fhQBbumKEFuXtMBDw8AaQyAjCorLGJQiS3skWZdQyQD",
  "relayer": "https://api3.privacycash.org",
  "tokens": [
    {
      "symbol": "SOL",
      "mint": "So11111111111111111111111111111111111111112",
      "decimals": 9,
      "notes": 889912,
      "minimumWithdrawal": "0.01",
      "withdrawFee": { "rate": 0.0035, "flat": "0.006" }
    },
    …USDC, USDT
  ],
  "shieldFee": "0"
}

import { PrivacyCash } from "privacycash";

// The SDK derives your pool key from your wallet's key pair; it never leaves this process
const pool = new PrivacyCash({ RPC_url: process.env.RPC_URL!, owner: keypair });

// Shield: a public deposit, the last thing on chain tied to you
await pool.deposit({ lamports: 2_000_000_000 });
const { lamports } = await pool.getPrivateBalance();

// Unshield: proven here, sent by the relayer; nothing ties it to the deposit
await pool.withdraw({ lamports: 500_000_000, recipientAddress: recipient });

import { PrivacyCash } from "privacycash";
import {
  createKeyPairSignerFromPrivateKeyBytes,
  getBase64EncodedWireTransaction,
  getBase64Encoder,
  getTransactionDecoder,
  signTransaction,
} from "@solana/kit";

const API = "https://cypher.tools/api/v1";
const headers = { "content-type": "application/json", "x-rpc-url": process.env.RPC_URL! };
const pool = new PrivacyCash({ RPC_url: process.env.RPC_URL!, owner: keypair });

// 1. A one-time wallet for this swap, paid out of the pool.
//    Keep its seed until it's empty: it holds funds in between.
const seed = crypto.getRandomValues(new Uint8Array(32));
const once = await createKeyPairSignerFromPrivateKeyBytes(seed);
await pool.withdraw({ lamports: 1_000_000_000, recipientAddress: once.address });

// 2. Cypher builds the swap, from the one-time wallet to the recipient
const built = await fetch(`${API}/swap`, {
  method: "POST",
  headers,
  body: JSON.stringify({ from: once.address, to: recipient, inputMint: "So11111111111111111111111111111111111111112", outputMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", amount: "0.98" }),
}).then((r) => r.json());
if (built.error) throw new Error(built.error.message);

// 3. Sign as the one-time wallet and submit
const tx = getTransactionDecoder().decode(getBase64Encoder().encode(built.transaction));
const signed = await signTransaction([once.keyPair], tx);
await fetch(`${API}/submit`, {
  method: "POST",
  headers,
  body: JSON.stringify({ transaction: getBase64EncodedWireTransaction(signed) }),
});

import {
  createKeyPairSignerFromBytes,
  getBase64EncodedWireTransaction,
  getBase64Encoder,
  getTransactionDecoder,
  signTransaction,
} from "@solana/kit";

const API = "https://cypher.tools/api/v1";
const headers = { "content-type": "application/json", "x-rpc-url": process.env.RPC_URL! };
const wallet = await createKeyPairSignerFromBytes(secretKey);

// 1. Build: Cypher routes the send, and its throwaway relays sign it
const built = await fetch(`${API}/send`, {
  method: "POST",
  headers,
  body: JSON.stringify({ from: wallet.address, to: recipient, amount: "1.5", level: "standard" }),
}).then((r) => r.json());
if (built.error) throw new Error(built.error.message);

// 2. Sign: add your signature as the sender and fee payer
const tx = getTransactionDecoder().decode(getBase64Encoder().encode(built.transaction));
const signed = await signTransaction([wallet.keyPair], tx);

// 3. Submit, through this API or your own RPC
const { signature } = await fetch(`${API}/submit`, {
  method: "POST",
  headers,
  body: JSON.stringify({ transaction: getBase64EncodedWireTransaction(signed) }),
}).then((r) => r.json());

{
  "transaction": "gQUAAQ8AAAC5Lfk1Rvm80+iSOVO9baQt…",
  "encoding": "base64",
  "version": 1,
  "lastValidBlockHeight": "440181372",
  "signer": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
  "level": "standard",
  "plan": { "relays": 4, "chunks": 3, "decoys": 3 },
  "size": 972,
  "limit": 4096
}

curl https://cypher.tools/api/v1/swap \
  -H "content-type: application/json" \
  -d '{
    "from": "<your wallet>",
    "to": "<recipient>",
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "0.25",
    "slippageBps": 50
  }'

{
  "transaction": "AQAAAAAAAAAAAAAAAAAAAAAA…",
  "encoding": "base64",
  "version": 0,
  "lastValidBlockHeight": "440181839",
  "signer": "<your wallet>",
  "recipient": "<recipient>",
  "quote": {
    "inAmount": "0.25",
    "outAmount": "25.2753",
    "minOutAmount": "25.148924",
    "priceImpactPct": 0,
    "slippageBps": 50,
    "route": [{ "venue": "Kipseli", "percent": 100 }]
  }
}

{
  "signature": "5LPA6GqDrCN8kCqpfiMS6J2bNjWHyzQt…",
  "status": "finalized",
  "slot": "462156087",
  "err": null
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limited: 1 request a second on the shared RPC. Pass your own in x-rpc-url for 10.",
    "retryAfterMs": 783
  }
}