# Come connettere

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

### Connettiti automaticamente con MetaMask

Se controlli il tuo account Hyperliquid con MetaMask, puoi collegarlo a goodcryptoX in appena 3 clic.

Se non lo fai - puoi seguire [la configurazione manuale](#manual-setup) oppure aggiungere il portafoglio che controlla il tuo account Hyperliquid a MetaMask e procedere con quanto segue.

{% stepper %}
{% step %}
Nella nostra [**app web**](https://app.goodcrypto.app) vai a:

```
Impostazioni -> Exchange -> Hyperliquid
```

{% endstep %}

{% step %}
Clicca "Connetti con MetaMask":

<figure><img src="https://4142774519-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 %}
Seleziona il portafoglio che controlla il tuo account Hyperliquid e clicca "Connetti":

<figure><img src="https://4142774519-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 %}
Ora genereremo un portafoglio API e lo registreremo con Hyperliquid. "Conferma" in MetaMask per firmare la transazione (non è necessario gas):

<figure><img src="https://4142774519-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>

Nell'improbabile caso tu abbia già il numero massimo di portafogli API registrati su Hyperliquid (3), ti chiederemo quale vuoi sostituire e registreremo uno nuovo al suo posto.
{% endstep %}

{% step %}
Ti verrà quindi chiesto di firmare la transazione per approvare la nostra [Commissione Builder](https://docs.goodcrypto.app/goodcryptox-it/perp-dex/hyperliquid/commissioni-del-builder). Clicca "Conferma" per procedere (non è necessario gas):

<figure><img src="https://4142774519-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 %}

Il tuo portafoglio API sarà ora salvato nel nostro archivio sicuro. Quando lo stato della tua connessione diventerà "**OK**" - sei a posto!

Ora puoi vedere l'indirizzo e il nome del tuo portafoglio API che puoi usare per identificarlo nell'interfaccia dell'exchange, così come la sua data di scadenza:

<figure><img src="https://4142774519-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>

I portafogli API di Hyperliquid scadono ogni 6 mesi. Prima della scadenza ti avviseremo e potrai sostituire senza interruzioni il tuo portafoglio API corrente con uno nuovo usando il tuo portafoglio MetaMask.

### Configurazione manuale

Se il portafoglio che usi per controllare il tuo account Hyperliquid è diverso da MetaMask, puoi configurare manualmente la connessione con goodcryptoX. Tuttavia, consigliamo vivamente di importare quel portafoglio in MetaMask e procedere con la [procedura automatica](#connect-with-metamask-automatically) .

{% stepper %}
{% step %}

#### Crea portafoglio API

Collega il tuo portafoglio a Hyperliquid. \
Vai su `Altro -> API`. \
Scegli un nome per il tuo portafoglio API (es. goodcryptoX), clicca "Genera" per l'indirizzo del portafoglio API e poi - "Autorizza portafoglio API":

<figure><img src="https://4142774519-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>

Vedrai quindi un pop-up con la chiave privata del tuo portafoglio API - copiala, dovrai aggiungerla a goodcryptoX più tardi - non vedrai più questa chiave. Clicca inoltre su "MAX" nel campo "Giorni validi" - imposterà la scadenza del portafoglio a 6 mesi (altrimenti scadrà in 90 giorni):

<figure><img src="https://4142774519-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>

Una volta pronto, clicca "Autorizza" e firma la transazione con il tuo portafoglio (non è necessario gas).
{% endstep %}

{% step %}

### Approva la commissione Builder

Per poter fare trading con goodcryptoX su Hyperliquid devi permetterci di [addebitarci commissioni](https://docs.goodcrypto.app/goodcryptox-it/perp-dex/hyperliquid/commissioni-del-builder) sulle tue operazioni. Hyperliquid non espone questa funzionalità nell'interfaccia, quindi dovrai usare uno strumento di terze parti per farlo. Per esempio - [Hyperdash](https://legacy.hyperdash.com/builder-fee).

Vai al [strumento di gestione delle commissioni Builder](https://legacy.hyperdash.com/builder-fee) di Hyperdash e connetti il portafoglio che controlla il tuo account Hyperliquid.\
Aggiungi il nostro indirizzo nel campo "Builder Address":

```
0xff09853a49dde85a8e7eab58abf94018fbe76116
```

Imposta "Max Fee Rate" su 1% e clicca "Approve Builder" (non è necessario gas):

<figure><img src="https://4142774519-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>

> Mentre approvi un tasso massimo builder dell'1%, questo approva solo una commissione futures dello 0,1% (imposta da Hyperliquid). L'unica voce unificata dell'1% è una limitazione visiva nell'implementazione di questa funzionalità da parte di Hyperliquid

{% hint style="info" %}
Se hai creato il tuo account Hyperliquid usando **email**, dovrai esportare il tuo portafoglio su MetaMask (o un altro portafoglio) prima di poter approvare le commissioni builder.

Vai su Impostazioni nell'interfaccia di Hyperliquid e seleziona “Esporta portafoglio email”
{% endhint %}
{% endstep %}

{% step %}

### Aggiungi il portafoglio API a goodcryptoX:

Nella nostra app (web o mobile), vai a:

```
Impostazioni -> Exchange -> Hyperliquid -> Aggiungi portafoglio API manualmente
```

Aggiungi l'indirizzo del portafoglio che controlla il tuo account Hyperliquid (NON l'indirizzo del tuo portafoglio API) in "Indirizzo account Hyperliquid".\
Aggiungi la chiave privata del portafoglio API che hai creato (NON la chiave privata del tuo portafoglio principale) in "Chiave privata portafoglio API" e clicca "Salva e convalida":

<figure><img src="https://4142774519-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 %}

Il tuo portafoglio API sarà ora salvato nel nostro archivio sicuro. Quando lo stato della tua connessione diventerà "**OK**" - sei a posto!

Ora puoi vedere l'indirizzo e il nome del tuo portafoglio API, così come la sua data di scadenza:

<figure><img src="https://4142774519-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>

Prima che scada, ti avviseremo in anticipo in modo che tu abbia il tempo necessario per sostituirlo con uno nuovo.