IntegrationsQuick StartV3

V3

Requirements

Before you begin, ensure you have the following installed:

  • Node.js (v16 or higher) and npm

  • Git for version control

  • A code editor (e.g., VS Code)

  • A wallet with testnet funds (e.g., Metamask) connected to the HyperEVM testnet

1. Clone the Repository

Start by cloning the Hyperswap integration repository:

git clone https://github.com/HyperSwapX/how-tos-v3.git
cd <your-repo-name>

2. Install Dependencies

npm install
// Or 
yarn install

3. Configure Your Environment

Create a .env file in the root of the project and add the following variables:

PRIVATE_KEY=0xYourPrivateKey
RPC_URL=https://api.YourProviderUrl.xyz/
ROUTER_V3_ADDRESS=0xRouterV3Address
IN_ADDRESS=0xTheTokenYouWishToSell
OUT_ADDRESS=0xTheTokenYouWishToBuy

4. Write Your First Integration

Swap With V3

6. Testing Your Integration

  • Use the HyperEVM Testnet to avoid spending real tokens during development.

  • You can acquire testnet funds from a faucet (e.g., HyperEVM Faucet).

7. Next Steps

  • Explore more advanced functionality like event listening or automation.

  • Build a frontend using React or integrate Hyperswap with your backend service.

For more detailed examples, visit the Templates And Use Cases section.

On this page