cipherpay-sdk 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# cipherpay-sdk
+
+Confidential payroll & payments SDK for [CipherPay](https://cipherpayy.vercel.app) on
+Fhenix FHE. Run encrypted payroll, charge invoices, relay webhooks, and drop a pay button
+into a React app — every amount stays encrypted as an FHE ciphertext on-chain.
+
+## Install
+
+```bash
+npm install cipherpay-sdk
+```
+
+Peer dependencies: `@cofhe/sdk` and `viem` are required; `react` and `wagmi` are only
+needed for the React hooks (`cipherpay-sdk/react`).
+
+## Run a confidential payroll (Node / server)
+
+```ts
+import { CipherPay } from 'cipherpay-sdk';
+
+const cp = new CipherPay({
+  rpcUrl:     process.env.SEPOLIA_RPC_URL!,
+  privateKey: process.env.PAYER_PRIVATE_KEY!, // employer / DAO treasury key
+});
+
+const result = await cp.runPayroll({
+  memo: 'April Payroll',
+  recipients: [
+    { address: '0xAbc...', amount: '2500.00' },
+    { address: '0xDef...', amount: '1800.00' },
+  ],
+  onProgress: (step) => console.log(step), // initTfhe → encrypting → submitting → confirming
+});
+
+console.log('Payroll batch tx:', result.txHash);
+```
+
+Each salary is FHE-encrypted before it reaches the chain. The batch is created in one
+`BatchCipher` transaction; each recipient can later claim and decrypt **only their own
+row** — no recipient, and no on-chain observer, sees another person's amount.
+
+## Charge a single invoice
+
+```ts
+await cp.charge({ invoiceId: '0x...', amount: '0.01' });
+```
+
+## Webhooks
+
+```ts
+import { CipherPay, CipherPayWebhooks } from 'cipherpay-sdk';
+
+new CipherPayWebhooks({
+  rpcUrl:   process.env.SEPOLIA_RPC_URL!,
+  endpoint: 'https://my-app.com/webhooks/cipherpay',
+  secret:   process.env.CIPHERPAY_WEBHOOK_SECRET!,
+}).start();
+
+// In your webhook handler — verify the signature before trusting the payload:
+const ok = CipherPay.verifyWebhook(rawBody, req.headers['x-cipherpay-signature'], secret);
+```
+
+`verifyWebhook` recomputes `HMAC-SHA256(secret, rawBody)` and compares it in constant time.
+
+## React hook
+
+```tsx
+import { useCheckout } from 'cipherpay-sdk/react';
+
+function PayButton({ invoiceHash }: { invoiceHash: string }) {
+  const { pay, status, txHash } = useCheckout(invoiceHash);
+  return (
+    <button onClick={() => pay({ amount: '0.01' })} disabled={status !== 'idle'}>
+      {status === 'encrypting' ? 'Encrypting…' : 'Pay with CipherPay'}
+    </button>
+  );
+}
+```
+
+The hook must render inside a wagmi `<WagmiProvider>`.
+
+## Build from source
+
+```bash
+npm install
+npm run build   # tsc → dist/
+```
+
+## License
+
+MIT

package/dist/CipherPay.d.ts

@@ -0,0 +1,61 @@
+import type { ChargeOptions, ChargeResult, PayrollOptions, PayrollResult, CipherPayConfig } from './types';
+/**
+ * CipherPay — server-side / Node.js SDK for CipherPay protocol.
+ *
+ * Stripe-like API:
+ *   const cp = new CipherPay({ rpcUrl, privateKey });
+ *   const result = await cp.charge({ invoiceId: '0x...', amount: '0.01' });
+ *
+ * The SDK handles:
+ *   1. FHE encryption of payment amount via @cofhe/sdk Node.js client
+ *   2. Contract interaction (payInvoice / payInvoiceShielded / claimAnonymously)
+ *   3. Transaction confirmation and result enrichment
+ */
+export declare class CipherPay {
+    private config;
+    constructor(config: CipherPayConfig);
+    /**
+     * Charge an invoice — FHE-encrypt the amount and submit payment.
+     *
+     * @example
+     * const result = await cp.charge({
+     *   invoiceId: '0xabc...',
+     *   amount: '0.01',
+     *   onProgress: (step) => console.log(step),
+     * });
+     * console.log('Paid:', result.txHash);
+     */
+    charge(opts: ChargeOptions): Promise<ChargeResult>;
+    /**
+     * Run a confidential payroll batch.
+     *
+     * Every salary is FHE-encrypted, then a single `BatchCipher` transaction
+     * creates one encrypted row per recipient. Each recipient can later claim and
+     * decrypt only their own row — no recipient, and no on-chain observer, sees
+     * another person's amount.
+     *
+     * @example
+     * await cp.runPayroll({
+     *   recipients: [
+     *     { address: '0xabc...', amount: '2500.00' },
+     *     { address: '0xdef...', amount: '1800.00' },
+     *   ],
+     *   memo: 'April Payroll',
+     * });
+     */
+    runPayroll(opts: PayrollOptions): Promise<PayrollResult>;
+    /**
+     * Verify a webhook event signature.
+     *
+     * `CipherPayWebhooks` signs every delivery as `HMAC-SHA256(secret, rawBody)`
+     * and sends the hex digest in the `X-CipherPay-Signature` header. This
+     * recomputes the digest and compares it to the received one in constant
+     * time, so a merchant can reject forged or tampered webhook calls.
+     *
+     * @param payload   the exact raw request body that was signed
+     * @param signature the hex digest from the `X-CipherPay-Signature` header
+     * @param secret    the shared webhook secret (`whsec_...`)
+     */
+    static verifyWebhook(payload: string, signature: string, secret: string): boolean;
+}
+//# sourceMappingURL=CipherPay.d.ts.map

package/dist/CipherPay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CipherPay.d.ts","sourceRoot":"","sources":["../src/CipherPay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EAAE,YAAY,EAC3B,cAAc,EAAE,aAAa,EAC7B,eAAe,EAChB,MAAM,SAAS,CAAC;AAQjB;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,eAAe;IASnC;;;;;;;;;;OAUG;IACG,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA8ExD;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgF9D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CAgBlF"}

package/dist/CipherPay.js

@@ -0,0 +1,217 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+// CipherPayFHE contract address on Ethereum Sepolia
+const DEFAULT_CONTRACT = '0x305eF265BD964fBe34913E70Ef6AA8951e6b662e';
+const DEFAULT_CHAIN_ID = 11155111;
+// BatchCipher — confidential batch payroll — on Ethereum Sepolia
+const BATCH_CIPHER_ADDRESS = '0x347fb466f3c9bC031560b49973ec05BdAdD2d4C4';
+/**
+ * CipherPay — server-side / Node.js SDK for CipherPay protocol.
+ *
+ * Stripe-like API:
+ *   const cp = new CipherPay({ rpcUrl, privateKey });
+ *   const result = await cp.charge({ invoiceId: '0x...', amount: '0.01' });
+ *
+ * The SDK handles:
+ *   1. FHE encryption of payment amount via @cofhe/sdk Node.js client
+ *   2. Contract interaction (payInvoice / payInvoiceShielded / claimAnonymously)
+ *   3. Transaction confirmation and result enrichment
+ */
+export class CipherPay {
+    config;
+    constructor(config) {
+        this.config = {
+            rpcUrl: config.rpcUrl,
+            privateKey: config.privateKey || '',
+            chainId: config.chainId ?? DEFAULT_CHAIN_ID,
+            contract: config.contract ?? DEFAULT_CONTRACT,
+        };
+    }
+    /**
+     * Charge an invoice — FHE-encrypt the amount and submit payment.
+     *
+     * @example
+     * const result = await cp.charge({
+     *   invoiceId: '0xabc...',
+     *   amount: '0.01',
+     *   onProgress: (step) => console.log(step),
+     * });
+     * console.log('Paid:', result.txHash);
+     */
+    async charge(opts) {
+        const { invoiceId, amount, shielded = false, anonymous = false, onProgress } = opts;
+        onProgress?.('initTfhe');
+        // Dynamic import for tree-shaking — cofhe/sdk only loaded when charge() is called
+        const { createCofheConfig, createCofheClient } = await import('@cofhe/sdk/node');
+        const { Encryptable } = await import('@cofhe/sdk');
+        const { createPublicClient, createWalletClient, http, parseEther } = await import('viem');
+        const { privateKeyToAccount } = await import('viem/accounts');
+        const { sepolia } = await import('viem/chains');
+        const account = privateKeyToAccount(this.config.privateKey);
+        const publicClient = createPublicClient({ chain: sepolia, transport: http(this.config.rpcUrl) });
+        const walletClient = createWalletClient({ account, chain: sepolia, transport: http(this.config.rpcUrl) });
+        const cofheConfig = createCofheConfig({ supportedChains: [sepolia] });
+        const cofheClient = createCofheClient(cofheConfig);
+        await cofheClient.connect(publicClient, walletClient);
+        onProgress?.('encrypting');
+        const amountWei = parseEther(amount);
+        const [encAmount] = await cofheClient.encryptInputs([Encryptable.uint64(amountWei)]).execute();
+        const encTuple = {
+            ctHash: BigInt(encAmount.ctHash ?? 0),
+            securityZone: encAmount.securityZone ?? 0,
+            utype: encAmount.utype ?? 5,
+            signature: encAmount.signature ?? '0x',
+        };
+        onProgress?.('submitting');
+        // Import minimal ABI inline — avoids needing the full contract.ts in sdk
+        const payAbi = [{
+                name: anonymous ? 'claimAnonymously' : shielded ? 'payInvoiceShielded' : 'payInvoice',
+                type: 'function',
+                stateMutability: anonymous || shielded ? 'nonpayable' : 'payable',
+                inputs: anonymous
+                    ? [{ name: '_invoiceHash', type: 'bytes32' }, { name: '_encryptedPayment', type: 'tuple', components: [{ name: 'ctHash', type: 'uint256' }, { name: 'securityZone', type: 'uint8' }, { name: 'utype', type: 'uint8' }, { name: 'signature', type: 'bytes' }] }, { name: '_nullifier', type: 'bytes32' }]
+                    : [{ name: '_invoiceHash', type: 'bytes32' }, { name: '_encryptedPayment', type: 'tuple', components: [{ name: 'ctHash', type: 'uint256' }, { name: 'securityZone', type: 'uint8' }, { name: 'utype', type: 'uint8' }, { name: 'signature', type: 'bytes' }] }],
+                outputs: [],
+            }];
+        const { keccak256, encodePacked } = await import('viem');
+        const nullifier = opts.nullifier
+            ? opts.nullifier
+            : keccak256(encodePacked(['address', 'bytes32'], [account.address, invoiceId]));
+        const args = anonymous
+            ? [invoiceId, encTuple, nullifier]
+            : [invoiceId, encTuple];
+        if (shielded) {
+            args.push(amountWei); // _maxDebit
+        }
+        const txHash = await walletClient.writeContract({
+            address: this.config.contract,
+            abi: payAbi,
+            functionName: payAbi[0].name,
+            args,
+            value: anonymous || shielded ? 0n : amountWei,
+        });
+        onProgress?.('confirming');
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+        return {
+            txHash,
+            invoiceId,
+            amount,
+            shielded,
+            anonymous,
+            blockNumber: receipt.blockNumber,
+        };
+    }
+    /**
+     * Run a confidential payroll batch.
+     *
+     * Every salary is FHE-encrypted, then a single `BatchCipher` transaction
+     * creates one encrypted row per recipient. Each recipient can later claim and
+     * decrypt only their own row — no recipient, and no on-chain observer, sees
+     * another person's amount.
+     *
+     * @example
+     * await cp.runPayroll({
+     *   recipients: [
+     *     { address: '0xabc...', amount: '2500.00' },
+     *     { address: '0xdef...', amount: '1800.00' },
+     *   ],
+     *   memo: 'April Payroll',
+     * });
+     */
+    async runPayroll(opts) {
+        const { recipients, memo = 'Payroll', onProgress } = opts;
+        if (recipients.length === 0 || recipients.length > 100) {
+            throw new Error('runPayroll: 1–100 recipients required per batch');
+        }
+        onProgress?.('initTfhe');
+        const { createCofheConfig, createCofheClient } = await import('@cofhe/sdk/node');
+        const { Encryptable } = await import('@cofhe/sdk');
+        const { createPublicClient, createWalletClient, http, parseEther, keccak256, encodePacked } = await import('viem');
+        const { privateKeyToAccount } = await import('viem/accounts');
+        const { sepolia } = await import('viem/chains');
+        const account = privateKeyToAccount(this.config.privateKey);
+        const publicClient = createPublicClient({ chain: sepolia, transport: http(this.config.rpcUrl) });
+        const walletClient = createWalletClient({ account, chain: sepolia, transport: http(this.config.rpcUrl) });
+        const cofheClient = createCofheClient(createCofheConfig({ supportedChains: [sepolia] }));
+        await cofheClient.connect(publicClient, walletClient);
+        onProgress?.('encrypting');
+        const amountsWei = recipients.map((r) => parseEther(r.amount));
+        const encrypted = await cofheClient
+            .encryptInputs(amountsWei.map((w) => Encryptable.uint64(w)))
+            .execute();
+        const encryptedAmounts = encrypted.map((e) => ({
+            ctHash: BigInt(e.ctHash ?? 0),
+            securityZone: e.securityZone ?? 0,
+            utype: e.utype ?? 5,
+            signature: e.signature ?? '0x',
+        }));
+        const total = amountsWei.reduce((sum, w) => sum + w, 0n);
+        const salt = keccak256(encodePacked(['address', 'uint256'], [account.address, BigInt(Date.now())]));
+        const createBatchAbi = [{
+                name: 'createBatch',
+                type: 'function',
+                stateMutability: 'payable',
+                inputs: [
+                    { name: '_recipients', type: 'address[]' },
+                    { name: '_encryptedAmounts', type: 'tuple[]', components: [
+                            { name: 'ctHash', type: 'uint256' }, { name: 'securityZone', type: 'uint8' },
+                            { name: 'utype', type: 'uint8' }, { name: 'signature', type: 'bytes' },
+                        ] },
+                    { name: '_ethAmounts', type: 'uint256[]' },
+                    { name: '_salt', type: 'bytes32' },
+                    { name: '_memo', type: 'string' },
+                ],
+                outputs: [{ name: 'batchId', type: 'bytes32' }],
+            }];
+        onProgress?.('submitting');
+        const txHash = await walletClient.writeContract({
+            address: BATCH_CIPHER_ADDRESS,
+            abi: createBatchAbi,
+            functionName: 'createBatch',
+            args: [
+                recipients.map((r) => r.address),
+                encryptedAmounts,
+                amountsWei,
+                salt,
+                memo,
+            ],
+            value: total,
+        });
+        onProgress?.('confirming');
+        const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash });
+        return {
+            txHash,
+            recipientCount: recipients.length,
+            memo,
+            blockNumber: receipt.blockNumber,
+        };
+    }
+    /**
+     * Verify a webhook event signature.
+     *
+     * `CipherPayWebhooks` signs every delivery as `HMAC-SHA256(secret, rawBody)`
+     * and sends the hex digest in the `X-CipherPay-Signature` header. This
+     * recomputes the digest and compares it to the received one in constant
+     * time, so a merchant can reject forged or tampered webhook calls.
+     *
+     * @param payload   the exact raw request body that was signed
+     * @param signature the hex digest from the `X-CipherPay-Signature` header
+     * @param secret    the shared webhook secret (`whsec_...`)
+     */
+    static verifyWebhook(payload, signature, secret) {
+        if (!payload || !signature || !secret)
+            return false;
+        const expected = createHmac('sha256', secret).update(payload).digest();
+        let received;
+        try {
+            received = Buffer.from(signature, 'hex');
+        }
+        catch {
+            return false;
+        }
+        // timingSafeEqual throws on length mismatch — guard before comparing.
+        if (received.length !== expected.length)
+            return false;
+        return timingSafeEqual(expected, received);
+    }
+}
+//# sourceMappingURL=CipherPay.js.map

package/dist/CipherPay.js.map

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

package/dist/hooks/useCheckout.d.ts

@@ -0,0 +1,26 @@
+/**
+ * useCheckout — React hook for paying a CipherPay invoice with an FHE-encrypted amount.
+ *
+ * Render it inside a wagmi `<WagmiProvider>` (the consuming app supplies the
+ * provider; `wagmi` and `viem` are peer dependencies of this SDK):
+ *
+ * @example
+ * import { useCheckout } from 'cipherpay-sdk/react';
+ *
+ * function PayButton({ invoiceHash }: { invoiceHash: string }) {
+ *   const { pay, status, txHash, error } = useCheckout(invoiceHash);
+ *   return (
+ *     <button onClick={() => pay({ amount: '0.01' })} disabled={status !== 'idle'}>
+ *       {status === 'encrypting' ? 'Encrypting…' : 'Pay with CipherPay'}
+ *     </button>
+ *   );
+ * }
+ *
+ * The hook runs the full FHE payment flow:
+ *   1. CoFHE SDK encrypts the amount client-side (TFHE + ZK proof)
+ *   2. Contract call — payInvoice / payInvoiceShielded / claimAnonymously
+ *   3. Wait for the transaction receipt
+ */
+import type { CheckoutState } from '../types';
+export declare function useCheckout(invoiceHash: string): CheckoutState;
+//# sourceMappingURL=useCheckout.d.ts.map

package/dist/hooks/useCheckout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.d.ts","sourceRoot":"","sources":["../../src/hooks/useCheckout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAA+C,MAAM,UAAU,CAAC;AAoB3F,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA0G9D"}

package/dist/hooks/useCheckout.js

@@ -0,0 +1,134 @@
+/**
+ * useCheckout — React hook for paying a CipherPay invoice with an FHE-encrypted amount.
+ *
+ * Render it inside a wagmi `<WagmiProvider>` (the consuming app supplies the
+ * provider; `wagmi` and `viem` are peer dependencies of this SDK):
+ *
+ * @example
+ * import { useCheckout } from 'cipherpay-sdk/react';
+ *
+ * function PayButton({ invoiceHash }: { invoiceHash: string }) {
+ *   const { pay, status, txHash, error } = useCheckout(invoiceHash);
+ *   return (
+ *     <button onClick={() => pay({ amount: '0.01' })} disabled={status !== 'idle'}>
+ *       {status === 'encrypting' ? 'Encrypting…' : 'Pay with CipherPay'}
+ *     </button>
+ *   );
+ * }
+ *
+ * The hook runs the full FHE payment flow:
+ *   1. CoFHE SDK encrypts the amount client-side (TFHE + ZK proof)
+ *   2. Contract call — payInvoice / payInvoiceShielded / claimAnonymously
+ *   3. Wait for the transaction receipt
+ */
+import { useState, useCallback, useRef } from 'react';
+import { useAccount, usePublicClient, useWalletClient } from 'wagmi';
+const CIPHERPAY_FHE_ADDRESS = '0x305eF265BD964fBe34913E70Ef6AA8951e6b662e';
+const ENCRYPTED_PAYMENT = {
+    name: '_encryptedPayment', type: 'tuple', components: [
+        { name: 'ctHash', type: 'uint256' }, { name: 'securityZone', type: 'uint8' },
+        { name: 'utype', type: 'uint8' }, { name: 'signature', type: 'bytes' },
+    ],
+};
+const PAY_ABI = [
+    { name: 'payInvoice', type: 'function', stateMutability: 'payable',
+        inputs: [{ name: '_invoiceHash', type: 'bytes32' }, ENCRYPTED_PAYMENT], outputs: [] },
+    { name: 'payInvoiceShielded', type: 'function', stateMutability: 'nonpayable',
+        inputs: [{ name: '_invoiceHash', type: 'bytes32' }, ENCRYPTED_PAYMENT, { name: '_maxDebit', type: 'uint256' }], outputs: [] },
+    { name: 'claimAnonymously', type: 'function', stateMutability: 'payable',
+        inputs: [{ name: '_invoiceHash', type: 'bytes32' }, ENCRYPTED_PAYMENT, { name: '_nullifier', type: 'bytes32' }], outputs: [] },
+];
+export function useCheckout(invoiceHash) {
+    const { address } = useAccount();
+    const publicClient = usePublicClient();
+    const { data: walletClient } = useWalletClient();
+    const [status, setStatus] = useState('idle');
+    const [error, setError] = useState(null);
+    const [txHash, setTxHash] = useState(null);
+    const [blockNumber, setBlock] = useState(null);
+    // The CoFHE client is created+connected once on the first pay() and reused.
+    const cofheRef = useRef(null);
+    const pay = useCallback(async (opts) => {
+        if (!walletClient || !publicClient || !address) {
+            const msg = 'Wallet not connected — render useCheckout inside a wagmi <WagmiProvider> and connect a wallet first.';
+            setError(msg);
+            setStatus('error');
+            throw new Error(msg);
+        }
+        setStatus('initializing_fhe');
+        setError(null);
+        setTxHash(null);
+        setBlock(null);
+        try {
+            const amount = opts?.amount ?? '0';
+            const shielded = opts?.shielded ?? false;
+            const anonymous = opts?.anonymous ?? false;
+            const { Encryptable } = await import('@cofhe/sdk');
+            const { parseEther, keccak256, encodePacked } = await import('viem');
+            // Lazily create + connect the CoFHE client (TFHE keys + ZK proving).
+            if (!cofheRef.current) {
+                const { createCofheConfig, createCofheClient } = await import('@cofhe/sdk/web');
+                const { sepolia } = await import('@cofhe/sdk/chains');
+                const client = createCofheClient(createCofheConfig({
+                    supportedChains: [sepolia],
+                    useWorkers: typeof SharedArrayBuffer !== 'undefined',
+                }));
+                await client.connect(publicClient, walletClient);
+                cofheRef.current = client;
+            }
+            const cofhe = cofheRef.current;
+            setStatus('encrypting');
+            const amountWei = parseEther(amount);
+            const [enc] = await cofhe
+                .encryptInputs([Encryptable.uint64(amountWei)])
+                .onStep((step) => opts?.onProgress?.(step))
+                .execute();
+            const encryptedPayment = {
+                ctHash: BigInt(enc.ctHash ?? 0),
+                securityZone: enc.securityZone ?? 0,
+                utype: enc.utype ?? 5,
+                signature: enc.signature ?? '0x',
+            };
+            setStatus('awaiting_signature');
+            const functionName = anonymous ? 'claimAnonymously' : shielded ? 'payInvoiceShielded' : 'payInvoice';
+            const nullifier = opts?.nullifier
+                ?? keccak256(encodePacked(['address', 'bytes32'], [address, invoiceHash]));
+            const args = anonymous
+                ? [invoiceHash, encryptedPayment, nullifier]
+                : shielded
+                    ? [invoiceHash, encryptedPayment, amountWei]
+                    : [invoiceHash, encryptedPayment];
+            setStatus('submitting');
+            const hash = await walletClient.writeContract({
+                address: CIPHERPAY_FHE_ADDRESS,
+                abi: PAY_ABI,
+                functionName,
+                args,
+                value: anonymous || shielded ? 0n : amountWei,
+                account: address,
+                chain: walletClient.chain,
+            });
+            setTxHash(hash);
+            setStatus('confirming');
+            const receipt = await publicClient.waitForTransactionReceipt({ hash });
+            setBlock(receipt.blockNumber);
+            setStatus('success');
+            return {
+                txHash: hash,
+                invoiceId: invoiceHash,
+                amount,
+                shielded,
+                anonymous,
+                blockNumber: receipt.blockNumber,
+            };
+        }
+        catch (err) {
+            const msg = err?.message || 'Payment failed';
+            setError(msg);
+            setStatus('error');
+            throw err;
+        }
+    }, [invoiceHash, address, publicClient, walletClient]);
+    return { status, error, txHash, blockNumber, pay };
+}
+//# sourceMappingURL=useCheckout.js.map

package/dist/hooks/useCheckout.js.map

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

package/dist/hooks/useShieldedBalance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * useShieldedBalance — React hook for CipherPay shielded balance management.
+ *
+ * @example
+ * const { balance, deposit, withdraw, isDepositing } = useShieldedBalance();
+ *
+ * // Deposit 0.01 ETH into shielded pool
+ * await deposit('0.01');
+ *
+ * // Withdraw 0.005 ETH back to wallet
+ * await withdraw('0.005');
+ */
+export declare function useShieldedBalance(): {
+    balance: string;
+    deposit: (amountEth: string) => Promise<`0x${string}`>;
+    withdraw: (amountEth: string) => Promise<`0x${string}`>;
+    refetch: (options?: import("@tanstack/query-core").RefetchOptions) => Promise<import("@tanstack/query-core").QueryObserverResult<bigint, import("viem").ReadContractErrorType>>;
+};
+//# sourceMappingURL=useShieldedBalance.d.ts.map

package/dist/hooks/useShieldedBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShieldedBalance.d.ts","sourceRoot":"","sources":["../../src/hooks/useShieldedBalance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAeH,wBAAgB,kBAAkB;;yBAec,MAAM;0BAYL,MAAM;;EAatD"}

package/dist/hooks/useShieldedBalance.js

@@ -0,0 +1,59 @@
+/**
+ * useShieldedBalance — React hook for CipherPay shielded balance management.
+ *
+ * @example
+ * const { balance, deposit, withdraw, isDepositing } = useShieldedBalance();
+ *
+ * // Deposit 0.01 ETH into shielded pool
+ * await deposit('0.01');
+ *
+ * // Withdraw 0.005 ETH back to wallet
+ * await withdraw('0.005');
+ */
+import { useCallback } from 'react';
+import { useAccount, useReadContract, useWriteContract, usePublicClient } from 'wagmi';
+import { parseEther, formatEther } from 'viem';
+// Import from the app's contract config
+const CIPHERPAY_FHE_ADDRESS = '0x305eF265BD964fBe34913E70Ef6AA8951e6b662e';
+const SHIELDED_ABI = [
+    { name: 'depositShielded', type: 'function', stateMutability: 'payable', inputs: [], outputs: [] },
+    { name: 'withdrawShielded', type: 'function', stateMutability: 'nonpayable', inputs: [{ name: '_amount', type: 'uint256' }], outputs: [] },
+    { name: 'shieldedBalance', type: 'function', stateMutability: 'view', inputs: [{ name: '', type: 'address' }], outputs: [{ name: '', type: 'uint256' }] },
+];
+export function useShieldedBalance() {
+    const { address } = useAccount();
+    const publicClient = usePublicClient();
+    const { writeContractAsync } = useWriteContract();
+    const { data: balanceRaw, refetch } = useReadContract({
+        address: CIPHERPAY_FHE_ADDRESS,
+        abi: SHIELDED_ABI,
+        functionName: 'shieldedBalance',
+        args: [address],
+        query: { enabled: !!address },
+    });
+    const balance = balanceRaw ? formatEther(balanceRaw) : '0';
+    const deposit = useCallback(async (amountEth) => {
+        const txHash = await writeContractAsync({
+            address: CIPHERPAY_FHE_ADDRESS,
+            abi: SHIELDED_ABI,
+            functionName: 'depositShielded',
+            value: parseEther(amountEth),
+        });
+        await publicClient.waitForTransactionReceipt({ hash: txHash });
+        await refetch();
+        return txHash;
+    }, [writeContractAsync, publicClient, refetch]);
+    const withdraw = useCallback(async (amountEth) => {
+        const txHash = await writeContractAsync({
+            address: CIPHERPAY_FHE_ADDRESS,
+            abi: SHIELDED_ABI,
+            functionName: 'withdrawShielded',
+            args: [parseEther(amountEth)],
+        });
+        await publicClient.waitForTransactionReceipt({ hash: txHash });
+        await refetch();
+        return txHash;
+    }, [writeContractAsync, publicClient, refetch]);
+    return { balance, deposit, withdraw, refetch };
+}
+//# sourceMappingURL=useShieldedBalance.js.map

package/dist/hooks/useShieldedBalance.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * cipherpay-sdk
+ *
+ * Confidential payroll & payments SDK for CipherPay on Fhenix FHE.
+ *
+ * Node / server entry. React hooks are in the 'cipherpay-sdk/react' subpath.
+ *
+ * Run a confidential payroll:
+ *   const cp = new CipherPay({ rpcUrl: 'https://...', privateKey: '0x...' });
+ *   await cp.runPayroll({
+ *     recipients: [
+ *       { address: '0x...', amount: '2500.00' },
+ *       { address: '0x...', amount: '1800.00' },
+ *     ],
+ *     memo: 'April Payroll',
+ *   });
+ *
+ * Charge a single invoice:
+ *   await cp.charge({ invoiceId: '0x...', amount: '0.01' });
+ *
+ * Relay on-chain events to a webhook endpoint:
+ *   new CipherPayWebhooks({ rpcUrl, endpoint, secret }).start();
+ */
+export { CipherPay } from './CipherPay';
+export { CipherPayWebhooks } from './webhooks';
+export type { ChargeOptions, ChargeResult, PayrollOptions, PayrollRecipient, PayrollResult, CheckoutState, CheckoutStatus, WebhookEvent, InvoiceType, CipherPayConfig, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAc,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * cipherpay-sdk
+ *
+ * Confidential payroll & payments SDK for CipherPay on Fhenix FHE.
+ *
+ * Node / server entry. React hooks are in the 'cipherpay-sdk/react' subpath.
+ *
+ * Run a confidential payroll:
+ *   const cp = new CipherPay({ rpcUrl: 'https://...', privateKey: '0x...' });
+ *   await cp.runPayroll({
+ *     recipients: [
+ *       { address: '0x...', amount: '2500.00' },
+ *       { address: '0x...', amount: '1800.00' },
+ *     ],
+ *     memo: 'April Payroll',
+ *   });
+ *
+ * Charge a single invoice:
+ *   await cp.charge({ invoiceId: '0x...', amount: '0.01' });
+ *
+ * Relay on-chain events to a webhook endpoint:
+ *   new CipherPayWebhooks({ rpcUrl, endpoint, secret }).start();
+ */
+export { CipherPay } from './CipherPay';
+export { CipherPayWebhooks } from './webhooks';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAc,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1,12 @@
+/**
+ * cipherpay-sdk/react — React hooks for CipherPay.
+ *
+ * These hooks call wagmi internally, so the host app must wrap its tree in a
+ * wagmi `<WagmiProvider>`. `react`, `wagmi`, and `viem` are peer dependencies.
+ *
+ *   import { useCheckout } from 'cipherpay-sdk/react';
+ */
+export { useCheckout } from './hooks/useCheckout';
+export { useShieldedBalance } from './hooks/useShieldedBalance';
+export type { CheckoutState, CheckoutStatus } from './types';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAa,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/dist/react.js

@@ -0,0 +1,11 @@
+/**
+ * cipherpay-sdk/react — React hooks for CipherPay.
+ *
+ * These hooks call wagmi internally, so the host app must wrap its tree in a
+ * wagmi `<WagmiProvider>`. `react`, `wagmi`, and `viem` are peer dependencies.
+ *
+ *   import { useCheckout } from 'cipherpay-sdk/react';
+ */
+export { useCheckout } from './hooks/useCheckout';
+export { useShieldedBalance } from './hooks/useShieldedBalance';
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAa,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export type InvoiceType = 'standard' | 'multipay' | 'recurring' | 'vesting' | 'donation' | 'batch';
+export interface ChargeOptions {
+    invoiceId: string;
+    amount: string;
+    currency?: 'ETH';
+    shielded?: boolean;
+    anonymous?: boolean;
+    nullifier?: string;
+    onProgress?: (step: string, ctx?: Record<string, unknown>) => void;
+}
+export interface ChargeResult {
+    txHash: string;
+    invoiceId: string;
+    amount: string;
+    shielded: boolean;
+    anonymous: boolean;
+    blockNumber?: bigint;
+}
+export interface PayrollRecipient {
+    address: string;
+    amount: string;
+}
+export interface PayrollOptions {
+    recipients: PayrollRecipient[];
+    memo?: string;
+    onProgress?: (step: string) => void;
+}
+export interface PayrollResult {
+    txHash: string;
+    batchId?: string;
+    recipientCount: number;
+    memo: string;
+    blockNumber?: bigint;
+}
+export type CheckoutStatus = 'idle' | 'initializing_fhe' | 'encrypting' | 'awaiting_signature' | 'submitting' | 'confirming' | 'success' | 'error';
+export interface CheckoutState {
+    status: CheckoutStatus;
+    error: string | null;
+    txHash: string | null;
+    blockNumber: bigint | null;
+    pay: (opts?: Partial<ChargeOptions>) => Promise<ChargeResult>;
+}
+export interface WebhookEvent {
+    type: 'invoice.paid' | 'invoice.settled' | 'invoice.cancelled' | 'anon.claimed';
+    invoiceId: string;
+    txHash: string;
+    blockNumber: number;
+    payer?: string;
+    timestamp: number;
+}
+export interface CipherPayConfig {
+    rpcUrl: string;
+    privateKey?: string;
+    chainId?: number;
+    contract?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnG,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAI,MAAM,CAAC;IACpB,MAAM,EAAO,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAI,KAAK,CAAC;IACnB,QAAQ,CAAC,EAAI,OAAO,CAAC;IACrB,SAAS,CAAC,EAAG,OAAO,CAAC;IACrB,SAAS,CAAC,EAAG,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAK,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAG,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAG,gBAAgB,EAAE,CAAC;IAChC,IAAI,CAAC,EAAQ,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAU,MAAM,CAAC;IACvB,OAAO,CAAC,EAAQ,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAY,MAAM,CAAC;IACvB,WAAW,CAAC,EAAI,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,kBAAkB,GAClB,YAAY,GACZ,oBAAoB,GACpB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAM,cAAc,CAAC;IAC3B,KAAK,EAAO,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAM,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAS,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAO,cAAc,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,CAAC;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAK,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAK,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAO,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAK,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAI,MAAM,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/webhooks.d.ts

@@ -0,0 +1,36 @@
+/**
+ * CipherPayWebhooks — relay on-chain CipherPay events to HTTPS endpoints.
+ *
+ * Merchants get order confirmation like Stripe webhooks.
+ *
+ * @example
+ * const webhooks = new CipherPayWebhooks({
+ *   rpcUrl: 'https://...',
+ *   endpoint: 'https://my-store.com/webhooks/cipherpay',
+ *   secret: 'whsec_...',
+ * });
+ *
+ * webhooks.start();
+ * // Listens to InvoicePaid, InvoiceSettled, AnonClaimSubmitted events
+ * // POSTs signed JSON to your endpoint on each event
+ */
+interface WebhookConfig {
+    rpcUrl: string;
+    endpoint: string;
+    secret: string;
+    contract?: string;
+    fromBlock?: bigint;
+}
+export declare class CipherPayWebhooks {
+    private config;
+    private running;
+    constructor(config: WebhookConfig);
+    /** Start watching for events and relaying to the webhook endpoint */
+    start(): Promise<void>;
+    stop(): void;
+    private _logToEventType;
+    private _deliver;
+    private _sign;
+}
+export {};
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,UAAU,aAAa;IACrB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,EAAG,MAAM,CAAC;IAClB,MAAM,EAAK,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,aAAa;IAUjC,qEAAqE;IAC/D,KAAK;IAsCX,IAAI;IAIJ,OAAO,CAAC,eAAe;YAUT,QAAQ;YAmBR,KAAK;CAKpB"}

package/dist/webhooks.js

@@ -0,0 +1,101 @@
+/**
+ * CipherPayWebhooks — relay on-chain CipherPay events to HTTPS endpoints.
+ *
+ * Merchants get order confirmation like Stripe webhooks.
+ *
+ * @example
+ * const webhooks = new CipherPayWebhooks({
+ *   rpcUrl: 'https://...',
+ *   endpoint: 'https://my-store.com/webhooks/cipherpay',
+ *   secret: 'whsec_...',
+ * });
+ *
+ * webhooks.start();
+ * // Listens to InvoicePaid, InvoiceSettled, AnonClaimSubmitted events
+ * // POSTs signed JSON to your endpoint on each event
+ */
+const DEFAULT_CONTRACT = '0x305eF265BD964fBe34913E70Ef6AA8951e6b662e';
+export class CipherPayWebhooks {
+    config;
+    running = false;
+    constructor(config) {
+        this.config = {
+            rpcUrl: config.rpcUrl,
+            endpoint: config.endpoint,
+            secret: config.secret,
+            contract: config.contract ?? DEFAULT_CONTRACT,
+            fromBlock: config.fromBlock ?? 0n,
+        };
+    }
+    /** Start watching for events and relaying to the webhook endpoint */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const { createPublicClient, http, parseAbi } = await import('viem');
+        const { sepolia } = await import('viem/chains');
+        const client = createPublicClient({
+            chain: sepolia,
+            transport: http(this.config.rpcUrl),
+        });
+        const abi = parseAbi([
+            'event InvoicePaid(bytes32 indexed invoiceHash, address indexed payer)',
+            'event InvoiceSettled(bytes32 indexed invoiceHash)',
+            'event InvoiceCancelled(bytes32 indexed invoiceHash)',
+            'event AnonClaimSubmitted(bytes32 indexed invoiceHash, bytes32 indexed nullifier)',
+        ]);
+        client.watchContractEvent({
+            address: this.config.contract,
+            abi,
+            onLogs: async (logs) => {
+                for (const log of logs) {
+                    const event = {
+                        type: this._logToEventType(log.eventName),
+                        invoiceId: log.args.invoiceHash ?? '',
+                        txHash: log.transactionHash ?? '',
+                        blockNumber: Number(log.blockNumber ?? 0),
+                        payer: log.args.payer,
+                        timestamp: Date.now(),
+                    };
+                    await this._deliver(event);
+                }
+            },
+        });
+    }
+    stop() {
+        this.running = false;
+    }
+    _logToEventType(name) {
+        const map = {
+            InvoicePaid: 'invoice.paid',
+            InvoiceSettled: 'invoice.settled',
+            InvoiceCancelled: 'invoice.cancelled',
+            AnonClaimSubmitted: 'anon.claimed',
+        };
+        return map[name ?? ''] ?? 'invoice.paid';
+    }
+    async _deliver(event) {
+        const body = JSON.stringify(event);
+        const sig = await this._sign(body);
+        try {
+            await fetch(this.config.endpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CipherPay-Signature': sig,
+                    'X-CipherPay-Timestamp': String(event.timestamp),
+                },
+                body,
+            });
+        }
+        catch (err) {
+            console.error('[CipherPay Webhooks] Delivery failed:', err);
+        }
+    }
+    async _sign(payload) {
+        // HMAC-SHA256 signature for webhook verification
+        const { createHmac } = await import('crypto');
+        return createHmac('sha256', this.config.secret).update(payload).digest('hex');
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "cipherpay-sdk",
+  "version": "0.1.0",
+  "description": "Confidential payroll & payments SDK for CipherPay on Fhenix FHE — encrypted payouts, webhooks, and React hooks.",
+  "license": "MIT",
+  "repository": "https://github.com/kravadk/cipherpay",
+  "type": "module",
+  "files": ["dist", "README.md"],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "fhe",
+    "fhenix",
+    "cofhe",
+    "confidential",
+    "payroll",
+    "payments",
+    "ethereum",
+    "web3"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@cofhe/sdk": ">=0.5.0",
+    "react": ">=18.0.0",
+    "viem": ">=2.0.0",
+    "wagmi": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "wagmi": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "@types/react": "^19.0.0",
+    "typescript": "~5.8.2"
+  }
+}