Use Developer Controlled Wallets

This brings Circle's developer-controlled wallets SDK into Claude, letting you build applications that create and manage custodial wallets on behalf of users. You get full programmatic control over wallet creation, token transfers, contract execution, and message signing across EVM chains, Solana, Aptos, and NEAR, while Circle handles key security through encrypted entity secrets and manages blockchain infrastructure. The skill covers both EOA and smart contract account types, walks through the complete transaction lifecycle from initiation to finality, and includes practical patterns for balance checks, fee estimation, and transaction acceleration. The documentation is security-focused and won't let you hardcode secrets or skip confirmation prompts on mainnet operations. Good fit if you're building wallets, payment flows, or any app where you need to hold custody rather than passing keys to end users.

skills.sh installs: 1K
GitHub stars: 164
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add circlefin/skills --skill use-developer-controlled-wallets --agent claude-code

Installs into .claude/skills of the current project.

Files

Overview

Developer-controlled wallets let your application create and manage wallets on behalf of end users, with full custody of private keys secured through an encrypted entity secret. Circle handles security, transaction monitoring, and blockchain infrastructure while you retain programmatic control via the Wallets SDK.

Prerequisites / Setup

Installation

npm install @circle-fin/developer-controlled-wallets

Environment Variables

CIRCLE_API_KEY=      # Circle API key (format: PREFIX:ID:SECRET)
ENTITY_SECRET=       # 32-byte hex entity secret

Entity Secret Registration

Register an entity secret before using the SDK. Point the developer to https://developers.circle.com/wallets/dev-controlled/register-entity-secret, or READ references/register-secret.md for the generation and registration snippets. IMPORTANT: Never register an entity secret on mainnet (LIVE) for the user; they generate, register, and store it themselves. On testnet (TEST), register only when the user explicitly asks, and make sure they store the entity secret and recovery file securely.