Comment interagir directement avec un contrat Uniswap V3 ?

Comprendre l'architecture du contrat Uniswap V3

1. Uniswap V3 introduit une liquidité concentrée, permettant aux fournisseurs de liquidité d'allouer du capital dans des fourchettes de prix personnalisées plutôt que sur l'ensemble de la courbe.

2. Le contrat principal est UniswapV3Pool , qui gère les swaps, la création de liquidités et la gestion des positions au niveau de la chaîne.

3. Chaque pool est déployé en tant que contrat immuable distinct avec des paramètres fixes : token0, token1, niveau de frais et espacement des ticks.

4. Le NonfungiblePositionManager sert d'interface de niveau supérieur pour gérer les positions de liquidité basées sur NFT.

5. Toutes les interactions nécessitent un codage précis des données d'appel, une gestion correcte des glissements et le respect des signatures de fonction exactes définies dans l'ABI officiel.

Configuration d'une interaction contractuelle directe

1. Récupérez l'adresse exacte du pool à l'aide de la fonction getPool du contrat UniswapV3Factory avec les adresses de jetons triées et le niveau de frais.

2. Instanciez le contrat de pool dans votre fournisseur web3 à l'aide de son ABI et de son adresse déployée : aucun proxy ou abstraction d'usine n'est nécessaire pour les appels directs.

3. Assurez-vous que votre portefeuille contient suffisamment d'ETH pour le gaz et les jetons requis pour l'opération prévue : échange ou fourniture de liquidités.

4. Utilisez ethers.js ou web3.py pour créer des transactions brutes avec un alignement approprié des noms occasionnels, des limites de gaz et des identifiants de chaîne.

5. Validez les limites des ticks avant de soumettre toute transaction liée à la liquidité : le pool rejette les positions en dehors de la plage de ticks valide ou mal alignées avec l'espacement des ticks.

Exécution d'un échange via un appel brut

1. Appelez le swap sur le contrat de pool avec les paramètres : destinataire, indicateur zeroForOne, montantSpécifié, sqrtPriceLimitX96 et données.

2. Calculez soigneusement sqrtPriceLimitX96 : il doit être strictement supérieur au prix actuel pour zeroForOne = false, ou inférieur pour true.

3. Transmettez un tableau d'octets vide en tant que données, sauf si vous implémentez un contrat de rappel personnalisé ; la plupart des échanges directs omettent ce champ.

4. Surveillez les valeurs montant0 et montant1 renvoyées pour confirmer le résultat de l'exécution : celles-ci reflètent les deltas nets des jetons après frais.

5. Le risque de retour augmente si la transaction ne spécifie pas une tolérance de glissement adéquate via sqrtPriceLimitX96, entraînant une résiliation prématurée.

Gestion manuelle des positions de liquidité

1. Générez de la liquidité en appelant mint sur NonfungiblePositionManager avec tickLower, tickUpper, montant0Desired, montant1Desired et date limite.

2. Chaque position est représentée comme un jeton ERC-721 unique : son identifiant devient essentiel pour les opérations ultérieures d'augmentation/diminution/collecte.

3. Pour ajouter plus de liquidité à une position existante, appelez IncreaseLiquidity avec les mêmes limites de ticks et de nouveaux montants.

4. Le retrait nécessite deux étapes : appelez d'abord la diminution de la liquidité pour brûler une partie de la position NFT, puis appelez collect pour récupérer les frais accumulés et les jetons principaux.

5. Le défaut de collecte après une diminution de la liquidité laisse les jetons bloqués dans le contrat de pool jusqu'à ce qu'ils soient explicitement récupérés.

Foire aux questions

Q : Puis-je échanger sans approuver le routeur Uniswap ? R : Oui, vous pouvez interagir directement avec le contrat du pool, en contournant entièrement les routeurs. L'approbation n'est requise que lors de l'utilisation de la logique ERC-20 transferFrom, comme avec NonfungiblePositionManager ou SwapRouter.

Q : Que se passe-t-il si je règle sqrtPriceLimitX96 sur zéro ? R : La transaction est annulée immédiatement. Cette valeur doit être un nombre à virgule fixe Q64.96 différent de zéro et correctement formaté, représentant une limite de prix valide.

Q : Dois-je gérer manuellement la comptabilité Flash lors d’un échange ? R : Non : la comptabilité flash est interne au contrat de pool. Les appelants externes n’observent les soldes nets de jetons qu’avant et après l’appel ; aucun suivi du solde n’est requis du côté de l’appelant.

Q : Est-il sécuritaire d’appeler burn() directement sur le contrat du pool ? R : Non, sauf si vous êtes le bénéficiaire des frais ou si vous disposez d'un contrôle de gouvernance. Seul le destinataire des frais désigné peut appeler Burn pour balayer les frais du protocole. Les appels non autorisés sont annulés.