@star-factory/sdk-vault 1.0.1 → 1.0.2

package/dist/features/relay/index.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Transaction Relay Utilities for Gasless/Sponsored Transactions
+ *
+ * This module provides utilities for implementing a transaction relay service
+ * that sponsors transaction fees for depositor actions (deposit, claim refund,
+ * claim excess refund, upgrade tier, claim dust).
+ *
+ * Architecture:
+ * 1. Frontend builds transaction with feePayer = sponsorPubkey
+ * 2. User signs the transaction (authorizes their action)
+ * 3. Frontend sends partially-signed tx to relay backend
+ * 4. Relay validates, signs with sponsor keypair, submits to Solana
+ *
+ * Security Considerations:
+ * - Always validate that only allowed programs are being called
+ * - Implement rate limiting to prevent abuse
+ * - Consider allowlisting users/vaults for sponsorship
+ * - Monitor sponsor wallet balance and alert on low funds
+ */
+import { Connection, Keypair, PublicKey, Transaction } from '@solana/web3.js';
+/**
+ * Default vault program ID (v4 on devnet).
+ * Override with your program ID in production.
+ */
+export declare const VAULT_PROGRAM_ID: PublicKey;
+/**
+ * Programs allowed in sponsored transactions (besides the vault program).
+ */
+export declare const ALLOWED_ANCILLARY_PROGRAMS: PublicKey[];
+/**
+ * Configuration for the relay service.
+ */
+export interface RelayConfig {
+    /** Solana RPC connection */
+    connection: Connection;
+    /** Sponsor keypair that pays transaction fees */
+    sponsorKeypair: Keypair;
+    /** Vault program ID to allow */
+    vaultProgramId?: PublicKey;
+    /** Additional program IDs to allow (default: system, token, ATA, compute budget) */
+    additionalAllowedPrograms?: PublicKey[];
+    /** Optional rate limit (max txs per user per minute) */
+    rateLimitPerMinute?: number;
+    /** Optional vault allowlist (only sponsor txs for these vaults) */
+    vaultAllowlist?: PublicKey[];
+    /** Optional user allowlist (only sponsor txs for these users) */
+    userAllowlist?: PublicKey[];
+    /** Skip preflight simulation (default: false) */
+    skipPreflight?: boolean;
+}
+/**
+ * Result of relay submission.
+ */
+export interface RelayResult {
+    success: boolean;
+    signature?: string;
+    error?: string;
+    /** Simulation logs if available */
+    logs?: string[];
+}
+/**
+ * Validation result for a sponsored transaction.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    /** Extracted vault pubkey from the transaction (if found) */
+    vault?: PublicKey;
+    /** Extracted user pubkey from the transaction (if found) */
+    user?: PublicKey;
+}
+/**
+ * Validate that a transaction is safe to sponsor.
+ *
+ * Checks:
+ * 1. Fee payer matches sponsor
+ * 2. Only allowed programs are called
+ * 3. Transaction is not expired
+ *
+ * @param tx - The partially-signed transaction
+ * @param config - Relay configuration
+ * @returns Validation result
+ */
+export declare function validateSponsoredTransaction(tx: Transaction, config: RelayConfig): ValidationResult;
+/**
+ * Sign and submit a sponsored transaction.
+ *
+ * @param tx - The partially-signed transaction (user has signed)
+ * @param config - Relay configuration
+ * @returns Result with signature or error
+ */
+export declare function submitSponsoredTransaction(tx: Transaction, config: RelayConfig): Promise<RelayResult>;
+/**
+ * Deserialize a base64-encoded transaction.
+ *
+ * @param txBase64 - Base64-encoded serialized transaction
+ * @returns Deserialized transaction
+ */
+export declare function deserializeTransaction(txBase64: string): Transaction;
+/**
+ * Create a relay handler function for use in API routes.
+ *
+ * Example usage in Next.js API route:
+ * ```ts
+ * // pages/api/relay/submit.ts
+ * import { createRelayHandler } from '@star-vault/sdk';
+ *
+ * const handler = createRelayHandler({
+ *   connection: new Connection(process.env.RPC_URL!),
+ *   sponsorKeypair: Keypair.fromSecretKey(Buffer.from(process.env.SPONSOR_SECRET!, 'base64')),
+ *   rateLimitPerMinute: 10,
+ * });
+ *
+ * export default handler;
+ * ```
+ *
+ * @param config - Relay configuration
+ * @returns Handler function for HTTP requests
+ */
+export declare function createRelayHandler(config: RelayConfig): (request: {
+    body: {
+        transaction: string;
+    };
+    headers?: {
+        "x-user-pubkey"?: string;
+    };
+}) => Promise<RelayResult>;
+/**
+ * Check sponsor wallet balance and return warning if low.
+ *
+ * @param connection - Solana connection
+ * @param sponsorPubkey - Sponsor wallet public key
+ * @param minBalanceSol - Minimum balance in SOL to consider "healthy" (default: 1 SOL)
+ * @returns Object with balance info and warning if applicable
+ */
+export declare function checkSponsorBalance(connection: Connection, sponsorPubkey: PublicKey, minBalanceSol?: number): Promise<{
+    balanceLamports: number;
+    balanceSol: number;
+    warning?: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/features/relay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/relay/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,UAAU,EACV,OAAO,EACP,SAAS,EAET,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AAQzB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,WAAgE,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,0BAA0B,aAMtC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;IACxB,gCAAgC;IAChC,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,oFAAoF;IACpF,yBAAyB,CAAC,EAAE,SAAS,EAAE,CAAC;IACxC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;IAC7B,iEAAiE;IACjE,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,WAAW,GAClB,gBAAgB,CAoElB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAgDtB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAGpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,IAItC,SAAS;IACrB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,KAAG,OAAO,CAAC,WAAW,CAAC,CA6CzB;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,SAAS,EACxB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAe5E"}

package/dist/features/relay/index.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * Transaction Relay Utilities for Gasless/Sponsored Transactions
+ *
+ * This module provides utilities for implementing a transaction relay service
+ * that sponsors transaction fees for depositor actions (deposit, claim refund,
+ * claim excess refund, upgrade tier, claim dust).
+ *
+ * Architecture:
+ * 1. Frontend builds transaction with feePayer = sponsorPubkey
+ * 2. User signs the transaction (authorizes their action)
+ * 3. Frontend sends partially-signed tx to relay backend
+ * 4. Relay validates, signs with sponsor keypair, submits to Solana
+ *
+ * Security Considerations:
+ * - Always validate that only allowed programs are being called
+ * - Implement rate limiting to prevent abuse
+ * - Consider allowlisting users/vaults for sponsorship
+ * - Monitor sponsor wallet balance and alert on low funds
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALLOWED_ANCILLARY_PROGRAMS = exports.VAULT_PROGRAM_ID = void 0;
+exports.validateSponsoredTransaction = validateSponsoredTransaction;
+exports.submitSponsoredTransaction = submitSponsoredTransaction;
+exports.deserializeTransaction = deserializeTransaction;
+exports.createRelayHandler = createRelayHandler;
+exports.checkSponsorBalance = checkSponsorBalance;
+const web3_js_1 = require("@solana/web3.js");
+const spl_token_1 = require("@solana/spl-token");
+const web3_js_2 = require("@solana/web3.js");
+/**
+ * Default vault program ID (v4 on devnet).
+ * Override with your program ID in production.
+ */
+exports.VAULT_PROGRAM_ID = new web3_js_1.PublicKey('2izCb6E5VNBa8NMFnKZhDmBptMCv7TyUNjkwFwrvf44B');
+/**
+ * Programs allowed in sponsored transactions (besides the vault program).
+ */
+exports.ALLOWED_ANCILLARY_PROGRAMS = [
+    web3_js_1.SystemProgram.programId,
+    spl_token_1.TOKEN_PROGRAM_ID,
+    spl_token_1.TOKEN_2022_PROGRAM_ID,
+    spl_token_1.ASSOCIATED_TOKEN_PROGRAM_ID,
+    web3_js_2.ComputeBudgetProgram.programId,
+];
+/**
+ * Validate that a transaction is safe to sponsor.
+ *
+ * Checks:
+ * 1. Fee payer matches sponsor
+ * 2. Only allowed programs are called
+ * 3. Transaction is not expired
+ *
+ * @param tx - The partially-signed transaction
+ * @param config - Relay configuration
+ * @returns Validation result
+ */
+function validateSponsoredTransaction(tx, config) {
+    const vaultProgramId = config.vaultProgramId ?? exports.VAULT_PROGRAM_ID;
+    const allowedPrograms = [
+        vaultProgramId,
+        ...exports.ALLOWED_ANCILLARY_PROGRAMS,
+        ...(config.additionalAllowedPrograms ?? []),
+    ];
+    // 1. Verify fee payer matches sponsor
+    if (!tx.feePayer?.equals(config.sponsorKeypair.publicKey)) {
+        return {
+            valid: false,
+            error: `Invalid fee payer. Expected ${config.sponsorKeypair.publicKey.toBase58()}, got ${tx.feePayer?.toBase58() ?? 'none'}`,
+        };
+    }
+    // 2. Verify only allowed programs are being called
+    let vaultPubkey;
+    let userPubkey;
+    for (const ix of tx.instructions) {
+        const isAllowed = allowedPrograms.some((p) => p.equals(ix.programId));
+        if (!isAllowed) {
+            return {
+                valid: false,
+                error: `Unauthorized program: ${ix.programId.toBase58()}`,
+            };
+        }
+        // Extract vault and user from vault program instructions
+        if (ix.programId.equals(vaultProgramId)) {
+            // In vault instructions, vault is typically the 2nd account (index 1)
+            // and user is the 1st account (index 0)
+            // This is a heuristic - adjust based on your instruction layout
+            if (ix.keys.length >= 2) {
+                userPubkey = ix.keys[0].pubkey;
+                vaultPubkey = ix.keys[1].pubkey;
+            }
+        }
+    }
+    // 3. Check vault allowlist if configured
+    if (config.vaultAllowlist && config.vaultAllowlist.length > 0 && vaultPubkey) {
+        const isVaultAllowed = config.vaultAllowlist.some((v) => v.equals(vaultPubkey));
+        if (!isVaultAllowed) {
+            return {
+                valid: false,
+                error: `Vault ${vaultPubkey.toBase58()} is not in sponsorship allowlist`,
+            };
+        }
+    }
+    // 4. Check user allowlist if configured
+    if (config.userAllowlist && config.userAllowlist.length > 0 && userPubkey) {
+        const isUserAllowed = config.userAllowlist.some((u) => u.equals(userPubkey));
+        if (!isUserAllowed) {
+            return {
+                valid: false,
+                error: `User ${userPubkey.toBase58()} is not in sponsorship allowlist`,
+            };
+        }
+    }
+    return {
+        valid: true,
+        vault: vaultPubkey,
+        user: userPubkey,
+    };
+}
+/**
+ * Sign and submit a sponsored transaction.
+ *
+ * @param tx - The partially-signed transaction (user has signed)
+ * @param config - Relay configuration
+ * @returns Result with signature or error
+ */
+async function submitSponsoredTransaction(tx, config) {
+    // Validate first
+    const validation = validateSponsoredTransaction(tx, config);
+    if (!validation.valid) {
+        return {
+            success: false,
+            error: validation.error,
+        };
+    }
+    try {
+        // Sign with sponsor keypair
+        tx.partialSign(config.sponsorKeypair);
+        // Get fresh blockhash if not set
+        if (!tx.recentBlockhash) {
+            const { blockhash } = await config.connection.getLatestBlockhash();
+            tx.recentBlockhash = blockhash;
+        }
+        // Submit to Solana
+        const signature = await config.connection.sendRawTransaction(tx.serialize(), {
+            skipPreflight: config.skipPreflight ?? false,
+            preflightCommitment: 'confirmed',
+        });
+        // Optionally wait for confirmation
+        const confirmation = await config.connection.confirmTransaction(signature, 'confirmed');
+        if (confirmation.value.err) {
+            return {
+                success: false,
+                signature,
+                error: `Transaction failed: ${JSON.stringify(confirmation.value.err)}`,
+            };
+        }
+        return {
+            success: true,
+            signature,
+        };
+    }
+    catch (error) {
+        const err = error;
+        return {
+            success: false,
+            error: err.message ?? String(error),
+        };
+    }
+}
+/**
+ * Deserialize a base64-encoded transaction.
+ *
+ * @param txBase64 - Base64-encoded serialized transaction
+ * @returns Deserialized transaction
+ */
+function deserializeTransaction(txBase64) {
+    const buffer = Buffer.from(txBase64, 'base64');
+    return web3_js_1.Transaction.from(buffer);
+}
+/**
+ * Create a relay handler function for use in API routes.
+ *
+ * Example usage in Next.js API route:
+ * ```ts
+ * // pages/api/relay/submit.ts
+ * import { createRelayHandler } from '@star-vault/sdk';
+ *
+ * const handler = createRelayHandler({
+ *   connection: new Connection(process.env.RPC_URL!),
+ *   sponsorKeypair: Keypair.fromSecretKey(Buffer.from(process.env.SPONSOR_SECRET!, 'base64')),
+ *   rateLimitPerMinute: 10,
+ * });
+ *
+ * export default handler;
+ * ```
+ *
+ * @param config - Relay configuration
+ * @returns Handler function for HTTP requests
+ */
+function createRelayHandler(config) {
+    // Simple in-memory rate limiter (use Redis in production)
+    const rateLimitMap = new Map();
+    return async (request) => {
+        const { transaction: txBase64 } = request.body;
+        if (!txBase64) {
+            return {
+                success: false,
+                error: 'Missing transaction in request body',
+            };
+        }
+        // Rate limiting
+        if (config.rateLimitPerMinute) {
+            const userKey = request.headers?.['x-user-pubkey'] ?? 'anonymous';
+            const now = Date.now();
+            const entry = rateLimitMap.get(userKey);
+            if (entry) {
+                if (now < entry.resetTime) {
+                    if (entry.count >= config.rateLimitPerMinute) {
+                        return {
+                            success: false,
+                            error: 'Rate limit exceeded. Please try again later.',
+                        };
+                    }
+                    entry.count++;
+                }
+                else {
+                    // Reset window
+                    rateLimitMap.set(userKey, { count: 1, resetTime: now + 60_000 });
+                }
+            }
+            else {
+                rateLimitMap.set(userKey, { count: 1, resetTime: now + 60_000 });
+            }
+        }
+        try {
+            const tx = deserializeTransaction(txBase64);
+            return await submitSponsoredTransaction(tx, config);
+        }
+        catch (error) {
+            const err = error;
+            return {
+                success: false,
+                error: `Failed to process transaction: ${err.message ?? String(error)}`,
+            };
+        }
+    };
+}
+/**
+ * Check sponsor wallet balance and return warning if low.
+ *
+ * @param connection - Solana connection
+ * @param sponsorPubkey - Sponsor wallet public key
+ * @param minBalanceSol - Minimum balance in SOL to consider "healthy" (default: 1 SOL)
+ * @returns Object with balance info and warning if applicable
+ */
+async function checkSponsorBalance(connection, sponsorPubkey, minBalanceSol = 1) {
+    const balanceLamports = await connection.getBalance(sponsorPubkey);
+    const balanceSol = balanceLamports / 1e9;
+    const result = {
+        balanceLamports,
+        balanceSol,
+    };
+    if (balanceSol < minBalanceSol) {
+        result.warning = `Sponsor wallet balance is low: ${balanceSol.toFixed(4)} SOL. ` +
+            `Consider topping up ${sponsorPubkey.toBase58()}`;
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/features/relay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/relay/index.ts"],"names":[],"mappings":"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"}

package/dist/features/vault/StarVault.d.ts

@@ -50,7 +50,7 @@ export declare function getTreasuryAuthority(cluster?: VaultCluster): PublicKey;
  * @throws Error if mint is not wSOL or USDC (mainnet/devnet)
  */
 export declare function validateQuoteMint(mint: PublicKey): void;
-import type { DepositorRecordAccount, Lamports, MakeArgs, StarVaultAccount, TgeConfigAccount, VaultEvent } from '../../core';
+import type { ClaimDustOptions, ClaimExcessRefundOptions, ClaimRefundOptions, DepositOptions, DepositorRecordAccount, Lamports, MakeArgs, StarVaultAccount, TgeConfigAccount, UpgradeTierOptions, VaultEvent } from '../../core';
 type VaultIdl = Idl & {
     address: string;
 };
@@ -100,20 +100,41 @@ export declare class StarVault {
      * Deposit into the vault (returns unsigned transaction).
      *
      * Options:
+     * - tier: Vesting tier (0-6). Higher tier = longer lockup = higher allocation priority.
+     *   - 0: immediate (no lockup)
+     *   - 1: 2 weeks, 2: 4 weeks, 3: 6 weeks
+     *   - 4: 8 weeks, 5: 10 weeks, 6: 12 weeks
      * - ensureAtas: Create ATAs if they don't exist
      * - wrapWsol: Wrap SOL into WSOL before deposit
      * - referrer: Optional referrer for rewards
+     * - feePayer: Optional sponsor pubkey for gasless transactions (requires relay submission)
      */
-    deposit(amount: Lamports | number, user: PublicKey, opts?: {
-        quoteTokenProgramId?: PublicKey;
-        ensureAtas?: boolean;
-        wrapWsol?: boolean;
-        referrer?: PublicKey;
-    }): Promise<Transaction>;
+    deposit(amount: Lamports | number, user: PublicKey, opts?: DepositOptions): Promise<Transaction>;
     /**
      * Close the vault early when minimum is met (returns unsigned transaction).
      */
     closeEarly(maker: PublicKey): Promise<Transaction>;
+    /**
+     * Upgrade vesting tier commitment (returns unsigned transaction).
+     *
+     * Users can only upgrade to a higher tier, not downgrade.
+     * Higher tier = longer lockup = higher allocation priority in oversubscribed sales.
+     * - tier 0: immediate (no lockup)
+     * - tier 1: 2 weeks, tier 2: 4 weeks, tier 3: 6 weeks
+     * - tier 4: 8 weeks, tier 5: 10 weeks, tier 6: 12 weeks
+     *
+     * Options:
+     * - feePayer: Optional sponsor pubkey for gasless transactions (requires relay submission)
+     */
+    upgradeTier(user: PublicKey, newTier: number, opts?: UpgradeTierOptions): Promise<Transaction>;
+    /**
+     * Admin calculates tier allocations after TGE acceptance (static method).
+     *
+     * Uses priority-fill algorithm: tier 6 (12wk) fills first, then 5, 4, 3, 2, 1, 0.
+     * Higher tiers (longer lockup commitment) get priority in allocation.
+     * Can only be called once after TGE is accepted.
+     */
+    static calculateAllocations(connection: Connection, admin: PublicKey, vault: PublicKey, seed: InstanceType<typeof BN> | number, programId?: PublicKey): Promise<Transaction>;
     /**
      * Creator requests TGE (returns unsigned transaction).
      */
@@ -172,16 +193,20 @@ export declare class StarVault {
     }): Promise<Transaction>;
     /**
      * User claims full refund when vault is in Refunding status (returns unsigned transaction).
+     *
+     * Options:
+     * - tokenProgramId: Override token program (default: TOKEN_PROGRAM_ID)
+     * - feePayer: Optional sponsor pubkey for gasless transactions (requires relay submission)
      */
-    claimRefund(user: PublicKey, opts?: {
-        tokenProgramId?: PublicKey;
-    }): Promise<Transaction>;
+    claimRefund(user: PublicKey, opts?: ClaimRefundOptions): Promise<Transaction>;
     /**
      * User claims pro-rata excess refund when vault is oversubscribed (returns unsigned transaction).
+     *
+     * Options:
+     * - tokenProgramId: Override token program (default: TOKEN_PROGRAM_ID)
+     * - feePayer: Optional sponsor pubkey for gasless transactions (requires relay submission)
      */
-    claimExcessRefund(user: PublicKey, opts?: {
-        tokenProgramId?: PublicKey;
-    }): Promise<Transaction>;
+    claimExcessRefund(user: PublicKey, opts?: ClaimExcessRefundOptions): Promise<Transaction>;
     /**
      * User claims uncredited dust after the raise ends using merkle proof (returns unsigned transaction).
      *
@@ -189,15 +214,12 @@ export declare class StarVault {
      * threshold and weren't credited on-chain. Uses merkle proof verification
      * against a root published by admin - no expiry, claim anytime.
      *
-     * @param user - User claiming the dust (pays all tx fees)
+     * @param user - User claiming the dust
      * @param amount - Amount of dust to claim (must be in merkle tree)
      * @param proof - Array of 32-byte hashes forming the merkle proof
-     * @param opts - Optional token program ID and ensure ATAs flag
+     * @param opts - Options including tokenProgramId, ensureAtas, and feePayer for gasless txs
      */
-    claimDust(user: PublicKey, amount: InstanceType<typeof BN> | number, proof: Buffer[], opts?: {
-        tokenProgramId?: PublicKey;
-        ensureAtas?: boolean;
-    }): Promise<Transaction>;
+    claimDust(user: PublicKey, amount: InstanceType<typeof BN> | number, proof: Buffer[], opts?: ClaimDustOptions): Promise<Transaction>;
     /**
      * Admin publishes merkle root for dust claims (static method for admin use).
      *

package/dist/features/vault/StarVault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StarVault.d.ts","sourceRoot":"","sources":["../../../src/features/vault/StarVault.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"StarVault.d.ts","sourceRoot":"","sources":["../../../src/features/vault/StarVault.ts"],"names":[],"mappings":"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"}