@nktkas/hyperliquid 0.26.0 → 0.27.0

package/src/api/exchange/cSignerAction.ts

@@ -1,20 +1,13 @@
 import * as v from "valibot";
-import { type DeepImmutable, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
 
-/**
- * Jail or unjail self as a validator signer.
- * @see null
- */
+import { UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
+
+/** Jail or unjail self as a validator signer. */
 export const CSignerActionRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -69,16 +62,38 @@ export const CSignerActionRequest = /* @__PURE__ */ (() => {
 })();
 export type CSignerActionRequest = v.InferOutput<typeof CSignerActionRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/** Successful response without specific data or error response. */
+export const CSignerActionResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type CSignerActionResponse = v.InferOutput<typeof CSignerActionResponse>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeL1Action,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode CSignerAction} function. */
 export type CSignerActionParameters = ExtractRequestAction<v.InferInput<typeof CSignerActionRequest>>;
+
 /** Request options for the {@linkcode CSignerAction} function. */
 export type CSignerActionOptions = ExtractRequestOptions<v.InferInput<typeof CSignerActionRequest>>;
 
+/** Successful variant of {@linkcode CSignerActionResponse} without errors. */
+export type CSignerActionSuccessResponse = ExcludeErrorResponse<CSignerActionResponse>;
+
 /**
  * Jail or unjail self as a validator signer.
  * @param config - General configuration for Exchange API requests.
@@ -89,12 +104,11 @@ export type CSignerActionOptions = ExtractRequestOptions<v.InferInput<typeof CSi
  * @throws {ApiRequestError} When the API returns an unsuccessful response.
  * @throws {TransportError} When the transport layer throws an error.
  *
- * @see null
  * @example
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { cSignerAction } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -116,7 +130,7 @@ export async function cSignerAction(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<CSignerActionParameters>,
   opts?: CSignerActionOptions,
-): Promise<SuccessResponse> {
+): Promise<CSignerActionSuccessResponse> {
   const request = parser(CSignerActionRequest)({
     action: {
       type: "CSignerAction",

package/src/api/exchange/cValidatorAction.ts

@@ -1,20 +1,13 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
 
-/**
- * Action related to validator management.
- * @see null
- */
+import { Address, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
+
+/** Action related to validator management. */
 export const CValidatorActionRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -180,16 +173,38 @@ export const CValidatorActionRequest = /* @__PURE__ */ (() => {
 })();
 export type CValidatorActionRequest = v.InferOutput<typeof CValidatorActionRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/** Successful response without specific data or error response. */
+export const CValidatorActionResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type CValidatorActionResponse = v.InferOutput<typeof CValidatorActionResponse>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeL1Action,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode CValidatorAction} function. */
 export type CValidatorActionParameters = ExtractRequestAction<v.InferInput<typeof CValidatorActionRequest>>;
+
 /** Request options for the {@linkcode CValidatorAction} function. */
 export type CValidatorActionOptions = ExtractRequestOptions<v.InferInput<typeof CValidatorActionRequest>>;
 
+/** Successful variant of {@linkcode CValidatorActionResponse} without errors. */
+export type CValidatorActionSuccessResponse = ExcludeErrorResponse<CValidatorActionResponse>;
+
 /**
  * Action related to validator management.
  * @param config - General configuration for Exchange API requests.
@@ -200,12 +215,11 @@ export type CValidatorActionOptions = ExtractRequestOptions<v.InferInput<typeof
  * @throws {ApiRequestError} When the API returns an unsuccessful response.
  * @throws {TransportError} When the transport layer throws an error.
  *
- * @see null
  * @example
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { cValidatorAction } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -256,7 +270,7 @@ export async function cValidatorAction(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<CValidatorActionParameters>,
   opts?: CValidatorActionOptions,
-): Promise<SuccessResponse> {
+): Promise<CValidatorActionSuccessResponse> {
   const request = parser(CValidatorActionRequest)({
     action: {
       type: "CValidatorAction",

package/src/api/exchange/cWithdraw.ts

@@ -1,16 +1,11 @@
 import * as v from "valibot";
-import { type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeUserSignedAction,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  getSignatureChainId,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Hex, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Transfer native token from staking into the user's spot account.
@@ -66,16 +61,42 @@ export const CWithdrawRequest = /* @__PURE__ */ (() => {
 })();
 export type CWithdrawRequest = v.InferOutput<typeof CWithdrawRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#withdraw-from-staking
+ */
+export const CWithdrawResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type CWithdrawResponse = v.InferOutput<typeof CWithdrawResponse>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeUserSignedAction,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  getSignatureChainId,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode cWithdraw} function. */
 export type CWithdrawParameters = ExtractRequestAction<v.InferInput<typeof CWithdrawRequest>>;
+
 /** Request options for the {@linkcode cWithdraw} function. */
 export type CWithdrawOptions = ExtractRequestOptions<v.InferInput<typeof CWithdrawRequest>>;
 
+/** Successful variant of {@linkcode CWithdrawResponse} without errors. */
+export type CWithdrawSuccessResponse = ExcludeErrorResponse<CWithdrawResponse>;
+
 /** EIP-712 types for the {@linkcode cWithdraw} function. */
 export const CWithdrawTypes = {
   "HyperliquidTransaction:CWithdraw": [
@@ -100,7 +121,7 @@ export const CWithdrawTypes = {
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { cWithdraw } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -115,7 +136,7 @@ export async function cWithdraw(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<CWithdrawParameters>,
   opts?: CWithdrawOptions,
-): Promise<SuccessResponse> {
+): Promise<CWithdrawSuccessResponse> {
   const request = parser(CWithdrawRequest)({
     action: {
       type: "cWithdraw",

package/src/api/exchange/cancel.ts

@@ -1,15 +1,11 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Address, UnsignedInteger } from "../_base.ts";
+import { Signature } from "./_base/mod.ts";
 
 /**
  * Cancel order(s).
@@ -71,7 +67,10 @@ export const CancelRequest = /* @__PURE__ */ (() => {
 })();
 export type CancelRequest = v.InferOutput<typeof CancelRequest>;
 
-/** Response for order cancellation. */
+/**
+ * Response for order cancellation.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s
+ */
 export const CancelResponse = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -119,50 +118,29 @@ export const CancelResponse = /* @__PURE__ */ (() => {
 })();
 export type CancelResponse = v.InferOutput<typeof CancelResponse>;
 
-/** Successful variant of {@linkcode CancelResponse} without errors. */
-export const CancelSuccessResponse = /* @__PURE__ */ (() => {
-  return v.pipe(
-    v.object({
-      /** Successful status. */
-      status: v.pipe(
-        v.literal("ok"),
-        v.description("Successful status."),
-      ),
-      /** Response details. */
-      response: v.pipe(
-        v.object({
-          /** Type of response. */
-          type: v.pipe(
-            v.literal("cancel"),
-            v.description("Type of response."),
-          ),
-          /** Specific data. */
-          data: v.pipe(
-            v.object({
-              /** Array of success statuses. */
-              statuses: v.pipe(
-                v.array(v.literal("success")),
-                v.description("Array of success statuses."),
-              ),
-            }),
-            v.description("Specific data."),
-          ),
-        }),
-        v.description("Response details."),
-      ),
-    }),
-    v.description("Successful variant of `CancelResponse` without errors."),
-  );
-})();
-export type CancelSuccessResponse = v.InferOutput<typeof CancelSuccessResponse>;
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeL1Action,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode cancel} function. */
 export type CancelParameters = ExtractRequestAction<v.InferInput<typeof CancelRequest>>;
+
 /** Request options for the {@linkcode cancel} function. */
 export type CancelOptions = ExtractRequestOptions<v.InferInput<typeof CancelRequest>>;
 
+/** Successful variant of {@linkcode CancelResponse} without errors. */
+export type CancelSuccessResponse = ExcludeErrorResponse<CancelResponse>;
+
 /**
  * Cancel order(s).
  * @param config - General configuration for Exchange API requests.
@@ -178,7 +156,7 @@ export type CancelOptions = ExtractRequestOptions<v.InferInput<typeof CancelRequ
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { cancel } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`

package/src/api/exchange/cancelByCloid.ts

@@ -1,15 +1,12 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Address, Hex, UnsignedInteger } from "../_base.ts";
+import { Signature } from "./_base/mod.ts";
+import { CancelResponse } from "./cancel.ts";
 
 /**
  * Cancel order(s) by cloid.
@@ -71,16 +68,36 @@ export const CancelByCloidRequest = /* @__PURE__ */ (() => {
 })();
 export type CancelByCloidRequest = v.InferOutput<typeof CancelByCloidRequest>;
 
-import { CancelSuccessResponse } from "./cancel.ts";
-export { CancelSuccessResponse };
+/**
+ * Response for order cancellation.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
+ */
+export const CancelByCloidResponse = CancelResponse;
+export type CancelByCloidResponse = CancelResponse;
 
-// -------------------- Function --------------------
+// ============================================================
+// Execution Logic
+// ============================================================
+
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeL1Action,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode cancelByCloid} function. */
 export type CancelByCloidParameters = ExtractRequestAction<v.InferInput<typeof CancelByCloidRequest>>;
+
 /** Request options for the {@linkcode cancelByCloid} function. */
 export type CancelByCloidOptions = ExtractRequestOptions<v.InferInput<typeof CancelByCloidRequest>>;
 
+/** Successful variant of {@linkcode CancelByCloidResponse} without errors. */
+export type CancelByCloidSuccessResponse = ExcludeErrorResponse<CancelByCloidResponse>;
+
 /**
  * Cancel order(s) by cloid.
  * @param config - General configuration for Exchange API requests.
@@ -96,7 +113,7 @@ export type CancelByCloidOptions = ExtractRequestOptions<v.InferInput<typeof Can
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { cancelByCloid } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -115,7 +132,7 @@ export async function cancelByCloid(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<CancelByCloidParameters>,
   opts?: CancelByCloidOptions,
-): Promise<CancelSuccessResponse> {
+): Promise<CancelByCloidSuccessResponse> {
   const request = parser(CancelByCloidRequest)({
     action: {
       type: "cancelByCloid",

package/src/api/exchange/claimRewards.ts

@@ -1,19 +1,13 @@
 import * as v from "valibot";
-import { parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
 
-/**
- * Claim rewards from referral program.
- * @see null
- */
+import { UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
+
+/** Claim rewards from referral program. */
 export const ClaimRewardsRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -49,14 +43,34 @@ export const ClaimRewardsRequest = /* @__PURE__ */ (() => {
 })();
 export type ClaimRewardsRequest = v.InferOutput<typeof ClaimRewardsRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/** Successful response without specific data or error response. */
+export const ClaimRewardsResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type ClaimRewardsResponse = v.InferOutput<typeof ClaimRewardsResponse>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeL1Action,
+  type ExtractRequestOptions,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Request options for the {@linkcode claimRewards} function. */
 export type ClaimRewardsOptions = ExtractRequestOptions<v.InferInput<typeof ClaimRewardsRequest>>;
 
+/** Successful variant of {@linkcode ClaimRewardsResponse} without errors. */
+export type ClaimRewardsSuccessResponse = ExcludeErrorResponse<ClaimRewardsResponse>;
+
 /**
  * Claim rewards from referral program.
  * @param opts - Request execution options.
@@ -65,12 +79,11 @@ export type ClaimRewardsOptions = ExtractRequestOptions<v.InferInput<typeof Clai
  * @throws {ApiRequestError} When the API returns an unsuccessful response.
  * @throws {TransportError} When the transport layer throws an error.
  *
- * @see null
  * @example
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { claimRewards } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -81,7 +94,7 @@ export type ClaimRewardsOptions = ExtractRequestOptions<v.InferInput<typeof Clai
 export async function claimRewards(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   opts?: ClaimRewardsOptions,
-): Promise<SuccessResponse> {
+): Promise<ClaimRewardsSuccessResponse> {
   const request = parser(ClaimRewardsRequest)({
     action: {
       type: "claimRewards",

package/src/api/exchange/convertToMultiSigUser.ts

@@ -1,19 +1,14 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, Hex, parser, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeUserSignedAction,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  getSignatureChainId,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Address, Hex, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /** Signers configuration for {@linkcode ConvertToMultiSigUserRequest}. */
-export const ConvertToMultiSigUserRequestSigners = /* @__PURE__ */ (() => {
+const ConvertToMultiSigUserRequestSigners = /* @__PURE__ */ (() => {
   return v.pipe(
     v.union([
       v.object({
@@ -37,7 +32,6 @@ export const ConvertToMultiSigUserRequestSigners = /* @__PURE__ */ (() => {
     v.description("Signers configuration for `ConvertToMultiSigUserRequest`"),
   );
 })();
-export type ConvertToMultiSigUserRequestSigners = v.InferOutput<typeof ConvertToMultiSigUserRequestSigners>;
 
 /**
  * Convert a single-signature account to a multi-signature account or vice versa.
@@ -111,16 +105,42 @@ export const ConvertToMultiSigUserRequest = /* @__PURE__ */ (() => {
 })();
 export type ConvertToMultiSigUserRequest = v.InferOutput<typeof ConvertToMultiSigUserRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/hypercore/multi-sig
+ */
+export const ConvertToMultiSigUserResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type ConvertToMultiSigUserResponse = v.InferOutput<typeof ConvertToMultiSigUserResponse>;
+
+// ============================================================
+// Execution Logic
+// ============================================================
 
-// -------------------- Function --------------------
+import { type DeepImmutable, parser } from "../_base.ts";
+import {
+  type ExchangeRequestConfig,
+  type ExcludeErrorResponse,
+  executeUserSignedAction,
+  type ExtractRequestAction,
+  type ExtractRequestOptions,
+  getSignatureChainId,
+  type MultiSignRequestConfig,
+} from "./_base/mod.ts";
 
 /** Action parameters for the {@linkcode convertToMultiSigUser} function. */
 export type ConvertToMultiSigUserParameters = ExtractRequestAction<v.InferInput<typeof ConvertToMultiSigUserRequest>>;
+
 /** Request options for the {@linkcode convertToMultiSigUser} function. */
 export type ConvertToMultiSigUserOptions = ExtractRequestOptions<v.InferInput<typeof ConvertToMultiSigUserRequest>>;
 
+/** Successful variant of {@linkcode ConvertToMultiSigUserResponse} without errors. */
+export type ConvertToMultiSigUserSuccessResponse = ExcludeErrorResponse<ConvertToMultiSigUserResponse>;
+
 /** EIP-712 types for the {@linkcode convertToMultiSigUser} function. */
 export const ConvertToMultiSigUserTypes = {
   "HyperliquidTransaction:ConvertToMultiSigUser": [
@@ -145,7 +165,7 @@ export const ConvertToMultiSigUserTypes = {
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { convertToMultiSigUser } from "@nktkas/hyperliquid/api/exchange";
- * import { privateKeyToAccount } from "npm:viem/accounts";
+ * import { privateKeyToAccount } from "viem/accounts";
  *
  * const wallet = privateKeyToAccount("0x..."); // viem or ethers
  * const transport = new HttpTransport(); // or `WebSocketTransport`
@@ -172,7 +192,7 @@ export async function convertToMultiSigUser(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<ConvertToMultiSigUserParameters>,
   opts?: ConvertToMultiSigUserOptions,
-): Promise<SuccessResponse> {
+): Promise<ConvertToMultiSigUserSuccessResponse> {
   const request = parser(ConvertToMultiSigUserRequest)({
     action: {
       type: "convertToMultiSigUser",