User-Controlled Wallets

The Circle User-Controlled Wallets Sample App is a frontend user interface designed to showcase how to integrate Circle's Web3 Services products, including their Web SDK, Smart Contract Accounts (SCA), and gasless transaction capabilities. It serves as a practical example for developers looking to embed user-controlled wallets into existing web applications, enabling end users to manage wallets securely and seamlessly. The app demonstrates key flows such as user authentication, PIN management, and wallet interactions using Circle's APIs.

Built with Next.js and React, and styled with Joy UI components, the sample app emphasizes client-side integration with Circle's Web3 Services Web SDK. It handles sensitive user data like PINs and security answers securely, leveraging the SDK's authentication and encryption features. The app requires pairing with a backend sample server to provide a complete end-to-end experience, including token management and session validation.

To get started, developers must sign up for Circle's Developer Console to obtain an App ID, install necessary development tools (nvm, openssl, yarn), and configure environment variables. Running the app locally involves standard Node.js commands with hot reload support. The project is open source on GitHub, providing a clear code structure and examples of SDK usage, including handling authentication challenges and session management. This sample app is ideal for teams building programmable wallets with user control and gasless transaction features, offering a foundation to customize and extend for production use.