@nktkas/hyperliquid 0.26.0 → 0.27.0

package/src/api/exchange/reserveRequestWeight.ts

@@ -1,15 +1,11 @@
 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
+// ============================================================
+
+import { UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Reserve additional rate-limited actions for a fee.
@@ -55,16 +51,41 @@ export const ReserveRequestWeightRequest = /* @__PURE__ */ (() => {
 })();
 export type ReserveRequestWeightRequest = v.InferOutput<typeof ReserveRequestWeightRequest>;
 
-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#reserve-additional-actions
+ */
+export const ReserveRequestWeightResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type ReserveRequestWeightResponse = v.InferOutput<typeof ReserveRequestWeightResponse>;
+
+// ============================================================
+// 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 reserveRequestWeight} function. */
 export type ReserveRequestWeightParameters = ExtractRequestAction<v.InferInput<typeof ReserveRequestWeightRequest>>;
+
 /** Request options for the {@linkcode reserveRequestWeight} function. */
 export type ReserveRequestWeightOptions = ExtractRequestOptions<v.InferInput<typeof ReserveRequestWeightRequest>>;
 
+/** Successful variant of {@linkcode ReserveRequestWeightResponse} without errors. */
+export type ReserveRequestWeightSuccessResponse = ExcludeErrorResponse<ReserveRequestWeightResponse>;
+
 /**
  * Reserve additional rate-limited actions for a fee.
  * @param config - General configuration for Exchange API requests.
@@ -80,7 +101,7 @@ export type ReserveRequestWeightOptions = ExtractRequestOptions<v.InferInput<typ
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { reserveRequestWeight } 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`
@@ -95,7 +116,7 @@ export async function reserveRequestWeight(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<ReserveRequestWeightParameters>,
   opts?: ReserveRequestWeightOptions,
-): Promise<SuccessResponse> {
+): Promise<ReserveRequestWeightSuccessResponse> {
   const request = parser(ReserveRequestWeightRequest)({
     action: {
       type: "reserveRequestWeight",

package/src/api/exchange/scheduleCancel.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 { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Schedule a cancel-all operation at a future time.
@@ -69,16 +65,41 @@ export const ScheduleCancelRequest = /* @__PURE__ */ (() => {
 })();
 export type ScheduleCancelRequest = v.InferOutput<typeof ScheduleCancelRequest>;
 
-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#schedule-cancel-dead-mans-switch
+ */
+export const ScheduleCancelResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type ScheduleCancelResponse = v.InferOutput<typeof ScheduleCancelResponse>;
+
+// ============================================================
+// 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 scheduleCancel} function. */
 export type ScheduleCancelParameters = ExtractRequestAction<v.InferInput<typeof ScheduleCancelRequest>>;
+
 /** Request options for the {@linkcode scheduleCancel} function. */
 export type ScheduleCancelOptions = ExtractRequestOptions<v.InferInput<typeof ScheduleCancelRequest>>;
 
+/** Successful variant of {@linkcode ScheduleCancelResponse} without errors. */
+export type ScheduleCancelSuccessResponse = ExcludeErrorResponse<ScheduleCancelResponse>;
+
 /**
  * Schedule a cancel-all operation at a future time.
  * @param config - General configuration for Exchange API requests.
@@ -94,7 +115,7 @@ export type ScheduleCancelOptions = ExtractRequestOptions<v.InferInput<typeof Sc
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { scheduleCancel } 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`
@@ -109,18 +130,18 @@ export async function scheduleCancel(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params?: DeepImmutable<ScheduleCancelParameters>,
   opts?: ScheduleCancelOptions,
-): Promise<SuccessResponse>;
+): Promise<ScheduleCancelSuccessResponse>;
 export async function scheduleCancel(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   opts?: ScheduleCancelOptions,
-): Promise<SuccessResponse>;
+): Promise<ScheduleCancelSuccessResponse>;
 export async function scheduleCancel(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   paramsOrOpts?:
     | DeepImmutable<ScheduleCancelParameters>
     | ScheduleCancelOptions,
   maybeOpts?: ScheduleCancelOptions,
-): Promise<SuccessResponse> {
+): Promise<ScheduleCancelSuccessResponse> {
   const isFirstArgParams = paramsOrOpts && "time" in paramsOrOpts;
   const params = isFirstArgParams ? paramsOrOpts : {};
   const opts = isFirstArgParams ? maybeOpts : paramsOrOpts as ScheduleCancelOptions;

package/src/api/exchange/sendAsset.ts

@@ -1,20 +1,15 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, Hex, parser, TokenId, UnsignedDecimal, 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, TokenId, UnsignedDecimal, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Transfer tokens between different perp DEXs, spot balance, users, and/or sub-accounts.
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset-testnet-only
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset
  */
 export const SendAssetRequest = /* @__PURE__ */ (() => {
   return v.pipe(
@@ -91,16 +86,42 @@ export const SendAssetRequest = /* @__PURE__ */ (() => {
 })();
 export type SendAssetRequest = v.InferOutput<typeof SendAssetRequest>;
 
-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#send-asset
+ */
+export const SendAssetResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type SendAssetResponse = v.InferOutput<typeof SendAssetResponse>;
+
+// ============================================================
+// 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 sendAsset} function. */
 export type SendAssetParameters = ExtractRequestAction<v.InferInput<typeof SendAssetRequest>>;
+
 /** Request options for the {@linkcode sendAsset} function. */
 export type SendAssetOptions = ExtractRequestOptions<v.InferInput<typeof SendAssetRequest>>;
 
+/** Successful variant of {@linkcode SendAssetResponse} without errors. */
+export type SendAssetSuccessResponse = ExcludeErrorResponse<SendAssetResponse>;
+
 /** EIP-712 types for the {@linkcode sendAsset} function. */
 export const SendAssetTypes = {
   "HyperliquidTransaction:SendAsset": [
@@ -125,12 +146,12 @@ export const SendAssetTypes = {
  * @throws {ApiRequestError} When the API returns an unsuccessful response.
  * @throws {TransportError} When the transport layer throws an error.
  *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset-testnet-only
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#send-asset
  * @example
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { sendAsset } 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`
@@ -151,7 +172,7 @@ export async function sendAsset(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<SendAssetParameters>,
   opts?: SendAssetOptions,
-): Promise<SuccessResponse> {
+): Promise<SendAssetSuccessResponse> {
   const request = parser(SendAssetRequest)({
     action: {
       type: "sendAsset",

package/src/api/exchange/setDisplayName.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
+// ============================================================
 
-/**
- * Set the display name in the leaderboard.
- * @see null
- */
+import { UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
+
+/** Set the display name in the leaderboard. */
 export const SetDisplayNameRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -62,16 +55,38 @@ export const SetDisplayNameRequest = /* @__PURE__ */ (() => {
 })();
 export type SetDisplayNameRequest = v.InferOutput<typeof SetDisplayNameRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/** Successful response without specific data or error response. */
+export const SetDisplayNameResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type SetDisplayNameResponse = v.InferOutput<typeof SetDisplayNameResponse>;
+
+// ============================================================
+// 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 setDisplayName} function. */
 export type SetDisplayNameParameters = ExtractRequestAction<v.InferInput<typeof SetDisplayNameRequest>>;
+
 /** Request options for the {@linkcode setDisplayName} function. */
 export type SetDisplayNameOptions = ExtractRequestOptions<v.InferInput<typeof SetDisplayNameRequest>>;
 
+/** Successful variant of {@linkcode SetDisplayNameResponse} without errors. */
+export type SetDisplayNameSuccessResponse = ExcludeErrorResponse<SetDisplayNameResponse>;
+
 /**
  * Set the display name in the leaderboard.
  * @param config - General configuration for Exchange API requests.
@@ -82,12 +97,11 @@ export type SetDisplayNameOptions = ExtractRequestOptions<v.InferInput<typeof Se
  * @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 { setDisplayName } 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`
@@ -102,7 +116,7 @@ export async function setDisplayName(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<SetDisplayNameParameters>,
   opts?: SetDisplayNameOptions,
-): Promise<SuccessResponse> {
+): Promise<SetDisplayNameSuccessResponse> {
   const request = parser(SetDisplayNameRequest)({
     action: {
       type: "setDisplayName",

package/src/api/exchange/setReferrer.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
+// ============================================================
 
-/**
- * Set a referral code.
- * @see null
- */
+import { UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
+
+/** Set a referral code. */
 export const SetReferrerRequest = /* @__PURE__ */ (() => {
   return v.pipe(
     v.object({
@@ -56,16 +49,38 @@ export const SetReferrerRequest = /* @__PURE__ */ (() => {
 })();
 export type SetReferrerRequest = v.InferOutput<typeof SetReferrerRequest>;
 
-import { SuccessResponse } from "./_base/mod.ts";
-export { SuccessResponse };
+/** Successful response without specific data or error response. */
+export const SetReferrerResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type SetReferrerResponse = v.InferOutput<typeof SetReferrerResponse>;
+
+// ============================================================
+// 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 setReferrer} function. */
 export type SetReferrerParameters = ExtractRequestAction<v.InferInput<typeof SetReferrerRequest>>;
+
 /** Request options for the {@linkcode setReferrer} function. */
 export type SetReferrerOptions = ExtractRequestOptions<v.InferInput<typeof SetReferrerRequest>>;
 
+/** Successful variant of {@linkcode SetReferrerResponse} without errors. */
+export type SetReferrerSuccessResponse = ExcludeErrorResponse<SetReferrerResponse>;
+
 /**
  * Set a referral code.
  * @param config - General configuration for Exchange API requests.
@@ -76,12 +91,11 @@ export type SetReferrerOptions = ExtractRequestOptions<v.InferInput<typeof SetRe
  * @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 { setReferrer } 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`
@@ -96,7 +110,7 @@ export async function setReferrer(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<SetReferrerParameters>,
   opts?: SetReferrerOptions,
-): Promise<SuccessResponse> {
+): Promise<SetReferrerSuccessResponse> {
   const request = parser(SetReferrerRequest)({
     action: {
       type: "setReferrer",

package/src/api/exchange/spotDeploy.ts

@@ -1,15 +1,11 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, parser, Percent, UnsignedDecimal, UnsignedInteger } from "../_base.ts";
-import {
-  type ExchangeRequestConfig,
-  executeL1Action,
-  type ExtractRequestAction,
-  type ExtractRequestOptions,
-  type MultiSignRequestConfig,
-  Signature,
-} from "./_base/mod.ts";
 
-// -------------------- Schemas --------------------
+// ============================================================
+// API Schemas
+// ============================================================
+
+import { Address, Percent, UnsignedDecimal, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Deploying HIP-1 and HIP-2 assets.
@@ -288,16 +284,41 @@ export const SpotDeployRequest = /* @__PURE__ */ (() => {
 })();
 export type SpotDeployRequest = v.InferOutput<typeof SpotDeployRequest>;
 
-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/deploying-hip-1-and-hip-2-assets
+ */
+export const SpotDeployResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type SpotDeployResponse = v.InferOutput<typeof SpotDeployResponse>;
+
+// ============================================================
+// 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 spotDeploy} function. */
 export type SpotDeployParameters = ExtractRequestAction<v.InferInput<typeof SpotDeployRequest>>;
+
 /** Request options for the {@linkcode spotDeploy} function. */
 export type SpotDeployOptions = ExtractRequestOptions<v.InferInput<typeof SpotDeployRequest>>;
 
+/** Successful variant of {@linkcode SpotDeployResponse} without errors. */
+export type SpotDeploySuccessResponse = ExcludeErrorResponse<SpotDeployResponse>;
+
 /**
  * Deploying HIP-1 and HIP-2 assets.
  * @param config - General configuration for Exchange API requests.
@@ -313,7 +334,7 @@ export type SpotDeployOptions = ExtractRequestOptions<v.InferInput<typeof SpotDe
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { spotDeploy } 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`
@@ -338,7 +359,7 @@ export async function spotDeploy(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<SpotDeployParameters>,
   opts?: SpotDeployOptions,
-): Promise<SuccessResponse> {
+): Promise<SpotDeploySuccessResponse> {
   const request = parser(SpotDeployRequest)({
     action: {
       type: "spotDeploy",

package/src/api/exchange/spotSend.ts

@@ -1,16 +1,11 @@
 import * as v from "valibot";
-import { Address, type DeepImmutable, Hex, parser, TokenId, UnsignedDecimal, 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, TokenId, UnsignedDecimal, UnsignedInteger } from "../_base.ts";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.ts";
 
 /**
  * Send spot assets to another address.
@@ -76,16 +71,42 @@ export const SpotSendRequest = /* @__PURE__ */ (() => {
 })();
 export type SpotSendRequest = v.InferOutput<typeof SpotSendRequest>;
 
-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#core-spot-transfer
+ */
+export const SpotSendResponse = /* @__PURE__ */ (() => {
+  return v.pipe(
+    v.union([SuccessResponse, ErrorResponse]),
+    v.description("Successful response without specific data or error response."),
+  );
+})();
+export type SpotSendResponse = v.InferOutput<typeof SpotSendResponse>;
+
+// ============================================================
+// 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 spotSend} function. */
 export type SpotSendParameters = ExtractRequestAction<v.InferInput<typeof SpotSendRequest>>;
+
 /** Request options for the {@linkcode spotSend} function. */
 export type SpotSendOptions = ExtractRequestOptions<v.InferInput<typeof SpotSendRequest>>;
 
+/** Successful variant of {@linkcode SpotSendResponse} without errors. */
+export type SpotSendSuccessResponse = ExcludeErrorResponse<SpotSendResponse>;
+
 /** EIP-712 types for the {@linkcode spotSend} function. */
 export const SpotSendTypes = {
   "HyperliquidTransaction:SpotSend": [
@@ -112,7 +133,7 @@ export const SpotSendTypes = {
  * ```ts
  * import { HttpTransport } from "@nktkas/hyperliquid";
  * import { spotSend } 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`
@@ -131,7 +152,7 @@ export async function spotSend(
   config: ExchangeRequestConfig | MultiSignRequestConfig,
   params: DeepImmutable<SpotSendParameters>,
   opts?: SpotSendOptions,
-): Promise<SuccessResponse> {
+): Promise<SpotSendSuccessResponse> {
   const request = parser(SpotSendRequest)({
     action: {
       type: "spotSend",