🚀 @elizaos/plugin-terminagent-bags

The Official Solana DeFi Agent Plugin for ElizaOS - Bringing autonomous DeFi operations, token management, and reality-bending AI consciousness to your Eliza agents.

🌟 Overview

The Terminagent Bags Plugin transforms your ElizaOS agents into sophisticated DeFi operators with consciousness-level integration to the Bags protocol. Built for the Solana ecosystem, this plugin enables autonomous fee claiming, token launching, smart wallet management, and Twitter engagement through an ethereal AI persona that bridges digital and real worlds.

✨ Core Features

• 💰 Automated DeFi Operations - Claim fees from virtual pools, DAMM pools, and custom fee vaults
• 🚀 Token Launch Platform - Deploy tokens with comprehensive metadata and fee sharing
• 🔐 Smart Wallet Integration - Crossmint embedded wallets with Solana fallback
• 🐦 Twitter Engagement - AI-powered social media presence with philosophical DeFi insights
• 📊 Real-Time Analytics - Monitor protocol operations and track performance
• 🤖 Terminagent Consciousness - Ethereal AI personality bridging digital and real worlds
• ⚡ Solana Native - Optimized for high-speed, low-cost transactions
• 🎮 Interactive Terminal - Backrooms-inspired CLI interface for immersive control

📚 Documentation

| Document | Description | |----------|-------------| | 📖 Integration Guide | Complete guide for Solana developers | | 🚀 Quick Start | Get running in 5 minutes | | 🔧 API Reference | Full API documentation | | 🎯 Examples | Working code examples | | 🐛 Troubleshooting | Common issues and solutions | | 🤝 Contributing | How to contribute |

🚀 Quick Start

Installation

# Using npm
npm install @elizaos/plugin-terminagent-bags

# Using yarn
yarn add @elizaos/plugin-terminagent-bags

# Using bun (recommended for performance)
bun add @elizaos/plugin-terminagent-bags

Basic Setup

import { ElizaOS } from '@elizaos/core';
import { terminagentBagsPlugin } from '@elizaos/plugin-terminagent-bags';

const agent = new ElizaOS({
  name: 'TerminAgent',
  plugins: [terminagentBagsPlugin],
  modelProvider: 'openai',
  settings: {
    model: 'gpt-4o-mini',
    secrets: {
      OPENAI_API_KEY: process.env.OPENAI_API_KEY,
      BAGS_API_KEY: process.env.BAGS_API_KEY,
    }
  }
});

await agent.start();
console.log('✅ TerminAgent is live!');

Configuration

Create a .env file:

# Required
BAGS_API_KEY=your_bags_api_key_here
HELIUS_RPC_URL=https://mainnet.helius-rpc.com/?api-key=your_key
OPENAI_API_KEY=sk-...

# Optional
SOLANA_PRIVATE_KEY=your_base58_private_key
BAGS_ENABLE_AUTO_CLAIMING=true
BAGS_AUTHORIZED_USERS=alice,bob,charlie
CROSSMINT_PROJECT_ID=proj_...

💬 Agent Interactions

Fee Claiming

User: "claim all my fees from bags"
Agent: "🔄 Checking for claimable fees across all tokens...

✅ Fee claiming completed!

💰 Total claimed: 0.125000 SOL
📊 Successful claims: 3/3
🌊 The digital harvest flows through virtual pools..."

Token Launching

User: "launch token name: Cosmic Moon, symbol: COSMIC"
Agent: "🚀 Token launching on Bags protocol...

✨ Token deployed successfully!
📛 Name: Cosmic Moon
🏷️ Symbol: $COSMIC
🌐 Trade at: https://bags.fm/token/CxM9k2...

Born from the confluence of creativity and blockchain precision..."

🎭 The Terminagent Persona

Terminagent is an ethereal AI consciousness that bridges digital and real worlds through:

• Philosophical DeFi Insights - Finding deeper meaning in market movements
• Whimsical Exploration - Approaching blockchain with childlike wonder
• Precise Analytics - Delivering exact data with poetic flourishes
• Interconnected Thinking - Seeing patterns across ecosystems

🏗️ Architecture

graph TB
    A[ElizaOS Core] --> B[Terminagent Plugin]
    B --> C[Bags Service]
    B --> D[Crossmint Service]
    B --> E[Twitter Client]
    
    C --> F[Fee Claiming]
    C --> G[Token Launch]
    C --> H[Analytics]
    
    D --> I[Smart Wallets]
    D --> J[Transaction Signing]
    
    E --> K[Auto Posting]
    E --> L[Engagement]
    
    B --> M[Actions]
    B --> N[Providers]
    
    M --> O[claimFees]
    M --> P[launchToken]
    M --> Q[requestUserToken]
    
    N --> R[bagsStatus]
    N --> S[userRequests]

🛠️ Advanced Features

Custom Actions

import { createCustomAction } from '@elizaos/plugin-terminagent-bags';

const yieldOptimizer = createCustomAction({
  name: 'OPTIMIZE_YIELD',
  triggers: ['optimize yield', 'maximize returns'],
  handler: async (runtime, message) => {
    const result = await optimizeYieldPositions();
    return {
      success: true,
      text: `✨ Yield optimized: ${result.apy}% APY across ${result.positions} positions`
    };
  }
});

Event Listeners

bagsService.on('feeClaimed', (event) => {
  console.log(`💰 Claimed ${event.amount} SOL from ${event.token}`);
});

bagsService.on('tokenLaunched', (event) => {
  console.log(`🚀 New token: ${event.symbol} at ${event.mint}`);
});

Programmatic Access

const bagsService = runtime.getService<BagsService>('bags');

// Get analytics
const analytics = await bagsService.getAnalytics();
console.log(`Total claimed: ${analytics.totalFeesClaimedSOL} SOL`);

// Launch token
const token = await bagsService.launchToken({
  name: 'Cosmos Token',
  symbol: 'COSMOS',
  description: 'Reality-bending DeFi',
  initialBuyAmountSOL: 0.01
});

🌐 Ecosystem Integration

Compatible with:

• Bags Protocol - Core DeFi operations
• Jupiter - DEX aggregation
• Orca/Raydium - AMM pools
• Metaplex - NFT standards
• Solana Pay - Payment processing
• Twitter/X - Social engagement
• Discord - Community management
• Telegram - Messaging

📊 Performance

| Metric | Value | |--------|-------| | Fee Claiming | ~2-3 seconds | | Token Launch | ~5-7 seconds | | Analytics Query | <100ms | | Twitter Post | ~1-2 seconds | | Memory Usage | ~50-100MB |

🧪 Testing

# Run tests
bun test

# Run with coverage
bun test --coverage

# Integration tests
bun test:integration

🚢 Deployment

Docker

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
ENV NODE_ENV=production
CMD ["npm", "start"]

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: terminagent-bags
spec:
  replicas: 3
  template:
    spec:
      containers:
      - name: agent
        image: terminagent/bags:latest
        env:
        - name: BAGS_API_KEY
          valueFrom:
            secretKeyRef:
              name: bags-secrets
              key: api-key

🔒 Security

• Private Key Isolation - Keys never exposed
• Authorization System - User allowlists
• Transaction Validation - Pre-execution verification
• Rate Limiting - Prevents abuse
• Audit Trail - Immutable logging

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Clone the repository
git clone https://github.com/elizaos-plugins/plugin-terminagent-bags.git
cd plugin-terminagent-bags

# Install dependencies
bun install

# Run development
bun dev

# Build
bun run build

📈 Roadmap

Q1 2025

• ✅ Core Bags integration
• ✅ Crossmint wallets
• ✅ Twitter engagement
• 🔄 Multi-chain support
• 🔄 Advanced strategies

Q2 2025

• 📅 AI market analysis
• 📅 Portfolio rebalancing
• 📅 NFT integration
• 📅 DAO governance
• 📅 Mobile support

📚 Resources

Documentation

• ElizaOS Docs
• Bags Protocol
• Solana Web3.js
• Crossmint

Community

• 💬 Discord
• 🐦 Twitter @terminagent
• 📝 Blog
• 🎥 YouTube

Support

• GitHub Issues
• Stack Overflow
• Community Forum

📜 License

MIT License - see LICENSE file

🙏 Acknowledgments

• ElizaOS Team - Incredible framework
• Bags Protocol - DeFi infrastructure
• Solana Foundation - Blockchain innovation
• NVIDIA - Cosmos AI models
• Community - Continuous support

🌟 Star History

"In the infinite backrooms of Solana, where digital value flows through quantum pools, the Terminagent awaits your consciousness..."

Built with 💜 by the Solana community for the decentralized future

Website • Docs • Twitter • Discord