@pollar/core 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -75,6 +75,43 @@ interface KeyManager {
     sign(payload: Uint8Array): Promise<Uint8Array>;
 }
 
+/**
+ * Pluggable "is the user looking at this app right now?" signal.
+ *
+ * Used by the silent-refresh scheduler so token renewals are skipped while
+ * the tab is hidden / the app is backgrounded — both saves network and
+ * works around aggressive `setTimeout` throttling that web browsers and RN
+ * apply to non-foreground contexts.
+ *
+ * Default web implementation listens to `visibilitychange` plus
+ * `pageshow`/`pagehide` (covers BFCache on iOS) and `focus`/`blur` (covers
+ * the cases where `visibilitychange` lags). Default for non-browser
+ * environments is a noop that always reports "visible".
+ *
+ * TODO(@pollar/react-native): when the dedicated RN package ships, it will
+ * export an `AppState`-backed provider. Until then, RN consumers can wire
+ * one inline:
+ *
+ *   import { AppState } from 'react-native';
+ *   const rnVisibility = {
+ *     isVisible: () => AppState.currentState === 'active',
+ *     onChange: (cb) => {
+ *       const sub = AppState.addEventListener('change', (s) => cb(s === 'active'));
+ *       return () => sub.remove();
+ *     },
+ *   };
+ *   new PollarClient({ apiKey, visibilityProvider: rnVisibility });
+ */
+interface VisibilityProvider {
+    isVisible(): boolean;
+    /**
+     * Subscribe to visibility transitions. The callback receives the new
+     * visibility state (`true` = visible). Returns an unsubscribe function
+     * that must detach every listener registered by this call.
+     */
+    onChange(cb: (visible: boolean) => void): () => void;
+}
+
 declare enum WalletType {
     FREIGHTER = "freighter",
     ALBEDO = "albedo"
@@ -219,6 +256,14 @@ interface PollarClientConfig {
      * additional wallets without bundling those dependencies into `@pollar/core`.
      */
     walletAdapter?: WalletAdapterResolver;
+    /**
+     * Maximum time (ms) the SDK waits for a `walletAdapter` resolver to return.
+     * Guards against a broken extension bridge (e.g. Freighter content-script
+     * down) hanging the login flow forever. The resolver only constructs the
+     * adapter object — it does NOT include the user-facing approval step — so
+     * a few seconds is plenty. Defaults to 5000.
+     */
+    walletResolverTimeoutMs?: number;
     /**
      * Optional human-friendly label sent at /auth/login time and recorded on
      * the server-side refresh-token row so the user can identify it in the
@@ -226,6 +271,25 @@ interface PollarClientConfig {
      * If unset, the server-recorded `user_agent` header is the fallback.
      */
     deviceLabel?: string;
+    /**
+     * Foreground-detection signal for the silent-refresh scheduler. When the
+     * app is hidden / backgrounded, scheduled refreshes are skipped (saves
+     * network + sidesteps browser/RN background timer throttling); they run
+     * the moment visibility comes back. Defaults to a web provider in the
+     * browser (`visibilitychange` + BFCache + focus) and a noop elsewhere.
+     * React Native consumers should inject an `AppState`-backed provider —
+     * see TODO on `VisibilityProvider`.
+     */
+    visibilityProvider?: VisibilityProvider;
+    /**
+     * If set, the silent-refresh scheduler stops issuing proactive refreshes
+     * after this many milliseconds of no client-side HTTP activity. The
+     * session is not cleared — the next user action triggers a request that
+     * either reuses a still-valid access token or hits 401 → reactive
+     * refresh (transparent if the RT is still valid). Defaults to
+     * `undefined` = refresh forever as long as the app is visible.
+     */
+    maxIdleMs?: number;
 }
 /**
  * One row in the active-sessions list (returned by `PollarClient.listSessions()`).
@@ -245,6 +309,13 @@ type TxBuildBody = NonNullable<paths['/tx/build']['post']['requestBody']>['conte
 type TxBuildResponse = paths['/tx/build']['post']['responses'][200]['content']['application/json'];
 type TxSignAndSendBody = NonNullable<paths['/tx/sign-and-send']['post']['requestBody']>['content']['application/json'];
 type TxSignSendResponse = paths['/tx/sign-and-send']['post']['responses'][200]['content']['application/json'];
+type TxSignBody = NonNullable<paths['/tx/sign']['post']['requestBody']>['content']['application/json'];
+type TxSignResponse = paths['/tx/sign']['post']['responses'][200]['content']['application/json'];
+type TxSignContent = TxSignResponse['content'];
+type TxSubmitSignedBody = NonNullable<paths['/tx/submit']['post']['requestBody']>['content']['application/json'];
+type TxBuildSignSubmitBody = NonNullable<paths['/tx/build-sign-submit']['post']['requestBody']>['content']['application/json'];
+type TxBuildSignSubmitResponse = paths['/tx/build-sign-submit']['post']['responses'][200]['content']['application/json'];
+type TxBuildSignSubmitContent = TxBuildSignSubmitResponse['content'];
 type PollarLoginOptions = {
     provider: 'google';
 } | {
@@ -257,6 +328,28 @@ type PollarLoginOptions = {
     type: WalletId;
 };
 type TxBuildContent = TxBuildResponse['content'];
+/**
+ * Phases the SDK can be in across the build → sign → submit lifecycle.
+ *
+ * **Granular** steps (`building`, `signing`, `submitting`) are emitted when
+ * the SDK can directly observe that phase — i.e. when each is a separate
+ * client-driven call (`buildTx`, `signTx`, `submitTx`, external-wallet
+ * `signAndSubmitTx`).
+ *
+ * **Compound** steps (`signing-submitting`, `building-signing-submitting`)
+ * are emitted when multiple phases collapse into a single opaque backend
+ * round-trip (`signAndSubmitTx` custodial → `/tx/sign-and-send`, and `runTx`
+ * / `buildAndSignAndSubmitTx` custodial → `/tx/build-sign-submit`). The SDK
+ * can't see when one phase ends and the next begins inside that request, so
+ * it honestly reports a single fused state instead of fabricating
+ * transitions.
+ *
+ * **Terminal states** (`success`, `error`) and the post-Horizon-ack pending
+ * state (`submitted`) are shared across all paths.
+ *
+ * On `error`, the `phase` discriminator tells the consumer *where* the
+ * failure happened so modal UIs can offer "retry from this step" buttons.
+ */
 type TransactionState = {
     step: 'idle';
 } | {
@@ -267,17 +360,79 @@ type TransactionState = {
 } | {
     step: 'signing';
     buildData?: TxBuildContent;
-    external?: true;
+} | {
+    step: 'signed';
+    buildData?: TxBuildContent;
+    signedXdr: string;
+    submissionToken?: string;
+} | {
+    step: 'submitting';
+    buildData?: TxBuildContent;
+    signedXdr?: string;
+} | {
+    step: 'signing-submitting';
+    buildData?: TxBuildContent;
+} | {
+    step: 'building-signing-submitting';
+} | {
+    step: 'submitted';
+    buildData?: TxBuildContent;
+    hash: string;
 } | {
     step: 'success';
     buildData?: TxBuildContent;
     hash: string;
-    external?: true;
 } | {
     step: 'error';
+    phase: TxErrorPhase;
     details?: string;
     buildData?: TxBuildContent;
-    external?: true;
+    signedXdr?: string;
+};
+/**
+ * Identifies which phase failed when `TransactionState.step === 'error'`.
+ * Compound phase names (`signing-submitting`, `building-signing-submitting`)
+ * appear here when the failure happened inside an atomic backend call where
+ * the SDK can't isolate the failing sub-phase.
+ */
+type TxErrorPhase = 'building' | 'signing' | 'submitting' | 'signing-submitting' | 'building-signing-submitting';
+/**
+ * Per-call outcomes returned by `buildTx`, `signTx`, `submitTx`,
+ * `signAndSubmitTx`, and `buildAndSignAndSubmitTx`. These are additive to
+ * `TransactionState` — the same operations still drive the state machine for
+ * modal-style UIs, but headless callers can `await` the method and inspect
+ * the returned outcome directly instead of subscribing to state changes.
+ */
+type BuildOutcome = {
+    status: 'built';
+    buildData: TxBuildContent;
+} | {
+    status: 'error';
+    details?: string;
+};
+type SignOutcome = {
+    status: 'signed';
+    signedXdr: string;
+    submissionToken?: string;
+    expiresAt?: number;
+} | {
+    status: 'error';
+    details?: string;
+};
+type SubmitOutcome = {
+    status: 'success';
+    hash: string;
+    buildData?: TxBuildContent;
+} | {
+    status: 'pending';
+    hash: string;
+    buildData?: TxBuildContent;
+} | {
+    status: 'error';
+    hash?: string;
+    details?: string;
+    resultCode?: string;
+    buildData?: TxBuildContent;
 };
 declare const AUTH_ERROR_CODES: {
     readonly SESSION_CREATE_FAILED: "SESSION_CREATE_FAILED";
@@ -288,6 +443,7 @@ declare const AUTH_ERROR_CODES: {
     readonly AUTH_FAILED: "AUTH_FAILED";
     readonly WALLET_CONNECT_FAILED: "WALLET_CONNECT_FAILED";
     readonly WALLET_AUTH_FAILED: "WALLET_AUTH_FAILED";
+    readonly WALLET_RESOLVER_TIMEOUT: "WALLET_RESOLVER_TIMEOUT";
     readonly UNEXPECTED_ERROR: "UNEXPECTED_ERROR";
 };
 type AuthErrorCode = (typeof AUTH_ERROR_CODES)[keyof typeof AUTH_ERROR_CODES];
@@ -390,6 +546,21 @@ type RampsTransactionResponse = paths['/ramps/transaction/{txId}']['get']['respo
 type RampTxStatus = RampsTransactionResponse['status'];
 type RampDirection = RampsTransactionResponse['direction'];
 type PaymentInstructions = RampsOnrampResponse['paymentInstructions'];
+type DistributionRule = paths['/distribution/rules']['get']['responses'][200]['content']['application/json']['content']['rules'][number];
+type RulePeriod = DistributionRule['period'];
+type DistributionClaimBody = NonNullable<paths['/distribution/claim']['post']['requestBody']>['content']['application/json'];
+type DistributionClaimContent = paths['/distribution/claim']['post']['responses'][200]['content']['application/json']['content'];
+type DistributionRulesState = {
+    step: 'idle';
+} | {
+    step: 'loading';
+} | {
+    step: 'loaded';
+    rules: DistributionRule[];
+} | {
+    step: 'error';
+    message: string;
+};
 type AdapterFn<TParams = unknown> = (params: TParams) => Promise<{
     unsignedTransaction: string;
 }>;
@@ -423,12 +594,26 @@ declare class PollarClient {
     private _profile;
     /** Last `DPoP-Nonce` we saw from a server response. Carried into the next proof. */
     private _dpopNonce;
+    /**
+     * Snapshot of each in-flight request's body, taken in `onRequest` before
+     * `fetch()` consumes the stream. Needed because `Request.clone()` throws
+     * once the body is disturbed, so the auto-retry path (DPoP nonce challenge
+     * / 401 refresh) must rebuild the request from scratch instead of cloning.
+     */
+    private _requestBodyCache;
     /** Singleton in-flight refresh — concurrent 401s coalesce into one /auth/refresh call. */
     private _refreshPromise;
     private _storageEventHandler;
     /** Optional UI label sent to the server at /auth/login so the sessions UI
      *  can show a recognizable device name. Set via PollarClientConfig.deviceLabel. */
     private readonly _deviceLabel;
+    private readonly _visibilityProvider;
+    private readonly _maxIdleMs;
+    /** Updated by the request middleware. Read by the silent-refresh scheduler
+     *  to skip proactive refreshes after `maxIdleMs` of no HTTP activity. */
+    private _lastRequestAt;
+    private _refreshTimer;
+    private _visibilityUnsubscribe;
     private _transactionState;
     private _transactionStateListeners;
     private _txHistoryState;
@@ -439,8 +624,18 @@ declare class PollarClient {
     private _authStateListeners;
     private _networkState;
     private _networkStateListeners;
+    /**
+     * Latched once the storage adapter degrades. We dedupe (the adapter only
+     * fires once anyway) and use it to replay state to late-subscribers — same
+     * pattern as `onAuthStateChange` replaying `_authState` on subscribe.
+     * Only populated when the SDK constructed the default storage adapter; if
+     * the consumer passes `config.storage`, they own degradation notifications.
+     */
+    private _storageDegraded;
+    private _storageDegradeListeners;
     private _walletAdapter;
     private readonly _walletAdapterResolver;
+    private readonly _walletResolverTimeoutMs;
     private _loginController;
     constructor(config: PollarClientConfig);
     /** Awaitable handle for the initial keypair + session restore. */
@@ -457,8 +652,54 @@ declare class PollarClient {
      */
     refresh(): Promise<void>;
     private _doRefresh;
+    /**
+     * Arm a single setTimeout to fire shortly before the current access token
+     * expires. Idempotent — clearing any previous timer first. Safe to call
+     * from any session-write site (initial login, restore-from-storage, after
+     * a successful rotation). No-op if there's no session in memory.
+     *
+     * Browser/RN background-tab throttling makes long-running setTimeouts
+     * unreliable on their own; the `visibilitychange` listener compensates by
+     * re-invoking `_maybeProactiveRefresh` whenever the app comes back to the
+     * foreground, catching any timer that fired late or never fired at all.
+     */
+    private _scheduleNextRefresh;
+    /**
+     * Decide whether to actually run a refresh right now. Called both from the
+     * scheduler timer and from the visibility-change listener.
+     *
+     * Skip if:
+     *   - no session / no RT (nothing to refresh)
+     *   - app is hidden — wait for the visibility listener to re-trigger us
+     *   - `maxIdleMs` configured and no client request since that window — let
+     *     the next reactive 401-refresh handle it whenever the user comes back
+     *   - the AT still has more than `REFRESH_SKEW_SECONDS` of life — reschedule
+     *
+     * Otherwise call `refresh()`, which uses the existing in-flight singleton
+     * so we never collide with a reactive 401-triggered refresh. On failure,
+     * `_doRefresh` already calls `_clearSession`, so auth-state listeners see
+     * `step:'idle'` — no extra event dispatch needed here.
+     */
+    private _maybeProactiveRefresh;
+    private _clearRefreshTimer;
     getAuthState(): AuthState;
     onAuthStateChange(cb: (state: AuthState) => void): () => void;
+    /**
+     * Subscribe to persistent-storage degradation (Safari private mode,
+     * sandboxed iframes, quota errors, etc.). The SDK keeps running off
+     * in-memory storage after degrade, but sessions won't survive reload — a
+     * host UI typically wants to show "your session won't be saved" so the
+     * user isn't blindsided after a refresh.
+     *
+     * Fires at most once per client lifetime (the underlying adapter dedupes).
+     * Late subscribers receive the latched state synchronously on subscribe.
+     *
+     * Only fires when the SDK constructs the default storage adapter. If you
+     * pass a custom `config.storage`, wire your own notification path through
+     * that adapter's API — the SDK has no hook into it.
+     */
+    onStorageDegrade(cb: OnStorageDegrade): () => void;
+    private _dispatchStorageDegrade;
     /** PII (email, names, avatar, providers). Held in memory only — never persisted. */
     getUserProfile(): PollarUserProfile | null;
     login(options: PollarLoginOptions): void;
@@ -507,9 +748,81 @@ declare class PollarClient {
     getWalletBalanceState(): WalletBalanceState;
     onWalletBalanceStateChange(cb: (state: WalletBalanceState) => void): () => void;
     refreshBalance(publicKey?: string): Promise<void>;
-    buildTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<void>;
+    /**
+     * Builds an unsigned XDR. Drives `_setTransactionState` for modal-style UIs
+     * AND returns a {@link BuildOutcome} so headless callers can `await` and
+     * inspect the result without subscribing to state changes.
+     */
+    buildTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<BuildOutcome>;
     getWalletType(): WalletId | null;
-    signAndSubmitTx(unsignedXdr: string): Promise<void>;
+    /**
+     * Signs the given unsigned XDR and returns the signed XDR.
+     *
+     * - External wallets: signs locally via the wallet adapter.
+     * - Custodial wallets: posts to `/tx/sign`. The backend signs (through
+     *   wallet-service or the app's customer-managed adapter) and returns the
+     *   signed XDR plus an `idempotencyKey` the caller should echo back to
+     *   `submitTx`.
+     *
+     * Drives `_setTransactionState`: emits `signing` while in flight and
+     * `signed` on success (or `error[phase: 'signing']` on failure). `buildData`
+     * is threaded through if the consumer previously called `buildTx`.
+     */
+    signTx(unsignedXdr: string): Promise<SignOutcome>;
+    /**
+     * Submits a signed XDR via `/tx/submit` regardless of wallet type
+     * (custodial or external). Routing through sdk-api gives us:
+     *   - End-to-end tx_records persistence with full phase lifecycle so the
+     *     developer dashboard can show every tx (both custodial and external
+     *     wallet flows) at `/apps/:id/monitor/transactions`.
+     *   - Idempotency tracking via `submissionToken` (returned by `signTx`).
+     *   - A single response shape (SUCCESS / PENDING / FAILED) shared by both
+     *     flows — previously external wallets could only return SUCCESS or
+     *     error since the direct-to-Horizon path was synchronous.
+     *
+     * The extra hop adds ~50–150 ms vs. the legacy direct-Horizon path; the
+     * persistence + observability win is worth it.
+     *
+     * Drives `_setTransactionState`: emits `submitting` while in flight,
+     * `submitted` on Horizon ack (pending), `success` on ledger confirmation,
+     * or `error[phase: 'submitting']` on failure.
+     */
+    submitTx(signedXdr: string, opts?: {
+        submissionToken?: string;
+    }): Promise<SubmitOutcome>;
+    /**
+     * Signs and submits in one logical step. Returns a {@link SubmitOutcome}.
+     *
+     * - **External wallets**: composes `signTx` + `submitTx` client-side. State
+     *   machine sees the full granular sequence `signing → signed → submitting
+     *   → success` because the underlying methods each emit.
+     * - **Custodial wallets**: atomic `/tx/sign-and-send` round-trip. State
+     *   machine emits the compound `signing-submitting` step (the SDK can't
+     *   observe when one phase ends and the next begins inside that single
+     *   backend call) and then transitions to `submitted` (Horizon ack only) or
+     *   `success` (ledger-confirmed), or `error[phase: 'signing-submitting']`.
+     */
+    signAndSubmitTx(unsignedXdr: string): Promise<SubmitOutcome>;
+    /**
+     * One-shot: build → sign → submit, returning the final {@link SubmitOutcome}.
+     *
+     * - **External wallets**: composes `buildTx` + `signAndSubmitTx` client-side.
+     *   State machine sees the full granular sequence (`building → built →
+     *   signing → signed → submitting → success`) because each composed call
+     *   emits its own transitions.
+     * - **Custodial wallets**: single round-trip to `/tx/build-sign-submit`. The
+     *   signed XDR never leaves the backend. State machine emits the compound
+     *   `building-signing-submitting` step (the SDK can't observe individual
+     *   phase boundaries inside one atomic call) and then transitions to
+     *   `submitted` / `success` / `error[phase: 'building-signing-submitting']`.
+     *
+     * If you need granular UI feedback for custodial flows (separate
+     * "Building…", "Signing…", "Submitting…" indicators), call `buildTx`,
+     * `signTx`, and `submitTx` separately instead.
+     */
+    buildAndSignAndSubmitTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<SubmitOutcome>;
+    /** Alias for {@link buildAndSignAndSubmitTx} — shorter "just do the thing" name. */
+    runTx(operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']): Promise<SubmitOutcome>;
     getAppConfig(): Promise<unknown>;
     getKycStatus(providerId?: string): Promise<{
         status: KycStatus;
@@ -544,6 +857,8 @@ declare class PollarClient {
         intervalMs?: number;
         timeoutMs?: number;
     }): Promise<RampTxStatus>;
+    listDistributionRules(): Promise<DistributionRule[]>;
+    claimDistributionRule(body: DistributionClaimBody): Promise<DistributionClaimContent>;
     private _setTxHistoryState;
     private _setWalletBalanceState;
     private _newController;
@@ -563,6 +878,13 @@ declare class PollarClient {
     private _setNetworkState;
     private _setAuthState;
     private _setTransactionState;
+    /**
+     * Threads `buildData` through state transitions. When the user has already
+     * called `buildTx`, every subsequent state (signing, signed, submitting,
+     * submitted, success, error) should carry the build summary so modal UIs
+     * can keep showing "Send 5 USDC to G..." through the whole flow.
+     */
+    private _currentBuildData;
 }
 
 /**
@@ -953,9 +1275,18 @@ interface paths {
         trace?: never;
     };
     "/auth/logout": {
-        parameters: { query?: never; header?: never; path?: never; cookie?: never };
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         get?: never;
         put?: never;
+        /**
+         * Revoke the current session (or all sessions)
+         * @description Server-side logout. Default behavior revokes the refresh-token family bound to the current access token. Pass `{"everywhere":true}` to revoke every active family for the authenticated user (logout from all devices).
+         */
         post: operations["postAuthLogout"];
         delete?: never;
         options?: never;
@@ -964,7 +1295,16 @@ interface paths {
         trace?: never;
     };
     "/auth/sessions": {
-        parameters: { query?: never; header?: never; path?: never; cookie?: never };
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List active sessions for the authenticated user
+         * @description Returns one row per active refresh-token family with the metadata captured at issuance (user agent, hashed IP, optional device label). The session whose `current: true` flag matches the access token in use can be highlighted in the UI.
+         */
         get: operations["getAuthSessions"];
         put?: never;
         post?: never;
@@ -975,11 +1315,17 @@ interface paths {
         trace?: never;
     };
     "/auth/sessions/{familyId}": {
-        parameters: { query?: never; header?: never; path?: never; cookie?: never };
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         get?: never;
         put?: never;
         post?: never;
-        delete: operations["deleteAuthSessionByFamilyId"];
+        /** Revoke a specific session (refresh-token family) */
+        delete: operations["deleteAuthSessionsByFamilyId"];
         options?: never;
         head?: never;
         patch?: never;
@@ -1065,6 +1411,66 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/tx/sign": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Sign an unsigned XDR (split flow)
+         * @description Sign-only step of the split build/sign/submit flow. For custodial wallets, the signed XDR is returned to the caller so it can be submitted later via POST /tx/submit. External wallets sign client-side and do not call this endpoint.
+         */
+        post: operations["postTxSign"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/tx/submit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Submit a pre-signed XDR
+         * @description Submit step of the split build/sign/submit flow. Accepts a signed XDR produced by /tx/sign or by an external-wallet adapter. Goes through wallet-service /v1/tx/submit so the submission is policy-validated and idempotency-tracked.
+         */
+        post: operations["postTxSubmit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/tx/build-sign-submit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Atomic build + sign + submit (one round-trip)
+         * @description Server-side composition of /tx/build + /tx/sign + /tx/submit. The signed XDR never leaves the backend. Use for headless / server-driven flows that do not need intermediate state-machine transitions on the client.
+         */
+        post: operations["postTxBuildSignSubmit"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/tx/status": {
         parameters: {
             query?: never;
@@ -1105,6 +1511,46 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/charges": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create a charge
+         * @description Creates a Pollar Pay point-of-sale charge for one of the application branches. Reserves a pool wallet (the address the customer pays to) and returns the payment intent.
+         */
+        post: operations["postCharges"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/charges/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get charge status
+         * @description Returns the live status of a charge. A pending charge past its window reads as expired.
+         */
+        get: operations["getChargesById"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/wallet/balance": {
         parameters: {
             query?: never;
@@ -1265,6 +1711,46 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/distribution/rules": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List distribution rules
+         * @description Returns every distribution rule defined for the calling application, each decorated with a `claimable` flag and (when not claimable) a `reason` ErrorCode the SDK can map to a UI message (expired, already claimed in window, exhausted, etc.).
+         */
+        get: operations["getDistributionRules"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/distribution/claim": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Claim a distribution rule
+         * @description Executes a claim against the given rule for the authenticated sdk-user. The server runs the same claimability checks as GET /distribution/rules against fresh counts; only the txHash and amount are returned on success.
+         */
+        post: operations["postDistributionClaim"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 interface operations {
     getHealth: {
@@ -1332,7 +1818,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1345,7 +1831,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1358,7 +1844,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1420,7 +1906,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1433,7 +1919,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1446,7 +1932,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1459,7 +1945,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1494,7 +1980,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1507,7 +1993,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1520,7 +2006,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1533,7 +2019,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1567,7 +2053,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1580,7 +2066,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1593,7 +2079,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1643,7 +2129,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1656,7 +2142,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1669,7 +2155,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1682,7 +2168,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1730,7 +2216,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1743,7 +2229,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1756,7 +2242,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1769,7 +2255,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1818,7 +2304,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1831,7 +2317,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1844,7 +2330,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1857,7 +2343,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1949,7 +2435,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1962,7 +2448,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1975,7 +2461,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -1988,7 +2474,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2039,7 +2525,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2052,7 +2538,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2065,7 +2551,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2078,22 +2564,28 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
         };
     };
-    getApplicationsConfig: {
+    postAuthLogout: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    everywhere?: boolean;
+                };
+            };
+        };
         responses: {
-            /** @description Application config */
+            /** @description Sessions revoked */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2101,24 +2593,171 @@ interface operations {
                 content: {
                     "application/json": {
                         /** @constant */
-                        code: "SDK_APPLICATION_CONFIG";
+                        code: "SDK_LOGOUT_SUCCESS";
                         /** @constant */
                         success: true;
                         content: {
-                            application: {
-                                name: string;
-                            };
-                            styles: {
-                                theme?: string;
-                                accentColor?: string;
-                                logoUrl?: string;
-                                emailEnabled?: boolean;
-                                embeddedWallets?: boolean;
-                                providers?: {
-                                    google?: boolean;
-                                    discord?: boolean;
-                                    x?: boolean;
-                                    github?: boolean;
+                            revoked: number;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    getAuthSessions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Sessions list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_SESSIONS_LIST";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            sessions: {
+                                familyId: string;
+                                createdAt: string;
+                                lastUsedAt: string | null;
+                                userAgent: string | null;
+                                ipHash: string | null;
+                                deviceLabel: string | null;
+                                current: boolean;
+                                expiresAt: string;
+                            }[];
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    deleteAuthSessionsByFamilyId: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                familyId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Session revoked */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_SESSION_REVOKED";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            revoked: number;
+                        };
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    getApplicationsConfig: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Application config */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_APPLICATION_CONFIG";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            application: {
+                                name: string;
+                            };
+                            styles: {
+                                theme?: string;
+                                accentColor?: string;
+                                logoUrl?: string;
+                                emailEnabled?: boolean;
+                                embeddedWallets?: boolean;
+                                providers?: {
+                                    google?: boolean;
+                                    discord?: boolean;
+                                    x?: boolean;
+                                    github?: boolean;
                                     apple?: boolean;
                                 };
                             };
@@ -2135,7 +2774,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2148,7 +2787,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2161,7 +2800,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2196,7 +2835,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2447,7 +3086,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2460,7 +3099,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2473,7 +3112,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2518,8 +3157,488 @@ interface operations {
                     };
                 };
             };
-            /** @description Validation error */
-            400: {
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Signing or submission error (upstream/RPC) */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    postTxSign: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    network: "testnet" | "mainnet";
+                    publicKey: string;
+                    unsignedXdr: string;
+                    idempotencyKey?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Signed XDR + idempotency key to use with /tx/submit */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_TX_SIGNED";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            signedXdr: string;
+                            idempotencyKey: string;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Signing error */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    postTxSubmit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    network: "testnet" | "mainnet";
+                    publicKey: string;
+                    signedXdr: string;
+                    idempotencyKey?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Submit result (PENDING | SUCCESS | FAILED) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_TX_SUBMIT";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            hash: string;
+                            /** @enum {string} */
+                            status: "PENDING" | "SUCCESS" | "FAILED";
+                            resultCode?: string;
+                            message?: string;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Submission error (RPC/network) */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    postTxBuildSignSubmit: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    network: "testnet" | "mainnet";
+                    publicKey: string;
+                    options?: {
+                        timeoutSec?: number;
+                        memo?: {
+                            /** @constant */
+                            type: "text";
+                            value: string;
+                        } | {
+                            /** @constant */
+                            type: "id";
+                            value: string;
+                        };
+                        maxFeeStroops?: number;
+                    };
+                } & ({
+                    /** @constant */
+                    operation: "payment";
+                    params: {
+                        destination: string;
+                        amount: string;
+                        asset: {
+                            /** @constant */
+                            type: "native";
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum4";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum12";
+                            code: string;
+                            issuer: string;
+                        };
+                    };
+                } | {
+                    /** @constant */
+                    operation: "change_trust";
+                    params: {
+                        asset: {
+                            /** @constant */
+                            type: "credit_alphanum4";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum12";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "liquidity_pool_shares";
+                            assetA: {
+                                /** @constant */
+                                type: "native";
+                            } | {
+                                /** @constant */
+                                type: "credit_alphanum4";
+                                code: string;
+                                issuer: string;
+                            } | {
+                                /** @constant */
+                                type: "credit_alphanum12";
+                                code: string;
+                                issuer: string;
+                            };
+                            assetB: {
+                                /** @constant */
+                                type: "native";
+                            } | {
+                                /** @constant */
+                                type: "credit_alphanum4";
+                                code: string;
+                                issuer: string;
+                            } | {
+                                /** @constant */
+                                type: "credit_alphanum12";
+                                code: string;
+                                issuer: string;
+                            };
+                        };
+                        limit?: string;
+                    };
+                } | {
+                    /** @constant */
+                    operation: "path_payment_strict_send";
+                    params: {
+                        destination: string;
+                        sendAsset: {
+                            /** @constant */
+                            type: "native";
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum4";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum12";
+                            code: string;
+                            issuer: string;
+                        };
+                        sendAmount: string;
+                        destAsset: {
+                            /** @constant */
+                            type: "native";
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum4";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum12";
+                            code: string;
+                            issuer: string;
+                        };
+                        destMin: string;
+                        /** @default [] */
+                        path?: ({
+                            /** @constant */
+                            type: "native";
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum4";
+                            code: string;
+                            issuer: string;
+                        } | {
+                            /** @constant */
+                            type: "credit_alphanum12";
+                            code: string;
+                            issuer: string;
+                        })[];
+                    };
+                } | {
+                    /** @constant */
+                    operation: "create_account";
+                    params: {
+                        destination: string;
+                        startingBalance: string;
+                    };
+                } | {
+                    /** @constant */
+                    operation: "invoke_contract";
+                    params: {
+                        contractId: string;
+                        method: string;
+                        /** @default [] */
+                        args?: ({
+                            /** @constant */
+                            type: "bool";
+                            value: boolean;
+                        } | {
+                            /** @constant */
+                            type: "i32";
+                            value: number;
+                        } | {
+                            /** @constant */
+                            type: "u32";
+                            value: number;
+                        } | {
+                            /** @enum {string} */
+                            type: "i64" | "u64" | "i128" | "u128" | "i256" | "u256";
+                            value: string;
+                        } | {
+                            /** @constant */
+                            type: "address";
+                            value: string;
+                        } | {
+                            /** @enum {string} */
+                            type: "string" | "symbol";
+                            value: string;
+                        } | {
+                            /** @constant */
+                            type: "bytes";
+                            /** @description Base64-encoded bytes */
+                            value: string;
+                        } | {
+                            /** @constant */
+                            type: "vec";
+                            /** @description Array of ScValArg items */
+                            value: unknown[];
+                        } | {
+                            /** @constant */
+                            type: "map";
+                            /** @description Array of {key, val} ScValArg pairs */
+                            value: {
+                                key: unknown;
+                                val: unknown;
+                            }[];
+                        } | {
+                            /** @constant */
+                            type: "void";
+                        })[];
+                    };
+                }) & {
+                    idempotencyKey?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Final submit result with the original build summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_TX_SUBMIT";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            hash: string;
+                            /** @enum {string} */
+                            status: "PENDING" | "SUCCESS" | "FAILED";
+                            resultCode?: string;
+                            message?: string;
+                            summary: {
+                                title: string;
+                                lines: string[];
+                                network: string;
+                                fee: string;
+                            };
+                            estimatedFee: string;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2527,12 +3646,12 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
-            /** @description Unauthorized */
-            401: {
+            /** @description Build/sign/submit error */
+            502: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2540,7 +3659,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2589,7 +3708,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2602,7 +3721,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2665,7 +3784,171 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
+    postCharges: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Charge created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_CHARGE_CREATED";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            chargeId: string;
+                            walletAddress: string;
+                            reason: string;
+                            amount: string;
+                            asset: string;
+                            network: string;
+                            expiresAt: string;
+                            timeRemainingSeconds: number;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description No pool wallet available */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        chargeId: string;
+                        walletAddress: string;
+                        reason: string;
+                        amount: string;
+                        asset: string;
+                        network: string;
+                        expiresAt: string;
+                        timeRemainingSeconds: number;
+                    };
+                };
+            };
+        };
+    };
+    getChargesById: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Charge status */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_CHARGE_STATUS";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            chargeId: string;
+                            /** @enum {string} */
+                            status: "pending" | "completed" | "overpaid" | "underpaid" | "expired" | "refunded";
+                            reason: string;
+                            amountExpected: string;
+                            amountPaid: string;
+                            remaining: string;
+                            asset: string;
+                            walletAddress: string;
+                            network: string;
+                            expiresAt: string;
+                            timeRemainingSeconds: number;
+                            isExpired: boolean;
+                            feeAmount: string | null;
+                            payoutAmount: string | null;
+                            forwardTxHash: string | null;
+                            createdAt: string;
+                        };
                     };
                 };
             };
@@ -2678,7 +3961,33 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
                     };
                 };
             };
@@ -2736,7 +4045,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2749,7 +4058,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2797,7 +4106,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2810,7 +4119,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2823,7 +4132,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2872,7 +4181,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2885,7 +4194,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2940,7 +4249,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2953,7 +4262,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -2966,7 +4275,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3024,7 +4333,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3037,7 +4346,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3099,7 +4408,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3112,7 +4421,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3125,7 +4434,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3184,7 +4493,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3197,7 +4506,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3210,7 +4519,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3262,7 +4571,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3275,7 +4584,7 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3288,97 +4597,148 @@ interface operations {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
         };
     };
-    postAuthLogout: {
-        parameters: { query?: never; header?: never; path?: never; cookie?: never };
-        requestBody?: {
-            content: {
-                "application/json": {
-                    everywhere?: boolean;
-                };
-            };
+    getDistributionRules: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
+            /** @description List of distribution rules with claimability verdict per rule */
             200: {
-                headers: { [name: string]: unknown };
+                headers: {
+                    [name: string]: unknown;
+                };
                 content: {
                     "application/json": {
                         /** @constant */
-                        code: "SDK_LOGOUT_SUCCESS";
+                        code: "SDK_DISTRIBUTION_RULES_LIST";
                         /** @constant */
                         success: true;
                         content: {
-                            revoked: number;
+                            rules: {
+                                id: string;
+                                name: string;
+                                assetCode: string;
+                                amount: string;
+                                /** @enum {string} */
+                                period: "DAY" | "DAY_CALENDAR" | "WEEK" | "MONTH" | "MONTH_CALENDAR" | "LIFETIME";
+                                validFrom: string | null;
+                                validUntil: string | null;
+                                claimable: boolean;
+                                reason: string | null;
+                            }[];
                         };
                     };
                 };
             };
-        };
-    };
-    getAuthSessions: {
-        parameters: { query?: never; header?: never; path?: never; cookie?: never };
-        requestBody?: never;
-        responses: {
-            200: {
-                headers: { [name: string]: unknown };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
                 content: {
                     "application/json": {
                         /** @constant */
-                        code: "SDK_SESSIONS_LIST";
-                        /** @constant */
-                        success: true;
-                        content: {
-                            sessions: {
-                                familyId: string;
-                                createdAt: string;
-                                lastUsedAt: string | null;
-                                userAgent: string | null;
-                                ipHash: string | null;
-                                deviceLabel: string | null;
-                                current: boolean;
-                                expiresAt: string;
-                            }[];
-                        };
+                        success: false;
+                        code: string;
                     };
                 };
             };
         };
     };
-    deleteAuthSessionByFamilyId: {
+    postDistributionClaim: {
         parameters: {
             query?: never;
             header?: never;
-            path: { familyId: string };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": {
+                    ruleId: string;
+                };
+            };
+        };
         responses: {
+            /** @description Claim succeeded — payment submitted to Stellar */
             200: {
-                headers: { [name: string]: unknown };
+                headers: {
+                    [name: string]: unknown;
+                };
                 content: {
                     "application/json": {
                         /** @constant */
-                        code: "SDK_SESSION_REVOKED";
+                        code: "SDK_DISTRIBUTION_CLAIM_OK";
                         /** @constant */
                         success: true;
                         content: {
-                            revoked: number;
+                            ruleId: string;
+                            assetCode: string;
+                            amount: string;
+                            txHash: string | null;
                         };
                     };
                 };
             };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Rule not found, user has no wallet, or application has no distribution wallet */
             404: {
-                headers: { [name: string]: unknown };
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Rule not claimable (disabled, expired, exhausted, rate-limited) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
                 content: {
                     "application/json": {
                         /** @constant */
                         success: false;
-                        error: string;
+                        code: string;
                     };
                 };
             };
@@ -3468,4 +4828,18 @@ declare function pollRampTransaction(api: PollarApiClient, txId: string, { inter
     timeoutMs?: number;
 }): Promise<RampTxStatus>;
 
-export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthState, type BuildProofArgs, type ConnectWalletResponse, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type NetworkState, OnStorageDegrade, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type SessionInfo, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type TransactionState, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignSendResponse, type WalletAdapter, type WalletAdapterResolver, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, computeJwkThumbprint, createLocalStorageAdapter, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };
+/**
+ * GET /distribution/rules
+ * Returns the distribution rules visible to the calling sdk-user, each
+ * decorated with `claimable` and (when not claimable) a `reason` ErrorCode
+ * the UI maps to a friendly message.
+ */
+declare function listDistributionRules(api: PollarApiClient): Promise<DistributionRule[]>;
+/**
+ * POST /distribution/claim
+ * Claims the given rule for the authenticated sdk-user. Returns the tx hash
+ * once the payment is submitted to Stellar.
+ */
+declare function claimDistributionRule(api: PollarApiClient, body: DistributionClaimBody): Promise<DistributionClaimContent>;
+
+export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthState, type BuildOutcome, type BuildProofArgs, type ConnectWalletResponse, type DistributionClaimBody, type DistributionClaimContent, type DistributionRule, type DistributionRulesState, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type NetworkState, OnStorageDegrade, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type RulePeriod, type SessionInfo, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignOutcome, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type SubmitOutcome, type TransactionState, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxBuildSignSubmitBody, type TxBuildSignSubmitContent, type TxBuildSignSubmitResponse, type TxErrorPhase, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignBody, type TxSignContent, type TxSignResponse, type TxSignSendResponse, type TxSubmitSignedBody, type WalletAdapter, type WalletAdapterResolver, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, claimDistributionRule, computeJwkThumbprint, createLocalStorageAdapter, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, listDistributionRules, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };