Định nghĩa
Một tài khoản chính có thể chuẩn thuận các ví API để ký thay chính nó hoặc thay bất cứ tài khoản con nào của nó. Chúng chỉ dùng để ký: dữ liệu tài khoản phải được truy vấn bằng địa chỉ thật của tài khoản, và tài liệu gọi việc truy vấn địa chỉ tác nhân là một cái bẫy thường gặp, vì nó trả về kết quả rỗng thay vì một lỗi. Một tài khoản có thể giữ một ví đã chuẩn thuận không tên và tối đa ba ví có tên, cộng thêm hai tác nhân có tên cho mỗi tài khoản con, và thời hạn đặt bằng valid_until xa nhất là 180 ngày tới.
Một khóa như vậy làm được gì và không làm được gì thì đã được đo, chứ không phải suy đoán. Ngày 28 tháng 9 năm 2026, trên mainnet, một tài khoản thử nghiệm chuẩn thuận một tác nhân mới trong một giờ và cho nó ký mọi hành động làm tiền dịch chuyển, với 1.000 USDC trong khi số dư chỉ khoảng 60, nên không gì dịch chuyển được và chỉ còn lý do của từng câu trả lời là đáng kể. Bị từ chối trên khóa ký: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, một approveAgent thứ hai và approveBuilderFee, trong khi chính tài khoản lại gặp lỗi số dư. Được nhận: đặt và hủy một lệnh. Và một lần dịch chuyển tiền được nhận, vaultTransfer, qua đó 5 USDC do khóa tác nhân ký đã tới được một vault của Hyperliquid.
Có một cảnh báo vận hành đi cùng định nghĩa này. Nonce được theo dõi riêng cho từng khóa ký, và trạng thái nonce của một ví API có thể bị tỉa đi khi ví đó bị xóa đăng ký vì một ví mới được chuẩn thuận, khi nó hết hạn, hoặc khi tài khoản đã đăng ký nó không còn tiền. Tài liệu nói rằng những hành động đã ký trước đó khi ấy có thể bị phát lại, và khuyên rất mạnh là đừng bao giờ dùng lại một địa chỉ tác nhân: hãy tạo địa chỉ mới.
Trong cách bố trí của chúng tôi, khóa tác nhân sống trên máy tính, niêm phong trên đĩa dưới một mật khẩu, và trình canh giữ chỉ giữ nó trong bộ nhớ khi nó đang được mở. Trình canh giữ ký một danh sách đóng các hành động giao dịch và không gì khác, khóa tự hết hạn với các cảnh báo trước 30, 14, 7, 3 và 1 ngày, và lpa agent revoke cho nó về hưu cùng với ví của bạn. Không tệp nào trên máy tính chặn được một kẻ trộm đang giữ cả khóa lẫn mật khẩu của nó, nên giới hạn thật sự đứng vững là chính tài khoản: những gì nó chứa là mức tối đa có thể mất.
Ví dụ
Một ví dụ, bằng số tròn. Một tài khoản được nạp 1.000 USDC chuẩn thuận một khóa tác nhân, với thời hạn 180 ngày tới, là mức trần Hyperliquid cho phép. Khóa ấy có thể mở và đóng vị thế đối ứng với 1.000 USDC đó và đặt đòn bẩy cùng chế độ ký quỹ của một thị trường; nó không thể rút một xu nào, không thể gửi sang địa chỉ khác, cũng không thể chuyển qua lại giữa số dư spot và số dư vĩnh cửu. Tất cả những gì nó với tới là 1.000 USDC ấy, và đó là lý do một tài khoản riêng chính là giới hạn đáng kể.