IntegrationsQuick StartV3

V3

Before you begin, ensure you have the following installed:

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