@t2000/sdk 9.12.0 → 9.13.0

package/README.md

@@ -31,6 +31,8 @@ await agent.pay({ url: 'https://mpp.t2000.ai/openai/v1/chat/completions', method
 
 USDC + USDsui sends and x402 USDC payments are gasless (Sui foundation's `0x2::balance::send_funds` sponsor). SUI sends and Cetus swaps need gas — keep ~0.05 SUI on hand.
 
+The SDK also ships the **escrow-job builders** for agent-to-agent deliverable work (`t2000::a2a_escrow` on Sui mainnet): `buildCreateJobTx` / `buildDeliverJobTx` / `buildReleaseJobTx` / `buildRejectJobTx` / `buildRefundJobTx`, plus `getJob`, `jobActionsFor`, and `verifyJobForSeller`. 2.5% protocol fee on the seller payout at settlement; refunds fee-free.
+
 ## Full reference
 
 Factory methods, full API surface, supported assets, Cetus swap routing, x402 payments, error handling, architecture →

package/dist/browser.cjs

@@ -1310,6 +1310,18 @@ async function buildSendTx({
       required: amount
     });
   }
+  if (asset === "USDC" || asset === "USDsui") {
+    const rawFloor = displayToRaw(GASLESS_MIN_STABLE_AMOUNT, assetInfo.decimals);
+    const remainder = totalBalance - rawAmount;
+    if (remainder > 0n && remainder < rawFloor) {
+      const total = Number(totalBalance) / 10 ** assetInfo.decimals;
+      throw new exports.T2000Error(
+        "INVALID_AMOUNT",
+        `Gasless ${asset} transfers must send the entire balance or leave at least ${GASLESS_MIN_STABLE_AMOUNT} ${asset}. Sending ${amount} of ${total} leaves ${(total - amount).toFixed(assetInfo.decimals)}. Send ${total} (everything) or at most ${(total - GASLESS_MIN_STABLE_AMOUNT).toFixed(assetInfo.decimals)}.`,
+        { available: total, required: amount }
+      );
+    }
+  }
   if (asset === "SUI") {
     const [sendCoin] = tx.splitCoins(tx.gas, [rawAmount]);
     tx.transferObjects([sendCoin], recipient);
@@ -1547,12 +1559,88 @@ async function verifyJobForSeller({
   return { ok: problems.length === 0, job, problems };
 }
 
+// src/commerce.ts
+var DEFAULT_COMMERCE_API_BASE = "https://api.t2000.ai/v1";
+async function commerceFetchJson(url, init) {
+  const res = await fetch(url, {
+    method: init?.method ?? "GET",
+    headers: init?.body ? { "Content-Type": "application/json" } : void 0,
+    body: init?.body ? JSON.stringify(init.body) : void 0
+  });
+  const json = await res.json().catch(() => ({}));
+  if (!res.ok) {
+    const err = json.error;
+    const msg = typeof err === "string" ? err : err?.message ?? `HTTP ${res.status}`;
+    throw new Error(msg);
+  }
+  return json;
+}
+async function listOfferings(base, filter = {}) {
+  const params = new URLSearchParams();
+  if (filter.agent) params.set("agent", filter.agent);
+  if (filter.query) params.set("q", filter.query);
+  const qs = params.size > 0 ? `?${params.toString()}` : "";
+  const json = await commerceFetchJson(`${base}/offerings${qs}`);
+  const offerings = json.offerings ?? [];
+  return { total: json.total ?? offerings.length, offerings };
+}
+async function fetchOffering(base, agent, slug) {
+  const { offerings: rows } = await listOfferings(base, { agent });
+  const match = rows.find((o) => o.slug === slug.trim().toLowerCase());
+  if (!match) {
+    const live = rows.filter((o) => !o.retired).map((o) => o.slug);
+    throw new Error(
+      `Agent ${truncateAddress(agent)} has no offering "${slug}".` + (live.length > 0 ? ` Live offerings: ${live.join(", ")}` : "")
+    );
+  }
+  if (match.retired) {
+    throw new Error(
+      `Offering "${slug}" is retired \u2014 the seller no longer sells it.`
+    );
+  }
+  return match;
+}
+async function sha256Hex(content) {
+  const digest = await crypto.subtle.digest(
+    "SHA-256",
+    new TextEncoder().encode(content)
+  );
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+async function putJobSpec(base, content) {
+  const json = await commerceFetchJson(`${base}/job/spec`, {
+    method: "POST",
+    body: { content }
+  });
+  const hash = json.hash;
+  if (!hash) {
+    throw new Error("Failed to store the job spec.");
+  }
+  return hash;
+}
+async function getJobSpec(base, hash) {
+  const clean = hash.trim().toLowerCase().replace(/^0x/, "");
+  const json = await commerceFetchJson(`${base}/job/spec/${clean}`);
+  const content = json.content;
+  if (content === void 0) {
+    throw new Error("No spec stored for this hash.");
+  }
+  const actual = await sha256Hex(content);
+  if (actual !== clean) {
+    throw new Error(
+      "Spec content does NOT match its hash \u2014 the store returned tampered data. Do not trust it."
+    );
+  }
+  return content;
+}
+
 // src/browser.ts
 init_token_registry();
 
 exports.A2A_ESCROW_FEE_CONFIG_ID = A2A_ESCROW_FEE_CONFIG_ID;
 exports.A2A_ESCROW_PACKAGE_ID = A2A_ESCROW_PACKAGE_ID;
 exports.CLOCK_ID = CLOCK_ID;
+exports.DEFAULT_COMMERCE_API_BASE = DEFAULT_COMMERCE_API_BASE;
 exports.DEFAULT_NETWORK = DEFAULT_NETWORK;
 exports.GAS_RESERVE_MIN = GAS_RESERVE_MIN;
 exports.JOB_STATES = JOB_STATES;
@@ -1590,6 +1678,7 @@ exports.extractTransferDetails = extractTransferDetails;
 exports.extractTxCommands = extractTxCommands;
 exports.extractTxSender = extractTxSender;
 exports.fallbackLabel = fallbackLabel;
+exports.fetchOffering = fetchOffering;
 exports.findSwapRoute = findSwapRoute;
 exports.formatAssetAmount = formatAssetAmount;
 exports.formatSui = formatSui;
@@ -1598,7 +1687,9 @@ exports.fromBase64 = fromBase642;
 exports.getDecimals = getDecimals;
 exports.getDecimalsForCoinType = getDecimalsForCoinType;
 exports.getJob = getJob;
+exports.getJobSpec = getJobSpec;
 exports.jobActionsFor = jobActionsFor;
+exports.listOfferings = listOfferings;
 exports.mapMoveAbortCode = mapMoveAbortCode;
 exports.mapWalletError = mapWalletError;
 exports.mistToSui = mistToSui;
@@ -1610,6 +1701,7 @@ exports.preflightFail = preflightFail;
 exports.preflightPay = preflightPay;
 exports.preflightSend = preflightSend;
 exports.preflightSwap = preflightSwap;
+exports.putJobSpec = putJobSpec;
 exports.rawToStable = rawToStable;
 exports.rawToUsdc = rawToUsdc;
 exports.refineLendingLabel = refineLendingLabel;