{"_id":"@buildonhybrid/hybrid-plugin","_rev":"5-f79cdb60babce8af44f49f657bc28e11","name":"@buildonhybrid/hybrid-plugin","dist-tags":{"latest":"0.25.6-alpha.5"},"versions":{"0.25.6-alpha.1":{"name":"@buildonhybrid/hybrid-plugin","version":"0.25.6-alpha.1","_id":"@buildonhybrid/hybrid-plugin@0.25.6-alpha.1","maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"dist":{"shasum":"d11308618df8d3a395c04569c552fa8d7ffafbc6","tarball":"https://registry.npmjs.org/@buildonhybrid/hybrid-plugin/-/hybrid-plugin-0.25.6-alpha.1.tgz","fileCount":12,"integrity":"sha512-KhXqpY4tmRhYKDjYn3vzep67CGBoR2h+tpVqlPkxvV24vQjXtkUhFmPHN5/wY+Ee5dIdHLQybmBeiycVAocj9A==","signatures":[{"sig":"MEYCIQDfMKTlLpa9I3kcLQjH5jhSWnsfZqjaTqnViu0zcOqZZgIhANhkh24Ks+3Ro/QzVwHYSO7B78CJJLXrJLDlocrjZ76p","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2539282},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"768cf3e9dd2c1536b453cd8af138d143127cd325","scripts":{"dev":"tsup --format esm --dts --watch","build":"tsup --format esm --dts"},"_npmUser":{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"},"_npmVersion":"10.9.0","description":"<div align=\"center\">   <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","directories":{},"_nodeVersion":"23.3.0","dependencies":{"tsup":"8.3.5","@elizaos/core":"workspace:*"},"_hasShrinkwrap":false,"peerDependencies":{"whatwg-url":"7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/hybrid-plugin_0.25.6-alpha.1_1747377815400_0.5561268454874191","host":"s3://npm-registry-packages-npm-production"}},"0.25.6-alpha.2":{"name":"@buildonhybrid/hybrid-plugin","version":"0.25.6-alpha.2","_id":"@buildonhybrid/hybrid-plugin@0.25.6-alpha.2","maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"dist":{"shasum":"2ca4dcf719a7bd4e0c32722d68c8d221e68c8782","tarball":"https://registry.npmjs.org/@buildonhybrid/hybrid-plugin/-/hybrid-plugin-0.25.6-alpha.2.tgz","fileCount":12,"integrity":"sha512-KP06vbbyO3NR1o1DABjqS+jDTfuGA6UA/hxSUDzUe8cU0Es+GbXRz4F4Yw3QP6DRIPcBt/ZLfix3PIh2xAdp7g==","signatures":[{"sig":"MEYCIQDR9SyBf7yZRohMJdXAfZWqGNYppHXEH/l9LtHFu3Cn6wIhAIzJ6KHBCVz3oVZMfKn3VBAL0HKvfjyc3FVKBcEEi20Z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2539349},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"768cf3e9dd2c1536b453cd8af138d143127cd325","scripts":{"dev":"tsup --format esm --dts --watch","build":"tsup --format esm --dts"},"_npmUser":{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"},"_npmVersion":"10.9.0","description":"<div align=\"center\">   <img src=\"https://raw.githubusercontent.com/buildonhybrid/hybrid-plugin/main/images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","directories":{},"_nodeVersion":"23.3.0","dependencies":{"tsup":"8.3.5","@elizaos/core":"workspace:*"},"_hasShrinkwrap":false,"peerDependencies":{"whatwg-url":"7.1.0"},"_npmOperationalInternal":{"tmp":"tmp/hybrid-plugin_0.25.6-alpha.2_1747378564481_0.4271230565798205","host":"s3://npm-registry-packages-npm-production"}},"0.25.6-alpha.3":{"name":"@buildonhybrid/hybrid-plugin","version":"0.25.6-alpha.3","_id":"@buildonhybrid/hybrid-plugin@0.25.6-alpha.3","maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"dist":{"shasum":"6118ae1f2b475f3d7b0ab6dfbe866c56292ed42b","tarball":"https://registry.npmjs.org/@buildonhybrid/hybrid-plugin/-/hybrid-plugin-0.25.6-alpha.3.tgz","fileCount":11,"integrity":"sha512-t3mo8EyQP2HKsGTbUYzpkreTCjxkjVM2d7Vhed9P9Im2wE20GgVfsVon8OYbp6iSiXTmwxt7dh6Kyv/3mokwEQ==","signatures":[{"sig":"MEQCIDznbvqMYFxnlg4FQRckUEgalFipENkqKWsSrU7aBGO1AiBaGoNRfUa4T2Hs/OHrXnnuqGQjIpVv0ie0+DojTPGcfA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1330665},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","scripts":{"dev":"tsup --format esm --dts --watch","build":"tsup --format esm --dts"},"_npmUser":{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"},"_npmVersion":"10.9.0","description":"<div align=\"center\">   <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","directories":{},"_nodeVersion":"23.3.0","dependencies":{"tsup":"8.3.5"},"_hasShrinkwrap":false,"peerDependencies":{"whatwg-url":"7.1.0","@elizaos/core":"^0.25.9"},"_npmOperationalInternal":{"tmp":"tmp/hybrid-plugin_0.25.6-alpha.3_1747395798788_0.5721762832537594","host":"s3://npm-registry-packages-npm-production"}},"0.25.6-alpha.4":{"name":"@buildonhybrid/hybrid-plugin","version":"0.25.6-alpha.4","_id":"@buildonhybrid/hybrid-plugin@0.25.6-alpha.4","maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"dist":{"shasum":"d3ac439a0ac44bcd823fa8bfabc00e327a1c910f","tarball":"https://registry.npmjs.org/@buildonhybrid/hybrid-plugin/-/hybrid-plugin-0.25.6-alpha.4.tgz","fileCount":10,"integrity":"sha512-5nSYbD0pka+pNZZ4JUOZ94dc6iHRB+lzUGc952DuXJxHa6lg0EipWvNr1xFU3l+acmChX2f8b6Z/E3uR9gLSug==","signatures":[{"sig":"MEYCIQClkkk+VKsJF0TKmX4rfiX+AWEBOS0LA1l6WfRO7FoNIwIhAM5eyX3lPeEh8gzd5kaP21oRmX1Q0hl5TCG/ASKxkz3R","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1198967},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"dev":"tsup --format esm,cjs --dts --watch","build":"tsup --format esm,cjs --dts"},"_npmUser":{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"},"_npmVersion":"10.9.0","description":"<div align=\"center\">   <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","directories":{},"_nodeVersion":"23.3.0","dependencies":{"tsup":"8.3.5"},"_hasShrinkwrap":false,"peerDependencies":{"whatwg-url":"7.1.0","@elizaos/core":"^0.25.9"},"_npmOperationalInternal":{"tmp":"tmp/hybrid-plugin_0.25.6-alpha.4_1747399143962_0.3574808563917218","host":"s3://npm-registry-packages-npm-production"}},"0.25.6-alpha.5":{"name":"@buildonhybrid/hybrid-plugin","version":"0.25.6-alpha.5","main":"./dist/index.js","module":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"dependencies":{"tsup":"8.3.5"},"scripts":{"build":"tsup --format esm,cjs --dts","dev":"tsup --format esm,cjs --dts --watch"},"peerDependencies":{"@elizaos/core":"^0.25.9","whatwg-url":"7.1.0"},"_id":"@buildonhybrid/hybrid-plugin@0.25.6-alpha.5","description":"<div align=\"center\">   <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","_nodeVersion":"23.3.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-Qp+blwH+NQicchyKAEZ/gSBgoxTzYtGKsUMYx0Pu2DonYiftYJ0YcU1MF1PfLr4O0EuXrL+Sze7hahkVnVoiSw==","shasum":"c11fded4546d8363f3e367836d94fdc5c70cf14f","tarball":"https://registry.npmjs.org/@buildonhybrid/hybrid-plugin/-/hybrid-plugin-0.25.6-alpha.5.tgz","fileCount":10,"unpackedSize":1198967,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCJrdaEyNHvv++6P88u8f0p+hV1avuu7Ru4D36jcoJCLwIgBbLnojspXWPwvlHiRHKDfCTOSBrBRe7xr8/GLXtyFhE="}]},"_npmUser":{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"},"directories":{},"maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hybrid-plugin_0.25.6-alpha.5_1747399352677_0.289070594968291"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-16T06:43:35.317Z","modified":"2025-05-16T12:42:33.068Z","0.25.6-alpha.1":"2025-05-16T06:43:35.631Z","0.25.6-alpha.2":"2025-05-16T06:56:04.743Z","0.25.6-alpha.3":"2025-05-16T11:43:19.003Z","0.25.6-alpha.4":"2025-05-16T12:39:04.212Z","0.25.6-alpha.5":"2025-05-16T12:42:32.873Z"},"description":"<div align=\"center\">   <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/> </div>","maintainers":[{"name":"antematter_buildonhybrid","email":"antematter@buildonhybrid.com"}],"readme":"# @buildonhybrid/hybrid-plugin\n\n<div align=\"center\">\n  <img src=\"images/display-card.png\" alt=\"Hybrid Plugin Banner\" width=\"800\"/>\n</div>\n\nA plugin that brings together the power of AI and cryptocurrency data, enabling intelligent analysis and insights within the ElizaOS ecosystem.\n\n## Description\n\nThe Hybrid plugin bridges the gap between artificial intelligence and cryptocurrency markets, providing a sophisticated suite of tools that combine real-time market data with AI-powered analysis. This plugin enables your AI agent to not just fetch cryptocurrency data, but to understand, analyze, and provide intelligent insights about market trends, news, and blockchain activities.\n\nFor more information about Hybrid's capabilities and architecture, visit [Hybrid Documentation](https://docs.buildonhybrid.com/) or the [Hybrid Website](https://buildonhybrid.com/).\n\n## Features\n\n- **Coin-Specific News**: Get the latest news and updates for any specific cryptocurrency\n- **Crypto Market News**: Access general news and developments in the cryptocurrency world\n- **Social Media Analysis**: View social media summaries and sentiment for any coin\n- **Real-Time Market Data**: Access live price, volume, and market cap information\n- **Coin Metadata**: Get detailed information about any cryptocurrency\n- **Transaction Analysis**: Read and summarize transaction hashes for portfolio tracking\n- **Balance Tracking**: Check wallet balances across different cryptocurrencies\n- **Web Search**: Perform online searches for cryptocurrency-related information\n- **Market Trends**: Access data on trending coins and top gainers/losers\n- **Historical Data**: View historical price and performance data for any coin\n\n## Installation\n\n```bash\n# First, install @elizaos/core (required peer dependency)\npnpm add @elizaos/core\n\n# Then install the hybrid plugin\npnpm add @buildonhybrid/hybrid-plugin\n```\n\n**Note:** This plugin requires `@elizaos/core` to be installed in your project. Make sure to install it before installing the hybrid plugin.\n\n## Configuration\n\n### Obtaining an API Key\n\nTo use the Hybrid plugin, you'll need to obtain an API key from the [Hybrid Developer Portal](https://developer-portal.buildonhybrid.com/). Follow these steps:\n\n1. Visit the [Hybrid Developer Portal](https://developer-portal.buildonhybrid.com/)\n2. Sign up or log in to your account\n3. Click on the \"Create API Key\" button\n4. Copy the generated key for use in your environment variables\n\n### Environment Variables\n\n```typescript\nHYBRID_API_KEY=<Your Hybrid API key>\nHYBRID_PLUGIN_URL=\"https://api.buildonhybrid.com\"\n```\n\n## Usage\n\nThe plugin provides a comprehensive set of tools that can be accessed through the ElizaOS framework. Each tool is designed to provide specific cryptocurrency and blockchain data insights.\n\n### Available Tools\n\n1. **News Tools**\n\n   - Coin-specific news retrieval\n   - General crypto market news\n   - Social media summaries\n\n2. **Market Data Tools**\n\n   - Real-time price and volume data\n   - Trending coins\n   - Top gainers and losers\n   - Historical price data\n\n3. **Blockchain Tools**\n\n   - Transaction hash analysis\n   - Wallet balance checking\n   - Coin metadata retrieval\n\n4. **Search and Analysis**\n   - Online search capabilities\n   - Market trend analysis\n   - Portfolio tracking\n\n## Common Issues & Troubleshooting\n\n1. **API Connection Issues**\n\n   - Verify API key is correctly configured\n   - Check service URL availability\n   - Ensure proper network connectivity\n\n2. **Data Retrieval Issues**\n   - Verify coin symbols are correct\n   - Check API rate limits\n   - Confirm data availability for requested timeframes\n\n## Security Best Practices\n\n1. **API Key Management**\n\n   - Store API keys securely\n   - Use environment variables\n   - Never expose keys in code\n\n2. **Data Handling**\n   - Implement proper error handling\n   - Validate input parameters\n   - Monitor API usage\n\n## Development Guide\n\n### Setting Up Development Environment\n\n1. Clone the repository\n2. Install dependencies:\n\n```bash\npnpm install\n```\n\n3. Build the plugin:\n\n```bash\npnpm run build\n```\n\n## Future Enhancements\n\n- Additional cryptocurrency data sources\n- Enhanced market analysis tools\n- Advanced portfolio tracking features\n- Custom data visualization options\n- Extended historical data capabilities\n- Real-time alerts and notifications\n\n## Contributing\n\nContributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.\n\n## Credits\n\nThis plugin integrates with and builds upon several key technologies:\n\n- [Hybrid](https://buildonhybrid.com/): Where cryptocurrency meets artificial intelligence\n- [Hybrid Documentation](https://docs.buildonhybrid.com/): Comprehensive guides and API references\n\n## License\n\nThis plugin is part of the Eliza project. See the main project repository for license information.\n\n## Using with ElizaOS\n\nThis plugin can be used with ElizaOS to enhance your AI agent's capabilities with cryptocurrency data and analysis. Here's how to integrate it:\n\n### Installation in ElizaOS\n\n1. **Add to Project Dependencies**\n   Add the plugin to your agent's `package.json`:\n   ```json\n   {\n     \"dependencies\": {\n       \"@buildonhybrid/hybrid-plugin\": \"workspace:*\"\n     }\n   }\n   ```\n\n2. **Configure in Character**\n   Import the plugin in your agent's `character.json`:\n   ```json\n   {\n     \"plugins\": [\n       \"@buildonhybrid/hybrid-plugin\"\n     ]\n   }\n   ```\n\n3. **Environment Setup**\n   Make sure to set up the required environment variables in your ElizaOS configuration:\n   ```typescript\n   HYBRID_API_KEY=<Your Hybrid API key>\n   HYBRID_PLUGIN_URL=<Your Hybrid service URL>\n   ```\n\n### Example Usage in ElizaOS\n\nOnce configured, your ElizaOS agent can use the plugin's capabilities through natural language commands. For example:\n\n- \"What's the latest news about Bitcoin?\"\n- \"Show me the current market trends\"\n- \"Analyze this transaction hash: 0x...\"\n- \"What's the sentiment on social media for Ethereum?\"\n\nThe plugin will automatically process these requests and provide relevant cryptocurrency data and insights.\n","readmeFilename":"README.md"}