@stable_sea/sdk 0.1.2 → 0.1.4

package/README.md

@@ -34,6 +34,27 @@ carries fixed scopes, so do not send a `Stable-Sea-Account` header.
 | SDK | API contract | Credentials |
 |---|---|---|
 | `0.1.x` | `2026-07-23` | `sk_live_…` on production |
+| `0.1.x` | `2026-07-23` | `sk_test_…` on sandbox |
+
+API access enables both Live and Sandbox. In Terminal, open **API keys** and
+create a key under **Test keys**. Set `baseUrl` to
+`https://sandbox-api.stablesea.com` and use that `sk_test_…` key. The same client,
+contract and idempotency rules apply.
+See the [sandbox quickstart](https://docs.stablesea.com/api/#sandbox) for simple
+instructions and the downloadable SDK test project.
+
+Sandbox uses synthetic balances and simulated financial partners; it cannot move
+real money. Production refuses Test credentials, and the stable sandbox refuses
+Live credentials. Create, rotate and revoke both kinds of keys in the same
+Terminal pane with the same business permissions. Live keys require a fresh
+two-factor code; Test keys do not. The first
+Test key prepares isolated balances of 100,000 USDC and 50,000 WTGXX; additional
+keys and rotations reuse that data.
+
+Available funds and settlement modes follow the production contract: WTGXX
+supports standard and instant settlement; FLTTX uses standard settlement. An
+unsupported instant order must produce the normal refusal rather than simulated
+liquidity that would not exist in production.
 
 ## Idempotent writes
 
@@ -69,3 +90,11 @@ const valid = await verifyWebhookSignature(
 API request, response, pagination, and error types are generated from
 `services/backend/api/openapi.public.json` and exported as `paths`, `operations`,
 and `components`.
+
+## Contract changes
+
+- `GET /v1/balances`: `chain` gains the value `solana`. A USDC balance held on
+  Solana (`segregated_rail: onchain_solana`) now reports `chain: "solana"`;
+  before this it reported `chain: "unknown"`. Code that switches on `chain`
+  should accept the new value, and code that keyed a Solana balance by its
+  `unknown` row should expect the `solana` row instead.

package/dist/gen/schema.d.ts

@@ -153,7 +153,9 @@ export interface paths {
          * List events
          * @description Lists the events recorded for the platform, newest first.
          *
-         *     SCOPING. The response covers every event this credential recorded, so one cursor sweep reconciles everything. There is no narrower scope to ask for: one credential addresses one business.
+         *     SCOPING. The response covers every event this credential recorded except those about pay-ins and payouts, so one cursor sweep reconciles everything this API serves. There is no narrower scope to ask for: one credential addresses one business.
+         *
+         *     PAY-INS AND PAYOUTS ARE NOT SERVED. An event about a pay-in or a payout is never listed, and neither is one about a held deposit, which has no /v1 transaction. That holds for events recorded before this API stopped serving payments as well. A withheld event is answered like an id that names no event, and a cursor that names one is refused like a cursor that names no event, so restart from the newest page by sending no cursor.
          *
          *     FRESHNESS. An event becomes listable 60 seconds after its created_ts. Inside that window it can be retrieved by id but is not returned here. Once a page has been served, the range it covers is complete and final: no older event can appear behind a cursor that has already passed it. Retrieval by id is not lagged.
          *
@@ -183,7 +185,7 @@ export interface paths {
          *
          *     FRESHNESS. Retrieval is not lagged: an event is readable as soon as it is recorded, including during the 60 seconds before it becomes listable.
          *
-         *     SCOPING. Any event this credential recorded may be retrieved, and nothing else. An id that names no event, one belonging to another business, and one recorded in the other environment are answered identically.
+         *     SCOPING. Any event this credential recorded may be retrieved, and nothing else, with one exclusion: an event about a pay-in, a payout or a held deposit is not served, because this API never serves those. An id that names no event, one belonging to another business, one recorded in the other environment, and one withheld for that reason are answered identically.
          *
          *     RETENTION. An event remains retrievable for at least 90 days after it is recorded.
          */
@@ -196,6 +198,96 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/external_wallets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List external wallets
+         * @description Lists the external wallets the business has connected: the addresses it whitelisted for withdrawals, each with the latest on-chain holdings of the tokens Stable Sea tracks.
+         *
+         *     THESE ARE NOT STABLE SEA BALANCES. holdings is read from the chain and describes the address; it is not money Stable Sea holds, and it is never part of /v1/balances.
+         *
+         *     HOLDINGS ARE READ ONLY FOR MONITORED WALLETS: enabled, cleared for withdrawals, and on a network we read (Ethereum, Stellar). Every other wallet is still listed, with holdings_status not_monitored and no holdings. Holdings are read in the background every few minutes, not on request. A reading is served for at most 15 minutes: holdings_status is ok when the latest read succeeded and stale when it failed and the last good reading is shown, and holdings_read_ts says when it was read. unavailable means there is no reading, not that the wallet is empty. A Stellar address with a memo is a shared deposit address and is answered shared_address.
+         *
+         *     PAGING. limit defaults to 10 and may not exceed 100; a larger value is rejected rather than reduced. starting_after and ending_before each take an external wallet id and cannot be combined. Wallets are ordered newest first by created_ts, ties by id. A cursor that names no current wallet is rejected rather than ignored.
+         */
+        get: operations["external_wallets.list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/external_wallets/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve an external wallet
+         * @description Retrieves one external wallet by id, with its latest on-chain holdings when the wallet is monitored.
+         *
+         *     holdings is read from the chain and is not money Stable Sea holds. See the listing for what each holdings_status means.
+         *
+         *     SCOPING. Any wallet this credential's business has connected may be retrieved, and nothing else. An id that names no wallet, one belonging to another business, and one whose wallet has been removed are answered identically.
+         */
+        get: operations["external_wallets.get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/notifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List notifications
+         * @description Lists eligible business-wide notices newest first after a 60-second stability window. Personal, integration, and bell seen-state notifications are excluded. A locked business cannot read the feed. A test credential cannot read live notices.
+         */
+        get: operations["notifications.list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/notifications/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve a notification
+         * @description Returns one eligible business-wide notice by id. Other businesses' and excluded notices are indistinguishable from unknown ids. A test credential cannot read live notices. Notifications already announced in the credential environment remain retrievable after a ledger-mode cutover.
+         */
+        get: operations["notifications.retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/orders": {
         parameters: {
             query?: never;
@@ -244,6 +336,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/policies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read effective money controls
+         * @description Read the authenticated business's movement switches, effective calendar/rolling limits and outgoing approval tiers. No policy or financial writes. These are current observations, not a transfer authorization. No withdrawal endpoint is enabled by this read. Delay/cooloff report supported=false; null limits mean no flow-wide cap, not unavailable data. Highest matching approval minimum applies when USD valuation is known. If USD valuation is unavailable for an on-chain withdrawal or fund trade, the highest configured approval rule for that flow applies regardless of amount. Changed pending policies require resubmission.
+         */
+        get: operations["policies.snapshot"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/quotes": {
         parameters: {
             query?: never;
@@ -328,6 +440,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/statements/{id}/content": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve statement content
+         * @description Returns the immutable issued statement values as display-ready JSON. Corrected statements remain retrievable and name their replacement. Pay-ins and payouts are not served on this API, so they are not listed in transactions; the balances and totals are the printed ones and still include their effect, which means a statement for a period in which the business made a payment does not reconcile from its transactions alone.
+         */
+        get: operations["statements.content.retrieve"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/transactions": {
         parameters: {
             query?: never;
@@ -339,11 +471,13 @@ export interface paths {
          * List transactions
          * @description Lists the business's money movements, newest first.
          *
-         *     SCOPING. The response covers every movement booked for this credential's business, so one cursor sweep reconciles everything. There is no narrower scope to ask for: one credential addresses one business.
+         *     SCOPING. The response covers every movement booked for this credential's business except the pay-ins and payouts described below, so one cursor sweep reconciles everything this API serves. There is no narrower scope to ask for: one credential addresses one business.
+         *
+         *     WHAT A ROW IS. One row is one MOVEMENT — the whole operation, not its ledger legs. asset_changes carries its signed net effect on the business's own holdings, one entry per asset: negative left, positive arrived. Amounts are net of the ledger's fees and taxes, on the same basis /v1/balances reports. Legs that touch accounts /v1/balances does not report are left out — a bank account, a whitelisted withdrawal address — and so are legs that failed, which never reached a balance.
          *
-         *     WHAT A ROW IS. One row is one MOVEMENT — the whole operation, not its ledger legs. asset_changes carries its signed net effect on the business's own holdings, one entry per asset: negative left, positive arrived. Amounts are net of the ledger's fees and taxes, on the same basis /v1/balances reports. Legs that touch accounts /v1/balances does not report are left out — a payout's beneficiary side, a bank account, a whitelisted withdrawal address — and so are legs that failed, which never reached a balance.
+         *     PAY-INS AND PAYOUTS ARE NOT SERVED. This API never lists a pay-in or a payout — not as a row here, not as a statement entry, not as an event — for any business, whatever its Payments settings say. Payments are managed in the dashboard, not on this API.
          *
-         *     RECONCILING AGAINST /v1/balances. Sum an asset's amounts across EVERY transaction, with no filter on status, and the total is the movement in that asset's settled balance. Do not restrict the sum to completed transactions: asset_changes reports what has SETTLED, which is not the same fact as the movement's status. A movement whose legs are still in flight reports no change at all, even one already marked processing; a movement that FAILED after part of it settled reports the part that settled, because that money really moved.
+         *     RECONCILING AGAINST /v1/balances. For a business with no pay-ins or payouts, sum an asset's amounts across EVERY transaction, with no filter on status, and the total is the movement in that asset's settled balance. Do not restrict the sum to completed transactions: asset_changes reports what has SETTLED, which is not the same fact as the movement's status. A movement whose legs are still in flight reports no change at all, even one already marked processing; a movement that FAILED after part of it settled reports the part that settled, because that money really moved. THE EXCEPTION IS PAYMENTS: /v1/balances and a statement's totals still include the effect of a pay-in or payout, but this listing does not serve the movement. A business with payment movements therefore cannot reconcile its balance from /v1/transactions alone — the transactions sum short by exactly its payments.
          *
          *     STATUS. pending means no leg has been picked up yet. processing means at least one leg is in flight. completed means every leg settled, and completed_ts is the instant the last one did. failed means the movement terminated without settling, and failed_ts is when. The two non-terminal states are reported separately because they call for opposite responses: a movement nothing has touched may be worth chasing, one already in flight must be left alone.
          *
@@ -377,7 +511,7 @@ export interface paths {
          *
          *     FIGURES. asset_changes is the signed net effect on the business's OWN SETTLED holdings, one entry per asset: negative left, positive arrived. Amounts are net of the ledger's fees and taxes, on the same basis /v1/balances reports. Legs touching accounts /v1/balances does not report are left out, and so are legs that failed — a failed leg never reached a balance.
          *
-         *     IT REPORTS WHAT SETTLED, NOT WHAT THE STATUS SAYS. A movement still in flight reports no change at all, because none of its legs has reached a balance yet. A movement that failed after part of it settled reports the part that settled. One whose every leg failed reports no change. Sum an asset's amounts across every transaction — with no filter on status — to reconcile against /v1/balances.
+         *     IT REPORTS WHAT SETTLED, NOT WHAT THE STATUS SAYS. A movement still in flight reports no change at all, because none of its legs has reached a balance yet. A movement that failed after part of it settled reports the part that settled. One whose every leg failed reports no change. For a business with no pay-ins or payouts, sum an asset's amounts across every transaction — with no filter on status — to reconcile against /v1/balances. Pay-ins and payouts are never served on this API, though /v1/balances still includes their effect, so a business with payment movements cannot reconcile its balance from /v1/transactions alone.
          *
          *     STATUS. The four states are pending, processing, completed and failed. completed_ts and failed_ts are mutually exclusive, and neither is present while the movement is in flight.
          *
@@ -449,7 +583,7 @@ export interface paths {
         };
         /**
          * List webhook deliveries
-         * @description Lists secret-free delivery health for an endpoint, newest first. limit defaults to 10 and may not exceed 100. starting_after and ending_before are mutually exclusive.
+         * @description Lists secret-free delivery health for an endpoint, newest first. limit defaults to 10 and may not exceed 100. starting_after and ending_before are mutually exclusive. Deliveries of events about pay-ins and payouts (and held deposits, which have no /v1 transaction) are not served, and none is sent. A cursor that names a withheld delivery is refused like a cursor that names no delivery, so restart from the newest page by sending no cursor.
          */
         get: operations["webhook_deliveries.list"];
         put?: never;
@@ -469,7 +603,7 @@ export interface paths {
         };
         /**
          * Retrieve a webhook delivery
-         * @description Retrieves delivery health for one endpoint and event.
+         * @description Retrieves delivery health for one endpoint and event. Deliveries of events about pay-ins and payouts (and held deposits, which have no /v1 transaction) are not served, and none is sent. Asking for one is answered like an id that names no delivery.
          */
         get: operations["webhook_deliveries.get"];
         put?: never;
@@ -491,7 +625,7 @@ export interface paths {
         put?: never;
         /**
          * Replay a webhook delivery
-         * @description Requeues one dead webhook delivery using its original event and endpoint revision, with a new three-day retry window.
+         * @description Requeues one dead webhook delivery using its original event and endpoint revision, with a new three-day retry window. Deliveries of events about pay-ins and payouts (and held deposits, which have no /v1 transaction) are not served, and none is sent. Asking to replay one is answered like an id that names no delivery, and nothing is requeued.
          */
         post: operations["webhook_deliveries.replay"];
         delete?: never;
@@ -588,7 +722,7 @@ export interface components {
              * @description The network this holding sits on. off_chain is the chain-agnostic omnibus balance; unknown means the chain could not be attributed, and the holding is reported anyway rather than dropped.
              * @enum {string}
              */
-            chain: "off_chain" | "ethereum" | "arbitrum" | "base" | "stellar" | "unknown";
+            chain: "off_chain" | "ethereum" | "arbitrum" | "base" | "stellar" | "solana" | "unknown";
             /**
              * Format: date-time
              * @description The instant the ledger was cut and the assets were priced. Every figure below is as of this instant.
@@ -596,7 +730,7 @@ export interface components {
             created_ts: string;
             /** @description The balance id. Derived from (business, chain, source, asset, segregated rail), so it is stable across reads and safe to diff against. */
             id: string;
-            /** @description Always true. A balance is a fact about real custodied money; there is no test ledger. */
+            /** @description False only for an isolated mock-money-only ledger; independent of the reading credential. */
             livemode: boolean;
             /** @enum {string} */
             object: "balance";
@@ -686,7 +820,69 @@ export interface components {
             object: "list";
         };
         /** @enum {string} */
-        EventTypeName: "order.updated" | "transaction.created" | "transaction.updated";
+        EventTypeName: "notification.created" | "order.updated" | "transaction.created" | "transaction.updated";
+        ExternalWallet: {
+            /** @description The wallet's on-chain address, exactly as the business connected it. */
+            address: string;
+            /**
+             * Format: date-time
+             * @description When the wallet was connected. The list is ordered and paged on this instant.
+             */
+            created_ts: string;
+            /**
+             * Format: uri
+             * @description The address's page on a public block explorer. Absent when the network has none.
+             */
+            explorer_url?: string;
+            /** @description The wallet's non-zero holdings of the tokens Stable Sea tracks, read from the chain. Only populated when holdings_status is ok or stale; an ok reading with no entries means the wallet holds none of those tokens. These are not funds Stable Sea holds, and they are never part of /v1/balances. */
+            holdings: components["schemas"]["ExternalWalletHolding"][];
+            /**
+             * Format: date-time
+             * @description When holdings was read from the chain. Present only when holdings_status is ok or stale.
+             */
+            holdings_read_ts?: string;
+            /**
+             * @description Whether holdings carries a reading. ok: the latest read succeeded. stale: the latest read failed, and holdings is the last good read. Either way holdings_read_ts says when it was read, and it is at most 15 minutes old. unavailable: no good read within 15 minutes; holdings is empty, which says nothing about what the wallet holds. shared_address: a Stellar address with a memo, which holds other people's funds and is never read. not_monitored: the wallet's holdings are not read, because it is disabled, on a network we do not monitor, or not yet cleared for withdrawals.
+             * @enum {string}
+             */
+            holdings_status: "ok" | "stale" | "unavailable" | "shared_address" | "not_monitored";
+            /** @description The external wallet id. Stable for the life of the wallet and safe to store. */
+            id: string;
+            /** @description False only under the validated mock-money-only profile; independent of the reading credential. */
+            livemode: boolean;
+            /** @description The Stellar memo the business attached to the address. Absent when there is none. A wallet with a memo is a shared deposit address, such as an exchange's, and its holdings are never read. */
+            memo?: string;
+            /** @enum {string} */
+            object: "external_wallet";
+            /** @description The network the wallet is on, as a withdrawal rail (onchain_ethereum, onchain_stellar). */
+            payment_rail: string;
+            /**
+             * @description enabled: the business has the wallet switched on as a withdrawal destination (a withdrawal to it can still be held for review). disabled: the business switched it off, and withdrawals to it are refused until it is enabled again.
+             * @enum {string}
+             */
+            status: "enabled" | "disabled";
+        };
+        ExternalWalletHolding: {
+            /** @description The quantity held, in the token's own units. Exact, never rounded, and always above zero. */
+            amount: string;
+            /** @description The token's on-chain identity: the ERC-20 contract address on Ethereum, CODE:ISSUER on Stellar. Two tokens can share a symbol; this cannot. */
+            asset_ref: string;
+            /** @description The token's symbol (USDC, WTGXX). */
+            symbol: string;
+            /** @description The holding valued in USD, to the cent. null when valuation_basis is none: a token we do not value carries no dollar figure rather than a zero. */
+            usd_value: string | null;
+            /**
+             * @description How usd_value was reached. pegged: valued at 1.00 USD per unit, the fixed value Stable Sea's own ledger gives this asset. assumed_par: a USD stablecoin Stable Sea does not price, valued at 1.00 USD per unit by assumption. none: no price source, so not valued. usd_value is for display and is never part of a Stable Sea balance.
+             * @enum {string}
+             */
+            valuation_basis: "pegged" | "assumed_par" | "none";
+        };
+        ExternalWalletList: {
+            data: components["schemas"]["ExternalWallet"][];
+            has_more: boolean;
+            /** @enum {string} */
+            object: "list";
+        };
         List: {
             data: components["schemas"]["Resource"][];
             has_more: boolean;
@@ -697,6 +893,32 @@ export interface components {
         Metadata: {
             [key: string]: string;
         };
+        Notification: {
+            /** Format: date-time */
+            created_ts: string;
+            id: string;
+            livemode: boolean;
+            /** @enum {string} */
+            object: "notification";
+            resource?: {
+                id: string;
+                /** @enum {string} */
+                object: "statement";
+            };
+            /** @enum {string} */
+            type: "balance_statement_ready" | "payout_destination_changed" | "account_frozen" | "deposit_refused_embargo";
+        };
+        NotificationList: {
+            data: components["schemas"]["Notification"][];
+            has_more: boolean;
+            /** @enum {string} */
+            object: "list";
+        };
+        NotificationResource: {
+            id: string;
+            /** @enum {string} */
+            object: "statement";
+        };
         Order: {
             amount: string;
             /** Format: date-time */
@@ -740,6 +962,112 @@ export interface components {
             /** @enum {string} */
             object: "list";
         };
+        Policy: {
+            /** @description If USD valuation is unavailable for an on-chain withdrawal or fund trade, the highest configured approval rule for that flow applies regardless of amount. */
+            approval_tiers: components["schemas"]["PolicyApprovalTier"][];
+            /** @description The business's movement switch; not a guarantee that identity, compliance, asset or partner checks will permit execution. */
+            enabled: boolean;
+            limits: components["schemas"]["PolicyLimits"];
+            new_destination_cooloff: {
+                /** @description False: this control has not been implemented. */
+                supported: boolean;
+            };
+            /** @enum {string} */
+            object: "policy";
+            rail: string;
+            release_delay: {
+                /** @description False: this control has not been implemented. */
+                supported: boolean;
+            };
+        };
+        /** @enum {string} */
+        PolicyApprovalFlow: "ach_withdrawal" | "wire_withdrawal" | "onchain_withdrawal" | "fund_buy" | "fund_sell";
+        PolicyApprovalTier: {
+            /** Format: int32 */
+            approvals_required: number;
+            /** @enum {string} */
+            flow: "ach_withdrawal" | "wire_withdrawal" | "onchain_withdrawal" | "fund_buy" | "fund_sell";
+            /** @description Legacy thresholds may require strictly greater than min_usd; current rules are inclusive. */
+            min_inclusive: boolean;
+            min_usd: string;
+            /** @description An additional named approval is required. Ordinary counts exclude both requester and named approver. */
+            named_approval_required: boolean;
+        };
+        PolicyDelay: {
+            /** @description False: this control has not been implemented. */
+            supported: boolean;
+        };
+        /** @enum {string} */
+        PolicyLimitScope: "all_assets" | "par_usd_assets";
+        PolicyLimits: {
+            daily: {
+                /** @enum {string} */
+                applies_to: "all_assets" | "par_usd_assets";
+                limit_usd: string;
+                remaining_usd: string;
+                /**
+                 * Format: int64
+                 * @description Movements omitted from the USD-valued used figure because no rate was available.
+                 */
+                unpriced_movements: number;
+                used_usd: string;
+                /** @enum {string} */
+                window: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
+            } | null;
+            /** @description Null means there is no flow-wide per-transaction USD cap. Asset and settlement-pathway gates still apply. */
+            per_transaction: {
+                /** @enum {string} */
+                applies_to: "all_assets" | "par_usd_assets";
+                limit_usd: string;
+                remaining_usd: string;
+                /**
+                 * Format: int64
+                 * @description Movements omitted from the USD-valued used figure because no rate was available.
+                 */
+                unpriced_movements: number;
+                used_usd: string;
+                /** @enum {string} */
+                window: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
+            } | null;
+            rolling: {
+                /** @enum {string} */
+                applies_to: "all_assets" | "par_usd_assets";
+                limit_usd: string;
+                remaining_usd: string;
+                /**
+                 * Format: int64
+                 * @description Movements omitted from the USD-valued used figure because no rate was available.
+                 */
+                unpriced_movements: number;
+                used_usd: string;
+                /** @enum {string} */
+                window: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
+            } | null;
+            weekly: {
+                /** @enum {string} */
+                applies_to: "all_assets" | "par_usd_assets";
+                limit_usd: string;
+                remaining_usd: string;
+                /**
+                 * Format: int64
+                 * @description Movements omitted from the USD-valued used figure because no rate was available.
+                 */
+                unpriced_movements: number;
+                used_usd: string;
+                /** @enum {string} */
+                window: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
+            } | null;
+        };
+        PolicySnapshot: {
+            data: components["schemas"]["Policy"][];
+            livemode: boolean;
+            /** @enum {string} */
+            object: "policy_snapshot";
+            /** Format: date-time */
+            observed_ts: string;
+        };
+        /** @enum {string} */
+        PolicyWindowKind: "calendar_day" | "calendar_week" | "rolling_24h" | "rolling_72h";
         Quote: {
             amount_usd: string;
             /** @enum {string} */
@@ -815,12 +1143,105 @@ export interface components {
             period_start_ts: string;
             superseded_by?: string;
         };
+        StatementCommission: {
+            amount: string;
+            label: string;
+            symbol: string;
+        };
+        StatementContent: {
+            balances: components["schemas"]["StatementLine"][];
+            /** Format: date-time */
+            created_ts: string;
+            id: string;
+            livemode: boolean;
+            /** @enum {string} */
+            object: "statement_content";
+            period: components["schemas"]["StatementPeriod"];
+            ramp_fees?: components["schemas"]["StatementRampFee"][];
+            superseded_by?: string;
+            totals: components["schemas"]["StatementTotals"];
+            /** @description The period's movements. Pay-ins and payouts are never served on this API, so they are not listed here although balances and totals include their effect: for a period in which the business made a payment the entries do not sum to the totals. */
+            transactions: components["schemas"]["StatementEntry"][];
+        };
+        StatementEffect: {
+            amount: string;
+            /** @enum {string} */
+            amount_status?: "provisional" | "settled";
+            quoted_amount?: string;
+            symbol: string;
+        };
+        StatementEntry: {
+            commission?: components["schemas"]["StatementCommission"];
+            effects: components["schemas"]["StatementEffect"][];
+            id: string;
+            label: string;
+            /** Format: date-time */
+            occurred_ts: string;
+            /** @enum {string} */
+            status: "completed" | "pending" | "failed";
+            /** @enum {string} */
+            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
+            withdrawal?: components["schemas"]["StatementWithdrawal"];
+        };
+        StatementLine: {
+            ending_native: string;
+            ending_usd: string;
+            label: string;
+            net_change_native: string;
+            net_change_usd: string;
+            opening_native: string;
+            opening_usd: string;
+            segregated_rail?: string;
+            symbol: string;
+        };
         StatementList: {
             data: components["schemas"]["Statement"][];
             has_more: boolean;
             /** @enum {string} */
             object: "list";
         };
+        StatementPeriod: {
+            /** Format: date-time */
+            end_ts: string;
+            label: string;
+            /** Format: date-time */
+            start_ts: string;
+        };
+        StatementRampFee: {
+            /** Format: date-time */
+            assessed_ts: string;
+            assessed_usdc: string;
+            bank_fee_usd: string;
+            collected_usdc: string;
+            /** @enum {string} */
+            direction: "onramp" | "offramp";
+            events: components["schemas"]["StatementRampFeeEvent"][];
+            net_proceeds_usdc?: string;
+            paid_to_bank_usd?: string;
+            principal_usd: string;
+            refunded_usdc: string;
+            /** @enum {string} */
+            status: "not_needed" | "pending" | "collected" | "waived" | "partially_refunded" | "refunded";
+            total_debit_usdc?: string;
+            transaction_id: string;
+        };
+        StatementRampFeeEvent: {
+            amount_usdc: string;
+            /** @enum {string} */
+            kind: "collection" | "refund";
+            /** Format: date-time */
+            settled_ts: string;
+            transaction_id: string;
+        };
+        StatementTotals: {
+            ending_usd: string;
+            net_change_usd: string;
+            opening_usd: string;
+        };
+        StatementWithdrawal: {
+            fee: string;
+            paid_to_bank: string;
+        };
         Transaction: {
             /** @description The signed net change to the business's own SETTLED holdings, one entry per asset, ordered by asset. Empty when nothing of the business's own has settled yet: a movement still pending or processing reports no change, and neither does one whose every leg failed. A failed movement DOES report the legs that settled before it failed. */
             asset_changes: components["schemas"]["TransactionAssetChange"][];
@@ -841,7 +1262,7 @@ export interface components {
             failed_ts?: string;
             /** @description The transaction id. Stable for the life of the movement and safe to store. */
             id: string;
-            /** @description Always true. A transaction records real custodied money moving; there is no test ledger. */
+            /** @description False only for an isolated mock-money-only ledger; independent of the reading credential. */
             livemode: boolean;
             /** @enum {string} */
             object: "transaction";
@@ -851,13 +1272,13 @@ export interface components {
              */
             status: "pending" | "processing" | "completed" | "failed";
             /**
-             * @description What the movement is. The full vocabulary is published; a business only ever sees the members its own activity produces.
+             * @description What the movement is. The whole vocabulary a transaction can carry is published; a business only ever sees the members its own activity produces. Pay-ins and payouts are never served on this API.
              * @enum {string}
              */
-            type: "ach_offramp" | "ach_onramp" | "adjustment" | "bank_payin" | "bank_payout" | "buy_fund_token" | "buy_fund_token_return" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_xlm_reserve" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "onchain_deposit" | "onchain_withdrawal" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
+            type: "ach_offramp" | "ach_onramp" | "adjustment" | "buy_fund_token" | "buy_fund_token_return" | "buy_fund_token_return_sweep" | "deposit_hold" | "deposit_return" | "deposit_reversal" | "fund_cash_subscription" | "fund_dividend_payout" | "fund_distribution_payout" | "fund_gas_tank" | "fund_xlm_reserve" | "gas_tank_refill" | "gas_wallet_funding" | "go_account_conversion" | "go_account_custodial_transfer" | "go_account_external_send" | "held_deposit_release" | "onchain_deposit" | "onchain_withdrawal" | "ramp_fee_refund" | "reclassification" | "sell_fund_token" | "sell_fund_token_return" | "trade_order" | "treasury_booking" | "treasury_wire_credit" | "wire_offramp" | "wire_onramp";
         };
         TransactionAssetChange: {
-            /** @description The signed net change to the business's settled holdings of this asset, in the asset's own units. NEGATIVE LEFT the business, positive arrived. Net of the ledger's fees and taxes, on the same basis /v1/balances reports. Summing an asset's amounts across every transaction — not only the completed ones — gives the movement in its settled balance. */
+            /** @description The signed net change to the business's settled holdings of this asset, in the asset's own units. NEGATIVE LEFT the business, positive arrived. Net of the ledger's fees and taxes, on the same basis /v1/balances reports. For a business with no pay-ins or payouts, summing an asset's amounts across every transaction — not only the completed ones — gives the movement in its settled balance. Pay-ins and payouts are not served on this API but still move /v1/balances, so a business with payments cannot reconcile its balance from transactions alone. */
             amount: string;
             /** @description The asset symbol, in the ledger's own casing (USDC, WTGXX, SOL:USDC). */
             asset: string;
@@ -1236,6 +1657,142 @@ export interface operations {
             };
         };
     };
+    "external_wallets.list": {
+        parameters: {
+            query?: {
+                /** @description How many external wallets to return. Defaults to 10. A value above 100 is rejected, not reduced. */
+                limit?: number;
+                /** @description Return the external wallets immediately after this external wallet id in the list order. Cannot be combined with ending_before. */
+                starting_after?: string;
+                /** @description Return the external wallets immediately before this external wallet id in the list order. Cannot be combined with starting_after. */
+                ending_before?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExternalWalletList"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "external_wallets.get": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The external wallet id. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ExternalWallet"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "notifications.list": {
+        parameters: {
+            query?: {
+                /** @description How many notifications to return. Defaults to 10. */
+                limit?: number;
+                /** @description Return the notifications immediately older than this notification id. Cannot be combined with ending_before. */
+                starting_after?: string;
+                /** @description Return the notifications immediately newer than this notification id. Cannot be combined with starting_after. */
+                ending_before?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationList"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "notifications.retrieve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The notification id. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Notification"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "orders.list": {
         parameters: {
             query?: {
@@ -1339,6 +1896,35 @@ export interface operations {
             };
         };
     };
+    "policies.snapshot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolicySnapshot"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "quotes.quote": {
         parameters: {
             query: {
@@ -1472,6 +2058,38 @@ export interface operations {
             };
         };
     };
+    "statements.content.retrieve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description The statement id. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatementContent"];
+                };
+            };
+            /** @description Error response. */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     "transactions.list": {
         parameters: {
             query?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -35,13 +35,14 @@
     "openapi-fetch": "0.17.0"
   },
   "devDependencies": {
-    "@types/node": "24.10.1",
+    "@types/node": "26.6.3",
     "openapi-typescript": "7.13.0",
     "typescript": "5.9.3",
-    "vitest": "4.1.11"
+    "vitest": "5.0.2"
   },
   "overrides": {
-    "js-yaml": "^5.4.1",
-    "nanoid": "^3.3.17"
+    "js-yaml": "^5.4.2",
+    "nanoid": "^3.3.17",
+    "source-map-js": "^1.2.2"
   }
 }