Skip to content

docs: add MetaMask integration guide with USDC token setup#100

Open
cryptoasuran wants to merge 1 commit into
circlefin:mainfrom
cryptoasuran:docs/metamask-usdc-integration
Open

docs: add MetaMask integration guide with USDC token setup#100
cryptoasuran wants to merge 1 commit into
circlefin:mainfrom
cryptoasuran:docs/metamask-usdc-integration

Conversation

@cryptoasuran
Copy link
Copy Markdown

Summary

Adds comprehensive MetaMask integration guide for Arc Testnet, including the critical wallet_watchAsset call 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:

  • Users see no USDC balance after receiving tokens
  • Users assume transactions failed
  • DApps appear broken

Solution

New guide at docs/metamask-integration.md covering:

  1. Network setup with wallet_addEthereumChain
  2. USDC token registration with wallet_watchAsset (the missing piece)
  3. Complete onboarding flow combining both steps
  4. Contract addresses and chain configuration
  5. Why this matters section explaining the impact

Changes

  • ✅ New file: docs/metamask-integration.md
  • ✅ Updated README.md to link to new guide
  • ✅ Complete TypeScript code examples
  • ✅ Addresses issue reproduction steps

Testing

Code examples follow MetaMask's official API documentation:

Impact

Every DApp on Arc Testnet that involves USDC transfers benefits from this documentation.

Fixes #97

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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: wallet_watchAsset call for USDC undocumented — USDC does not appear in MetaMask token list without it

2 participants