@x402/aptos 2.3.0

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

@@ -0,0 +1,116 @@
+import {
+  APTOS_ADDRESS_REGEX,
+  USDC_MAINNET_FA,
+  USDC_TESTNET_FA
+} from "../../chunk-FG4ANPDN.mjs";
+
+// src/exact/server/scheme.ts
+var ExactAptosScheme = class {
+  constructor() {
+    this.scheme = "exact";
+    this.moneyParsers = [];
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   *
+   * @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.
+   *
+   * @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}`);
+      }
+      if (!APTOS_ADDRESS_REGEX.test(price.asset)) {
+        throw new Error(`Invalid asset address format: ${price.asset}`);
+      }
+      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;
+    const extra = { ...paymentRequirements.extra };
+    if (typeof supportedKind.extra?.feePayer === "string") {
+      extra.feePayer = supportedKind.extra.feePayer;
+    }
+    return Promise.resolve({ ...paymentRequirements, extra });
+  }
+  /**
+   * Parse Money to a decimal number.
+   *
+   * @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 to USDC.
+   *
+   * @param amount - The decimal amount
+   * @param network - The network to use
+   * @returns The parsed asset amount in USDC
+   */
+  defaultMoneyConversion(amount, network) {
+    const decimals = 6;
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), decimals);
+    const asset = network === "aptos:2" ? USDC_TESTNET_FA : USDC_MAINNET_FA;
+    return { amount: tokenAmount, asset, extra: {} };
+  }
+  /**
+   * Convert a decimal amount string to a token amount string.
+   *
+   * @param amount - The decimal amount
+   * @param decimals - Number of decimals for the token
+   * @returns The amount in atomic units as a string
+   */
+  convertToTokenAmount(amount, decimals) {
+    const parts = amount.split(".");
+    const wholePart = parts[0] || "0";
+    const fractionalPart = (parts[1] || "").padEnd(decimals, "0").slice(0, decimals);
+    return BigInt(wholePart + fractionalPart).toString();
+  }
+};
+export {
+  ExactAptosScheme
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/scheme.ts"],"sourcesContent":["import type {\n  AssetAmount,\n  Money,\n  MoneyParser,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n} from \"@x402/core/types\";\nimport { APTOS_ADDRESS_REGEX, USDC_MAINNET_FA, USDC_TESTNET_FA } from \"../../constants\";\n\n/**\n * Aptos server implementation for the Exact payment scheme.\n */\nexport class ExactAptosScheme implements SchemeNetworkServer {\n  readonly scheme = \"exact\";\n  private moneyParsers: MoneyParser[] = [];\n\n  /**\n   * Register a custom money parser in the parser chain.\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): ExactAptosScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\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 (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      if (!APTOS_ADDRESS_REGEX.test(price.asset)) {\n        throw new Error(`Invalid asset address format: ${price.asset}`);\n      }\n      return { amount: price.amount, asset: price.asset, extra: price.extra || {} };\n    }\n\n    const amount = this.parseMoneyToDecimal(price as Money);\n\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    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    void extensionKeys;\n\n    const extra: Record<string, unknown> = { ...paymentRequirements.extra };\n    if (typeof supportedKind.extra?.feePayer === \"string\") {\n      extra.feePayer = supportedKind.extra.feePayer;\n    }\n\n    return Promise.resolve({ ...paymentRequirements, extra });\n  }\n\n  /**\n   * Parse Money to a decimal number.\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    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n    return amount;\n  }\n\n  /**\n   * Default money conversion to USDC.\n   *\n   * @param amount - The decimal amount\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    const decimals = 6;\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), decimals);\n    const asset = network === \"aptos:2\" ? USDC_TESTNET_FA : USDC_MAINNET_FA;\n    return { amount: tokenAmount, asset, extra: {} };\n  }\n\n  /**\n   * Convert a decimal amount string to a token amount string.\n   *\n   * @param amount - The decimal amount\n   * @param decimals - Number of decimals for the token\n   * @returns The amount in atomic units as a string\n   */\n  private convertToTokenAmount(amount: string, decimals: number): string {\n    const parts = amount.split(\".\");\n    const wholePart = parts[0] || \"0\";\n    const fractionalPart = (parts[1] || \"\").padEnd(decimals, \"0\").slice(0, decimals);\n    return BigInt(wholePart + fractionalPart).toString();\n  }\n}\n"],"mappings":";;;;;;;AAcO,IAAM,mBAAN,MAAsD;AAAA,EAAtD;AACL,SAAS,SAAS;AAClB,SAAQ,eAA8B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQvC,oBAAoB,QAAuC;AACzD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAW,OAAc,SAAwC;AACrE,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,8DAA8D,OAAO,EAAE;AAAA,MACzF;AACA,UAAI,CAAC,oBAAoB,KAAK,MAAM,KAAK,GAAG;AAC1C,cAAM,IAAI,MAAM,iCAAiC,MAAM,KAAK,EAAE;AAAA,MAChE;AACA,aAAO,EAAE,QAAQ,MAAM,QAAQ,OAAO,MAAM,OAAO,OAAO,MAAM,SAAS,CAAC,EAAE;AAAA,IAC9E;AAEA,UAAM,SAAS,KAAK,oBAAoB,KAAc;AAEtD,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,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;AAC9B,SAAK;AAEL,UAAM,QAAiC,EAAE,GAAG,oBAAoB,MAAM;AACtE,QAAI,OAAO,cAAc,OAAO,aAAa,UAAU;AACrD,YAAM,WAAW,cAAc,MAAM;AAAA,IACvC;AAEA,WAAO,QAAQ,QAAQ,EAAE,GAAG,qBAAqB,MAAM,CAAC;AAAA,EAC1D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AACA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AACpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,uBAAuB,QAAgB,SAA+B;AAC5E,UAAM,WAAW;AACjB,UAAM,cAAc,KAAK,qBAAqB,OAAO,SAAS,GAAG,QAAQ;AACzE,UAAM,QAAQ,YAAY,YAAY,kBAAkB;AACxD,WAAO,EAAE,QAAQ,aAAa,OAAO,OAAO,CAAC,EAAE;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,qBAAqB,QAAgB,UAA0B;AACrE,UAAM,QAAQ,OAAO,MAAM,GAAG;AAC9B,UAAM,YAAY,MAAM,CAAC,KAAK;AAC9B,UAAM,kBAAkB,MAAM,CAAC,KAAK,IAAI,OAAO,UAAU,GAAG,EAAE,MAAM,GAAG,QAAQ;AAC/E,WAAO,OAAO,YAAY,cAAc,EAAE,SAAS;AAAA,EACrD;AACF;","names":[]}

package/dist/esm/index.d.mts

@@ -0,0 +1,116 @@
+export { ExactAptosScheme } from './exact/client/index.mjs';
+import { Network, Aptos, SimpleTransaction, AccountAuthenticator, EntryFunction, TransactionPayload, TransactionPayloadEntryFunction } from '@aptos-labs/ts-sdk';
+export { C as ClientAptosConfig, a as ClientAptosSigner, F as FacilitatorAptosSigner, c as createClientSigner, t as toFacilitatorAptosSigner } from './signer-DPT9P1NX.mjs';
+import '@x402/core/types';
+
+/**
+ * Exact Aptos payload structure containing a base64 encoded transaction
+ */
+type ExactAptosPayload = {
+    /**
+     * Base64 encoded JSON containing transaction and senderAuthenticator byte arrays
+     */
+    transaction: string;
+};
+/**
+ * Decoded Aptos payment payload structure
+ */
+type DecodedAptosPayload = {
+    /**
+     * Transaction bytes as number array
+     */
+    transaction: number[];
+    /**
+     * Sender authenticator bytes as number array
+     */
+    senderAuthenticator: number[];
+};
+
+/**
+ * CAIP-2 network identifier for Aptos Mainnet
+ */
+declare const APTOS_MAINNET_CAIP2 = "aptos:1";
+/**
+ * CAIP-2 network identifier for Aptos Testnet
+ */
+declare const APTOS_TESTNET_CAIP2 = "aptos:2";
+/**
+ * Regex pattern for validating Aptos addresses
+ * Matches 64 hex characters with 0x prefix
+ */
+declare const APTOS_ADDRESS_REGEX: RegExp;
+/**
+ * The primary fungible store transfer function
+ */
+declare const TRANSFER_FUNCTION = "0x1::primary_fungible_store::transfer";
+/**
+ * Maximum gas amount allowed for sponsored transactions to prevent gas draining attacks.
+ * The Aptos SDK defaults to 200000 for simple transactions, so we allow some headroom.
+ */
+declare const MAX_GAS_AMOUNT = 500000n;
+/**
+ * Maps CAIP-2 network identifiers to Aptos chain IDs.
+ *
+ * @param network - The CAIP-2 network identifier (e.g., "aptos:1")
+ * @returns The corresponding chain ID
+ */
+declare function getAptosChainId(network: string): number;
+/**
+ * Default USDC fungible asset metadata address on mainnet.
+ */
+declare const USDC_MAINNET_FA = "0xbae207659db88bea0cbead6da0ed00aac12edcdda169e591cd41c94180b46f3b";
+/**
+ * Default USDC fungible asset metadata address on testnet.
+ */
+declare const USDC_TESTNET_FA = "0x69091fbab5f7d635ee7ac5098cf0c1efbe31d68fec0f2cd565e8d168daf52832";
+/**
+ * Maps CAIP-2 network identifiers to Aptos SDK Network enum.
+ *
+ * @param network - The CAIP-2 network identifier (e.g., "aptos:1")
+ * @returns The corresponding Aptos SDK Network enum value
+ */
+declare function getAptosNetwork(network: string): Network;
+/**
+ * Gets the default RPC URL for the given Aptos network.
+ *
+ * @param network - The Aptos SDK Network enum value
+ * @returns The default RPC URL for the network
+ */
+declare function getAptosRpcUrl(network: Network): string;
+
+/**
+ * Deserialize an Aptos transaction and authenticator from the payment payload.
+ *
+ * @param transactionBase64 - The base64 encoded transaction payload
+ * @returns The deserialized transaction and authenticator
+ */
+declare function deserializeAptosPayment(transactionBase64: string): {
+    transaction: SimpleTransaction;
+    senderAuthenticator: AccountAuthenticator;
+    entryFunction?: EntryFunction;
+};
+/**
+ * Checks if it's an entry function payload.
+ *
+ * @param payload - The payload to check
+ * @returns True if it's an entry function payload
+ */
+declare function isEntryFunctionPayload(payload: TransactionPayload): payload is TransactionPayloadEntryFunction;
+/**
+ * Create an Aptos SDK client for the given network
+ *
+ * @param network - CAIP-2 network identifier (e.g., "aptos:1")
+ * @param rpcUrl - Optional custom RPC URL
+ * @returns Aptos SDK client
+ */
+declare function createAptosClient(network: string, rpcUrl?: string): Aptos;
+/**
+ * Encode an Aptos payment payload to base64
+ *
+ * @param transactionBytes - The serialized transaction bytes
+ * @param authenticatorBytes - The serialized authenticator bytes
+ * @returns Base64 encoded payload
+ */
+declare function encodeAptosPayload(transactionBytes: Uint8Array, authenticatorBytes: Uint8Array): string;
+
+export { APTOS_ADDRESS_REGEX, APTOS_MAINNET_CAIP2, APTOS_TESTNET_CAIP2, type DecodedAptosPayload, type ExactAptosPayload, MAX_GAS_AMOUNT, TRANSFER_FUNCTION, USDC_MAINNET_FA, USDC_TESTNET_FA, createAptosClient, deserializeAptosPayment, encodeAptosPayload, getAptosChainId, getAptosNetwork, getAptosRpcUrl, isEntryFunctionPayload };

package/dist/esm/index.mjs

@@ -0,0 +1,105 @@
+import {
+  ExactAptosScheme
+} from "./chunk-6BMAMLXJ.mjs";
+import {
+  createAptosClient,
+  deserializeAptosPayment,
+  encodeAptosPayload,
+  isEntryFunctionPayload
+} from "./chunk-D4UVBSUH.mjs";
+import {
+  APTOS_ADDRESS_REGEX,
+  APTOS_MAINNET_CAIP2,
+  APTOS_TESTNET_CAIP2,
+  MAX_GAS_AMOUNT,
+  TRANSFER_FUNCTION,
+  USDC_MAINNET_FA,
+  USDC_TESTNET_FA,
+  getAptosChainId,
+  getAptosNetwork,
+  getAptosRpcUrl
+} from "./chunk-FG4ANPDN.mjs";
+
+// src/signer.ts
+import {
+  Account,
+  Ed25519PrivateKey,
+  Aptos,
+  AptosConfig,
+  PrivateKey,
+  PrivateKeyVariants
+} from "@aptos-labs/ts-sdk";
+async function createClientSigner(privateKey) {
+  const formattedKey = PrivateKey.formatPrivateKey(privateKey, PrivateKeyVariants.Ed25519);
+  const privateKeyBytes = new Ed25519PrivateKey(formattedKey);
+  return Account.fromPrivateKey({ privateKey: privateKeyBytes });
+}
+function toFacilitatorAptosSigner(account, rpcConfig) {
+  const getRpcUrl = (network) => {
+    if (rpcConfig) {
+      if ("defaultRpcUrl" in rpcConfig && rpcConfig.defaultRpcUrl) {
+        return rpcConfig.defaultRpcUrl;
+      }
+      if (network in rpcConfig) {
+        return rpcConfig[network];
+      }
+    }
+    return getAptosRpcUrl(getAptosNetwork(network));
+  };
+  const getAptos = (network) => {
+    const aptosNetwork = getAptosNetwork(network);
+    const rpcUrl = getRpcUrl(network);
+    return new Aptos(new AptosConfig({ network: aptosNetwork, fullnode: rpcUrl }));
+  };
+  return {
+    getAddresses: () => [account.accountAddress.toStringLong()],
+    signAndSubmitAsFeePayer: async (transaction, senderAuthenticator, network) => {
+      const aptos = getAptos(network);
+      transaction.feePayerAddress = account.accountAddress;
+      const feePayerAuthenticator = aptos.transaction.signAsFeePayer({
+        signer: account,
+        transaction
+      });
+      return aptos.transaction.submit.simple({
+        transaction,
+        senderAuthenticator,
+        feePayerAuthenticator
+      });
+    },
+    submitTransaction: async (transaction, senderAuthenticator, network) => {
+      const aptos = getAptos(network);
+      return aptos.transaction.submit.simple({ transaction, senderAuthenticator });
+    },
+    simulateTransaction: async (transaction, network) => {
+      const aptos = getAptos(network);
+      const results = await aptos.transaction.simulate.simple({ transaction });
+      if (results.length === 0 || !results[0].success) {
+        throw new Error(`Simulation failed: ${results[0]?.vm_status || "unknown error"}`);
+      }
+    },
+    waitForTransaction: async (txHash, network) => {
+      const aptos = getAptos(network);
+      await aptos.waitForTransaction({ transactionHash: txHash });
+    }
+  };
+}
+export {
+  APTOS_ADDRESS_REGEX,
+  APTOS_MAINNET_CAIP2,
+  APTOS_TESTNET_CAIP2,
+  ExactAptosScheme,
+  MAX_GAS_AMOUNT,
+  TRANSFER_FUNCTION,
+  USDC_MAINNET_FA,
+  USDC_TESTNET_FA,
+  createAptosClient,
+  createClientSigner,
+  deserializeAptosPayment,
+  encodeAptosPayload,
+  getAptosChainId,
+  getAptosNetwork,
+  getAptosRpcUrl,
+  isEntryFunctionPayload,
+  toFacilitatorAptosSigner
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["import {\n  Account,\n  Ed25519PrivateKey,\n  Aptos,\n  AptosConfig,\n  SimpleTransaction,\n  AccountAuthenticator,\n  PrivateKey,\n  PrivateKeyVariants,\n  type PendingTransactionResponse,\n} from \"@aptos-labs/ts-sdk\";\nimport { getAptosNetwork, getAptosRpcUrl } from \"./constants\";\n\n/**\n * Client-side signer for creating and signing Aptos transactions\n */\nexport type ClientAptosSigner = Account;\n\n/**\n * Configuration for client operations\n */\nexport type ClientAptosConfig = {\n  /**\n   * Optional custom RPC URL for the client to use\n   */\n  rpcUrl?: string;\n};\n\n/**\n * Minimal facilitator signer interface for Aptos operations\n */\nexport type FacilitatorAptosSigner = {\n  /**\n   * Get all addresses this facilitator can use for signing\n   */\n  getAddresses(): readonly string[];\n\n  /**\n   * Sign a transaction as the fee payer and submit it\n   */\n  signAndSubmitAsFeePayer(\n    transaction: SimpleTransaction,\n    senderAuthenticator: AccountAuthenticator,\n    network: string,\n  ): Promise<PendingTransactionResponse>;\n\n  /**\n   * Submit a fully-signed transaction (non-sponsored)\n   */\n  submitTransaction(\n    transaction: SimpleTransaction,\n    senderAuthenticator: AccountAuthenticator,\n    network: string,\n  ): Promise<PendingTransactionResponse>;\n\n  /**\n   * Simulate a transaction to verify it would succeed\n   */\n  simulateTransaction(transaction: SimpleTransaction, network: string): Promise<void>;\n\n  /**\n   * Wait for transaction confirmation\n   */\n  waitForTransaction(txHash: string, network: string): Promise<void>;\n};\n\n/**\n * Creates a client signer from a private key\n *\n * @param privateKey - The private key as a hex string or AIP-80 format\n * @returns An Aptos Account instance\n */\nexport async function createClientSigner(privateKey: string): Promise<ClientAptosSigner> {\n  const formattedKey = PrivateKey.formatPrivateKey(privateKey, PrivateKeyVariants.Ed25519);\n  const privateKeyBytes = new Ed25519PrivateKey(formattedKey);\n  return Account.fromPrivateKey({ privateKey: privateKeyBytes });\n}\n\n/**\n * Create a facilitator signer from an Aptos Account\n *\n * @param account - The Aptos Account that will act as fee payer\n * @param rpcConfig - Optional RPC configuration\n * @returns FacilitatorAptosSigner instance\n */\nexport function toFacilitatorAptosSigner(\n  account: Account,\n  rpcConfig?: { defaultRpcUrl?: string } | Record<string, string>,\n): FacilitatorAptosSigner {\n  const getRpcUrl = (network: string): string => {\n    if (rpcConfig) {\n      if (\"defaultRpcUrl\" in rpcConfig && rpcConfig.defaultRpcUrl) {\n        return rpcConfig.defaultRpcUrl;\n      }\n      if (network in rpcConfig) {\n        return (rpcConfig as Record<string, string>)[network];\n      }\n    }\n    return getAptosRpcUrl(getAptosNetwork(network));\n  };\n\n  const getAptos = (network: string): Aptos => {\n    const aptosNetwork = getAptosNetwork(network);\n    const rpcUrl = getRpcUrl(network);\n    return new Aptos(new AptosConfig({ network: aptosNetwork, fullnode: rpcUrl }));\n  };\n\n  return {\n    getAddresses: () => [account.accountAddress.toStringLong()],\n\n    signAndSubmitAsFeePayer: async (\n      transaction: SimpleTransaction,\n      senderAuthenticator: AccountAuthenticator,\n      network: string,\n    ) => {\n      const aptos = getAptos(network);\n      transaction.feePayerAddress = account.accountAddress;\n      const feePayerAuthenticator = aptos.transaction.signAsFeePayer({\n        signer: account,\n        transaction,\n      });\n      return aptos.transaction.submit.simple({\n        transaction,\n        senderAuthenticator,\n        feePayerAuthenticator,\n      });\n    },\n\n    submitTransaction: async (\n      transaction: SimpleTransaction,\n      senderAuthenticator: AccountAuthenticator,\n      network: string,\n    ) => {\n      const aptos = getAptos(network);\n      return aptos.transaction.submit.simple({ transaction, senderAuthenticator });\n    },\n\n    simulateTransaction: async (transaction: SimpleTransaction, network: string) => {\n      const aptos = getAptos(network);\n      const results = await aptos.transaction.simulate.simple({ transaction });\n      if (results.length === 0 || !results[0].success) {\n        throw new Error(`Simulation failed: ${results[0]?.vm_status || \"unknown error\"}`);\n      }\n    },\n\n    waitForTransaction: async (txHash: string, network: string) => {\n      const aptos = getAptos(network);\n      await aptos.waitForTransaction({ transactionHash: txHash });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,OAEK;AA8DP,eAAsB,mBAAmB,YAAgD;AACvF,QAAM,eAAe,WAAW,iBAAiB,YAAY,mBAAmB,OAAO;AACvF,QAAM,kBAAkB,IAAI,kBAAkB,YAAY;AAC1D,SAAO,QAAQ,eAAe,EAAE,YAAY,gBAAgB,CAAC;AAC/D;AASO,SAAS,yBACd,SACA,WACwB;AACxB,QAAM,YAAY,CAAC,YAA4B;AAC7C,QAAI,WAAW;AACb,UAAI,mBAAmB,aAAa,UAAU,eAAe;AAC3D,eAAO,UAAU;AAAA,MACnB;AACA,UAAI,WAAW,WAAW;AACxB,eAAQ,UAAqC,OAAO;AAAA,MACtD;AAAA,IACF;AACA,WAAO,eAAe,gBAAgB,OAAO,CAAC;AAAA,EAChD;AAEA,QAAM,WAAW,CAAC,YAA2B;AAC3C,UAAM,eAAe,gBAAgB,OAAO;AAC5C,UAAM,SAAS,UAAU,OAAO;AAChC,WAAO,IAAI,MAAM,IAAI,YAAY,EAAE,SAAS,cAAc,UAAU,OAAO,CAAC,CAAC;AAAA,EAC/E;AAEA,SAAO;AAAA,IACL,cAAc,MAAM,CAAC,QAAQ,eAAe,aAAa,CAAC;AAAA,IAE1D,yBAAyB,OACvB,aACA,qBACA,YACG;AACH,YAAM,QAAQ,SAAS,OAAO;AAC9B,kBAAY,kBAAkB,QAAQ;AACtC,YAAM,wBAAwB,MAAM,YAAY,eAAe;AAAA,QAC7D,QAAQ;AAAA,QACR;AAAA,MACF,CAAC;AACD,aAAO,MAAM,YAAY,OAAO,OAAO;AAAA,QACrC;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,mBAAmB,OACjB,aACA,qBACA,YACG;AACH,YAAM,QAAQ,SAAS,OAAO;AAC9B,aAAO,MAAM,YAAY,OAAO,OAAO,EAAE,aAAa,oBAAoB,CAAC;AAAA,IAC7E;AAAA,IAEA,qBAAqB,OAAO,aAAgC,YAAoB;AAC9E,YAAM,QAAQ,SAAS,OAAO;AAC9B,YAAM,UAAU,MAAM,MAAM,YAAY,SAAS,OAAO,EAAE,YAAY,CAAC;AACvE,UAAI,QAAQ,WAAW,KAAK,CAAC,QAAQ,CAAC,EAAE,SAAS;AAC/C,cAAM,IAAI,MAAM,sBAAsB,QAAQ,CAAC,GAAG,aAAa,eAAe,EAAE;AAAA,MAClF;AAAA,IACF;AAAA,IAEA,oBAAoB,OAAO,QAAgB,YAAoB;AAC7D,YAAM,QAAQ,SAAS,OAAO;AAC9B,YAAM,MAAM,mBAAmB,EAAE,iBAAiB,OAAO,CAAC;AAAA,IAC5D;AAAA,EACF;AACF;","names":[]}

package/dist/esm/signer-DPT9P1NX.d.mts

@@ -0,0 +1,59 @@
+import { Account, SimpleTransaction, AccountAuthenticator, PendingTransactionResponse } from '@aptos-labs/ts-sdk';
+
+/**
+ * Client-side signer for creating and signing Aptos transactions
+ */
+type ClientAptosSigner = Account;
+/**
+ * Configuration for client operations
+ */
+type ClientAptosConfig = {
+    /**
+     * Optional custom RPC URL for the client to use
+     */
+    rpcUrl?: string;
+};
+/**
+ * Minimal facilitator signer interface for Aptos operations
+ */
+type FacilitatorAptosSigner = {
+    /**
+     * Get all addresses this facilitator can use for signing
+     */
+    getAddresses(): readonly string[];
+    /**
+     * Sign a transaction as the fee payer and submit it
+     */
+    signAndSubmitAsFeePayer(transaction: SimpleTransaction, senderAuthenticator: AccountAuthenticator, network: string): Promise<PendingTransactionResponse>;
+    /**
+     * Submit a fully-signed transaction (non-sponsored)
+     */
+    submitTransaction(transaction: SimpleTransaction, senderAuthenticator: AccountAuthenticator, network: string): Promise<PendingTransactionResponse>;
+    /**
+     * Simulate a transaction to verify it would succeed
+     */
+    simulateTransaction(transaction: SimpleTransaction, network: string): Promise<void>;
+    /**
+     * Wait for transaction confirmation
+     */
+    waitForTransaction(txHash: string, network: string): Promise<void>;
+};
+/**
+ * Creates a client signer from a private key
+ *
+ * @param privateKey - The private key as a hex string or AIP-80 format
+ * @returns An Aptos Account instance
+ */
+declare function createClientSigner(privateKey: string): Promise<ClientAptosSigner>;
+/**
+ * Create a facilitator signer from an Aptos Account
+ *
+ * @param account - The Aptos Account that will act as fee payer
+ * @param rpcConfig - Optional RPC configuration
+ * @returns FacilitatorAptosSigner instance
+ */
+declare function toFacilitatorAptosSigner(account: Account, rpcConfig?: {
+    defaultRpcUrl?: string;
+} | Record<string, string>): FacilitatorAptosSigner;
+
+export { type ClientAptosConfig as C, type FacilitatorAptosSigner as F, type ClientAptosSigner as a, createClientSigner as c, toFacilitatorAptosSigner as t };

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@x402/aptos",
+  "version": "2.3.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "scripts": {
+    "start": "tsx --env-file=.env index.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:watch": "vitest",
+    "watch": "tsc --watch",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts"
+  },
+  "keywords": [
+    "x402",
+    "payment",
+    "protocol",
+    "aptos"
+  ],
+  "license": "Apache-2.0",
+  "author": "Aptos Labs",
+  "repository": "https://github.com/coinbase/x402",
+  "description": "x402 Payment Protocol Aptos Implementation",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/node": "^22.13.4",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "prettier": "3.5.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.6",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.5"
+  },
+  "dependencies": {
+    "@x402/core": "workspace:*",
+    "@aptos-labs/ts-sdk": "^5.2.1"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./exact/client": {
+      "import": {
+        "types": "./dist/esm/exact/client/index.d.mts",
+        "default": "./dist/esm/exact/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/client/index.d.ts",
+        "default": "./dist/cjs/exact/client/index.js"
+      }
+    },
+    "./exact/server": {
+      "import": {
+        "types": "./dist/esm/exact/server/index.d.mts",
+        "default": "./dist/esm/exact/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/server/index.d.ts",
+        "default": "./dist/cjs/exact/server/index.js"
+      }
+    },
+    "./exact/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact/facilitator/index.d.mts",
+        "default": "./dist/esm/exact/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/facilitator/index.d.ts",
+        "default": "./dist/cjs/exact/facilitator/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ]
+}