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

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

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metaplexMethodNames = exports.metaplexMethods = void 0;
+exports.createMetaplexTools = createMetaplexTools;
+/**
+ * @module ai/tools/protocols/metaplex/tools
+ * @description Metaplex Protocol — LangChain tool factory.
+ *
+ * Creates 12 executable tools that call DAS methods through the Solana RPC
+ * transport (no external REST API needed — DAS is an RPC extension).
+ *
+ * ```ts
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * const client = new SynapseClient({ endpoint: '...' });
+ * const metaplex = createMetaplexTools(client);
+ * ```
+ *
+ * @since 1.0.0
+ */
+const shared_1 = require("../shared");
+const schemas_1 = require("./schemas");
+/* ═══════════════════════════════════════════════════════════════
+ *  DAS RPC method name mapping
+ *
+ *  Maps our public tool names → actual JSON-RPC method names
+ *  used by the DAS extension on the Solana RPC node.
+ * ═══════════════════════════════════════════════════════════════ */
+const DAS_RPC_METHODS = {
+    getAsset: 'getAsset',
+    getAssets: 'getAssetBatch',
+    getAssetProof: 'getAssetProof',
+    getAssetProofs: 'getAssetProofBatch',
+    getAssetsByOwner: 'getAssetsByOwner',
+    getAssetsByCreator: 'getAssetsByCreator',
+    getAssetsByCollection: 'getAssetsByGroup',
+    getAssetsByAuthority: 'getAssetsByAuthority',
+    searchAssets: 'searchAssets',
+    getAssetSignatures: 'getSignaturesForAsset',
+    getTokenAccounts: 'getTokenAccounts',
+};
+/* ═══════════════════════════════════════════════════════════════
+ *  Execution dispatcher — DAS via RPC transport
+ * ═══════════════════════════════════════════════════════════════ */
+function createMetaplexExecutor(transport) {
+    return async (method, input) => {
+        const rpcMethod = DAS_RPC_METHODS[method.name];
+        // ── resolveCollection: compound helper ──────────────────
+        if (method.name === 'resolveCollection') {
+            return executeResolveCollection(transport, input);
+        }
+        if (!rpcMethod) {
+            throw new Error(`Unknown Metaplex DAS method: ${method.name}`);
+        }
+        // Strip the commitment field — DAS methods embed it in the params object
+        const { commitment, ...params } = input;
+        // DAS methods expect a single params array element
+        const rpcParams = commitment
+            ? [{ ...params, commitment }]
+            : [params];
+        // For single-ID methods, unwrap to match the DAS API signature
+        if (method.name === 'getAsset' || method.name === 'getAssetProof') {
+            return transport.request(rpcMethod, [{ id: params.id, ...(commitment ? { commitment } : {}) }]);
+        }
+        if (method.name === 'getAssets' || method.name === 'getAssetProofs') {
+            return transport.request(rpcMethod, [{ ids: params.ids, ...(commitment ? { commitment } : {}) }]);
+        }
+        return transport.request(rpcMethod, rpcParams);
+    };
+}
+/**
+ * resolveCollection — compound helper that:
+ * 1. Fetches the collection asset metadata
+ * 2. Fetches a sample page of items in the collection
+ * 3. Computes stats (unique owners, compressed count, traits)
+ */
+async function executeResolveCollection(transport, input) {
+    const collectionAddress = input.collectionAddress;
+    const sampleSize = input.sampleSize || 10;
+    const commitment = input.commitment;
+    const commitmentParam = commitment ? { commitment } : {};
+    // Fetch collection asset + sample items in parallel
+    const [collection, page] = await Promise.all([
+        transport.request('getAsset', [{ id: collectionAddress, ...commitmentParam }]),
+        transport.request('getAssetsByGroup', [{
+                groupKey: 'collection',
+                groupValue: collectionAddress,
+                limit: sampleSize,
+                page: 1,
+                ...commitmentParam,
+            }]),
+    ]);
+    // Compute stats from the sample
+    const items = page?.items ?? [];
+    const owners = new Set();
+    let compressedCount = 0;
+    let burnedCount = 0;
+    const traitMap = {};
+    for (const item of items) {
+        if (item?.ownership?.owner)
+            owners.add(item.ownership.owner);
+        if (item?.compression?.compressed)
+            compressedCount++;
+        if (item?.burnt)
+            burnedCount++;
+        const attrs = item?.content?.metadata?.attributes;
+        if (Array.isArray(attrs)) {
+            for (const attr of attrs) {
+                if (!attr.trait_type || !attr.value)
+                    continue;
+                if (!traitMap[attr.trait_type])
+                    traitMap[attr.trait_type] = new Set();
+                traitMap[attr.trait_type].add(String(attr.value));
+            }
+        }
+    }
+    // Convert sets to arrays for serialisation
+    const traitSummary = {};
+    for (const [k, v] of Object.entries(traitMap)) {
+        traitSummary[k] = [...v];
+    }
+    return {
+        collection,
+        stats: {
+            totalSupply: page?.total ?? items.length,
+            sampleSize: items.length,
+            uniqueOwners: owners.size,
+            compressedCount,
+            burnedCount,
+            traitSummary,
+        },
+    };
+}
+/**
+ * @description Create LangChain-compatible tools for Metaplex DAS API.
+ *
+ * Unlike Jupiter/Raydium, Metaplex tools use the Solana RPC transport
+ * (DAS is an extension of the JSON-RPC interface).
+ *
+ * @param {SynapseClient} client - Initialised SynapseClient (provides HttpTransport)
+ * @param {MetaplexToolsConfig} [opts={}] - Tool creation options
+ * @returns {ProtocolToolkit} Toolkit with 12 Metaplex DAS tools
+ *
+ * @example
+ * ```ts
+ * const client = new SynapseClient({ endpoint: 'https://...' });
+ * const metaplex = createMetaplexTools(client);
+ * const nfts = metaplex.toolMap.getAssetsByOwner;
+ * ```
+ *
+ * @since 1.0.0
+ */
+function createMetaplexTools(client, opts = {}) {
+    const execute = createMetaplexExecutor(client.transport);
+    return (0, shared_1.buildProtocolTools)(schemas_1.metaplexMethods, execute, {
+        defaultPrefix: 'metaplex_',
+        ...opts,
+    });
+}
+/** Re-export schemas for direct access. */
+var schemas_2 = require("./schemas");
+Object.defineProperty(exports, "metaplexMethods", { enumerable: true, get: function () { return schemas_2.metaplexMethods; } });
+Object.defineProperty(exports, "metaplexMethodNames", { enumerable: true, get: function () { return schemas_2.metaplexMethodNames; } });
+//# sourceMappingURL=tools.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * @module ai/tools/protocols/raydium
+ * @description Raydium Protocol — barrel export for Raydium AMM tools.
+ * @since 1.0.0
+ */
+export { raydiumMethods, raydiumMethodNames } from './schemas';
+export { createRaydiumTools, RAYDIUM_API_URL, type RaydiumToolsConfig, } from './tools';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/raydium/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/raydium/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAYDIUM_API_URL = exports.createRaydiumTools = exports.raydiumMethodNames = exports.raydiumMethods = void 0;
+/**
+ * @module ai/tools/protocols/raydium
+ * @description Raydium Protocol — barrel export for Raydium AMM tools.
+ * @since 1.0.0
+ */
+var schemas_1 = require("./schemas");
+Object.defineProperty(exports, "raydiumMethods", { enumerable: true, get: function () { return schemas_1.raydiumMethods; } });
+Object.defineProperty(exports, "raydiumMethodNames", { enumerable: true, get: function () { return schemas_1.raydiumMethodNames; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "createRaydiumTools", { enumerable: true, get: function () { return tools_1.createRaydiumTools; } });
+Object.defineProperty(exports, "RAYDIUM_API_URL", { enumerable: true, get: function () { return tools_1.RAYDIUM_API_URL; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/raydium/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/raydium/schemas.d.ts

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

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

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

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

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raydiumMethodNames = exports.raydiumMethods = void 0;
+/**
+ * @module ai/tools/protocols/raydium/schemas
+ * @description Raydium Protocol — Zod schemas for all 16 Raydium API v3 methods.
+ *
+ * Covers:
+ *  - Main / Info     (5 methods)
+ *  - Mint / Token    (3 methods)
+ *  - Pools           (6 methods)
+ *  - Farms           (2 methods)
+ *
+ * API reference: https://api-v3.raydium.io/docs/
+ *
+ * @since 1.0.0
+ */
+const zod_1 = require("zod");
+const shared_1 = require("../shared");
+const { register, methods } = (0, shared_1.createMethodRegistry)('raydium');
+/* ═══════════════════════════════════════════════════════════════
+ *  Shared Zod primitives
+ * ═══════════════════════════════════════════════════════════════ */
+const zMint = zod_1.z.string().describe('Token mint address (base58)');
+const zPoolId = zod_1.z.string().describe('Raydium pool ID');
+/* ═══════════════════════════════════════════════════════════════
+ *  1. Main / Info — /main/*
+ * ═══════════════════════════════════════════════════════════════ */
+register('getInfo', zod_1.z.object({}), zod_1.z.object({
+    tvl: zod_1.z.number().describe('Total value locked in USD'),
+    volume24h: zod_1.z.number().describe('24h trading volume in USD'),
+    totalLiquidity: zod_1.z.number().optional(),
+    totalSwapVolume: zod_1.z.number().optional(),
+}), 'Get Raydium protocol-wide stats: TVL and 24-hour trading volume.', { httpMethod: 'GET', path: '/main/info' });
+register('getChainTime', zod_1.z.object({}), zod_1.z.object({
+    chainTime: zod_1.z.number().describe('Current Solana chain timestamp (Unix seconds)'),
+    offset: zod_1.z.number().optional().describe('Offset from local clock'),
+}), 'Get the current Solana chain time from Raydium nodes.', { httpMethod: 'GET', path: '/main/chain-time' });
+register('getClmmConfig', zod_1.z.object({}), zod_1.z.array(zod_1.z.object({
+    id: zod_1.z.string(),
+    index: zod_1.z.number(),
+    protocolFeeRate: zod_1.z.number(),
+    tradeFeeRate: zod_1.z.number(),
+    tickSpacing: zod_1.z.number(),
+    fundFeeRate: zod_1.z.number(),
+    defaultRange: zod_1.z.number().optional(),
+    defaultRangePoint: zod_1.z.array(zod_1.z.number()).optional(),
+})), 'Get configuration for all CLMM (Concentrated Liquidity) pool tiers, including fee rates and tick spacing.', { httpMethod: 'GET', path: '/main/clmm-config' });
+register('getCpmmConfig', zod_1.z.object({}), zod_1.z.array(zod_1.z.object({
+    id: zod_1.z.string(),
+    index: zod_1.z.number(),
+    protocolFeeRate: zod_1.z.number(),
+    tradeFeeRate: zod_1.z.number(),
+    fundFeeRate: zod_1.z.number(),
+    createPoolFee: zod_1.z.string(),
+})), 'Get configuration for all CPMM (Constant Product) pool tiers, including fee rates and pool creation costs.', { httpMethod: 'GET', path: '/main/cpmm-config' });
+register('getAutoFee', zod_1.z.object({}), zod_1.z.object({
+    fee: zod_1.z.number().describe('Recommended transaction priority fee (lamports)'),
+    feeLevel: zod_1.z.string().optional().describe('Fee urgency level'),
+}), 'Get the recommended auto-computed transaction priority fee.', { httpMethod: 'GET', path: '/main/auto-fee' });
+/* ═══════════════════════════════════════════════════════════════
+ *  2. Mint / Token — /mint/*
+ * ═══════════════════════════════════════════════════════════════ */
+register('getMintList', zod_1.z.object({}), zod_1.z.array(zod_1.z.object({
+    address: zMint,
+    name: zod_1.z.string().optional(),
+    symbol: zod_1.z.string().optional(),
+    decimals: zod_1.z.number(),
+    logoURI: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    extensions: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    priority: zod_1.z.number().optional(),
+})), 'Get the Raydium default token mint list with metadata.', { httpMethod: 'GET', path: '/mint/list' });
+register('getMintInfo', zod_1.z.object({
+    mints: zod_1.z.array(zMint).min(1).max(100).describe('Token mint addresses to query'),
+}), zod_1.z.array(zod_1.z.object({
+    address: zMint,
+    name: zod_1.z.string().optional(),
+    symbol: zod_1.z.string().optional(),
+    decimals: zod_1.z.number(),
+    logoURI: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    extensions: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    freezeAuthority: zod_1.z.string().nullable().optional(),
+    mintAuthority: zod_1.z.string().nullable().optional(),
+})), 'Get detailed token mint info for one or more mints.', { httpMethod: 'GET', path: '/mint/ids' });
+register('getMintPrice', zod_1.z.object({
+    mints: zod_1.z.array(zMint).min(1).max(100).describe('Token mint addresses to price'),
+}), zod_1.z.record(zMint, zod_1.z.number()), 'Get USD prices for one or more token mints.', { httpMethod: 'GET', path: '/mint/price' });
+/* ═══════════════════════════════════════════════════════════════
+ *  3. Pools — /pools/*
+ * ═══════════════════════════════════════════════════════════════ */
+const zPoolInfo = zod_1.z.object({
+    id: zPoolId,
+    type: zod_1.z.enum(['Standard', 'Concentrated', 'Cpmm']).describe('Pool type (AMM v4 / CLMM / CPMM)'),
+    mintA: zod_1.z.object({ address: zMint, symbol: zod_1.z.string().optional(), decimals: zod_1.z.number(), logoURI: zod_1.z.string().optional() }),
+    mintB: zod_1.z.object({ address: zMint, symbol: zod_1.z.string().optional(), decimals: zod_1.z.number(), logoURI: zod_1.z.string().optional() }),
+    price: zod_1.z.number().describe('Current price of mintA in terms of mintB'),
+    tvl: zod_1.z.number().describe('Total value locked in USD'),
+    feeRate: zod_1.z.number().describe('Trading fee rate'),
+    volume24h: zod_1.z.number().optional(),
+    fee24h: zod_1.z.number().optional(),
+    apr24h: zod_1.z.number().optional(),
+    apr7d: zod_1.z.number().optional(),
+    apr30d: zod_1.z.number().optional(),
+    lpMint: zod_1.z.object({ address: zMint, decimals: zod_1.z.number() }).optional(),
+    farmCount: zod_1.z.number().optional(),
+    isOpenBook: zod_1.z.boolean().optional(),
+    programId: zod_1.z.string(),
+});
+register('getPoolInfo', zod_1.z.object({
+    ids: zod_1.z.array(zPoolId).min(1).max(100).describe('Pool IDs to query'),
+}), zod_1.z.array(zPoolInfo), 'Get detailed pool info (TVL, price, APR, volume) for specific Raydium pool IDs.', { httpMethod: 'GET', path: '/pools/info/ids' });
+register('getPoolsByLpMint', zod_1.z.object({
+    lpMints: zod_1.z.array(zMint).min(1).max(100).describe('LP mint addresses'),
+}), zod_1.z.array(zPoolInfo), 'Find Raydium pools by their LP token mint address.', { httpMethod: 'GET', path: '/pools/info/lps' });
+register('getPoolList', zod_1.z.object({
+    type: zod_1.z.enum(['all', 'standard', 'concentrated', 'cpmm', 'allFarm']).optional().describe('Filter by pool type'),
+    sort: zod_1.z.enum(['liquidity', 'volume24h', 'fee24h', 'apr24h', 'apr7d', 'apr30d']).optional(),
+    order: zod_1.z.enum(['asc', 'desc']).optional(),
+    page: zod_1.z.number().int().positive().optional(),
+    pageSize: zod_1.z.number().int().positive().max(1000).optional(),
+}), zod_1.z.object({
+    count: zod_1.z.number(),
+    data: zod_1.z.array(zPoolInfo),
+    hasNextPage: zod_1.z.boolean(),
+}), 'Get a paginated, sortable list of all Raydium pools with full stats.', { httpMethod: 'GET', path: '/pools/info/list' });
+register('getPoolsByTokenMint', zod_1.z.object({
+    mint1: zMint.describe('First token mint'),
+    mint2: zMint.optional().describe('Second token mint (narrows to specific pair)'),
+    type: zod_1.z.enum(['all', 'standard', 'concentrated', 'cpmm']).optional(),
+    sort: zod_1.z.enum(['liquidity', 'volume24h', 'fee24h', 'apr24h']).optional(),
+    order: zod_1.z.enum(['asc', 'desc']).optional(),
+    page: zod_1.z.number().int().positive().optional(),
+    pageSize: zod_1.z.number().int().positive().max(1000).optional(),
+}), zod_1.z.object({
+    count: zod_1.z.number(),
+    data: zod_1.z.array(zPoolInfo),
+    hasNextPage: zod_1.z.boolean(),
+}), 'Find Raydium pools by token mint(s). Great for discovering where to swap a specific token.', { httpMethod: 'GET', path: '/pools/info/mint' });
+register('getPoolLiquidity', zod_1.z.object({
+    poolId: zPoolId,
+    period: zod_1.z.enum(['1h', '4h', '1d', '1w', '1m']).optional().describe('Aggregation period'),
+}), zod_1.z.object({
+    poolId: zPoolId,
+    data: zod_1.z.array(zod_1.z.object({
+        time: zod_1.z.number(),
+        liquidity: zod_1.z.number(),
+    })),
+}), 'Get historical liquidity data for a pool (useful for charting).', { httpMethod: 'GET', path: '/pools/line/liquidity' });
+register('getClmmPosition', zod_1.z.object({
+    poolId: zPoolId,
+}), zod_1.z.object({
+    poolId: zPoolId,
+    data: zod_1.z.array(zod_1.z.object({
+        priceLower: zod_1.z.number(),
+        priceUpper: zod_1.z.number(),
+        liquidity: zod_1.z.string(),
+        amountA: zod_1.z.string(),
+        amountB: zod_1.z.string(),
+    })),
+}), 'Get current CLMM concentrated liquidity position distribution for a pool.', { httpMethod: 'GET', path: '/pools/line/position' });
+/* ═══════════════════════════════════════════════════════════════
+ *  4. Farms — /farms/*
+ * ═══════════════════════════════════════════════════════════════ */
+const zFarmInfo = zod_1.z.object({
+    id: zod_1.z.string(),
+    lpMint: zod_1.z.object({ address: zMint, decimals: zod_1.z.number() }),
+    baseMint: zMint.optional(),
+    quoteMint: zMint.optional(),
+    rewardInfos: zod_1.z.array(zod_1.z.object({
+        mint: zod_1.z.object({ address: zMint, symbol: zod_1.z.string().optional(), decimals: zod_1.z.number() }),
+        perSecond: zod_1.z.string().optional(),
+        perDay: zod_1.z.string().optional(),
+        openTime: zod_1.z.number().optional(),
+        endTime: zod_1.z.number().optional(),
+        type: zod_1.z.string().optional(),
+    })),
+    apr: zod_1.z.number().optional(),
+    tvl: zod_1.z.number().optional(),
+    programId: zod_1.z.string(),
+});
+register('getFarmInfo', zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).max(100).describe('Farm IDs to query'),
+}), zod_1.z.array(zFarmInfo), 'Get detailed farm info (APR, rewards, TVL) for specific Raydium farm IDs.', { httpMethod: 'GET', path: '/farms/info/ids' });
+register('getFarmByLpMint', zod_1.z.object({
+    lpMints: zod_1.z.array(zMint).min(1).max(100).describe('LP mint addresses to search farms for'),
+}), zod_1.z.array(zFarmInfo), 'Find Raydium yield farms by the LP mint address they accept.', { httpMethod: 'GET', path: '/farms/info/lp' });
+/* ═══════════════════════════════════════════════════════════════
+ *  Export
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description All 16 registered Raydium methods with typed Zod schemas.
+ * @since 1.0.0
+ */
+exports.raydiumMethods = methods;
+/**
+ * @description Raydium method names as a readonly tuple for allow-listing.
+ * @since 1.0.0
+ */
+exports.raydiumMethodNames = methods.map((m) => m.name);
+//# sourceMappingURL=schemas.js.map

package/dist/cjs/ai/tools/protocols/raydium/schemas.js.map

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

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

@@ -0,0 +1,50 @@
+/**
+ * @module ai/tools/protocols/raydium/tools
+ * @description Raydium Protocol — LangChain tool factory.
+ *
+ * Creates 16 executable tools bound to the Raydium REST API v3:
+ * ```ts
+ * const raydium = createRaydiumTools();
+ * agent.tools.push(...raydium.tools);
+ * ```
+ *
+ * @since 1.0.0
+ */
+import { type ProtocolToolkit, type CreateProtocolToolsOpts } from '../shared';
+/**
+ * @description Raydium public API v3 base URL.
+ * @since 1.0.0
+ */
+export declare const RAYDIUM_API_URL = "https://api-v3.raydium.io";
+/**
+ * @description Raydium-specific configuration for tool creation.
+ * @since 1.0.0
+ */
+export interface RaydiumToolsConfig {
+    /** Raydium API base URL (default: https://api-v3.raydium.io). */
+    apiUrl?: string;
+    /** Request timeout in ms (default: 30 000). */
+    timeout?: number;
+    /** Extra headers. */
+    headers?: Record<string, string>;
+    /** Override global fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * @description Create LangChain-compatible tools for Raydium Protocol.
+ *
+ * @param {RaydiumToolsConfig & CreateProtocolToolsOpts} [config={}] - Raydium API config and tool options
+ * @returns {ProtocolToolkit} Toolkit with 16 Raydium tools
+ *
+ * @example
+ * ```ts
+ * const raydium = createRaydiumTools();
+ * const poolTool = raydium.toolMap.getPoolsByTokenMint;
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare function createRaydiumTools(config?: RaydiumToolsConfig & CreateProtocolToolsOpts): ProtocolToolkit;
+/** Re-export schemas for direct access. */
+export { raydiumMethods, raydiumMethodNames } from './schemas';
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/raydium/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAOnB;;;GAGG;AACH,eAAO,MAAM,eAAe,8BAA8B,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAgCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,GAAE,kBAAkB,GAAG,uBAA4B,GACxD,eAAe,CAuBjB;AAED,2CAA2C;AAC3C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raydiumMethodNames = exports.raydiumMethods = exports.RAYDIUM_API_URL = void 0;
+exports.createRaydiumTools = createRaydiumTools;
+/**
+ * @module ai/tools/protocols/raydium/tools
+ * @description Raydium Protocol — LangChain tool factory.
+ *
+ * Creates 16 executable tools bound to the Raydium REST API v3:
+ * ```ts
+ * const raydium = createRaydiumTools();
+ * agent.tools.push(...raydium.tools);
+ * ```
+ *
+ * @since 1.0.0
+ */
+const shared_1 = require("../shared");
+const schemas_1 = require("./schemas");
+/* ═══════════════════════════════════════════════════════════════
+ *  Default configuration
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Raydium public API v3 base URL.
+ * @since 1.0.0
+ */
+exports.RAYDIUM_API_URL = 'https://api-v3.raydium.io';
+/* ═══════════════════════════════════════════════════════════════
+ *  Execution dispatcher
+ *
+ *  Raydium API v3 uses query params with specific key conventions.
+ *  Array params are joined by comma (e.g. ids=a,b,c).
+ * ═══════════════════════════════════════════════════════════════ */
+function createRaydiumExecutor(http) {
+    return async (method, input) => {
+        const path = method.path ?? `/${method.name}`;
+        // Raydium wraps all responses in { id, success, data } or { id, success, msg }
+        const raw = await http.get(path, input);
+        // Unwrap the Raydium envelope
+        if (raw && typeof raw === 'object' && 'success' in raw) {
+            if (!raw.success) {
+                throw new Error(`Raydium API error: ${raw.msg ?? 'Unknown error'}`);
+            }
+            return raw.data;
+        }
+        return raw;
+    };
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  createRaydiumTools()
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Create LangChain-compatible tools for Raydium Protocol.
+ *
+ * @param {RaydiumToolsConfig & CreateProtocolToolsOpts} [config={}] - Raydium API config and tool options
+ * @returns {ProtocolToolkit} Toolkit with 16 Raydium tools
+ *
+ * @example
+ * ```ts
+ * const raydium = createRaydiumTools();
+ * const poolTool = raydium.toolMap.getPoolsByTokenMint;
+ * ```
+ *
+ * @since 1.0.0
+ */
+function createRaydiumTools(config = {}) {
+    const { apiUrl = exports.RAYDIUM_API_URL, timeout, headers, fetch: fetchFn, ...toolOpts } = config;
+    const httpConfig = {
+        baseUrl: apiUrl,
+        timeout,
+        headers,
+        fetch: fetchFn,
+    };
+    const http = new shared_1.ProtocolHttpClient(httpConfig);
+    const execute = createRaydiumExecutor(http);
+    return (0, shared_1.buildProtocolTools)(schemas_1.raydiumMethods, execute, {
+        defaultPrefix: 'raydium_',
+        ...toolOpts,
+    });
+}
+/** Re-export schemas for direct access. */
+var schemas_2 = require("./schemas");
+Object.defineProperty(exports, "raydiumMethods", { enumerable: true, get: function () { return schemas_2.raydiumMethods; } });
+Object.defineProperty(exports, "raydiumMethodNames", { enumerable: true, get: function () { return schemas_2.raydiumMethodNames; } });
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/raydium/tools.ts"],"names":[],"mappings":";;;AA2FA,gDAyBC;AApHD;;;;;;;;;;;GAWG;AACH,sCAOmB;AACnB,uCAA2C;AAE3C;;qEAEqE;AAErE;;;GAGG;AACU,QAAA,eAAe,GAAG,2BAA2B,CAAC;AAiB3D;;;;;qEAKqE;AAErE,SAAS,qBAAqB,CAAC,IAAwB;IACrD,OAAO,KAAK,EAAE,MAAsB,EAAE,KAA8B,EAAoB,EAAE;QACxF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9C,+EAA+E;QAC/E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAqD,IAAI,EAAE,KAAK,CAAC,CAAC;QAE5F,8BAA8B;QAC9B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED;;qEAEqE;AAErE;;;;;;;;;;;;;GAaG;AACH,SAAgB,kBAAkB,CAChC,SAAuD,EAAE;IAEzD,MAAM,EACJ,MAAM,GAAG,uBAAe,EACxB,OAAO,EACP,OAAO,EACP,KAAK,EAAE,OAAO,EACd,GAAG,QAAQ,EACZ,GAAG,MAAM,CAAC;IAEX,MAAM,UAAU,GAAyB;QACvC,OAAO,EAAE,MAAM;QACf,OAAO;QACP,OAAO;QACP,KAAK,EAAE,OAAO;KACf,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,2BAAkB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO,IAAA,2BAAkB,EAAC,wBAAc,EAAE,OAAO,EAAE;QACjD,aAAa,EAAE,UAAU;QACzB,GAAG,QAAQ;KACZ,CAAC,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,qCAA+D;AAAtD,yGAAA,cAAc,OAAA;AAAE,6GAAA,kBAAkB,OAAA"}