@t2000/sdk 10.25.1 → 10.27.0

package/dist/{commerce-B_eH6fvR.d.cts → commerce-DR_F-Eg6.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;
@@ -1400,7 +1444,17 @@ declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, r
  * onto the Job at create, FeeConfig versioning, bounded windows). Override
  * via env for testnet/dev.
  */
-/** The published `a2a_escrow` package id (mainnet). */
+/** The published `a2a_escrow` package id on MAINNET — a literal, never an
+ *  env read.
+ *
+ *  Security (S.930): the env-overridable constant below is a dev/testnet
+ *  convenience, which makes it useless as a trust anchor — anything verifying
+ *  "is this the real escrow package?" against it would be checking the
+ *  attacker's own answer. Signature-time verification compares against THIS.
+ *  Must match the Move upgrade publish notes. */
+declare const MAINNET_A2A_ESCROW_PACKAGE_ID = "0x358a819c1c016e2cc84ef5fbea81cba90c31f7f8a62bf45cb5e5276acf198bdd";
+/** The published `a2a_escrow` package id (mainnet default; env-overridable
+ *  for testnet/dev — NOT a trust anchor, see above). */
 declare const A2A_ESCROW_PACKAGE_ID: string;
 /** The shared `FeeConfig` object every escrow entry reads (mainnet). */
 declare const A2A_ESCROW_FEE_CONFIG_ID: string;
@@ -1556,4 +1610,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, isCetusRouteFresh as bA, isInRegistry as bB, normalizeAsset as bC, normalizeCoinType as bD, probeX402 as bE, queryHistory as bF, queryTransaction as bG, selectAndSplitCoin as bH, selectSuiCoin as bI, serializeCetusRoute as bJ, simulateTransaction as bK, throwIfSimulationFailed as bL, verifyCetusRouteCoinMatch as bM, 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, MAINNET_A2A_ESCROW_PACKAGE_ID as bi, OPERATION_ASSETS as bj, type Operation as bk, SENDABLE_ASSETS as bl, type SelectAndSplitResult as bm, type SerializedCetusRoutePath as bn, type SerializedRouterDataV3 as bo, addSendToTx as bp, addSwapToTx as bq, assertAllowedAsset as br, assertBuyerRequirements as bs, buildDeclineJobTx as bt, deserializeCetusRoute as bu, fetchAllCoins as bv, getCoinMeta as bw, getSuiClient as bx, getSuiGrpcClient as by, isAllowedAsset 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-DR_F-Eg6.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;
@@ -1400,7 +1444,17 @@ declare function addSendToTx(tx: Transaction, coin: TransactionObjectArgument, r
  * onto the Job at create, FeeConfig versioning, bounded windows). Override
  * via env for testnet/dev.
  */
-/** The published `a2a_escrow` package id (mainnet). */
+/** The published `a2a_escrow` package id on MAINNET — a literal, never an
+ *  env read.
+ *
+ *  Security (S.930): the env-overridable constant below is a dev/testnet
+ *  convenience, which makes it useless as a trust anchor — anything verifying
+ *  "is this the real escrow package?" against it would be checking the
+ *  attacker's own answer. Signature-time verification compares against THIS.
+ *  Must match the Move upgrade publish notes. */
+declare const MAINNET_A2A_ESCROW_PACKAGE_ID = "0x358a819c1c016e2cc84ef5fbea81cba90c31f7f8a62bf45cb5e5276acf198bdd";
+/** The published `a2a_escrow` package id (mainnet default; env-overridable
+ *  for testnet/dev — NOT a trust anchor, see above). */
 declare const A2A_ESCROW_PACKAGE_ID: string;
 /** The shared `FeeConfig` object every escrow entry reads (mainnet). */
 declare const A2A_ESCROW_FEE_CONFIG_ID: string;
@@ -1556,4 +1610,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, isCetusRouteFresh as bA, isInRegistry as bB, normalizeAsset as bC, normalizeCoinType as bD, probeX402 as bE, queryHistory as bF, queryTransaction as bG, selectAndSplitCoin as bH, selectSuiCoin as bI, serializeCetusRoute as bJ, simulateTransaction as bK, throwIfSimulationFailed as bL, verifyCetusRouteCoinMatch as bM, 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, MAINNET_A2A_ESCROW_PACKAGE_ID as bi, OPERATION_ASSETS as bj, type Operation as bk, SENDABLE_ASSETS as bl, type SelectAndSplitResult as bm, type SerializedCetusRoutePath as bn, type SerializedRouterDataV3 as bo, addSendToTx as bp, addSwapToTx as bq, assertAllowedAsset as br, assertBuyerRequirements as bs, buildDeclineJobTx as bt, deserializeCetusRoute as bu, fetchAllCoins as bv, getCoinMeta as bw, getSuiClient as bx, getSuiGrpcClient as by, isAllowedAsset 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 });
@@ -3217,7 +3292,8 @@ init_coinSelection();
 init_errors();
 init_token_registry();
 init_coinSelection();
-var A2A_ESCROW_OPENING_PACKAGE_ID = process.env.A2A_ESCROW_OPENING_PACKAGE_ID ?? "0x69ad93c555519de520a5c7f7f2963ad6f8b91cefc098fc2eed75942dcb5bcbe7";
+var MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID = "0x69ad93c555519de520a5c7f7f2963ad6f8b91cefc098fc2eed75942dcb5bcbe7";
+var A2A_ESCROW_OPENING_PACKAGE_ID = process.env.A2A_ESCROW_OPENING_PACKAGE_ID ?? MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID;
 var A2A_ESCROW_PACKAGE_V2_ID = "0x860288d789dc617f6474a0a6801d6011e53bf30d5fb801cdad47b9bc6adb098b";
 var A2A_ESCROW_PACKAGE_V3_ID = "0x69ad93c555519de520a5c7f7f2963ad6f8b91cefc098fc2eed75942dcb5bcbe7";
 var CLOCK_ID2 = "0x6";
@@ -3353,7 +3429,8 @@ async function getOpening(client, openingId) {
 }
 
 // src/wallet/job.ts
-var A2A_ESCROW_PACKAGE_ID = process.env.A2A_ESCROW_PACKAGE_ID ?? "0x358a819c1c016e2cc84ef5fbea81cba90c31f7f8a62bf45cb5e5276acf198bdd";
+var MAINNET_A2A_ESCROW_PACKAGE_ID = "0x358a819c1c016e2cc84ef5fbea81cba90c31f7f8a62bf45cb5e5276acf198bdd";
+var A2A_ESCROW_PACKAGE_ID = process.env.A2A_ESCROW_PACKAGE_ID ?? MAINNET_A2A_ESCROW_PACKAGE_ID;
 var A2A_ESCROW_FEE_CONFIG_ID = process.env.A2A_ESCROW_FEE_CONFIG_ID ?? "0xddaa25570950b7484dbf20797ebcf75707be9c87cd67bef2a06ed2e81d2c494b";
 var A2A_ESCROW_FEE_CONFIG_VERSION = Number(
   process.env.A2A_ESCROW_FEE_CONFIG_VERSION ?? 931861903
@@ -3723,6 +3800,10 @@ async function fetchJson(url, init) {
   }
   return json;
 }
+var sponsoredTxGuard = null;
+function setSponsoredTxGuard(guard) {
+  sponsoredTxGuard = guard;
+}
 async function listOpenJobs(base, filter = {}) {
   const params = new URLSearchParams();
   if (filter.status) params.set("status", filter.status);
@@ -3741,6 +3822,7 @@ async function getOpenJob(base, id) {
 }
 async function sponsoredOpeningVerb(base, signer, action, params) {
   const address = signer.getAddress();
+  sponsoredTxGuard?.({ base, action });
   const prep = await fetchJson(`${base}/job/prepare`, {
     method: "POST",
     body: { address, action, params }
@@ -3750,6 +3832,7 @@ async function sponsoredOpeningVerb(base, signer, action, params) {
   if (!(nonce && txBytes)) {
     throw new Error("Failed to prepare the transaction.");
   }
+  sponsoredTxGuard?.({ base, action, txBytes });
   const { signature } = await signer.signTransaction(utils.fromBase64(txBytes));
   const json = await fetchJson(`${base}/job/submit`, {
     method: "POST",
@@ -4242,6 +4325,8 @@ exports.KeypairSigner = KeypairSigner;
 exports.LABEL_PATTERNS = LABEL_PATTERNS;
 exports.LimitEnforcer = LimitEnforcer;
 exports.LimitExceededError = LimitExceededError;
+exports.MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID = MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID;
+exports.MAINNET_A2A_ESCROW_PACKAGE_ID = MAINNET_A2A_ESCROW_PACKAGE_ID;
 exports.MAX_DELIVER_HORIZON_MS = MAX_DELIVER_HORIZON_MS;
 exports.MAX_JOB_USDC = MAX_JOB_USDC;
 exports.MAX_OPEN_WINDOW_MS = MAX_OPEN_WINDOW_MS;
@@ -4355,6 +4440,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;
@@ -4377,6 +4463,7 @@ exports.selectAndSplitCoin = selectAndSplitCoin;
 exports.selectSuiCoin = selectSuiCoin;
 exports.serializeCetusRoute = serializeCetusRoute;
 exports.setLimits = setLimits;
+exports.setSponsoredTxGuard = setSponsoredTxGuard;
 exports.simulateTransaction = simulateTransaction;
 exports.stableToRaw = stableToRaw;
 exports.suiToMist = suiToMist;