x402-svm-mantle 2.1.1-mantle

package/dist/esm/exact/server/index.d.mts

@@ -0,0 +1,87 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from 'x402-core-mantle/types';
+import { x402ResourceServer } from 'x402-core-mantle/server';
+
+/**
+ * SVM server implementation for the Exact payment scheme.
+ */
+declare class ExactSvmScheme implements SchemeNetworkServer {
+    readonly scheme = "exact";
+    private moneyParsers;
+    /**
+     * Register a custom money parser in the parser chain.
+     * Multiple parsers can be registered - they will be tried in registration order.
+     * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+     * If a parser returns null, the next parser in the chain will be tried.
+     * The default parser is always the final fallback.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The service instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): ExactSvmScheme;
+    /**
+     * Parses a price into an asset amount.
+     * If price is already an AssetAmount, returns it directly.
+     * If price is Money (string | number), parses to decimal and tries custom parsers.
+     * Falls back to default conversion if all custom parsers return null.
+     *
+     * @param price - The price to parse
+     * @param network - The network to use
+     * @returns Promise that resolves to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Build payment requirements for this scheme/network combination
+     *
+     * @param paymentRequirements - The base payment requirements
+     * @param supportedKind - The supported kind configuration
+     * @param supportedKind.x402Version - The x402 protocol version
+     * @param supportedKind.scheme - The payment scheme
+     * @param supportedKind.network - The network identifier
+     * @param supportedKind.extra - Extra metadata including feePayer address
+     * @param extensionKeys - Extension keys supported by the facilitator
+     * @returns Enhanced payment requirements with feePayer in extra
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        x402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     * Handles formats like "$1.50", "1.50", 1.50, etc.
+     *
+     * @param money - The money value to parse
+     * @returns Decimal number
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     * Converts decimal amount to USDC on the specified network.
+     *
+     * @param amount - The decimal amount (e.g., 1.50)
+     * @param network - The network to use
+     * @returns The parsed asset amount in USDC
+     */
+    private defaultMoneyConversion;
+}
+
+/**
+ * Configuration options for registering SVM schemes to an x402ResourceServer
+ */
+interface SvmResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     */
+    networks?: Network[];
+}
+/**
+ * Registers SVM payment schemes to an existing x402ResourceServer instance.
+ *
+ * @param server - The x402ResourceServer instance to register schemes to
+ * @param config - Configuration for SVM resource server registration
+ * @returns The server instance for chaining
+ */
+declare function registerExactSvmScheme(server: x402ResourceServer, config?: SvmResourceServerConfig): x402ResourceServer;
+
+export { ExactSvmScheme, type SvmResourceServerConfig, registerExactSvmScheme };

package/dist/esm/exact/server/index.mjs

@@ -0,0 +1,129 @@
+import {
+  convertToTokenAmount,
+  getUsdcAddress
+} from "../../chunk-PHFXLBH6.mjs";
+
+// src/exact/server/scheme.ts
+var ExactSvmScheme = class {
+  constructor() {
+    this.scheme = "exact";
+    this.moneyParsers = [];
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   * Multiple parsers can be registered - they will be tried in registration order.
+   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+   * If a parser returns null, the next parser in the chain will be tried.
+   * The default parser is always the final fallback.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The service instance for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount.
+   * If price is already an AssetAmount, returns it directly.
+   * If price is Money (string | number), parses to decimal and tries custom parsers.
+   * Falls back to default conversion if all custom parsers return null.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves to the parsed asset amount
+   */
+  async parsePrice(price, network) {
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * Build payment requirements for this scheme/network combination
+   *
+   * @param paymentRequirements - The base payment requirements
+   * @param supportedKind - The supported kind configuration
+   * @param supportedKind.x402Version - The x402 protocol version
+   * @param supportedKind.scheme - The payment scheme
+   * @param supportedKind.network - The network identifier
+   * @param supportedKind.extra - Extra metadata including feePayer address
+   * @param extensionKeys - Extension keys supported by the facilitator
+   * @returns Enhanced payment requirements with feePayer in extra
+   */
+  enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    return Promise.resolve({
+      ...paymentRequirements,
+      extra: {
+        ...paymentRequirements.extra,
+        feePayer: supportedKind.extra?.feePayer
+      }
+    });
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   * Handles formats like "$1.50", "1.50", 1.50, etc.
+   *
+   * @param money - The money value to parse
+   * @returns Decimal number
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion implementation.
+   * Converts decimal amount to USDC on the specified network.
+   *
+   * @param amount - The decimal amount (e.g., 1.50)
+   * @param network - The network to use
+   * @returns The parsed asset amount in USDC
+   */
+  defaultMoneyConversion(amount, network) {
+    const tokenAmount = convertToTokenAmount(amount.toString(), 6);
+    return {
+      amount: tokenAmount,
+      asset: getUsdcAddress(network),
+      extra: {}
+    };
+  }
+};
+
+// src/exact/server/register.ts
+function registerExactSvmScheme(server, config = {}) {
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, new ExactSvmScheme());
+    });
+  } else {
+    server.register("solana:*", new ExactSvmScheme());
+  }
+  return server;
+}
+export {
+  ExactSvmScheme,
+  registerExactSvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/scheme.ts","../../../../src/exact/server/register.ts"],"sourcesContent":["import type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"x402-core-mantle/types\";\nimport { convertToTokenAmount, getUsdcAddress } from \"../../utils\";\n\n/**\n * SVM server implementation for the Exact payment scheme.\n */\nexport class ExactSvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"exact\";\n  private moneyParsers: MoneyParser[] = [];\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The service instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): ExactSvmScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination\n   *\n   * @param paymentRequirements - The base payment requirements\n   * @param supportedKind - The supported kind configuration\n   * @param supportedKind.x402Version - The x402 protocol version\n   * @param supportedKind.scheme - The payment scheme\n   * @param supportedKind.network - The network identifier\n   * @param supportedKind.extra - Extra metadata including feePayer address\n   * @param extensionKeys - Extension keys supported by the facilitator\n   * @returns Enhanced payment requirements with feePayer in extra\n   */\n  enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      x402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters to satisfy linter\n    void extensionKeys;\n\n    // Add feePayer from supportedKind.extra to payment requirements\n    // The facilitator provides its address as the fee payer for transaction fees\n    return Promise.resolve({\n      ...paymentRequirements,\n      extra: {\n        ...paymentRequirements.extra,\n        feePayer: supportedKind.extra?.feePayer,\n      },\n    });\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   *\n   * @param money - The money value to parse\n   * @returns Decimal number\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to USDC on the specified network.\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount in USDC\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    // Convert decimal amount to token amount (USDC has 6 decimals)\n    const tokenAmount = convertToTokenAmount(amount.toString(), 6);\n\n    return {\n      amount: tokenAmount,\n      asset: getUsdcAddress(network),\n      extra: {},\n    };\n  }\n}\n","import { x402ResourceServer } from \"x402-core-mantle/server\";\nimport { Network } from \"x402-core-mantle/types\";\nimport { ExactSvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering SVM schemes to an x402ResourceServer\n */\nexport interface SvmResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402ResourceServer instance.\n *\n * @param server - The x402ResourceServer instance to register schemes to\n * @param config - Configuration for SVM resource server registration\n * @returns The server instance for chaining\n */\nexport function registerExactSvmScheme(\n  server: x402ResourceServer,\n  config: SvmResourceServerConfig = {},\n): x402ResourceServer {\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      server.register(network, new ExactSvmScheme());\n    });\n  } else {\n    server.register(\"solana:*\", new ExactSvmScheme());\n  }\n\n  return server;\n}\n"],"mappings":";;;;;;AAaO,IAAM,iBAAN,MAAoD;AAAA,EAApD;AACL,SAAS,SAAS;AAClB,SAAQ,eAA8B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYvC,oBAAoB,QAAqC;AACvD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,OAAc,SAAwC;AAErE,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,8DAA8D,OAAO,EAAE;AAAA,MACzF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,QAAQ,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,2BACE,qBACA,eAMA,eAC8B;AAE9B,SAAK;AAIL,WAAO,QAAQ,QAAQ;AAAA,MACrB,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,oBAAoB;AAAA,QACvB,UAAU,cAAc,OAAO;AAAA,MACjC;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,uBAAuB,QAAgB,SAA+B;AAE5E,UAAM,cAAc,qBAAqB,OAAO,SAAS,GAAG,CAAC;AAE7D,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,eAAe,OAAO;AAAA,MAC7B,OAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AC9HO,SAAS,uBACd,QACA,SAAkC,CAAC,GACf;AACpB,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,CAAC;AAAA,IAC/C,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,eAAe,CAAC;AAAA,EAClD;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/exact/v1/client/index.d.mts

@@ -0,0 +1,33 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from 'x402-core-mantle/types';
+import { C as ClientSvmSigner, a as ClientSvmConfig } from '../../../signer-BMkbhFYE.mjs';
+import '@solana/kit';
+
+/**
+ * SVM client implementation for the Exact payment scheme (V1).
+ */
+declare class ExactSvmSchemeV1 implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly config?;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactSvmClientV1 instance.
+     *
+     * @param signer - The SVM signer for client operations
+     * @param config - Optional configuration with custom RPC URL
+     * @returns ExactSvmClientV1 instance
+     */
+    constructor(signer: ClientSvmSigner, config?: ClientSvmConfig | undefined);
+    /**
+     * Creates a payment payload for the Exact scheme (V1).
+     *
+     * @param x402Version - The x402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload"> & {
+        scheme: string;
+        network: Network;
+    }>;
+}
+
+export { ExactSvmSchemeV1 };

package/dist/esm/exact/v1/client/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactSvmSchemeV1
+} from "../../../chunk-M7NDDMX7.mjs";
+import "../../../chunk-PHFXLBH6.mjs";
+export {
+  ExactSvmSchemeV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/v1/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/exact/v1/facilitator/index.d.mts

@@ -0,0 +1,71 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from 'x402-core-mantle/types';
+import { F as FacilitatorSvmSigner } from '../../../signer-BMkbhFYE.mjs';
+import '@solana/kit';
+
+/**
+ * SVM facilitator implementation for the Exact payment scheme (V1).
+ */
+declare class ExactSvmSchemeV1 implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "solana:*";
+    /**
+     * Creates a new ExactSvmFacilitatorV1 instance.
+     *
+     * @param signer - The SVM RPC client for facilitator operations
+     * @returns ExactSvmFacilitatorV1 instance
+     */
+    constructor(signer: FacilitatorSvmSigner);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * For SVM, this includes a randomly selected fee payer address.
+     * Random selection distributes load across multiple signers.
+     *
+     * @param _ - The network identifier (unused for SVM)
+     * @returns Extra data with feePayer address
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * For SVM, returns all available fee payer addresses.
+     *
+     * @param _ - The network identifier (unused for SVM)
+     * @returns Array of fee payer addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies a payment payload (V1).
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by submitting the transaction (V1).
+     * Ensures the correct signer is used based on the feePayer specified in requirements.
+     *
+     * @param payload - The payment payload to settle
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    /**
+     * Verify compute limit instruction
+     *
+     * @param instruction - The compute limit instruction
+     * @param instruction.programAddress - Program address
+     * @param instruction.data - Instruction data bytes
+     */
+    private verifyComputeLimitInstruction;
+    /**
+     * Verify compute price instruction
+     *
+     * @param instruction - The compute price instruction
+     * @param instruction.programAddress - Program address
+     * @param instruction.data - Instruction data bytes
+     */
+    private verifyComputePriceInstruction;
+}
+
+export { ExactSvmSchemeV1 };

package/dist/esm/exact/v1/facilitator/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactSvmSchemeV1
+} from "../../../chunk-WRDCPYFH.mjs";
+import "../../../chunk-PHFXLBH6.mjs";
+export {
+  ExactSvmSchemeV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/v1/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/index.d.mts

@@ -0,0 +1,118 @@
+export { E as ExactSvmScheme } from './scheme-VFikrqtD.mjs';
+export { a as ClientSvmConfig, C as ClientSvmSigner, c as FacilitatorRpcClient, d as FacilitatorRpcConfig, F as FacilitatorSvmSigner, t as toClientSvmSigner, b as toFacilitatorSvmSigner } from './signer-BMkbhFYE.mjs';
+import { Transaction, RpcDevnet, SolanaRpcApiDevnet, RpcTestnet, SolanaRpcApiTestnet, RpcMainnet, SolanaRpcApiMainnet } from '@solana/kit';
+import { Network } from 'x402-core-mantle/types';
+
+/**
+ * Exact SVM payload structure containing a base64 encoded Solana transaction
+ */
+type ExactSvmPayloadV1 = {
+    /**
+     * Base64 encoded Solana transaction
+     */
+    transaction: string;
+};
+/**
+ * Exact SVM payload V2 structure (currently same as V1, reserved for future extensions)
+ */
+type ExactSvmPayloadV2 = ExactSvmPayloadV1;
+
+/**
+ * Token program addresses for SPL Token and Token-2022
+ * These addresses are the same across all Solana networks (mainnet, devnet, testnet)
+ */
+declare const TOKEN_PROGRAM_ADDRESS = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+declare const TOKEN_2022_PROGRAM_ADDRESS = "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+declare const COMPUTE_BUDGET_PROGRAM_ADDRESS = "ComputeBudget111111111111111111111111111111";
+/**
+ * Default RPC URLs for Solana networks
+ */
+declare const DEVNET_RPC_URL = "https://api.devnet.solana.com";
+declare const TESTNET_RPC_URL = "https://api.testnet.solana.com";
+declare const MAINNET_RPC_URL = "https://api.mainnet-beta.solana.com";
+declare const DEVNET_WS_URL = "wss://api.devnet.solana.com";
+declare const TESTNET_WS_URL = "wss://api.testnet.solana.com";
+declare const MAINNET_WS_URL = "wss://api.mainnet-beta.solana.com";
+/**
+ * USDC token mint addresses (default stablecoin)
+ */
+declare const USDC_MAINNET_ADDRESS = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+declare const USDC_DEVNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+declare const USDC_TESTNET_ADDRESS = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+/**
+ * Compute budget configuration
+ * All prices are in microlamports (1 lamport = 1,000,000 microlamports)
+ */
+declare const DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 1;
+declare const MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 5000000;
+declare const DEFAULT_COMPUTE_UNIT_LIMIT = 6500;
+/**
+ * Solana address validation regex (base58, 32-44 characters)
+ */
+declare const SVM_ADDRESS_REGEX: RegExp;
+/**
+ * CAIP-2 network identifiers for Solana (V2)
+ */
+declare const SOLANA_MAINNET_CAIP2 = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+declare const SOLANA_DEVNET_CAIP2 = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+declare const SOLANA_TESTNET_CAIP2 = "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+/**
+ * V1 to V2 network identifier mappings (for backwards compatibility)
+ * V1 used simple names like solana, V2 uses CAIP-2
+ */
+declare const V1_TO_V2_NETWORK_MAP: Record<string, string>;
+
+/**
+ * Normalize network identifier to CAIP-2 format
+ * Handles both V1 names (solana, solana-devnet) and V2 CAIP-2 format
+ *
+ * @param network - Network identifier (V1 or V2 format)
+ * @returns CAIP-2 network identifier
+ */
+declare function normalizeNetwork(network: Network): string;
+/**
+ * Validate Solana address format
+ *
+ * @param address - Base58 encoded address string
+ * @returns true if address is valid, false otherwise
+ */
+declare function validateSvmAddress(address: string): boolean;
+/**
+ * Decode a base64 encoded transaction from an SVM payload
+ *
+ * @param svmPayload - The SVM payload containing a base64 encoded transaction
+ * @returns Decoded Transaction object
+ */
+declare function decodeTransactionFromPayload(svmPayload: ExactSvmPayloadV1): Transaction;
+/**
+ * Extract the token sender (owner of the source token account) from a TransferChecked instruction
+ *
+ * @param transaction - The decoded transaction
+ * @returns The token payer address as a base58 string
+ */
+declare function getTokenPayerFromTransaction(transaction: Transaction): string;
+/**
+ * Create an RPC client for the specified network
+ *
+ * @param network - Network identifier (CAIP-2 or V1 format)
+ * @param customRpcUrl - Optional custom RPC URL
+ * @returns RPC client for the specified network
+ */
+declare function createRpcClient(network: Network, customRpcUrl?: string): RpcDevnet<SolanaRpcApiDevnet> | RpcTestnet<SolanaRpcApiTestnet> | RpcMainnet<SolanaRpcApiMainnet>;
+/**
+ * Get the default USDC mint address for a network
+ *
+ * @param network - Network identifier (CAIP-2 or V1 format)
+ * @returns USDC mint address for the network
+ */
+declare function getUsdcAddress(network: Network): string;
+/**
+ * Convert a decimal amount to token smallest units
+ *
+ * @param decimalAmount - The decimal amount (e.g., "0.10")
+ * @param decimals - The number of decimals for the token (e.g., 6 for USDC)
+ * @returns The amount in smallest units as a string
+ */
+declare function convertToTokenAmount(decimalAmount: string, decimals: number): string;
+
+export { COMPUTE_BUDGET_PROGRAM_ADDRESS, DEFAULT_COMPUTE_UNIT_LIMIT, DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS, DEVNET_RPC_URL, DEVNET_WS_URL, type ExactSvmPayloadV1, type ExactSvmPayloadV2, MAINNET_RPC_URL, MAINNET_WS_URL, MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS, SOLANA_DEVNET_CAIP2, SOLANA_MAINNET_CAIP2, SOLANA_TESTNET_CAIP2, SVM_ADDRESS_REGEX, TESTNET_RPC_URL, TESTNET_WS_URL, TOKEN_2022_PROGRAM_ADDRESS, TOKEN_PROGRAM_ADDRESS, USDC_DEVNET_ADDRESS, USDC_MAINNET_ADDRESS, USDC_TESTNET_ADDRESS, V1_TO_V2_NETWORK_MAP, convertToTokenAmount, createRpcClient, decodeTransactionFromPayload, getTokenPayerFromTransaction, getUsdcAddress, normalizeNetwork, validateSvmAddress };

package/dist/esm/index.mjs

@@ -0,0 +1,198 @@
+import {
+  ExactSvmScheme
+} from "./chunk-TA6OPUHK.mjs";
+import {
+  COMPUTE_BUDGET_PROGRAM_ADDRESS,
+  DEFAULT_COMPUTE_UNIT_LIMIT,
+  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  DEVNET_RPC_URL,
+  DEVNET_WS_URL,
+  MAINNET_RPC_URL,
+  MAINNET_WS_URL,
+  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  SOLANA_DEVNET_CAIP2,
+  SOLANA_MAINNET_CAIP2,
+  SOLANA_TESTNET_CAIP2,
+  SVM_ADDRESS_REGEX,
+  TESTNET_RPC_URL,
+  TESTNET_WS_URL,
+  TOKEN_2022_PROGRAM_ADDRESS,
+  TOKEN_PROGRAM_ADDRESS,
+  USDC_DEVNET_ADDRESS,
+  USDC_MAINNET_ADDRESS,
+  USDC_TESTNET_ADDRESS,
+  V1_TO_V2_NETWORK_MAP,
+  convertToTokenAmount,
+  createRpcClient,
+  decodeTransactionFromPayload,
+  getTokenPayerFromTransaction,
+  getUsdcAddress,
+  normalizeNetwork,
+  validateSvmAddress
+} from "./chunk-PHFXLBH6.mjs";
+
+// src/signer.ts
+import { getBase64EncodedWireTransaction } from "@solana/kit";
+function toClientSvmSigner(signer) {
+  return signer;
+}
+function createRpcCapabilitiesFromRpc(rpc) {
+  return {
+    getBalance: async (address) => {
+      const result = await rpc.getBalance(address).send();
+      return result.value;
+    },
+    getTokenAccountBalance: async (address) => {
+      const accountInfo = await rpc.getAccountInfo(address, {
+        encoding: "jsonParsed"
+      }).send();
+      if (!accountInfo.value) {
+        throw new Error(`Token account not found: ${address}`);
+      }
+      const parsed = accountInfo.value.data;
+      return BigInt(parsed.parsed.info.tokenAmount.amount);
+    },
+    getLatestBlockhash: async () => {
+      const result = await rpc.getLatestBlockhash().send();
+      return {
+        blockhash: result.value.blockhash,
+        lastValidBlockHeight: result.value.lastValidBlockHeight
+      };
+    },
+    simulateTransaction: async (transaction, config) => {
+      return await rpc.simulateTransaction(transaction, config).send();
+    },
+    sendTransaction: async (transaction) => {
+      return await rpc.sendTransaction(transaction, {
+        encoding: "base64"
+      }).send();
+    },
+    confirmTransaction: async (signature) => {
+      let confirmed = false;
+      let attempts = 0;
+      const maxAttempts = 30;
+      while (!confirmed && attempts < maxAttempts) {
+        const status = await rpc.getSignatureStatuses([signature]).send();
+        if (status.value[0]?.confirmationStatus === "confirmed" || status.value[0]?.confirmationStatus === "finalized") {
+          confirmed = true;
+          return status.value[0];
+        }
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        attempts++;
+      }
+      throw new Error("Transaction confirmation timeout");
+    },
+    fetchMint: async (address) => {
+      const { fetchMint } = await import("@solana-program/token-2022");
+      return await fetchMint(rpc, address);
+    }
+  };
+}
+function toFacilitatorSvmSigner(signer, rpcConfig) {
+  let rpcMap = {};
+  let defaultRpcUrl;
+  if (rpcConfig) {
+    if ("defaultRpcUrl" in rpcConfig && typeof rpcConfig.defaultRpcUrl === "string") {
+      defaultRpcUrl = rpcConfig.defaultRpcUrl;
+    } else if ("getBalance" in rpcConfig || "getSlot" in rpcConfig) {
+      rpcMap["*"] = rpcConfig;
+    } else {
+      rpcMap = rpcConfig;
+    }
+  }
+  const getRpcForNetwork = (network) => {
+    if (rpcMap[network]) {
+      return rpcMap[network];
+    }
+    if (rpcMap["*"]) {
+      return rpcMap["*"];
+    }
+    return createRpcClient(network, defaultRpcUrl);
+  };
+  return {
+    getAddresses: () => {
+      return [signer.address];
+    },
+    signTransaction: async (transaction, feePayer, _) => {
+      if (feePayer !== signer.address) {
+        throw new Error(`No signer for feePayer ${feePayer}. Available: ${signer.address}`);
+      }
+      const tx = decodeTransactionFromPayload({ transaction });
+      const signableMessage = {
+        content: tx.messageBytes,
+        signatures: tx.signatures
+      };
+      const [facilitatorSignatureDictionary] = await signer.signMessages([
+        signableMessage
+      ]);
+      const fullySignedTx = {
+        ...tx,
+        signatures: {
+          ...tx.signatures,
+          ...facilitatorSignatureDictionary
+        }
+      };
+      return getBase64EncodedWireTransaction(fullySignedTx);
+    },
+    simulateTransaction: async (transaction, network) => {
+      const rpc = getRpcForNetwork(network);
+      const result = await rpc.simulateTransaction(transaction, {
+        sigVerify: true,
+        replaceRecentBlockhash: false,
+        commitment: "confirmed",
+        encoding: "base64"
+      }).send();
+      if (result.value.err) {
+        const errorStr = JSON.stringify(
+          result.value.err,
+          (_, v) => typeof v === "bigint" ? v.toString() : v
+        );
+        throw new Error(`Simulation failed: ${errorStr}`);
+      }
+    },
+    sendTransaction: async (transaction, network) => {
+      const rpc = getRpcForNetwork(network);
+      return await rpc.sendTransaction(transaction, {
+        encoding: "base64"
+      }).send();
+    },
+    confirmTransaction: async (signature, network) => {
+      const rpc = getRpcForNetwork(network);
+      const rpcCapabilities = createRpcCapabilitiesFromRpc(rpc);
+      await rpcCapabilities.confirmTransaction(signature);
+    }
+  };
+}
+export {
+  COMPUTE_BUDGET_PROGRAM_ADDRESS,
+  DEFAULT_COMPUTE_UNIT_LIMIT,
+  DEFAULT_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  DEVNET_RPC_URL,
+  DEVNET_WS_URL,
+  ExactSvmScheme,
+  MAINNET_RPC_URL,
+  MAINNET_WS_URL,
+  MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS,
+  SOLANA_DEVNET_CAIP2,
+  SOLANA_MAINNET_CAIP2,
+  SOLANA_TESTNET_CAIP2,
+  SVM_ADDRESS_REGEX,
+  TESTNET_RPC_URL,
+  TESTNET_WS_URL,
+  TOKEN_2022_PROGRAM_ADDRESS,
+  TOKEN_PROGRAM_ADDRESS,
+  USDC_DEVNET_ADDRESS,
+  USDC_MAINNET_ADDRESS,
+  USDC_TESTNET_ADDRESS,
+  V1_TO_V2_NETWORK_MAP,
+  convertToTokenAmount,
+  createRpcClient,
+  decodeTransactionFromPayload,
+  getTokenPayerFromTransaction,
+  getUsdcAddress,
+  normalizeNetwork,
+  toClientSvmSigner,
+  toFacilitatorSvmSigner,
+  validateSvmAddress
+};
+//# sourceMappingURL=index.mjs.map