pump-fun-compose · diff

git:20260429.76fb466 to git:20260429.f07b42a

5 added, 0 removed. Audit C to C.

# pump-fun-compose

Agent-level loops that compose `pump-fun` (read) and `pump-fun-trade` (sign).

| Tool | Loop |

|---|---|

| `researchAndBuy` | search → vet (curve, holders, creator) → quote → buy |

| `autoSnipe` | poll new tokens → vet → buy until session cap |

| `copyTrade` | watch a wallet's recent buys → mirror with size scaling |

| `rugExitWatch` | watch held mints → sell on concentration or dev-sell triggers |

## Filters (manifest.config)

- `minHoldersForBuy` — reject thin books

- `maxTopHolderPct` — reject whale-controlled supplies

- `rejectIfCreatorRugCount` — reject repeat ruggers

- `exitOnConcentrationPct` / `exitOnDevSellPct` — exit triggers

- `sessionSpendCapSol` / `perTradeSol` — hard spend caps

+ ## Safety

+ - Pass `simulate: true` on any tool to dry-run: filters/quotes still execute, but `buyToken` / `sellToken` are skipped and a `SIMULATED:*` sig is returned. Spend caps still tick as if real so the simulated session terminates the same way a live one would.

+ - Pass `sessionId: "<stable-string>"` to persist `seen` / `mirrored` / `spent` / `exited` between calls. A restart with the same `sessionId` resumes — preventing a crash mid-loop from re-spending up to the cap. State is written via `ctx.memory.note` and falls back to an in-process Map if memory is unavailable.

## Wiring

The host runtime injects:

- `ctx.skills.invoke('skill.tool', args)` — sibling-skill calls

- `ctx.wallet` — used by the trade skill (this one never touches keys directly)

- `ctx.memory.note` — every action is auditable

## Composition example

```js

await ctx.skills.invoke('pump-fun-compose.autoSnipe', { durationSec: 600 });

// then babysit positions

await ctx.skills.invoke('pump-fun-compose.rugExitWatch', {

mints: heldMints,

durationSec: 3600,

});

```