Obsqra.fi Docs
Demo

Connect Your Wallet

Detailed guide for connecting to Obsqra.fi, including network configuration, wallet setup, and troubleshooting common issues.

Supported Wallets

Obsqra.fi uses RainbowKit for wallet connections, supporting most EVM-compatible wallets:

Wallet
MetaMask
Status
Recommended
Notes
Best compatibility, browser extension
Wallet
Rainbow
Status
Supported
Notes
Mobile-first, clean UX
Wallet
Coinbase Wallet
Status
Supported
Notes
Good for Coinbase users
Wallet
WalletConnect
Status
Supported
Notes
Connect any mobile wallet
Wallet
Trust Wallet
Status
Supported
Notes
Via WalletConnect
Wallet
Ledger
Status
Supported
Notes
Via MetaMask integration

Network Configuration

Anvil (Local Testnet)

For local development or the hosted demo, you'll connect to the Anvil testnet:

Network Details
Network Name:
Anvil (Local)
Chain ID:
31337
RPC URL (Local):
http://localhost:8545
RPC URL (Hosted):
https://obsqra.fi/rpc
Currency Symbol:
ETH
Block Explorer:
N/A (local)

Adding Network Manually

If the automatic network switch doesn't work, add it manually in MetaMask:

  1. 1.Open MetaMask and click the network dropdown
  2. 2.Click "Add Network" → "Add a network manually"
  3. 3.Enter the network details from the table above
  4. 4.Click "Save" and switch to the new network

Getting Test ETH

On the Anvil testnet, you start with 10,000 ETH by default. If you need more:

# Using Foundry's cast command
cast send
--value 100ether YOUR_ADDRESS --private-key ANVIL_PRIVATE_KEY

The default Anvil private keys (for testing only):

# Account #0 (10000 ETH)
0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80
# Account #1 (10000 ETH)
0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d
⚠️
Never Use These Keys on Mainnet
These are well-known test keys. Anyone can drain wallets using these keys. Only use them on local testnets.

Troubleshooting

Wallet not connecting

If the Connect Wallet button doesn't respond:

  • ‣Make sure your wallet extension is unlocked
  • ‣Try refreshing the page
  • ‣Disable other wallet extensions temporarily
  • ‣Clear browser cache and try again
  • ‣Try a different browser
Wrong network error

If you see "Wrong network" or transactions fail:

  • ‣Check you're on Chain ID 31337 (Anvil)
  • ‣The RPC URL should match (localhost:8545 or obsqra.fi/rpc)
  • ‣Try removing and re-adding the network
  • ‣Make sure Anvil is actually running
MetaMask lagging or unresponsive

If MetaMask is slow to respond:

  • ‣Close other dApps that might be using MetaMask
  • ‣Reset MetaMask account (Settings → Advanced → Reset Account)
  • ‣This clears transaction history but keeps your keys
  • ‣Try using a different wallet (Rainbow, Coinbase)
Nonce too high / Transaction stuck

If transactions fail with nonce errors:

  • ‣Anvil was likely restarted, resetting on-chain nonces
  • ‣Reset MetaMask account (Settings → Advanced → Reset Account)
  • ‣This syncs MetaMask's nonce with the chain
Balance shows 0

If your wETH balance shows 0 after minting:

  • ‣Wait a few seconds and refresh the page
  • ‣Check that Anvil is running and contracts are deployed
  • ‣The wETH contract address may have changed if Anvil restarted
  • ‣Check the console for RPC errors

Security Best Practices

Do

  • +Use a separate wallet for testing
  • +Verify the URL is obsqra.fi
  • +Check transaction details before signing
  • +Keep your seed phrase offline

Don't

  • −Share your private key or seed phrase
  • −Connect to unknown sites
  • −Approve unlimited token spending
  • −Use test keys on mainnet