@nktkas/hyperliquid 0.25.3 → 0.25.5

package/README.md

@@ -392,7 +392,7 @@ class InfoClient {
     transport: HttpTransport | WebSocketTransport;
   });
 
-  // Market
+  // Market Data
   alignedQuoteTokenInfo(params: AlignedQuoteTokenInfoParameters): Promise<AlignedQuoteTokenInfoResponse>;
   allMids(params?: AllMidsParameters): Promise<AllMidsResponse>;
   candleSnapshot(params: CandleSnapshotParameters): Promise<CandleSnapshotResponse>;
@@ -403,19 +403,15 @@ class InfoClient {
   maxMarketOrderNtls(): Promise<MaxMarketOrderNtlsResponse>;
   meta(params?: MetaParameters): Promise<MetaResponse>;
   metaAndAssetCtxs(params?: MetaAndAssetCtxsParameters): Promise<MetaAndAssetCtxsResponse>;
-  perpDeployAuctionStatus(): Promise<PerpDeployAuctionStatusResponse>;
   perpDexLimits(params: PerpDexLimitsParameters): Promise<PerpDexLimitsResponse>;
   perpDexs(): Promise<PerpDexsResponse>;
   perpsAtOpenInterestCap(params?: PerpsAtOpenInterestCapParameters): Promise<PerpsAtOpenInterestCapResponse>;
   predictedFundings(): Promise<PredictedFundingsResponse>;
   recentTrades(params: RecentTradesParameters): Promise<RecentTradesResponse>;
-  spotDeployState(params: SpotDeployStateParameters): Promise<SpotDeployStateResponse>;
   spotMeta(): Promise<SpotMetaResponse>;
   spotMetaAndAssetCtxs(): Promise<SpotMetaAndAssetCtxsResponse>;
-  spotPairDeployAuctionStatus(): Promise<SpotPairDeployAuctionStatusResponse>;
-  tokenDetails(params: TokenDetailsParameters): Promise<TokenDetailsResponse>;
 
-  // Account
+  // User Account
   activeAssetData(params: ActiveAssetDataParameters): Promise<ActiveAssetDataResponse>;
   clearinghouseState(params: ClearinghouseStateParameters): Promise<ClearinghouseStateResponse>;
   extraAgents(params: ExtraAgentsParameters): Promise<ExtraAgentsResponse>;
@@ -427,6 +423,7 @@ class InfoClient {
   referral(params: ReferralParameters): Promise<ReferralResponse>;
   spotClearinghouseState(params: SpotClearinghouseStateParameters): Promise<SpotClearinghouseStateResponse>;
   subAccounts(params: SubAccountsParameters): Promise<SubAccountsResponse>;
+  userDexAbstraction(params: UserDexAbstractionInfoParameters): Promise<UserDexAbstractionInfoResponse>;
   userFees(params: UserFeesParameters): Promise<UserFeesResponse>;
   userFunding(params: UserFundingParameters): Promise<UserFundingResponse>;
   userNonFundingLedgerUpdates(
@@ -437,7 +434,7 @@ class InfoClient {
   userToMultiSigSigners(params: UserToMultiSigSignersParameters): Promise<UserToMultiSigSignersResponse>;
   webData2(params: WebData2Parameters): Promise<WebData2Response>;
 
-  // Order
+  // Orders & TWAP & Position
   frontendOpenOrders(params: FrontendOpenOrdersParameters): Promise<FrontendOpenOrdersResponse>;
   historicalOrders(params: HistoricalOrdersParameters): Promise<HistoricalOrdersResponse>;
   openOrders(params: OpenOrdersParameters): Promise<OpenOrdersResponse>;
@@ -448,12 +445,12 @@ class InfoClient {
   userTwapSliceFills(params: UserTwapSliceFillsParameters): Promise<UserTwapSliceFillsResponse>;
   userTwapSliceFillsByTime(params: UserTwapSliceFillsByTimeParameters): Promise<UserTwapSliceFillsByTimeResponse>;
 
-  // Validator
-  gossipRootIps(): Promise<GossipRootIpsResponse>;
+  // Delegation & Validators
   delegations(params: DelegationsParameters): Promise<DelegationsResponse>;
   delegatorHistory(params: DelegatorHistoryParameters): Promise<DelegatorHistoryResponse>;
   delegatorRewards(params: DelegatorRewardsParameters): Promise<DelegatorRewardsResponse>;
   delegatorSummary(params: DelegatorSummaryParameters): Promise<DelegatorSummaryResponse>;
+  gossipRootIps(): Promise<GossipRootIpsResponse>;
   validatorL1Votes(): Promise<ValidatorL1VotesResponse>;
   validatorSummaries(): Promise<ValidatorSummariesResponse>;
 
@@ -463,13 +460,19 @@ class InfoClient {
   vaultDetails(params: VaultDetailsParameters): Promise<VaultDetailsResponse>;
   vaultSummaries(): Promise<VaultSummariesResponse>;
 
-  // Server
+  // Deploy Market
+  perpDeployAuctionStatus(): Promise<PerpDeployAuctionStatusResponse>;
+  spotDeployState(params: SpotDeployStateParameters): Promise<SpotDeployStateResponse>;
+  spotPairDeployAuctionStatus(): Promise<SpotPairDeployAuctionStatusResponse>;
+
+  // Other
   exchangeStatus(): Promise<ExchangeStatusResponse>;
 
-  // Explorer (RPC endpoint)
+  // Transaction & Block Details (RPC endpoint)
   blockDetails(params: BlockDetailsParameters): Promise<BlockDetailsResponse>;
   txDetails(params: TxDetailsParameters): Promise<TxDetailsResponse>;
   userDetails(params: UserDetailsParameters): Promise<UserDetailsResponse>;
+  tokenDetails(params: TokenDetailsParameters): Promise<TokenDetailsResponse>;
 }
 ```
 
@@ -485,7 +488,7 @@ class ExchangeClient {
     nonceManager?: () => MaybePromise<number>; // Function to get the next nonce (default: monotonically incrementing `Date.now()`)
   });
 
-  // Order
+  // Order & TWAP & Position
   batchModify(params: BatchModifyParameters): Promise<OrderResponseSuccess>;
   cancel(params: CancelParameters): Promise<CancelResponseSuccess>;
   cancelByCloid(params: CancelByCloidParameters): Promise<CancelResponseSuccess>;
@@ -498,37 +501,39 @@ class ExchangeClient {
   updateLeverage(params: UpdateLeverageParameters): Promise<SuccessResponse>;
 
   // Account
+  agentEnableDexAbstraction(): Promise<SuccessResponse>;
   approveAgent(params: ApproveAgentParameters): Promise<SuccessResponse>;
   approveBuilderFee(params: ApproveBuilderFeeParameters): Promise<SuccessResponse>;
-  claimRewards(): Promise<SuccessResponse>;
-  createSubAccount(params: CreateSubAccountParameters): Promise<CreateSubAccountResponse>;
   evmUserModify(params: EvmUserModifyParameters): Promise<SuccessResponse>;
   noop(): Promise<SuccessResponse>;
-  registerReferrer(params: RegisterReferrerParameters): Promise<SuccessResponse>;
   reserveRequestWeight(params: ReserveRequestWeightParameters): Promise<SuccessResponse>;
   setDisplayName(params: SetDisplayNameParameters): Promise<SuccessResponse>;
-  setReferrer(params: SetReferrerParameters): Promise<SuccessResponse>;
-  subAccountModify(params: SubAccountModifyParameters): Promise<SuccessResponse>;
   spotUser(params: SpotUserParameters): Promise<SuccessResponse>;
+  userDexAbstraction(params: UserDexAbstractionExchangeParameters): Promise<UserDexAbstractionExchangeResponse>;
 
-  // Transfer
+  // Fund Transfers
   sendAsset(params: SendAssetParameters): Promise<SuccessResponse>;
   spotSend(params: SpotSendParameters): Promise<SuccessResponse>;
-  subAccountSpotTransfer(params: SubAccountSpotTransferParameters): Promise<SuccessResponse>;
-  subAccountTransfer(params: SubAccountTransferParameters): Promise<SuccessResponse>;
   usdClassTransfer(params: UsdClassTransferParameters): Promise<SuccessResponse>;
   usdSend(params: UsdSendParameters): Promise<SuccessResponse>;
   withdraw3(params: Withdraw3Parameters): Promise<SuccessResponse>;
 
-  // Staking
+  // Sub-Account
+  createSubAccount(params: CreateSubAccountParameters): Promise<CreateSubAccountResponse>;
+  subAccountModify(params: SubAccountModifyParameters): Promise<SuccessResponse>;
+  subAccountSpotTransfer(params: SubAccountSpotTransferParameters): Promise<SuccessResponse>;
+  subAccountTransfer(params: SubAccountTransferParameters): Promise<SuccessResponse>;
+
+  // Referrer
+  claimRewards(): Promise<SuccessResponse>;
+  registerReferrer(params: RegisterReferrerParameters): Promise<SuccessResponse>;
+  setReferrer(params: SetReferrerParameters): Promise<SuccessResponse>;
+
+  // Staking & Delegation
   cDeposit(params: CDepositParameters): Promise<SuccessResponse>;
   cWithdraw(params: CWithdrawParameters): Promise<SuccessResponse>;
   tokenDelegate(params: TokenDelegateParameters): Promise<SuccessResponse>;
 
-  // Market
-  perpDeploy(params: PerpDeployParameters): Promise<SuccessResponse>;
-  spotDeploy(params: SpotDeployParameters): Promise<SuccessResponse>;
-
   // Vault
   createVault(params: CreateVaultParameters): Promise<CreateVaultResponse>;
   vaultDistribute(params: VaultDistributeParameters): Promise<SuccessResponse>;
@@ -547,7 +552,11 @@ class ExchangeClient {
     | TwapCancelSuccessResponse
   >;
 
-  // Validator
+  // Deploy Market
+  perpDeploy(params: PerpDeployParameters): Promise<SuccessResponse>;
+  spotDeploy(params: SpotDeployParameters): Promise<SuccessResponse>;
+
+  // Validator Actions
   cSignerAction(params: CSignerActionParameters): Promise<SuccessResponse>;
   cValidatorAction(params: CValidatorActionParameters): Promise<SuccessResponse>;
 }
@@ -591,7 +600,7 @@ class SubscriptionClient {
   userTwapHistory(params: WsUserTwapHistoryParameters, listener: (data: WsUserTwapHistoryEvent) => void);
   userTwapSliceFills(params: WsUserTwapSliceFillsParameters, listener: (data: WsUserTwapSliceFillsEvent) => void);
 
-  // Explorer (RPC endpoint)
+  // Transaction & Block Details (RPC endpoint)
   explorerBlock(listener: (data: WsExplorerBlockEvent) => void);
   explorerTxs(listener: (data: WsExplorerTxsEvent) => void);
 }
@@ -936,6 +945,31 @@ console.log(JSON.stringify(schema, null, 2));
 // }
 ```
 
+### `/utils`
+
+This module contains helper functions for interacting with the HyperLiquid API.
+
+#### `SymbolConverter`
+
+Utility class for converting asset symbols to their corresponding IDs and size decimals. See
+[docs](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids).
+
+```ts
+import { HttpTransport } from "@nktkas/hyperliquid";
+import { SymbolConverter } from "@nktkas/hyperliquid/utils";
+
+const transport = new HttpTransport(); // or `WebSocketTransport`
+const converter = await SymbolConverter.create({ transport });
+
+const btcId = converter.getAssetId("BTC"); // perpetual → 0
+const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
+const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
+
+const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
+const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
+const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
+```
+
 ## FAQ
 
 ### How to execute an L1 action via an external wallet (e.g. MetaMask)?

package/esm/bin/cli.js

@@ -86,156 +86,156 @@ INFO ENDPOINT METHODS
 Market Data:
   alignedQuoteTokenInfo   --token <number>
   allMids                 [--dex <string>]
-  l2Book                  --coin <string> [--nSigFigs <2|3|4|5>] [--mantissa <2|5>]
-  candleSnapshot          --coin <string> --interval <1m|3m|5m|15m|30m|1h|2h|4h|8h|12h|1d|3d|1w|1M> 
+  candleSnapshot          --coin <string> --interval <1m|3m|5m|15m|30m|1h|2h|4h|8h|12h|1d|3d|1w|1M>
                           --startTime <number> [--endTime <number>]
   fundingHistory          --coin <string> --startTime <number> [--endTime <number>]
-  predictedFundings       (no params)
-  recentTrades            --coin <string>
-
-Exchange Information:
+  l2Book                  --coin <string> [--nSigFigs <2|3|4|5>] [--mantissa <2|5>]
+  liquidatable            (no params)
+  marginTable             --id <number>
+  maxMarketOrderNtls      (no params)
   meta                    [--dex <string>]
   metaAndAssetCtxs        [--dex <string>]
+  perpDexLimits           --dex <string>
+  perpDexs                (no params)
+  perpsAtOpenInterestCap  [--dex <string>]
+  predictedFundings       (no params)
+  recentTrades            --coin <string>
   spotMeta                (no params)
   spotMetaAndAssetCtxs    (no params)
-  exchangeStatus          (no params)
-  perpDexs                (no params)
-  perpDexLimits           --dex <string>
-  spotPairDeployAuctionStatus  (no params)
-  perpDeployAuctionStatus      (no params)
-  perpsAtOpenInterestCap       [--dex <string>]
-  maxMarketOrderNtls           (no params)
-  liquidatable                 (no params)
-  marginTable                  --id <number>
 
-User Account Data:
-  clearinghouseState      --user <address> [--dex <string>]
-  spotClearinghouseState  --user <address> [--dex <string>]
-  portfolio               --user <address>
-  openOrders              --user <address> [--dex <string>]
-  frontendOpenOrders      --user <address> [--dex <string>]
-  historicalOrders        --user <address>
-  orderStatus             --user <address> --oid <number|hex>
-  userDetails             --user <address>
-  userFees                --user <address>
-  userRateLimit           --user <address>
-  userRole                --user <address>
+User Account:
   activeAssetData         --user <address> --coin <string>
+  clearinghouseState      --user <address> [--dex <string>]
+  extraAgents             --user <address>
   isVip                   --user <address>
   legalCheck              --user <address>
-  referral                --user <address>
-  spotDeployState         --user <address>
-  preTransferCheck        --user <address> --source <address>
   maxBuilderFee           --user <address> --builder <address>
-  webData2                --user <address>
-
-User Trading History:
-  userFills               --user <address> [--aggregateByTime <bool>]
-  userFillsByTime         --user <address> --startTime <number> [--endTime <number>] 
-                          [--aggregateByTime <bool>]
+  portfolio               --user <address>
+  preTransferCheck        --user <address> --source <address>
+  referral                --user <address>
+  spotClearinghouseState  --user <address> [--dex <string>]
+  subAccounts             --user <address>
+  userDexAbstraction      --user <address>
+  userFees                --user <address>
   userFunding             --user <address> --startTime <number> [--endTime <number>]
   userNonFundingLedgerUpdates  --user <address> --startTime <number> [--endTime <number>]
-  twapHistory             --user <address>
-  userTwapSliceFills      --user <address>
-  userTwapSliceFillsByTime     --user <address> --startTime <number> [--endTime <number>] 
-                               [--aggregateByTime <bool>]
-
-Sub-Account & Multi-Sig:
-  subAccounts             --user <address>
-  extraAgents             --user <address>
+  userRateLimit           --user <address>
+  userRole                --user <address>
   userToMultiSigSigners   --user <address>
+  webData2                --user <address>
 
-Vault Information:
-  vaultSummaries          (no params)
-  vaultDetails            --vaultAddress <address> [--user <address>]
-  leadingVaults           --user <address>
-  userVaultEquities       --user <address>
+Orders & TWAP & Position:
+  frontendOpenOrders      --user <address> [--dex <string>]
+  historicalOrders        --user <address>
+  openOrders              --user <address> [--dex <string>]
+  orderStatus             --user <address> --oid <number|hex>
+  twapHistory             --user <address>
+  userFills               --user <address> [--aggregateByTime <bool>]
+  userFillsByTime         --user <address> --startTime <number>
+                          [--endTime <number>] [--aggregateByTime <bool>]
+  userTwapSliceFills           --user <address>
+  userTwapSliceFillsByTime     --user <address> --startTime <number>
+                               [--endTime <number>] [--aggregateByTime <bool>]
 
 Delegation & Validators:
   delegations             --user <address>
   delegatorHistory        --user <address>
   delegatorRewards        --user <address>
   delegatorSummary        --user <address>
+  gossipRootIps           (no params)
   validatorL1Votes        (no params)
   validatorSummaries      (no params)
-  gossipRootIps           (no params)
+
+Vault:
+  leadingVaults           --user <address>
+  userVaultEquities       --user <address>
+  vaultDetails            --vaultAddress <address> [--user <address>]
+  vaultSummaries          (no params)
+
+Deploy Market:
+  perpDeployAuctionStatus      (no params)
+  spotDeployState              --user <address>
+  spotPairDeployAuctionStatus  (no params)
+
+Other:
+  exchangeStatus          (no params)
 
 Transaction & Block Details:
-  txDetails               --hash <hex>
   blockDetails            --height <number>
   tokenDetails            --tokenId <hex>
+  txDetails               --hash <hex>
+  userDetails             --user <address>
 
 =============================================================================
 EXCHANGE ENDPOINT METHODS
 =============================================================================
 
-Trading Operations:
-  order                   --orders <json> [--grouping <na|normalTpsl|positionTpsl>] 
-                          [--builder <json>]
-  modify                  --oid <number|hex> --order <json>
+Order & TWAP & Position:
   batchModify             --modifies <json>
   cancel                  --cancels <json>
   cancelByCloid           --cancels <json>
+  modify                  --oid <number|hex> --order <json>
+  order                   --orders <json> [--grouping <na|normalTpsl|positionTpsl>] [--builder <json>]
   scheduleCancel          [--time <number>]
-
-TWAP Operations:
-  twapOrder               --a <number> --b <bool> --s <number> --r <bool> --m <number> --t <bool>
   twapCancel              --a <number> --t <number>
-
-Position Management:
-  updateLeverage          --asset <number> --isCross <bool> --leverage <number>
+  twapOrder               --a <number> --b <bool> --s <number> --r <bool> --m <number> --t <bool>
   updateIsolatedMargin    --asset <number> --isBuy <bool> --ntli <number>
+  updateLeverage          --asset <number> --isCross <bool> --leverage <number>
+
+Account:
+  agentEnableDexAbstraction  (no params)
+  approveAgent            --agentAddress <address> [--agentName <string>]
+  approveBuilderFee       --maxFeeRate <number> --builder <address>
+  evmUserModify           --usingBigBlocks <bool>
+  noop                    (no params)
+  reserveRequestWeight    --weight <number>
+  setDisplayName          --displayName <string>
+  spotUser                --optOut <bool>
+  userDexAbstraction      --user <address> --enabled <bool>
 
 Fund Transfers:
-  withdraw3               --destination <address> --amount <number>
-  usdSend                 --destination <address> --amount <number>
-  spotSend                --destination <address> --token <name:address> --amount <number>
   sendAsset               --destination <address> --token <name:address> --amount <number>
                           --sourceDex <string> --destinationDex <string> [--fromSubAccount <address>]
+  spotSend                --destination <address> --token <name:address> --amount <number>
   usdClassTransfer        --amount <number> --toPerp <bool>
+  usdSend                 --destination <address> --amount <number>
+  withdraw3               --destination <address> --amount <number>
 
-Sub-Account Management:
+Sub-Account:
   createSubAccount        --name <string>
   subAccountModify        --subAccountUser <address> --name <string>
-  subAccountTransfer      --subAccountUser <address> --isDeposit <bool> --usd <number>
-  subAccountSpotTransfer  --subAccountUser <address> --isDeposit <bool> 
+  subAccountSpotTransfer  --subAccountUser <address> --isDeposit <bool>
                           --token <name:address> --amount <number>
+  subAccountTransfer      --subAccountUser <address> --isDeposit <bool> --usd <number>
 
-Vault Operations:
-  createVault             --name <string> --description <string> --initialUsd <number>
-  vaultModify             --vaultAddress <address> [--allowDeposits <bool>] 
-                          [--alwaysCloseOnWithdraw <bool>]
-  vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
-  vaultDistribute         --vaultAddress <address> --usd <number>
-
-Agent & Referrer:
-  approveAgent            --agentAddress <address> [--agentName <string>]
-  approveBuilderFee       --maxFeeRate <number> --builder <address>
+Referrer:
+  claimRewards            (no params)
   registerReferrer        --code <string>
   setReferrer             --code <string>
-  setDisplayName          --displayName <string>
 
 Staking & Delegation:
-  tokenDelegate           --validator <address> --wei <number> --isUndelegate <bool>
   cDeposit                --wei <number>
   cWithdraw               --wei <number>
-  claimRewards            (no params)
+  tokenDelegate           --validator <address> --wei <number> --isUndelegate <bool>
 
-Spot & EVM Operations:
-  spotUser                --optOut <bool>
-  evmUserModify           --usingBigBlocks <bool>
-  reserveRequestWeight    --weight <number>
+Vault:
+  createVault             --name <string> --description <string> --initialUsd <number>
+  vaultDistribute         --vaultAddress <address> --usd <number>
+  vaultModify             --vaultAddress <address> [--allowDeposits <bool>]
+                          [--alwaysCloseOnWithdraw <bool>]
+  vaultTransfer           --vaultAddress <address> --isDeposit <bool> --usd <number>
 
 Deploy Market:
   perpDeploy              --registerAsset <json> | --setOracle <json>
   spotDeploy              --genesis <json> | --registerHyperliquidity <json> | --registerSpot <json> |
                           --registerToken2 <json> | --setDeployerTradingFeeShare <json> | --userGenesis <json>
 
-Multi-Sig & Advanced:
-  convertToMultiSigUser   --authorizedUsers <json> --threshold <number>
+Validator Actions:
   cSignerAction           --jailSelf null | --unjailSelf null
   cValidatorAction        --changeProfile <json> | --register <json> | --unregister null
-  noop                    (no params)
+
+Other:
+  convertToMultiSigUser   --authorizedUsers <json> --threshold <number>
 
 =============================================================================
 

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

@@ -0,0 +1,74 @@
+import { type ExchangeRequestConfig, type ExtractRequestOptions, type MultiSignRequestConfig } from "./_base.js";
+import * as v from "valibot";
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @see null
+ */
+export declare const AgentEnableDexAbstractionRequest: 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<"agentEnableDexAbstraction", undefined>, v.DescriptionAction<"agentEnableDexAbstraction", "Type of action.">]>;
+    }, undefined>, v.DescriptionAction<{
+        type: "agentEnableDexAbstraction";
+    }, "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.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.TransformAction<`0x${string}`, `0x${string}`>]>, 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.TransformAction<`0x${string}`, `0x${string}`>]>, v.DescriptionAction<`0x${string}`, "Second 32-byte component of ECDSA signature.">]>;
+        readonly v: v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.SchemaWithPipe<readonly [v.UnionSchema<[v.StringSchema<undefined>, v.NumberSchema<undefined>], undefined>, v.TransformAction<any, number>, v.SafeIntegerAction<number, undefined>]>, 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.SafeIntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>, v.DescriptionAction<number | undefined, "Expiration time of the action.">]>;
+}, undefined>, v.DescriptionAction<{
+    action: {
+        type: "agentEnableDexAbstraction";
+    };
+    nonce: number;
+    signature: {
+        r: `0x${string}`;
+        s: `0x${string}`;
+        v: 27 | 28;
+    };
+    expiresAfter?: number | undefined;
+}, "Enable HIP-3 DEX abstraction request.">]>;
+export type AgentEnableDexAbstractionRequest = v.InferOutput<typeof AgentEnableDexAbstractionRequest>;
+import { SuccessResponse } from "./_base.js";
+export { SuccessResponse };
+/** Request options for the {@linkcode agentEnableDexAbstraction} function. */
+export type AgentEnableDexAbstractionOptions = ExtractRequestOptions<v.InferInput<typeof AgentEnableDexAbstractionRequest>>;
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @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 null
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { agentEnableDexAbstraction } 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 agentEnableDexAbstraction({ transport, wallet });
+ * ```
+ */
+export declare function agentEnableDexAbstraction(config: ExchangeRequestConfig | MultiSignRequestConfig, opts?: AgentEnableDexAbstractionOptions): Promise<SuccessResponse>;
+//# sourceMappingURL=agentEnableDexAbstraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentEnableDexAbstraction.d.ts","sourceRoot":"","sources":["../../../../src/src/api/exchange/agentEnableDexAbstraction.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAE1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAE5B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAI7B;;;GAGG;AACH,eAAO,MAAM,gCAAgC;IAGvC,yBAAyB;;QAGrB,sBAAsB;;;;;IAQ1B,2DAA2D;;IAK3D,+BAA+B;;;;;;;;;;;;;;IAK/B,qCAAqC;;;;;;;;;;;;;6CAQvC,CAAC;AACL,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAEtG,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,CAAC;AAI3B,8EAA8E;AAC9E,MAAM,MAAM,gCAAgC,GAAG,qBAAqB,CAClE,CAAC,CAAC,UAAU,CAAC,OAAO,gCAAgC,CAAC,CACtD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,qBAAqB,GAAG,sBAAsB,EACtD,IAAI,CAAC,EAAE,gCAAgC,GACtC,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

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

@@ -0,0 +1,58 @@
+import { parser, UnsignedInteger } from "../_base.js";
+import { executeL1Action, Signature, } from "./_base.js";
+import * as v from "valibot";
+// -------------------- Schemas --------------------
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @see null
+ */
+export const AgentEnableDexAbstractionRequest = /* @__PURE__ */ (() => {
+    return v.pipe(v.object({
+        /** Action to perform. */
+        action: v.pipe(v.object({
+            /** Type of action. */
+            type: v.pipe(v.literal("agentEnableDexAbstraction"), v.description("Type of action.")),
+        }), 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("Enable HIP-3 DEX abstraction request."));
+})();
+import { SuccessResponse } from "./_base.js";
+export { SuccessResponse };
+/**
+ * Enable HIP-3 DEX abstraction.
+ * @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 null
+ * @example
+ * ```ts
+ * import { HttpTransport } from "@nktkas/hyperliquid";
+ * import { agentEnableDexAbstraction } 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 agentEnableDexAbstraction({ transport, wallet });
+ * ```
+ */
+export async function agentEnableDexAbstraction(config, opts) {
+    const action = parser(AgentEnableDexAbstractionRequest.entries.action)({
+        type: "agentEnableDexAbstraction",
+    });
+    const expiresAfter = typeof config.defaultExpiresAfter === "number"
+        ? config.defaultExpiresAfter
+        : await config.defaultExpiresAfter?.();
+    return await executeL1Action(config, { action, expiresAfter }, opts?.signal);
+}
+//# sourceMappingURL=agentEnableDexAbstraction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentEnableDexAbstraction.js","sourceRoot":"","sources":["../../../../src/src/api/exchange/agentEnableDexAbstraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,eAAe,EAGf,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,oDAAoD;AAEpD;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,eAAe,CAAC,CAAC,GAAG,EAAE;IACpE,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,2BAA2B,CAAC,EACtC,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CACjC;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,uCAAuC,CAAC,CACvD,CAAC;AACJ,CAAC,CAAC,EAAE,CAAC;AAGL,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,CAAC;AAS3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAsD,EACtD,IAAuC;IAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,gCAAgC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,EAAE,2BAA2B;KAClC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,mBAAmB,KAAK,QAAQ;QACjE,CAAC,CAAC,MAAM,CAAC,mBAAmB;QAC5B,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;IACzC,OAAO,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/E,CAAC"}