// What you can do
Upload Hardhat and Foundry contract artifacts
Mint native tokens and ERC20s
Impersonate accounts over JSON-RPC
Override code, nonce, and storage state
Auto-create Workspaces when uploaded contracts are deployed
// Setup
01Install the package with npm.
02Run contract.dev init in your project root.
03Add your Stagenet RPC URL to contract.dev.js (or contract.dev.cjs for ESM projects).
// CLI
The CLI reads your compiled artifacts and matches them against deployments. When a matching uploaded contract is deployed, a Workspace is created automatically.
Commands
contract.dev init
contract.dev upload-contracts
Note
Build first with forge build or npx hardhat compile.
// SDK
Use createStagenet() to mint balances, impersonate accounts, and override state for scenario-driven testing.
Code
import { createStagenet } from "contract.dev";
const stagenet = createStagenet();
await stagenet.addBalance(addr, 10n ** 18n);
await stagenet.impersonateAccount(whale);
// Workspaces
A Workspace is created whenever a previously uploaded contract is deployed to your Stagenet, giving your team a contract-specific dashboard out of the box.
