التعريف
يستطيع الحساب الرئيسي أن يوافق على محافظ API لتوقّع بالنيابة عنه أو عن أي من حساباته الفرعية. وهي لا تُستعمل إلا للتوقيع: فبيانات الحساب يجب أن تُطلب بالعنوان الحقيقي للحساب، وتسمّي الوثائق الطلب بعنوان الوكيل مزلقًا شائعًا، لأنه يعيد نتيجة فارغة لا خطأ. ويستطيع الحساب أن يحمل محفظة واحدة موافَقًا عليها بلا اسم وثلاثًا بأسماء على الأكثر، مع وكيلين مسمّيين إضافيين لكل حساب فرعي، وأقصى انتهاء يُضبط بـ valid_until هو 180 يومًا من الآن.
ما يستطيع مثل هذا المفتاح فعله وما لا يستطيعه قِيس ولم يُفترض. ففي 28 سبتمبر 2026، على الشبكة الرئيسية، وافق حساب اختبار على وكيل جديد لساعة واحدة، وجعله يوقّع كل فعل يحرّك المال بمبلغ 1,000 USDC في مقابل رصيد نحو 60، فلم يكن شيء ليتحرك، ولم يبق إلا سبب كل جواب. المرفوض على هذا الموقّع: withdraw3 وusdSend وspotSend وsendAsset وusdClassTransfer وapproveAgent ثانٍ وapproveBuilderFee، حيث لقي الحساب نفسه خطأ رصيد بدلًا من ذلك. والمقبول: وضع أمر وإلغاؤه. وقُبلت حركة أموال واحدة، vaultTransfer، وبها وصلت 5 USDC موقّعة بمفتاح الوكيل إلى خزينة في Hyperliquid.
وثمة تنبيه تشغيلي يليق به أن يكون مع التعريف. فالأرقام المتسلسلة تُتابَع لكل موقّع على حدة، وقد تُمحى حالة الرقم المتسلسل لمحفظة API حين يُلغى تسجيلها بالموافقة على محفظة جديدة، أو حين تنتهي مدتها، أو حين لا يبقى للحساب الذي سجّلها أموال. وتقول الوثائق إن الأفعال الموقّعة سابقًا يمكن أن تُعاد عندئذٍ، وتنصح بقوة بألّا يُعاد استعمال عنوان وكيل أبدًا: بل يُنشأ عنوان جديد.
في تركيبنا يعيش مفتاح الوكيل على الحاسوب، مختومًا على القرص بكلمة سر، ولا يحمله الحارس في الذاكرة إلا وهو مفتوح. والحارس يوقّع قائمة مغلقة من أفعال التداول ولا شيء غيرها، والمفتاح ينتهي من تلقاء نفسه مع تحذيرات قبل 30 و14 و7 و3 و1 يومًا، وlpa agent revoke يُقعده بمحفظتك. ولا يوقف أي ملف على حاسوب سارقًا يحمل المفتاح وكلمة سره معًا، فالحدّ الذي يصمد هو الحساب: وما فيه هو أقصى ما يمكن أن يُفقد.
مثال
مثال بأرقام مدوّرة. حساب فيه 1,000 USDC يوافق على مفتاح وكيل واحد، بانتهاء بعد 180 يومًا، وهو السقف الذي يسمح به Hyperliquid. ويستطيع ذلك المفتاح أن يفتح المراكز ويغلقها في مقابل تلك 1,000 USDC وأن يضبط رافعة سوق ووضع هامشه؛ ولا يستطيع أن يسحب منها سنتًا واحدًا، ولا أن يرسلها إلى عنوان آخر، ولا أن ينقلها بين رصيد الفوري ورصيد العقود الدائمة. وكل ما يبلغه هو تلك 1,000 USDC، ولهذا فإن حسابًا مخصصًا هو الحدّ الذي يهمّ.