Builder Codes

Примечание: термин «билдер» в контексте builder codes не относится к билдерам блоков в рамках консенсуса, а означает «дефи-билдеров», создающих приложения на Hyperliquid.

Builder Codes позволяют билдерам получать комиссию со сделок, которые они отправляют от имени пользователя. Они задаются для каждого ордера отдельно для максимальной гибкости. Пользователь должен одобрить максимальную комиссию билдера для каждого билдера и может отозвать разрешение в любой момент. Builder Codes обрабатываются полностью ончейн в рамках логики комиссий.

Чтобы использовать builder codes, конечный пользователь должен сначала одобрить максимальную комиссию для адреса билдера с помощью действия ApproveBuilderFee. Это действие должно быть подписано основным кошельком пользователя, а не агентским/API-кошельком. Билдер должен иметь не менее 100 USDC в стоимости перп-аккаунта и должен использовать режим standard в качестве режима абстракции аккаунта.

В настоящее время builder codes применяются только к комиссиям, взимаемым в котируемом активе или активе обеспечения. Другими словами, builder codes не применяются к стороне покупки спот-сделок, но применяются к обеим сторонам сделок с перпами. Взимаемая комиссия билдера может составлять не более 0.1% на перпах и 1% на споте.

После завершения авторизации будущие действия с ордерами, отправляемые от имени пользователя, могут включать необязательный параметр билдера: {"b": address, "f": number}. b — это адрес билдера, а f — комиссия билдера в десятых долях базисного пункта. Т.е. значение 10 означает 1 базисный пункт.

Билдеры могут получить комиссии с builder codes через обычный процесс запроса реферальных вознаграждений.

Каждый пользователь может иметь максимум 10 активных одобрений builder codes одновременно.

Пример кода см. в Python SDK https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py

API для билдеров

Одобренная максимальная комиссия билдера для пользователя может быть запрошена через info-запрос {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."}.

Общая сумма собранных комиссий билдера является частью ответа о реферальном состоянии на info-запрос {"type": "referral", "user": "0x..."}.

Сделки, использующие конкретный builder code, выгружаются в сжатом формате LZ4 по адресу https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/{builder_address}/{YYYYMMDD}.csv.lz4, например https://stats-data.hyperliquid.xyz/Mainnet/builder_fills/0x123.../20241031.csv.lz4

Важно: обратите внимание, что эти URL чувствительны к регистру и требуют, чтобы builder_address был полностью в нижнем регистре.