@elizaos/plugin-social-alpha 2.0.0-beta.1 → 2.0.11-beta.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,176 +1,97 @@
-# Marketplace of Trust Plugin
+# @elizaos/plugin-social-alpha
 
-A sophisticated trust scoring system for ElizaOS that analyzes trading calls and calculates user trust scores based on performance metrics.
+An elizaOS plugin that tracks cryptocurrency token recommendations made by users in chat, evaluates their accuracy against real price outcomes, and builds trust scores for each recommender.
 
-## Overview
+## What it does
 
-The Marketplace of Trust plugin provides:
-- **Trust Score Calculation**: Advanced algorithm that evaluates users based on profit, win rate, Sharpe ratio, and call quality
-- **Trading Call Analysis**: Process Discord messages to extract and analyze trading calls
-- **Price Data Enrichment**: Integrate with Birdeye and DexScreener APIs for historical price data
-- **Algorithm Optimization**: Machine learning-based parameter tuning for optimal trust score accuracy
-- **Leaderboard System**: Real-time trust score rankings with beautiful UI
+- **Recommendation capture.** Every incoming message is analyzed with a single LLM call to detect buy/sell calls ("shills" and "FUD"). Detected calls are stored against the sender's trust profile as an elizaOS Component.
+- **Trust scoring.** Scores are calculated using a multi-factor algorithm: profit percentage, win rate, Sharpe ratio, alpha vs market, consistency, and a scam/rug penalty.
+- **Leaderboard.** Ranked leaderboard of all tracked recommenders is available as a JSON API and as a dashboard view (`SocialAlphaView`).
+- **Agent context injection.** The `socialAlpha` provider injects the current speaker's trust stats and the top/bottom leaderboard into the agent's context automatically, so the agent can factor reputation into its responses.
 
-## Architecture
+## Capabilities added to an Eliza agent
 
-```
-src/
-├── services/              # Core business logic
-│   ├── SimulationService.ts      # Consolidated simulation functionality
-│   ├── PriceDataService.ts       # Price data fetching and enrichment
-│   ├── TrustScoreService.ts      # Trust score calculation and optimization
-│   └── balancedTrustScoreCalculator.ts  # Core scoring algorithm
-├── frontend/              # React UI components
-│   └── LeaderboardTable.tsx      # Trust score leaderboard
-└── __tests__/            # Comprehensive test suite
-```
-
-## Installation
+| Capability | Description |
+|-----------|-------------|
+| `socialAlpha` provider | Injects trust scores, win rate, avg P&L, and leaderboard into agent context |
+| `MESSAGE_RECEIVED` event handler | Extracts buy/sell signals from messages in real time |
+| `CommunityInvestorService` | Manages all trust score and recommendation data |
+| `GET /api/social-alpha/leaderboard` route | Returns `LeaderboardEntry[]` JSON |
+| `social-alpha` view | Leaderboard dashboard view — appears in the view manager when the plugin is enabled; requires a configured agent wallet |
 
-```bash
-npm install @elizaos/plugin-marketplace-of-trust
-```
+No actions are added — recommendation capture is event-driven, not agent-initiated.
 
-## Configuration
+## How to enable
 
-Add to your `.env` file:
-
-```env
-# API Keys (at least one required)
-BIRDEYE_API_KEY=your_birdeye_api_key
-DEXSCREENER_API_KEY=your_dexscreener_api_key
-
-# Optional: Helius for token metadata
-HELIUS_API_KEY=your_helius_api_key
-```
-
-## Trust Score Algorithm
-
-The balanced trust score algorithm considers multiple factors:
+Add the plugin to your agent's character definition:
 
 ```typescript
-score = profitComponent * profitWeight +
-        winRateComponent * winRateWeight +
-        sharpeComponent * sharpeWeight +
-        alphaComponent * alphaWeight +
-        consistencyComponent * consistencyWeight +
-        qualityComponent * qualityWeight
-```
-
-### Components:
-- **Profit**: Average profit percentage across all calls
-- **Win Rate**: Percentage of profitable calls
-- **Sharpe Ratio**: Risk-adjusted returns
-- **Alpha**: Excess returns vs market
-- **Consistency**: Stability of returns
-- **Quality**: Penalty for rug pull promotions
+import { socialAlphaPlugin } from "@elizaos/plugin-social-alpha";
 
-### Default Weights:
-- Profit: 25%
-- Win Rate: 25%
-- Sharpe: 15%
-- Alpha: 10%
-- Consistency: 10%
-- Quality: 15%
-
-## API Integration
+export const character = {
+  name: "MyAgent",
+  plugins: [socialAlphaPlugin],
+  // ...
+};
+```
 
-### Using in Your Plugin
+## Required configuration
 
-```typescript
-import { MarketplaceOfTrustService } from '@elizaos/plugin-marketplace-of-trust';
+Set these in your agent's environment or character config:
 
-// In your plugin definition
-export const myPlugin: Plugin = {
-  name: 'my-plugin',
-  services: [MarketplaceOfTrustService],
-  // ... other plugin config
-};
+```env
+BIRDEYE_API_KEY=        # Token price, security, and trade data (Solana)
+DEXSCREENER_API_KEY=    # DEX pair data and ticker resolution
+HELIUS_API_KEY=         # Solana holder list data (optional — service degrades gracefully without it)
 ```
 
-### Accessing Trust Scores
+The following are declared as required in `agentConfig` but are not actively used in current code paths:
 
-```typescript
-// Get user trust score
-const trustProfile = await runtime.getComponent(
-  userId,
-  'trust_profile',
-  worldId
-);
-
-console.log(`Trust Score: ${trustProfile.data.trustScore}`);
-console.log(`Total Calls: ${trustProfile.data.totalCalls}`);
-console.log(`Win Rate: ${trustProfile.data.winRate}%`);
+```env
+JUPITER_API_KEY=
+COINGECKO_API_KEY=
+MORALIS_API_KEY=
 ```
 
-## Testing
+### Optional tuning
 
-Run the comprehensive test suite:
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `PROCESS_TRADE_DECISION_INTERVAL_HOURS` | `1` | How often queued trade decisions are evaluated |
+| `METRIC_REFRESH_INTERVAL_HOURS` | `24` | How often recommender metrics are refreshed |
+| `USER_TRADE_COOLDOWN_HOURS` | `12` | Minimum hours between decisions per user |
+| `SCAM_PENALTY` | `-100` | Trust score penalty for promoting a rug/scam |
+| `SCAM_CORRECT_CALL_BONUS` | `100` | Bonus for correctly calling out a scam |
+| `MAX_RECOMMENDATIONS_IN_PROFILE` | `50` | Rolling window of recommendations kept per user |
 
-```bash
-# Unit tests
-npm test
+## Trust score algorithm
 
-# E2E tests
-npm run test:e2e
+The balanced trust score uses:
 
-# Test coverage
-npm run test:coverage
-```
-
-## Development
+- **Profit** — average percentage gain across evaluated calls
+- **Win rate** — proportion of calls that were profitable
+- **Sharpe ratio** — risk-adjusted returns
+- **Alpha** — excess returns vs market
+- **Consistency** — stability of returns over time
+- **Quality** — scam/rug penalty applied when a promoted token turns out fraudulent; bonus for correctly calling out scams before they dump
 
-### Building
+Weights are tunable via `src/services/trustScoreOptimizer.ts`.
 
-```bash
-npm run build
-```
+## Building the view
 
-### Development Server
+The leaderboard UI is a plugin view served at `/api/views/social-alpha/bundle.js`. Build it (react + `@elizaos/ui` stay externalised to the host shell):
 
 ```bash
-npm run dev
+bun run --cwd plugins/plugin-social-alpha build
 ```
 
-### Code Quality
+## Running tests
 
 ```bash
-npm run lint
-npm run format
-npm run typecheck
+bun run --cwd plugins/plugin-social-alpha test
 ```
 
-## Performance Considerations
-
-- **Caching**: The system caches simulation results and API responses to minimize redundant calls
-- **Rate Limiting**: Built-in rate limiting for API calls (100ms delay between requests)
-- **Batch Processing**: Processes data in configurable batches to manage memory usage
-- **Resume Support**: Price enrichment can be resumed if interrupted
-
-## Troubleshooting
-
-### Common Issues
-
-1. **No API Keys**: Ensure at least one price data API key is configured
-2. **Rate Limits**: If hitting API rate limits, reduce batch size or add delays
-3. **Memory Issues**: For large datasets, reduce batch size or process in chunks
-4. **TypeScript Errors**: Run `npm run typecheck` to identify type issues
-
-## Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests for new functionality
-5. Ensure all tests pass
-6. Submit a pull request
-
-## License
-
-MIT
+## Supported chains
 
-## Support
+Primary support is Solana. Ethereum and Base are partially supported for ticker resolution via DexScreener.
 
-For issues and questions:
-- GitHub Issues: [elizaos/elizaos](https://github.com/elizaos/elizaos/issues)
-- Discord: [ElizaOS Community](https://discord.gg/elizaos)

package/assets/hero.svg

@@ -0,0 +1,70 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1024 1024" width="1024" height="1024" role="img" aria-label="Social Alpha">
+  <defs>
+    <linearGradient id="bg-social-alpha" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#152818"/>
+      <stop offset="1" stop-color="#0b1910"/>
+    </linearGradient>
+    <radialGradient id="blobA-social-alpha" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#2fda4b" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#2fda4b" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="blobB-social-alpha" cx="0.5" cy="0.5" r="0.5">
+      <stop offset="0" stop-color="#28c38a" stop-opacity="0.5"/>
+      <stop offset="1" stop-color="#28c38a" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="vig-social-alpha" cx="0.5" cy="0.42" r="0.75">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="0.72" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.5"/>
+    </radialGradient>
+    <linearGradient id="label-social-alpha" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="#000000" stop-opacity="0"/>
+      <stop offset="1" stop-color="#000000" stop-opacity="0.55"/>
+    </linearGradient>
+    <filter id="soft-social-alpha" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="46"/>
+    </filter>
+    <filter id="iglow-social-alpha" x="-40%" y="-40%" width="180%" height="180%">
+      <feDropShadow dx="0" dy="0" stdDeviation="14" flood-color="#45ed61" flood-opacity="0.45"/>
+    </filter>
+  </defs>
+
+  <rect width="1024" height="1024" fill="url(#bg-social-alpha)"/>
+
+  <g opacity="0.9">
+    <circle cx="232" cy="220" r="300" fill="url(#blobA-social-alpha)" filter="url(#soft-social-alpha)"/>
+    <circle cx="840" cy="800" r="340" fill="url(#blobB-social-alpha)" filter="url(#soft-social-alpha)"/>
+  </g>
+
+  <g stroke="#d7eada" stroke-width="1.4" opacity="0.06">
+    <line x1="0" y1="256" x2="1024" y2="256"/>
+    <line x1="0" y1="512" x2="1024" y2="512"/>
+    <line x1="0" y1="768" x2="1024" y2="768"/>
+    <line x1="256" y1="0" x2="256" y2="1024"/>
+    <line x1="512" y1="0" x2="512" y2="1024"/>
+    <line x1="768" y1="0" x2="768" y2="1024"/>
+  </g>
+
+  <g opacity="0.5">
+    <path d="M120 470 A 400 400 0 0 1 904 470" fill="none" stroke="#45ed61" stroke-width="3" opacity="0.35"/>
+  </g>
+
+  <g transform="translate(512 432)" filter="url(#iglow-social-alpha)"
+     color="#d7eada" stroke="#d7eada" stroke-width="20"
+     stroke-linecap="round" stroke-linejoin="round" fill="none">
+    <polyline points="-150,80 -54,-22 6,38 150,-110" fill="none"/>
+    <polyline points="92,-110 150,-110 150,-52" fill="none"/>
+    <circle cx="-110" cy="128" r="26"/>
+    <circle cx="0" cy="128" r="26"/>
+    <circle cx="110" cy="128" r="26"/>
+  </g>
+
+  <rect x="0" y="784" width="1024" height="240" fill="url(#label-social-alpha)"/>
+  <text x="512" y="892" text-anchor="middle"
+        font-family="system-ui, -apple-system, Segoe UI, Roboto, sans-serif"
+        font-size="76" font-weight="600" letter-spacing="0.5"
+        fill="#d7eada">Social Alpha</text>
+  <rect x="460" y="924" width="104" height="6" rx="3" fill="#45ed61"/>
+
+  <rect width="1024" height="1024" fill="url(#vig-social-alpha)"/>
+</svg>

package/package.json

@@ -1,33 +1,44 @@
 {
   "name": "@elizaos/plugin-social-alpha",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.11-beta.7",
   "description": "Social Alpha Plugin — Tracks token recommendations (shills/FUD), builds trust scores based on P&L outcomes, and exposes a Social Alpha Provider with win rate, rank, and recommender analytics.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
   },
   "files": [
+    "assets",
     "dist"
   ],
   "scripts": {
-    "build": "bunx vite build",
-    "dev": "vite",
+    "build": "bun run build:js && bun run build:views && bun run build:types",
     "test": "vitest run --passWithNoTests",
-    "clean": "rm -rf dist .turbo",
-    "lint": "echo \"Lint skipped for release\"",
+    "clean": "rm -rf dist .turbo node_modules",
+    "lint": "bunx @biomejs/biome check src",
     "lint:check": "bun run lint",
-    "format": "echo \"Format skipped (source is gitignored vendor code)\"",
-    "format:check": "echo \"Format check skipped (source is gitignored vendor code)\"",
-    "typecheck": "echo \"Typecheck skipped for release\""
+    "format": "bunx @biomejs/biome format --write src",
+    "format:check": "bunx @biomejs/biome format src",
+    "typecheck": "tsc --noEmit -p tsconfig.build.json",
+    "build:js": "tsup --config ../tsup.plugin-packages.shared.ts",
+    "build:views": "bunx --bun vite build --config vite.config.views.ts",
+    "build:types": "tsc --noCheck -p tsconfig.build.json",
+    "lint:fix": "bunx @biomejs/biome check --write src"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
+    "@elizaos/core": "2.0.11-beta.7",
+    "@elizaos/ui": "2.0.11-beta.7",
     "bignumber.js": "^11.0.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -39,32 +50,26 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.0-beta.1"
+    "@elizaos/core": "2.0.11-beta.7"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.14",
     "@cypress/react": "^9.0.2",
     "@radix-ui/react-slot": "^1.0.0",
     "@radix-ui/react-tabs": "^1.0.0",
-    "@tailwindcss/postcss": "4.2.4",
-    "@tanstack/react-query": "^5.62.0",
     "@testing-library/cypress": "^10.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@vitejs/plugin-react-swc": "^4.0.0",
-    "autoprefixer": "^10.4.21",
     "cypress": "^15.14.2",
     "lucide-react": "^1.0.0",
-    "postcss": "^8.5.4",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "tailwind-merge": "^3.4.0",
-    "tailwindcss": "^4.0.0",
     "tsconfig-paths": "^4.2.0",
     "tsup": "^8.5.1",
     "tsx": "4.21.0",
     "typescript": "^6.0.3",
-    "vite": "^6.0.0",
+    "vite": "^8.0.16",
     "vitest": "^4.0.0"
   },
   "publishConfig": {
@@ -116,5 +121,6 @@
         "sensitive": true
       }
     }
-  }
+  },
+  "gitHead": "cdbc876f793d96073d7eb0d09715a031ce0cd32e"
 }