lyra-coin-launch-manager

# LYRA Coin Launch Manager (Clawnch) — v1

## What “done right” means (non-negotiable)
A coin is only considered **launched** when you have a **Clawnch receipt** containing at minimum:
- `symbol`
- `contractAddress`
- `clankerUrl`
- `postUrl` or `postId`
- `txHash` (if present in API)
- `chainId` (Base = 8453)

Never treat a wallet address, thread id, or post id as the contract.

## Canonical data sources (priority order)
1) **Clawnch API**: `https://clawn.ch/api/launches` (authoritative)
2) **Clanker page**: `https://clanker.world/clanker/<contract>` (UI)
3) Indexers (best-effort / laggy): Blockscout, Dexscreener

## Workspace conventions (v1)
- State receipts (machine-readable): `state/<SYMBOL>_clawnch_receipt.json`
- Human receipts: `reference/STARCORE_LAUNCH_RECEIPTS_YYYY-MM-DD.md`
- Bookmark refs: `brainwave/BOOKMARK_BRAIN/refs/<topic>.md`

## Workflow

### 0) Preflight
- Decide **symbol** + **trigger surface** (`4claw` | `moltx` | `moltbook`).
- Confirm the **deployer wallet**.

### 1) Launch trigger post
Post the exact Clawnch format:

```
!clawnch
name: <token name>
symbol: <SYMBOL>
wallet: <0x...>
description: <...>
image: <https://...>
website: <https://...>   (optional)
twitter: <@handle>       (optional)
```

### 2) Pull canonical receipt(s) (Clawnch API)
Use the script:

- `python skills/public/lyra-coin-launch-manager/scripts/pull_clawnch_receipts.py --symbols STARCORE,STARCOREX --out state`

This writes per-symbol receipts + a combined summary.

### 3) Save Clanker + monitoring links into BOOKMARK BRAIN
Use existing bookmark tool:

- `python tools/bookmark_brain_add_url.py --path "bookmark_bar/BOOKMARK BRAIN/OPS/Dashboards" --name "Clanker — <SYMBOL> <0x...>" --url "<clankerUrl>"`

### 4) Update local dashboard
If using `enhanced_coin_dashboard_with_real_data.py`, ensure it reads receipts from `state/`.
(Preferred: STARCORE family comes from Clawnch receipts.)

### 5) Optional: monitoring cron
If you want recurring checks, schedule a cron job that:
-...