@sip-protocol/sdk 0.2.2 → 0.2.4

package/dist/index.d.mts

@@ -301,6 +301,20 @@ declare function getErrorMessage(error: unknown): string;
  * The mock proofs are clearly marked and will be rejected by any real verifier.
  */
 
+/**
+ * Configuration options for MockProofProvider
+ */
+interface MockProofProviderOptions {
+    /**
+     * Suppress the console warning about mock usage.
+     *
+     * Use this ONLY for SSR fallback scenarios where the mock provider
+     * is a placeholder and real proofs will be generated client-side.
+     *
+     * @default false
+     */
+    silent?: boolean;
+}
 /**
  * Mock Proof Provider for testing
  *
@@ -316,16 +330,29 @@ declare function getErrorMessage(error: unknown): string;
  *   // ... other params
  * })
  * ```
+ *
+ * @example
+ * ```typescript
+ * // SSR fallback (silent mode)
+ * const ssrFallback = new MockProofProvider({ silent: true })
+ * ```
  */
 declare class MockProofProvider implements ProofProvider {
     readonly framework: ProofFramework;
     private _isReady;
     private _warningShown;
+    private _silent;
+    /**
+     * Create a new MockProofProvider
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: MockProofProviderOptions);
     get isReady(): boolean;
     /**
      * Initialize the mock provider
      *
-     * Logs a warning to console about mock usage.
+     * Logs a warning to console about mock usage (unless silent mode is enabled).
      */
     initialize(): Promise<void>;
     /**
@@ -1530,9 +1557,10 @@ declare class SIP {
      *
      * @param params - Intent parameters (CreateIntentParams for production, ShieldedIntent/CreateIntentParams for demo)
      * @param recipientMetaAddress - Optional stealth meta-address for privacy modes
+     * @param senderAddress - Optional sender wallet address for cross-curve refunds
      * @returns Array of quotes (with deposit info in production mode)
      */
-    getQuotes(params: CreateIntentParams | ShieldedIntent, recipientMetaAddress?: StealthMetaAddress | string): Promise<ProductionQuote[]>;
+    getQuotes(params: CreateIntentParams | ShieldedIntent, recipientMetaAddress?: StealthMetaAddress | string, senderAddress?: string): Promise<ProductionQuote[]>;
     /**
      * Execute an intent with a selected quote
      *

package/dist/index.d.ts

@@ -301,6 +301,20 @@ declare function getErrorMessage(error: unknown): string;
  * The mock proofs are clearly marked and will be rejected by any real verifier.
  */
 
+/**
+ * Configuration options for MockProofProvider
+ */
+interface MockProofProviderOptions {
+    /**
+     * Suppress the console warning about mock usage.
+     *
+     * Use this ONLY for SSR fallback scenarios where the mock provider
+     * is a placeholder and real proofs will be generated client-side.
+     *
+     * @default false
+     */
+    silent?: boolean;
+}
 /**
  * Mock Proof Provider for testing
  *
@@ -316,16 +330,29 @@ declare function getErrorMessage(error: unknown): string;
  *   // ... other params
  * })
  * ```
+ *
+ * @example
+ * ```typescript
+ * // SSR fallback (silent mode)
+ * const ssrFallback = new MockProofProvider({ silent: true })
+ * ```
  */
 declare class MockProofProvider implements ProofProvider {
     readonly framework: ProofFramework;
     private _isReady;
     private _warningShown;
+    private _silent;
+    /**
+     * Create a new MockProofProvider
+     *
+     * @param options - Configuration options
+     */
+    constructor(options?: MockProofProviderOptions);
     get isReady(): boolean;
     /**
      * Initialize the mock provider
      *
-     * Logs a warning to console about mock usage.
+     * Logs a warning to console about mock usage (unless silent mode is enabled).
      */
     initialize(): Promise<void>;
     /**
@@ -1530,9 +1557,10 @@ declare class SIP {
      *
      * @param params - Intent parameters (CreateIntentParams for production, ShieldedIntent/CreateIntentParams for demo)
      * @param recipientMetaAddress - Optional stealth meta-address for privacy modes
+     * @param senderAddress - Optional sender wallet address for cross-curve refunds
      * @returns Array of quotes (with deposit info in production mode)
      */
-    getQuotes(params: CreateIntentParams | ShieldedIntent, recipientMetaAddress?: StealthMetaAddress | string): Promise<ProductionQuote[]>;
+    getQuotes(params: CreateIntentParams | ShieldedIntent, recipientMetaAddress?: StealthMetaAddress | string, senderAddress?: string): Promise<ProductionQuote[]>;
     /**
      * Execute an intent with a selected quote
      *

package/dist/index.js

@@ -2884,9 +2884,10 @@ var SIP = class {
    *
    * @param params - Intent parameters (CreateIntentParams for production, ShieldedIntent/CreateIntentParams for demo)
    * @param recipientMetaAddress - Optional stealth meta-address for privacy modes
+   * @param senderAddress - Optional sender wallet address for cross-curve refunds
    * @returns Array of quotes (with deposit info in production mode)
    */
-  async getQuotes(params, recipientMetaAddress) {
+  async getQuotes(params, recipientMetaAddress, senderAddress) {
     if (this.isProductionMode()) {
       if (!("input" in params)) {
         throw new ValidationError(
@@ -2894,7 +2895,7 @@ var SIP = class {
           "params"
         );
       }
-      return this.getQuotesProduction(params, recipientMetaAddress);
+      return this.getQuotesProduction(params, recipientMetaAddress, senderAddress);
     }
     return this.getQuotesDemo(params);
   }
@@ -2934,7 +2935,7 @@ var SIP = class {
     return this.config.network;
   }
   // ─── Production Mode Implementation ─────────────────────────────────────────
-  async getQuotesProduction(params, recipientMetaAddress) {
+  async getQuotesProduction(params, recipientMetaAddress, senderAddress) {
     if (!this.intentsAdapter) {
       throw new ValidationError(
         "NEAR Intents adapter not configured. Set intentsAdapter in config for production mode.",
@@ -2961,7 +2962,7 @@ var SIP = class {
       const prepared = await this.intentsAdapter.prepareSwap(
         swapRequest,
         metaAddr,
-        this.wallet?.address
+        senderAddress ?? this.wallet?.address
       );
       const rawQuote = await this.intentsAdapter.getQuote(prepared);
       this.pendingSwaps.set(requestId, {
@@ -3144,16 +3145,25 @@ var MockProofProvider = class {
   framework = "mock";
   _isReady = false;
   _warningShown = false;
+  _silent;
+  /**
+   * Create a new MockProofProvider
+   *
+   * @param options - Configuration options
+   */
+  constructor(options) {
+    this._silent = options?.silent ?? false;
+  }
   get isReady() {
     return this._isReady;
   }
   /**
    * Initialize the mock provider
    *
-   * Logs a warning to console about mock usage.
+   * Logs a warning to console about mock usage (unless silent mode is enabled).
    */
   async initialize() {
-    if (!this._warningShown) {
+    if (!this._warningShown && !this._silent) {
       console.warn(WARNING_MESSAGE);
       this._warningShown = true;
     }

package/dist/index.mjs

@@ -197,7 +197,7 @@ import {
   walletRegistry,
   withSecureBuffer,
   withSecureBufferSync
-} from "./chunk-DU7LQDD2.mjs";
+} from "./chunk-VXSHK7US.mjs";
 import {
   CryptoError,
   EncryptionNotImplementedError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sip-protocol/sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Core SDK for Shielded Intents Protocol - Privacy layer for cross-chain transactions",
   "author": "SIP Protocol <hello@sip-protocol.org>",
   "homepage": "https://sip-protocol.org",
@@ -36,6 +36,17 @@
     "dist",
     "src"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts --watch",
+    "lint": "eslint --ext .ts src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "bench": "vitest bench --config vitest.bench.config.ts",
+    "bench:json": "vitest bench --config vitest.bench.config.ts --outputJson benchmarks/results.json"
+  },
   "dependencies": {
     "@aztec/bb.js": "^0.63.1",
     "@noble/ciphers": "^2.0.1",
@@ -60,16 +71,5 @@
     "stealth-addresses",
     "zcash"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/browser.ts src/proofs/noir.ts --format cjs,esm --dts --watch",
-    "lint": "eslint --ext .ts src/",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "bench": "vitest bench --config vitest.bench.config.ts",
-    "bench:json": "vitest bench --config vitest.bench.config.ts --outputJson benchmarks/results.json"
-  }
-}
+  "license": "MIT"
+}

package/src/proofs/index.ts

@@ -46,6 +46,7 @@ export { ProofGenerationError } from './interface'
 
 // Mock provider (testing only)
 export { MockProofProvider } from './mock'
+export type { MockProofProviderOptions } from './mock'
 
 // NOTE: NoirProofProvider is NOT exported from main entry to avoid bundling WASM
 // in server-side builds (e.g., Next.js SSR). Import directly if needed:

package/src/proofs/mock.ts

@@ -44,6 +44,21 @@ const WARNING_MESSAGE = `
 ╚══════════════════════════════════════════════════════════════╝
 `
 
+/**
+ * Configuration options for MockProofProvider
+ */
+export interface MockProofProviderOptions {
+  /**
+   * Suppress the console warning about mock usage.
+   *
+   * Use this ONLY for SSR fallback scenarios where the mock provider
+   * is a placeholder and real proofs will be generated client-side.
+   *
+   * @default false
+   */
+  silent?: boolean
+}
+
 /**
  * Mock Proof Provider for testing
  *
@@ -59,11 +74,27 @@ const WARNING_MESSAGE = `
  *   // ... other params
  * })
  * ```
+ *
+ * @example
+ * ```typescript
+ * // SSR fallback (silent mode)
+ * const ssrFallback = new MockProofProvider({ silent: true })
+ * ```
  */
 export class MockProofProvider implements ProofProvider {
   readonly framework: ProofFramework = 'mock'
   private _isReady = false
   private _warningShown = false
+  private _silent: boolean
+
+  /**
+   * Create a new MockProofProvider
+   *
+   * @param options - Configuration options
+   */
+  constructor(options?: MockProofProviderOptions) {
+    this._silent = options?.silent ?? false
+  }
 
   get isReady(): boolean {
     return this._isReady
@@ -72,10 +103,10 @@ export class MockProofProvider implements ProofProvider {
   /**
    * Initialize the mock provider
    *
-   * Logs a warning to console about mock usage.
+   * Logs a warning to console about mock usage (unless silent mode is enabled).
    */
   async initialize(): Promise<void> {
-    if (!this._warningShown) {
+    if (!this._warningShown && !this._silent) {
       console.warn(WARNING_MESSAGE)
       this._warningShown = true
     }

package/src/sip.ts

@@ -320,11 +320,13 @@ export class SIP {
    *
    * @param params - Intent parameters (CreateIntentParams for production, ShieldedIntent/CreateIntentParams for demo)
    * @param recipientMetaAddress - Optional stealth meta-address for privacy modes
+   * @param senderAddress - Optional sender wallet address for cross-curve refunds
    * @returns Array of quotes (with deposit info in production mode)
    */
   async getQuotes(
     params: CreateIntentParams | ShieldedIntent,
     recipientMetaAddress?: StealthMetaAddress | string,
+    senderAddress?: string,
   ): Promise<ProductionQuote[]> {
     // Production mode - use real NEAR Intents
     if (this.isProductionMode()) {
@@ -335,7 +337,7 @@ export class SIP {
           'params'
         )
       }
-      return this.getQuotesProduction(params, recipientMetaAddress)
+      return this.getQuotesProduction(params, recipientMetaAddress, senderAddress)
     }
 
     // Demo mode - return mock quotes
@@ -400,6 +402,7 @@ export class SIP {
   private async getQuotesProduction(
     params: CreateIntentParams,
     recipientMetaAddress?: StealthMetaAddress | string,
+    senderAddress?: string,
   ): Promise<ProductionQuote[]> {
     if (!this.intentsAdapter) {
       throw new ValidationError(
@@ -437,10 +440,11 @@ export class SIP {
 
     try {
       // Get quote from 1Click API
+      // Use provided senderAddress or fallback to connected wallet address (for cross-curve refunds)
       const prepared = await this.intentsAdapter.prepareSwap(
         swapRequest,
         metaAddr,
-        this.wallet?.address,
+        senderAddress ?? this.wallet?.address,
       )
       const rawQuote = await this.intentsAdapter.getQuote(prepared)
 

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 RECTOR Labs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.