Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 48 additions & 0 deletions showcase/aria-vanguard-zhc/PR_DESCRIPTION.md
Original file line number Diff line number Diff line change
@@ -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.
70 changes: 70 additions & 0 deletions showcase/aria-vanguard-zhc/README.md
Original file line number Diff line number Diff line change
@@ -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 <job-id> --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.
30 changes: 30 additions & 0 deletions showcase/aria-vanguard-zhc/agent.yaml
Original file line number Diff line number Diff line change
@@ -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
15 changes: 15 additions & 0 deletions showcase/aria-vanguard-zhc/assets/hero-card.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -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 <job-id> --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.
77 changes: 77 additions & 0 deletions showcase/aria-vanguard-zhc/examples/api-500-blocker-evidence.md
Original file line number Diff line number Diff line change
@@ -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.
57 changes: 57 additions & 0 deletions showcase/aria-vanguard-zhc/examples/production-health-proof.md
Original file line number Diff line number Diff line change
@@ -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.
11 changes: 11 additions & 0 deletions showcase/aria-vanguard-zhc/examples/prompt.md
Original file line number Diff line number Diff line change
@@ -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.
```
Loading