@shuffle-protocol/sdk 0.1.0 → 0.2.0

package/README.md

@@ -22,33 +22,21 @@ npm install -g @shuffle-protocol/sdk
 
    # Configure for devnet
    solana config set --url devnet
-
-   # Get devnet SOL
-   solana airdrop 2
    ```
 
-### Commands
+### Get Started (Devnet)
 
 ```bash
-# Create your privacy account
+# 1. Create your privacy account
 shuffle init
 
-# View encrypted balances
-shuffle balance
-
-# Get test tokens (devnet)
+# 2. Get test tokens (also airdrops 1 SOL for fees)
 shuffle faucet 10000
 
-# Deposit into privacy account
-shuffle deposit USDC 1000
-
-# Withdraw from privacy account
-shuffle withdraw USDC 500
+# 3. Deposit into privacy account
+shuffle shield USDC 1000
 
-# Private transfer to another user
-shuffle transfer <solana-address> 100
-
-# Place encrypted order
+# 4. Place encrypted order
 shuffle order TSLA_USDC buy 500
 
 # Check status
@@ -58,6 +46,22 @@ shuffle status
 shuffle settle
 ```
 
+### Other Commands
+
+```bash
+# View encrypted balances
+shuffle balance
+
+# Withdraw from privacy account
+shuffle unshield USDC 500
+
+# Private transfer to another user
+shuffle transfer <solana-address> 100
+
+# Get more SOL if needed
+shuffle airdrop 2
+```
+
 ## 📦 SDK Usage
 
 ```typescript

package/dist/cli/commands.d.ts

@@ -41,7 +41,7 @@ export declare function executeCommand(): Promise<void>;
  */
 export declare function statusCommand(): Promise<void>;
 /**
- * shuffle faucet <amount> - Mint USDC to wallet
+ * shuffle faucet <amount> - Claim USDC from program faucet (also airdrops 1 SOL for fees)
  */
 export declare function faucetCommand(amountStr: string): Promise<void>;
 /**

package/dist/cli/commands.js

@@ -55,10 +55,35 @@ exports.airdropCommand = airdropCommand;
 exports.historyCommand = historyCommand;
 const chalk_1 = __importDefault(require("chalk"));
 const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
 const config_1 = require("./config");
 const output_1 = require("./output");
 const devnet_1 = require("./devnet");
+const pda_1 = require("../pda");
 const constants_1 = require("../constants");
+function getErrorLogs(error) {
+    if (!error)
+        return [];
+    if (Array.isArray(error.logs))
+        return error.logs;
+    if (Array.isArray(error.transactionLogs))
+        return error.transactionLogs;
+    if (Array.isArray(error.data?.logs))
+        return error.data.logs;
+    return [];
+}
+function formatUsdc(amount) {
+    const num = Number(amount) / 1000000;
+    if (num === 0)
+        return "0.00";
+    if (num < 0.01) {
+        return num.toLocaleString("en-US", { minimumFractionDigits: 6, maximumFractionDigits: 6 });
+    }
+    if (num < 1) {
+        return num.toLocaleString("en-US", { minimumFractionDigits: 4, maximumFractionDigits: 4 });
+    }
+    return num.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
 // ============================================================================
 // ACCOUNT COMMANDS
 // ============================================================================
@@ -136,25 +161,31 @@ async function balanceCommand() {
     }
     try {
         // Fetch shielded, unshielded, and estimated payout (for lazy settlement)
-        const [shielded, unshielded, estimatedPayout] = await (0, output_1.withSpinner)("Fetching balances...", async () => {
-            const shieldedBalances = await config.shuffleClient.getBalance();
-            const unshieldedBalances = await config.shuffleClient.getUnshieldedBalances();
-            const payout = await config.shuffleClient.estimatePayout();
-            return [shieldedBalances, unshieldedBalances, payout];
+        const [shielded, unshielded, estimatedPayout, solBalance] = await (0, output_1.withSpinner)("Fetching balances...", async () => {
+            const [shieldedBalances, unshieldedBalances, payout, sol] = await Promise.all([
+                config.shuffleClient.getBalance(),
+                config.shuffleClient.getUnshieldedBalances(),
+                config.shuffleClient.estimatePayout(),
+                config.connection.getBalance(config.wallet.publicKey),
+            ]);
+            return [shieldedBalances, unshieldedBalances, payout, sol];
         }, "Balances loaded!");
         // Pass pending payout to display it directly in the balance (cyan color)
         const pendingPayout = estimatedPayout
             ? { amount: estimatedPayout.estimatedPayout, assetId: estimatedPayout.outputAssetId }
             : null;
-        (0, output_1.printBalanceTable)(shielded, unshielded, pendingPayout);
+        (0, output_1.printBalanceTable)(shielded, unshielded, pendingPayout, solBalance);
     }
     catch (e) {
         // If account doesn't exist, show only unshielded
         if (e.message?.includes("Account does not exist") || e.message?.includes("not found")) {
             try {
-                const unshielded = await config.shuffleClient.getUnshieldedBalances();
+                const [unshielded, solBalance] = await Promise.all([
+                    config.shuffleClient.getUnshieldedBalances(),
+                    config.connection.getBalance(config.wallet.publicKey),
+                ]);
                 console.log(chalk_1.default.yellow("\n  ⚠ No shielded account. Run 'shuffle init' to create one.\n"));
-                (0, output_1.printBalanceTable)({ usdc: BigInt(0), tsla: BigInt(0), spy: BigInt(0), aapl: BigInt(0) }, unshielded);
+                (0, output_1.printBalanceTable)({ usdc: BigInt(0), tsla: BigInt(0), spy: BigInt(0), aapl: BigInt(0) }, unshielded, null, solBalance);
             }
             catch {
                 (0, output_1.printError)("Privacy account not found. Run 'shuffle init' first.");
@@ -1058,7 +1089,7 @@ async function statusCommand() {
 // DEVNET COMMANDS
 // ============================================================================
 /**
- * shuffle faucet <amount> - Mint USDC to wallet
+ * shuffle faucet <amount> - Claim USDC from program faucet (also airdrops 1 SOL for fees)
  */
 async function faucetCommand(amountStr) {
     const config = (0, config_1.getConfig)();
@@ -1072,13 +1103,16 @@ async function faucetCommand(amountStr) {
         (0, output_1.printMockWarning)();
         const state = (0, devnet_1.getMockState)();
         const progress = (0, output_1.createProgressSpinner)([
+            "Requesting 1 SOL for transaction fees...",
             "Connecting to USDC faucet...",
-            `Minting ${amount.toLocaleString()} USDC to your wallet...`,
+            `Claiming ${amount.toLocaleString()} USDC to your wallet...`,
             "Tokens received!",
         ]);
         progress.start();
         await (0, devnet_1.mockDelay)("fast");
         progress.nextStep();
+        await (0, devnet_1.mockDelay)("fast");
+        progress.nextStep();
         await (0, devnet_1.mockDelay)("medium");
         progress.nextStep();
         await (0, devnet_1.mockDelay)("fast");
@@ -1087,61 +1121,112 @@ async function faucetCommand(amountStr) {
             state.balances.usdc += amountRaw;
             (0, devnet_1.updateMockState)({ balances: state.balances });
         }
-        progress.succeed(`Received ${amount.toLocaleString()} USDC!`);
+        progress.succeed(`Received 1 SOL + ${amount.toLocaleString()} USDC!`);
         console.log(chalk_1.default.gray(`  Token: ${devnet_1.DEVNET_CONFIG.mints.USDC.toBase58().slice(0, 20)}...`));
         (0, output_1.printTxSuccess)((0, devnet_1.mockSignature)(), config.network);
         return;
     }
-    // Real mode - mint USDC via ShuffleClient
+    // Real mode - first airdrop SOL, then claim USDC via program faucet
     if (!config.shuffleClient) {
         (0, output_1.printError)("Not connected to Shuffle protocol");
         return;
     }
     try {
-        const sig = await (0, output_1.withSpinner)(`Minting ${amount.toLocaleString()} USDC to your wallet...`, async () => {
-            // Use the client's mintToWallet method if available, otherwise show helpful error
-            if (typeof config.shuffleClient.mintUsdcToWallet === "function") {
-                return await config.shuffleClient.mintUsdcToWallet(Math.floor(amount * 1000000));
+        // Step 1: Airdrop 1 SOL for transaction fees (only on devnet/localnet)
+        const pubkey = config.wallet.publicKey;
+        let currentBalance = await config.connection.getBalance(pubkey);
+        const minBalance = 0.1 * 1000000000; // 0.1 SOL minimum
+        const minBalanceForTx = 0.005 * 1000000000; // 0.005 SOL absolute minimum for transaction
+        if (currentBalance < minBalance) {
+            console.log(chalk_1.default.gray(`\n  💰 Requesting 1 SOL for transaction fees...`));
+            try {
+                const airdropSig = await config.connection.requestAirdrop(pubkey, 1000000000 // 1 SOL
+                );
+                await config.connection.confirmTransaction(airdropSig, "confirmed");
+                console.log(chalk_1.default.green(`  ✓ Received 1 SOL`));
+                // Refresh balance after successful airdrop
+                currentBalance = await config.connection.getBalance(pubkey);
             }
-            // Fallback: try to get mint and mint directly
-            const { mintTo, getOrCreateAssociatedTokenAccount } = await Promise.resolve().then(() => __importStar(require("@solana/spl-token")));
-            const { Keypair } = await Promise.resolve().then(() => __importStar(require("@solana/web3.js")));
-            const fs = await Promise.resolve().then(() => __importStar(require("fs")));
-            const path = await Promise.resolve().then(() => __importStar(require("path")));
-            const os = await Promise.resolve().then(() => __importStar(require("os")));
-            const pool = await config.shuffleClient.program.account.pool.fetch(config.shuffleClient.poolPDA);
-            const usdcMint = pool.usdcMint;
-            const connection = config.connection;
-            // Load the DEFAULT keypair (has mint authority) instead of current user
-            const defaultKeypairPath = path.join(os.homedir(), ".config", "solana", "id.json");
-            if (!fs.existsSync(defaultKeypairPath)) {
-                throw new Error("Main wallet not found. Faucet requires default Solana keypair with mint authority.");
+            catch (airdropError) {
+                // Non-fatal: warn but continue with USDC faucet
+                const msg = airdropError.message || "";
+                if (msg.includes("429") || msg.includes("airdrop limit") || msg.includes("Too Many Requests")) {
+                    // Rate limited - show helpful guide
+                    console.log(chalk_1.default.yellow(`\n  ⚠ Airdrop rate limit reached. Get SOL manually:\n`));
+                    console.log(chalk_1.default.cyan(`  📍 Visit: ${chalk_1.default.white.bold("https://faucet.solana.com")}`));
+                    console.log(chalk_1.default.gray(`  1. Paste your wallet address: ${chalk_1.default.white(pubkey.toBase58())}`));
+                    console.log(chalk_1.default.gray(`  2. Request ${chalk_1.default.white("0.5 SOL")} (minimum recommended)`));
+                    console.log(chalk_1.default.gray(`  3. Complete the CAPTCHA\n`));
+                }
+                else {
+                    console.log(chalk_1.default.yellow(`  ⚠ SOL airdrop failed: ${msg}`));
+                }
             }
-            const defaultRaw = JSON.parse(fs.readFileSync(defaultKeypairPath, "utf-8"));
-            const mintAuthority = Keypair.fromSecretKey(Uint8Array.from(defaultRaw));
-            // Current user's public key (where tokens will go)
-            const recipientPubkey = config.wallet.publicKey;
-            // Get or create user's token account (use mint authority as payer since they have SOL)
-            const tokenAccount = await getOrCreateAssociatedTokenAccount(connection, mintAuthority, // payer
-            usdcMint, recipientPubkey // owner (the current user profile)
-            );
-            // Mint tokens using the mint authority
-            const mintSig = await mintTo(connection, mintAuthority, usdcMint, tokenAccount.address, mintAuthority, // mint authority
-            Math.floor(amount * 1000000));
-            return mintSig;
+        }
+        else {
+            console.log(chalk_1.default.gray(`\n  ✓ Sufficient SOL balance (${(currentBalance / 1000000000).toFixed(4)} SOL)`));
+        }
+        // Check if we have enough SOL for the transaction after airdrop attempt
+        if (currentBalance < minBalanceForTx) {
+            console.log();
+            (0, output_1.printError)(`Insufficient SOL for transaction fees (${(currentBalance / 1000000000).toFixed(4)} SOL).`);
+            console.log(chalk_1.default.yellow(`\n  You need at least 0.005 SOL to claim USDC from the faucet.`));
+            console.log(chalk_1.default.cyan(`  📍 Get SOL from: ${chalk_1.default.white.bold("https://faucet.solana.com")}`));
+            console.log(chalk_1.default.gray(`  1. Paste your wallet: ${chalk_1.default.white(pubkey.toBase58())}`));
+            console.log(chalk_1.default.gray(`  2. Request ${chalk_1.default.white("0.5 SOL")}`));
+            console.log(chalk_1.default.gray(`  3. Then run: ${chalk_1.default.white("shuffle faucet " + amountStr)}\n`));
+            return;
+        }
+        // Step 2: Preflight check - ensure faucet vault has enough USDC
+        try {
+            const programId = config.network === "localnet"
+                ? devnet_1.LOCALNET_CONFIG.programId
+                : devnet_1.DEVNET_CONFIG.programId;
+            const [faucetVaultPDA] = (0, pda_1.getFaucetVaultPDA)(programId);
+            const faucetVault = await (0, spl_token_1.getAccount)(config.connection, faucetVaultPDA);
+            if (faucetVault.amount < amountRaw) {
+                (0, output_1.printError)(`Faucet vault has insufficient USDC (available: ${formatUsdc(faucetVault.amount)}). ` +
+                    "Ask an admin to refill the faucet.");
+                return;
+            }
+        }
+        catch (e) {
+            // If the faucet vault isn't initialized or can't be fetched, surface a clear message
+            const msg = e?.message?.toLowerCase?.() || "";
+            if (msg.includes("failed to find account") || msg.includes("could not find account") || msg.includes("not found")) {
+                (0, output_1.printError)("Faucet vault is not initialized. Ask an admin to initialize and fund the faucet.");
+                return;
+            }
+            // Fall through to attempt faucet call; it may still succeed
+        }
+        // Step 3: Claim USDC from faucet
+        const sig = await (0, output_1.withSpinner)(`Claiming ${amount.toLocaleString()} USDC to your wallet...`, async () => {
+            if (typeof config.shuffleClient.faucet !== "function") {
+                throw new Error("Faucet not supported by this SDK version.");
+            }
+            return await config.shuffleClient.faucet(Math.floor(amount * 1000000));
         }, `Received ${amount.toLocaleString()} USDC!`);
         (0, output_1.printTxSuccess)(sig, config.network);
     }
     catch (e) {
         // Improve error messages
-        if (e.message?.includes("mint authority")) {
-            (0, output_1.printError)("Cannot mint: you don't have mint authority. Only works on localnet.");
+        const msg = e.message || "";
+        const logs = getErrorLogs(e);
+        const hasTokenInsufficient = logs.some((log) => log.toLowerCase().includes("error: insufficient funds"));
+        if (msg.includes("Account does not exist") || msg.includes("not found")) {
+            (0, output_1.printError)("Privacy account not found. Run 'shuffle init' first.");
+        }
+        else if (msg.includes("Faucet limit exceeded") || msg.includes("FaucetLimitExceeded")) {
+            (0, output_1.printError)("Faucet limit exceeded. You can claim up to 1000 USDC total.");
+        }
+        else if (hasTokenInsufficient) {
+            (0, output_1.printError)("Faucet vault has insufficient USDC. Try a smaller amount or ask an admin to refill the faucet.");
         }
-        else if (e.message?.includes("insufficient funds")) {
-            (0, output_1.printError)("Insufficient SOL for transaction fees. Request an airdrop first with 'shuffle airdrop'.");
+        else if (msg.toLowerCase().includes("insufficient funds") && (msg.toLowerCase().includes("fee") || msg.toLowerCase().includes("transaction"))) {
+            (0, output_1.printError)("Insufficient SOL for transaction fees. This shouldn't happen - please report this issue.");
         }
         else {
-            (0, output_1.printError)(e.message || "Faucet failed");
+            (0, output_1.printError)(msg || "Faucet failed");
         }
     }
 }

package/dist/cli/config.js

@@ -192,17 +192,20 @@ async function loadConfig(opts) {
     const connection = new web3_js_1.Connection(getRpcUrl(network), "confirmed");
     const encryptionPrivateKey = loadOrCreateEncryptionKey(userProfile);
     let shuffleClient = null;
-    // Select program ID based on network
+    // Select program ID and cluster offset based on network
     const programId = network === "localnet"
         ? devnet_1.LOCALNET_CONFIG.programId
         : devnet_1.DEVNET_CONFIG.programId;
+    const clusterOffset = network === "localnet"
+        ? 0
+        : devnet_1.DEVNET_CONFIG.clusterOffset;
     if (!mockMode) {
         try {
             shuffleClient = await client_1.ShuffleClient.create({
                 connection,
                 wallet,
                 programId,
-                clusterOffset: 0,
+                clusterOffset,
             });
             shuffleClient.initEncryption(encryptionPrivateKey);
         }

package/dist/cli/devnet.d.ts

@@ -11,7 +11,7 @@ import { PublicKey } from "@solana/web3.js";
 export declare const MOCK_MODE = false;
 /**
  * Localnet program configuration (from arcium test)
- * UPDATE THIS when network restarts!
+ * NOTE: This is automatically updated by setup-local.js
  */
 export declare const LOCALNET_CONFIG: {
     programId: PublicKey;

package/dist/cli/devnet.js

@@ -22,20 +22,20 @@ const web3_js_1 = require("@solana/web3.js");
 exports.MOCK_MODE = false;
 /**
  * Localnet program configuration (from arcium test)
- * UPDATE THIS when network restarts!
+ * NOTE: This is automatically updated by setup-local.js
  */
 exports.LOCALNET_CONFIG = {
-    programId: new web3_js_1.PublicKey("BzaakuSahkVtEXKqZnD9tSPBoiJCMLa1nzQHUjtY1xRM"),
+    programId: new web3_js_1.PublicKey("DQ29rUToHVTyp2QxP3C7nt1MuYp6p6PKYNaDpGooPAFq"),
     rpcUrl: "http://127.0.0.1:8899",
 };
 /**
  * Devnet program and token configuration
  */
 exports.DEVNET_CONFIG = {
-    // Program ID from successful devnet deployment (2026-02-01)
-    programId: new web3_js_1.PublicKey("BzaakuSahkVtEXKqZnD9tSPBoiJCMLa1nzQHUjtY1xRM"),
+    // Program ID from successful devnet deployment (2026-02-03 v0.7.0 - fresh deploy with synced IDs)
+    programId: new web3_js_1.PublicKey("D5hXtvqYeBHM4f8DqJuYyioPNDsQS6jhSRqj9DmFFvCH"),
     rpcUrl: "https://devnet.helius-rpc.com/?api-key=a8e1a5ce-29c6-4356-b3f9-54c1c650ac08",
-    // Arcium cluster offset for v0.6.3 (required for account derivations)
+    // Arcium cluster offset for v0.7.0 (required for account derivations)
     clusterOffset: 456,
     // Token mints - deployed 2026-02-01
     mints: {

package/dist/cli/index.js

@@ -134,7 +134,7 @@ program
 // Devnet Utilities
 program
     .command("faucet <amount>")
-    .description("Mint devnet USDC to your wallet")
+    .description("Claim devnet USDC (also airdrops 1 SOL for transaction fees)")
     .action(commands_1.faucetCommand);
 program
     .command("airdrop [amount]")

package/dist/cli/output.d.ts

@@ -43,7 +43,7 @@ export declare function printBalanceTable(shielded: {
 }, pendingPayout?: {
     amount: bigint;
     assetId: number;
-} | null): void;
+} | null, solBalanceLamports?: number | bigint): void;
 /**
  * Print order status
  */

package/dist/cli/output.js

@@ -87,8 +87,26 @@ function printHeader(title) {
  * Print balance table showing shielded and unshielded balances side-by-side
  * If pendingPayout is provided, add it to the relevant asset in a different color
  */
-function printBalanceTable(shielded, unshielded, pendingPayout) {
+function printBalanceTable(shielded, unshielded, pendingPayout, solBalanceLamports) {
     printHeader("Your Balances");
+    if (solBalanceLamports !== undefined) {
+        const sol = Number(solBalanceLamports) / 1000000000;
+        let solDisplay;
+        if (sol === 0) {
+            solDisplay = "0.0000";
+        }
+        else if (sol < 0.01) {
+            solDisplay = sol.toLocaleString("en-US", { minimumFractionDigits: 6, maximumFractionDigits: 6 });
+        }
+        else if (sol < 1) {
+            solDisplay = sol.toLocaleString("en-US", { minimumFractionDigits: 4, maximumFractionDigits: 4 });
+        }
+        else {
+            solDisplay = sol.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+        }
+        console.log(chalk_1.default.gray(`  SOL (wallet): ${chalk_1.default.white(solDisplay)} SOL`));
+        console.log();
+    }
     const format = (val) => {
         const num = Number(val) / 1000000; // 6 decimals
         // Use more decimal places for small values to avoid showing 0.00 for non-zero amounts

package/dist/client.d.ts

@@ -41,6 +41,11 @@ export declare class ShuffleClient {
     fetchUserAccount(owner?: PublicKey): Promise<any>;
     /** Check if account exists */
     accountExists(owner?: PublicKey): Promise<boolean>;
+    /**
+     * Claim USDC from the program faucet.
+     * @param amount Amount in base units (6 decimals).
+     */
+    faucet(amount: number): Promise<string>;
     /** Deposit tokens into the protocol (add_balance). Uses internal encryption if params omitted. */
     deposit(assetId: AssetId, amount: number, cipher?: RescueCipher, encryptionPublicKey?: Uint8Array): Promise<string>;
     /** Withdraw tokens from the protocol (sub_balance). Uses internal encryption if params omitted. */

package/dist/client.js

@@ -153,6 +153,49 @@ class ShuffleClient {
         }
     }
     // =========================================================================
+    // DEVNET / FAUCET METHODS
+    // =========================================================================
+    /**
+     * Claim USDC from the program faucet.
+     * @param amount Amount in base units (6 decimals).
+     */
+    async faucet(amount) {
+        const owner = this.wallet.publicKey;
+        const [userAccountPDA] = (0, pda_1.getUserAccountPDA)(this.programId, owner);
+        const [faucetVaultPDA] = (0, pda_1.getFaucetVaultPDA)(this.programId);
+        // Fetch pool to find the USDC mint
+        const pool = await this.program.account.pool.fetch(this.poolPDA);
+        const usdcMint = pool.usdcMint;
+        // Ensure the user's USDC ATA exists (create if missing)
+        const userUsdcAccount = (0, spl_token_1.getAssociatedTokenAddressSync)(usdcMint, owner);
+        try {
+            await (0, spl_token_1.getAccount)(this.connection, userUsdcAccount);
+        }
+        catch (e) {
+            if (e instanceof spl_token_1.TokenAccountNotFoundError) {
+                const ix = (0, spl_token_1.createAssociatedTokenAccountInstruction)(owner, // payer
+                userUsdcAccount, owner, usdcMint);
+                const tx = new web3_js_1.Transaction().add(ix);
+                await this.provider.sendAndConfirm(tx, []);
+            }
+            else {
+                throw e;
+            }
+        }
+        const sig = await this.program.methods
+            .faucet(new anchor.BN(amount))
+            .accounts({
+            user: owner,
+            userAccount: userAccountPDA,
+            userUsdcAccount,
+            pool: this.poolPDA,
+            faucetVault: faucetVaultPDA,
+            tokenProgram: spl_token_1.TOKEN_PROGRAM_ID,
+        })
+            .rpc({ commitment: "confirmed" });
+        return sig;
+    }
+    // =========================================================================
     // BALANCE METHODS
     // =========================================================================
     /** Deposit tokens into the protocol (add_balance). Uses internal encryption if params omitted. */

package/dist/constants.d.ts

@@ -25,6 +25,7 @@ export declare const USER_SEED = "user";
 export declare const BATCH_ACCUMULATOR_SEED = "batch_accumulator";
 export declare const BATCH_LOG_SEED = "batch_log";
 export declare const VAULT_SEED = "vault";
+export declare const FAUCET_USDC_SEED = "faucet_usdc";
 export declare const VAULT_ASSET_SEEDS: Record<AssetId, string>;
 export declare const ASSET_LABELS: Record<AssetId, string>;
 export declare const PAIR_TOKENS: Record<PairId, [AssetId, AssetId]>;

package/dist/constants.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAIR_TOKENS = exports.ASSET_LABELS = exports.VAULT_ASSET_SEEDS = exports.VAULT_SEED = exports.BATCH_LOG_SEED = exports.BATCH_ACCUMULATOR_SEED = exports.USER_SEED = exports.POOL_SEED = exports.NUM_ASSETS = exports.NUM_PAIRS = exports.Direction = exports.PairId = exports.AssetId = exports.PROGRAM_ID = void 0;
+exports.PAIR_TOKENS = exports.ASSET_LABELS = exports.VAULT_ASSET_SEEDS = exports.FAUCET_USDC_SEED = exports.VAULT_SEED = exports.BATCH_LOG_SEED = exports.BATCH_ACCUMULATOR_SEED = exports.USER_SEED = exports.POOL_SEED = exports.NUM_ASSETS = exports.NUM_PAIRS = exports.Direction = exports.PairId = exports.AssetId = exports.PROGRAM_ID = void 0;
 const web3_js_1 = require("@solana/web3.js");
-// Program ID (localnet default from Anchor.toml)
-exports.PROGRAM_ID = new web3_js_1.PublicKey("BzaakuSahkVtEXKqZnD9tSPBoiJCMLa1nzQHUjtY1xRM");
+// Program ID (localnet default, use DEVNET_CONFIG for devnet)
+exports.PROGRAM_ID = new web3_js_1.PublicKey("DQ29rUToHVTyp2QxP3C7nt1MuYp6p6PKYNaDpGooPAFq");
 // Asset IDs matching contract/programs/shuffle_protocol/src/constants.rs
 var AssetId;
 (function (AssetId) {
@@ -36,6 +36,7 @@ exports.USER_SEED = "user";
 exports.BATCH_ACCUMULATOR_SEED = "batch_accumulator";
 exports.BATCH_LOG_SEED = "batch_log";
 exports.VAULT_SEED = "vault";
+exports.FAUCET_USDC_SEED = "faucet_usdc";
 // Per-asset vault sub-seeds
 exports.VAULT_ASSET_SEEDS = {
     [AssetId.USDC]: "usdc",

package/dist/errors.js

@@ -8,7 +8,7 @@ exports.ERROR_MAP = {
     6001: { name: "Unauthorized", message: "Unauthorized" },
     6002: { name: "InvalidAmount", message: "Invalid amount" },
     6003: { name: "InvalidAsset", message: "Invalid asset" },
-    6004: { name: "InvalidAssetId", message: "Invalid asset ID (must be 0-3)" },
+    6004: { name: "InvalidAssetId", message: "Invalid asset ID (must be 0-3 for USDC, TSLA, SPY, AAPL)" },
     6005: { name: "InvalidPairId", message: "Invalid pair ID (must be 0-5)" },
     6006: { name: "InvalidMint", message: "Invalid token mint" },
     6007: { name: "InvalidOwner", message: "Invalid token account owner" },
@@ -17,13 +17,16 @@ exports.ERROR_MAP = {
     6010: { name: "NoPendingOrder", message: "No pending order to settle" },
     6011: { name: "BatchNotFinalized", message: "Batch not yet executed" },
     6012: { name: "BatchIdMismatch", message: "Batch ID mismatch" },
-    6013: { name: "InsufficientBalance", message: "Insufficient balance" },
-    6014: { name: "MinOutputNotMet", message: "Minimum output not met" },
-    6015: { name: "DivisionByZero", message: "Division by zero in settlement" },
-    6016: { name: "AbortedComputation", message: "The computation was aborted" },
-    6017: { name: "ComputationFailed", message: "MPC computation failed" },
-    6018: { name: "ClusterNotSet", message: "Cluster not set" },
-    6019: { name: "RecipientAccountNotFound", message: "Recipient account not found" },
+    6013: { name: "InvalidBatchId", message: "Invalid batch ID - doesn't match BatchLog" },
+    6014: { name: "SwapsAlreadyExecuted", message: "Swaps already executed for this batch" },
+    6015: { name: "InsufficientBalance", message: "Insufficient balance" },
+    6016: { name: "MinOutputNotMet", message: "Minimum output not met" },
+    6017: { name: "DivisionByZero", message: "Division by zero in settlement - no input for this pair" },
+    6018: { name: "AbortedComputation", message: "The computation was aborted" },
+    6019: { name: "ComputationFailed", message: "MPC computation failed" },
+    6020: { name: "ClusterNotSet", message: "Cluster not set" },
+    6021: { name: "RecipientAccountNotFound", message: "Recipient account not found - they must create a privacy account first" },
+    6022: { name: "FaucetLimitExceeded", message: "Faucet limit exceeded - you can only claim up to 1000 USDC total" },
 };
 class ShuffleError extends Error {
     constructor(code) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { ShuffleClient } from "./client";
 export type { UserBalance, OrderInfo, DecryptedOrderInfo, BatchInfo, BatchResult, PairResult, ShuffleConfig, EstimatedPayout, EffectiveBalance, } from "./types";
-export { AssetId, PairId, Direction, PROGRAM_ID, NUM_PAIRS, NUM_ASSETS, POOL_SEED, USER_SEED, BATCH_ACCUMULATOR_SEED, BATCH_LOG_SEED, VAULT_SEED, VAULT_ASSET_SEEDS, ASSET_LABELS, PAIR_TOKENS, } from "./constants";
-export { getPoolPDA, getUserAccountPDA, getBatchAccumulatorPDA, getBatchLogPDA, getVaultPDA, } from "./pda";
+export { AssetId, PairId, Direction, PROGRAM_ID, NUM_PAIRS, NUM_ASSETS, POOL_SEED, USER_SEED, BATCH_ACCUMULATOR_SEED, BATCH_LOG_SEED, VAULT_SEED, FAUCET_USDC_SEED, VAULT_ASSET_SEEDS, ASSET_LABELS, PAIR_TOKENS, } from "./constants";
+export { getPoolPDA, getUserAccountPDA, getBatchAccumulatorPDA, getBatchLogPDA, getVaultPDA, getFaucetVaultPDA, } from "./pda";
 export { generateEncryptionKeypair, createCipher, encryptValue, decryptValue, fetchMXEPublicKey, nonceToBN, } from "./encryption";
 export type { EncryptionKeypair, EncryptedValue } from "./encryption";
 export { ShuffleError, parseError, ERROR_MAP } from "./errors";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_MAP = exports.parseError = exports.ShuffleError = exports.nonceToBN = exports.fetchMXEPublicKey = exports.decryptValue = exports.encryptValue = exports.createCipher = exports.generateEncryptionKeypair = exports.getVaultPDA = exports.getBatchLogPDA = exports.getBatchAccumulatorPDA = exports.getUserAccountPDA = exports.getPoolPDA = exports.PAIR_TOKENS = exports.ASSET_LABELS = exports.VAULT_ASSET_SEEDS = exports.VAULT_SEED = exports.BATCH_LOG_SEED = exports.BATCH_ACCUMULATOR_SEED = exports.USER_SEED = exports.POOL_SEED = exports.NUM_ASSETS = exports.NUM_PAIRS = exports.PROGRAM_ID = exports.Direction = exports.PairId = exports.AssetId = exports.ShuffleClient = void 0;
+exports.ERROR_MAP = exports.parseError = exports.ShuffleError = exports.nonceToBN = exports.fetchMXEPublicKey = exports.decryptValue = exports.encryptValue = exports.createCipher = exports.generateEncryptionKeypair = exports.getFaucetVaultPDA = exports.getVaultPDA = exports.getBatchLogPDA = exports.getBatchAccumulatorPDA = exports.getUserAccountPDA = exports.getPoolPDA = exports.PAIR_TOKENS = exports.ASSET_LABELS = exports.VAULT_ASSET_SEEDS = exports.FAUCET_USDC_SEED = exports.VAULT_SEED = exports.BATCH_LOG_SEED = exports.BATCH_ACCUMULATOR_SEED = exports.USER_SEED = exports.POOL_SEED = exports.NUM_ASSETS = exports.NUM_PAIRS = exports.PROGRAM_ID = exports.Direction = exports.PairId = exports.AssetId = exports.ShuffleClient = void 0;
 // Main SDK exports
 var client_1 = require("./client");
 Object.defineProperty(exports, "ShuffleClient", { enumerable: true, get: function () { return client_1.ShuffleClient; } });
@@ -17,6 +17,7 @@ Object.defineProperty(exports, "USER_SEED", { enumerable: true, get: function ()
 Object.defineProperty(exports, "BATCH_ACCUMULATOR_SEED", { enumerable: true, get: function () { return constants_1.BATCH_ACCUMULATOR_SEED; } });
 Object.defineProperty(exports, "BATCH_LOG_SEED", { enumerable: true, get: function () { return constants_1.BATCH_LOG_SEED; } });
 Object.defineProperty(exports, "VAULT_SEED", { enumerable: true, get: function () { return constants_1.VAULT_SEED; } });
+Object.defineProperty(exports, "FAUCET_USDC_SEED", { enumerable: true, get: function () { return constants_1.FAUCET_USDC_SEED; } });
 Object.defineProperty(exports, "VAULT_ASSET_SEEDS", { enumerable: true, get: function () { return constants_1.VAULT_ASSET_SEEDS; } });
 Object.defineProperty(exports, "ASSET_LABELS", { enumerable: true, get: function () { return constants_1.ASSET_LABELS; } });
 Object.defineProperty(exports, "PAIR_TOKENS", { enumerable: true, get: function () { return constants_1.PAIR_TOKENS; } });
@@ -27,6 +28,7 @@ Object.defineProperty(exports, "getUserAccountPDA", { enumerable: true, get: fun
 Object.defineProperty(exports, "getBatchAccumulatorPDA", { enumerable: true, get: function () { return pda_1.getBatchAccumulatorPDA; } });
 Object.defineProperty(exports, "getBatchLogPDA", { enumerable: true, get: function () { return pda_1.getBatchLogPDA; } });
 Object.defineProperty(exports, "getVaultPDA", { enumerable: true, get: function () { return pda_1.getVaultPDA; } });
+Object.defineProperty(exports, "getFaucetVaultPDA", { enumerable: true, get: function () { return pda_1.getFaucetVaultPDA; } });
 // Encryption helpers
 var encryption_1 = require("./encryption");
 Object.defineProperty(exports, "generateEncryptionKeypair", { enumerable: true, get: function () { return encryption_1.generateEncryptionKeypair; } });

package/dist/pda.d.ts

@@ -5,3 +5,4 @@ export declare function getUserAccountPDA(programId: PublicKey, owner: PublicKey
 export declare function getBatchAccumulatorPDA(programId: PublicKey): [PublicKey, number];
 export declare function getBatchLogPDA(programId: PublicKey, batchId: number | anchor.BN): [PublicKey, number];
 export declare function getVaultPDA(programId: PublicKey, assetSeed: string): [PublicKey, number];
+export declare function getFaucetVaultPDA(programId: PublicKey): [PublicKey, number];

package/dist/pda.js

@@ -38,6 +38,7 @@ exports.getUserAccountPDA = getUserAccountPDA;
 exports.getBatchAccumulatorPDA = getBatchAccumulatorPDA;
 exports.getBatchLogPDA = getBatchLogPDA;
 exports.getVaultPDA = getVaultPDA;
+exports.getFaucetVaultPDA = getFaucetVaultPDA;
 const web3_js_1 = require("@solana/web3.js");
 const anchor = __importStar(require("@coral-xyz/anchor"));
 const constants_1 = require("./constants");
@@ -57,3 +58,6 @@ function getBatchLogPDA(programId, batchId) {
 function getVaultPDA(programId, assetSeed) {
     return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.VAULT_SEED), Buffer.from(assetSeed)], programId);
 }
+function getFaucetVaultPDA(programId) {
+    return web3_js_1.PublicKey.findProgramAddressSync([Buffer.from(constants_1.FAUCET_USDC_SEED)], programId);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shuffle-protocol/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI and SDK for the Shuffle privacy protocol on Solana",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,7 +31,7 @@
     "url": "https://github.com/tothster/shuffle/issues"
   },
   "dependencies": {
-    "@arcium-hq/client": "0.6.3",
+    "@arcium-hq/client": "0.7.0",
     "@coral-xyz/anchor": "^0.32.1",
     "@solana/web3.js": "^1.98.4",
     "@solana/spl-token": "^0.4.14",