hedera-agentkit

Easy Hedera wallet management for AI agents. Create wallets, send HBAR, use HCS messaging, and manage tokens with simple APIs.

Installation

npm install hedera-agentkit

Quick Start

const { HederaAgent } = require('hedera-agentkit');

// Load existing wallet
const agent = await HederaAgent.load(
  '0.0.12345',           // Account ID
  'your-private-key',    // ECDSA private key (hex)
  'mainnet'              // or 'testnet'
);

// Check balance
const balance = await agent.getBalance();
console.log(balance.hbar); // 100.5

// Send HBAR
await agent.sendHbar('0.0.67890', 10); // Send 10 HBAR

// HCS Messaging
const topic = await agent.createTopic('My Agent Channel');
await agent.submitMessage(topic.topicId, { hello: 'world' });
const messages = await agent.getMessages(topic.topicId);

agent.close();

Create New Agent Wallet

// Requires a funder account to create new accounts on-chain
const { agent, accountId, privateKey, evmAddress } = await HederaAgent.create(
  '0.0.funder',        // Funder account ID
  'funder-private-key', // Funder private key
  { 
    network: 'mainnet',
    initialBalance: 5   // Fund with 5 HBAR
  }
);

console.log('New agent:', accountId);    // 0.0.xxxxx
console.log('EVM address:', evmAddress); // 0x...

API Reference

HederaAgent.create(funderAccountId, funderPrivateKey, options)

Create a new agent with a fresh Hedera wallet.

HederaAgent.load(accountId, privateKey, network)

Load an existing agent from credentials.

agent.getBalance()

Get HBAR and token balances.

agent.sendHbar(recipientId, amount)

Send HBAR to another account.

agent.createTopic(memo)

Create an HCS topic for messaging.

agent.submitMessage(topicId, message)

Submit a message to an HCS topic.

agent.getMessages(topicId, sinceSequence)

Get messages from an HCS topic via mirror node.

agent.export()

Export credentials for saving.

agent.close()

Close the connection.

Why Hedera for Agents?

• $0.0001 transactions — Affordable for high-frequency agent operations
• 3-second finality — Fast enough for real-time agent interactions
• Native accounts — Not smart contract wallets, real accounts
• HCS messaging — Built-in consensus messaging for agent coordination
• aBFT security — Enterprise-grade security

License

MIT