pump-fun-reactive

name	pump-fun-reactive
version	0.1.0
author	nirholas
description	Drives live avatar movement from the real pump.fun PumpPortal feed.
trust	any

pump-fun-reactive

Connects to the real PumpPortal WebSocket feed and drives <agent-3d> avatar reactions from live pump.fun events — no LLM in the loop.

Tools

enable_live_reactions

Opens a WebSocket to wss://pumpportal.fun/api/data, subscribes to new token launches and migrations, and starts emitting avatar events every 2 seconds based on market activity.

• Returns { ok: true, started: true } on first call.
• Returns { ok: true, already: true } if already running.
• Reconnects automatically on disconnect (exponential backoff, up to 10 attempts).

Requires ctx.protocol — an AgentProtocol instance (or any object with an emit(action) method).

disable_live_reactions

Closes the WebSocket and stops the aggregator. Returns { ok: true, stopped: true }.

Event logic (2-second aggregator window)

Priority order within each window:

1. Any migration (txType: 'migrate') → gesture: celebrate + emote: celebration + speak: "<name> graduated!"
2. Big initial buy (highest-solAmount create event has solAmount > 5 SOL) → emote: curiosity + speak: "<name> just opened with a X.XX SOL buy."
3. Count of txType: 'create' events:
   • 0 → emote: patience
   • 1–2 → emote: curiosity + look-at: user
   • 3–9 → gesture: wave + emote: curiosity
   • 10+ → gesture: wave + emote: celebration + speak: "Pump.fun is on fire — N new launches in 2 seconds."

Usage

// Install the skill and call enable
await registry.install({ uri: './pump-fun-skills/reactive/' });
const skill = registry.findSkillForTool('enable_live_reactions');
await skill.invoke('enable_live_reactions', {}, { protocol });

// Stop later
await skill.invoke('disable_live_reactions', {}, {});