> 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="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FqUaHcekL4zBOazJ8PFz1%2Fimage.png?alt=media&amp;token=c27f17a3-56db-466f-bcf0-5edc418637f1" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fsf5A21JNyN0yIkBXZNtF%2Fimage.png?alt=media&amp;token=51d808d4-cdf2-46f9-8be5-64cc06ce0320" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F8IoPe9ZQ0YIJWEYz7dtD%2Fimage.png?alt=media&amp;token=b2d5fefe-9077-4631-b1a6-05f3ed08d436" alt="" width="375"><figcaption></figcaption></figure>

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

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fdi4GEaXEcFB5TnThJMcF%2Fimage.png?alt=media&amp;token=cd6a0b33-2fd8-467f-8ab2-aa3fc98e2a32" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FuChb6TQuFf9rL9o7TCi8%2Fimage.png?alt=media&amp;token=014cf41a-3265-47c3-96a7-544547928d78" alt=""><figcaption></figcaption></figure>

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

### 수동 설정

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

{% stepper %}
{% step %}

#### API 지갑 생성

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fio6DHExMEq0HQeQyiRuu%2Fimage.png?alt=media&amp;token=5273a64a-5e75-4ff7-bf55-845ae6a97f1c" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FeMFuUEnx4hO5WMUEJpN5%2Fimage.png?alt=media&amp;token=273d93fc-1322-4723-84dc-f4fd158bfc56" 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="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOqRnbfSyZYhuMijnp09u%2Fimage.png?alt=media&amp;token=ec647976-90e9-4844-b9da-f2ccccf7d6a0" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FeDfJQmzwjh3vvP9VBlbq%2Fimage.png?alt=media&amp;token=d8980f23-b309-47f9-965d-e2298e5d9e85" 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="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FVhOSbmzsqxJvrHKUwfmW%2Fimage.png?alt=media&amp;token=147a5fd6-a3b2-4fab-aa2e-46b7c3a88dd6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

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

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

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FuChb6TQuFf9rL9o7TCi8%2Fimage.png?alt=media&amp;token=014cf41a-3265-47c3-96a7-544547928d78" alt=""><figcaption></figcaption></figure>

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