Nahtlose Integration mit KLAYswap V2: Ein umfassender Leitfaden für Smart-Contract-Entwickler

Durch die programmgesteuerte Integration von KLAYswap in Smart Contracts können Benutzer Token innerhalb dezentraler Anwendungen nahtlos kaufen und verkaufen. Dieses Tutorial konzentriert sich auf die Verwendung von KLAYswap V2 und bietet Methoden zum Austausch von Token im Klaytn Cypress (Mainnet)-Netzwerk. Der KLAYswap UniversalRouter bietet verschiedene Methoden wie swapExactETHForTokens, swapExactTokensForTokens und swapExactTokensForETH, um diesen Austausch zu erleichtern. Benutzer müssen dem Router den Zugriff auf die angegebene Anzahl an Token genehmigen, bevor sie einen Austausch initiieren. Dieses Handbuch enthält ein voll funktionsfähiges Beispiel, Anweisungen zum Bereitstellen des MiniKLAYswap-Vertrags mithilfe der Thirdweb-CLI sowie Schritt-für-Schritt-Anweisungen zum Ausführen von Swap-Vorgängen mithilfe des Dashboards und von Klaytnscope.

Integrating KLAYswap V2 into Smart Contracts: A Comprehensive Guide for Developers

Integration von KLAYswap V2 in Smart Contracts: Ein umfassender Leitfaden für Entwickler

Introduction

Einführung

For developers seeking to enhance the functionality of their decentralized applications (dApps), integrating automated market maker (AMM) protocols such as KLAYswap becomes crucial. This integration enables the seamless swapping of tokens within dApps, enhancing user experience and expanding service offerings.

Für Entwickler, die die Funktionalität ihrer dezentralen Anwendungen (dApps) verbessern möchten, ist die Integration von AMM-Protokollen (Automated Market Maker) wie KLAYswap von entscheidender Bedeutung. Diese Integration ermöglicht den nahtlosen Austausch von Token innerhalb von dApps, verbessert das Benutzererlebnis und erweitert das Serviceangebot.

Understanding KLAYswap

KLAYswap verstehen

KLAYswap is an AMM protocol designed specifically for the Klaytn network. It operates as a decentralized exchange (DEX), facilitating instant token swaps by relying on on-chain liquidity pools established by liquidity providers. Unlike traditional order book structures, KLAYswap's liquidity pools allow users to trade tokens directly with the pool, eliminating the need for counterparties.

KLAYswap ist ein AMM-Protokoll, das speziell für das Klaytn-Netzwerk entwickelt wurde. Sie fungiert als dezentrale Börse (DEX) und ermöglicht den sofortigen Token-Austausch, indem sie sich auf von Liquiditätsanbietern eingerichtete On-Chain-Liquiditätspools stützt. Im Gegensatz zu herkömmlichen Orderbuchstrukturen ermöglichen die Liquiditätspools von KLAYswap den Benutzern den direkten Handel mit Tokens mit dem Pool, sodass keine Gegenparteien erforderlich sind.

Benefits of Integrating KLAYswap V2

Vorteile der Integration von KLAYswap V2

Integrating KLAYswap V2 into smart contracts provides numerous advantages:

Die Integration von KLAYswap V2 in Smart Contracts bietet zahlreiche Vorteile:

• Seamless Token Swapping: Users can conveniently swap tokens directly within your dApp without leaving the interface.
• Enhanced User Experience: By incorporating KLAYswap, you can offer users a more intuitive and efficient trading experience.
• Expanded Functionality: Integrate additional services around specific ERC20 and KIP7 tokens, such as enabling token purchases or lending.

Technical Integration Details

Nahtloser Token-Austausch: Benutzer können Token bequem direkt in Ihrer dApp austauschen, ohne die Benutzeroberfläche zu verlassen. Verbesserte Benutzererfahrung: Durch die Integration von KLAYswap können Sie Benutzern ein intuitiveres und effizienteres Handelserlebnis bieten. Erweiterte Funktionalität: Integrieren Sie zusätzliche Dienste rund um bestimmte ERC20- und KIP7-Token , wie zum Beispiel das Ermöglichen von Token-Käufen oder -Leihungen.Technische Integrationsdetails

To programmatically integrate KLAYswap V2 into your smart contract, follow these steps:

Um KLAYswap V2 programmgesteuert in Ihren Smart Contract zu integrieren, befolgen Sie diese Schritte:

1. Prerequisites:

1. Voraussetzungen:

• Proficiency in smart contract development.
• Familiarity with smart contract development environments (e.g., thirdweb).

2. KLAYswap Universal Router:

Kenntnisse in der Entwicklung intelligenter Verträge. Vertrautheit mit Entwicklungsumgebungen für intelligente Verträge (z. B. Thirdweb).2. KLAYswap Universal-Router:

• Utilize the KLAYswap router to access a range of methods for secure token swapping.
• Before executing any swap method, the user must authorize the router to access the desired amount of tokens.

3. Token Swap Methods:

Nutzen Sie den KLAYswap-Router, um auf eine Reihe von Methoden für den sicheren Token-Austausch zuzugreifen. Bevor Sie eine Austauschmethode ausführen, muss der Benutzer den Router autorisieren, auf die gewünschte Menge an Token zuzugreifen.3. Token-Swap-Methoden:

• swapExactETHForTokens: Swaps an exact amount of KLAY for tokens, maximizing the output tokens along the specified path.
• swapExactTokensForTokens: Swaps an exact amount of input tokens for tokens, maximizing the output tokens along the specified path.
• swapExactTokensForETH: Swaps an exact amount of tokens for ETH, maximizing the ETH output along the specified path.

4. Fully Working Example:

swapExactETHForTokens: Tauscht eine genaue Menge an KLAY gegen Tokens aus und maximiert so die Ausgabe-Tokens entlang des angegebenen Pfads ETH, Maximierung der ETH-Ausgabe entlang des angegebenen Pfads.4. Voll funktionsfähiges Beispiel:

// Sample smart contract showcasing KLAYswap operations
// Beispiel eines Smart-Vertrags, der KLAYswap-Operationen demonstriert
pragma solidity ^0.8.20;
Pragma-Solidität ^0.8.20;

interface IKlaySwapRouterV2 {
Schnittstelle IKlaySwapRouterV2 {
    struct SwapParams {
struct SwapParams {
        address to;
richten an;
        address[] path;
Adresse[] Pfad;
        address[] pool;
Adresse[]-Pool;
        uint deadline;
uint Frist;
    }
}
}
}

    function swapExactTokensForTokens(
Funktion swapExactTokensForTokens(
        uint256 amountIn,
uint256 amountIn,
        uint256 amountOutMin,
uint256 amountOutMin,
        SwapParams calldata p
SwapParams-Aufrufdaten S
arams
SwapParams Aufrufdatenparameter
    ) external returns (uint256[] memory amounts);
) externe Rückgaben (uint256[] Speichermengen);
    function swapExactETHForTokens(
Funktion swapExactETHForTokens(
        uint256 amountOutMin,
uint256 amountOutMin,
        SwapParams calldata p
SwapParams-Aufrufdaten S
    ) external payable returns (uint256[] memory amounts);
) extern zahlbare Rückgaben (uint256[] Speicherbeträge);
    function swapExactTokensForETH(
Funktion swapExactTokensForETH(
        uint256 amountIn,
uint256 amountIn,
        uint256 amountOutMin,
uint256 amountOutMin,
        SwapParams calldata p
SwapParams-Aufrufdaten S
    ) external returns (uint256[] memory amounts);
) externe Rückgaben (uint256[] Speichermengen);
}
}

interface IERC20 {
Schnittstelle IERC20 {
    function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
Funktion transferFrom(Adresse Absender, Adresse Empfänger, uint256 Betrag) externe Rückgaben (bool);
    function approve(address spender, uint256 amount) external returns (bool);
Funktion genehmigen(Adresse Spender, uint256 Betrag) externe Rückgaben (bool);
}
}

contract MiniKLAYSwap {
Vertrag MiniKLAYSwap {
    address public constant routerAddress = 0xe0fbB27D0E7F3a397A67a9d4864D4f4DD7cF8cB9;
Adresse öffentliche Konstante routerAddress = 0xe0fbB27D0E7F3a397A67a9d4864D4f4DD7cF8cB9;
    address public constant MBX_TOKEN_ADDRESS = 0xD068c52d81f4409B9502dA926aCE3301cc41f623;
öffentliche Adresskonstante MBX_TOKEN_ADDRESS = 0xD068c52d81f4409B9502dA926aCE3301cc41f623;
    address public constant sKAI_TOKEN_ADDRESS = 0x37d46C6813B121d6A27eD263AeF782081ae95434;
öffentliche Adresskonstante sKAI_TOKEN_ADDRESS = 0x37d46C6813B121d6A27eD263AeF782081ae95434;
    address public constant WKLAY_ADDRESS = 0x19Aac5f612f524B754CA7e7c41cbFa2E981A4432;
öffentliche Adresskonstante WKLAY_ADDRESS = 0x19Aac5f612f524B754CA7e7c41cbFa2E981A4432;

    IKlaySwapRouterV2 public immutable swapRouter = IKlaySwapRouterV2(routerAddress);
IKlaySwapRouterV2 public unveränderlicher swapRouter = IKlaySwapRouterV2(routerAddress);
    IERC20 public immutable MBX_TOKEN = IERC20(MBX_TOKEN_ADDRESS);
IERC20 public unveränderlich MBX_TOKEN = IERC20(MBX_TOKEN_ADDRESS);
    IERC20 public immutable SKAI_TOKEN = IERC20(sKAI_TOKEN_ADDRESS);
IERC20 public unveränderlich SKAI_TOKEN = IERC20(sKAI_TOKEN_ADDRESS);

    address[] private pool = [address(0)];
Adresse[] privater Pool = [Adresse(0)];
    address[] private path = [MBX_TOKEN_ADDRESS, WKLAY_ADDRESS];
Adresse[] privater Pfad = [MBX_TOKEN_ADDRESS, WKLAY_ADDRESS];
    address[] private path1 = [WKLAY_ADDRESS, sKAI_TOKEN_ADDRESS];
Adresse[] privater Pfad1 = [WKLAY_ADDRESS, sKAI_TOKEN_ADDRESS];
    address[] private path2 = [sKAI_TOKEN_ADDRESS, WKLAY_ADDRESS];
Adresse[] privater Pfad2 = [sKAI_TOKEN_ADDRESS, WKLAY_ADDRESS];

    function swapExactTokensForTokens(
Funktion swapExactTokensForTokens(
uint256 amountIn) external returns (uint256[] memory amountOut) {
        MBX_TOKEN.transferFrom(msg.sender, address(this), amountIn);
MBX_TOKEN.transferFrom(msg.sender, address(this), amountIn);
        MBX_TOKEN.approve(address(swapRouter), amountIn);
MBX_TOKEN.approve(address(swapRouter), amountIn);

        IKlaySwapRouterV2.SwapParams memory params = IKlaySwapRouterV2.SwapParams(
IKlaySwapRouterV2.SwapParams Speicherparameter = IKlaySwapRouterV2.SwapParams(
            to: msg.sender,
an: msg.sender,
            path: path,
Pfad: Pfad,
            pool: pool,
Pool: Pool,
            deadline: block.timestamp
Frist: block.timestamp
        );
);

        amountOut = swapRouter.swapExactTokensForTokens(amountIn, 1, params);
amountOut = swapRouter.swapExactTokensForTokens(amountIn, 1, params);
    }
}
}
}


    function swapExactKLAYForTokens() external payable returns (uint256[] memory amountOut) {
Funktion swapExactKLAYForTokens() externe zahlbare Rückgabe (uint256[] SpeicherbetragOut) {
        IKlaySwapRouterV2.SwapParams memory params = IKlaySwapRouterV2.SwapParams(
IKlaySwapRouterV2.SwapParams Speicherparameter = IKlaySwapRouterV2.SwapParams(
            to: msg.sender,
an: msg.sender,
            path: path1,
Pfad: Pfad1,
            pool: pool,
Pool: Pool,
            deadline: block.timestamp
Frist: block.timestamp
        );
);

        amountOut = swapRouter.swapExactETHForTokens{value: msg.value}
}
(1, params);
    }
}
}
}


    function swapExactTokensForKLAY(uint256 amountIn) external returns (uint256[] memory amountOut) {
Funktion swapExactTokensForKLAY(uint256 amountIn) external gibt (uint256[] Memory amountOut) {
        SKAI_TOKEN.transferFrom(msg.sender, address(this), amountIn);
SKAI_TOKEN.transferFrom(msg.sender, address(this), amountIn);
        SKAI_TOKEN.approve(address(swapRouter), amountIn);
SKAI_TOKEN.approve(address(swapRouter), amountIn);

        IKlaySwapRouterV2.SwapParams memory params = IKlaySwapRouterV2.SwapParams(
IKlaySwapRouterV2.SwapParams Speicherparameter = IKlaySwapRouterV2.SwapParams(
            to: msg.sender,
an: msg.sender,
            path: path2,
Pfad: Pfad2,
            pool: pool,
Pool: Pool,
            deadline: block.timestamp
Frist: block.timestamp
        );
);

        amountOut = swapRouter.swapExactTokensForETH(amountIn, 1, params);
amountOut = swapRouter.swapExactTokensForETH(amountIn, 1, params);
    }
}
}
}

}
}

5. Deploying MiniKLAYswap.sol using thirdweb CLI:

Utilize the thirdweb CLI to deploy the MiniKLAYswap.sol contract. Provide a project name and select your desired framework (Hardhat or Foundry). For this example, choose the Empty base contract option.

Nutzen Sie die Thirdweb-CLI, um den MiniKLAYswap.sol-Vertrag bereitzustellen. Geben Sie einen Projektnamen ein und wählen Sie Ihr gewünschtes Framework (Hardhat oder Foundry) aus. Wählen Sie für dieses Beispiel die Option Basisvertrag leeren.

6. Performing the Swap Operation:

6. Durchführen der Swap-Operation:

To execute the swap operations, navigate to the explorer tab of your deployed MiniKLAYswap contract on the thirdweb dashboard. Select the appropriate swap method (e.g., swapExactKLAYForTokens) and provide the necessary input parameters. Click 'Execute' to perform the swap.

Um die Tauschvorgänge auszuführen, navigieren Sie im Thirdweb-Dashboard zur Explorer-Registerkarte Ihres bereitgestellten MiniKLAYswap-Vertrags. Wählen Sie die entsprechende Swap-Methode aus (z. B. swapExactKLAYForTokens) und geben Sie die erforderlichen Eingabeparameter an. Klicken Sie auf „Ausführen“, um den Austausch durchzuführen.

7. Verifying the Swap Operation:

7. Überprüfung des Swap-Vorgangs:

To verify the swap, paste the transaction hash into the Klaytnscope search bar. This will display the details of the transaction, including the swapped token amounts.

Um den Tausch zu überprüfen, fügen Sie den Transaktions-Hash in die Klaytnscope-Suchleiste ein. Dadurch werden die Details der Transaktion angezeigt, einschließlich der ausgetauschten Token-Beträge.

Conclusion

Abschluss

By integrating KLAYswap V2 into your smart contracts, you empower users to seamlessly swap tokens within your dApp. This enhances the user experience and opens up new possibilities for token-related services.

Durch die Integration von KLAYswap V2 in Ihre Smart Contracts ermöglichen Sie Benutzern den nahtlosen Austausch von Token innerhalb Ihrer dApp. Dies verbessert das Benutzererlebnis und eröffnet neue Möglichkeiten für Token-bezogene Dienste.

For further exploration and guidance, refer to the Klaytn Docs and KLAYswap Docs. If you encounter any queries, engage with the Klaytn Forum for assistance. Stay tuned for Part 2 of this tutorial, where we will delve into building a minimalistic frontend to interact with the MiniKLAYswap contract using thirdweb and Next.js.

Weitere Informationen und Anleitungen finden Sie in den Klaytn-Dokumenten und KLAYswap-Dokumenten. Wenn Sie Fragen haben, wenden Sie sich an das Klaytn-Forum, um Hilfe zu erhalten. Seien Sie gespannt auf Teil 2 dieses Tutorials, in dem wir uns mit der Erstellung eines minimalistischen Frontends für die Interaktion mit dem MiniKLAYswap-Vertrag mithilfe von Thirdweb und Next.js befassen.