@exagent/agent 0.3.6 → 0.3.8

package/src/perp/signer.ts

@@ -1,277 +0,0 @@
-/**
- * Hyperliquid EIP-712 Signer
- *
- * Signs Hyperliquid L1 actions (orders, cancels, leverage changes)
- * using the "phantom agent" pattern:
- *
- * 1. Serialize action via msgpack (NOT JSON.stringify)
- * 2. Hash: keccak256(msgpack(action) + nonce_bytes + vault_marker)
- * 3. Sign EIP-712 typed data with domain "Exchange" / chainId 1337
- *    and type Agent { source: string, connectionId: bytes32 }
- *
- * This is fundamentally different from user-signed actions (approveAgent,
- * withdraw, etc.) which use the "HyperliquidSignTransaction" domain with
- * chainId 42161. Those are NOT used for trading.
- *
- * Nonces are timestamp-based (ms), strictly increasing.
- */
-
-import { type WalletClient, keccak256 } from 'viem';
-import { encodeMsgpack, largeIntToBigInt, removeUndefinedKeys, toUint64Bytes } from './msgpack.js';
-import type { MsgpackValue } from './msgpack.js';
-
-// ── EIP-712 DOMAINS ─────────────────────────────────────────
-
-/**
- * L1 Action domain — "Exchange" with chainId 1337.
- * Used for trading actions (orders, cancels, leverage) via the phantom agent pattern.
- */
-export const HYPERLIQUID_DOMAIN = {
-  name: 'Exchange' as const,
-  version: '1' as const,
-  chainId: 1337,
-  verifyingContract: '0x0000000000000000000000000000000000000000' as `0x${string}`,
-} as const;
-
-/**
- * User-signed action domain — "HyperliquidSignTransaction" with chainId 42161 (Arbitrum).
- * Used for withdraw3, usdSend, approveAgent, and other non-trading actions.
- * These use direct EIP-712 signing (NOT the phantom agent pattern).
- */
-export const HYPERLIQUID_USER_DOMAIN = {
-  name: 'HyperliquidSignTransaction' as const,
-  version: '1' as const,
-  chainId: 42161,
-  verifyingContract: '0x0000000000000000000000000000000000000000' as `0x${string}`,
-} as const;
-
-/** EIP-712 types for Hyperliquid user-signed actions */
-export const USER_ACTION_TYPES = {
-  withdraw: {
-    'HyperliquidTransaction:Withdraw': [
-      { name: 'hyperliquidChain', type: 'string' },
-      { name: 'destination', type: 'string' },
-      { name: 'amount', type: 'string' },
-      { name: 'time', type: 'uint64' },
-    ],
-  },
-  usdSend: {
-    'HyperliquidTransaction:UsdSend': [
-      { name: 'hyperliquidChain', type: 'string' },
-      { name: 'destination', type: 'string' },
-      { name: 'amount', type: 'string' },
-      { name: 'time', type: 'uint64' },
-    ],
-  },
-} as const;
-
-const PHANTOM_AGENT_TYPES = {
-  Agent: [
-    { name: 'source', type: 'string' },
-    { name: 'connectionId', type: 'bytes32' },
-  ],
-} as const;
-
-// ── NONCE ────────────────────────────────────────────────────
-
-let lastNonce = 0n;
-
-export function getNextNonce(): bigint {
-  const now = BigInt(Date.now());
-  if (now <= lastNonce) {
-    lastNonce = lastNonce + 1n;
-  } else {
-    lastNonce = now;
-  }
-  return lastNonce;
-}
-
-// ── L1 ACTION HASH ──────────────────────────────────────────
-
-/**
- * Create the L1 action hash for the phantom agent pattern.
- *
- * Hash = keccak256(
- *   msgpack(action) +
- *   nonce_as_uint64_be +
- *   vault_marker(0x00 or 0x01 + address_bytes)
- * )
- */
-export function createL1ActionHash(args: {
-  action: Record<string, unknown> | unknown[];
-  nonce: number;
-  vaultAddress?: `0x${string}`;
-}): `0x${string}` {
-  const { action, nonce, vaultAddress } = args;
-
-  // 1. Encode action as msgpack (with large int → BigInt conversion)
-  const cleaned = removeUndefinedKeys(action as MsgpackValue);
-  const withBigInts = largeIntToBigInt(cleaned);
-  const actionBytes = encodeMsgpack(withBigInts);
-
-  // 2. Nonce as big-endian uint64
-  const nonceBytes = toUint64Bytes(nonce);
-
-  // 3. Vault address marker
-  const vaultMarker = vaultAddress
-    ? new Uint8Array([1])
-    : new Uint8Array([0]);
-  const vaultBytes = vaultAddress
-    ? hexToBytes(vaultAddress.slice(2))
-    : new Uint8Array();
-
-  // 4. Concatenate all bytes and keccak256
-  const bytes = concatBytes(actionBytes, nonceBytes, vaultMarker, vaultBytes);
-  return keccak256(bytes);
-}
-
-// ── SIGNER ───────────────────────────────────────────────────
-
-export class HyperliquidSigner {
-  private readonly isTestnet: boolean;
-
-  constructor(
-    private readonly walletClient: WalletClient,
-    isTestnet = false,
-  ) {
-    this.isTestnet = isTestnet;
-  }
-
-  /**
-   * Sign an L1 action (order, cancel, updateLeverage, etc.)
-   * using the phantom agent pattern.
-   */
-  async signAction(
-    action: Record<string, unknown>,
-    nonce?: bigint,
-    vaultAddress?: `0x${string}`,
-  ): Promise<{ signature: `0x${string}`; nonce: bigint }> {
-    const actionNonce = nonce ?? getNextNonce();
-    const nonceNumber = Number(actionNonce);
-
-    const account = this.walletClient.account;
-    if (!account) throw new Error('Wallet client has no account');
-
-    // Compute the L1 action hash (msgpack + keccak256)
-    const connectionId = createL1ActionHash({
-      action,
-      nonce: nonceNumber,
-      vaultAddress,
-    });
-
-    // Sign the phantom agent message
-    const signature = await this.walletClient.signTypedData({
-      account,
-      domain: HYPERLIQUID_DOMAIN,
-      types: PHANTOM_AGENT_TYPES,
-      primaryType: 'Agent' as const,
-      message: {
-        source: this.isTestnet ? 'b' : 'a',
-        connectionId,
-      },
-    });
-
-    return { signature, nonce: actionNonce };
-  }
-
-  /**
-   * Sign a user-signed action (withdraw3, usdSend, approveAgent, etc.)
-   * using the HyperliquidSignTransaction domain (chainId 42161).
-   *
-   * Unlike trading actions, these use direct EIP-712 typed data signing
-   * with action-specific types — NOT the phantom agent pattern.
-   */
-  async signUserAction(
-    actionType: keyof typeof USER_ACTION_TYPES,
-    message: Record<string, unknown>,
-  ): Promise<{ signature: `0x${string}` }> {
-    const account = this.walletClient.account;
-    if (!account) throw new Error('Wallet client has no account');
-
-    const types = USER_ACTION_TYPES[actionType];
-    const primaryType = Object.keys(types)[0] as string;
-
-    const signature = await this.walletClient.signTypedData({
-      account,
-      domain: HYPERLIQUID_USER_DOMAIN,
-      types: types as Record<string, readonly { name: string; type: string }[]>,
-      primaryType,
-      message,
-    });
-
-    return { signature };
-  }
-
-  /**
-   * Build and sign a withdraw3 action for withdrawing USDC from Hyperliquid to Arbitrum.
-   * Returns the complete payload ready to POST to /exchange.
-   *
-   * @param destination — The Arbitrum address to receive USDC
-   * @param amount — Amount as string (e.g., "10.0" for $10)
-   */
-  async signWithdraw(
-    destination: `0x${string}`,
-    amount: string,
-  ): Promise<{
-    action: Record<string, unknown>;
-    signature: { r: string; s: string; v: number };
-    nonce: number;
-  }> {
-    const timestamp = Date.now();
-
-    const message = {
-      hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
-      destination,
-      amount,
-      time: BigInt(timestamp),
-    };
-
-    const { signature } = await this.signUserAction('withdraw', message);
-
-    const action = {
-      type: 'withdraw3',
-      hyperliquidChain: this.isTestnet ? 'Testnet' : 'Mainnet',
-      signatureChainId: '0xa4b1', // Arbitrum chainId in hex
-      destination,
-      amount,
-      time: timestamp,
-    };
-
-    return {
-      action,
-      signature: {
-        r: signature.slice(0, 66),
-        s: `0x${signature.slice(66, 130)}`,
-        v: parseInt(signature.slice(130, 132), 16),
-      },
-      nonce: timestamp,
-    };
-  }
-
-  getAddress(): `0x${string}` {
-    const account = this.walletClient.account;
-    if (!account) throw new Error('Wallet client has no account');
-    return account.address;
-  }
-}
-
-// ── PRIVATE HELPERS ─────────────────────────────────────────
-
-function hexToBytes(hex: string): Uint8Array {
-  const bytes = new Uint8Array(hex.length / 2);
-  for (let i = 0; i < bytes.length; i++) {
-    bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
-  }
-  return bytes;
-}
-
-function concatBytes(...arrays: Uint8Array[]): Uint8Array {
-  const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
-  const result = new Uint8Array(totalLength);
-  let offset = 0;
-  for (const arr of arrays) {
-    result.set(arr, offset);
-    offset += arr.length;
-  }
-  return result;
-}

package/src/perp/types.ts

@@ -1,192 +0,0 @@
-/**
- * Hyperliquid Perp Trading Types
- *
- * Core type definitions for perp trading via Hyperliquid L1.
- * Fills are reported to the command center via WebSocket relay — no on-chain recording.
- */
-
-// ============================================================
-// CONFIG
-// ============================================================
-
-export interface PerpConfig {
-  enabled: boolean;
-  apiUrl: string;
-  wsUrl: string;
-  maxLeverage: number;
-  maxNotionalUSD: number;
-  allowedInstruments?: string[];
-}
-
-export const DEFAULT_PERP_CONFIG: PerpConfig = {
-  enabled: false,
-  apiUrl: 'https://api.hyperliquid.xyz',
-  wsUrl: 'wss://api.hyperliquid.xyz/ws',
-  maxLeverage: 10,
-  maxNotionalUSD: 50_000,
-};
-
-// ============================================================
-// SIGNALS
-// ============================================================
-
-export type PerpAction =
-  | 'open_long'
-  | 'open_short'
-  | 'close_long'
-  | 'close_short'
-  | 'hold';
-
-export interface PerpTradeSignal {
-  action: PerpAction;
-  instrument: string;
-  size: number;
-  price: number;
-  leverage: number;
-  orderType: 'limit' | 'market';
-  reduceOnly: boolean;
-  confidence: number;
-  reasoning?: string;
-}
-
-// ============================================================
-// POSITIONS & ACCOUNT
-// ============================================================
-
-export interface PerpPosition {
-  instrument: string;
-  assetIndex: number;
-  /** Positive = long, negative = short */
-  size: number;
-  entryPrice: number;
-  markPrice: number;
-  unrealizedPnl: number;
-  leverage: number;
-  marginType: 'cross' | 'isolated';
-  liquidationPrice: number;
-  notionalUSD: number;
-  marginUsed: number;
-}
-
-export interface AccountSummary {
-  totalEquity: number;
-  availableMargin: number;
-  totalMarginUsed: number;
-  totalUnrealizedPnl: number;
-  totalNotional: number;
-  maintenanceMargin: number;
-  effectiveLeverage: number;
-  cashBalance: number;
-}
-
-// ============================================================
-// FILLS & MARKET DATA
-// ============================================================
-
-export interface PerpFill {
-  oid: number;
-  coin: string;
-  /** B = buy (long), A = ask/sell (short) */
-  side: 'B' | 'A';
-  px: string;
-  sz: string;
-  fee: string;
-  time: number;
-  hash: string;
-  isMaker: boolean;
-  builderFee?: string;
-  liquidation?: boolean;
-}
-
-export interface PerpMarketData {
-  instrument: string;
-  midPrice: number;
-  bestBid: number;
-  bestAsk: number;
-  funding8h: number;
-  openInterest: number;
-  volume24h: number;
-  priceChange24h: number;
-}
-
-// ============================================================
-// ORDER RESULTS
-// ============================================================
-
-export interface OrderResult {
-  success: boolean;
-  orderId?: number;
-  status: 'filled' | 'resting' | 'error';
-  avgPrice?: string;
-  filledSize?: string;
-  error?: string;
-}
-
-// ============================================================
-// RAW HYPERLIQUID API TYPES
-// ============================================================
-
-export interface AssetMeta {
-  name: string;
-  szDecimals: number;
-  maxLeverage: number;
-  onlyIsolated: boolean;
-}
-
-export interface ClearinghouseState {
-  assetPositions: AssetPosition[];
-  crossMarginSummary: {
-    accountValue: string;
-    totalNtlPos: string;
-    totalRawUsd: string;
-    totalMarginUsed: string;
-  };
-}
-
-export interface AssetPosition {
-  position: {
-    coin: string;
-    szi: string;
-    entryPx: string;
-    positionValue: string;
-    unrealizedPnl: string;
-    liquidationPx: string | null;
-    marginUsed: string;
-    leverage: { type: string; value: string } | null;
-  };
-}
-
-export interface HyperliquidFill {
-  coin: string;
-  px: string;
-  sz: string;
-  side: 'B' | 'A';
-  time: number;
-  startPosition: string;
-  dir: string;
-  closedPnl: string;
-  hash: string;
-  oid: number;
-  crossed: boolean;
-  fee: string;
-  tid: number;
-  builderFee?: string;
-  liquidation?: boolean;
-}
-
-export interface HyperliquidOrder {
-  coin: string;
-  side: 'B' | 'A';
-  limitPx: string;
-  sz: string;
-  oid: number;
-  timestamp: number;
-  origSz: string;
-  cloid: string | null;
-}
-
-export interface L2Book {
-  coin: string;
-  levels: Array<Array<{ px: string; sz: string; n: number }>>;
-  time: number;
-}