UNPKG

@nktkas/hyperliquid

Version:

Hyperliquid API SDK for all major JS runtimes, written in TypeScript.

98 lines (97 loc) 3.74 kB
import * as v from "valibot"; // ============================================================ // API Schemas // ============================================================ import { Hex, UnsignedInteger } from "../../_schemas.js"; /** * Transfer native token from the user spot account into staking for delegating to validators. * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking */ export const CDepositRequest = /* @__PURE__ */ (()=>{ return v.object({ /** Action to perform. */ action: v.object({ /** Type of action. */ type: v.literal("cDeposit"), /** Chain ID in hex format for EIP-712 signing. */ signatureChainId: Hex, /** Hyperliquid network type. */ hyperliquidChain: v.picklist([ "Mainnet", "Testnet" ]), /** Amount of wei to deposit into staking balance (float * 1e8). */ wei: v.pipe(UnsignedInteger, v.minValue(1)), /** Nonce (timestamp in ms) used to prevent replay attacks. */ nonce: UnsignedInteger }), /** Nonce (timestamp in ms) used to prevent replay attacks. */ nonce: UnsignedInteger, /** ECDSA signature components. */ signature: v.object({ /** First 32-byte component. */ r: v.pipe(Hex, v.length(66)), /** Second 32-byte component. */ s: v.pipe(Hex, v.length(66)), /** Recovery identifier. */ v: v.picklist([ 27, 28 ]) }) }); })(); // ============================================================ // Execution Logic // ============================================================ import { parse } from "../../../_base.js"; import { canonicalize } from "../../../signing/mod.js"; import { executeUserSignedAction } from "./_base/mod.js"; /** Schema for action fields (excludes request-level system fields). */ const CDepositActionSchema = /* @__PURE__ */ (()=>{ return v.omit(v.object(CDepositRequest.entries.action.entries), [ "signatureChainId", "hyperliquidChain", "nonce" ]); })(); /** EIP-712 types for the {@linkcode cDeposit} function. */ export const CDepositTypes = { "HyperliquidTransaction:CDeposit": [ { name: "hyperliquidChain", type: "string" }, { name: "wei", type: "uint64" }, { name: "nonce", type: "uint64" } ] }; /** * Transfer native token from the user spot account into staking for delegating to validators. * * Signing: User-Signed EIP-712. * * @param config General configuration for Exchange API requests. * @param params Parameters specific to the API request. * @param opts Request execution options. * @return Successful response without specific data. * * @throws {ValidationError} When the request parameters fail validation (before sending). * @throws {TransportError} When the transport layer throws an error. * @throws {ApiRequestError} When the API returns an unsuccessful response. * * @example * ```ts * import { HttpTransport } from "@nktkas/hyperliquid"; * import { cDeposit } 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 cDeposit({ transport, wallet }, { * wei: 1 * 1e8, * }); * ``` * * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#deposit-into-staking */ export function cDeposit(config, params, opts) { const action = canonicalize(CDepositActionSchema, parse(CDepositActionSchema, { type: "cDeposit", ...params })); return executeUserSignedAction(config, action, CDepositTypes, opts); } //# sourceMappingURL=cDeposit.js.map