@augustdigital/sdk 7.0.1 → 8.2.0

package/lib/services/swap-quotes/paraswap.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARASWAP_DEFAULTS = void 0;
+exports.fetchParaswapQuote = fetchParaswapQuote;
+const errors_1 = require("../../core/errors");
+const web3_1 = require("../../core/helpers/web3");
+const PARASWAP_PRICES_URL = 'https://api.paraswap.io/prices';
+const PARASWAP_TRANSACTIONS_BASE_URL = 'https://api.paraswap.io/transactions';
+const DEFAULT_PARTNER = 'august';
+const DEFAULT_PARTNER_ADDRESS = '0xb60ee0FA5B6bA917255A03e744967E0Bda531dD0';
+const PARASWAP_VERSION = '6.2';
+const BPS_DENOMINATOR = 10000n;
+async function fetchParaswapQuote(input) {
+    const priceRoute = await getPriceRoute(input);
+    const destAmountRaw = priceRoute.destAmount;
+    if (typeof destAmountRaw !== 'string' || !/^\d+$/.test(destAmountRaw)) {
+        throw new errors_1.AugustServerError(200, `fetchSwapQuote: Paraswap /prices returned non-numeric destAmount: ${String(destAmountRaw)}`, { context: { destAmount: destAmountRaw } });
+    }
+    const expectedAmountOut = BigInt(destAmountRaw);
+    const { router, payload } = await getTransactionData(input, priceRoute);
+    return { router, payload, expectedAmountOut, fetchedAt: Date.now() };
+}
+async function getPriceRoute(input) {
+    const params = new URLSearchParams({
+        network: String(input.chainId),
+        srcToken: input.srcToken,
+        srcDecimals: String(input.srcDecimals),
+        destToken: input.destToken,
+        destDecimals: String(input.destDecimals),
+        amount: input.amount.toString(),
+        partner: input.partner,
+        partnerAddress: input.partnerAddress,
+        version: PARASWAP_VERSION,
+    });
+    const url = `${PARASWAP_PRICES_URL}?${params.toString()}`;
+    let response;
+    try {
+        response = await input.fetchImpl(url, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+            signal: input.signal,
+        });
+    }
+    catch (cause) {
+        throw new errors_1.AugustNetworkError('fetchSwapQuote: Paraswap /prices fetch failed', { cause, context: { url } });
+    }
+    if (!response.ok) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /prices returned HTTP ${response.status}`, { context: { url } });
+    }
+    const body = (await response.json());
+    if (body.error) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /prices error: ${body.error}`, { context: { providerError: body.error } });
+    }
+    if (!body.priceRoute) {
+        throw new errors_1.AugustServerError(response.status, 'fetchSwapQuote: Paraswap /prices returned no priceRoute', { context: { body } });
+    }
+    return body.priceRoute;
+}
+async function getTransactionData(input, priceRoute) {
+    const url = `${PARASWAP_TRANSACTIONS_BASE_URL}/${input.chainId}/?ignoreChecks=true&ignoreGasEstimate=true&onlyParams=false`;
+    const expectedDestAmount = BigInt(priceRoute.destAmount);
+    const minDestAmount = (expectedDestAmount * (BPS_DENOMINATOR - BigInt(input.slippageBps))) /
+        BPS_DENOMINATOR;
+    const requestBody = {
+        userAddress: input.receiver,
+        srcToken: input.srcToken,
+        destToken: input.destToken,
+        srcDecimals: input.srcDecimals,
+        destDecimals: input.destDecimals,
+        srcAmount: input.amount.toString(),
+        destAmount: minDestAmount.toString(),
+        priceRoute,
+        partner: input.partner,
+        partnerAddress: input.partnerAddress,
+    };
+    let response;
+    try {
+        response = await input.fetchImpl(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(requestBody),
+            signal: input.signal,
+        });
+    }
+    catch (cause) {
+        throw new errors_1.AugustNetworkError('fetchSwapQuote: Paraswap /transactions fetch failed', { cause, context: { url } });
+    }
+    if (!response.ok) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /transactions returned HTTP ${response.status}`, { context: { url } });
+    }
+    const body = (await response.json());
+    if (body.error) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /transactions error: ${body.error}`, { context: { providerError: body.error } });
+    }
+    if (!body.to || !body.data) {
+        throw new errors_1.AugustServerError(response.status, 'fetchSwapQuote: Paraswap /transactions returned no to/data', { context: { body } });
+    }
+    if (!(0, web3_1.checkAddress)(body.to, console, 'contract')) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /transactions returned an invalid router address: ${body.to}`, { context: { to: body.to } });
+    }
+    if (!/^0x[0-9a-fA-F]+$/.test(body.data) || body.data.length % 2 !== 0) {
+        throw new errors_1.AugustServerError(response.status, `fetchSwapQuote: Paraswap /transactions returned malformed calldata (${body.data.length} chars)`, { context: { dataPrefix: body.data.slice(0, 16) } });
+    }
+    if (body.data.length < 10) {
+        throw new errors_1.AugustValidationError('INVALID_INPUT', 'fetchSwapQuote: Paraswap /transactions returned calldata shorter than a 4-byte selector');
+    }
+    return {
+        router: body.to,
+        payload: body.data,
+    };
+}
+exports.PARASWAP_DEFAULTS = {
+    partner: DEFAULT_PARTNER,
+    partnerAddress: DEFAULT_PARTNER_ADDRESS,
+};
+//# sourceMappingURL=paraswap.js.map

package/lib/types/vaults.d.ts

@@ -22,6 +22,17 @@ export interface IVaultLoan {
     isIdleCapital: boolean;
     allocation: number;
 }
+export interface IVaultBorrowerHealthFactor {
+    borrower: IAddress;
+    loan: IAddress;
+    health_factor?: {
+        datetime: string;
+        health_factor: number;
+        id: string;
+        total_collateral_value: number;
+        total_loan_value: number;
+    };
+}
 export type IVaultUserHistoryItem = {
     timestamp: number;
     address: IAddress;
@@ -321,3 +332,32 @@ export interface IVaultMetadataItem {
     address: string;
 }
 export type IVaultMetadata = Record<string, IVaultMetadataItem>;
+export declare enum SwapRouterVaultType {
+    ERC4626 = 1,
+    TokenizedVaultV2 = 2
+}
+export interface ISwapParams {
+    tokenIn: IAddress;
+    tokenOut: IAddress;
+    amountIn: bigint;
+    minAmountOut: bigint;
+    router: IAddress;
+    payload: `0x${string}`;
+}
+export interface ISwapRouterBaseOptions {
+    chainId: number;
+    vault: IAddress;
+    receiver: IAddress;
+    originCode?: `0x${string}`;
+    wait?: boolean;
+}
+export interface ISwapAndDepositOptions extends ISwapRouterBaseOptions {
+    swaps: ISwapParams[];
+}
+export interface ISwapRouterDirectDepositOptions extends ISwapRouterBaseOptions {
+    asset: IAddress;
+    amount: bigint;
+}
+export interface ISwapRouterNativeDepositOptions extends ISwapRouterBaseOptions {
+    amount: bigint;
+}

package/lib/types/vaults.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VaultRedemptionStatus = void 0;
+exports.SwapRouterVaultType = exports.VaultRedemptionStatus = void 0;
 var VaultRedemptionStatus;
 (function (VaultRedemptionStatus) {
     VaultRedemptionStatus["AWAITING_COOLDOWN"] = "awaiting_cooldown";
     VaultRedemptionStatus["READY_TO_CLAIM"] = "ready_to_claim";
 })(VaultRedemptionStatus || (exports.VaultRedemptionStatus = VaultRedemptionStatus = {}));
+var SwapRouterVaultType;
+(function (SwapRouterVaultType) {
+    SwapRouterVaultType[SwapRouterVaultType["ERC4626"] = 1] = "ERC4626";
+    SwapRouterVaultType[SwapRouterVaultType["TokenizedVaultV2"] = 2] = "TokenizedVaultV2";
+})(SwapRouterVaultType || (exports.SwapRouterVaultType = SwapRouterVaultType = {}));
 //# sourceMappingURL=vaults.js.map

package/lib/types/web3.d.ts

@@ -22,7 +22,6 @@ export type IInfuraOptions = {
 };
 export type ISolanaNetwork = 'devnet' | 'mainnet-beta' | 'testnet' | 'localnet';
 export type IStellarNetwork = 'mainnet' | 'testnet';
-export type StellarNetwork = IStellarNetwork;
 export interface ISolanaConfig {
     rpcUrl: string;
     network: ISolanaNetwork;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@augustdigital/sdk",
-  "version": "7.0.1",
+  "version": "8.2.0",
   "main": "lib/index.js",
   "keywords": [
     "augustdigital",