State Snapshots

# Start your environment
dokrypt up

# Deploy contracts, do some setup...

# Save the current state
dokrypt snapshot save after-deploy --description "Contracts deployed and configured"

# Run some experiments, make changes...

# Restore back to the clean state
dokrypt snapshot restore after-deploy

# Chain is now back to the exact state after deployment

dokrypt snapshot save <name> [--description "..."] [--tags tag1 --tags tag2]

dokrypt snapshot restore <name>

dokrypt snapshot list

dokrypt snapshot delete <name>

# Export to share with teammates
dokrypt snapshot export my-snapshot ./backup.json

# Import on another machine
dokrypt snapshot import ./backup.json

dokrypt snapshot diff snapshot-a snapshot-b

# Save clean state before each test suite
dokrypt snapshot save clean

# Run tests...

# Restore for next suite
dokrypt snapshot restore clean

# 1. Start clean environment
dokrypt up --fresh

# 2. Deploy contracts
forge script scripts/Deploy.s.sol --rpc-url http://localhost:8545

# 3. Snapshot the deployed state
dokrypt snapshot save deployed

# 4. Iterate on contract interactions
# ...make changes, test, break things...

# 5. Restore to deployed state
dokrypt snapshot restore deployed

# 6. Try again with a different approach

# Developer A: Export the state
dokrypt snapshot export fully-configured ./team-state.json

# Developer B: Import the state
dokrypt snapshot import ./team-state.json
dokrypt snapshot restore fully-configured

{
  "name": "my-snapshot",
  "description": "Fresh deployment",
  "tags": ["v1.0"],
  "created_at": "2025-01-15T10:30:00Z",
  "project": "my-dapp",
  "chains": {
    "ethereum": {
      "name": "ethereum",
      "engine": "anvil",
      "chain_id": 31337,
      "block_number": 42,
      "state_file": ""
    }
  }
}