Installation

Evolution SDK is a pure TypeScript library with zero runtime dependencies on Cardano Multiplatform Library (CML). This means lighter bundle sizes, better IDE support, and tree-shakeable exports—you only ship what you use. It works seamlessly with modern build tools and supports both Node.js and browser environments.

Install it for any Cardano project: dApps, wallets, transaction tools, or when migrating from other SDKs like Lucid.

Quick Install

npm

npm install @evolution-sdk/evolution

yarn

yarn add @evolution-sdk/evolution

pnpm

pnpm add @evolution-sdk/evolution

Requirements

• Node.js: 18.0.0 or higher
• TypeScript: 5.0.0 or higher (for TypeScript projects)
• ESM Support: Modern bundlers with ES module support

Monorepo Setup

If you're using Evolution SDK in a monorepo with pnpm workspaces:

pnpm add @evolution-sdk/evolution

The SDK works seamlessly with pnpm's workspace structure and maintains type safety across packages.

Browser Usage

For browser environments, ensure your build tool supports:

• ES2020+ target
• Dynamic imports
• BigInt support

Most modern frameworks (React, Vue, Svelte) bundle Evolution SDK without issues.

Verify Installation

Test that everything is working:

import { createClient } from "@evolution-sdk/evolution";

const client = createClient({
  network: "preprod",
  provider: {
    type: "blockfrost",
    baseUrl: "https://cardano-preprod.blockfrost.io/api/v0",
    projectId: "your-project-id"
  },
  wallet: {
    type: "seed",
    mnemonic: "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
    accountIndex: 0
  }
});

console.log("Evolution SDK loaded successfully!");

Next Steps

• Create a wallet
• Connect a provider
• Build your first transaction