@settlemint/dalp-sdk 3.1.26-main.37116470199 → 3.1.26

package/dist/platform.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Combined DALP platform client factory.
+ *
+ * Related: kit/sdk/src/client.ts, kit/sdk/src/auth.ts
+ *
+ * @module
+ */
+import { type DalpAuthClient } from "./auth.js";
+import { DalpCookieStore } from "./cookie-store.js";
+import type { DalpClient, DalpClientConfig } from "./types.js";
+export interface DalpPlatformClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /** API key used by the DAPI client and, by default, the auth client. */
+    apiKey?: string;
+    /** Organization ID sent to both DAPI and auth operations when provided. */
+    organizationId?: string;
+    /** Headers merged into DAPI requests. */
+    headers?: DalpClientConfig["headers"];
+    /** Headers merged into Better Auth requests. */
+    authHeaders?: Record<string, string>;
+    /** Better Auth session token sent as an Authorization bearer token. */
+    sessionToken?: string;
+    /** Initial cookie header for Better Auth session handoff. */
+    cookie?: string;
+    /** Existing cookie store to reuse across platform clients. */
+    cookieStore?: DalpCookieStore;
+    /** Validate outgoing DAPI requests against the contract before sending. */
+    requestValidation?: boolean;
+    /** Validate incoming DAPI responses against the contract. */
+    responseValidation?: boolean;
+    /** Custom `fetch` implementation for both DAPI and Better Auth clients. */
+    fetch?: typeof globalThis.fetch;
+}
+export interface DalpPlatformClient {
+    dapi: DalpClient;
+    auth: DalpAuthClient;
+    cookieStore: DalpCookieStore;
+}
+export declare function createDalpPlatformClient(config: DalpPlatformClientConfig): DalpPlatformClient;
+//# sourceMappingURL=platform.d.ts.map

package/dist/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,yCAAyC;IACzC,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAEtC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAyB7F"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Optional oRPC link plugins for advanced SDK usage.
+ *
+ * These are thin re-exports with JSDoc guidance. Import from
+ * `@settlemint/dalp-sdk/plugins` to keep the main entry point lean.
+ *
+ * Related: kit/sdk/src/client.ts
+ *
+ * @module
+ */
+export { RequestValidationPlugin, ResponseValidationPlugin } from "@orpc/contract/plugins";
+export { BatchLinkPlugin } from "@orpc/client/plugins";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,10 @@
+import"../chunk-xm8h1dzh.js";
+
+// src/plugins/index.ts
+import { RequestValidationPlugin, ResponseValidationPlugin } from "@orpc/contract/plugins";
+import { BatchLinkPlugin } from "@orpc/client/plugins";
+export {
+  ResponseValidationPlugin,
+  RequestValidationPlugin,
+  BatchLinkPlugin
+};

package/dist/sdk-error.d.ts

@@ -0,0 +1,74 @@
+import { ORPCError } from "@orpc/client";
+import type { DapiErrorId, DapiPublicError } from "./dapi-errors.js";
+interface DalpOrpcErrorJson {
+    readonly defined: true;
+    readonly code: string;
+    readonly status: number;
+    readonly message: string;
+    readonly data: {
+        readonly id: string;
+        readonly category: string;
+        readonly retryable: boolean;
+        readonly why: string;
+        readonly fix: string;
+        readonly requestId?: string;
+        readonly retryAfterSeconds?: unknown;
+        readonly [key: string]: unknown;
+    };
+}
+export interface DalpSdkErrorOptions {
+    code?: string;
+    id?: DapiErrorId;
+    category: string;
+    status?: number;
+    retryable: boolean;
+    message: string;
+    why: string;
+    fix: string;
+    details?: Record<string, unknown>;
+    dapiError?: DapiPublicError;
+    /** Full ORPC `data` from the wire, including typed route/contract fields. */
+    orpcData?: Record<string, unknown>;
+    /**
+     * Seconds the server asks the client to wait before retrying, decoded from a
+     * `Retry-After`-bearing error (e.g. `INDEXER_REINDEXING`). Present only when
+     * the error carried the value; never a default.
+     */
+    retryAfterSeconds?: number;
+    cause?: unknown;
+}
+export interface DalpSdkConfigurationErrorInput {
+    message: string;
+    why: string;
+    fix: string;
+    cause?: unknown;
+}
+export type DalpSdkErrorJson = ReturnType<ORPCError<string, DapiPublicError | undefined>["toJSON"]> & {
+    id?: DapiErrorId;
+    category: string;
+    retryable: boolean;
+    why: string;
+    fix: string;
+    details?: Record<string, unknown>;
+    retryAfterSeconds?: number;
+};
+export declare class DalpSdkError extends ORPCError<string, DapiPublicError | undefined> {
+    readonly id?: DapiErrorId;
+    readonly category: string;
+    readonly retryable: boolean;
+    readonly why: string;
+    readonly fix: string;
+    readonly details?: Record<string, unknown>;
+    readonly dapiError?: DapiPublicError;
+    readonly retryAfterSeconds?: number;
+    constructor(options: DalpSdkErrorOptions);
+    toJSON(): DalpSdkErrorJson;
+}
+export declare function createDalpSdkConfigurationError(input: DalpSdkConfigurationErrorInput): DalpSdkError;
+export declare function createDalpSdkErrorFromOrpcJson(parsed: DalpOrpcErrorJson, cause?: unknown, retryAfterSeconds?: number): DalpSdkError;
+export declare function createDalpSdkErrorFromDapiPublicError(error: DapiPublicError, cause?: unknown, retryAfterSeconds?: number): DalpSdkError;
+export declare function decodeDapiErrorResponseBody(body: unknown): DalpSdkError | null;
+export declare function getDapiPublicErrorFromResponseBody(body: unknown): DapiPublicError | undefined;
+export declare function isDapiPublicError(value: unknown): value is DapiPublicError;
+export {};
+//# sourceMappingURL=sdk-error.d.ts.map

package/dist/sdk-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-error.d.ts","sourceRoot":"","sources":["../src/sdk-error.ts"],"names":[],"mappings":"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"}

package/dist/serializers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Custom JSON serializers for oRPC wire format.
+ *
+ * Vendored from @core/validation to avoid pulling in heavy transitive
+ * dependencies (viem, date-fns, iso-3166). Only the serializer objects
+ * are included — not the Zod schemas or helper functions.
+ *
+ * Related: packages/core/validation/src/bigdecimal.ts,
+ *          packages/core/validation/src/bigint.ts,
+ *          packages/core/validation/src/timestamp.ts
+ *
+ * @module
+ */
+import type { StandardRPCCustomJsonSerializer } from "@orpc/client/standard";
+/**
+ * Serializer for arbitrary-precision decimal values (dnum).
+ *
+ * Encodes `Dnum` values as locale-independent decimal strings on the wire
+ * and decodes them back into `Dnum` tuples on the receiving side.
+ */
+export declare const bigDecimalSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * Serializer for native `bigint` values.
+ *
+ * Encodes bigints as decimal strings on the wire since JSON does not
+ * support the `bigint` primitive natively.
+ */
+export declare const bigIntSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * Serializer for `Date` objects.
+ *
+ * Encodes dates as ISO-8601 strings on the wire and reconstructs
+ * `Date` instances on deserialization.
+ */
+export declare const timestampSerializer: StandardRPCCustomJsonSerializer;
+/**
+ * All DALP custom JSON serializers, pre-configured for use with
+ * `RPCLink` or `RPCHandler` `customJsonSerializers` option.
+ */
+export declare const dalpSerializers: readonly StandardRPCCustomJsonSerializer[];
+//# sourceMappingURL=serializers.d.ts.map

package/dist/serializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../src/serializers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAqD7E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,+BA6BlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,+BAK9B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,+BAKjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,+BAA+B,EAIrE,CAAC"}

package/dist/types.d.ts

@@ -1,38 +1,115 @@
-import type { AssumableParticipant, JoinableParticipant, JoinableProvider, EvmAddress, TokenTopicScheme, TokenTrustedIssuer, EvmUserEventV2Item, UserEventV2Item, UserMe, party_multisigDrafts_issueInvite_Response, party_topicSchemes_addForToken_Request, party_trustedIssuers_addForToken_Request, party_users_events_Response, platform_settings_settingsThemeUploadLogo_Request, token_create_Request, token_documents_getUploadUrl_Request, token_features_list_Response, system_feeds_issuerSigned_create_Request } from "./generated/api-types.d.ts";
-export type ParticipantKind = "person" | "company" | "fund" | "spv" | "department" | "joint_account" | "asset" | "organisation" | "claim_issuer" | "addon";
-export type ParticipantAddressPurpose = "transfer" | "identity" | "participant";
-export interface EligibleForTokenFilter {
-    readonly tokenAddress: EvmAddress;
-    readonly action: "mint" | "transfer" | "burn";
-    readonly reveal?: boolean;
+/**
+ * Type-only exports for the DALP SDK.
+ *
+ * Import from `@settlemint/dalp-sdk/types` when you only need types
+ * (e.g., for function signatures) without pulling in runtime code.
+ *
+ * Related: kit/sdk/src/client.ts
+ *
+ * @module
+ */
+import type { DalpApi } from "./api-types.generated.js";
+/**
+ * Fully typed DALP API client.
+ *
+ * The shapes come from `./api-types.generated.ts` rather than from the contract
+ * router's inferred type. A declaration that names the contract cannot be
+ * published: `@dalp/api-contract` is private, and the inferred type does not
+ * survive declaration emit at all (`TS7056` on the larger route files). See
+ * `./contract.ts`.
+ *
+ * Response values carry the wire representation, so a `bigint` field reads as a
+ * decimal string and a timestamp as an ISO string. The client serializes on the
+ * way out but does not decode on the way back, so a request may pass either the
+ * native value or its string form.
+ *
+ * Provides auto-completed access to all v2 API namespaces:
+ * `account`, `actions`, `addons`, `admin`, `contacts`, `exchangeRates`,
+ * `externalToken`, `identityRecovery`, `monitoring`, `search`,
+ * `settings`, `system`, `token`, `transaction`, `user`.
+ */
+export type DalpClient = DalpApi;
+/**
+ * Per-call client context threaded into individual SDK operations as the second
+ * argument, e.g. `client.token.create(input, { context: { idempotencyKey } })`.
+ * Every field is optional and scoped to the single call, unlike the client-level
+ * {@link BaseDalpClientConfig.idempotencyKey} which applies to every request.
+ */
+export interface DalpClientCallContext {
+    /**
+     * Idempotency key sent as the `Idempotency-Key` header for this call only,
+     * overriding any client-level key. Use a fresh value per genuine retry of a
+     * failed mutation: dapi burns the key of a failed transaction, so re-sending
+     * under the same key is rejected ("previously failed. Use a new idempotency
+     * key to retry"). A stable value within one logical attempt keeps network-level
+     * fetch retries deduplicated.
+     */
+    idempotencyKey?: string;
+    /**
+     * oRPC error codes the caller treats as expected for this call and does not
+     * want surfaced by its own error logging (e.g. an existence probe that accepts
+     * `NOT_FOUND`). A client-side hint scoped to the single call; it is not sent to
+     * the server.
+     */
+    skipLoggingFor?: readonly string[];
 }
-export type JoinableParticipantOption = JoinableParticipant;
-export type JoinableProviderOption = JoinableProvider;
-export type ActAvailability = AssumableParticipant["actAvailability"];
-export type OnboardingState = UserMe["onboardingState"];
-export type UserEvent = UserEventV2Item;
-export type EvmUserEvent = EvmUserEventV2Item;
-export type UserEventCollectionResponse = party_users_events_Response;
-export type UserEventValue = NonNullable<EvmUserEvent["values"]>[number];
-export type TokenTopicSchemeInheritanceLevel = TokenTopicScheme["inheritanceLevel"];
-export type TokenTrustedIssuerInheritanceLevel = TokenTrustedIssuer["inheritanceLevel"];
-export type TokenTopicSchemeCreateInput = party_topicSchemes_addForToken_Request;
-export type TokenTrustedIssuerCreateInput = party_trustedIssuers_addForToken_Request;
-export type MultisigDraftCreateInviteOutput = party_multisigDrafts_issueInvite_Response;
-export type IssuerSignedCreateInput = system_feeds_issuerSigned_create_Request;
-export type ThemeLogoMode = platform_settings_settingsThemeUploadLogo_Request["mode"];
-type AttachedTokenFeature = token_features_list_Response["data"][number];
-type AttachedTokenFeatureConfig<Name extends AttachedTokenFeature["name"]> = NonNullable<Extract<AttachedTokenFeature, {
-    readonly name: Name;
-}>["config"]>;
-export type TokenFeatureHistoricalBalancesConfig = AttachedTokenFeatureConfig<"historical-balances">;
-export type TokenFeatureMaturityRedemptionConfig = AttachedTokenFeatureConfig<"maturity-redemption">;
-export type TokenFeatureFixedTreasuryYieldConfig = AttachedTokenFeatureConfig<"fixed-treasury-yield">;
-export type TokenFeatureDividendYieldConfig = AttachedTokenFeatureConfig<"dividend-yield">;
-export type TokenFeatureInterestYieldConfig = AttachedTokenFeatureConfig<"interest-yield">;
-export type TokenFeatureTransactionFeeConfig = AttachedTokenFeatureConfig<"transaction-fee">;
-export type TokenFeatureTransactionFeeAccountingConfig = AttachedTokenFeatureConfig<"transaction-fee-accounting">;
-export type TokenFeatureExternalTransactionFeeConfig = AttachedTokenFeatureConfig<"external-transaction-fee">;
-export type TokenDocumentMimeType = token_documents_getUploadUrl_Request["mimeType"];
-export type TokenCreateInput = token_create_Request;
-export type * from "./generated/api-types.d.ts";
+interface BaseDalpClientConfig {
+    /** Base URL of the DALP API (e.g., `"https://dalp.example.com"`). */
+    url: string;
+    /**
+     * Organization ID for multi-tenant setups.
+     * Required when the API key is scoped to multiple organizations.
+     */
+    organizationId?: string;
+    /**
+     * Additional headers merged into every request.
+     * Accepts a static object or a (possibly async) function for dynamic headers.
+     * Can override defaults like `User-Agent` but cannot override security headers (`x-api-key`, `x-organization-id`).
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /**
+     * Validate outgoing requests against the contract before sending.
+     * Catches schema violations client-side for faster feedback.
+     * @defaultValue false
+     */
+    requestValidation?: boolean;
+    /**
+     * Validate incoming responses against the contract.
+     * Useful during development to catch API drift.
+     * @defaultValue false
+     */
+    responseValidation?: boolean;
+    /**
+     * Custom `fetch` implementation.
+     * Use this to inject logging, proxy configuration, or test doubles.
+     */
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Idempotency key sent as the `Idempotency-Key` header on every request.
+     *
+     * **Warning:** This value is sent on _every_ request made by the client.
+     * If you reuse the same client instance for multiple mutations, the server
+     * will deduplicate all but the first — subsequent mutations silently return
+     * the first response. Only set this when the client is used for a single
+     * mutation (e.g., a one-shot script). For multi-mutation workflows, set the
+     * header per-request via the `headers` callback instead.
+     *
+     * When omitted, no idempotency key header is sent.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * Configuration for creating an authenticated DALP API client.
+ */
+export interface DalpClientConfig extends BaseDalpClientConfig {
+    /** API key for authenticated routes (issued via the DALP dashboard or CLI). */
+    apiKey: string;
+}
+/**
+ * Configuration for creating a public DALP API client.
+ */
+export interface PublicDalpClientConfig extends BaseDalpClientConfig {
+    apiKey?: undefined;
+}
+export type { WalletAuthEndpointPath } from "./auth-wallet-plugins.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,UAAU,oBAAoB;IAC5B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAEpG;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAEhC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,YAAY,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/url.d.ts

@@ -1 +1,2 @@
 export declare function normalizeDalpBaseUrl(url: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBxD"}

package/dist/verify-webhook.d.ts

@@ -1,23 +1,34 @@
-import type { Webhook } from "./webhook-events.ts";
-export type WebhookVerificationFailure = "TIMESTAMP_SKEW" | "SECRET_MISMATCH" | "BODY_HASH_MISMATCH" | "REPLAYED_EVENT" | "MALFORMED_BODY" | "REPLAY_STORE_FAILURE";
+import type { Webhook } from "./webhook-events.js";
+export type WebhookVerificationFailure = "TIMESTAMP_SKEW" | "SECRET_MISMATCH" | "BODY_HASH_MISMATCH";
 export type WebhookVerificationResult = {
-    readonly ok: true;
-    readonly event: Webhook.Event;
+    ok: true;
+    event: Webhook.Event;
 } | {
-    readonly ok: false;
-    readonly code: WebhookVerificationFailure;
+    ok: false;
+    code: WebhookVerificationFailure;
 };
-export interface WebhookReplayStore {
-    readonly has: (eventId: string) => boolean | Promise<boolean>;
-    readonly add: (eventId: string) => void | Promise<void>;
-}
 export interface VerifyWebhookInput {
-    readonly rawBody: string | Uint8Array;
-    readonly headers: Headers | Record<string, string | ReadonlyArray<string> | undefined>;
-    readonly secret: string | ReadonlyArray<string>;
-    readonly replayStore?: WebhookReplayStore;
-    readonly now?: number | Date;
-    readonly timestampToleranceSeconds?: number;
+    rawBody: string | Uint8Array;
+    headers: Headers | Record<string, string | string[] | undefined>;
+    secret: string | readonly string[];
 }
+/**
+ * Strip the `dalp_whsk_` family prefix from a DALP signing secret.
+ *
+ * The Standard Webhooks library expects the bare secret material; DALP
+ * adds the prefix for parity with the `sm_dalp_` API-key family. Both
+ * the dispatcher (DALP-side) and any verifier (DALP or consumer) must
+ * call this before constructing a `new Webhook(...)` instance, otherwise
+ * the HMAC inputs differ on the two ends and every signature mismatches.
+ */
 export declare function toStandardWebhookSecret(secret: string): string;
-export declare function verifyWebhook(input: VerifyWebhookInput): Promise<WebhookVerificationResult>;
+/**
+ * Verifies a DALP webhook signature and returns the typed event union.
+ *
+ * Use the returned lifecycle state and `supersedes` accessor to reconcile
+ * cached DAPI mutation responses with later on-chain outcomes.
+ *
+ * @see ../../kit/docs/content/events/idempotency-and-on-chain-outcome.mdx
+ */
+export declare function verifyWebhook({ rawBody, headers, secret }: VerifyWebhookInput): WebhookVerificationResult;
+//# sourceMappingURL=verify-webhook.d.ts.map

package/dist/verify-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-webhook.d.ts","sourceRoot":"","sources":["../src/verify-webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;AAErG,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACjE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACpC;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,kBAAkB,GAAG,yBAAyB,CAkBzG"}

package/dist/version.d.ts

@@ -1,2 +1,5 @@
+/** Semver version of the published SDK package. */
 export declare const SDK_VERSION: string;
+/** Default User-Agent header sent with every SDK request. */
 export declare const SDK_USER_AGENT: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAcA,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,MAA4B,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,cAAc,QAA6B,CAAC"}

package/dist/version.generated.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generated from package.json. Do not edit.
+ *
+ * @module
+ */
+/** Semver version of the published SDK package. */
+export declare const SDK_PACKAGE_VERSION = "3.1.26";
+//# sourceMappingURL=version.generated.d.ts.map

package/dist/version.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.generated.d.ts","sourceRoot":"","sources":["../src/version.generated.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,WAAW,CAAC"}

package/dist/wait-for-transaction.d.ts

@@ -1,52 +1,94 @@
-import type { DalpClient } from "./proxy/client.ts";
-import type { EvmTransactionStatusOutput } from "./generated/api-types.d.ts";
-export interface WaitForTransactionContractError {
-    readonly id: string;
-    readonly args: Readonly<Record<string, string>>;
-    readonly why: string;
-    readonly message: string;
-    readonly fix?: string;
+/**
+ * Bounded wait-until-terminal barrier for queued DALP mutations.
+ *
+ * A v2 mutation may return a `202`-style async-accepted envelope when its
+ * synchronous wait window elapses while the execution workflow is still
+ * confirming. `waitForTransaction` turns that into a deterministic outcome:
+ * poll the transaction status route at a FIXED interval bounded by a wall-clock
+ * deadline, resolve on a terminal success, throw a typed error on a terminal
+ * failure, and throw a loud timeout error if the deadline elapses first.
+ *
+ * This is a determinism barrier, not a masking retry — total wait is bounded by
+ * `timeoutMs` (never exponential), and a never-terminating transaction fails
+ * loud and bounded instead of hanging.
+ *
+ * Related: kit/sdk/src/types.ts
+ * Related: packages/dalp/api-contract/src/routes/transaction/routes/transaction.status.schema.ts
+ *
+ * @module
+ */
+import type { DalpClient } from "./types.js";
+/** Outcome shape returned by the transaction status route, narrowed to the fields this helper reads. */
+export interface WaitForTransactionResult {
+    readonly tokenAddress?: unknown;
 }
 export interface WaitForTransactionStatus {
-    readonly transactionId: string;
-    readonly status: string;
-    readonly subStatus: string | null;
-    readonly transactionHash: string | null;
-    readonly errorMessage: string | null;
-    readonly contractError?: WaitForTransactionContractError | null;
-    readonly result?: WaitForTransactionResult;
-    readonly activeRequirement?: EvmTransactionStatusOutput["activeRequirement"];
-    readonly activeRequirementUnavailable?: EvmTransactionStatusOutput["activeRequirementUnavailable"];
-    readonly indexerRebuild?: EvmTransactionStatusOutput["indexerRebuild"];
-    readonly indexerRebuildUnavailable?: EvmTransactionStatusOutput["indexerRebuildUnavailable"];
-}
-export type WaitForTransactionResult = NonNullable<EvmTransactionStatusOutput["result"]>;
-export interface WaitForTransactionSuccess extends WaitForTransactionStatus {
-    readonly status: "COMPLETED";
+    transactionId: string;
+    status: string;
+    subStatus: string | null;
+    transactionHash: string | null;
+    errorMessage: string | null;
+    result?: WaitForTransactionResult;
 }
 export interface WaitForTransactionOptions {
-    readonly timeoutMs?: number;
-    readonly pollIntervalMs?: number;
-    readonly signal?: AbortSignal;
-    readonly onStatus?: (status: WaitForTransactionStatus) => void;
-    readonly holdWhilePaused?: boolean;
-    readonly holdWhileRebuilding?: boolean;
-    readonly now?: () => number;
-    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
-    readonly readStatus?: (transactionId: string, signal?: AbortSignal) => Promise<WaitForTransactionStatus>;
+    /** Wall-clock ceiling for the whole wait, in milliseconds. Default 120_000. */
+    timeoutMs?: number;
+    /** Fixed delay between status polls, in milliseconds. Default 2_000. */
+    intervalMs?: number;
+    /**
+     * Resolve (instead of continuing to poll) when the transaction reaches
+     * `PENDING_APPROVAL` — an external approval gate (DFNS / Fireblocks) that is
+     * not a stall and may legitimately outlast the deadline. Default `true`.
+     */
+    resolveOnPendingApproval?: boolean;
+    /**
+     * Cancels the wait when the owning context (React component, request handler,
+     * workflow step) is torn down. An aborted signal stops the loop on the next
+     * iteration, cancels the in-flight status request, and surfaces as a
+     * {@link DalpTransactionWaitError} with `reason: "aborted"`.
+     */
+    signal?: AbortSignal;
 }
-export type TransactionWaitFailureReason = "terminal-failure" | "timeout" | "aborted" | "funding-paused" | "indexer-rebuild";
+/**
+ * Thrown when a transaction reaches a terminal failure state
+ * (`FAILED` / `DEAD_LETTER` / `CANCELLED`), does not reach any terminal state
+ * within the deadline (`reason: "timeout"`), or the caller's `AbortSignal`
+ * fires (`reason: "aborted"`).
+ */
 export declare class DalpTransactionWaitError extends Error {
-    readonly code = "sdk.transaction.WAIT_FAILED";
-    readonly category: "operational";
     readonly transactionId: string;
-    readonly reason: TransactionWaitFailureReason;
-    readonly lastStatus?: WaitForTransactionStatus;
-    readonly elapsedMs?: number;
-    constructor(transactionId: string, reason: TransactionWaitFailureReason, lastStatus?: WaitForTransactionStatus, elapsedMs?: number);
-    get status(): string;
-    get subStatus(): string | null;
-    get retryable(): boolean;
+    readonly status: string;
+    readonly subStatus: string | null;
+    readonly reason: "terminal-failure" | "timeout" | "aborted";
+    readonly lastStatus: WaitForTransactionStatus | undefined;
+    constructor(options: {
+        message: string;
+        transactionId: string;
+        status: string;
+        subStatus: string | null;
+        reason: "terminal-failure" | "timeout" | "aborted";
+        lastStatus?: WaitForTransactionStatus;
+        cause?: unknown;
+    });
 }
-export declare const isDalpTransactionWaitError: (error: unknown) => error is DalpTransactionWaitError;
-export declare function waitForTransaction(client: DalpClient, transactionId: string, options?: WaitForTransactionOptions): Promise<WaitForTransactionSuccess>;
+/**
+ * Poll the transaction status route until the transaction reaches a terminal
+ * state or the deadline elapses.
+ *
+ * - `COMPLETED` → resolves with the final status (the handler already waited for
+ *   the indexer drain, so this is a true read-after-write guarantee).
+ * - `FAILED` / `DEAD_LETTER` / `CANCELLED` → throws {@link DalpTransactionWaitError}
+ *   (`reason: "terminal-failure"`) carrying `status`, `subStatus`, and
+ *   `errorMessage` — fail fast, do not keep polling.
+ * - `PENDING_APPROVAL` → resolves as pending (when `resolveOnPendingApproval`,
+ *   the default) so an external approval gate is never treated as a stall.
+ * - deadline elapsed → throws {@link DalpTransactionWaitError} (`reason: "timeout"`)
+ *   carrying the last observed status — a loud, bounded failure, never an
+ *   indefinite hang.
+ *
+ * @param client A DALP API client.
+ * @param transactionId The queue transaction identifier (UUIDv7) returned in the
+ *   async-accepted envelope.
+ */
+export declare function waitForTransaction(client: DalpClient, transactionId: string, options?: WaitForTransactionOptions): Promise<WaitForTransactionStatus>;
+//# sourceMappingURL=wait-for-transaction.d.ts.map

package/dist/wait-for-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-transaction.d.ts","sourceRoot":"","sources":["../src/wait-for-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiB7C,wGAAwG;AACxG,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,UAAU,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAE1D,YAAY,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAC;QACnD,UAAU,CAAC,EAAE,wBAAwB,CAAC;QACtC,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,EAQA;CACF;AA0BD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAsFnC"}