feat: add Uniswap V3 Periphery with Hardhat CI harness (#286)

* feat: add Uniswap V3 Periphery with Hardhat CI harness

Adds the polkadot-cookbook test harness for the Uniswap V3 Periphery
with EVM on Polkadot Hub tutorial. The harness clones revm-hardhat-examples
at pinned commit 96696ad15c3cf01b9168a71ad5114f27c34a8726, installs
dependencies (resolving the local @uniswap/v3-core file reference
automatically), compiles the SwapRouter and NonfungiblePositionManager
contracts, runs the full 39-test Hardhat suite on the local Hardhat
network, and optionally deploys via Hardhat Ignition to polkadotTestnet.

* docs: add Uniswap V3 Periphery entry to polkadot-docs README table

Author: sekisamu

.github/workflows/polkadot-docs-uniswap-v3-periphery-hardhat.yml

@@ -0,0 +1,57 @@
+name: Uniswap V3 Periphery with Hardhat
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/**'
+      - '!polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/README.md'
+  pull_request:
+    paths:
+      - 'polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/**'
+      - '!polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/README.md'
+  workflow_dispatch:
+
+jobs:
+  test:
+    if: github.repository == 'polkadot-developers/polkadot-cookbook'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Cache npm dependencies (upstream uniswap-v3-periphery-hardhat)
+        uses: actions/cache@v4
+        with:
+          path: |
+            polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/.test-workspace/revm-hardhat-examples/uniswap-v3-periphery-hardhat/node_modules
+          key: ${{ runner.os }}-uniswap-v3-periphery-hardhat-npm-${{ hashFiles('polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/tests/docs.test.ts') }}
+
+      - name: Install wrapper dependencies
+        run: |
+          cd polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat
+          npm ci
+
+      - name: Run tests
+        run: |
+          cd polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat
+          npm test
+        env:
+          TESTNET_PRIVATE_KEY: ${{ secrets.TESTNET_PRIVATE_KEY }}
+        timeout-minutes: 30
+
+  post-test:
+    needs: test
+    if: github.repository == 'polkadot-developers/polkadot-cookbook' && always() && github.ref == 'refs/heads/master'
+    uses: ./.github/workflows/post-cleanup.yml
+    with:
+      test_result: ${{ needs.test.result }}
+      readme_path: 'polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/README.md'
+      workflow_name: 'Uniswap V3 Periphery with Hardhat'
+    permissions:
+      contents: read
+      issues: write

polkadot-docs/README.md

@@ -62,6 +62,7 @@ This repository serves as the **source of truth** that Polkadot documentation wo
 | [Uniswap V2 Core with Hardhat](./smart-contracts/uniswap-v2-core-hardhat/) | [![Uniswap V2 Core with Hardhat](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v2-core-hardhat.yml/badge.svg?event=push)](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v2-core-hardhat.yml) | [docs.polkadot.com](https://docs.polkadot.com/smart-contracts/cookbook/eth-dapps/uniswap-v2/core-v2/) |
 | [Uniswap V2 Periphery with Hardhat](./smart-contracts/uniswap-v2-periphery-hardhat/) | [![Uniswap V2 Periphery with Hardhat](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v2-periphery-hardhat.yml/badge.svg?event=push)](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v2-periphery-hardhat.yml) | [docs.polkadot.com](https://docs.polkadot.com/smart-contracts/cookbook/eth-dapps/uniswap-v2/periphery-v2/) |
 | [Uniswap V3 Core with Hardhat](./smart-contracts/uniswap-v3-core-hardhat/) | [![Uniswap V3 Core with Hardhat](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-core-hardhat.yml/badge.svg?event=push)](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-core-hardhat.yml) | [docs.polkadot.com](https://docs.polkadot.com/smart-contracts/cookbook/eth-dapps/uniswap-v3/core-v3/) |
+| [Uniswap V3 Periphery with Hardhat](./smart-contracts/uniswap-v3-periphery-hardhat/) | [![Uniswap V3 Periphery with Hardhat](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-periphery-hardhat.yml/badge.svg?event=push)](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-periphery-hardhat.yml) | [docs.polkadot.com](https://docs.polkadot.com/smart-contracts/cookbook/eth-dapps/uniswap-v3/periphery-v3/) |
 
 ## How It Works
 

polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/.gitignore

@@ -0,0 +1,2 @@
+.test-workspace/
+node_modules/

polkadot-docs/smart-contracts/uniswap-v3-periphery-hardhat/README.md

@@ -0,0 +1,50 @@
+---
+title: "Uniswap V3 Periphery with Hardhat"
+description: "Verify the Uniswap V3 Periphery with Hardhat guide from docs.polkadot.com"
+source_url: "https://docs.polkadot.com/smart-contracts/cookbook/eth-dapps/uniswap-v3/periphery-v3/"
+source_repo: "https://github.com/polkadot-developers/polkadot-docs/blob/master/smart-contracts/cookbook/eth-dapps/uniswap-v3/periphery-v3.md"
+---
+
+# Uniswap V3 Periphery with Hardhat
+
+[![Uniswap V3 Periphery with Hardhat](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-periphery-hardhat.yml/badge.svg?event=push)](https://github.com/polkadot-developers/polkadot-cookbook/actions/workflows/polkadot-docs-uniswap-v3-periphery-hardhat.yml)
+
+This project verifies the Uniswap V3 Periphery with Hardhat guide from docs.polkadot.com.
+
+The tests run against [revm-hardhat-examples](https://github.com/polkadot-developers/revm-hardhat-examples) at a pinned commit, compiling and testing the Uniswap V3 Periphery contracts (SwapRouter and NonfungiblePositionManager) on Hardhat's local network and deploying all four contracts via Hardhat Ignition to Polkadot Hub TestNet.
+
+## What This Tests
+
+1. **Environment Prerequisites** - Verifies Node.js v22+, npm, and git are available
+2. **Clone Repository** - Clones `revm-hardhat-examples` at the pinned commit and verifies the expected project structure (SwapRouter, NonfungiblePositionManager, Ignition module)
+3. **Install Dependencies** - Installs `uniswap-v3-periphery-hardhat` dependencies (resolves the local `@uniswap/v3-core` file reference automatically) and confirms Hardhat is available
+4. **Configure Testnet Credentials** - Verifies `TESTNET_PRIVATE_KEY` is available (skipped when not set)
+5. **Compile Contracts** - Runs `npx hardhat compile` and verifies the `SwapRouter.json` and `NonfungiblePositionManager.json` artifacts (ABI + bytecode)
+6. **Run Hardhat Tests** - Runs the full Hardhat test suite (39 tests: 14 SwapRouter + 25 NFPM) on the local Hardhat network
+7. **Deploy via Ignition** - Deploys UniswapV3Factory, WETH9, SwapRouter, and NonfungiblePositionManager using Hardhat Ignition to `polkadotTestnet` and verifies contract addresses are returned
+
+## Prerequisites
+
+- Node.js v22.13.1 or later
+- npm
+- git
+- A funded account on Polkadot Hub TestNet (get tokens from the [Polkadot Faucet](https://faucet.polkadot.io/))
+
+## Running Tests Locally
+
+```bash
+# 1. Export testnet private key (RPC URL is hardcoded in hardhat.config.ts)
+export TESTNET_PRIVATE_KEY="<your-private-key>"
+
+# 2. Install wrapper dependencies
+npm install
+
+# 3. Run all verification tests
+npm test
+```
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `TESTNET_PRIVATE_KEY` | Private key of a funded account (no `0x` prefix) |