Wie interagiere ich direkt mit einem Uniswap V3-Vertrag?

Grundlegendes zur Uniswap V3-Vertragsarchitektur

1. Uniswap V3 führt konzentrierte Liquidität ein und ermöglicht es Liquiditätsanbietern, Kapital innerhalb benutzerdefinierter Preisspannen statt über die gesamte Kurve zu verteilen.

2. Der Kernvertrag ist UniswapV3Pool , der Swaps, Liquiditätsprägung und Positionsmanagement auf On-Chain-Ebene abwickelt.

3. Jeder Pool wird als separater unveränderlicher Vertrag mit festen Parametern bereitgestellt: Token0, Token1, Gebührenstufe und Tick-Abstand.

4. Der NonfungiblePositionManager dient als übergeordnete Schnittstelle zur Verwaltung von NFT-basierten Liquiditätspositionen.

5. Alle Interaktionen erfordern eine präzise Codierung der Anrufdaten, eine korrekte Slippage-Behandlung und die Einhaltung der genauen Funktionssignaturen, die im offiziellen ABI definiert sind.

Direkte Vertragsinteraktion einrichten

1. Rufen Sie die genaue Pooladresse mithilfe der getPool- Funktion aus dem UniswapV3Factory-Vertrag mit sortierten Token-Adressen und Gebührenstufe ab.

2. Instanziieren Sie den Pool-Vertrag bei Ihrem Web3-Anbieter mithilfe seines ABI und der bereitgestellten Adresse – für direkte Aufrufe ist kein Proxy oder Factory-Abstraktion erforderlich.

3. Stellen Sie sicher, dass in Ihrem Wallet ausreichend ETH für Benzin und die erforderlichen Token für den beabsichtigten Vorgang – Swap oder Liquiditätsbereitstellung – vorhanden sind.

4. Verwenden Sie ethers.js oder web3.py , um Rohtransaktionen mit der richtigen Nonce-, Gaslimit- und Ketten-ID-Ausrichtung zu erstellen.

5. Überprüfen Sie die Tick-Grenzen, bevor Sie eine liquiditätsbezogene Transaktion einreichen. Der Pool lehnt Positionen ab, die außerhalb des gültigen Tick-Bereichs liegen oder nicht mit dem Tick-Abstand übereinstimmen.

Ausführen eines Swaps per Raw Call

1. Rufen Sie Swap für den Poolvertrag mit folgenden Parametern auf: Empfänger, ZeroForOne-Flag, amountSpecified, sqrtPriceLimitX96 und Daten.

2. Berechnen Sie sqrtPriceLimitX96 sorgfältig – es muss unbedingt größer als der aktuelle Preis für „zeroForOne = false“ oder kleiner für „true“ sein.

3. Übergeben Sie ein leeres Byte-Array als Daten , es sei denn, Sie implementieren einen benutzerdefinierten Rückrufvertrag. Bei den meisten direkten Swaps wird dieses Feld weggelassen.

4. Überwachen Sie die zurückgegebenen Werte „amount0“ und „amount1“ , um das Ausführungsergebnis zu bestätigen – diese spiegeln die Netto-Token-Deltas nach Gebühren wider.

5. Das Rückfallrisiko steigt, wenn die Transaktion keine ausreichende Slippage-Toleranz durch sqrtPriceLimitX96 vorgibt, was zu einer vorzeitigen Beendigung führt.

Liquiditätspositionen manuell verwalten

1. Prägen Sie die Liquidität, indem Sie „Mint“ auf NonfungiblePositionManager mit tickLower, tickUpper, amount0Desired, amount1Desired und Deadline aufrufen.

2. Jede Position wird als eindeutiger ERC-721-Token dargestellt – seine ID ist für nachfolgende Erhöhungs-/Verringerungs-/Sammelvorgänge unerlässlich.

3. Um einer bestehenden Position mehr Liquidität hinzuzufügen, rufen Sie raiseLiquidity mit denselben Tick-Grenzen und neuen Beträgen auf.

4. Für den Abzug sind zwei Schritte erforderlich: Rufen Sie zunächst „reductionLiquidity“ auf, um einen Teil der NFT-Position zu vernichten, und rufen Sie dann „Collect“ auf, um aufgelaufene Gebühren und Kapitaltoken abzuheben.

5. Erfolgt die Einziehung nach abnehmender Liquidität nicht, verbleiben die Token im Pool-Vertrag, bis sie explizit abgerufen werden.

Häufig gestellte Fragen

F: Kann ich wechseln, ohne den Uniswap-Router zu genehmigen? A: Ja – Sie können direkt mit dem Poolvertrag interagieren und Router vollständig umgehen. Eine Genehmigung ist nur erforderlich, wenn die ERC-20-TransferFrom-Logik verwendet wird, beispielsweise mit dem NonfungiblePositionManager oder SwapRouter.

F: Was passiert, wenn ich sqrtPriceLimitX96 auf Null setze? A: Die Transaktion wird sofort rückgängig gemacht. Dieser Wert muss eine ordnungsgemäß formatierte Q64.96-Festkommazahl ungleich Null sein, die eine gültige Preisgrenze darstellt.

F: Muss ich die Flash-Buchhaltung beim Austausch manuell verwalten? A: Nein – die Flash-Buchhaltung ist Bestandteil des Poolvertrags. Externe Anrufer beobachten nur die Netto-Token-Salden vor und nach dem Anruf; Auf Anruferseite ist keine Kontostandverfolgung erforderlich.

F: Ist es sicher, burn() direkt im Poolvertrag aufzurufen? A: Nicht, es sei denn, Sie sind der Gebührenempfänger oder haben die Kontrolle über die Governance. Nur der benannte Gebührenempfänger kann die Protokollgebühren für das Burn- to-Sweep-Protokoll in Anspruch nehmen. Nicht autorisierte Anrufe werden wiederhergestellt.