@aibtc/mcp-server 1.33.3 → 1.33.4

package/dist/services/defi.service.d.ts

@@ -35,7 +35,7 @@ export interface ZestMarketInfo {
 }
 export interface ZestUserPosition {
     asset: string;
-    supplied: string;
+    suppliedShares: string;
     borrowed: string;
     healthFactor?: string;
 }
@@ -92,7 +92,6 @@ export declare class ZestProtocolService {
     private network;
     private hiro;
     private contracts;
-    private assetsListCache;
     constructor(network: Network);
     private ensureMainnet;
     /**
@@ -100,74 +99,108 @@ export declare class ZestProtocolService {
      */
     private getAssetConfig;
     /**
-     * Build the assets-list CV required for borrow/withdraw operations
-     * This is a list of tuples containing (asset, lp-token, oracle) for all supported assets
-     * Result is cached since ZEST_ASSETS_LIST is static
+     * Get all supported assets from Zest Protocol v2
      */
-    private buildAssetsListCV;
+    getAssets(): Promise<ZestAsset[]>;
     /**
-     * Pyth price feed IDs used by Zest's oracle contracts.
-     * BTC and STX feeds cover all current Zest assets.
+     * Resolve an asset symbol or contract ID to a full contract ID
      */
-    private static PYTH_FEED_IDS;
-    private priceFeedCache;
-    private static PRICE_FEED_TTL_MS;
+    resolveAsset(assetOrSymbol: string): Promise<string>;
     /**
-     * Fetch fresh Pyth price update VAA from Hermes API.
-     * Caches for 30s to avoid redundant requests when multiple ops run in sequence.
-     * Returns someCV(bufferCV(...)) for the price-feed-bytes parameter,
-     * or noneCV() if the fetch fails (graceful degradation).
+     * Get user's full position on Zest v2 via the data helper contract.
+     * Returns collateral, debt, health factor, and LTV data in a single call.
      */
-    private fetchPriceFeedBytes;
+    getUserPosition(asset: string, userAddress: string): Promise<ZestUserPosition | null>;
     /**
-     * Get all supported assets from Zest Protocol
-     * Returns the hardcoded asset list with full metadata
+     * Get detailed per-asset supply balances via the data helper.
+     * Returns vault share balances, underlying equivalents, and market collateral.
      */
-    getAssets(): Promise<ZestAsset[]>;
+    getUserSupplies(userAddress: string): Promise<Record<string, unknown> | null>;
     /**
-     * Resolve an asset symbol or contract ID to a full contract ID
+     * Build post-conditions for a principal sending tokens.
+     * Handles wSTX (native STX transfers) vs FT transfers.
      */
-    resolveAsset(assetOrSymbol: string): Promise<string>;
+    private buildSendPC;
     /**
-     * Get user's reserve/position data for an asset.
-     *
-     * Supply positions are tracked as LP token balances (e.g. zsbtc-v2-0.get-balance),
-     * not in pool-0-reserve-v2-0.get-user-reserve-data which only tracks borrow-side debt.
-     * Borrow positions are read from get-user-reserve-data.principal-borrow-balance.
+     * Query the vault's convert-to-assets to predict underlying amount for a given share amount.
+     * Used to set accurate post-conditions for withdraw operations (shares appreciate over time).
      */
-    getUserPosition(asset: string, userAddress: string): Promise<ZestUserPosition | null>;
+    private getExpectedUnderlying;
+    /**
+     * Query the vault's convert-to-shares to predict zToken amount for a given underlying amount.
+     * Used to set accurate post-conditions for supply operations.
+     */
+    private getExpectedShares;
     /**
-     * Supply assets to Zest lending pool via borrow-helper
+     * Supply assets to Zest v2 via market's supply-collateral-add.
+     * Atomically deposits into vault and adds zTokens as collateral.
+     * This earns yield AND provides borrowing power.
      *
-     * Contract signature: supply(lp, pool-reserve, asset, amount, owner, referral, incentives)
+     * Token flow (3 ft-transfers):
+     * 1. user → market (underlying)
+     * 2. market → vault (underlying)
+     * 3. user → market-vault (zTokens, minted to user then transferred)
+     *
+     * Contract: v0-4-market.supply-collateral-add(ft, amount, min-shares, price-feeds)
      */
-    supply(account: Account, asset: string, amount: bigint, onBehalfOf?: string): Promise<TransferResult>;
+    supply(account: Account, asset: string, amount: bigint): Promise<TransferResult>;
     /**
-     * Withdraw assets from Zest lending pool via borrow-helper
+     * Withdraw assets from Zest v2 via market's collateral-remove-redeem.
+     * Atomically removes zToken collateral and redeems for underlying.
+     *
+     * Token flow (3 ft-transfers):
+     * 1. market-vault → market (zTokens released from collateral)
+     * 2. market → vault (zTokens for redemption/burn)
+     * 3. vault → user (underlying redeemed)
+     *
+     * Contract: v0-4-market.collateral-remove-redeem(ft, amount, min-underlying, receiver, price-feeds)
      *
-     * Contract signature: withdraw(lp, pool-reserve, asset, oracle, amount, owner, assets, incentives, price-feed-bytes)
+     * @param amount - Amount in zToken shares to withdraw
      */
     withdraw(account: Account, asset: string, amount: bigint): Promise<TransferResult>;
     /**
-     * Borrow assets from Zest lending pool via borrow-helper
+     * Borrow assets from Zest v2 via market's borrow function.
+     * Requires sufficient collateral to maintain healthy LTV.
      *
-     * Contract signature: borrow(pool-reserve, oracle, asset-to-borrow, lp, assets, amount, fee-calculator, interest-rate-mode, owner, price-feed-bytes)
+     * Token flow (1 ft-transfer):
+     * 1. vault → user (borrowed underlying)
+     *
+     * Contract: v0-4-market.borrow(ft, amount, receiver, price-feeds)
      */
     borrow(account: Account, asset: string, amount: bigint): Promise<TransferResult>;
     /**
-     * Repay borrowed assets
+     * Repay borrowed assets on Zest v2.
+     *
+     * Token flow (1 ft-transfer):
+     * 1. user → vault (repayment, amount may be capped to actual debt on-chain)
      *
-     * Contract signature: repay(asset, amount-to-repay, on-behalf-of, payer)
+     * Contract: v0-4-market.repay(ft, amount, on-behalf-of)
      */
     repay(account: Account, asset: string, amount: bigint, onBehalfOf?: string): Promise<TransferResult>;
     /**
-     * Claim accumulated rewards from Zest incentives program via borrow-helper
+     * Deposit directly into a Zest v2 vault for yield without collateral.
+     * Mints zTokens that earn supply yield. Simpler than supply-collateral-add
+     * but the zTokens won't be usable as collateral for borrowing.
+     *
+     * Token flow (1 ft-transfer):
+     * 1. user → vault (underlying)
+     * Note: zTokens minted to recipient (ft-mint, no PC needed)
+     *
+     * Contract: vault.deposit(amount, min-out, recipient)
+     */
+    depositToVault(account: Account, asset: string, amount: bigint): Promise<TransferResult>;
+    /**
+     * Redeem zTokens from a Zest v2 vault for underlying assets.
+     *
+     * Token flow:
+     * 1. user sends zTokens → vault (ft-burn, but transfer happens first)
+     * 2. vault sends underlying → recipient
      *
-     * Currently: sBTC suppliers earn wSTX rewards
+     * Contract: vault.redeem(amount, min-out, recipient)
      *
-     * Contract signature: claim-rewards(lp, pool-reserve, asset, oracle, owner, assets, reward-asset, incentives, price-feed-bytes)
+     * @param amount - Amount of zTokens to redeem
      */
-    claimRewards(account: Account, asset: string): Promise<TransferResult>;
+    redeemFromVault(account: Account, asset: string, amount: bigint): Promise<TransferResult>;
 }
 export declare function getAlexDexService(network: Network): AlexDexService;
 export declare function getZestProtocolService(network: Network): ZestProtocolService;

package/dist/services/defi.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defi.service.d.ts","sourceRoot":"","sources":["../../src/services/defi.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"defi.service.d.ts","sourceRoot":"","sources":["../../src/services/defi.service.ts"],"names":[],"mappings":"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"}