use-circle-wallets

Selects the appropriate Circle wallet type for blockchain application integrations.

3|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/levantuy/arc-quantum --skill use-circle-wallets-levantuy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: use-circle-wallets
Source: https://github.com/levantuy/arc-quantum/tree/main/.agents/skills/use-circle-wallets
Command: npx skills add https://github.com/levantuy/arc-quantum --skill use-circle-wallets-levantuy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Choosing between Circle's developer-controlled, user-controlled, and modular (passkey) wallets is confusing because they differ in custody model, authentication, account types, and chain support. This Skill provides a structured decision guide so you pick the correct wallet type before writing any integration code. ## Core Features & Use Cases - Wallet Comparison: Compares custody model, auth method, account types (EOA, SCA, ERC-6900 Modular), gas sponsorship, and architecture across all three Circle wallet types. - Step-by-Step Decision Guide: Walks through custodian selection, auth method, account type, and chain compatibility checks (e.g., Modular wallets unsupported on Ethereum, Solana, Aptos, NEAR). - Use Case: A consumer app needing Google login and gasless transactions gets routed to user-controlled wallets with SCA on an L2, then delegated to the corresponding implementation skill. ## Quick Start Ask which Circle wallet type fits your application, describing your custody preference, authentication method, and target blockchain.

Frequently Asked Questions about use-circle-wallets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between Circle wallet types?

Start with custody: developer-controlled wallets use API key and entity secret on the backend, while user-controlled and modular wallets give key control to end users. Then pick by auth method, account type, and target chain using the decision guide.

What is the difference between developer-controlled and user-controlled Circle wallets?

Developer-controlled wallets are custodied by the developer and authenticated with an API key plus entity secret via a backend SDK. User-controlled wallets are custodied by end users and authenticated with social login, email OTP, or PIN using backend and frontend SDKs.

Which blockchains support Circle modular wallets?

Modular wallets are supported on Arbitrum, Avalanche, Base, Monad, Optimism, Polygon, and Unichain. They are not supported on Ethereum, Solana, Aptos, or NEAR, where you should fall back to user-controlled wallets with SCA or EOA.

Should I use EOA or SCA accounts on Ethereum mainnet?

Use EOA on Ethereum mainnet because SCA gas costs are prohibitive and Modular Wallets are not supported there. On L2 chains like Arbitrum, Base, or Polygon, prefer SCA when you need gas sponsorship or batched transactions.

When should I use passkey modular wallets instead of user-controlled wallets?

Choose modular wallets when you want WebAuthn passkey (biometric) authentication and extensible ERC-6900 modules on a supported L2. Choose user-controlled wallets when you need social login, email OTP, or PIN authentication.