unify-balance

Generate TypeScript code for cross-chain USDC unified balance operations using Circle SDKs.

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

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 across multiple blockchains normally requires direct contract interaction, EIP-712 signing, burn intents, and attestation polling. This Skill generates server-side TypeScript code that abstracts all of that into simple deposit, spend, and balance query calls via Circle's App Kit or Unified Balance Kit SDKs. ## Core Features & Use Cases - Unified Balance Operations: Generate code for depositing USDC into a unified balance, spending it to any supported chain, and querying aggregated cross-chain balances with getBalances(). - Multi-Adapter Support: Covers Viem private key, Solana, Circle developer-controlled wallets, and combined EVM+Solana multichain adapter setups. - Delegate & Withdrawal Flows: Implements delegate lifecycle (addDelegate, depositFor, delegate spend) and the two-step 7-day delayed fund removal process. - Use Case: A payments backend needs to accept USDC deposits on Base and pay out on Arbitrum. The Skill walks through SDK and adapter selection, then generates reviewed, env-var-secured code the user runs themselves. ## Quick Start Ask the assistant to generate code that deposits 10 USDC on Base Sepolia into a unified balance and spends it to a recipient on Arc Testnet using the Viem adapter.

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 and @circle-fin/adapter-viem-v2, create a Viem adapter from a private key stored in an environment variable, then call kit.unifiedBalance.deposit() with the source chain and amount. The SDK handles approval and transfer in one call.

What is the difference between App Kit and Unified Balance Kit?

App Kit (@circle-fin/app-kit) covers unified balance, swap, bridge, and send in one package and is recommended for extensibility. Unified Balance Kit (@circle-fin/unified-balance-kit) exposes the same unified balance API in a lighter package for unified-balance-only use cases.

Does Unified Balance Kit support Solana?

Yes, Solana is supported via the @circle-fin/adapter-solana package with a base58 private key. You can deposit from Solana, spend from Solana allocations, and combine EVM and Solana adapters in multichain flows.

Do I need a kit key for unified balance operations?

No, unified balance operations do not require a kit key. A kit key is only needed when using swap or send features through App Kit.

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 to transfer USDC back to your wallet.

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, contract-level control, or custom handling of individual CCTP steps like approve, burn, attestation fetching, and minting. Unified Balance Kit is server-side only.