alphaoutcastyt/arc-builder-guide

Arc Builder AI Guide is not a piece of software you run, it is a documentation repository meant to help both human developers and AI coding assistants build, test, and deploy applications on Arc Testnet, a Layer-1 blockchain network run by Circle, the company behind the USDC stablecoin. Rather than one README, it is organized as a set of separate guide files, each covering a different stage of building a project on this network. The guide starts with a quickstart file meant to get a new project connected and reading a USDC balance within five to ten minutes, followed by an architecture file for planning technical decisions before writing code, including project types and recommended tech stacks. An examples file holds copy-paste code for common tasks like configuring the chain connection, reading balances, transferring tokens, and deploying contracts, using tools such as Viem, Wagmi, Ethers, Hardhat, and Foundry. A deployment file walks through pre-deployment checklists, contract and frontend deployment steps, and rollback procedures. A troubleshooting file lists solutions to more than thirty common problems involving wallets, networks, gas, and transactions. A security file covers key management, smart contract security, and frontend and backend protections. Finally, an API reference file lists network details, contract addresses, and configuration snippets. A notable detail specific to Arc Testnet is that it uses USDC itself as the network's gas token instead of ETH, with native USDC using 18 decimal places for gas while the ERC-20 version of USDC used for transfers uses 6 decimals, a distinction the guide calls out as easy to get wrong. The repository includes a dedicated section instructing AI coding agents on how to use the guide, telling them to read this overview first, ask the user which specific guide they need, and check the security and API reference files before suggesting code or contract addresses. Overall this project functions as a structured reference library rather than a runnable app or library, aimed at speeding up the process of building correctly configured, reasonably secure applications on a new blockchain network.