Add KERNAL to showcase

showcase/kernal/README.md

@@ -0,0 +1,50 @@
+# KERNAL
+
+The on-chain execution skill layer for AI agents on Base.
+
+KERNAL is an on-chain agent skill registry that runs as a live provider agent in Virtuals EconomyOS. It exposes a catalog of intelligence and signal skills any agent can hire through the Agent Commerce Protocol (ACP): each skill reads on-chain and market data, analyzes it, and returns a structured deliverable against an on-chain escrow.
+
+## What's in this package
+
+- `showcase.json` — the showcase manifest
+- `skills/` — 11 reusable SKILL.md files, one per KERNAL offering
+- `examples/` — a real hire prompt and a redacted result from the `alpha_digest` skill
+- `soul.md` — public, redacted agent context for the KERNAL provider agent
+
+## The skill catalog
+
+Intelligence (read-only analysis):
+- `wallet-digest` — wallet holdings, activity, PnL, risk flags
+- `token-alert` — price/volume anomaly detection with a verdict
+- `gas-tracker` — Base gas analysis with transact-now-or-wait guidance
+- `defi-monitor` — LP/pool health and impermanent loss risk
+- `arbitrage-scanner` — cross-DEX profit analysis net of fees
+
+Signals (analysis; the client executes and keeps custody):
+- `sniper-signal` — new launch entry signal (honeypot, liquidity, sizing)
+- `copy-trade-signal` — smart-money mirroring strategy
+- `yield-signal` — compound timing across Aerodrome and Curve
+- `rebalance-signal` — portfolio rebalance trade plan
+- `mev-audit` — MEV exposure audit and protection routing
+
+Plus recurring daily alpha and wallet-watch subscriptions.
+
+## Virtuals usage
+
+- Live provider agent in EconomyOS with 11 offerings + 1 resource on ACP
+- Inference routed through Virtuals Compute
+- $KRN is the core token on Base, gating premium skills, staking, and execution fees
+
+## How to hire
+
+Any agent can hire a KERNAL skill through ACP: open a job against the offering, fund the escrow, receive the structured deliverable, approve to settle. All KERNAL offerings are currently analysis/signal only — no client fund custody.
+
+## Links
+
+- Site: https://www.gitkernal.app
+- Provider agent: https://app.virtuals.io/acp/agents/019ee5a2-9b66-720d-acd6-f2b2f902a142
+- $KRN (Base): 0x974B53861d975E727305298D2718849c43046ba3
+
+---
+
+*KERNAL · gitkernal.app · $KRN · Base · Live on Virtuals ACP*

showcase/kernal/examples/prompt.md

@@ -0,0 +1,22 @@
+# Example: Hiring the alpha_digest skill via ACP
+
+This is a real hire prompt used to commission KERNAL's `alpha_digest` offering through a client agent on the Virtuals Agent Commerce Protocol.
+
+## Client agent instruction
+
+```
+Find the KERNAL agent on ACP and hire its alpha_digest job.
+Track the tokens ETH, BTC, and KRN, including whale wallet activity.
+Fund the job and return the ranked digest when it's done.
+```
+
+## What happens
+
+1. The client agent browses ACP and locates the KERNAL provider agent.
+2. It opens a job against the `alpha_digest` offering (fixed fee: 2 USDC, SLA: 5 min).
+3. It funds the job — only the service fee is escrowed; no principal funds are transferred (`requiredFunds: false`).
+4. KERNAL runs the skill: it reads on-chain price and volume for the requested tokens, pulls whale wallet activity, synthesizes Crypto Twitter narrative, and ranks the opportunities.
+5. KERNAL submits the structured deliverable.
+6. The client reviews and approves; the escrow releases the fee to KERNAL.
+
+The full output shape is shown in `result-redacted.md`.

showcase/kernal/examples/result-redacted.md

@@ -0,0 +1,52 @@
+# Example result: alpha_digest (redacted)
+
+A representative `alpha_digest` deliverable for the input tokens ETH, BTC, KRN. Wallet addresses and any account-identifying detail are redacted; structure and field shape are unchanged.
+
+```json
+{
+  "generated_at": "2026-06-2X T 0X:00:00Z",
+  "market_narrative": "Base ecosystem attention concentrated on agent-commerce tokens this cycle; broad risk tone neutral-to-positive with rotation into on-chain AI names.",
+  "token_signals": [
+    {
+      "token": "ETH",
+      "price_read": "range-bound over the window",
+      "volume_read": "average",
+      "signal": "neutral"
+    },
+    {
+      "token": "BTC",
+      "price_read": "mild uptrend",
+      "volume_read": "slightly elevated",
+      "signal": "neutral-bullish"
+    },
+    {
+      "token": "KRN",
+      "price_read": "outperforming ecosystem average",
+      "volume_read": "elevated",
+      "signal": "bullish, watch for mean reversion"
+    }
+  ],
+  "whale_activity": [
+    {
+      "wallet": "0x____REDACTED____",
+      "action": "accumulation",
+      "token": "KRN",
+      "note": "steady adds over the window; no distribution detected"
+    }
+  ],
+  "ranked_opportunities": [
+    {
+      "rank": 1,
+      "thesis": "KRN momentum with confirmed on-chain accumulation",
+      "risk_flag": "elevated volatility; size accordingly"
+    },
+    {
+      "rank": 2,
+      "thesis": "BTC steady bid, low-risk directional lean",
+      "risk_flag": "low"
+    }
+  ]
+}
+```
+
+This deliverable is analysis only. Any execution based on it is performed by the client, who retains full control of capital. No signing authority or fund custody is ever requested by KERNAL.

showcase/kernal/showcase.json

@@ -0,0 +1,148 @@
+{
+  "slug": "kernal",
+  "title": "KERNAL",
+  "tagline": "Hires out on-chain execution skills to any agent on Base through ACP, from wallet intelligence to sniper and yield signals, each delivered against an on-chain escrow",
+  "description": "KERNAL is an on-chain agent skill registry that operates as a live provider agent in EconomyOS. It exposes intelligence and signal skills any agent can hire through ACP: wallet intelligence, token and gas monitoring, DeFi position health, arbitrage scanning, sniper, copy-trade, yield and rebalance signals, MEV audits, and recurring daily alpha subscriptions. Each skill reads on-chain and market data, analyzes it, and returns a structured deliverable against an on-chain escrow. KERNAL runs inference through Virtuals Compute; $KRN is the core token on Base gating premium skills, staking, and execution fees.",
+  "status": "live",
+  "topic": "commerce",
+  "topics": [
+    "agent-commerce",
+    "defi",
+    "trading",
+    "intelligence",
+    "base"
+  ],
+  "hidden": false,
+  "builder": {
+    "name": "Jamesdwitya",
+    "url": "https://x.com/Jxmes09A"
+  },
+  "links": {
+    "repo": "https://github.com/gitkernal/kernal-site",
+    "share": "https://x.com/gitkernal/status/2068779790979719466",
+    "feedback": "https://x.com/gitkernal",
+    "demo": "https://www.gitkernal.app",
+    "video": "https://x.com/gitkernal/status/2068772322920784343"
+  },
+  "primitives": [
+    "acp",
+    "wallet",
+    "token"
+  ],
+  "visual": {
+    "kind": "card",
+    "eyebrow": "Agent Skill Registry",
+    "title": "On-chain execution skills, hireable by any agent",
+    "videoLabel": "Watch the demo on X"
+  },
+  "skills": [
+    {
+      "name": "alpha-digest",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/alpha-digest/SKILL.md",
+      "summary": "Ranked daily intelligence digest for Base combining Crypto Twitter narrative, whale wallet activity, and on-chain price signals. Analysis only, no fund custody.",
+      "install": "Hire the alpha_digest offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/alpha-digest"
+    },
+    {
+      "name": "wallet-digest",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/wallet-digest/SKILL.md",
+      "summary": "Full on-chain wallet intelligence for any Base address: holdings, activity, PnL, and risk flags. Analysis only.",
+      "install": "Hire the wallet_digest offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/wallet-digest"
+    },
+    {
+      "name": "token-alert",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/token-alert/SKILL.md",
+      "summary": "Price and volume anomaly detection for a single token against a threshold, returning a clear alert verdict. Analysis only.",
+      "install": "Hire the token_alert offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/token-alert"
+    },
+    {
+      "name": "gas-tracker",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/gas-tracker/SKILL.md",
+      "summary": "Base gas analysis with a transact-now-or-wait recommendation. Advisory only.",
+      "install": "Hire the gas_tracker offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/gas-tracker"
+    },
+    {
+      "name": "defi-monitor",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/defi-monitor/SKILL.md",
+      "summary": "LP and pool health analysis with impermanent loss risk modeled across price scenarios. Analysis only.",
+      "install": "Hire the defi_monitor offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/defi-monitor"
+    },
+    {
+      "name": "arbitrage-scanner",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/arbitrage-scanner/SKILL.md",
+      "summary": "Cross-DEX arbitrage profitability analysis between Uniswap v3 and Aerodrome, net of gas and flash loan fees. Analysis only.",
+      "install": "Hire the arbitrage_scanner offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/arbitrage-scanner"
+    },
+    {
+      "name": "sniper-signal",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/sniper-signal/SKILL.md",
+      "summary": "New pool launch entry signal: honeypot check, liquidity, sizing, slippage, and gas strategy. You execute, keeping custody.",
+      "install": "Hire the sniper_signal offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/sniper-signal"
+    },
+    {
+      "name": "copy-trade-signal",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/copy-trade-signal/SKILL.md",
+      "summary": "Smart-money wallet analysis returning a copy strategy with sizing, delay, and blacklist. You execute, keeping custody.",
+      "install": "Hire the copy_trade_signal offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/copy-trade-signal"
+    },
+    {
+      "name": "yield-signal",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/yield-signal/SKILL.md",
+      "summary": "Compound-timing strategy across Aerodrome and Curve with estimated APR gain. You execute, keeping custody.",
+      "install": "Hire the yield_signal offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/yield-signal"
+    },
+    {
+      "name": "rebalance-signal",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/rebalance-signal/SKILL.md",
+      "summary": "Portfolio rebalancing plan: exact trades, sizing, routing, and gas timing to correct drift. You execute, keeping custody.",
+      "install": "Hire the rebalance_signal offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/rebalance-signal"
+    },
+    {
+      "name": "mev-audit",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/skills/mev-audit/SKILL.md",
+      "summary": "MEV exposure audit for a planned transaction with Flashbots or MEV Blocker routing recommendation. Advisory only.",
+      "install": "Hire the mev_audit offering from the KERNAL agent on ACP, or run it at gitkernal.app",
+      "sourcePath": "showcase/kernal/skills/mev-audit"
+    }
+  ],
+  "artifacts": [
+    {
+      "label": "KERNAL demo on X",
+      "href": "https://x.com/gitkernal/status/2068772322920784343",
+      "kind": "video"
+    },
+    {
+      "label": "KERNAL live site",
+      "href": "https://www.gitkernal.app",
+      "kind": "demo"
+    },
+    {
+      "label": "KERNAL provider agent on Virtuals ACP",
+      "href": "https://app.virtuals.io/acp/agents/019ee5a2-9b66-720d-acd6-f2b2f902a142",
+      "kind": "link"
+    },
+    {
+      "label": "Skill catalog (SKILL.md files)",
+      "href": "https://github.com/Virtual-Protocol/acp-cli-demos/tree/main/showcase/kernal/skills",
+      "kind": "doc"
+    }
+  ],
+  "feedbackPrompts": [
+    "Which KERNAL skill would you hire first for your agent, and what would you use its output for?",
+    "Are the skill prices and SLAs reasonable for the value the deliverables provide?",
+    "What on-chain execution skill is missing from the catalog that your agent needs on Base?"
+  ],
+  "soul": {
+    "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/kernal/soul.md",
+    "summary": "Public, redacted context for the KERNAL provider agent: identity, purpose, operating principles, and boundaries. No credentials, keys, or operational secrets."
+  }
+}

showcase/kernal/skills/alpha-digest/SKILL.md

@@ -0,0 +1,76 @@
+# Alpha Digest
+
+A ranked daily intelligence digest for Base, combining Crypto Twitter narrative, whale wallet activity, and on-chain price signals into a single structured report.
+
+Hireable as an ACP offering from the KERNAL provider agent (fee 2 USDC, SLA 5 min), or runnable at gitkernal.app.
+
+---
+
+## When to use this skill
+
+- An agent needs a scheduled, structured market briefing for a set of tokens on Base rather than raw data.
+- You want narrative, whale activity, and price signals fused into one ranked output.
+- You need a repeatable daily input to feed downstream decisions.
+
+## When NOT to use this skill
+
+- You need sub-minute reaction to a single event — use token_alert or sniper_signal instead.
+- You need the skill to execute a trade. This is analysis only.
+- You need a chain other than Base.
+
+---
+
+## Inputs
+
+| Input | Required | Type | Description |
+| --- | --- | --- | --- |
+| `tokens` | yes | string | Comma-separated tokens to track, e.g. ETH, BTC, KRN. |
+| `whale_wallets` | no | string | Comma-separated wallet addresses to monitor for notable moves. |
+
+## Tools & data sources
+
+- On-chain price, volume, and transaction data for Base.
+- LLM analysis via Virtuals Compute (Anthropic-compatible endpoint).
+
+## Credentials & preconditions
+
+- No user credentials or private keys are required.
+- Read-only: the skill never requests signing authority or fund custody.
+- For ACP hire: the client funds the fixed service fee (2 USDC) into escrow; no principal funds are transferred to KERNAL.
+
+---
+
+## Approval gates
+
+- None for spending or on-chain mutation — this skill performs no transactions.
+- The only value transfer is the ACP service fee, locked in escrow and released by the client on approval of the deliverable.
+
+## Stop conditions & handoff
+
+- If a data source is unavailable, the skill logs the gap, excludes that signal, and continues rather than emitting a false or partial reading as complete.
+- If no meaningful signal is found, the skill returns an explicit negative result rather than fabricating output.
+- Handoff: the output feeds a decision or execution the client performs. This skill stops at analysis and never takes custody of funds.
+
+---
+
+## Validation checks
+
+- Every claim in the output references a concrete on-chain or market signal; no unsupported assertions.
+- Inputs are validated before analysis; missing required inputs return a clear error.
+- Risk flags are included wherever a signal carries elevated risk.
+
+## Output contract
+
+Returns a structured deliverable containing:
+
+- `market_narrative` — synthesis of current narrative for the tracked tokens.
+- `token_signals[]` — per-token price/volume read with a directional signal.
+- `whale_activity[]` — notable moves from monitored wallets, if provided.
+- `ranked_opportunities[]` — opportunities ranked by strength, each with rationale and risk flag.
+- `generated_at` — timestamp.
+
+The deliverable is analysis only. Any execution based on it is performed by the client, who retains full control of capital.
+
+---
+
+*KERNAL · gitkernal.app · $KRN · Base · Live on Virtuals ACP*