@totalis/hip4-client 0.78.0 → 0.79.1

package/CHANGELOG.md

@@ -3,6 +3,40 @@
 `@totalis/hip4-client` follows [semantic versioning](https://semver.org).
 The contract version the generated types come from is `sdkVersion` in `./version`.
 
+## 0.79.1
+
+### Changed
+
+- `grantVaultAgent` answers `503 CONTRACT_UNAVAILABLE` on a vault whose
+  generation has no `setAgent`, instead of relaying a grant that never lands.
+
+## 0.79.0
+
+### Added
+
+- Follow settings (`followTrader`, `listFollows`) take `mode` per product: `COPY`
+  or `COUNTER`. A counter of a single buys the outcome's other side, priced
+  against 1 less the trader's price and sized from what the trader spent; a
+  counter of a Combo flips every leg and takes the best quote paying more than
+  its net stake (TT-2628). Contract `207.0.0-copy-modes`.
+- `counter_exit_floor_bps` on Combo settings: the least a counter Combo cashes
+  out for when the trader cashes out: what the follower receives, net of the
+  vault's profit fee, in basis points of what they staked, 0 to 100000, 10000
+  (never below the stake) when left out. Below it, the cash-out is skipped and
+  the ticket held to settlement. Core refuses any value but 10000.
+- `new_positions_only` on core settings: copy a buy only when it opens the
+  trader's position. Combos refuse `true`.
+- Copy journal rows (`listCopyTrades`, `listComboCopies`) answer `mode`; their
+  `side` and `legs` are now the account's own, flipped for a counter.
+
+### Changed
+
+- `slippage_bps` (max worst entry) allows up to 5000 (50%), from 2000. Writes
+  that leave out `mode`, `new_positions_only` and `counter_exit_floor_bps` keep
+  meaning `COPY`, every buy copied and a 10000 floor.
+- `createDeposit`'s 0.10 USDC floor covers a Privy external login wallet as
+  well as an embedded one; any other wallet still moves at least 1 USDC.
+
 ## 0.78.0
 
 ### Added

package/dist/generated/errors.d.ts

@@ -414,7 +414,7 @@ export declare const operationErrors: {
     readonly getVolumeLeaderboard: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_QUERY", "CONTRACT_UNAVAILABLE"];
     readonly getWithdrawal: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "INVALID_REQUEST", "NOT_FOUND"];
     readonly grantComboCopyAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "NOT_FOUND", "INVALID_REQUEST", "FINANCIAL_ACTIONS_DISABLED", "DEPENDENCY_STALE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
-    readonly grantVaultAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "INVALID_REQUEST", "FINANCIAL_ACTIONS_DISABLED", "DEPENDENCY_STALE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
+    readonly grantVaultAgent: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "CONTRACT_UNAVAILABLE", "INVALID_REQUEST", "FINANCIAL_ACTIONS_DISABLED", "DEPENDENCY_STALE", "INVALID_IDEMPOTENCY_KEY", "IDEMPOTENCY_KEY_REUSED"];
     readonly likeComment: readonly ["UNAUTHENTICATED", "FORBIDDEN", "AUTHORIZATION_UNAVAILABLE", "DEPENDENCY_STALE", "RATE_LIMITED", "ORIGIN_REQUIRED", "IDENTITY_NOT_FOUND", "NOT_FOUND", "INVALID_IDEMPOTENCY_KEY"];
     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"];

package/dist/generated/errors.js

@@ -1244,6 +1244,7 @@ export const operationErrors = {
         "RATE_LIMITED",
         "ORIGIN_REQUIRED",
         "IDENTITY_NOT_FOUND",
+        "CONTRACT_UNAVAILABLE",
         "INVALID_REQUEST",
         "FINANCIAL_ACTIONS_DISABLED",
         "DEPENDENCY_STALE",

package/dist/generated/openapi.d.ts

@@ -1066,7 +1066,7 @@ export type paths = {
         readonly put?: never;
         /**
          * Relay the account's grant or revoke of a device's vault agent
-         * @description Relays the account's EIP-712 signature over AgentGrant(account, agent, valid_until, nonce) to setAgent; Totalis pays the gas. agent is a key one of the account's devices holds, so it can sign the account's named Combo accepts, cash-outs and Exits to its own wallet or Core spot without a wallet prompt. valid_until is unix seconds, in the future and at most 180 days away (the vault's limit); 0 revokes at once. nonce must exceed the agent's last grant (GET /v1/me/vault-agents), so a client uses the current unix time. Only the account's own signature (or its ERC-1271 verdict) grants. 403 FORBIDDEN for a copy agent, whose grants go through /v1/me/copy-agents. While financial actions run off only a revoke is relayed. A retry with the same Idempotency-Key returns the same operation.
+         * @description Relays the account's EIP-712 signature over AgentGrant(account, agent, valid_until, nonce) to setAgent; Totalis pays the gas. agent is a key one of the account's devices holds, so it can sign the account's named Combo accepts, cash-outs and Exits to its own wallet or Core spot without a wallet prompt. valid_until is unix seconds, in the future and at most 180 days away (the vault's limit); 0 revokes at once. nonce must exceed the agent's last grant (GET /v1/me/vault-agents), so a client uses the current unix time. Only the account's own signature (or its ERC-1271 verdict) grants. 403 FORBIDDEN for a copy agent, whose grants go through /v1/me/copy-agents. While financial actions run off only a revoke is relayed. 503 CONTRACT_UNAVAILABLE when the vault has no setAgent. A retry with the same Idempotency-Key returns the same operation.
          */
         readonly post: operations["grantVaultAgent"];
         readonly delete?: never;
@@ -2523,10 +2523,19 @@ export type components = {
             readonly max_per_trade: components["schemas"]["$defs-Amount"];
             /** @description Most positions copied from this trader open at once. */
             readonly max_open: number;
-            /** @description Worst price a copy accepts against the trader's, in basis points; a copy outside it is skipped. */
+            /** @description Max worst entry: the worst price a copy accepts against the trader's, in basis points, 0 to 5000 (50%); a copy outside it is skipped. A COUNTER of a Combo has no band from the trader, whose price says nothing of the flipped Combo's: it takes the best quote paying more than its net stake. */
             readonly slippage_bps: number;
             /** @description Copy the trader's reductions and cash-outs too. */
             readonly mirror_exits: boolean;
+            /**
+             * @description COPY takes the trader's side. COUNTER takes the other side: a single buys the outcome's other side, priced against 1 less the trader's price and sized from what the trader spent; a Combo flips every leg, so it pays only if every one of the trader's legs loses. A counter mirrors the trader's exits as a copy does: a single's sells are priced against 1 less the trader's price, and a Combo's cash-out at no less than counter_exit_floor_bps of what the follower staked, as the trader's cash-out prices their ticket, not the flipped one. After a change of mode, buys in a market are not copied while copies of it are held on the other side. Left out of a write, COPY.
+             * @enum {unknown}
+             */
+            readonly mode?: "COPY" | "COUNTER";
+            /** @description Copy a buy only when it opens the trader's position, never one adding to it. Core only: every Combo opens a new position, so combos refuses true. Left out of a write, false. */
+            readonly new_positions_only?: boolean;
+            /** @description The least a COUNTER Combo cashes out for when the trader cashes out: what the follower receives, after the vault's profit fee on a sell-back, in basis points of what they staked, fee included, 0 to 100000: 10000 never sells for less than the stake, 8000 accepts up to a 20% loss, 0 takes the best quote at any price. With none at or above it, the cash-out is skipped and the ticket held to settlement. Combos only: listed on combos, never on core, and core refuses any value but 10000. Left out of a write, 10000. */
+            readonly counter_exit_floor_bps?: number;
         };
         readonly FollowSettingsFields: {
             /** @description How the follow copies HyperCore orders. */
@@ -8266,13 +8275,18 @@ export interface operations {
                             readonly decided_at?: components["schemas"]["$defs-Timestamp"];
                             /** @description HIP-4 outcome ID, as a decimal string. */
                             readonly outcome_id: components["schemas"]["UInt32String"];
-                            /** @description Outcome side. */
+                            /** @description The side the account traded: the trader's, or its other side for a COUNTER. */
                             readonly side: components["schemas"]["Side"];
                             /**
-                             * @description ENTRY: the trader bought, and the copy buys. REDUCE: the trader sold part of their holding, and the copy sells that fraction of the account's copied shares. CLOSE and EXIT: the trader sold all of it, and the copy sells all copied shares.
+                             * @description ENTRY: the trader bought, and the copy buys, or for a COUNTER buys the other side. REDUCE: the trader sold part of their holding, and the copy sells that fraction of the account's copied shares. CLOSE and EXIT: the trader sold all of it, and the copy sells all copied shares.
                              * @enum {string}
                              */
                             readonly kind: "ENTRY" | "REDUCE" | "CLOSE" | "EXIT";
+                            /**
+                             * @description Whether this copied the trader's trade or took its other side.
+                             * @enum {unknown}
+                             */
+                            readonly mode: "COPY" | "COUNTER";
                             /**
                              * CopyLeaderTrade
                              * @description The trader's trade, all of its fills together.
@@ -8354,11 +8368,16 @@ export interface operations {
                             /** @description When the copy reached its outcome; absent while PENDING. */
                             readonly decided_at?: components["schemas"]["$defs-Timestamp"];
                             /**
-                             * @description ENTRY: the trader opened a Combo, and the copy opens the same legs at the account's stake. EXIT: the trader cashed theirs out, and the copy cashes out the account's copy.
+                             * @description ENTRY: the trader opened a Combo, and the copy opens the same legs, or for a COUNTER each leg's other side, at the account's stake. EXIT: the trader cashed theirs out, and the copy cashes out the account's copy.
                              * @enum {string}
                              */
                             readonly kind: "ENTRY" | "EXIT";
-                            /** @description The Combo's legs. */
+                            /**
+                             * @description Whether this copied the trader's trade or took its other side.
+                             * @enum {unknown}
+                             */
+                            readonly mode: "COPY" | "COUNTER";
+                            /** @description The legs the account's copy takes: the trader's, each on its other side for a COUNTER. */
                             readonly legs: readonly components["schemas"]["TraderLeg"][];
                             /**
                              * ComboCopyLeaderTrade
@@ -10784,7 +10803,7 @@ export interface operations {
                     readonly "application/json": components["schemas"]["DepositAccepted"];
                 };
             };
-            /** @description A deposit moves at least 0.10 USDC from a Totalis embedded wallet and 1 USDC from any other, and a wallet that controls a maker cannot deposit (`INVALID_REQUEST`). */
+            /** @description A deposit moves at least 0.10 USDC from a Privy login wallet, embedded or external, and 1 USDC from any other, and a wallet that controls a maker cannot deposit (`INVALID_REQUEST`). */
             readonly 400: components["responses"]["Error"];
             readonly 401: components["responses"]["Error"];
             /** @description Wallet sessions and Totalis app sessions only: an API key cannot deposit. */

package/dist/generated/version.d.ts

@@ -1,5 +1,5 @@
-export declare const sdkVersion = "206.0.0-public-trader-reads";
-export declare const openapiSha256 = "1c4c1c9a685d200b19fc047a9ff25240c7a7ba37520bd6a9dc2ea6b78b696e64";
+export declare const sdkVersion = "207.0.0-copy-modes";
+export declare const openapiSha256 = "3d418204ef35fc0569a5d38291b6a894e4d88e0de24e26e379d218e72d636765";
 export declare const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
 export declare const jsonSchemaSha256: {
     readonly "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6";

package/dist/generated/version.js

@@ -1,6 +1,6 @@
 // Generated by scripts/generate.mjs; do not edit.
-export const sdkVersion = "206.0.0-public-trader-reads";
-export const openapiSha256 = "1c4c1c9a685d200b19fc047a9ff25240c7a7ba37520bd6a9dc2ea6b78b696e64";
+export const sdkVersion = "207.0.0-copy-modes";
+export const openapiSha256 = "3d418204ef35fc0569a5d38291b6a894e4d88e0de24e26e379d218e72d636765";
 export const realtimeSha256 = "1cac740e108e84ad1979f6ccc71089efd840404cb72d1612a86edc02769637e3";
 export const jsonSchemaSha256 = {
     "account.schema.json": "5106e2d53abef190990eff113f6692dd27df5848439cf5a80a42c11e89f2bef6",

package/package.json

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