Tanım
Bir ana hesap, kendi adına ya da alt hesaplarından herhangi biri için imzalamak üzere API cüzdanlarını onaylayabilir. Bunlar yalnızca imzalamak için kullanılır: hesap verisi, hesabın gerçek adresiyle sorgulanmalıdır ve belgeler ajan adresini sorgulamayı yaygın bir tuzak olarak anar, çünkü bu bir hata değil boş bir sonuç döndürür. Bir hesap, adı olmayan tek bir onaylı cüzdan ile adlandırılmış en çok üç cüzdan tutabilir, her alt hesap için iki adlandırılmış ajan daha serbesttir ve valid_until ile belirlenen bitiş en çok 180 gün ileride olabilir.
Böyle bir anahtarın neyi yapabildiği ve neyi yapamadığı varsayılmadı, ölçüldü. 28 Eylül 2026'da, ana ağda, bir test hesabı bir saat için yeni bir ajan onayladı ve ona para hareket ettiren her eylemi 1.000 USDC üzerinden, yaklaşık 60 bakiyeye karşı imzalattı; böylece hiçbir şey hareket edemedi ve yalnızca her yanıtın nedeni sayıldı. İmzalayanda reddedildi: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, ikinci bir approveAgent ve approveBuilderFee; hesabın kendisi bunların yerine bir bakiye hatasıyla karşılaştı. Kabul edildi: emir vermek ve iptal etmek. Ve bir fon hareketi kabul edildi, vaultTransfer: ajan anahtarıyla imzalanan 5 USDC bir Hyperliquid kasasına ulaştı.
Tanımın yanında işletmeye dair bir uyarı da durur. Nonce'lar her imzalayan için ayrı izlenir ve bir API cüzdanının nonce durumu, yeni bir cüzdanın onaylanmasıyla kaydı silindiğinde, süresi bittiğinde ya da onu kaydeden hesapta artık para kalmadığında budanabilir. Belgeler, daha önce imzalanmış eylemlerin o zaman yeniden oynatılabileceğini söyler ve bir ajan adresinin asla yeniden kullanılmamasını güçlü biçimde salık verir: yerine yenisini üretin.
Bizim düzenimizde ajan anahtarı bilgisayarda yaşar, diskte bir parolanın altında mühürlüdür ve muhafız onu yalnızca kilidi açıkken bellekte tutar. Muhafız kapalı bir işlem eylemleri listesini imzalar, başka hiçbir şeyi; anahtar 30, 14, 7, 3 ve 1 gün önceden uyarılarla kendi kendine sona erer ve lpa agent revoke onu cüzdanınızla birlikte emekliye çıkarır. Bilgisayardaki hiçbir dosya, hem anahtarı hem parolasını elinde tutan bir hırsızı durdurmaz; dolayısıyla tutan sınır hesabın kendisidir: içinde ne varsa, kaybedilebilecek en çok şey odur.
Örnek
Yuvarlak sayılarla bir örnek. 1.000 USDC ile fonlanan bir hesap, bitişi 180 gün ileride olan tek bir ajan anahtarı onaylar; bu, Hyperliquid'in izin verdiği üst tavandır. O anahtar, 1.000 USDC karşısında pozisyon açıp kapatabilir ve bir piyasanın kaldıracını ve marj kipini belirleyebilir; oradan tek kuruş çekemez, başka bir adrese gönderemez, spot ile perpetual bakiyeleri arasında kaydıramaz. Uzanabildiği her şey o 1.000 USDC'dir; işte bu yüzden ayrı bir hesap, önemli olan sınırdır.