@dvmkit/sdk 0.1.5-rc.9 → 0.2.1-rc.9

package/dist/{chunk-2UUXIIOC.js → chunk-VIVXB4CD.js}

@@ -2,7 +2,7 @@ import {
   isValidEvmPrivateKey,
   loadConfig,
   updateConfig
-} from "./chunk-CGKZDODG.js";
+} from "./chunk-MG67KXU7.js";
 import {
   DvmError,
   resolveRpcHttpTransportOptions,
@@ -101,7 +101,7 @@ async function generateTempoKey(opts = {}) {
     );
   }
   if (existing && opts.force) {
-    const { assertTempoWalletIdle } = await import("./tempo-lifecycle-DFIXQ54Q.js");
+    const { assertTempoWalletIdle } = await import("./tempo-lifecycle-G5SB4HFC.js");
     await assertTempoWalletIdle("replace");
   }
   const { privateKeyToAccount, generatePrivateKey } = await import("viem/accounts");
@@ -155,7 +155,7 @@ async function getTempoUsdcBalance(account) {
       usdc: Number(raw) / 1e6,
       tokenAddress,
       chainId: network.chainId,
-      // internal-review: redacted here rather than at a display surface, so the clear
+      // redacted here rather than at a display surface, so the clear
       // endpoint never leaves this function on the success path either.
       rpcUrlRedacted: redactUrl(rpcUrl),
       rpcSource,

package/dist/{chunk-6BQM7TOW.js → chunk-XMDQOXHO.js}

@@ -1,6 +1,6 @@
 import {
   withSdkInitLock
-} from "./chunk-S3XAHZQY.js";
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/payout-reporter.ts
 import { createHash, randomUUID } from "crypto";
@@ -35,7 +35,6 @@ var PostgresX402BatchStore = class {
     this.db = db;
   }
   db;
-  /** Create the table (idempotent), under the SDK init lock like every other boot DDL. */
   async init() {
     await withSdkInitLock(this.db, async () => {
       await this.db.query(`
@@ -155,7 +154,6 @@ var PayoutReporter = class {
     this.intervalMs = opts.snapshotIntervalMs ?? PAYOUT_SNAPSHOT_INTERVAL_MS;
     this.now = opts.now ?? Date.now;
   }
-  /** Boot DDL for the durable batch store, when this reporter owns one. */
   async init() {
     if (this.ownsBatchStore && this.batches instanceof PostgresX402BatchStore) {
       await this.batches.init();
@@ -200,8 +198,6 @@ var PayoutReporter = class {
       warn("payout_flush_failed", { error: message(err) });
     }
   }
-  // ── cashu ─────────────────────────────────────────────────────────────
-  /** The hook `mark-melted` runs inside its transaction: the mark and its payout commit together. */
   meltHook() {
     return {
       enqueue: (event, tx) => this.cashuMelted(event, tx),
@@ -212,17 +208,9 @@ var PayoutReporter = class {
     };
   }
   /**
-   * A melt completed: the accumulator rows are SPENT at the mint and the
-   * Lightning payment reached the builder's destination. One payout per mint
-   * in the call — a `mark-melted` normally names one, since a melt quote
-   * belongs to one mint. The amount is the face value melted; the mint's fee
-   * and the Lightning amount received are builder-machine facts this DVM does
-   * not see.
-   *
-   * Queued through `tx` when the caller is inside the transaction that marks
-   * the rows, and a failure is thrown rather than swallowed so that mark rolls
-   * back with it — see {@link TransactionalPayoutHook}. Without `tx` the rows
-   * are queued on their own and delivered at once.
+   * Report melted face value per mint, not the Lightning amount received after fees. Hash the
+   * payment preimage; do not publish it. With tx, propagate enqueue failures and defer
+   * delivery until commit. Without tx, enqueue independently and start delivery.
    */
   async cashuMelted(event, tx) {
     const byMint = /* @__PURE__ */ new Map();
@@ -262,8 +250,6 @@ var PayoutReporter = class {
       void this.snapshotCashu();
     }
   }
-  // ── tempo ─────────────────────────────────────────────────────────────
-  /** The host attaches the session store and ledger readers once they exist. */
   attachTempo(reader) {
     this.tempo = reader;
   }
@@ -296,7 +282,6 @@ var PayoutReporter = class {
     }
     void this.snapshotTempo();
   }
-  /** The hook `reconcile-tempo-drain` runs inside its transaction: the booking and its payout commit together. */
   tempoRepairHook() {
     return {
       enqueue: (event, tx) => this.tempoCloseReconciled(event, tx),
@@ -307,14 +292,9 @@ var PayoutReporter = class {
     };
   }
   /**
-   * The operator repaired a wedged cooperative close (internal-review). The close's
-   * payee side landed on chain when the close did; if the live hook reported
-   * it, this upgrades that row to `repair`, otherwise it is the row. The
-   * figure is the receipt's payee total for the channel.
-   *
-   * Queued through `tx` when the caller is inside the transaction that books
-   * the drain, and thrown rather than swallowed so that booking rolls back
-   * with it — see {@link TransactionalPayoutHook}.
+   * Report the receipt’s payee total under the live close’s transaction ID, flagged repaired.
+   * The platform upgrades a live row if one exists. Join tx and propagate enqueue failures;
+   * this does not report the caller refund.
    */
   async tempoCloseReconciled(event, tx) {
     const settled = BigInt(event.settledToPayee);
@@ -345,8 +325,6 @@ var PayoutReporter = class {
       void this.snapshotTempo();
     }
   }
-  // ── x402 ──────────────────────────────────────────────────────────────
-  /** The observer the batch-settlement server attaches to and routes its manager through. */
   x402Observer() {
     return {
       attach: (ctx) => {
@@ -366,13 +344,9 @@ var PayoutReporter = class {
     };
   }
   /**
-   * Wrap the upstream channel manager so every claim grows the open batch and
-   * every settle closes it. The claim delta is read off storage rather than
-   * off upstream's result, which carries only a voucher count; under the
-   * fleet lock the before/after read is consistent. A channel the claim
-   * removed on its way through — a refund's claim-then-delete (internal-review) —
-   * moved whatever it still owed before it went, and that value reaches
-   * `pay_to` in this batch too, so it counts at its pre-claim figure.
+   * Read claim deltas from storage because upstream returns voucher counts. Under the fleet
+   * lock, before/after reads are consistent. A deleted channel contributes its pre-claim
+   * unclaimed value, including refund claim-then-delete.
    */
   trackX402Manager(manager) {
     const claim = async (...args) => {
@@ -502,7 +476,6 @@ var PayoutReporter = class {
       warn("payout_batch_track_failed", { scope: ctx.scope, error: message(trackErr) });
     }
   }
-  // ── snapshots ─────────────────────────────────────────────────────────
   /** Every rail this reporter can read, each on its own failure boundary. */
   async snapshot() {
     await this.snapshotCashu();
@@ -639,7 +612,7 @@ var PayoutReporter = class {
   /**
    * Tempo: each active channel's spent-but-unsettled balance — earned, not
    * yet paid to the recipient — and the cooperative closes wedged between
-   * chain and ledger (internal-review), aged past the same floor the repair queue
+   * chain and ledger, aged past the same floor the repair queue
    * uses so an in-flight close is not reported as stuck.
    */
   async snapshotTempo() {

package/dist/{chunk-DMNLFNTW.js → chunk-XRLKGCAW.js}

@@ -1,6 +1,6 @@
 import {
   withSdkInitLock
-} from "./chunk-S3XAHZQY.js";
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/processed-payment-store.ts
 var ProcessedPaymentReplayError = class extends Error {
@@ -39,7 +39,7 @@ var PostgresProcessedPaymentStore = class {
   async init() {
     await withSdkInitLock(this.pool, () => this.createTables());
   }
-  /** The boot DDL itself — always runs under {@link withSdkInitLock} (internal-review). */
+  /** The boot DDL itself — always runs under {@link withSdkInitLock}. */
   async createTables() {
     await this.pool.query(`
       CREATE TABLE IF NOT EXISTS processed_payments (

package/dist/{chunk-M7LHFJ5K.js → chunk-XZ7LW4S5.js}

@@ -75,7 +75,6 @@ var TempoSettlementReadiness = class {
     if (this.timer) clearInterval(this.timer);
     this.timer = void 0;
   }
-  /** Read and report the configured fee-token balance now. */
   async checkBalance(opts) {
     if (this.inFlight) {
       const current = await this.inFlight;
@@ -454,7 +453,7 @@ function buildMppMethods(opts, env) {
         // Without this mppx installs `Store.memory()`, so the consumed-hash
         // guard is per-process and a credential replayed onto a sibling machine
         // (or after a restart) reaches a broadcast the chain then rejects
-        // instead of a cheap refusal (internal-review).
+        // instead of a cheap refusal.
         ...opts.tempoCharge && { store: opts.tempoCharge.store }
       })
     );
@@ -468,7 +467,7 @@ function buildMppMethods(opts, env) {
           // A server-driven settle/close must spend fees from the same TIP-20
           // token the channel carries. Leaving this implicit lets an account's
           // stale fee preference win even when that token has too little left
-          // to broadcast, while the channel token is funded (internal-review).
+          // to broadcast, while the channel token is funded.
           feeToken: tempoCurrency,
           decimals: 6,
           unitType: "request",

package/dist/{chunk-E4EVGPDX.js → chunk-YO56VCTQ.js}

@@ -5,21 +5,17 @@ import {
 // src/sdk/step-cache.ts
 var StepCache = class _StepCache {
   cache = /* @__PURE__ */ new Map();
-  /** Check if a step result is cached. */
   has(id) {
     return this.cache.has(id);
   }
-  /** Get a cached step result. Throws if not present. */
   get(id) {
     return this.getRecord(id).value;
   }
-  /** Get a cached step record, including replay metadata. Throws if not present. */
   getRecord(id) {
     const record = this.cache.get(id);
     if (record === void 0) throw new Error(`StepCache: no cached result for step "${id}"`);
     return record;
   }
-  /** Cache a step result. */
   set(id, value, costs) {
     this.cache.set(id, {
       id,
@@ -27,11 +23,9 @@ var StepCache = class _StepCache {
       ...costs !== void 0 && costs.length > 0 ? { costs: costs.map(({ amount, currency }) => ({ amount, currency })) } : {}
     });
   }
-  /** Export all cached steps for persistence. */
   serialize() {
     return [...this.cache.values()];
   }
-  /** Restore a StepCache from persisted records. */
   static deserialize(records) {
     const cache = new _StepCache();
     for (const { id, value, costs } of records) {

package/dist/{credit-ledger-2DFQHNLB.js → credit-ledger-MHA652TV.js}

@@ -10,8 +10,8 @@ import {
   isDrainMethod,
   isFundingRail,
   x402SettlementPending
-} from "./chunk-MLRCSJYX.js";
-import "./chunk-S3XAHZQY.js";
+} from "./chunk-2D75MNNG.js";
+import "./chunk-COYKJRMM.js";
 import "./chunk-C3MTFLC6.js";
 export {
   CreditLedger,