unify-balance

Generate TypeScript code for cross-chain USDC deposits, spends, and balance queries via Circle Unified Balance Kit.

1|Updated Jul 20, 2026
One-click install
npx skills add https://github.com/Lightupwrld/Cycuxio --skill unify-balance-lightupwrld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unify-balance
Source: https://github.com/Lightupwrld/Cycuxio/tree/main/.agents/skills/unify-balance
Command: npx skills add https://github.com/Lightupwrld/Cycuxio --skill unify-balance-lightupwrld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @circle-fin/app-kit, @circle-fin/unified-balance-kit, @circle-fin/adapter-viem-v2, @circle-fin/adapter-solana, @circle-fin/adapter-circle-wallets, viem, @solana/web3.js, and includes references (resource) components.

What problem does it solve? Managing USDC spread across multiple blockchains normally requires direct contract interaction, EIP-712 signing, and attestation polling. This Skill generates server-side TypeScript code that uses Circle's Unified Balance Kit or App Kit SDKs to handle all cross-chain orchestration through simple deposit, spend, and getBalances calls. ## Core Features & Use Cases - Unified Balance Operations: Generate code for depositing USDC into a unified balance, spending to any supported chain, and querying aggregated per-chain balances. - Multi-Adapter Support: Covers Viem private key, Solana, Circle developer-controlled wallets, and combined EVM + Solana multichain adapters. - Delegate & Withdrawal Flows: Implements addDelegate, depositFor, delegate spend, and the two-step 7-day delayed fund removal process. - Use Case: A developer building a chain-abstracted payment flow asks the assistant to deposit 10 USDC on Arc Testnet and spend 5 USDC to a recipient on Base Sepolia, receiving ready-to-review TypeScript code with correct chain identifiers and error handling. ## Quick Start Ask the assistant to generate code that deposits USDC into a unified balance on Arc Testnet and then spends it to a recipient on another chain using the Circle Unified Balance Kit.

Frequently Asked Questions about unify-balance

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

FAQPage Schema
How do I deposit USDC into a unified balance with Circle SDK?

Install @circle-fin/app-kit with @circle-fin/adapter-viem-v2, create a Viem adapter from your private key, and call kit.unifiedBalance.deposit with a from chain like Arc_Testnet and an amount. The SDK handles approval and transfer in one call.

App Kit vs Unified Balance Kit: which should I use?

Use App Kit (@circle-fin/app-kit) if you may need swap, bridge, or send features later, since it covers all of them in one package. Choose the standalone Unified Balance Kit only for unified-balance-only use cases; neither requires a kit key for balance operations.

Does Unified Balance Kit support Solana and EVM chains together?

Yes, you can combine the Viem adapter and Solana adapter in one integration. Deposit from both ecosystems and spend across them by passing multiple sources with per-chain allocations that sum to the total amount.

How do I withdraw USDC from a unified balance?

Withdrawal is a two-step process: call initiateRemoveFund to start a mandatory 7-day delayed withdrawal on a specific chain, then call removeFund after the activation period. Only one removal can be pending per chain at a time.

When should I use Gateway directly instead of Unified Balance Kit?

Use direct Gateway integration when you need browser-wallet flows with wagmi or EIP-1193 providers, since Unified Balance Kit is server-side only. It also fits when you need custom control over individual CCTP steps like approve, burn, attestation, and mint.