@ember-finance/sdk 2.18.0 → 2.19.0

package/dist/src/placements/api.d.ts

@@ -0,0 +1,13 @@
+import { VaultsApi } from "../api/v2/index.js";
+/**
+ * The generated vaults client, on the fetch adapter so this module keeps one
+ * transport in the browser and in Node.
+ */
+export declare function vaultsApi(baseUrl: string): VaultsApi;
+/** Status and Retry-After of a failed call, or undefined when no response came back. */
+export declare function httpFailure(error: unknown): {
+    status: number;
+    retryAfter?: string;
+} | undefined;
+/** True for a transport failure (no response), which is worth retrying. */
+export declare function isNetworkError(error: unknown): boolean;

package/dist/src/placements/api.js

@@ -0,0 +1,26 @@
+import axios from "axios";
+import { Configuration, VaultsApi } from "../api/v2/index.js";
+/**
+ * The generated vaults client, on the fetch adapter so this module keeps one
+ * transport in the browser and in Node.
+ */
+export function vaultsApi(baseUrl) {
+    return new VaultsApi(new Configuration({
+        basePath: baseUrl.replace(/\/$/, ""),
+        baseOptions: { adapter: "fetch" }
+    }));
+}
+/** Status and Retry-After of a failed call, or undefined when no response came back. */
+export function httpFailure(error) {
+    if (!axios.isAxiosError(error) || !error.response)
+        return undefined;
+    const retryAfter = error.response.headers?.["retry-after"];
+    return {
+        status: error.response.status,
+        retryAfter: typeof retryAfter === "string" ? retryAfter : undefined
+    };
+}
+/** True for a transport failure (no response), which is worth retrying. */
+export function isNetworkError(error) {
+    return axios.isAxiosError(error) && !error.response && !axios.isCancel(error);
+}

package/dist/src/placements/pointers.d.ts

@@ -10,7 +10,6 @@ export interface HttpPointerSourceOptions {
     env?: PlatformEnv;
     /** Overrides `env` entirely. For a local deployment, or a proxy. */
     baseUrl?: string;
-    path?: string;
     /** How long a coin's rows may be reused, in milliseconds. Default 30s. */
     cacheMs?: number;
 }

package/dist/src/placements/pointers.js

@@ -1,5 +1,6 @@
 import { environmentConfig } from "../common/constants.js";
-import { isAbortError, isTransientStatus, retryAfterMs } from "./batch.js";
+import { httpFailure, isNetworkError, vaultsApi } from "./api.js";
+import { isTransientStatus, retryAfterMs } from "./batch.js";
 import { coinTypesMatch, normalizeCoinType } from "./sui.js";
 /**
  * Pointers held in memory. Useful for tests, and for pinning a known venue set
@@ -33,7 +34,7 @@ export function httpPointerSource(options = {}) {
     // makes, not to cache across a session: pointers change when a venue is
     // added, and a long window would keep a new one invisible.
     const baseUrl = options.baseUrl ?? environmentConfig[options.env ?? "prod"].apiHost;
-    const path = options.path ?? "/api/v2/vaults/placements";
+    const api = vaultsApi(baseUrl);
     const cacheMs = options.cacheMs ?? 30000;
     /**
      * One request for every coin. The endpoint answers with the whole registry
@@ -59,12 +60,7 @@ export function httpPointerSource(options = {}) {
         inFlight.set(key, { at: Date.now(), rows });
         return rows;
     };
-    const request = (coin) => {
-        const url = new URL(`${baseUrl.replace(/\/$/, "")}${path}`);
-        if (coin !== undefined)
-            url.searchParams.set("coin", coin);
-        return fetchPlacements(url.toString());
-    };
+    const request = (coin) => fetchPlacements(api, coin);
     const rowsFor = async (coin) => {
         if (Date.now() >= perCoinUntil) {
             try {
@@ -139,34 +135,31 @@ const FALLBACK_RECHECK_MS = 5 * 60000;
  * Retries transient failures. Every vault's venues now ride on this one
  * request, and callers keep a failed discover rather than retrying it.
  */
-async function fetchPlacements(url) {
+async function fetchPlacements(api, coin) {
     for (let attempt = 1;; attempt++) {
         let waitMs;
         try {
-            const response = await fetch(url, {
-                headers: { Accept: "application/json" }
-            });
-            if (response.ok) {
-                const body = (await response.json());
-                return body.placements ?? [];
-            }
-            if (!isTransientStatus(response.status) || attempt >= FETCH_ATTEMPTS) {
-                throw new PointerSourceError(response.status);
-            }
-            waitMs = retryAfterMs(response.headers?.get("retry-after"));
-            // Retrying before the server asked would only add to the load it
-            // is shedding and fail again.
-            if (waitMs !== undefined && waitMs > RETRY_MAX_MS) {
-                throw new PointerSourceError(response.status);
-            }
+            const { data } = await api.getCoinPlacements(coin);
+            return data.placements ?? [];
         }
         catch (error) {
-            // fetch rejects only on network failure; retry that, not our own
-            // errors or an abort.
-            if (error instanceof PointerSourceError ||
-                isAbortError(error) ||
-                attempt >= FETCH_ATTEMPTS) {
-                throw error;
+            const failure = httpFailure(error);
+            if (!failure) {
+                // Only a transport failure is worth retrying, not an abort or a
+                // bug of our own.
+                if (!isNetworkError(error) || attempt >= FETCH_ATTEMPTS)
+                    throw error;
+            }
+            else {
+                if (!isTransientStatus(failure.status) || attempt >= FETCH_ATTEMPTS) {
+                    throw new PointerSourceError(failure.status);
+                }
+                waitMs = retryAfterMs(failure.retryAfter);
+                // Retrying before the server asked would only add to the load it
+                // is shedding and fail again.
+                if (waitMs !== undefined && waitMs > RETRY_MAX_MS) {
+                    throw new PointerSourceError(failure.status);
+                }
             }
         }
         const backoff = Math.min(RETRY_BASE_MS * 2 ** (attempt - 1), RETRY_MAX_MS);

package/dist/src/placements/vaults.js

@@ -1,4 +1,5 @@
 import { environmentConfig } from "../common/constants.js";
+import { httpFailure, vaultsApi } from "./api.js";
 /**
  * Resolves a vault to the receipt coins it issues, from the vaults API.
  *
@@ -6,14 +7,17 @@ import { environmentConfig } from "../common/constants.js";
  * each, so this returns one entry per chain rather than assuming a single coin.
  */
 export function httpVaultCoinsResolver(options = {}) {
-    const baseUrl = (options.baseUrl ?? environmentConfig[options.env ?? "prod"].apiHost).replace(/\/$/, "");
-    const get = async (path) => {
-        const response = await fetch(`${baseUrl}${path}`, {
-            headers: { Accept: "application/json" }
-        });
-        if (!response.ok)
-            throw new Error(`vaults api ${response.status} for ${path}`);
-        return (await response.json());
+    const api = vaultsApi(options.baseUrl ?? environmentConfig[options.env ?? "prod"].apiHost);
+    const get = async (path, call) => {
+        try {
+            return (await call()).data;
+        }
+        catch (error) {
+            const failure = httpFailure(error);
+            if (failure)
+                throw new Error(`vaults api ${failure.status} for ${path}`);
+            throw error;
+        }
     };
     // The chain catalogue is what carries the EVM network id. Without it an EVM
     // coin has no chainId, and every read for it fails rather than returning a
@@ -22,7 +26,7 @@ export function httpVaultCoinsResolver(options = {}) {
     const chainRefs = () => {
         if (chains)
             return chains;
-        chains = get("/api/v2/vaults/supported-chains").then(supported => {
+        chains = get("/api/v2/vaults/supported-chains", () => api.getSupportedChains()).then(supported => {
             const byIdentifier = new Map();
             for (const chain of supported) {
                 if (!chain.identifier)
@@ -51,10 +55,10 @@ export function httpVaultCoinsResolver(options = {}) {
     return {
         async coinsForVault(vaultId) {
             const [vaults, catalogue] = await Promise.all([
-                get(`/api/v2/vaults?vaultId=${encodeURIComponent(vaultId)}`),
+                get(`/api/v2/vaults?vaultId=${vaultId}`, () => api.getVaults(vaultId)),
                 chainRefs()
             ]);
-            const list = Array.isArray(vaults) ? vaults : [vaults];
+            const list = vaults;
             const vault = list.find(v => v.id === vaultId) ?? list[0];
             if (!vault)
                 throw new Error(`vault ${vaultId} not found`);

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@ember-finance/sdk",
     "description": "Ember Protocol SDK",
-    "version": "2.18.0",
+    "version": "2.19.0",
     "type": "module",
     "module": "./dist/index.js",
     "main": "./dist/index.js",