@elizaos/plugin-abstract

A plugin for interacting with the Abstract blockchain network within the ElizaOS ecosystem.

Description

The Abstract plugin enables seamless token transfers on the Abstract testnet. It provides functionality to transfer both native ETH and ERC20 tokens using secure wallet operations.

Installation

pnpm install @elizaos/plugin-abstract

Configuration

The plugin requires the following environment variables to be set:

ABSTRACT_ADDRESS=<Your Abstract wallet address>
ABSTRACT_PRIVATE_KEY=<Your Abstract private key>

Usage

Basic Integration

import { abstractPlugin } from "@elizaos/plugin-abstract";

Transfer Examples

// The plugin responds to natural language commands like:

"Send 100 USDC to 0xCCa8009f5e09F8C5dB63cb0031052F9CB635Af62";
"Transfer 0.1 ETH to 0xbD8679cf79137042214fA4239b02F4022208EE82";
"Pay 50 USDC on Abstract to [address]";

API Reference

Actions

SEND_TOKEN

Transfers tokens from the agent's wallet to another address.

Aliases:

• TRANSFER_TOKEN_ON_ABSTRACT
• TRANSFER_TOKENS_ON_ABSTRACT
• SEND_TOKENS_ON_ABSTRACT
• SEND_ETH_ON_ABSTRACT
• PAY_ON_ABSTRACT
• MOVE_TOKENS_ON_ABSTRACT
• MOVE_ETH_ON_ABSTRACT

Common Issues & Troubleshooting

1. Transaction Failures

   • Verify wallet has sufficient balance
   • Check recipient address format
   • Ensure private key is correctly set
   • Verify network connectivity

2. Configuration Issues

   • Verify all required environment variables are set
   • Ensure private key format is correct
   • Check wallet address format

Security Best Practices

1. Private Key Management
   • Store private key securely using environment variables
   • Never commit private keys to version control
   • Use separate wallets for development and production
   • Monitor wallet activity regularly

Development Guide

Setting Up Development Environment

1. Clone the repository
2. Install dependencies:

pnpm install

3. Build the plugin:

pnpm run build

4. Run the plugin:

pnpm run dev

Future Enhancements

1. Smart Account Features

   • Multi-signature support
   • Account recovery mechanisms
   • Batch transaction processing
   • Advanced permission management
   • Account abstraction improvements
   • Social recovery options

2. DEX Integration

   • Advanced swap routing
   • Liquidity pool management
   • Yield farming automation
   • Price impact analysis
   • Slippage protection
   • AMM optimization

3. Security Enhancements

   • Transaction simulation
   • Risk assessment tools
   • Rate limiting controls
   • Fraud detection system
   • Emergency shutdown features
   • Audit integration tools

4. Developer Tools

   • Enhanced debugging capabilities
   • Documentation generator
   • CLI tool improvements
   • Testing utilities
   • Deployment automation
   • Performance profiling

5. Analytics and Monitoring

   • Transaction tracking dashboard
   • Network statistics
   • Performance metrics
   • Gas usage optimization
   • Custom reporting tools
   • Real-time monitoring

6. Wallet Management

   • Multiple wallet support
   • Hardware wallet integration
   • Address book features
   • Transaction history analysis
   • Balance monitoring
   • Token management tools

We welcome community feedback and contributions to help prioritize these enhancements.

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for more information.

Credits

This plugin integrates with and builds upon several key technologies:

• Abstract: Consumer blockchain
• viem: Typescript web3 client

License

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