@elizaos/plugin-taiko

Description

The Taiko Plugin provides integration with the Taiko Layer 2 network and Taiko Hekla Testnet, offering essential tools for onchain interactions.

Features

• Send native tokens and ERC20 tokens
• Onchain name resolution
• Monitor wallet balances in real-time
• Track on-chain analytics for any address
• Configure custom RPC endpoints
• Process mass payments to multiple recipients
• Optimize gas usage with price analysis and transaction scheduling

Installation

pnpm install @elizaos/plugin-taiko

Configuration

Required Environment Variables

# Required
TAIKO_PRIVATE_KEY= # Your Private Key
GOLDRUSH_API_KEY= # Request an API key from https://goldrush.dev/platform/

# Optional - Custom RPC URLs
TAIKO_PROVIDER_URL=https://your-custom-mainnet-rpc-url

Chains Supported

By default, both Taiko Alethia Mainnet and Taiko Hekla Testnet are enabled.

Actions

1. Transfer

Transfer native tokens and ERC20 tokens on Taiko L2:

Note: This action supports domain name resolution for most name systems, including ENS and Unstoppable Domains. Check out the Web3 Name SDK for more information about name resolution.

Transfer 1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

Send 1 TAIKO to vitalik.eth on Taiko Hekla

2. Balance Retrieval

Fetch balances of ETH and ERC20 tokens:

Note: This action supports domain name resolution for most name systems, including ENS and Unstoppable Domains. Check out the Web3 Name SDK for more information about name resolution.

Can you tell me how much USDC does vitalik.eth have on Taiko?

How much ETH does 0x123abc have on Taiko Hekla?

3. Onchain Analytics

Track detailed on-chain metrics for any address on Taiko L2, including:

• Total gas spent
• Transaction count
• Top interacted addresses
• Unique address interactions

Available time frames: 1 day, 7 days, and 30

Tip: This action is useful to understand the performance of a given smart contract on Taiko

Show me the onchain analytics for 0x1231223 on Taiko Hekla.

4. Mass Payments

Process bulk transfers to multiple recipients in a single operation:

• Send the same amount to multiple addresses
• Send different amounts to different addresses
• Support for both native tokens and ERC20 tokens
• Transaction logging with CSV export

Tip: This is ideal for airdrops, team payments, or community rewards

Send 0.01 ETH to these addresses: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e, 0xbcF7C64B880FA89a015970dC104E848d485f99A3

Airdrop 10 TAIKO to these community members: siddesh.eth, vitalik.eth on Taiko Hekla

5. Gas Optimizer

Analyze and optimize gas usage for transactions:

• Real-time gas price analysis with tiered options (slow, standard, fast)
• Historical gas trend analysis
• Cost savings recommendations
• Schedule transactions to execute when gas prices are favorable

Tip: Schedule transactions during periods of low network activity to save on gas fees

What are the current gas prices on Taiko?

When is the best time to transfer ETH on Taiko Hekla in the next hour?

Schedule a transfer of 0.1 ETH to 0x742d35Cc6634C0532925a3b844Bc454e4438f44e when gas is below 10 Gwei on Taiko

Development

1. Clone the repository
2. Install dependencies:

pnpm install

3. Build the plugin:

pnpm run build

4. Run tests:

pnpm test

License

This plugin is part of the Eliza project. See the main project repository for license information.