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

package/dist/{lightning-backend-BozcevPZ.d.ts → lightning-backend-BhsyrBLa.d.ts}

@@ -1,4 +1,4 @@
-import { W as JsonValue } from './step-cache-5dljDqrQ.js';
+import { W as JsonValue } from './step-cache-v2yhyhSZ.js';
 
 declare const lockPubkeyBrand: unique symbol;
 /**
@@ -23,11 +23,9 @@ type LockPubkey = string & {
 declare function toLockPubkey(raw: string): LockPubkey;
 
 /**
- * Canonical deploy-time attestation payload (internal-review). One signature serves
+ * Canonical deploy-time attestation payload. One signature serves
  * both auth-on-deploy and the `/v1/info#builder` attestation — the bytes the
- * builder signs are the canonical JSON of this object. Making a field required
- * also requires the coordinated fleet-before-caller release note in
- * `public compatibility guide`.
+ * builder signs are the canonical JSON of this object.
  */
 interface AttestationPayload {
     /** Immutable platform or self-hosted DVM identifier this attestation applies to. */
@@ -35,12 +33,12 @@ interface AttestationPayload {
     /** DVM slug the attestation applies to (must match the deploy request's slug). */
     slug: string;
     /** sha256(`canonicaliseForSigning(capabilities)`) hex. Binds the attestation
-     *  to the capability shape declared at deploy time. */
+     * to the capability shape declared at deploy time. */
     capabilities_hash: string;
     /** Builder identity x-only secp256k1 pubkey, hex (32 bytes / 64 chars). */
     builder_pubkey: string;
     /**
-     * Per-DVM receipt-signing x-only pubkey, hex (internal-review). Binds the key the
+     * Per-DVM receipt-signing x-only pubkey, hex. Binds the key the
      * deployed DVM signs job receipts with to the cold builder identity: the
      * builder signs this payload, so a receipt verifying under
      * `receipt_pubkey` inherits the builder's authority.
@@ -54,14 +52,12 @@ interface AttestationPayload {
     /** Unix seconds at which the attestation was signed. */
     deployed_at: number;
 }
-/** Result of {@link generateIdentity}: hex pubkey + hex secret. */
 interface BuilderIdentityKeypair {
     /** secp256k1 BIP-340 x-only pubkey, 32 bytes hex (64 chars). */
     pubkey: string;
     /** secp256k1 secret, 32 bytes hex (64 chars). */
     secret: string;
 }
-/** Generate a fresh BIP-340 Schnorr keypair for builder identity. */
 declare function generateIdentity(): BuilderIdentityKeypair;
 /**
  * Read the builder identity secret from `~/.dvmkit/builder.key`. Returns
@@ -96,7 +92,7 @@ declare function writeIdentity(keypair: BuilderIdentityKeypair, opts?: {
  */
 declare function hashCapabilities(capabilities: JsonValue): string;
 /**
- * Assemble the deploy-time attestation payload (internal-review). `deployedAt`
+ * Assemble the deploy-time attestation payload. `deployedAt`
  * defaults to the current Unix second; tests can pin it for reproducibility.
  */
 declare function buildAttestation(args: {
@@ -104,8 +100,8 @@ declare function buildAttestation(args: {
     slug: string;
     capabilities: JsonValue;
     builderPubkey: string;
-    /** Receipt-signing pubkey to attest (internal-review). Omitted when the deploy path
-     *  can't provision the matching `DVMKIT_RECEIPT_KEY`. */
+    /** Receipt-signing pubkey to attest. Omitted when the deploy path
+     * can't provision the matching `DVMKIT_RECEIPT_KEY`. */
     receiptPubkey?: string;
     deployedAt?: number;
 }): AttestationPayload;
@@ -126,7 +122,7 @@ declare function verifyAttestation(payload: AttestationPayload, signatureHex: st
 
 /**
  * Per-method amount limits a mint advertises on its NUT-4 / NUT-5 bolt11/sat
- * entry (internal-review). Both values are in the method's own unit — `sat` here,
+ * entry. Both values are in the method's own unit — `sat` here,
  * never msats.
  *
  * `null` means the mint advertised nothing in that direction, which reads as
@@ -140,9 +136,7 @@ interface MintAmountBounds {
     /** Largest amount the mint will quote, or `null` when unadvertised. */
     maxSats: number | null;
 }
-/** Error categories returned when a mint health probe fails. */
 type HealthErrorCode = "timeout" | "http_error" | "network" | "parse_error" | "missing_fields";
-/** Outcome of a single health probe against one mint. */
 interface MintHealthCheckResult {
     /** Mint URL exactly as passed in (not normalised). */
     mintUrl: string;
@@ -150,9 +144,7 @@ interface MintHealthCheckResult {
     ok: boolean;
     /** Wall-clock duration of the successful (or final failed) attempt in ms. */
     latencyMs: number;
-    /** NUT-06 mint pubkey when present. */
     pubkey?: string;
-    /** NUT-06 mint version string (e.g. "Nutshell/0.20.0") when present. */
     version?: string;
     /** Sorted list of NUT keys the mint declares support for. */
     supportedNuts?: string[];
@@ -167,7 +159,7 @@ interface MintHealthCheckResult {
      * is not switched off (`disabled: true`). Distinct from
      * {@link bolt11SatMintSupported}, which only asks whether the method exists:
      * a mint in melt-only recovery keeps advertising the method and turns the
-     * flag on. Consulted when picking a funding default (internal-review).
+     * flag on. Consulted when picking a funding default.
      */
     mintingEnabled?: boolean;
     /** Same question for NUT-05 (melt) — whether the mint can currently pay out. */
@@ -176,12 +168,11 @@ interface MintHealthCheckResult {
      * True when the mint can currently serve `/v1/swap` — see {@link canSwap} for
      * why an unadvertised NUT-3 reads as `true`. This is what a per-call spend
      * needs, so a `false` here is the reason a spend routes around this mint
-     * (internal-review).
      */
     swapEnabled?: boolean;
     /**
      * Amount limits the mint advertises for issuing (NUT-04 bolt11/sat), in sats
-     * (internal-review). Consulted when picking a funding default and when refusing an
+     * Consulted when picking a funding default and when refusing an
      * amount locally, so a fund outside the range never opens a Lightning quote.
      */
     mintAmountBounds?: MintAmountBounds;
@@ -191,7 +182,7 @@ interface MintHealthCheckResult {
      * True when the mint passes the full {@link assertNutSupport} gate — every
      * required NUT present (not `supported: false`) and bolt11/sat on NUT-4 +
      * NUT-5. The runtime `MintHealthTracker` treats a mint as healthy only when
-     * this is true, reproducing the boot-time NUT gate post-`listen` (internal-review).
+     * this is true, reproducing the boot-time NUT gate post-`listen`.
      */
     nutCompliant?: boolean;
     /** Raw `nuts` object from the `/v1/info` response. Used by `assertNutSupport`. */
@@ -202,7 +193,6 @@ interface MintHealthCheckResult {
         message: string;
     };
 }
-/** Tunables for `checkMintHealth`. */
 interface CheckMintHealthOptions {
     /** Per-attempt timeout in ms. Default: 5000. */
     timeoutMs?: number;
@@ -221,11 +211,10 @@ interface CheckMintHealthOptions {
 declare function checkMintHealth(mintUrl: string, opts?: CheckMintHealthOptions): Promise<MintHealthCheckResult>;
 /**
  * Whether the mint can currently serve `/v1/swap` — the operation every
- * per-call Cashu payment depends on (internal-review).
+ * per-call Cashu payment depends on.
  *
  * **An absent NUT-3 means yes.** Swap is a baseline mint operation and healthy
- * mints do not enumerate it — neither coinos nor lnvoltz advertises a `"3"` key
- * (see `public design rationale`).
+ * mints do not enumerate it — neither coinos nor lnvoltz advertises a `"3"` key.
  * Reading silence as "incapable" would rule out every working mint.
  *
  * A mint that has *switched swaps off* does say so: a mint in melt-only
@@ -250,17 +239,15 @@ declare function amountBoundsVerdict(sats: number, bounds?: MintAmountBounds): A
 /**
  * Assert that a mint's NUT-06 `nuts` object advertises all required capabilities.
  * Two-phase check:
- *   1. Dict-level — each NUT in `requiredNuts` must be present and not have
- *      `supported: false`. Throws naming the missing NUT numbers and mint URL.
- *   2. Method-level — NUT-4 and NUT-5 must each advertise a `bolt11`/`sat`
- *      entry in their `methods` array (covers NUT-23). Throws naming the
- *      missing method.
+ * 1. Dict-level — each NUT in `requiredNuts` must be present and not have
+ * `supported: false`. Throws naming the missing NUT numbers and mint URL.
+ * 2. Method-level — NUT-4 and NUT-5 must each advertise a `bolt11`/`sat`
+ * entry in their `methods` array (covers NUT-23). Throws naming the
+ * missing method.
  */
 declare function assertNutSupport(mintUrl: string, nuts: Record<string, unknown>, requiredNuts?: readonly number[]): void;
 
-/** A Lightning invoice created by the backend. */
 interface CreatedInvoice {
-    /** BOLT11 payment request string. */
     bolt11: string;
     /** Payment hash (hex) — primary key for looking up settlement. */
     paymentHash: string;
@@ -269,7 +256,6 @@ interface CreatedInvoice {
     /** Unix milliseconds when the invoice expires. */
     expiresAt: number;
 }
-/** Result of looking up an invoice's settlement status. */
 interface InvoiceStatus {
     /** True once the invoice has been paid and preimage is known. */
     settled: boolean;
@@ -282,7 +268,6 @@ interface InvoiceStatus {
 }
 /** How a payment reached a settled state — see `payInvoiceReconciling`. */
 type LightningPayOutcome = "paid" | "reconciled" | "republished";
-/** Settled payment plus the audit trail of how it got there. */
 interface LightningPayment {
     /** Payment preimage (hex) — proof the invoice was paid. */
     preimage: string;
@@ -291,7 +276,6 @@ interface LightningPayment {
     /** Whether the wallet answered directly, or the outcome had to be reconciled. */
     outcome: LightningPayOutcome;
 }
-/** Bounds for a read-only wallet transaction snapshot. */
 interface LightningTransactionListOptions {
     /** Include transactions created at or after this Unix timestamp (seconds). */
     from?: number;
@@ -315,9 +299,7 @@ interface LightningTransactionSnapshot {
     createdAt: number;
     settledAt?: number;
 }
-/** What a backend can tell us about the wallet behind it. */
 interface LightningWalletInfo {
-    /** Human-readable wallet name (e.g. "Alby Hub"). */
     alias?: string;
     /** Operations the wallet supports (e.g. `pay_invoice`, `lookup_invoice`). */
     methods: string[];
@@ -330,7 +312,6 @@ interface LightningWalletInfo {
      */
     walletReportedBudget?: Record<string, unknown>;
 }
-/** Abstraction over Lightning wallet backends (NWC, future). */
 interface LightningBackend {
     /**
      * Pay a bolt11 invoice exactly once. Returns the preimage on success.
@@ -346,15 +327,12 @@ interface LightningBackend {
     payInvoice(bolt11: string, amountMsats?: number): Promise<LightningPayment>;
     /** Get wallet balance in millisatoshis. */
     getBalance(): Promise<number>;
-    /** Get wallet info (name, supported methods, any volunteered budget fields). */
     getInfo(): Promise<LightningWalletInfo>;
-    /** Create a new incoming invoice for the given amount and description. */
     createInvoice(params: {
         amountMsats: number;
         description?: string;
         expirySeconds?: number;
     }): Promise<CreatedInvoice>;
-    /** Look up an invoice's settlement status by payment hash. */
     lookupInvoice(paymentHash: string): Promise<InvoiceStatus>;
     /**
      * Return a bounded, credential-safe transaction snapshot when supported.

package/dist/{memory-credit-ledger-MNUOTQO5.js → memory-credit-ledger-BYBATRN3.js}

@@ -1,8 +1,8 @@
 import {
   MemoryCreditLedger
-} from "./chunk-KVEHHC7W.js";
-import "./chunk-MLRCSJYX.js";
-import "./chunk-S3XAHZQY.js";
+} from "./chunk-U5VNEALI.js";
+import "./chunk-2D75MNNG.js";
+import "./chunk-COYKJRMM.js";
 import "./chunk-C3MTFLC6.js";
 export {
   MemoryCreditLedger

package/dist/{mpp-secret-state-WNAQQ6K4.js → mpp-secret-state-B5GCILVH.js}

@@ -1,6 +1,6 @@
 import {
   withSdkInitLock
-} from "./chunk-S3XAHZQY.js";
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/mpp-secret-state.ts
 var DEFAULT_ROTATION_WINDOW_MS = 5 * 60 * 1e3;

package/dist/{mpp-setup-4FJD6ZHV.js → mpp-setup-MPP3ST5X.js}

@@ -17,7 +17,7 @@ import {
   parseMppMethodsAllowlist,
   resolveTempoNetwork,
   wrapMppx
-} from "./chunk-M7LHFJ5K.js";
+} from "./chunk-XZ7LW4S5.js";
 export {
   MPPX_HMAC_MISMATCH_REASON,
   TEMPO_MAINNET_CHAIN_ID,

package/dist/{payout-reporter-RG6XNGPI.js → payout-reporter-KEMUXEUO.js}

@@ -3,8 +3,8 @@ import {
   PAYOUT_SNAPSHOT_INTERVAL_MS,
   PayoutReporter,
   PostgresX402BatchStore
-} from "./chunk-6BQM7TOW.js";
-import "./chunk-S3XAHZQY.js";
+} from "./chunk-XMDQOXHO.js";
+import "./chunk-COYKJRMM.js";
 export {
   MemoryX402BatchStore,
   PAYOUT_SNAPSHOT_INTERVAL_MS,

package/dist/{postgres-consumed-credential-store-VHBT4KEA.js → postgres-consumed-credential-store-6N2V5MJN.js}

@@ -1,6 +1,6 @@
 import {
   withSdkInitLock
-} from "./chunk-S3XAHZQY.js";
+} from "./chunk-COYKJRMM.js";
 
 // src/sdk/server/postgres-consumed-credential-store.ts
 var DEFAULT_TABLE_NAME = "consumed_credentials";
@@ -27,7 +27,7 @@ var PostgresConsumedCredentialStore = 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 ${this.tableName} (

package/dist/postgres-job-store-MZZZMS2B.js

@@ -0,0 +1,7 @@
+import {
+  PostgresJobStore
+} from "./chunk-JAHRF5X3.js";
+import "./chunk-COYKJRMM.js";
+export {
+  PostgresJobStore
+};

package/dist/postgres-kv-store-DXGTKXLU.js

@@ -0,0 +1,7 @@
+import {
+  PostgresKVStore
+} from "./chunk-V5ZRATJH.js";
+import "./chunk-COYKJRMM.js";
+export {
+  PostgresKVStore
+};

package/dist/{postgres-replay-store-UJXRT6VO.js → postgres-replay-store-ZF4JNZOW.js}

@@ -1,7 +1,7 @@
 import {
   PostgresReplayStore
-} from "./chunk-L4OYF4DQ.js";
-import "./chunk-S3XAHZQY.js";
+} from "./chunk-AJNFXR7J.js";
+import "./chunk-COYKJRMM.js";
 export {
   PostgresReplayStore
 };

package/dist/{pricing-4CEB34RM.js → pricing-MU5GNUJZ.js}

@@ -12,7 +12,7 @@ import {
   resolveFxSourceFromEnv,
   validateCurrency,
   warmFxSnapshot
-} from "./chunk-27V2ILSR.js";
+} from "./chunk-4A2RAKCW.js";
 import {
   InvalidFxRateError,
   InvalidUsdPriceError,

package/dist/{processed-payment-store-HAA4SFNK.js → processed-payment-store-GKMAWOM3.js}

@@ -2,8 +2,8 @@ import {
   MemoryProcessedPaymentStore,
   PostgresProcessedPaymentStore,
   ProcessedPaymentReplayError
-} from "./chunk-DMNLFNTW.js";
-import "./chunk-S3XAHZQY.js";
+} from "./chunk-XRLKGCAW.js";
+import "./chunk-COYKJRMM.js";
 export {
   MemoryProcessedPaymentStore,
   PostgresProcessedPaymentStore,

package/dist/revenue-reporter-O75BGYFK.js

@@ -0,0 +1,7 @@
+import {
+  RevenueReporter
+} from "./chunk-VA7GT6C6.js";
+import "./chunk-COYKJRMM.js";
+export {
+  RevenueReporter
+};