> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-ko/perp-dex-1/hyperliquid/how-to-connect.md).

# 연결 방법

{% embed url="<https://youtu.be/dCKlpi8v738>" %}

{% hint style="info" %}
수동 빌더 수수료 승인을 위해서는 아래에 설명된 우리의 맞춤 [도구를](https://goodcrypto.app/hype/builder-fees) 사용하세요. 영상에 표시된 Hyperdash의 도구는 이미 서비스가 종료되었습니다
{% endhint %}

### MetaMask에 자동으로 연결

MetaMask로 Hyperliquid 계정을 관리하고 있다면, 단 3번의 클릭으로 goodcryptoX에 연결할 수 있습니다.

그렇지 않다면 - 아래의 [수동 설정](#manual-setup) 경로를 따르거나 Hyperliquid 계정을 제어하는 지갑을 MetaMask에 추가한 뒤 다음 단계를 진행하세요.

{% stepper %}
{% step %}
우리의 [**웹 앱에서**](https://app.goodcrypto.app) 다음으로 이동하세요:

```
설정 -> 거래소 -> Hyperliquid
```

{% endstep %}

{% step %}
"MetaMask에 연결"을 클릭하세요:

<figure><img src="/files/4ce3e5aa71f6d8cfb94efee92c013ba02b8ffb44" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Hyperliquid 계정을 제어하는 지갑을 선택하고 "연결"을 클릭하세요:

<figure><img src="/files/00fcfd3da5541039f099113c168de2990d68ed65" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
이제 API 지갑을 생성하여 Hyperliquid에 등록합니다. 거래에 서명하려면 Metamask에서 "확인"을 클릭하세요(가스 비용 필요 없음):

<figure><img src="/files/4e84fc25cba4155819eaf4f5cf276e115232fb54" alt="" width="375"><figcaption></figcaption></figure>

드물게 Hyperliquid에 이미 등록된 API 지갑의 최대 수(3개)에 도달한 경우, 어떤 지갑을 교체할지 묻고 그 자리에 새 지갑을 등록합니다.
{% endstep %}

{% step %}
그 다음 우리의 [빌더 수수료](/goodcryptox-ko/perp-dex-1/hyperliquid/builder-fees.md)를 승인하기 위해 거래에 서명하라는 요청을 받게 됩니다. 진행하려면 "확인"을 클릭하세요(가스 비용 필요 없음):

<figure><img src="/files/e0a57958a3afd36e80b136aa7cf861541dda6adb" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

이제 API 지갑이 안전한 저장소에 저장됩니다. 연결 상태가 "**OK**"로 바뀌면 모든 설정이 완료된 것입니다!

이제 API 지갑의 주소와 이름을 볼 수 있으며, 거래소 인터페이스에서 이를 식별하는 데 사용할 수 있고 만료일도 확인할 수 있습니다:

<figure><img src="/files/cb9b5f0330baba513e61c9176abd0b73cc7010b8" alt=""><figcaption></figcaption></figure>

Hyperliquid의 API 지갑은 6개월마다 만료됩니다. 만료되기 전에 미리 알려드리며, MetaMask 지갑을 사용해 현재 API 지갑을 새 지갑으로 원활하게 교체할 수 있습니다.

### 수동 설정

Hyperliquid 계정을 제어하는 데 사용하는 지갑이 MetaMask가 아닌 경우, goodcryptoX와의 연결을 수동으로 설정할 수 있습니다.

{% stepper %}
{% step %}

#### API 지갑 생성

지갑을 Hyperliquid에 연결하세요. \
다음으로 이동: `더보기 -> API`. \
API 지갑의 이름을 정하고(예: goodcryptoX), "생성"을 클릭해 API 지갑 주소를 만든 다음 - "API 지갑 승인"을 클릭하세요:

<figure><img src="/files/1d4d48284d937322c96237e6d1f59ebf8093501c" alt="" width="563"><figcaption></figcaption></figure>

그러면 API 지갑의 개인 키가 포함된 팝업이 표시됩니다. 이를 복사해 두세요. 나중에 goodcryptoX에 추가해야 하며, 이 키는 다시 볼 수 없습니다. 또한 "유효 일수" 항목의 "MAX"를 클릭하세요 - 그러면 지갑 만료 기간이 6개월로 설정됩니다(그렇지 않으면 90일 후 만료됩니다):

<figure><img src="/files/d371a054161a33e62e6cfa25acab262dd872f109" alt="" width="375"><figcaption></figcaption></figure>

준비가 되면 "승인"을 클릭하고 지갑으로 거래에 서명하세요(가스 비용 필요 없음).
{% endstep %}

{% step %}

### 빌더 수수료 승인

Hyperliquid에서 goodcryptoX로 거래하려면 우리가 [수수료를 부과할 수 있도록](/goodcryptox-ko/perp-dex-1/hyperliquid/builder-fees.md) 허용해야 합니다. Hyperliquid는 인터페이스에서 이 기능을 제공하지 않기 때문에, 이를 위해 전용 [도구를](https://goodcrypto.app/hype/builder-fees) 을 구축했습니다.

우리의 [빌더 수수료 관리 도구](https://goodcrypto.app/hype/builder-fees) 로 이동해 Hyperliquid 계정을 제어하는 지갑을 연결하세요:

<figure><img src="/files/f797c93d584fc9a01f7ffb7b84e01e6303775cd7" alt="" width="563"><figcaption></figcaption></figure>

연결되면 goodcryptoX 빌더 수수료 승인를 클릭하고 지갑으로 거래에 서명하세요:&#x20;

<figure><img src="/files/80b89aa7f2b7d9c38b30c8014dd9c03e1529f223" alt="" width="563"><figcaption></figcaption></figure>

> 1%의 최대 빌더 수수료를 승인하더라도, 실제로는 0.1%의 선물 수수료만 승인됩니다(Hyperliquid에서 적용). 통합된 1% 표시는 이 기능 구현에서 Hyperliquid의 시각적 제한입니다

{% hint style="info" %}
Hyperliquid 계정을 생성할 때 **이메일**을 사용했다면, 빌더 수수료를 승인하기 전에 지갑을 MetaMask(또는 다른 지갑)로 내보내야 합니다.

Hyperliquid 인터페이스의 설정으로 이동하여 “이메일 지갑 내보내기”를 선택하세요
{% endhint %}
{% endstep %}

{% step %}

### goodcryptoX에 API 지갑 추가:

우리 앱(웹 또는 모바일)에서 다음으로 이동하세요:

```
설정 -> 거래소 -> Hyperliquid -> API 지갑 수동 추가
```

Hyperliquid 계정을 제어하는 지갑의 주소(API 지갑 주소가 아님)를 "Hyperliquid 계정 주소"에 추가하세요.\
생성한 API 지갑의 개인 키(메인 지갑의 개인 키가 아님)를 "API 지갑 개인 키"에 추가한 뒤 "저장 및 검증"을 클릭하세요:

<figure><img src="/files/b5d5c68424926b95f88f7ba2f6ac4ec628fb38ad" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

이제 API 지갑이 안전한 저장소에 저장됩니다. 연결 상태가 "**OK**"로 바뀌면 모든 설정이 완료된 것입니다!

이제 API 지갑의 주소와 이름, 그리고 만료일을 볼 수 있습니다:

<figure><img src="/files/cb9b5f0330baba513e61c9176abd0b73cc7010b8" alt=""><figcaption></figcaption></figure>

만료되기 전에 미리 알려드려 교체할 새 지갑을 준비할 충분한 시간을 드리겠습니다.