@t2000/sdk 9.6.0 → 9.7.0

package/dist/index.cjs

@@ -3131,6 +3131,209 @@ var T2000 = class _T2000 extends eventemitter3.EventEmitter {
 
 // src/index.ts
 init_errors();
+
+// src/wallet/job.ts
+init_errors();
+init_token_registry();
+init_preflight();
+init_coinSelection();
+var A2A_ESCROW_PACKAGE_ID = process.env.A2A_ESCROW_PACKAGE_ID ?? "0x9e67c380fb7079d793d6d15ff916b24d82779d7119bfa4631863102ed485c0a0";
+var CLOCK_ID2 = "0x6";
+var MODULE = "escrow";
+var MAX_JOB_USDC = 50;
+var JOB_STATES = [
+  "funded",
+  "delivered",
+  "released",
+  "refunded",
+  "rejected"
+];
+function hexToBytes2(hex) {
+  const clean = hex.startsWith("0x") ? hex.slice(2) : hex;
+  if (clean.length === 0 || clean.length % 2 !== 0 || /[^0-9a-fA-F]/.test(clean)) {
+    throw new exports.T2000Error(
+      "INVALID_AMOUNT",
+      `Expected a hex hash (0x\u2026), got "${hex.slice(0, 32)}"`
+    );
+  }
+  const out = [];
+  for (let i = 0; i < clean.length; i += 2) {
+    out.push(Number.parseInt(clean.slice(i, i + 2), 16));
+  }
+  return out;
+}
+function bytesToHex2(bytes) {
+  let s = "0x";
+  for (const b of bytes) s += b.toString(16).padStart(2, "0");
+  return s;
+}
+function preflightCreateJob(terms) {
+  const addressCheck = checkSuiAddress(terms.seller);
+  if (!addressCheck.valid) return addressCheck;
+  if (!Number.isFinite(terms.amountUsdc) || terms.amountUsdc <= 0) {
+    return preflightFail("INVALID_AMOUNT", `Amount must be positive. Got ${terms.amountUsdc}.`);
+  }
+  if (terms.amountUsdc > MAX_JOB_USDC) {
+    return preflightFail(
+      "INVALID_AMOUNT",
+      `v1 caps escrow jobs at ${MAX_JOB_USDC} USDC (no-arbitration split only stays fair at small sizes). Got ${terms.amountUsdc}.`
+    );
+  }
+  if (terms.deliverByMs <= Date.now()) {
+    return preflightFail("INVALID_AMOUNT", "deliverByMs must be in the future.");
+  }
+  if (terms.reviewWindowMs < 0) {
+    return preflightFail("INVALID_AMOUNT", "reviewWindowMs must be \u2265 0.");
+  }
+  if (!Number.isInteger(terms.rejectSplitBps) || terms.rejectSplitBps < 0 || terms.rejectSplitBps > 1e4) {
+    return preflightFail("INVALID_AMOUNT", "rejectSplitBps must be an integer 0\u201310000.");
+  }
+  try {
+    hexToBytes2(terms.specHash);
+  } catch (e) {
+    return preflightFail("INVALID_AMOUNT", e.message);
+  }
+  return exports.PREFLIGHT_OK;
+}
+async function buildCreateJobTx({
+  client,
+  buyer,
+  terms
+}) {
+  const pf = preflightCreateJob(terms);
+  if (!pf.valid) throw new exports.T2000Error(pf.code, pf.error);
+  const seller = validateAddress(terms.seller);
+  if (seller === validateAddress(buyer)) {
+    throw new exports.T2000Error("INVALID_ADDRESS", "Buyer and seller must be different wallets.");
+  }
+  const rawAmount = BigInt(Math.floor(terms.amountUsdc * 10 ** USDC_DECIMALS));
+  const tx = new transactions.Transaction();
+  const { coin } = await selectAndSplitCoin(tx, client, buyer, exports.USDC_TYPE, rawAmount, {
+    allowSwapAll: false
+  });
+  tx.moveCall({
+    target: `${A2A_ESCROW_PACKAGE_ID}::${MODULE}::create`,
+    typeArguments: [exports.USDC_TYPE],
+    arguments: [
+      tx.pure.address(seller),
+      coin,
+      tx.pure.vector("u8", hexToBytes2(terms.specHash)),
+      tx.pure.u64(terms.deliverByMs),
+      tx.pure.u64(terms.reviewWindowMs),
+      tx.pure.u64(terms.rejectSplitBps),
+      tx.object(CLOCK_ID2)
+    ]
+  });
+  return tx;
+}
+function jobCall(jobId, fn) {
+  const tx = new transactions.Transaction();
+  tx.moveCall({
+    target: `${A2A_ESCROW_PACKAGE_ID}::${MODULE}::${fn}`,
+    typeArguments: [exports.USDC_TYPE],
+    arguments: [tx.object(jobId), tx.object(CLOCK_ID2)]
+  });
+  return tx;
+}
+function buildDeliverJobTx(jobId, deliveryHash) {
+  const tx = new transactions.Transaction();
+  tx.moveCall({
+    target: `${A2A_ESCROW_PACKAGE_ID}::${MODULE}::deliver`,
+    typeArguments: [exports.USDC_TYPE],
+    arguments: [
+      tx.object(jobId),
+      tx.pure.vector("u8", hexToBytes2(deliveryHash)),
+      tx.object(CLOCK_ID2)
+    ]
+  });
+  return tx;
+}
+function buildReleaseJobTx(jobId) {
+  return jobCall(jobId, "release");
+}
+function buildRejectJobTx(jobId) {
+  return jobCall(jobId, "reject");
+}
+function buildRefundJobTx(jobId) {
+  return jobCall(jobId, "refund");
+}
+async function getJob(client, jobId) {
+  const resp = await client.core.getObject({ objectId: jobId, include: { json: true } }).catch((e) => {
+    throw new exports.T2000Error(
+      "RPC_ERROR",
+      `Job ${jobId} not found: ${e instanceof Error ? e.message : String(e)}`
+    );
+  });
+  const objType = resp.object?.type ?? "";
+  const json = resp.object?.json;
+  if (!json || !objType.includes(`::${MODULE}::Job<`)) {
+    throw new exports.T2000Error("RPC_ERROR", `Object ${jobId} is not an a2a_escrow Job.`);
+  }
+  const stateNum = Number(json.state ?? -1);
+  const state = JOB_STATES[stateNum];
+  if (!state) {
+    throw new exports.T2000Error("RPC_ERROR", `Job ${jobId} has unknown state ${stateNum}.`);
+  }
+  const deliveredAtMs = Number(json.delivered_at_ms ?? 0);
+  const deliveryBytes = json.delivery_hash ?? [];
+  const hasDelivery = deliveredAtMs > 0;
+  return {
+    id: jobId,
+    buyer: String(json.buyer),
+    seller: String(json.seller),
+    amountUsdc: Number(json.amount) / 10 ** USDC_DECIMALS,
+    escrowUsdc: Number(json.escrow) / 10 ** USDC_DECIMALS,
+    specHash: bytesToHex2(json.spec_hash ?? []),
+    deliverByMs: Number(json.deliver_by_ms),
+    reviewWindowMs: Number(json.review_window_ms),
+    rejectSplitBps: Number(json.reject_split_bps),
+    state,
+    deliveryHash: hasDelivery ? bytesToHex2(deliveryBytes) : null,
+    deliveredAtMs: hasDelivery ? deliveredAtMs : null,
+    createdAtMs: Number(json.created_at_ms)
+  };
+}
+function jobActionsFor(job, caller, nowMs = Date.now()) {
+  const me = validateAddress(caller);
+  const isBuyer = me === job.buyer;
+  const isSeller = me === job.seller;
+  const actions = [];
+  if (job.state === "funded") {
+    if (isSeller && nowMs <= job.deliverByMs) actions.push("deliver");
+    if (isBuyer) actions.push("release");
+    if (nowMs > job.deliverByMs) actions.push("refund");
+  } else if (job.state === "delivered") {
+    const windowClosesMs = (job.deliveredAtMs ?? 0) + job.reviewWindowMs;
+    if (isBuyer && nowMs <= windowClosesMs) actions.push("release", "reject");
+    if (nowMs > windowClosesMs) actions.push("release");
+  }
+  return actions;
+}
+async function verifyJobForSeller({
+  client,
+  jobId,
+  seller,
+  minAmountUsdc,
+  minRunwayMs = 6e4
+}) {
+  const job = await getJob(client, jobId);
+  const problems = [];
+  if (job.state !== "funded") {
+    problems.push(`state is "${job.state}", expected "funded"`);
+  }
+  if (job.seller !== validateAddress(seller)) {
+    problems.push(`job pays ${job.seller}, not this seller`);
+  }
+  if (job.escrowUsdc < minAmountUsdc) {
+    problems.push(`escrow holds ${job.escrowUsdc} USDC, price is ${minAmountUsdc}`);
+  }
+  if (job.deliverByMs - Date.now() < minRunwayMs) {
+    problems.push("deadline too close to accept");
+  }
+  return { ok: problems.length === 0, job, problems };
+}
+
+// src/index.ts
 init_coinSelection();
 
 // src/composeTx.ts
@@ -3554,6 +3757,7 @@ function displayHandle(label, parentName = AUDRIC_PARENT_NAME) {
 // src/index.ts
 init_preflight();
 
+exports.A2A_ESCROW_PACKAGE_ID = A2A_ESCROW_PACKAGE_ID;
 exports.AGENT_ID_PARENT = AGENT_ID_PARENT;
 exports.AGENT_ID_PARENT_NAME = AGENT_ID_PARENT_NAME;
 exports.AGENT_ID_PARENT_NFT_ID = AGENT_ID_PARENT_NFT_ID;
@@ -3569,11 +3773,13 @@ exports.GASLESS_MIN_STABLE_AMOUNT = GASLESS_MIN_STABLE_AMOUNT;
 exports.GASLESS_STABLE_TYPES = GASLESS_STABLE_TYPES;
 exports.GAS_RESERVE_MIN = GAS_RESERVE_MIN;
 exports.InvalidAddressError = InvalidAddressError;
+exports.JOB_STATES = JOB_STATES;
 exports.KNOWN_TARGETS = KNOWN_TARGETS;
 exports.KeypairSigner = KeypairSigner;
 exports.LABEL_PATTERNS = LABEL_PATTERNS;
 exports.LimitEnforcer = LimitEnforcer;
 exports.LimitExceededError = LimitExceededError;
+exports.MAX_JOB_USDC = MAX_JOB_USDC;
 exports.MIST_PER_SUI = MIST_PER_SUI;
 exports.OPERATION_ASSETS = OPERATION_ASSETS;
 exports.SENDABLE_ASSETS = SENDABLE_ASSETS;
@@ -3597,6 +3803,11 @@ exports.approxUsdValue = approxUsdValue;
 exports.assertAllowedAsset = assertAllowedAsset;
 exports.assertLimitConfig = assertLimitConfig;
 exports.buildAddLeafTx = buildAddLeafTx;
+exports.buildCreateJobTx = buildCreateJobTx;
+exports.buildDeliverJobTx = buildDeliverJobTx;
+exports.buildRefundJobTx = buildRefundJobTx;
+exports.buildRejectJobTx = buildRejectJobTx;
+exports.buildReleaseJobTx = buildReleaseJobTx;
 exports.buildRevokeLeafTx = buildRevokeLeafTx;
 exports.buildSendTx = buildSendTx;
 exports.buildSwapTx = buildSwapTx;
@@ -3631,6 +3842,7 @@ exports.getAddress = getAddress;
 exports.getCoinMeta = getCoinMeta;
 exports.getDecimals = getDecimals;
 exports.getDecimalsForCoinType = getDecimalsForCoinType;
+exports.getJob = getJob;
 exports.getLimits = getLimits;
 exports.getSponsoredSwapProviders = getSponsoredSwapProviders;
 exports.getSuiClient = getSuiClient;
@@ -3640,6 +3852,7 @@ exports.hasLimits = hasLimits;
 exports.isAllowedAsset = isAllowedAsset;
 exports.isCetusRouteFresh = isCetusRouteFresh;
 exports.isInRegistry = isInRegistry;
+exports.jobActionsFor = jobActionsFor;
 exports.keypairFromPrivateKey = keypairFromPrivateKey;
 exports.listModels = listModels;
 exports.loadKey = loadKey;
@@ -3653,6 +3866,7 @@ exports.normalizeCoinType = normalizeCoinType;
 exports.parseMppSuiChallenge = parseMppSuiChallenge;
 exports.parseSuiRpcTx = parseSuiRpcTx;
 exports.payWithMpp = payWithMpp;
+exports.preflightCreateJob = preflightCreateJob;
 exports.preflightFail = preflightFail;
 exports.preflightPay = preflightPay;
 exports.preflightSend = preflightSend;
@@ -3684,6 +3898,7 @@ exports.usdcToRaw = usdcToRaw;
 exports.validateAddress = validateAddress;
 exports.validateLabel = validateLabel;
 exports.verifyCetusRouteCoinMatch = verifyCetusRouteCoinMatch;
+exports.verifyJobForSeller = verifyJobForSeller;
 exports.verifyReceipt = verifyReceipt;
 exports.walletExists = walletExists;
 exports.writeLimitsFile = writeLimitsFile;