@oobe-protocol-labs/sap-mcp-server 0.9.37 → 0.9.50

package/dist/tools/adrena/adrena-index.js

@@ -0,0 +1,75 @@
+/**
+ * @name tools/adrena/adrena-index
+ * @description Main entry point for Adrena tool registration. Re-exports
+ *   registerAdrenaTools which calls all sub-registrations.
+ *
+ * @module tools/adrena/adrena-index
+ */
+import { logger } from '../../core/logger.js';
+import { registerAdrenaOpenLongTool } from './adrena-trading-tools.js';
+import { registerAdrenaOpenShortTool } from './adrena-trading-tools.js';
+import { registerAdrenaCloseLongTool } from './adrena-trading-tools.js';
+import { registerAdrenaCloseShortTool } from './adrena-trading-tools.js';
+import { registerAdrenaSetStopLossTool } from './adrena-trading-tools.js';
+import { registerAdrenaSetTakeProfitTool } from './adrena-trading-tools.js';
+import { registerAdrenaCancelStopLossTool } from './adrena-trading-tools.js';
+import { registerAdrenaCancelTakeProfitTool } from './adrena-trading-tools.js';
+import { registerAdrenaSimulatePositionTool } from './adrena-trading-tools.js';
+import { registerAdrenaPositionPackageTool } from './adrena-trading-tools.js';
+import { registerAdrenaTradeIntentTool } from './adrena-trading-tools.js';
+import { registerAdrenaMarketSnapshotTool } from './adrena-snapshot-tools.js';
+import { registerAdrenaAddLimitOrderTool } from './adrena-limit-order-tools.js';
+import { registerAdrenaCancelLimitOrderTool } from './adrena-limit-order-tools.js';
+import { registerAdrenaCommodityTools } from './adrena-commodity-tools.js';
+import { registerAdrenaLiquiditySwapTools } from './adrena-liquidity-tools.js';
+import { registerAdrenaStakingTools } from './adrena-staking-tools.js';
+import { registerAdrenaDataApiTools } from './adrena-data-tools.js';
+import { registerAdrenaGetMarketsTool } from './adrena-data-tools.js';
+/* ═══════════════════════════════════════════════════════════════════
+ *  Main registration function
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name registerAdrenaTools
+ * @description Register all Adrena perps protocol tools: trading builders, commodity builders, liquidity/swap, staking, and Data API.
+ *
+ * @param server  — MCP server instance.
+ * @param context — Shared runtime context with Solana connection.
+ *
+ * @usedBy `register-tools.ts`
+ */
+export function registerAdrenaTools(server, context) {
+    logger.debug('Registering Adrena perps protocol tools');
+    // Trading builders
+    registerAdrenaOpenLongTool(server, context);
+    registerAdrenaOpenShortTool(server, context);
+    registerAdrenaCloseLongTool(server, context);
+    registerAdrenaCloseShortTool(server, context);
+    // SL / TP builders
+    registerAdrenaSetStopLossTool(server, context);
+    registerAdrenaSetTakeProfitTool(server, context);
+    registerAdrenaCancelStopLossTool(server, context);
+    registerAdrenaCancelTakeProfitTool(server, context);
+    // Free simulation (dry-run, no x402 charge)
+    registerAdrenaSimulatePositionTool(server, context);
+    // Batch position builder (open + SL + TP atomic)
+    registerAdrenaPositionPackageTool(server, context);
+    // Intent-level trading API (resolves mint, leverage, collateral automatically)
+    registerAdrenaTradeIntentTool(server, context);
+    // Market snapshot with TTL cache (reduces polling costs 20x)
+    registerAdrenaMarketSnapshotTool(server, context);
+    // Limit order builders
+    registerAdrenaAddLimitOrderTool(server, context);
+    registerAdrenaCancelLimitOrderTool(server, context);
+    // Commodity builders
+    registerAdrenaCommodityTools(server, context);
+    // Liquidity & swap builders
+    registerAdrenaLiquiditySwapTools(server, context);
+    // Staking builders
+    registerAdrenaStakingTools(server, context);
+    // Data API tools
+    registerAdrenaDataApiTools(server, context);
+    // On-chain markets reader
+    registerAdrenaGetMarketsTool(server, context);
+    logger.debug('Adrena perps tools registered', { count: 36 });
+}
+//# sourceMappingURL=adrena-index.js.map

package/dist/tools/adrena/adrena-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrena-index.js","sourceRoot":"","sources":["../../../src/tools/adrena/adrena-index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,kCAAkC,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;yEAEyE;AAEzE;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,OAAsB;IACxE,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAExD,mBAAmB;IACnB,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C,mBAAmB;IACnB,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,+BAA+B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,gCAAgC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,kCAAkC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,4CAA4C;IAC5C,kCAAkC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,iDAAiD;IACjD,iCAAiC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnD,+EAA+E;IAC/E,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C,6DAA6D;IAC7D,gCAAgC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,uBAAuB;IACvB,+BAA+B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,kCAAkC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpD,qBAAqB;IACrB,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C,4BAA4B;IAC5B,gCAAgC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD,mBAAmB;IACnB,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5C,iBAAiB;IACjB,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5C,0BAA0B;IAC1B,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/tools/adrena/adrena-limit-order-tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @name tools/adrena/adrena-limit-order-tools
+ * @description Limit order builder tool registrations for Adrena perps:
+ *   add limit order, cancel limit order.
+ *
+ * @module tools/adrena/adrena-limit-order-tools
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * @name registerAdrenaAddLimitOrderTool
+ * @description Register sap_adrena_build_add_limit_order.
+ * @internal
+ */
+export declare function registerAdrenaAddLimitOrderTool(server: Server, context: SapMcpContext): void;
+/**
+ * @name registerAdrenaCancelLimitOrderTool
+ * @description Register sap_adrena_build_cancel_limit_order.
+ * @internal
+ */
+export declare function registerAdrenaCancelLimitOrderTool(server: Server, context: SapMcpContext): void;
+//# sourceMappingURL=adrena-limit-order-tools.d.ts.map

package/dist/tools/adrena/adrena-limit-order-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrena-limit-order-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adrena/adrena-limit-order-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAqBzD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAuC5F;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA2B/F"}

package/dist/tools/adrena/adrena-limit-order-tools.js

@@ -0,0 +1,91 @@
+/**
+ * @name tools/adrena/adrena-limit-order-tools
+ * @description Limit order builder tool registrations for Adrena perps:
+ *   add limit order, cancel limit order.
+ *
+ * @module tools/adrena/adrena-limit-order-tools
+ */
+import { createTextResponse } from '../../adapters/mcp/tool-response.js';
+import { registerTool } from '../../adapters/mcp/sdk-compat.js';
+import { buildAddLimitOrder, buildCancelLimitOrder, } from '../../perps/adrena/index.js';
+import { MAIN_POOL_TOKENS, COLLATERAL_TOKENS, priceToRaw, getConnection, parsePublicKey, } from './adrena-helpers.js';
+/* ═══════════════════════════════════════════════════════════════════
+ *  Limit Order Builders
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name registerAdrenaAddLimitOrderTool
+ * @description Register sap_adrena_build_add_limit_order.
+ * @internal
+ */
+export function registerAdrenaAddLimitOrderTool(server, context) {
+    const schema = {
+        type: 'object',
+        properties: {
+            owner: { type: 'string', description: 'Order owner wallet public key (base58).' },
+            principalToken: { type: 'string', description: 'Asset to trade.', enum: MAIN_POOL_TOKENS },
+            collateralToken: { type: 'string', description: 'Collateral token.', enum: COLLATERAL_TOKENS },
+            collateralAmount: { type: 'number', description: 'Collateral amount in human-readable units.', minimum: 0 },
+            leverage: { type: 'number', description: 'Leverage multiplier.', minimum: 1, maximum: 100 },
+            side: { type: 'string', description: 'Order side.', enum: ['long', 'short'] },
+            triggerPriceUsd: { type: 'number', description: 'Trigger price in USD. Order fills when oracle reaches this price.', minimum: 0 },
+            limitPriceUsd: { type: 'number', description: 'Optional limit price cap. Omit for market price at fill.', minimum: 0 },
+        },
+        required: ['owner', 'principalToken', 'collateralToken', 'collateralAmount', 'leverage', 'side', 'triggerPriceUsd'],
+        additionalProperties: false,
+    };
+    registerTool(server, 'sap_adrena_build_add_limit_order', {
+        description: 'Build an unsigned transaction to place a limit order on Adrena. The order fills when the oracle price reaches the trigger price. Returns transactionBase64 for local signing.',
+        inputSchema: schema,
+    }, async (args) => {
+        try {
+            const owner = parsePublicKey(String(args['owner']));
+            const principalToken = String(args['principalToken']).toUpperCase();
+            const collateralToken = String(args['collateralToken']).toUpperCase();
+            const collateralAmount = Number(args['collateralAmount']);
+            const leverage = Number(args['leverage']);
+            const side = args['side'] === 'short' ? 'short' : 'long';
+            const triggerPriceUsd = Number(args['triggerPriceUsd']);
+            const limitPriceUsd = args['limitPriceUsd'] !== undefined ? Number(args['limitPriceUsd']) : null;
+            const triggerPrice = priceToRaw(triggerPriceUsd);
+            const limitPrice = limitPriceUsd !== null ? priceToRaw(limitPriceUsd) : null;
+            const result = await buildAddLimitOrder(getConnection(context), owner, principalToken, collateralToken, collateralAmount, leverage, side, triggerPrice, limitPrice);
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build add limit order transaction', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+}
+/**
+ * @name registerAdrenaCancelLimitOrderTool
+ * @description Register sap_adrena_build_cancel_limit_order.
+ * @internal
+ */
+export function registerAdrenaCancelLimitOrderTool(server, context) {
+    const schema = {
+        type: 'object',
+        properties: {
+            owner: { type: 'string', description: 'Order owner wallet public key (base58).' },
+            collateralToken: { type: 'string', description: 'Collateral token used for the order.', enum: COLLATERAL_TOKENS },
+            orderId: { type: 'number', description: 'Limit order ID to cancel.' },
+        },
+        required: ['owner', 'collateralToken', 'orderId'],
+        additionalProperties: false,
+    };
+    registerTool(server, 'sap_adrena_build_cancel_limit_order', {
+        description: 'Build an unsigned transaction to cancel a limit order on Adrena. Returns transactionBase64 for local signing.',
+        inputSchema: schema,
+    }, async (args) => {
+        try {
+            const owner = parsePublicKey(String(args['owner']));
+            const collateralToken = String(args['collateralToken']).toUpperCase();
+            const orderId = BigInt(Math.floor(Number(args['orderId'])));
+            const result = await buildCancelLimitOrder(getConnection(context), owner, collateralToken, orderId);
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build cancel limit order transaction', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+}
+//# sourceMappingURL=adrena-limit-order-tools.js.map

package/dist/tools/adrena/adrena-limit-order-tools.js.map

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

package/dist/tools/adrena/adrena-liquidity-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @name tools/adrena/adrena-liquidity-tools
+ * @description Liquidity and swap builder tool registrations for Adrena.
+ *
+ * @module tools/adrena/adrena-liquidity-tools
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * @name registerAdrenaLiquiditySwapTools
+ * @description Register liquidity and swap builder tools.
+ * @internal
+ */
+export declare function registerAdrenaLiquiditySwapTools(server: Server, context: SapMcpContext): void;
+//# sourceMappingURL=adrena-liquidity-tools.d.ts.map

package/dist/tools/adrena/adrena-liquidity-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrena-liquidity-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adrena/adrena-liquidity-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmBzD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA0F7F"}

package/dist/tools/adrena/adrena-liquidity-tools.js

@@ -0,0 +1,108 @@
+/**
+ * @name tools/adrena/adrena-liquidity-tools
+ * @description Liquidity and swap builder tool registrations for Adrena.
+ *
+ * @module tools/adrena/adrena-liquidity-tools
+ */
+import { createTextResponse } from '../../adapters/mcp/tool-response.js';
+import { registerTool } from '../../adapters/mcp/sdk-compat.js';
+import { buildAddLiquidity, buildRemoveLiquidity, buildSwap, } from '../../perps/adrena/index.js';
+import { COLLATERAL_TOKENS, getConnection, parsePublicKey, } from './adrena-helpers.js';
+/* ═══════════════════════════════════════════════════════════════════
+ *  Liquidity & Swap Builders
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name registerAdrenaLiquiditySwapTools
+ * @description Register liquidity and swap builder tools.
+ * @internal
+ */
+export function registerAdrenaLiquiditySwapTools(server, context) {
+    // Add liquidity
+    registerTool(server, 'sap_adrena_build_add_liquidity', {
+        description: 'Build an unsigned transaction to add liquidity to an Adrena pool. Deposits collateral and receives LP tokens. Returns transactionBase64 for local signing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                owner: { type: 'string', description: 'Liquidity provider wallet public key (base58).' },
+                collateralToken: { type: 'string', description: 'Collateral token to deposit.', enum: COLLATERAL_TOKENS },
+                amount: { type: 'number', description: 'Amount in human-readable units.', minimum: 0 },
+                minLpAmountOut: { type: 'number', description: 'Minimum LP tokens to receive (raw). 0 for no slippage protection.', minimum: 0 },
+                poolName: { type: 'string', description: 'Pool to add liquidity to.', enum: ['main-pool', 'commodities-pool'] },
+            },
+            required: ['owner', 'collateralToken', 'amount'],
+            additionalProperties: false,
+        },
+    }, async (args) => {
+        try {
+            const owner = parsePublicKey(String(args['owner']));
+            const collateralToken = String(args['collateralToken']).toUpperCase();
+            const amount = Number(args['amount']);
+            const minLpAmountOut = args['minLpAmountOut'] !== undefined ? BigInt(Math.floor(Number(args['minLpAmountOut']))) : 0n;
+            const poolName = (args['poolName'] === 'commodities-pool' ? 'commodities-pool' : 'main-pool');
+            const result = await buildAddLiquidity(getConnection(context), owner, collateralToken, amount, minLpAmountOut, poolName);
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build add liquidity transaction', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+    // Remove liquidity
+    registerTool(server, 'sap_adrena_build_remove_liquidity', {
+        description: 'Build an unsigned transaction to remove liquidity from an Adrena pool. Burns LP tokens and receives collateral. Returns transactionBase64 for local signing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                owner: { type: 'string', description: 'Liquidity provider wallet public key (base58).' },
+                collateralToken: { type: 'string', description: 'Collateral token to receive.', enum: COLLATERAL_TOKENS },
+                lpAmountIn: { type: 'number', description: 'LP tokens to burn (raw, 6 decimals).', minimum: 0 },
+                minAmountOut: { type: 'number', description: 'Minimum collateral to receive (raw). 0 for no slippage protection.', minimum: 0 },
+                poolName: { type: 'string', description: 'Pool to remove liquidity from.', enum: ['main-pool', 'commodities-pool'] },
+            },
+            required: ['owner', 'collateralToken', 'lpAmountIn'],
+            additionalProperties: false,
+        },
+    }, async (args) => {
+        try {
+            const owner = parsePublicKey(String(args['owner']));
+            const collateralToken = String(args['collateralToken']).toUpperCase();
+            const lpAmountIn = BigInt(Math.floor(Number(args['lpAmountIn'])));
+            const minAmountOut = args['minAmountOut'] !== undefined ? BigInt(Math.floor(Number(args['minAmountOut']))) : 0n;
+            const poolName = (args['poolName'] === 'commodities-pool' ? 'commodities-pool' : 'main-pool');
+            const result = await buildRemoveLiquidity(getConnection(context), owner, collateralToken, lpAmountIn, minAmountOut, poolName);
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build remove liquidity transaction', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+    // Swap
+    registerTool(server, 'sap_adrena_build_swap', {
+        description: 'Build an unsigned transaction to swap tokens through an Adrena pool. Uses zero-slippage oracle pricing. Returns transactionBase64 for local signing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                owner: { type: 'string', description: 'Swapper wallet public key (base58).' },
+                fromToken: { type: 'string', description: 'Token to swap from.', enum: COLLATERAL_TOKENS },
+                toToken: { type: 'string', description: 'Token to swap to.', enum: COLLATERAL_TOKENS },
+                amount: { type: 'number', description: 'Amount to swap in human-readable units.', minimum: 0 },
+                minAmountOut: { type: 'number', description: 'Minimum amount to receive (raw). 0 for no slippage protection.', minimum: 0 },
+            },
+            required: ['owner', 'fromToken', 'toToken', 'amount'],
+            additionalProperties: false,
+        },
+    }, async (args) => {
+        try {
+            const owner = parsePublicKey(String(args['owner']));
+            const fromToken = String(args['fromToken']).toUpperCase();
+            const toToken = String(args['toToken']).toUpperCase();
+            const amount = Number(args['amount']);
+            const minAmountOut = args['minAmountOut'] !== undefined ? BigInt(Math.floor(Number(args['minAmountOut']))) : 0n;
+            const result = await buildSwap(getConnection(context), owner, fromToken, toToken, amount, minAmountOut);
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build swap transaction', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+}
+//# sourceMappingURL=adrena-liquidity-tools.js.map

package/dist/tools/adrena/adrena-liquidity-tools.js.map

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

package/dist/tools/adrena/adrena-snapshot-tools.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @name tools/adrena/adrena-snapshot-tools
+ * @description Market snapshot tool with TTL cache for reduced x402 costs.
+ *
+ * @module tools/adrena/adrena-snapshot-tools
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/** Market snapshot response. */
+export interface MarketSnapshotResult {
+    timestamp: string;
+    cached: boolean;
+    cacheTtlSeconds: number;
+    markets: MarketEntry[];
+    prices: Record<string, number>;
+    poolInfo: PoolInfo;
+}
+/** Single market entry in the snapshot. */
+interface MarketEntry {
+    symbol: string;
+    pool: string;
+    allowTrade: boolean;
+    allowSwap: boolean;
+    maxInitialLeverage: number;
+    maxLeverage: number;
+    decimals: number;
+}
+/** Pool info in the snapshot. */
+interface PoolInfo {
+    poolAddress: string;
+    aumUsd: number;
+    lpTokenSupply: number;
+}
+/**
+ * @name registerAdrenaMarketSnapshotTool
+ * @description Register sap_market_snapshot — returns markets + prices + pool info
+ * in a single call with a 30-second TTL cache. Reduces x402 costs for polling bots.
+ * @internal
+ */
+export declare function registerAdrenaMarketSnapshotTool(server: Server, context: SapMcpContext): void;
+export {};
+//# sourceMappingURL=adrena-snapshot-tools.d.ts.map

package/dist/tools/adrena/adrena-snapshot-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrena-snapshot-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adrena/adrena-snapshot-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAiBzD,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,2CAA2C;AAC3C,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,UAAU,QAAQ;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAwG7F"}

package/dist/tools/adrena/adrena-snapshot-tools.js

@@ -0,0 +1,124 @@
+/**
+ * @name tools/adrena/adrena-snapshot-tools
+ * @description Market snapshot tool with TTL cache for reduced x402 costs.
+ *
+ * @module tools/adrena/adrena-snapshot-tools
+ */
+import { createTextResponse } from '../../adapters/mcp/tool-response.js';
+import { registerTool } from '../../adapters/mcp/sdk-compat.js';
+import { getConnection } from './adrena-helpers.js';
+import { adrenaDataApi } from '../../perps/adrena/adrena-data-api.js';
+import { ADRENA_MAIN_POOL_ADDRESS, ADRENA_CUSTODIES } from '../../perps/adrena/adrena-constants.js';
+import { logger } from '../../core/logger.js';
+/** TTL for the market snapshot cache in milliseconds. */
+const SNAPSHOT_CACHE_TTL_MS = 30_000;
+let snapshotCache = null;
+/**
+ * @name registerAdrenaMarketSnapshotTool
+ * @description Register sap_market_snapshot — returns markets + prices + pool info
+ * in a single call with a 30-second TTL cache. Reduces x402 costs for polling bots.
+ * @internal
+ */
+export function registerAdrenaMarketSnapshotTool(server, context) {
+    registerTool(server, 'sap_market_snapshot', {
+        description: 'Returns a complete market snapshot: all Adrena market data (leverage, OI, flags), live oracle prices, and pool health (AUM, LP supply) in one call. Includes a 30-second TTL cache — repeated calls within the cache window return cached data without re-fetching. Reduces market data costs by 20x for polling bots.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                forceRefresh: {
+                    type: 'boolean',
+                    description: 'When true, bypasses the cache and fetches fresh data. Default false.',
+                },
+            },
+            additionalProperties: false,
+        },
+    }, async (args) => {
+        try {
+            const forceRefresh = args['forceRefresh'] === true;
+            // Check cache first.
+            if (!forceRefresh && snapshotCache && Date.now() - snapshotCache.timestamp < SNAPSHOT_CACHE_TTL_MS) {
+                const cached = {
+                    ...snapshotCache.data,
+                    cached: true,
+                    timestamp: new Date(snapshotCache.timestamp).toISOString(),
+                };
+                return createTextResponse(JSON.stringify(cached, null, 2));
+            }
+            const connection = getConnection(context);
+            // Fetch prices from the Adrena Data API.
+            let prices = {};
+            try {
+                const tradingPrices = await adrenaDataApi.getLastTradingPrices();
+                if (tradingPrices && Array.isArray(tradingPrices)) {
+                    for (const p of tradingPrices) {
+                        if (p.symbol && p.priceUsd) {
+                            prices[p.symbol] = Number(p.priceUsd);
+                        }
+                    }
+                }
+            }
+            catch (priceErr) {
+                logger.warn('Market snapshot: failed to fetch trading prices', { error: priceErr instanceof Error ? priceErr.message : String(priceErr) });
+            }
+            // Read custody accounts on-chain for market data.
+            const markets = [];
+            for (const [symbol, custody] of Object.entries(ADRENA_CUSTODIES)) {
+                try {
+                    const custodyInfo = await connection.getAccountInfo(new (await import('@solana/web3.js')).PublicKey(custody.address), 'confirmed');
+                    if (!custodyInfo || !custodyInfo.data || custodyInfo.data.length < 184)
+                        continue;
+                    const d = custodyInfo.data;
+                    const allowTrade = d[10] === 1;
+                    const allowSwap = d[11] === 1;
+                    const maxInitialLeverageBps = d.readUInt32LE(176);
+                    const maxLeverageBps = d.readUInt32LE(180);
+                    const decimals = d[12];
+                    markets.push({
+                        symbol,
+                        pool: custody.pool === ADRENA_MAIN_POOL_ADDRESS ? 'main-pool' : 'commodities-pool',
+                        allowTrade,
+                        allowSwap,
+                        maxInitialLeverage: maxInitialLeverageBps / 10000,
+                        maxLeverage: maxLeverageBps / 10000,
+                        decimals,
+                    });
+                }
+                catch {
+                    // Skip unreadable custody.
+                }
+            }
+            // Read main pool account for pool health.
+            let poolInfo = { poolAddress: ADRENA_MAIN_POOL_ADDRESS, aumUsd: 0, lpTokenSupply: 0 };
+            try {
+                const poolInfo_raw = await connection.getAccountInfo(new (await import('@solana/web3.js')).PublicKey(ADRENA_MAIN_POOL_ADDRESS), 'confirmed');
+                if (poolInfo_raw && poolInfo_raw.data && poolInfo_raw.data.length >= 80) {
+                    const aumUsdRaw = poolInfo_raw.data.readBigUInt64LE(16) + (BigInt(poolInfo_raw.data.readBigUInt64LE(24)) << 64n);
+                    const lpTokenSupply = poolInfo_raw.data.readBigUInt64LE(32);
+                    poolInfo = {
+                        poolAddress: ADRENA_MAIN_POOL_ADDRESS,
+                        aumUsd: Number(aumUsdRaw) / 1e6,
+                        lpTokenSupply: Number(lpTokenSupply),
+                    };
+                }
+            }
+            catch {
+                // Best-effort pool read.
+            }
+            const result = {
+                timestamp: new Date().toISOString(),
+                cached: false,
+                cacheTtlSeconds: SNAPSHOT_CACHE_TTL_MS / 1000,
+                markets,
+                prices,
+                poolInfo,
+            };
+            // Update cache.
+            snapshotCache = { data: { ...result }, timestamp: Date.now() };
+            return createTextResponse(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            return createTextResponse(JSON.stringify({ error: 'Failed to build market snapshot', message: err instanceof Error ? err.message : 'Unknown error' }), { isError: true });
+        }
+    });
+}
+//# sourceMappingURL=adrena-snapshot-tools.js.map

package/dist/tools/adrena/adrena-snapshot-tools.js.map

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

package/dist/tools/adrena/adrena-staking-tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @name tools/adrena/adrena-staking-tools
+ * @description Staking builder tool registrations for Adrena.
+ *
+ * @module tools/adrena/adrena-staking-tools
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../../core/types.js';
+/**
+ * @name registerAdrenaStakingTools
+ * @description Register staking builder tools.
+ * @internal
+ */
+export declare function registerAdrenaStakingTools(server: Server, context: SapMcpContext): void;
+//# sourceMappingURL=adrena-staking-tools.d.ts.map

package/dist/tools/adrena/adrena-staking-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adrena-staking-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/adrena/adrena-staking-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmBzD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAsHvF"}