@oobe-protocol-labs/synapse-client-sdk 1.0.0-beta → 1.0.2

package/dist/cjs/ai/tools/protocols/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @module ai/tools/protocols
+ * @description Protocol Tools — unified barrel export + super-factory.
+ *
+ * Import individual protocol toolkits:
+ * ```ts
+ * import { createJupiterTools } from '.../protocols/jupiter';
+ * import { createRaydiumTools } from '.../protocols/raydium';
+ * import { createMetaplexTools } from '.../protocols/metaplex';
+ * ```
+ *
+ * Or use the unified super-factory:
+ * ```ts
+ * import { createProtocolTools } from '.../protocols';
+ * const all = createProtocolTools(client, { jupiter: {}, raydium: {} });
+ * ```
+ *
+ * @since 1.0.0
+ */
+export { type ProtocolMethod, type ProtocolToolkit, type ProtocolTool, type ProtocolClientConfig, type CreateProtocolToolsOpts, ProtocolHttpClient, ProtocolApiError, createMethodRegistry, buildProtocolTools, } from './shared';
+export { createJupiterTools, jupiterMethods, jupiterMethodNames, JUPITER_API_URL, type JupiterToolsConfig, } from './jupiter';
+export { createRaydiumTools, raydiumMethods, raydiumMethodNames, RAYDIUM_API_URL, type RaydiumToolsConfig, } from './raydium';
+export { createMetaplexTools, metaplexMethods, metaplexMethodNames, type MetaplexToolsConfig, } from './metaplex';
+import type { SynapseClient } from '../../../core/client';
+import { type JupiterToolsConfig } from './jupiter';
+import { type RaydiumToolsConfig } from './raydium';
+import { type MetaplexToolsConfig } from './metaplex';
+import type { ProtocolToolkit, ProtocolTool, CreateProtocolToolsOpts } from './shared';
+/**
+ * @description Configuration for the unified protocol tools super-factory.
+ * Pass `false` for any protocol to skip it entirely.
+ * @since 1.0.0
+ */
+export interface CreateProtocolToolsConfig {
+    /** Jupiter config — pass `false` to skip Jupiter tools entirely. */
+    jupiter?: JupiterToolsConfig & CreateProtocolToolsOpts | false;
+    /** Raydium config — pass `false` to skip Raydium tools entirely. */
+    raydium?: RaydiumToolsConfig & CreateProtocolToolsOpts | false;
+    /** Metaplex config — pass `false` to skip Metaplex tools entirely. */
+    metaplex?: MetaplexToolsConfig | false;
+}
+/**
+ * @description Result of the unified protocol tools super-factory.
+ * Contains per-protocol toolkits and a merged `allTools` array.
+ * @since 1.0.0
+ */
+export interface AllProtocolToolkits {
+    /** Jupiter toolkit (undefined if disabled). */
+    jupiter?: ProtocolToolkit;
+    /** Raydium toolkit (undefined if disabled). */
+    raydium?: ProtocolToolkit;
+    /** Metaplex toolkit (undefined if disabled). */
+    metaplex?: ProtocolToolkit;
+    /** Flat array of ALL tools across all enabled protocols — pass directly to an agent. */
+    allTools: ProtocolTool[];
+    /** Total number of tools. */
+    totalToolCount: number;
+    /** Map of protocol name → method count. */
+    protocolSummary: Record<string, number>;
+}
+/**
+ * @description Create tools for all Solana native protocols in a single call.
+ *
+ * @param {SynapseClient} client - Initialised SynapseClient (needed for Metaplex DAS)
+ * @param {CreateProtocolToolsConfig} [config={}] - Per-protocol configuration
+ * @returns {AllProtocolToolkits} Object with per-protocol toolkits and merged allTools array
+ *
+ * @example
+ * ```ts
+ * const client = new SynapseClient({ endpoint: '...' });
+ * const { allTools, jupiter, raydium, metaplex } = createProtocolTools(client, {
+ *   jupiter: { apiKey: 'my-jup-key' },
+ *   raydium: {},
+ *   metaplex: {},
+ * });
+ *
+ * // Pass everything to an agent:
+ * const agent = createAgent({ tools: allTools });
+ *
+ * // Or cherry-pick:
+ * const quoteTool = jupiter!.toolMap.getQuote;
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function createProtocolTools(client: SynapseClient, config?: CreateProtocolToolsConfig): AllProtocolToolkits;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ai/tools/protocols/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/tools/protocols/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAUpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,oEAAoE;IACpE,OAAO,CAAC,EAAE,kBAAkB,GAAG,uBAAuB,GAAG,KAAK,CAAC;IAC/D,oEAAoE;IACpE,OAAO,CAAC,EAAE,kBAAkB,GAAG,uBAAuB,GAAG,KAAK,CAAC;IAC/D,sEAAsE;IACtE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,GAAE,yBAA8B,GACrC,mBAAmB,CAqCrB"}

package/dist/cjs/ai/tools/protocols/index.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * @module ai/tools/protocols
+ * @description Protocol Tools — unified barrel export + super-factory.
+ *
+ * Import individual protocol toolkits:
+ * ```ts
+ * import { createJupiterTools } from '.../protocols/jupiter';
+ * import { createRaydiumTools } from '.../protocols/raydium';
+ * import { createMetaplexTools } from '.../protocols/metaplex';
+ * ```
+ *
+ * Or use the unified super-factory:
+ * ```ts
+ * import { createProtocolTools } from '.../protocols';
+ * const all = createProtocolTools(client, { jupiter: {}, raydium: {} });
+ * ```
+ *
+ * @since 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metaplexMethodNames = exports.metaplexMethods = exports.createMetaplexTools = exports.RAYDIUM_API_URL = exports.raydiumMethodNames = exports.raydiumMethods = exports.createRaydiumTools = exports.JUPITER_API_URL = exports.jupiterMethodNames = exports.jupiterMethods = exports.createJupiterTools = exports.buildProtocolTools = exports.createMethodRegistry = exports.ProtocolApiError = exports.ProtocolHttpClient = void 0;
+exports.createProtocolTools = createProtocolTools;
+// ── Shared infrastructure ──────────────────────────────────────
+var shared_1 = require("./shared");
+Object.defineProperty(exports, "ProtocolHttpClient", { enumerable: true, get: function () { return shared_1.ProtocolHttpClient; } });
+Object.defineProperty(exports, "ProtocolApiError", { enumerable: true, get: function () { return shared_1.ProtocolApiError; } });
+Object.defineProperty(exports, "createMethodRegistry", { enumerable: true, get: function () { return shared_1.createMethodRegistry; } });
+Object.defineProperty(exports, "buildProtocolTools", { enumerable: true, get: function () { return shared_1.buildProtocolTools; } });
+// ── Jupiter ────────────────────────────────────────────────────
+var jupiter_1 = require("./jupiter");
+Object.defineProperty(exports, "createJupiterTools", { enumerable: true, get: function () { return jupiter_1.createJupiterTools; } });
+Object.defineProperty(exports, "jupiterMethods", { enumerable: true, get: function () { return jupiter_1.jupiterMethods; } });
+Object.defineProperty(exports, "jupiterMethodNames", { enumerable: true, get: function () { return jupiter_1.jupiterMethodNames; } });
+Object.defineProperty(exports, "JUPITER_API_URL", { enumerable: true, get: function () { return jupiter_1.JUPITER_API_URL; } });
+// ── Raydium ────────────────────────────────────────────────────
+var raydium_1 = require("./raydium");
+Object.defineProperty(exports, "createRaydiumTools", { enumerable: true, get: function () { return raydium_1.createRaydiumTools; } });
+Object.defineProperty(exports, "raydiumMethods", { enumerable: true, get: function () { return raydium_1.raydiumMethods; } });
+Object.defineProperty(exports, "raydiumMethodNames", { enumerable: true, get: function () { return raydium_1.raydiumMethodNames; } });
+Object.defineProperty(exports, "RAYDIUM_API_URL", { enumerable: true, get: function () { return raydium_1.RAYDIUM_API_URL; } });
+// ── Metaplex ───────────────────────────────────────────────────
+var metaplex_1 = require("./metaplex");
+Object.defineProperty(exports, "createMetaplexTools", { enumerable: true, get: function () { return metaplex_1.createMetaplexTools; } });
+Object.defineProperty(exports, "metaplexMethods", { enumerable: true, get: function () { return metaplex_1.metaplexMethods; } });
+Object.defineProperty(exports, "metaplexMethodNames", { enumerable: true, get: function () { return metaplex_1.metaplexMethodNames; } });
+const jupiter_2 = require("./jupiter");
+const raydium_2 = require("./raydium");
+const metaplex_2 = require("./metaplex");
+/**
+ * @description Create tools for all Solana native protocols in a single call.
+ *
+ * @param {SynapseClient} client - Initialised SynapseClient (needed for Metaplex DAS)
+ * @param {CreateProtocolToolsConfig} [config={}] - Per-protocol configuration
+ * @returns {AllProtocolToolkits} Object with per-protocol toolkits and merged allTools array
+ *
+ * @example
+ * ```ts
+ * const client = new SynapseClient({ endpoint: '...' });
+ * const { allTools, jupiter, raydium, metaplex } = createProtocolTools(client, {
+ *   jupiter: { apiKey: 'my-jup-key' },
+ *   raydium: {},
+ *   metaplex: {},
+ * });
+ *
+ * // Pass everything to an agent:
+ * const agent = createAgent({ tools: allTools });
+ *
+ * // Or cherry-pick:
+ * const quoteTool = jupiter!.toolMap.getQuote;
+ * ```
+ *
+ * @since 1.0.0
+ */
+function createProtocolTools(client, config = {}) {
+    const allTools = [];
+    const protocolSummary = {};
+    let jupiter;
+    let raydium;
+    let metaplex;
+    // Jupiter
+    if (config.jupiter !== false) {
+        jupiter = (0, jupiter_2.createJupiterTools)(config.jupiter ?? {});
+        allTools.push(...jupiter.tools);
+        protocolSummary.jupiter = jupiter.tools.length;
+    }
+    // Raydium
+    if (config.raydium !== false) {
+        raydium = (0, raydium_2.createRaydiumTools)(config.raydium ?? {});
+        allTools.push(...raydium.tools);
+        protocolSummary.raydium = raydium.tools.length;
+    }
+    // Metaplex
+    if (config.metaplex !== false) {
+        metaplex = (0, metaplex_2.createMetaplexTools)(client, config.metaplex ?? {});
+        allTools.push(...metaplex.tools);
+        protocolSummary.metaplex = metaplex.tools.length;
+    }
+    return {
+        jupiter,
+        raydium,
+        metaplex,
+        allTools,
+        totalToolCount: allTools.length,
+        protocolSummary,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/ai/tools/protocols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai/tools/protocols/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAkHH,kDAwCC;AAxJD,kEAAkE;AAClE,mCAUkB;AAJhB,4GAAA,kBAAkB,OAAA;AAClB,0GAAA,gBAAgB,OAAA;AAChB,8GAAA,oBAAoB,OAAA;AACpB,4GAAA,kBAAkB,OAAA;AAGpB,kEAAkE;AAClE,qCAMmB;AALjB,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AAIjB,kEAAkE;AAClE,qCAMmB;AALjB,6GAAA,kBAAkB,OAAA;AAClB,yGAAA,cAAc,OAAA;AACd,6GAAA,kBAAkB,OAAA;AAClB,0GAAA,eAAe,OAAA;AAIjB,kEAAkE;AAClE,uCAKoB;AAJlB,+GAAA,mBAAmB,OAAA;AACnB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AAarB,uCAAwE;AACxE,uCAAwE;AACxE,yCAA2E;AAqC3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,mBAAmB,CACjC,MAAqB,EACrB,SAAoC,EAAE;IAEtC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,eAAe,GAA2B,EAAE,CAAC;IAEnD,IAAI,OAAoC,CAAC;IACzC,IAAI,OAAoC,CAAC;IACzC,IAAI,QAAqC,CAAC;IAE1C,UAAU;IACV,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAA,4BAAkB,EAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,eAAe,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,UAAU;IACV,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAA,4BAAkB,EAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,eAAe,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;IACjD,CAAC;IAED,WAAW;IACX,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC9B,QAAQ,GAAG,IAAA,8BAAmB,EAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC9D,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,eAAe,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,cAAc,EAAE,QAAQ,CAAC,MAAM;QAC/B,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/cjs/ai/tools/protocols/jupiter/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module ai/tools/protocols/jupiter
+ * @description Jupiter Protocol — barrel export for Jupiter DEX tools.
+ * @since 1.0.0
+ */
+export { jupiterMethods, jupiterMethodNames } from './schemas';
+export { createJupiterTools, JUPITER_API_URL, type JupiterToolsConfig, } from './tools';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/ai/tools/protocols/jupiter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/jupiter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC"}

package/dist/cjs/ai/tools/protocols/jupiter/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JUPITER_API_URL = exports.createJupiterTools = exports.jupiterMethodNames = exports.jupiterMethods = void 0;
+/**
+ * @module ai/tools/protocols/jupiter
+ * @description Jupiter Protocol — barrel export for Jupiter DEX tools.
+ * @since 1.0.0
+ */
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "jupiterMethods", { enumerable: true, get: function () { return schemas_1.jupiterMethods; } });
+Object.defineProperty(exports, "jupiterMethodNames", { enumerable: true, get: function () { return schemas_1.jupiterMethodNames; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "createJupiterTools", { enumerable: true, get: function () { return tools_1.createJupiterTools; } });
+Object.defineProperty(exports, "JUPITER_API_URL", { enumerable: true, get: function () { return tools_1.JUPITER_API_URL; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/ai/tools/protocols/jupiter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/jupiter/index.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qCAA+D;AAAtD,yGAAA,cAAc,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAC3C,iCAIiB;AAHf,2GAAA,kBAAkB,OAAA;AAClB,wGAAA,eAAe,OAAA"}

package/dist/cjs/ai/tools/protocols/jupiter/schemas.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @description All 22 registered Jupiter methods with typed Zod schemas.
+ * @since 1.0.0
+ */
+export declare const jupiterMethods: import("../shared").ProtocolMethod[];
+/**
+ * @description Jupiter method names as a readonly tuple for allow-listing.
+ * @since 1.0.0
+ */
+export declare const jupiterMethodNames: readonly string[];
+//# sourceMappingURL=schemas.d.ts.map

package/dist/cjs/ai/tools/protocols/jupiter/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/jupiter/schemas.ts"],"names":[],"mappings":"AAkhBA;;;GAGG;AACH,eAAO,MAAM,cAAc,sCAAU,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAiC,SAAS,MAAM,EAAE,CAAC"}

package/dist/cjs/ai/tools/protocols/jupiter/schemas.js

@@ -0,0 +1,386 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jupiterMethodNames = exports.jupiterMethods = void 0;
+/**
+ * @module ai/tools/protocols/jupiter/schemas
+ * @description Jupiter Protocol — Zod schemas for all 22 Jupiter API methods.
+ *
+ * Covers:
+ *  - Ultra Swap API   (6 methods)
+ *  - Metis Swap API   (4 methods)
+ *  - Price API v3     (1 method)
+ *  - Token API        (1 method)
+ *  - Trigger API      (5 methods — limit orders)
+ *  - Recurring API    (4 methods — DCA)
+ *
+ * @since 1.0.0
+ */
+const zod_1 = require("zod");
+const shared_1 = require("../shared");
+const { register, methods } = (0, shared_1.createMethodRegistry)('jupiter');
+/* ═══════════════════════════════════════════════════════════════
+ *  Shared Zod primitives
+ * ═══════════════════════════════════════════════════════════════ */
+const zMint = zod_1.z.string().describe('Token mint address (base58)');
+const zAmount = zod_1.z.string().describe('Raw token amount as string (no decimals)');
+const zSlippage = zod_1.z.number().min(0).max(10000).describe('Slippage tolerance in bps (e.g. 50 = 0.5%)');
+const zPubkey = zod_1.z.string().describe('Solana wallet public key (base58)');
+const zTxBase64 = zod_1.z.string().describe('Base64-encoded unsigned transaction');
+const zSignedTx = zod_1.z.string().describe('Base64-encoded signed transaction');
+/* ═══════════════════════════════════════════════════════════════
+ *  1. Ultra Swap API — /ultra/v1/*
+ * ═══════════════════════════════════════════════════════════════ */
+register('getOrder', zod_1.z.object({
+    inputMint: zMint,
+    outputMint: zMint,
+    amount: zAmount,
+    taker: zPubkey.describe('Taker (sender) wallet address'),
+    slippageBps: zSlippage.optional(),
+    referralAccount: zPubkey.optional().describe('Referral account for fee-sharing'),
+    referralFeeBps: zod_1.z.number().optional().describe('Referral fee in bps'),
+}), zod_1.z.object({
+    requestId: zod_1.z.string(),
+    inputMint: zMint,
+    outputMint: zMint,
+    inAmount: zAmount,
+    outAmount: zAmount,
+    otherAmountThreshold: zAmount,
+    swapMode: zod_1.z.string(),
+    slippageBps: zod_1.z.number(),
+    priceImpactPct: zod_1.z.string(),
+    routePlan: zod_1.z.array(zod_1.z.unknown()),
+    transaction: zTxBase64,
+    lastValidBlockHeight: zod_1.z.number(),
+    prioritizationFeeLamports: zod_1.z.number().optional(),
+    dynamicSlippageReport: zod_1.z.unknown().optional(),
+}), 'Get a quote + unsigned swap transaction in a single call (Ultra API). The recommended entry-point for swaps.', { httpMethod: 'GET', path: '/ultra/v1/order' });
+register('executeOrder', zod_1.z.object({
+    signedTransaction: zSignedTx,
+    requestId: zod_1.z.string().describe('requestId from getOrder response'),
+}), zod_1.z.object({
+    signature: zod_1.z.string(),
+    status: zod_1.z.enum(['Success', 'Failed', 'Expired']),
+    error: zod_1.z.string().optional(),
+    slot: zod_1.z.number().optional(),
+    inputAmountResult: zAmount.optional(),
+    outputAmountResult: zAmount.optional(),
+}), 'Execute a signed swap transaction obtained from getOrder and receive execution status.', { httpMethod: 'POST', path: '/ultra/v1/execute' });
+register('getHoldings', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet address to query balances for'),
+}), zod_1.z.object({
+    tokens: zod_1.z.array(zod_1.z.object({
+        mint: zMint,
+        amount: zAmount,
+        decimals: zod_1.z.number(),
+        uiAmount: zod_1.z.number(),
+        symbol: zod_1.z.string().optional(),
+        name: zod_1.z.string().optional(),
+        logoURI: zod_1.z.string().optional(),
+        priceUsd: zod_1.z.number().optional(),
+        valueUsd: zod_1.z.number().optional(),
+    })),
+    nativeBalance: zod_1.z.object({
+        lamports: zod_1.z.number(),
+        solUsd: zod_1.z.number().optional(),
+    }).optional(),
+}), 'Fetch all token balances and holdings for a wallet, including USD valuations.', { httpMethod: 'GET', path: '/ultra/v1/holdings' });
+register('shield', zod_1.z.object({
+    mints: zod_1.z.array(zMint).min(1).max(100).describe('Token mints to check'),
+}), zod_1.z.object({
+    warnings: zod_1.z.record(zMint, zod_1.z.array(zod_1.z.object({
+        severity: zod_1.z.enum(['info', 'warning', 'critical']),
+        type: zod_1.z.string(),
+        message: zod_1.z.string(),
+    }))),
+}), 'Check token mints for potential security risks (honeypot, freeze authority, low liquidity, etc.).', { httpMethod: 'GET', path: '/ultra/v1/shield' });
+register('searchTokens', zod_1.z.object({
+    query: zod_1.z.string().describe('Search by token symbol, name, or mint address'),
+}), zod_1.z.array(zod_1.z.object({
+    address: zMint,
+    name: zod_1.z.string(),
+    symbol: zod_1.z.string(),
+    decimals: zod_1.z.number(),
+    logoURI: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    daily_volume: zod_1.z.number().optional(),
+    freeze_authority: zod_1.z.string().nullable().optional(),
+    mint_authority: zod_1.z.string().nullable().optional(),
+})), 'Search for tokens by symbol, name, or mint address. Returns matching tokens with metadata.', { httpMethod: 'GET', path: '/ultra/v1/search' });
+register('getRouters', zod_1.z.object({}), zod_1.z.array(zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+})), 'List available routing engines in Ultra Swap (e.g. Juno).', { httpMethod: 'GET', path: '/ultra/v1/routers' });
+/* ═══════════════════════════════════════════════════════════════
+ *  2. Metis Swap API — /swap/v1/*
+ * ═══════════════════════════════════════════════════════════════ */
+register('getQuote', zod_1.z.object({
+    inputMint: zMint,
+    outputMint: zMint,
+    amount: zAmount,
+    slippageBps: zSlippage.optional(),
+    swapMode: zod_1.z.enum(['ExactIn', 'ExactOut']).optional(),
+    onlyDirectRoutes: zod_1.z.boolean().optional().describe('Restrict to single-hop routes'),
+    asLegacyTransaction: zod_1.z.boolean().optional().describe('Return a legacy transaction'),
+    maxAccounts: zod_1.z.number().optional().describe('Max accounts in transaction (default 64)'),
+    platformFeeBps: zod_1.z.number().optional().describe('Platform fee in bps'),
+    restrictIntermediateTokens: zod_1.z.boolean().optional(),
+    dynamicSlippage: zod_1.z.boolean().optional(),
+}), zod_1.z.object({
+    inputMint: zMint,
+    inAmount: zAmount,
+    outputMint: zMint,
+    outAmount: zAmount,
+    otherAmountThreshold: zAmount,
+    swapMode: zod_1.z.string(),
+    slippageBps: zod_1.z.number(),
+    priceImpactPct: zod_1.z.string(),
+    routePlan: zod_1.z.array(zod_1.z.object({
+        swapInfo: zod_1.z.object({
+            ammKey: zod_1.z.string(),
+            label: zod_1.z.string().optional(),
+            inputMint: zMint,
+            outputMint: zMint,
+            inAmount: zAmount,
+            outAmount: zAmount,
+            feeAmount: zAmount,
+            feeMint: zMint,
+        }),
+        percent: zod_1.z.number(),
+    })),
+    contextSlot: zod_1.z.number().optional(),
+    timeTaken: zod_1.z.number().optional(),
+}), 'Get an optimally-routed swap quote with full route plan details (Metis engine).', { httpMethod: 'GET', path: '/swap/v1/quote' });
+register('swap', zod_1.z.object({
+    userPublicKey: zPubkey,
+    wrapAndUnwrapSol: zod_1.z.boolean().optional().describe('Auto wrap/unwrap SOL (default true)'),
+    useSharedAccounts: zod_1.z.boolean().optional(),
+    feeAccount: zPubkey.optional().describe('Fee token account for platform fee collection'),
+    computeUnitPriceMicroLamports: zod_1.z.number().optional().describe('Priority fee in µ-lamports/CU'),
+    asLegacyTransaction: zod_1.z.boolean().optional(),
+    useTokenLedger: zod_1.z.boolean().optional(),
+    destinationTokenAccount: zPubkey.optional(),
+    dynamicComputeUnitLimit: zod_1.z.boolean().optional(),
+    skipUserAccountsRpcCalls: zod_1.z.boolean().optional(),
+    dynamicSlippage: zod_1.z.boolean().optional(),
+    quoteResponse: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).describe('The full quoteResponse object from getQuote'),
+}), zod_1.z.object({
+    swapTransaction: zTxBase64,
+    lastValidBlockHeight: zod_1.z.number(),
+    prioritizationFeeLamports: zod_1.z.number().optional(),
+    computeUnitLimit: zod_1.z.number().optional(),
+    prioritizationType: zod_1.z.object({ computeBudget: zod_1.z.unknown() }).optional(),
+    dynamicSlippageReport: zod_1.z.unknown().optional(),
+    simulationError: zod_1.z.unknown().optional(),
+}), 'Build an unsigned swap transaction from a quote response. Sign and send the returned transaction.', { httpMethod: 'POST', path: '/swap/v1/swap' });
+register('swapInstructions', zod_1.z.object({
+    userPublicKey: zPubkey,
+    wrapAndUnwrapSol: zod_1.z.boolean().optional(),
+    useSharedAccounts: zod_1.z.boolean().optional(),
+    feeAccount: zPubkey.optional(),
+    computeUnitPriceMicroLamports: zod_1.z.number().optional(),
+    asLegacyTransaction: zod_1.z.boolean().optional(),
+    useTokenLedger: zod_1.z.boolean().optional(),
+    destinationTokenAccount: zPubkey.optional(),
+    dynamicComputeUnitLimit: zod_1.z.boolean().optional(),
+    quoteResponse: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).describe('The full quoteResponse object from getQuote'),
+}), zod_1.z.object({
+    tokenLedgerInstruction: zod_1.z.unknown().nullable(),
+    computeBudgetInstructions: zod_1.z.array(zod_1.z.unknown()),
+    setupInstructions: zod_1.z.array(zod_1.z.unknown()),
+    swapInstruction: zod_1.z.unknown(),
+    cleanupInstruction: zod_1.z.unknown().nullable(),
+    addressLookupTableAddresses: zod_1.z.array(zod_1.z.string()),
+    otherInstructions: zod_1.z.array(zod_1.z.unknown()).optional(),
+}), 'Get individual swap instructions instead of a full transaction. Useful for composing with other instructions.', { httpMethod: 'POST', path: '/swap/v1/swap-instructions' });
+register('programLabels', zod_1.z.object({}), zod_1.z.record(zod_1.z.string(), zod_1.z.string()), 'Get a mapping from program ID to human-readable label for all DEX programs in the routing engine.', { httpMethod: 'GET', path: '/swap/v1/program-id-to-label' });
+/* ═══════════════════════════════════════════════════════════════
+ *  3. Price API v3 — /price/v3
+ * ═══════════════════════════════════════════════════════════════ */
+register('getPrice', zod_1.z.object({
+    ids: zod_1.z.array(zMint).min(1).max(100).describe('Token mints to price'),
+    vsToken: zMint.optional().describe('Quote token (default: USDC)'),
+    showExtraInfo: zod_1.z.boolean().optional().describe('Include confidence, depth, timestamps'),
+}), zod_1.z.object({
+    data: zod_1.z.record(zMint, zod_1.z.object({
+        id: zMint,
+        type: zod_1.z.string(),
+        price: zod_1.z.string(),
+        extraInfo: zod_1.z.object({
+            lastSwappedPrice: zod_1.z.object({
+                lastJupiterSellAt: zod_1.z.number().optional(),
+                lastJupiterSellPrice: zod_1.z.string().optional(),
+                lastJupiterBuyAt: zod_1.z.number().optional(),
+                lastJupiterBuyPrice: zod_1.z.string().optional(),
+            }).optional(),
+            quotedPrice: zod_1.z.object({
+                buyPrice: zod_1.z.string().optional(),
+                buyAt: zod_1.z.number().optional(),
+                sellPrice: zod_1.z.string().optional(),
+                sellAt: zod_1.z.number().optional(),
+            }).optional(),
+            confidenceLevel: zod_1.z.enum(['high', 'medium', 'low']).optional(),
+            depth: zod_1.z.object({
+                buyPriceImpactRatio: zod_1.z.unknown().optional(),
+                sellPriceImpactRatio: zod_1.z.unknown().optional(),
+            }).optional(),
+        }).optional(),
+    })),
+    timeTaken: zod_1.z.number(),
+}), 'Get real-time heuristic prices for tokens. Supports buy/sell price, confidence, and depth info.', { httpMethod: 'GET', path: '/price/v3' });
+/* ═══════════════════════════════════════════════════════════════
+ *  4. Token API — /tokens/v1
+ * ═══════════════════════════════════════════════════════════════ */
+register('getTokenList', zod_1.z.object({
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Filter by tags (e.g. "verified", "community")'),
+}), zod_1.z.array(zod_1.z.object({
+    address: zMint,
+    name: zod_1.z.string(),
+    symbol: zod_1.z.string(),
+    decimals: zod_1.z.number(),
+    logoURI: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()),
+    daily_volume: zod_1.z.number().optional(),
+    created_at: zod_1.z.string().optional(),
+    freeze_authority: zod_1.z.string().nullable().optional(),
+    mint_authority: zod_1.z.string().nullable().optional(),
+    permanent_delegate: zod_1.z.string().nullable().optional(),
+    minted_at: zod_1.z.string().nullable().optional(),
+    extensions: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+})), 'Get the full Jupiter verified token list with metadata, tags, and daily volume.', { httpMethod: 'GET', path: '/tokens/v1' });
+/* ═══════════════════════════════════════════════════════════════
+ *  5. Trigger API — /trigger/v1/* (Limit Orders)
+ * ═══════════════════════════════════════════════════════════════ */
+register('createLimitOrder', zod_1.z.object({
+    maker: zPubkey.describe('Wallet address of the order creator'),
+    payer: zPubkey.describe('Wallet paying for transaction fees'),
+    inputMint: zMint,
+    outputMint: zMint,
+    makingAmount: zAmount.describe('Amount of input token to sell'),
+    takingAmount: zAmount.describe('Amount of output token to receive'),
+    expiredAt: zod_1.z.string().optional().describe('ISO 8601 expiry timestamp'),
+    feeBps: zod_1.z.number().optional().describe('Referral fee in bps'),
+    computeUnitPrice: zod_1.z.string().optional().describe('Priority fee (µ-lamports/CU)'),
+}), zod_1.z.object({
+    order: zod_1.z.string().describe('Order public key'),
+    tx: zTxBase64,
+}), 'Create a limit order. Returns an unsigned transaction — sign and submit via executeTrigger.', { httpMethod: 'POST', path: '/trigger/v1/createOrder' });
+register('executeTrigger', zod_1.z.object({
+    signedTransaction: zSignedTx,
+}), zod_1.z.object({
+    signature: zod_1.z.string(),
+    status: zod_1.z.enum(['Success', 'Failed', 'Expired']),
+    error: zod_1.z.string().optional(),
+}), 'Submit a signed limit-order transaction for on-chain execution.', { httpMethod: 'POST', path: '/trigger/v1/execute' });
+register('cancelLimitOrder', zod_1.z.object({
+    maker: zPubkey,
+    order: zod_1.z.string().describe('Order public key to cancel'),
+    computeUnitPrice: zod_1.z.string().optional(),
+}), zod_1.z.object({
+    tx: zTxBase64,
+}), 'Create an unsigned transaction to cancel a specific limit order.', { httpMethod: 'POST', path: '/trigger/v1/cancelOrder' });
+register('cancelLimitOrders', zod_1.z.object({
+    maker: zPubkey,
+    orders: zod_1.z.array(zod_1.z.string()).describe('Array of order public keys to cancel'),
+    computeUnitPrice: zod_1.z.string().optional(),
+}), zod_1.z.object({
+    txs: zod_1.z.array(zTxBase64),
+}), 'Create unsigned transactions to cancel multiple limit orders in batch.', { httpMethod: 'POST', path: '/trigger/v1/cancelOrders' });
+register('getLimitOrders', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet address to query'),
+    includeHistory: zod_1.z.boolean().optional().describe('Include completed / cancelled orders'),
+    inputMint: zMint.optional(),
+    outputMint: zMint.optional(),
+    page: zod_1.z.number().optional(),
+    limit: zod_1.z.number().optional(),
+}), zod_1.z.object({
+    orders: zod_1.z.array(zod_1.z.object({
+        orderKey: zod_1.z.string(),
+        maker: zPubkey,
+        inputMint: zMint,
+        outputMint: zMint,
+        makingAmount: zAmount,
+        takingAmount: zAmount,
+        remainingMakingAmount: zAmount,
+        remainingTakingAmount: zAmount,
+        expiredAt: zod_1.z.string().nullable(),
+        createdAt: zod_1.z.string(),
+        updatedAt: zod_1.z.string(),
+        status: zod_1.z.string(),
+    })),
+    total: zod_1.z.number().optional(),
+    page: zod_1.z.number().optional(),
+}), 'Get all limit orders (active and optionally historical) for a wallet.', { httpMethod: 'GET', path: '/trigger/v1/getTriggerOrders' });
+/* ═══════════════════════════════════════════════════════════════
+ *  6. Recurring API — /recurring/v1/* (DCA)
+ * ═══════════════════════════════════════════════════════════════ */
+register('createDCA', zod_1.z.object({
+    payer: zPubkey.describe('Wallet paying for the DCA setup'),
+    maker: zPubkey.describe('Wallet executing the DCA'),
+    inputMint: zMint,
+    outputMint: zMint,
+    totalInAmount: zAmount.describe('Total amount of input token to DCA'),
+    frequency: zod_1.z.enum(['hourly', 'daily', 'weekly', 'monthly', 'yearly']).describe('DCA interval'),
+    numberOfOrders: zod_1.z.number().int().positive().describe('Total number of orders to split into'),
+    minOutAmountPerOrder: zAmount.optional().describe('Minimum output per order (slippage protection)'),
+    maxOutAmountPerOrder: zAmount.optional().describe('Maximum output per order'),
+    startAt: zod_1.z.string().optional().describe('ISO 8601 start timestamp (default: now)'),
+}), zod_1.z.object({
+    order: zod_1.z.string().describe('DCA order public key'),
+    tx: zTxBase64,
+}), 'Create a Dollar-Cost Averaging (DCA) recurring order. Returns an unsigned transaction.', { httpMethod: 'POST', path: '/recurring/v1/createOrder' });
+register('executeDCA', zod_1.z.object({
+    signedTransaction: zSignedTx,
+}), zod_1.z.object({
+    signature: zod_1.z.string(),
+    status: zod_1.z.enum(['Success', 'Failed', 'Expired']),
+    error: zod_1.z.string().optional(),
+}), 'Submit a signed DCA order creation/cancellation transaction.', { httpMethod: 'POST', path: '/recurring/v1/execute' });
+register('cancelDCA', zod_1.z.object({
+    maker: zPubkey,
+    order: zod_1.z.string().describe('DCA order public key to cancel'),
+    computeUnitPrice: zod_1.z.string().optional(),
+}), zod_1.z.object({
+    tx: zTxBase64,
+}), 'Create an unsigned transaction to cancel a DCA recurring order.', { httpMethod: 'POST', path: '/recurring/v1/cancelOrder' });
+register('getDCAOrders', zod_1.z.object({
+    wallet: zPubkey.describe('Wallet address to query'),
+    includeHistory: zod_1.z.boolean().optional(),
+    inputMint: zMint.optional(),
+    outputMint: zMint.optional(),
+    page: zod_1.z.number().optional(),
+    limit: zod_1.z.number().optional(),
+}), zod_1.z.object({
+    orders: zod_1.z.array(zod_1.z.object({
+        orderKey: zod_1.z.string(),
+        maker: zPubkey,
+        inputMint: zMint,
+        outputMint: zMint,
+        totalInAmount: zAmount,
+        totalOutAmount: zAmount,
+        remainingInAmount: zAmount,
+        frequency: zod_1.z.string(),
+        numberOfOrders: zod_1.z.number(),
+        completedOrders: zod_1.z.number(),
+        nextExecutionAt: zod_1.z.string().nullable(),
+        createdAt: zod_1.z.string(),
+        updatedAt: zod_1.z.string(),
+        status: zod_1.z.string(),
+    })),
+    total: zod_1.z.number().optional(),
+    page: zod_1.z.number().optional(),
+}), 'Get all DCA orders (active and optionally historical) for a wallet.', { httpMethod: 'GET', path: '/recurring/v1/getRecurringOrders' });
+/* ═══════════════════════════════════════════════════════════════
+ *  Export
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description All 22 registered Jupiter methods with typed Zod schemas.
+ * @since 1.0.0
+ */
+exports.jupiterMethods = methods;
+/**
+ * @description Jupiter method names as a readonly tuple for allow-listing.
+ * @since 1.0.0
+ */
+exports.jupiterMethodNames = methods.map((m) => m.name);
+//# sourceMappingURL=schemas.js.map