@veilo/sdk-core 0.3.3 → 0.4.0

package/dist/esm/config.d.ts

@@ -0,0 +1,82 @@
+import { PublicKey } from "@solana/web3.js";
+/** Default relayer fee in basis points (50 = 0.5%). */
+export declare const DEFAULT_FEE_BPS = 50;
+/** Merkle tree depth - matches on-chain MerkleTreeAccount subtrees array size */
+export declare const MERKLE_TREE_DEPTH = 22;
+/** Root history size - matches on-chain MerkleTreeAccount root_history array size */
+export declare const ROOT_HISTORY_SIZE = 256;
+/** Native SOL mint address (Pubkey::default() = all zeros) */
+export declare const NATIVE_SOL_MINT: PublicKey;
+/** Convert SOL to lamports (e.g. `sol(1.5)` → `1_500_000_000n`). */
+export declare function sol(n: number): bigint;
+/** Configuration for initializing a privacy pool */
+export type PoolInitConfig = {
+    /** Fee in basis points (0-10000, where 10000 = 100%) */
+    feeBps?: number;
+    /** Token mint address (use NATIVE_SOL_MINT for SOL pools) */
+    mintAddress: PublicKey;
+    /** Minimum deposit amount in lamports/token units */
+    minDepositAmount?: bigint;
+    /** Maximum deposit amount in lamports/token units */
+    maxDepositAmount?: bigint;
+    /** Minimum withdrawal amount in lamports/token units */
+    minWithdrawAmount?: bigint;
+    /** Maximum withdrawal amount in lamports/token units */
+    maxWithdrawAmount?: bigint;
+};
+/** On-chain PrivacyConfig account structure */
+export type PrivacyConfigAccount = {
+    bump: number;
+    vaultBump: number;
+    admin: PublicKey;
+    feeBps: number;
+    feeErrorMarginBps: number;
+    minWithdrawalFee: bigint;
+    /** Minimum fee kept by relayer on swaps (in destination token base units) */
+    minSwapFee: bigint;
+    /** Fee rate applied to swap output in basis points */
+    swapFeeBps: number;
+    totalTvl: bigint;
+    mintAddress: PublicKey;
+    minDepositAmount: bigint;
+    maxDepositAmount: bigint;
+    minWithdrawAmount: bigint;
+    maxWithdrawAmount: bigint;
+    numRelayers: number;
+    relayers: PublicKey[];
+    numTrees: number;
+    nextTreeIndex: number;
+};
+/** On-chain GlobalConfig account structure */
+export type GlobalConfigAccount = {
+    bump: number;
+    admin: PublicKey;
+    relayerEnabled: boolean;
+};
+/**
+ * Compute the relayer fee for a withdrawal.
+ * Mirrors the formula in the relayer-server:
+ *   fee = max(amount * feeBps / 10_000, minWithdrawalFee)
+ *
+ * @returns fee in base token units, and the amount that reaches the recipient
+ */
+export declare function computeWithdrawalFee(amount: bigint, feeBps: number, minWithdrawalFee: bigint): {
+    fee: bigint;
+    toRecipient: bigint;
+};
+/**
+ * Compute the relayer fee for a cross-pool swap.
+ * Mirrors the formula in the relayer-server:
+ *   relayerFee = max(estimatedOutput * swapFeeBps / 10_000, minSwapFee)
+ *   destAmount  = minAmountOut - relayerFee
+ *
+ * @param estimatedOutput  Jupiter quote output amount
+ * @param swapFeeBps       From the destination pool's PrivacyConfigAccount
+ * @param minSwapFee       From the destination pool's PrivacyConfigAccount
+ * @param minAmountOut     User-agreed minimum swap output (after slippage)
+ * @returns relayerFee and the amount committed into the destination UTXO
+ */
+export declare function computeSwapFee(estimatedOutput: bigint, swapFeeBps: number, minSwapFee: bigint, minAmountOut: bigint): {
+    relayerFee: bigint;
+    destAmount: bigint;
+};

package/dist/esm/events.d.ts

@@ -0,0 +1,77 @@
+import { PublicKey } from "@solana/web3.js";
+import { Program, Idl } from "@coral-xyz/anchor";
+import { MerkleTree } from "./merkle.js";
+/**
+ * On-chain CommitmentEvent emitted by `transact` and `transact_swap`.
+ * Mirrors the IDL CommitmentEvent struct.
+ */
+export type CommitmentEvent = {
+    commitment: Uint8Array;
+    leafIndex: number;
+    newRoot: Uint8Array;
+    timestamp: number;
+    mintAddress: PublicKey;
+    treeId: number;
+    txSignature: string;
+    slot: number;
+};
+/**
+ * On-chain NullifierSpent event emitted when a UTXO is consumed.
+ * Mirrors the IDL NullifierSpent struct.
+ */
+export type NullifierSpentEvent = {
+    nullifier: Uint8Array;
+    timestamp: number;
+    mintAddress: PublicKey;
+    treeId: number;
+    txSignature: string;
+    slot: number;
+};
+/**
+ * Fetch and parse CommitmentEvents for a program, optionally filtered by mint.
+ *
+ * @param program     - Anchor program instance
+ * @param mintAddress - Filter to a specific pool; omit to get all pools
+ * @param before      - Start paging before this signature (exclusive)
+ * @param until       - Stop paging at this signature (exclusive)
+ * @param limit       - Max signatures to fetch per page (default 1000)
+ */
+export declare function scanCommitmentEvents<T extends Idl>(params: {
+    program: Program<T>;
+    mintAddress?: PublicKey;
+    before?: string;
+    until?: string;
+    limit?: number;
+}): Promise<CommitmentEvent[]>;
+/**
+ * Fetch and parse NullifierSpent events for a program, optionally filtered by mint.
+ */
+export declare function scanNullifierEvents<T extends Idl>(params: {
+    program: Program<T>;
+    mintAddress?: PublicKey;
+    before?: string;
+    until?: string;
+    limit?: number;
+}): Promise<NullifierSpentEvent[]>;
+/**
+ * Rebuild a local MerkleTree from on-chain CommitmentEvents.
+ * Use this to get a valid inclusion proof for spending any UTXO.
+ *
+ * CommitmentEvents are sorted by (treeId, leafIndex) so the local tree
+ * matches the on-chain state exactly.
+ *
+ * @param program     - Anchor program instance
+ * @param mintAddress - Pool to reconstruct
+ * @param treeId      - Which tree to reconstruct (default 0)
+ * @param depth       - Merkle tree depth (default 22, must match on-chain)
+ */
+export declare function buildTreeFromEvents<T extends Idl>(params: {
+    program: Program<T>;
+    mintAddress: PublicKey;
+    treeId?: number;
+    depth?: number;
+}): Promise<{
+    tree: MerkleTree;
+    events: CommitmentEvent[];
+    latestSignature?: string;
+}>;

package/dist/esm/events.js

@@ -1,5 +1,5 @@
 import * as anchor from "@coral-xyz/anchor";
-import { MerkleTree } from "./merkle";
+import { MerkleTree } from "./merkle.js";
 // -----------------------------------------------------------------------------
 // Event Scanning
 // -----------------------------------------------------------------------------

package/dist/esm/idl/privacy_pool.d.ts

@@ -0,0 +1,5 @@
+import type { Idl } from "@coral-xyz/anchor";
+declare const IDL_JSON: Idl & {
+    address: string;
+};
+export default IDL_JSON;