@stable_sea/sdk 0.2.7 → 0.2.8

package/README.md

@@ -207,6 +207,18 @@ registry metadata remains available. These figures are informational. Use a
 quote to obtain the price for a trade. See the
 [securities reference](https://docs.stablesea.com/api/reference/#GET/v1/securities).
 
+## Transaction settlement references
+
+Retrieve `GET /v1/transactions/{id}` with `money:read` to see
+`onchain_transactions`. Each observed reference includes its `hash` and, when
+known, `chain` and `explorer_url`. An empty array means no references have been
+observed; null means the metadata is unavailable, including a receipt initiated
+by another business. List responses omit this detail.
+
+A hash is a settlement reference, not proof that the whole movement completed.
+Check the transaction's `status` and `asset_changes` for its lifecycle and effect
+on settled balances. Sandbox references use simulated partner data.
+
 ## Statement previews
 
 Read the current month's interim document with

package/dist/gen/schema.d.ts

@@ -894,6 +894,8 @@ export interface paths {
          *
          *     The status is `pending`, `processing`, `completed` or `failed`. `completed_ts` and `failed_ts` are mutually exclusive and absent while execution is pending or processing.
          *
+         *     `onchain_transactions` includes observed hashes, their blockchain when known, and available explorer links for movements initiated by your business. An empty array means no hashes have been observed; null means references are unavailable for this read. Lists omit these details.
+         *
          *     Unknown and cross-business IDs return the same not-found response.
          */
         get: operations["transactions.get"];
@@ -2247,12 +2249,60 @@ export interface components {
             /** @description The asset symbol, in the ledger's own casing (USDC, WTGXX, SOL:USDC). */
             asset: string;
         };
+        TransactionDetail: {
+            /** @description Signed net changes to settled holdings, one entry per asset, ordered by asset. Empty when no part has settled. A failed movement includes any changes that settled before failure; pending or processing status alone does not determine whether this array is empty. */
+            asset_changes: components["schemas"]["TransactionAssetChange"][];
+            /**
+             * Format: date-time
+             * @description When the last leg settled. Present only when status is completed, and never alongside failed_ts.
+             */
+            completed_ts?: string;
+            /**
+             * Format: date-time
+             * @description When the movement was opened. Immutable, and the instant this list is ordered and paged on.
+             */
+            created_ts: string;
+            /**
+             * Format: date-time
+             * @description When the movement terminated as failed. Present only when status is failed, and never alongside completed_ts.
+             */
+            failed_ts?: string;
+            /** @description The transaction id. Stable for the life of the movement and safe to store. */
+            id: string;
+            /** @description Whether the resource represents live financial data. False for an isolated simulated ledger; independent of the reading credential. */
+            livemode: boolean;
+            /** @enum {string} */
+            object: "transaction";
+            /** @description Observed on-chain settlement references for a movement initiated by your business. Empty when none have been observed; null when unavailable. */
+            onchain_transactions: components["schemas"]["TransactionOnchainReference"][] | null;
+            /**
+             * @description The movement lifecycle: pending before execution starts; processing while at least one part is in flight; completed when all parts settle; failed when execution ends unsuccessfully. A failed movement can have settled changes, reported in asset_changes.
+             * @enum {string}
+             */
+            status: "pending" | "processing" | "completed" | "failed";
+            /**
+             * @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" | "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";
+        };
         TransactionList: {
             data: components["schemas"]["Transaction"][];
             has_more: boolean;
             /** @enum {string} */
             object: "list";
         };
+        TransactionOnchainReference: {
+            /** @description Blockchain identifier, such as ethereum or stellar. Omitted when the hash cannot be attributed to a blockchain. */
+            chain?: string;
+            /**
+             * Format: uri
+             * @description Block-explorer URL, when available. Otherwise use the hash as plain text.
+             */
+            explorer_url?: string;
+            /** @description Observed transaction hash. */
+            hash: string;
+        };
         USBankAccountCreateDetails: {
             account_number: string;
             /** @enum {string} */
@@ -4156,7 +4206,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["Transaction"];
+                    "application/json": components["schemas"]["TransactionDetail"];
                 };
             };
             400: components["responses"]["Error400"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stable_sea/sdk",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "type": "module",
   "sideEffects": false,
   "files": [