Emulator

Evolution SDK's devnet acts as a local blockchain emulator — a complete Cardano node with Kupo and Ogmios running in Docker. No external services needed for development and testing.

How It Works

Devnet provides:

• A local Cardano node producing blocks
• Kupo for UTxO indexing and querying
• Ogmios for protocol parameter queries and transaction submission
• Configurable genesis with pre-funded addresses
• Fast block times (20-100ms) for rapid testing

Quick Start

import { Cluster, Config } from "@evolution-sdk/devnet"

const cluster = await Cluster.make({
  clusterName: "my-emulator",
  ports: { node: 3001, submit: 3002 },
  shelleyGenesis: {
    ...Config.DEFAULT_SHELLEY_GENESIS,
    slotLength: 0.1,
    initialFunds: {
      "your_address_hex": 1_000_000_000_000
    }
  },
  kupo: { enabled: true, port: 1442 },
  ogmios: { enabled: true, port: 1337 }
})

await Cluster.start(cluster)
// ... run tests ...
await Cluster.stop(cluster)
await Cluster.remove(cluster)

Advantages Over External Testnets

Next Steps

• Devnet Getting Started — Full devnet setup guide
• Devnet Integration — Complete integration workflows
• Integration Tests — Test patterns with devnet