@unicitylabs/sphere-sdk 0.14.1-dev.2 → 0.14.2

package/dist/modules/payments-v2/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var payments_v2_exports = {};
 __export(payments_v2_exports, {
   ATTENTION_MINT_UNRESOLVED: () => ATTENTION_MINT_UNRESOLVED,
+  ATTENTION_RECIPIENT_NETWORK_UNVERIFIED: () => ATTENTION_RECIPIENT_NETWORK_UNVERIFIED,
   ATTENTION_RESEED_REJECTED: () => ATTENTION_RESEED_REJECTED,
   HEARTBEAT_CAP_MS: () => HEARTBEAT_CAP_MS,
   HEARTBEAT_SEED_MS: () => HEARTBEAT_SEED_MS,
@@ -1520,6 +1521,31 @@ function distinctOpCount(entries) {
   return new Set(entries.map((entry) => entry.opIndex)).size;
 }
 
+// modules/payments-v2/recipient.ts
+var ATTENTION_RECIPIENT_NETWORK_UNVERIFIED = "recipient:network-unverified";
+async function requireSameNetworkRecipient(deps, identifier) {
+  const recipient = await deps.resolveRecipient(identifier);
+  if (recipient === null || recipient.chainPubkey === "") {
+    throw new SphereError(`Recipient ${identifier} has no published chain pubkey`, "INVALID_RECIPIENT");
+  }
+  if (recipient.network === null) {
+    deps.emit("transfer:attention", {
+      transferId: "",
+      // the gate precedes plan allocation — no transferId exists yet
+      code: ATTENTION_RECIPIENT_NETWORK_UNVERIFIED,
+      detail: `could not verify the network of recipient ${identifier} \u2014 assuming this session's "${deps.network}"`
+    });
+    return recipient;
+  }
+  if (recipient.network !== deps.network) {
+    throw new SphereError(
+      `Recipient ${identifier} is on network "${recipient.network}" but this session is on "${deps.network}" \u2014 a cross-network deposit is unrecoverable`,
+      "INVALID_RECIPIENT"
+    );
+  }
+  return recipient;
+}
+
 // modules/payments-v2/restore.ts
 var ATTENTION_RESEED_REJECTED = "intent:reseed-rejected";
 var ALL_STREAMS = ["inventory", "mailbox", "payment_requests", "history"];
@@ -4054,6 +4080,10 @@ var PaymentsFacade = class {
   history(page) {
     return this.historyStore.page(page ?? {});
   }
+  /** §4: read through to the session — the same value `connection:status` carries (sphere#473). No session ⇒ 'offline'. */
+  connectionStatus() {
+    return this.started ? this.deps.session.status() : "offline";
+  }
   /** §4 pending-transfers UI surface — derived on read, never cached (convergence.ts). */
   pendingTransfers() {
     return derivePendingTransfers(this.machineStores, this.machineDeps.decryptPayload);
@@ -4128,7 +4158,7 @@ var PaymentsFacade = class {
     this.deps.emit("transfer:updated", failed);
   }
   async sendWithPolicy(request, run) {
-    const recipient = await this.requireSameNetworkRecipient(request.recipient);
+    const recipient = await requireSameNetworkRecipient(this.deps, request.recipient);
     for (let attempt = 0; ; attempt++) {
       let ctx;
       try {
@@ -4151,20 +4181,6 @@ var PaymentsFacade = class {
       if (surfaced !== null) return surfaced;
     }
   }
-  /** §5.6 cross-network deposit trap: refused BEFORE any reserve/certification. */
-  async requireSameNetworkRecipient(identifier) {
-    const recipient = await this.deps.resolveRecipient(identifier);
-    if (recipient === null || recipient.chainPubkey === "") {
-      throw new SphereError(`Recipient ${identifier} has no published chain pubkey`, "INVALID_RECIPIENT");
-    }
-    if (recipient.network !== this.deps.network) {
-      throw new SphereError(
-        `Recipient ${identifier} is on network "${recipient.network}" but this session is on "${this.deps.network}" \u2014 a cross-network deposit is unrecoverable`,
-        "INVALID_RECIPIENT"
-      );
-    }
-    return recipient;
-  }
   async runAttempt(ctx) {
     this.activeMoneyOps.add(ctx.transferId);
     try {
@@ -4541,19 +4557,12 @@ var PaymentsFacade = class {
   }
   toUiToken(tokenId, coinId, amount) {
     const now = this.nowMs();
-    return toToken(
-      tokenId,
-      { assets: [], createdAt: now, updatedAt: now },
-      { coinId, amount: amount.toString() },
-      this.deps.registry,
-      { transferring: true, suspectedSpent: false }
-    );
+    const snapshot = { assets: [], createdAt: now, updatedAt: now };
+    const flags = { transferring: true, suspectedSpent: false };
+    return toToken(tokenId, snapshot, { coinId, amount: amount.toString() }, this.deps.registry, flags);
   }
   track(op) {
-    const settled = op.then(
-      () => void 0,
-      () => void 0
-    );
+    const settled = op.then(() => void 0, () => void 0);
     this.pendingOps.add(settled);
     void settled.finally(() => this.pendingOps.delete(settled));
     return op;
@@ -4565,6 +4574,7 @@ var PaymentsFacade = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ATTENTION_MINT_UNRESOLVED,
+  ATTENTION_RECIPIENT_NETWORK_UNVERIFIED,
   ATTENTION_RESEED_REJECTED,
   HEARTBEAT_CAP_MS,
   HEARTBEAT_SEED_MS,