@t2000/sdk 10.38.2 → 10.39.0

package/dist/browser.js

@@ -1349,19 +1349,87 @@ init_coinSelection();
 init_errors();
 init_token_registry();
 init_coinSelection();
-var MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID = "0x5c90ec07da01bf885a4e65247ce98b75ab8a042cd965d30d7213856d579c4afa";
+var MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID = "0x2a928916c859a159e6d6f4841073a31397d01336c1ea689ce74344e456463c8d";
 var A2A_ESCROW_LATEST_PACKAGE_ID = process.env.A2A_ESCROW_OPENING_PACKAGE_ID ?? process.env.A2A_ESCROW_PACKAGE_ID ?? MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID;
+var A2A_ESCROW_OPENING_PACKAGE_ID = A2A_ESCROW_LATEST_PACKAGE_ID;
 var A2A_ESCROW_PACKAGE_V7_ID = "0x4249f0b242c47c7baf0c37304365bc4bbe769bcedf11f3525e84682d59a3b23e";
 var A2A_ESCROW_PACKAGE_V8_ID = "0x1595b80bc05a03607f3908702c866ca63cf961025b4263b5ecbe419e07f8ff31";
 var A2A_ESCROW_PACKAGE_V10_ID = process.env.A2A_ESCROW_PACKAGE_V10_ID ?? "0x5c90ec07da01bf885a4e65247ce98b75ab8a042cd965d30d7213856d579c4afa";
+process.env.A2A_ESCROW_PACKAGE_V11_ID ?? "0x2a928916c859a159e6d6f4841073a31397d01336c1ea689ce74344e456463c8d";
+var SHA256_HEX_RE = /^(0x)?[0-9a-fA-F]{64}$/;
 var OPENING_CLAIM_POLICY_ANY_ACTIVE = 0;
 var OPENING_CLAIM_POLICY_PROVEN = 1;
 var OPENING_CLAIM_POLICY_PROVEN_4STAR = 2;
+var MAX_OPEN_WINDOW_MS = 2592e6;
+function feeConfigArg(tx) {
+  return tx.sharedObjectRef({
+    objectId: A2A_ESCROW_FEE_CONFIG_ID,
+    initialSharedVersion: A2A_ESCROW_FEE_CONFIG_VERSION,
+    mutable: false
+  });
+}
 var OPENING_CLAIM_POLICIES = [
   OPENING_CLAIM_POLICY_ANY_ACTIVE,
   OPENING_CLAIM_POLICY_PROVEN,
   OPENING_CLAIM_POLICY_PROVEN_4STAR
 ];
+var OPEN_REJECT_SPLIT_BPS = 1e4;
+function preflightCreateOpening(terms) {
+  if (!Number.isFinite(terms.amountUsdc) || terms.amountUsdc <= 0) {
+    return { valid: false, code: "INVALID_AMOUNT", error: "Budget must be positive." };
+  }
+  if (terms.amountUsdc < MIN_JOB_USDC) {
+    return {
+      valid: false,
+      code: "INVALID_AMOUNT",
+      error: `Open jobs start at ${MIN_JOB_USDC} USDC (contract-enforced minimum). Got ${terms.amountUsdc}.`
+    };
+  }
+  if (terms.amountUsdc > MAX_JOB_USDC) {
+    return {
+      valid: false,
+      code: "INVALID_AMOUNT",
+      error: `Open jobs cap at ${MAX_JOB_USDC} USDC (v1).`
+    };
+  }
+  if (!SHA256_HEX_RE.test(terms.specHash)) {
+    return { valid: false, code: "INVALID_INPUT", error: "specHash must be a sha256 hex string." };
+  }
+  const now = Date.now();
+  if (terms.openUntilMs <= now) {
+    return { valid: false, code: "INVALID_INPUT", error: "openUntil must be in the future." };
+  }
+  if (terms.openUntilMs > now + MAX_OPEN_WINDOW_MS) {
+    return { valid: false, code: "INVALID_INPUT", error: "Openings can stay claimable at most 30 days." };
+  }
+  if (terms.slaMs <= 0) {
+    return { valid: false, code: "INVALID_INPUT", error: "Delivery window must be positive." };
+  }
+  if (terms.rejectSplitBps !== OPEN_REJECT_SPLIT_BPS) {
+    return {
+      valid: false,
+      code: "INVALID_INPUT",
+      error: "Open postings lock reject at 100% buyer / 0% seller (rejectSplitBps must be 10000, contract-enforced since v5) \u2014 reject is economically a decline, so junk delivery has no edge."
+    };
+  }
+  const policy = terms.claimPolicy ?? OPENING_CLAIM_POLICY_ANY_ACTIVE;
+  if (!OPENING_CLAIM_POLICIES.includes(policy)) {
+    return {
+      valid: false,
+      code: "INVALID_INPUT",
+      error: "claimPolicy must be 0 (Anyone), 1 (Proven) or 2 (Proven \xB7 4\u2605+) \u2014 anything else aborts on-chain."
+    };
+  }
+  const minLevel = terms.minSellerLevel ?? 0;
+  if (!Number.isInteger(minLevel) || minLevel < 0 || minLevel > 4) {
+    return {
+      valid: false,
+      code: "INVALID_INPUT",
+      error: "minSellerLevel must be 0 (no floor) or 1\u20134 (Level 1\u20134) \u2014 anything else aborts on-chain (S.1192)."
+    };
+  }
+  return { valid: true };
+}
 
 // src/wallet/job.ts
 var MAINNET_A2A_ESCROW_PACKAGE_ID = "0x358a819c1c016e2cc84ef5fbea81cba90c31f7f8a62bf45cb5e5276acf198bdd";
@@ -1372,7 +1440,7 @@ var A2A_ESCROW_FEE_CONFIG_VERSION = Number(
 );
 var CLOCK_ID2 = "0x6";
 var MODULE = "escrow";
-function feeConfigArg(tx) {
+function feeConfigArg2(tx) {
   return tx.sharedObjectRef({
     objectId: A2A_ESCROW_FEE_CONFIG_ID,
     initialSharedVersion: A2A_ESCROW_FEE_CONFIG_VERSION,
@@ -1473,7 +1541,7 @@ async function buildCreateJobTx({
       tx.pure.u64(terms.deliverByMs),
       tx.pure.u64(terms.reviewWindowMs),
       tx.pure.u64(terms.rejectSplitBps),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ]
   });
@@ -1489,13 +1557,13 @@ function buildRejectJobTx(jobId, v2) {
       tx.object(v2.sellerScoreId),
       tx.object(v2.buyerScoreId),
       tx.object(v2.registryId),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ] : [
       tx.object(jobId),
       tx.object(v2.sellerScoreId),
       tx.object(v2.registryId),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ]
   });
@@ -1509,7 +1577,7 @@ function buildRefundJobTx(jobId, v2) {
     arguments: [
       tx.object(jobId),
       tx.object(v2.sellerScoreId),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ]
   });
@@ -1523,7 +1591,7 @@ function buildDeliverJobTx(jobId, deliveryHash) {
     arguments: [
       tx.object(jobId),
       tx.pure.vector("u8", hexToBytes(deliveryHash)),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ]
   });
@@ -1537,7 +1605,7 @@ function buildReleaseJobTx(jobId, v2) {
     arguments: [
       tx.object(jobId),
       tx.object(v2.sellerScoreId),
-      feeConfigArg(tx),
+      feeConfigArg2(tx),
       tx.object(CLOCK_ID2)
     ]
   });
@@ -1769,6 +1837,184 @@ function preflightClaimOpening(score, opening) {
   return { valid: true };
 }
 
+// src/wallet/batch.ts
+init_errors();
+init_token_registry();
+init_coinSelection();
+var MODULE3 = "batch";
+var CLOCK_ID3 = "0x6";
+var MAX_BATCH_SLOTS_DEFAULT = 250;
+var BATCH_OPENING_TYPE_MARKER = "::batch::BatchOpening<";
+function preflightCreateBatchOpening(terms) {
+  const single = preflightCreateOpening(terms);
+  if (!single.valid) return single;
+  if (!Number.isInteger(terms.slots) || terms.slots < 1 || terms.slots > MAX_BATCH_SLOTS_DEFAULT) {
+    return {
+      valid: false,
+      code: "INVALID_INPUT",
+      error: `slots must be an integer 1\u2013${MAX_BATCH_SLOTS_DEFAULT} (the live max is AdminCap-tunable on-chain).`
+    };
+  }
+  const maxClaims = terms.maxClaimsPerAgent ?? 1;
+  if (!Number.isInteger(maxClaims) || maxClaims < 1 || maxClaims > terms.slots) {
+    return {
+      valid: false,
+      code: "INVALID_INPUT",
+      error: "maxClaimsPerAgent must be an integer \u22651 and \u2264 slots."
+    };
+  }
+  return { valid: true };
+}
+async function buildCreateBatchOpeningTx({
+  client,
+  buyer,
+  terms
+}) {
+  const pf = preflightCreateBatchOpening(terms);
+  if (!pf.valid) throw new T2000Error(pf.code ?? "INVALID_INPUT", pf.error ?? "Invalid batch.");
+  const perSlotRaw = BigInt(Math.floor(terms.amountUsdc * 10 ** USDC_DECIMALS));
+  const totalRaw = perSlotRaw * BigInt(terms.slots);
+  const tx = new Transaction();
+  const { coin } = await selectAndSplitCoin(
+    tx,
+    client,
+    validateAddress(buyer),
+    USDC_TYPE,
+    totalRaw,
+    { allowSwapAll: false }
+  );
+  tx.moveCall({
+    target: `${A2A_ESCROW_OPENING_PACKAGE_ID}::${MODULE3}::create_batch_open`,
+    typeArguments: [USDC_TYPE],
+    arguments: [
+      coin,
+      tx.pure.u64(terms.slots),
+      tx.pure.vector("u8", hexToBytes2(terms.specHash)),
+      tx.pure.u64(terms.openUntilMs),
+      tx.pure.u64(terms.slaMs),
+      tx.pure.u64(terms.reviewWindowMs),
+      tx.pure.u64(terms.rejectSplitBps),
+      tx.pure.u8(terms.claimPolicy ?? OPENING_CLAIM_POLICY_ANY_ACTIVE),
+      tx.pure.u8(terms.minSellerLevel ?? 0),
+      tx.pure.u8(terms.maxClaimsPerAgent ?? 1),
+      feeConfigArg(tx),
+      tx.object(CLOCK_ID3)
+    ]
+  });
+  return tx;
+}
+function buildBatchClaimTx({
+  batchId,
+  registryId,
+  scoreId
+}) {
+  if (!scoreId) {
+    throw new T2000Error(
+      "INVALID_INPUT",
+      "Claiming needs the claimer's own AgentScore id (derive with deriveAgentScoreId; create it first with buildCreateEmptyScoreTx when missing)."
+    );
+  }
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${A2A_ESCROW_OPENING_PACKAGE_ID}::${MODULE3}::batch_claim`,
+    typeArguments: [USDC_TYPE],
+    arguments: [
+      tx.object(batchId),
+      tx.object(registryId),
+      tx.object(scoreId),
+      feeConfigArg(tx),
+      tx.object(CLOCK_ID3)
+    ]
+  });
+  return tx;
+}
+function batchCall(batchId, fn) {
+  const tx = new Transaction();
+  tx.moveCall({
+    target: `${A2A_ESCROW_OPENING_PACKAGE_ID}::${MODULE3}::${fn}`,
+    typeArguments: [USDC_TYPE],
+    arguments: [tx.object(batchId), feeConfigArg(tx), tx.object(CLOCK_ID3)]
+  });
+  return tx;
+}
+function buildCancelBatchOpeningTx(batchId) {
+  return batchCall(batchId, "cancel_batch_open");
+}
+function buildRefundBatchExpiredTx(batchId) {
+  return batchCall(batchId, "refund_batch_expired");
+}
+function bytesToHex2(bytes) {
+  return `0x${Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("")}`;
+}
+function hexToBytes2(hex) {
+  const clean = hex.replace(/^0x/, "");
+  const bytes = [];
+  for (let i = 0; i < clean.length; i += 2) {
+    bytes.push(Number.parseInt(clean.slice(i, i + 2), 16));
+  }
+  return bytes;
+}
+async function getBatchOpening(client, batchId) {
+  const resp = await client.core.getObject({ objectId: batchId, include: { json: true } }).catch(() => null);
+  const objType = resp?.object?.type ?? "";
+  const json = resp?.object?.json;
+  if (!json || !objType.includes(BATCH_OPENING_TYPE_MARKER)) {
+    return null;
+  }
+  const table = json.claims_by_agent;
+  return {
+    id: batchId,
+    buyer: String(json.buyer),
+    amountUsdc: Number(json.amount) / 10 ** USDC_DECIMALS,
+    slotsTotal: Number(json.slots_total),
+    slotsRemaining: Number(json.slots_remaining),
+    feeBps: Number(json.fee_bps ?? 0),
+    specHash: bytesToHex2(json.spec_hash ?? []),
+    openUntilMs: Number(json.open_until_ms),
+    slaMs: Number(json.sla_ms),
+    reviewWindowMs: Number(json.review_window_ms),
+    rejectSplitBps: Number(json.reject_split_bps),
+    claimPolicy: Number(json.claim_policy ?? 0),
+    minSellerLevel: Number(json.min_seller_level ?? 0),
+    maxClaimsPerAgent: Number(json.max_claims_per_agent ?? 1),
+    claimsTableId: table?.id ? String(table.id) : null,
+    createdAtMs: Number(json.created_at_ms ?? 0)
+  };
+}
+async function getBatchClaimsByAgent(client, batch, agent) {
+  if (!batch.claimsTableId) return 0;
+  try {
+    const fieldId = deriveDynamicFieldID(
+      batch.claimsTableId,
+      "address",
+      bcs.Address.serialize(validateAddress(agent)).toBytes()
+    );
+    const resp = await client.core.getObject({
+      objectId: fieldId,
+      include: { json: true }
+    });
+    const json = resp?.object?.json;
+    return Number(json?.value ?? 0);
+  } catch {
+    return 0;
+  }
+}
+function preflightBatchClaim(score, batch, myClaims) {
+  if (batch.slotsRemaining <= 0) {
+    return {
+      valid: false,
+      error: "No slots left on this batch \u2014 every slot is claimed. Find open waves on the board."
+    };
+  }
+  if (myClaims >= batch.maxClaimsPerAgent) {
+    return {
+      valid: false,
+      error: `This wave allows ${batch.maxClaimsPerAgent} slot${batch.maxClaimsPerAgent === 1 ? "" : "s"} per agent and this wallet already holds ${myClaims}. Deliver what you claimed; other waves on the board are open.`
+    };
+  }
+  return preflightClaimOpening(score, batch);
+}
+
 // src/commerce.ts
 var DEFAULT_COMMERCE_API_BASE = "https://api.t2000.ai/v1";
 async function commerceFetchJson(url, init) {
@@ -1859,4 +2105,4 @@ async function getJobSpec(base, hash) {
 // src/browser.ts
 init_token_registry();
 
-export { A2A_ESCROW_FEE_CONFIG_ID, A2A_ESCROW_PACKAGE_ID, CLOCK_ID, COIN_REGISTRY, DEFAULT_ACTIVITY_REPORT_URL, DEFAULT_COMMERCE_API_BASE, DEFAULT_NETWORK, ETH_TYPE, GAS_RESERVE_MIN, IKA_TYPE, JOB_STATES, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LEVEL4_MAX_NO_DELIVERY, LEVEL4_MIN_REVIEWS, LOFI_TYPE, MANIFEST_TYPE, MAX_DELIVER_HORIZON_MS, MAX_JOB_USDC, MAX_REVIEW_WINDOW_MS, MIN_JOB_USDC, MIST_PER_SUI, NAVX_TYPE, NO_DELIVERY_REGRESSION_FLOOR, OPENING_CLAIM_POLICIES, OPENING_CLAIM_POLICY_ANY_ACTIVE, OPENING_CLAIM_POLICY_PROVEN, OPENING_CLAIM_POLICY_PROVEN_4STAR, OVERLAY_FEE_RATE, PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK, PROVEN_MIN_AVG_STARS_X10, PROVEN_MIN_REVIEWS, REVIEW_MAX_STARS, REVIEW_MIN_STARS, SELLER_LEVEL_ACTIVE_CAPS, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, ZkLoginSigner, activeCapForLevel, buildCreateJobTx, buildDeliverJobTx, buildRefundJobTx, buildRejectJobTx, buildReleaseJobTx, buildSendTx, buildSwapTx, checkPositiveAmount, checkSuiAddress, claimPolicyLabel, claimPolicyRequirement, classifyAction, classifyLabel, classifySendAsset, classifyTransaction, deriveAgentScoreId, effectiveSellerLevel, executeTx, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchService, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fromBase642 as fromBase64, getAgentScore, getDecimals, getDecimalsForCoinType, getJob, getJobSpec, invalidSendAssetMessage, jobActionsFor, listServices, mapMoveAbortCode, mapWalletError, meetsClaimPolicy, meetsMinSellerLevel, mistToSui, parseSuiRpcTx, payWithX402, preflightClaimOpening, preflightCreateJob, preflightFail, preflightPay, preflightSend, preflightSwap, putJobSpec, rawToStable, rawToUsdc, refineLendingLabel, reportX402Activity, resolveSymbol, resolveTokenType, sellerLevel, sellerLevelLabel, stableToRaw, suiToMist, toBase64, truncateAddress, usdcToRaw, validateAddress, verifyJobForSeller };
+export { A2A_ESCROW_FEE_CONFIG_ID, A2A_ESCROW_PACKAGE_ID, BATCH_OPENING_TYPE_MARKER, CLOCK_ID, COIN_REGISTRY, DEFAULT_ACTIVITY_REPORT_URL, DEFAULT_COMMERCE_API_BASE, DEFAULT_NETWORK, ETH_TYPE, GAS_RESERVE_MIN, IKA_TYPE, JOB_STATES, KNOWN_TARGETS, KeypairSigner, LABEL_PATTERNS, LEVEL4_MAX_NO_DELIVERY, LEVEL4_MIN_REVIEWS, LOFI_TYPE, MANIFEST_TYPE, MAX_BATCH_SLOTS_DEFAULT, MAX_DELIVER_HORIZON_MS, MAX_JOB_USDC, MAX_REVIEW_WINDOW_MS, MIN_JOB_USDC, MIST_PER_SUI, NAVX_TYPE, NO_DELIVERY_REGRESSION_FLOOR, OPENING_CLAIM_POLICIES, OPENING_CLAIM_POLICY_ANY_ACTIVE, OPENING_CLAIM_POLICY_PROVEN, OPENING_CLAIM_POLICY_PROVEN_4STAR, OVERLAY_FEE_RATE, PREFLIGHT_MAX_AMOUNT, PREFLIGHT_OK, PROVEN_MIN_AVG_STARS_X10, PROVEN_MIN_REVIEWS, REVIEW_MAX_STARS, REVIEW_MIN_STARS, SELLER_LEVEL_ACTIVE_CAPS, STABLE_ASSETS, SUI_DECIMALS, SUI_TYPE, SUPPORTED_ASSETS, T2000Error, T2000_OVERLAY_FEE_WALLET, TOKEN_MAP, USDC_DECIMALS, USDC_TYPE, USDE_TYPE, USDSUI_TYPE, USDT_TYPE, WAL_TYPE, WBTC_TYPE, ZkLoginSigner, activeCapForLevel, buildBatchClaimTx, buildCancelBatchOpeningTx, buildCreateBatchOpeningTx, buildCreateJobTx, buildDeliverJobTx, buildRefundBatchExpiredTx, buildRefundJobTx, buildRejectJobTx, buildReleaseJobTx, buildSendTx, buildSwapTx, checkPositiveAmount, checkSuiAddress, claimPolicyLabel, claimPolicyRequirement, classifyAction, classifyLabel, classifySendAsset, classifyTransaction, deriveAgentScoreId, effectiveSellerLevel, executeTx, extractAllUserLegs, extractTransferDetails, extractTxCommands, extractTxSender, fallbackLabel, fetchService, findSwapRoute, formatAssetAmount, formatSui, formatUsd, fromBase642 as fromBase64, getAgentScore, getBatchClaimsByAgent, getBatchOpening, getDecimals, getDecimalsForCoinType, getJob, getJobSpec, invalidSendAssetMessage, jobActionsFor, listServices, mapMoveAbortCode, mapWalletError, meetsClaimPolicy, meetsMinSellerLevel, mistToSui, parseSuiRpcTx, payWithX402, preflightBatchClaim, preflightClaimOpening, preflightCreateBatchOpening, preflightCreateJob, preflightFail, preflightPay, preflightSend, preflightSwap, putJobSpec, rawToStable, rawToUsdc, refineLendingLabel, reportX402Activity, resolveSymbol, resolveTokenType, sellerLevel, sellerLevelLabel, stableToRaw, suiToMist, toBase64, truncateAddress, usdcToRaw, validateAddress, verifyJobForSeller };

package/dist/{commerce-D14qzqAV.d.cts → commerce-C_1GwUoT.d.cts}

@@ -1641,8 +1641,10 @@ declare function verifyJobForSeller({ client, jobId, seller, minAmountUsdc, minR
  * target the LATEST published id — the original id (types, Job verbs) is
  * unchanged.
  */
-/** The LATEST published `a2a_escrow` package id on MAINNET (v10 upgrade
- *  2026-08-24, S.1192 — seller levels + active caps, VERSION 6 cutover:
+/** The LATEST published `a2a_escrow` package id on MAINNET (v11 upgrade
+ *  2026-08-25, S.1193 — batch openings, additive, NO migrate:
+ *  `batch` module + `set_max_batch_slots`;
+ *  v10 = S.1192 seller levels + active caps, VERSION 6 cutover:
  *  claim_v2/claim_proven_v2/create_open_v2/release_v2;
  *  v9 = S.1064 review on REJECTED, additive; v8 = outcome
  *  counters (S.1063); v7 = distinct buyers (S.1062);
@@ -1657,9 +1659,9 @@ declare function verifyJobForSeller({ client, jobId, seller, minAmountUsdc, minR
  *  upgrade + `migrate` cutover is a ONE-VALUE change here. The original id
  *  (`MAINNET_A2A_ESCROW_PACKAGE_ID` in job.ts) remains the anchor for type
  *  strings, event filters, and object-type queries — those never move. */
-declare const MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID = "0x5c90ec07da01bf885a4e65247ce98b75ab8a042cd965d30d7213856d579c4afa";
+declare const MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID = "0x2a928916c859a159e6d6f4841073a31397d01336c1ea689ce74344e456463c8d";
 /** Back-compat name for the latest id (pre-S.981 consumers import this). */
-declare const MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID = "0x5c90ec07da01bf885a4e65247ce98b75ab8a042cd965d30d7213856d579c4afa";
+declare const MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID = "0x2a928916c859a159e6d6f4841073a31397d01336c1ea689ce74344e456463c8d";
 /** Env-overridable latest id for testnet/dev (NOT a trust anchor). A fresh
  *  dev publish has original == latest, so `A2A_ESCROW_PACKAGE_ID` alone is
  *  honored as the fallback override. */
@@ -1702,6 +1704,12 @@ declare const A2A_ESCROW_PACKAGE_V8_ID = "0x1595b80bc05a03607f3908702c866ca63cf9
  *  ClaimedJobKey DF key types. A DEFINING-id anchor like V2/V3/V6/V7/V8 —
  *  never moves again, even when LATEST does. */
 declare const A2A_ESCROW_PACKAGE_V10_ID: string;
+/** v11 (S.1193, upgrade 2y3g17rv… 2026-08-25) — defining id for the batch
+ *  surface: the BatchOpeningCreated/BatchSlotClaimed/BatchOpeningCancelled/
+ *  BatchOpeningRefunded events and the BatchOpening object type. A
+ *  DEFINING-id anchor like V2/V3/V6/V7/V8/V10 — never moves again, even
+ *  when LATEST does. */
+declare const A2A_ESCROW_PACKAGE_V11_ID: string;
 /** Default claim policy: any ACTIVE registered Agent ID ($0 claim, FCFS). */
 declare const OPENING_CLAIM_POLICY_ANY_ACTIVE = 0;
 /** S.1054 — Proven: claimer needs ≥ PROVEN_MIN_REVIEWS on-chain reviews
@@ -1939,6 +1947,88 @@ declare function buildSubmitFirstReviewTx({ jobId, stars, boardId, }: {
     boardId?: string;
 }): Transaction;
 
+/** Mirror of the Move package default for slots per wave. The LIVE value
+ *  is an AdminCap FeeConfig DF (`config_max_batch_slots`) — the chain is
+ *  the SSOT and may be retuned between npm releases (same class as
+ *  `MAX_JOB_USDC`); this mirror feeds the preflight's English only. */
+declare const MAX_BATCH_SLOTS_DEFAULT = 250;
+/** Object-type marker for `resolveCreatedObjectId` digest walks. */
+declare const BATCH_OPENING_TYPE_MARKER: "::batch::BatchOpening<";
+interface BatchOpeningTerms extends OpeningTerms {
+    /** Slots in the wave (1..live max; default live max 250). `amountUsdc`
+     *  is PER SLOT — total escrow = `slots × amountUsdc`. */
+    slots: number;
+    /** Slots one agent may claim of THIS wave (≥1; default 1). */
+    maxClaimsPerAgent?: number;
+}
+/** Client-side preflight — the single-opening rules on the PER-SLOT terms
+ *  plus the wave bounds. */
+declare function preflightCreateBatchOpening(terms: BatchOpeningTerms): {
+    valid: boolean;
+    code?: 'INVALID_AMOUNT' | 'INVALID_INPUT';
+    error?: string;
+};
+/** Build the wave post: split `slots × amount` USDC → `create_batch_open`. */
+declare function buildCreateBatchOpeningTx({ client, buyer, terms, }: {
+    client: SuiCoreClient;
+    buyer: string;
+    terms: BatchOpeningTerms;
+}): Promise<Transaction>;
+/** Claim ONE slot — same score plumbing as `buildClaimOpeningTx`
+ *  (claimer's own AgentScore always; `create_empty_score` precursor when
+ *  it doesn't exist yet). Unlike singles there is no policy-based entry
+ *  split: `batch_claim` handles every policy internally. */
+declare function buildBatchClaimTx({ batchId, registryId, scoreId, }: {
+    batchId: string;
+    registryId: string;
+    scoreId: string;
+}): Transaction;
+/** Buyer withdraws the unclaimed remainder — fee-free, any time. */
+declare function buildCancelBatchOpeningTx(batchId: string): Transaction;
+/** Permissionless remainder refund once `open_until` lapses. */
+declare function buildRefundBatchExpiredTx(batchId: string): Transaction;
+/** On-chain view of one BatchOpening. */
+interface BatchOpening {
+    id: string;
+    buyer: string;
+    /** PER-SLOT escrow in display USDC. */
+    amountUsdc: number;
+    slotsTotal: number;
+    slotsRemaining: number;
+    feeBps: number;
+    specHash: string;
+    openUntilMs: number;
+    slaMs: number;
+    reviewWindowMs: number;
+    rejectSplitBps: number;
+    claimPolicy: number;
+    minSellerLevel: number;
+    maxClaimsPerAgent: number;
+    /** Object id of the on-chain `claims_by_agent` Table (per-agent counts
+     *  live as its dynamic fields — see `getBatchClaimsByAgent`). */
+    claimsTableId: string | null;
+    createdAtMs: number;
+}
+/** Read one BatchOpening by object id (null = not a batch / gone). A
+ *  drained or cancelled batch still resolves (`slotsRemaining: 0`) — the
+ *  object persists in v1; existence is NOT the state. */
+declare function getBatchOpening(client: SuiCoreClient, batchId: string): Promise<BatchOpening | null>;
+/** Slots `agent` already claimed of this batch — best-effort read of the
+ *  on-chain Table entry (0 on miss/hiccup; Move enforces the real limit). */
+declare function getBatchClaimsByAgent(client: SuiCoreClient, batch: BatchOpening, agent: string): Promise<number>;
+/** English preflight for a batch claim — the wave gates first (slots,
+ *  per-agent limit), then the exact single-claim stack (policy → active
+ *  cap → level floor via `preflightClaimOpening`). */
+declare function preflightBatchClaim(score: AgentScore | null, batch: {
+    claimPolicy: number;
+    minSellerLevel?: number;
+    slotsRemaining: number;
+    maxClaimsPerAgent: number;
+}, myClaims: number): {
+    valid: boolean;
+    error?: string;
+};
+
 declare const DEFAULT_COMMERCE_API_BASE = "https://api.t2000.ai/v1";
 /** The shape the API returns from GET /v1/services. */
 interface ServiceListing {
@@ -2037,4 +2127,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 { STABLE_ASSETS 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, OPENING_CLAIM_POLICY_PROVEN as F, GAS_RESERVE_MIN as G, OPENING_CLAIM_POLICY_PROVEN_4STAR 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, OPENING_CLAIM_POLICIES as O, OVERLAY_FEE_RATE as P, type OverlayFeeConfig as Q, PREFLIGHT_MAX_AMOUNT as R, PREFLIGHT_OK as S, PROVEN_MIN_AVG_STARS_X10 as T, PROVEN_MIN_REVIEWS as U, type PayOptions as V, type PayResult as W, type PreflightResult as X, REVIEW_MAX_STARS as Y, REVIEW_MIN_STARS as Z, SELLER_LEVEL_ACTIVE_CAPS as _, A2A_ESCROW_PACKAGE_ID as a, getDecimalsForCoinType as a$, SUI_DECIMALS as a0, SUI_TYPE as a1, SUPPORTED_ASSETS as a2, type SellerLevel as a3, type SendAssetClass as a4, type SendResult as a5, type ServiceListing as a6, type SimulationResult as a7, type StableAsset as a8, type SuiHolding as a9, buildRejectJobTx as aA, buildReleaseJobTx as aB, buildSendTx as aC, buildSwapTx as aD, checkPositiveAmount as aE, checkSuiAddress as aF, claimPolicyLabel as aG, claimPolicyRequirement as aH, classifyAction as aI, classifyLabel as aJ, classifySendAsset as aK, classifyTransaction as aL, deriveAgentScoreId as aM, effectiveSellerLevel as aN, executeTx as aO, extractAllUserLegs as aP, extractTransferDetails as aQ, extractTxCommands as aR, extractTxSender as aS, fallbackLabel as aT, fetchService as aU, findSwapRoute as aV, formatAssetAmount as aW, formatSui as aX, formatUsd as aY, getAgentScore as aZ, getDecimals as a_, type SuiRpcTxBlock as aa, type SupportedAsset as ab, type SwapRouteResult as ac, T2000Error as ad, type T2000ErrorCode as ae, type T2000ErrorData as af, T2000_OVERLAY_FEE_WALLET as ag, TOKEN_MAP as ah, type TransactionLeg as ai, type TransactionRecord as aj, type TransactionSigner as ak, type TxDirection as al, USDC_DECIMALS as am, USDC_TYPE as an, USDE_TYPE as ao, USDSUI_TYPE as ap, USDT_TYPE as aq, WAL_TYPE as ar, WBTC_TYPE as as, type X402ActivityPayload as at, type ZkLoginProof as au, ZkLoginSigner as av, activeCapForLevel as aw, buildCreateJobTx as ax, buildDeliverJobTx as ay, buildRefundJobTx as az, type ActivityReportConfig as b, type Opening as b$, getJob as b0, getJobSpec as b1, invalidSendAssetMessage as b2, jobActionsFor as b3, listServices as b4, mapMoveAbortCode as b5, mapWalletError as b6, meetsClaimPolicy as b7, meetsMinSellerLevel as b8, mistToSui as b9, type SwapResult as bA, type SwapQuoteResult as bB, type PaymentRequest as bC, type SuiCoreClient as bD, type SponsoredCoinMergeCache as bE, type SendableAsset as bF, A2A_ESCROW_LATEST_PACKAGE_ID as bG, A2A_ESCROW_OPENING_PACKAGE_ID as bH, A2A_ESCROW_PACKAGE_V10_ID as bI, A2A_ESCROW_PACKAGE_V2_ID as bJ, A2A_ESCROW_PACKAGE_V3_ID as bK, A2A_ESCROW_PACKAGE_V6_ID as bL, A2A_ESCROW_PACKAGE_V7_ID as bM, A2A_ESCROW_PACKAGE_V8_ID as bN, A2A_SCORE_BOARD_ID as bO, type ApiRouteListing as bP, CETUS_USDC_SUI_POOL as bQ, type CoinPage as bR, DEFAULT_GRPC_URL as bS, GASLESS_MIN_STABLE_AMOUNT as bT, GASLESS_STABLE_TYPES as bU, MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID as bV, MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID as bW, MAINNET_A2A_ESCROW_PACKAGE_ID as bX, MAINNET_A2A_SCORE_BOARD_ID as bY, MAX_OPEN_WINDOW_MS as bZ, OPERATION_ASSETS as b_, parseSuiRpcTx as ba, payWithX402 as bb, preflightClaimOpening as bc, preflightCreateJob as bd, preflightFail as be, preflightPay as bf, preflightSend as bg, preflightSwap as bh, putJobSpec as bi, rawToStable as bj, rawToUsdc as bk, refineLendingLabel as bl, reportX402Activity as bm, resolveSymbol as bn, resolveTokenType as bo, sellerLevel as bp, sellerLevelLabel as bq, stableToRaw as br, suiToMist as bs, truncateAddress as bt, usdcToRaw as bu, validateAddress as bv, verifyJobForSeller as bw, type T2000Options as bx, type X402Probe as by, type SerializedCetusRoute as bz, type AgentScore as c, type OpeningTerms as c0, type Operation as c1, SENDABLE_ASSETS as c2, type SelectAndSplitResult as c3, type SerializedCetusRoutePath as c4, type SerializedRouterDataV3 as c5, type ServicesRail as c6, type ServicesRow as c7, addSendToTx as c8, addSwapToTx as c9, selectSuiCoin as cA, serializeCetusRoute as cB, simulateTransaction as cC, throwIfSimulationFailed as cD, verifyCetusRouteCoinMatch as cE, assertAllowedAsset as ca, assertBuyerRequirements as cb, buildCancelOpeningTx as cc, buildClaimOpeningTx as cd, buildCreateEmptyScoreTx as ce, buildCreateOpeningTx as cf, buildDeclineJobTx as cg, buildRefundUnclaimedTx as ch, buildSubmitFirstReviewTx as ci, buildSubmitReviewTx as cj, deserializeCetusRoute as ck, fetchAllCoins as cl, getCoinMeta as cm, getOpening as cn, getSuiClient as co, getSuiGrpcClient as cp, isAllowedAsset as cq, isCetusRouteFresh as cr, isInRegistry as cs, normalizeAsset as ct, normalizeCoinType as cu, preflightCreateOpening as cv, probeX402 as cw, queryHistory as cx, queryTransaction as cy, selectAndSplitCoin as cz, COIN_REGISTRY as d, type ClassifyBalanceChange as e, type ClassifyResult as f, type CoinMeta as g, DEFAULT_COMMERCE_API_BASE as h, DEFAULT_NETWORK as i, type DepositInfo as j, type ExtractedTransfer as k, type Job as l, type JobState as m, type JobTerms as n, type JobVerification as o, KeypairSigner as p, LEVEL4_MAX_NO_DELIVERY as q, LEVEL4_MIN_REVIEWS as r, LOFI_TYPE as s, MAX_DELIVER_HORIZON_MS as t, MAX_JOB_USDC as u, MAX_REVIEW_WINDOW_MS as v, MIN_JOB_USDC as w, MIST_PER_SUI as x, NO_DELIVERY_REGRESSION_FLOOR as y, OPENING_CLAIM_POLICY_ANY_ACTIVE as z };
+export { type PreflightResult as $, A2A_ESCROW_FEE_CONFIG_ID as A, BATCH_OPENING_TYPE_MARKER as B, CLOCK_ID as C, DEFAULT_ACTIVITY_REPORT_URL as D, ETH_TYPE as E, MIN_JOB_USDC as F, GAS_RESERVE_MIN as G, MIST_PER_SUI 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, NO_DELIVERY_REGRESSION_FLOOR as O, OPENING_CLAIM_POLICIES as P, OPENING_CLAIM_POLICY_ANY_ACTIVE as Q, OPENING_CLAIM_POLICY_PROVEN as R, OPENING_CLAIM_POLICY_PROVEN_4STAR as S, OVERLAY_FEE_RATE as T, type OverlayFeeConfig as U, PREFLIGHT_MAX_AMOUNT as V, PREFLIGHT_OK as W, PROVEN_MIN_AVG_STARS_X10 as X, PROVEN_MIN_REVIEWS as Y, type PayOptions as Z, type PayResult as _, A2A_ESCROW_PACKAGE_ID as a, fallbackLabel as a$, REVIEW_MAX_STARS as a0, REVIEW_MIN_STARS as a1, SELLER_LEVEL_ACTIVE_CAPS as a2, STABLE_ASSETS as a3, SUI_DECIMALS as a4, SUI_TYPE as a5, SUPPORTED_ASSETS as a6, type SellerLevel as a7, type SendAssetClass as a8, type SendResult as a9, activeCapForLevel as aA, buildBatchClaimTx as aB, buildCancelBatchOpeningTx as aC, buildCreateBatchOpeningTx as aD, buildCreateJobTx as aE, buildDeliverJobTx as aF, buildRefundBatchExpiredTx as aG, buildRefundJobTx as aH, buildRejectJobTx as aI, buildReleaseJobTx as aJ, buildSendTx as aK, buildSwapTx as aL, checkPositiveAmount as aM, checkSuiAddress as aN, claimPolicyLabel as aO, claimPolicyRequirement as aP, classifyAction as aQ, classifyLabel as aR, classifySendAsset as aS, classifyTransaction as aT, deriveAgentScoreId as aU, effectiveSellerLevel as aV, executeTx as aW, extractAllUserLegs as aX, extractTransferDetails as aY, extractTxCommands as aZ, extractTxSender as a_, type ServiceListing as aa, type SimulationResult as ab, type StableAsset as ac, type SuiHolding as ad, type SuiRpcTxBlock as ae, type SupportedAsset as af, type SwapRouteResult as ag, T2000Error as ah, type T2000ErrorCode as ai, type T2000ErrorData as aj, T2000_OVERLAY_FEE_WALLET as ak, TOKEN_MAP as al, type TransactionLeg as am, type TransactionRecord as an, type TransactionSigner as ao, type TxDirection as ap, USDC_DECIMALS as aq, USDC_TYPE as ar, USDE_TYPE as as, USDSUI_TYPE as at, USDT_TYPE as au, WAL_TYPE as av, WBTC_TYPE as aw, type X402ActivityPayload as ax, type ZkLoginProof as ay, ZkLoginSigner as az, type ActivityReportConfig as b, A2A_SCORE_BOARD_ID as b$, fetchService as b0, findSwapRoute as b1, formatAssetAmount as b2, formatSui as b3, formatUsd as b4, getAgentScore as b5, getBatchClaimsByAgent as b6, getBatchOpening as b7, getDecimals as b8, getDecimalsForCoinType as b9, resolveTokenType as bA, sellerLevel as bB, sellerLevelLabel as bC, stableToRaw as bD, suiToMist as bE, truncateAddress as bF, usdcToRaw as bG, validateAddress as bH, verifyJobForSeller as bI, type T2000Options as bJ, type X402Probe as bK, type SerializedCetusRoute as bL, type SwapResult as bM, type SwapQuoteResult as bN, type PaymentRequest as bO, type SuiCoreClient as bP, type SponsoredCoinMergeCache as bQ, type SendableAsset as bR, A2A_ESCROW_LATEST_PACKAGE_ID as bS, A2A_ESCROW_OPENING_PACKAGE_ID as bT, A2A_ESCROW_PACKAGE_V10_ID as bU, A2A_ESCROW_PACKAGE_V11_ID as bV, A2A_ESCROW_PACKAGE_V2_ID as bW, A2A_ESCROW_PACKAGE_V3_ID as bX, A2A_ESCROW_PACKAGE_V6_ID as bY, A2A_ESCROW_PACKAGE_V7_ID as bZ, A2A_ESCROW_PACKAGE_V8_ID as b_, getJob as ba, getJobSpec as bb, invalidSendAssetMessage as bc, jobActionsFor as bd, listServices as be, mapMoveAbortCode as bf, mapWalletError as bg, meetsClaimPolicy as bh, meetsMinSellerLevel as bi, mistToSui as bj, parseSuiRpcTx as bk, payWithX402 as bl, preflightBatchClaim as bm, preflightClaimOpening as bn, preflightCreateBatchOpening as bo, preflightCreateJob as bp, preflightFail as bq, preflightPay as br, preflightSend as bs, preflightSwap as bt, putJobSpec as bu, rawToStable as bv, rawToUsdc as bw, refineLendingLabel as bx, reportX402Activity as by, resolveSymbol as bz, type AgentScore as c, type ApiRouteListing as c0, CETUS_USDC_SUI_POOL as c1, type CoinPage as c2, DEFAULT_GRPC_URL as c3, GASLESS_MIN_STABLE_AMOUNT as c4, GASLESS_STABLE_TYPES as c5, MAINNET_A2A_ESCROW_LATEST_PACKAGE_ID as c6, MAINNET_A2A_ESCROW_OPENING_PACKAGE_ID as c7, MAINNET_A2A_ESCROW_PACKAGE_ID as c8, MAINNET_A2A_SCORE_BOARD_ID as c9, getOpening as cA, getSuiClient as cB, getSuiGrpcClient as cC, isAllowedAsset as cD, isCetusRouteFresh as cE, isInRegistry as cF, normalizeAsset as cG, normalizeCoinType as cH, preflightCreateOpening as cI, probeX402 as cJ, queryHistory as cK, queryTransaction as cL, selectAndSplitCoin as cM, selectSuiCoin as cN, serializeCetusRoute as cO, simulateTransaction as cP, throwIfSimulationFailed as cQ, verifyCetusRouteCoinMatch as cR, MAX_OPEN_WINDOW_MS as ca, OPERATION_ASSETS as cb, type Opening as cc, type OpeningTerms as cd, type Operation as ce, SENDABLE_ASSETS as cf, type SelectAndSplitResult as cg, type SerializedCetusRoutePath as ch, type SerializedRouterDataV3 as ci, type ServicesRail as cj, type ServicesRow as ck, addSendToTx as cl, addSwapToTx as cm, assertAllowedAsset as cn, assertBuyerRequirements as co, buildCancelOpeningTx as cp, buildClaimOpeningTx as cq, buildCreateEmptyScoreTx as cr, buildCreateOpeningTx as cs, buildDeclineJobTx as ct, buildRefundUnclaimedTx as cu, buildSubmitFirstReviewTx as cv, buildSubmitReviewTx as cw, deserializeCetusRoute as cx, fetchAllCoins as cy, getCoinMeta as cz, type BalanceResponse as d, type BatchOpening as e, type BatchOpeningTerms as f, COIN_REGISTRY as g, type ClassifyBalanceChange as h, type ClassifyResult as i, type CoinMeta as j, DEFAULT_COMMERCE_API_BASE as k, DEFAULT_NETWORK as l, type DepositInfo as m, type ExtractedTransfer as n, type Job as o, type JobState as p, type JobTerms as q, type JobVerification as r, KeypairSigner as s, LEVEL4_MAX_NO_DELIVERY as t, LEVEL4_MIN_REVIEWS as u, LOFI_TYPE as v, MAX_BATCH_SLOTS_DEFAULT as w, MAX_DELIVER_HORIZON_MS as x, MAX_JOB_USDC as y, MAX_REVIEW_WINDOW_MS as z };