이 페이지는 자동 번역되었습니다. 영어 원문이 정본입니다. 영어로 읽기 →
메인 콘텐츠로 건너뛰기

포트폴리오 증거금 온보딩

포트폴리오 증거금(PM)은 프로덕션에 출시되어 모든 계정이 이용할 수 있습니다. PM은 옵션과 Hyperliquid 퍼프를 최악의 시나리오 기준 포트폴리오 리스크로 함께 산정하므로, 헤지된 포지션은 표준 증거금보다 훨씬 적은 담보로 운용할 수 있습니다. 이 페이지에서는 PM으로 전환하는 방법을 다룹니다. 증거금 자체의 산정 방식은 포트폴리오 증거금을 참고하십시오.

요약: 새 매니저 지갑을 사용하여 Hypercall 계정을 생성하고, HyperCore 통합 계정 모드를 켜고, 포트폴리오 모드로 전환한 다음에 입금합니다.

새 지갑에서 시작하는 이유​

잔고나 미결제 포지션이 있는 표준 증거금(SM) 계정은 그대로 포트폴리오 증거금으로 전환할 수 없습니다. Hypercall은 매니저 지갑이 다음 조건을 모두 충족할 때만 포트폴리오 모드 전환을 허용합니다.

요건의미
Hypercall 계정이 정확히 하나매니저가 하나의 Account 컨트랙트를 관리해야 합니다. 계정이 없거나 둘 이상이면 거부됩니다.
표준 잔고 0지갑의 표준 증거금 현금 잔고가 0이어야 합니다. 출금 가능한 잔고가 있으면 전환이 차단됩니다.
포지션 없음매니저 지갑과 해당 Account 모두에 미결제 포지션과 미체결 주문이 없어야 합니다.

이러한 규칙은 두 모드가 설정 하나로 구분되는 같은 계정이 아니라, 서로 다른 종류의 계정이기 때문에 존재합니다.

  • 담보 보관 방식이 다릅니다. 표준 증거금에서 포트폴리오 증거금으로 옮기려면 스위치를 바꾸는 것이 아니라 자금을 이동해야 합니다.
  • 포지션에 적용되는 증거금 규칙이 다릅니다. 미결제 포지션이 있다면 한 규칙 체계에서 다른 규칙 체계로 증거금을 다시 산정해야 합니다.
  • 따라서 전환은 빈 계정에서 이루어집니다. 두 작업을 한 번에 안전하게 수행하는 것은 지원되지 않으므로, 먼저 포지션을 정리하고 잔고를 비워야 합니다.

증거금 모드는 매니저 지갑 단위로 설정되므로 하나의 지갑으로 두 모드를 동시에 운용할 수 없습니다. 가장 간단한 방법은 PM용 새 매니저 지갑을 사용하는 것입니다. 이렇게 하면 설정하는 동안에도 기존 SM 계정에서 호가를 계속 제시할 수 있습니다. 기존 지갑을 비우고(모든 포지션 청산, 모든 주문 취소, 표준 현금 전액 출금) 전환할 수도 있지만, 그동안 SM 포지션은 운용할 수 없습니다.

시작하기 전에​

  • 새 매니저 지갑(직접 관리하는 EOA, 가급적 하드웨어 지갑 등 안전하게 보관된 키).
  • 계정 생성 예치금과 가스비로 쓸 HyperEVM상의 HYPE.
  • 담보로 사용할 USDC.

설정 절차​

아래 순서대로 진행하십시오. 4단계는 반드시 5단계보다 먼저 수행해야 합니다.

  1. 새 매니저 지갑을 생성합니다. SM 매니저, API 지갑, 에이전트 키를 재사용하지 마십시오.

  2. Hypercall 계정을 생성합니다. 매니저 지갑에서 HYPE 생성 예치금과 함께 Factory 컨트랙트의 createAccount(salt)를 호출합니다. 이 호출로 Account 컨트랙트가 배포되고 HyperCore에서 활성화됩니다. 온보딩(컨트랙트)을 참고하십시오. 이 매니저에는 계정을 하나만 생성하십시오.

  3. Account에 HyperCore 통합 계정 모드를 켭니다. 매니저 지갑으로 서명한 hl_set_abstraction 액션을 제출하되, user는 Account 주소로, abstraction은 2(통합 계정)로 설정합니다. POST /v1/actions/hl_set_abstraction/typed-data가 서명할 정확한 typed data를 반환하며, POST /v1/actions/hl_set_abstraction으로 제출합니다. HyperCore가 Account를 unifiedAccount로 보고할 때까지 기다리십시오. Hyperliquid 자체의 포트폴리오 증거금 모드를 포함한 다른 계정 모드는 지원되지 않습니다.

  4. 포트폴리오 모드로 전환합니다. wallet을 매니저 주소로, margin_mode를 portfolio로 설정하고 매니저 지갑으로 서명하여 POST /margin-mode를 전송합니다(인증 참고). 응답에는 PM 지갑으로 사용될 Account 주소가 포함됩니다. 이 단계는 입금 전에 수행하십시오. 지갑이 아직 표준 모드인 상태에서 Hypercall에 입금하면 표준 현금으로 입금 처리되며, 이 잔고를 다시 출금할 때까지 전환이 차단됩니다.

  5. Account에 USDC를 입금합니다. 증거금 모드에 따라 경로를 지정하는 앱을 통해 입금하거나, HyperCore에서 Account 주소로 USDC를 전송합니다. 자금은 Hypercall의 다음 HyperCore 스냅샷에 반영된 시점부터 증거금으로 인정됩니다.

  6. 서명 키를 설정합니다. 기존 SM 지갑의 승인은 이전되지 않습니다.

    • 옵션(REST): POST /approve-agent로 새 매니저 지갑에 대해 트레이딩 키를 승인합니다. 에이전트 승인을 참고하십시오.
    • 퍼프(온체인 디렉티브): 매니저가 서명한 hc_update_api_wallet 액션으로 Account에 API 지갑을 등록합니다. API 지갑은 하나의 Account에서만 활성화될 수 있습니다. EIP-712 서명을 참고하십시오.

  7. 거래합니다. 옵션 요청에서는 계속 매니저 주소를 wallet으로 전송하면 Hypercall이 PM 계정으로 라우팅합니다. 주문 유형, 주문 API, 서명 방식은 표준 증거금과 동일합니다. 앱에서 Hyperliquid 퍼프를 거래하는 방법은 Hypercall의 퍼프를 참고하십시오.

앱에서 Settings > Margin Mode의 Portfolio를 선택하면 2~4단계가 자동으로 실행됩니다. 계정이 없으면 생성하고, 통합 계정 모드를 켜고, 모드를 전환합니다.

통합 계정 모드를 건너뛴 경우

Hypercall은 PM 계정을 HyperCore 자산가치(equity)로 평가하는데, HyperCore는 통합 계정 모드인 Account에 대해서만 이를 공개합니다. Account가 해당 모드가 아니면 4단계는 400 pm_account_not_unified로 거부됩니다. 3단계를 완료하고 HyperCore가 모드를 확인할 때까지 기다린 뒤 다시 시도하십시오.

이후 Account가 통합 계정 모드에서 벗어나면 포트폴리오 조회는 503 pm_account_equity_pending을 반환하고(HyperCore가 해당 계정의 자산가치를 한 번도 공개하지 않았다면 409 pm_account_not_unified), 주문은 missing HyperCore account equity for PM wallet 0x...와 같은 오류로 실패합니다. 통합 계정 모드를 다시 활성화하면 해결됩니다. 오류 및 거부 사유를 참고하십시오.

FAQ​

표준 증거금 계정을 계속 운용할 수 있습니까? 예. 새 매니저 지갑으로 PM에 온보딩하고 SM 계정은 그대로 두면 됩니다.

증거금 모드 전환이 거부된 이유는 무엇입니까? 오류 메시지에 해당 규칙이 표시됩니다. 지갑에 Account가 없거나(또는 둘 이상이거나), 표준 잔고가 있거나, 미결제 포지션 또는 미체결 주문이 있거나, Account가 아직 HyperCore 통합 계정 모드가 아닌 경우(pm_account_not_unified)입니다. 새 지갑에서 시작하는 이유를 참고하십시오.

전환 전에 입금했습니다. 어떻게 해야 합니까? 입금액은 표준 현금으로 처리되었습니다. 이를 출금한 뒤 포트폴리오 모드로 전환하고 Account에 입금하십시오.

새 API 키가 필요합니까? 새로운 승인이 필요합니다. 옵션 에이전트 승인은 매니저 지갑에 연결되어 있으므로 새 지갑에 대해 키를 다시 승인하십시오. 퍼프 API 지갑은 하나의 Account에서만 활성화될 수 있으므로, 새 키를 사용하거나 먼저 기존 Account에서 해당 키를 제거하십시오(6단계).

PM 증거금, 청산, 결제 방식은 어디에서 확인할 수 있습니까? 포트폴리오 증거금, PM 증거금 계산 예시, 증거금 하한, 청산, 결제를 참고하십시오.

최종 업데이트: