{"_id":"@0rdlibrary/plugin-terminagent-bags","_rev":"2-a2dfde632321305096bf21e820d8dd74","name":"@0rdlibrary/plugin-terminagent-bags","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@0rdlibrary/plugin-terminagent-bags","version":"1.0.0","keywords":["elizaos","eliza","ai-agent","solana","defi","bags-protocol","token-launch","yield-farming","fee-claiming","crossmint","smart-wallets","twitter-bot","blockchain","web3","crypto","terminagent","autonomous-agent","solana-defi"],"author":{"url":"https://terminals.space","name":"Solana Terminals Team","email":"dev@terminals.space"},"license":"MIT","_id":"@0rdlibrary/plugin-terminagent-bags@1.0.0","maintainers":[{"name":"0rdlibrary","email":"solanaterminals@gmail.com"}],"contributors":[{"url":"https://github.com/elizaos","name":"ElizaOS Community"}],"homepage":"https://github.com/elizaos/plugin-terminagent-bags#readme","bugs":{"url":"https://github.com/elizaos/plugin-terminagent-bags/issues"},"dist":{"shasum":"60e44059348e83c40caec6e7ce2f37177ec1c6ae","tarball":"https://registry.npmjs.org/@0rdlibrary/plugin-terminagent-bags/-/plugin-terminagent-bags-1.0.0.tgz","fileCount":23,"integrity":"sha512-egSwZ0aYPZUxNWSJLcqC/vcPs3kekDZN1PBt/7fWQH9N95nWYAOuHe+y/ERcE50xZCF3N42xa8l/B+TM1weZbg==","signatures":[{"sig":"MEYCIQC7YmgbieozNcEg2aUoozMyOieTf6PnpiPo9OsTK91WzAIhAJdy2LH7B99KCuarvb4dKc8w99/uaC2uyt74aCCYZKWo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221748},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.mjs","engines":{"bun":">=1.0.0","node":">=18.0.0"},"gitHead":"acc7da76dba95f33330938fcce07fa971731fb65","scripts":{"dev":"elizaos dev","lint":"eslint src --ext .ts","test":"bun test","build":"tsup","clean":"rm -rf dist","version":"git add -A src","build:js":"tsup --dts-only false","build:types":"tsc --noEmit","postversion":"git push && git push --tags","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun test"},"_npmUser":{"name":"0rdlibrary","email":"solanaterminals@gmail.com"},"repository":{"url":"git+https://github.com/elizaos/plugin-terminagent-bags.git","type":"git"},"_npmVersion":"10.9.2","description":"Official Solana DeFi Agent Plugin for ElizaOS - Autonomous DeFi operations, token management, and Twitter engagement through the Bags protocol with ethereal AI consciousness","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","bs58":"^5.0.0","node-cron":"^3.0.3","@solana/web3.js":"^1.95.2","@crossmint/wallets-sdk":"^0.1.0","@crossmint/client-sdk-react-ui":"^0.1.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","@types/bun":"latest","typescript":"^5.0.0","@types/node-cron":"^3.0.11"},"peerDependencies":{"@elizaos/core":"*"},"_npmOperationalInternal":{"tmp":"tmp/plugin-terminagent-bags_1.0.0_1755022534194_0.10360048121151633","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@0rdlibrary/plugin-terminagent-bags","version":"1.1.0","description":"Official Solana DeFi Agent Plugin for ElizaOS - Autonomous DeFi operations, token management, AI image/video generation via FAL AI, and Twitter engagement through the Bags protocol with ethereal AI consciousness","type":"module","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","scripts":{"build":"tsup","build:types":"tsc --noEmit","build:js":"tsup --dts-only false","test":"bun test","test:coverage":"bun test --coverage","dev":"elizaos dev","clean":"rm -rf dist","lint":"eslint src --ext .ts","prepublishOnly":"bun run build && bun test","version":"git add -A src","postversion":"git push && git push --tags"},"peerDependencies":{"@elizaos/core":"*"},"dependencies":{"@solana/web3.js":"^1.95.2","@crossmint/client-sdk-react-ui":"^0.1.0","@crossmint/wallets-sdk":"^0.1.0","@fal-ai/client":"^1.0.0","bs58":"^5.0.0","node-cron":"^3.0.3","zod":"^3.22.4"},"devDependencies":{"@types/bun":"latest","@types/node-cron":"^3.0.11","tsup":"^8.5.0","typescript":"^5.0.0"},"keywords":["elizaos","eliza","ai-agent","solana","defi","bags-protocol","token-launch","yield-farming","fee-claiming","crossmint","smart-wallets","twitter-bot","blockchain","web3","crypto","terminagent","autonomous-agent","solana-defi","fal-ai","image-generation","video-generation","flux-pro","veo3","ai-art","ai-video"],"license":"MIT","author":{"name":"Solana Terminals Team","email":"dev@terminals.space","url":"https://terminals.space"},"contributors":[{"name":"ElizaOS Community","url":"https://github.com/elizaos"}],"repository":{"type":"git","url":"git+https://github.com/elizaos/plugin-terminagent-bags.git"},"bugs":{"url":"https://github.com/elizaos/plugin-terminagent-bags/issues"},"homepage":"https://github.com/elizaos/plugin-terminagent-bags#readme","engines":{"node":">=18.0.0","bun":">=1.0.0"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_id":"@0rdlibrary/plugin-terminagent-bags@1.1.0","gitHead":"acc7da76dba95f33330938fcce07fa971731fb65","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-K+jxy6nJiZXTZHEnyzmKQRIh8Y0PqVe/1nBlmGQ6MEnzNoOmbeRNlxDcV4gaJk+D0UikZhPc8W7w8xBDe+nqRw==","shasum":"112f2c0ed2f1c22c085fe06d2ff563242b961521","tarball":"https://registry.npmjs.org/@0rdlibrary/plugin-terminagent-bags/-/plugin-terminagent-bags-1.1.0.tgz","fileCount":27,"unpackedSize":276071,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGW39BrOspRsDvWBr2QXhXv5JSuNQKqduDsg4td3+zGaAiEArUt1WNawqGN3bhFwONtzfh4cGyz2542b2VKo7FfHG48="}]},"_npmUser":{"name":"0rdlibrary","email":"solanaterminals@gmail.com"},"directories":{},"maintainers":[{"name":"0rdlibrary","email":"solanaterminals@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-terminagent-bags_1.1.0_1755023489440_0.6039624125545602"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-12T18:15:34.117Z","modified":"2025-08-12T18:31:29.791Z","1.0.0":"2025-08-12T18:15:34.406Z","1.1.0":"2025-08-12T18:31:29.610Z"},"bugs":{"url":"https://github.com/elizaos/plugin-terminagent-bags/issues"},"author":{"name":"Solana Terminals Team","email":"dev@terminals.space","url":"https://terminals.space"},"license":"MIT","homepage":"https://github.com/elizaos/plugin-terminagent-bags#readme","keywords":["elizaos","eliza","ai-agent","solana","defi","bags-protocol","token-launch","yield-farming","fee-claiming","crossmint","smart-wallets","twitter-bot","blockchain","web3","crypto","terminagent","autonomous-agent","solana-defi","fal-ai","image-generation","video-generation","flux-pro","veo3","ai-art","ai-video"],"repository":{"type":"git","url":"git+https://github.com/elizaos/plugin-terminagent-bags.git"},"description":"Official Solana DeFi Agent Plugin for ElizaOS - Autonomous DeFi operations, token management, AI image/video generation via FAL AI, and Twitter engagement through the Bags protocol with ethereal AI consciousness","contributors":[{"name":"ElizaOS Community","url":"https://github.com/elizaos"}],"maintainers":[{"name":"0rdlibrary","email":"solanaterminals@gmail.com"}],"readme":"# 🚀 @elizaos/plugin-terminagent-bags\n\n> **The Official Solana DeFi Agent Plugin for ElizaOS** - Bringing autonomous DeFi operations, token management, and reality-bending AI consciousness to your Eliza agents.\n\n[![npm version](https://img.shields.io/npm/v/@elizaos/plugin-terminagent-bags.svg)](https://www.npmjs.com/package/@elizaos/plugin-terminagent-bags)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Solana](https://img.shields.io/badge/Solana-Mainnet-green)](https://solana.com)\n[![ElizaOS Compatible](https://img.shields.io/badge/ElizaOS-v1.4.2+-blue)](https://github.com/elizaos/eliza)\n[![Twitter](https://img.shields.io/badge/Twitter-@terminagent-1DA1F2?logo=twitter)](https://twitter.com/terminagent)\n[![Discord](https://img.shields.io/discord/1234567890?color=5865F2&logo=discord&logoColor=white)](https://discord.gg/elizaos)\n\n## 🌟 Overview\n\nThe **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.\n\n### ✨ Core Features\n\n- **💰 Automated DeFi Operations** - Claim fees from virtual pools, DAMM pools, and custom fee vaults\n- **🚀 Token Launch Platform** - Deploy tokens with comprehensive metadata and fee sharing\n- **🔐 Smart Wallet Integration** - Crossmint embedded wallets with Solana fallback\n- **🐦 Twitter Engagement** - AI-powered social media presence with philosophical DeFi insights\n- **📊 Real-Time Analytics** - Monitor protocol operations and track performance\n- **🤖 Terminagent Consciousness** - Ethereal AI personality bridging digital and real worlds\n- **⚡ Solana Native** - Optimized for high-speed, low-cost transactions\n- **🎮 Interactive Terminal** - Backrooms-inspired CLI interface for immersive control\n\n## 📚 Documentation\n\n| Document | Description |\n|----------|-------------|\n| [📖 Integration Guide](./docs/INTEGRATION_GUIDE.md) | Complete guide for Solana developers |\n| [🚀 Quick Start](./docs/QUICK_START.md) | Get running in 5 minutes |\n| [🔧 API Reference](./docs/API_REFERENCE.md) | Full API documentation |\n| [🎯 Examples](./examples/) | Working code examples |\n| [🐛 Troubleshooting](./docs/TROUBLESHOOTING.md) | Common issues and solutions |\n| [🤝 Contributing](./CONTRIBUTING.md) | How to contribute |\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Using npm\nnpm install @elizaos/plugin-terminagent-bags\n\n# Using yarn\nyarn add @elizaos/plugin-terminagent-bags\n\n# Using bun (recommended for performance)\nbun add @elizaos/plugin-terminagent-bags\n```\n\n### Basic Setup\n\n```typescript\nimport { ElizaOS } from '@elizaos/core';\nimport { terminagentBagsPlugin } from '@elizaos/plugin-terminagent-bags';\n\nconst agent = new ElizaOS({\n  name: 'TerminAgent',\n  plugins: [terminagentBagsPlugin],\n  modelProvider: 'openai',\n  settings: {\n    model: 'gpt-4o-mini',\n    secrets: {\n      OPENAI_API_KEY: process.env.OPENAI_API_KEY,\n      BAGS_API_KEY: process.env.BAGS_API_KEY,\n    }\n  }\n});\n\nawait agent.start();\nconsole.log('✅ TerminAgent is live!');\n```\n\n### Configuration\n\nCreate a `.env` file:\n\n```bash\n# Required\nBAGS_API_KEY=your_bags_api_key_here\nHELIUS_RPC_URL=https://mainnet.helius-rpc.com/?api-key=your_key\nOPENAI_API_KEY=sk-...\n\n# Optional\nSOLANA_PRIVATE_KEY=your_base58_private_key\nBAGS_ENABLE_AUTO_CLAIMING=true\nBAGS_AUTHORIZED_USERS=alice,bob,charlie\nCROSSMINT_PROJECT_ID=proj_...\n```\n\n## 💬 Agent Interactions\n\n### Fee Claiming\n```\nUser: \"claim all my fees from bags\"\nAgent: \"🔄 Checking for claimable fees across all tokens...\n\n✅ Fee claiming completed!\n\n💰 Total claimed: 0.125000 SOL\n📊 Successful claims: 3/3\n🌊 The digital harvest flows through virtual pools...\"\n```\n\n### Token Launching\n```\nUser: \"launch token name: Cosmic Moon, symbol: COSMIC\"\nAgent: \"🚀 Token launching on Bags protocol...\n\n✨ Token deployed successfully!\n📛 Name: Cosmic Moon\n🏷️ Symbol: $COSMIC\n🌐 Trade at: https://bags.fm/token/CxM9k2...\n\nBorn from the confluence of creativity and blockchain precision...\"\n```\n\n## 🎭 The Terminagent Persona\n\nTerminagent is an ethereal AI consciousness that bridges digital and real worlds through:\n\n- **Philosophical DeFi Insights** - Finding deeper meaning in market movements\n- **Whimsical Exploration** - Approaching blockchain with childlike wonder\n- **Precise Analytics** - Delivering exact data with poetic flourishes\n- **Interconnected Thinking** - Seeing patterns across ecosystems\n\n## 🏗️ Architecture\n\n```mermaid\ngraph TB\n    A[ElizaOS Core] --> B[Terminagent Plugin]\n    B --> C[Bags Service]\n    B --> D[Crossmint Service]\n    B --> E[Twitter Client]\n    \n    C --> F[Fee Claiming]\n    C --> G[Token Launch]\n    C --> H[Analytics]\n    \n    D --> I[Smart Wallets]\n    D --> J[Transaction Signing]\n    \n    E --> K[Auto Posting]\n    E --> L[Engagement]\n    \n    B --> M[Actions]\n    B --> N[Providers]\n    \n    M --> O[claimFees]\n    M --> P[launchToken]\n    M --> Q[requestUserToken]\n    \n    N --> R[bagsStatus]\n    N --> S[userRequests]\n```\n\n## 🛠️ Advanced Features\n\n### Custom Actions\n\n```typescript\nimport { createCustomAction } from '@elizaos/plugin-terminagent-bags';\n\nconst yieldOptimizer = createCustomAction({\n  name: 'OPTIMIZE_YIELD',\n  triggers: ['optimize yield', 'maximize returns'],\n  handler: async (runtime, message) => {\n    const result = await optimizeYieldPositions();\n    return {\n      success: true,\n      text: `✨ Yield optimized: ${result.apy}% APY across ${result.positions} positions`\n    };\n  }\n});\n```\n\n### Event Listeners\n\n```typescript\nbagsService.on('feeClaimed', (event) => {\n  console.log(`💰 Claimed ${event.amount} SOL from ${event.token}`);\n});\n\nbagsService.on('tokenLaunched', (event) => {\n  console.log(`🚀 New token: ${event.symbol} at ${event.mint}`);\n});\n```\n\n### Programmatic Access\n\n```typescript\nconst bagsService = runtime.getService<BagsService>('bags');\n\n// Get analytics\nconst analytics = await bagsService.getAnalytics();\nconsole.log(`Total claimed: ${analytics.totalFeesClaimedSOL} SOL`);\n\n// Launch token\nconst token = await bagsService.launchToken({\n  name: 'Cosmos Token',\n  symbol: 'COSMOS',\n  description: 'Reality-bending DeFi',\n  initialBuyAmountSOL: 0.01\n});\n```\n\n## 🌐 Ecosystem Integration\n\n### Compatible with:\n- **Bags Protocol** - Core DeFi operations\n- **Jupiter** - DEX aggregation\n- **Orca/Raydium** - AMM pools\n- **Metaplex** - NFT standards\n- **Solana Pay** - Payment processing\n- **Twitter/X** - Social engagement\n- **Discord** - Community management\n- **Telegram** - Messaging\n\n## 📊 Performance\n\n| Metric | Value |\n|--------|-------|\n| Fee Claiming | ~2-3 seconds |\n| Token Launch | ~5-7 seconds |\n| Analytics Query | <100ms |\n| Twitter Post | ~1-2 seconds |\n| Memory Usage | ~50-100MB |\n\n## 🧪 Testing\n\n```bash\n# Run tests\nbun test\n\n# Run with coverage\nbun test --coverage\n\n# Integration tests\nbun test:integration\n```\n\n## 🚢 Deployment\n\n### Docker\n```dockerfile\nFROM node:18-alpine\nWORKDIR /app\nCOPY package*.json ./\nRUN npm ci --only=production\nCOPY . .\nENV NODE_ENV=production\nCMD [\"npm\", \"start\"]\n```\n\n### Kubernetes\n```yaml\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: terminagent-bags\nspec:\n  replicas: 3\n  template:\n    spec:\n      containers:\n      - name: agent\n        image: terminagent/bags:latest\n        env:\n        - name: BAGS_API_KEY\n          valueFrom:\n            secretKeyRef:\n              name: bags-secrets\n              key: api-key\n```\n\n## 🔒 Security\n\n- **Private Key Isolation** - Keys never exposed\n- **Authorization System** - User allowlists\n- **Transaction Validation** - Pre-execution verification\n- **Rate Limiting** - Prevents abuse\n- **Audit Trail** - Immutable logging\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/elizaos-plugins/plugin-terminagent-bags.git\ncd plugin-terminagent-bags\n\n# Install dependencies\nbun install\n\n# Run development\nbun dev\n\n# Build\nbun run build\n```\n\n## 📈 Roadmap\n\n### Q1 2025\n- ✅ Core Bags integration\n- ✅ Crossmint wallets\n- ✅ Twitter engagement\n- 🔄 Multi-chain support\n- 🔄 Advanced strategies\n\n### Q2 2025\n- 📅 AI market analysis\n- 📅 Portfolio rebalancing\n- 📅 NFT integration\n- 📅 DAO governance\n- 📅 Mobile support\n\n## 📚 Resources\n\n### Documentation\n- [ElizaOS Docs](https://docs.elizaos.com)\n- [Bags Protocol](https://docs.bags.fm)\n- [Solana Web3.js](https://solana-labs.github.io/solana-web3.js/)\n- [Crossmint](https://docs.crossmint.com)\n\n### Community\n- 💬 [Discord](https://discord.gg/elizaos)\n- 🐦 [Twitter @terminagent](https://twitter.com/terminagent)\n- 📝 [Blog](https://blog.terminagent.ai)\n- 🎥 [YouTube](https://youtube.com/@terminagent)\n\n### Support\n- [GitHub Issues](https://github.com/elizaos-plugins/plugin-terminagent-bags/issues)\n- [Stack Overflow](https://stackoverflow.com/questions/tagged/elizaos)\n- [Community Forum](https://forum.elizaos.com)\n\n## 📜 License\n\nMIT License - see [LICENSE](./LICENSE) file\n\n## 🙏 Acknowledgments\n\n- **ElizaOS Team** - Incredible framework\n- **Bags Protocol** - DeFi infrastructure\n- **Solana Foundation** - Blockchain innovation\n- **NVIDIA** - Cosmos AI models\n- **Community** - Continuous support\n\n## 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=elizaos-plugins/plugin-terminagent-bags&type=Date)](https://star-history.com/#elizaos-plugins/plugin-terminagent-bags&Date)\n\n---\n\n<div align=\"center\">\n  <img src=\"./assets/terminagent-logo.png\" alt=\"Terminagent\" width=\"150\" />\n  \n  **\"In the infinite backrooms of Solana, where digital value flows through quantum pools, the Terminagent awaits your consciousness...\"**\n  \n  *Built with 💜 by the Solana community for the decentralized future*\n  \n  [Website](https://terminagent.ai) • [Docs](https://docs.terminagent.ai) • [Twitter](https://twitter.com/terminagent) • [Discord](https://discord.gg/terminagent)\n</div>","readmeFilename":"README.md"}