dsh-hyperliquid 0.0.1 → 0.2.0

package/cordis.patch.yml

@@ -0,0 +1,7 @@
+- insert:
+    - id: hyperliquid
+      name: dsh-hyperliquid
+      config:
+        dataDir: '~/.dsh-hyperliquid'
+        network: mainnet
+        tradingMode: live

package/icon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200">
+  <!-- Official Hyperliquid mark (brand kit "Hyperliquid SVG format.zip",
+       Hyperliquid_Blob_Green.svg) on the official brand-dark plate.
+       Source: https://hyperliquid.gitbook.io/hyperliquid-docs/brand-kit -->
+  <rect width="200" height="200" rx="44" fill="#011916"/>
+  <path d="M175.11589,99.27891c0,49.46366-30.3687,65.33789-46.47302,51.30413-13.11357-11.5031-17.02471-35.88989-36.81018-38.42055-25.07698-2.99085-27.37764,30.36839-43.94216,30.36839-19.3254,0-23.00642-27.83773-23.00642-42.33179,0-14.72405,4.14115-34.73961,20.47565-34.73961,19.09528,0,20.24566,28.75802,44.17226,27.14754,23.69661-1.61047,24.1567-31.51877,39.80103-44.17224,13.57335-11.27313,45.78283.69019,45.78283,50.84413Z" fill="#97fce4"/>
+</svg>

package/index.js

@@ -0,0 +1,118 @@
+/**
+ * dsh-hyperliquid — host half.
+ *
+ * Publishes the `hyper` Remote namespace (Typert, dsh-bots-anchored), registers
+ * the hyper_* agent tools, and contributes a short system-prompt section so
+ * agents in any session know the trading desk exists and how to drive it.
+ * The client half (client.js) renders the peer-level trading platform.
+ *
+ * @module dsh-hyperliquid
+ */
+
+import { HyperRemote } from './lib/remote.js'
+import { buildToolDefinitions } from './lib/tools.js'
+import { registerHyperSkill } from './lib/skill.js'
+
+export const name = 'dsh-hyperliquid'
+
+/** Optional services only: without `tools` the desk still serves the UI. */
+export const inject = []
+
+let z = null
+try {
+  // Prefer the HOST's schemastery copy (same implementation the loader
+  // validates with) resolved through the dsh-bin anchor; fall back to the
+  // bundled copy. require(esm) — Node ≥ 22.12.
+  const { createRequire } = await import('node:module')
+  const { realpathSync } = await import('node:fs')
+  try {
+    const anchor = realpathSync(process.argv?.[1] ?? '')
+    z = createRequire(anchor)('@deepseek-ai/schemastery')
+    if (!z || typeof z.object !== 'function') z = null
+  } catch { /* anchor unavailable → bundled copy */ }
+  if (!z) z = (await import('@deepseek-ai/schemastery')).default
+} catch (err) {
+  throw new Error(`[dsh-hyperliquid] schemastery 加载失败：${String(err?.message ?? err)}`)
+}
+
+export const Config = z.object({
+  dataDir: z.string().description('插件数据目录（交易会话登记表与 paper 账户落盘处）').default('~/.dsh-hyperliquid'),
+  network: z.union([z.const('mainnet'), z.const('testnet')]).description('Hyperliquid 网络，默认 mainnet；testnet 可在交易台「更多」中切换').default('mainnet'),
+  tradingMode: z.union([z.const('paper'), z.const('live')]).description('交易模式：live 真实签名下单（默认），paper 本地撮合；可在交易台「更多」中切换').default('live'),
+  privateKey: z.string().description('Hyperliquid 钱包私钥（signer=local 时使用；建议用 agent wallet 派生密钥；留空则 live 不可用）。也可用环境变量 HYPERLIQUID_PRIVATE_KEY').default(''),
+  signer: z.union([z.const('local'), z.const('web3')]).description('签名方式：local 插件内私钥签名；web3 交给 dsh-web3 钱包保险库签名（私钥不出保险库，逐笔过签名策略与审批）').default('local'),
+  web3Account: z.string().description('signer=web3 时使用的 dsh-web3 账户 id 或名称').default('main'),
+  tradingAddress: z.string().description('Hyperliquid 主账户地址；使用 dsh-web3 API wallet 签名时必填，账户查询必须用主账户地址').default(''),
+  autonomousLive: z.boolean().description('允许 agent 在硬性限额内自主提交 live 订单；默认关闭，且仅支持 dsh-web3 签名').default(false),
+  allowedCoins: z.string().description('交易限额（paper/live 均生效）：允许新开仓的币对，逗号分隔；减仓不受限').default('BTC,ETH'),
+  maxOrderUsd: z.number().description('交易限额（paper/live 均生效）：单笔名义价值上限 USD').default(100),
+  maxDailyUsd: z.number().description('交易限额（paper/live 均生效）：每 UTC 日累计开仓名义价值上限 USD，paper 与 live 分账').default(500),
+  maxPositionUsd: z.number().description('交易限额（paper/live 均生效）：每币最大仓位名义价值 USD').default(500),
+  maxLeverage: z.number().description('交易限额（paper/live 均生效）：最大杠杆倍数').default(2),
+}).description('Hyperliquid 交易台配置')
+
+/**
+ * @param ctx - the Cordis plugin context.
+ * @param config - validated row config.
+ */
+export function apply(ctx, config = {}) {
+  const remote = new HyperRemote(ctx, config)
+  const disposers = []
+
+  // Live channel lifecycle: stop the upstream WS on teardown.
+  ctx.effect(() => () => remote.stopWs())
+
+  // Agent tools (optional service — degrade gracefully).
+  const tools = typeof ctx?.get === 'function' ? ctx.get('tools') : undefined
+  if (tools && typeof tools.register === 'function') {
+    for (const def of buildToolDefinitions(remote)) {
+      const remove = tools.register(def)
+      disposers.push(remove)
+      ctx.effect(() => () => { try { remove() } catch { /* already gone */ } })
+    }
+  } else {
+    ctx.logger?.warn?.('[dsh-hyperliquid] tools 服务不可用，仅提供 UI 远端')
+  }
+
+  const skillRemove = registerHyperSkill(typeof ctx?.get === 'function' ? ctx.get('skills') : null)
+  if (skillRemove) {
+    disposers.push(skillRemove)
+    ctx.effect(() => () => { try { skillRemove() } catch { /* already gone */ } })
+  }
+
+  // System-prompt section: make the desk discoverable to every agent, with
+  // LIVE desk context (what the user is looking at right now) evaluated per
+  // prompt — the desk and the conversation stay in lockstep both ways.
+  const systemPrompt = typeof ctx?.get === 'function' ? ctx.get('systemPrompt') : undefined
+  if (systemPrompt && typeof systemPrompt.section === 'function') {
+    const remove = systemPrompt.section({
+      name: 'hyperliquid-desk',
+      order: 500,
+      text: () => {
+        const mode = remote.cfg.tradingMode
+        const net = remote.cfg.network
+        const lines = [
+          '## Hyperliquid 交易台（dsh-hyperliquid）',
+          `本 Harness 装有 Hyperliquid 交易台（mode=${mode}，network=${net}）。用户可在面板看行情并填写交易票据；票据只把意图送入当前会话，所有实际下单只能由你调用工具完成。`,
+          '可用工具：hyper_context（会话交易上下文）、hyper_market（详细行情）、hyper_chart（在行情图上画支撑/阻力与趋势线）、hyper_account（账户）、hyper_decide（交易决策预检并返回一次性 decisionId）、hyper_order（执行/撤单/杠杆）、hyper_session（会话视角）。',
+          '用户说"当前/界面上这个币"时，先 hyper_context 或 hyper_session status；需要技术判断时用 hyper_market indicators 验证趋势、动量、波动和支撑阻力，可用 hyper_chart 将依据画给用户看。交易前核对行情与账户，说明方向、数量、依据及风险。paper 模式用 hyper_order 执行；live 模式先用 hyper_decide 预检，并用返回的一次性 decisionId 执行 hyper_order。是否可自主执行由宿主配置和钱包策略决定。',
+        ]
+        if (skillRemove) lines.push('复杂的 Hyperliquid 分析、交易或异常对账，请先加载 hyperliquid-trading skill。')
+        // Live desk focus: what coin/interval the desk shows right now.
+        try {
+          const desk = remote.desk ?? {}
+          if (desk.coin) lines.push(`当前交易台焦点：${desk.coin} · K线 ${desk.interval ?? '15m'}。用户消息里说"这个币/当前价格/图上"时指的就是它。`)
+        } catch { /* desk context is best-effort */ }
+        return lines.join('\n')
+      },
+    })
+    disposers.push(remove)
+  }
+
+  return () => {
+    for (const d of disposers) {
+      try { d() } catch { /* best effort */ }
+    }
+    remote.stopWs()
+  }
+}

package/lib/chart-drawings.d.ts

@@ -0,0 +1,23 @@
+export type DrawingKind = 'level' | 'hray' | 'vline' | 'text' | 'trend' | 'ray' | 'extended' | 'fib' | 'rect' | 'measure' | 'channel' | 'long' | 'short' | 'fibext' | 'fibchannel' | 'fibtime' | 'gannfan' | 'pitchfork' | 'regression' | 'arrow' | 'callout' | 'circle' | 'triangle' | 'brush' | 'crossline' | 'pricelabel' | 'infoline' | 'trendangle' | 'pricerange' | 'daterange' | 'elliott' | 'elliottabc' | 'xabcd' | 'abcd' | 'headshoulders' | 'gannbox' | 'gannsquare' | 'schiff' | 'modschiff' | 'icon'
+export type LineStyleName = 'solid' | 'dashed' | 'dotted'
+export interface DrawingStyle { color?: string; lineWidth?: number; lineStyle?: LineStyleName; locked?: boolean; hidden?: boolean; shared?: boolean; alert?: boolean }
+export declare const DRAWING_POINTS: Record<DrawingKind, number>
+export declare const DRAWING_KINDS: DrawingKind[]
+export declare const DRAWING_CLICKS: Record<DrawingKind, number>
+export declare const LINE_STYLES: LineStyleName[]
+export declare function drawingStyle(request: unknown): DrawingStyle
+export declare const FIB_LEVELS: number[]
+export declare function drawingGeometry(kind: string, request: unknown, now?: number): Record<string, unknown>
+export declare const BRUSH_MIN: number
+export declare const BRUSH_MAX: number
+export declare const TEXT_KINDS: DrawingKind[]
+export declare const FIB_EXT_LEVELS: number[]
+export declare const FIB_TIME_SERIES: number[]
+export declare const GANN_RATIOS: Array<[number, number]>
+export declare const ICON_NAMES: string[]
+export declare const GANN_BOX_LEVELS: number[]
+export declare const STICKERS: Record<'trading' | 'faces' | 'symbols', string[]>
+export declare function isIconLabel(label: unknown): boolean
+export declare const ALERT_KINDS: DrawingKind[]
+export declare function linePriceAt(mark: unknown, time: number): number | null
+export declare function isSingleEmoji(value: unknown): boolean

package/lib/chart-drawings.js

@@ -0,0 +1,159 @@
+/**
+ * dsh-hyperliquid — chart drawing kinds shared by the host (validation, the
+ * hyper_chart tool) and the browser chart (tools menu, rendering).
+ *
+ * level / trend keep their original flat fields (price; fromTime…toPrice);
+ * every other kind stores `points: [{ time, price }]` in click order.
+ * @module lib/chart-drawings
+ */
+
+/** kind → number of anchor points (level: a price only). */
+export const DRAWING_POINTS = {
+  level: 1, hray: 1, vline: 1, text: 1, trend: 2, ray: 2, extended: 2, fib: 2, rect: 2, measure: 2, channel: 3,
+  // Positions store [entry, stop, target]; the desk creates them with 2 clicks (target defaults to 2R).
+  long: 3, short: 3,
+  // Fibonacci family, Gann, pitchfork, regression.
+  fibext: 3, fibchannel: 3, fibtime: 2, gannfan: 2, pitchfork: 3, regression: 2,
+  // Annotation and shapes. brush is freehand: 0 = variable (BRUSH_MIN..BRUSH_MAX points).
+  arrow: 2, callout: 2, circle: 2, triangle: 3, brush: 0,
+  // More lines and measures: cross line, price label, info line, trend angle, price-only and date-only ranges.
+  crossline: 1, pricelabel: 1, infoline: 2, trendangle: 2, pricerange: 2, daterange: 2,
+  // Advanced: Elliott waves, harmonic / chart patterns, Gann box & square, pitchfork variants, icons.
+  elliott: 6, elliottabc: 4, xabcd: 5, abcd: 4, headshoulders: 7,
+  gannbox: 2, gannsquare: 2, schiff: 3, modschiff: 3, icon: 1,
+}
+/** Icon stickers (the drawing's label holds the icon name). */
+export const ICON_NAMES = ['flag', 'star', 'up', 'down', 'warning', 'check', 'cross', 'fire', 'target', 'bell', 'pin', 'clock', 'dollar', 'shield', 'bolt', 'heart', 'question', 'info']
+/** Sticker library (TradingView's emoji stickers): category → emoji. An icon label is a name or `emoji:<char>`. */
+export const STICKERS = {
+  trading: ['📈', '📉', '💰', '💸', '🚀', '🎯', '🔥', '💎', '🐂', '🐻', '🐋', '🚨', '🔔', '⏰', '📌', '🧭', '🛑', '🏦', '⚖️', '🪙'],
+  faces: ['😀', '😂', '😎', '🤔', '😱', '😭', '😡', '🥳', '🤯', '🙏', '👍', '👎', '👀', '💪', '🫡', '🤝'],
+  symbols: ['⭐', '❗', '❓', '💡', '🔒', '🔓', '⛔', '🟢', '🔴', '🟡', '⬆️', '⬇️', '↗️', '↘️', '🏁', '🎉', '✅', '❌', '⚠️', '♻️', '⏸️', '▶️'],
+}
+const STICKER_SET = new Set(Object.values(STICKERS).flat())
+/** Whether an icon drawing's label names a built-in icon or a library sticker. */
+export function isIconLabel(label) {
+  if (ICON_NAMES.includes(label)) return true
+  if (typeof label !== 'string' || !label.startsWith('emoji:')) return false
+  const emoji = label.slice(6)
+  return STICKER_SET.has(emoji) || isSingleEmoji(emoji)
+}
+
+/** Any one emoji (a single grapheme that is pictographic, or a regional-indicator flag), so the whole emoji set works as stickers. */
+export function isSingleEmoji(value) {
+  if (typeof value !== 'string' || !value || value.length > 32 || !/\p{Extended_Pictographic}|\p{Regional_Indicator}/u.test(value)) return false
+  return [...new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(value)].length === 1
+}
+/** Gann box divisions on both axes (TradingView defaults). */
+export const GANN_BOX_LEVELS = [0, 0.25, 0.382, 0.5, 0.618, 0.75, 1]
+/** Drawings a price can cross: alerts fire when the mid price crosses them (once, like TradingView). */
+export const ALERT_KINDS = ['level', 'hray', 'trend', 'ray', 'extended']
+
+/** The line's price at `time`, or null when the drawing does not exist at that time. */
+export function linePriceAt(mark, time) {
+  if (mark.kind === 'level') return Number(mark.price)
+  const [a, b] = mark.kind === 'trend'
+    ? [{ time: mark.fromTime, price: mark.fromPrice }, { time: mark.toTime, price: mark.toPrice }]
+    : mark.points ?? []
+  if (!a) return null
+  if (mark.kind === 'hray') return time >= a.time ? a.price : null
+  if (!b || b.time === a.time) return null
+  if (mark.kind === 'trend' && (time < Math.min(a.time, b.time) || time > Math.max(a.time, b.time))) return null
+  if (mark.kind === 'ray' && (time - a.time) * (b.time - a.time) < 0) return null
+  return a.price + (b.price - a.price) * (time - a.time) / (b.time - a.time)
+}
+
+export const BRUSH_MIN = 2
+export const BRUSH_MAX = 500
+/** Kinds whose label is free text shown on the chart (up to 200 characters). */
+export const TEXT_KINDS = ['text', 'callout']
+/** Clicks that create a drawing when they differ from its stored anchor count. */
+export const DRAWING_CLICKS = { ...Object.fromEntries(Object.entries(DRAWING_POINTS)), long: 2, short: 2 }
+export const DRAWING_KINDS = Object.keys(DRAWING_POINTS)
+/** Fibonacci retracement levels (0 = second point, 1 = first point, as in TradingView). */
+export const FIB_LEVELS = [0, 0.236, 0.382, 0.5, 0.618, 0.786, 1]
+/** Trend-based Fibonacci extension levels (projected from the third point, TradingView defaults). */
+export const FIB_EXT_LEVELS = [0, 0.382, 0.618, 1, 1.272, 1.618, 2, 2.618]
+/** Fibonacci time zones: bar multiples of the first two points' spacing. */
+export const FIB_TIME_SERIES = [0, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
+/** Gann fan angles as price/time ratios relative to the 1×1 line. */
+export const GANN_RATIOS = [[1, 8], [1, 4], [1, 3], [1, 2], [1, 1], [2, 1], [3, 1], [4, 1], [8, 1]]
+
+const OLDEST = Date.UTC(2015, 0, 1)
+
+/**
+ * Validate the geometry of one drawing request (throws on invalid input).
+ * @returns the geometry fields to persist for that kind.
+ */
+export function drawingGeometry(kind, request, now = Date.now()) {
+  if (!DRAWING_KINDS.includes(kind)) throw new Error(`画线类型必须为 ${DRAWING_KINDS.join('/')}`)
+  const latest = now + 365 * 86_400_000
+  const point = (time, price, label) => {
+    const t = Number(time), p = Number(price)
+    if (!Number.isFinite(t) || t < OLDEST || t > latest) throw new Error(`${label}时间必须为 2015 年至今后一年内的毫秒时间戳`)
+    if (!Number.isFinite(p) || p <= 0) throw new Error(`${label}价格必须为正数`)
+    return { time: t, price: p }
+  }
+  if (kind === 'level') {
+    const price = Number(request?.price)
+    if (!Number.isFinite(price) || price <= 0) throw new Error('水平线 price 必须为正数')
+    return { price }
+  }
+  if (kind === 'trend') {
+    const from = point(request?.fromTime, request?.fromPrice, '趋势线起点')
+    const to = point(request?.toTime, request?.toPrice, '趋势线终点')
+    if (to.time <= from.time) throw new Error('趋势线终点时间必须晚于起点')
+    return { fromTime: from.time, fromPrice: from.price, toTime: to.time, toPrice: to.price }
+  }
+  const need = DRAWING_POINTS[kind]
+  const raw = request?.points
+  if (kind === 'brush') {
+    if (!Array.isArray(raw) || raw.length < BRUSH_MIN || raw.length > BRUSH_MAX) throw new Error(`brush 需要 ${BRUSH_MIN}-${BRUSH_MAX} 个 points`)
+  } else if (!Array.isArray(raw) || raw.length !== need) throw new Error(`${kind} 需要 ${need} 个 points（{ time, price }）`)
+  const points = raw.map((item, index) => point(item?.time, item?.price, `第 ${index + 1} 个点`))
+  if (['trend', 'ray', 'extended', 'channel', 'fibchannel', 'gannfan', 'regression', 'fibtime', 'infoline', 'trendangle'].includes(kind) && points[0].time === points[1].time) throw new Error('前两个点的时间不能相同')
+  if ((kind === 'regression' || kind === 'fibtime' || kind === 'gannfan') && points[1].time < points[0].time) throw new Error('第二个点必须晚于第一个点')
+  if (kind === 'long' || kind === 'short') {
+    const [entry, stop, target] = points.map((item) => item.price)
+    const ok = kind === 'long' ? stop < entry && entry < target : target < entry && entry < stop
+    if (!ok) throw new Error(kind === 'long' ? '多头头寸需要 止损 < 入场 < 止盈' : '空头头寸需要 止盈 < 入场 < 止损')
+    if (points[1].time <= points[0].time) throw new Error('头寸右边界时间必须晚于入场时间')
+  }
+  return { points }
+}
+
+const COLOR = /^#[0-9a-fA-F]{6}$/
+export const LINE_STYLES = ['solid', 'dashed', 'dotted']
+
+/** Validate optional appearance fields; absent keys are left untouched. */
+export function drawingStyle(request) {
+  const style = {}
+  if (request?.color != null) {
+    if (typeof request.color !== 'string' || !COLOR.test(request.color)) throw new Error('画线颜色必须为 #RRGGBB')
+    style.color = request.color.toLowerCase()
+  }
+  if (request?.lineWidth != null) {
+    const width = Number(request.lineWidth)
+    if (!Number.isInteger(width) || width < 1 || width > 4) throw new Error('线宽必须为 1-4 的整数')
+    style.lineWidth = width
+  }
+  if (request?.lineStyle != null) {
+    if (!LINE_STYLES.includes(request.lineStyle)) throw new Error(`线型必须为 ${LINE_STYLES.join('/')}`)
+    style.lineStyle = request.lineStyle
+  }
+  for (const flag of ['shared', 'alert']) {
+    if (request?.[flag] == null) continue
+    if (typeof request[flag] !== 'boolean') throw new Error(`${flag} 必须为布尔值`)
+    style[flag] = request[flag]
+  }
+  if (style.alert && request?.kind != null && !ALERT_KINDS.includes(request.kind)) throw new Error(`只有 ${ALERT_KINDS.join('/')} 支持价格提醒`)
+  if (request?.hidden != null) {
+    if (typeof request.hidden !== 'boolean') throw new Error('hidden 必须为布尔值')
+    style.hidden = request.hidden
+  }
+  if (request?.locked != null) {
+    if (typeof request.locked !== 'boolean') throw new Error('locked 必须为布尔值')
+    style.locked = request.locked
+  }
+  return style
+}