@wzrd_sol/eliza-plugin 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,61 @@
+# @wzrd_sol/eliza-plugin
+
+ElizaOS plugin for the WZRD Liquid Attention Protocol on Solana. Gives ElizaOS agents the ability to discover AI model velocity, manage attention market positions, deposit USDC, and claim CCM yield.
+
+## Install
+
+```bash
+npm install @wzrd_sol/eliza-plugin
+```
+
+## Configuration
+
+Set these in your ElizaOS runtime settings or environment:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `SOLANA_PRIVATE_KEY` | Yes (for tx) | — | Base58 keypair for signing deposits/claims |
+| `WZRD_API_URL` | No | `https://api.twzrd.xyz` | WZRD backend endpoint |
+| `SOLANA_RPC_URL` | No | Helius mainnet | Solana RPC for on-chain reads |
+
+## Usage
+
+```typescript
+import { wzrdPlugin } from "@wzrd_sol/eliza-plugin";
+
+// Register with your ElizaOS agent
+const agent = new AgentRuntime({
+  plugins: [wzrdPlugin],
+  // ... other config
+});
+```
+
+## Actions
+
+| Action | Auth | Description |
+|--------|------|-------------|
+| `WZRD_LEADERBOARD` | No | Fetch top markets ranked by velocity EMA |
+| `WZRD_VELOCITY` | No | Classify attention signal strength for a market |
+| `WZRD_PORTFOLIO` | Yes | View positions and accrued yield |
+| `WZRD_DEPOSIT` | Yes | Deposit USDC into an attention market, receive vLOFI |
+| `WZRD_CLAIM` | Yes | Claim accrued CCM via gasless relay or self-signed tx |
+
+### Example prompts
+
+- "Show me the top WZRD markets"
+- "What's the velocity signal for market 6?"
+- "Check my WZRD portfolio"
+- "Deposit 1 USDC into market 3"
+- "Claim my CCM rewards"
+
+## Links
+
+- [WZRD Protocol](https://twzrd.xyz)
+- [SDK](https://www.npmjs.com/package/@wzrd_sol/sdk)
+- [OpenAPI](https://twzrd.xyz/openapi.json)
+- [MCP Server](https://app.twzrd.xyz/api/mcp)
+- [Agent Discovery](https://twzrd.xyz/llms.txt)
+
+## License
+
+MIT

package/dist/actions/claim.d.ts

@@ -1,3 +1,9 @@
-/** ELIZA Action: WZRD_CLAIM — claim accrued CCM via gasless relay (auth). */
+/**
+ * ELIZA Action: WZRD_CLAIM — claim accrued CCM via gasless relay (auth).
+ *
+ * Agents can check current APR before deciding whether to claim or hold:
+ *   WzrdClient.getMarketApr(marketId) — projected_total_apr_bps shows current yield rate.
+ *   WzrdClient.getMarketPreview(marketId) — projected_multiplier_bps for live attention signal.
+ */
 import type { Action } from '@elizaos/core';
 export declare const claimAction: Action;

package/dist/actions/claim.js

@@ -10,7 +10,21 @@ export const claimAction = {
     validate: async () => true,
     handler: async (runtime, _msg, _state, _opt, callback) => {
         const client = getWzrdClient(runtime);
-        const claims = await client.getClaims();
+        let claims;
+        try {
+            claims = await client.getClaims();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('404')) {
+                const text = 'No claims found. Deposit into a market first to start accruing CCM.';
+                await callback?.({ text });
+                return { success: true, text };
+            }
+            const text = `Failed to fetch claims: ${msg}`;
+            await callback?.({ text });
+            return { success: false, error: text };
+        }
         const claimable = claims.cumulative_total - claims.claimed_total;
         if (claimable <= 0) {
             const text = `No CCM to claim. Cumulative: ${claims.cumulative_total}, claimed: ${claims.claimed_total}.`;

package/dist/actions/deposit.js

@@ -1,4 +1,13 @@
-/** ELIZA Action: WZRD_DEPOSIT — deposit USDC into attention market, mint vLOFI (auth + keypair). */
+/**
+ * ELIZA Action: WZRD_DEPOSIT — deposit USDC into attention market, mint vLOFI (auth + keypair).
+ *
+ * Before depositing, agents can check expected returns via the APR endpoint:
+ *   GET /v1/markets/:id/apr  — returns base_apr_bps, attention_multiplier_bps,
+ *                              projected_total_apr_bps, tvl_usdc, and the yield formula.
+ *   GET /v1/markets/:id/preview — returns projected_multiplier_bps and freshness_secs
+ *                                  for a live multiplier snapshot before committing capital.
+ * Use WzrdClient.getMarketApr(marketId) or WzrdClient.getMarketPreview(marketId).
+ */
 import { Keypair, ComputeBudgetProgram, TransactionMessage, VersionedTransaction, Connection } from '@solana/web3.js';
 export const depositAction = {
     name: 'WZRD_DEPOSIT',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wzrd_sol/eliza-plugin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "WZRD Liquid Attention Protocol plugin for ElizaOS — leaderboard, portfolio, deposit, claim, velocity",
   "type": "module",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/twzrd-sol/wzrd-final",
+    "url": "git+https://github.com/twzrd-sol/wzrd-final.git",
     "directory": "agents/eliza-plugin"
   },
   "files": [