docs: add MetaMask integration guide with USDC token setup#100
docs: add MetaMask integration guide with USDC token setup#100cryptoasuran wants to merge 1 commit into
Conversation
Adds comprehensive guide for integrating Arc Testnet with MetaMask, including the critical wallet_watchAsset call to register USDC. Without this step, users see no USDC balance in MetaMask after receiving tokens, causing confusion and making DApps appear broken. Includes: - Complete onboarding flow with wallet_addEthereumChain - wallet_watchAsset call for USDC token registration - Contract addresses and chain configuration - Why this matters section explaining the impact Fixes circlefin#97 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Great guide — this addresses the exact pain point in #97. One more MetaMask behaviour on Arc Testnet that's worth documenting alongside the Even after the network has been added, calling // ❌ Unreliable on Arc Testnet — may resolve without actually switching
await window.ethereum.request({
method: 'wallet_switchEthereumChain',
params: [{ chainId: '0x4CEF52' }],
});
// ✅ Reliable — works whether network is already added or not
await window.ethereum.request({
method: 'wallet_addEthereumChain',
params: [{
chainId: '0x4CEF52',
chainName: 'Arc Testnet',
nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
rpcUrls: ['https://rpc.drpc.testnet.arc.network'],
blockExplorerUrls: ['https://testnet.arcscan.app'],
}],
});Note the Also: the |
Summary
Adds comprehensive MetaMask integration guide for Arc Testnet, including the critical
wallet_watchAssetcall to register USDC.Problem
Issue #97 identified that there's no documented way to add Arc Testnet USDC to MetaMask's token list. Without this:
Solution
New guide at
docs/metamask-integration.mdcovering:wallet_addEthereumChainwallet_watchAsset(the missing piece)Changes
docs/metamask-integration.mdREADME.mdto link to new guideTesting
Code examples follow MetaMask's official API documentation:
Impact
Every DApp on Arc Testnet that involves USDC transfers benefits from this documentation.
Fixes #97