@aintivirus-ai/mixer-sdk 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Supported blockchain networks
+ */
+export declare enum ChainType {
+    EVM = "EVM",
+    SOLANA = "SOLANA"
+}
+/**
+ * Asset modes for deposits and withdrawals
+ */
+export declare enum AssetMode {
+    ETH = 0,// For EVM: ETH, For Solana: SOL
+    TOKEN = 1
+}
+/**
+ * Withdrawal proof structure
+ */
+export interface WithdrawalProof {
+    pA: [bigint, bigint];
+    pB: [[bigint, bigint], [bigint, bigint]];
+    pC: [bigint, bigint];
+    pubSignals: [bigint, bigint, bigint];
+}
+/**
+ * Deposit data structure
+ */
+export interface DepositData {
+    secret: bigint;
+    nullifier: bigint;
+    commitment: bigint;
+    amount: bigint;
+    mode: AssetMode;
+}
+/**
+ * Staking season information
+ */
+export interface StakeSeason {
+    seasonId: bigint;
+    startTimestamp: bigint;
+    endTimestamp: bigint;
+    totalStakedEthAmount: bigint;
+    totalStakedTokenAmount: bigint;
+    totalRewardEthAmount: bigint;
+    totalRewardTokenAmount: bigint;
+    totalEthWeightValue: bigint;
+    totalTokenWeightValue: bigint;
+}
+/**
+ * Staker record information
+ */
+export interface StakerRecord {
+    ethStakedSeasonId: bigint;
+    tokenStakedSeasonId: bigint;
+    ethStakedTimestamp: bigint;
+    tokenStakedTimestamp: bigint;
+    stakedEthAmount: bigint;
+    stakedTokenAmount: bigint;
+    ethWeightValue: bigint;
+    tokenWeightValue: bigint;
+}
+/**
+ * Configuration for SDK initialization
+ */
+export interface SDKConfig {
+    evm?: {
+        factoryAddress: string;
+        tokenAddress: string;
+        rpcUrl?: string;
+        provider?: any;
+    };
+    solana?: {
+        factoryProgramId: string;
+        mixerProgramId: string;
+        stakingProgramId: string;
+        tokenMint?: string;
+        rpcUrl?: string;
+        connection?: any;
+    };
+}
+/**
+ * Transaction result
+ */
+export interface TransactionResult {
+    txHash: string;
+    blockNumber?: number;
+    blockTime?: number;
+}
+/**
+ * Hook configuration for EVM
+ */
+export interface EVMHookConfig {
+    factoryAddress: string;
+    tokenAddress?: string;
+}
+/**
+ * Hook configuration for Solana
+ */
+export interface SolanaHookConfig {
+    factoryProgramId: string;
+    mixerProgramId: string;
+    stakingProgramId: string;
+    tokenMint?: string;
+}

package/dist/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssetMode = exports.ChainType = void 0;
+/**
+ * Supported blockchain networks
+ */
+var ChainType;
+(function (ChainType) {
+    ChainType["EVM"] = "EVM";
+    ChainType["SOLANA"] = "SOLANA";
+})(ChainType || (exports.ChainType = ChainType = {}));
+/**
+ * Asset modes for deposits and withdrawals
+ */
+var AssetMode;
+(function (AssetMode) {
+    AssetMode[AssetMode["ETH"] = 0] = "ETH";
+    AssetMode[AssetMode["TOKEN"] = 1] = "TOKEN";
+})(AssetMode || (exports.AssetMode = AssetMode = {}));

package/dist/utils/crypto.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generate secret and nullifier for a deposit
+ */
+export declare function generateSecretAndNullifier(): {
+    secret: bigint;
+    nullifier: bigint;
+};
+/**
+ * Compute commitment hash: Poseidon(secret, nullifier)
+ */
+export declare function computeCommitment(secret: bigint, nullifier: bigint): bigint;
+/**
+ * Compute nullifier hash: Poseidon(nullifier, 0)
+ */
+export declare function computeNullifierHash(nullifier: bigint): bigint;
+/**
+ * Convert bigint to bytes32 (for EVM)
+ */
+export declare function bigIntToBytes32(value: bigint): string;
+/**
+ * Convert bytes32 to bigint (for EVM)
+ */
+export declare function bytes32ToBigInt(value: string): bigint;

package/dist/utils/crypto.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSecretAndNullifier = generateSecretAndNullifier;
+exports.computeCommitment = computeCommitment;
+exports.computeNullifierHash = computeNullifierHash;
+exports.bigIntToBytes32 = bigIntToBytes32;
+exports.bytes32ToBigInt = bytes32ToBigInt;
+const poseidon_lite_1 = require("poseidon-lite");
+const ethers_1 = require("ethers");
+/**
+ * Generate secret and nullifier for a deposit
+ */
+function generateSecretAndNullifier() {
+    const secretBytes = (0, ethers_1.randomBytes)(32);
+    const nullifierBytes = (0, ethers_1.randomBytes)(32);
+    const secret = BigInt("0x" + Buffer.from(secretBytes).toString("hex"));
+    const nullifier = BigInt("0x" + Buffer.from(nullifierBytes).toString("hex"));
+    return { secret, nullifier };
+}
+/**
+ * Compute commitment hash: Poseidon(secret, nullifier)
+ */
+function computeCommitment(secret, nullifier) {
+    return (0, poseidon_lite_1.poseidon2)([secret, nullifier]);
+}
+/**
+ * Compute nullifier hash: Poseidon(nullifier, 0)
+ */
+function computeNullifierHash(nullifier) {
+    return (0, poseidon_lite_1.poseidon2)([nullifier, 0n]);
+}
+/**
+ * Convert bigint to bytes32 (for EVM)
+ */
+function bigIntToBytes32(value) {
+    return "0x" + value.toString(16).padStart(64, "0");
+}
+/**
+ * Convert bytes32 to bigint (for EVM)
+ */
+function bytes32ToBigInt(value) {
+    return BigInt(value);
+}

package/dist/utils/proof.d.ts

@@ -0,0 +1,34 @@
+import MerkleTree from "fixed-merkle-tree";
+import { WithdrawalProof } from "../types";
+/**
+ * Build merkle tree from commitments
+ */
+export declare function buildMerkleTree(commitments: bigint[]): MerkleTree;
+/**
+ * Get merkle path for a commitment
+ */
+export declare function getMerklePath(tree: MerkleTree, commitment: bigint): {
+    pathElements: bigint[];
+    pathIndices: number[];
+};
+/**
+ * Generate withdrawal proof
+ * Note: This requires the circuit WASM and zkey files
+ * In production, you should load these from your build directory
+ */
+export declare function generateWithdrawalProof(secret: bigint, nullifier: bigint, root: bigint, recipient: string, pathElements: bigint[], pathIndices: number[], circuitWasm?: Buffer, circuitZkey?: Buffer): Promise<WithdrawalProof>;
+/**
+ * Helper to prepare withdrawal proof data
+ */
+export interface WithdrawalProofData {
+    secret: bigint;
+    nullifier: bigint;
+    recipient: string;
+    commitments: bigint[];
+    circuitWasm?: Buffer;
+    circuitZkey?: Buffer;
+}
+/**
+ * Generate complete withdrawal proof from deposit data
+ */
+export declare function generateWithdrawalProofFromData(data: WithdrawalProofData): Promise<WithdrawalProof>;

package/dist/utils/proof.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMerkleTree = buildMerkleTree;
+exports.getMerklePath = getMerklePath;
+exports.generateWithdrawalProof = generateWithdrawalProof;
+exports.generateWithdrawalProofFromData = generateWithdrawalProofFromData;
+const poseidon_lite_1 = require("poseidon-lite");
+const fixed_merkle_tree_1 = __importDefault(require("fixed-merkle-tree"));
+const crypto_1 = require("./crypto");
+const snarkjs_1 = __importDefault(require("snarkjs"));
+/**
+ * Build merkle tree from commitments
+ */
+function buildMerkleTree(commitments) {
+    const tree = new fixed_merkle_tree_1.default(24, [], {
+        hashFunction: (left, right) => {
+            return (0, poseidon_lite_1.poseidon2)([BigInt(left), BigInt(right)]).toString();
+        },
+        zeroElement: "0",
+    });
+    for (const commitment of commitments) {
+        tree.insert(commitment.toString());
+    }
+    return tree;
+}
+/**
+ * Get merkle path for a commitment
+ */
+function getMerklePath(tree, commitment) {
+    const commitmentIndex = tree.elements.indexOf(commitment.toString());
+    if (commitmentIndex === -1) {
+        throw new Error("Commitment not found in merkle tree");
+    }
+    const path = tree.path(commitmentIndex);
+    return {
+        pathElements: path.pathElements.map((e) => BigInt(e)),
+        pathIndices: path.pathIndices,
+    };
+}
+/**
+ * Generate withdrawal proof
+ * Note: This requires the circuit WASM and zkey files
+ * In production, you should load these from your build directory
+ */
+async function generateWithdrawalProof(secret, nullifier, root, recipient, pathElements, pathIndices, circuitWasm, circuitZkey) {
+    // If circuit files are not provided, return a placeholder structure
+    // In production, you should always provide these files
+    if (!circuitWasm || !circuitZkey) {
+        console.warn("Circuit files not provided. Returning placeholder proof structure.");
+        const nullifierHash = (0, crypto_1.computeNullifierHash)(nullifier);
+        const recipientBigInt = BigInt(recipient);
+        return {
+            pA: [0n, 0n],
+            pB: [
+                [0n, 0n],
+                [0n, 0n],
+            ],
+            pC: [0n, 0n],
+            pubSignals: [nullifierHash, recipientBigInt, root],
+        };
+    }
+    // Prepare inputs
+    const input = {
+        secret: secret.toString(),
+        nullifier: nullifier.toString(),
+        root: root.toString(),
+        recipient: BigInt(recipient).toString(),
+        pathElements: pathElements.map((e) => e.toString()),
+        pathIndices: pathIndices.map((i) => i.toString()),
+    };
+    // Generate witness (requires witness calculator)
+    // Note: This is a simplified version. In production, you need to:
+    // 1. Load the witness calculator from your compiled circuit
+    // 2. Calculate witness using the calculator
+    // 3. Generate proof using snarkjs.groth16.prove()
+    // For now, return placeholder
+    // TODO: Implement full proof generation with witness calculator
+    const nullifierHash = (0, crypto_1.computeNullifierHash)(nullifier);
+    const recipientBigInt = BigInt(recipient);
+    try {
+        // Attempt to generate proof if witness calculator is available
+        // This would require loading the witness calculator from your build
+        const { proof, publicSignals } = await snarkjs_1.default.groth16.fullProve(input, circuitWasm, circuitZkey);
+        return {
+            pA: [BigInt(proof.pi_a[0]), BigInt(proof.pi_a[1])],
+            pB: [
+                [BigInt(proof.pi_b[0][1]), BigInt(proof.pi_b[0][0])],
+                [BigInt(proof.pi_b[1][1]), BigInt(proof.pi_b[1][0])],
+            ],
+            pC: [BigInt(proof.pi_c[0]), BigInt(proof.pi_c[1])],
+            pubSignals: publicSignals.map((x) => BigInt(x)),
+        };
+    }
+    catch (error) {
+        console.error("Proof generation failed:", error);
+        // Return placeholder on error
+        return {
+            pA: [0n, 0n],
+            pB: [
+                [0n, 0n],
+                [0n, 0n],
+            ],
+            pC: [0n, 0n],
+            pubSignals: [nullifierHash, recipientBigInt, root],
+        };
+    }
+}
+/**
+ * Generate complete withdrawal proof from deposit data
+ */
+async function generateWithdrawalProofFromData(data) {
+    const commitment = (0, crypto_1.computeCommitment)(data.secret, data.nullifier);
+    const tree = buildMerkleTree(data.commitments);
+    const root = BigInt(tree.root);
+    const path = getMerklePath(tree, commitment);
+    return generateWithdrawalProof(data.secret, data.nullifier, root, data.recipient, path.pathElements, path.pathIndices, data.circuitWasm, data.circuitZkey);
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@aintivirus-ai/mixer-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for AintiVirus Mixer - Easy web3 integration for privacy-preserving transactions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "npx tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "web3",
+    "privacy",
+    "mixer",
+    "zk-proof",
+    "ethereum",
+    "solana",
+    "staking"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@coral-xyz/anchor": "^0.29.0",
+    "@solana/spl-token": "^0.3.9",
+    "@solana/web3.js": "^1.87.6",
+    "ethers": "^6.9.0",
+    "fixed-merkle-tree": "^0.7.0",
+    "poseidon-lite": "^0.3.0",
+    "snarkjs": "^0.7.0"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@types/snarkjs": "^0.7.9",
+    "react": "^18.2.0",
+    "typescript": "^5.3.3",
+    "viem": "^2.0.0",
+    "wagmi": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "viem": "^2.0.0",
+    "wagmi": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "wagmi": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}