diff --git a/docs/ability/official-abilities/hyperliquid.mdx b/docs/ability/official-abilities/hyperliquid.mdx new file mode 100644 index 000000000..924da457b --- /dev/null +++ b/docs/ability/official-abilities/hyperliquid.mdx @@ -0,0 +1,5 @@ +--- +title: Hyperliquid Automation +--- + +Placeholder for now. diff --git a/docs/concepts/hyperliquid/about.mdx b/docs/concepts/hyperliquid/about.mdx new file mode 100644 index 000000000..dae3e48e0 --- /dev/null +++ b/docs/concepts/hyperliquid/about.mdx @@ -0,0 +1,191 @@ +--- +title: 'Hyperliquid Automation' +--- + +Vincent enables prop traders, DEX aggregators, and exchanges to automate Hyperliquid trading with complete non-custodial control. + +## The Manual Approval Bottleneck + +Trading strategies generate signals 24/7. Manual approvals don't. + + + + Your algorithm identifies a profitable trade + + + User must manually approve the transaction + + + They're offline, asleep, or in a different timezone + + + **Opportunity expires. Trade not executed.** + + + + + Manual signature requirements limit execution speed and trading volume. Vincent eliminates this bottleneck. + + +## Enter Vincent Agent Wallets + +Vincent Agent Wallets provide non-custodial delegation infrastructure for Hyperliquid. Users grant scoped trading permissions to your application once - you build the automation logic, Vincent handles secure execution while users maintain complete asset control. + +Think of it as delegation infrastructure: users set boundaries, you build strategies that operate within them automatically. + + + ```jsx Before Vincent + // Multiple signatures per trade + await hyperliquid.approve(order) // User must sign + await hyperliquid.placeOrder(order) // User must sign + await hyperliquid.confirm(order) // User must sign + // Limited to user availability + ``` + ```jsx With Vincent + // One-time delegation, your automation runs continuously + await hyperliquidAbilityClient.execute({ + order: { + asset: 0, + orderType: { limit: { tif: "Gtc" } }, + ... +}, +{ delegatorAddress } +}) + // Your application executes without additional signatures + ``` + + +## How It Works + + + + User approves scoped delegation - defining exactly which actions your app can perform on Hyperliquid + + + Your application logic executes trades programmatically without requiring additional signatures + + + Users can monitor activity, adjust permissions, or revoke access anytime + + + + + Users delegate once. Your automation runs continuously. + + +## Why Trading Operations Choose Vincent + + + + **The Problem:** Manual signatures create latency between signal generation and execution + + **With Vincent:** + - Build automation that executes trades immediately when signals fire + - Operate across all timezones and market hours + - Scale to hundreds of daily transactions per user + - No waiting for user availability + + **Result:** Capture more opportunities, eliminate timing-based slippage + + + + **The Problem:** Traditional delegation requires custody handoff or private key sharing + + **With Vincent:** + - Users never transfer asset custody + - Scoped permissions with explicit boundaries + - Full transaction auditability on-chain + - Instant revocation capability + + **Result:** Build automation without compliance risk + + + + **The Problem:** Building delegation infrastructure is time-consuming + + **With Vincent:** + - Delegation infrastructure handled for you + - TypeScript SDK for building execution logic + - Optional smart contract policies for custom delegation permissions + - Focus on strategy, not infrastructure + + **Result:** Build automated strategies faster + + + +## What You Can Build + +Build sophisticated trading automation on Hyperliquid that would be impractical with manual approvals: + + + + Hummingbot or Telegram bots for automated strategy execution + + + Cron-based execution for timed trades and rebalancing + + + Mirror successful traders' positions in real-time + + + + + + Execute trades automatically based on custom signals + + + Automated rebalancing and risk management + + + Continuous liquidity provision and spread management + + + +## Integration + + + This is an example. I'll change it when writing the Hyperliquid ability page. + + + + + ```bash + npm install @vincent/sdk + ``` + + + + ```jsx + import { createAbilityClient } from '@vincent/sdk' + + const hyperliquidAbilityClient = await createAbilityClient({ + protocol: 'hyperliquid', + // Configuration details + }) + ``` + + + + ```jsx + // Your automation logic + await hyperliquidAbilityClient.execute({ + order: { + asset: 0, + orderType: { limit: { tif: "Gtc" } }, + isBuy: true, + limitPx: "2000", + sz: "1" + }, + { delegatorAddress: user.address } + }) + ``` + + + +## The Bottom Line + +Manual approval processes don't scale. Vincent provides the infrastructure to build trading automation that executes at machine speed while users sleep - without asking them to trust you with their assets. + + + View Hyperliquid ability documentation + diff --git a/docs/docs.json b/docs/docs.json index 3293fbf01..f3b099263 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -28,7 +28,8 @@ "concepts/wallets/user-accounts", "concepts/wallets/agent-wallets" ] - } + }, + "concepts/hyperliquid/about" ] } ]