@silentswap/sdk 0.0.77 → 0.0.79

package/dist/swap-executor.d.ts

@@ -5,6 +5,14 @@
  * This module provides a simple interface for integrators to execute swaps without
  * needing to understand the underlying protocol details.
  *
+ * **Recovery (refund / prove delivery):** Save `result.viewingAuth` and the order ID
+ * for tracking, refund, and recovery. The mnemonic used for the facilitator group can
+ * be derived from the same entropy that was used to create the group: use
+ * `exportSecretMnemonicFromEntropy(entropy)` from this package. Recovery paths are
+ * BIP-44 paths of the form `m/44'/${coinType}'/${accountIndex}'/0/${addressIndex}`,
+ * built from the group's exported public keys (skip coin type `'*'`). See the docs
+ * "Save auth & order ID (refund & recovery)" for full details.
+ *
  * @example
  * ```typescript
  * import { executeSolanaSwap, createSwapAccounts } from '@silentswap/sdk';
@@ -24,6 +32,7 @@
  * });
  *
  * console.log('Order ID:', result.orderId);
+ * console.log('Viewing auth (save for tracking/refund/recovery):', result.viewingAuth);
  * ```
  */
 import type { Caip19 } from './types/core.js';
@@ -90,6 +99,27 @@ export interface SwapResult {
     usdcAmount: string;
     /** Actual source amount used (may differ due to bridge optimization) */
     actualSourceAmount: string;
+    /**
+     * Viewing auth (Base58 EVM address of the facilitator group's viewer) for this order.
+     * Save it together with the order ID to track the order, check refund eligibility, or run
+     * recovery flows.
+     */
+    viewingAuth: string;
+    /**
+     * Recovery data for refund/recovery: mnemonic (24 words) and BIP-44 derivation paths
+     * for the facilitator group. Store securely; do not log or commit.
+     */
+    recoveryData: {
+        mnemonic: string;
+        recoveryPaths: string[];
+    };
+    /** Wallets used for this swap: EVM signer (refundee) and Solana depositor */
+    usedWallet: {
+        /** EVM address used for auth and as refundee */
+        evmAddress: `0x${string}`;
+        /** Solana public key (base58) used for the deposit transaction */
+        solanaPublicKey: string;
+    };
 }
 /**
  * EVM account for signing

package/dist/swap-executor.js

@@ -5,6 +5,14 @@
  * This module provides a simple interface for integrators to execute swaps without
  * needing to understand the underlying protocol details.
  *
+ * **Recovery (refund / prove delivery):** Save `result.viewingAuth` and the order ID
+ * for tracking, refund, and recovery. The mnemonic used for the facilitator group can
+ * be derived from the same entropy that was used to create the group: use
+ * `exportSecretMnemonicFromEntropy(entropy)` from this package. Recovery paths are
+ * BIP-44 paths of the form `m/44'/${coinType}'/${accountIndex}'/0/${addressIndex}`,
+ * built from the group's exported public keys (skip coin type `'*'`). See the docs
+ * "Save auth & order ID (refund & recovery)" for full details.
+ *
  * @example
  * ```typescript
  * import { executeSolanaSwap, createSwapAccounts } from '@silentswap/sdk';
@@ -24,14 +32,15 @@
  * });
  *
  * console.log('Order ID:', result.orderId);
+ * console.log('Viewing auth (save for tracking/refund/recovery):', result.viewingAuth);
  * ```
  */
 import { encodeFunctionData, erc20Abi } from 'viem';
 import { createSilentSwapClient } from './client.js';
 import { createSignInMessage, createEip712DocForWalletGeneration } from './sdk.js';
-import { createHdFacilitatorGroupFromEntropy } from './hd-facilitator-group.js';
+import { createHdFacilitatorGroupFromEntropy, exportSecretMnemonicFromEntropy, } from './hd-facilitator-group.js';
 import { queryDepositCount } from './wallet.js';
-import { hexToBytes } from './encoding.js';
+import { hexToBytes, hexToBase58 } from './encoding.js';
 import { quoteResponseToEip712Document, DeliveryMethod, FacilitatorKeyType, PublicKeyArgGroups } from './order.js';
 import { solveOptimalUsdcAmount, fetchRelayQuote, getRelayStatus } from './bridge.js';
 import { ENVIRONMENT, N_RELAY_CHAIN_ID_SOLANA, NI_CHAIN_ID_AVALANCHE, SB58_ADDR_SOL_PROGRAM_SYSTEM, SB58_CHAIN_ID_SOLANA_MAINNET, S0X_ADDR_USDC_AVALANCHE, } from './constants.js';
@@ -491,12 +500,32 @@ export async function executeSolanaSwap(config) {
             });
         }
     }
+    // Derive viewing auth (viewer EVM address as Base58) for tracking, refund, and recovery
+    const viewer = await facilitatorGroup.viewer();
+    const viewerEvmSigner = await viewer.evmSigner();
+    const viewingAuth = hexToBase58(viewerEvmSigner.address);
+    // Build recovery data (mnemonic + paths) for refund/recovery
+    const groupPublicKeysForRecovery = await facilitatorGroup.exportPublicKeys(1, [...PublicKeyArgGroups.GENERIC]);
+    const recoveryPaths = [];
+    for (const pk of groupPublicKeysForRecovery[0] ?? []) {
+        if (pk.coinType === '*')
+            continue;
+        recoveryPaths.push(`m/44'/${pk.coinType}'/${depositCount}'/0/0`);
+    }
+    const mnemonic = (await exportSecretMnemonicFromEntropy(hexToBytes(entropy))).toString();
+    const recoveryData = { mnemonic, recoveryPaths };
     return {
         orderId,
         quoteId: quoteResponse.quoteId,
         depositTxHash: txHash,
         usdcAmount: bridgeResult.usdcAmountOut.toString(),
         actualSourceAmount: bridgeResult.actualAmountIn.toString(),
+        viewingAuth,
+        recoveryData,
+        usedWallet: {
+            evmAddress: accounts.evm.address,
+            solanaPublicKey: accounts.solana.publicKey,
+        },
     };
 }
 // ============================================================================

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@silentswap/sdk",
   "type": "module",
-  "version": "0.0.77",
+  "version": "0.0.79",
   "license": "MIT",
   "main": "dist/index.js",
   "files": [