@hfunlabs/hyperliquid 0.27.1-hfunlabs.1

package/esm/src/api/exchange/createVault.d.ts

@@ -0,0 +1,133 @@
+import * as v from "valibot";
+/** Create a vault. */
+export declare const CreateVaultRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"createVault", undefined>, v.DescriptionAction<"createVault", "Type of action.">]>;
+        /** Vault name. */
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 3, undefined>, v.DescriptionAction<string, "Vault name.">]>;
+        /** Vault description. */
+        readonly description: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 10, undefined>, v.DescriptionAction<string, "Vault description.">]>;
+        /** Initial balance (float * 1e6). */
+        readonly initialUsd: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.MinValueAction<number, 100000000, undefined>, v.DescriptionAction<number, "Initial balance (float * 1e6).">]>;
+        /** Unique request identifier (current timestamp in ms) (default: Date.now()). */
+        readonly nonce: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, () => number>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "createVault";
+        name: string;
+        description: string;
+        initialUsd: number;
+        nonce: number;
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+    /** Expiration time of the action. */
+    readonly expiresAfter: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, v.DescriptionAction<number | undefined, "Expiration time of the action.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "createVault";
+        name: string;
+        description: string;
+        initialUsd: number;
+        nonce: number;
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+    expiresAfter?: number | undefined;
+}, "Create a vault.">]>;
+export type CreateVaultRequest = v.InferOutput<typeof CreateVaultRequest>;
+/** Response for creating a vault. */
+export declare const CreateVaultResponse: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Successful status. */
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"ok", undefined>, v.DescriptionAction<"ok", "Successful status.">]>;
+    /** Response details. */
+    readonly response: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of response. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"createVault", undefined>, v.DescriptionAction<"createVault", "Type of response.">]>;
+        /** Vault address. */
+        readonly data: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, "Vault address.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "createVault";
+        data: `0x${string}`;
+    }, "Response details.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "ok";
+    response: {
+        type: "createVault";
+        data: `0x${string}`;
+    };
+}, "Successful response for creating a vault">]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"err", undefined>, v.DescriptionAction<"err", "Error status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Error message.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+}, "Error response for failed operations.">]>], undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+} | {
+    status: "ok";
+    response: {
+        type: "createVault";
+        data: `0x${string}`;
+    };
+}, "Response for creating a vault.">]>;
+export type CreateVaultResponse = v.InferOutput<typeof CreateVaultResponse>;
+import { type DeepImmutable } from "../_base.js";
+import { type ExchangeRequestConfig, type ExcludeErrorResponse, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_base/mod.js";
+/** Action parameters for the {@linkcode createVault} function. */
+export type CreateVaultParameters = ExtractRequestAction<v.InferInput<typeof CreateVaultRequest>>;
+/** Request options for the {@linkcode createVault} function. */
+export type CreateVaultOptions = ExtractRequestOptions<v.InferInput<typeof CreateVaultRequest>>;
+/** Successful variant of {@linkcode CreateVaultResponse} without errors. */
+export type CreateVaultSuccessResponse = ExcludeErrorResponse<CreateVaultResponse>;
+/**
+ * Create a vault.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Response for creating a vault.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { createVault } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * const data = await createVault(
+ *   { transport, wallet },
+ *   {
+ *     name: "...",
+ *     description: "...",
+ *     initialUsd: 100 * 1e6,
+ *   },
+ * );
+ * ```
+ */
+export declare function createVault(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<CreateVaultParameters>, opts?: CreateVaultOptions): Promise<CreateVaultSuccessResponse>;
+//# sourceMappingURL=createVault.d.ts.map

package/esm/src/api/exchange/createVault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVault.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/createVault.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAS7B,sBAAsB;AACtB,eAAO,MAAM,kBAAkB;IAGzB,yBAAyB;;QAGrB,sBAAsB;;QAKtB,kBAAkB;;QAMlB,yBAAyB;;QAMzB,qCAAqC;;QAMrC,iFAAiF;;;;;;;;;IAQrF,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;IAK/B,qCAAqC;;;;;;;;;;;;;;;;;uBAQvC,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE1E,qCAAqC;AACrC,eAAO,MAAM,mBAAmB;IAKtB,yBAAyB;;IAKzB,wBAAwB;;QAGpB,wBAAwB;;QAKxB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAe/B,CAAC;AACL,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAM5E,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAExB,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAElG,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC;AAEhG,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAAG,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC5C,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,0BAA0B,CAAC,CAiBrC"}

package/esm/src/api/exchange/createVault.js

@@ -0,0 +1,102 @@
+import * as v from "valibot";
+// ============================================================
+// API Schemas
+// ============================================================
+import { Address, UnsignedInteger } from "../_base.js";
+import { ErrorResponse, Signature } from "./_base/mod.js";
+/** Create a vault. */
+export const CreateVaultRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("createVault"), v.description("Type of action.")),
+            /** Vault name. */
+            name: v.pipe(v.string(), v.minLength(3), v.description("Vault name.")),
+            /** Vault description. */
+            description: v.pipe(v.string(), v.minLength(10), v.description("Vault description.")),
+            /** Initial balance (float * 1e6). */
+            initialUsd: v.pipe(UnsignedInteger, v.minValue(100000000), // 100 USDC
+            v.description("Initial balance (float * 1e6).")),
+            /** Unique request identifier (current timestamp in ms) (default: Date.now()). */
+            nonce: v.pipe(v.optional(UnsignedInteger, () => Date.now()), // default value is allowed because this is an L1 action
+            v.description("Unique request identifier (current timestamp in ms).")),
+        }), v.description("Action to perform.")),
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(Signature, v.description("Cryptographic signature.")),
+        /** Expiration time of the action. */
+        expiresAfter: v.pipe(v.optional(UnsignedInteger), v.description("Expiration time of the action.")),
+    }), v.description("Create a vault."));
+})();
+/** Response for creating a vault. */
+export const CreateVaultResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([
+        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("createVault"), v.description("Type of response.")),
+                /** Vault address. */
+                data: v.pipe(Address, v.description("Vault address.")),
+            }), v.description("Response details.")),
+        }), v.description("Successful response for creating a vault")),
+        ErrorResponse,
+    ]), v.description("Response for creating a vault."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+import { parser } from "../_base.js";
+import { executeL1Action, } from "./_base/mod.js";
+/**
+ * Create a vault.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Response for creating a vault.
+ *
+ * @throws {ApiRequestError} When the API returns an unsuccessful response.
+ * @throws {TransportError} When the transport layer throws an error.
+ *
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { createVault } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * const data = await createVault(
+ *   { transport, wallet },
+ *   {
+ *     name: "...",
+ *     description: "...",
+ *     initialUsd: 100 * 1e6,
+ *   },
+ * );
+ * ```
+ */
+export async function createVault(config, params, opts) {
+    const request = parser(CreateVaultRequest)({
+        action: {
+            type: "createVault",
+            ...params,
+        },
+        nonce: 0, // Placeholder; actual nonce generated in `executeL1Action`
+        signature: {
+            r: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            s: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            v: 27,
+        },
+        expiresAfter: typeof config.defaultExpiresAfter === "number"
+            ? config.defaultExpiresAfter
+            : await config.defaultExpiresAfter?.(),
+    });
+    return await executeL1Action(config, request, opts?.signal);
+}
+//# sourceMappingURL=createVault.js.map

package/esm/src/api/exchange/createVault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVault.js","sourceRoot":"","sources":["../../../../src/src/api/exchange/createVault.ts"],"names":[],"mappings":"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"}

package/esm/src/api/exchange/evmUserModify.d.ts

@@ -0,0 +1,116 @@
+import * as v from "valibot";
+/**
+ * Configure block type for EVM transactions.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
+ */
+export declare const EvmUserModifyRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"evmUserModify", undefined>, v.DescriptionAction<"evmUserModify", "Type of action.">]>;
+        /** `true` for large blocks, `false` for small blocks. */
+        readonly usingBigBlocks: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, "`true` for large blocks, `false` for small blocks.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "evmUserModify";
+        usingBigBlocks: boolean;
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+    /** Expiration time of the action. */
+    readonly expiresAfter: v.SchemaWithPipe<readonly [v.OptionalSchema<v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, v.DescriptionAction<number | undefined, "Expiration time of the action.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "evmUserModify";
+        usingBigBlocks: boolean;
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+    expiresAfter?: number | undefined;
+}, "Configure block type for EVM transactions.">]>;
+export type EvmUserModifyRequest = v.InferOutput<typeof EvmUserModifyRequest>;
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
+ */
+export declare const EvmUserModifyResponse: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"ok", undefined>, v.DescriptionAction<"ok", "Successful status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"default", undefined>, v.DescriptionAction<"default", "Type of response.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "default";
+    }, "Response details.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "ok";
+    response: {
+        type: "default";
+    };
+}, "Successful response without specific data.">]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"err", undefined>, v.DescriptionAction<"err", "Error status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Error message.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+}, "Error response for failed operations.">]>], undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+} | {
+    status: "ok";
+    response: {
+        type: "default";
+    };
+}, "Successful response without specific data or error response.">]>;
+export type EvmUserModifyResponse = v.InferOutput<typeof EvmUserModifyResponse>;
+import { type DeepImmutable } from "../_base.js";
+import { type ExchangeRequestConfig, type ExcludeErrorResponse, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_base/mod.js";
+/** Action parameters for the {@linkcode evmUserModify} function. */
+export type EvmUserModifyParameters = ExtractRequestAction<v.InferInput<typeof EvmUserModifyRequest>>;
+/** Request options for the {@linkcode evmUserModify} function. */
+export type EvmUserModifyOptions = ExtractRequestOptions<v.InferInput<typeof EvmUserModifyRequest>>;
+/** Successful variant of {@linkcode EvmUserModifyResponse} without errors. */
+export type EvmUserModifySuccessResponse = ExcludeErrorResponse<EvmUserModifyResponse>;
+/**
+ * Configure block type for EVM transactions.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @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/hyperevm/dual-block-architecture
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { evmUserModify } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await evmUserModify(
+ *   { transport, wallet },
+ *   { usingBigBlocks: true },
+ * );
+ * ```
+ */
+export declare function evmUserModify(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<EvmUserModifyParameters>, opts?: EvmUserModifyOptions): Promise<EvmUserModifySuccessResponse>;
+//# sourceMappingURL=evmUserModify.d.ts.map

package/esm/src/api/exchange/evmUserModify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evmUserModify.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/evmUserModify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAS7B;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAG3B,yBAAyB;;QAGrB,sBAAsB;;QAKtB,yDAAyD;;;;;;IAQ7D,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;IAK/B,qCAAqC;;;;;;;;;;;;;;kDAQvC,CAAC;AACL,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;oEAK9B,CAAC;AACL,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMhF,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAExB,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAEtG,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC;AAEpG,8EAA8E;AAC9E,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,EAC9C,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,4BAA4B,CAAC,CAiBvC"}

package/esm/src/api/exchange/evmUserModify.js

@@ -0,0 +1,84 @@
+import * as v from "valibot";
+// ============================================================
+// API Schemas
+// ============================================================
+import { UnsignedInteger } from "../_base.js";
+import { ErrorResponse, Signature, SuccessResponse } from "./_base/mod.js";
+/**
+ * Configure block type for EVM transactions.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
+ */
+export const EvmUserModifyRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("evmUserModify"), v.description("Type of action.")),
+            /** `true` for large blocks, `false` for small blocks. */
+            usingBigBlocks: v.pipe(v.boolean(), v.description("`true` for large blocks, `false` for small blocks.")),
+        }), v.description("Action to perform.")),
+        /** Unique request identifier (current timestamp in ms). */
+        nonce: v.pipe(UnsignedInteger, v.description("Unique request identifier (current timestamp in ms).")),
+        /** Cryptographic signature. */
+        signature: v.pipe(Signature, v.description("Cryptographic signature.")),
+        /** Expiration time of the action. */
+        expiresAfter: v.pipe(v.optional(UnsignedInteger), v.description("Expiration time of the action.")),
+    }), v.description("Configure block type for EVM transactions."));
+})();
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/dual-block-architecture
+ */
+export const EvmUserModifyResponse = /* @__PURE__ */ (() => {
+    return v.pipe(v.union([SuccessResponse, ErrorResponse]), v.description("Successful response without specific data or error response."));
+})();
+// ============================================================
+// Execution Logic
+// ============================================================
+import { parser } from "../_base.js";
+import { executeL1Action, } from "./_base/mod.js";
+/**
+ * Configure block type for EVM transactions.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @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/hyperevm/dual-block-architecture
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { evmUserModify } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await evmUserModify(
+ *   { transport, wallet },
+ *   { usingBigBlocks: true },
+ * );
+ * ```
+ */
+export async function evmUserModify(config, params, opts) {
+    const request = parser(EvmUserModifyRequest)({
+        action: {
+            type: "evmUserModify",
+            ...params,
+        },
+        nonce: 0, // Placeholder; actual nonce generated in `executeL1Action`
+        signature: {
+            r: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            s: "0x0000000000000000000000000000000000000000000000000000000000000000",
+            v: 27,
+        },
+        expiresAfter: typeof config.defaultExpiresAfter === "number"
+            ? config.defaultExpiresAfter
+            : await config.defaultExpiresAfter?.(),
+    });
+    return await executeL1Action(config, request, opts?.signal);
+}
+//# sourceMappingURL=evmUserModify.js.map

package/esm/src/api/exchange/evmUserModify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evmUserModify.js","sourceRoot":"","sources":["../../../../src/src/api/exchange/evmUserModify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACxD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,MAAM,CAAC;QACP,yBAAyB;QACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CACZ,CAAC,CAAC,MAAM,CAAC;YACP,sBAAsB;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CACV,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAC1B,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CACjC;YACD,yDAAyD;YACzD,cAAc,EAAE,CAAC,CAAC,IAAI,CACpB,CAAC,CAAC,OAAO,EAAE,EACX,CAAC,CAAC,WAAW,CAAC,oDAAoD,CAAC,CACpE;SACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC,CACpC;QACD,2DAA2D;QAC3D,KAAK,EAAE,CAAC,CAAC,IAAI,CACX,eAAe,EACf,CAAC,CAAC,WAAW,CAAC,sDAAsD,CAAC,CACtE;QACD,+BAA+B;QAC/B,SAAS,EAAE,CAAC,CAAC,IAAI,CACf,SAAS,EACT,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAC1C;QACD,qCAAqC;QACrC,YAAY,EAAE,CAAC,CAAC,IAAI,CAClB,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAC3B,CAAC,CAAC,WAAW,CAAC,gCAAgC,CAAC,CAChD;KACF,CAAC,EACF,CAAC,CAAC,WAAW,CAAC,4CAA4C,CAAC,CAC5D,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACzD,OAAO,CAAC,CAAC,IAAI,CACX,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,EACzC,CAAC,CAAC,WAAW,CAAC,8DAA8D,CAAC,CAC9E,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,OAAO,EAAsB,MAAM,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAGL,eAAe,GAIhB,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAsD,EACtD,MAA8C,EAC9C,IAA2B;IAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC3C,MAAM,EAAE;YACN,IAAI,EAAE,eAAe;YACrB,GAAG,MAAM;SACV;QACD,KAAK,EAAE,CAAC,EAAE,2DAA2D;QACrE,SAAS,EAAE;YACT,CAAC,EAAE,oEAAoE;YACvE,CAAC,EAAE,oEAAoE;YACvE,CAAC,EAAE,EAAE;SACN;QACD,YAAY,EAAE,OAAO,MAAM,CAAC,mBAAmB,KAAK,QAAQ;YAC1D,CAAC,CAAC,MAAM,CAAC,mBAAmB;YAC5B,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE;KACzC,CAAC,CAAC;IACH,OAAO,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/esm/src/api/exchange/linkStakingUser.d.ts

@@ -0,0 +1,144 @@
+import * as v from "valibot";
+/**
+ * Link staking and trading accounts for fee discount attribution.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#staking-linking
+ */
+export declare const LinkStakingUserRequest: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    /** Action to perform. */
+    readonly action: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        /** Type of action. */
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"linkStakingUser", undefined>, v.DescriptionAction<"linkStakingUser", "Type of action.">]>;
+        /** Chain ID used for signing. */
+        readonly signatureChainId: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Chain ID used for signing.">]>;
+        /** HyperLiquid network. */
+        readonly hyperliquidChain: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<"Mainnet", undefined>, v.LiteralSchema<"Testnet", undefined>], undefined>, v.DescriptionAction<"Testnet" | "Mainnet", "HyperLiquid network.">]>;
+        /**
+         * Target account address.
+         * - Trading user initiating: enter staking account address.
+         * - Staking user finalizing: enter trading account address.
+         */
+        readonly user: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 42, undefined>]>, v.DescriptionAction<`0x${string}`, string>]>;
+        /**
+         * Link phase.
+         * - `false` = trading user initiates link request.
+         * - `true` = staking user finalizes permanent link.
+         */
+        readonly isFinalize: v.SchemaWithPipe<readonly [v.BooleanSchema<undefined>, v.DescriptionAction<boolean, string>]>;
+        /** Unique request identifier (current timestamp in ms). */
+        readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "linkStakingUser";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        user: `0x${string}`;
+        isFinalize: boolean;
+        nonce: number;
+    }, "Action to perform.">]>;
+    /** Unique request identifier (current timestamp in ms). */
+    readonly nonce: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, v.DescriptionAction<number, "Unique request identifier (current timestamp in ms).">]>;
+    /** Cryptographic signature. */
+    readonly signature: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly r: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "First 32-byte component of ECDSA signature.">]>;
+        readonly s: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, undefined>, v.TransformAction<string, `0x${string}`>]>, v.LengthAction<`0x${string}`, 66, undefined>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.UnionSchema<[v.LiteralSchema<27, undefined>, v.LiteralSchema<28, undefined>], undefined>, v.DescriptionAction<27 | 28, "Recovery identifier.">]>;
+    }, undefined>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "ECDSA signature components for Ethereum typed data.">]>, v.DescriptionAction<{
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    }, "Cryptographic signature.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "linkStakingUser";
+        signatureChainId: `0x${string}`;
+        hyperliquidChain: "Testnet" | "Mainnet";
+        user: `0x${string}`;
+        isFinalize: boolean;
+        nonce: number;
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+}, "">]>;
+export type LinkStakingUserRequest = v.InferOutput<typeof LinkStakingUserRequest>;
+/**
+ * Successful response without specific data or error response.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#staking-linking
+ */
+export declare const LinkStakingUserResponse: v.SchemaWithPipe<readonly [v.UnionSchema<[v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"ok", undefined>, v.DescriptionAction<"ok", "Successful status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+        readonly type: v.SchemaWithPipe<readonly [v.LiteralSchema<"default", undefined>, v.DescriptionAction<"default", "Type of response.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "default";
+    }, "Response details.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "ok";
+    response: {
+        type: "default";
+    };
+}, "Successful response without specific data.">]>, v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly status: v.SchemaWithPipe<readonly [v.LiteralSchema<"err", undefined>, v.DescriptionAction<"err", "Error status.">]>;
+    readonly response: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Error message.">]>;
+}, undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+}, "Error response for failed operations.">]>], undefined>, v.DescriptionAction<{
+    status: "err";
+    response: string;
+} | {
+    status: "ok";
+    response: {
+        type: "default";
+    };
+}, "Successful response without specific data or error response.">]>;
+export type LinkStakingUserResponse = v.InferOutput<typeof LinkStakingUserResponse>;
+import { type DeepImmutable } from "../_base.js";
+import { type ExchangeRequestConfig, type ExcludeErrorResponse, type ExtractRequestAction, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_base/mod.js";
+/** Action parameters for the {@linkcode linkStakingUser} function. */
+export type LinkStakingUserParameters = ExtractRequestAction<v.InferInput<typeof LinkStakingUserRequest>>;
+/** Request options for the {@linkcode linkStakingUser} function. */
+export type LinkStakingUserOptions = ExtractRequestOptions<v.InferInput<typeof LinkStakingUserRequest>>;
+/** Successful variant of {@linkcode LinkStakingUserResponse} without errors. */
+export type LinkStakingUserSuccessResponse = ExcludeErrorResponse<LinkStakingUserResponse>;
+/** EIP-712 types for the {@linkcode linkStakingUser} function. */
+export declare const LinkStakingUserTypes: {
+    "HyperliquidTransaction:LinkStakingUser": {
+        name: string;
+        type: string;
+    }[];
+};
+/**
+ * Link staking and trading accounts for fee discount attribution.
+ * @param config - General configuration for Exchange API requests.
+ * @param params - Parameters specific to the API request.
+ * @param opts - Request execution options.
+ * @returns Successful response without specific data.
+ *
+ * @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/trading/fees#staking-linking
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { linkStakingUser } from "@nktkas/hyperliquid/api/exchange";
+ * import { privateKeyToAccount } from "npm:viem/accounts";
+ *
+ * const wallet = privateKeyToAccount("0x..."); // viem or ethers
+ * const transport = new HttpTransport(); // or `WebSocketTransport`
+ *
+ * await linkStakingUser(
+ *   { transport, wallet },
+ *   { user: "0x...", isFinalize: false },
+ * );
+ * ```
+ */
+export declare function linkStakingUser(config: ExchangeRequestConfig | MultiSignRequestConfig, params: DeepImmutable<LinkStakingUserParameters>, opts?: LinkStakingUserOptions): Promise<LinkStakingUserSuccessResponse>;
+//# sourceMappingURL=linkStakingUser.d.ts.map

package/esm/src/api/exchange/linkStakingUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkStakingUser.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/linkStakingUser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAS7B;;;GAGG;AACH,eAAO,MAAM,sBAAsB;IAG7B,yBAAyB;;QAGrB,sBAAsB;;QAKtB,iCAAiC;;QAKjC,2BAA2B;;QAK3B;;;;WAIG;;QASH;;;;WAIG;;QASH,2DAA2D;;;;;;;;;;IAQ/D,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAQjC,CAAC;AACL,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;oEAKhC,CAAC;AACL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMpF,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,aAAa,CAAC;AACzD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAExB,sEAAsE;AACtE,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AAE1G,oEAAoE;AACpE,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AAExG,gFAAgF;AAChF,MAAM,MAAM,8BAA8B,GAAG,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;AAE3F,kEAAkE;AAClE,eAAO,MAAM,oBAAoB;;;;;CAOhC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,MAAM,EAAE,aAAa,CAAC,yBAAyB,CAAC,EAChD,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,8BAA8B,CAAC,CAiBzC"}