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

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

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jupiterOnchainMethodNames = exports.jupiterOnchainMethods = void 0;
+/**
+ * @module ai/tools/protocols/jupiter-onchain/schemas
+ * @description Jupiter On-Chain — Zod schemas for 10 local RPC-based tools.
+ *
+ * These tools query Jupiter protocol state **directly from the Solana
+ * blockchain** using the SDK's native RPC transport and binary decoders.
+ * They complement the REST-based Jupiter tools (which call api.jup.ag)
+ * 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)
+ *  - Position discovery    (3 methods — limit orders, DCA, perps)
+ *  - Token utilities       (2 methods — mint info, token holdings)
+ *  - Program registry      (1 method  — list all Jupiter program IDs)
+ *
+ * @since 1.1.0
+ */
+const zod_1 = require("zod");
+const shared_1 = require("../shared");
+const { register, methods } = (0, shared_1.createMethodRegistry)('jupiter_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, "finalized" for critical state');
+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');
+/** Jupiter program name → resolves to on-chain program ID in the executor. */
+const zJupiterProgram = zod_1.z.enum([
+    'aggregator_v6',
+    'aggregator_v4',
+    'aggregator_v3',
+    'aggregator_v2',
+    'perps_v2',
+    'perps_v1',
+    'limit_order_v2',
+    'dca',
+    'lock',
+    'vote',
+    'dao',
+]).describe('Jupiter program name. aggregator_v6 is the current swap router. ' +
+    'limit_order_v2 stores on-chain limit orders. dca stores Dollar-Cost-Average positions. ' +
+    'perps_v2 is the perpetual futures engine. lock is the token lock program.');
+/** Memcmp filter: match bytes at a specific offset in account data. */
+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 the bytes field (default: base58)'),
+    }),
+}).describe('Match accounts whose data contains specific bytes at a given offset');
+/** DataSize filter: match accounts with an exact data length. */
+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 (useful for filtering by account type)');
+/** Union of supported getProgramAccounts filters. */
+const zFilter = zod_1.z.union([zMemcmpFilter, zDataSizeFilter]);
+/** DataSlice: return only a portion of account data. */
+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 — use to reduce payload size for large accounts');
+/* ═══════════════════════════════════════════════════════════════
+ *  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 Jupiter limit order, DCA, or perps position account)'),
+    encoding: zEncoding,
+    commitment: zCommitment,
+    dataSlice: zDataSlice,
+}), zAccountInfoResult, 'Fetch raw on-chain account data for any Solana address. ' +
+    'Use this to inspect Jupiter program state accounts such as limit orders, DCA positions, ' +
+    'perps positions, or any account owned by a Jupiter program. ' +
+    'Returns owner program, lamports balance, data in the requested encoding, and executable flag. ' +
+    'Use encoding "jsonParsed" for SPL Token accounts, "base64" for raw binary data.');
+register('searchProgramAccounts', zod_1.z.object({
+    program: zJupiterProgram.describe('Jupiter program to query — the tool resolves this to the correct on-chain program ID'),
+    filters: zod_1.z.array(zFilter).optional()
+        .describe('Optional memcmp/dataSize filters. For example, use memcmp at offset 8 with the owner pubkey bytes to find accounts belonging to a specific wallet'),
+    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). Large programs may return thousands of accounts — use filters or dataSlice 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 Jupiter program. ' +
+    'Resolves the program name to its on-chain ID and calls getProgramAccounts. ' +
+    'Use memcmp filters to narrow results by discriminator, owner, or token mint. ' +
+    'Use dataSlice to return only account headers and reduce payload size. ' +
+    'WARNING: unfiltered queries on large programs (e.g. aggregator_v6) may return thousands of accounts — always apply filters in production.');
+/* ═══════════════════════════════════════════════════════════════
+ *  2. Transaction history
+ * ═══════════════════════════════════════════════════════════════ */
+register('getTransactionHistory', zod_1.z.object({
+    address: zPubkey.describe('Address to get transaction history for — can be a Jupiter program ID, a wallet, or any account'),
+    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 signature (pagination cursor)'),
+    until: zSignature.optional().describe('Return signatures newer than this signature (stop condition)'),
+    commitment: zCommitment,
+}), zod_1.z.array(zSignatureEntry), 'Get recent transaction signatures for a Jupiter program address, wallet, or any on-chain account. ' +
+    'Returns chronological list with slot, block time, confirmation status, and error info. ' +
+    'Use "before" and "until" for pagination through transaction history. ' +
+    'Combine with inspectTransaction to get full transaction 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'),
+    jupiterInstructions: 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 Jupiter 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 Jupiter program interactions. ' +
+    'Returns the full parsed transaction plus a filtered list of instructions that involve known Jupiter programs ' +
+    '(aggregator swaps, limit order fills, DCA executions, perps trades, etc.). ' +
+    'Useful for understanding what happened in a specific Jupiter-related transaction.');
+/* ═══════════════════════════════════════════════════════════════
+ *  3. Position discovery
+ * ═══════════════════════════════════════════════════════════════ */
+register('getLimitOrders', zod_1.z.object({
+    owner: zPubkey.describe('Wallet address (maker) to find limit orders for'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    programId: zPubkey,
+    orders: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Limit order account address'),
+        data: zod_1.z.unknown().describe('Raw account data (base64)'),
+        lamports: zod_1.z.number(),
+    })),
+    count: zod_1.z.number(),
+}), 'Find all on-chain Jupiter Limit Order v2 accounts for a specific wallet. ' +
+    'Queries the limit order program (J1TnP8zvVxbtF5KFp5xRmWuvG9McnhzmBd9XGfCyuxFP) ' +
+    'with a memcmp filter on the maker field at offset 8 (after the 8-byte Anchor discriminator). ' +
+    'Returns raw account data — the agent can interpret the binary layout or combine with the REST API for enriched data.');
+register('getDCAAccounts', zod_1.z.object({
+    owner: zPubkey.describe('Wallet address (user) to find DCA positions for'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    programId: zPubkey,
+    accounts: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('DCA account address'),
+        data: zod_1.z.unknown().describe('Raw account data (base64)'),
+        lamports: zod_1.z.number(),
+    })),
+    count: zod_1.z.number(),
+}), 'Find all on-chain Jupiter DCA (Dollar-Cost Averaging) accounts for a wallet. ' +
+    'Queries the DCA program (DCA265Vj8a9CE2Xng1bcnkRg2PeugTsRt) ' +
+    'with a memcmp filter on the user field at offset 8 (after the 8-byte Anchor discriminator). ' +
+    'Returns raw account data for each active or completed DCA position.');
+register('getPerpsPositions', zod_1.z.object({
+    trader: zPubkey.describe('Trader wallet address to find perpetual positions for'),
+    version: zod_1.z.enum(['v1', 'v2']).optional()
+        .describe('Perps program version — v2 is the current active version (default: v2)'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    programId: zPubkey,
+    programName: zod_1.z.string(),
+    positions: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Position 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 Jupiter Perpetuals position accounts for a trader wallet. ' +
+    'Queries the Perps program (v1 or v2, default v2) with a memcmp filter on the trader field. ' +
+    'Jupiter Perps supports SOL, ETH, and BTC perpetual contracts. ' +
+    'Returns raw position state data including size, collateral, entry price, and liquidation price.');
+/* ═══════════════════════════════════════════════════════════════
+ *  4. Token utilities
+ * ═══════════════════════════════════════════════════════════════ */
+register('getTokenMintInfo', zod_1.z.object({
+    mint: zPubkey.describe('SPL Token mint address to decode (e.g. SOL-USDC LP mint, JUP token mint)'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    mintAuthority: zPubkey.nullable(),
+    supply: zod_1.z.string().describe('Total supply as raw integer string'),
+    decimals: zod_1.z.number().describe('Number of decimal places'),
+    isInitialized: zod_1.z.boolean(),
+    freezeAuthority: zPubkey.nullable(),
+    slot: zod_1.z.number().describe('Slot at which the data was fetched'),
+}), 'Fetch and decode a SPL Token mint account using the SDK native binary decoder. ' +
+    'Returns supply, decimals, mint authority, freeze authority, and initialization state. ' +
+    'Works with both SPL Token and Token-2022 mints. ' +
+    'Useful for checking token supply, verifying authority keys, and validating token metadata on-chain.');
+register('getTokenHoldings', zod_1.z.object({
+    owner: zPubkey.describe('Wallet address to query token holdings for'),
+    mint: zPubkey.optional().describe('Filter by specific token mint — omit to get ALL token accounts'),
+    programId: zPubkey.optional()
+        .describe('Token program ID — omit for SPL Token, set to "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb" for Token-2022'),
+    commitment: zCommitment,
+}), zod_1.z.object({
+    accounts: zod_1.z.array(zod_1.z.object({
+        pubkey: zPubkey.describe('Token account address'),
+        mint: zPubkey,
+        owner: zPubkey,
+        amount: zod_1.z.string().describe('Raw token amount (no decimals)'),
+        decimals: zod_1.z.number(),
+        uiAmount: zod_1.z.number().nullable(),
+        delegate: zPubkey.nullable().optional(),
+        state: zod_1.z.string(),
+    })),
+    count: zod_1.z.number(),
+}), 'Get all SPL token accounts owned by a wallet using getTokenAccountsByOwner. ' +
+    'Optionally filter by a specific mint address to get the balance of one token. ' +
+    'Returns decoded token account data including balance, mint, delegate, and account state. ' +
+    'Useful for checking Jupiter-related token balances (JUP, LP tokens, etc.) or discovering all tokens in a wallet.');
+/* ═══════════════════════════════════════════════════════════════
+ *  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 Jupiter program IDs with human-readable names and short keys. ' +
+    'Returns the complete Jupiter program registry: aggregator versions (v2–v6), ' +
+    'Perps (v1/v2), Limit Order v2, DCA, Lock, Vote, and DAO programs. ' +
+    'No RPC call needed — this is a pure local lookup. ' +
+    'Use the returned keys as input to the "program" field in searchProgramAccounts.');
+/* ═══════════════════════════════════════════════════════════════
+ *  Export
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description All 10 registered Jupiter on-chain methods with typed Zod schemas.
+ * @since 1.1.0
+ */
+exports.jupiterOnchainMethods = methods;
+/**
+ * @description Jupiter on-chain method names as a readonly tuple.
+ * @since 1.1.0
+ */
+exports.jupiterOnchainMethodNames = methods.map((m) => m.name);
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * @module ai/tools/protocols/jupiter-onchain/tools
+ * @description Jupiter On-Chain — LangChain tool factory.
+ *
+ * Creates 10 executable tools that query Jupiter protocol state directly
+ * from the Solana blockchain via the SDK's native RPC transport and
+ * binary decoders. No external REST API dependency.
+ *
+ * ```ts
+ * import { SynapseClient } from '@oobe-protocol-labs/synapse-client-sdk';
+ * const client = new SynapseClient({ endpoint: '...' });
+ * const jupOnchain = createJupiterOnchainTools(client);
+ * ```
+ *
+ * @since 1.1.0
+ */
+import { type ProtocolToolkit, type CreateProtocolToolsOpts } from '../shared';
+import type { SynapseClient } from '../../../../core/client';
+/** @internal */
+export declare const JUPITER_PROGRAM_IDS: Record<string, {
+    id: string;
+    name: string;
+}>;
+/**
+ * @description Jupiter on-chain specific config (tool options — transport comes from SynapseClient).
+ * @since 1.1.0
+ */
+export type JupiterOnchainToolsConfig = CreateProtocolToolsOpts;
+/**
+ * @description Create LangChain-compatible tools for querying Jupiter state on-chain.
+ *
+ * Unlike the REST-based Jupiter tools (which call api.jup.ag), these tools
+ * query the Solana blockchain directly via the SDK's RPC transport and
+ * native binary decoders. Use them to inspect limit orders, DCA positions,
+ * perps positions, and any Jupiter program account in real-time.
+ *
+ * @param {SynapseClient} client - Initialised SynapseClient (provides HttpTransport)
+ * @param {JupiterOnchainToolsConfig} [opts={}] - Tool creation options
+ * @returns {ProtocolToolkit} Toolkit with 10 Jupiter on-chain tools
+ *
+ * @example
+ * ```ts
+ * const client = new SynapseClient({ endpoint: 'https://...' });
+ * const jupOnchain = createJupiterOnchainTools(client);
+ *
+ * // Find all limit orders for a wallet:
+ * const orders = jupOnchain.toolMap.getLimitOrders;
+ *
+ * // Inspect a Jupiter swap transaction:
+ * const inspector = jupOnchain.toolMap.inspectTransaction;
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function createJupiterOnchainTools(client: SynapseClient, opts?: JupiterOnchainToolsConfig): ProtocolToolkit;
+/** Re-export schemas for direct access. */
+export { jupiterOnchainMethods, jupiterOnchainMethodNames } from './schemas';
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/ai/tools/protocols/jupiter-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;AAa7D,gBAAgB;AAChB,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAY5E,CAAC;AAoWF;;;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"}