Cardano Agent Kit 🛠️

A TypeScript SDK for interacting with the Cardano blockchain, powered by Mesh SDK, AI tools, and modular actions.

---

🚀 Features

✅ Create & Restore Cardano Wallets
✅ Get Wallet Balance (ADA + Native Assets)
✅ Send ADA (Lovelace) Transactions
✅ Sign & Submit Transactions
✅ Stake & Delegate ADA to Stake Pools
✅ Mint & Burn Tokens / NFTs
✅ Fetch Transaction History
✅ AI-powered Blockchain Tools (Vercel AI & Langchain integration)
✅ Dynamic Toolset Creation for AI Models
✅ Exported Actions (e.g., create wallet, send ADA, burn assets)
✅ Support for Blockfrost, Koios, Maestro, and U5C Providers

---

📦 Installation

Install via npm:

npm install cardano-agent-kit

or via yarn:

yarn add cardano-agent-kit

---

🛠 Usage Example

1️⃣ Import the SDK

import { CardanoToolKit } from "cardano-agent-kit";

2️⃣ Initialize Wallet

const API_KEY = "your_blockfrost_api_key";
const TEST_MNEMONIC = [
    "churn", "analyst", "debate", "million", "tattoo", "enlist",
    "crystal", "slide", "gallery", "airport", "squeeze", "live",
    "dinosaur", "rough", "first", "south", "cave", "clerk",
    "divorce", "attend", "topic", "idea", "finger", "verify"
];

const toolkit = new CardanoToolKit("blockfrost", API_KEY, "testnet", TEST_MNEMONIC);

3️⃣ Get Wallet Address

const address = await toolkit.getAddress();
console.log("Wallet Address:", address);

4️⃣ Check Wallet Balance

const balance = await toolkit.getBalance();
console.log("Wallet Balance:", balance);

5️⃣ Send ADA (Lovelace)

const recipient = "addr_test1qz...";
const txHash = await toolkit.sendLovelace(recipient, "1000000"); // 1 ADA
console.log("✅ Transaction Sent! TX Hash:", txHash);

6️⃣ Delegate to a Stake Pool

const stakePoolId = "pool1a7h89sr6ymj9g2a9tm6e6dddghl64tp39pj78f6cah5ewgd4px0";
const stakingTxHash = await toolkit.registerAndStakeADA(stakePoolId);
console.log("✅ Staking TX Hash:", stakingTxHash);

---

🧠 AI-Powered Dynamic Tools

Cardano Agent Kit supports AI-powered blockchain tools using Vercel AI SDK and Langchain.

⚡ Create AI-powered Vercel Tools

import { CardanoToolKit, createVercelCardanoTools } from "cardano-agent-kit";

const toolkit = new CardanoToolKit("blockfrost", API_KEY, "testnet", TEST_MNEMONIC);
const aiTools = createVercelCardanoTools(toolkit);

🤖 Create AI-powered Langchain Tools

import { CardanoToolKit, createLangchainCardanoTools } from "cardano-agent-kit";

const toolkit = new CardanoToolKit("blockfrost", API_KEY, "testnet", TEST_MNEMONIC);
const aiTools = createLangchainCardanoTools(toolkit);

🔀 Create Dynamic Toolsets

Cardano Agent Kit allows dynamic creation of AI tools for blockchain interactions.

Create AI-powered tools dynamically for Vercel AI

import { CardanoToolKit, createVercelAITools } from "cardano-agent-kit";
import {
    getAddress,
    sendLovelace,
    getBalance,
    createWallet,
    mintAsset,
    burnAsset,
    sendAsset
} from "cardano-agent-kit";

const toolkit = new CardanoToolKit("blockfrost", API_KEY, "testnet", TEST_MNEMONIC);
const aiTools = createVercelAITools(toolkit, [sendAsset, mintAsset, burnAsset, getAddress, sendLovelace, getBalance, createWallet]);

Create AI-powered tools dynamically for Langchain

import { CardanoToolKit, createLangchainTools } from "cardano-agent-kit";
import {
    getAddress,
    sendLovelace,
    getBalance,
    createWallet,
    mintAsset,
    burnAsset,
    sendAsset
} from "cardano-agent-kit";

const toolkit = new CardanoToolKit("blockfrost", API_KEY, "testnet", TEST_MNEMONIC);
const aiTools = createLangchainTools(toolkit, [sendAsset, mintAsset, burnAsset, getAddress, sendLovelace, getBalance, createWallet]);

---

🔬 API Reference

Wallet Functions

Function	Description
createWallet()	Creates a new wallet and returns its mnemonic.
getMnemonic()	Returns the wallet mnemonic (if available).
getPrivateKey()	Returns the Bech32 private key (if available).
getAddress()	Fetches the primary wallet address.
getBalance()	Fetches all assets in the wallet (ADA + tokens).
sendLovelace(address, amount)	Sends ADA to a recipient.
signAndSendTx(txHex)	Signs and submits a transaction.

Staking Functions

Function	Description
registerAndStakeADA(poolId)	Registers a stake address and delegates to a stake pool.

Asset Functions

Function	Description
mintAsset(name, quantity, recipient, metadata, label)	Mints a new Cardano token/NFT.
burnAsset(assetUnit, quantity)	Burns a specific amount of an asset.
sendAsset(recipient, assetUnit, quantity)	Transfers a Cardano asset (NFT or token).

Transaction Functions

Function	Description
getTransactionHistory()	Retrieves the transaction history with details on senders, recipients, and amounts.

AI-Powered Tools

Function	Description
createVercelCardanoTools(toolkit)	Creates AI-powered Cardano tools using Vercel AI SDK.
createLangchainCardanoTools(toolkit)	Creates AI-powered Cardano tools using Langchain.
createVercelAITools(toolkit, toolsList)	Dynamically generates AI-powered blockchain tools for Vercel AI.
createLangchainTools(toolkit, toolsList)	Dynamically generates AI-powered blockchain tools for Langchain.

---

🛠 Development

Run Tests

npm test

---

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

🤝 Contributing

💡 Contributions are welcome!

• Open an issue
• Submit a pull request

---

🌟 Support

If you find this project useful, please ⭐ star the repository and share it with the Cardano community!

---

✅ What's New?

1️⃣ AI-powered Blockchain Interactions (Vercel AI & Langchain tools)
2️⃣ Dynamic Toolset Creation for AI Models
3️⃣ Enhanced Transaction History Functionality
4️⃣ Comprehensive API Documentation & Examples