@totalis/hip4-client 0.80.0 → 0.82.0

package/CHANGELOG.md

@@ -3,6 +3,51 @@
 `@totalis/hip4-client` follows [semantic versioning](https://semver.org).
 The contract version the generated types come from is `sdkVersion` in `./version`.
 
+## 0.82.0
+
+### Changed
+
+- `GAS_PRICE_ABOVE_CEILING` (503, `BACKOFF`) moves from opening RFQs to
+  accepting them (TT-2637): `createRfq`, `createCashout` and `createGoldenRfq`
+  no longer answer it, so quotes keep coming during a HyperEVM gas spike, and
+  `acceptQuote` (entry and cash-out) answers it, like `placeGolden`, while the
+  gas price is above 30 gwei. Nothing is placed or accepted; an exact replay
+  of an accepted quote still answers.
+
+### Added
+
+- The market stream's `network` subscription flag and `network` frame: the
+  HyperEVM gas price, the level Totalis accepts quotes at
+  (`accept_below_wei`) and the current spike's `peak_wei`, after every
+  snapshot and on every change the app acts on, so a client can tell before
+  a press that an accept would be refused. Contract `209.0.0-gas-at-accept`.
+
+## 0.81.1
+
+### Changed
+
+- Generated types: the `actions` description on maker capital reads now says
+  `MAKER_QUOTE` carries an amount, `free_after_pending` less a live v1
+  withdrawal request's amount, instead of always being null (TT-2567). No type
+  changed.
+
+## 0.81.0
+
+### Added
+
+- `totalis.readComboCash()`: what one Combo can stake now, from one
+  `GET /v1/me/balances` read and the signer's HyperCore cash read from
+  Hyperliquid (TT-2572). It answers `vault`, `wallet`, `core` (spot USDC less
+  its hold), `coreMode`, `setupFee`, `offeredCore` and `allowance`, each `null`
+  when unknown. Pass it as `cash` and `offeredCore` as `core` to `openPosition`,
+  `signEntry` or `prepareEntryFunding`; `allowance` is the largest stake they
+  plan from it. A Portfolio Margin account offers no Core, as in the Totalis app.
+- `offeredCore(spendable, setupFee)` and `comboAllowance({ vault, wallet, core })`,
+  the same rule as plain functions.
+- `readCoreCash(network, account, info?)`, `hyperliquidInfo(fetch?)`,
+  `coreSetupFee` and `infoUrl` on `hyperliquidNetwork`, for reading HyperCore
+  cash yourself.
+
 ## 0.80.0
 
 ### Added

package/dist/client.d.ts

@@ -5,12 +5,12 @@ export type { components, operations, paths } from "./generated/client.js";
 export type { AccessToken, ApiClientOptions, PublicEnvironment } from "./base.js";
 /** The typed HTTP client for the `client` audience. `createTotalis` adds the flows. */
 export declare function createClient(environment: PublicEnvironment, options?: ApiClientOptions): import("openapi-fetch").Client<paths, `${string}/${string}`>;
-export { bestBid, bestQuote, createTotalis, EntryError, entryFailure, follow, type Acceptance, type AcceptanceResult, type Amount, type BridgeState, type CashoutBid, type Chooser, type Deployment, type DepositAccepted, type EntryCash, type EntryFailure, type EntryQuote, type CoreExit, type LegacySignedEntry, type Leg, type PreparedEntryFunding, type NotAdmitted, type RecordListener, type Operation, type Quote, type ResponseOf, type SellBackQuote, type SignedAcceptance, type SignedCashout, type SignedCoreExit, type SignedDeposit, type SignedEntry, type SignedReturnToCore, type Totalis, type TotalisOptions, type TransferQuote, type WalletCall, type Withdrawal, } from "./totalis.js";
-export { bridgeAction, bridgeGasBuffer, classifyHypercoreAnswer, hyperevmUsdcBridge, hyperliquidExchange, hyperliquidNetwork, hypercoreNonce, hypercoreSignature, sendAssetTypedData, settleHypercore, signSendAsset, submitHypercore, usdcText, type BridgedCash, type HypercoreAnswer, type HypercoreSignature, type HypercoreTransport, type HyperliquidNetwork, type SendAssetAction, type SignedSendAsset, } from "./hypercore.js";
+export { bestBid, bestQuote, createTotalis, EntryError, entryFailure, follow, type Acceptance, type AcceptanceResult, type Amount, type BridgeState, type ComboCash, type CashoutBid, type Chooser, type Deployment, type DepositAccepted, type EntryCash, type EntryFailure, type EntryQuote, type CoreExit, type LegacySignedEntry, type Leg, type PreparedEntryFunding, type NotAdmitted, type RecordListener, type Operation, type Quote, type ResponseOf, type SellBackQuote, type SignedAcceptance, type SignedCashout, type SignedCoreExit, type SignedDeposit, type SignedEntry, type SignedReturnToCore, type Totalis, type TotalisOptions, type TransferQuote, type WalletCall, type Withdrawal, } from "./totalis.js";
+export { bridgeAction, bridgeGasBuffer, classifyHypercoreAnswer, coreSetupFee, hyperevmUsdcBridge, hyperliquidExchange, hyperliquidInfo, hyperliquidNetwork, hypercoreNonce, hypercoreSignature, readCoreCash, sendAssetTypedData, settleHypercore, signSendAsset, submitHypercore, usdcText, type BridgedCash, type CoreAccountMode, type CoreCash, type HypercoreAnswer, type HyperliquidInfo, type HypercoreSignature, type HypercoreTransport, type HyperliquidNetwork, type SendAssetAction, type SignedSendAsset, } from "./hypercore.js";
 export { ApiError, envelope, NetworkError, randomBytes32, retryingFetch, sendOnce, unwrap, uuidv7, type Fetch, type Repaired, type RetryPolicy } from "./request.js";
 export { items, pages, type Page, type PageQuery } from "./pagination.js";
 export { toTotalisSigner, type SignerInput, type TotalisSigner } from "./signer.js";
 export { BalanceUnknownError, ExitUnavailableError, normalizeError, type NormalizedError } from "./flow-errors.js";
-export { netCashout, netOfProfitFee, netPayout, netStake, spendableCash } from "./money.js";
+export { comboAllowance, netCashout, netOfProfitFee, netPayout, netStake, offeredCore, spendableCash } from "./money.js";
 export { createUiAdapter, type AccountResource, type QuoteView, type UiAdapter, type UiAdapterOptions } from "./ui.js";
 export { StreamClosedError, TotalisStream, type StreamEvent, type StreamOptions, type StreamStatus, type StreamSubscription } from "./stream.js";

package/dist/client.js

@@ -5,11 +5,11 @@ export function createClient(environment, options) {
     return audienceClient(environment, options);
 }
 export { bestBid, bestQuote, createTotalis, EntryError, entryFailure, follow, } from "./totalis.js";
-export { bridgeAction, bridgeGasBuffer, classifyHypercoreAnswer, hyperevmUsdcBridge, hyperliquidExchange, hyperliquidNetwork, hypercoreNonce, hypercoreSignature, sendAssetTypedData, settleHypercore, signSendAsset, submitHypercore, usdcText, } from "./hypercore.js";
+export { bridgeAction, bridgeGasBuffer, classifyHypercoreAnswer, coreSetupFee, hyperevmUsdcBridge, hyperliquidExchange, hyperliquidInfo, hyperliquidNetwork, hypercoreNonce, hypercoreSignature, readCoreCash, sendAssetTypedData, settleHypercore, signSendAsset, submitHypercore, usdcText, } from "./hypercore.js";
 export { ApiError, envelope, NetworkError, randomBytes32, retryingFetch, sendOnce, unwrap, uuidv7 } from "./request.js";
 export { items, pages } from "./pagination.js";
 export { toTotalisSigner } from "./signer.js";
 export { BalanceUnknownError, ExitUnavailableError, normalizeError } from "./flow-errors.js";
-export { netCashout, netOfProfitFee, netPayout, netStake, spendableCash } from "./money.js";
+export { comboAllowance, netCashout, netOfProfitFee, netPayout, netStake, offeredCore, spendableCash } from "./money.js";
 export { createUiAdapter } from "./ui.js";
 export { StreamClosedError, TotalisStream } from "./stream.js";

package/dist/generated/account-read.d.ts

@@ -481,7 +481,7 @@ export type components = {
             readonly floor_bps: number | null;
             /** @description SHA-256 of the exact pinned artifact that names this deployment's chain and vault: the release artifact on chain 999, the environment's deployment manifest on 998. A client compares it with its own pinned artifact to bind the read to its deployment. */
             readonly deployment_digest: string;
-            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is always null with one blocker, because quoting capacity depends on state only the maker's bot holds, such as its other live quotes. PRIVATE_QUOTE_CAPACITY_UNAVAILABLE means only that Totalis cannot compute that amount; it does not mean quoting is off, and the maker can keep quoting. A reconciliation blocker replaces it while the vault read and venue records disagree. */
+            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is the most new quotes may promise: free_after_pending less a live v1 withdrawal request's amount, never below zero. Quotes reserve nothing, so it does not count the maker's other live quotes; if several are accepted at once, a confirm past it fails QUOTE_CAPACITY_EXCEEDED. Both are null with a reconciliation blocker while the vault read and venue records disagree. */
             readonly actions: readonly components["schemas"]["ActionAvailability"][];
             /** @description Venue reservations on MAKER_VAULT that make up pending_commitments. */
             readonly reservations: readonly components["schemas"]["Reservation"][];

package/dist/generated/errors.d.ts

@@ -369,7 +369,7 @@ export type CloseReason = "SUBPROTOCOL_REQUIRED" | "CURSOR_RESET" | "DEPENDENCY_
 /** The codes each live operation can return. */
 export declare const operationErrors: {
     readonly abandonCoreExit: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "NOT_FOUND", "STATE_CONFLICT", "ORIGIN_REQUIRED"];
-    readonly acceptQuote: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_NOT_OPEN", "QUOTE_EXPIRED", "QUOTE_CANCELLED", "QUOTE_REPLACED", "QUOTE_SIGNER_CHANGED", "QUOTE_CAPACITY_EXCEEDED", "QUOTE_NOT_FOUND", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "INVALID_SIGNATURE", "CONTRACT_SIGNATURE_OVERLOADED", "EXECUTION_BACKLOG_FULL", "CORE_MOVE_IN_FLIGHT", "ACCEPTANCE_IN_FLIGHT", "GOLDEN_CASHOUT_REFUSED", "NOT_FOUND", "ORIGIN_REQUIRED", "WRONG_AUTHORITY"];
+    readonly acceptQuote: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_NOT_OPEN", "QUOTE_EXPIRED", "QUOTE_CANCELLED", "QUOTE_REPLACED", "QUOTE_SIGNER_CHANGED", "QUOTE_CAPACITY_EXCEEDED", "QUOTE_NOT_FOUND", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "INVALID_SIGNATURE", "CONTRACT_SIGNATURE_OVERLOADED", "EXECUTION_BACKLOG_FULL", "CORE_MOVE_IN_FLIGHT", "ACCEPTANCE_IN_FLIGHT", "GOLDEN_CASHOUT_REFUSED", "GAS_PRICE_ABOVE_CEILING", "NOT_FOUND", "ORIGIN_REQUIRED", "WRONG_AUTHORITY"];
     readonly activeCoreExits: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED"];
     readonly admitOwnMaker: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "INVALID_REQUEST", "NOT_FOUND", "STATE_CONFLICT"];
     readonly admitPartnerWallet: readonly ["INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "UNAUTHENTICATED", "FORBIDDEN", "STATE_CONFLICT", "INVALID_SIGNATURE", "RATE_LIMITED", "AUTHORIZATION_UNAVAILABLE"];
@@ -379,19 +379,19 @@ export declare const operationErrors: {
     readonly confirmComboCopyAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "NOT_FOUND", "STATE_CONFLICT", "DEPENDENCY_STALE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
     readonly confirmCoreCopyAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "NOT_FOUND", "STATE_CONFLICT", "DEPENDENCY_STALE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
     readonly confirmQuote: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "NOT_FOUND", "STATE_CONFLICT", "INVALID_SIGNATURE", "QUOTE_EXPIRED", "QUOTE_SIGNER_CHANGED", "QUOTE_CAPACITY_EXCEEDED", "QUOTE_EXPOSURE_LIMIT", "QUOTE_EXPOSURE_STALE", "COMBO_AUTOMATIC_DISABLED", "RFQ_GENERATION_STALE", "FINANCIAL_ACTIONS_DISABLED", "WRONG_AUTHORITY"];
-    readonly createCashout: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_INTENT_LIMIT", "STATE_CONFLICT", "GOLDEN_CASHOUT_REFUSED", "FINANCIAL_ACTIONS_DISABLED", "GAS_PRICE_ABOVE_CEILING", "ORIGIN_REQUIRED"];
+    readonly createCashout: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_INTENT_LIMIT", "STATE_CONFLICT", "GOLDEN_CASHOUT_REFUSED", "FINANCIAL_ACTIONS_DISABLED", "ORIGIN_REQUIRED"];
     readonly createCollateralReduction: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "NOT_FOUND", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "COLLATERAL_REDUCTION_UNAVAILABLE"];
     readonly createComment: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT"];
     readonly createCoreExit: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "CORE_EXIT_UNAVAILABLE", "CORE_ACCOUNT_NOT_READY", "CORE_ACCOUNT_ACTIVATION_REQUIRED", "CORE_MOVE_IN_FLIGHT", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "ORIGIN_REQUIRED"];
     readonly createDeposit: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "INVALID_SIGNATURE", "SPONSORSHIP_UNAVAILABLE", "ORIGIN_REQUIRED"];
-    readonly createGoldenRfq: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "CONTRACT_UNAVAILABLE", "GOLDEN_TICKET_NONE", "GOLDEN_TICKET_USED", "GOLDEN_TICKET_EXPIRED", "GOLDEN_PLACEMENT_IN_FLIGHT", "GOLDEN_LEG_COUNT", "GOLDEN_LEG_NOT_ELIGIBLE", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "GAS_PRICE_ABOVE_CEILING", "COMBO_AUTOMATIC_DISABLED", "BROWSE_UNAVAILABLE"];
+    readonly createGoldenRfq: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "CONTRACT_UNAVAILABLE", "GOLDEN_TICKET_NONE", "GOLDEN_TICKET_USED", "GOLDEN_TICKET_EXPIRED", "GOLDEN_PLACEMENT_IN_FLIGHT", "GOLDEN_LEG_COUNT", "GOLDEN_LEG_NOT_ELIGIBLE", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "COMBO_AUTOMATIC_DISABLED", "BROWSE_UNAVAILABLE"];
     readonly createMakerApiKey: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "IDEMPOTENCY_KEY_REUSED", "SECRET_UNAVAILABLE", "KEY_LIMIT_REACHED"];
     readonly createMakerApiKeyChallenge: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "IDEMPOTENCY_KEY_REUSED"];
     readonly createOperatorApiKey: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "IDEMPOTENCY_KEY_REUSED", "SECRET_UNAVAILABLE", "KEY_LIMIT_REACHED"];
     readonly createPersonalApiKey: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "IDEMPOTENCY_KEY_REUSED", "SECRET_UNAVAILABLE", "KEY_LIMIT_REACHED"];
     readonly createPersonalApiKeyChallenge: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "IDEMPOTENCY_KEY_REUSED"];
     readonly createQuote: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_NOT_OPEN", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "NOT_FOUND"];
-    readonly createRfq: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_INTENT_LIMIT", "RFQ_GENERATION_STALE", "RFQ_GENERATION_IN_FLIGHT", "STATE_CONFLICT", "COMBO_AUTOMATIC_DISABLED", "FINANCIAL_ACTIONS_DISABLED", "GAS_PRICE_ABOVE_CEILING", "ORIGIN_REQUIRED"];
+    readonly createRfq: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "RFQ_INTENT_LIMIT", "RFQ_GENERATION_STALE", "RFQ_GENERATION_IN_FLIGHT", "STATE_CONFLICT", "COMBO_AUTOMATIC_DISABLED", "FINANCIAL_ACTIONS_DISABLED", "ORIGIN_REQUIRED"];
     readonly createRunOffClaim: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "ORIGIN_REQUIRED"];
     readonly createWalletChallenge: readonly ["INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "ORIGIN_REQUIRED", "ORIGIN_NOT_ALLOWED", "UNAUTHENTICATED", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT", "WALLET_CONTRACT_UNSUPPORTED", "RATE_LIMITED", "AUTHORIZATION_UNAVAILABLE"];
     readonly createWalletSession: readonly ["INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "ORIGIN_REQUIRED", "ORIGIN_NOT_ALLOWED", "UNAUTHENTICATED", "ACCESS_REQUIRED", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT", "INVALID_SIGNATURE", "RATE_LIMITED", "AUTHORIZATION_UNAVAILABLE"];

package/dist/generated/errors.js

@@ -402,6 +402,7 @@ export const operationErrors = {
         "CORE_MOVE_IN_FLIGHT",
         "ACCEPTANCE_IN_FLIGHT",
         "GOLDEN_CASHOUT_REFUSED",
+        "GAS_PRICE_ABOVE_CEILING",
         "NOT_FOUND",
         "ORIGIN_REQUIRED",
         "WRONG_AUTHORITY"
@@ -537,7 +538,6 @@ export const operationErrors = {
         "STATE_CONFLICT",
         "GOLDEN_CASHOUT_REFUSED",
         "FINANCIAL_ACTIONS_DISABLED",
-        "GAS_PRICE_ABOVE_CEILING",
         "ORIGIN_REQUIRED"
     ],
     "createCollateralReduction": [
@@ -619,7 +619,6 @@ export const operationErrors = {
         "GOLDEN_LEG_NOT_ELIGIBLE",
         "STATE_CONFLICT",
         "FINANCIAL_ACTIONS_DISABLED",
-        "GAS_PRICE_ABOVE_CEILING",
         "COMBO_AUTOMATIC_DISABLED",
         "BROWSE_UNAVAILABLE"
     ],
@@ -709,7 +708,6 @@ export const operationErrors = {
         "STATE_CONFLICT",
         "COMBO_AUTOMATIC_DISABLED",
         "FINANCIAL_ACTIONS_DISABLED",
-        "GAS_PRICE_ABOVE_CEILING",
         "ORIGIN_REQUIRED"
     ],
     "createRunOffClaim": [

package/dist/generated/openapi.d.ts

@@ -3573,7 +3573,7 @@ export type components = {
             readonly floor_bps: number | null;
             /** @description SHA-256 of the exact pinned artifact that names this deployment's chain and vault: the release artifact on chain 999, the environment's deployment manifest on 998. A client compares it with its own pinned artifact to bind the read to its deployment. */
             readonly deployment_digest: string;
-            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is always null with one blocker, because quoting capacity depends on state only the maker's bot holds, such as its other live quotes. PRIVATE_QUOTE_CAPACITY_UNAVAILABLE means only that Totalis cannot compute that amount; it does not mean quoting is off, and the maker can keep quoting. A reconciliation blocker replaces it while the vault read and venue records disagree. */
+            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is the most new quotes may promise: free_after_pending less a live v1 withdrawal request's amount, never below zero. Quotes reserve nothing, so it does not count the maker's other live quotes; if several are accepted at once, a confirm past it fails QUOTE_CAPACITY_EXCEEDED. Both are null with a reconciliation blocker while the vault read and venue records disagree. */
             readonly actions: readonly components["schemas"]["ActionAvailability"][];
             /** @description Venue reservations on MAKER_VAULT that make up pending_commitments. */
             readonly reservations: readonly components["schemas"]["Reservation"][];

package/dist/generated/realtime.d.ts

@@ -578,6 +578,24 @@ export type components = {
             readonly publication_freshness?: boolean;
             /** @description Opt in to scoreboards frames: the live game scoreboard of every game with a selected outcome, complete after each snapshot, then on every change. Without it the socket gets no scoreboards frame. */
             readonly scoreboards?: boolean;
+            /** @description Opt in to network frames: the HyperEVM gas price against the level Totalis accepts quotes at, after each snapshot, then on every change the app acts on. Without it the socket gets no network frame. */
+            readonly network?: boolean;
+        };
+        readonly MarketNetworkFrame: {
+            /**
+             * @description Frame discriminator, always network.
+             * @constant
+             */
+            readonly channel: "network";
+            /** @description The network state. One frame carries all of it; replace the local state with it. */
+            readonly data: {
+                /** @description The HyperEVM network gas price (eth_gasPrice, the next small block's base fee) in wei, as of when the frame was sent; null when it cannot be read. Accepting a quote (entry, cash-out or golden placement) is refused with GAS_PRICE_ABOVE_CEILING while it is above accept_below_wei. */
+                readonly gas_price_wei: components["schemas"]["Uint"] | null;
+                /** @description The highest gas price in wei at which Totalis accepts quotes, at that price included; null when unknown. RFQs and quotes keep flowing above it. */
+                readonly accept_below_wei: components["schemas"]["Uint"] | null;
+                /** @description The highest gas price in wei since the price last went above accept_below_wei; set exactly while gas_price_wei is above it, null otherwise and while the price cannot be read. */
+                readonly peak_wei: components["schemas"]["Uint"] | null;
+            };
         };
         readonly MarketScoreboardsFrame: {
             /**
@@ -1080,7 +1098,7 @@ export type components = {
             readonly floor_bps: number | null;
             /** @description SHA-256 of the exact pinned artifact that names this deployment's chain and vault: the release artifact on chain 999, the environment's deployment manifest on 998. A client compares it with its own pinned artifact to bind the read to its deployment. */
             readonly deployment_digest: string;
-            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is always null with one blocker, because quoting capacity depends on state only the maker's bot holds, such as its other live quotes. PRIVATE_QUOTE_CAPACITY_UNAVAILABLE means only that Totalis cannot compute that amount; it does not mean quoting is off, and the maker can keep quoting. A reconciliation blocker replaces it while the vault read and venue records disagree. */
+            /** @description Decisions for MAKER_WITHDRAW and MAKER_QUOTE on the MAKER_VAULT route. MAKER_WITHDRAW is the amount a new withdrawal request may ask for: free_after_pending, so it never takes collateral from fills already admitted. The vault re-checks free collateral when the request executes after its delay; it is null with MAKER_WITHDRAW_PENDING while a request is live, or with a reconciliation blocker. MAKER_QUOTE is the most new quotes may promise: free_after_pending less a live v1 withdrawal request's amount, never below zero. Quotes reserve nothing, so it does not count the maker's other live quotes; if several are accepted at once, a confirm past it fails QUOTE_CAPACITY_EXCEEDED. Both are null with a reconciliation blocker while the vault read and venue records disagree. */
             readonly actions: readonly components["schemas"]["ActionAvailability"][];
             /** @description Venue reservations on MAKER_VAULT that make up pending_commitments. */
             readonly reservations: readonly components["schemas"]["Reservation"][];
@@ -1096,6 +1114,8 @@ export type components = {
             /** @description Stream cursor the client asked to resume after; null when it started without one. */
             readonly cursor: components["schemas"]["Cursor"] | null;
         };
+        /** Format: uint256-decimal */
+        readonly Uint: string;
         readonly ScoreboardCompetitor: {
             /** @description The participant's name as our catalog spells it, cut to 96 characters ending in an ellipsis when longer. */
             readonly name: string;
@@ -1370,8 +1390,6 @@ export type components = {
             readonly reason: "UNQUALIFIED_MARKET_CLASS" | "MISSING_STRUCTURED_SOURCE" | "AMBIGUOUS_DESCRIPTION" | "UNSUPPORTED_PROTOCOL_VERSION";
         };
         readonly "$defs-Deadline": components["schemas"]["$defs-DeadlineAvailable"] | components["schemas"]["$defs-DeadlineUnavailable"];
-        /** Format: uint256-decimal */
-        readonly Uint: string;
         readonly PublicationCatalogSide: {
             /** @description Market side, YES or NO. */
             readonly side: components["schemas"]["Side"];

package/dist/generated/version.d.ts

@@ -1,12 +1,12 @@
-export declare const sdkVersion = "208.0.0-golden-combo";
-export declare const openapiSha256 = "d20296ea5f9a68f36dfe34c735d7cac2a5b5e2a0d116f0bb183c1e7f192601ff";
-export declare const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
+export declare const sdkVersion = "209.0.0-gas-at-accept";
+export declare const openapiSha256 = "0eaeaf098c1a1c14ede94a521a2b63db7954b6fc8f61acb54a4b1feed5d9e2dc";
+export declare const realtimeSha256 = "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07";
 export declare const jsonSchemaSha256: {
     readonly "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6";
     readonly "comments.schema.json": "18f4addcfa4e31c2c833fce8b8beca61d2e2ee5b6318c2ed0b479698ff56b65e";
     readonly "common.schema.json": "04f51deb3cbea448e59195e26ede3212598d58a7940fe67eb2123fd9161c5edb";
     readonly "core-exit.schema.json": "c7f617e815225cdcac95c236f8b73fbe288ee5713ff444c3be90eb915fc3a401";
-    readonly "error.schema.json": "724f7e86716a49effe27694ca8fd8370d6f215798d3f663362f1718fd89e7ebb";
+    readonly "error.schema.json": "d15dad1b8369b45746271e0fddd2106535c22493668b703544c9ddfa80761012";
     readonly "hypercore.schema.json": "5b89b2bbff7ec8cc1b8717375d12ce9cd5ab6aa5af03c4fdc6cc753ef9583a2c";
     readonly "identity.schema.json": "94534b768030736f4fd1fad285f1312454ca5fbff0b1eb5fab70416a78923bd0";
     readonly "maker-access.schema.json": "49698ee0235e42064aae0397db1e0f646bdc10d9dfa10121714ba06dd69fee3b";
@@ -15,7 +15,7 @@ export declare const jsonSchemaSha256: {
     readonly "market-data.schema.json": "85db33fac6a29b0fa87a500bfda947d0ab3913b13f1c26663d4a7c0484c35786";
     readonly "product-metadata.schema.json": "7c8ffbde878a0aedaed16814fcfd2e80038054b140886cc8736bb7b508042631";
     readonly "quote.schema.json": "5616260d399d022bde2d0130cc9f8a09f71a3dc877276adf796c7a174d21b59a";
-    readonly "realtime.schema.json": "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
+    readonly "realtime.schema.json": "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07";
 };
 export declare const operations: {
     readonly client: readonly ["abandonCoreExit", "acceptQuote", "activeCoreExits", "admitOwnMaker", "admitPartnerWallet", "bindEmbeddedWallet", "cancelRfq", "confirmComboCopyAgent", "confirmCoreCopyAgent", "createCashout", "createComment", "createCoreExit", "createDeposit", "createGoldenRfq", "createRfq", "createRunOffClaim", "createWalletChallenge", "createWalletSession", "createWithdrawal", "deleteComment", "editComment", "endWalletSession", "followTrader", "getAcceptance", "getAccountActivity", "getAccountPnl", "getAccountPosition", "getBalances", "getCopyAgents", "getCopyBudget", "getCopySettings", "getCopySummary", "getCoreExit", "getDeployment", "getGolden", "getGoldenMarkets", "getGoldenOffer", "getGoldenSuggestions", "getHypercoreBalance", "getHypercorePortfolio", "getHypercoreSettlementCredits", "getIdentity", "getMakerActivity", "getMakerCapital", "getMakerExposure", "getMakerPerformance", "getMakerPosition", "getMakerQuotes", "getMakerTelemetry", "getMakerVaultFundingTransaction", "getMakerWithdrawal", "getMarket", "getMarketDataConfig", "getMarketDefinitions", "getMarketHistory", "getMarketRecurringRound", "getMarketReferenceCloses", "getMarketScoreTimeline", "getMarketStats", "getOperation", "getOwnMaker", "getPartnerReport", "getPerpMarks", "getProfitLeaderboard", "getQuestion", "getQuestionRecurringRound", "getQuestionScoreTimeline", "getRfq", "getSeries", "getSuggestedCombo", "getTaxonomy", "getTrader", "getTraderPnl", "getUsernameAvailability", "getVaultAgents", "getVolumeLeaderboard", "getWithdrawal", "grantComboCopyAgent", "grantVaultAgent", "likeComment", "listAccountActivity", "listAccountPositions", "listComboCopies", "listComboFeed", "listCommentReplies", "listComments", "listControlledMakers", "listCopiedFills", "listCopyTrades", "listDiscovery", "listFollows", "listMakerActivity", "listMakerPositions", "listMakerQuoteHistory", "listMarkets", "listOperations", "listQuotes", "listTraderPositions", "listTraderTrades", "placeGolden", "reactComment", "recordAcquisition", "refreshPicture", "requestComboCopyAgent", "requestCoreCopyAgent", "revokeComboCopyAgent", "searchCatalog", "setAvatar", "setCopyAllocation", "setCopySettings", "setPublicProfile", "setUsername", "stream", "streamMarkets", "switchOffComboCopyAgent", "switchOffCoreCopyAgent", "unfollowTrader", "unlikeComment", "unreactComment"];

package/dist/generated/version.js

@@ -1,13 +1,13 @@
 // Generated by scripts/generate.mjs; do not edit.
-export const sdkVersion = "208.0.0-golden-combo";
-export const openapiSha256 = "d20296ea5f9a68f36dfe34c735d7cac2a5b5e2a0d116f0bb183c1e7f192601ff";
-export const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
+export const sdkVersion = "209.0.0-gas-at-accept";
+export const openapiSha256 = "0eaeaf098c1a1c14ede94a521a2b63db7954b6fc8f61acb54a4b1feed5d9e2dc";
+export const realtimeSha256 = "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07";
 export const jsonSchemaSha256 = {
     "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6",
     "comments.schema.json": "18f4addcfa4e31c2c833fce8b8beca61d2e2ee5b6318c2ed0b479698ff56b65e",
     "common.schema.json": "04f51deb3cbea448e59195e26ede3212598d58a7940fe67eb2123fd9161c5edb",
     "core-exit.schema.json": "c7f617e815225cdcac95c236f8b73fbe288ee5713ff444c3be90eb915fc3a401",
-    "error.schema.json": "724f7e86716a49effe27694ca8fd8370d6f215798d3f663362f1718fd89e7ebb",
+    "error.schema.json": "d15dad1b8369b45746271e0fddd2106535c22493668b703544c9ddfa80761012",
     "hypercore.schema.json": "5b89b2bbff7ec8cc1b8717375d12ce9cd5ab6aa5af03c4fdc6cc753ef9583a2c",
     "identity.schema.json": "94534b768030736f4fd1fad285f1312454ca5fbff0b1eb5fab70416a78923bd0",
     "maker-access.schema.json": "49698ee0235e42064aae0397db1e0f646bdc10d9dfa10121714ba06dd69fee3b",
@@ -16,7 +16,7 @@ export const jsonSchemaSha256 = {
     "market-data.schema.json": "85db33fac6a29b0fa87a500bfda947d0ab3913b13f1c26663d4a7c0484c35786",
     "product-metadata.schema.json": "7c8ffbde878a0aedaed16814fcfd2e80038054b140886cc8736bb7b508042631",
     "quote.schema.json": "5616260d399d022bde2d0130cc9f8a09f71a3dc877276adf796c7a174d21b59a",
-    "realtime.schema.json": "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3"
+    "realtime.schema.json": "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07"
 };
 export const operations = {
     "client": [

package/dist/hypercore.d.ts

@@ -5,6 +5,7 @@ export type HyperliquidNetwork = {
     /** The signing domain chain the HyperEVM bridge names: the deployment's own chain. */
     readonly signatureChainId: Hex;
     readonly exchangeUrl: string;
+    readonly infoUrl: string;
     readonly usdcToken: string;
 };
 export declare function hyperliquidNetwork(chainId: string | number): HyperliquidNetwork;
@@ -109,3 +110,27 @@ export declare function settleHypercore(signed: SignedSendAsset, options?: {
     readonly now?: () => number;
     readonly retryDelayMs?: number;
 }): Promise<HypercoreAnswer>;
+/** A read of Hyperliquid's `/info` on one network: the request body in, the answer's JSON out. */
+export type HyperliquidInfo = (network: HyperliquidNetwork, body: Readonly<Record<string, unknown>>, signal?: AbortSignal) => Promise<unknown>;
+/** POST to the network's `/info`. A non-2xx answer or a body that is not JSON throws. */
+export declare function hyperliquidInfo(fetchImpl?: typeof fetch): HyperliquidInfo;
+/** Hyperliquid's one-time account setup fee, in USDC base units, taken on top of an account's first send out when it was funded without paying it. */
+export declare const coreSetupFee = 1000000n;
+/** The account mode Hyperliquid's `userAbstraction` names; `null` for one this SDK does not know. */
+export type CoreAccountMode = "STANDARD" | "UNIFIED" | "PORTFOLIO_MARGIN";
+/**
+ * The account's HyperCore USDC as a Combo can bridge it, read from
+ * Hyperliquid. `spendable` is spot USDC `total` less `hold`, then floored
+ * to USDC base units (6 decimals); `hold` already carries order holds and
+ * position margin. A Portfolio Margin account offers none, as in the Totalis
+ * app. `setupFee` says whether a bridge from it also pays `coreSetupFee`; it is
+ * read only when there is something to bridge. Each is `null` when unread or
+ * unreadable, never 0.
+ */
+export type CoreCash = {
+    readonly mode: CoreAccountMode | null;
+    readonly spendable: bigint | null;
+    readonly setupFee: boolean | null;
+};
+/** Read `account`'s `CoreCash` on `network`. A failed or malformed read leaves its fields `null`; it never throws. */
+export declare function readCoreCash(network: HyperliquidNetwork, account: string, info?: HyperliquidInfo, signal?: AbortSignal): Promise<CoreCash>;

package/dist/hypercore.js

@@ -1,8 +1,8 @@
 import { sleep } from "./request.js";
 import { canonicalSignature } from "./typed-data.js";
 const networks = {
-    "999": { chain: "Mainnet", signatureChainId: "0x3e7", exchangeUrl: "https://api.hyperliquid.xyz/exchange", usdcToken: "USDC:0x6d1e7cde53ba9467b783cb7c530ce054" },
-    "998": { chain: "Testnet", signatureChainId: "0x3e6", exchangeUrl: "https://api.hyperliquid-testnet.xyz/exchange", usdcToken: "USDC:0xeb62eee3685fc4c43992febcd9e75443" },
+    "999": { chain: "Mainnet", signatureChainId: "0x3e7", exchangeUrl: "https://api.hyperliquid.xyz/exchange", infoUrl: "https://api.hyperliquid.xyz/info", usdcToken: "USDC:0x6d1e7cde53ba9467b783cb7c530ce054" },
+    "998": { chain: "Testnet", signatureChainId: "0x3e6", exchangeUrl: "https://api.hyperliquid-testnet.xyz/exchange", infoUrl: "https://api.hyperliquid-testnet.xyz/info", usdcToken: "USDC:0xeb62eee3685fc4c43992febcd9e75443" },
 };
 export function hyperliquidNetwork(chainId) {
     const key = String(chainId);
@@ -130,3 +130,77 @@ export async function settleHypercore(signed, options = {}) {
             return { kind: "unknown" };
     }
 }
+/** POST to the network's `/info`. A non-2xx answer or a body that is not JSON throws. */
+export function hyperliquidInfo(fetchImpl = (input, init) => globalThis.fetch(input, init)) {
+    return async (network, body, signal) => {
+        const response = await fetchImpl(network.infoUrl, {
+            method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body),
+            ...(signal === undefined ? {} : { signal }),
+        });
+        if (!response.ok)
+            throw new Error(`Hyperliquid info answered ${response.status}`);
+        const answer = JSON.parse(await response.text());
+        return answer;
+    };
+}
+/** Hyperliquid's one-time account setup fee, in USDC base units, taken on top of an account's first send out when it was funded without paying it. */
+export const coreSetupFee = 1000000n;
+const decimalText = /^\d+(\.\d+)?$/;
+const record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function coreMode(answer) {
+    if (answer === "default" || answer === "disabled")
+        return "STANDARD";
+    if (answer === "unifiedAccount")
+        return "UNIFIED";
+    if (answer === "portfolioMargin")
+        return "PORTFOLIO_MARGIN";
+    return null;
+}
+/** Spot decimal text (8 decimals) as integer units, or `null` past 8 decimals. */
+function spotUnits(text) {
+    const [whole = "0", fraction = ""] = text.split(".");
+    return fraction.length > 8 ? null : BigInt(whole) * 100000000n + BigInt(fraction.padEnd(8, "0"));
+}
+/**
+ * Spot USDC `total` less `hold`, exact in spot's 8 decimals and only then
+ * floored to USDC base units, so the sub-unit parts never round it up.
+ * `null` when the answer is malformed: two USDC entries, or a hold above the
+ * total. An account with no USDC entry holds none.
+ */
+function spotUsdc(answer) {
+    if (!record(answer) || !Array.isArray(answer.balances))
+        return null;
+    const entries = answer.balances.filter((entry) => record(entry) && entry.coin === "USDC");
+    if (entries.length === 0)
+        return 0n;
+    const [usdc] = entries;
+    if (entries.length > 1 || !record(usdc) || typeof usdc.total !== "string" || typeof usdc.hold !== "string" || !decimalText.test(usdc.total) || !decimalText.test(usdc.hold))
+        return null;
+    const total = spotUnits(usdc.total);
+    const hold = spotUnits(usdc.hold);
+    if (total === null || hold === null || hold > total)
+        return null;
+    return (total - hold) / 100n;
+}
+/** Whether `preTransferCheck` charges the setup fee: its `fee` is exactly 0 or exactly `coreSetupFee`; anything else is `null`. */
+function setupFeeCharged(answer) {
+    if (!record(answer) || typeof answer.fee !== "string" || !decimalText.test(answer.fee))
+        return null;
+    const fee = spotUnits(answer.fee);
+    return fee === 0n ? false : fee === coreSetupFee * 100n ? true : null;
+}
+const settledValue = (result) => (result.status === "fulfilled" ? result.value : undefined);
+/** Read `account`'s `CoreCash` on `network`. A failed or malformed read leaves its fields `null`; it never throws. */
+export async function readCoreCash(network, account, info = hyperliquidInfo(), signal) {
+    const [modeRead, spotRead] = await Promise.allSettled([
+        info(network, { type: "userAbstraction", user: account }, signal),
+        info(network, { type: "spotClearinghouseState", user: account }, signal),
+    ]);
+    const mode = coreMode(settledValue(modeRead));
+    const spot = spotUsdc(settledValue(spotRead));
+    const spendable = mode === null || spot === null ? null : mode === "PORTFOLIO_MARGIN" ? 0n : spot;
+    if (spendable === null || spendable === 0n)
+        return { mode, spendable, setupFee: null };
+    const check = await info(network, { type: "preTransferCheck", user: hyperevmUsdcBridge, source: account }, signal).then(setupFeeCharged, () => null);
+    return { mode, spendable, setupFee: check };
+}

package/dist/money.d.ts

@@ -26,6 +26,24 @@ export declare function spendableCash(balance: Pick<Balance, "amount" | "state"
     readonly wallet: bigint | null;
     readonly total: bigint | null;
 };
+/**
+ * The HyperCore USDC a Combo offers its bridge (`core` for `openPosition`,
+ * `signEntry` and `prepareEntryFunding`): all of `spendable`, less
+ * `coreSetupFee` when the bridge also pays it. `null` while either is unknown
+ * and there is Core to bridge.
+ */
+export declare function offeredCore(spendable: bigint | null, setupFee: boolean | null): bigint | null;
+/**
+ * The largest stake one Combo can take now, in USDC base units, as an entry
+ * plans its funding: free vault cash, then available wallet USDC, then a
+ * bridge of the offered Core less `bridgeGasBuffer`. `null` when any part is
+ * unknown, never a partial sum.
+ */
+export declare function comboAllowance(cash: {
+    readonly vault: bigint | null;
+    readonly wallet: bigint | null;
+    readonly core: bigint | null;
+}): bigint | null;
 /**
  * What the owner receives from a gross close amount (a settlement payout or a
  * sell-back price), as the vault pays it: the profit fee is

package/dist/money.js

@@ -1,3 +1,4 @@
+import { bridgeGasBuffer, coreSetupFee } from "./hypercore.js";
 const bps = 10000n;
 /**
  * Spendable Totalis cash from `GET /v1/me/balances`, in USDC base units, as
@@ -25,6 +26,31 @@ export function spendableCash(balance) {
         total: balance.state === "CURRENT" && balance.amount !== null ? BigInt(balance.amount) : null,
     };
 }
+/**
+ * The HyperCore USDC a Combo offers its bridge (`core` for `openPosition`,
+ * `signEntry` and `prepareEntryFunding`): all of `spendable`, less
+ * `coreSetupFee` when the bridge also pays it. `null` while either is unknown
+ * and there is Core to bridge.
+ */
+export function offeredCore(spendable, setupFee) {
+    if (spendable === null || spendable === 0n || setupFee === false)
+        return spendable;
+    if (setupFee === null)
+        return null;
+    return spendable > coreSetupFee ? spendable - coreSetupFee : 0n;
+}
+/**
+ * The largest stake one Combo can take now, in USDC base units, as an entry
+ * plans its funding: free vault cash, then available wallet USDC, then a
+ * bridge of the offered Core less `bridgeGasBuffer`. `null` when any part is
+ * unknown, never a partial sum.
+ */
+export function comboAllowance(cash) {
+    const { vault, wallet, core } = cash;
+    if (vault === null || wallet === null || core === null)
+        return null;
+    return vault + wallet + (core > bridgeGasBuffer ? core - bridgeGasBuffer : 0n);
+}
 /**
  * What the owner receives from a gross close amount (a settlement payout or a
  * sell-back price), as the vault pays it: the profit fee is

package/dist/totalis.d.ts

@@ -1,7 +1,7 @@
 import { issueApiKey, rotateApiKey } from "./api-keys.js";
 import { type AccessToken, type ApiClientOptions, type PublicEnvironment } from "./base.js";
 import type { paths } from "./generated/client.js";
-import { type BridgedCash, type HypercoreAnswer, type HypercoreTransport, type SignedSendAsset } from "./hypercore.js";
+import { type BridgedCash, type CoreAccountMode, type HypercoreAnswer, type HypercoreTransport, type HyperliquidInfo, type SignedSendAsset } from "./hypercore.js";
 import { BalanceUnknownError, EntryError, ExitUnavailableError } from "./flow-errors.js";
 import { ApiError, NetworkError, type RetryPolicy } from "./request.js";
 import { type SignerInput } from "./signer.js";
@@ -69,6 +69,23 @@ export type EntryCash = {
     readonly wallet: Amount | null;
 };
 export type DepositAccepted = Ok<"/v1/me/deposits", "post", 202>;
+/**
+ * What one Combo can stake, from the venue balances and the account's
+ * HyperCore cash, in USDC base units (`readComboCash`). `vault` and `wallet`
+ * are `spendableCash`'s; `core` is HyperCore spot USDC less its hold;
+ * `setupFee` whether a bridge from it pays Hyperliquid's one-time setup fee;
+ * `offeredCore` what an entry may bridge (`offeredCore`); `allowance` the
+ * largest stake (`comboAllowance`). Each is `null` when unknown, never 0.
+ */
+export type ComboCash = {
+    readonly vault: bigint | null;
+    readonly wallet: bigint | null;
+    readonly coreMode: CoreAccountMode | null;
+    readonly core: bigint | null;
+    readonly setupFee: boolean | null;
+    readonly offeredCore: bigint | null;
+    readonly allowance: bigint | null;
+};
 /** Who signed an acceptance record, and for which vault; a record is only sent or recovered by the same account on the same deployment. */
 type RecordScope = {
     readonly acceptanceId: string;
@@ -263,6 +280,10 @@ export declare function createTotalis(options: TotalisOptions): {
         readonly wallet: bigint | null;
         readonly total: bigint | null;
     }>;
+    readComboCash: (options?: {
+        readonly info?: HyperliquidInfo;
+        readonly signal?: AbortSignal;
+    }) => Promise<ComboCash>;
     openPosition: (request: {
         readonly legs: readonly Leg[];
         readonly stake: Amount;

package/dist/totalis.js

@@ -1,9 +1,9 @@
 import { keccak_256 } from "@noble/hashes/sha3";
 import { createApiKeyClient, issueApiKey, rotateApiKey } from "./api-keys.js";
 import { audienceClient, headerRecord } from "./base.js";
-import { bridgeAction, bridgeGasBuffer, hyperliquidExchange, hyperliquidNetwork, settleHypercore, signSendAsset, usdcUnits, } from "./hypercore.js";
+import { bridgeAction, bridgeGasBuffer, hyperliquidExchange, hyperliquidNetwork, readCoreCash, settleHypercore, signSendAsset, usdcUnits, } from "./hypercore.js";
 import { BalanceUnknownError, EntryError, ExitUnavailableError, normalizeError } from "./flow-errors.js";
-import { spendableCash } from "./money.js";
+import { comboAllowance, offeredCore, spendableCash } from "./money.js";
 import { ApiError, backoffDelay, envelope, NetworkError, randomBytes32, resendable, retryingFetch, sendOnce, singleFetch, sleep, unwrap, uuidv7 } from "./request.js";
 import { toTotalisSigner } from "./signer.js";
 import { TotalisStream } from "./stream.js";
@@ -433,6 +433,26 @@ export function createTotalis(options) {
     async function readSpendableCash(signal) {
         return spendableCash(unwrap(await client.GET("/v1/me/balances", signal === undefined ? {} : { signal })));
     }
+    /**
+     * The account's Combo cash now (`ComboCash`): one venue balances read and
+     * the signer's HyperCore cash read from Hyperliquid, together. Pass `cash`
+     * and `offeredCore` straight to `openPosition` (`cash`, `core`) so the entry
+     * plans from what was shown. A failed HyperCore read leaves its fields
+     * `null`; a failed balances read throws, as `spendableCash` does. `info`
+     * replaces the Hyperliquid read, for tests or a proxy.
+     */
+    async function readComboCash(options = {}) {
+        const [account, chain] = await Promise.all([(async () => (await requireSigner()).address())(), deployment()]);
+        const [venue, core] = await Promise.all([
+            readSpendableCash(options.signal),
+            readCoreCash(hyperliquidNetwork(chain.chain_id), account, options.info, options.signal),
+        ]);
+        const offered = offeredCore(core.spendable, core.setupFee);
+        return {
+            vault: venue.vault, wallet: venue.wallet, coreMode: core.mode, core: core.spendable, setupFee: core.setupFee,
+            offeredCore: offered, allowance: comboAllowance({ vault: venue.vault, wallet: venue.wallet, core: offered }),
+        };
+    }
     /** The wallet's USDC authorization of `value` into the vault; the venue fills `account` and `from` with the same wallet. */
     async function depositAuthorization(chain, account, value) {
         const authorization = { value: value.toString(), valid_after: String(now() - 60), valid_before: String(now() + 600), salt: randomBytes32() };
@@ -1360,6 +1380,7 @@ export function createTotalis(options) {
         deployment,
         /** Spendable Totalis cash from a fresh balances read (`spendableCash`): `{ vault, wallet, total }`, each `null` while unknown, never 0. */
         spendableCash: readSpendableCash,
+        readComboCash,
         openPosition,
         cashOut,
         prepareEntryFunding,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totalis/hip4-client",
-  "version": "0.80.0",
+  "version": "0.82.0",
   "description": "Totalis HIP-4 SDK: typed HTTP clients, signer-agnostic typed data, a retrying request layer, pagination, a realtime stream and taker/maker flows",
   "type": "module",
   "files": [