Skip to main content

@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​

bun 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:
bun install
  1. Build the plugin:
bun run build
  1. Run the plugin:
bun 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.