@wzrd_sol/solana-agent-plugin 0.1.2 → 0.2.0

package/src/client.ts

@@ -1,238 +0,0 @@
-/**
- * WZRD API client — handles agent auth (Ed25519 challenge/verify),
- * token caching, and all REST calls.
- *
- * Standalone: no framework dependency. Works with a Keypair or any wallet
- * implementation that supports `publicKey` + `signMessage()`.
- */
-
-import { Keypair, type PublicKey } from '@solana/web3.js';
-
-export const DEFAULT_API_URL = 'https://api.twzrd.xyz';
-const TOKEN_REFRESH_MARGIN_MS = 5 * 60 * 1000;
-
-export interface WzrdSigner {
-  publicKey: PublicKey;
-  signMessage?: (message: Uint8Array) => Promise<Uint8Array>;
-  secretKey?: Uint8Array;
-}
-
-// ── Base58 encoder (zero-dependency) ────────────────────
-
-const B58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
-function toBase58(bytes: Uint8Array): string {
-  const digits = [0];
-  for (const byte of bytes) {
-    let carry = byte;
-    for (let j = 0; j < digits.length; j++) {
-      carry += digits[j] << 8;
-      digits[j] = carry % 58;
-      carry = (carry / 58) | 0;
-    }
-    while (carry > 0) {
-      digits.push(carry % 58);
-      carry = (carry / 58) | 0;
-    }
-  }
-  let out = '';
-  for (const b of bytes) {
-    if (b !== 0) break;
-    out += '1';
-  }
-  for (let i = digits.length - 1; i >= 0; i--) out += B58[digits[i]];
-  return out;
-}
-
-// ── Types ───────────────────────────────────────────────
-
-export interface WzrdMarket {
-  market_id: number;
-  channel_id: string;
-  platform: string;
-  metric: string;
-  velocity_ema: number;
-  multiplier_bps: number;
-  position_count: number;
-  tvl_usdc: number;
-  rank: number;
-  status: string;
-  snapshot_count: number;
-  last_scored_at: string;
-  depositable: boolean;
-}
-
-export interface WzrdLeaderboard {
-  markets: WzrdMarket[];
-  root: { root_seq: number; root_hash: string; published_slot: number };
-  total_positions: number;
-  total_tvl_usdc: number;
-  total_snapshots: number;
-  updated_at: string;
-}
-
-export interface WzrdPosition {
-  market_id: number;
-  metric: string;
-  usdc_deposited: number;
-  vlofi_minted: number;
-  multiplier_bps: number;
-  status: string;
-  is_settled: boolean;
-}
-
-export interface WzrdPortfolio {
-  positions: WzrdPosition[];
-  total_deposited_usdc: number;
-  total_vlofi: number;
-  total_ccm_earned: number;
-}
-
-export interface WzrdClaim {
-  root_seq: number;
-  cumulative_total: number;
-  claimed_total: number;
-  leaf_index: number;
-  proof: string[];
-  accounts: Record<string, string>;
-}
-
-export interface WzrdRelayResult {
-  root_seq: number;
-  cumulative_total: number;
-  claimed_total?: number;
-  tx_sig?: string;
-  status?: 'already_claimed';
-}
-
-// ── Client ──────────────────────────────────────────────
-
-export class WzrdClient {
-  private token: string | null = null;
-  private tokenExpiresAt = 0;
-
-  constructor(
-    private readonly signer: WzrdSigner | Keypair,
-    private readonly apiUrl: string = DEFAULT_API_URL,
-  ) {}
-
-  get pubkey(): string {
-    return this.signer.publicKey.toBase58();
-  }
-
-  private isWalletSigner(
-    signer: WzrdSigner | Keypair,
-  ): signer is WzrdSigner & { signMessage: NonNullable<WzrdSigner['signMessage']> } {
-    return typeof (signer as WzrdSigner).signMessage === 'function';
-  }
-
-  private hasSecretKey(signer: WzrdSigner | Keypair): signer is WzrdSigner & { secretKey: Uint8Array } {
-    return signer instanceof Keypair || signer.secretKey instanceof Uint8Array;
-  }
-
-  private async signAuthMessage(message: Uint8Array): Promise<Uint8Array> {
-    if (this.isWalletSigner(this.signer)) {
-      return this.signer.signMessage(message);
-    }
-
-    if (this.hasSecretKey(this.signer)) {
-      const { default: nacl } = await import('tweetnacl');
-      return nacl.sign.detached(message, this.signer.secretKey);
-    }
-
-    throw new Error(
-      'WzrdClient requires a signer with signMessage() or an Ed25519 secretKey',
-    );
-  }
-
-  // ── Auth ────────────────────────────────────────────
-
-  private async authenticate(): Promise<void> {
-    // 1. Challenge
-    const cr = await fetch(`${this.apiUrl}/v1/agent/challenge`);
-    if (!cr.ok) throw new Error(`Challenge failed: ${cr.status}`);
-    const { nonce } = (await cr.json()) as { nonce: string };
-
-    // 2. Sign with Ed25519
-    const message = `wzrd-agent-auth v1 | wallet:${this.pubkey} | nonce:${nonce}`;
-    const sig = await this.signAuthMessage(new TextEncoder().encode(message));
-
-    // 3. Verify
-    const vr = await fetch(`${this.apiUrl}/v1/agent/verify`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        pubkey: this.pubkey,
-        nonce,
-        signature: toBase58(sig),
-      }),
-    });
-    if (!vr.ok) throw new Error(`Verify failed: ${vr.status} ${await vr.text()}`);
-
-    const { token, expires_at } = (await vr.json()) as {
-      token: string;
-      expires_at: string;
-    };
-    this.token = token;
-    this.tokenExpiresAt = new Date(expires_at).getTime();
-  }
-
-  private async getToken(): Promise<string> {
-    if (
-      !this.token ||
-      Date.now() > this.tokenExpiresAt - TOKEN_REFRESH_MARGIN_MS
-    ) {
-      await this.authenticate();
-    }
-    return this.token!;
-  }
-
-  private async authedFetch(path: string, init?: RequestInit): Promise<Response> {
-    const token = await this.getToken();
-    return fetch(`${this.apiUrl}${path}`, {
-      ...init,
-      headers: { ...init?.headers, Authorization: `Bearer ${token}` },
-    });
-  }
-
-  // ── Public API ──────────────────────────────────────
-
-  /** Fetch leaderboard — no auth required. */
-  async getLeaderboard(limit = 20, platform?: string): Promise<WzrdLeaderboard> {
-    const params = new URLSearchParams({ limit: String(limit) });
-    if (platform) params.set('platform', platform);
-    const res = await fetch(`${this.apiUrl}/v1/leaderboard?${params}`);
-    if (!res.ok) throw new Error(`Leaderboard failed: ${res.status}`);
-    return (await res.json()) as WzrdLeaderboard;
-  }
-
-  /** Fetch authenticated portfolio. */
-  async getPortfolio(): Promise<WzrdPortfolio> {
-    const res = await this.authedFetch('/v1/portfolio');
-    if (!res.ok) throw new Error(`Portfolio failed: ${res.status}`);
-    return (await res.json()) as WzrdPortfolio;
-  }
-
-  /** Fetch claim data (proof + amounts). */
-  async getClaims(): Promise<WzrdClaim> {
-    const res = await this.authedFetch(`/v1/claims/${this.pubkey}`);
-    if (!res.ok) throw new Error(`Claims failed: ${res.status}`);
-    return (await res.json()) as WzrdClaim;
-  }
-
-  /** Execute gasless relay claim — server pays tx fees. */
-  async claimRelay(): Promise<WzrdRelayResult> {
-    const res = await this.authedFetch(`/v1/claims/${this.pubkey}/relay`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-    });
-    if (!res.ok) throw new Error(`Relay claim failed: ${res.status} ${await res.text()}`);
-    return (await res.json()) as WzrdRelayResult;
-  }
-
-  /** Fetch system health — no auth required. */
-  async getHealth(): Promise<Record<string, unknown>> {
-    const res = await fetch(`${this.apiUrl}/health`);
-    if (!res.ok) throw new Error(`Health failed: ${res.status}`);
-    return (await res.json()) as Record<string, unknown>;
-  }
-}

package/src/index.ts

@@ -1,122 +0,0 @@
-/**
- * @wzrd_sol/solana-agent-plugin
- *
- * WZRD Liquid Attention Protocol plugin for autonomous Solana agents.
- *
- * 5 actions:
- *   wzrd_leaderboard — browse attention markets (no auth)
- *   wzrd_velocity    — classify signal strength (no auth)
- *   wzrd_portfolio   — view positions + CCM earned (auth)
- *   wzrd_deposit     — deposit USDC → mint vLOFI (auth + keypair)
- *   wzrd_claim       — claim CCM via gasless relay (auth)
- *
- * Works with:
- *   - Solana Agent Kit (SendAI) — register as plugin
- *   - ElizaOS — wrap actions as ELIZA-style actions
- *   - Standalone — use WzrdClient directly
- *
- * Quick start:
- *   import { WzrdClient } from '@wzrd_sol/solana-agent-plugin';
- *   const client = new WzrdClient(keypair);
- *   const leaderboard = await client.getLeaderboard();
- */
-
-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 type { MarketSignal } from './actions/index.js';
-
-// ── Convenience: all actions as array ────────────────────
-
-import type { Plugin, SolanaAgentKit } from 'solana-agent-kit';
-
-import { getClaimsData, getClientForAgent, getLeaderboardData } from './runtime.js';
-import { LEADERBOARD_ACTION } from './actions/leaderboard.js';
-import { PORTFOLIO_ACTION } from './actions/portfolio.js';
-import { DEPOSIT_ACTION, depositHandler } from './actions/deposit.js';
-import { CLAIM_ACTION, claimHandler } from './actions/claim.js';
-import { VELOCITY_ACTION, velocityHandler, type MarketSignal } from './actions/velocity.js';
-
-export const WZRD_ACTIONS = [
-  LEADERBOARD_ACTION,
-  PORTFOLIO_ACTION,
-  DEPOSIT_ACTION,
-  CLAIM_ACTION,
-  VELOCITY_ACTION,
-] as 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 function createWzrdPlugin(): Plugin {
-  let agentRef: SolanaAgentKit | null = null;
-
-  const requireAgent = (): SolanaAgentKit => {
-    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?: string) {
-        return getLeaderboardData(requireAgent(), { limit, platform });
-      },
-      async wzrdPortfolio() {
-        return getClientForAgent(requireAgent()).getPortfolio();
-      },
-      async wzrdClaims() {
-        return getClaimsData(requireAgent());
-      },
-      async wzrdDeposit(marketId: number, amountUsdc: number, priorityFee?: number) {
-        return depositHandler(requireAgent(), {
-          market_id: marketId,
-          amount_usdc: amountUsdc,
-          priority_fee: priorityFee,
-        });
-      },
-      async wzrdClaim(execute = true) {
-        return claimHandler(requireAgent(), { execute });
-      },
-      async wzrdVelocity(platform?: string, minSignal?: MarketSignal['signal']) {
-        return velocityHandler(requireAgent(), {
-          platform,
-          min_signal: minSignal,
-        });
-      },
-    },
-    actions: WZRD_ACTIONS,
-  };
-}
-
-/** Default plugin instance for direct registration via `agent.use(...)`. */
-export const WZRD_PLUGIN: Plugin = createWzrdPlugin();

package/src/runtime.ts

@@ -1,60 +0,0 @@
-import { PublicKey } from '@solana/web3.js';
-import type { SolanaAgentKit } from 'solana-agent-kit';
-
-import {
-  DEFAULT_API_URL,
-  WzrdClient,
-  type WzrdClaim,
-  type WzrdLeaderboard,
-  type WzrdPortfolio,
-} from './client.js';
-
-export type SignalTier =
-  | 'BREAKOUT'
-  | 'MOMENTUM'
-  | 'EMERGING'
-  | 'STABLE'
-  | 'COOLING'
-  | 'WEAK';
-
-export function resolveApiUrl(explicit?: string): string {
-  const envUrl = process.env.WZRD_API_URL?.trim();
-  return explicit?.trim() || envUrl || DEFAULT_API_URL;
-}
-
-export function getClientForAgent(agent: SolanaAgentKit, apiUrl?: string): WzrdClient {
-  return new WzrdClient(agent.wallet, resolveApiUrl(apiUrl));
-}
-
-export function getWalletPublicKey(agent: SolanaAgentKit): PublicKey {
-  return agent.wallet.publicKey;
-}
-
-export function formatVelocity(v: number): string {
-  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: number | bigint): string {
-  return (Number(nativeAmount) / 1_000_000).toFixed(4);
-}
-
-export function formatCcm(nativeAmount: number | bigint): string {
-  return (Number(nativeAmount) / 1_000_000).toFixed(4);
-}
-
-export async function getLeaderboardData(
-  agent: SolanaAgentKit,
-  input: { limit?: number; platform?: string },
-): Promise<WzrdLeaderboard> {
-  return getClientForAgent(agent).getLeaderboard(input.limit ?? 10, input.platform);
-}
-
-export async function getPortfolioData(agent: SolanaAgentKit): Promise<WzrdPortfolio> {
-  return getClientForAgent(agent).getPortfolio();
-}
-
-export async function getClaimsData(agent: SolanaAgentKit): Promise<WzrdClaim> {
-  return getClientForAgent(agent).getClaims();
-}

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "nodenext",
-    "moduleResolution": "nodenext",
-    "declaration": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src"]
-}

package/type-smoke-Cvxu.ts

@@ -1,8 +0,0 @@
-import type { Action, Plugin } from 'solana-agent-kit';
-import { WZRD_PLUGIN, LEADERBOARD_ACTION } from './dist/index.js';
-
-const plugin: Plugin = WZRD_PLUGIN;
-const action: Action = LEADERBOARD_ACTION;
-
-void plugin;
-void action;