@waiaas/actions 2.6.0-rc.10

package/dist/providers/jupiter-swap/index.d.ts

@@ -0,0 +1,11 @@
+import type { IActionProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest } from '@waiaas/core';
+import { type JupiterSwapConfig } from './config.js';
+export declare class JupiterSwapActionProvider implements IActionProvider {
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    private readonly config;
+    private readonly apiClient;
+    constructor(config?: Partial<JupiterSwapConfig>);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/jupiter-swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/jupiter-swap/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,iBAAiB,EAA6C,MAAM,aAAa,CAAC;AAkBhG,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IA0BzC,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,CAAC;CAsEhC"}

package/dist/providers/jupiter-swap/index.js

@@ -0,0 +1,102 @@
+/**
+ * Jupiter Swap Action Provider.
+ *
+ * Implements IActionProvider to resolve Jupiter DEX swap requests
+ * into ContractCallRequest objects for the 6-stage pipeline.
+ */
+import { z } from 'zod';
+import { ChainError } from '@waiaas/core';
+import { JupiterApiClient } from './jupiter-api-client.js';
+import { JUPITER_SWAP_DEFAULTS, JUPITER_PROGRAM_ID } from './config.js';
+import { clampSlippageBps, asBps } from '../../common/slippage.js';
+// ---------------------------------------------------------------------------
+// Input schema for the swap action
+// ---------------------------------------------------------------------------
+const SwapInputSchema = z.object({
+    inputMint: z.string().min(1, 'inputMint is required'),
+    outputMint: z.string().min(1, 'outputMint is required'),
+    amount: z.string().min(1, 'amount is required (in smallest units)'),
+    slippageBps: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class JupiterSwapActionProvider {
+    metadata;
+    actions;
+    config;
+    apiClient;
+    constructor(config) {
+        this.config = { ...JUPITER_SWAP_DEFAULTS, ...config };
+        this.apiClient = new JupiterApiClient(this.config);
+        this.metadata = {
+            name: 'jupiter_swap',
+            description: 'Jupiter DEX aggregator for Solana token swaps with MEV protection',
+            version: '1.0.0',
+            chains: ['solana'],
+            mcpExpose: true,
+            requiresApiKey: false,
+            requiredApis: ['jupiter'],
+        };
+        this.actions = [
+            {
+                name: 'swap',
+                description: 'Swap tokens on Solana via Jupiter aggregator with slippage protection and Jito MEV tips',
+                chain: 'solana',
+                inputSchema: SwapInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        if (actionName !== 'swap') {
+            throw new ChainError('INVALID_INSTRUCTION', 'solana', { message: `Unknown action: ${actionName}` });
+        }
+        const input = SwapInputSchema.parse(params);
+        // SAFE-05: Block same-token swap
+        if (input.inputMint === input.outputMint) {
+            throw new ChainError('INVALID_INSTRUCTION', 'solana', { message: 'Cannot swap a token for itself' });
+        }
+        // SAFE-01/02: Clamp slippage
+        const slippageBps = clampSlippageBps(input.slippageBps ?? 0, asBps(this.config.defaultSlippageBps), asBps(this.config.maxSlippageBps));
+        // SWAP-01/06: Get quote with restrictIntermediateTokens=true
+        const quote = await this.apiClient.getQuote({
+            inputMint: input.inputMint,
+            outputMint: input.outputMint,
+            amount: input.amount,
+            slippageBps,
+            restrictIntermediateTokens: true,
+        });
+        // SAFE-03: Price impact check
+        const priceImpact = parseFloat(quote.priceImpactPct);
+        if (priceImpact > this.config.maxPriceImpactPct) {
+            throw new ChainError('PRICE_IMPACT_TOO_HIGH', 'solana', { message: `Price impact ${priceImpact}% exceeds max ${this.config.maxPriceImpactPct}%` });
+        }
+        // SWAP-02/SAFE-04: Get swap instructions with Jito MEV tip
+        const instructions = await this.apiClient.getSwapInstructions({
+            quoteResponse: quote,
+            userPublicKey: context.walletAddress,
+            jitoTipLamports: this.config.jitoTipLamports,
+        });
+        // SWAP-05: Verify program ID
+        if (instructions.swapInstruction.programId !== JUPITER_PROGRAM_ID) {
+            throw new ChainError('INVALID_INSTRUCTION', 'solana', { message: `Unexpected program ID: ${instructions.swapInstruction.programId} (expected ${JUPITER_PROGRAM_ID})` });
+        }
+        // SWAP-03: Convert to ContractCallRequest
+        const request = {
+            type: 'CONTRACT_CALL',
+            to: JUPITER_PROGRAM_ID,
+            programId: instructions.swapInstruction.programId,
+            instructionData: instructions.swapInstruction.data,
+            accounts: instructions.swapInstruction.accounts.map((a) => ({
+                pubkey: a.pubkey,
+                isSigner: a.isSigner,
+                isWritable: a.isWritable,
+            })),
+            network: context.chain === 'solana' ? undefined : undefined,
+        };
+        return request;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/jupiter-swap/index.js.map

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

package/dist/providers/jupiter-swap/jupiter-api-client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Jupiter REST API client (v1).
+ * Wraps /swap/v1/quote and /swap/v1/swap-instructions endpoints.
+ */
+import { ActionApiClient } from '../../common/action-api-client.js';
+import type { QuoteResponse, SwapInstructionsResponse } from './schemas.js';
+import type { JupiterSwapConfig } from './config.js';
+export declare class JupiterApiClient extends ActionApiClient {
+    constructor(config: JupiterSwapConfig);
+    getQuote(params: {
+        inputMint: string;
+        outputMint: string;
+        amount: string;
+        slippageBps: number;
+        restrictIntermediateTokens?: boolean;
+    }): Promise<QuoteResponse>;
+    getSwapInstructions(params: {
+        quoteResponse: QuoteResponse;
+        userPublicKey: string;
+        jitoTipLamports?: number;
+    }): Promise<SwapInstructionsResponse>;
+}
+//# sourceMappingURL=jupiter-api-client.d.ts.map

package/dist/providers/jupiter-swap/jupiter-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jupiter-api-client.d.ts","sourceRoot":"","sources":["../../../src/providers/jupiter-swap/jupiter-api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,qBAAa,gBAAiB,SAAQ,eAAe;gBACvC,MAAM,EAAE,iBAAiB;IAQ/B,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,0BAA0B,CAAC,EAAE,OAAO,CAAC;KACtC,GAAG,OAAO,CAAC,aAAa,CAAC;IAUpB,mBAAmB,CAAC,MAAM,EAAE;QAChC,aAAa,EAAE,aAAa,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAYtC"}

package/dist/providers/jupiter-swap/jupiter-api-client.js

@@ -0,0 +1,37 @@
+/**
+ * Jupiter REST API client (v1).
+ * Wraps /swap/v1/quote and /swap/v1/swap-instructions endpoints.
+ */
+import { ActionApiClient } from '../../common/action-api-client.js';
+import { QuoteResponseSchema, SwapInstructionsResponseSchema } from './schemas.js';
+export class JupiterApiClient extends ActionApiClient {
+    constructor(config) {
+        const headers = {};
+        if (config.apiKey) {
+            headers['x-api-key'] = config.apiKey;
+        }
+        super(config.apiBaseUrl, config.requestTimeoutMs, headers);
+    }
+    async getQuote(params) {
+        return this.get('quote', QuoteResponseSchema, {
+            inputMint: params.inputMint,
+            outputMint: params.outputMint,
+            amount: params.amount,
+            slippageBps: String(params.slippageBps),
+            restrictIntermediateTokens: String(params.restrictIntermediateTokens ?? true),
+        });
+    }
+    async getSwapInstructions(params) {
+        const body = {
+            quoteResponse: params.quoteResponse,
+            userPublicKey: params.userPublicKey,
+        };
+        if (params.jitoTipLamports && params.jitoTipLamports > 0) {
+            body.prioritizationFeeLamports = {
+                jitoTipLamports: params.jitoTipLamports,
+            };
+        }
+        return this.post('swap-instructions', body, SwapInstructionsResponseSchema);
+    }
+}
+//# sourceMappingURL=jupiter-api-client.js.map

package/dist/providers/jupiter-swap/jupiter-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jupiter-api-client.js","sourceRoot":"","sources":["../../../src/providers/jupiter-swap/jupiter-api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAInF,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD,YAAY,MAAyB;QACnC,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAMd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,EAAE;YAC5C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACvC,0BAA0B,EAAE,MAAM,CAAC,MAAM,CAAC,0BAA0B,IAAI,IAAI,CAAC;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAIzB;QACC,MAAM,IAAI,GAA4B;YACpC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;QACF,IAAI,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,yBAAyB,GAAG;gBAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,8BAA8B,CAAC,CAAC;IAC9E,CAAC;CACF"}