@t2000/sdk 10.25.1 → 10.26.0

package/dist/{commerce-B_eH6fvR.d.cts → commerce-DOKu1FYI.d.cts}

@@ -938,6 +938,50 @@ declare function preflightPay(input: {
     url: string;
     maxPrice?: number;
 }): PreflightResult;
+/**
+ * What a paid call WOULD cost, without paying (S.919). Every branch mirrors
+ * a `payWithX402` outcome so the probe can never promise something the pay
+ * path then refuses — one dialect story, not two.
+ */
+type X402Probe = {
+    kind: 'free';
+    status: number;
+    note: string;
+} | {
+    kind: 'payable';
+    priceUsdc: number;
+    asset: string;
+    payTo: string;
+    network: string;
+} | {
+    kind: 'escrow';
+    priceUsdc: number;
+    payTo: string;
+    note: string;
+} | {
+    kind: 'unsupported';
+    reason: string;
+    note: string;
+} | {
+    kind: 'incomplete';
+    reason: string;
+    note: string;
+} | {
+    kind: 'not-x402';
+    status: number;
+    note: string;
+};
+/**
+ * READ-ONLY x402 probe: issue the same request `pay()` would, read the 402,
+ * and report the terms. Never signs, never spends, never throws on a
+ * non-payable answer — an unpayable endpoint is information, not a failure.
+ * (Invalid input still throws, exactly as `pay()` would, so a caller can't
+ * probe a URL that could never be paid.)
+ */
+declare function probeX402(args: {
+    network: string;
+    options: PayOptions;
+}): Promise<X402Probe>;
 declare function payWithX402(args: {
     signer: TransactionSigner;
     client: SuiGrpcClient;
@@ -1556,4 +1600,4 @@ declare function putJobSpec(base: string, content: string): Promise<string>;
  *  the store is untrusted; the chain hash is the authority). */
 declare function getJobSpec(base: string, hash: string): Promise<string>;
 
-export { type T2000ErrorData as $, A2A_ESCROW_FEE_CONFIG_ID as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_ACTIVITY_REPORT_URL as D, ETH_TYPE as E, SUI_TYPE as F, GAS_RESERVE_MIN as G, SUPPORTED_ASSETS as H, IKA_TYPE as I, JOB_STATES as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type SendResult as Q, type ServiceListing as R, STABLE_ASSETS as S, type SimulationResult as T, type StableAsset as U, type SuiHolding as V, type SuiRpcTxBlock as W, type SupportedAsset as X, type SwapRouteResult as Y, T2000Error as Z, type T2000ErrorCode as _, A2A_ESCROW_PACKAGE_ID as a, suiToMist as a$, T2000_OVERLAY_FEE_WALLET as a0, TOKEN_MAP as a1, type TransactionLeg as a2, type TransactionRecord as a3, type TransactionSigner as a4, type TxDirection as a5, USDC_DECIMALS as a6, USDC_TYPE as a7, USDE_TYPE as a8, USDSUI_TYPE as a9, formatAssetAmount as aA, formatSui as aB, formatUsd as aC, getDecimals as aD, getDecimalsForCoinType as aE, getJob as aF, getJobSpec as aG, jobActionsFor as aH, listServices as aI, mapMoveAbortCode as aJ, mapWalletError as aK, mistToSui as aL, parseSuiRpcTx as aM, payWithX402 as aN, preflightCreateJob as aO, preflightFail as aP, preflightPay as aQ, preflightSend as aR, preflightSwap as aS, putJobSpec as aT, rawToStable as aU, rawToUsdc as aV, refineLendingLabel as aW, reportX402Activity as aX, resolveSymbol as aY, resolveTokenType as aZ, stableToRaw as a_, USDT_TYPE as aa, WAL_TYPE as ab, WBTC_TYPE as ac, type X402ActivityPayload as ad, type ZkLoginProof as ae, ZkLoginSigner as af, buildCreateJobTx as ag, buildDeliverJobTx as ah, buildRefundJobTx as ai, buildRejectJobTx as aj, buildReleaseJobTx as ak, buildSendTx as al, buildSwapTx as am, checkPositiveAmount as an, checkSuiAddress as ao, classifyAction as ap, classifyLabel as aq, classifyTransaction as ar, executeTx as as, extractAllUserLegs as at, extractTransferDetails as au, extractTxCommands as av, extractTxSender as aw, fallbackLabel as ax, fetchService as ay, findSwapRoute as az, type ActivityReportConfig as b, truncateAddress as b0, usdcToRaw as b1, validateAddress as b2, verifyJobForSeller as b3, type T2000Options as b4, type SerializedCetusRoute as b5, type SwapResult as b6, type SwapQuoteResult as b7, type PaymentRequest as b8, type SuiCoreClient as b9, normalizeAsset as bA, normalizeCoinType as bB, queryHistory as bC, queryTransaction as bD, selectAndSplitCoin as bE, selectSuiCoin as bF, serializeCetusRoute as bG, simulateTransaction as bH, throwIfSimulationFailed as bI, verifyCetusRouteCoinMatch as bJ, type SponsoredCoinMergeCache as ba, type SendableAsset as bb, CETUS_USDC_SUI_POOL as bc, type CoinPage as bd, DEFAULT_GRPC_URL as be, GASLESS_MIN_STABLE_AMOUNT as bf, GASLESS_STABLE_TYPES as bg, OPERATION_ASSETS as bh, type Operation as bi, SENDABLE_ASSETS as bj, type SelectAndSplitResult as bk, type SerializedCetusRoutePath as bl, type SerializedRouterDataV3 as bm, addSendToTx as bn, addSwapToTx as bo, assertAllowedAsset as bp, assertBuyerRequirements as bq, buildDeclineJobTx as br, deserializeCetusRoute as bs, fetchAllCoins as bt, getCoinMeta as bu, getSuiClient as bv, getSuiGrpcClient as bw, isAllowedAsset as bx, isCetusRouteFresh as by, isInRegistry as bz, COIN_REGISTRY as c, type ClassifyBalanceChange as d, type ClassifyResult as e, type CoinMeta as f, DEFAULT_COMMERCE_API_BASE as g, DEFAULT_NETWORK as h, type DepositInfo as i, type ExtractedTransfer as j, type Job as k, type JobState as l, type JobTerms as m, type JobVerification as n, KeypairSigner as o, LOFI_TYPE as p, MAX_DELIVER_HORIZON_MS as q, MAX_JOB_USDC as r, MAX_REVIEW_WINDOW_MS as s, MIST_PER_SUI as t, type OverlayFeeConfig as u, PREFLIGHT_OK as v, type PayOptions as w, type PayResult as x, type PreflightResult as y, SUI_DECIMALS as z };
+export { type T2000ErrorData as $, A2A_ESCROW_FEE_CONFIG_ID as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_ACTIVITY_REPORT_URL as D, ETH_TYPE as E, SUI_TYPE as F, GAS_RESERVE_MIN as G, SUPPORTED_ASSETS as H, IKA_TYPE as I, JOB_STATES as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type SendResult as Q, type ServiceListing as R, STABLE_ASSETS as S, type SimulationResult as T, type StableAsset as U, type SuiHolding as V, type SuiRpcTxBlock as W, type SupportedAsset as X, type SwapRouteResult as Y, T2000Error as Z, type T2000ErrorCode as _, A2A_ESCROW_PACKAGE_ID as a, suiToMist as a$, T2000_OVERLAY_FEE_WALLET as a0, TOKEN_MAP as a1, type TransactionLeg as a2, type TransactionRecord as a3, type TransactionSigner as a4, type TxDirection as a5, USDC_DECIMALS as a6, USDC_TYPE as a7, USDE_TYPE as a8, USDSUI_TYPE as a9, formatAssetAmount as aA, formatSui as aB, formatUsd as aC, getDecimals as aD, getDecimalsForCoinType as aE, getJob as aF, getJobSpec as aG, jobActionsFor as aH, listServices as aI, mapMoveAbortCode as aJ, mapWalletError as aK, mistToSui as aL, parseSuiRpcTx as aM, payWithX402 as aN, preflightCreateJob as aO, preflightFail as aP, preflightPay as aQ, preflightSend as aR, preflightSwap as aS, putJobSpec as aT, rawToStable as aU, rawToUsdc as aV, refineLendingLabel as aW, reportX402Activity as aX, resolveSymbol as aY, resolveTokenType as aZ, stableToRaw as a_, USDT_TYPE as aa, WAL_TYPE as ab, WBTC_TYPE as ac, type X402ActivityPayload as ad, type ZkLoginProof as ae, ZkLoginSigner as af, buildCreateJobTx as ag, buildDeliverJobTx as ah, buildRefundJobTx as ai, buildRejectJobTx as aj, buildReleaseJobTx as ak, buildSendTx as al, buildSwapTx as am, checkPositiveAmount as an, checkSuiAddress as ao, classifyAction as ap, classifyLabel as aq, classifyTransaction as ar, executeTx as as, extractAllUserLegs as at, extractTransferDetails as au, extractTxCommands as av, extractTxSender as aw, fallbackLabel as ax, fetchService as ay, findSwapRoute as az, type ActivityReportConfig as b, truncateAddress as b0, usdcToRaw as b1, validateAddress as b2, verifyJobForSeller as b3, type T2000Options as b4, type X402Probe as b5, type SerializedCetusRoute as b6, type SwapResult as b7, type SwapQuoteResult as b8, type PaymentRequest as b9, isInRegistry as bA, normalizeAsset as bB, normalizeCoinType as bC, probeX402 as bD, queryHistory as bE, queryTransaction as bF, selectAndSplitCoin as bG, selectSuiCoin as bH, serializeCetusRoute as bI, simulateTransaction as bJ, throwIfSimulationFailed as bK, verifyCetusRouteCoinMatch as bL, type SuiCoreClient as ba, type SponsoredCoinMergeCache as bb, type SendableAsset as bc, CETUS_USDC_SUI_POOL as bd, type CoinPage as be, DEFAULT_GRPC_URL as bf, GASLESS_MIN_STABLE_AMOUNT as bg, GASLESS_STABLE_TYPES as bh, OPERATION_ASSETS as bi, type Operation as bj, SENDABLE_ASSETS as bk, type SelectAndSplitResult as bl, type SerializedCetusRoutePath as bm, type SerializedRouterDataV3 as bn, addSendToTx as bo, addSwapToTx as bp, assertAllowedAsset as bq, assertBuyerRequirements as br, buildDeclineJobTx as bs, deserializeCetusRoute as bt, fetchAllCoins as bu, getCoinMeta as bv, getSuiClient as bw, getSuiGrpcClient as bx, isAllowedAsset as by, isCetusRouteFresh as bz, COIN_REGISTRY as c, type ClassifyBalanceChange as d, type ClassifyResult as e, type CoinMeta as f, DEFAULT_COMMERCE_API_BASE as g, DEFAULT_NETWORK as h, type DepositInfo as i, type ExtractedTransfer as j, type Job as k, type JobState as l, type JobTerms as m, type JobVerification as n, KeypairSigner as o, LOFI_TYPE as p, MAX_DELIVER_HORIZON_MS as q, MAX_JOB_USDC as r, MAX_REVIEW_WINDOW_MS as s, MIST_PER_SUI as t, type OverlayFeeConfig as u, PREFLIGHT_OK as v, type PayOptions as w, type PayResult as x, type PreflightResult as y, SUI_DECIMALS as z };

package/dist/{commerce-B_eH6fvR.d.ts → commerce-DOKu1FYI.d.ts}

@@ -938,6 +938,50 @@ declare function preflightPay(input: {
     url: string;
     maxPrice?: number;
 }): PreflightResult;
+/**
+ * What a paid call WOULD cost, without paying (S.919). Every branch mirrors
+ * a `payWithX402` outcome so the probe can never promise something the pay
+ * path then refuses — one dialect story, not two.
+ */
+type X402Probe = {
+    kind: 'free';
+    status: number;
+    note: string;
+} | {
+    kind: 'payable';
+    priceUsdc: number;
+    asset: string;
+    payTo: string;
+    network: string;
+} | {
+    kind: 'escrow';
+    priceUsdc: number;
+    payTo: string;
+    note: string;
+} | {
+    kind: 'unsupported';
+    reason: string;
+    note: string;
+} | {
+    kind: 'incomplete';
+    reason: string;
+    note: string;
+} | {
+    kind: 'not-x402';
+    status: number;
+    note: string;
+};
+/**
+ * READ-ONLY x402 probe: issue the same request `pay()` would, read the 402,
+ * and report the terms. Never signs, never spends, never throws on a
+ * non-payable answer — an unpayable endpoint is information, not a failure.
+ * (Invalid input still throws, exactly as `pay()` would, so a caller can't
+ * probe a URL that could never be paid.)
+ */
+declare function probeX402(args: {
+    network: string;
+    options: PayOptions;
+}): Promise<X402Probe>;
 declare function payWithX402(args: {
     signer: TransactionSigner;
     client: SuiGrpcClient;
@@ -1556,4 +1600,4 @@ declare function putJobSpec(base: string, content: string): Promise<string>;
  *  the store is untrusted; the chain hash is the authority). */
 declare function getJobSpec(base: string, hash: string): Promise<string>;
 
-export { type T2000ErrorData as $, A2A_ESCROW_FEE_CONFIG_ID as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_ACTIVITY_REPORT_URL as D, ETH_TYPE as E, SUI_TYPE as F, GAS_RESERVE_MIN as G, SUPPORTED_ASSETS as H, IKA_TYPE as I, JOB_STATES as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type SendResult as Q, type ServiceListing as R, STABLE_ASSETS as S, type SimulationResult as T, type StableAsset as U, type SuiHolding as V, type SuiRpcTxBlock as W, type SupportedAsset as X, type SwapRouteResult as Y, T2000Error as Z, type T2000ErrorCode as _, A2A_ESCROW_PACKAGE_ID as a, suiToMist as a$, T2000_OVERLAY_FEE_WALLET as a0, TOKEN_MAP as a1, type TransactionLeg as a2, type TransactionRecord as a3, type TransactionSigner as a4, type TxDirection as a5, USDC_DECIMALS as a6, USDC_TYPE as a7, USDE_TYPE as a8, USDSUI_TYPE as a9, formatAssetAmount as aA, formatSui as aB, formatUsd as aC, getDecimals as aD, getDecimalsForCoinType as aE, getJob as aF, getJobSpec as aG, jobActionsFor as aH, listServices as aI, mapMoveAbortCode as aJ, mapWalletError as aK, mistToSui as aL, parseSuiRpcTx as aM, payWithX402 as aN, preflightCreateJob as aO, preflightFail as aP, preflightPay as aQ, preflightSend as aR, preflightSwap as aS, putJobSpec as aT, rawToStable as aU, rawToUsdc as aV, refineLendingLabel as aW, reportX402Activity as aX, resolveSymbol as aY, resolveTokenType as aZ, stableToRaw as a_, USDT_TYPE as aa, WAL_TYPE as ab, WBTC_TYPE as ac, type X402ActivityPayload as ad, type ZkLoginProof as ae, ZkLoginSigner as af, buildCreateJobTx as ag, buildDeliverJobTx as ah, buildRefundJobTx as ai, buildRejectJobTx as aj, buildReleaseJobTx as ak, buildSendTx as al, buildSwapTx as am, checkPositiveAmount as an, checkSuiAddress as ao, classifyAction as ap, classifyLabel as aq, classifyTransaction as ar, executeTx as as, extractAllUserLegs as at, extractTransferDetails as au, extractTxCommands as av, extractTxSender as aw, fallbackLabel as ax, fetchService as ay, findSwapRoute as az, type ActivityReportConfig as b, truncateAddress as b0, usdcToRaw as b1, validateAddress as b2, verifyJobForSeller as b3, type T2000Options as b4, type SerializedCetusRoute as b5, type SwapResult as b6, type SwapQuoteResult as b7, type PaymentRequest as b8, type SuiCoreClient as b9, normalizeAsset as bA, normalizeCoinType as bB, queryHistory as bC, queryTransaction as bD, selectAndSplitCoin as bE, selectSuiCoin as bF, serializeCetusRoute as bG, simulateTransaction as bH, throwIfSimulationFailed as bI, verifyCetusRouteCoinMatch as bJ, type SponsoredCoinMergeCache as ba, type SendableAsset as bb, CETUS_USDC_SUI_POOL as bc, type CoinPage as bd, DEFAULT_GRPC_URL as be, GASLESS_MIN_STABLE_AMOUNT as bf, GASLESS_STABLE_TYPES as bg, OPERATION_ASSETS as bh, type Operation as bi, SENDABLE_ASSETS as bj, type SelectAndSplitResult as bk, type SerializedCetusRoutePath as bl, type SerializedRouterDataV3 as bm, addSendToTx as bn, addSwapToTx as bo, assertAllowedAsset as bp, assertBuyerRequirements as bq, buildDeclineJobTx as br, deserializeCetusRoute as bs, fetchAllCoins as bt, getCoinMeta as bu, getSuiClient as bv, getSuiGrpcClient as bw, isAllowedAsset as bx, isCetusRouteFresh as by, isInRegistry as bz, COIN_REGISTRY as c, type ClassifyBalanceChange as d, type ClassifyResult as e, type CoinMeta as f, DEFAULT_COMMERCE_API_BASE as g, DEFAULT_NETWORK as h, type DepositInfo as i, type ExtractedTransfer as j, type Job as k, type JobState as l, type JobTerms as m, type JobVerification as n, KeypairSigner as o, LOFI_TYPE as p, MAX_DELIVER_HORIZON_MS as q, MAX_JOB_USDC as r, MAX_REVIEW_WINDOW_MS as s, MIST_PER_SUI as t, type OverlayFeeConfig as u, PREFLIGHT_OK as v, type PayOptions as w, type PayResult as x, type PreflightResult as y, SUI_DECIMALS as z };
+export { type T2000ErrorData as $, A2A_ESCROW_FEE_CONFIG_ID as A, type BalanceResponse as B, CLOCK_ID as C, DEFAULT_ACTIVITY_REPORT_URL as D, ETH_TYPE as E, SUI_TYPE as F, GAS_RESERVE_MIN as G, SUPPORTED_ASSETS as H, IKA_TYPE as I, JOB_STATES as J, KNOWN_TARGETS as K, LABEL_PATTERNS as L, MANIFEST_TYPE as M, NAVX_TYPE as N, OVERLAY_FEE_RATE as O, PREFLIGHT_MAX_AMOUNT as P, type SendResult as Q, type ServiceListing as R, STABLE_ASSETS as S, type SimulationResult as T, type StableAsset as U, type SuiHolding as V, type SuiRpcTxBlock as W, type SupportedAsset as X, type SwapRouteResult as Y, T2000Error as Z, type T2000ErrorCode as _, A2A_ESCROW_PACKAGE_ID as a, suiToMist as a$, T2000_OVERLAY_FEE_WALLET as a0, TOKEN_MAP as a1, type TransactionLeg as a2, type TransactionRecord as a3, type TransactionSigner as a4, type TxDirection as a5, USDC_DECIMALS as a6, USDC_TYPE as a7, USDE_TYPE as a8, USDSUI_TYPE as a9, formatAssetAmount as aA, formatSui as aB, formatUsd as aC, getDecimals as aD, getDecimalsForCoinType as aE, getJob as aF, getJobSpec as aG, jobActionsFor as aH, listServices as aI, mapMoveAbortCode as aJ, mapWalletError as aK, mistToSui as aL, parseSuiRpcTx as aM, payWithX402 as aN, preflightCreateJob as aO, preflightFail as aP, preflightPay as aQ, preflightSend as aR, preflightSwap as aS, putJobSpec as aT, rawToStable as aU, rawToUsdc as aV, refineLendingLabel as aW, reportX402Activity as aX, resolveSymbol as aY, resolveTokenType as aZ, stableToRaw as a_, USDT_TYPE as aa, WAL_TYPE as ab, WBTC_TYPE as ac, type X402ActivityPayload as ad, type ZkLoginProof as ae, ZkLoginSigner as af, buildCreateJobTx as ag, buildDeliverJobTx as ah, buildRefundJobTx as ai, buildRejectJobTx as aj, buildReleaseJobTx as ak, buildSendTx as al, buildSwapTx as am, checkPositiveAmount as an, checkSuiAddress as ao, classifyAction as ap, classifyLabel as aq, classifyTransaction as ar, executeTx as as, extractAllUserLegs as at, extractTransferDetails as au, extractTxCommands as av, extractTxSender as aw, fallbackLabel as ax, fetchService as ay, findSwapRoute as az, type ActivityReportConfig as b, truncateAddress as b0, usdcToRaw as b1, validateAddress as b2, verifyJobForSeller as b3, type T2000Options as b4, type X402Probe as b5, type SerializedCetusRoute as b6, type SwapResult as b7, type SwapQuoteResult as b8, type PaymentRequest as b9, isInRegistry as bA, normalizeAsset as bB, normalizeCoinType as bC, probeX402 as bD, queryHistory as bE, queryTransaction as bF, selectAndSplitCoin as bG, selectSuiCoin as bH, serializeCetusRoute as bI, simulateTransaction as bJ, throwIfSimulationFailed as bK, verifyCetusRouteCoinMatch as bL, type SuiCoreClient as ba, type SponsoredCoinMergeCache as bb, type SendableAsset as bc, CETUS_USDC_SUI_POOL as bd, type CoinPage as be, DEFAULT_GRPC_URL as bf, GASLESS_MIN_STABLE_AMOUNT as bg, GASLESS_STABLE_TYPES as bh, OPERATION_ASSETS as bi, type Operation as bj, SENDABLE_ASSETS as bk, type SelectAndSplitResult as bl, type SerializedCetusRoutePath as bm, type SerializedRouterDataV3 as bn, addSendToTx as bo, addSwapToTx as bp, assertAllowedAsset as bq, assertBuyerRequirements as br, buildDeclineJobTx as bs, deserializeCetusRoute as bt, fetchAllCoins as bu, getCoinMeta as bv, getSuiClient as bw, getSuiGrpcClient as bx, isAllowedAsset as by, isCetusRouteFresh as bz, COIN_REGISTRY as c, type ClassifyBalanceChange as d, type ClassifyResult as e, type CoinMeta as f, DEFAULT_COMMERCE_API_BASE as g, DEFAULT_NETWORK as h, type DepositInfo as i, type ExtractedTransfer as j, type Job as k, type JobState as l, type JobTerms as m, type JobVerification as n, KeypairSigner as o, LOFI_TYPE as p, MAX_DELIVER_HORIZON_MS as q, MAX_JOB_USDC as r, MAX_REVIEW_WINDOW_MS as s, MIST_PER_SUI as t, type OverlayFeeConfig as u, PREFLIGHT_OK as v, type PayOptions as w, type PayResult as x, type PreflightResult as y, SUI_DECIMALS as z };

package/dist/index.cjs

@@ -1140,11 +1140,65 @@ function preflightPay(input) {
   }
   return exports.PREFLIGHT_OK;
 }
-async function payWithX402(args) {
-  const { signer, client } = args;
-  let options = args.options;
-  const pf = preflightPay({ url: options.url, maxPrice: options.maxPrice });
+async function probeX402(args) {
+  const { network } = args;
+  const pf = preflightPay({ url: args.options.url, maxPrice: args.options.maxPrice });
   if (!pf.valid) throw new exports.T2000Error(pf.code, pf.error);
+  const { reqInit } = normalizePayRequest(args.options);
+  const probe = await fetch(args.options.url, reqInit);
+  if (probe.status !== 402) {
+    return {
+      kind: "free",
+      status: probe.status,
+      note: "No payment required \u2014 this endpoint served without a 402."
+    };
+  }
+  const pick = await pickSuiExactRequirements(probe, network);
+  if (pick.kind === "payable") {
+    const requirements = pick.requirements;
+    const priceUsdc = atomicToHuman(
+      BigInt(requirements.maxAmountRequired),
+      await assetDecimals(requirements.asset)
+    );
+    const { isX402EscrowRequirements } = await import('@t2000/sui-x402');
+    if (isX402EscrowRequirements(requirements)) {
+      return {
+        kind: "escrow",
+        priceUsdc,
+        payTo: requirements.payTo,
+        note: "This endpoint sells deliverable work through on-chain escrow, not an instant call. Hire it as a job instead \u2014 funds lock in a Job object and release on delivery."
+      };
+    }
+    return {
+      kind: "payable",
+      priceUsdc,
+      asset: requirements.asset,
+      payTo: requirements.payTo,
+      network
+    };
+  }
+  if (hasPaymentAuthenticateHeader(probe)) {
+    return {
+      kind: "unsupported",
+      reason: "header-only-402-unsupported",
+      note: "This seller answered a header-only 402 (WWW-Authenticate: Payment) with no payable x402 accepts[] envelope. That dialect is no longer supported \u2014 the seller must offer x402 (e.g. @t2000/serve emits it)."
+    };
+  }
+  if (pick.kind === "incomplete") {
+    return {
+      kind: "incomplete",
+      reason: "incomplete-x402-accepts",
+      note: "Seller's x402 challenge is incomplete (missing extra.suimpp) \u2014 the 402 advertises an exact/sui entry but carries no settlement challenge to bind a payment to."
+    };
+  }
+  return {
+    kind: "not-x402",
+    status: probe.status,
+    note: `Endpoint returned 402 without an x402 'exact' / sui:${network} requirement in the body. Nothing this SDK can pay.`
+  };
+}
+function normalizePayRequest(input) {
+  let options = input;
   const method = (options.method ?? "GET").toUpperCase();
   const canHaveBody = method !== "GET" && method !== "HEAD";
   if (canHaveBody && typeof options.body === "string" && isJsonText(options.body) && !hasContentType(options.headers)) {
@@ -1153,11 +1207,23 @@ async function payWithX402(args) {
       headers: { ...options.headers ?? {}, "content-type": "application/json" }
     };
   }
-  const reqInit = {
-    method,
-    headers: options.headers,
-    body: canHaveBody ? options.body : void 0
+  return {
+    options,
+    reqInit: {
+      method,
+      headers: options.headers,
+      body: canHaveBody ? options.body : void 0
+    }
   };
+}
+async function payWithX402(args) {
+  const { signer, client } = args;
+  let options = args.options;
+  const pf = preflightPay({ url: options.url, maxPrice: options.maxPrice });
+  if (!pf.valid) throw new exports.T2000Error(pf.code, pf.error);
+  const normalized = normalizePayRequest(options);
+  options = normalized.options;
+  const reqInit = normalized.reqInit;
   const probe = await fetch(options.url, reqInit);
   if (probe.status !== 402) {
     return finalize(probe, { paid: false });
@@ -2799,6 +2865,15 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
     return this._signer;
   }
   // -- MPP Payments --
+  /**
+   * READ-ONLY price probe for an x402 endpoint (S.919). Reports what `pay()`
+   * would cost without signing or spending, so a caller (Connect's
+   * `t2000_pay_probe`, the CLI, a UI) can show terms before committing.
+   * No limit gate: nothing moves.
+   */
+  async payProbe(options) {
+    return await probeX402({ network: this.client.network, options });
+  }
   async pay(options) {
     this.limits.assert({ operation: "pay", amountUsd: options.maxPrice ?? 0, force: options.force });
     const result = await payWithX402({ signer: this._signer, client: this.client, options });
@@ -4355,6 +4430,7 @@ exports.preflightFail = preflightFail;
 exports.preflightPay = preflightPay;
 exports.preflightSend = preflightSend;
 exports.preflightSwap = preflightSwap;
+exports.probeX402 = probeX402;
 exports.putJobSpec = putJobSpec;
 exports.queryBalance = queryBalance;
 exports.queryHistory = queryHistory;