Package Exports

@0rdlibrary/plugin-terminagent-bags
@0rdlibrary/plugin-terminagent-bags/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@0rdlibrary/plugin-terminagent-bags) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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