Skip to main content

Prerequisites

What you need depends on your use case.

For Free Tier (Testing)​

Nothing! Just make HTTP requests.

curl https://api.web3identity.com/api/ens/resolve/vitalik.eth

For Paid Requests (Production)​

RequirementDescription
WalletAny Ethereum wallet with private key access
USDC on BaseFor x402 payments (keep ~$1-5)
Node.js 18+For SDK usage

Getting USDC on Base​

Option 1: Bridge from Ethereum

  1. Go to bridge.base.org
  2. Connect your wallet
  3. Bridge USDC from Ethereum to Base

Option 2: Buy on Base

  1. Use Coinbase with Base withdrawal
  2. Or swap on Uniswap (Base)

Creating a Wallet (if needed)​

# Using viem
npm install viem
import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';

const privateKey = generatePrivateKey();
const account = privateKeyToAccount(privateKey);
console.log('Address:', account.address);
console.log('Private Key:', privateKey);  // Save securely!
Security

Never commit private keys to version control. Use environment variables or a secrets manager.

For SIWE Authentication​

  • Wallet that can sign messages
  • That's it — no USDC needed for auth

Environment Setup​

Recommended environment variables:

# .env
WALLET_KEY=0x...your_private_key...

Load in Node.js:

import 'dotenv/config';
const privateKey = process.env.WALLET_KEY;

Next Steps​