Definisi
Sebuah akun induk bisa menyetujui dompet API untuk menandatangani atas namanya sendiri atau untuk sub-akun mana pun miliknya. Dompet itu hanya dipakai untuk menandatangani: data akun harus ditanyakan dengan alamat sungguhan akunnya, dan dokumentasinya menyebut menanyakan alamat agen sebagai jebakan yang umum, sebab yang kembali adalah hasil kosong, bukan sebuah kesalahan. Satu akun bisa memegang satu dompet disetujui tanpa nama dan sampai tiga yang bernama, dengan dua agen bernama lagi untuk setiap sub-akun, dan kedaluwarsa yang diatur dengan valid_until paling jauh 180 hari ke depan.
Apa yang bisa dan tidak bisa dilakukan kunci semacam itu diukur, bukan dikira-kira. Pada 28 September 2026, di mainnet, sebuah akun uji menyetujui agen baru untuk satu jam dan memintanya menandatangani setiap tindakan yang memindahkan uang sebesar 1.000 USDC melawan saldo sekitar 60, jadi tidak ada yang bisa berpindah dan hanya alasan tiap jawabannya yang dihitung. Ditolak pada penanda tangan: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, sebuah approveAgent kedua dan approveBuilderFee, sementara akunnya sendiri justru bertemu kesalahan saldo. Diterima: memasang dan membatalkan order. Dan satu perpindahan dana diterima, vaultTransfer, yang dengannya 5 USDC bertanda tangan kunci agen sampai ke sebuah vault Hyperliquid.
Satu peringatan operasional melekat pada definisi ini. Nonce dilacak per penanda tangan, dan keadaan nonce sebuah dompet API bisa dipangkas ketika dompet itu dicabut pendaftarannya oleh persetujuan dompet baru, ketika ia kedaluwarsa, atau ketika akun yang mendaftarkannya tidak lagi punya dana. Dokumentasinya menyebut tindakan yang sudah ditandatangani sebelumnya lalu bisa diputar ulang, dan sangat menyarankan agar alamat agen tidak pernah dipakai dua kali: buatlah yang baru.
Dalam susunan kami sendiri, kunci agen tinggal di komputer, tersegel di disk di bawah sebuah sandi dan dipegang di memori oleh penjaga hanya selama ia terbuka. Penjaga menandatangani daftar tertutup tindakan trading dan tidak lebih, kuncinya kedaluwarsa sendiri dengan peringatan 30, 14, 7, 3 dan 1 hari sebelumnya, dan lpa agent revoke memensiunkannya dengan dompet Anda. Tidak ada berkas di komputer yang menghentikan pencuri yang memegang kunci sekaligus sandinya, jadi batas yang benar-benar bertahan adalah akunnya: isinya adalah paling banyak yang bisa hilang.
Contoh
Sebuah contoh, dalam angka bulat. Akun yang berisi 1.000 USDC menyetujui satu kunci agen, dengan kedaluwarsa 180 hari ke depan, yaitu langit-langit yang diizinkan Hyperliquid. Kunci itu bisa membuka dan menutup posisi melawan 1.000 USDC tersebut dan menetapkan leverage serta mode margin sebuah pasar; ia tidak bisa menarik sesen pun darinya, mengirimnya ke alamat lain atau memindahkannya antara saldo spot dan saldo perpetual. Seluruh yang bisa dijangkaunya adalah 1.000 USDC itu, dan itulah sebabnya akun khusus adalah batas yang benar-benar berarti.