defi-dash-sdk 0.1.3 → 0.1.4

package/dist/__tests__/sdk.preview.unit.test.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * SDK Method: sdk.previewLeverage()  [Unit]
+ *
+ * Tests previewLeverage() with mocked dependencies. No mainnet RPC.
+ *
+ * Mocked internal dependencies:
+ *   - protocol.getAssetRiskParams()  → returns { ltv: 0.75, maxMultiplier: 4.0 }
+ *   - protocol.getAssetApy()         → returns mock supply/borrow APY
+ *   - ScallopFlashLoanClient         → returns 0% fee
+ *   - 7k Protocol swap quote         → returns mock swap output
+ *   - getTokenPrice()                → returns $3.50
+ *
+ * Integration test counterpart: sdk.preview.test.ts
+ *
+ * Run: npx vitest run src/__tests__/sdk.preview.unit.test.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const leverage_preview_1 = require("../strategies/leverage-preview");
+const types_1 = require("../types");
+// ── Mock helpers ─────────────────────────────────────────────────────────────
+function createMockDeps(overrides = {}) {
+    const mockProtocol = {
+        name: "mock",
+        consumesRepaymentCoin: false,
+        getAssetRiskParams: vitest_1.vi.fn().mockResolvedValue({
+            ltv: 0.75,
+            liquidationThreshold: 0.80,
+            liquidationBonus: 0.05,
+            maxMultiplier: 4.0,
+        }),
+        getAssetApy: vitest_1.vi.fn().mockImplementation(async (coinType) => {
+            if (coinType === types_1.COIN_TYPES.USDC) {
+                return {
+                    supplyApy: 0.03,
+                    rewardApy: 0,
+                    totalSupplyApy: 0.03,
+                    borrowApy: 0.05,
+                    borrowRewardApy: 0.01,
+                };
+            }
+            return {
+                supplyApy: 0.02,
+                rewardApy: 0.01,
+                totalSupplyApy: 0.03,
+                borrowApy: 0,
+                borrowRewardApy: 0,
+            };
+        }),
+        initialize: vitest_1.vi.fn(),
+        getPosition: vitest_1.vi.fn(),
+        deposit: vitest_1.vi.fn(),
+        withdraw: vitest_1.vi.fn(),
+        borrow: vitest_1.vi.fn(),
+        repay: vitest_1.vi.fn(),
+        refreshOracles: vitest_1.vi.fn(),
+        getAccountPortfolio: vitest_1.vi.fn(),
+    };
+    const mockSwapClient = {
+        quote: vitest_1.vi.fn().mockResolvedValue([
+            { amountOut: "4500000000", amountIn: "100000000", route: [] }, // 4.5 SUI for $100
+        ]),
+    };
+    return {
+        protocol: mockProtocol,
+        swapClient: mockSwapClient,
+        suiClient: {},
+        ...overrides,
+    };
+}
+// Mock external dependencies
+vitest_1.vi.mock("@7kprotocol/sdk-ts", () => ({
+    MetaAg: vitest_1.vi.fn(),
+    getTokenPrice: vitest_1.vi.fn().mockResolvedValue(3.5), // SUI at $3.50
+}));
+vitest_1.vi.mock("../protocols/scallop/flash-loan", () => ({
+    ScallopFlashLoanClient: {
+        fetchFlashLoanFeeRate: vitest_1.vi.fn().mockResolvedValue(0), // 0% flash loan fee
+        calculateFee: vitest_1.vi.fn().mockReturnValue(0n),
+    },
+}));
+vitest_1.vi.mock("../utils/coin", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        getDecimals: vitest_1.vi.fn().mockReturnValue(9),
+    };
+});
+// ── Tests ────────────────────────────────────────────────────────────────────
+(0, vitest_1.describe)("previewLeverage (unit)", () => {
+    (0, vitest_1.it)("calculates correct position metrics for 2x leverage", async () => {
+        const deps = createMockDeps();
+        const result = await (0, leverage_preview_1.previewLeverage)({
+            coinType: types_1.COIN_TYPES.SUI,
+            depositValueUsd: 100,
+            multiplier: 2.0,
+        }, deps);
+        // Basic sanity
+        (0, vitest_1.expect)(result.initialEquityUsd).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.totalPositionUsd).toBeCloseTo(result.initialEquityUsd * 2.0, 0);
+        (0, vitest_1.expect)(result.debtUsd).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.flashLoanUsdc).toBeGreaterThan(0n);
+        // Risk params from mock
+        (0, vitest_1.expect)(result.assetLtv).toBe(0.75);
+        (0, vitest_1.expect)(result.maxMultiplier).toBe(4.0);
+        (0, vitest_1.expect)(result.liquidationThreshold).toBe(0.80);
+        // LTV should be reasonable
+        (0, vitest_1.expect)(result.ltvPercent).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.ltvPercent).toBeLessThan(100);
+        // Liquidation price should be positive and below current price
+        (0, vitest_1.expect)(result.liquidationPrice).toBeGreaterThan(0);
+        (0, vitest_1.expect)(result.priceDropBuffer).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)("flash loan amount scales with multiplier", async () => {
+        const deps = createMockDeps();
+        const preview2x = await (0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 2.0 }, deps);
+        const preview3x = await (0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 3.0 }, deps);
+        // 3x needs 2x the flash loan of 2x (since flashLoanUsd = equity * (mult - 1))
+        const flashLoan2x = Number(preview2x.flashLoanUsdc);
+        const flashLoan3x = Number(preview3x.flashLoanUsdc);
+        (0, vitest_1.expect)(flashLoan3x / flashLoan2x).toBeCloseTo(2.0, 1);
+    });
+    (0, vitest_1.it)("APY breakdown is computed correctly", async () => {
+        const deps = createMockDeps();
+        const result = await (0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 2.0 }, deps);
+        // Supply APY from mock
+        (0, vitest_1.expect)(result.supplyApyBreakdown.base).toBe(0.02);
+        (0, vitest_1.expect)(result.supplyApyBreakdown.reward).toBe(0.01);
+        (0, vitest_1.expect)(result.supplyApyBreakdown.total).toBe(0.03);
+        // Borrow APY from mock
+        (0, vitest_1.expect)(result.borrowApyBreakdown.net).toBe(0.05);
+        (0, vitest_1.expect)(result.borrowApyBreakdown.rebate).toBe(0.01);
+        // Net APY = (position * supplyApy - debt * borrowApy) / equity
+        const expectedNetApy = (result.totalPositionUsd * result.supplyApyBreakdown.total -
+            result.debtUsd * result.borrowApyBreakdown.net) /
+            result.initialEquityUsd;
+        (0, vitest_1.expect)(result.netApy).toBeCloseTo(expectedNetApy, 5);
+    });
+    (0, vitest_1.it)("throws on multiplier exceeding max", async () => {
+        const deps = createMockDeps();
+        await (0, vitest_1.expect)((0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 5.0 }, deps)).rejects.toThrow("exceeds protocol max");
+    });
+    (0, vitest_1.it)("throws if neither depositAmount nor depositValueUsd provided", async () => {
+        const deps = createMockDeps();
+        await (0, vitest_1.expect)((0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, multiplier: 2.0 }, deps)).rejects.toThrow("Either depositAmount or depositValueUsd");
+    });
+    (0, vitest_1.it)("throws if both depositAmount and depositValueUsd provided", async () => {
+        const deps = createMockDeps();
+        await (0, vitest_1.expect)((0, leverage_preview_1.previewLeverage)({
+            coinType: types_1.COIN_TYPES.SUI,
+            depositAmount: "10",
+            depositValueUsd: 100,
+            multiplier: 2.0,
+        }, deps)).rejects.toThrow("Cannot provide both");
+    });
+    (0, vitest_1.it)("throws on swap quote failure", async () => {
+        const deps = createMockDeps({
+            swapClient: {
+                quote: vitest_1.vi.fn().mockRejectedValue(new Error("Quote failed")),
+            },
+        });
+        await (0, vitest_1.expect)((0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 2.0 }, deps)).rejects.toThrow("Quote failed");
+    });
+    (0, vitest_1.it)("calculates swap slippage from quote", async () => {
+        // Mock a swap that returns slightly less than theoretical (0.5% slippage)
+        const deps = createMockDeps();
+        const result = await (0, leverage_preview_1.previewLeverage)({ coinType: types_1.COIN_TYPES.SUI, depositValueUsd: 100, multiplier: 2.0 }, deps);
+        // With the mock returning 4.5 SUI, slippage should be calculable
+        (0, vitest_1.expect)(result.swapSlippagePct).toBeGreaterThanOrEqual(0);
+        // effectiveMultiplier should differ from requested due to slippage
+        (0, vitest_1.expect)(result.effectiveMultiplier).toBeGreaterThan(1);
+    });
+});
+//# sourceMappingURL=sdk.preview.unit.test.js.map

package/dist/__tests__/sdk.preview.unit.test.js.map

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

package/dist/__tests__/utils.normalizeCoinType.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for normalizeCoinType utility function
+ *
+ * Migrated from scripts/tests/test_normalize_coin_type.ts
+ */
+export {};
+//# sourceMappingURL=utils.normalizeCoinType.test.d.ts.map

package/dist/__tests__/utils.normalizeCoinType.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.normalizeCoinType.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/utils.normalizeCoinType.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/utils.normalizeCoinType.test.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Unit tests for normalizeCoinType utility function
+ *
+ * Migrated from scripts/tests/test_normalize_coin_type.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const coin_1 = require("../utils/coin");
+const errors_1 = require("../utils/errors");
+const constants_1 = require("../types/constants");
+(0, vitest_1.describe)("normalizeCoinType", () => {
+    (0, vitest_1.it)("pads short SUI address to 64 chars", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)("0x2::sui::SUI")).toBe("0x0000000000000000000000000000000000000000000000000000000000000002::sui::SUI");
+    });
+    (0, vitest_1.it)("keeps full SUI address unchanged", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(constants_1.COIN_TYPES.SUI)).toBe(constants_1.COIN_TYPES.SUI);
+    });
+    (0, vitest_1.it)("keeps full LBTC address unchanged", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(constants_1.COIN_TYPES.LBTC)).toBe(constants_1.COIN_TYPES.LBTC);
+    });
+    (0, vitest_1.it)("keeps already-normalized LBTC unchanged", () => {
+        const normalized = "0x3e8e9423d80e1774a7ca128fccd8bf5f1f7753be658c5e645929037f7c819040::lbtc::LBTC";
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(normalized)).toBe(normalized);
+    });
+    (0, vitest_1.it)("keeps full XBTC address unchanged", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(constants_1.COIN_TYPES.XBTC)).toBe(constants_1.COIN_TYPES.XBTC);
+    });
+    (0, vitest_1.it)("keeps full USDC address unchanged", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(constants_1.COIN_TYPES.USDC)).toBe(constants_1.COIN_TYPES.USDC);
+    });
+    (0, vitest_1.it)("keeps full ETH address unchanged", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)(constants_1.COIN_TYPES.ETH)).toBe(constants_1.COIN_TYPES.ETH);
+    });
+    (0, vitest_1.it)("throws InvalidCoinTypeError on invalid format", () => {
+        (0, vitest_1.expect)(() => (0, coin_1.normalizeCoinType)("invalid")).toThrow(errors_1.InvalidCoinTypeError);
+    });
+    (0, vitest_1.it)("pads short hex address", () => {
+        (0, vitest_1.expect)((0, coin_1.normalizeCoinType)("0xabc::module::Type")).toBe("0x0000000000000000000000000000000000000000000000000000000000000abc::module::Type");
+    });
+});
+//# sourceMappingURL=utils.normalizeCoinType.test.js.map

package/dist/__tests__/utils.normalizeCoinType.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.normalizeCoinType.test.js","sourceRoot":"","sources":["../../src/__tests__/utils.normalizeCoinType.test.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAEH,mCAA8C;AAC9C,wCAAkD;AAClD,4CAAuD;AACvD,kDAAgD;AAEhD,IAAA,iBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAC7C,8EAA8E,CAC/E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,sBAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAU,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,sBAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAU,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,UAAU,GACd,gFAAgF,CAAC;QACnF,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,sBAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAU,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,sBAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAU,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,sBAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAU,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,wBAAiB,EAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,6BAAoB,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,IAAA,eAAM,EAAC,IAAA,wBAAiB,EAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CACnD,kFAAkF,CACnF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -10,23 +10,31 @@
  * ```typescript
  * import { DefiDashSDK, LendingProtocol } from 'defi-dash-sdk';
  *
- * const sdk = new DefiDashSDK();
- * await sdk.initialize(suiClient, keypair);
+ * const sdk = await DefiDashSDK.create(suiClient, keypair);
  *
- * // Leverage strategy
- * const result = await sdk.leverage({
+ * // Build leverage transaction
+ * const tx = new Transaction();
+ * tx.setSender(address);
+ * await sdk.buildLeverageTransaction(tx, {
  *   protocol: LendingProtocol.Suilend,
  *   depositAsset: 'LBTC',
  *   depositAmount: '0.001',
  *   multiplier: 2.0,
- *   dryRun: true
  * });
+ *
+ * // Node.js: execute via SDK
+ * const result = await sdk.execute(tx);
+ *
+ * // Browser: execute via wallet adapter
+ * await signAndExecute({ transaction: tx });
  * ```
  */
-export { DefiDashSDK } from "./sdk";
-export { LendingProtocol, type PositionSide, type AssetPosition, type PositionInfo, type Position, type AccountPortfolio, type MarketAsset, type LeverageParams, type DeleverageParams, type StrategyResult, type LeveragePreview, type SDKOptions, type BrowserLeverageParams, type BrowserDeleverageParams, type ILendingProtocol, type MarketReserve, USDC_COIN_TYPE, SUI_COIN_TYPE, DEFAULT_7K_PARTNER, COIN_TYPES, } from "./types";
-export { buildLeverageTransaction, calculateLeveragePreview, buildDeleverageTransaction, calculateDeleverageEstimate, } from "./strategies";
-export * from "./utils";
-export { ScallopFlashLoanClient } from "./protocols/scallop/flash-loan";
-export { SUILEND_RESERVES, getReserveByCoinType, getReserveBySymbol, } from "./protocols/suilend/constants";
+export { DefiDashSDK } from './sdk';
+export { LendingProtocol, USDC_COIN_TYPE, SUI_COIN_TYPE, COIN_TYPES, } from './types';
+export type { StrategyResult, LeveragePreview, FindBestRouteParams, LeverageRoute, LeverageRouteResult, } from './types';
+export type { AssetPosition, PositionInfo, Position, AccountPortfolio, MarketAsset, } from './types';
+export type { SDKOptions, BrowserLeverageParams, BrowserDeleverageParams, } from './types';
+export { formatUnits, parseUnits } from './utils/format';
+export { normalizeCoinType } from './utils/coin';
+export { DefiDashError, SDKNotInitializedError, InvalidParameterError, InvalidCoinTypeError, } from './utils/errors';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EAEL,eAAe,EACf,KAAK,YAAY,EAGjB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAGhB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAG5B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAGlB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,cAAc,CAAC;AAGtB,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAGpC,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -11,61 +11,45 @@
  * ```typescript
  * import { DefiDashSDK, LendingProtocol } from 'defi-dash-sdk';
  *
- * const sdk = new DefiDashSDK();
- * await sdk.initialize(suiClient, keypair);
+ * const sdk = await DefiDashSDK.create(suiClient, keypair);
  *
- * // Leverage strategy
- * const result = await sdk.leverage({
+ * // Build leverage transaction
+ * const tx = new Transaction();
+ * tx.setSender(address);
+ * await sdk.buildLeverageTransaction(tx, {
  *   protocol: LendingProtocol.Suilend,
  *   depositAsset: 'LBTC',
  *   depositAmount: '0.001',
  *   multiplier: 2.0,
- *   dryRun: true
  * });
+ *
+ * // Node.js: execute via SDK
+ * const result = await sdk.execute(tx);
+ *
+ * // Browser: execute via wallet adapter
+ * await signAndExecute({ transaction: tx });
  * ```
  */
-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 });
-exports.getReserveBySymbol = exports.getReserveByCoinType = exports.SUILEND_RESERVES = exports.ScallopFlashLoanClient = exports.calculateDeleverageEstimate = exports.buildDeleverageTransaction = exports.calculateLeveragePreview = exports.buildLeverageTransaction = exports.COIN_TYPES = exports.DEFAULT_7K_PARTNER = exports.SUI_COIN_TYPE = exports.USDC_COIN_TYPE = exports.LendingProtocol = exports.DefiDashSDK = void 0;
+exports.InvalidCoinTypeError = exports.InvalidParameterError = exports.SDKNotInitializedError = exports.DefiDashError = exports.normalizeCoinType = exports.parseUnits = exports.formatUnits = exports.COIN_TYPES = exports.SUI_COIN_TYPE = exports.USDC_COIN_TYPE = exports.LendingProtocol = exports.DefiDashSDK = void 0;
 // Main SDK
 var sdk_1 = require("./sdk");
 Object.defineProperty(exports, "DefiDashSDK", { enumerable: true, get: function () { return sdk_1.DefiDashSDK; } });
-// Types, Interfaces, Enums, and Constants
+// Enums & Constants
 var types_1 = require("./types");
-// Enums
 Object.defineProperty(exports, "LendingProtocol", { enumerable: true, get: function () { return types_1.LendingProtocol; } });
-// Constants
 Object.defineProperty(exports, "USDC_COIN_TYPE", { enumerable: true, get: function () { return types_1.USDC_COIN_TYPE; } });
 Object.defineProperty(exports, "SUI_COIN_TYPE", { enumerable: true, get: function () { return types_1.SUI_COIN_TYPE; } });
-Object.defineProperty(exports, "DEFAULT_7K_PARTNER", { enumerable: true, get: function () { return types_1.DEFAULT_7K_PARTNER; } });
 Object.defineProperty(exports, "COIN_TYPES", { enumerable: true, get: function () { return types_1.COIN_TYPES; } });
-// Strategy Builders (for advanced usage)
-var strategies_1 = require("./strategies");
-Object.defineProperty(exports, "buildLeverageTransaction", { enumerable: true, get: function () { return strategies_1.buildLeverageTransaction; } });
-Object.defineProperty(exports, "calculateLeveragePreview", { enumerable: true, get: function () { return strategies_1.calculateLeveragePreview; } });
-Object.defineProperty(exports, "buildDeleverageTransaction", { enumerable: true, get: function () { return strategies_1.buildDeleverageTransaction; } });
-Object.defineProperty(exports, "calculateDeleverageEstimate", { enumerable: true, get: function () { return strategies_1.calculateDeleverageEstimate; } });
-// Utilities
-__exportStar(require("./utils"), exports);
-// Flash Loan
-var flash_loan_1 = require("./protocols/scallop/flash-loan");
-Object.defineProperty(exports, "ScallopFlashLoanClient", { enumerable: true, get: function () { return flash_loan_1.ScallopFlashLoanClient; } });
-// Protocol-specific data
-var constants_1 = require("./protocols/suilend/constants");
-Object.defineProperty(exports, "SUILEND_RESERVES", { enumerable: true, get: function () { return constants_1.SUILEND_RESERVES; } });
-Object.defineProperty(exports, "getReserveByCoinType", { enumerable: true, get: function () { return constants_1.getReserveByCoinType; } });
-Object.defineProperty(exports, "getReserveBySymbol", { enumerable: true, get: function () { return constants_1.getReserveBySymbol; } });
+// Utilities (frontend-facing only)
+var format_1 = require("./utils/format");
+Object.defineProperty(exports, "formatUnits", { enumerable: true, get: function () { return format_1.formatUnits; } });
+Object.defineProperty(exports, "parseUnits", { enumerable: true, get: function () { return format_1.parseUnits; } });
+var coin_1 = require("./utils/coin");
+Object.defineProperty(exports, "normalizeCoinType", { enumerable: true, get: function () { return coin_1.normalizeCoinType; } });
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "DefiDashError", { enumerable: true, get: function () { return errors_1.DefiDashError; } });
+Object.defineProperty(exports, "SDKNotInitializedError", { enumerable: true, get: function () { return errors_1.SDKNotInitializedError; } });
+Object.defineProperty(exports, "InvalidParameterError", { enumerable: true, get: function () { return errors_1.InvalidParameterError; } });
+Object.defineProperty(exports, "InvalidCoinTypeError", { enumerable: true, get: function () { return errors_1.InvalidCoinTypeError; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;;;;;;;;;;;;;;;;AAEH,WAAW;AACX,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAEpB,0CAA0C;AAC1C,iCAgCiB;AA/Bf,QAAQ;AACR,wGAAA,eAAe,OAAA;AAyBf,YAAY;AACZ,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,2GAAA,kBAAkB,OAAA;AAClB,mGAAA,UAAU,OAAA;AAGZ,yCAAyC;AACzC,2CAKsB;AAJpB,sHAAA,wBAAwB,OAAA;AACxB,sHAAA,wBAAwB,OAAA;AACxB,wHAAA,0BAA0B,OAAA;AAC1B,yHAAA,2BAA2B,OAAA;AAG7B,YAAY;AACZ,0CAAwB;AAExB,aAAa;AACb,6DAAwE;AAA/D,oHAAA,sBAAsB,OAAA;AAE/B,yBAAyB;AACzB,2DAIuC;AAHrC,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;AAEH,WAAW;AACX,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAEpB,oBAAoB;AACpB,iCAKiB;AAJf,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,mGAAA,UAAU,OAAA;AA4BZ,mCAAmC;AACnC,yCAAyD;AAAhD,qGAAA,WAAW,OAAA;AAAE,oGAAA,UAAU,OAAA;AAChC,qCAAiD;AAAxC,yGAAA,iBAAiB,OAAA;AAC1B,yCAKwB;AAJtB,uGAAA,aAAa,OAAA;AACb,gHAAA,sBAAsB,OAAA;AACtB,+GAAA,qBAAqB,OAAA;AACrB,8GAAA,oBAAoB,OAAA"}

package/dist/protocols/base-adapter.d.ts

@@ -1,105 +1,72 @@
 /**
  * Base Protocol Adapter
  *
- * Abstract base class providing common functionality for all protocol adapters.
- * Reduces code duplication and ensures consistent implementation patterns.
+ * Abstract base class for all lending protocol adapters.
+ * Implements ILendingProtocol to enforce compile-time method checks.
+ *
+ * Any class extending this MUST implement all abstract methods,
+ * otherwise TypeScript will produce a build error:
+ *   "Non-abstract class 'XxxAdapter' does not implement inherited abstract member 'methodName'"
+ *
+ * This is the TypeScript equivalent of Go's interface compliance pattern:
+ *   var _ ILendingProtocol = (*MyAdapter)(nil)
  */
 import { SuiClient } from "@mysten/sui/client";
-import { ILendingProtocol } from "../types";
+import { Transaction } from "@mysten/sui/transactions";
+import { ILendingProtocol, PositionInfo, AssetRiskParams, AssetApy, AccountPortfolio } from "../types";
 /**
- * Abstract base class for protocol adapters
+ * Abstract base class for protocol adapters.
  *
- * Provides common functionality that all protocol adapters need:
- * - SuiClient management
- * - Coin type normalization
- * - Initialization tracking
+ * Provides common utilities (SuiClient management, coin normalization).
+ * All ILendingProtocol methods are declared abstract — subclasses MUST implement them.
  *
  * @example
  * ```typescript
- * class MyProtocolAdapter extends BaseProtocolAdapter {
- *   readonly name = "MyProtocol";
+ * export class NewProtocolAdapter extends BaseProtocolAdapter {
+ *   readonly name = "new-protocol";
  *   readonly consumesRepaymentCoin = false;
  *
- *   async initialize(client: SuiClient): Promise<void> {
- *     await super.initialize(client);
- *     // Protocol-specific initialization
+ *   async initialize(suiClient: SuiClient): Promise<void> {
+ *     await super.initialize(suiClient);
+ *     // protocol-specific init
  *   }
  *
- *   async getPosition(address: string): Promise<PositionInfo | null> {
- *     this.ensureInitialized();
- *     // Implementation
- *   }
+ *   // All abstract methods must be implemented:
+ *   async getPosition(userAddress: string) { ... }
+ *   async deposit(tx, coin, coinType, userAddress) { ... }
+ *   async withdraw(tx, coinType, amount, userAddress) { ... }
+ *   async borrow(tx, coinType, amount, userAddress) { ... }
+ *   async repay(tx, coinType, coin, userAddress) { ... }
+ *   async refreshOracles(tx, coinTypes, userAddress) { ... }
+ *   async getAccountPortfolio(address) { ... }
+ *   async getAssetRiskParams(coinType) { ... }
+ *   async getAssetApy(coinType) { ... }
  * }
  * ```
  */
-export declare abstract class BaseProtocolAdapter implements Partial<ILendingProtocol> {
-    /**
-     * Sui client instance
-     * Available after initialization
-     */
+export declare abstract class BaseProtocolAdapter implements ILendingProtocol {
     protected suiClient: SuiClient;
-    /**
-     * Initialization status
-     */
     protected initialized: boolean;
-    /**
-     * Protocol name (must be implemented by subclass)
-     */
     abstract readonly name: string;
-    /**
-     * Whether protocol consumes repayment coin entirely
-     * (must be implemented by subclass)
-     */
     abstract readonly consumesRepaymentCoin: boolean;
-    /**
-     * Initialize the protocol adapter
-     *
-     * @param suiClient - Sui blockchain client
-     */
+    abstract getPosition(userAddress: string): Promise<PositionInfo | null>;
+    abstract deposit(tx: Transaction, coin: any, coinType: string, userAddress: string): Promise<void>;
+    abstract withdraw(tx: Transaction, coinType: string, amount: string, userAddress: string): Promise<any>;
+    abstract borrow(tx: Transaction, coinType: string, amount: string, userAddress: string, skipOracle?: boolean): Promise<any>;
+    abstract repay(tx: Transaction, coinType: string, coin: any, userAddress: string): Promise<void>;
+    abstract refreshOracles(tx: Transaction, coinTypes: string[], userAddress: string): Promise<void>;
+    abstract getAccountPortfolio(address: string): Promise<AccountPortfolio>;
+    abstract getAssetRiskParams(coinType: string): Promise<AssetRiskParams>;
+    abstract getAssetApy(coinType: string): Promise<AssetApy>;
     initialize(suiClient: SuiClient): Promise<void>;
     /**
-     * Ensure adapter is initialized before use
-     *
-     * @throws Error if not initialized
+     * Optional: clear pending state between transactions.
+     * Override in subclass if needed (e.g., Scallop obligation tracking).
      */
+    clearPendingState(): void;
     protected ensureInitialized(): void;
-    /**
-     * Normalize coin type to standard format
-     *
-     * Utility method for consistent coin type handling.
-     *
-     * @param coinType - Raw coin type string
-     * @returns Normalized coin type with padded address
-     *
-     * @example
-     * ```typescript
-     * const normalized = this.normalizeCoin("0x2::sui::SUI");
-     * // "0x0000...0002::sui::SUI"
-     * ```
-     */
     protected normalizeCoin(coinType: string): string;
-    /**
-     * Get object by ID with error handling
-     *
-     * @param objectId - Object ID to fetch
-     * @returns Object data or null if not found
-     */
-    protected getObject(objectId: string): Promise<any>;
-    /**
-     * Format amount from raw units to human-readable
-     *
-     * @param amount - Raw amount (bigint)
-     * @param decimals - Token decimals
-     * @returns Human-readable number
-     */
     protected formatAmount(amount: bigint, decimals: number): number;
-    /**
-     * Parse amount from human-readable to raw units
-     *
-     * @param amount - Human-readable amount (number or string)
-     * @param decimals - Token decimals
-     * @returns Raw amount as bigint
-     */
     protected parseAmount(amount: number | string, decimals: number): bigint;
 }
 //# sourceMappingURL=base-adapter.d.ts.map

package/dist/protocols/base-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/protocols/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,8BAAsB,mBAAoB,YAAW,OAAO,CAAC,gBAAgB,CAAC;IAC5E;;;OAGG;IACH,SAAS,CAAC,SAAS,EAAG,SAAS,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,WAAW,UAAS;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAEjD;;;;OAIG;IACG,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAMnC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjD;;;;;OAKG;cACa,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBzD;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIhE;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAIzE"}
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../src/protocols/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,8BAAsB,mBAAoB,YAAW,gBAAgB;IACnE,SAAS,CAAC,SAAS,EAAG,SAAS,CAAC;IAChC,SAAS,CAAC,WAAW,UAAS;IAI9B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IAIjD,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAEvE,QAAQ,CAAC,OAAO,CACd,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAEhB,QAAQ,CAAC,QAAQ,CACf,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC;IAEf,QAAQ,CAAC,MAAM,CACb,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAAC,GAAG,CAAC;IAEf,QAAQ,CAAC,KAAK,CACZ,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,GAAG,EACT,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAEhB,QAAQ,CAAC,cAAc,CACrB,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAEhB,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAExE,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAEvE,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInD,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;OAGG;IACH,iBAAiB,IAAI,IAAI;IAMzB,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAMnC,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIjD,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIhE,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;CAIzE"}