@oobe-protocol-labs/synapse-client-sdk 1.0.2 → 1.0.4

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

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raydiumOnchainMethodNames = exports.raydiumOnchainMethods = void 0;
+/**
+ * @module ai/tools/protocols/raydium-onchain/schemas
+ * @description Raydium On-Chain — Zod schemas for 10 local RPC-based tools.
+ *
+ * These tools query Raydium protocol state **directly from the Solana
+ * blockchain** using the SDK's native RPC transport and binary decoders.
+ * They complement the REST-based Raydium tools (which call api-v3.raydium.io)
+ * by providing raw on-chain data without external API dependencies.
+ *
+ * Covers:
+ *  - Account inspection       (2 methods — single + program search)
+ *  - Transaction history      (2 methods — signatures + full tx parse)
+ *  - Pool state               (3 methods — single, batch, search by mint)
+ *  - Position discovery       (2 methods — LP tokens, farm positions)
+ *  - Program registry         (1 method  — list all Raydium program IDs)
+ *
+ * @since 1.1.0
+ */
+const zod_1 = require("zod");
+const shared_1 = require("../shared");
+const { register, methods } = (0, shared_1.createMethodRegistry)('raydium_onchain');
+/* ═══════════════════════════════════════════════════════════════
+ *  Shared Zod primitives
+ * ═══════════════════════════════════════════════════════════════ */
+const zPubkey = zod_1.z.string().describe('Solana public key (base58-encoded)');
+const zSignature = zod_1.z.string().describe('Transaction signature (base58-encoded, 88 chars)');
+const zCommitment = zod_1.z.enum(['processed', 'confirmed', 'finalized']).optional()
+    .describe('RPC commitment level — "confirmed" is recommended for most reads');
+const zEncoding = zod_1.z.enum(['base58', 'base64', 'base64+zstd', 'jsonParsed']).optional()
+    .describe('Account data encoding — "base64" is fastest, "jsonParsed" returns human-readable JSON for known programs');
+/** Raydium program name → resolves to on-chain program ID in the executor. */
+const zRaydiumProgram = zod_1.z.enum([
+    'amm_v4',
+    'clmm',
+    'cpmm',
+    'route',
+    'farm',
+    'acceleraytor',
+    'clmm_legacy',
+]).describe('Raydium program name. amm_v4 is the classic AMM. clmm is Concentrated Liquidity Market Maker. ' +
+    'cpmm is the Constant Product Market Maker. farm is the yield farming/staking program. ' +
+    'route is the swap router. acceleraytor is the IDO launchpad.');
+/** Memcmp filter for getProgramAccounts. */
+const zMemcmpFilter = zod_1.z.object({
+    memcmp: zod_1.z.object({
+        offset: zod_1.z.number().int().min(0).describe('Byte offset in account data where comparison starts'),
+        bytes: zod_1.z.string().describe('Base58-encoded bytes to match at the given offset'),
+        encoding: zod_1.z.enum(['base58', 'base64']).optional().describe('Encoding of bytes field (default: base58)'),
+    }),
+}).describe('Match accounts whose data contains specific bytes at a given offset');
+/** DataSize filter for getProgramAccounts. */
+const zDataSizeFilter = zod_1.z.object({
+    dataSize: zod_1.z.number().int().positive().describe('Exact account data length in bytes to match'),
+}).describe('Match accounts with exactly this data size');
+const zFilter = zod_1.z.union([zMemcmpFilter, zDataSizeFilter]);
+/** DataSlice for partial data reads. */
+const zDataSlice = zod_1.z.object({
+    offset: zod_1.z.number().int().min(0).describe('Byte offset to start slicing from'),
+    length: zod_1.z.number().int().positive().describe('Number of bytes to return'),
+}).optional().describe('Return only a slice of account data to reduce payload size');
+/* ═══════════════════════════════════════════════════════════════
+ *  Generic output shapes
+ * ═══════════════════════════════════════════════════════════════ */
+const zAccountInfoResult = zod_1.z.object({
+    context: zod_1.z.object({ slot: zod_1.z.number() }),
+    value: zod_1.z.object({
+        data: zod_1.z.unknown().describe('Account data in the requested encoding'),
+        executable: zod_1.z.boolean(),
+        lamports: zod_1.z.number(),
+        owner: zPubkey,
+        rentEpoch: zod_1.z.number(),
+        space: zod_1.z.number().optional(),
+    }).nullable(),
+});
+const zProgramAccountEntry = zod_1.z.object({
+    pubkey: zPubkey,
+    account: zod_1.z.object({
+        data: zod_1.z.unknown(),
+        executable: zod_1.z.boolean(),
+        lamports: zod_1.z.number(),
+        owner: zPubkey,
+        rentEpoch: zod_1.z.number(),
+        space: zod_1.z.number().optional(),
+    }),
+});
+const zSignatureEntry = zod_1.z.object({
+    signature: zSignature,
+    slot: zod_1.z.number(),
+    blockTime: zod_1.z.number().nullable(),
+    confirmationStatus: zod_1.z.string().nullable(),
+    err: zod_1.z.unknown().nullable(),
+    memo: zod_1.z.string().nullable(),
+});
+/* ═══════════════════════════════════════════════════════════════
+ *  1. Account inspection
+ * ═══════════════════════════════════════════════════════════════ */
+register('fetchAccount', zod_1.z.object({
+    address: zPubkey.describe('Account address to fetch (e.g. a Raydium pool state, LP position, or farm account)'),
+    encoding: zEncoding,
+    commitment: zCommitment,
+    dataSlice: zDataSlice,
+}), zAccountInfoResult, 'Fetch raw on-chain account data for any Solana address. ' +
+    'Use this to inspect Raydium program state accounts such as AMM pool states, ' +
+    'CLMM positions, CPMM pools, or farming accounts. ' +
+    'Returns owner program, lamports balance, data in the requested encoding, and executable flag.');
+register('searchProgramAccounts', zod_1.z.object({
+    program: zRaydiumProgram.describe('Raydium program to query — resolves to the correct on-chain program ID'),
+    filters: zod_1.z.array(zFilter).optional()
+        .describe('Optional memcmp/dataSize filters. Use memcmp to filter by pool mint addresses, owner, or discriminator'),
+    encoding: zEncoding,
+    dataSlice: zDataSlice,
+    commitment: zCommitment,
+    maxResults: zod_1.z.number().int().positive().max(1000).optional()
+        .describe('Truncate results to this many accounts (default: no limit). Use filters to keep responses manageable'),
+}), zod_1.z.object({
+    programId: zPubkey.describe('Resolved on-chain program ID'),
+    programName: zod_1.z.string(),
+    accounts: zod_1.z.array(zProgramAccountEntry),
+    totalFound: zod_1.z.number(),
+    truncated: zod_1.z.boolean(),
+}), 'Query all on-chain accounts owned by a specific Raydium program. ' +
+    'Resolves the program name to its on-chain ID and calls getProgramAccounts. ' +
+    'Use memcmp filters to narrow results by token mint, pool pair, or account type. ' +
+    'WARNING: unfiltered queries on amm_v4 or clmm may return thousands of accounts — always apply filters.');
+/* ═══════════════════════════════════════════════════════════════
+ *  2. Transaction history
+ * ═══════════════════════════════════════════════════════════════ */
+register('getTransactionHistory', zod_1.z.object({
+    address: zPubkey.describe('Address to get transaction history for — can be a Raydium program, pool, or wallet'),
+    limit: zod_1.z.number().int().min(1).max(1000).optional()
+        .describe('Maximum number of signatures to return (default: 20, max: 1000)'),
+    before: zSignature.optional().describe('Return signatures older than this (pagination cursor)'),
+    until: zSignature.optional().describe('Return signatures newer than this (stop condition)'),
+    commitment: zCommitment,
+}), zod_1.z.array(zSignatureEntry), 'Get recent transaction signatures for a Raydium program address, pool account, or wallet. ' +
+    'Returns chronological list with slot, block time, confirmation status, and error info. ' +
+    'Use "before" and "until" for pagination. Combine with inspectTransaction for full details.');
+register('inspectTransaction', zod_1.z.object({
+    signature: zSignature.describe('Transaction signature to fetch and parse'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    transaction: zod_1.z.unknown().describe('Full parsed transaction with instructions'),
+    raydiumInstructions: zod_1.z.array(zod_1.z.object({
+        programId: zPubkey,
+        programName: zod_1.z.string(),
+        instructionIndex: zod_1.z.number(),
+        data: zod_1.z.string().optional(),
+        accounts: zod_1.z.array(zPubkey).optional(),
+        isInner: zod_1.z.boolean(),
+    })).describe('Instructions involving Raydium programs, extracted from the transaction'),
+    slot: zod_1.z.number(),
+    blockTime: zod_1.z.number().nullable(),
+}), 'Fetch a complete transaction by signature and identify all Raydium program interactions. ' +
+    'Returns the full parsed transaction plus a filtered list of instructions involving Raydium programs ' +
+    '(AMM swaps, CLMM position changes, CPMM operations, farm deposits/withdrawals, etc.).');
+/* ═══════════════════════════════════════════════════════════════
+ *  3. Pool state
+ * ═══════════════════════════════════════════════════════════════ */
+register('getPoolState', zod_1.z.object({
+    poolAddress: zPubkey.describe('Raydium pool account address (AMM v4, CLMM, or CPMM pool)'),
+    encoding: zEncoding,
+    commitment: zCommitment,
+}), zod_1.z.object({
+    address: zPubkey,
+    owner: zPubkey.describe('Program that owns this pool (identifies pool type: AMM v4, CLMM, or CPMM)'),
+    lamports: zod_1.z.number(),
+    data: zod_1.z.unknown().describe('Pool state data in the requested encoding'),
+    slot: zod_1.z.number(),
+    poolType: zod_1.z.string().nullable().describe('Detected pool type based on owner program, or null if not a known Raydium pool'),
+}), 'Fetch the on-chain state of a specific Raydium pool by its account address. ' +
+    'Automatically detects the pool type (AMM v4, CLMM, or CPMM) based on the owner program. ' +
+    'Returns raw pool state data including reserves, fees, tick state (CLMM), and configuration. ' +
+    'Use encoding "base64" for raw binary data or "jsonParsed" if the RPC supports it.');
+register('getMultiplePoolStates', zod_1.z.object({
+    poolAddresses: zod_1.z.array(zPubkey).min(1).max(100)
+        .describe('Array of Raydium pool account addresses to fetch in a single RPC call (max 100)'),
+    encoding: zEncoding,
+    commitment: zCommitment,
+}), zod_1.z.object({
+    pools: zod_1.z.array(zod_1.z.object({
+        address: zPubkey,
+        owner: zPubkey.nullable(),
+        lamports: zod_1.z.number().nullable(),
+        data: zod_1.z.unknown().nullable(),
+        poolType: zod_1.z.string().nullable(),
+        exists: zod_1.z.boolean(),
+    })),
+    slot: zod_1.z.number(),
+    found: zod_1.z.number(),
+    missing: zod_1.z.number(),
+}), 'Fetch multiple Raydium pool states in a single getMultipleAccounts RPC call. ' +
+    'More efficient than fetching pools one by one. Returns null for non-existent accounts. ' +
+    'Automatically detects pool type for each account. Max 100 pools per call.');
+register('getPoolsByMint', zod_1.z.object({
+    program: zod_1.z.enum(['amm_v4', 'clmm', 'cpmm'])
+        .describe('Raydium pool program to search — each has different account layouts'),
+    mint: zPubkey.describe('Token mint address to search for in pool accounts'),
+    mintOffset: zod_1.z.number().int().min(0)
+        .describe('Byte offset of the mint field in the pool account data layout. ' +
+        'Common offsets — AMM v4: baseMint=400, quoteMint=432. ' +
+        'CLMM: tokenMint0=73, tokenMint1=105. ' +
+        'CPMM: token0Mint=73, token1Mint=105.'),
+    commitment: zCommitment,
+    maxResults: zod_1.z.number().int().positive().max(100).optional()
+        .describe('Limit results (default: 50)'),
+}), zod_1.z.object({
+    programId: zPubkey,
+    pools: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Pool account address'),
+        data: zod_1.z.unknown(),
+        lamports: zod_1.z.number(),
+    })),
+    count: zod_1.z.number(),
+    truncated: zod_1.z.boolean(),
+}), 'Find Raydium pools containing a specific token mint by searching program accounts with a memcmp filter. ' +
+    'You must specify the byte offset where the mint address appears in the pool account layout. ' +
+    'Common offsets: AMM v4 baseMint=400, quoteMint=432; CLMM tokenMint0=73, tokenMint1=105; ' +
+    'CPMM token0Mint=73, token1Mint=105. Returns raw pool state data.');
+/* ═══════════════════════════════════════════════════════════════
+ *  4. Position discovery
+ * ═══════════════════════════════════════════════════════════════ */
+register('getLPPositions', zod_1.z.object({
+    owner: zPubkey.describe('Wallet address to find LP token positions for'),
+    lpMint: zPubkey.optional()
+        .describe('Filter by specific LP token mint — omit to get all token accounts (then filter client-side for known LP mints)'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    accounts: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Token account address holding LP tokens'),
+        mint: zPubkey.describe('LP token mint address'),
+        owner: zPubkey,
+        amount: zod_1.z.string().describe('Raw LP token amount'),
+        decimals: zod_1.z.number(),
+        uiAmount: zod_1.z.number().nullable(),
+    })),
+    count: zod_1.z.number(),
+}), 'Find LP (Liquidity Provider) token accounts for a wallet. ' +
+    'Uses getTokenAccountsByOwner to discover LP positions. ' +
+    'If you know the specific LP mint, pass it to filter directly. ' +
+    'Otherwise, returns all token accounts — cross-reference with known Raydium LP mints to identify positions. ' +
+    'The LP token balance represents the wallet\'s share of the pool liquidity.');
+register('getFarmPositions', zod_1.z.object({
+    owner: zPubkey.describe('Wallet address (farmer) to find staking positions for'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    programId: zPubkey,
+    positions: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Farm user account address'),
+        data: zod_1.z.unknown().describe('Raw account data (base64)'),
+        lamports: zod_1.z.number(),
+    })),
+    count: zod_1.z.number(),
+}), 'Find on-chain Raydium farm/staking position accounts for a wallet. ' +
+    'Queries the Farm/Staking program (FarmqiPv5eAj3j1GMdMCMUGXqPUvmquZtMy86QH6rzhG) ' +
+    'with a memcmp filter on the owner field at offset 40 (after discriminator + farm ID). ' +
+    'Returns raw farming position data including staked amount and pending rewards.');
+/* ═══════════════════════════════════════════════════════════════
+ *  5. Program registry
+ * ═══════════════════════════════════════════════════════════════ */
+register('resolvePrograms', zod_1.z.object({}), zod_1.z.object({
+    programs: zod_1.z.array(zod_1.z.object({
+        id: zPubkey.describe('On-chain program ID'),
+        name: zod_1.z.string().describe('Human-readable program name'),
+        key: zod_1.z.string().describe('Short key used in searchProgramAccounts'),
+    })),
+    count: zod_1.z.number(),
+}), 'List all known Raydium program IDs with human-readable names and short keys. ' +
+    'Returns the complete Raydium program registry: AMM v4, CLMM (Concentrated Liquidity), ' +
+    'CPMM (Constant Product), Route (swap router), Farm/Staking, Acceleraytor (IDO), and CLMM Legacy. ' +
+    'No RPC call needed — pure local lookup. ' +
+    'Use the returned keys as input to the "program" field in searchProgramAccounts.');
+/* ═══════════════════════════════════════════════════════════════
+ *  Export
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description All 10 registered Raydium on-chain methods with typed Zod schemas.
+ * @since 1.1.0
+ */
+exports.raydiumOnchainMethods = methods;
+/**
+ * @description Raydium on-chain method names as a readonly tuple.
+ * @since 1.1.0
+ */
+exports.raydiumOnchainMethodNames = methods.map((m) => m.name);
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * @module ai/tools/protocols/raydium-onchain/tools
+ * @description Raydium On-Chain — LangChain tool factory.
+ *
+ * Creates 10 executable tools that query Raydium protocol state directly
+ * from the Solana blockchain via the SDK's native RPC transport.
+ * No external REST API dependency.
+ *
+ * ```ts
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * const client = new SynapseClient({ endpoint: '...' });
+ * const rayOnchain = createRaydiumOnchainTools(client);
+ * ```
+ *
+ * @since 1.1.0
+ */
+import { type ProtocolToolkit, type CreateProtocolToolsOpts } from '../shared';
+import type { SynapseClient } from '../../../../core/client';
+/** @internal */
+export declare const RAYDIUM_PROGRAM_IDS: Record<string, {
+    id: string;
+    name: string;
+}>;
+/**
+ * @description Raydium on-chain specific config (tool options — transport comes from SynapseClient).
+ * @since 1.1.0
+ */
+export type RaydiumOnchainToolsConfig = CreateProtocolToolsOpts;
+/**
+ * @description Create LangChain-compatible tools for querying Raydium state on-chain.
+ *
+ * Unlike the REST-based Raydium tools (which call api-v3.raydium.io), these tools
+ * query the Solana blockchain directly via the SDK's RPC transport.
+ * Use them to inspect pool states, LP positions, farm positions, and any
+ * Raydium program account in real-time.
+ *
+ * @param {SynapseClient} client - Initialised SynapseClient (provides HttpTransport)
+ * @param {RaydiumOnchainToolsConfig} [opts={}] - Tool creation options
+ * @returns {ProtocolToolkit} Toolkit with 10 Raydium on-chain tools
+ *
+ * @example
+ * ```ts
+ * const client = new SynapseClient({ endpoint: 'https://...' });
+ * const rayOnchain = createRaydiumOnchainTools(client);
+ *
+ * // Fetch a pool state:
+ * const poolTool = rayOnchain.toolMap.getPoolState;
+ *
+ * // Find farm positions for a wallet:
+ * const farmTool = rayOnchain.toolMap.getFarmPositions;
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function createRaydiumOnchainTools(client: SynapseClient, opts?: RaydiumOnchainToolsConfig): ProtocolToolkit;
+/** Re-export schemas for direct access. */
+export { raydiumOnchainMethods, raydiumOnchainMethodNames } from './schemas';
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/raydium-onchain/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAU7D,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQ5E,CAAC;AAqZF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,yBAA8B,GACnC,eAAe,CAOjB;AAED,2CAA2C;AAC3C,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC"}