chore: add deployment + smoke-test scripts and BSC testnet record

- scripts/deploy.ts: deploy Factory + Router02, write deployments/<net>.json,
  and assert keccak256(ListaV2Pair.creationCode) == library init-code hash
- scripts/create-pair.ts: create a pair (env TOKEN_A/TOKEN_B), verify the
  on-chain address matches the CREATE2 derivation
- scripts/smoke-test.ts: read-only smoke tests + init-code-hash verification
- scripts/smoke-swap.ts: live add-liquidity + swap E2E (both token and native paths)
- scripts/lib/deployments.ts: load/save deployment records
- deployments/bscTestnet.json: deployed + verified Factory/Router02/WBNB-USDT pair
- hardhat.config.ts: bscTestnet network + Etherscan V2 verification; load .env
- README: Deployment section + BSC testnet addresses

.env is gitignored (never committed). Full suite: 126 passing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: razww

README.md

@@ -64,6 +64,46 @@ npm run compile   # hardhat compile
 npm test          # hardhat test
 ```
 
+## Deployment
+
+Scripts live in `scripts/` and record addresses to `deployments/<network>.json`.
+Configure `.env` (see the keys read by `hardhat.config.ts`): `PRIVATE_KEY_TESTNET`,
+`BSC_TESTNET_RPC_URL`, and `ETHERSCAN_API_KEY` (Etherscan V2 unified key, used for
+BscScan verification).
+
+```bash
+# deploy Factory + Router02 and write deployments/<net>.json
+npx hardhat run scripts/deploy.ts --network bscTestnet
+
+# create a pair (defaults WBNB/USDT; override TOKEN_A / TOKEN_B)
+npx hardhat run scripts/create-pair.ts --network bscTestnet
+
+# verify on the block explorer (Etherscan V2 API)
+npx hardhat verify --network bscTestnet <factory> <feeToSetter>
+npx hardhat verify --network bscTestnet <router> <factory> <WETH>
+
+# read-only smoke tests + init-code-hash check
+npx hardhat run scripts/smoke-test.ts --network bscTestnet
+# live end-to-end (adds liquidity + swaps; spends testnet funds)
+npx hardhat run scripts/smoke-swap.ts --network bscTestnet
+```
+
+`ListaV2Pair` is never deployed directly — the factory creates it via CREATE2, so
+`scripts/deploy.ts` verifies `keccak256(type(ListaV2Pair).creationCode)` matches the
+hash hardcoded in `ListaV2Library.pairFor`. Production deployments must use the exact
+compiler settings in `hardhat.config.ts` (solc 0.5.16, optimizer 999999, istanbul),
+or that hash — and every derived pair address — changes.
+
+### BSC testnet (chainId 97)
+
+| Contract | Address |
+| --- | --- |
+| ListaV2Factory | `0xD5397504095C424325416f0c83c42F5805626c54` |
+| ListaV2Router02 | `0x0B8306e6ad72Bf95538feB9fc29C8673eAe5785f` |
+| Pair WBNB/USDT | `0xd3ECad4ef152727581c238Fe73cE7443293Cb99B` |
+
+All three are verified on [testnet.bscscan.com](https://testnet.bscscan.com).
+
 ## License
 
 GPL-3.0-or-later (unchanged from upstream).

deployments/bscTestnet.json

@@ -0,0 +1,17 @@
+{
+  "network": "bscTestnet",
+  "chainId": 97,
+  "deployer": "0x6616EF47F4d997137a04C2AD7FF8e5c228dA4f06",
+  "feeToSetter": "0x6616EF47F4d997137a04C2AD7FF8e5c228dA4f06",
+  "factory": "0xD5397504095C424325416f0c83c42F5805626c54",
+  "router02": "0x0B8306e6ad72Bf95538feB9fc29C8673eAe5785f",
+  "WETH": "0xae13d989daC2f0dEbFf460aC112a837C89BAa7cd",
+  "pairInitCodeHash": "0x20adb33eb0c20d289945602eca3d6797bfe1b2555b1f251a8855fc5bb3ceea3d",
+  "pairs": {
+    "WBNB/USDT": {
+      "address": "0xd3ECad4ef152727581c238Fe73cE7443293Cb99B",
+      "token0": "0x49b1401B4406Fe0B32481613bF1bC9Fe4B9378aC",
+      "token1": "0xae13d989daC2f0dEbFf460aC112a837C89BAa7cd"
+    }
+  }
+}

hardhat.config.ts

@@ -1,5 +1,15 @@
 import { HardhatUserConfig } from "hardhat/config";
 import "@nomiclabs/hardhat-waffle";
+import "@nomicfoundation/hardhat-verify";
+import * as dotenv from "dotenv";
+
+dotenv.config();
+
+// Normalize the deployer key (hardhat wants a 0x-prefixed hex private key).
+const rawKey = process.env.PRIVATE_KEY_TESTNET || "";
+const testnetKey = rawKey ? [rawKey.startsWith("0x") ? rawKey : `0x${rawKey}`] : [];
+const bscTestnetRpc =
+  process.env.BSC_TESTNET_RPC_URL || "https://bsc-testnet-dataseed.bnbchain.org";
 
 /**
  * Uniswap V2 uses two Solidity versions:
@@ -34,6 +44,15 @@ const config: HardhatUserConfig = {
       // setup txs don't drift past the anchored start time.
       allowBlocksWithSameTimestamp: true,
     },
+    bscTestnet: {
+      url: bscTestnetRpc,
+      chainId: 97,
+      accounts: testnetKey,
+    },
+  },
+  etherscan: {
+    // Etherscan V2 unified API — a single key routes to BSC by chainId.
+    apiKey: process.env.ETHERSCAN_API_KEY || process.env.BSCSCAN_API_KEY || "",
   },
   paths: {
     sources: "./contracts",

package-lock.json

@@ -15,12 +15,14 @@
     "@uniswap/lib": "4.0.1-alpha"
   },
   "devDependencies": {
+    "@nomicfoundation/hardhat-verify": "^2.1.3",
     "@nomiclabs/hardhat-ethers": "^2.2.3",
     "@nomiclabs/hardhat-waffle": "^2.0.6",
     "@types/chai": "^4.3.20",
     "@types/mocha": "^9.1.1",
     "@types/node": "^20.19.43",
     "chai": "^4.5.0",
+    "dotenv": "^17.4.2",
     "ethereum-waffle": "^3.4.4",
     "ethereumjs-util": "^6.2.1",
     "ethers": "^5.8.0",