@hashgraph/hedera-agent-kit-elizaos

ElizaOS integration for Hedera Agent Kit. Wraps Hedera tools as ElizaOS Actions so they can be registered with the ElizaOS runtime.

Getting started

1. Install dependencies

npm install @hashgraph/hedera-agent-kit-elizaos @hashgraph/hedera-agent-kit @hiero-ledger/sdk @elizaos/core dotenv

2. Configure environment variables

Create a .env file:

ACCOUNT_ID=0.0.12345
PRIVATE_KEY=302e...
OPENAI_API_KEY=sk-...

Get your Hedera testnet keys at https://portal.hedera.com/dashboard. We recommend using the DER-encoded private key.

3. Register Hedera actions

import 'dotenv/config';
import { Client, AccountId, PrivateKey } from '@hiero-ledger/sdk';
import { HederaElizaOSToolkit } from '@hashgraph/hedera-agent-kit-elizaos';
import {
  coreTokenPlugin,
  coreAccountPlugin,
  coreConsensusPlugin,
} from '@hashgraph/hedera-agent-kit/plugins';
import { AgentMode } from '@hashgraph/hedera-agent-kit';

const client = Client.forTestnet();
client.setOperator(
  AccountId.fromString(process.env.ACCOUNT_ID!),
  PrivateKey.fromStringDer(process.env.PRIVATE_KEY!),
);

const toolkit = new HederaElizaOSToolkit({
  client,
  configuration: {
    plugins: [coreTokenPlugin, coreAccountPlugin, coreConsensusPlugin],
    context: { mode: AgentMode.AUTONOMOUS },
  },
});

// Get all Hedera tools as ElizaOS Actions
const actions = toolkit.getTools();

// Register actions with your ElizaOS runtime
// See https://github.com/hedera-dev/eliza-plugin-hedera for a full example

Each action uses LLM-based parameter extraction from user messages and validates inputs against tool schemas before executing transactions on Hedera.

License

Apache-2.0