Eliza

Overview

The Kaia Eliza Plugin is a vital extension for integrating with ElizaOS, enabling seamless interaction with the Kaia Mainnet and Kairos Testnet. This plugin provides a robust suite of functionalities, including KAIA token transfers, wallet balance queries, and retrieval of fungible and non-fungible tokens (FTs/NFTs). Designed for developers, it simplifies wallet management and enhances application capabilities within the ElizaOS framework for the Kaia ecosystem.

备注

The Kaia Eliza Plugin uses the Kaia Agent Kit under the hood. This means all onchain actions, like sending tokens or checking balances, are powered by the Kaia Agent Kit’s secure and reliable tools.

Key Features

• Token Transfers: Effortlessly send KAIA tokens between wallets.
• Wallet Queries: Retrieve wallet balances and real-time KAIA price data.
• Network Management: Interact seamlessly with the Kaia blockchain.
• Block & Transaction Information: Access detailed insights into transactions and blocks on the network.

Getting Started

1. Setup ElizaOS

git clone https://github.com/elizaOS/eliza

cd eliza

git checkout $(git describe --tags --abbrev=0)

pnpm install

cp .env.example .env

2. Configuring Environment Variables

To integrate the Kaia plugin, developers must configure environment variables and secrets. The plugin can access these settings through agent.json.secret or directly at runtime.

Now, configure the .env file and kaiaagent.character.json values.

.env file:

GROK_API_KEY= # GROK API Key

GOOGLE_GENERATIVE_AI_API_KEY= # Gemini API Key

备注

To use any LLM provider, configure the relevant API keys in .env. Based on the key provided, update the modelProvider setting in the character file.

kaiaagent.character.json:

{

"name": "Kaia AI Dev Agent",

"plugins": ["@elizaos-plugins/plugin-kaia"],

"clients": [],

"modelProvider": "grok",

"settings": {

"ragKnowledge": false,

"secrets": {

"KAIA_EVM_PRIVATE_KEY": "",

"KAIA_KAIASCAN_API_KEY": "",

"KAIA_FAUCET_AMOUNT": "1"

}

}

}

Provide values for:

• KAIA_EVM_PRIVATE_KEY: Required for on-chain transactions.
• KAIA_KAIASCAN_API_KEY: Obtainable from KaiaScan.
• KAIA_FAUCET_AMOUNT: Specifies the token amount to distribute upon request.

Configuration Example

Download the required character.json file:

wget https://eco-klaytn-safe-asset.s3.ap-northeast-2.amazonaws.com/elizaagent/kaiaagent.character.json -O ./characters/kaiaagent.character.json

Plugin Registration

To enable the Kaia plugin, add it to your agent’s configuration:

{

"name": "Kaia AI Dev Agent",

"plugins": ["@elizaos-plugins/plugin-kaia"]

}

Also, run the command below to add the plugin in your package.json:

npx elizaos plugins install @elizaos-plugins/plugin-kaia

{

"dependencies": {

"@elizaos-plugins/plugin-kaia": "github:kaiachain/kaia-eliza-plugin"

}

}

Build & Start Eliza

pnpm build

pnpm start --character="./characters/kaiaagent.character.json"

Running the Eliza Client UI

Open another terminal and execute:

pnpm run start:client

Once the UI is ready, it should be available at http://localhost:5173.

备注

Ensure that the account associated with the configured private key is funded to perform on-chain transactions on either the Kaia Testnet or Mainnet. Test tokens can be requested from the Kaia Faucet.

Demo

Watch the Kaia Eliza Plugin Demo

Usage Examples

Fetch KAIA Price and Market Data

Command:

User: "Give me KAIA information"

Response:

Assistant: "KAIA Token info: USD: 0.14, Total Supply: 5,936,109,217, Volume: 63,994,146"

Request KAIA Test Tokens

Command:

User: "Give me some test tokens to 0xcfcb1dc1efbbccbb6a9afc78c12315d64e8c383d"

Response:

Assistant: "I'll send a few KAIA testnet tokens..."

Send KAIA Tokens

Command:

User: "Send 1 KAIA to 0xcfcb1dc1efbbccbb6a9afc78c12315d64e8c383d on Kairos"

Response:

Assistant: "I'll send 1 KAIA token now..."

Query Account Information

Command:

User: "What's my account overview of 0xcfcb1dc1efbbccbb6a9afc78c12315d64e8c383d on Kairos?"

Response:

Assistant: "Your account overview details: Account Type: EOA, Balance: 10, Total Transactions: 12"

Check Latest Block Information

Command:

User: "What is the latest block number of Kaia?"

Response:

Assistant: "The latest block number for Kaia is 176629207"

Get Involved

We welcome contributions from the developer community. To explore more about the Kaia blockchain, visit:

• Kaia Documentation
• Kaia Developer Portal
• KaiaScan Explorer
• KaiaScan API Docs
• Kaia Github Repository

Conclusion

The Kaia Eliza Plugin seamlessly integrates with the ElizaOS AI agent framework, enabling intelligent and efficient interaction with the Kaia Mainnet and Kairos Testnet. With its powerful wallet, transaction, and token management features, it empowers developers to build smarter, more responsive decentralized applications while simplifying blockchain interactions.

Ready to enhance your AI-driven blockchain experience? Integrate the Kaia plugin with ElizaOS today and unlock new possibilities!