@dvmkit/sdk 0.21.2 → 0.22.0

package/dist/{step-cache-Bx_ZybWF.d.ts → step-cache-DXFftnAc.d.ts}

@@ -20,7 +20,7 @@ interface UpfrontPayment {
     amount_micro?: number;
     currency?: string;
     /** Funding rail for a credit hold, or the accepted per-call rail. */
-    rail?: "cashu" | "x402" | "tempo" | "lightning";
+    rail?: "cashu" | "x402" | "tempo" | "lightning" | "stripe";
     /** Allocated rail-native atomic units, distinct from credit denomination. */
     native_amount?: number;
     native_asset?: string;
@@ -1454,9 +1454,10 @@ interface ReceiptPayment {
     /**
      * Rail of the most recent successful credit; `null` when nothing was paid.
      * `lightning` appears on a draw against a credit the caller funded by
-     * invoice — it is a funding rail, never an attached-proof one.
+     * invoice — it is a funding rail, never an attached-proof one. `stripe`
+     * likewise appears only on a draw against card-funded credit.
      */
-    rail: "cashu" | "x402" | "tempo" | "lightning" | null;
+    rail: "cashu" | "x402" | "tempo" | "lightning" | "stripe" | null;
     /** Rail-native upfront amount (sats / USDC microunits), `null` when absent. */
     native_amount: number | null;
     native_asset: string | null;
@@ -1780,6 +1781,16 @@ declare function verifyDrainReceipt(receipt: DrainReceipt): boolean;
  */
 declare const NON_CHANNEL_BITCOIN_RAILS: readonly ["cashu", "lightning"];
 type NonChannelBitcoinRail = (typeof NON_CHANNEL_BITCOIN_RAILS)[number];
+/**
+ * Rails whose credit is a card charge the seller refunds through its card
+ * processor rather than in kind. Each funding keeps its own lot so the charge
+ * that bought it (`fundingRef`, the PaymentIntent id) stays addressable for a
+ * partial refund. A card lot carries no sats basis and is never priced in
+ * kind; no Bitcoin path reads it, because every such path is gated on
+ * {@link isNonChannelBitcoinRail} of the credit's own rail.
+ */
+declare const CARD_FUNDED_RAILS: readonly ["stripe"];
+type CardFundedRail = (typeof CARD_FUNDED_RAILS)[number];
 declare function isNonChannelBitcoinRail(rail: string | null | undefined): rail is NonChannelBitcoinRail;
 /**
  * One funding event's deposit: the sats that arrived and the credit micro they
@@ -1796,7 +1807,7 @@ declare function isNonChannelBitcoinRail(rail: string | null | undefined): rail
 interface FundingLot {
     lotId: string;
     creditId: string;
-    rail: NonChannelBitcoinRail;
+    rail: NonChannelBitcoinRail | CardFundedRail;
     /** Sats this funding delivered. `0` on a credit funded before a rail basis was recorded. */
     satsFunded: number;
     /** Explicit original-asset evidence, including a refund whose integer share is zero sats. */
@@ -3035,7 +3046,9 @@ declare class CreditLedger {
     /**
      * Release expired undrawn balances, retaining readable credit records. Tempo rail or
      * channel-backed credits are excluded because their collateral returns to the caller
-     * through the channel lifecycle.
+     * through the channel lifecycle. Card-funded credits are excluded because an expired card
+     * balance is owed back to the card, never released to the builder: it stays on the credit,
+     * where expiry already refuses new draws, until a card refund returns it.
      *
      * Pending holds prevent release: jobs accepted before expiry may still settle or release.
      * Candidates are rechecked under the same parent-credit lock used by draw writes. The
@@ -3061,7 +3074,8 @@ declare class CreditLedger {
     /**
      * Record non-channel Bitcoin funding lots on the funding transaction. An implicit payment
      * also needs a lot: its draw is initially only a hold, and failure releases the whole
-     * balance for reclaim. Channel collateral is excluded from Bitcoin lots.
+     * balance for reclaim. Channel collateral is excluded from Bitcoin lots. A card funding
+     * records a lot per charge so a later refund can address the charge that bought it.
      *
      * A zero-sats basis still records a lot, distinguishing covered but basisless credit from a
      * missing-lot coverage gap.
@@ -3450,6 +3464,60 @@ declare class CreditLedger {
         creditId: string;
         drainId: string;
     }): Promise<CreditDrainRecord | undefined>;
+    /**
+     * Store a card refund's plan or progress on its pending `stripe` drain. With `onlyIfUnset`
+     * the first plan wins and every later caller gets that stored plan back, so concurrent
+     * retries send one set of amounts under one set of idempotency keys. Returns what is
+     * stored after the write; null when the drain is not a pending stripe drain with a plan.
+     */
+    saveCardRefund(args: {
+        creditId: string;
+        drainId: string;
+        plan: CardRefundPlan;
+        onlyIfUnset?: boolean;
+    }): Promise<CardRefundPlan | null>;
+    /**
+     * Expired card credits still holding balance, with no pending holds and no card refund in
+     * progress, oldest expiry first. A credit waiting on its refund drops out of the page, so
+     * one that can never finish does not crowd out the rest.
+     */
+    listExpiredCardCredits(args?: {
+        nowMs?: number;
+        limit?: number;
+    }): Promise<string[]>;
+    /**
+     * Turn an expired card credit's whole balance into a pending `stripe` drain owed back to
+     * the card, and close the credit (`refunded`) in the same transaction. Closing is what
+     * makes this terminal: a later top-up cannot revive a balance that went back to the card,
+     * and the builder never receives it. Returns undefined when the credit no longer
+     * qualifies under its lock (not card, not expired, empty, holds pending, or closed).
+     */
+    openCardExpiryRefund(args: {
+        creditId: string;
+        nowMs?: number;
+    }): Promise<CreditDrainRecord | undefined>;
+    /**
+     * Freeze every active credit a disputed card payment funded (`disputed`): no draw, top-up
+     * or drain moves its balance while the card network decides. Returns the credits this
+     * call froze; already-frozen or closed credits are left as they are.
+     */
+    freezeCardCreditsForPaymentIntent(paymentIntentId: string): Promise<string[]>;
+    /**
+     * Frozen credits this PaymentIntent funded, each with every card PaymentIntent that funded
+     * it: the sweep checks all of them with Stripe before lifting a freeze.
+     */
+    disputedCardCreditsFundedBy(paymentIntentId: string): Promise<{
+        creditId: string;
+        paymentIntentIds: string[];
+    }[]>;
+    /**
+     * Lift a dispute freeze: the credit is `active` and refundable again, including at expiry.
+     * The caller decides that no top-up of the credit has an open or lost dispute. Returns
+     * false when the credit was not frozen.
+     */
+    unfreezeCardCredit(creditId: string): Promise<boolean>;
+    /** True when a funding lot books this PaymentIntent: the charge reached a credit. */
+    cardFundingBooked(paymentIntentId: string): Promise<boolean>;
     /**
      * One credit's undepleted funding lots, oldest first — the
      * public read behind the reclaim's own arithmetic, for anything that needs
@@ -3669,6 +3737,7 @@ declare class CreditLedger {
      * a new draw allocates against. One round-trip, since every
      * caller needs the micro sum anyway.
      */
+    private pendingCardRefundDrainId;
     private pendingSums;
     private snapshotFromRow;
     private readTempoCreditLosses;
@@ -3717,6 +3786,32 @@ interface CreditLedgerLike {
     }): Promise<{
         released: CreditExpiryRelease[];
     }>;
+    /** See {@link CreditLedger.saveCardRefund}. */
+    saveCardRefund?(args: {
+        creditId: string;
+        drainId: string;
+        plan: CardRefundPlan;
+        onlyIfUnset?: boolean;
+    }): Promise<CardRefundPlan | null>;
+    /**
+     * Card-refund sweep reads and writes. Optional and Postgres-only, like the expiry sweep:
+     * see {@link CreditLedger.openCardExpiryRefund}.
+     */
+    listExpiredCardCredits?(args?: {
+        nowMs?: number;
+        limit?: number;
+    }): Promise<string[]>;
+    openCardExpiryRefund?(args: {
+        creditId: string;
+        nowMs?: number;
+    }): Promise<CreditDrainRecord | undefined>;
+    freezeCardCreditsForPaymentIntent?(paymentIntentId: string): Promise<string[]>;
+    disputedCardCreditsFundedBy?(paymentIntentId: string): Promise<{
+        creditId: string;
+        paymentIntentIds: string[];
+    }[]>;
+    unfreezeCardCredit?(creditId: string): Promise<boolean>;
+    cardFundingBooked?(paymentIntentId: string): Promise<boolean>;
     /**
      * Ask that gate directly, so a route can refuse a wedged channel **before**
      * the rail moves anything. Optional on the same terms as the
@@ -4061,14 +4156,19 @@ type CreditLedgerPool = Pick<Pool, "query" | "connect">;
  * x402 credit with no remaining liability can be restored to active by channel
  * reconciliation.
  */
-type CreditStatus = "active" | "unbacked";
+/**
+ * `unbacked`: Tempo backing finalized before the DVM was protected. `refunded`: card credit
+ * whose expired balance went back to the card. `disputed`: a card funding behind it was
+ * disputed, which freezes the remaining balance. None accepts draws, top-ups or drains.
+ */
+type CreditStatus = "active" | "unbacked" | "refunded" | "disputed";
 /** Draw lifecycle: two-phase hold → terminal settle/release. */
 type DrawStatus = "pending" | "settled" | "released";
 /**
  * Drain payout rails. Direct Lightning send is excluded: deployments reclaiming Bitcoin can
  * use Cashu notes without putting a spending wallet credential in the DVM.
  */
-type DrainMethod = "cashu" | "x402" | "tempo";
+type DrainMethod = "cashu" | "x402" | "tempo" | "stripe";
 /**
  * Drain lifecycle. `pending` — liability recorded, not yet fulfilled.
  * Cashu: `pending → parked` (token attached by the builder batch job)
@@ -4258,6 +4358,41 @@ interface CreditDrainRecord {
     provenRefundNative?: string | null;
     /** Sticky proof that some refund was paid; false/absent does not prove zero. */
     refundPaymentProven?: boolean;
+    /** A `stripe` drain's refunds to the card: plan and progress. Null until planned. */
+    cardRefund?: CardRefundPlan | null;
+}
+/**
+ * One refund of card credit against one funding PaymentIntent. Amounts are US cents.
+ *
+ * `amountCents = grossCents − feeShareCents`: the caller bears the share of Stripe's
+ * processing fee proportional to what goes back, because Stripe keeps its whole fee
+ * on a refund.
+ */
+interface CardRefundEntry {
+    lotId: string;
+    paymentIntentId: string;
+    /** Credit returned against this charge, before the fee share. */
+    grossCents: number;
+    feeShareCents: number;
+    /** What goes back to the card. Zero when the fee share eats the whole slice. */
+    amountCents: number;
+    /**
+     * Part of the idempotency key. Bumped only after Stripe definitively rejected or failed a
+     * refund, because Stripe replays a key's first answer, errors included.
+     */
+    attempt: number;
+    refundId: string | null;
+    /** Stripe's refund status, `planned` before any refund exists, `rejected` when refused. */
+    status: "planned" | "pending" | "requires_action" | "succeeded" | "failed" | "canceled" | "rejected";
+    /** Stripe's enum code for the last refusal or failure; never Stripe's free text. */
+    lastError: string | null;
+}
+interface CardRefundPlan {
+    /** Whole cents of the drained credit: `floor(amountMicro / 10_000)`. */
+    grossCents: number;
+    /** Drained credit below one cent, which no card refund can carry. */
+    subCentMicro: number;
+    entries: CardRefundEntry[];
 }
 /**
  * Keyset cursor for {@link CreditLedger.listChannelDrains} — the last row of
@@ -4643,14 +4778,16 @@ interface BlockedInvoiceCursor {
     creditId: string;
     fundId: string;
 }
-type CreditLedgerErrorCode = "credit_not_found" | "credit_expired" | "credit_unbacked" | "tempo_channel_closing" | "tempo_settlement_pending" | "settlement_pending" | "insufficient_credit" | "draw_conflict" | "invalid_refund" | "draw_not_completed" | "refund_conflict" | "refund_exceeds_draw" | "credit_not_open" | "credit_refund_channel_unsupported" | "credit_refund_basis_unavailable" | "credit_refund_state_unavailable" | "draw_not_found" | "invalid_draw_state" | "funding_replayed" | "currency_mismatch" | "caller_mismatch" | "rail_mismatch" | "invalid_amount" | "invalid_expiry" | "invalid_basis" | "nothing_to_drain" | "drain_below_dust" | "drain_not_found" | "drain_conflict" | "invalid_drain_state" | "tempo_drain_close_pending" | "tempo_drain_refund_paid" | "tempo_drain_refund_unknown" | "invalid_drain_decision" | "drain_not_repairable" | "drain_decision_conflict" | "invoice_not_found" | "invoice_conflict" | "invoice_not_blocked" | "below_rail_minimum";
+type CreditLedgerErrorCode = "credit_not_found" | "credit_expired" | "credit_unbacked" | "credit_closed" | "tempo_channel_closing" | "tempo_settlement_pending" | "settlement_pending" | "insufficient_credit" | "draw_conflict" | "invalid_refund" | "draw_not_completed" | "refund_conflict" | "refund_exceeds_draw" | "credit_not_open" | "credit_refund_channel_unsupported" | "credit_refund_basis_unavailable" | "credit_refund_state_unavailable" | "draw_not_found" | "invalid_draw_state" | "funding_replayed" | "currency_mismatch" | "caller_mismatch" | "rail_mismatch" | "invalid_amount" | "invalid_expiry" | "invalid_basis" | "nothing_to_drain" | "drain_below_dust" | "drain_not_found" | "drain_conflict" | "invalid_drain_state" | "tempo_drain_close_pending" | "tempo_drain_refund_paid" | "tempo_drain_refund_unknown" | "invalid_drain_decision" | "drain_not_repairable" | "drain_decision_conflict" | "invoice_not_found" | "invoice_conflict" | "invoice_not_blocked" | "below_rail_minimum";
 /**
  * Structured drain_conflict reasons select caller instructions without matching prose. A
  * refund_floor shortfall needs operator resolution, unlike duplicate payout; foreign_credit
  * discloses no liability to the wrong owner; drain_id_retired requires a fresh ID.
  */
-type DrainConflictReason = "pending_draws" | "balance_moved" | "refund_floor";
+type DrainConflictReason = "pending_draws" | "balance_moved" | "refund_floor" | "card_refund_pending";
 interface CreditLedgerErrorDetails {
+    /** On `credit_closed`: why the card-funded credit no longer moves money. */
+    creditStatus?: "refunded" | "disputed";
     /** On `drain_conflict`: which conflict it is, so a route can answer it without matching on prose. */
     drainConflict?: DrainConflictReason;
     /** On `insufficient_credit`: the spendable balance the draw exceeded. */
@@ -5929,8 +6066,13 @@ interface CapabilityRate {
  * on, nothing to verify inline, and no `lightning` entry in `/v1/info` or
  * `/v1/quote`'s `payment.methods`. Keeping the two types distinct is what
  * stops that dead rail from reappearing every time the funding menu grows.
+ *
+ * `stripe` funds a credit with a Stripe Shared Payment Token over an MPP
+ * `method="stripe"` challenge that only `POST /v1/credit` issues. The card is
+ * charged once, immediately, into the DVM owner's Stripe account; it is never
+ * a per-call job payment method.
  */
-type FundingMethod = PaymentMethod | "lightning";
+type FundingMethod = PaymentMethod | "lightning" | "stripe";
 /**
  * Whether the payment rail returns value when a job fails. No rail reverses
  * `ctx.fail`: Cashu proofs are committed to the accumulator; Tempo and x402
@@ -6435,4 +6577,4 @@ declare class StepCache {
     static deserialize(records: StepRecord[]): StepCache;
 }
 
-export { type JsonValue as $, type ApprovalContent as A, SIGNED_REQUEST_STATEMENT_VERSION as B, type Currency as C, type DVMConfig as D, type SignedRequestAudience as E, type SignedRequestDomain as F, SignedRequestError as G, type SignedRequestFailure as H, type IncomingMessage as I, type JobCost as J, type KVStore as K, type Logger as L, type SignedRequestReplayStore as M, type SignedRequestSignOpts as N, type SignedRequestStatementHeader as O, type PaymentContent as P, type QuoteConfig as Q, type ResolvedCashuConfig as R, type SDKJobContext as S, type SignedRequestVerifier as T, UnsupportedCurrencyError as U, type UpfrontPayment as V, createSignedRequestVerifier as W, isZodSchema as X, signedRequestStatementHeader as Y, type ZodLike as Z, validateCurrency as _, type DVMDescriptor as a, encodePaymentRequiredHeader as a$, X402_BATCH_SETTLEMENT_SCHEME as a0, X402_EXACT_SCHEME as a1, type DrawFundingReceipt as a2, type FundingReceipt as a3, type JobReceipt as a4, type MessageType as a5, type X402Version as a6, type MppxCredential as a7, type PaymentRequired as a8, type Message as a9, type SettleResponse as aA, StepCache as aB, type StepRecord as aC, type TextContent as aD, type UnsignedDrainReceipt as aE, type UnsignedDrawFundingReceipt as aF, type UnsignedFundingReceipt as aG, type UnsignedJobReceipt as aH, type VerifyResponse as aI, type WorkingContent as aJ, type X402Config$1 as aK, type X402ResponseBody as aL, type X402SelfRelayRpcFailureReason as aM, X402_DEFAULT_NETWORK as aN, X402_V1_VERSION as aO, X402_VERSION as aP, buildPaymentRequiredV2 as aQ, buildPaymentRequirements as aR, caip2ToX402Network as aS, canonicalRequestPath as aT, canonicaliseForSigning as aU, canonicalize as aV, chainIdFromCaip2 as aW, computeResultHash as aX, decodePayment as aY, decodePaymentRequiredHeader as aZ, encodePayment as a_, type MppxChallenge as aa, type ReceiptCredit as ab, type DrainReceipt as ac, type X402Wallet as ad, type PaymentRequirementsV1 as ae, type PaymentRequirementsV2 as af, type BuildPaymentRequirementsOpts as ag, type CapabilityDescriptor as ah, type CashuMode as ai, type CompleteContent as aj, type DrainReceiptEvent as ak, type ExactEvmPayload as al, type ExactEvmPayloadAuthorization as am, type FundingMethod as an, type MessageFrom as ao, type PaymentPayload as ap, type PaymentPayloadV1 as aq, type PaymentPayloadV2 as ar, type PaymentRequestContent as as, type PaymentRequiredV2 as at, type PaymentRequirements as au, type PromptContent as av, RAIL_REFUNDABLE as aw, type ReceiptOutcome as ax, type ReceiptPayment as ay, type ResourceInfo as az, type ArtifactContent as b, type CreditDrawRefundResult as b$, encodeSettleResponseHeader as b0, exactEvmAuthorization as b1, isArtifactMessage as b2, isCancelMessage as b3, isCompleteMessage as b4, isDrainReceipt as b5, isDrawFundingReceipt as b6, isFundingReceipt as b7, isPaymentRequestMessage as b8, isPromptMessage as b9, type MppxServer as bA, NON_CHANNEL_BITCOIN_RAILS as bB, type NonChannelBitcoinRail as bC, PayoutReporter as bD, PostgresTempoSessionStore as bE, RevenueReporter as bF, SIGNED_ENVELOPE_FIELDS as bG, SIGNED_ENVELOPE_TYPES as bH, type X402TrackedChannel as bI, _testing as bJ, createDefaultReplayStore as bK, depleteLots as bL, fifoOrder as bM, inKindDrawMsats as bN, isInKindDepletion as bO, isNonChannelBitcoinRail as bP, lotOwedSats as bQ, netOwedSats as bR, wrapMppx as bS, type CreditLedgerQuerier as bT, type CreditDrainEnqueue as bU, HostedSettlementReportObligations as bV, type DVMAuthScheme as bW, type CreditLedgerLike as bX, type X402RefundSettlementGate as bY, type CreditSnapshot as bZ, type CreditDrawRefundArgs as b_, isSignedJobReceipt as ba, isTextMessage as bb, isWorkingMessage as bc, paymentRequiredV2FromV1 as bd, signDrainReceipt as be, signDrawFundingReceipt as bf, signFundingReceipt as bg, signReceipt as bh, usdcContractByCaip2 as bi, usdcContractFor as bj, usdcDomainNameFor as bk, usdcDomainVersionFor as bl, verifyDrainReceipt as bm, verifyDrawFundingReceipt as bn, verifyFundingReceipt as bo, verifyReceipt as bp, x402NetworkToCaip2 as bq, type X402ExactVersionSupport as br, type X402Receipt as bs, type TransactionalPayoutHook as bt, type CashuMeltCompleted as bu, type CreditDepositPayload as bv, type CreditDrainPayload as bw, type FundingLot as bx, type LotDebit as by, type LotDepletion as bz, type CancelContent as c, allocateDrawValue as c$, type DrawResult as c0, type X402SettlementStatus as c1, type X402UnresolvedRefund as c2, type GrownDrawResult as c3, type DrawResolution as c4, type FundingRecord as c5, type CreditFundingEvidence as c6, type CreditInvoiceRecord as c7, type InvoiceSettlement as c8, type BlockedInvoiceCursor as c9, CreditLedger as cA, CreditLedgerError as cB, type CreditLedgerErrorCode as cC, type CreditLedgerErrorDetails as cD, type CreditLedgerPool as cE, type CreditStatus as cF, DRAIN_DELIVERY_RESERVE_SATS as cG, DVM_PROTOCOL_VERSION as cH, type DrainConflictReason as cI, type DrawRailValue as cJ, type DrawStatus as cK, type HostedTempoCloseReportWriteOff as cL, type JobCostReportPayload as cM, type JobTerminalReportPayload as cN, PostgresX402ChannelStorage as cO, type ReplayStoreBackend as cP, type RevenueSkippedNoRailPayload as cQ, type RevenueSkippedNoRailReason as cR, type Secp256k1AuthOpts as cS, type TempoDrainDecision as cT, type TempoDrainDecisionArgs as cU, type TempoDrainDecisionResult as cV, type TempoDrainHoldReason as cW, type X402ChannelStorageOpts as cX, type X402RelayLockHolder as cY, type X402RelaySubmissionLock as cZ, X402RelaySubmissionLockError as c_, type InvoiceReconciliation as ca, type InvoiceWriteOff as cb, type DrawRecord as cc, type StalePendingDrawCursor as cd, type TempoCreditLossEvidence as ce, type TempoCreditLoss as cf, type X402CreditLossEvidence as cg, type X402CreditLoss as ch, type DrainMethod as ci, type DrainRequestResult as cj, type BitcoinDepositLiability as ck, type CreditDrainRecord as cl, type ChannelDrainCursor as cm, type DrainWriteOff as cn, type DrainTransitionResult as co, type DrainReleaseResult as cp, type DrainFulfilment as cq, HostingCleanupFence as cr, CLIENT_COMPATIBILITY_HEADERS as cs, type ClientCompatibility as ct, type ClientCompatibilityEnv as cu, type ClientCompatibilityGate as cv, type ClientCompatibilityRequirement as cw, type ClientSemVer as cx, type CreditFundingBasis as cy, type CreditInvoiceStatus as cz, type CanonicalEnvelope as d, clientCompatibilityAttributes as d0, clientCompatibilityMiddleware as d1, clientUpgradeRequired as d2, parseClientCapabilities as d3, parseClientCompatibility as d4, parseDvmClient as d5, parseProtocolVersion as d6, requireClientCompatibility as d7, retryHostedTempoCloseReport as d8, secp256k1Auth as d9, signedRequestInput as da, writeOffHostedTempoCloseReport as db, type HostedIntent as dc, type X402SettlementIntent as dd, type HostedFundingReservation as de, type X402SettlementCursor as df, type X402SettlementWriteOff as dg, type X402FacilitatorAuth as dh, type X402BatchSettlementConfig as di, type X402PayoutObserver as dj, type CreditDepositEnqueue as dk, type X402SettlementReconciliationReason as dl, type CreditDrawReleaseEnqueue as dm, type CapabilityRate as e, type CashuConfig as f, type CreateSignedRequestVerifierOpts as g, type CreditConfig as h, type CreditView as i, DEFAULT_CREDIT_MAX as j, DEFAULT_CREDIT_MIN as k, DEFAULT_CREDIT_TTL_SECONDS as l, DEFAULT_JOB_RETENTION_DAYS as m, type DVMRouteContext as n, type InputType as o, InvalidCurrencyError as p, type PaymentMethod as q, type PriceValue as r, type ProgressContent as s, type PromptOpts as t, type QuoteContext as u, type QuoteResult as v, type ResolvedCreditConfig as w, type ResponseContent as x, type SDKPaymentRequestOpts as y, SIGNED_REQUEST_AUTH_ID as z };
+export { type JsonValue as $, type ApprovalContent as A, SIGNED_REQUEST_STATEMENT_VERSION as B, type Currency as C, type DVMConfig as D, type SignedRequestAudience as E, type SignedRequestDomain as F, SignedRequestError as G, type SignedRequestFailure as H, type IncomingMessage as I, type JobCost as J, type KVStore as K, type Logger as L, type SignedRequestReplayStore as M, type SignedRequestSignOpts as N, type SignedRequestStatementHeader as O, type PaymentContent as P, type QuoteConfig as Q, type ResolvedCashuConfig as R, type SDKJobContext as S, type SignedRequestVerifier as T, UnsupportedCurrencyError as U, type UpfrontPayment as V, createSignedRequestVerifier as W, isZodSchema as X, signedRequestStatementHeader as Y, type ZodLike as Z, validateCurrency as _, type DVMDescriptor as a, encodePaymentRequiredHeader as a$, X402_BATCH_SETTLEMENT_SCHEME as a0, X402_EXACT_SCHEME as a1, type DrawFundingReceipt as a2, type FundingReceipt as a3, type JobReceipt as a4, type MessageType as a5, type X402Version as a6, type MppxCredential as a7, type PaymentRequired as a8, type Message as a9, type SettleResponse as aA, StepCache as aB, type StepRecord as aC, type TextContent as aD, type UnsignedDrainReceipt as aE, type UnsignedDrawFundingReceipt as aF, type UnsignedFundingReceipt as aG, type UnsignedJobReceipt as aH, type VerifyResponse as aI, type WorkingContent as aJ, type X402Config$1 as aK, type X402ResponseBody as aL, type X402SelfRelayRpcFailureReason as aM, X402_DEFAULT_NETWORK as aN, X402_V1_VERSION as aO, X402_VERSION as aP, buildPaymentRequiredV2 as aQ, buildPaymentRequirements as aR, caip2ToX402Network as aS, canonicalRequestPath as aT, canonicaliseForSigning as aU, canonicalize as aV, chainIdFromCaip2 as aW, computeResultHash as aX, decodePayment as aY, decodePaymentRequiredHeader as aZ, encodePayment as a_, type MppxChallenge as aa, type ReceiptCredit as ab, type DrainReceipt as ac, type X402Wallet as ad, type PaymentRequirementsV1 as ae, type PaymentRequirementsV2 as af, type BuildPaymentRequirementsOpts as ag, type CapabilityDescriptor as ah, type CashuMode as ai, type CompleteContent as aj, type DrainReceiptEvent as ak, type ExactEvmPayload as al, type ExactEvmPayloadAuthorization as am, type FundingMethod as an, type MessageFrom as ao, type PaymentPayload as ap, type PaymentPayloadV1 as aq, type PaymentPayloadV2 as ar, type PaymentRequestContent as as, type PaymentRequiredV2 as at, type PaymentRequirements as au, type PromptContent as av, RAIL_REFUNDABLE as aw, type ReceiptOutcome as ax, type ReceiptPayment as ay, type ResourceInfo as az, type ArtifactContent as b, type CreditDrawRefundResult as b$, encodeSettleResponseHeader as b0, exactEvmAuthorization as b1, isArtifactMessage as b2, isCancelMessage as b3, isCompleteMessage as b4, isDrainReceipt as b5, isDrawFundingReceipt as b6, isFundingReceipt as b7, isPaymentRequestMessage as b8, isPromptMessage as b9, type MppxServer as bA, NON_CHANNEL_BITCOIN_RAILS as bB, type NonChannelBitcoinRail as bC, PayoutReporter as bD, PostgresTempoSessionStore as bE, RevenueReporter as bF, SIGNED_ENVELOPE_FIELDS as bG, SIGNED_ENVELOPE_TYPES as bH, type X402TrackedChannel as bI, _testing as bJ, createDefaultReplayStore as bK, depleteLots as bL, fifoOrder as bM, inKindDrawMsats as bN, isInKindDepletion as bO, isNonChannelBitcoinRail as bP, lotOwedSats as bQ, netOwedSats as bR, wrapMppx as bS, type CreditLedgerQuerier as bT, type CreditDrainEnqueue as bU, HostedSettlementReportObligations as bV, type DVMAuthScheme as bW, type CreditLedgerLike as bX, type X402RefundSettlementGate as bY, type CreditSnapshot as bZ, type CreditDrawRefundArgs as b_, isSignedJobReceipt as ba, isTextMessage as bb, isWorkingMessage as bc, paymentRequiredV2FromV1 as bd, signDrainReceipt as be, signDrawFundingReceipt as bf, signFundingReceipt as bg, signReceipt as bh, usdcContractByCaip2 as bi, usdcContractFor as bj, usdcDomainNameFor as bk, usdcDomainVersionFor as bl, verifyDrainReceipt as bm, verifyDrawFundingReceipt as bn, verifyFundingReceipt as bo, verifyReceipt as bp, x402NetworkToCaip2 as bq, type X402ExactVersionSupport as br, type X402Receipt as bs, type TransactionalPayoutHook as bt, type CashuMeltCompleted as bu, type CreditDepositPayload as bv, type CreditDrainPayload as bw, type FundingLot as bx, type LotDebit as by, type LotDepletion as bz, type CancelContent as c, X402RelaySubmissionLockError as c$, type DrawResult as c0, type X402SettlementStatus as c1, type X402UnresolvedRefund as c2, type GrownDrawResult as c3, type DrawResolution as c4, type FundingRecord as c5, type CreditFundingEvidence as c6, type CreditInvoiceRecord as c7, type InvoiceSettlement as c8, type BlockedInvoiceCursor as c9, type CreditInvoiceStatus as cA, CreditLedger as cB, CreditLedgerError as cC, type CreditLedgerErrorCode as cD, type CreditLedgerErrorDetails as cE, type CreditLedgerPool as cF, type CreditStatus as cG, DRAIN_DELIVERY_RESERVE_SATS as cH, DVM_PROTOCOL_VERSION as cI, type DrainConflictReason as cJ, type DrawRailValue as cK, type DrawStatus as cL, type HostedTempoCloseReportWriteOff as cM, type JobCostReportPayload as cN, type JobTerminalReportPayload as cO, PostgresX402ChannelStorage as cP, type ReplayStoreBackend as cQ, type RevenueSkippedNoRailPayload as cR, type RevenueSkippedNoRailReason as cS, type Secp256k1AuthOpts as cT, type TempoDrainDecision as cU, type TempoDrainDecisionArgs as cV, type TempoDrainDecisionResult as cW, type TempoDrainHoldReason as cX, type X402ChannelStorageOpts as cY, type X402RelayLockHolder as cZ, type X402RelaySubmissionLock as c_, type InvoiceReconciliation as ca, type InvoiceWriteOff as cb, type DrawRecord as cc, type StalePendingDrawCursor as cd, type TempoCreditLossEvidence as ce, type TempoCreditLoss as cf, type X402CreditLossEvidence as cg, type X402CreditLoss as ch, type DrainMethod as ci, type DrainRequestResult as cj, type BitcoinDepositLiability as ck, type CreditDrainRecord as cl, type ChannelDrainCursor as cm, type DrainWriteOff as cn, type DrainTransitionResult as co, type DrainReleaseResult as cp, type DrainFulfilment as cq, type CardRefundPlan as cr, HostingCleanupFence as cs, CLIENT_COMPATIBILITY_HEADERS as ct, type ClientCompatibility as cu, type ClientCompatibilityEnv as cv, type ClientCompatibilityGate as cw, type ClientCompatibilityRequirement as cx, type ClientSemVer as cy, type CreditFundingBasis as cz, type CanonicalEnvelope as d, allocateDrawValue as d0, clientCompatibilityAttributes as d1, clientCompatibilityMiddleware as d2, clientUpgradeRequired as d3, parseClientCapabilities as d4, parseClientCompatibility as d5, parseDvmClient as d6, parseProtocolVersion as d7, requireClientCompatibility as d8, retryHostedTempoCloseReport as d9, secp256k1Auth as da, signedRequestInput as db, writeOffHostedTempoCloseReport as dc, type HostedIntent as dd, type X402SettlementIntent as de, type HostedFundingReservation as df, type X402SettlementCursor as dg, type X402SettlementWriteOff as dh, type X402FacilitatorAuth as di, type X402BatchSettlementConfig as dj, type X402PayoutObserver as dk, type CreditDepositEnqueue as dl, type X402SettlementReconciliationReason as dm, type CreditDrawReleaseEnqueue as dn, type CapabilityRate as e, type CashuConfig as f, type CreateSignedRequestVerifierOpts as g, type CreditConfig as h, type CreditView as i, DEFAULT_CREDIT_MAX as j, DEFAULT_CREDIT_MIN as k, DEFAULT_CREDIT_TTL_SECONDS as l, DEFAULT_JOB_RETENTION_DAYS as m, type DVMRouteContext as n, type InputType as o, InvalidCurrencyError as p, type PaymentMethod as q, type PriceValue as r, type ProgressContent as s, type PromptOpts as t, type QuoteContext as u, type QuoteResult as v, type ResolvedCreditConfig as w, type ResponseContent as x, type SDKPaymentRequestOpts as y, SIGNED_REQUEST_AUTH_ID as z };

package/dist/{tempo-charge-store-P7ZBR3GG.js → tempo-charge-store-SOIRMEFJ.js}

@@ -1,9 +1,9 @@
 import {
   PostgresTempoChargeStore
-} from "./chunk-2RZRYMCR.js";
+} from "./chunk-YNHFJE6U.js";
 import "./chunk-YG7G4DPZ.js";
 import "./chunk-COYKJRMM.js";
-import "./chunk-MA55LUNR.js";
+import "./chunk-2WWVI32F.js";
 export {
   PostgresTempoChargeStore
 };

package/dist/{tempo-session-store-ZVRBAMLG.js → tempo-session-store-UBDFFHDG.js}

@@ -1,11 +1,11 @@
 import {
   PostgresTempoSessionStore,
   assertMonotonicTransition
-} from "./chunk-FAT57DAP.js";
+} from "./chunk-5YJWAJ4N.js";
 import "./chunk-YG7G4DPZ.js";
 import "./chunk-COYKJRMM.js";
-import "./chunk-LSANCGLP.js";
-import "./chunk-MA55LUNR.js";
+import "./chunk-L35WYOH2.js";
+import "./chunk-2WWVI32F.js";
 export {
   PostgresTempoSessionStore,
   assertMonotonicTransition

package/dist/testing/index.d.ts

@@ -1,6 +1,6 @@
-import { C as ContentHoldHistory, a as ContentHoldMutation } from '../content-retention-efjireLM.js';
-import { a4 as JobReceipt, a9 as Message, a5 as MessageType, K as KVStore, L as Logger, x as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../step-cache-Bx_ZybWF.js';
-import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-DWVkleH3.js';
+import { C as ContentHoldHistory, a as ContentHoldMutation } from '../content-retention-DEvY5vjM.js';
+import { a4 as JobReceipt, a9 as Message, a5 as MessageType, K as KVStore, L as Logger, x as ResponseContent, P as PaymentContent, S as SDKJobContext } from '../step-cache-DXFftnAc.js';
+import { c as StreamableJobStore, R as ReceiptIssuingStore, J as JobRecord, d as RequestIdClaim, e as RequestIdClaimResult, f as JobRetentionCursor, O as OutgoingMessage, A as AppendOutgoingOptions, P as PaymentCreditDelta, V as VerifyAndCreditResult, g as JobCounters } from '../job-store-CjPnf0dd.js';
 import 'hono';
 import 'mppx';
 import '@x402/core/server';

package/dist/testing/index.js

@@ -4,22 +4,22 @@ import {
 import {
   MemoryJobStore,
   createInstrumentedFetch
-} from "../chunk-WWKFG6TM.js";
+} from "../chunk-5NMHZIIU.js";
 import {
   JobCancelledError
 } from "../chunk-KVKJ7R5V.js";
 import {
   createNoopLogger
-} from "../chunk-NRE4NOCY.js";
+} from "../chunk-JMTLK2SZ.js";
 import "../chunk-FUJ36YDV.js";
 import "../chunk-BQJIFRAZ.js";
-import "../chunk-LWF4ABYF.js";
+import "../chunk-EHBUAJ5M.js";
 import {
   validateCurrency
-} from "../chunk-XWG54M6T.js";
-import "../chunk-7KNFEDFW.js";
+} from "../chunk-UVRBD5GR.js";
+import "../chunk-ZH5CLGO6.js";
 import "../chunk-66HGCPBU.js";
-import "../chunk-MA55LUNR.js";
+import "../chunk-2WWVI32F.js";
 
 // src/sdk/testing/test-context.ts
 function createTestContext(opts) {

package/dist/{usd-eOAMEO12.d.ts → usd-Bc_rva_K.d.ts}

@@ -1,4 +1,4 @@
-import { C as Currency } from './step-cache-Bx_ZybWF.js';
+import { C as Currency } from './step-cache-DXFftnAc.js';
 
 /**
  * Thrown by `fiatToSatsCeil` / `satsToFiat` when the supplied `ratePerBtc` is

package/dist/{x402-44JZJQ5F.js → x402-MFBRORHG.js}

@@ -3,11 +3,11 @@ import {
   generateX402PrivateKey,
   getX402Balance,
   resolveX402Asset
-} from "./chunk-5RGZN6WQ.js";
+} from "./chunk-XB644VN3.js";
 import {
   verifyX402Payment
-} from "./chunk-ZBOCNF56.js";
-import "./chunk-3V6CSTWB.js";
+} from "./chunk-GDZXGB43.js";
+import "./chunk-3DGIRHP2.js";
 import {
   X402_DEFAULT_FACILITATOR,
   X402_DEFAULT_NETWORK,
@@ -26,7 +26,7 @@ import {
   paymentRequiredV2FromV1,
   usdcContractByCaip2,
   x402NetworkToCaip2
-} from "./chunk-NUDHO4HV.js";
+} from "./chunk-LABJSMSJ.js";
 import "./chunk-FUJ36YDV.js";
 import {
   X402_NETWORKS,
@@ -37,7 +37,7 @@ import {
   x402SupportedNetworksHint
 } from "./chunk-BPYMEMQX.js";
 import "./chunk-66HGCPBU.js";
-import "./chunk-MA55LUNR.js";
+import "./chunk-2WWVI32F.js";
 export {
   X402_DEFAULT_FACILITATOR,
   X402_DEFAULT_NETWORK,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvmkit/sdk",
-  "version": "0.21.2",
+  "version": "0.22.0",
   "description": "SDK for building Digital Vending Machines: pay-per-use HTTPS services AI agents can find, pay, and call with no account or API key",
   "author": "DVM Technologies Ltd",
   "keywords": [

package/dist/{chunk-NUDHO4HV.js → chunk-LABJSMSJ.js}

@@ -3,6 +3,47 @@ import {
   x402NetworkBySlug
 } from "./chunk-BPYMEMQX.js";
 
+// src/lib/payment-amounts.ts
+function msatsToUsd(msats, rate) {
+  return msats / 1e11 * rate;
+}
+function usdToMsats(usd, rate) {
+  return Math.round(usd / rate * 1e11);
+}
+function msatsToUsdCents(msats, btcPriceUsd) {
+  const usd = msatsToUsd(msats, btcPriceUsd);
+  return Math.round(usd * 100);
+}
+function msatsToUsdc(msats, btcUsdRate) {
+  if (!Number.isSafeInteger(msats) || msats < 0) {
+    throw new RangeError("msats must be a non-negative safe integer");
+  }
+  if (!Number.isFinite(btcUsdRate) || btcUsdRate <= 0) {
+    throw new RangeError("BTC/USD rate must be finite and positive");
+  }
+  const [mantissa, exponent = "0"] = btcUsdRate.toString().split("e");
+  const decimalPlaces = mantissa.split(".")[1]?.length ?? 0;
+  const shift = Number(exponent) - decimalPlaces;
+  let numerator = BigInt(msats) * BigInt(mantissa.replace(".", ""));
+  let denominator = 100000n;
+  if (shift > 0) numerator *= 10n ** BigInt(shift);
+  else if (shift < 0) denominator *= 10n ** BigInt(-shift);
+  const micro = (numerator + denominator - 1n) / denominator;
+  if (micro > BigInt(Number.MAX_SAFE_INTEGER)) {
+    throw new RangeError("USDC micro-unit amount exceeds the safe integer range");
+  }
+  return Number(micro);
+}
+function usdcToMsats(usdc, btcUsdRate) {
+  return usdToMsats(usdc, btcUsdRate);
+}
+function msatsToMicro(msats, btcRate) {
+  return Math.round(msatsToUsd(msats, btcRate) * 1e6);
+}
+function microToSats(micro, btcRate) {
+  return Math.ceil(usdToMsats(micro / 1e6, btcRate) / 1e3);
+}
+
 // src/lib/x402/constants.ts
 var X402_DEFAULT_FACILITATOR = "https://x402.org/facilitator";
 
@@ -206,47 +247,6 @@ function isOptionalRecord(value) {
   return value === void 0 || value === null || isRecord(value);
 }
 
-// src/lib/payment-amounts.ts
-function msatsToUsd(msats, rate) {
-  return msats / 1e11 * rate;
-}
-function usdToMsats(usd, rate) {
-  return Math.round(usd / rate * 1e11);
-}
-function msatsToUsdCents(msats, btcPriceUsd) {
-  const usd = msatsToUsd(msats, btcPriceUsd);
-  return Math.round(usd * 100);
-}
-function msatsToUsdc(msats, btcUsdRate) {
-  if (!Number.isSafeInteger(msats) || msats < 0) {
-    throw new RangeError("msats must be a non-negative safe integer");
-  }
-  if (!Number.isFinite(btcUsdRate) || btcUsdRate <= 0) {
-    throw new RangeError("BTC/USD rate must be finite and positive");
-  }
-  const [mantissa, exponent = "0"] = btcUsdRate.toString().split("e");
-  const decimalPlaces = mantissa.split(".")[1]?.length ?? 0;
-  const shift = Number(exponent) - decimalPlaces;
-  let numerator = BigInt(msats) * BigInt(mantissa.replace(".", ""));
-  let denominator = 100000n;
-  if (shift > 0) numerator *= 10n ** BigInt(shift);
-  else if (shift < 0) denominator *= 10n ** BigInt(-shift);
-  const micro = (numerator + denominator - 1n) / denominator;
-  if (micro > BigInt(Number.MAX_SAFE_INTEGER)) {
-    throw new RangeError("USDC micro-unit amount exceeds the safe integer range");
-  }
-  return Number(micro);
-}
-function usdcToMsats(usdc, btcUsdRate) {
-  return usdToMsats(usdc, btcUsdRate);
-}
-function msatsToMicro(msats, btcRate) {
-  return Math.round(msatsToUsd(msats, btcRate) * 1e6);
-}
-function microToSats(micro, btcRate) {
-  return Math.ceil(usdToMsats(micro / 1e6, btcRate) / 1e3);
-}
-
 // src/lib/payment-rails/rpc.ts
 function resolveRpcOverride(envValue, bundled) {
   const override = envValue?.trim() ?? "";
@@ -274,6 +274,13 @@ function resolveRpcHttpTransportOptions(source, envValue) {
 }
 
 export {
+  msatsToUsd,
+  usdToMsats,
+  msatsToUsdCents,
+  msatsToUsdc,
+  usdcToMsats,
+  msatsToMicro,
+  microToSats,
   X402_DEFAULT_FACILITATOR,
   X402_VERSION,
   X402_V1_VERSION,
@@ -296,13 +303,6 @@ export {
   decodePaymentRequiredHeader,
   exactEvmAuthorization,
   encodeSettleResponseHeader,
-  msatsToUsd,
-  usdToMsats,
-  msatsToUsdCents,
-  msatsToUsdc,
-  usdcToMsats,
-  msatsToMicro,
-  microToSats,
   resolveRpcOverride,
   resolveRpcHttpTransportOptions
 };