@ravnexchange/sdk 0.1.11 → 0.1.13

package/dist/client.d.ts

@@ -4,7 +4,8 @@ export interface RavnClientConfig {
     apiKey?: string;
     /** Default: https://app.ravn.exchange/api/v1 */
     baseUrl?: string;
-    /** Swap in your own fetch (e.g. for React Native, or a test double). Defaults to global fetch. */
+    /** Swap in your own fetch (e.g. for React Native, or a test double). Defaults to global fetch.
+     * Called as a plain function (no `this`): pass fetch itself, or a plain or bound wrapper. */
     fetch?: typeof fetch;
 }
 export declare class RavnClient {
@@ -29,8 +30,10 @@ export declare class RavnClient {
     }>;
     /** POST /v1/status: pass the quoteToken execute() returned (not the quote's own), and as `ref`
      * the execution's statusRef, submitSignature's statusRef, or the origin tx hash. POST, not GET:
-     * a 2-hop quoteToken in a query string can exceed header limits and fail with 431. */
-    getStatus(quoteToken: string, ref: string): Promise<StatusDTO>;
+     * a 2-hop quoteToken in a query string can exceed header limits and fail with 431. `txHash`:
+     * a two-hop route's hop-1 transaction, or the fee payment a DEPOSIT's `fee.transaction` asked
+     * for; it's how RAVN proves the fee your share is paid from. */
+    getStatus(quoteToken: string, ref: string, txHash?: string): Promise<StatusDTO>;
     /** GET /v1/tokens: RAVN's listed token registry for one chain. Not a per-pair routability guarantee. */
     getTokens(chainId: number): Promise<TokenDTO[]>;
     /** GET /v1/chains: every chain RAVN lists tokens for. Static; safe to cache client-side. */

package/dist/client.js

@@ -13,7 +13,10 @@ class RavnClient {
         this.fetchImpl = config.fetch ?? globalThis.fetch;
     }
     async request(path, init) {
-        const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+        // Called unbound, never as this.fetchImpl(...): a browser's own fetch (the default, or one
+        // passed in) throws "Illegal invocation" when `this` is the client, failing every call.
+        const fetchImpl = this.fetchImpl;
+        const res = await fetchImpl(`${this.baseUrl}${path}`, {
             ...init,
             headers: {
                 "content-type": "application/json",
@@ -62,11 +65,13 @@ class RavnClient {
     }
     /** POST /v1/status: pass the quoteToken execute() returned (not the quote's own), and as `ref`
      * the execution's statusRef, submitSignature's statusRef, or the origin tx hash. POST, not GET:
-     * a 2-hop quoteToken in a query string can exceed header limits and fail with 431. */
-    getStatus(quoteToken, ref) {
+     * a 2-hop quoteToken in a query string can exceed header limits and fail with 431. `txHash`:
+     * a two-hop route's hop-1 transaction, or the fee payment a DEPOSIT's `fee.transaction` asked
+     * for; it's how RAVN proves the fee your share is paid from. */
+    getStatus(quoteToken, ref, txHash) {
         return this.request("/status", {
             method: "POST",
-            body: JSON.stringify({ quoteToken, ref }),
+            body: JSON.stringify({ quoteToken, ref, ...(txHash ? { txHash } : {}) }),
         });
     }
     /** GET /v1/tokens: RAVN's listed token registry for one chain. Not a per-pair routability guarantee. */

package/dist/types.d.ts

@@ -180,7 +180,31 @@ export type ExecutionDTO = {
     };
     /** Poll getStatus with this, not `deposit.address`. */
     statusRef: string;
+    /** Only when your key sets a fee and the venue has no fee of its own (today Rift). Skip it
+     * and the swap still fills on `deposit.amount`; no fee is owed to you. */
+    fee?: DepositFeeDTO;
 };
+/** RAVN's integrator fee beside a deposit, in the input token, paid by your user to RAVN; your
+ * share is paid out as usual. `deposit.amount` already leaves it out. */
+export interface DepositFeeDTO {
+    /** Base units of the input token. */
+    amount: string;
+    /** RAVN's fee address on the input chain. */
+    address: string;
+    chainId: number;
+    /** EVM: send this transaction too, exactly as given and as a transaction of its own from the
+     * user's regular wallet (it names the order, which ties the fee to this swap; bundled into a
+     * smart-wallet batch it can't be proven, and nothing is owed on it), then pass its hash as
+     * `txHash` to getStatus once it has confirmed (simplest: on every poll). Absent on Bitcoin: pay `amount` to `address`
+     * as an extra output of the SAME transaction that pays the deposit; RAVN finds it there once
+     * that transaction confirms. */
+    transaction?: {
+        to: string;
+        data: string;
+        value: string;
+        chainId: number;
+    };
+}
 export type SettlementStatus = "pending" | "processing" | "expired" | "success" | "refunded" | "failed" | "not_found" | "unknown";
 export interface StatusDTO {
     status: SettlementStatus;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ravnexchange/sdk",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Typed client for the RAVN integrator API (/api/v1): quote, execute, submit-signature, status.",
   "keywords": ["ravn", "cross-chain", "swap", "swap-api", "dex-aggregator", "bitcoin", "native-btc", "solana", "evm", "crypto", "defi", "typescript", "sdk", "api-client"],
   "main": "./dist/index.js",