Builder Codes

참고: Builder code 맥락에서 "빌더"라는 용어는 컨센서스 내 블록 빌더를 의미하는 것이 아니라, Hyperliquid 위에 애플리케이션을 구축하는 "디파이 빌더"를 의미합니다.

Builder Code를 통해 빌더는 사용자를 대신하여 보내 체결에 대해 수수료를 받을 수 있습니다. 최대의 유연성을 위해 주문 단위로 설정됩니다. 사용자는 각 빌더에 대해 최대 빌더 수수료를 승인해야 하며, 언제든지 권한을 철회할 수 있습니다. Builder Code는 수수료 로직의 일부로 전적으로 온체인에서 처리됩니다.

Builder Code를 사용하려면, 최종 사용자가 먼저 ApproveBuilderFee 액션을 통해 빌더 주소에 대해 최대 수수료를 승인해야 합니다. 이 액션은 에이전트/API 지갑이 아닌 사용자의 메인 지갑으로 서명되어야 합니다. 빌더는 무기한 선물(펍) 계정 값에 최소 100 USDC를 보유해야 하며 계정 추상화 모드로 standard를 사용해야 합니다.

Builder Code는 현재 호가 또는 담보 자산으로 수집되는 수수료에만 적용됩니다. 다시 말해, Builder Code는 스팟 거래의 매수 측에는 적용되지 않지만 무기한 선물(펍) 거래의 양쪽 모두에 적용됩니다. 부과되는 빌더 수수료는 무기한 선물(펍)에서 최대 0.1%, 스팟에서 최대 1%입니다.

승인이 완료되면, 사용자를 대신하여 전송되는 향후 주문 액션에 선택적 빌더 파라미터가 포함될 수 있습니다: {"b": address, "f": number}. b는 빌더의 주소이고 f는 basis point의 1/10 단위로 부과할 빌더 수수료입니다. 즉, 값이 10이면 1 basis point를 의미합니다.

빌더는 일반적인 추천 보상 청구 절차를 통해 Builder Code의 수수료를 청구할 수 있습니다.

각 사용자는 한 번에 최대 10개의 활성 Builder Code 승인을 가질 수 있습니다.

예시 코드는 Python SDK https://github.com/hyperliquid-dex/hyperliquid-python-sdk/blob/master/examples/basic_builder_fee.py를 참조하세요

빌더를 위한 API

사용자에 대해 승인된 최대 빌더 수수료는 정보 요청 {"type": "maxBuilderFee", "user": "0x...", "builder": "0x..."}를 통해 조회할 수 있습니다.

빌더에 대해 수집된 총 빌더 수수료는 정보 요청 {"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가 전체적으로 소문자여야 합니다.