@wzrd_sol/solana-agent-plugin 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -12,7 +12,7 @@
  *
  * Works with:
  *   - Solana Agent Kit (SendAI) — register as plugin
- *   - ElizaOS — wrap actions as ElizaOS Actions
+ *   - ElizaOS — wrap actions as ELIZA-style actions
  *   - Standalone — use WzrdClient directly
  *
  * Quick start:
@@ -23,275 +23,20 @@
 export { WzrdClient } from './client.js';
 export type { WzrdMarket, WzrdLeaderboard, WzrdPosition, WzrdPortfolio, WzrdClaim, WzrdRelayResult, } from './client.js';
 export { LEADERBOARD_ACTION, PORTFOLIO_ACTION, DEPOSIT_ACTION, CLAIM_ACTION, VELOCITY_ACTION, } from './actions/index.js';
-export declare const WZRD_ACTIONS: readonly [{
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        user: string;
-        content: {
-            text: string;
-        };
-    }[][];
-    validate: () => Promise<boolean>;
-    handler: (client: import("./client.js").WzrdClient, params: {
-        limit?: number;
-        platform?: string;
-    }) => Promise<{
-        success: boolean;
-        text: string;
-        data: import("./client.js").WzrdLeaderboard;
-    }>;
-}, {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        user: string;
-        content: {
-            text: string;
-        };
-    }[][];
-    validate: () => Promise<boolean>;
-    handler: (client: import("./client.js").WzrdClient) => Promise<{
-        success: boolean;
-        text: string;
-        data: import("./client.js").WzrdPortfolio;
-    }>;
-}, {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        user: string;
-        content: {
-            text: string;
-        };
-    }[][];
-    validate: (_client: import("./client.js").WzrdClient, params: import("./actions/deposit.js").DepositParams) => Promise<boolean>;
-    handler: (_client: import("./client.js").WzrdClient, params: import("./actions/deposit.js").DepositParams, connection: import("@solana/web3.js").Connection, wallet: import("@solana/web3.js").Keypair) => Promise<{
-        success: boolean;
-        text: string;
-        data?: undefined;
-    } | {
-        success: boolean;
-        text: string;
-        data: {
-            logs: string[] | undefined;
-            signature?: undefined;
-            market_id?: undefined;
-            amount_usdc?: undefined;
-            cu_used?: undefined;
-            elapsed_ms?: undefined;
-            explorer?: undefined;
-        };
-    } | {
-        success: boolean;
-        text: string;
-        data: {
-            signature: string;
-            market_id: number;
-            amount_usdc: number;
-            cu_used: number | undefined;
-            elapsed_ms: number;
-            explorer: string;
-            logs?: undefined;
-        };
-    }>;
-}, {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        user: string;
-        content: {
-            text: string;
-        };
-    }[][];
-    validate: () => Promise<boolean>;
-    handler: (client: import("./client.js").WzrdClient, params: {
-        execute?: boolean;
-    }) => Promise<{
-        success: boolean;
-        text: string;
-        data: import("./client.js").WzrdClaim;
-    } | {
-        success: boolean;
-        text: string;
-        data: {
-            claimable_before: number;
-            explorer: string;
-            root_seq: number;
-            cumulative_total: number;
-            tx_sig: string;
-        };
-    }>;
-}, {
-    name: string;
-    similes: string[];
-    description: string;
-    examples: {
-        user: string;
-        content: {
-            text: string;
-        };
-    }[][];
-    validate: () => Promise<boolean>;
-    handler: (client: import("./client.js").WzrdClient, params: {
-        platform?: string;
-        min_signal?: "BREAKOUT" | "MOMENTUM" | "EMERGING" | "STABLE" | "COOLING" | "WEAK";
-    }) => Promise<{
-        success: boolean;
-        text: string;
-        data: {
-            signals: never[];
-            median_velocity?: undefined;
-        };
-    } | {
-        success: boolean;
-        text: string;
-        data: {
-            signals: import("./actions/velocity.js").MarketSignal[];
-            median_velocity: number;
-        };
-    }>;
-}];
-/** Plugin metadata for framework registration. */
-export declare const WZRD_PLUGIN: {
-    name: string;
-    description: string;
-    actions: readonly [{
-        name: string;
-        similes: string[];
-        description: string;
-        examples: {
-            user: string;
-            content: {
-                text: string;
-            };
-        }[][];
-        validate: () => Promise<boolean>;
-        handler: (client: import("./client.js").WzrdClient, params: {
-            limit?: number;
-            platform?: string;
-        }) => Promise<{
-            success: boolean;
-            text: string;
-            data: import("./client.js").WzrdLeaderboard;
-        }>;
-    }, {
-        name: string;
-        similes: string[];
-        description: string;
-        examples: {
-            user: string;
-            content: {
-                text: string;
-            };
-        }[][];
-        validate: () => Promise<boolean>;
-        handler: (client: import("./client.js").WzrdClient) => Promise<{
-            success: boolean;
-            text: string;
-            data: import("./client.js").WzrdPortfolio;
-        }>;
-    }, {
-        name: string;
-        similes: string[];
-        description: string;
-        examples: {
-            user: string;
-            content: {
-                text: string;
-            };
-        }[][];
-        validate: (_client: import("./client.js").WzrdClient, params: import("./actions/deposit.js").DepositParams) => Promise<boolean>;
-        handler: (_client: import("./client.js").WzrdClient, params: import("./actions/deposit.js").DepositParams, connection: import("@solana/web3.js").Connection, wallet: import("@solana/web3.js").Keypair) => Promise<{
-            success: boolean;
-            text: string;
-            data?: undefined;
-        } | {
-            success: boolean;
-            text: string;
-            data: {
-                logs: string[] | undefined;
-                signature?: undefined;
-                market_id?: undefined;
-                amount_usdc?: undefined;
-                cu_used?: undefined;
-                elapsed_ms?: undefined;
-                explorer?: undefined;
-            };
-        } | {
-            success: boolean;
-            text: string;
-            data: {
-                signature: string;
-                market_id: number;
-                amount_usdc: number;
-                cu_used: number | undefined;
-                elapsed_ms: number;
-                explorer: string;
-                logs?: undefined;
-            };
-        }>;
-    }, {
-        name: string;
-        similes: string[];
-        description: string;
-        examples: {
-            user: string;
-            content: {
-                text: string;
-            };
-        }[][];
-        validate: () => Promise<boolean>;
-        handler: (client: import("./client.js").WzrdClient, params: {
-            execute?: boolean;
-        }) => Promise<{
-            success: boolean;
-            text: string;
-            data: import("./client.js").WzrdClaim;
-        } | {
-            success: boolean;
-            text: string;
-            data: {
-                claimable_before: number;
-                explorer: string;
-                root_seq: number;
-                cumulative_total: number;
-                tx_sig: string;
-            };
-        }>;
-    }, {
-        name: string;
-        similes: string[];
-        description: string;
-        examples: {
-            user: string;
-            content: {
-                text: string;
-            };
-        }[][];
-        validate: () => Promise<boolean>;
-        handler: (client: import("./client.js").WzrdClient, params: {
-            platform?: string;
-            min_signal?: "BREAKOUT" | "MOMENTUM" | "EMERGING" | "STABLE" | "COOLING" | "WEAK";
-        }) => Promise<{
-            success: boolean;
-            text: string;
-            data: {
-                signals: never[];
-                median_velocity?: undefined;
-            };
-        } | {
-            success: boolean;
-            text: string;
-            data: {
-                signals: import("./actions/velocity.js").MarketSignal[];
-                median_velocity: number;
-            };
-        }>;
-    }];
-    version: string;
-};
+export type { MarketSignal } from './actions/index.js';
+import type { Plugin } from 'solana-agent-kit';
+import { getClaimsData, getClientForAgent, getLeaderboardData } from './runtime.js';
+import { type MarketSignal } from './actions/velocity.js';
+export declare const WZRD_ACTIONS: Plugin["actions"];
+export interface WzrdPluginMethods {
+    wzrdLeaderboard(limit?: number, platform?: string): Promise<ReturnType<typeof getLeaderboardData>>;
+    wzrdPortfolio(): Promise<ReturnType<typeof getClientForAgent>['getPortfolio']>;
+    wzrdClaims(): Promise<ReturnType<typeof getClaimsData>>;
+    wzrdDeposit(marketId: number, amountUsdc: number, priorityFee?: number): Promise<Record<string, unknown>>;
+    wzrdClaim(execute?: boolean): Promise<Record<string, unknown>>;
+    wzrdVelocity(platform?: string, minSignal?: MarketSignal['signal']): Promise<Record<string, unknown>>;
+    wzrdClient(): ReturnType<typeof getClientForAgent>;
+}
+export declare function createWzrdPlugin(): Plugin;
+/** Default plugin instance for direct registration via `agent.use(...)`. */
+export declare const WZRD_PLUGIN: Plugin;

package/dist/index.js

@@ -12,7 +12,7 @@
  *
  * Works with:
  *   - Solana Agent Kit (SendAI) — register as plugin
- *   - ElizaOS — wrap actions as ElizaOS Actions
+ *   - ElizaOS — wrap actions as ELIZA-style actions
  *   - Standalone — use WzrdClient directly
  *
  * Quick start:
@@ -22,12 +22,12 @@
  */
 export { WzrdClient } from './client.js';
 export { LEADERBOARD_ACTION, PORTFOLIO_ACTION, DEPOSIT_ACTION, CLAIM_ACTION, VELOCITY_ACTION, } from './actions/index.js';
-// ── Convenience: all actions as array ────────────────────
+import { getClaimsData, getClientForAgent, getLeaderboardData } from './runtime.js';
 import { LEADERBOARD_ACTION } from './actions/leaderboard.js';
 import { PORTFOLIO_ACTION } from './actions/portfolio.js';
-import { DEPOSIT_ACTION } from './actions/deposit.js';
-import { CLAIM_ACTION } from './actions/claim.js';
-import { VELOCITY_ACTION } from './actions/velocity.js';
+import { DEPOSIT_ACTION, depositHandler } from './actions/deposit.js';
+import { CLAIM_ACTION, claimHandler } from './actions/claim.js';
+import { VELOCITY_ACTION, velocityHandler } from './actions/velocity.js';
 export const WZRD_ACTIONS = [
     LEADERBOARD_ACTION,
     PORTFOLIO_ACTION,
@@ -35,10 +35,51 @@ export const WZRD_ACTIONS = [
     CLAIM_ACTION,
     VELOCITY_ACTION,
 ];
-/** Plugin metadata for framework registration. */
-export const WZRD_PLUGIN = {
-    name: 'wzrd',
-    description: 'WZRD Liquid Attention Protocol — deposit USDC into AI attention markets, earn CCM yield',
-    actions: WZRD_ACTIONS,
-    version: '0.1.0',
-};
+export function createWzrdPlugin() {
+    let agentRef = null;
+    const requireAgent = () => {
+        if (!agentRef) {
+            throw new Error('WZRD plugin has not been initialized with a SolanaAgentKit instance');
+        }
+        return agentRef;
+    };
+    return {
+        name: 'wzrd',
+        initialize(agent) {
+            agentRef = agent;
+        },
+        methods: {
+            wzrdClient() {
+                return getClientForAgent(requireAgent());
+            },
+            async wzrdLeaderboard(limit = 20, platform) {
+                return getLeaderboardData(requireAgent(), { limit, platform });
+            },
+            async wzrdPortfolio() {
+                return getClientForAgent(requireAgent()).getPortfolio();
+            },
+            async wzrdClaims() {
+                return getClaimsData(requireAgent());
+            },
+            async wzrdDeposit(marketId, amountUsdc, priorityFee) {
+                return depositHandler(requireAgent(), {
+                    market_id: marketId,
+                    amount_usdc: amountUsdc,
+                    priority_fee: priorityFee,
+                });
+            },
+            async wzrdClaim(execute = true) {
+                return claimHandler(requireAgent(), { execute });
+            },
+            async wzrdVelocity(platform, minSignal) {
+                return velocityHandler(requireAgent(), {
+                    platform,
+                    min_signal: minSignal,
+                });
+            },
+        },
+        actions: WZRD_ACTIONS,
+    };
+}
+/** Default plugin instance for direct registration via `agent.use(...)`. */
+export const WZRD_PLUGIN = createWzrdPlugin();

package/dist/runtime.d.ts

@@ -0,0 +1,16 @@
+import { PublicKey } from '@solana/web3.js';
+import type { SolanaAgentKit } from 'solana-agent-kit';
+import { WzrdClient, type WzrdClaim, type WzrdLeaderboard, type WzrdPortfolio } from './client.js';
+export type SignalTier = 'BREAKOUT' | 'MOMENTUM' | 'EMERGING' | 'STABLE' | 'COOLING' | 'WEAK';
+export declare function resolveApiUrl(explicit?: string): string;
+export declare function getClientForAgent(agent: SolanaAgentKit, apiUrl?: string): WzrdClient;
+export declare function getWalletPublicKey(agent: SolanaAgentKit): PublicKey;
+export declare function formatVelocity(v: number): string;
+export declare function formatUsdc(nativeAmount: number | bigint): string;
+export declare function formatCcm(nativeAmount: number | bigint): string;
+export declare function getLeaderboardData(agent: SolanaAgentKit, input: {
+    limit?: number;
+    platform?: string;
+}): Promise<WzrdLeaderboard>;
+export declare function getPortfolioData(agent: SolanaAgentKit): Promise<WzrdPortfolio>;
+export declare function getClaimsData(agent: SolanaAgentKit): Promise<WzrdClaim>;

package/dist/runtime.js

@@ -0,0 +1,33 @@
+import { DEFAULT_API_URL, WzrdClient, } from './client.js';
+export function resolveApiUrl(explicit) {
+    const envUrl = process.env.WZRD_API_URL?.trim();
+    return explicit?.trim() || envUrl || DEFAULT_API_URL;
+}
+export function getClientForAgent(agent, apiUrl) {
+    return new WzrdClient(agent.wallet, resolveApiUrl(apiUrl));
+}
+export function getWalletPublicKey(agent) {
+    return agent.wallet.publicKey;
+}
+export function formatVelocity(v) {
+    if (v >= 1_000_000)
+        return `${(v / 1_000_000).toFixed(1)}M`;
+    if (v >= 1_000)
+        return `${(v / 1_000).toFixed(0)}K`;
+    return v.toFixed(0);
+}
+export function formatUsdc(nativeAmount) {
+    return (Number(nativeAmount) / 1_000_000).toFixed(4);
+}
+export function formatCcm(nativeAmount) {
+    return (Number(nativeAmount) / 1_000_000).toFixed(4);
+}
+export async function getLeaderboardData(agent, input) {
+    return getClientForAgent(agent).getLeaderboard(input.limit ?? 10, input.platform);
+}
+export async function getPortfolioData(agent) {
+    return getClientForAgent(agent).getPortfolio();
+}
+export async function getClaimsData(agent) {
+    return getClientForAgent(agent).getClaims();
+}

package/examples/hello-wzrd.mjs

@@ -7,20 +7,22 @@
  *   2. Authenticate with Ed25519 (no browser, 1 second)
  *   3. Check portfolio (what do I hold?)
  *   4. Check claimable CCM (any rewards ready?)
+ *   5. Optionally claim via gasless relay (--claim)
  *
  * Usage:
- *   SOLANA_RPC_URL=https://... WZRD_KEYPAIR_PATH=~/.config/solana/id.json node hello-wzrd.mjs
+ *   WZRD_KEYPAIR_PATH=~/.config/solana/id.json node hello-wzrd.mjs
  *
  * Or generate a fresh keypair:
  *   solana-keygen new -o /tmp/agent.json --no-bip39-passphrase
- *   SOLANA_RPC_URL=https://... WZRD_KEYPAIR_PATH=/tmp/agent.json node hello-wzrd.mjs
+ *   WZRD_KEYPAIR_PATH=/tmp/agent.json node hello-wzrd.mjs
  */
 
 import { readFileSync } from 'node:fs';
 import { Keypair } from '@solana/web3.js';
-import { WzrdClient } from '../dist/index.js';
+import { WzrdClient } from '@wzrd_sol/solana-agent-plugin';
 
 const KEYPAIR_PATH = process.env.WZRD_KEYPAIR_PATH;
+const SHOULD_CLAIM = process.argv.includes('--claim');
 if (!KEYPAIR_PATH) {
   console.log('Usage: WZRD_KEYPAIR_PATH=/path/to/keypair.json node hello-wzrd.mjs');
   console.log('Generate one: solana-keygen new -o /tmp/agent.json --no-bip39-passphrase');
@@ -36,9 +38,11 @@ console.log(`Agent: ${wallet.publicKey.toBase58()}\n`);
 
 // 1. Leaderboard (public, no auth)
 console.log('→ Fetching leaderboard...');
-const board = await client.getLeaderboard(5);
-console.log(`  ${board.markets.length} markets, root_seq=${board.root.root_seq}`);
-for (const m of board.markets) {
+const board = await client.getLeaderboard(20);
+const visibleMarketIds = new Set(board.markets.map(m => m.market_id));
+const topMarkets = board.markets.slice(0, 5);
+console.log(`  ${topMarkets.length} markets, root_seq=${board.root.root_seq}`);
+for (const m of topMarkets) {
   const vel = m.velocity_ema >= 1000 ? `${(m.velocity_ema/1000).toFixed(0)}K` : m.velocity_ema.toFixed(0);
   console.log(`  #${m.market_id} ${m.metric} — ${vel} velocity (${m.platform})`);
 }
@@ -50,7 +54,10 @@ try {
   const open = portfolio.positions.filter(p => !p.is_settled);
   console.log(`  ${open.length} open positions, ${(portfolio.total_deposited_usdc / 1e6).toFixed(4)} USDC total`);
   for (const p of open) {
-    console.log(`  • Market #${p.market_id}: ${(p.usdc_deposited / 1e6).toFixed(4)} USDC, ${(p.multiplier_bps / 10000).toFixed(1)}x`);
+    const legacyTag = visibleMarketIds.has(p.market_id) ? '' : ' [legacy/not listed]';
+    console.log(
+      `  • Market #${p.market_id}: ${(p.usdc_deposited / 1e6).toFixed(4)} USDC, ${(p.multiplier_bps / 10000).toFixed(1)}x${legacyTag}`,
+    );
   }
 } catch (e) {
   console.log(`  No portfolio yet (${e instanceof Error ? e.message : e})`);
@@ -65,7 +72,15 @@ try {
   console.log(`  Cumulative: ${claims.cumulative_total}, Claimed: ${claims.claimed_total}`);
   console.log(`  Claimable now: ${claimable > 0 ? claimable : 'none'}`);
   if (claimable > 0) {
-    console.log('  → Run with --claim to harvest via gasless relay');
+    if (SHOULD_CLAIM) {
+      const result = await client.claimRelay();
+      console.log(`  Claim relay result: ${result.status}`);
+      if (result.signature) {
+        console.log(`  Signature: ${result.signature}`);
+      }
+    } else {
+      console.log('  → Run with --claim to harvest via gasless relay');
+    }
   }
 } catch (e) {
   console.log(`  No claims data yet (${e instanceof Error ? e.message : e})`);
@@ -75,5 +90,5 @@ console.log('\n=== Done ===');
 console.log('Next steps:');
 console.log('  1. Fund your wallet with USDC (even 0.01 is enough)');
 console.log('  2. Use wzrd_deposit to enter a market');
-console.log('  3. Wait ~10 min for scoring cycle');
+console.log('  3. Wait ~5 min for scoring cycle');
 console.log('  4. Use wzrd_claim to harvest CCM (gasless — no SOL needed)');

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@wzrd_sol/solana-agent-plugin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "WZRD Liquid Attention Protocol plugin for Solana Agent Kit — deposit, claim, leaderboard, portfolio, velocity signal",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "default": "./dist/index.js"
     }
   },
   "scripts": {
@@ -17,8 +18,9 @@
   },
   "dependencies": {
     "@solana/web3.js": "^1.95.0",
-    "@wzrd_sol/sdk": "^0.1.0",
-    "tweetnacl": "^1.0.3"
+    "@wzrd_sol/sdk": "^0.1.1",
+    "tweetnacl": "^1.0.3",
+    "zod": "^3.25.76"
   },
   "peerDependencies": {
     "solana-agent-kit": "^2.0.0"
@@ -28,6 +30,10 @@
       "optional": true
     }
   },
+  "devDependencies": {
+    "solana-agent-kit": "^2.0.10",
+    "typescript": "^5.6.3"
+  },
   "keywords": [
     "solana",
     "agent",
@@ -39,8 +45,11 @@
     "solana-agent-kit"
   ],
   "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/twzrd-sol/wzrd-final"
+    "url": "git+https://github.com/twzrd-sol/wzrd-final.git"
   }
 }