@settlemint/dalp-sdk 3.1.18-main.34042135992 → 3.1.18-main.34051758545

package/README.md

@@ -53,24 +53,26 @@ demo scripts are all built on it.
 
 ### Settlement
 
-A queue-backed write resolves with the settled record, not with the platform's
-acceptance. The platform answers such a route either with the settled body or
-with a handle to poll, and the client follows the handle so no caller writes
-that loop.
-
-A wait that runs out raises `SettlementTimeoutError` carrying the transaction
-id and the status URL. That is not a failed write: the transaction is still on
-its way to a block, and resubmitting is a second transfer. `settlementTimeoutMs`
-sets the bound per client, and a call may override it.
-
-A write the funding gate parks on an operator payment is stopped, not slow. The
-status row carries the open ask as `activeRequirement`, and every read that
-reports one restarts the bound, so the wait outlasts the pause and resolves
-with the settled record once the ask is paid. When an ask lapses unpaid the
-platform fails the request, and that failure is what the client reports. A
-caller that cannot wait that long ends the wait through `signal`, and
-`waitForTransaction` takes `holdWhilePaused: false` to end on the first parked
-status with reason `funding-paused` instead.
+A queue-backed write carries a `Prefer` header derived from
+`settlementTimeoutMs`: undefined asks for `wait=15`, zero or less asks for
+`respond-async`, anything else asks for `wait=<seconds>`, clamped to the
+platform's 5 to 99 second range. `settlementTimeoutMs` sets that bound per
+client, and a call may override it.
+
+The platform does the waiting, not the client. When the write settles inside
+the wait, the call returns the route's HTTP 200 resource. When it does not, the
+call returns the declared HTTP 202 handle unchanged: a transaction write's
+`{ transactionId, status, statusUrl }`, or a custody write's `{ requestId,
+state, statusUrl }`. The client never polls a status URL on your behalf.
+
+Pass a transaction id to `waitForTransaction` to follow it to a terminal
+state. A write the funding gate parks on an operator payment reads as still
+queued for as long as the ask is open: the status row carries it as
+`activeRequirement`, and `waitForTransaction` restarts its own timeout on every
+status that reports one, so the wait it runs outlasts the pause. A caller that
+cannot wait that long ends the wait through `signal`, or passes
+`holdWhilePaused: false` to end on the first parked status instead. A custody
+handle has no equivalent helper: follow `statusUrl` yourself.
 
 ### Conditional requests and ETags
 
@@ -126,8 +128,8 @@ using something else.
 Cache keys are derived from route identity plus canonicalized input, so two
 callers passing the same parameters in a different key order share one entry.
 `./react-query` exports `queryKeyFor` and `canonicalize` for building a
-matching invalidation filter, and `UI_SETTLEMENT_TIMEOUT_MS`, the shorter bound
-the mutation factories default to.
+matching invalidation filter, and `UI_SETTLEMENT_TIMEOUT_MS`, the bound the
+mutation factories default to.
 
 ## Scalars
 
@@ -173,14 +175,14 @@ while calling the v2 REST resources underneath. It accepts EntryPoint v0.9
 
 - `./verify-webhook` verifies an inbound webhook signature.
 - `./sign-webhook-receipt` signs a webhook delivery receipt (Node only).
-- `./wait-for-transaction` is a bounded poll for on-chain settlement, for a
-  transaction id you hold from somewhere other than a client call. A write made
-  through the client already waits.
+- `./wait-for-transaction` is a bounded poll to a terminal state, for a
+  transaction id from any source, including the 202 handle a client write
+  returns when the platform's wait runs out.
 
 ## Package root
 
 The root stays small: the client factory, its options and errors, cookie-store
-transport, the settlement types, and the version constants. A consumer who only
+transport, and the version constants. A consumer who only
 calls routes never pays for auth, bundler, TanStack Query, or webhook code.
 
 ## Documentation

package/dist/auth.js

@@ -10,7 +10,7 @@ import {
   makeCookieStore2,
   createCookieStoreFetch2,
   SDK_USER_AGENT2
-} from "./chunk-98m5ctae.js";
+} from "./chunk-bmac5ggc.js";
 
 // src/auth/live.ts
 import { apiKeyClient } from "@better-auth/api-key/client";

package/dist/bundler.js

@@ -1,10 +1,10 @@
-import"./chunk-8mxdqwrr.js";
+import"./chunk-6ffsp0q3.js";
 import"./chunk-j4sxrfzz.js";
-import"./chunk-396ye0s9.js";
+import"./chunk-8rarvfkr.js";
 import"./chunk-xp3fx2yt.js";
 import {
   createDalpClient2
-} from "./chunk-daqk4jhm.js";
+} from "./chunk-9q3a58gk.js";
 
 // src/bundler.ts
 import { getAddress, hexToBigInt, isHex } from "viem";