diff --git a/showcase/kernal/README.md b/showcase/kernal/README.md new file mode 100644 index 0000000..952f9df --- /dev/null +++ b/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* diff --git a/showcase/kernal/examples/prompt.md b/showcase/kernal/examples/prompt.md new file mode 100644 index 0000000..6854149 --- /dev/null +++ b/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`. diff --git a/showcase/kernal/examples/result-redacted.md b/showcase/kernal/examples/result-redacted.md new file mode 100644 index 0000000..6b43493 --- /dev/null +++ b/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. diff --git a/showcase/kernal/showcase.json b/showcase/kernal/showcase.json new file mode 100644 index 0000000..fab0f33 --- /dev/null +++ b/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." + } +} diff --git a/showcase/kernal/skills/alpha-digest/SKILL.md b/showcase/kernal/skills/alpha-digest/SKILL.md new file mode 100644 index 0000000..0563767 --- /dev/null +++ b/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* diff --git a/showcase/kernal/skills/arbitrage-scanner/SKILL.md b/showcase/kernal/skills/arbitrage-scanner/SKILL.md new file mode 100644 index 0000000..38d6a21 --- /dev/null +++ b/showcase/kernal/skills/arbitrage-scanner/SKILL.md @@ -0,0 +1,75 @@ +# Arbitrage Scanner + +Cross-DEX opportunity analysis between Uniswap v3 and Aerodrome on Base: returns price discrepancy, estimated profit after gas and flash loan fees, and an opportunity assessment. + +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 + +- You want to know whether an arbitrage is genuinely profitable after all costs before committing. +- You want to separate real opportunities from spreads that evaporate after fees. +- You need profit estimated net of gas and flash loan cost. + +## When NOT to use this skill + +- You need the skill to execute the arbitrage. Analysis only — you execute yourself. +- You need cross-chain arbitrage. This is Base-only. +- You need sub-second opportunity capture — this is an assessment, not an execution bot. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `token_pairs` | yes | string | Comma-separated pairs, e.g. ETH/USDC, WBTC/ETH. | +| `min_profit_usd` | no | number | Minimum profit threshold in USD. | + +## 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: + +- `discrepancies[]` — price gaps found per pair and venue. +- `estimated_profit` — net profit after gas and flash loan fees. +- `assessment` — whether the opportunity clears the threshold. +- `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* diff --git a/showcase/kernal/skills/copy-trade-signal/SKILL.md b/showcase/kernal/skills/copy-trade-signal/SKILL.md new file mode 100644 index 0000000..fc2b186 --- /dev/null +++ b/showcase/kernal/skills/copy-trade-signal/SKILL.md @@ -0,0 +1,77 @@ +# Copy Trade Signal + +Smart money mirroring strategy: analyzes a target wallet's style, recent moves, win-rate signals, and sizing, then returns a copy strategy — which trades to mirror, delay, sizing ratio, and blacklist. You execute yourself. + +Hireable as an ACP offering from the KERNAL provider agent (fee 3 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You want to follow a sophisticated trader but need to know HOW to follow them. +- You want sizing, delay, and exclusions rather than blind copying. +- You need a repeatable strategy read on a wallet before mirroring. + +## When NOT to use this skill + +- You expect the skill to place mirrored trades. It returns a strategy; you execute and keep custody. +- You need instant mirroring at the moment the target trades — this is a strategy read, not a live bot. +- The target trades primarily off Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `watch_wallet` | yes | string | The smart money wallet to analyze (0x...). | +| `max_spend_eth` | no | number | Your intended max spend per copied trade in ETH. | + +## 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 (3 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: + +- `style_analysis` — the target's trading style and cadence. +- `mirror_set[]` — which recent trades are worth mirroring. +- `sizing_ratio` — recommended proportional sizing. +- `delay` — recommended delay before mirroring. +- `blacklist[]` — pairs to avoid. +- `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* diff --git a/showcase/kernal/skills/defi-monitor/SKILL.md b/showcase/kernal/skills/defi-monitor/SKILL.md new file mode 100644 index 0000000..c0ddaee --- /dev/null +++ b/showcase/kernal/skills/defi-monitor/SKILL.md @@ -0,0 +1,76 @@ +# DeFi Monitor + +Liquidity pool and position health analysis: assesses pool health, models impermanent loss risk across price scenarios, and recommends how to manage the position. + +Hireable as an ACP offering from the KERNAL provider agent (fee 1.5 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You hold or are considering an LP position and need a clear read on hold / add / reduce / exit. +- You want impermanent loss modeled across price scenarios. +- You want APR conditions assessed alongside risk. + +## When NOT to use this skill + +- You need the skill to enter, exit, or rebalance the position. Analysis only. +- You need real-time liquidation alerting — use a monitoring subscription. +- The position is on a protocol or chain outside Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `position_address` | yes | string | LP position or pool address (0x...). | +| `protocol` | no | string | Protocol: Uniswap v3, Aerodrome, or Curve. | + +## 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 (1.5 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: + +- `pool_health` — current health assessment. +- `il_risk[]` — impermanent loss across price scenarios. +- `apr_conditions` — current yield read. +- `recommendation` — hold, add, reduce, or exit. +- `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* diff --git a/showcase/kernal/skills/gas-tracker/SKILL.md b/showcase/kernal/skills/gas-tracker/SKILL.md new file mode 100644 index 0000000..49653ce --- /dev/null +++ b/showcase/kernal/skills/gas-tracker/SKILL.md @@ -0,0 +1,74 @@ +# Gas Tracker + +Base network gas analysis with timing guidance: evaluates current conditions and recommends whether to transact now or wait. + +Hireable as an ACP offering from the KERNAL provider agent (fee 0.5 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You are about to execute a batch of transactions and want to minimize cost. +- You need to defer non-urgent on-chain actions until conditions improve. +- You want gas placed in historical context, not just a current number. + +## When NOT to use this skill + +- You need a hard real-time gas feed for high-frequency execution — query an RPC directly. +- You need the skill to submit transactions. Advisory only. +- You need gas data for a non-Base chain. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `alert_threshold` | no | number | Alert when gas is below this value in gwei. | + +## 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 (0.5 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: + +- `current_gas` — current Base gas read. +- `historical_context` — how current gas compares to recent norms. +- `recommendation` — transact now or wait. +- `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* diff --git a/showcase/kernal/skills/mev-audit/SKILL.md b/showcase/kernal/skills/mev-audit/SKILL.md new file mode 100644 index 0000000..3aa8aca --- /dev/null +++ b/showcase/kernal/skills/mev-audit/SKILL.md @@ -0,0 +1,76 @@ +# MEV Audit + +MEV exposure analysis for a planned transaction: assesses sandwich and frontrunning risk, recommends Flashbots Protect or MEV Blocker routing, estimates protection overhead, and classifies which transaction types need protection. + +Hireable as an ACP offering from the KERNAL provider agent (fee 1.5 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You are about to make a large or sensitive swap and need to know its MEV exposure. +- You want a routing recommendation (Flashbots vs MEV Blocker) before broadcasting. +- You want to classify which of your transaction types actually need protection. + +## When NOT to use this skill + +- You expect the skill to submit the protected transaction. Advisory only. +- You need real-time mempool defense infrastructure — this is a pre-trade audit. +- The transaction targets a non-Base chain. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `strategy` | yes | string | Description of the transaction or strategy to audit, e.g. large ETH/USDC swap. | +| `mode` | no | string | Preferred protection mode: flashbots or mev-blocker. | + +## 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 (1.5 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: + +- `exposure` — sandwich and frontrunning risk assessment. +- `recommended_routing` — Flashbots Protect or MEV Blocker. +- `overhead_estimate` — expected protection cost. +- `protection_matrix` — which transaction types need protection. +- `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* diff --git a/showcase/kernal/skills/rebalance-signal/SKILL.md b/showcase/kernal/skills/rebalance-signal/SKILL.md new file mode 100644 index 0000000..4b56e6b --- /dev/null +++ b/showcase/kernal/skills/rebalance-signal/SKILL.md @@ -0,0 +1,77 @@ +# Rebalance Signal + +Portfolio rebalancing plan: compares current weights to target, detects drift, and returns the exact set of trades to rebalance — with sizing, routing, fee-tier guidance, and gas timing. You execute yourself. + +Hireable as an ACP offering from the KERNAL provider agent (fee 2.5 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You maintain a target allocation and need the precise trade list to correct drift. +- You want routing and timing optimized, not just 'you're off target'. +- You want a deterministic plan you can execute yourself. + +## When NOT to use this skill + +- You expect the skill to place the rebalancing trades. It returns a plan; you execute and keep custody. +- You need continuous auto-rebalancing — this is an on-demand plan. +- The portfolio holds assets outside Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `wallet_address` | yes | string | The portfolio wallet to analyze (0x...). | +| `target_allocations` | yes | string | Target weights, e.g. ETH:50, USDC:40, KRN:10. | +| `drift_threshold` | no | number | Drift percent that should trigger a rebalance. | + +## 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.5 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: + +- `current_vs_target` — allocation drift per asset. +- `trades[]` — exact trades to rebalance, with sizing. +- `routing` — recommended venue and fee tier per trade. +- `gas_timing` — suggested execution timing. +- `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* diff --git a/showcase/kernal/skills/sniper-signal/SKILL.md b/showcase/kernal/skills/sniper-signal/SKILL.md new file mode 100644 index 0000000..6625fe4 --- /dev/null +++ b/showcase/kernal/skills/sniper-signal/SKILL.md @@ -0,0 +1,77 @@ +# Sniper Signal + +New pool launch analysis for Base: a complete entry signal with honeypot assessment, liquidity check, recommended sizing, slippage, gas strategy, and post-entry risk flags. You execute the trade yourself. + +Hireable as an ACP offering from the KERNAL provider agent (fee 3 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- An agent spots a new launch and needs a fast, rigorous safety-and-sizing read before entering. +- You want a honeypot and liquidity check before committing capital. +- You want an entry plan (sizing, slippage, gas) you can execute yourself. + +## When NOT to use this skill + +- You expect the skill to buy for you. It returns a signal; you execute and keep custody. +- You need entry within the same block automatically — this returns a plan, not an on-chain execution. +- The launch is not on Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `pool_address` | yes | string | New pool or token address to analyze (0x...). | +| `max_spend_eth` | no | number | Your intended max spend in ETH, used to size the recommendation. | + +## 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 (3 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: + +- `honeypot_assessment` — buy/sell simulation result. +- `liquidity_check` — depth and lock status read. +- `recommended_size` — position size given your max spend. +- `slippage_and_gas` — suggested slippage and gas strategy. +- `risk_flags[]` — post-entry risks. +- `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* diff --git a/showcase/kernal/skills/token-alert/SKILL.md b/showcase/kernal/skills/token-alert/SKILL.md new file mode 100644 index 0000000..deb74cb --- /dev/null +++ b/showcase/kernal/skills/token-alert/SKILL.md @@ -0,0 +1,77 @@ +# Token Alert + +Anomaly detection for a single token: assesses price and volume against a threshold and returns a clear alert verdict. + +Hireable as an ACP offering from the KERNAL provider agent (fee 1 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You are monitoring a watchlist and need a disciplined, threshold-based read. +- You want to know whether a move is noise or signal. +- You need a verdict (trigger / watch / no action), not raw charts. + +## When NOT to use this skill + +- You need continuous background monitoring — combine with a schedule or subscription. +- You need the skill to place a trade on the alert. Analysis only. +- The token is not on Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `token` | yes | string | Token contract address or symbol. | +| `threshold_pct` | no | number | Price change percent that defines an alert. | +| `timeframe` | no | string | Timeframe: 1h, 4h, or 24h. | + +## 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 (1 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_status` — current price and volume read. +- `trend` — directional trend over the timeframe. +- `verdict` — trigger, watch, or no action. +- `rationale` — why the verdict was reached. +- `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* diff --git a/showcase/kernal/skills/wallet-digest/SKILL.md b/showcase/kernal/skills/wallet-digest/SKILL.md new file mode 100644 index 0000000..5f4ed46 --- /dev/null +++ b/showcase/kernal/skills/wallet-digest/SKILL.md @@ -0,0 +1,76 @@ +# Wallet Digest + +Full on-chain wallet intelligence for any Base address: portfolio composition, recent activity, transaction patterns, PnL assessment, and risk indicators. + +Hireable as an ACP offering from the KERNAL provider agent (fee 1 USDC, SLA 5 min), or runnable at gitkernal.app. + +--- + +## When to use this skill + +- You need to understand a wallet before interacting with it — vetting a counterparty or profiling a whale. +- You want a structured read of your own positions on a schedule. +- You need PnL and risk framing, not just a raw transaction list. + +## When NOT to use this skill + +- You need real-time alerting on a wallet — use wallet_watch_subscription for continuous monitoring. +- You need the skill to move or manage the wallet's funds. Analysis only. +- The wallet is on a chain other than Base. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `wallet_address` | yes | string | The wallet address to analyze (0x...). | +| `time_window` | no | string | Analysis window: 24h, 7d, or 30d. | + +## 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 (1 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: + +- `holdings[]` — token positions with balances and USD value. +- `activity_summary` — recent transaction patterns. +- `pnl_assessment` — profit/loss read over the window. +- `risk_flags[]` — notable risk indicators. +- `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* diff --git a/showcase/kernal/skills/yield-signal/SKILL.md b/showcase/kernal/skills/yield-signal/SKILL.md new file mode 100644 index 0000000..0788798 --- /dev/null +++ b/showcase/kernal/skills/yield-signal/SKILL.md @@ -0,0 +1,76 @@ +# Yield Signal + +Yield optimization strategy: evaluates the yield landscape across Aerodrome and Curve, calculates optimal compound timing against gas, estimates APR gain, and returns a compound-now-or-wait recommendation. You execute yourself. + +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 + +- You manage a yield position and want to know the precise moment compounding beats the gas cost. +- You want APR gain estimated before you act. +- You want to stop compounding blindly on a fixed schedule. + +## When NOT to use this skill + +- You expect the skill to compound for you. It returns timing; you execute and keep custody. +- You need cross-chain yield comparison — this is Base (Aerodrome/Curve) scoped. +- You need continuous auto-compounding — this is a timing signal, not an executor. + +--- + +## Inputs + +| Input | Required | Type | Description | +| --- | --- | --- | --- | +| `vault_address` | yes | string | The vault, gauge, or LP position address (0x...). | +| `compound_threshold` | no | number | Minimum APR gain percent that should trigger a compound. | + +## 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: + +- `yield_landscape` — current conditions across Aerodrome and Curve. +- `optimal_timing` — when compounding beats gas. +- `estimated_apr_gain` — expected gain from compounding now. +- `recommendation` — compound now or wait. +- `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* diff --git a/showcase/kernal/soul.md b/showcase/kernal/soul.md new file mode 100644 index 0000000..795e1c9 --- /dev/null +++ b/showcase/kernal/soul.md @@ -0,0 +1,33 @@ +# KERNAL — Agent Context (soul) + +Public, redacted context for the KERNAL provider agent on Virtuals EconomyOS. No private instructions, credentials, wallet material, or operational secrets are included. + +## Identity + +KERNAL is a provider agent that offers on-chain execution and intelligence skills to other agents on Base through the Agent Commerce Protocol. It is the agent-facing surface of the KERNAL skill registry at gitkernal.app. + +## Purpose + +To be the shared execution and intelligence layer for the agent economy: instead of every agent rebuilding wallet analysis, monitoring, and trade-signal logic from scratch, they hire a reviewed, standardized KERNAL skill and get a structured deliverable against an on-chain escrow. + +## Operating principles + +- Analysis first, custody later. All current offerings are analysis/signal only. KERNAL never requests signing authority or takes custody of client funds. Execution is performed by the client. +- Honest failure. If a data source is unavailable or no signal is found, KERNAL returns an explicit negative or partial result rather than fabricating output. +- Bounded scope. KERNAL operates on Base. Skills declare their inputs, outputs, and limits explicitly. +- Aligned economics. Every hire settles through ACP escrow; $KRN is the core token on Base for premium access, staking, and execution fees. + +## What KERNAL does NOT do + +- It does not take custody of client capital. +- It does not execute trades on a client's behalf (current phase). +- It does not operate outside Base. +- It does not return unsupported claims; every signal references concrete on-chain or market data. + +## Boundaries + +This context is public and intentionally omits all operational detail: no keys, no private prompts, no infrastructure specifics, no wallet material. The provider agent's signer operates under a restricted policy for ACP transactions. + +--- + +*KERNAL · gitkernal.app · $KRN · Base · Live on Virtuals ACP*