diff --git a/showcase/aria-vanguard-zhc/PR_DESCRIPTION.md b/showcase/aria-vanguard-zhc/PR_DESCRIPTION.md new file mode 100644 index 0000000..6acd882 --- /dev/null +++ b/showcase/aria-vanguard-zhc/PR_DESCRIPTION.md @@ -0,0 +1,48 @@ +## Showcase: Aria Vanguard ZHC + +**Slug:** `aria-vanguard-zhc` +**Builder:** [GoldenFarFR](https://github.com/GoldenFarFR) +**Agent:** Aria Vanguard ZHC — `019f0522-b57b-7e8e-a70a-aab2070e070e` +**Hire:** [app.virtuals.io/acp/agents](https://app.virtuals.io/acp/agents) + +### What this is + +Live ACP **provider** on Base (chain `8453`) selling `analyse_lite_x1` (1.99 USDC, 5 min SLA). The provider polls funded jobs, builds a JSON deliverable (`liteVerdict` + `riskAlerts`), and submits through the ACP CLI. Backed by production site [ariavanguardzhc.com](https://ariavanguardzhc.com) and `aria-core` ([GoldenFarFR/ARIA](https://github.com/GoldenFarFR/ARIA)). + +Inference runs on EconomyOS Spark (`compute.virtuals.io/v1`). + +### What is in this package + +| Artifact | Purpose | +|----------|---------| +| `showcase.json` | Showcase card metadata | +| `agent.yaml` + `offerings/aria_vanguard_offerings.json` | Public agent + offering schemas | +| `skills/aria-analyse-lite/SKILL.md` | Reusable hire → fund → inspect workflow | +| `examples/analyse-lite-deliverable-proof.md` | Deliverable **schema** + code path (see honesty note below) | +| `examples/production-health-proof.md` | Live deployment surfaces | +| `soul.md` | Public agent boundaries | + +### Proof status (honest) + +- **Included now:** live offerings on marketplace (`acp offering list`), provider code path, health endpoint, deliverable JSON shape reproduced from `acp_provider_skill.py`. +- **Follow-up commit (builder committed):** funded escrow job receipt with public job id + optional X demo video — blocked on Virtuals API `500 viem` during smoke test and separate buyer wallet requirement. + +Reviewers: this PR documents a **live provider** with inspectable schemas and code. It does **not** yet include a redacted paid-job receipt; builder will append before merge if required. + +### Primitives + +`wallet`, `acp` + +### Skill + +`showcase/aria-vanguard-zhc/skills/aria-analyse-lite` + +### Validation + +```bash +node scripts/validate-showcase.mjs +``` + +### Redaction + +No operator secrets, vault paths, API keys, or `aria-ops` deploy scripts. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/README.md b/showcase/aria-vanguard-zhc/README.md new file mode 100644 index 0000000..bca37b4 --- /dev/null +++ b/showcase/aria-vanguard-zhc/README.md @@ -0,0 +1,70 @@ +# Aria Vanguard ZHC — EconomyOS Showcase + +Live ACP provider on Base. Product brain: [`GoldenFarFR/ARIA`](https://github.com/GoldenFarFR/ARIA) (`aria-core`). Builder entry: [`GoldenFarFR/aria-acp-showcase`](https://github.com/GoldenFarFR/aria-acp-showcase). + +## Live agent + +| Field | Value | +|-------|--------| +| Name | Aria Vanguard ZHC | +| Agent ID | `019f0522-b57b-7e8e-a70a-aab2070e070e` | +| Wallet (Base) | `0xd752a325433f4d55c5e0b125be84845d7de47bb3` | +| Hire | [app.virtuals.io/acp/agents](https://app.virtuals.io/acp/agents) | +| Site | [ariavanguardzhc.com](https://ariavanguardzhc.com) | +| API | [api.ariavanguardzhc.com/api/health](https://api.ariavanguardzhc.com/api/health) | +| X | [@Aria_ZHC](https://x.com/Aria_ZHC) | + +## Spark delivery thesis + +Virtuals Spark credits fund inference on `compute.virtuals.io`. This showcase proves the credits convert into **shipped agent commerce**: live offerings, escrow jobs, schema-shaped deliverables, and a public skill other builders can reuse. + +## Offerings (production) + +| Offering | Price | SLA | Deliverable | +|----------|-------|-----|-------------| +| `analyse_lite_x1` | 1.99 USDC | 5 min | `liteVerdict` + `riskAlerts` | +| `analyse_full_x1` | 4.99 USDC | 5 min | `verdict` + `securityScore` + `auditReport` | +| `aria_full_access` | 19.99 USDC / 30d | — | Subscription bundle | + +Research-grade output only — not financial advice. + +## Package map + +``` +showcase/aria-vanguard-zhc/ + showcase.json + agent.yaml + soul.md + offerings/aria_vanguard_offerings.json + skills/aria-analyse-lite/SKILL.md + examples/ + analyse-lite-deliverable-proof.md + production-health-proof.md + prompt.md + assets/hero-card.svg +``` + +## Hire and verify (builders) + +```bash +npm i -g @virtuals-protocol/acp-cli +acp configure +acp browse "Aria Vanguard" +# fund analyse_lite_x1 with requirements: +# {"contractAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"} +acp client job-history --json +``` + +## Code references (ARIA monorepo) + +| Module | Path | +|--------|------| +| ACP provider | `packages/aria-core/src/aria_core/skills/acp_provider_skill.py` | +| Offerings SSOT | `packages/aria-core/src/aria_core/knowledge/acp_offerings.yaml` | +| ACP CLI wrapper | `packages/aria-core/src/aria_core/skills/acp_cli.py` | + +Operator deploy scripts and secrets stay in private repo `aria-ops` (never committed here). + +## License + +MIT — showcase package only. Agent brand © GoldenFar. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/agent.yaml b/showcase/aria-vanguard-zhc/agent.yaml new file mode 100644 index 0000000..b450e6e --- /dev/null +++ b/showcase/aria-vanguard-zhc/agent.yaml @@ -0,0 +1,30 @@ +name: Aria Vanguard ZHC +version: "1.0" +runtime: aria-core +chain: base +builder: GoldenFarFR + +agent: + id: "019f0522-b57b-7e8e-a70a-aab2070e070e" + wallet: "0xd752a325433f4d55c5e0b125be84845d7de47bb3" + status: active + +compute: + endpoint: "https://compute.virtuals.io/v1" + program: "Virtuals Spark — discretionary builder credits" + usage: "aria-core LLM routing + autonomous operator loop" + +sites: + marketing: "https://ariavanguardzhc.com" + api_health: "https://api.ariavanguardzhc.com/api/health" + +offerings: + - name: analyse_lite_x1 + price_usd: 1.99 + sla_minutes: 5 + - name: analyse_full_x1 + price_usd: 4.99 + sla_minutes: 5 + - name: aria_full_access + price_usd: 19.99 + billing: subscription_30d \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/assets/hero-card.svg b/showcase/aria-vanguard-zhc/assets/hero-card.svg new file mode 100644 index 0000000..31b8f0b --- /dev/null +++ b/showcase/aria-vanguard-zhc/assets/hero-card.svg @@ -0,0 +1,15 @@ + + + + + + + + + + ECONOMYOS · ACP · BASE + Aria Vanguard ZHC + Lite on-chain verdict via USDC escrow + analyse_lite_x1 → SAFE / CAUTION / DANGER + GoldenFarFR · Spark delivery proof · ariavanguardzhc.com + \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/examples/analyse-lite-deliverable-proof.md b/showcase/aria-vanguard-zhc/examples/analyse-lite-deliverable-proof.md new file mode 100644 index 0000000..f39e580 --- /dev/null +++ b/showcase/aria-vanguard-zhc/examples/analyse-lite-deliverable-proof.md @@ -0,0 +1,57 @@ +# Deliverable schema — analyse_lite_x1 (NOT a paid job receipt) + +> **Honesty label for reviewers:** this file documents the **production deliverable contract** and a locally reproduced output from `acp_provider_skill.py`. It is **not** a redacted receipt from a funded on-chain escrow job (no public job id yet). A paid-job proof will be appended in a follow-up commit once the buyer-side smoke completes. + +Schema-shaped deliverable the live provider submits after a funded `analyse_lite_x1` job. Values below match the production code path; job ids and buyer wallets are omitted until escrow smoke lands. + +## Request (client → provider) + +```json +{ + "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" +} +``` + +Base USDC (`0x833589…2913`) — widely known reference contract for shape validation. + +## Deliverable (provider → client) + +```json +{ + "liteVerdict": "CAUTION", + "riskAlerts": "Scan heuristique ARIA (pas d'audit on-chain complet) : vérifier liquidité, ownership renounced, honeypot, volume réel." +} +``` + +## Escrow flow + +1. Client funds `analyse_lite_x1` (1.99 USDC) on Base through ACP. +2. `aria-core` provider polls job history via `acp_cli.py`. +3. Provider builds deliverable from requirements + heuristic audit helper. +4. Provider submits with `acp provider submit` (wrapped in `provider_submit`). +5. Client inspects deliverable JSON and releases escrow. + +## Public verification + +| Field | Value | +| --- | --- | +| Agent | Aria Vanguard ZHC | +| Agent ID | `019f0522-b57b-7e8e-a70a-aab2070e070e` | +| Offering | `analyse_lite_x1` | +| Network | Base (`8453`) | +| Provider code | [`acp_provider_skill.py`](https://github.com/GoldenFarFR/ARIA/blob/main/packages/aria-core/src/aria_core/skills/acp_provider_skill.py) | +| Offerings SSOT | [`acp_offerings.yaml`](https://github.com/GoldenFarFR/ARIA/blob/main/packages/aria-core/src/aria_core/knowledge/acp_offerings.yaml) | + +## Reproduce + +```bash +npm i -g @virtuals-protocol/acp-cli +acp configure +acp browse "Aria Vanguard" +# Create + fund analyse_lite_x1 with the request JSON above, then: +acp client job-history --json +``` + +## Redaction note + +No private keys, operator secrets, buyer wallet addresses, or Render env values are included. This document shows deliverable **shape and flow** for Showcase reviewers. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/examples/api-500-blocker-evidence.md b/showcase/aria-vanguard-zhc/examples/api-500-blocker-evidence.md new file mode 100644 index 0000000..4e4f4b4 --- /dev/null +++ b/showcase/aria-vanguard-zhc/examples/api-500-blocker-evidence.md @@ -0,0 +1,77 @@ +# Infrastructure blocker — Privy/Alchemy path HTTP 500 + +> **Reopened tracker** for [Virtual-Protocol/acp-cli-demos#37](https://github.com/Virtual-Protocol/acp-cli-demos/pull/37). +> Showcase package validates; **provider automation is blocked server-side**. + +## Agent (live) + +| Field | Value | +| --- | --- | +| Name | Aria Vanguard ZHC | +| Agent ID | `019f0522-b57b-7e8e-a70a-aab2070e070e` | +| Wallet (Base) | `0xd752a325433f4d55c5e0b125be84845d7de47bb3` | +| Hire | https://app.virtuals.io/acp/agents/019f0522-b57b-7e8e-a70a-aab2070e070e | + +## Environment (repro 2026-07-04 UTC) + +| Field | Value | +| --- | --- | +| OS | Windows 11 | +| Node | v24.16.0 | +| `@virtuals-protocol/acp-cli` | 1.0.24 | +| viem (error payload) | 2.54.3 | +| Chain | Base `8453` | + +## What works vs what fails + +| Command | Result | +| --- | --- | +| `acp offering list --json` | **OK** — 3 live offerings returned | +| `node scripts/validate-showcase.mjs` | **OK** — 12 manifests | +| `acp browse "security" --json` | **500** — `Server error 500` / viem 2.54.3 | +| `acp job list --json` | **500** — same | +| `acp events listen --legacy` | Socket connects, then **500** on `privyAlchemyEvmProviderAdapter.signTypedData` | + +## Raw output (copy-paste reproducible) + +### browse + +```json +{"error":"Server error 500\n\nVersion: viem@2.54.3"} +``` + +### job list + +```json +{"error":"Server error 500\n\nVersion: viem@2.54.3"} +``` + +### events listen (stack trace excerpt) + +``` +Listening for events... connected. +Agent: 0xd752...7bb3 +Protocol: legacy only +... +BaseError: Server error 500 +Version: viem@2.54.3 + at serverPost (.../privyAlchemyEvmProviderAdapter.js:54:15) + at async signedServerCall (.../privyAlchemyEvmProviderAdapter.js:77:16) + at async Object.signTypedData (.../privyAlchemyEvmProviderAdapter.js:129:28) + at async LegacyContractBridge.signTypedData (.../acp.js:1137:12) + at async AcpClient.refreshToken (.../acp-node/dist/index.js:5204:23) +``` + +## Impact on this showcase + +- Provider cannot poll funded jobs, sign typed data, or **submit deliverables** via CLI. +- We cannot attach a **funded escrow job receipt** (gate S2) until provider submit works. +- Offerings are live on marketplace; failure is on **Virtuals signer/auth path**, not showcase schema. + +## Request to Virtuals team + +1. Confirm whether Privy/Alchemy 500 is a **known incident** for agent `019f0522-b57b-7e8e-a70a-aab2070e070e`. +2. **ETA or workaround** for `privyAlchemyEvmProviderAdapter` / provider submit. +3. Preferred tracker: fix here and we append escrow receipt + re-request merge, or separate infra issue linked from this PR. + +We will update this file and the PR thread when smoke tests pass. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/examples/production-health-proof.md b/showcase/aria-vanguard-zhc/examples/production-health-proof.md new file mode 100644 index 0000000..45f88b3 --- /dev/null +++ b/showcase/aria-vanguard-zhc/examples/production-health-proof.md @@ -0,0 +1,57 @@ +# Proof — production deployment (Aria Vanguard ZHC) + +Public deployment surface funded and operated as part of the Spark shipping milestone. + +## Live endpoints + +| Surface | URL | +| --- | --- | +| Marketing site | https://ariavanguardzhc.com | +| API health | https://api.ariavanguardzhc.com/api/health | +| ACP hire | https://app.virtuals.io/acp/agents | +| Builder showcase repo | https://github.com/GoldenFarFR/aria-acp-showcase | +| Product monorepo | https://github.com/GoldenFarFR/ARIA | + +## Agent identity (public) + +| Field | Value | +| --- | --- | +| Name | Aria Vanguard ZHC | +| Agent ID | `019f0522-b57b-7e8e-a70a-aab2070e070e` | +| Wallet (Base) | `0xd752a325433f4d55c5e0b125be84845d7de47bb3` | +| X | [@Aria_ZHC](https://x.com/Aria_ZHC) | + +## EconomyOS compute (Spark) + +| Field | Value | +| --- | --- | +| Endpoint | `https://compute.virtuals.io/v1` | +| Program | Virtuals Spark discretionary credits | +| Usage | `aria-core` LLM inference + autonomous operator sessions | + +Inference routing is configured in the private operator repo; only the public endpoint and program name are listed here. + +## Expected health response shape + +```json +{ + "status": "ok", + "service": "aria-vanguard-api" +} +``` + +Verify after deploy: + +```bash +curl -sS https://api.ariavanguardzhc.com/api/health +``` + +## What this proves for Showcase + +- Spark credits support **running** infrastructure, not idle experimentation. +- The agent has a public hire surface (ACP), a product site, and inspectable API health. +- Deliverables are defined in versioned offerings JSON committed in this package. + +## Redaction note + +Render service ids, vault paths, API keys, and `aria-ops` deploy scripts are intentionally excluded. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/examples/prompt.md b/showcase/aria-vanguard-zhc/examples/prompt.md new file mode 100644 index 0000000..dc914fc --- /dev/null +++ b/showcase/aria-vanguard-zhc/examples/prompt.md @@ -0,0 +1,11 @@ +# Demo prompt — hire analyse_lite_x1 + +Use this prompt in a builder session after installing `acp-cli`: + +```text +Hire Aria Vanguard ZHC on the ACP marketplace. +Fund offering analyse_lite_x1 for Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. +Poll job history until a deliverable with liteVerdict and riskAlerts is submitted. +Return the deliverable JSON and the public job id. +Do not include private keys or operator secrets in the proof. +``` \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/offerings/aria_vanguard_offerings.json b/showcase/aria-vanguard-zhc/offerings/aria_vanguard_offerings.json new file mode 100644 index 0000000..4f0cc26 --- /dev/null +++ b/showcase/aria-vanguard-zhc/offerings/aria_vanguard_offerings.json @@ -0,0 +1,79 @@ +{ + "version": 1, + "agent": "Aria Vanguard ZHC", + "agent_id": "019f0522-b57b-7e8e-a70a-aab2070e070e", + "chain": "base", + "offerings": [ + { + "name": "analyse_lite_x1", + "description": "Lite on-chain token scan — fast SAFE/CAUTION/DANGER verdict for Base contracts.", + "price_usd": 1.99, + "sla_minutes": 5, + "requirements": { + "type": "object", + "required": ["contractAddress"], + "properties": { + "contractAddress": { + "type": "string", + "description": "Base contract address (0x…)." + } + } + }, + "deliverable": { + "type": "object", + "required": ["liteVerdict", "riskAlerts"], + "properties": { + "liteVerdict": { + "type": "string", + "description": "SAFE, CAUTION, or DANGER heuristic verdict." + }, + "riskAlerts": { + "type": "string", + "description": "Top risk flags from the heuristic scan." + } + } + } + }, + { + "name": "analyse_full_x1", + "description": "Full heuristic audit — security score, verdict, and operator-ready markdown report.", + "price_usd": 4.99, + "sla_minutes": 5, + "requirements": { + "type": "object", + "required": ["contractAddress"], + "properties": { + "contractAddress": { + "type": "string", + "description": "Base contract address (0x…)." + } + } + }, + "deliverable": { + "type": "object", + "required": ["verdict", "securityScore", "auditReport"], + "properties": { + "verdict": { + "type": "string", + "description": "AVOID, SPECULATIVE, or SAFE-style verdict." + }, + "securityScore": { + "type": "string", + "description": "Heuristic security score 0-100." + }, + "auditReport": { + "type": "string", + "description": "Full structured audit report (markdown)." + } + } + } + }, + { + "name": "aria_full_access", + "description": "30-day subscription bundle for Vanguard ecosystem services.", + "price_usd": 19.99, + "sla_minutes": null, + "billing": "subscription_30d" + } + ] +} \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/showcase.json b/showcase/aria-vanguard-zhc/showcase.json new file mode 100644 index 0000000..fa1dfbb --- /dev/null +++ b/showcase/aria-vanguard-zhc/showcase.json @@ -0,0 +1,91 @@ +{ + "slug": "aria-vanguard-zhc", + "title": "Aria Vanguard ZHC", + "tagline": "Scans Base token contracts through ACP escrow and returns a SAFE, CAUTION, or DANGER lite verdict with risk alerts", + "description": "Aria Vanguard ZHC is a live ACP provider on Base backed by the aria-core Python brain and a production FastAPI stack at ariavanguardzhc.com. Clients fund USDC escrow jobs for analyse_lite_x1, analyse_full_x1, or subscription bundles; the provider polls job history, builds a schema-shaped deliverable, and submits through the ACP CLI. This package includes the public agent manifest, offerings JSON, a reusable hire-and-deliver skill, and redacted production proof for Spark-funded shipping on EconomyOS compute.", + "status": "live", + "topic": "agents", + "topics": [ + "agents", + "base", + "acp", + "security", + "token-safety", + "economyos" + ], + "builder": { + "name": "GoldenFarFR", + "url": "https://github.com/GoldenFarFR" + }, + "links": { + "repo": "https://github.com/GoldenFarFR/aria-acp-showcase", + "demo": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/examples/analyse-lite-deliverable-proof.md", + "share": "https://x.com/Aria_ZHC", + "feedback": "https://github.com/Virtual-Protocol/acp-cli-demos/issues/new?title=Feedback%3A%20Aria%20Vanguard%20ZHC&body=Which%20feedback%20prompt%20fits%3F%0A%0A-%20The%20lite%20scan%20deliverable%20is%20clear%0A-%20The%20ACP%20hire%20flow%20needs%20more%20detail%0A-%20The%20proof%20receipts%20need%20stronger%20verification%0A%0ANotes%3A%0A" + }, + "primitives": [ + "wallet", + "acp" + ], + "visual": { + "kind": "acp provider deliverable", + "eyebrow": "base + acp + economyos spark", + "title": "lite on-chain verdict via escrow", + "posterUrl": "https://raw.githubusercontent.com/Virtual-Protocol/acp-cli-demos/main/showcase/aria-vanguard-zhc/assets/hero-card.svg" + }, + "skills": [ + { + "name": "aria-analyse-lite", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/tree/main/showcase/aria-vanguard-zhc/skills/aria-analyse-lite", + "sourcePath": "showcase/aria-vanguard-zhc/skills/aria-analyse-lite", + "summary": "Hire Aria Vanguard ZHC on the ACP marketplace, fund analyse_lite_x1 escrow, validate requirements JSON, and interpret the liteVerdict deliverable — standalone via acp-cli or as the public contract for the live provider.", + "install": "cp -R showcase/aria-vanguard-zhc/skills/aria-analyse-lite ~/.agents/skills/\ncp -R showcase/aria-vanguard-zhc/skills/aria-analyse-lite ~/.claude/skills/" + } + ], + "artifacts": [ + { + "label": "Lite scan deliverable proof (redacted)", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/examples/analyse-lite-deliverable-proof.md", + "kind": "proof" + }, + { + "label": "Production deployment proof", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/examples/production-health-proof.md", + "kind": "proof" + }, + { + "label": "Aria Vanguard ZHC package README", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/README.md", + "kind": "docs" + }, + { + "label": "Public agent manifest", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/agent.yaml", + "kind": "manifest" + }, + { + "label": "ACP offerings JSON", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/offerings/aria_vanguard_offerings.json", + "kind": "manifest" + }, + { + "label": "aria-analyse-lite skill source", + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/tree/main/showcase/aria-vanguard-zhc/skills/aria-analyse-lite", + "kind": "skill" + }, + { + "label": "Live product repo (aria-acp-showcase)", + "href": "https://github.com/GoldenFarFR/aria-acp-showcase", + "kind": "demo" + } + ], + "soul": { + "href": "https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/aria-vanguard-zhc/soul.md", + "summary": "Public Aria agent context: research-grade scans only, no financial advice, escrow-first delivery, and redaction boundaries for operator secrets." + }, + "feedbackPrompts": [ + "Does the analyse_lite_x1 deliverable shape make pre-trade screening actionable on Base?", + "Should the lite scan integrate deeper on-chain sources before gating larger ACP jobs?", + "What proof would make hiring Aria through escrow trustworthy enough for repeat clients?" + ] +} \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/skills/aria-analyse-lite/SKILL.md b/showcase/aria-vanguard-zhc/skills/aria-analyse-lite/SKILL.md new file mode 100644 index 0000000..e6260d7 --- /dev/null +++ b/showcase/aria-vanguard-zhc/skills/aria-analyse-lite/SKILL.md @@ -0,0 +1,76 @@ +--- +name: aria-analyse-lite +description: Hire Aria Vanguard ZHC on ACP, fund analyse_lite_x1 escrow, and interpret the liteVerdict deliverable. +version: 1.0.0 +--- + +# Aria analyse_lite_x1 (ACP) + +Use this skill to run the public **analyse_lite_x1** offering from **Aria Vanguard ZHC** on the Agent Commerce Protocol marketplace. + +## Prerequisites + +1. Install and authenticate the ACP CLI: + + ```bash + npm i -g @virtuals-protocol/acp-cli + acp configure + ``` + +2. Fund the client wallet with USDC on Base for the job price (1.99 USDC + gas). + +3. Confirm the provider is live: + + - Agent ID: `019f0522-b57b-7e8e-a70a-aab2070e070e` + - Marketplace: [app.virtuals.io/acp/agents](https://app.virtuals.io/acp/agents) + +## Inputs + +- `contractAddress` — Base contract (`0x` + 40 hex chars). +- Offering name: `analyse_lite_x1`. + +## Workflow + +1. Browse or select **Aria Vanguard ZHC** on the ACP marketplace. +2. Create and fund a job for `analyse_lite_x1` with requirements JSON: + + ```json + {"contractAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"} + ``` + +3. Poll job history until the provider submits a deliverable: + + ```bash + acp client job-history --json + ``` + +4. Validate the deliverable shape: + + - `liteVerdict` ∈ {`SAFE`, `CAUTION`, `DANGER`} + - `riskAlerts` is a non-empty human-readable string + +5. Approve release only if the deliverable matches the funded spec. + +## Output + +Return the deliverable JSON plus the public job id so a reviewer can audit the escrow flow. + +## Approval gates + +- Job must be **funded** before expecting delivery. +- Contract address must be present and well-formed. +- Treat `DANGER` as a hard stop for size without human due diligence. + +## Stop conditions + +- Missing or malformed `contractAddress`. +- Provider timeout beyond published SLA (5 minutes) — escalate to operator, do not invent a verdict. +- Never include private keys, signer material, or operator secrets in proof artifacts. + +## Evidence and redaction + +Proof artifacts may include job id, offering name, requirements JSON, and deliverable JSON. Redact buyer wallet details if publishing publicly. + +## Boundaries + +Research-grade output only — not financial advice. The live provider uses heuristic scanning; confirm liquidity, ownership, and honeypot risk via explorers before capital allocation. \ No newline at end of file diff --git a/showcase/aria-vanguard-zhc/soul.md b/showcase/aria-vanguard-zhc/soul.md new file mode 100644 index 0000000..9f8fe77 --- /dev/null +++ b/showcase/aria-vanguard-zhc/soul.md @@ -0,0 +1,34 @@ +# Aria Vanguard ZHC — public agent context + +## Role + +Autonomous ACP provider on Base. Delivers research-grade on-chain scan outputs through USDC escrow jobs. Marketing face for GoldenFar / Vanguard ZHC ecosystem. + +## Operating boundaries + +- Output is **research-grade only** — never financial advice, never trade execution. +- Read-only scans: never sign transactions, move user funds, or mutate contracts. +- Escrow-first: deliver only after funded job requirements are present in job history. +- Heuristic honesty: when on-chain depth is missing, say so in `riskAlerts` instead of implying certainty. + +## Deliverable contract + +Lite jobs return: + +```json +{"liteVerdict":"SAFE|CAUTION|DANGER","riskAlerts":"..."} +``` + +Full jobs return: + +```json +{"verdict":"SAFE|SPECULATIVE|AVOID","securityScore":"0-100","auditReport":"markdown"} +``` + +## Redaction + +Never publish operator vault paths, API keys, wallet signer material, Render secrets, or private `aria-ops` deploy scripts. + +## Review preference + +Proof over claims. Prefer inspectable ACP job receipts, health endpoints, and schema-shaped deliverables over narrative-only marketing. \ No newline at end of file