defi-dash-sdk 0.1.0

package/README.md

@@ -0,0 +1,210 @@
+# DeFi Dash SDK
+
+> Multi-protocol DeFi SDK for Sui blockchain - leverage strategies, flash loans, and lending protocols
+
+[![npm version](https://img.shields.io/npm/v/defi-dash-sdk.svg)](https://www.npmjs.com/package/defi-dash-sdk)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+
+## Features
+
+- 🔧 **Utility Functions** - Token formatting, coin type normalization
+- 🏦 **Protocol Wrappers** - Scallop, Suilend integration
+- 🔄 **Leverage Strategies** - One-click leverage long positions
+- ⚡ **Type-Safe** - Full TypeScript support
+
+---
+
+## Installation
+
+```bash
+npm install defi-dash-sdk
+# or
+yarn add defi-dash-sdk
+```
+
+---
+
+## Quick Start
+
+### 1. Basic Usage - Utility Functions
+
+```typescript
+import { formatUnits, parseUnits, normalizeCoinType } from 'defi-dash-sdk';
+
+// Format token amounts
+const humanReadable = formatUnits(1000000, 6); // "1" (USDC)
+const rawAmount = parseUnits("1.5", 6); // 1500000n
+
+// Normalize coin types
+const normalized = normalizeCoinType("0x2::sui::SUI");
+// "0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI"
+```
+
+### 2. Using Type Definitions
+
+```typescript
+import type { MarketReserve } from 'defi-dash-sdk';
+
+const reserve: MarketReserve = {
+  coinType: "0x2::sui::SUI",
+  id: "0x...",
+  decimals: 9,
+  symbol: "SUI"
+};
+```
+
+---
+
+## API Reference
+
+### Utilities
+
+#### `formatUnits(amount, decimals): string`
+
+Converts raw token amount to human-readable format.
+
+**Parameters:**
+
+- `amount` - Raw amount (string | number | bigint)
+- `decimals` - Token decimals (e.g., 6 for USDC, 9 for SUI)
+
+**Returns:** Formatted string with proper decimal placement
+
+**Example:**
+
+```typescript
+formatUnits(1500000, 6) // "1.5"
+formatUnits(1000000000, 9) // "1"
+```
+
+#### `parseUnits(amount, decimals): bigint`
+
+Converts human-readable amount to raw units.
+
+**Parameters:**
+
+- `amount` - Human-readable amount string
+- `decimals` - Token decimals
+
+**Returns:** Raw amount as bigint
+
+**Example:**
+
+```typescript
+parseUnits("1.5", 6) // 1500000n
+```
+
+#### `normalizeCoinType(coinType): string`
+
+Normalizes Sui coin type addresses (pads to 64 chars, ensures 0x prefix).
+
+#### `formatCoinType(type): string`
+
+Uses `normalizeStructTag` from `@mysten/sui` with fallback.
+
+---
+
+## Development
+
+This package is designed for both Node.js scripts and frontend applications.
+
+### For Testing Strategies
+
+Clone the repo to access example scripts:
+
+```bash
+git clone https://github.com/yourusername/defi-dash-sdk.git
+cd defi-dash-sdk
+npm install
+
+# Run example leverage strategy
+npm run test:suilend-leverage
+```
+
+### Building from Source
+
+```bash
+npm run build  # Compiles TypeScript to dist/
+```
+
+---
+
+## Architecture
+
+```
+defi-dash-sdk/
+├── src/
+│   ├── index.ts           # SDK entry point
+│   └── lib/
+│       ├── utils/         # Formatting & normalization
+│       ├── scallop/       # Flash loan wrapper
+│       └── suilend/       # Lending constants
+└── tests/                 # Integration examples
+```
+
+---
+
+## Examples
+
+### Using in a Frontend (React/Next.js)
+
+```typescript
+import { formatUnits, normalizeCoinType } from 'defi-dash-sdk';
+
+function TokenBalance({ amount, decimals, symbol }) {
+  const formatted = formatUnits(amount, decimals);
+
+  return <div>{formatted} {symbol}</div>;
+}
+```
+
+### Using in a Node.js Script
+
+```typescript
+import { parseUnits } from 'defi-dash-sdk';
+
+const depositAmount = parseUnits("100", 6); // 100 USDC
+console.log(`Depositing: ${depositAmount} raw units`);
+```
+
+---
+
+## Protocol Support
+
+| Protocol    | Type              | Status         |
+| ----------- | ----------------- | -------------- |
+| Scallop     | Flash Loans       | ✅ Supported   |
+| Suilend     | Lending/Borrowing | ✅ Supported   |
+| 7k Protocol | Swap Aggregator   | ✅ Supported   |
+| NAVI        | Lending           | 🚧 In Progress |
+
+---
+
+## Dependencies
+
+Core dependencies (automatically installed):
+
+- `@mysten/sui` - Sui blockchain SDK
+- `@suilend/sdk` - Suilend protocol
+- `@scallop-io/sui-scallop-sdk` - Scallop flash loans
+- `@7kprotocol/sdk-ts` - 7k swap aggregator
+
+---
+
+## Contributing
+
+Contributions are welcome! Please open an issue or PR.
+
+---
+
+## License
+
+ISC
+
+---
+
+## Links
+
+- [Documentation](#) (Coming Soon)
+- [GitHub Repository](#)
+- [Example Apps](#)

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DeFi Dash SDK
+ *
+ * Multi-protocol DeFi SDK for Sui blockchain integrating leverage strategies,
+ * flash loans, and lending protocols.
+ *
+ * @module defi-dash-sdk
+ */
+export * from "./lib/utils";
+export * from "./lib/scallop";
+export type { MarketReserve } from "./lib/suilend/const";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,aAAa,CAAC;AAG5B,cAAc,eAAe,CAAC;AAG9B,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * DeFi Dash SDK
+ *
+ * Multi-protocol DeFi SDK for Sui blockchain integrating leverage strategies,
+ * flash loans, and lending protocols.
+ *
+ * @module defi-dash-sdk
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Utility functions
+__exportStar(require("./lib/utils"), exports);
+// Protocol wrappers
+__exportStar(require("./lib/scallop"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,8CAA4B;AAE5B,oBAAoB;AACpB,gDAA8B"}

package/dist/lib/navi_calculations.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Navi Protocol Calculation Utilities
+ */
+export interface NaviPoolInfo {
+    coinType: string;
+    symbol: string;
+    decimals: number;
+    supplyApy: number;
+    borrowApy: number;
+    liquidationThreshold: number;
+    ltv: number;
+    totalSupply: number;
+    totalBorrow: number;
+    availableLiquidity: number;
+    utilizationRate: number;
+    rawPool: any;
+}
+export interface NaviUserPosition {
+    coinType: string;
+    symbol: string;
+    decimals: number;
+    price: number;
+    supplyAmount: number;
+    supplyValueUsd: number;
+    supplyApy: number;
+    borrowAmount: number;
+    borrowValueUsd: number;
+    borrowApy: number;
+    liquidationThreshold: number;
+    liquidationPrice: number;
+}
+export interface NaviAccountSummary {
+    positions: NaviUserPosition[];
+    totalSupplyValueUsd: number;
+    totalBorrowValueUsd: number;
+    totalCollateralValueUsd: number;
+    netWorthUsd: number;
+    healthFactor: number;
+    weightedSupplyApy: number;
+    weightedBorrowApy: number;
+    netApy: number;
+}
+export interface LeverageInfo {
+    maxLeverage: number;
+    safeLeverage: number;
+    targetLtv: number;
+}
+export declare function fetchNaviPoolData(): Promise<Map<string, NaviPoolInfo>>;
+export declare function fetchNaviUserData(userAddress: string, poolMap?: Map<string, NaviPoolInfo>): Promise<NaviUserPosition[]>;
+export declare function fetchNaviAccountSummary(userAddress: string, poolMap?: Map<string, NaviPoolInfo>): Promise<NaviAccountSummary>;
+export declare function calculateLeverageMultiplier(pool: NaviPoolInfo, safetyBuffer?: number, executionBuffer?: number): LeverageInfo;
+/**
+ * ```typescript
+ * const summary = await fetchNaviAccountSummary(address);
+ *
+ * // 전체 요약
+ * console.log("Health Factor:", summary.healthFactor);
+ * console.log("Net APY:", summary.netApy);
+ * console.log("Net Worth:", summary.netWorthUsd);
+ *
+ * // 각 position 정보
+ * for (const pos of summary.positions) {
+ *   console.log(`${pos.symbol}:`);
+ *   console.log(`  Supply: ${pos.supplyAmount} ($${pos.supplyValueUsd})`);
+ *   console.log(`  Borrow: ${pos.borrowAmount} ($${pos.borrowValueUsd})`);
+ *   console.log(`  Liquidation Price: $${pos.liquidationPrice}`);
+ * }
+ *
+ * // 레버리지 계산
+ * const poolMap = await fetchNaviPoolData();
+ * const suiPool = poolMap.get("0x2::sui::SUI");
+ * const leverage = calculateLeverageMultiplier(suiPool);
+ * console.log("Safe Leverage:", leverage.safeLeverage);
+ * ```
+ */
+//# sourceMappingURL=navi_calculations.d.ts.map

package/dist/lib/navi_calculations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navi_calculations.d.ts","sourceRoot":"","sources":["../../src/lib/navi_calculations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAiD5E;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA0D7B;AAED,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAkD7B;AAMD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,YAAY,EAClB,YAAY,GAAE,MAAa,EAC3B,eAAe,GAAE,MAAa,GAC7B,YAAY,CAed;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/lib/navi_calculations.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * Navi Protocol Calculation Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchNaviPoolData = fetchNaviPoolData;
+exports.fetchNaviUserData = fetchNaviUserData;
+exports.fetchNaviAccountSummary = fetchNaviAccountSummary;
+exports.calculateLeverageMultiplier = calculateLeverageMultiplier;
+const lending_1 = require("@naviprotocol/lending");
+const sdk_ts_1 = require("@7kprotocol/sdk-ts");
+// ============================================================================
+// Data Fetching Functions
+// ============================================================================
+async function fetchNaviPoolData() {
+    const pools = await (0, lending_1.getPools)({ env: "prod" });
+    const poolsArray = Array.isArray(pools) ? pools : Object.values(pools);
+    const poolMap = new Map();
+    for (const pool of poolsArray) {
+        const coinType = (0, lending_1.normalizeCoinType)(pool.coinType ?? pool.suiCoinType ?? "");
+        if (!coinType)
+            continue;
+        const decimals = pool.token?.decimals ?? 9;
+        const symbol = pool.token?.symbol ?? pool.symbol ?? "UNKNOWN";
+        const supplyApy = parseFloat(pool.supplyApy ?? pool.supplyIncentiveApyInfo?.apy ?? "0");
+        const borrowApy = parseFloat(pool.borrowApy ?? pool.borrowIncentiveApyInfo?.apy ?? "0");
+        const liquidationThreshold = parseFloat(pool.liquidationFactor?.threshold ?? "0.8");
+        // LTV is stored as scaled by 1e27 in Navi
+        const rawLtv = parseFloat(pool.ltv ?? "0");
+        const ltv = rawLtv > 1 ? rawLtv / 1e27 : rawLtv || 0.75;
+        const totalSupply = parseFloat(pool.totalSupply ?? "0") / Math.pow(10, decimals);
+        const totalBorrow = parseFloat(pool.totalBorrow ?? "0") / Math.pow(10, decimals);
+        poolMap.set(coinType, {
+            coinType,
+            symbol,
+            decimals,
+            supplyApy,
+            borrowApy,
+            liquidationThreshold,
+            ltv,
+            totalSupply,
+            totalBorrow,
+            availableLiquidity: totalSupply - totalBorrow,
+            utilizationRate: totalSupply > 0 ? totalBorrow / totalSupply : 0,
+            rawPool: pool,
+        });
+    }
+    return poolMap;
+}
+async function fetchNaviUserData(userAddress, poolMap) {
+    const lendingState = await (0, lending_1.getLendingState)(userAddress, { env: "prod" });
+    const pools = poolMap ?? (await fetchNaviPoolData());
+    // 1차: position 데이터 수집
+    const rawPositions = [];
+    for (const pos of lendingState) {
+        const coinType = (0, lending_1.normalizeCoinType)(pos.pool.coinType);
+        const pool = pools.get(coinType);
+        if (!pool)
+            continue;
+        const supplyBalance = BigInt(pos.supplyBalance);
+        const borrowBalance = BigInt(pos.borrowBalance);
+        if (supplyBalance <= 0n && borrowBalance <= 0n)
+            continue;
+        const price = await (0, sdk_ts_1.getTokenPrice)(coinType);
+        const supplyAmount = Number(supplyBalance) / Math.pow(10, pool.decimals);
+        const borrowAmount = Number(borrowBalance) / Math.pow(10, pool.decimals);
+        rawPositions.push({
+            coinType,
+            symbol: pool.symbol,
+            decimals: pool.decimals,
+            price,
+            supplyAmount,
+            supplyValueUsd: supplyAmount * price,
+            supplyApy: pool.supplyApy,
+            borrowAmount,
+            borrowValueUsd: borrowAmount * price,
+            borrowApy: pool.borrowApy,
+            liquidationThreshold: pool.liquidationThreshold,
+        });
+    }
+    // 2차: 전체 borrow 합계 계산
+    const totalBorrowValueUsd = rawPositions.reduce((sum, p) => sum + p.borrowValueUsd, 0);
+    // 3차: 각 position에 liquidationPrice 계산
+    const positions = rawPositions.map((pos) => {
+        // liquidationPrice = totalBorrowValueUsd / (supplyAmount * liquidationThreshold)
+        let liquidationPrice = 0;
+        if (pos.supplyAmount > 0 && pos.liquidationThreshold > 0) {
+            liquidationPrice =
+                totalBorrowValueUsd / (pos.supplyAmount * pos.liquidationThreshold);
+        }
+        return {
+            ...pos,
+            liquidationPrice,
+        };
+    });
+    return positions;
+}
+async function fetchNaviAccountSummary(userAddress, poolMap) {
+    const pools = poolMap ?? (await fetchNaviPoolData());
+    const positions = await fetchNaviUserData(userAddress, pools);
+    let totalSupplyValueUsd = 0;
+    let totalBorrowValueUsd = 0;
+    let totalCollateralValueUsd = 0;
+    let weightedSupplyApy = 0;
+    let weightedBorrowApy = 0;
+    for (const pos of positions) {
+        totalSupplyValueUsd += pos.supplyValueUsd;
+        totalBorrowValueUsd += pos.borrowValueUsd;
+        totalCollateralValueUsd += pos.supplyValueUsd * pos.liquidationThreshold;
+        weightedSupplyApy += pos.supplyApy * pos.supplyValueUsd;
+        weightedBorrowApy += pos.borrowApy * pos.borrowValueUsd;
+    }
+    if (totalSupplyValueUsd > 0) {
+        weightedSupplyApy = weightedSupplyApy / totalSupplyValueUsd;
+    }
+    if (totalBorrowValueUsd > 0) {
+        weightedBorrowApy = weightedBorrowApy / totalBorrowValueUsd;
+    }
+    const netWorthUsd = totalSupplyValueUsd - totalBorrowValueUsd;
+    const healthFactor = totalBorrowValueUsd > 0
+        ? totalCollateralValueUsd / totalBorrowValueUsd
+        : 999;
+    // Net APY 계산
+    let netApy = 0;
+    if (netWorthUsd > 0) {
+        const supplyInterest = totalSupplyValueUsd * (weightedSupplyApy / 100);
+        const borrowInterest = totalBorrowValueUsd * (weightedBorrowApy / 100);
+        netApy = ((supplyInterest - borrowInterest) / netWorthUsd) * 100;
+    }
+    return {
+        positions,
+        totalSupplyValueUsd,
+        totalBorrowValueUsd,
+        totalCollateralValueUsd,
+        netWorthUsd,
+        healthFactor,
+        weightedSupplyApy,
+        weightedBorrowApy,
+        netApy,
+    };
+}
+// ============================================================================
+// Leverage Calculation (Pool 기반)
+// ============================================================================
+function calculateLeverageMultiplier(pool, safetyBuffer = 0.05, executionBuffer = 0.95) {
+    const targetLtv = pool.liquidationThreshold - safetyBuffer;
+    if (targetLtv >= 1 || targetLtv <= 0) {
+        return { maxLeverage: 1, safeLeverage: 1, targetLtv: 0 };
+    }
+    const theoreticalMax = 1 / (1 - targetLtv);
+    const safeLeverage = theoreticalMax * executionBuffer;
+    return {
+        maxLeverage: Number(theoreticalMax.toFixed(2)),
+        safeLeverage: Number(safeLeverage.toFixed(2)),
+        targetLtv: Number(targetLtv.toFixed(4)),
+    };
+}
+// ============================================================================
+// Example Usage
+// ============================================================================
+/**
+ * ```typescript
+ * const summary = await fetchNaviAccountSummary(address);
+ *
+ * // 전체 요약
+ * console.log("Health Factor:", summary.healthFactor);
+ * console.log("Net APY:", summary.netApy);
+ * console.log("Net Worth:", summary.netWorthUsd);
+ *
+ * // 각 position 정보
+ * for (const pos of summary.positions) {
+ *   console.log(`${pos.symbol}:`);
+ *   console.log(`  Supply: ${pos.supplyAmount} ($${pos.supplyValueUsd})`);
+ *   console.log(`  Borrow: ${pos.borrowAmount} ($${pos.borrowValueUsd})`);
+ *   console.log(`  Liquidation Price: $${pos.liquidationPrice}`);
+ * }
+ *
+ * // 레버리지 계산
+ * const poolMap = await fetchNaviPoolData();
+ * const suiPool = poolMap.get("0x2::sui::SUI");
+ * const leverage = calculateLeverageMultiplier(suiPool);
+ * console.log("Safe Leverage:", leverage.safeLeverage);
+ * ```
+ */
+//# sourceMappingURL=navi_calculations.js.map

package/dist/lib/navi_calculations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navi_calculations.js","sourceRoot":"","sources":["../../src/lib/navi_calculations.ts"],"names":[],"mappings":"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"}

package/dist/lib/scallop/flash-loan-client.d.ts

@@ -0,0 +1,88 @@
+import { Transaction } from "@mysten/sui/transactions";
+/**
+ * Scallop Protocol Addresses
+ * Default: fetched from https://sui.apis.scallop.io/addresses/{addressId}
+ * Can be overridden via constructor
+ */
+export interface ScallopCoreIds {
+    protocolPkg: string;
+    version: string;
+    market: string;
+    coinDecimalsRegistry: string;
+    xOracle?: string;
+}
+export interface ScallopCoinTypes {
+    [coinName: string]: string;
+}
+export interface ScallopFlashLoanClientOptions {
+    /** Override default protocol package ID */
+    protocolPkg?: string;
+    /** Override default version object ID */
+    version?: string;
+    /** Override default market object ID */
+    market?: string;
+    /** Additional coin types to add/override */
+    coinTypes?: ScallopCoinTypes;
+    /** Full override of core IDs */
+    coreIds?: Partial<ScallopCoreIds>;
+}
+type TransactionArg = ReturnType<Transaction["splitCoins"]>;
+/**
+ * Custom Scallop Flash Loan Client
+ *
+ * Allows you to use default addresses from API or override them locally.
+ * This is useful when the SDK's addresses are outdated.
+ *
+ * @example
+ * ```ts
+ * // Use defaults
+ * const client = new ScallopFlashLoanClient();
+ *
+ * // Override protocol package (when SDK is outdated)
+ * const client = new ScallopFlashLoanClient({
+ *   protocolPkg: "0x...",
+ * });
+ * ```
+ */
+export declare class ScallopFlashLoanClient {
+    private coreIds;
+    private coinTypes;
+    constructor(options?: ScallopFlashLoanClientOptions);
+    /**
+     * Get coin type from coin name
+     */
+    getCoinType(coinName: string): string;
+    /**
+     * Get current core IDs (for debugging)
+     */
+    getCoreIds(): ScallopCoreIds;
+    /**
+     * Borrow a flash loan from Scallop
+     *
+     * @param tx - Sui Transaction object
+     * @param amount - Amount to borrow (in smallest unit)
+     * @param coinName - Coin name (e.g., 'sui', 'usdc')
+     * @returns [loanCoin, receipt] - The borrowed coin and flash loan receipt
+     */
+    borrowFlashLoan(tx: Transaction, amount: number | bigint, coinName: string): [TransactionArg, TransactionArg];
+    /**
+     * Repay a flash loan to Scallop
+     *
+     * @param tx - Sui Transaction object
+     * @param coin - The coin to repay (must include fee)
+     * @param receipt - The flash loan receipt (Hot Potato)
+     * @param coinName - Coin name (e.g., 'sui', 'usdc')
+     */
+    repayFlashLoan(tx: Transaction, coin: TransactionArg, receipt: TransactionArg, coinName: string): void;
+    /**
+     * Calculate flash loan fee (0.05% = 5 basis points)
+     */
+    static calculateFee(amount: bigint): bigint;
+    /**
+     * Fetch latest addresses from Scallop API
+     * Use this to update the client when SDK is outdated
+     */
+    static fetchFromAPI(addressId?: string): Promise<ScallopCoreIds>;
+}
+export default ScallopFlashLoanClient;
+//# sourceMappingURL=flash-loan-client.d.ts.map

package/dist/lib/scallop/flash-loan-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flash-loan-client.d.ts","sourceRoot":"","sources":["../../../src/lib/scallop/flash-loan-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAmCD,MAAM,WAAW,6BAA6B;IAC5C,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AAED,KAAK,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,GAAE,6BAAkC;IAkBvD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQrC;;OAEG;IACH,UAAU,IAAI,cAAc;IAI5B;;;;;;;OAOG;IACH,eAAe,CACb,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,CAAC,cAAc,EAAE,cAAc,CAAC;IAanC;;;;;;;OAOG;IACH,cAAc,CACZ,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,IAAI;IAgBP;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAM3C;;;OAGG;WACU,YAAY,CACvB,SAAS,GAAE,MAAmC,GAC7C,OAAO,CAAC,cAAc,CAAC;CAc3B;AAED,eAAe,sBAAsB,CAAC"}