# Send Setup Local Anvil Testnet to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "setup-local-testnet",
    "name": "Setup Local Anvil Testnet",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/wpank/setup-local-testnet",
    "canonicalUrl": "https://clawhub.ai/wpank/setup-local-testnet",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/setup-local-testnet",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=setup-local-testnet",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "setup-local-testnet",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-08T17:54:37.489Z",
      "expiresAt": "2026-05-15T17:54:37.489Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=setup-local-testnet",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=setup-local-testnet",
        "contentDisposition": "attachment; filename=\"setup-local-testnet-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "setup-local-testnet"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/setup-local-testnet"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/setup-local-testnet",
    "downloadUrl": "https://openagent3.xyz/downloads/setup-local-testnet",
    "agentUrl": "https://openagent3.xyz/skills/setup-local-testnet/agent",
    "manifestUrl": "https://openagent3.xyz/skills/setup-local-testnet/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/setup-local-testnet/agent.md"
  }
}
```
## Documentation

### Overview

Spins up a local Anvil testnet forking a live chain with all Uniswap contracts available, pre-funded test accounts, and real pool state. This is the foundation for all local testing -- every other testnet skill depends on it.

Why this is 10x better than doing it manually:

One command: Instead of writing 30+ lines of shell script to start Anvil, impersonate whales, fund accounts, and verify contracts, you say "set up a local testnet" and it's done.
Pre-funded accounts: Each test account gets 10,000 ETH plus 1M USDC, 1M USDT, 10K DAI, 100 WETH, and 10K UNI -- ready for any testing scenario.
Real pool state: Fork mode gives you every Uniswap pool with real liquidity, real prices, and real tick state. No mocking required.
Contract discovery: Returns all relevant Uniswap contract addresses (V3Factory, NonfungiblePositionManager, UniversalRouter, Permit2, QuoterV2) so you can immediately interact with them.
Port management: Automatically finds an available port, handles conflicts, and cleans up previous testnets.
Follow-up integration: Output is designed to feed directly into create-test-pool and time-travel skills.

### When to Use

Activate when the user says anything like:

"Set up a local testnet"
"Start a local Anvil fork"
"I need a test environment for Uniswap"
"Fork Ethereum locally"
"Set up a dev environment"
"I want to test without spending real gas"
"Spin up Anvil with Uniswap"
"Create a test environment for my agent"

Do NOT use when the user already has a testnet running and just wants to add pools (use create-test-pool) or advance time (use time-travel).

### Parameters

ParameterRequiredDefaultHow to ExtractmodeNofork"fork" or "mock" -- fork is the default and recommendedforkFromNoethereum"ethereum", "base", "arbitrum", "optimism", "polygon"blockNumberNolatestSpecific block number if the user mentions oneseedLiquidityNotrueSet to false only if user says "empty testnet" or "no tokens"fundedAccountsNo3Number of accounts (1-5) if user specifiesportNoautoSpecific port if user mentions one

### Step 1: Check Prerequisites

Before calling the MCP tool, verify the environment:

Anvil availability: The tool will return a clear error if Anvil is not installed. If you see TESTNET_ANVIL_NOT_FOUND, tell the user:
Anvil (Foundry) is required but not installed.
Install: curl -L https://foundry.paradigm.xyz | bash && foundryup



Network access: Fork mode requires network access to the chain's RPC. If you see TESTNET_STARTUP_TIMEOUT, suggest checking network connectivity or trying a different chain.

### Step 2: Extract Parameters

Parse the user's request for any specific requirements:

Chain preference: "fork Base" → forkFrom: "base"
Block number: "at block 19000000" → blockNumber: 19000000
Account count: "5 test accounts" → fundedAccounts: 5
No funding: "empty testnet" → seedLiquidity: false

If the user doesn't specify, use all defaults (fork Ethereum, 3 funded accounts, seed liquidity).

### Step 3: Call setup_local_testnet

Call mcp__uniswap__setup_local_testnet with the extracted parameters.

### Step 4: Present Results

Format the response as a rich summary:

Local Testnet Ready

  RPC URL:    http://127.0.0.1:8545
  Chain ID:   31337
  Mode:       Fork of Ethereum at block 19,234,567

  Funded Accounts:
  ┌──────────────────────────────────────────────────────────────────────┐
  │ #  Address                                    ETH       USDC        │
  │ 1  0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 10,000    1,000,000  │
  │ 2  0x70997970C51812dc3A010C7d01b50e0d17dc79C8 10,000    1,000,000  │
  │ 3  0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC 10,000    1,000,000  │
  └──────────────────────────────────────────────────────────────────────┘

  Key Contracts:
    V3Factory:                      0x1F98431c8aD98523631AE4a59f267346ea31F984
    NonfungiblePositionManager:     0xC36442b4a4522E871399CD717aBDD847Ab11FE88
    UniversalRouter:                0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD
    Permit2:                        0x000000000022D473030F116dDEE9F6B43aC78BA3
    QuoterV2:                       0x61fFE014bA17989E743c5F6cB21bF9697530B21e

  Available Pools (from fork):
    USDC/WETH 0.05% (V3)  — 0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640
    USDC/WETH 0.30% (V3)  — 0x8ad599c3A0ff1De082011EFDDc58f1908eb6e6D8
    USDT/WETH 0.30% (V3)  — 0x4e68Ccd3E89f51C3074ca5072bbAC773960dFa36
    WBTC/WETH 0.30% (V3)  — 0xCBCdF9626bC03E24f779434178A73a0B4bad62eD

  Private Keys (for wallet config):
    Account #1: 0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
    Account #2: 0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d
    Account #3: 0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a

### Step 5: Suggest Next Steps

Always end with actionable follow-ups:

Next Steps:
  - Create a custom pool: "Create a WETH/DAI pool with thin liquidity"
  - Test time-dependent logic: "Advance time by 7 days"
  - Test a swap: "Get a quote for 1 WETH → USDC on the local testnet"
  - Fund more tokens: "Fund account #1 with 10,000 WBTC"
  - Configure your MCP server: Set RPC_URL_1=http://127.0.0.1:8545 in .env

### Important Notes

Anvil must be installed. This skill requires Foundry's Anvil. If not installed, provide the installation command.
Fork mode requires network access. The initial fork downloads state from the live chain's RPC. Subsequent operations are local.
Port conflicts are handled automatically. If port 8545 is in use, the tool finds the next available port.
Previous testnets are cleaned up. Starting a new testnet kills any existing one.
Private keys are Anvil defaults. These are well-known test keys -- never use them on mainnet.
The testnet persists until the MCP server process exits or a new testnet is started.

### Error Handling

ErrorUser-Facing MessageSuggested ActionTESTNET_ANVIL_NOT_FOUND"Anvil (Foundry) is not installed."Install: curl -L https://foundry.paradigm.xyz | bash && foundryupTESTNET_STARTUP_TIMEOUT"Anvil did not start within 30s. Fork RPC may be unreachable."Check network, try a different chain, or retryTESTNET_INVALID_FORK_CHAIN"Chain X is not supported for forking."Use ethereum, base, arbitrum, optimism, or polygonTESTNET_MOCK_NOT_IMPLEMENTED"Mock mode is not yet implemented."Use fork mode insteadTESTNET_SETUP_FAILED"Failed to set up testnet: {reason}"Check Anvil installation and network access
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: wpank
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-08T17:54:37.489Z
- Expires at: 2026-05-15T17:54:37.489Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/setup-local-testnet)
- [Send to Agent page](https://openagent3.xyz/skills/setup-local-testnet/agent)
- [JSON manifest](https://openagent3.xyz/skills/setup-local-testnet/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/setup-local-testnet/agent.md)
- [Download page](https://openagent3.xyz/downloads/setup-local-testnet)