@totalis/hip4-client 0.82.0 → 0.84.0

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 `@totalis/hip4-client` follows [semantic versioning](https://semver.org).
 The contract version the generated types come from is `sdkVersion` in `./version`.
 
+## 0.84.0
+
+### Added
+
+- `getGolden`: `golden.placement`, the account's latest golden placement as
+  `placeGolden` answers it, plus `created_at`, or null (TT-2627).
+- `getGoldenSuggestions` items are `GoldenSuggestedCombo`: `payout` is the
+  live best house offer, with its `accept_before` and the five's `band`
+  (`HUGE`, `BIG`, `STEADY`). Contract `211.0.0-golden-live-fives`.
+
+## 0.83.0
+
+### Added
+
+- The X handle on public trader profiles (TT-2649). `getTrader`
+  (`GET /v1/traders/{username}`) carries `x_username`, the handle of the X
+  account linked to the trader's Privy login, unless the trader hid it.
+  `VenueIdentity` (`GET /v1/me`) carries `x_username` and `x_shown`, and
+  `refreshPicture` (`POST /v1/me/picture`) returns `x_username` beside
+  `picture_url`; call it right after the user links X. `setXHandleShown`
+  (`PUT /v1/me/public-profile/x`, `{shown}`) shows or hides the handle,
+  ordered by Idempotency-Key like `setPublicProfile`; it starts shown. New
+  schemas `XUsername` and `XHandleShownRequest`. Contract `210.0.0-x-handle`.
+  Additive.
+
 ## 0.82.0
 
 ### Changed

package/dist/generated/client.d.ts

@@ -41,6 +41,7 @@ export type paths = {
     readonly "/v1/leaderboard/volume": Pick<SharedPaths["/v1/leaderboard/volume"], "parameters" | "get">;
     readonly "/v1/leaderboard/profit": Pick<SharedPaths["/v1/leaderboard/profit"], "parameters" | "get">;
     readonly "/v1/me/public-profile": Pick<SharedPaths["/v1/me/public-profile"], "parameters" | "put">;
+    readonly "/v1/me/public-profile/x": Pick<SharedPaths["/v1/me/public-profile/x"], "parameters" | "put">;
     readonly "/v1/traders/{username}": Pick<SharedPaths["/v1/traders/{username}"], "parameters" | "get">;
     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">;
@@ -110,4 +111,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" | "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">;
+export type operations = Pick<SharedOperations, "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" | "setXHandleShown" | "stream" | "streamMarkets" | "switchOffComboCopyAgent" | "switchOffCoreCopyAgent" | "unfollowTrader" | "unlikeComment" | "unreactComment">;

package/dist/generated/errors.d.ts

@@ -509,6 +509,7 @@ export declare const operationErrors: {
     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"];
     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 setXHandleShown: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "INVALID_REQUEST", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED", "IDENTITY_NOT_FOUND", "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"];

package/dist/generated/errors.js

@@ -1892,6 +1892,17 @@ export const operationErrors = {
         "USERNAME_TAKEN",
         "ORIGIN_REQUIRED"
     ],
+    "setXHandleShown": [
+        "UNAUTHENTICATED",
+        "FORBIDDEN",
+        "AUTHORIZATION_UNAVAILABLE",
+        "RATE_LIMITED",
+        "INVALID_REQUEST",
+        "INVALID_IDEMPOTENCY_KEY",
+        "IDEMPOTENCY_KEY_REUSED",
+        "IDENTITY_NOT_FOUND",
+        "ORIGIN_REQUIRED"
+    ],
     "stream": [
         "UNAUTHENTICATED",
         "FORBIDDEN",

package/dist/generated/openapi.d.ts

@@ -626,7 +626,7 @@ export type paths = {
         readonly put?: never;
         /**
          * Refresh X picture
-         * @description Reads the profile picture of the X account linked to the authenticated account's Privy login from Privy now, stores it and returns it; GET /v1/me, comments and the leaderboard then serve it. Call it right after the user links or unlinks X. Send no body. Call it after POST /v1/me/embedded-wallet; before that it is 404 IDENTITY_NOT_FOUND. Reading again stores Privy's answer again, so a retry is safe; send no Idempotency-Key. If Privy does not answer it is 503 DEPENDENCY_STALE and the stored picture stays; a server without a Privy app secret answers 503 CONTRACT_UNAVAILABLE. An account that signs in with an external wallet has no Privy login, so it gets the stored picture back. Limited to 10 calls a minute per account.
+         * @description Reads the profile picture and handle of the X account linked to the authenticated account's Privy login from Privy now, stores them and returns them; GET /v1/me, comments and the leaderboard then serve the picture, and GET /v1/me and the public trader profile the handle. Call it right after the user links or unlinks X. Send no body. Call it after POST /v1/me/embedded-wallet; before that it is 404 IDENTITY_NOT_FOUND. Reading again stores Privy's answer again, so a retry is safe; send no Idempotency-Key. If Privy does not answer it is 503 DEPENDENCY_STALE and the stored picture stays; a server without a Privy app secret answers 503 CONTRACT_UNAVAILABLE. An account that signs in with an external wallet has no Privy login, so it gets the stored picture back. Limited to 10 calls a minute per account.
          */
         readonly post: operations["refreshPicture"];
         readonly delete?: never;
@@ -724,7 +724,7 @@ export type paths = {
         };
         /**
          * List golden suggestions
-         * @description Up to three ready-made golden Combos that share no outcome, for an account whose golden ticket is available: 5 legs from golden markets at the 1 USDC golden stake, each priced recently by a Totalis maker quote to the promo account. Picking one only fills the slip; place it through POST /v1/me/golden/rfqs, which requotes. A suggestion leaves the list once a leg is no longer a golden market or its quote is two hours old.
+         * @description Up to three ready-made golden Combos from different games, for an account whose golden ticket is available: 5 legs from golden markets at the 1 USDC golden stake, one per fair-multiplier band, biggest first. Each shows the best house-maker offer the promo account holds on it right now, live while any ticket holder reads golden Combos; a five with no such offer, or one paying under the golden value floor, is left out. Picking one only fills the slip; place it through POST /v1/me/golden/rfqs, which asks afresh, so the slip's own offer is what places.
          */
         readonly get: operations["getGoldenSuggestions"];
         readonly put?: never;
@@ -855,6 +855,26 @@ export type paths = {
         readonly patch?: never;
         readonly trace?: never;
     };
+    readonly "/v1/me/public-profile/x": {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly get?: never;
+        /**
+         * Show or hide the X handle on the public trader profile
+         * @description Shows (shown: true) or hides the handle of the X account linked to the authenticated account's Privy login on its public trader profile, GET /v1/traders/{username}. It starts shown: linking X is the consent, and this switch takes it back. GET /v1/me returns the state as x_shown. It is a preference, kept whether or not X is linked, and it does not unlink X. Hiding it reaches signed-out readers within the 30 seconds the edge may cache GET /v1/traders/{username}. 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. Shares PUT /v1/me/public-profile's 30 calls a minute per account. Servers before contract 210 answer 404.
+         */
+        readonly put: operations["setXHandleShown"];
+        readonly post?: never;
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
     readonly "/v1/traders/{username}": {
         readonly parameters: {
             readonly query?: never;
@@ -864,7 +884,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. 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.
+         * @description A trader's public profile, while they have turned it on with PUT /v1/me/public-profile: their username, avatar, X handle unless they hid it, 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;
@@ -3237,6 +3257,34 @@ export type components = {
         readonly HyperevmKeeperOperationKind: "DEPOSIT_USER_AUTHORIZED" | "WITHDRAW_USER" | "ACCEPT" | "SETTLE" | "CACHE_SETTLEMENT" | "CLAIM" | "SELL_BACK" | "TRANSFER_TICKET" | "ATTEST" | "SYNC" | "TOTALIS_PAYOUT" | "CORE_EXIT" | "SET_AGENT";
         readonly Hash32: string;
         readonly Uint256: string;
+        /**
+         * GoldenPlacementState
+         * @enum {string}
+         */
+        readonly GoldenPlacementState: "PLACING" | "BOUGHT" | "DELIVERED" | "FAILED";
+        /**
+         * GoldenPlacementFailure
+         * @enum {string}
+         */
+        readonly GoldenPlacementFailure: "MAKER_DECLINED" | "ACCEPT_FAILED" | "NOT_ACCEPTED" | "PROMO_BUSY" | "GIFT_FAILED" | "GIFT_EXPIRED";
+        /** GoldenSuggestedCombo */
+        readonly GoldenSuggestedCombo: {
+            readonly legs: readonly components["schemas"]["$defs-Leg"][];
+            /** @description Browse contract 4 discovery card each leg was picked from, in leg order, as read when the five was composed. Lets a client draw a leg that is not on its own page; its prices are not current. */
+            readonly cards: readonly components["schemas"]["Card"][];
+            readonly stake: components["schemas"]["$defs-Amount"];
+            /** @description What the best house-maker offer on this five pays on a win now, after the taker and profit fees, in USDC base units. An indication: the offer is the promo account's, so the slip asks for its own. */
+            readonly payout: components["schemas"]["$defs-Amount"];
+            /** @description When the server first saw that offer. */
+            readonly quoted_at: components["schemas"]["$defs-Timestamp"];
+            /** @description When that offer stops being takeable. Drop the number once it passes without a newer read; never show it after. */
+            readonly accept_before: components["schemas"]["$defs-Timestamp"];
+            /**
+             * @description The fair-multiplier band the five was composed for, a stable slot key: a five that drops out and is replaced keeps its band.
+             * @enum {string}
+             */
+            readonly band: "HUGE" | "BIG" | "STEADY";
+        };
         /** SuggestedCombo */
         readonly SuggestedCombo: {
             readonly legs: readonly components["schemas"]["$defs-Leg"][];
@@ -3940,6 +3988,8 @@ export type components = {
         readonly AvatarSeed: string;
         /** @description An X profile picture on pbs.twimg.com or abs.twimg.com, at the size X gave Privy, usually the 48-pixel file ending in _normal; X also serves _bigger (73 px) and _400x400 under the same name. */
         readonly XPictureUrl: string;
+        /** @description An X handle without the @, in the case X gave Privy: 1 to 15 letters, digits or underscores. Clients link it as https://x.com/{handle}. */
+        readonly XUsername: string;
         readonly VenueIdentity: {
             /** @description Totalis account ID. */
             readonly account_id: components["schemas"]["Uuid"];
@@ -3963,6 +4013,10 @@ export type components = {
             readonly wallet_kind?: "EMBEDDED" | "EXTERNAL";
             /** @description Whether the account turned on its public trader profile with PUT /v1/me/public-profile. Servers before contract 190 omit it. */
             readonly public_profile?: boolean;
+            /** @description The handle of the X account linked to the account's Privy login, read from Privy with picture_url and served the same way. Absent when the server has none: none is linked, X does not allow it, it has not been read yet, or the server has no Privy app secret. Servers before contract 210 omit it. */
+            readonly x_username?: components["schemas"]["XUsername"];
+            /** @description Whether the public trader profile shows x_username: true until the account hides it with PUT /v1/me/public-profile/x, whether or not X is linked. Servers before contract 210 omit it. */
+            readonly x_shown?: boolean;
         };
         readonly NonZeroAddress: components["schemas"]["Address"] & unknown;
         /** Format: uri */
@@ -4192,6 +4246,8 @@ export type components = {
         readonly PictureRefresh: {
             /** @description The linked X account's picture; absent when none is linked or it is not on X's profile picture hosts. */
             readonly picture_url?: components["schemas"]["XPictureUrl"];
+            /** @description The linked X account's handle; absent when none is linked or X does not allow it. Servers before contract 210 omit it. */
+            readonly x_username?: components["schemas"]["XUsername"];
         };
         /** @description The canonical contract deployment clients sign against. Totalis structs are signed under the TotalisParlay v1 domain with chainId chain_id and verifyingContract vault_address. */
         readonly Deployment: {
@@ -4679,6 +4735,10 @@ export type components = {
         /** Format: uint256-decimal */
         readonly Uint: string;
         readonly ContractSignature: string;
+        readonly XHandleShownRequest: {
+            /** @description true to show the X handle on the public trader profile, false to hide it. */
+            readonly shown: boolean;
+        };
         /** @description 1 to 1000 characters after surrounding whitespace is trimmed. Newlines are kept; other control characters are refused. */
         readonly CommentBody: string;
         /**
@@ -7810,7 +7870,19 @@ export interface operations {
                             /** @description The gifted position once PLACED; null otherwise. */
                             readonly position_id: null | components["schemas"]["Bytes32"];
                             /** @description While AVAILABLE, why the latest placement failed, if one did; null otherwise. */
-                            readonly last_failure: null | ("MAKER_DECLINED" | "ACCEPT_FAILED" | "NOT_ACCEPTED" | "PROMO_BUSY" | "GIFT_FAILED" | "GIFT_EXPIRED");
+                            readonly last_failure: null | components["schemas"]["GoldenPlacementFailure"];
+                            /** @description The account's latest placement, the same object placeGolden answers plus when it was recorded, so a client that lost a placement's answer settles it from here; null before the first. */
+                            readonly placement: null | {
+                                readonly placement_id: components["schemas"]["Uuid"];
+                                /** @description As placeGolden answers it, now. */
+                                readonly state: components["schemas"]["GoldenPlacementState"];
+                                /** @description The placed quote's digest: the position this placement buys, which is the account's once DELIVERED. */
+                                readonly position_id: components["schemas"]["Bytes32"];
+                                /** @description Why it failed, once FAILED; null otherwise. */
+                                readonly failure: null | components["schemas"]["GoldenPlacementFailure"];
+                                /** @description When the placement was recorded. */
+                                readonly created_at: components["schemas"]["$defs-Timestamp"];
+                            };
                         };
                     };
                 };
@@ -7867,8 +7939,8 @@ export interface operations {
                 };
                 content: {
                     readonly "application/json": {
-                        /** @description In order; empty when none is priced. `payout` is the Totalis maker quote's win amount after the profit fee, indicative only. */
-                        readonly combos: readonly components["schemas"]["SuggestedCombo"][];
+                        /** @description Biggest band first; empty while none has a live offer. */
+                        readonly combos: readonly components["schemas"]["GoldenSuggestedCombo"][];
                     };
                 };
             };
@@ -8014,14 +8086,11 @@ export interface operations {
                 content: {
                     readonly "application/json": {
                         readonly placement_id: components["schemas"]["Uuid"];
-                        /**
-                         * @description PLACING until the promo account's accept lands, BOUGHT until the gift lands, then DELIVERED; FAILED leaves the golden ticket available again. Read GET /v1/me/golden for its progress.
-                         * @enum {string}
-                         */
-                        readonly state: "PLACING" | "BOUGHT" | "DELIVERED" | "FAILED";
+                        /** @description PLACING until the promo account's accept lands, BOUGHT until the gift lands, then DELIVERED; FAILED leaves the golden ticket available again. Read GET /v1/me/golden for its progress. */
+                        readonly state: components["schemas"]["GoldenPlacementState"];
                         /** @description The quote's digest: the position the gift delivers. */
                         readonly position_id: components["schemas"]["Bytes32"];
-                        readonly failure: null | ("MAKER_DECLINED" | "ACCEPT_FAILED" | "NOT_ACCEPTED" | "PROMO_BUSY" | "GIFT_FAILED" | "GIFT_EXPIRED");
+                        readonly failure: null | components["schemas"]["GoldenPlacementFailure"];
                     };
                 };
             };
@@ -8179,6 +8248,41 @@ export interface operations {
             readonly 503: components["responses"]["Unavailable"];
         };
     };
+    readonly setXHandleShown: {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header: {
+                /**
+                 * @description Lowercase UUIDv7 naming this command, unique per caller and route. A retry with the same key and body returns the original result; the same key with a different body returns `409 IDEMPOTENCY_KEY_REUSED`.
+                 * @example 0198a6f6-82a5-7abc-9f2a-4f0fb437493e
+                 */
+                readonly "Idempotency-Key": components["parameters"]["IdempotencyKey"];
+            };
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly requestBody: {
+            readonly content: {
+                readonly "application/json": components["schemas"]["XHandleShownRequest"];
+            };
+        };
+        readonly responses: {
+            /** @description The handle is in the requested state */
+            readonly 204: {
+                headers: {
+                    readonly [name: string]: unknown;
+                };
+                content?: never;
+            };
+            readonly 400: components["responses"]["Error"];
+            readonly 401: components["responses"]["Error"];
+            readonly 403: components["responses"]["Error"];
+            readonly 404: components["responses"]["Error"];
+            readonly 409: components["responses"]["Error"];
+            readonly 429: components["responses"]["RateLimited"];
+            readonly 503: components["responses"]["Unavailable"];
+        };
+    };
     readonly getTrader: {
         readonly parameters: {
             readonly query?: never;
@@ -8205,6 +8309,8 @@ export interface operations {
                         readonly avatar_seed: components["schemas"]["AvatarSeed"];
                         /** @description The trader's X picture, shown in place of the generated avatar; absent when there is none, as for GET /v1/me. */
                         readonly picture_url?: components["schemas"]["XPictureUrl"];
+                        /** @description The handle of the X account linked to the trader's Privy login, as for GET /v1/me. Absent when there is none or the trader hid it with PUT /v1/me/public-profile/x; a signed-out answer the edge cached may show it for up to 30 seconds after it changes. Servers before contract 210 omit it. */
+                        readonly x_username?: components["schemas"]["XUsername"];
                         /** @description The account wallet the trader trades from, as GET /v1/me shows it to them. */
                         readonly account: components["schemas"]["LowercaseNonZeroAddress"];
                         /** @description When the trader turned the profile on. */

package/dist/generated/version.d.ts

@@ -1,5 +1,5 @@
-export declare const sdkVersion = "209.0.0-gas-at-accept";
-export declare const openapiSha256 = "0eaeaf098c1a1c14ede94a521a2b63db7954b6fc8f61acb54a4b1feed5d9e2dc";
+export declare const sdkVersion = "211.0.0-golden-live-fives";
+export declare const openapiSha256 = "35c16104e0eaa909bfa93999c770a4f209173d37f0ee16c328807ecdecf6c9d5";
 export declare const realtimeSha256 = "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07";
 export declare const jsonSchemaSha256: {
     readonly "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6";
@@ -8,7 +8,7 @@ export declare const jsonSchemaSha256: {
     readonly "core-exit.schema.json": "c7f617e815225cdcac95c236f8b73fbe288ee5713ff444c3be90eb915fc3a401";
     readonly "error.schema.json": "d15dad1b8369b45746271e0fddd2106535c22493668b703544c9ddfa80761012";
     readonly "hypercore.schema.json": "5b89b2bbff7ec8cc1b8717375d12ce9cd5ab6aa5af03c4fdc6cc753ef9583a2c";
-    readonly "identity.schema.json": "94534b768030736f4fd1fad285f1312454ca5fbff0b1eb5fab70416a78923bd0";
+    readonly "identity.schema.json": "b623b947db4fe8fe1f297158bcc6a555c0333f3937ca925dda20ec4956ea479f";
     readonly "maker-access.schema.json": "49698ee0235e42064aae0397db1e0f646bdc10d9dfa10121714ba06dd69fee3b";
     readonly "maker-action.schema.json": "dc41e52c868848e85cdeb918992cb710d34616d2803a63f6d9a658e016744a50";
     readonly "maker-telemetry.schema.json": "85b111ce0f4935299d1116071b43de12e775bef4e0c283c12f19046d34374a9c";
@@ -18,7 +18,7 @@ export declare const jsonSchemaSha256: {
     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"];
+    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", "setXHandleShown", "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 = "209.0.0-gas-at-accept";
-export const openapiSha256 = "0eaeaf098c1a1c14ede94a521a2b63db7954b6fc8f61acb54a4b1feed5d9e2dc";
+export const sdkVersion = "211.0.0-golden-live-fives";
+export const openapiSha256 = "35c16104e0eaa909bfa93999c770a4f209173d37f0ee16c328807ecdecf6c9d5";
 export const realtimeSha256 = "f4f1078418b5302417babe1380b85b0c4f89cb0fdfaff3a46154dd2018625c07";
 export const jsonSchemaSha256 = {
     "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6",
@@ -9,7 +9,7 @@ export const jsonSchemaSha256 = {
     "core-exit.schema.json": "c7f617e815225cdcac95c236f8b73fbe288ee5713ff444c3be90eb915fc3a401",
     "error.schema.json": "d15dad1b8369b45746271e0fddd2106535c22493668b703544c9ddfa80761012",
     "hypercore.schema.json": "5b89b2bbff7ec8cc1b8717375d12ce9cd5ab6aa5af03c4fdc6cc753ef9583a2c",
-    "identity.schema.json": "94534b768030736f4fd1fad285f1312454ca5fbff0b1eb5fab70416a78923bd0",
+    "identity.schema.json": "b623b947db4fe8fe1f297158bcc6a555c0333f3937ca925dda20ec4956ea479f",
     "maker-access.schema.json": "49698ee0235e42064aae0397db1e0f646bdc10d9dfa10121714ba06dd69fee3b",
     "maker-action.schema.json": "dc41e52c868848e85cdeb918992cb710d34616d2803a63f6d9a658e016744a50",
     "maker-telemetry.schema.json": "85b111ce0f4935299d1116071b43de12e775bef4e0c283c12f19046d34374a9c",
@@ -132,6 +132,7 @@ export const operations = {
         "setCopySettings",
         "setPublicProfile",
         "setUsername",
+        "setXHandleShown",
         "stream",
         "streamMarkets",
         "switchOffComboCopyAgent",

package/package.json

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