@ravnexchange/sdk 0.1.7 → 0.1.9

package/dist/client.d.ts

@@ -21,8 +21,9 @@ export declare class RavnClient {
     submitSignature(params: SubmitSignatureParams): Promise<{
         statusRef: string;
     }>;
-    /** GET /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 /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>;
     /** GET /v1/tokens: RAVN's listed token registry for one chain. Not a per-pair routability guarantee. */
     getTokens(chainId: number): Promise<TokenDTO[]>;

package/dist/client.js

@@ -51,11 +51,14 @@ class RavnClient {
             body: JSON.stringify(params),
         });
     }
-    /** GET /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 /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) {
-        const qs = new URLSearchParams({ quoteToken, ref }).toString();
-        return this.request(`/status?${qs}`, { method: "GET" });
+        return this.request("/status", {
+            method: "POST",
+            body: JSON.stringify({ quoteToken, ref }),
+        });
     }
     /** GET /v1/tokens: RAVN's listed token registry for one chain. Not a per-pair routability guarantee. */
     getTokens(chainId) {

package/dist/types.d.ts

@@ -52,6 +52,9 @@ export interface QuoteDTO {
     outputUsd: string | null;
     estimatedTimeSeconds: number;
     estimatedTimeIsGuess: boolean;
+    /** Epoch ms: execute() on `quoteToken` must reach RAVN before this, or it fails with
+     * QUOTE_EXPIRED. Already 5 s ahead of the venue's own deadline, so compare it to the clock as
+     * is. 0 means no deadline. A 2-hop route (`venue.id === "compose"`) re-prices at execute instead. */
     expiresAt: number;
     /** Present on 2-hop (`venue.id === "compose"`) and Relay dest-call quotes. Sign hop 1; hop 2 is
      * a unique deposit, not a second wallet tx. */
@@ -82,6 +85,9 @@ export interface AlternativeQuoteDTO {
     executable: boolean;
     estimatedTimeSeconds: number;
     estimatedTimeIsGuess: boolean;
+    /** This route's own execute deadline, same meaning as QuoteDTO.expiresAt. Venues differ, so
+     * check it before executing an alternative. */
+    expiresAt: number;
     hops?: {
         id: string;
         name: string;
@@ -192,14 +198,28 @@ export interface GetQuoteParams {
     rankingMode?: "best_output" | "fastest";
     /** Drop specific venues from this race, e.g. a risk objection to one of them. */
     excludeVenues?: string[];
+    /** Settle privately: the race narrows to NEAR Intents (Confidential Intents) and Houdini Swap,
+     * and NO_LIQUIDITY replaces a public fill if neither can quote. Houdini is sent the request's IP,
+     * user-agent and clientTimezone for compliance screening; its terms bar US persons and
+     * sanctioned jurisdictions, and you own your users' eligibility (excludeVenues: ["houdini"]). */
+    confidential?: boolean;
+    /** Your end user's IANA timezone (e.g. "Europe/Berlin"), forwarded only to Houdini. Default UTC. */
+    clientTimezone?: string;
+    /** Optional analytics handle: send the same value while re-pricing one swap so it counts as one
+     * intent. Never affects pricing, routing or fees. Max 64 chars. */
+    quoteSessionId?: string;
     /** Test quote -> execute -> status with no real funds and no live venue settlement. See
      * the API's own sandbox field description for per-venue/per-route exceptions. */
     sandbox?: boolean;
 }
 export interface ExecuteParams {
     quoteToken: string;
+    /** Only venues that bind the recipient at execute (Chainflip, Houdini Swap, Layerswap, Mayan,
+     * NEAR Intents, Rift) accept a new one; elsewhere a different address is INVALID_REQUEST. */
     destinationAddress?: string;
     refundAddress?: string;
+    /** Your end user's IANA timezone, forwarded only to Houdini. Default UTC. */
+    clientTimezone?: string;
 }
 export interface SubmitSignatureParams {
     quoteToken: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ravnexchange/sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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",