Code samples referenced from the Circle and Arc developer documentation.
Each subdirectory is a self-contained example with its own package.json. Clone
the repo, change into the example you want to run, install dependencies, and
follow the instructions in that example's documentation page or local README.
Browser app that bridges USDC from Ethereum Sepolia to Arc Testnet using App Kit with the viem adapter. Connects to any EIP-6963 browser wallet (e.g., MetaMask).
Run with npm install && npm run dev.
Browser app that bridges USDC from Solana Devnet to Arc Testnet using App Kit with both the viem and Solana adapters. Connects an EVM wallet for the destination and a Solana wallet for the source.
Run with npm install && npm run dev.
Browser app that estimates and sends USDC on Arc Testnet using App Kit with the viem adapter. Connects to any EIP-6963 browser wallet (e.g., MetaMask).
Run with npm install && npm run dev.
Browser app that estimates and swaps USDC for EURC on Arc Testnet using App Kit with the viem adapter. Connects to any EIP-6963 browser wallet (e.g., MetaMask).
Run with npm install && npm run dev.
React app that embeds a USDC transfer widget with
App Kit. Supports same-chain
send() and crosschain bridge() flows for EVM and Solana browser wallets,
including estimate, review, and retry.
Run with npm install && npm run dev.
Browser app that deposits USDC into a unified balance from Base Sepolia and Solana Devnet, reads the balance, and spends it on Arc Testnet using App Kit with the viem and Solana adapters. Connects an EVM wallet and a Solana wallet.
Run with npm install && npm run dev.
Node.js script that generates a new entity secret, registers it with Circle,
writes the recovery file to disk, and adds CIRCLE_ENTITY_SECRET to .env.
Intended for first-time setup of
developer-controlled wallets.
See entity-secret-setup/README.md for
prerequisites and security notes.
PIN path for
user-controlled wallets:
create a PIN-secured wallet (challenge → execute → list), then continue,
reset, or recover the PIN. Uses
@circle-fin/user-controlled-wallets
and
@circle-fin/w3s-pw-web-sdk.
See user-controlled-wallets-pin/README.md.
Run npm run server and npm run dev in separate terminals.
Email OTP path for user-controlled wallets: OTP login, then initialize
(challenge on first login) and list wallets. Same packages as the PIN sample.
See user-controlled-wallets-email/README.md.
Run npm run server and npm run dev in separate terminals.
Google social login path for user-controlled wallets: OAuth login, then
initialize (challenge on first login) and list wallets. Same packages as the
PIN sample; also needs VITE_GOOGLE_CLIENT_ID.
See user-controlled-wallets-social/README.md.
Run npm run server and npm run dev in separate terminals.
Apache 2.0 — see LICENSE.
To report a vulnerability, see SECURITY.md.