sui-local-dev-usdc

Deploy a mock USDC coin on a local Sui network and fund dev addresses.

2|Updated May 16, 2026
One-click install
npx skills add https://github.com/avbel/ai-skills --skill sui-local-dev-usdc-avbel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sui-local-dev-usdc
Source: https://github.com/avbel/ai-skills/tree/main/skills/sui-local-dev-usdc
Command: npx skills add https://github.com/avbel/ai-skills --skill sui-local-dev-usdc-avbel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Testing Sui Move applications that interact with USDC requires a funded local environment, but mainnet USDC is unavailable locally and setting up a coin package, faucet funding, and minting flows by hand is repetitive and error-prone. ## Core Features & Use Cases - Local Network Bootstrap: Start a local Sui validator with faucet via sui start --with-faucet --force-regenesis and configure the CLI environment. - Mock USDC Deployment: Scaffold and publish a Move coin package matching Circle's native USDC (6 decimals), with an initial 1M USDC supply and a transferable TreasuryCap. - Faucet, Mint, and Balance Flows: Request faucet SUI, mint additional USDC via sui client call or PTB, split and transfer coins, and verify balances. - Use Case: A developer building a Sui DeFi integration needs USDC-denominated test transactions; they run the bootstrap scenarios to spin up the network, publish the mock coin, and mint USDC to test wallets. ## Quick Start Ask the agent to start a local Sui network with a faucet and deploy a mock USDC coin, then mint 10,000 USDC to your dev address.

Frequently Asked Questions about sui-local-dev-usdc

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

FAQPage Schema
How do I set up a local Sui network for development?▼

Run `sui start --with-faucet --force-regenesis` to start a local validator, fullnode, and faucet with fresh genesis state. Then point the CLI at it with `sui client new-env --alias local --rpc http://127.0.0.1:9000` and switch to that environment.

How to create and mint a mock USDC coin on Sui localnet?▼

Scaffold a Move package with `sui move new usdc`, define a `USDC` one-time witness struct, and call `coin::create_currency` with 6 decimals in the init function. After publishing, use the TreasuryCap with `sui client call --function mint` or a PTB to mint additional USDC to any address.

Does the mock USDC match Circle's native USDC on Sui?▼

It matches the 6-decimal configuration of native USDC but uses plain `coin::create_currency` without the RegulatedCoin standard, so it lacks freeze and deny-list capabilities. The package address is also randomly assigned at publish time rather than fixed.

Why does sui client faucet fail on a local network?▼

The faucet may not be ready immediately after `sui start`; wait 5-10 seconds before requesting. You can also specify the local faucet explicitly with `--url http://127.0.0.1:9123/v2/gas`.

Can this mock USDC setup be used on mainnet?▼

No, this init pattern is for local development only because the TreasuryCap is held by the deployer, allowing unlimited minting. The documentation explicitly warns never to deploy this pattern to mainnet.