@ampvaleo/x402-hyperliquid-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Valeo Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @ampvaleo/x402-hyperliquid-client
+
+Sign `sendAsset` payments and perform automatic x402 retries via `x402Fetch`.
+
+```ts
+import { x402Fetch } from "@ampvaleo/x402-hyperliquid-client";
+import { privateKeyToAccount } from "viem/accounts";
+
+const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
+const wallet = {
+  getAddress: async () => account.address,
+  signTypedData: (a) => account.signTypedData(a),
+};
+
+const res = await x402Fetch("https://api.example.com/paid", {}, wallet);
+```
+
+Optional **ethers v6** `Signer` helper: `createEthersWallet(signer)`.
+
+See the [root README](../../README.md).

package/dist/index.cjs

@@ -0,0 +1,176 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createEthersWallet: () => createEthersWallet,
+  createViemWallet: () => createViemWallet,
+  signSendAsset: () => signSendAsset,
+  signatureHexToComponents: () => signatureHexToComponents,
+  x402Fetch: () => x402Fetch
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/fetch.ts
+var import_x402_hyperliquid_core3 = require("@ampvaleo/x402-hyperliquid-core");
+
+// src/sign.ts
+var import_x402_hyperliquid_core = require("@ampvaleo/x402-hyperliquid-core");
+var import_x402_hyperliquid_core2 = require("@ampvaleo/x402-hyperliquid-core");
+var import_viem = require("viem");
+function signatureHexToComponents(sig) {
+  const bytes = (0, import_viem.hexToBytes)(sig);
+  if (bytes.length !== 65) {
+    throw new Error(`Expected 65-byte signature, got ${bytes.length}`);
+  }
+  const r = (0, import_viem.bytesToHex)(bytes.slice(0, 32));
+  const s = (0, import_viem.bytesToHex)(bytes.slice(32, 64));
+  let v = bytes[64];
+  if (v === 0 || v === 1) {
+    v += 27;
+  }
+  return { r, s, v };
+}
+async function signSendAsset(wallet, requirements, options = {}) {
+  if (requirements.scheme !== import_x402_hyperliquid_core.HYPERLIQUID_SENDASSET_SCHEME) {
+    throw new Error(`Unsupported scheme: ${requirements.scheme}`);
+  }
+  const extra = requirements.extra;
+  const chainName = extra.chain;
+  const chain = (0, import_x402_hyperliquid_core.getChainConfig)(chainName);
+  const amount = options.amount ?? requirements.maxAmountRequired;
+  const nonceMs = options.nonceMs ?? Date.now();
+  const nonce = BigInt(nonceMs);
+  const message = {
+    hyperliquidChain: chain.hyperliquidLabel,
+    destination: requirements.payTo,
+    sourceDex: extra.sourceDex,
+    destinationDex: extra.destinationDex,
+    token: extra.token,
+    amount,
+    fromSubAccount: "",
+    nonce
+  };
+  const typed = (0, import_x402_hyperliquid_core.buildSendAssetTypedData)({
+    chainId: chain.chainId,
+    message
+  });
+  const sigHex = await wallet.signTypedData({
+    domain: typed.domain,
+    types: import_x402_hyperliquid_core2.VIEM_SEND_ASSET_TYPES,
+    primaryType: typed.primaryType,
+    message: typed.message
+  });
+  const { r, s, v } = signatureHexToComponents(sigHex);
+  const action = {
+    type: "sendAsset",
+    signatureChainId: chain.signatureChainId,
+    hyperliquidChain: chain.hyperliquidLabel,
+    destination: requirements.payTo,
+    sourceDex: extra.sourceDex,
+    destinationDex: extra.destinationDex,
+    token: extra.token,
+    amount,
+    fromSubAccount: "",
+    nonce: nonceMs
+  };
+  return {
+    scheme: import_x402_hyperliquid_core.HYPERLIQUID_SENDASSET_SCHEME,
+    network: chain.network,
+    nonce: nonceMs,
+    signatureChainId: chain.signatureChainId,
+    signature: { r, s, v },
+    action,
+    accepted: {
+      ...requirements,
+      maxAmountRequired: requirements.maxAmountRequired
+    }
+  };
+}
+
+// src/fetch.ts
+async function x402Fetch(input, init, wallet, options = {}) {
+  const first = await fetch(input, init);
+  if (first.status !== 402) {
+    return first;
+  }
+  let body;
+  try {
+    body = await first.json();
+  } catch {
+    return first;
+  }
+  const accepts = body.accepts;
+  if (!accepts?.length) {
+    return first;
+  }
+  const chosen = options.selectRequirement?.(accepts) ?? accepts.find((a) => a.scheme === import_x402_hyperliquid_core3.HYPERLIQUID_SENDASSET_SCHEME);
+  if (!chosen) {
+    return first;
+  }
+  const payload = await signSendAsset(wallet, chosen);
+  const payment = (0, import_x402_hyperliquid_core3.encodePaymentHeader)(payload);
+  const headers = new Headers(init?.headers ?? void 0);
+  headers.set("X-PAYMENT", payment);
+  return fetch(input, {
+    ...init,
+    headers
+  });
+}
+
+// src/wallet.ts
+function createViemWallet(client, account) {
+  return {
+    getAddress: async () => account,
+    signTypedData: (args) => client.signTypedData({
+      account,
+      domain: args.domain,
+      types: args.types,
+      primaryType: args.primaryType,
+      message: {
+        ...args.message,
+        nonce: args.message.nonce
+      }
+    })
+  };
+}
+async function createEthersWallet(signer) {
+  const address = await signer.getAddress();
+  return {
+    getAddress: async () => address,
+    signTypedData: async (args) => {
+      const sig = await signer.signTypedData(
+        args.domain,
+        args.types,
+        args.message
+      );
+      return sig;
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEthersWallet,
+  createViemWallet,
+  signSendAsset,
+  signatureHexToComponents,
+  x402Fetch
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/fetch.ts","../src/sign.ts","../src/wallet.ts"],"sourcesContent":["export { x402Fetch, type X402FetchOptions } from \"./fetch.js\";\nexport { signSendAsset, signatureHexToComponents, type SignSendAssetOptions } from \"./sign.js\";\nexport {\n  createEthersWallet,\n  createViemWallet,\n  type HyperliquidWallet,\n} from \"./wallet.js\";\n","import {\n  HYPERLIQUID_SENDASSET_SCHEME,\n  encodePaymentHeader,\n  type PaymentRequirements,\n} from \"@ampvaleo/x402-hyperliquid-core\";\n\nimport { signSendAsset } from \"./sign.js\";\nimport type { HyperliquidWallet } from \"./wallet.js\";\n\nexport interface X402FetchOptions {\n  /** Choose which accepted requirement to pay; defaults to the first Hyperliquid sendAsset entry */\n  selectRequirement?: (\n    accepts: PaymentRequirements[],\n  ) => PaymentRequirements | undefined;\n}\n\n/**\n * Drop-in `fetch` that automatically pays Hyperliquid x402 challenges (402 + `accepts`).\n */\nexport async function x402Fetch(\n  input: RequestInfo | URL,\n  init: RequestInit | undefined,\n  wallet: HyperliquidWallet,\n  options: X402FetchOptions = {},\n): Promise<Response> {\n  const first = await fetch(input, init);\n  if (first.status !== 402) {\n    return first;\n  }\n\n  let body: unknown;\n  try {\n    body = await first.json();\n  } catch {\n    return first;\n  }\n\n  const accepts = (body as { accepts?: PaymentRequirements[] }).accepts;\n  if (!accepts?.length) {\n    return first;\n  }\n\n  const chosen =\n    options.selectRequirement?.(accepts) ??\n    accepts.find((a) => a.scheme === HYPERLIQUID_SENDASSET_SCHEME);\n\n  if (!chosen) {\n    return first;\n  }\n\n  const payload = await signSendAsset(wallet, chosen);\n  const payment = encodePaymentHeader(payload);\n\n  const headers = new Headers(init?.headers ?? undefined);\n  headers.set(\"X-PAYMENT\", payment);\n\n  return fetch(input, {\n    ...init,\n    headers,\n  });\n}\n","import type { PaymentPayload, PaymentRequirements } from \"@ampvaleo/x402-hyperliquid-core\";\nimport {\n  HYPERLIQUID_SENDASSET_SCHEME,\n  buildSendAssetTypedData,\n  getChainConfig,\n  type HyperliquidChainName,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport { VIEM_SEND_ASSET_TYPES } from \"@ampvaleo/x402-hyperliquid-core\";\nimport type { Hex } from \"viem\";\nimport { bytesToHex, hexToBytes } from \"viem\";\n\nimport type { HyperliquidWallet } from \"./wallet.js\";\n\nexport interface SignSendAssetOptions {\n  /** Defaults to `requirements.maxAmountRequired` */\n  amount?: string;\n  /** Millisecond nonce; defaults to `Date.now()` */\n  nonceMs?: number;\n}\n\nexport function signatureHexToComponents(sig: Hex): {\n  r: Hex;\n  s: Hex;\n  v: number;\n} {\n  const bytes = hexToBytes(sig);\n  if (bytes.length !== 65) {\n    throw new Error(`Expected 65-byte signature, got ${bytes.length}`);\n  }\n  const r = bytesToHex(bytes.slice(0, 32));\n  const s = bytesToHex(bytes.slice(32, 64));\n  let v = bytes[64]!;\n  if (v === 0 || v === 1) {\n    v += 27;\n  }\n  return { r, s, v };\n}\n\n/**\n * Build and sign a Hyperliquid sendAsset payment for the given x402 requirements.\n */\nexport async function signSendAsset(\n  wallet: HyperliquidWallet,\n  requirements: PaymentRequirements,\n  options: SignSendAssetOptions = {},\n): Promise<PaymentPayload> {\n  if (requirements.scheme !== HYPERLIQUID_SENDASSET_SCHEME) {\n    throw new Error(`Unsupported scheme: ${requirements.scheme}`);\n  }\n  const extra = requirements.extra;\n  const chainName = extra.chain as HyperliquidChainName;\n  const chain = getChainConfig(chainName);\n  const amount = options.amount ?? requirements.maxAmountRequired;\n  const nonceMs = options.nonceMs ?? Date.now();\n  const nonce = BigInt(nonceMs);\n\n  const message = {\n    hyperliquidChain: chain.hyperliquidLabel,\n    destination: requirements.payTo,\n    sourceDex: extra.sourceDex,\n    destinationDex: extra.destinationDex,\n    token: extra.token,\n    amount,\n    fromSubAccount: \"\",\n    nonce,\n  };\n\n  const typed = buildSendAssetTypedData({\n    chainId: chain.chainId,\n    message,\n  });\n\n  const sigHex = await wallet.signTypedData({\n    domain: typed.domain,\n    types: VIEM_SEND_ASSET_TYPES,\n    primaryType: typed.primaryType,\n    message: typed.message,\n  });\n\n  const { r, s, v } = signatureHexToComponents(sigHex);\n\n  const action = {\n    type: \"sendAsset\" as const,\n    signatureChainId: chain.signatureChainId,\n    hyperliquidChain: chain.hyperliquidLabel,\n    destination: requirements.payTo,\n    sourceDex: extra.sourceDex,\n    destinationDex: extra.destinationDex,\n    token: extra.token,\n    amount,\n    fromSubAccount: \"\",\n    nonce: nonceMs,\n  };\n\n  return {\n    scheme: HYPERLIQUID_SENDASSET_SCHEME,\n    network: chain.network,\n    nonce: nonceMs,\n    signatureChainId: chain.signatureChainId,\n    signature: { r, s, v },\n    action,\n    accepted: {\n      ...requirements,\n      maxAmountRequired: requirements.maxAmountRequired,\n    },\n  };\n}\n","import type {\n  PaymentRequirements,\n  SendAssetEip712Message,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport {\n  SEND_ASSET_PRIMARY_TYPE,\n  VIEM_SEND_ASSET_TYPES,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport type { Address, Hex, TypedDataDomain } from \"viem\";\nimport type { WalletClient } from \"viem\";\n\n/** Minimal wallet surface for Hyperliquid EIP-712 sendAsset */\nexport interface HyperliquidWallet {\n  getAddress(): Promise<Address>;\n  signTypedData(args: {\n    domain: TypedDataDomain;\n    types: typeof VIEM_SEND_ASSET_TYPES;\n    primaryType: typeof SEND_ASSET_PRIMARY_TYPE;\n    message: SendAssetEip712Message;\n  }): Promise<Hex>;\n}\n\nexport function createViemWallet(\n  client: WalletClient,\n  account: Address,\n): HyperliquidWallet {\n  return {\n    getAddress: async () => account,\n    signTypedData: (args) =>\n      client.signTypedData({\n        account,\n        domain: args.domain,\n        types: args.types,\n        primaryType: args.primaryType,\n        message: {\n          ...args.message,\n          nonce: args.message.nonce,\n        },\n      }),\n  };\n}\n\n/** ethers v6 Signer — optional peer dependency */\nexport async function createEthersWallet(\n  signer: import(\"ethers\").Signer,\n): Promise<HyperliquidWallet> {\n  const address = (await signer.getAddress()) as Address;\n  return {\n    getAddress: async () => address,\n    signTypedData: async (args) => {\n      const sig = await signer.signTypedData(\n        args.domain,\n        args.types as Record<string, import(\"ethers\").TypedDataField[]>,\n        args.message as unknown as Record<string, unknown>,\n      );\n      return sig as Hex;\n    },\n  };\n}\n\nexport type { PaymentRequirements };\n"],"mappings":"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","names":["import_x402_hyperliquid_core","import_x402_hyperliquid_core"]}

package/dist/index.d.cts

@@ -0,0 +1,44 @@
+import { VIEM_SEND_ASSET_TYPES, SEND_ASSET_PRIMARY_TYPE, SendAssetEip712Message, PaymentRequirements, PaymentPayload } from '@ampvaleo/x402-hyperliquid-core';
+import * as ethers from 'ethers';
+import { Address, TypedDataDomain, Hex, WalletClient } from 'viem';
+
+/** Minimal wallet surface for Hyperliquid EIP-712 sendAsset */
+interface HyperliquidWallet {
+    getAddress(): Promise<Address>;
+    signTypedData(args: {
+        domain: TypedDataDomain;
+        types: typeof VIEM_SEND_ASSET_TYPES;
+        primaryType: typeof SEND_ASSET_PRIMARY_TYPE;
+        message: SendAssetEip712Message;
+    }): Promise<Hex>;
+}
+declare function createViemWallet(client: WalletClient, account: Address): HyperliquidWallet;
+/** ethers v6 Signer — optional peer dependency */
+declare function createEthersWallet(signer: ethers.Signer): Promise<HyperliquidWallet>;
+
+interface X402FetchOptions {
+    /** Choose which accepted requirement to pay; defaults to the first Hyperliquid sendAsset entry */
+    selectRequirement?: (accepts: PaymentRequirements[]) => PaymentRequirements | undefined;
+}
+/**
+ * Drop-in `fetch` that automatically pays Hyperliquid x402 challenges (402 + `accepts`).
+ */
+declare function x402Fetch(input: RequestInfo | URL, init: RequestInit | undefined, wallet: HyperliquidWallet, options?: X402FetchOptions): Promise<Response>;
+
+interface SignSendAssetOptions {
+    /** Defaults to `requirements.maxAmountRequired` */
+    amount?: string;
+    /** Millisecond nonce; defaults to `Date.now()` */
+    nonceMs?: number;
+}
+declare function signatureHexToComponents(sig: Hex): {
+    r: Hex;
+    s: Hex;
+    v: number;
+};
+/**
+ * Build and sign a Hyperliquid sendAsset payment for the given x402 requirements.
+ */
+declare function signSendAsset(wallet: HyperliquidWallet, requirements: PaymentRequirements, options?: SignSendAssetOptions): Promise<PaymentPayload>;
+
+export { type HyperliquidWallet, type SignSendAssetOptions, type X402FetchOptions, createEthersWallet, createViemWallet, signSendAsset, signatureHexToComponents, x402Fetch };

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import { VIEM_SEND_ASSET_TYPES, SEND_ASSET_PRIMARY_TYPE, SendAssetEip712Message, PaymentRequirements, PaymentPayload } from '@ampvaleo/x402-hyperliquid-core';
+import * as ethers from 'ethers';
+import { Address, TypedDataDomain, Hex, WalletClient } from 'viem';
+
+/** Minimal wallet surface for Hyperliquid EIP-712 sendAsset */
+interface HyperliquidWallet {
+    getAddress(): Promise<Address>;
+    signTypedData(args: {
+        domain: TypedDataDomain;
+        types: typeof VIEM_SEND_ASSET_TYPES;
+        primaryType: typeof SEND_ASSET_PRIMARY_TYPE;
+        message: SendAssetEip712Message;
+    }): Promise<Hex>;
+}
+declare function createViemWallet(client: WalletClient, account: Address): HyperliquidWallet;
+/** ethers v6 Signer — optional peer dependency */
+declare function createEthersWallet(signer: ethers.Signer): Promise<HyperliquidWallet>;
+
+interface X402FetchOptions {
+    /** Choose which accepted requirement to pay; defaults to the first Hyperliquid sendAsset entry */
+    selectRequirement?: (accepts: PaymentRequirements[]) => PaymentRequirements | undefined;
+}
+/**
+ * Drop-in `fetch` that automatically pays Hyperliquid x402 challenges (402 + `accepts`).
+ */
+declare function x402Fetch(input: RequestInfo | URL, init: RequestInit | undefined, wallet: HyperliquidWallet, options?: X402FetchOptions): Promise<Response>;
+
+interface SignSendAssetOptions {
+    /** Defaults to `requirements.maxAmountRequired` */
+    amount?: string;
+    /** Millisecond nonce; defaults to `Date.now()` */
+    nonceMs?: number;
+}
+declare function signatureHexToComponents(sig: Hex): {
+    r: Hex;
+    s: Hex;
+    v: number;
+};
+/**
+ * Build and sign a Hyperliquid sendAsset payment for the given x402 requirements.
+ */
+declare function signSendAsset(wallet: HyperliquidWallet, requirements: PaymentRequirements, options?: SignSendAssetOptions): Promise<PaymentPayload>;
+
+export { type HyperliquidWallet, type SignSendAssetOptions, type X402FetchOptions, createEthersWallet, createViemWallet, signSendAsset, signatureHexToComponents, x402Fetch };

package/dist/index.js

@@ -0,0 +1,152 @@
+// src/fetch.ts
+import {
+  HYPERLIQUID_SENDASSET_SCHEME as HYPERLIQUID_SENDASSET_SCHEME2,
+  encodePaymentHeader
+} from "@ampvaleo/x402-hyperliquid-core";
+
+// src/sign.ts
+import {
+  HYPERLIQUID_SENDASSET_SCHEME,
+  buildSendAssetTypedData,
+  getChainConfig
+} from "@ampvaleo/x402-hyperliquid-core";
+import { VIEM_SEND_ASSET_TYPES } from "@ampvaleo/x402-hyperliquid-core";
+import { bytesToHex, hexToBytes } from "viem";
+function signatureHexToComponents(sig) {
+  const bytes = hexToBytes(sig);
+  if (bytes.length !== 65) {
+    throw new Error(`Expected 65-byte signature, got ${bytes.length}`);
+  }
+  const r = bytesToHex(bytes.slice(0, 32));
+  const s = bytesToHex(bytes.slice(32, 64));
+  let v = bytes[64];
+  if (v === 0 || v === 1) {
+    v += 27;
+  }
+  return { r, s, v };
+}
+async function signSendAsset(wallet, requirements, options = {}) {
+  if (requirements.scheme !== HYPERLIQUID_SENDASSET_SCHEME) {
+    throw new Error(`Unsupported scheme: ${requirements.scheme}`);
+  }
+  const extra = requirements.extra;
+  const chainName = extra.chain;
+  const chain = getChainConfig(chainName);
+  const amount = options.amount ?? requirements.maxAmountRequired;
+  const nonceMs = options.nonceMs ?? Date.now();
+  const nonce = BigInt(nonceMs);
+  const message = {
+    hyperliquidChain: chain.hyperliquidLabel,
+    destination: requirements.payTo,
+    sourceDex: extra.sourceDex,
+    destinationDex: extra.destinationDex,
+    token: extra.token,
+    amount,
+    fromSubAccount: "",
+    nonce
+  };
+  const typed = buildSendAssetTypedData({
+    chainId: chain.chainId,
+    message
+  });
+  const sigHex = await wallet.signTypedData({
+    domain: typed.domain,
+    types: VIEM_SEND_ASSET_TYPES,
+    primaryType: typed.primaryType,
+    message: typed.message
+  });
+  const { r, s, v } = signatureHexToComponents(sigHex);
+  const action = {
+    type: "sendAsset",
+    signatureChainId: chain.signatureChainId,
+    hyperliquidChain: chain.hyperliquidLabel,
+    destination: requirements.payTo,
+    sourceDex: extra.sourceDex,
+    destinationDex: extra.destinationDex,
+    token: extra.token,
+    amount,
+    fromSubAccount: "",
+    nonce: nonceMs
+  };
+  return {
+    scheme: HYPERLIQUID_SENDASSET_SCHEME,
+    network: chain.network,
+    nonce: nonceMs,
+    signatureChainId: chain.signatureChainId,
+    signature: { r, s, v },
+    action,
+    accepted: {
+      ...requirements,
+      maxAmountRequired: requirements.maxAmountRequired
+    }
+  };
+}
+
+// src/fetch.ts
+async function x402Fetch(input, init, wallet, options = {}) {
+  const first = await fetch(input, init);
+  if (first.status !== 402) {
+    return first;
+  }
+  let body;
+  try {
+    body = await first.json();
+  } catch {
+    return first;
+  }
+  const accepts = body.accepts;
+  if (!accepts?.length) {
+    return first;
+  }
+  const chosen = options.selectRequirement?.(accepts) ?? accepts.find((a) => a.scheme === HYPERLIQUID_SENDASSET_SCHEME2);
+  if (!chosen) {
+    return first;
+  }
+  const payload = await signSendAsset(wallet, chosen);
+  const payment = encodePaymentHeader(payload);
+  const headers = new Headers(init?.headers ?? void 0);
+  headers.set("X-PAYMENT", payment);
+  return fetch(input, {
+    ...init,
+    headers
+  });
+}
+
+// src/wallet.ts
+function createViemWallet(client, account) {
+  return {
+    getAddress: async () => account,
+    signTypedData: (args) => client.signTypedData({
+      account,
+      domain: args.domain,
+      types: args.types,
+      primaryType: args.primaryType,
+      message: {
+        ...args.message,
+        nonce: args.message.nonce
+      }
+    })
+  };
+}
+async function createEthersWallet(signer) {
+  const address = await signer.getAddress();
+  return {
+    getAddress: async () => address,
+    signTypedData: async (args) => {
+      const sig = await signer.signTypedData(
+        args.domain,
+        args.types,
+        args.message
+      );
+      return sig;
+    }
+  };
+}
+export {
+  createEthersWallet,
+  createViemWallet,
+  signSendAsset,
+  signatureHexToComponents,
+  x402Fetch
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fetch.ts","../src/sign.ts","../src/wallet.ts"],"sourcesContent":["import {\n  HYPERLIQUID_SENDASSET_SCHEME,\n  encodePaymentHeader,\n  type PaymentRequirements,\n} from \"@ampvaleo/x402-hyperliquid-core\";\n\nimport { signSendAsset } from \"./sign.js\";\nimport type { HyperliquidWallet } from \"./wallet.js\";\n\nexport interface X402FetchOptions {\n  /** Choose which accepted requirement to pay; defaults to the first Hyperliquid sendAsset entry */\n  selectRequirement?: (\n    accepts: PaymentRequirements[],\n  ) => PaymentRequirements | undefined;\n}\n\n/**\n * Drop-in `fetch` that automatically pays Hyperliquid x402 challenges (402 + `accepts`).\n */\nexport async function x402Fetch(\n  input: RequestInfo | URL,\n  init: RequestInit | undefined,\n  wallet: HyperliquidWallet,\n  options: X402FetchOptions = {},\n): Promise<Response> {\n  const first = await fetch(input, init);\n  if (first.status !== 402) {\n    return first;\n  }\n\n  let body: unknown;\n  try {\n    body = await first.json();\n  } catch {\n    return first;\n  }\n\n  const accepts = (body as { accepts?: PaymentRequirements[] }).accepts;\n  if (!accepts?.length) {\n    return first;\n  }\n\n  const chosen =\n    options.selectRequirement?.(accepts) ??\n    accepts.find((a) => a.scheme === HYPERLIQUID_SENDASSET_SCHEME);\n\n  if (!chosen) {\n    return first;\n  }\n\n  const payload = await signSendAsset(wallet, chosen);\n  const payment = encodePaymentHeader(payload);\n\n  const headers = new Headers(init?.headers ?? undefined);\n  headers.set(\"X-PAYMENT\", payment);\n\n  return fetch(input, {\n    ...init,\n    headers,\n  });\n}\n","import type { PaymentPayload, PaymentRequirements } from \"@ampvaleo/x402-hyperliquid-core\";\nimport {\n  HYPERLIQUID_SENDASSET_SCHEME,\n  buildSendAssetTypedData,\n  getChainConfig,\n  type HyperliquidChainName,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport { VIEM_SEND_ASSET_TYPES } from \"@ampvaleo/x402-hyperliquid-core\";\nimport type { Hex } from \"viem\";\nimport { bytesToHex, hexToBytes } from \"viem\";\n\nimport type { HyperliquidWallet } from \"./wallet.js\";\n\nexport interface SignSendAssetOptions {\n  /** Defaults to `requirements.maxAmountRequired` */\n  amount?: string;\n  /** Millisecond nonce; defaults to `Date.now()` */\n  nonceMs?: number;\n}\n\nexport function signatureHexToComponents(sig: Hex): {\n  r: Hex;\n  s: Hex;\n  v: number;\n} {\n  const bytes = hexToBytes(sig);\n  if (bytes.length !== 65) {\n    throw new Error(`Expected 65-byte signature, got ${bytes.length}`);\n  }\n  const r = bytesToHex(bytes.slice(0, 32));\n  const s = bytesToHex(bytes.slice(32, 64));\n  let v = bytes[64]!;\n  if (v === 0 || v === 1) {\n    v += 27;\n  }\n  return { r, s, v };\n}\n\n/**\n * Build and sign a Hyperliquid sendAsset payment for the given x402 requirements.\n */\nexport async function signSendAsset(\n  wallet: HyperliquidWallet,\n  requirements: PaymentRequirements,\n  options: SignSendAssetOptions = {},\n): Promise<PaymentPayload> {\n  if (requirements.scheme !== HYPERLIQUID_SENDASSET_SCHEME) {\n    throw new Error(`Unsupported scheme: ${requirements.scheme}`);\n  }\n  const extra = requirements.extra;\n  const chainName = extra.chain as HyperliquidChainName;\n  const chain = getChainConfig(chainName);\n  const amount = options.amount ?? requirements.maxAmountRequired;\n  const nonceMs = options.nonceMs ?? Date.now();\n  const nonce = BigInt(nonceMs);\n\n  const message = {\n    hyperliquidChain: chain.hyperliquidLabel,\n    destination: requirements.payTo,\n    sourceDex: extra.sourceDex,\n    destinationDex: extra.destinationDex,\n    token: extra.token,\n    amount,\n    fromSubAccount: \"\",\n    nonce,\n  };\n\n  const typed = buildSendAssetTypedData({\n    chainId: chain.chainId,\n    message,\n  });\n\n  const sigHex = await wallet.signTypedData({\n    domain: typed.domain,\n    types: VIEM_SEND_ASSET_TYPES,\n    primaryType: typed.primaryType,\n    message: typed.message,\n  });\n\n  const { r, s, v } = signatureHexToComponents(sigHex);\n\n  const action = {\n    type: \"sendAsset\" as const,\n    signatureChainId: chain.signatureChainId,\n    hyperliquidChain: chain.hyperliquidLabel,\n    destination: requirements.payTo,\n    sourceDex: extra.sourceDex,\n    destinationDex: extra.destinationDex,\n    token: extra.token,\n    amount,\n    fromSubAccount: \"\",\n    nonce: nonceMs,\n  };\n\n  return {\n    scheme: HYPERLIQUID_SENDASSET_SCHEME,\n    network: chain.network,\n    nonce: nonceMs,\n    signatureChainId: chain.signatureChainId,\n    signature: { r, s, v },\n    action,\n    accepted: {\n      ...requirements,\n      maxAmountRequired: requirements.maxAmountRequired,\n    },\n  };\n}\n","import type {\n  PaymentRequirements,\n  SendAssetEip712Message,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport {\n  SEND_ASSET_PRIMARY_TYPE,\n  VIEM_SEND_ASSET_TYPES,\n} from \"@ampvaleo/x402-hyperliquid-core\";\nimport type { Address, Hex, TypedDataDomain } from \"viem\";\nimport type { WalletClient } from \"viem\";\n\n/** Minimal wallet surface for Hyperliquid EIP-712 sendAsset */\nexport interface HyperliquidWallet {\n  getAddress(): Promise<Address>;\n  signTypedData(args: {\n    domain: TypedDataDomain;\n    types: typeof VIEM_SEND_ASSET_TYPES;\n    primaryType: typeof SEND_ASSET_PRIMARY_TYPE;\n    message: SendAssetEip712Message;\n  }): Promise<Hex>;\n}\n\nexport function createViemWallet(\n  client: WalletClient,\n  account: Address,\n): HyperliquidWallet {\n  return {\n    getAddress: async () => account,\n    signTypedData: (args) =>\n      client.signTypedData({\n        account,\n        domain: args.domain,\n        types: args.types,\n        primaryType: args.primaryType,\n        message: {\n          ...args.message,\n          nonce: args.message.nonce,\n        },\n      }),\n  };\n}\n\n/** ethers v6 Signer — optional peer dependency */\nexport async function createEthersWallet(\n  signer: import(\"ethers\").Signer,\n): Promise<HyperliquidWallet> {\n  const address = (await signer.getAddress()) as Address;\n  return {\n    getAddress: async () => address,\n    signTypedData: async (args) => {\n      const sig = await signer.signTypedData(\n        args.domain,\n        args.types as Record<string, import(\"ethers\").TypedDataField[]>,\n        args.message as unknown as Record<string, unknown>,\n      );\n      return sig as Hex;\n    },\n  };\n}\n\nexport type { PaymentRequirements };\n"],"mappings":"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","names":["HYPERLIQUID_SENDASSET_SCHEME","HYPERLIQUID_SENDASSET_SCHEME"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@ampvaleo/x402-hyperliquid-client",
+  "version": "0.1.0",
+  "description": "Sign and fetch helpers for x402 on Hyperliquid HyperCore",
+  "author": "Valeo Protocol",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/valeo-cash/x402-hyperliquid.git",
+    "directory": "packages/client"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "viem": "^2.21.54",
+    "@ampvaleo/x402-hyperliquid-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ethers": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}