Skip to content

Showcase: HoodFlow Agent API + lifecycle-aware routing on Robinhood Chain#62

Open
dereliapps wants to merge 11 commits into
Virtual-Protocol:mainfrom
dereliapps:showcase/hoodflow
Open

Showcase: HoodFlow Agent API + lifecycle-aware routing on Robinhood Chain#62
dereliapps wants to merge 11 commits into
Virtual-Protocol:mainfrom
dereliapps:showcase/hoodflow

Conversation

@dereliapps

@dereliapps dereliapps commented Jul 18, 2026

Copy link
Copy Markdown

Showcase Project

What shipped

HoodFlow exposes a bounded agent surface for reading route-reviewed markets and preparing short-lived buy or sell preflights. It checks live liquidity, slippage, and oracle deviation, then hands the exact intent to HoodFlow for a fresh quote and user-wallet confirmation.

The Virtuals lifecycle adapter classifies bonding-stage launches, exposes their VIRTUAL settlement context, and links them to the official Virtuals market. HoodFlow enables embedded execution only after graduation when live DEX liquidity returns an executable quote.

Project package

  • Added showcase/hoodflow/showcase.json
  • Added the public Agent API manifest, market registry, guide, and interactive workspace
  • Added a reusable, fail-closed route-preflight skill
  • Added a committed 1672×941 poster and a directly playable 1920×1080 MP4
  • Added a successful user-signed mainnet receipt and decoded proof
  • Linked every public artifact from the manifest
  • Included exactly three feedback prompts
  • Left hidden: false so the card can publish after approval

Validation

  • node scripts/validate-showcase.mjs — 31 manifests passed
  • Skill quick_validate.py passed
  • Independent skill forward-test produced a live AAPL route/oracle/quote preflight without wallet access
  • Site, workspace, manifest, 14-market registry, docs anchor, direct MP4, Blockscout receipt, decoded proof, and route proof return successfully
  • git diff --check passed

Scope, safety, and proof limits

  • No keys, tokens, wallet secrets, private RPC values, or private prompts are published
  • Preflights are indicative, expire after 75 seconds, and never submit transactions
  • HoodFlow requotes before the user signs in a self-custody wallet
  • The completed receipt proves the wallet/token trade
  • The preceding offchain preflight is builder-attested and is not cryptographically bound to that transaction
  • No live ACP listing, ACP job, autonomous signing, or EconomyOS Agent Wallet execution is claimed

Reviewer feedback is especially welcome on whether this bounded quote-preflight surface should become a Virtuals ACP resource and which additional market fields would help agent consumers.

@LauJoeYing LauJoeYing left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hey thanks for the showcase pr!!

Can i request for a image/video demo? You can refer to the guide in our showcase README to see how to attach them! : )
link to readme: https://github.com/Virtual-Protocol/acp-cli-demos/blob/main/showcase/README.md

@dereliapps

Copy link
Copy Markdown
Author

Thanks! I’ve added the 30-second HoodFlow product tour to the showcase package, including the original X video, a direct H.264 source for inline playback, and its 16:9 poster image.

Validation is green: Validated 31 showcase project manifest(s).

Would appreciate a re-review when you have a chance.

@dereliapps
dereliapps requested a review from LauJoeYing July 21, 2026 17:44
@dereliapps dereliapps changed the title Showcase: HoodFlow lifecycle-aware Virtuals routing on Robinhood Chain Showcase: HoodFlow Agent API + lifecycle-aware routing on Robinhood Chain Jul 21, 2026
@dereliapps

Copy link
Copy Markdown
Author

Added the public HoodFlow Agent API review surface in commit 7857a18:

The API prepares short-lived, slippage-bounded quote preflights and never signs or submits transactions. The showcase copy explicitly does not claim a live ACP listing.

Validation is green: 31 showcase manifests passed, and all four public review links return HTTP 200. Would appreciate a re-review when you have a chance.

@LauJoeYing LauJoeYing left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @dereliapps

One thing to fix before this can publish: the card has no hero image or video. The visual block in showcase.json only has text fields

"visual": {
  "kind": "Lifecycle-aware token router + self-custody wallet",
  "eyebrow": "commerce · virtuals · robinhood chain",
  "title": "route the market that is live"
}

and the diff doesn't add any image/video asset. Could you add a media reference (screenshot or short demo clip) so the Showcase card doesn't render with a blank/placeholder hero? You already have a good candidate live at https://hoodflow.app/og-crypto.png, or feel free to attach a short clip of the route desk in action if that reads better as a hero.

Once the hero asset is in, this looks ready to me! thks!

@dereliapps

Copy link
Copy Markdown
Author

Added the completed wallet/token execution proof requested in the latest review.

Agent API preflight → fresh HoodFlow quote → user wallet confirmation:

The receipt finalized successfully and both ERC-20 transfers were verified through the Robinhood Chain RPC. The scope remains explicit: the Agent API prepared the preflight, but it did not initiate, sign, or submit the transaction; the user wallet confirmed it, and this is not represented as an ACP job or live ACP provider action.

The current manifest also already contains the requested poster and demo video. node scripts/validate-showcase.mjs passes for all 31 manifests.

@LauJoeYing @celesteanglm, could you please re-review when convenient? Thank you.

@dereliapps

Copy link
Copy Markdown
Author

@LauJoeYing @celesteanglm — the requested media and evidence updates are now in commit 591f380:

  • committed 1672×941 hero poster plus a directly playable 1920×1080 H.264 demo
  • added the reusable, fail-closed hoodflow-route-preflight skill
  • added a successful user-signed mainnet receipt and decoded 1 USDG → INTC proof
  • corrected the scope language: no ACP job, autonomous signing, or EconomyOS Agent Wallet execution is claimed
  • refreshed the PR description and public artifact links

Validation passes for all 31 showcase manifests, the skill validator, and an independent live preflight test. The only remaining check is the maintainer-approved fork workflow. Re-review would be appreciated.

@LauJoeYing LauJoeYing left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey, dug into this a bit more since we wanted to give you the exact fix instead of a vague pointer.

The field you're missing is visual.posterUrl in showcase.json, that's what renders as the card's hero image. It's optional in the schema so validate-showcase.mjs won't flag it, which is why it still passed with 31 manifests, but reviewers do check for it per the Media section in showcase/README.md.

If you just want a static image: add visual.posterUrl pointing to an https image, 16:9 ratio, 1280x720 or bigger. Easiest path is committing it as showcase/hoodflow/assets/poster.jpg and referencing the raw.githubusercontent.com url for it (heads up, that url only resolves after merge, so check it on your branch first).

If you want a video instead: you'd need links.video (the public watch page url), visual.videoUrl (a direct file, mp4 preferred, not a page link, the validator actually rejects YouTube/X/Vimeo/etc page urls here), and visual.videoLabel (required once links.video is set, has to name the platform, like Watch the 1:50 demo on YouTube).

Either one works fine on its own, a poster with no video just renders as a static card image. Rest of the PR looks solid, this was really the only thing missing! thkssss

@dereliapps

dereliapps commented Jul 23, 2026

Copy link
Copy Markdown
Author

@LauJoeYing thanks for the exact pointer — the media setup is now complete, and the brittle X CDN hotlink has been removed.

  • The 5,281,351-byte H.264 demo is committed as showcase/hoodflow/assets/demo.mp4
  • links.video and visual.videoUrl now point to this immutable, commit-pinned playback URL
  • The playback URL returns HTTP 200, Content-Type: video/mp4, supports byte ranges, and was opened successfully in Chrome without a referrer
  • The repository source remains independently inspectable at the commit-pinned raw asset
  • visual.posterUrl points to the commit-pinned 1672×941 poster
  • visual.videoLabel is Watch the 0:30 demo
  • node scripts/validate-showcase.mjs passes all 31 manifests

Relevant commits: b34a371 and 43aeb2a.

Both hero media URLs are immediately verifiable before merge. Could you please re-review when convenient? Thank you.

@dereliapps
dereliapps requested a review from LauJoeYing July 23, 2026 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants