@wzrd_sol/solana-agent-plugin 0.1.1 → 0.1.2

package/README.md

@@ -4,12 +4,37 @@ WZRD Liquid Attention Protocol plugin for autonomous Solana agents. Provides 5 a
 
 Works standalone, with [Solana Agent Kit](https://github.com/sendAI/solana-agent-kit), or as a base for ElizaOS action wrappers.
 
+## 30-Second Test
+
+No Solana Agent Kit dependency is required for the first smoke test. The package is ESM-first, so use `type: "module"` and `import`.
+
+```bash
+mkdir wzrd-agent && cd wzrd-agent
+printf '{\"name\":\"wzrd-agent\",\"type\":\"module\",\"private\":true}\n' > package.json
+npm install @wzrd_sol/solana-agent-plugin @solana/web3.js
+curl -O https://raw.githubusercontent.com/twzrd-sol/wzrd-final/main/agents/solana-agent-kit-plugin/examples/hello-wzrd.mjs
+solana-keygen new -o /tmp/agent.json --no-bip39-passphrase
+WZRD_KEYPAIR_PATH=/tmp/agent.json node hello-wzrd.mjs
+```
+
+What you should see:
+- top markets
+- successful Ed25519 agent auth
+- portfolio or signup-bonus path
+- claimable CCM state
+
 ## Install
 
 ```bash
 npm install @wzrd_sol/solana-agent-plugin
 ```
 
+Install with Solana Agent Kit only when you are ready to execute through its action system:
+
+```bash
+npm install @wzrd_sol/solana-agent-plugin solana-agent-kit
+```
+
 ## Quick Start
 
 ```typescript
@@ -30,6 +55,18 @@ const claims = await client.getClaims();
 const result = await client.claimRelay(); // gasless CCM claim
 ```
 
+## Solana Agent Kit
+
+The package works standalone or as a Solana Agent Kit plugin.
+
+```typescript
+import { SolanaAgentKit } from 'solana-agent-kit';
+import { WZRD_PLUGIN } from '@wzrd_sol/solana-agent-plugin';
+
+const agent = new SolanaAgentKit(/* wallet + rpc + model config */);
+agent.use(WZRD_PLUGIN);
+```
+
 ## Actions
 
 The plugin exports 5 actions that follow the Solana Agent Kit action interface:
@@ -38,7 +75,7 @@ The plugin exports 5 actions that follow the Solana Agent Kit action interface:
 |--------|------|-------------|
 | `LEADERBOARD_ACTION` | No | Fetch ranked attention markets |
 | `VELOCITY_ACTION` | No | Classify signal strength (BREAKOUT / MOMENTUM / EMERGING / STABLE / COOLING / WEAK) |
-| `PORTFOLIO_ACTION` | Yes | View positions and CCM earned |
+| `PORTFOLIO_ACTION` | Yes | View portfolio positions |
 | `DEPOSIT_ACTION` | Yes | Deposit USDC into a market, receive vLOFI |
 | `CLAIM_ACTION` | Yes | Claim CCM via server-paid gasless relay |
 
@@ -65,6 +102,11 @@ Creates a client instance. The keypair is used for Ed25519 agent authentication.
 
 Auth is handled automatically: the client requests a challenge nonce, signs it with the keypair, and caches the bearer token (24h TTL, auto-refreshes).
 
+For an end-to-end smoke test, use [`examples/hello-wzrd.mjs`](./examples/hello-wzrd.mjs). It works with just:
+- `@wzrd_sol/solana-agent-plugin`
+- `@solana/web3.js`
+- `WZRD_KEYPAIR_PATH=/path/to/keypair.json`
+
 ## License
 
 MIT

package/examples/hello-wzrd.mjs

@@ -7,13 +7,14 @@
  *   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';
@@ -21,6 +22,7 @@ import { Keypair } from '@solana/web3.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,6 +1,6 @@
 {
   "name": "@wzrd_sol/solana-agent-plugin",
-  "version": "0.1.1",
+  "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",
@@ -45,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"
   }
 }