This guide walks you through creating a project, starting the development environment, and running your first tests.
Step 1: Create a Project
Scaffold a new project from a built-in template:
dokrypt init my-dapp --template evm-basic
my-dapp/ directory with:
Use dokrypt template list to see all 5 available templates: evm-basic, evm-token, evm-nft, evm-dao, evm-defi.
Step 2: Start the Environment
Dokrypt pulls the required Docker images and starts a local Anvil blockchain node:
Starting services...
✓ ethereum Ready ▸ http://localhost:8545
Accounts (10000 ETH each):
0x70997970C51812dc3A010C7d01b50e0d17dc79C8
0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC
...
Started 1 service in 3.2s
http://localhost:8545 with 10 pre-funded accounts.
Step 3: Check Status
Service Status Port URL
ethereum (anvil) ● Ready 8545 http://localhost:8545
Step 4: Run Tests
Dokrypt discovers and runs your Solidity tests:
Running test suite: contracts
✓ test_increment (12ms)
✓ test_set_number (8ms)
✓ test_decrement (9ms)
✓ test_token_transfer (15ms)
4 passed, 0 failed (44ms)
--gas-report for gas analysis:
dokrypt test run --gas-report
Step 5: Use Chain Utilities
While your environment is running, you can manipulate the chain:
# Mine 10 blocks
dokrypt chain mine 10
# Time-travel 1 day into the future
dokrypt chain time-travel 1d
# Fund an address with 500 ETH
dokrypt chain set-balance 0x1234...abcd 500
# Get chain info
dokrypt chain info
Step 6: Save a Snapshot
Save the current chain state so you can restore it later:
dokrypt snapshot save clean-state --description "Fresh deployment"
dokrypt snapshot restore clean-state
Step 7: Fork Mainnet
Test against real protocol state by forking a live network:
dokrypt fork mainnet --block 18500000
Step 8: Stop the Environment
Add --volumes to remove persistent data:
Next Steps
