Uniswap V4 : Comment utiliser les Hooks ? (Fonctionnalités avancées)

Comprendre les hooks dans Uniswap V4

1. Les hooks sont des extensions logiques modulaires et personnalisables intégrées directement dans les pools Uniswap V4, permettant aux développeurs d'injecter un comportement personnalisé à des moments spécifiques lors des swaps, de l'approvisionnement en liquidités et de la collecte des frais.

2. Contrairement aux niveaux de frais statiques ou aux paramètres de pool immuables de la V3, la V4 permet aux hooks de s'exécuter avant ou après les actions principales, telles que l'exécution du swap, l'ajout/suppression de liquidités ou la récolte des frais, sans altérer la conception minimisée de la confiance du protocole principal.

3. Chaque hook est implémenté en tant que contrat intelligent distinct conforme à l'interface IHook, qui définit des fonctions obligatoires telles que beforeSwap , afterSwap , beforeAddLiquidity et afterRemoveLiquidity .

4. Un pool doit être déployé avec une adresse de hook désignée ; une fois défini, le hook ne peut pas être modifié à moins que le pool ne soit réinitialisé – une contrainte délibérée garantissant l’immuabilité et l’auditabilité.

5. Les contrats Hook sont vérifiés en chaîne et doivent respecter des limites de gaz strictes pour chaque rappel afin d'empêcher les vecteurs DoS, appliquant ainsi une logique simple et déterministe.

Déployer un contrat Hook personnalisé

1. Les développeurs écrivent du code Solidity implémentant IHook, en se concentrant uniquement sur les rappels requis pertinents pour leur cas d'utilisation. Par exemple, un hook de validation d'oracle de prix ne peut implémenter qu'avantSwap pour rejeter les transactions s'écartant de plus de 0,5 % d'une référence hors chaîne.

2. Le contrat de hook doit inclure une fonction validateHook qui renvoie true si l'appelant est autorisé à déployer le hook, limitant souvent le déploiement à la gouvernance ou à un portefeuille multisig.

3. La compilation nécessite de cibler un bytecode compatible EVM compatible avec les paramètres vérifiés du compilateur d'Uniswap ; tout écart déclenche un échec de déploiement lors de la création du pool.

4. Une fois le déploiement réussi, l'adresse du hook est transmise en tant que paramètre à la fonction createPool avec les adresses de jeton, le niveau de frais et l'espacement des ticks.

5. Une fois en ligne, toutes les interactions avec ce pool sont automatiquement acheminées via le hook enregistré : aucune configuration côté utilisateur ni approbation de portefeuille n'est nécessaire au-delà de la signature de transaction standard.

Cas d'utilisation de Hooks dans le monde réel

1. Ajustement dynamique des frais : un crochet surveille les indicateurs de volatilité en chaîne et augmente le pourcentage de frais dans des conditions de glissement élevé, revenant au taux de base lorsque le calme revient.

2. Application du verrouillage des liquidités : Avant le retrait des liquidités, le crochet vérifie si la position est active depuis au moins 72 heures, rejetant les sorties anticipées pour décourager la spéculation à court terme.

3. Filtrage de conformité : un oracle KYC en chaîne est interrogé à l'intérieur de beforeAddLiquidity ; les adresses non inscrites sur la liste blanche par une entité réglementée se voient refuser la participation.

4. Logique de redistribution des frais : après chaque échange, le crochet intercepte les frais collectés et en transmet une partie à un contrat de récompenses de mise basé sur des calculs APY en temps réel.

5. Surveillance de l'état des positions : pendant afterSwap , le hook calcule le ratio LTV mis à jour des positions de liquidité concentrées et déclenche des signaux de liquidation si les seuils sont dépassés.

Considérations de sécurité pour l'intégration de Hook

1. Les hooks héritent du contexte d'exécution complet du pool, ce qui signifie qu'une logique malveillante ou boguée peut geler la liquidité, drainer les frais ou corrompre les structures de données des ticks.

2. La réentrance est explicitement interdite : le runtime Uniswap V4 impose une entrée non réentrante dans les rappels de hook, empêchant ainsi les appels récursifs dans les fonctions de modification d'état du pool.

3. La consommation de gaz doit rester inférieure à 200 000 unités par rappel ; le dépassement de cette limite entraîne le retour en arrière de l'ensemble de la transaction, y compris l'opération de swap primaire ou de liquidité.

4. Toutes les écritures du stockage hook sont isolées du propre stockage contractuel du hook : aucun accès direct au stockage en pool n'est autorisé, préservant ainsi la séparation des préoccupations.

5. Les appels externes effectués par des hooks sont limités aux interfaces pré-approuvées uniquement, telles que les flux de prix Chainlink ou les résolveurs ENS ; les appels de contrats externes arbitraires sont bloqués au niveau du protocole.

Foire aux questions

Q : Un seul hook peut-il être réutilisé sur plusieurs pools Uniswap V4 ? Oui. Un contrat de hook peut être référencé par n'importe quel nombre de pools tant qu'il est conforme à IHook et passe la validation lors de la création de chaque pool.

Q : Est-il possible de mettre à niveau un hook après le déploiement d’un pool ? Non. L’adresse du hook est gravée dans les paramètres d’initialisation immuables du pool. Les mises à niveau nécessitent le déploiement d’un nouveau pool avec l’adresse de hook mise à jour.

Q : Les hooks affectent-ils le comportement de l'interface utilisateur frontale dans les portefeuilles comme MetaMask ou Rabby ? Pas directement. Les portefeuilles affichent des interfaces d'échange standard. Cependant, si un hook introduit des retours conditionnels (par exemple, en bloquant les échanges pour certaines adresses), la transaction échouera silencieusement à moins que la dApp n'intègre une analyse des erreurs spécifiques au hook.

Q : Existe-t-il des hooks officiels gérés par Uniswap et disponibles pour un usage public ? Uniswap Labs a publié des implémentations de référence, notamment un accumulateur de frais de base et un hook de liquidité verrouillé dans le temps, sur GitHub sous le référentiel uniswap-v4-hooks, toutes sous licence MIT et auditées.