@oobe-protocol-labs/synapse-client-sdk 1.0.1 → 1.0.3

package/dist/esm/accounts/nonce.d.ts

@@ -0,0 +1,30 @@
+/**
+ * High-level typed nonce account fetcher.
+ *
+ * @module accounts/nonce
+ * @since 1.1.0
+ */
+import type { HttpTransport, CallOptions } from '../core/transport';
+import type { Pubkey, Commitment } from '../core/types';
+import type { DecodedNonceAccount } from '../decoders/nonce';
+import type { DecodedAccountResult } from './helpers';
+/**
+ * Fetch and decode a Solana nonce account.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Nonce account public key.
+ * @param opts - RPC options.
+ * @returns Decoded nonce account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const nonce = await fetchNonceAccount(transport, noncePubkey);
+ * if (nonce) console.log(`Blockhash: ${nonce.decoded.blockhash}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function fetchNonceAccount(transport: HttpTransport, pubkey: Pubkey, opts?: {
+    commitment?: Commitment;
+} & CallOptions): Promise<DecodedAccountResult<DecodedNonceAccount> | null>;
+//# sourceMappingURL=nonce.d.ts.map

package/dist/esm/accounts/nonce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.d.ts","sourceRoot":"","sources":["../../../src/accounts/nonce.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,WAAgB,GACnD,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAE3D"}

package/dist/esm/accounts/nonce.js

@@ -0,0 +1,28 @@
+/**
+ * High-level typed nonce account fetcher.
+ *
+ * @module accounts/nonce
+ * @since 1.1.0
+ */
+import { decodeNonceAccount } from '../decoders/nonce.js';
+import { getDecodedAccount } from './helpers.js';
+/**
+ * Fetch and decode a Solana nonce account.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Nonce account public key.
+ * @param opts - RPC options.
+ * @returns Decoded nonce account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const nonce = await fetchNonceAccount(transport, noncePubkey);
+ * if (nonce) console.log(`Blockhash: ${nonce.decoded.blockhash}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export async function fetchNonceAccount(transport, pubkey, opts = {}) {
+    return getDecodedAccount(transport, pubkey, decodeNonceAccount, opts);
+}
+//# sourceMappingURL=nonce.js.map

package/dist/esm/accounts/nonce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nonce.js","sourceRoot":"","sources":["../../../src/accounts/nonce.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAwB,EACxB,MAAc,EACd,OAAkD,EAAE;IAEpD,OAAO,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/esm/accounts/stake.d.ts

@@ -0,0 +1,33 @@
+/**
+ * High-level typed stake account fetcher.
+ *
+ * @module accounts/stake
+ * @since 1.1.0
+ */
+import type { HttpTransport, CallOptions } from '../core/transport';
+import type { Pubkey, Commitment } from '../core/types';
+import type { DecodedStakeAccount } from '../decoders/stake';
+import type { DecodedAccountResult } from './helpers';
+/**
+ * Fetch and decode a Solana stake account.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Stake account public key.
+ * @param opts - RPC options.
+ * @returns Decoded stake account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const stake = await fetchStakeAccount(transport, stakeAccountPubkey);
+ * if (stake?.decoded.type === 'delegated') {
+ *   console.log(`Delegated to: ${stake.decoded.stake!.voterPubkey}`);
+ *   console.log(`Stake amount: ${stake.decoded.stake!.stake} lamports`);
+ * }
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function fetchStakeAccount(transport: HttpTransport, pubkey: Pubkey, opts?: {
+    commitment?: Commitment;
+} & CallOptions): Promise<DecodedAccountResult<DecodedStakeAccount> | null>;
+//# sourceMappingURL=stake.d.ts.map

package/dist/esm/accounts/stake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stake.d.ts","sourceRoot":"","sources":["../../../src/accounts/stake.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,WAAgB,GACnD,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,CAE3D"}

package/dist/esm/accounts/stake.js

@@ -0,0 +1,31 @@
+/**
+ * High-level typed stake account fetcher.
+ *
+ * @module accounts/stake
+ * @since 1.1.0
+ */
+import { decodeStakeAccount } from '../decoders/stake.js';
+import { getDecodedAccount } from './helpers.js';
+/**
+ * Fetch and decode a Solana stake account.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Stake account public key.
+ * @param opts - RPC options.
+ * @returns Decoded stake account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const stake = await fetchStakeAccount(transport, stakeAccountPubkey);
+ * if (stake?.decoded.type === 'delegated') {
+ *   console.log(`Delegated to: ${stake.decoded.stake!.voterPubkey}`);
+ *   console.log(`Stake amount: ${stake.decoded.stake!.stake} lamports`);
+ * }
+ * ```
+ *
+ * @since 1.1.0
+ */
+export async function fetchStakeAccount(transport, pubkey, opts = {}) {
+    return getDecodedAccount(transport, pubkey, decodeStakeAccount, opts);
+}
+//# sourceMappingURL=stake.js.map

package/dist/esm/accounts/stake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stake.js","sourceRoot":"","sources":["../../../src/accounts/stake.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAAwB,EACxB,MAAc,EACd,OAAkD,EAAE;IAEpD,OAAO,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/esm/accounts/token.d.ts

@@ -0,0 +1,98 @@
+/**
+ * High-level typed token account fetchers.
+ *
+ * Wraps RPC calls + decoders to provide a one-call API for fetching
+ * decoded SPL Token accounts and mints.
+ *
+ * @module accounts/token
+ * @since 1.1.0
+ */
+import type { HttpTransport, CallOptions } from '../core/transport';
+import type { Pubkey, Commitment } from '../core/types';
+import type { DecodedTokenAccount, DecodedMint } from '../decoders/token';
+import type { DecodedAccountResult } from './helpers';
+/**
+ * Fetched token account with owner program metadata.
+ * @since 1.1.0
+ */
+export interface FetchedTokenAccount extends DecodedAccountResult<DecodedTokenAccount> {
+    /** The token program that owns this account ('token' or 'token-2022'). */
+    program: 'token' | 'token-2022';
+    /** Account public key. */
+    address: Pubkey;
+}
+/**
+ * Fetched mint with owner program metadata.
+ * @since 1.1.0
+ */
+export interface FetchedMint extends DecodedAccountResult<DecodedMint> {
+    /** The token program that owns this mint ('token' or 'token-2022'). */
+    program: 'token' | 'token-2022';
+    /** Mint public key. */
+    address: Pubkey;
+}
+/**
+ * Fetch and decode a single SPL Token account.
+ *
+ * Automatically detects Token vs Token-2022 from the on-chain owner
+ * and applies the appropriate decoder (including extensions for 2022).
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Token account public key.
+ * @param opts - RPC options.
+ * @returns Decoded token account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const acct = await fetchTokenAccount(transport, tokenAccountPubkey);
+ * if (acct) console.log(`Balance: ${acct.decoded.amount}, Mint: ${acct.decoded.mint}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function fetchTokenAccount(transport: HttpTransport, pubkey: Pubkey, opts?: {
+    commitment?: Commitment;
+} & CallOptions): Promise<FetchedTokenAccount | null>;
+/**
+ * Fetch and decode a token mint.
+ *
+ * Automatically detects Token vs Token-2022 and applies the appropriate decoder.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Mint public key.
+ * @param opts - RPC options.
+ * @returns Decoded mint, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const mint = await fetchMint(transport, mintPubkey);
+ * if (mint) console.log(`Supply: ${mint.decoded.supply}, Decimals: ${mint.decoded.decimals}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function fetchMint(transport: HttpTransport, pubkey: Pubkey, opts?: {
+    commitment?: Commitment;
+} & CallOptions): Promise<FetchedMint | null>;
+/**
+ * Fetch all token accounts owned by a wallet, optionally filtered by mint.
+ *
+ * @param transport - HTTP transport.
+ * @param owner - Wallet public key.
+ * @param mint - Token mint to filter by (optional).
+ * @param opts - RPC options. Include `programId` to target Token-2022 specifically.
+ * @returns Array of decoded token accounts.
+ *
+ * @example
+ * ```ts
+ * const accounts = await fetchTokenAccountsByOwner(transport, walletPubkey, usdcMint);
+ * for (const a of accounts) console.log(`${a.address}: ${a.decoded.amount}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export declare function fetchTokenAccountsByOwner(transport: HttpTransport, owner: Pubkey, mint?: Pubkey, opts?: {
+    commitment?: Commitment;
+    programId?: Pubkey;
+} & CallOptions): Promise<FetchedTokenAccount[]>;
+//# sourceMappingURL=token.d.ts.map

package/dist/esm/accounts/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/accounts/token.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAItD;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB,CAAC,mBAAmB,CAAC;IACpF,0EAA0E;IAC1E,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,oBAAoB,CAAC,WAAW,CAAC;IACpE,uEAAuE;IACvE,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,WAAgB,GACnD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAerC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,WAAgB,GACnD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAc7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAgB,GACvE,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAkDhC"}

package/dist/esm/accounts/token.js

@@ -0,0 +1,121 @@
+/**
+ * High-level typed token account fetchers.
+ *
+ * Wraps RPC calls + decoders to provide a one-call API for fetching
+ * decoded SPL Token accounts and mints.
+ *
+ * @module accounts/token
+ * @since 1.1.0
+ */
+import { Pubkey as mkPubkey } from '../core/types.js';
+import { decodeTokenAccount, decodeMint, TOKEN_PROGRAM_ID } from '../decoders/token.js';
+import { decodeToken2022Account, decodeToken2022Mint, TOKEN_2022_PROGRAM_ID } from '../decoders/token-2022.js';
+import { getDecodedAccount, base64ToBytes } from './helpers.js';
+// ── Fetchers ───────────────────────────────────────────────────
+/**
+ * Fetch and decode a single SPL Token account.
+ *
+ * Automatically detects Token vs Token-2022 from the on-chain owner
+ * and applies the appropriate decoder (including extensions for 2022).
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Token account public key.
+ * @param opts - RPC options.
+ * @returns Decoded token account, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const acct = await fetchTokenAccount(transport, tokenAccountPubkey);
+ * if (acct) console.log(`Balance: ${acct.decoded.amount}, Mint: ${acct.decoded.mint}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export async function fetchTokenAccount(transport, pubkey, opts = {}) {
+    const result = await getDecodedAccount(transport, pubkey, decodeTokenAccount, opts);
+    if (!result)
+        return null;
+    const owner = String(result.raw.owner);
+    const program = owner === TOKEN_2022_PROGRAM_ID ? 'token-2022' : 'token';
+    // Re-decode with Token-2022 decoder to capture extensions
+    if (program === 'token-2022') {
+        const bytes = base64ToBytes(result.raw.data);
+        const decoded = decodeToken2022Account(bytes);
+        return { decoded, raw: result.raw, slot: result.slot, program, address: pubkey };
+    }
+    return { decoded: result.decoded, raw: result.raw, slot: result.slot, program, address: pubkey };
+}
+/**
+ * Fetch and decode a token mint.
+ *
+ * Automatically detects Token vs Token-2022 and applies the appropriate decoder.
+ *
+ * @param transport - HTTP transport.
+ * @param pubkey - Mint public key.
+ * @param opts - RPC options.
+ * @returns Decoded mint, or `null` if not found.
+ *
+ * @example
+ * ```ts
+ * const mint = await fetchMint(transport, mintPubkey);
+ * if (mint) console.log(`Supply: ${mint.decoded.supply}, Decimals: ${mint.decoded.decimals}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export async function fetchMint(transport, pubkey, opts = {}) {
+    const result = await getDecodedAccount(transport, pubkey, decodeMint, opts);
+    if (!result)
+        return null;
+    const owner = String(result.raw.owner);
+    const program = owner === TOKEN_2022_PROGRAM_ID ? 'token-2022' : 'token';
+    if (program === 'token-2022') {
+        const bytes = base64ToBytes(result.raw.data);
+        const decoded = decodeToken2022Mint(bytes);
+        return { decoded, raw: result.raw, slot: result.slot, program, address: pubkey };
+    }
+    return { decoded: result.decoded, raw: result.raw, slot: result.slot, program, address: pubkey };
+}
+/**
+ * Fetch all token accounts owned by a wallet, optionally filtered by mint.
+ *
+ * @param transport - HTTP transport.
+ * @param owner - Wallet public key.
+ * @param mint - Token mint to filter by (optional).
+ * @param opts - RPC options. Include `programId` to target Token-2022 specifically.
+ * @returns Array of decoded token accounts.
+ *
+ * @example
+ * ```ts
+ * const accounts = await fetchTokenAccountsByOwner(transport, walletPubkey, usdcMint);
+ * for (const a of accounts) console.log(`${a.address}: ${a.decoded.amount}`);
+ * ```
+ *
+ * @since 1.1.0
+ */
+export async function fetchTokenAccountsByOwner(transport, owner, mint, opts = {}) {
+    const { commitment, programId, ...callOpts } = opts;
+    const filter = mint
+        ? { mint: String(mint) }
+        : { programId: String(programId ?? TOKEN_PROGRAM_ID) };
+    const cfg = { encoding: 'base64' };
+    if (commitment)
+        cfg.commitment = commitment;
+    const result = await transport.request('getTokenAccountsByOwner', [owner, filter, cfg], callOpts);
+    return result.value.map((entry) => {
+        const bytes = base64ToBytes(entry.account.data);
+        const entryOwner = entry.account.owner;
+        const program = entryOwner === TOKEN_2022_PROGRAM_ID ? 'token-2022' : 'token';
+        const decoded = program === 'token-2022'
+            ? decodeToken2022Account(bytes)
+            : decodeTokenAccount(bytes);
+        return {
+            decoded,
+            raw: entry.account,
+            slot: result.context.slot,
+            program,
+            address: mkPubkey(entry.pubkey),
+        };
+    });
+}
+//# sourceMappingURL=token.js.map

package/dist/esm/accounts/token.js.map

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

package/dist/esm/ai/gateway/index.js

@@ -609,7 +609,7 @@ export class AgentGateway {
         this.getSessionOrThrow(sessionId);
         // Lazy import to keep gateway usable without langchain installed
         const { tool: lcTool } = await import('@langchain/core/tools');
-        const { agentRpcMethods } = await import('../tools/zod.js');
+        const { agentRpcMethods } = await import('../tools/zod/index.js');
         const tools = [];
         for (const method of agentRpcMethods) {
             const gateway = this;
@@ -740,5 +740,5 @@ export { PricingEngine, DEFAULT_TIERS } from './pricing.js';
 export { ResponseValidator } from './validator.js';
 export { ToolMarketplace } from './marketplace.js';
 /* ── x402 Protocol ─────────────────────────────────────────── */
-export * from './x402.js';
+export * from './x402/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ai/gateway/x402/facilitator.d.ts

@@ -144,20 +144,20 @@ export declare class FacilitatorClient {
  * ```ts
  * import { createFacilitator, KnownFacilitator } from '@oobe-protocol-labs/synapse-client-sdk';
  *
- * // ✅ One-liner with a known facilitator
+ * // One-liner with a known facilitator
  * const facilitator = createFacilitator(KnownFacilitator.PayAI);
  * const facilitator = createFacilitator(KnownFacilitator.RelAI);
  * const facilitator = createFacilitator(KnownFacilitator.Dexter);
  * const facilitator = createFacilitator(KnownFacilitator.CDP);
  *
- * // ✅ Custom URL
+ * // Custom URL
  * const facilitator = createFacilitator({ url: 'https://my-facilitator.com' });
  *
- * // ✅ Known facilitator + auth override
+ * // Known facilitator + auth override
  * const facilitator = createFacilitator(KnownFacilitator.PayAI);
  * // Then set PAYAI_API_KEY_ID / PAYAI_API_KEY_SECRET env vars for production.
  *
- * // ✅ Default (PayAI free tier)
+ * // Default (PayAI free tier)
  * const facilitator = createFacilitator();
  * ```
  *

package/dist/esm/ai/gateway/x402/facilitator.js

@@ -257,20 +257,20 @@ export class FacilitatorClient {
  * ```ts
  * import { createFacilitator, KnownFacilitator } from '@oobe-protocol-labs/synapse-client-sdk';
  *
- * // ✅ One-liner with a known facilitator
+ * // One-liner with a known facilitator
  * const facilitator = createFacilitator(KnownFacilitator.PayAI);
  * const facilitator = createFacilitator(KnownFacilitator.RelAI);
  * const facilitator = createFacilitator(KnownFacilitator.Dexter);
  * const facilitator = createFacilitator(KnownFacilitator.CDP);
  *
- * // ✅ Custom URL
+ * // Custom URL
  * const facilitator = createFacilitator({ url: 'https://my-facilitator.com' });
  *
- * // ✅ Known facilitator + auth override
+ * // Known facilitator + auth override
  * const facilitator = createFacilitator(KnownFacilitator.PayAI);
  * // Then set PAYAI_API_KEY_ID / PAYAI_API_KEY_SECRET env vars for production.
  *
- * // ✅ Default (PayAI free tier)
+ * // Default (PayAI free tier)
  * const facilitator = createFacilitator();
  * ```
  *

package/dist/esm/ai/index.js

@@ -15,7 +15,7 @@
  * @since 1.0.0
  */
 // ── Tools (LangChain) ─────────────────────────────────────────
-export { createExecutableSolanaTools, agentRpcMethods, solanaToolNames, } from './tools.js';
+export { createExecutableSolanaTools, agentRpcMethods, solanaToolNames, } from './tools/index.js';
 // ── Gateway (Agent Commerce) ──────────────────────────────────
 export { 
 // Main orchestrator
@@ -33,5 +33,5 @@ GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, c
 // x402 Protocol
 X402Paywall, X402Client, FacilitatorClient, createFacilitator, createX402Client, encodePaymentHeader, decodePaymentHeader, defaultRequirementsSelector, SOLANA_MAINNET, SOLANA_DEVNET, USDC_MAINNET, USDC_DEVNET, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, X402_VERSION, 
 // x402 Errors
-FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, } from './gateway.js';
+FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, } from './gateway/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ai/tools/index.js

@@ -20,9 +20,9 @@
  * @since 1.0.0
  */
 import { tool } from '@langchain/core/tools';
-import { agentRpcMethods } from './zod.js';
+import { agentRpcMethods } from './zod/index.js';
 // Re-export for convenience
-export { agentRpcMethods } from './zod.js';
+export { agentRpcMethods } from './zod/index.js';
 // ── Protocol tools (Jupiter, Raydium, Metaplex) ───────────────
 export { 
 // Factories
@@ -32,7 +32,7 @@ jupiterMethods, jupiterMethodNames, raydiumMethods, raydiumMethodNames, metaplex
 // Shared infrastructure
 ProtocolHttpClient, ProtocolApiError, buildProtocolTools, createMethodRegistry, 
 // Constants
-JUPITER_API_URL, RAYDIUM_API_URL, } from './protocols.js';
+JUPITER_API_URL, RAYDIUM_API_URL, } from './protocols/index.js';
 /* ═══════════════════════════════════════════════════════════════
  *  Method name → standalone function dispatcher
  *

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

@@ -20,14 +20,14 @@
 // ── Shared infrastructure ──────────────────────────────────────
 export { ProtocolHttpClient, ProtocolApiError, createMethodRegistry, buildProtocolTools, } from './shared.js';
 // ── Jupiter ────────────────────────────────────────────────────
-export { createJupiterTools, jupiterMethods, jupiterMethodNames, JUPITER_API_URL, } from './jupiter.js';
+export { createJupiterTools, jupiterMethods, jupiterMethodNames, JUPITER_API_URL, } from './jupiter/index.js';
 // ── Raydium ────────────────────────────────────────────────────
-export { createRaydiumTools, raydiumMethods, raydiumMethodNames, RAYDIUM_API_URL, } from './raydium.js';
+export { createRaydiumTools, raydiumMethods, raydiumMethodNames, RAYDIUM_API_URL, } from './raydium/index.js';
 // ── Metaplex ───────────────────────────────────────────────────
-export { createMetaplexTools, metaplexMethods, metaplexMethodNames, } from './metaplex.js';
-import { createJupiterTools } from './jupiter.js';
-import { createRaydiumTools } from './raydium.js';
-import { createMetaplexTools } from './metaplex.js';
+export { createMetaplexTools, metaplexMethods, metaplexMethodNames, } from './metaplex/index.js';
+import { createJupiterTools } from './jupiter/index.js';
+import { createRaydiumTools } from './raydium/index.js';
+import { createMetaplexTools } from './metaplex/index.js';
 /**
  * @description Create tools for all Solana native protocols in a single call.
  *

package/dist/esm/ai/tools/zod/index.d.ts

@@ -31,5 +31,5 @@ export declare const agentRpcMethods: AgentRpcMethod[];
  * @returns {AgentRpcMethod} The registered method descriptor
  * @since 1.0.0
  */
-export declare function registerRpcMethod<I extends z.ZodTypeAny, O extends z.ZodTypeAny>(name: string, input: I, output: O, description?: string): AgentRpcMethod;
+export declare function registerRpcMethod<I extends z.ZodTypeAny, O extends z.ZodTypeAny>(name: string, input: I, output: O, description?: string, skill?: string): AgentRpcMethod;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/ai/tools/zod/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,SAAS,CAAC;AAEjB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAc9C;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EAAoB,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,EAC9E,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,EACT,WAAW,CAAC,EAAE,MAAM,GACnB,cAAc,CAKhB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,SAAS,CAAC;AAEjB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAc9C;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EAAoB,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,UAAU,EAC9E,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,EACT,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,cAAc,CAKhB"}

package/dist/esm/ai/tools/zod/index.js

@@ -43,10 +43,10 @@ export const agentRpcMethods = _registry ?? [];
  * @returns {AgentRpcMethod} The registered method descriptor
  * @since 1.0.0
  */
-export function registerRpcMethod(name, input, output, description) {
+export function registerRpcMethod(name, input, output, description, skill) {
     if (!_registry)
         _registry = [];
-    const method = { name, input, output, description };
+    const method = { name, input, output, description, skill };
     _registry.push(method);
     return method;
 }

package/dist/esm/ai/tools/zod/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;qEAGqE;AACrE,OAAO,SAAS,CAAC;AAOjB;;;;;;;;GAQG;AACH,kCAAkC;AAClC,IAAI,SAAuC,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB,SAAS,IAAI,EAAE,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAAQ,EACR,MAAS,EACT,WAAoB;IAEpB,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACpE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;qEAGqE;AACrE,OAAO,SAAS,CAAC;AAOjB;;;;;;;;GAQG;AACH,kCAAkC;AAClC,IAAI,SAAuC,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqB,SAAS,IAAI,EAAE,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAAQ,EACR,MAAS,EACT,WAAoB,EACpB,KAAc;IAEd,IAAI,CAAC,SAAS;QAAE,SAAS,GAAG,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAG,CAAC;IAC5E,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/ai/tools/zod/types.d.ts

@@ -21,5 +21,7 @@ export interface AgentRpcMethod {
     input: z.ZodTypeAny;
     /** Zod schema documenting the expected output shape. */
     output: z.ZodTypeAny;
+    /** Optional skill/category tag for organizing methods. */
+    skill?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/esm/ai/tools/zod/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/ai/tools/zod/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IACpB,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IAErB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}