@luxfi/exchange 0.1.0 → 0.2.0

package/dist/bridge/use-private-teleport.d.ts

@@ -4,7 +4,7 @@
  * React hook for cross-chain private teleportation
  * Enables: XVM UTXO → ZNote (shielded) → Z-Chain AMM → destination
  */
-import { type PrivateTeleportConfig, type PrivateTeleportRequest, type TeleportRecord, type TeleportState } from './private-teleport-types';
+import { type PrivateTeleportConfig, type PrivateTeleportRequest, type TeleportRecord, TeleportState } from './private-teleport-types';
 export interface UsePrivateTeleportOptions {
     /** Custom config */
     config?: Partial<PrivateTeleportConfig>;

package/dist/bridge/use-private-teleport.d.ts.map

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

package/dist/bridge/use-private-teleport.js

@@ -7,7 +7,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { usePublicClient, useWalletClient } from 'wagmi';
 import { encodeFunctionData, keccak256, toHex } from 'viem';
-import { DEFAULT_PRIVATE_TELEPORT_CONFIG, PRIVATE_TELEPORT_ABI, ZNOTE_ABI, } from './private-teleport-types';
+import { TeleportState, DEFAULT_PRIVATE_TELEPORT_CONFIG, PRIVATE_TELEPORT_ABI, ZNOTE_ABI, } from './private-teleport-types';
 // ═══════════════════════════════════════════════════════════════════════════
 // CRYPTO UTILITIES (STUB - REAL IMPL USES @luxfi/crypto)
 // ═══════════════════════════════════════════════════════════════════════════
@@ -20,7 +20,7 @@ async function generateCommitment(amount, blindingFactor) {
     const bf = blindingFactor ?? toHex(BigInt(Math.random() * Number.MAX_SAFE_INTEGER));
     // Pedersen: C = g^amount * h^blinding
     // Simplified for now - real implementation uses elliptic curve ops
-    const commitment = keccak256(toHex(amount) + bf.slice(2));
+    const commitment = keccak256(`${toHex(amount)}${bf.slice(2)}`);
     return {
         commitment,
         blindingFactor: bf,
@@ -32,7 +32,7 @@ async function generateCommitment(amount, blindingFactor) {
  */
 async function fheEncrypt(value, publicKey) {
     // Simplified - real implementation uses TFHE
-    const ciphertext = keccak256(toHex(value) + publicKey.slice(2));
+    const ciphertext = keccak256(`${toHex(value)}${publicKey.slice(2)}`);
     return {
         ciphertext,
         publicKey,
@@ -44,7 +44,7 @@ async function fheEncrypt(value, publicKey) {
  */
 async function generateRangeProof(amount, commitment, blindingFactor, rangeBits = 64) {
     // Simplified - real implementation generates actual Bulletproof
-    const proof = keccak256(commitment + blindingFactor.slice(2) + toHex(amount).slice(2));
+    const proof = keccak256(`${commitment}${blindingFactor.slice(2)}${toHex(amount).slice(2)}`);
     return {
         proof,
         commitment,
@@ -55,19 +55,19 @@ async function generateRangeProof(amount, commitment, blindingFactor, rangeBits
  * Generate nullifier for spending a note
  */
 function generateNullifier(commitment, spendingKey, noteIndex) {
-    return keccak256(commitment + spendingKey.slice(2) + toHex(noteIndex).slice(2));
+    return keccak256(`${commitment}${spendingKey.slice(2)}${toHex(noteIndex).slice(2)}`);
 }
 // ═══════════════════════════════════════════════════════════════════════════
 // STATE MAPPING
 // ═══════════════════════════════════════════════════════════════════════════
 const stateMap = {
-    0: 'pending',
-    1: 'shielded',
-    2: 'swapped',
-    3: 'exporting',
-    4: 'complete',
-    5: 'cancelled',
-    6: 'expired',
+    0: TeleportState.INITIATED,
+    1: TeleportState.SHIELDED,
+    2: TeleportState.SWAP_COMPLETE,
+    3: TeleportState.EXPORTED,
+    4: TeleportState.COMPLETED,
+    5: TeleportState.CANCELLED,
+    6: TeleportState.EXPIRED,
 };
 // ═══════════════════════════════════════════════════════════════════════════
 // HOOK IMPLEMENTATION
@@ -148,7 +148,7 @@ export function usePrivateTeleport(options = {}) {
                 noteIndex: 0, // Would be extracted from event
             }));
             setCurrentTeleportId(teleportId);
-            setCurrentState('pending');
+            setCurrentState(TeleportState.INITIATED);
             return teleportId;
         }
         catch (err) {
@@ -191,8 +191,8 @@ export function usePrivateTeleport(options = {}) {
                 value: BigInt(0),
             });
             await publicClient.waitForTransactionReceipt({ hash });
-            setCurrentState('swapped');
-            onStateChange?.(teleportId, 'swapped');
+            setCurrentState(TeleportState.SWAP_COMPLETE);
+            onStateChange?.(teleportId, TeleportState.SWAP_COMPLETE);
         }
         catch (err) {
             const e = err instanceof Error ? err : new Error(String(err));
@@ -204,6 +204,46 @@ export function usePrivateTeleport(options = {}) {
         }
     }, [walletClient, publicClient, config, onStateChange]);
     // ─────────────────────────────────────────────────────────────────────────
+    // GET TELEPORT RECORD (defined early for use by other callbacks)
+    // ─────────────────────────────────────────────────────────────────────────
+    const getTeleportRecord = useCallback(async (teleportId) => {
+        if (!publicClient) {
+            throw new Error('Client not connected');
+        }
+        try {
+            const result = await publicClient.readContract({
+                address: config.teleportContract,
+                abi: PRIVATE_TELEPORT_ABI,
+                functionName: 'getTeleport',
+                args: [teleportId],
+            });
+            const tuple = result;
+            const [id, state, sourceChain, destChain, sourceAsset, destAsset, noteCommitment, encryptedAmount, nullifierHash, sender, recipient, deadline, createdBlock, privateSwap] = tuple;
+            if (id === '0x' + '00'.repeat(32)) {
+                return null;
+            }
+            return {
+                teleportId: id,
+                state: stateMap[state] ?? TeleportState.INITIATED,
+                sourceChain,
+                destChain,
+                sourceAsset,
+                destAsset,
+                noteCommitment,
+                encryptedAmount,
+                nullifierHash: nullifierHash !== '0x' + '00'.repeat(32) ? nullifierHash : undefined,
+                sender,
+                recipient,
+                deadline: Number(deadline),
+                createdBlock: Number(createdBlock),
+                privateSwap,
+            };
+        }
+        catch {
+            return null;
+        }
+    }, [publicClient, config]);
+    // ─────────────────────────────────────────────────────────────────────────
     // EXPORT TO DESTINATION
     // ─────────────────────────────────────────────────────────────────────────
     const exportToDestination = useCallback(async (teleportId) => {
@@ -250,8 +290,8 @@ export function usePrivateTeleport(options = {}) {
                 value: BigInt(0),
             });
             await publicClient.waitForTransactionReceipt({ hash });
-            setCurrentState('exporting');
-            onStateChange?.(teleportId, 'exporting');
+            setCurrentState(TeleportState.EXPORTED);
+            onStateChange?.(teleportId, TeleportState.EXPORTED);
         }
         catch (err) {
             const e = err instanceof Error ? err : new Error(String(err));
@@ -283,8 +323,8 @@ export function usePrivateTeleport(options = {}) {
                 value: BigInt(0),
             });
             await publicClient.waitForTransactionReceipt({ hash });
-            setCurrentState('complete');
-            onStateChange?.(teleportId, 'complete');
+            setCurrentState(TeleportState.COMPLETED);
+            onStateChange?.(teleportId, TeleportState.COMPLETED);
             // Clean up secrets
             setSecrets(prev => {
                 const next = new Map(prev);
@@ -352,8 +392,8 @@ export function usePrivateTeleport(options = {}) {
             const receipt = await publicClient.waitForTransactionReceipt({ hash });
             // Extract exportTxId from logs
             const exportTxId = receipt.logs[0]?.topics[1] ?? hash;
-            setCurrentState('complete');
-            onStateChange?.(request.teleportId, 'complete');
+            setCurrentState(TeleportState.COMPLETED);
+            onStateChange?.(request.teleportId, TeleportState.COMPLETED);
             // Clean up secrets
             setSecrets(prev => {
                 const next = new Map(prev);
@@ -392,7 +432,7 @@ export function usePrivateTeleport(options = {}) {
             // Generate new commitment for recipient
             const recipientCommitment = await generateCommitment(request.amount);
             // Encrypt note to recipient's viewing key
-            const encryptedNote = keccak256(request.recipientViewKey + recipientCommitment.commitment.slice(2));
+            const encryptedNote = keccak256(`${request.recipientViewKey}${recipientCommitment.commitment.slice(2)}`);
             // Generate nullifier
             const nullifier = generateNullifier(record.noteCommitment, secret.spendingKey, secret.noteIndex);
             // Get Merkle proof
@@ -403,7 +443,7 @@ export function usePrivateTeleport(options = {}) {
                 args: [BigInt(secret.noteIndex)],
             });
             // Generate transfer proof (proves amount conservation)
-            const transferProof = keccak256(record.noteCommitment + recipientCommitment.commitment.slice(2));
+            const transferProof = keccak256(`${record.noteCommitment}${recipientCommitment.commitment.slice(2)}`);
             const txData = encodeFunctionData({
                 abi: PRIVATE_TELEPORT_ABI,
                 functionName: 'privateTransferToRecipient',
@@ -424,8 +464,8 @@ export function usePrivateTeleport(options = {}) {
             const receipt = await publicClient.waitForTransactionReceipt({ hash });
             // Extract note index from logs (simplified)
             const newNoteIndex = Number(receipt.logs[0]?.data?.slice(0, 66) ?? '0');
-            setCurrentState('complete');
-            onStateChange?.(request.teleportId, 'complete');
+            setCurrentState(TeleportState.COMPLETED);
+            onStateChange?.(request.teleportId, TeleportState.COMPLETED);
             // Clean up secrets for this teleport
             setSecrets(prev => {
                 const next = new Map(prev);
@@ -467,7 +507,7 @@ export function usePrivateTeleport(options = {}) {
             // Generate commitments for each output
             const outputNotes = await Promise.all(outputs.map(async (output) => {
                 const commitment = await generateCommitment(output.amount);
-                const encryptedNote = keccak256(output.recipient + commitment.commitment.slice(2));
+                const encryptedNote = keccak256(`${output.recipient}${commitment.commitment.slice(2)}`);
                 return {
                     commitment: commitment.commitment,
                     encryptedNote,
@@ -484,7 +524,7 @@ export function usePrivateTeleport(options = {}) {
                 args: [BigInt(secret.noteIndex)],
             });
             // Generate split proof (proves sum of outputs = input)
-            const splitProof = keccak256(record.noteCommitment + outputNotes.map(n => n.commitment).join(''));
+            const splitProof = keccak256(`${record.noteCommitment}${outputNotes.map(n => n.commitment.slice(2)).join('')}`);
             const txData = encodeFunctionData({
                 abi: PRIVATE_TELEPORT_ABI,
                 functionName: 'splitAndTransfer',
@@ -504,8 +544,8 @@ export function usePrivateTeleport(options = {}) {
             const receipt = await publicClient.waitForTransactionReceipt({ hash });
             // Extract note indices from logs (simplified)
             const noteIndices = outputs.map((_, i) => i);
-            setCurrentState('complete');
-            onStateChange?.(teleportId, 'complete');
+            setCurrentState(TeleportState.COMPLETED);
+            onStateChange?.(teleportId, TeleportState.COMPLETED);
             // Clean up secrets for this teleport
             setSecrets(prev => {
                 const next = new Map(prev);
@@ -544,8 +584,8 @@ export function usePrivateTeleport(options = {}) {
                 value: BigInt(0),
             });
             await publicClient.waitForTransactionReceipt({ hash });
-            setCurrentState('cancelled');
-            onStateChange?.(teleportId, 'cancelled');
+            setCurrentState(TeleportState.CANCELLED);
+            onStateChange?.(teleportId, TeleportState.CANCELLED);
             // Clean up secrets
             setSecrets(prev => {
                 const next = new Map(prev);
@@ -562,45 +602,7 @@ export function usePrivateTeleport(options = {}) {
             setIsLoading(false);
         }
     }, [walletClient, publicClient, config, onStateChange]);
-    // ─────────────────────────────────────────────────────────────────────────
-    // GET TELEPORT RECORD
-    // ─────────────────────────────────────────────────────────────────────────
-    const getTeleportRecord = useCallback(async (teleportId) => {
-        if (!publicClient) {
-            throw new Error('Client not connected');
-        }
-        try {
-            const result = await publicClient.readContract({
-                address: config.teleportContract,
-                abi: PRIVATE_TELEPORT_ABI,
-                functionName: 'getTeleport',
-                args: [teleportId],
-            });
-            const [id, state, sourceChain, destChain, sourceAsset, destAsset, noteCommitment, encryptedAmount, nullifierHash, sender, recipient, deadline, createdBlock, privateSwap] = result;
-            if (id === '0x' + '00'.repeat(32)) {
-                return null;
-            }
-            return {
-                teleportId: id,
-                state: stateMap[state] ?? 'pending',
-                sourceChain,
-                destChain,
-                sourceAsset,
-                destAsset,
-                noteCommitment,
-                encryptedAmount,
-                nullifierHash: nullifierHash !== '0x' + '00'.repeat(32) ? nullifierHash : undefined,
-                sender,
-                recipient,
-                deadline: Number(deadline),
-                createdBlock: Number(createdBlock),
-                privateSwap,
-            };
-        }
-        catch {
-            return null;
-        }
-    }, [publicClient, config]);
+    // Wrapper for external API
     const getTeleport = useCallback(async (teleportId) => {
         return getTeleportRecord(teleportId);
     }, [getTeleportRecord]);
@@ -628,7 +630,7 @@ export function usePrivateTeleport(options = {}) {
     // POLLING
     // ─────────────────────────────────────────────────────────────────────────
     useEffect(() => {
-        if (!currentTeleportId || !publicClient || currentState === 'complete' || currentState === 'cancelled') {
+        if (!currentTeleportId || !publicClient || currentState === TeleportState.COMPLETED || currentState === TeleportState.CANCELLED) {
             return;
         }
         const poll = async () => {

package/dist/index.d.ts

@@ -14,4 +14,5 @@ export * from './contracts';
 export * from './dex';
 export * from './hooks';
 export * from './stores';
+export * from './bridge';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,UAAU,CAAA;AAGxB,cAAc,UAAU,CAAA;AAGxB,cAAc,aAAa,CAAA;AAG3B,cAAc,OAAO,CAAA;AAGrB,cAAc,SAAS,CAAA;AAGvB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,UAAU,CAAA;AAGxB,cAAc,UAAU,CAAA;AAGxB,cAAc,aAAa,CAAA;AAG3B,cAAc,OAAO,CAAA;AAGrB,cAAc,SAAS,CAAA;AAGvB,cAAc,UAAU,CAAA;AAGxB,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -20,5 +20,5 @@ export * from './dex';
 export * from './hooks';
 // Stores
 export * from './stores';
-// Note: Bridge module is experimental and will be added in a future release
-// See bridge-wip/ for the work-in-progress implementation
+// Bridge (cross-chain + Z-Chain privacy layer)
+export * from './bridge';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luxfi/exchange",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lux Exchange SDK - React hooks and utilities for Lux DEX",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -34,6 +34,10 @@
     "./dex": {
       "types": "./dist/dex/index.d.ts",
       "import": "./dist/dex/index.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge/index.d.ts",
+      "import": "./dist/bridge/index.js"
     }
   },
   "files": [

package/src/bridge/cross-chain-store.ts

@@ -0,0 +1,210 @@
+/**
+ * Zustand store for cross-chain mint operations
+ */
+
+import { create } from 'zustand'
+import { devtools, persist } from 'zustand/middleware'
+import type { CrossChainMintRequest, CrossChainMintState, CrossChainMintStatus } from './types'
+
+interface PendingMint extends CrossChainMintRequest {
+  state: CrossChainMintState
+}
+
+export interface CrossChainStore {
+  /** Currently active mints by swap ID */
+  pendingMints: Record<string, PendingMint>
+  /** Most recent completed mints (for history) */
+  recentMints: PendingMint[]
+  /** Maximum number of recent mints to keep */
+  maxRecentMints: number
+
+  // Actions
+  initiateMint: (request: CrossChainMintRequest) => string
+  updateMintStatus: (swapId: string, status: CrossChainMintStatus) => void
+  updateMintTxHash: (swapId: string, field: 'sourceTxHash' | 'mintTxHash' | 'swapTxHash', hash: string) => void
+  completeMint: (swapId: string) => void
+  failMint: (swapId: string, error: string) => void
+  cancelMint: (swapId: string) => void
+  clearPendingMint: (swapId: string) => void
+  getPendingMint: (swapId: string) => PendingMint | undefined
+  getActiveMints: () => PendingMint[]
+}
+
+// Generate a random swap ID
+function generateSwapId(): string {
+  const bytes = new Uint8Array(32)
+  crypto.getRandomValues(bytes)
+  return '0x' + Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('')
+}
+
+export const useCrossChainStore = create<CrossChainStore>()(
+  devtools(
+    persist(
+      (set, get) => ({
+        pendingMints: {},
+        recentMints: [],
+        maxRecentMints: 20,
+
+        initiateMint: (request: CrossChainMintRequest) => {
+          const swapId = generateSwapId()
+          const now = Date.now()
+
+          const pendingMint: PendingMint = {
+            ...request,
+            state: {
+              swapId: swapId as `0x${string}`,
+              status: 'initiating',
+              sourceTxHash: null,
+              mintTxHash: null,
+              swapTxHash: null,
+              error: null,
+              startedAt: now,
+              completedAt: null,
+            },
+          }
+
+          set((state) => ({
+            pendingMints: {
+              ...state.pendingMints,
+              [swapId]: pendingMint,
+            },
+          }))
+
+          return swapId
+        },
+
+        updateMintStatus: (swapId: string, status: CrossChainMintStatus) => {
+          set((state) => {
+            const mint = state.pendingMints[swapId]
+            if (!mint) return state
+
+            return {
+              pendingMints: {
+                ...state.pendingMints,
+                [swapId]: {
+                  ...mint,
+                  state: {
+                    ...mint.state,
+                    status,
+                  },
+                },
+              },
+            }
+          })
+        },
+
+        updateMintTxHash: (swapId: string, field: 'sourceTxHash' | 'mintTxHash' | 'swapTxHash', hash: string) => {
+          set((state) => {
+            const mint = state.pendingMints[swapId]
+            if (!mint) return state
+
+            return {
+              pendingMints: {
+                ...state.pendingMints,
+                [swapId]: {
+                  ...mint,
+                  state: {
+                    ...mint.state,
+                    [field]: hash,
+                  },
+                },
+              },
+            }
+          })
+        },
+
+        completeMint: (swapId: string) => {
+          set((state) => {
+            const mint = state.pendingMints[swapId]
+            if (!mint) return state
+
+            const completedMint: PendingMint = {
+              ...mint,
+              state: {
+                ...mint.state,
+                status: 'complete',
+                completedAt: Date.now(),
+              },
+            }
+
+            const { [swapId]: _, ...remainingPending } = state.pendingMints
+            const newRecent = [completedMint, ...state.recentMints].slice(0, state.maxRecentMints)
+
+            return {
+              pendingMints: remainingPending,
+              recentMints: newRecent,
+            }
+          })
+        },
+
+        failMint: (swapId: string, error: string) => {
+          set((state) => {
+            const mint = state.pendingMints[swapId]
+            if (!mint) return state
+
+            return {
+              pendingMints: {
+                ...state.pendingMints,
+                [swapId]: {
+                  ...mint,
+                  state: {
+                    ...mint.state,
+                    status: 'failed',
+                    error,
+                    completedAt: Date.now(),
+                  },
+                },
+              },
+            }
+          })
+        },
+
+        cancelMint: (swapId: string) => {
+          set((state) => {
+            const mint = state.pendingMints[swapId]
+            if (!mint) return state
+
+            return {
+              pendingMints: {
+                ...state.pendingMints,
+                [swapId]: {
+                  ...mint,
+                  state: {
+                    ...mint.state,
+                    status: 'cancelled',
+                    completedAt: Date.now(),
+                  },
+                },
+              },
+            }
+          })
+        },
+
+        clearPendingMint: (swapId: string) => {
+          set((state) => {
+            const { [swapId]: _, ...remainingPending } = state.pendingMints
+            return { pendingMints: remainingPending }
+          })
+        },
+
+        getPendingMint: (swapId: string) => {
+          return get().pendingMints[swapId]
+        },
+
+        getActiveMints: () => {
+          const { pendingMints } = get()
+          return Object.values(pendingMints).filter(
+            (m) => m.state.status !== 'failed' && m.state.status !== 'cancelled'
+          )
+        },
+      }),
+      {
+        name: 'cross-chain-mint-storage',
+        partialize: (state) => ({
+          recentMints: state.recentMints,
+        }),
+      }
+    ),
+    { name: 'CrossChainStore' }
+  )
+)

package/src/bridge/index.ts

@@ -0,0 +1,81 @@
+/**
+ * Cross-chain bridge module for XVM ↔ C-Chain atomic swaps
+ *
+ * Enables one-click minting of wrapped tokens on C-Chain from X-Chain assets
+ * using Warp cross-chain messaging and HTLC atomic swaps.
+ *
+ * Includes Z-Chain privacy layer for fully shielded cross-chain teleportation:
+ * XVM UTXO → ZNote (shielded) → Z-Chain AMM (private swap) → destination
+ *
+ * @example
+ * ```tsx
+ * // Standard cross-chain mint
+ * import { useCrossChainMint } from '@luxfi/exchange/bridge'
+ *
+ * function MintButton() {
+ *   const { mint, isLoading } = useCrossChainMint()
+ *
+ *   const handleMint = async () => {
+ *     const swapId = await mint({
+ *       sourceAsset: '0x...', // XVM asset ID
+ *       amount: 1000000n,     // 1 token (6 decimals)
+ *       recipient: '0x...',   // C-Chain recipient
+ *       targetToken: '0x...', // Optional: swap to this token
+ *       minReceive: 990000n,  // Slippage protection
+ *     })
+ *     console.log('Mint initiated:', swapId)
+ *   }
+ *
+ *   return (
+ *     <button onClick={handleMint} disabled={isLoading}>
+ *       {isLoading ? 'Minting...' : 'Mint on C-Chain'}
+ *     </button>
+ *   )
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Private teleport with Z-Chain
+ * import { usePrivateTeleport } from '@luxfi/exchange/bridge'
+ *
+ * function PrivateTeleportButton() {
+ *   const { teleport, executeSwap, exportToDestination, isLoading } = usePrivateTeleport()
+ *
+ *   const handlePrivateTeleport = async () => {
+ *     // 1. Initiate shielded teleport (creates ZNote)
+ *     const teleportId = await teleport({
+ *       sourceChain: '0x...', // X-Chain ID
+ *       destChain: '0x...',   // C-Chain ID
+ *       sourceAsset: '0x...', // Asset to teleport
+ *       destAsset: '0x...',   // Asset to receive (if swapping)
+ *       amount: 1000000n,     // Amount (will be encrypted)
+ *       recipient: '0x...',   // Destination address
+ *       deadline: Math.floor(Date.now() / 1000) + 3600,
+ *       privateSwap: true,    // Use Z-Chain AMM for private swap
+ *     })
+ *
+ *     // 2. Execute private swap on Z-Chain (optional)
+ *     await executeSwap(teleportId, '0x...poolId', 990000n)
+ *
+ *     // 3. Export to destination chain with range proof
+ *     await exportToDestination(teleportId)
+ *   }
+ *
+ *   return (
+ *     <button onClick={handlePrivateTeleport} disabled={isLoading}>
+ *       Private Teleport
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+
+// Standard cross-chain (public)
+export * from './types'
+export * from './cross-chain-store'
+export * from './use-cross-chain-mint'
+
+// Private teleport (Z-Chain privacy layer)
+export * from './private-teleport-types'
+export * from './use-private-teleport'