# 연결 방법

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

### 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&#x26;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&#x26;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&#x26;token=b2d5fefe-9077-4631-b1a6-05f3ed08d436" alt="" width="375"><figcaption></figcaption></figure>

만약 이미 Hyperliquid에 등록된 API 지갑이 최대 수(3개)인 경우, 어떤 지갑을 교체할지 묻고 해당 지갑을 새 것으로 등록합니다.
{% endstep %}

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

<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&#x26;token=cd6a0b33-2fd8-467f-8ab2-aa3fc98e2a32" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

귀하의 API 지갑은 이제 당사의 안전한 저장소에 저장됩니다. 연결 상태가 "**정상**"으로 바뀌면 모든 설정이 완료됩니다!

이제 거래소 인터페이스에서 식별하는 데 사용할 수 있는 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&#x26;token=014cf41a-3265-47c3-96a7-544547928d78" alt=""><figcaption></figcaption></figure>

Hyperliquid의 API 지갑은 6개월마다 만료됩니다. 만료 전에 경고를 보내드리며 MetaMask 지갑을 사용하여 현재 API 지갑을 새 것으로 원활하게 교체할 수 있습니다.

### 수동 설정

Hyperliquid 계정을 제어하는 데 MetaMask가 아닌 다른 지갑을 사용하는 경우 goodcryptoX와의 연결을 수동으로 설정할 수 있습니다. 다만 해당 지갑을 MetaMask로 가져와 [자동](#connect-with-metamask-automatically) 경로를 진행할 것을 강력히 권장합니다.

{% stepper %}
{% step %}

#### API 지갑 생성

지갑을 Hyperliquid에 연결하세요. \
다음으로 이동 `더보기 -> API`. \
API 지갑의 이름(e.g. 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&#x26;token=5273a64a-5e75-4ff7-bf55-845ae6a97f1c" alt="" width="563"><figcaption></figcaption></figure>

그런 다음 API 지갑의 개인 키가 포함된 팝업이 표시됩니다 - 복사해 두세요. 나중에 goodcryptoX에 추가해야 하며 이 키는 다시 볼 수 없습니다. 또한 "유효일수" 필드의 "최대"를 클릭하면 지갑 만료가 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&#x26;token=273d93fc-1322-4723-84dc-f4fd158bfc56" alt="" width="375"><figcaption></figcaption></figure>

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

{% step %}

### 빌더 수수료 승인

goodcryptoX로 Hyperliquid에서 거래하려면 우리에게 [수수료를 부과하도록](https://docs.goodcrypto.app/goodcryptox-ko/dex-1/hyperliquid/builder-fees) 허용해야 합니다. Hyperliquid는 이 기능을 인터페이스에 노출하지 않으므로 타사 도구를 사용해야 합니다. 예를 들어 - [Hyperdash](https://legacy.hyperdash.com/builder-fee).

Hyperdash의 [빌더 수수료 관리 도구](https://legacy.hyperdash.com/builder-fee) 로 이동하여 Hyperliquid 계정을 제어하는 지갑을 연결하세요.\
우리 주소를 "Builder Address" 필드에 추가:

```
0xff09853a49dde85a8e7eab58abf94018fbe76116
```

"최대 수수료 비율"을 1%로 설정하고 "Builder 승인"을 클릭하세요(가스 불필요):

<figure><img src="https://3334908495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fum2V0WAcmQOjJPYbwOjl%2Fimage.png?alt=media&#x26;token=f847bafe-f8d1-4e48-8931-a53fb82b9a8c" alt="" width="375"><figcaption></figcaption></figure>

> 1%의 최대 빌더 수수료를 승인하더라도, 이는 Hyperliquid가 적용하는 0.1% 선물 수수료만 승인합니다. 통합된 1% 항목은 Hyperliquid의 해당 기능 구현에서의 시각적 제한입니다.

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

Hyperliquid 인터페이스에서 설정으로 가서 "이메일 지갑 내보내기"를 선택하세요
{% endhint %}
{% endstep %}

{% step %}

### API 지갑을 goodcryptoX에 추가:

앱(웹 또는 모바일)에서 다음으로 이동:

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

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

<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&#x26;token=147a5fd6-a3b2-4fab-aa2e-46b7c3a88dd6" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

귀하의 API 지갑은 이제 당사의 안전한 저장소에 저장됩니다. 연결 상태가 "**정상**"으로 바뀌면 모든 설정이 완료됩니다!

이제 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&#x26;token=014cf41a-3265-47c3-96a7-544547928d78" alt=""><figcaption></figcaption></figure>

만료되기 전에 미리 경고해 드리므로 새 것으로 교체할 충분한 시간이 있습니다.