@cmdoss/suipay 0.1.1-dev.7 → 0.1.1-dev.9

package/dist/index.js

@@ -1752,6 +1752,33 @@ function decodeSponsorGasPayment(encoded) {
     return { objectId: bits[0], version: bits[1], digest: bits[2] };
   });
 }
+var SPONSOR_GAS_ADDRESS_BALANCE = "address-balance";
+function decodeSponsorGasPin(encoded) {
+  if (encoded === SPONSOR_GAS_ADDRESS_BALANCE)
+    return [];
+  return decodeSponsorGasPayment(encoded);
+}
+var ADDRESS_BALANCE_VALIDITY_EPOCHS = 1n;
+function addressBalanceGasExpiration(input) {
+  const chain = input.chainIdentifier.trim();
+  if (!chain)
+    throw new Error("address-balance gas needs a chain identifier");
+  if (input.epoch < 0n)
+    throw new Error("address-balance gas needs a non-negative epoch");
+  if (!Number.isInteger(input.nonce) || input.nonce < 0 || input.nonce > 4294967295) {
+    throw new Error("address-balance gas nonce must be a u32");
+  }
+  return {
+    ValidDuring: {
+      minEpoch: String(input.epoch),
+      maxEpoch: String(input.epoch + ADDRESS_BALANCE_VALIDITY_EPOCHS),
+      minTimestamp: null,
+      maxTimestamp: null,
+      chain,
+      nonce: input.nonce
+    }
+  };
+}
 
 // ../sdk/dist/protocol/mpp.js
 function offerToBase64Url(offer) {
@@ -4381,7 +4408,7 @@ function readX402GasPin(offer) {
       owner,
       budget,
       price,
-      payment: decodeSponsorGasPayment(offer.sponsorGasPayment ?? "")
+      payment: decodeSponsorGasPin(offer.sponsorGasPayment ?? "")
     };
   } catch {
     return null;
@@ -4395,16 +4422,33 @@ async function buildSpendAccountX402PayTx(input) {
   tx.setGasBudget(input.gas.budget);
   tx.setGasPrice(input.gas.price);
   tx.setGasPayment(input.gas.payment);
-  tx.setExpiration({ Epoch: String(input.currentEpoch + X402_EXPIRATION_EPOCHS) });
+  if (input.gas.payment.length === 0) {
+    if (!input.chainIdentifier) {
+      throw new Error("address-balance sponsor gas needs a chain identifier");
+    }
+    tx.setExpiration(addressBalanceGasExpiration({
+      epoch: input.currentEpoch,
+      chainIdentifier: input.chainIdentifier,
+      nonce: input.nonce ?? randomU32()
+    }));
+  } else {
+    tx.setExpiration({ Epoch: String(input.currentEpoch + X402_EXPIRATION_EPOCHS) });
+  }
   const txBytes = toBase645(await tx.build());
   return { txBytes, kindBytes };
 }
+function randomU32() {
+  return globalThis.crypto.getRandomValues(new Uint32Array(1))[0];
+}
 function currentEpochReader(client) {
   return async () => {
     const { systemState } = await client.core.getCurrentSystemState();
     return BigInt(systemState.epoch);
   };
 }
+function chainIdentifierReader(client) {
+  return async () => (await client.core.getChainIdentifier()).chainIdentifier;
+}
 function assertPayTransaction(txBytes, expected) {
   let data;
   try {
@@ -4865,6 +4909,10 @@ async function payDelegatedSpendAccount(args) {
     return { status: "ok", paid: false, body: resolution.body };
   }
   if (resolution.status === "failed") {
+    logInternal(logError, "resolve payment failed", {
+      code: resolution.code,
+      detail: resolution.detail
+    });
     const mapped = mapPayOpErrorToDelegated(resolution.code, resolution.detail);
     return failed2(mapped.code, mapped.detail, {
       paymentId: resolution.paymentId
@@ -4989,7 +5037,8 @@ async function payDelegatedSpendAccount(args) {
       buildInput: {
         ...kindBuildInput,
         gas: x402Terms.gas,
-        currentEpoch: x402Terms.currentEpoch
+        currentEpoch: x402Terms.currentEpoch,
+        ...x402Terms.chainIdentifier !== void 0 ? { chainIdentifier: x402Terms.chainIdentifier } : {}
       },
       settlement: {
         status: "success",
@@ -5366,12 +5415,28 @@ async function x402Preflight(dialect, offer, deps, logError) {
     logInternal(logError, "x402 needs a current-epoch reader");
     return null;
   }
+  let currentEpoch;
   try {
-    return { gas, currentEpoch: BigInt(await deps.getCurrentEpoch()) };
+    currentEpoch = BigInt(await deps.getCurrentEpoch());
   } catch (err) {
     logInternal(logError, "read current epoch failed", err);
     return null;
   }
+  if (gas.payment.length > 0)
+    return { gas, currentEpoch };
+  if (typeof deps.getChainIdentifier !== "function") {
+    logInternal(logError, "address-balance x402 gas needs a chain-identifier reader");
+    return null;
+  }
+  try {
+    const chainIdentifier = await deps.getChainIdentifier();
+    if (!chainIdentifier.trim())
+      throw new Error("chain identifier is blank");
+    return { gas, currentEpoch, chainIdentifier };
+  } catch (err) {
+    logInternal(logError, "read chain identifier failed", err);
+    return null;
+  }
 }
 function emitX402Progress(ctx, event) {
   if (!ctx.onProgress)
@@ -6453,6 +6518,8 @@ async function createPayer(options) {
     // x402 bounds the transaction's expiration by the current epoch, read from
     // the same client as every other chain read here.
     getCurrentEpoch: currentEpochReader(chain.client),
+    // Address-balance gas (ADR-0055) binds the expiration to the chain.
+    getChainIdentifier: chainIdentifierReader(chain.client),
     ...options.offerSecret ? { offerSecret: options.offerSecret } : {},
     ...options.fetchImpl ? { fetchImpl: options.fetchImpl } : {},
     ...options.logError ? { logError: options.logError } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmdoss/suipay",
-  "version": "0.1.1-dev.7",
+  "version": "0.1.1-dev.9",
   "private": false,
   "type": "module",
   "description": "SuiPay embeddable client — quote and pay a 402 from a spend-account grant.",