Practical overview
When it fits
Use it when an application needs the documented Uniswap v3 peripheral interfaces or when local testing requires deployment from the published package artifacts.
Who it is for
- Solidity developers integrating a Uniswap v3 swap-router interface.
- Application developers importing Uniswap v3 contract ABIs and bytecode.
- Teams testing Uniswap v3-compatible applications against local deployments.
Documented uses
- Import the `ISwapRouter` interface into a Solidity contract.
- Call the documented router integration point, including the example `exactInput` operation.
- Deploy packaged SwapRouter bytecode to a local testnet.
- Use npm artifacts in application or developer tooling.
Requirements & limits
The repository is publicly accessible, open source and licensed under GPL-2.0. The supplied material documents npm package installation and local-testnet deployment prerequisites; it does not provide account or pricing information.
- The package provides both contract artifacts and Solidity interfaces, supporting separate deployment and integration workflows.
- The documented local-deployment flow uses bytecode from
@uniswap/v3-periphery/artifacts/contracts/*/*.json. - The example imports
ISwapRouter.soland referencesexactInput(...), but does not constitute a complete production-ready integration. - The repository covers peripheral contracts; the README directs readers to a separate repository for lower-level Uniswap v3 core contracts.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up a local deployment from the npm artifacts
Prepare a local Uniswap v3-compatible testing deployment using the packaged SwapRouter bytecode.
Before you start
- The
@uniswap/v3-peripherynpm package. - A local testnet environment.
- A TypeScript application or deployment script that can import package artifacts.
Steps
Install the
@uniswap/v3-peripherynpm package.Import the ABI and bytecode from
@uniswap/v3-periphery/artifacts/contracts/SwapRouter.sol/SwapRouter.json.Use the imported bytecode to deploy the SwapRouter contract to the local testnet.
Expected outcome
A local deployment based on the packaged SwapRouter artifact, intended to interoperate with Uniswap code in the local environment.
Guide limitations
- The documentation does not identify supported local testnet implementations or networks.
- The setup instructions do not document a complete application test or swap execution procedure.
Add the documented swap-router interface to a Solidity contract
Create a contract integration point for calling the Uniswap v3 swap router interface.
Before you start
- A Solidity smart-contract project.
- The
@uniswap/v3-peripherynpm artifact. - A contract that declares an
ISwapRouterrouter reference.
Steps
Install or otherwise make the
@uniswap/v3-peripherynpm artifact available to the Solidity project.Import
@uniswap/v3-periphery/contracts/interfaces/ISwapRouter.sol.Declare an
ISwapRouterrouter reference in the contract.Use the documented
exactInput(...)call pattern where the contract's integration requires it.
Expected outcome
A Solidity contract containing the documented interface-based integration point for a Uniswap v3 swap router.
Guide limitations
- The example does not establish a complete production-ready integration.
- The documentation does not provide the remaining application logic or transaction-specific configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 2 October 2026
- Original website title
- Uniswap/v3-periphery · Official homepage title · retained in its source language

