dApp Testing Proxy: Test Your Front End from Real Country IPs

Why dApp testing needs a proxy

dApps answer differently by country. Polymarket, for example, documents a geoblock endpoint that returns the detected IP, country and region, lists jurisdictions where its front end and API block orders or allow closing positions only, and tells builders to check the location before placing an order. If your dApp applies rules like these, you only see each region's result from an IP in that region.

Browser automation takes a proxy per browser or per context. Playwright sets a proxy for the whole browser or for each browser context, so one test run can walk through several countries, and it sends a username and password only to HTTP(S) proxies — so generate your IPs with HTTP. Wallet extensions such as MetaMask load only in Chromium started with a persistent context.

Static exits keep results comparable. A static datacenter IP keeps its address for the whole term, so a country that fails today fails on the same IP tomorrow instead of on a random one — the Web3 note in the console calls this setup “Development and tools”.

• Polymarket documentation: geographic restrictions
• Playwright documentation: HTTP proxy
• Playwright documentation: Chrome extensions
• Proxy302 static datacenter configuration for Web3

Recommended dApp testing setup

Scroll horizontally with the arrow keys to read all content.

The “Configure dApp testing proxies” button opens static datacenter proxies for the Web3 use case, billed per IP and term with HTTP selected. Choose the region, the term and Quantity (up to 100 IPs at a time) before you pay.

• Proxy302 static datacenter configuration for Web3

Which Proxy302 proxy to buy

Scroll horizontally with the arrow keys to read all content.

Prices in US dollars; you pay with PTC credit (1 PTC = US$1). Top up your wallet, then buy the line you need. Auto-renew isn't available yet, so renew static IPs in My assets before their term ends.

• Proxy302 static datacenter configuration for Web3
• Proxy302 pricing

Set up dApp testing proxies in 4 steps

1. Open the developer setup

   The “Configure dApp testing proxies” button opens Static Datacenter Proxies with the Web3 use case selected. Under Connection settings pick the Region, choose the Term and keep Protocol at HTTP, then click Review cost and generate. Each purchase covers one Region, so repeat it for every country in your test matrix; Quantity adds more IPs in the same country (up to 100 at a time).

   Expected result Your configuration lists Per IP and term, Web3, the region and the protocol.

2. Copy the connection details

   After payment the console opens My assets. Choose View credentials on the new proxy and copy the endpoint (host:port), username and password.

3. Put the exits into your test config

   Store each country's host, port, username and password as CI secrets, not in the repository. In Playwright pass them as the proxy option of the browser or of each context, as in the example below.

4. Run the flow per country

   Run the same flow through every exit. Read the exit country first, then the page status, and keep a screenshot per country so differences are easy to review.

   Expected result Each run reports its exit country, the page status and a screenshot.

Run the same test through each country (Playwright)

Scroll horizontally with the arrow keys to read all content.

// Save as geo-test.mjs and run: node geo-test.mjs
// npm i -D playwright && npx playwright install chromium
import { chromium } from 'playwright'

const DAPP_URL = 'https://app.example.org/' // your dApp
const exits = {
  US: { server: 'http://US_HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
  DE: { server: 'http://DE_HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
}

const browser = await chromium.launch()
for (const [expected, proxy] of Object.entries(exits)) {
  const context = await browser.newContext({ proxy })
  const page = await context.newPage()
  await page.goto('https://ipinfo.io/country')
  const seen = (await page.locator('body').innerText()).trim()
  const response = await page.goto(DAPP_URL, { waitUntil: 'domcontentloaded' })
  console.log(`${expected}: exit ${seen}, status ${response?.status()}`)
  await page.screenshot({ path: `dapp-${expected}.png`, fullPage: true })
  await context.close()
}
await browser.close()

Playwright takes a proxy per browser context, so one run walks through several countries. Keep hosts and passwords in your CI secrets and replace DAPP_URL with your dApp.

• Playwright documentation: HTTP proxy

Quick fixes

dApp testing proxy FAQ

Related setups

Playwright proxies

Playwright proxy setup with username and password: static datacenter IPs for tests and CI, rotating residential from US$1.50/GB when a site blocks servers.

View options and pricing

MetaMask & wallet proxies

MetaMask proxy on a static ISP IP: set it on the browser profile, keep MetaMask's networks on their defaults, and use the wallet and dApps from one fixed address. HTTP or SOCKS5.

View options and pricing

Testnet development proxies

Testnet proxy for Web3 developers: send Hardhat, Foundry and Node.js traffic — installs, compiler downloads, Sepolia RPC and verification — through one static datacenter IP with HTTPS_PROXY.

View options and pricing