@totalis/hip4-client 0.76.0 → 0.78.0

package/CHANGELOG.md

@@ -3,6 +3,60 @@
 `@totalis/hip4-client` follows [semantic versioning](https://semver.org).
 The contract version the generated types come from is `sdkVersion` in `./version`.
 
+## 0.78.0
+
+### Added
+
+- `listComboFeed` (`GET /v1/feed/combos`): every Combo opened by a trader
+  whose profile is public, newest first, each with the trader's `username`,
+  `avatar_seed` and `picture_url`, paged with `cursor` and `limit` (TT-2615).
+  Contract `206.0.0-public-trader-reads`.
+- `listTraderPositions` answers `singles` on its first page: the HIP-4 outcome
+  sides the trader holds on HyperCore, each with `shares`, `average_price` and
+  `opened_at`, or null while they cannot be known.
+
+### Changed
+
+- `getTrader`, `listTraderTrades`, `listTraderPositions` and `getTraderPnl`
+  answer signed out too.
+
+## 0.77.0
+
+`openPosition` chooses its quote last and moves on to the next quote when an
+accept is refused, declined or times out (TT-2578, TT-2574). Makers replace
+quotes as they renew them, and an accept that took seconds to sign often found
+its quote gone (`QUOTE_REPLACED`). Additive: 0.76 code runs unchanged, but
+`openPosition` now sends up to `maxAttempts` accepts where it sent one or two.
+
+### Added
+
+- `prepareEntryFunding({ stake, core, cash, sourceDex, hypercoreNonce })`
+  plans and signs an entry's funding (the wallet's USDC authorization and any
+  bridge from Core) before a quote is chosen. `signEntry({ quote, prepared })`
+  then signs only the quote, so the accept can go straight out. A prepared
+  funding is for one accept.
+- `SignedEntry.refused`: the code of an accept the venue refused outright.
+  `recoverAcceptance` answers such a record `NOT_ADMITTED` from the record
+  alone, without reading the acceptance or cancelling the RFQ.
+- `openPosition` options `minPayout`, `refreshMs` (default 10 s) and
+  `maxAttempts` (default 4).
+
+### Changed
+
+- `openPosition` signs the funding first and chooses the quote after, then
+  signs it and sends the accept at once. Signing the funding counts against
+  `collectMs`.
+- On `QUOTE_REPLACED` or `QUOTE_EXPIRED`, `openPosition` hands `onSigned` the
+  record marked `refused`, then prepares the funding again and signs the best
+  other quote paying at least `minPayout` (left out: the first chosen quote's
+  payout). It keeps going until an accept is taken, `refreshMs` passes or
+  `maxAttempts` accepts were sent, and throws the last refusal. Before, it
+  retried once and took any payout.
+- A `DECLINED` or `TIMED_OUT` accept is followed the same way, within the
+  same `refreshMs` and `maxAttempts`: the maker's answer admitted nothing and
+  the RFQ stays open. With no other quote at or above `minPayout` in time,
+  `openPosition` returns that answer, as before.
+
 ## 0.76.0
 
 Vault agents (TT-2554), one Combo leg per question (TT-2605) and no legs on

package/README.md

@@ -66,8 +66,9 @@ if (opened.operationId) {
 totalis.close();
 ```
 
-`openPosition` creates the RFQ, takes the best quote, signs the acceptance and funds any shortfall from the
-wallet. Only `COMMITTED` means the trade happened. A decided position settles and pays out on its own.
+`openPosition` creates the RFQ, signs the funding for any shortfall from the wallet, then takes the best quote
+and signs the acceptance. If the maker replaced the quote first, declined it or didn't answer, it signs the best
+other quote paying at least the first one's payout (`minPayout`) and tries again. Only `COMMITTED` means the trade happened. A decided position settles and pays out on its own.
 
 ## Make markets
 

package/dist/client.d.ts

@@ -5,7 +5,7 @@ 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 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 { 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 { 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";

package/dist/generated/client.d.ts

@@ -39,6 +39,7 @@ export type paths = {
     readonly "/v1/traders/{username}/trades": Pick<SharedPaths["/v1/traders/{username}/trades"], "parameters" | "get">;
     readonly "/v1/traders/{username}/positions": Pick<SharedPaths["/v1/traders/{username}/positions"], "parameters" | "get">;
     readonly "/v1/traders/{username}/pnl": Pick<SharedPaths["/v1/traders/{username}/pnl"], "parameters" | "get">;
+    readonly "/v1/feed/combos": Pick<SharedPaths["/v1/feed/combos"], "parameters" | "get">;
     readonly "/v1/me/follows": Pick<SharedPaths["/v1/me/follows"], "parameters" | "get">;
     readonly "/v1/me/follows/{username}": Pick<SharedPaths["/v1/me/follows/{username}"], "parameters" | "put" | "delete">;
     readonly "/v1/me/copy-settings": Pick<SharedPaths["/v1/me/copy-settings"], "parameters" | "get" | "put">;
@@ -103,4 +104,4 @@ export type paths = {
     readonly "/v1/makers/{maker_id}/exposure": Pick<SharedPaths["/v1/makers/{maker_id}/exposure"], "parameters" | "get">;
     readonly "/v1/makers/{maker_id}/performance": Pick<SharedPaths["/v1/makers/{maker_id}/performance"], "parameters" | "get">;
 };
-export type operations = Pick<SharedOperations, "abandonCoreExit" | "acceptQuote" | "activeCoreExits" | "admitOwnMaker" | "admitPartnerWallet" | "bindEmbeddedWallet" | "cancelRfq" | "confirmComboCopyAgent" | "confirmCoreCopyAgent" | "createCashout" | "createComment" | "createCoreExit" | "createDeposit" | "createRfq" | "createRunOffClaim" | "createWalletChallenge" | "createWalletSession" | "createWithdrawal" | "deleteComment" | "editComment" | "endWalletSession" | "followTrader" | "getAcceptance" | "getAccountActivity" | "getAccountPnl" | "getAccountPosition" | "getBalances" | "getCopyAgents" | "getCopyBudget" | "getCopySettings" | "getCopySummary" | "getCoreExit" | "getDeployment" | "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" | "listCommentReplies" | "listComments" | "listControlledMakers" | "listCopiedFills" | "listCopyTrades" | "listDiscovery" | "listFollows" | "listMakerActivity" | "listMakerPositions" | "listMakerQuoteHistory" | "listMarkets" | "listOperations" | "listQuotes" | "listTraderPositions" | "listTraderTrades" | "reactComment" | "recordAcquisition" | "refreshPicture" | "requestComboCopyAgent" | "requestCoreCopyAgent" | "revokeComboCopyAgent" | "searchCatalog" | "setAvatar" | "setCopyAllocation" | "setCopySettings" | "setPublicProfile" | "setUsername" | "stream" | "streamMarkets" | "switchOffComboCopyAgent" | "switchOffCoreCopyAgent" | "unfollowTrader" | "unlikeComment" | "unreactComment">;
+export type operations = Pick<SharedOperations, "abandonCoreExit" | "acceptQuote" | "activeCoreExits" | "admitOwnMaker" | "admitPartnerWallet" | "bindEmbeddedWallet" | "cancelRfq" | "confirmComboCopyAgent" | "confirmCoreCopyAgent" | "createCashout" | "createComment" | "createCoreExit" | "createDeposit" | "createRfq" | "createRunOffClaim" | "createWalletChallenge" | "createWalletSession" | "createWithdrawal" | "deleteComment" | "editComment" | "endWalletSession" | "followTrader" | "getAcceptance" | "getAccountActivity" | "getAccountPnl" | "getAccountPosition" | "getBalances" | "getCopyAgents" | "getCopyBudget" | "getCopySettings" | "getCopySummary" | "getCoreExit" | "getDeployment" | "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" | "reactComment" | "recordAcquisition" | "refreshPicture" | "requestComboCopyAgent" | "requestCoreCopyAgent" | "revokeComboCopyAgent" | "searchCatalog" | "setAvatar" | "setCopyAllocation" | "setCopySettings" | "setPublicProfile" | "setUsername" | "stream" | "streamMarkets" | "switchOffComboCopyAgent" | "switchOffCoreCopyAgent" | "unfollowTrader" | "unlikeComment" | "unreactComment">;

package/dist/generated/errors.d.ts

@@ -407,8 +407,8 @@ export declare const operationErrors: {
     readonly getSeries: readonly ["INVALID_REQUEST", "NOT_FOUND", "MARKET_DATA_UNAVAILABLE", "INVALID_QUERY"];
     readonly getSuggestedCombo: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY"];
     readonly getTaxonomy: readonly ["INVALID_QUERY", "MARKET_DATA_UNAVAILABLE", "UNSUPPORTED_BROWSE_CONTRACT", "BROWSE_UNAVAILABLE"];
-    readonly getTrader: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE"];
-    readonly getTraderPnl: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE"];
+    readonly getTrader: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "NOT_FOUND", "SOURCE_UNAVAILABLE"];
+    readonly getTraderPnl: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE"];
     readonly getUsernameAvailability: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "IDENTITY_NOT_FOUND", "ORIGIN_REQUIRED"];
     readonly getVaultAgents: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY", "DEPENDENCY_STALE"];
     readonly getVolumeLeaderboard: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
@@ -419,13 +419,14 @@ export declare const operationErrors: {
     readonly listAccountActivity: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE", "CURSOR_EXPIRED"];
     readonly listAccountPositions: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE", "CURSOR_EXPIRED"];
     readonly listComboCopies: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
+    readonly listComboFeed: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "SOURCE_UNAVAILABLE"];
     readonly listCommentReplies: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "INVALID_CURSOR", "NOT_FOUND"];
     readonly listComments: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "INVALID_CURSOR", "SOURCE_UNAVAILABLE", "MARKET_DATA_UNAVAILABLE"];
     readonly listControlledMakers: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "INVALID_QUERY", "INVALID_CURSOR"];
     readonly listCopiedFills: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
     readonly listCopyTrades: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
     readonly listDiscovery: readonly ["INVALID_QUERY", "INVALID_CURSOR", "STALE_CURSOR", "MARKET_DATA_UNAVAILABLE", "UNSUPPORTED_BROWSE_CONTRACT", "BROWSE_UNAVAILABLE"];
-    readonly listFollows: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
+    readonly listFollows: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_QUERY"];
     readonly listMakerAcceptances: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "INVALID_CURSOR", "NOT_FOUND"];
     readonly listMakerActivity: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE", "CURSOR_EXPIRED"];
     readonly listMakerApiKeys: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND"];
@@ -437,8 +438,8 @@ export declare const operationErrors: {
     readonly listPersonalApiKeys: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND"];
     readonly listQuotes: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND"];
     readonly listRfqs: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "INVALID_CURSOR"];
-    readonly listTraderPositions: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE"];
-    readonly listTraderTrades: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "ORIGIN_REQUIRED", "NOT_FOUND", "SOURCE_UNAVAILABLE", "CONTRACT_UNAVAILABLE"];
+    readonly listTraderPositions: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "NOT_FOUND", "SOURCE_UNAVAILABLE"];
+    readonly listTraderTrades: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_QUERY", "NOT_FOUND", "SOURCE_UNAVAILABLE"];
     readonly live: readonly [];
     readonly publishMakerTelemetry: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "NOT_FOUND", "CONTRACT_UNAVAILABLE", "TELEMETRY_CONFLICT", "INVALID_REQUEST"];
     readonly reactComment: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY"];
@@ -460,14 +461,14 @@ export declare const operationErrors: {
     readonly setAvatar: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "IDENTITY_NOT_FOUND", "ORIGIN_REQUIRED"];
     readonly setCopyAllocation: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "DEPENDENCY_STALE", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "CONTRACT_UNAVAILABLE"];
     readonly setCopySettings: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "CONTRACT_UNAVAILABLE"];
-    readonly setPublicProfile: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "IDENTITY_NOT_FOUND", "USERNAME_REQUIRED", "ORIGIN_REQUIRED", "CONTRACT_UNAVAILABLE"];
+    readonly setPublicProfile: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "IDENTITY_NOT_FOUND", "USERNAME_REQUIRED", "ORIGIN_REQUIRED"];
     readonly setUsername: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "IDENTITY_NOT_FOUND", "USERNAME_NOT_ALLOWED", "USERNAME_TAKEN", "ORIGIN_REQUIRED"];
     readonly stream: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "SUBPROTOCOL_REQUIRED", "CONNECTION_LIMIT", "CONNECTION_DRAIN", "INVALID_REQUEST", "NOT_FOUND", "ORIGIN_REQUIRED"];
     readonly streamMarkets: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "SUBPROTOCOL_REQUIRED", "CONNECTION_LIMIT", "CONNECTION_DRAIN", "ORIGIN_NOT_ALLOWED", "INVALID_QUERY"];
     readonly submitMakerSelfFundedTransaction: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "STATE_CONFLICT", "FINANCIAL_ACTIONS_DISABLED", "INVALID_SIGNATURE", "CONTRACT_SIGNATURE_OVERLOADED", "NOT_FOUND"];
     readonly switchOffComboCopyAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
     readonly switchOffCoreCopyAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
-    readonly unfollowTrader: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "INVALID_REQUEST", "IDEMPOTENCY_KEY_REUSED", "CONTRACT_UNAVAILABLE"];
+    readonly unfollowTrader: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_IDEMPOTENCY_KEY", "INVALID_REQUEST", "IDEMPOTENCY_KEY_REUSED"];
     readonly unlikeComment: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY"];
     readonly unreactComment: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY"];
 };

package/dist/generated/errors.js

@@ -1171,10 +1171,8 @@ export const operationErrors = {
         "AUTHORIZATION_UNAVAILABLE",
         "RATE_LIMITED",
         "INVALID_QUERY",
-        "ORIGIN_REQUIRED",
         "NOT_FOUND",
-        "SOURCE_UNAVAILABLE",
-        "CONTRACT_UNAVAILABLE"
+        "SOURCE_UNAVAILABLE"
     ],
     "getTraderPnl": [
         "UNAUTHENTICATED",
@@ -1182,7 +1180,6 @@ export const operationErrors = {
         "AUTHORIZATION_UNAVAILABLE",
         "RATE_LIMITED",
         "INVALID_QUERY",
-        "ORIGIN_REQUIRED",
         "NOT_FOUND",
         "SOURCE_UNAVAILABLE",
         "CONTRACT_UNAVAILABLE"
@@ -1300,6 +1297,14 @@ export const operationErrors = {
         "INVALID_QUERY",
         "CONTRACT_UNAVAILABLE"
     ],
+    "listComboFeed": [
+        "UNAUTHENTICATED",
+        "FORBIDDEN",
+        "AUTHORIZATION_UNAVAILABLE",
+        "RATE_LIMITED",
+        "INVALID_QUERY",
+        "SOURCE_UNAVAILABLE"
+    ],
     "listCommentReplies": [
         "UNAUTHENTICATED",
         "FORBIDDEN",
@@ -1366,8 +1371,7 @@ export const operationErrors = {
         "RATE_LIMITED",
         "ORIGIN_REQUIRED",
         "IDENTITY_NOT_FOUND",
-        "INVALID_QUERY",
-        "CONTRACT_UNAVAILABLE"
+        "INVALID_QUERY"
     ],
     "listMakerAcceptances": [
         "UNAUTHENTICATED",
@@ -1483,10 +1487,8 @@ export const operationErrors = {
         "AUTHORIZATION_UNAVAILABLE",
         "RATE_LIMITED",
         "INVALID_QUERY",
-        "ORIGIN_REQUIRED",
         "NOT_FOUND",
-        "SOURCE_UNAVAILABLE",
-        "CONTRACT_UNAVAILABLE"
+        "SOURCE_UNAVAILABLE"
     ],
     "listTraderTrades": [
         "UNAUTHENTICATED",
@@ -1494,10 +1496,8 @@ export const operationErrors = {
         "AUTHORIZATION_UNAVAILABLE",
         "RATE_LIMITED",
         "INVALID_QUERY",
-        "ORIGIN_REQUIRED",
         "NOT_FOUND",
-        "SOURCE_UNAVAILABLE",
-        "CONTRACT_UNAVAILABLE"
+        "SOURCE_UNAVAILABLE"
     ],
     "live": [],
     "publishMakerTelemetry": [
@@ -1728,8 +1728,7 @@ export const operationErrors = {
         "IDEMPOTENCY_KEY_REUSED",
         "IDENTITY_NOT_FOUND",
         "USERNAME_REQUIRED",
-        "ORIGIN_REQUIRED",
-        "CONTRACT_UNAVAILABLE"
+        "ORIGIN_REQUIRED"
     ],
     "setUsername": [
         "UNAUTHENTICATED",
@@ -1816,8 +1815,7 @@ export const operationErrors = {
         "IDENTITY_NOT_FOUND",
         "INVALID_IDEMPOTENCY_KEY",
         "INVALID_REQUEST",
-        "IDEMPOTENCY_KEY_REUSED",
-        "CONTRACT_UNAVAILABLE"
+        "IDEMPOTENCY_KEY_REUSED"
     ],
     "unlikeComment": [
         "UNAUTHENTICATED",

package/dist/generated/openapi.d.ts

@@ -725,7 +725,7 @@ export type paths = {
         readonly get?: never;
         /**
          * Turn the public trader profile on or off
-         * @description Turns the authenticated account's public trader profile on (public: true) or off. It starts on, and an account without a username can turn it off before picking one; nothing names the profile until then. While it is on, any signed-in participant reads GET /v1/traders/{username}: the username, avatar, account wallet, volume, trades, open Combos and P&L, and the leaderboards mark the account public_profile. Its HyperCore fills and tickets are public on chain anyway; what turning it on discloses is that the wallet belongs to the username. Turning it on needs a username (409 USERNAME_REQUIRED); public_since keeps the first time it went on until it is turned off. Call it after POST /v1/me/embedded-wallet; before that it is 404 IDENTITY_NOT_FOUND. Asking for the current state again returns 204, so a retry is safe. Idempotency-Keys order these requests: the other state under the account's newest key, or under an older key, is 409 IDEMPOTENCY_KEY_REUSED, so a delayed retry never undoes a newer request. A key stamped more than 5 minutes ahead of server time is 400 INVALID_REQUEST.
+         * @description Turns the authenticated account's public trader profile on (public: true) or off. It starts on, and an account without a username can turn it off before picking one; nothing names the profile until then. While it is on, anyone, signed in or not, reads GET /v1/traders/{username}: the username, avatar, account wallet, volume, trades, open Combos and singles and P&L, and GET /v1/feed/combos lists the Combos it opens, and the leaderboards mark the account public_profile. Its HyperCore fills and tickets are public on chain anyway; what turning it on discloses is that the wallet belongs to the username. Turning it on needs a username (409 USERNAME_REQUIRED); public_since keeps the first time it went on until it is turned off. Call it after POST /v1/me/embedded-wallet; before that it is 404 IDENTITY_NOT_FOUND. Asking for the current state again returns 204, so a retry is safe. Idempotency-Keys order these requests: the other state under the account's newest key, or under an older key, is 409 IDEMPOTENCY_KEY_REUSED, so a delayed retry never undoes a newer request. A key stamped more than 5 minutes ahead of server time is 400 INVALID_REQUEST.
          */
         readonly put: operations["setPublicProfile"];
         readonly post?: never;
@@ -744,7 +744,7 @@ export type paths = {
         };
         /**
          * Get a public trader profile
-         * @description A trader's public profile, while they have turned it on with PUT /v1/me/public-profile: their username, avatar, the account wallet they trade from, which clients read HyperCore holdings for from Hyperliquid, their follower count, whether the reader follows them, and their all-time volume, counted as GET /v1/leaderboard/volume counts it. Only a signed-in participant session reads it: anonymous calls and API keys are refused. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND.
+         * @description A trader's public profile, while they have turned it on with PUT /v1/me/public-profile: their username, avatar, the account wallet they trade from, which clients read HyperCore holdings for from Hyperliquid, their follower count, whether the reader follows them, and their all-time volume, counted as GET /v1/leaderboard/volume counts it. Anyone reads it, signed out or with any credential, from any origin; a supplied credential must still authenticate. A signed-out answer is the same for everyone and is cached for 30 seconds. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND, signed in or not.
          */
         readonly get: operations["getTrader"];
         readonly put?: never;
@@ -764,7 +764,7 @@ export type paths = {
         };
         /**
          * List a public trader's trades
-         * @description A public trader's trades, newest first: each HyperCore fill GET /v1/leaderboard/volume counts as theirs (on their Totalis embedded wallet, or an order the app placed on another linked wallet), each Combo ticket a wallet of theirs opened, when it did (a ticket passed to them on is not their entry), and each sold back from a wallet of theirs, when it was. Poll the first page for new trades; ids are stable. The cursor never expires. Only a signed-in participant session reads it: anonymous calls and API keys are refused. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND.
+         * @description A public trader's trades, newest first: each HyperCore fill GET /v1/leaderboard/volume counts as theirs (on their Totalis embedded wallet, or an order the app placed on another linked wallet), each Combo ticket a wallet of theirs opened, when it did (a ticket passed to them on is not their entry), and each sold back from a wallet of theirs, when it was. Poll the first page for new trades; ids are stable. The cursor never expires. Anyone reads it, signed out or with any credential, from any origin; a supplied credential must still authenticate. A signed-out answer is the same for everyone and is cached for 30 seconds. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND, signed in or not.
          */
         readonly get: operations["listTraderTrades"];
         readonly put?: never;
@@ -783,8 +783,8 @@ export type paths = {
             readonly cookie?: never;
         };
         /**
-         * List a public trader's open Combos
-         * @description A public trader's open Combo tickets, newest first by opening, including tickets passed to them. Their HyperCore holdings are on Hyperliquid: read them for the profile's account wallet. Only a signed-in participant session reads it: anonymous calls and API keys are refused. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND.
+         * List a public trader's open Combos and singles
+         * @description A public trader's open Combo tickets, newest first by opening, including tickets passed to them, and on the first page (no cursor) their singles: the HIP-4 outcome sides their account wallet holds on HyperCore, replayed from its whole fill history in the account index. singles is null while that history cannot prove them: off Mainnet, while the index is behind or missing history, after an outcome token moved by transfer, or while the read fails. A later page leaves singles out. Anyone reads it, signed out or with any credential, from any origin; a supplied credential must still authenticate. A signed-out answer is the same for everyone and is cached for 30 seconds. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND, signed in or not.
          */
         readonly get: operations["listTraderPositions"];
         readonly put?: never;
@@ -804,7 +804,7 @@ export type paths = {
         };
         /**
          * Get a public trader's P&L series
-         * @description A public trader's cumulative trading P&L over one range: what GET /v1/me/pnl shows them for their account wallet. Only a signed-in participant session reads it: anonymous calls and API keys are refused. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND.
+         * @description A public trader's cumulative trading P&L over one range: what GET /v1/me/pnl shows them for their account wallet. Anyone reads it, signed out or with any credential, from any origin; a supplied credential must still authenticate. A signed-out answer is the same for everyone and is cached for 30 seconds. A username with no public profile, whether private, unknown or held by an account that is not ACTIVE, is 404 NOT_FOUND, signed in or not.
          */
         readonly get: operations["getTraderPnl"];
         readonly put?: never;
@@ -815,6 +815,26 @@ export type paths = {
         readonly patch?: never;
         readonly trace?: never;
     };
+    readonly "/v1/feed/combos": {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        /**
+         * List the Combos public traders opened
+         * @description Every Combo ticket opened by a trader whose profile is public (PUT /v1/me/public-profile), newest first by opening, a page at a time, with the trader's username and avatar. A ticket counts for the participant whose linked wallet opened it, whoever holds it now; a profile turned off leaves the feed, and one turned on brings its Combos back. A page reads a bounded run of tickets, so it may hold fewer than limit, even none, while has_more is true. Poll the first page for new Combos; the cursor never expires. Anyone reads it, signed out or with any credential, from any origin; a supplied credential must still authenticate. A signed-out answer is the same for everyone and is cached for 30 seconds.
+         */
+        readonly get: operations["listComboFeed"];
+        readonly put?: never;
+        readonly post?: never;
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
     readonly "/v1/me/follows": {
         readonly parameters: {
             readonly query?: never;
@@ -845,7 +865,7 @@ export type paths = {
         readonly get?: never;
         /**
          * Follow a trader or set a follow's copy settings
-         * @description Follows the trader whose public profile has this username, and answers the follow's copy settings. A follow alone copies nothing: it puts the trader's trades in the account's feed. Send {} to follow: a new follow takes the defaults (automatic copying off, FIXED 10 USDC a trade up to 100 USDC, 5 open positions, 100 bps slippage, exits mirrored) and an existing one keeps its settings. Send both core and combos to replace the follow's settings, following first if needed. Automatic copying also needs the product's copy agent, and stops while the account is paused (PUT /v1/me/copy-settings) or the trader's profile is off. Idempotency-Keys order every write to a follow, unfollows included: a request under a key no newer than the follow's latest succeeds only if the follow is already as it asks (followed, with these settings if it sends any), so a retry is safe; anything else is 409 IDEMPOTENCY_KEY_REUSED, so a delayed retry never undoes a newer follow, settings change or unfollow. A key stamped more than 5 minutes ahead of server time is 400 INVALID_REQUEST. A username with no public profile is 404 NOT_FOUND; the account's own username is 422 FOLLOW_SELF; a 101st follow is 422 FOLLOW_LIMIT_REACHED.
+         * @description Follows the trader whose public profile has this username, and answers the follow's copy settings. A follow alone copies nothing: it puts the trader's trades in the account's feed. Send {} to follow: a new follow takes the defaults (automatic copying off, FIXED 10 USDC a trade up to 100 USDC, 5 open positions, 100 bps slippage, exits mirrored) and an existing one keeps its settings. Send both core and combos to replace the follow's settings, following first if needed. Automatic copying also needs the product's copy agent, and stops while the account is paused (PUT /v1/me/copy-settings) or the trader's profile is off. Idempotency-Keys order every write to a follow, unfollows included: a request under a key no newer than the follow's latest succeeds only if the follow is already as it asks (followed, with these settings if it sends any), so a retry is safe; anything else is 409 IDEMPOTENCY_KEY_REUSED, so a delayed retry never undoes a newer follow, settings change or unfollow. A key stamped more than 5 minutes ahead of server time is 400 INVALID_REQUEST. A username with no public profile is 404 NOT_FOUND; the account's own username is 422 FOLLOW_SELF; a 101st follow is 422 FOLLOW_LIMIT_REACHED. Where copy trading is not available, a plain follow ({}) still works but a body with copy settings is 503 CONTRACT_UNAVAILABLE.
          */
         readonly put: operations["followTrader"];
         readonly post?: never;
@@ -2663,6 +2683,35 @@ export type components = {
         };
         /** TraderCombo */
         readonly TraderCombo: components["schemas"]["TraderComboFields"];
+        /**
+         * TraderSingle
+         * @description A HIP-4 outcome side a trader's account wallet holds on HyperCore.
+         */
+        readonly TraderSingle: {
+            /** @description HIP-4 outcome ID held, as a decimal string. */
+            readonly outcome_id: components["schemas"]["UInt32String"];
+            /** @description Outcome side held. */
+            readonly side: components["schemas"]["Side"];
+            /** @description Shares held, an exact decimal string with no trailing zeros. */
+            readonly shares: string;
+            /** @description What each held share cost on average in USDC, fees included: buys add their cost and a sale removes its shares' share of it. Rounded half away from zero to 6 decimals, no trailing zeros. Absent when the holding's fills brought cash in rather than paid it out. */
+            readonly average_price?: string;
+            /** @description HyperCore block time of the fill that last opened the holding from none. */
+            readonly opened_at: components["schemas"]["$defs-Timestamp"];
+        };
+        /**
+         * ComboFeedItem
+         * @description A Combo a public trader opened.
+         */
+        readonly ComboFeedItem: {
+            readonly username: components["schemas"]["Username"];
+            /** @description The seed clients draw the trader's generated avatar from, as for GET /v1/traders/{username}. */
+            readonly avatar_seed: components["schemas"]["AvatarSeed"];
+            /** @description The trader's X picture, shown in place of the generated avatar; absent when there is none. */
+            readonly picture_url?: components["schemas"]["XPictureUrl"];
+            /** @description HyperEVM block time of the ticket's opening. */
+            readonly opened_at: components["schemas"]["$defs-Timestamp"];
+        } & components["schemas"]["TraderComboFields"];
         /** @description One live, unsigned quote on an RFQ, told apart by `kind`. List quotes, the account snapshot's quotes and `QUOTE_CREATED` carry the same item. */
         readonly Quote: components["schemas"]["EntryQuote"] | components["schemas"]["SellBackQuote"] | components["schemas"]["TransferQuote"];
         /** @description A maker's offer to open a position on an entry RFQ. */
@@ -7755,7 +7804,8 @@ export interface operations {
             /** @description The profile */
             readonly 200: {
                 headers: {
-                    readonly "Cache-Control"?: "no-store";
+                    /** @description public, max-age=30 for a signed-out read, which the edge may share; no-store for one with a credential. */
+                    readonly "Cache-Control"?: "public, max-age=30" | "no-store";
                     readonly [name: string]: unknown;
                 };
                 content: {
@@ -7820,7 +7870,8 @@ export interface operations {
             /** @description A page of trades */
             readonly 200: {
                 headers: {
-                    readonly "Cache-Control"?: "no-store";
+                    /** @description public, max-age=30 for a signed-out read, which the edge may share; no-store for one with a credential. */
+                    readonly "Cache-Control"?: "public, max-age=30" | "no-store";
                     readonly [name: string]: unknown;
                 };
                 content: {
@@ -7895,7 +7946,8 @@ export interface operations {
             /** @description A page of open Combos */
             readonly 200: {
                 headers: {
-                    readonly "Cache-Control"?: "no-store";
+                    /** @description public, max-age=30 for a signed-out read, which the edge may share; no-store for one with a credential. */
+                    readonly "Cache-Control"?: "public, max-age=30" | "no-store";
                     readonly [name: string]: unknown;
                 };
                 content: {
@@ -7907,6 +7959,8 @@ export interface operations {
                         } & components["schemas"]["TraderComboFields"])[];
                         readonly next_cursor: components["schemas"]["NextCursor"];
                         readonly has_more: boolean;
+                        /** @description The trader's open singles, newest opened first; null when they cannot be known. Only on the first page. */
+                        readonly singles?: null | readonly components["schemas"]["TraderSingle"][];
                     };
                 };
             };
@@ -7936,7 +7990,8 @@ export interface operations {
             /** @description The trader's P&L series */
             readonly 200: {
                 headers: {
-                    readonly "Cache-Control"?: "no-store";
+                    /** @description public, max-age=30 for a signed-out read, which the edge may share; no-store for one with a credential. */
+                    readonly "Cache-Control"?: "public, max-age=30" | "no-store";
                     readonly [name: string]: unknown;
                 };
                 content: {
@@ -7951,6 +8006,49 @@ export interface operations {
             readonly 503: components["responses"]["Unavailable"];
         };
     };
+    readonly listComboFeed: {
+        readonly parameters: {
+            readonly query?: {
+                /**
+                 * @description Omit for the first page; then send the previous response's next_cursor unchanged.
+                 * @example eyJ2IjoxLCJzIjoiMTIzNDUifQ
+                 */
+                readonly cursor?: components["parameters"]["Cursor"];
+                /**
+                 * @description Maximum items per page, 1 to 200, default 50. A page may hold fewer, even none, while has_more is true.
+                 * @example 50
+                 */
+                readonly limit?: components["parameters"]["Limit"];
+            };
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly requestBody?: never;
+        readonly responses: {
+            /** @description A page of public traders' Combos */
+            readonly 200: {
+                headers: {
+                    /** @description public, max-age=30 for a signed-out read, which the edge may share; no-store for one with a credential. */
+                    readonly "Cache-Control"?: "public, max-age=30" | "no-store";
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": {
+                        /** @description Combos, newest first by opening. */
+                        readonly items: readonly components["schemas"]["ComboFeedItem"][];
+                        readonly next_cursor: components["schemas"]["NextCursor"];
+                        readonly has_more: boolean;
+                    };
+                };
+            };
+            readonly 400: components["responses"]["Error"];
+            readonly 401: components["responses"]["Error"];
+            readonly 403: components["responses"]["Error"];
+            readonly 429: components["responses"]["RateLimited"];
+            readonly 503: components["responses"]["Unavailable"];
+        };
+    };
     readonly listFollows: {
         readonly parameters: {
             readonly query?: never;

package/dist/generated/version.d.ts

@@ -1,5 +1,5 @@
-export declare const sdkVersion = "205.0.0-device-vault-agents";
-export declare const openapiSha256 = "93141e0bf50949fc37ebceef7c64555eb50a70f69c71c89c8fdc12780e0dd168";
+export declare const sdkVersion = "206.0.0-public-trader-reads";
+export declare const openapiSha256 = "1c4c1c9a685d200b19fc047a9ff25240c7a7ba37520bd6a9dc2ea6b78b696e64";
 export declare const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
 export declare const jsonSchemaSha256: {
     readonly "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6";
@@ -18,7 +18,7 @@ export declare const jsonSchemaSha256: {
     readonly "realtime.schema.json": "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
 };
 export declare const operations: {
-    readonly client: readonly ["abandonCoreExit", "acceptQuote", "activeCoreExits", "admitOwnMaker", "admitPartnerWallet", "bindEmbeddedWallet", "cancelRfq", "confirmComboCopyAgent", "confirmCoreCopyAgent", "createCashout", "createComment", "createCoreExit", "createDeposit", "createRfq", "createRunOffClaim", "createWalletChallenge", "createWalletSession", "createWithdrawal", "deleteComment", "editComment", "endWalletSession", "followTrader", "getAcceptance", "getAccountActivity", "getAccountPnl", "getAccountPosition", "getBalances", "getCopyAgents", "getCopyBudget", "getCopySettings", "getCopySummary", "getCoreExit", "getDeployment", "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", "listCommentReplies", "listComments", "listControlledMakers", "listCopiedFills", "listCopyTrades", "listDiscovery", "listFollows", "listMakerActivity", "listMakerPositions", "listMakerQuoteHistory", "listMarkets", "listOperations", "listQuotes", "listTraderPositions", "listTraderTrades", "reactComment", "recordAcquisition", "refreshPicture", "requestComboCopyAgent", "requestCoreCopyAgent", "revokeComboCopyAgent", "searchCatalog", "setAvatar", "setCopyAllocation", "setCopySettings", "setPublicProfile", "setUsername", "stream", "streamMarkets", "switchOffComboCopyAgent", "switchOffCoreCopyAgent", "unfollowTrader", "unlikeComment", "unreactComment"];
+    readonly client: readonly ["abandonCoreExit", "acceptQuote", "activeCoreExits", "admitOwnMaker", "admitPartnerWallet", "bindEmbeddedWallet", "cancelRfq", "confirmComboCopyAgent", "confirmCoreCopyAgent", "createCashout", "createComment", "createCoreExit", "createDeposit", "createRfq", "createRunOffClaim", "createWalletChallenge", "createWalletSession", "createWithdrawal", "deleteComment", "editComment", "endWalletSession", "followTrader", "getAcceptance", "getAccountActivity", "getAccountPnl", "getAccountPosition", "getBalances", "getCopyAgents", "getCopyBudget", "getCopySettings", "getCopySummary", "getCoreExit", "getDeployment", "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", "reactComment", "recordAcquisition", "refreshPicture", "requestComboCopyAgent", "requestCoreCopyAgent", "revokeComboCopyAgent", "searchCatalog", "setAvatar", "setCopyAllocation", "setCopySettings", "setPublicProfile", "setUsername", "stream", "streamMarkets", "switchOffComboCopyAgent", "switchOffCoreCopyAgent", "unfollowTrader", "unlikeComment", "unreactComment"];
     readonly maker: readonly ["cancelQuote", "confirmQuote", "createCollateralReduction", "createQuote", "getAccountActivity", "getAccountPosition", "getCollateralReduction", "getDeployment", "getMakerActivity", "getMakerCapital", "getMakerExposure", "getMakerPerformance", "getMakerPosition", "getMakerQuotes", "getMakerTelemetry", "getMakerTelemetryPublication", "getMakerVaultFundingTransaction", "getMakerWithdrawal", "getMarket", "getMarketHistory", "getMarketRecurringRound", "getMarketReferenceCloses", "getOperation", "getQuestion", "getQuestionRecurringRound", "getRfq", "getSeries", "getTaxonomy", "listAccountActivity", "listAccountPositions", "listDiscovery", "listMakerAcceptances", "listMakerActivity", "listMakerPositions", "listMakerQuoteHistory", "listMarkets", "listOperations", "listRfqs", "publishMakerTelemetry", "releaseQuoteLease", "renewQuoteLease", "searchCatalog", "stream", "submitMakerSelfFundedTransaction"];
     readonly operator: readonly ["live", "ready"];
 };

package/dist/generated/version.js

@@ -1,6 +1,6 @@
 // Generated by scripts/generate.mjs; do not edit.
-export const sdkVersion = "205.0.0-device-vault-agents";
-export const openapiSha256 = "93141e0bf50949fc37ebceef7c64555eb50a70f69c71c89c8fdc12780e0dd168";
+export const sdkVersion = "206.0.0-public-trader-reads";
+export const openapiSha256 = "1c4c1c9a685d200b19fc047a9ff25240c7a7ba37520bd6a9dc2ea6b78b696e64";
 export const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
 export const jsonSchemaSha256 = {
     "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6",
@@ -98,6 +98,7 @@ export const operations = {
         "listAccountActivity",
         "listAccountPositions",
         "listComboCopies",
+        "listComboFeed",
         "listCommentReplies",
         "listComments",
         "listControlledMakers",

package/dist/totalis.d.ts

@@ -102,6 +102,27 @@ export type SignedEntry = RecordScope & {
     readonly command: AcceptCommand;
     readonly bridge?: SignedSendAsset;
     readonly bridgeState?: BridgeState;
+    /**
+     * Set when the venue refused this accept outright (`QUOTE_REPLACED`,
+     * `QUOTE_EXPIRED`): nothing was admitted, so `recoverAcceptance` answers
+     * `NOT_ADMITTED` without reading or cancelling the RFQ, which a later
+     * attempt may be using.
+     */
+    readonly refused?: string;
+};
+/**
+ * An entry's funding, signed before its quote is chosen
+ * (`prepareEntryFunding`). Pass it to `signEntry` as `prepared`, so only the
+ * quote is left to sign once it is chosen. It funds one accept: prepare again
+ * for another.
+ */
+export type PreparedEntryFunding = {
+    readonly stake: string;
+    readonly account: Hex;
+    readonly chainId: string;
+    readonly vault: Hex;
+    readonly funding?: Funding;
+    readonly bridge?: SignedSendAsset;
 };
 /** An entry record from SDK 0.63 or older, which sent its bridge before the accept: `recoverAcceptance` reads it and sends nothing, and `sendAcceptance` refuses it. */
 export type LegacySignedEntry = Omit<SignedEntry, "version" | "bridgeState">;
@@ -246,7 +267,7 @@ export declare function createTotalis(options: TotalisOptions): {
         readonly legs: readonly Leg[];
         readonly stake: Amount;
         readonly choose?: Chooser<EntryQuote>;
-        /** How long quotes may keep arriving after the first one `choose` would take, before it picks; 0 takes it at once. */
+        /** How long quotes may keep arriving after the first one `choose` would take, before it picks; 0 takes it at once. Time spent signing the funding counts. */
         readonly collectMs?: number;
         /** `"wallet"` (default) plans the shortfall from the wallet and `core`; `"none"` never funds; or pass a funding command. */
         readonly funding?: "wallet" | "none" | Funding;
@@ -254,9 +275,9 @@ export declare function createTotalis(options: TotalisOptions): {
         readonly core?: Amount | null;
         readonly sourceDex?: "spot" | "";
         readonly transport?: HypercoreTransport;
-        /** The cash to plan from (see `signEntry`); left out, the balances are read while the quotes arrive. */
+        /** The cash to plan from (see `signEntry`); left out, the balances are read while the RFQ is created, and again for each refresh. */
         readonly cash?: EntryCash;
-        /** Awaited with the signed record before anything is sent, then with each change to its bridge (`onRecord`): persist it to `recoverAcceptance` after a restart. */
+        /** Awaited with the signed record before anything is sent, then with each change to its bridge (`onRecord`) or its refusal: persist it to `recoverAcceptance` after a restart. */
         readonly onSigned?: RecordListener;
         /** Automatic-quote intent identity, as the Totalis app sends it. */
         readonly intent?: {
@@ -264,6 +285,12 @@ export declare function createTotalis(options: TotalisOptions): {
             readonly intent_generation: string;
         };
         readonly quoteTimeoutMs?: number;
+        /** The least payout a quote may pay, in USDC base units. Left out, it is the first chosen quote's: a refresh never takes less. */
+        readonly minPayout?: Amount;
+        /** How long after the first quote is chosen a refused, declined or timed-out accept may still be followed by another (default 10 s). */
+        readonly refreshMs?: number;
+        /** The most accepts sent, the first included (default 4); 1 never refreshes. */
+        readonly maxAttempts?: number;
         readonly signal?: AbortSignal;
     }) => Promise<{
         entry: {
@@ -297,6 +324,14 @@ export declare function createTotalis(options: TotalisOptions): {
         readonly quoteTimeoutMs?: number;
         readonly signal?: AbortSignal;
     }) => Promise<AcceptanceResult>;
+    prepareEntryFunding: (request: {
+        readonly stake: Amount;
+        readonly core?: Amount | null | undefined;
+        readonly cash?: EntryCash | undefined;
+        readonly sourceDex?: "spot" | "" | undefined;
+        readonly hypercoreNonce?: number | undefined;
+        readonly signal?: AbortSignal | undefined;
+    }) => Promise<PreparedEntryFunding>;
     signEntry: (request: {
         readonly quote: EntryQuote;
         readonly core?: Amount | null;
@@ -304,6 +339,7 @@ export declare function createTotalis(options: TotalisOptions): {
         readonly sourceDex?: "spot" | "";
         readonly acceptanceId?: string;
         readonly hypercoreNonce?: number;
+        readonly prepared?: PreparedEntryFunding;
     }) => Promise<SignedEntry>;
     signCashout: (request: {
         readonly quote: CashoutBid;

package/dist/totalis.js

@@ -87,6 +87,11 @@ const minimumDeposit = 1000000n;
  * best of them win instead of the fastest.
  */
 const defaultCollectMs = 1_000;
+const defaultRefreshMs = 10_000;
+const defaultMaxAttempts = 4;
+/** Accept refusals that mean the chosen quote went away before the accept, not that the position cannot open. */
+const refreshCodes = new Set(["QUOTE_EXPIRED", "QUOTE_REPLACED"]);
+const passedOn = new Set(["DECLINED", "TIMED_OUT"]);
 const timerSlackMs = 250;
 function termsOf(quote) {
     return quote.kind === "ENTRY" ? quote.entry : quote.kind === "SELL_BACK" ? quote.sell_back : quote.transfer;
@@ -641,11 +646,46 @@ export function createTotalis(options) {
             throw new EntryError("INSUFFICIENT_FUNDS", `${bridge - (routable > 0n ? routable : 0n)} USDC base units short for this stake`);
         return { wallet: shortfall, bridge };
     }
+    function signBridge(signer, chain, amount, request) {
+        return amount > 0n ? signSendAsset(signer, bridgeAction(hyperliquidNetwork(chain.chain_id), amount, {
+            ...(request.hypercoreNonce === undefined ? {} : { nonce: request.hypercoreNonce }),
+            ...(request.sourceDex === undefined ? {} : { sourceDex: request.sourceDex }),
+        })) : undefined;
+    }
+    /**
+     * Plan and sign an entry's funding before choosing its quote: the wallet's
+     * USDC authorization and any bridge from `core`, planned from `cash` or a
+     * fresh balances read as `signEntry` plans them. Neither names a quote, so
+     * once one is chosen `signEntry({ quote, prepared })` signs only the quote
+     * and the accept can go straight out.
+     */
+    async function prepareEntryFunding(request) {
+        const { signer, account, chain, scope } = await recordScope();
+        const stake = BigInt(request.stake);
+        const core = request.core === undefined || request.core === null ? request.core : BigInt(request.core);
+        const plan = planEntry(stake, core, request.cash ?? await readSpendableCash(request.signal));
+        const [bridge, funding] = await Promise.all([
+            signBridge(signer, chain, plan.bridge, request),
+            plan.wallet > 0n ? depositAuthorization(chain, account, plan.wallet) : undefined,
+        ]);
+        return { stake: stake.toString(), ...scope, ...(funding === undefined ? {} : { funding }), ...(bridge === undefined ? {} : { bridge }) };
+    }
     async function signEntryWith(request, funding) {
-        const { quote, cash } = request;
+        const { quote, cash, prepared } = request;
         const { signer, vaultSigner, account, chain, scope } = await recordScope();
         if (quote.entry.taker.toLowerCase() !== account)
             throw new Error("the quote is for another taker");
+        const record = (taker_signature, fundingCommand, bridge) => ({
+            kind: "ENTRY", version: 2, acceptanceId: request.acceptanceId ?? uuidv7(), rfqId: quote.rfq_id, quoteId: quote.quote_id, ...scope, expiry: quote.entry.expiry,
+            command: { taker_signature, ...(fundingCommand === undefined ? {} : { funding: fundingCommand }) },
+            ...(bridge === undefined ? {} : { bridge }),
+        });
+        if (prepared !== undefined) {
+            if (prepared.stake !== quote.entry.stake || prepared.account !== scope.account || prepared.chainId !== scope.chainId || prepared.vault !== scope.vault) {
+                throw new Error("the prepared funding is for another stake, account or deployment");
+            }
+            return record(await vaultSigner.signTypedData(takerAcceptTypedData(chain, quote.entry)), prepared.funding, prepared.bridge);
+        }
         const stake = BigInt(quote.entry.stake);
         const core = request.core === undefined || request.core === null ? request.core : BigInt(request.core);
         // Known cash is planned before any prompt, so a plan that fails asks the wallet for nothing.
@@ -664,18 +704,11 @@ export function createTotalis(options) {
         const walletAmount = plan?.wallet ?? 0n;
         const [taker_signature, bridge, walletFunding] = await Promise.all([
             signing,
-            bridgeAmount > 0n ? signSendAsset(signer, bridgeAction(hyperliquidNetwork(chain.chain_id), bridgeAmount, {
-                ...(request.hypercoreNonce === undefined ? {} : { nonce: request.hypercoreNonce }),
-                ...(request.sourceDex === undefined ? {} : { sourceDex: request.sourceDex }),
-            })) : undefined,
+            signBridge(signer, chain, bridgeAmount, request),
             walletAmount > 0n ? depositAuthorization(chain, account, walletAmount) : undefined,
         ]);
         const fundingCommand = plan === undefined ? (funding === "none" || funding === "plan" ? undefined : funding) : walletFunding;
-        return {
-            kind: "ENTRY", version: 2, acceptanceId: request.acceptanceId ?? uuidv7(), rfqId: quote.rfq_id, quoteId: quote.quote_id, ...scope, expiry: quote.entry.expiry,
-            command: { taker_signature, ...(fundingCommand === undefined ? {} : { funding: fundingCommand }) },
-            ...(bridge === undefined ? {} : { bridge }),
-        };
+        return record(taker_signature, fundingCommand, bridge);
     }
     /**
      * Sign a Combo entry for a quote without sending it. Funding is planned
@@ -691,7 +724,8 @@ export function createTotalis(options) {
      * shows them in turn. `sourceDex: ""` bridges from perps instead of spot.
      * Persist the record, then `sendAcceptance` it; after a restart,
      * `recoverAcceptance` it. Pass `hypercoreNonce` if your app reserves
-     * Hyperliquid nonces itself.
+     * Hyperliquid nonces itself. With `prepared` (`prepareEntryFunding`), only
+     * the quote is signed, and its funding is the prepared one.
      */
     function signEntry(request) {
         return signEntryWith(request, "plan");
@@ -773,9 +807,13 @@ export function createTotalis(options) {
      * record from SDK 0.63 or older is only read. One still `PENDING_CONFIRM`
      * is read again after the maker's deadline, or every 250 ms until 2 s past
      * it while a bridge is unsent; `wait: false` returns it as it stands instead.
+     * A record marked `refused` is `NOT_ADMITTED`, read from the record alone.
      */
     async function recoverAcceptance(signed, options = {}) {
         await checkScope(signed);
+        if (signed.kind === "ENTRY" && "refused" in signed && signed.refused !== undefined) {
+            return resultOf(signed, { status: "NOT_ADMITTED", quote_id: signed.quoteId, rfq_id: signed.rfqId }, {});
+        }
         const clock = venueClock();
         const outcome = await fenceAcceptance(signed, clock, undefined, options.wait ?? true, bridgeUnsent(signed));
         return resultOf(signed, outcome, await moveBridge(signed, outcome, clock, options));
@@ -791,21 +829,30 @@ export function createTotalis(options) {
         }
     }
     /**
-     * Open a combo position: create the RFQ, take a quote from those the stream
-     * pushes, sign it (`signEntry`), hand the record to `onSigned` to persist,
-     * then `sendAcceptance`. Returns the acceptance's status (`ACCEPTED` with
+     * Open a combo position: create the RFQ, sign its funding
+     * (`prepareEntryFunding`), then take a quote from those the stream pushes,
+     * sign it (`signEntry`), hand the record to `onSigned` to persist, and
+     * `sendAcceptance` at once: the quote is chosen last, so the one signed is
+     * as fresh as the book allows. Returns the acceptance's status (`ACCEPTED` with
      * `operationId`; `FILLED` or `FAILED`, also with it, when a lost answer was
      * read after the trade settled; `DECLINED` / `TIMED_OUT` / `CANCELLED`; or
      * `NOT_ADMITTED` when a lost accept never arrived). The position opens
      * under `positionId`, the quote's ID, once `waitForOperation(operationId)`
      * resolves `COMMITTED`; pass its operation and the result's `record` to
      * `entryFailure` to name a failure. Any vault shortfall is funded from the
-     * wallet, and from `core` by bridge, unless `funding` says otherwise. An accept refused with
-     * `QUOTE_EXPIRED` or `QUOTE_REPLACED` takes and signs a fresh quote once
-     * (`onSigned` gets the new record); a second refusal is thrown.
+     * wallet, and from `core` by bridge, unless `funding` says otherwise.
+     *
+     * Makers replace their quotes as they renew them, so an accept can find its
+     * quote gone (`QUOTE_REPLACED`, `QUOTE_EXPIRED`); then `onSigned` gets the
+     * record marked `refused`. A maker can also turn its quote down (`DECLINED`)
+     * or not answer in time (`TIMED_OUT`). Either way nothing was admitted, so
+     * the best other quote paying at least `minPayout` is signed and sent,
+     * funding first, until one is taken, `refreshMs` has passed since the first
+     * quote was chosen, or `maxAttempts` accepts were sent. Then the last
+     * refusal is thrown, or the last decline or timeout returned.
      */
     async function openPosition(request) {
-        const { legs, stake, choose = bestQuote(), collectMs = defaultCollectMs, funding = "wallet", intent, quoteTimeoutMs = 20_000, signal } = request;
+        const { legs, stake, choose = bestQuote(), collectMs = defaultCollectMs, funding = "wallet", intent, quoteTimeoutMs = 20_000, refreshMs = defaultRefreshMs, maxAttempts = defaultMaxAttempts, signal } = request;
         const reading = funding === "wallet" && request.cash === undefined ? readSpendableCash(signal) : undefined;
         reading?.catch(() => undefined);
         const account = await (await requireSigner()).address();
@@ -814,20 +861,32 @@ export function createTotalis(options) {
         const wanted = { taker: account, stake: String(stake), legs: [...legs].sort((a, b) => Number(a.outcome_id) - Number(b.outcome_id)).map(({ outcome_id, side }) => ({ outcome_id, side })) };
         const entry = { stake: wanted.stake, legs: wanted.legs };
         const rfqId = await createRfq(intent === undefined ? entry : { ...entry, ...intent });
-        // Only quotes for exactly this position are offered to the chooser, and the chosen one is checked again before signing.
-        const matches = (quote) => quote.kind === "ENTRY" && quote.rfq_id === rfqId &&
+        const createdAt = performance.now();
+        let floor = request.minPayout === undefined ? undefined : BigInt(request.minPayout);
+        const refused = new Set();
+        const offered = (quote) => quote.kind === "ENTRY" && quote.rfq_id === rfqId &&
             quote.entry.taker.toLowerCase() === wanted.taker && quote.entry.stake === wanted.stake &&
-            JSON.stringify(quote.entry.legs.map(({ outcome_id, side }) => ({ outcome_id, side }))) === JSON.stringify(wanted.legs);
-        const take = (refused) => signedOrCancel(rfqId, async () => {
-            const offered = (quote) => matches(quote) && quote.quote_id !== refused;
-            const selected = await awaitOffer(rfqId, offered, choose, collectMs, quoteTimeoutMs, signal);
+            JSON.stringify(quote.entry.legs.map(({ outcome_id, side }) => ({ outcome_id, side }))) === JSON.stringify(wanted.legs) &&
+            !refused.has(quote.quote_id) && (floor === undefined || BigInt(quote.entry.payout) >= floor);
+        // Counted from the first choice, not from its signature, so a slow wallet cannot stretch the window.
+        let refreshUntil;
+        const take = () => signedOrCancel(rfqId, async () => {
+            const prepared = funding === "wallet"
+                ? await prepareEntryFunding({ stake: wanted.stake, core: request.core, cash: request.cash ?? await (refreshUntil === undefined ? reading : readSpendableCash(signal)), sourceDex: request.sourceDex, signal })
+                : undefined;
+            const selected = refreshUntil === undefined
+                ? await awaitOffer(rfqId, offered, choose, Math.max(0, Math.round(collectMs - (performance.now() - createdAt))), quoteTimeoutMs, signal)
+                : await awaitOffer(rfqId, offered, choose, 0, Math.max(0, Math.round(refreshUntil - performance.now())), signal);
+            refreshUntil ??= performance.now() + refreshMs;
             if (!offered(selected))
                 throw new Error("the chosen quote is not for the requested position");
-            const signed = await signEntryWith({ quote: selected, core: request.core, cash: request.cash ?? await reading, sourceDex: request.sourceDex }, funding === "wallet" ? "plan" : funding);
+            const signed = await signEntryWith({ quote: selected, prepared }, funding === "wallet" ? "plan" : funding);
             await request.onSigned?.(signed);
             return { selected, signed };
         });
         let { selected, signed } = await take();
+        floor ??= BigInt(selected.entry.payout);
+        const refreshEnds = refreshUntil ?? 0;
         let record = signed;
         const send = () => sendAcceptance(signed, {
             ...(request.transport === undefined ? {} : { transport: request.transport }),
@@ -837,18 +896,56 @@ export function createTotalis(options) {
                 await request.onSigned?.(next);
             },
         });
-        let result;
-        try {
-            result = await send();
-        }
-        catch (error) {
-            if (!(error instanceof ApiError) || error.code !== "QUOTE_EXPIRED" && error.code !== "QUOTE_REPLACED")
-                throw error;
-            // The quote went away before the accept (sendAcceptance discarded its bridge): sign a fresh one, once. No fresh quote in time is still that refusal.
-            ({ selected, signed } = await take(signed.quoteId).catch((retried) => Promise.reject(retried instanceof Error && retried.name === "TimeoutError" ? error : retried)));
-            record = signed;
-            result = await send();
-        }
+        const settle = async () => {
+            for (let attempt = 1;; attempt += 1) {
+                // The maker turned the quote down, or never answered: nothing was admitted and the RFQ stays open.
+                let lost;
+                try {
+                    lost = await send();
+                    if (!passedOn.has(lost.status))
+                        return lost;
+                }
+                catch (error) {
+                    if (!(error instanceof ApiError) || !refreshCodes.has(error.code))
+                        throw error;
+                    // Refused outright, so nothing was admitted and sendAcceptance discarded any bridge.
+                    lost = error;
+                    record = { ...record, refused: error.code };
+                    await request.onSigned?.(record);
+                }
+                refused.add(signed.quoteId);
+                const last = record;
+                const end = async () => {
+                    if (record !== last) {
+                        record = last;
+                        await request.onSigned?.(last);
+                    }
+                    if (lost instanceof ApiError)
+                        throw lost;
+                    return lost;
+                };
+                if (attempt >= maxAttempts || performance.now() >= refreshEnds)
+                    return end();
+                let next;
+                try {
+                    next = await take();
+                }
+                catch (retried) {
+                    // No fresh quote at or above the floor in time leaves this outcome standing.
+                    if (retried instanceof Error && retried.name === "TimeoutError")
+                        return end();
+                    throw retried;
+                }
+                // Signing and persisting can outlast the window: a record signed too late is never sent, and the last sent one is persisted again.
+                if (performance.now() >= refreshEnds) {
+                    record = next.signed;
+                    return end();
+                }
+                ({ selected, signed } = next);
+                record = signed;
+            }
+        };
+        const result = await settle();
         const { bridged: _bridged, ...settled } = result;
         return {
             ...settled,
@@ -1265,6 +1362,7 @@ export function createTotalis(options) {
         spendableCash: readSpendableCash,
         openPosition,
         cashOut,
+        prepareEntryFunding,
         signEntry,
         signCashout,
         sendAcceptance,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@totalis/hip4-client",
-  "version": "0.76.0",
+  "version": "0.78.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": [