Lucid Evolution

A highly scalable, production-ready transaction builder and off-chain framework for dApps and devs on Cardano.

There are a growing number of projects that are built on top of lucid-evolution! If you've built a library or a project on top of lucid-evolution, tell me about it on X or on Discord . I'll add it below and tweet it out.

Powered by Lucid Evolution

---

📦 Install

pnpm i @lucid-evolution/lucid

---

🚀 Quick Start

import { Lucid, Koios, generateSeedPhrase } from "@lucid-evolution/lucid";

// Initialize Lucid with a provider
const lucid = await Lucid(
  new Koios("https://preprod.koios.rest/api/v1"),
  "Preprod",
);

const seedPhrase = generateSeedPhrase(); // BIP-39
lucid.selectWallet.fromSeed(seedPhrase); // Select a wallet for signing

// Build, sign and submit transaction
const tx = await lucid
  .newTx()
  .pay.ToAddress("addr_testa...", { lovelace: 5000000n }) // Pay 5 ADA to addr_testa...
  .pay.ToAddress("addr_testb...", { lovelace: 5000000n }) // Pay 5 ADA to addr_testb...
  .complete(); // Balance the transaction and initiate UTxO selection

const signedTx = await tx.sign.withWallet().complete();
const txHash = await signedTx.submit();

console.log("Transaction Submitted:", txHash);

---

📚 Documentation

For comprehensive documentation including API references, examples, and guides, visit our official documentation site.

• 🔍 Core Concepts
• 🧠 Deep Dives
• ⚙️ Under the Hood

👥 Community and Support

• Discord Community: Join for discussions, support, and updates
• GitHub Issues: Report bugs or request features

🤝 Contributing

We welcome contributions to Lucid Evolution! Please check our CONTRIBUTING.md guide for more information.

Getting Started

git clone https://github.com/Anastasia-Labs/lucid-evolution.git

cd lucid-evolution
pnpm install

pnpm build

🧪 Testing

# Run tests across all packages
pnpm test

# Run tests for a specific package
pnpm --filter @lucid-evolution/lucid test

📖 Local Documentation

pnpm dev

Visit http://localhost:3000/lucid-evolution.

---

📜 License

Lucid Evolution is licensed under the MIT License.

---

Maintained with ❤️ by Anastasia Labs