Skip to content

Showcase: AgentOracle Verifiable Delivery — signed ACP-outcome receipts, verified offline - #97

Open
TKCollective wants to merge 2 commits into
Virtual-Protocol:mainfrom
TKCollective:showcase/agentoracle-verifiable-delivery
Open

Showcase: AgentOracle Verifiable Delivery — signed ACP-outcome receipts, verified offline#97
TKCollective wants to merge 2 commits into
Virtual-Protocol:mainfrom
TKCollective:showcase/agentoracle-verifiable-delivery

Conversation

@TKCollective

Copy link
Copy Markdown

What shipped

  • Project slug: agentoracle-verifiable-delivery
  • Project title: AgentOracle Verifiable Delivery
  • Builder name and URL: TK Collective — https://github.com/TKCollective
  • EconomyOS primitives used: acp
  • Public proof: live production-issued JWS signed receipt committed at
    showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/examples/receipt.json.
    Produced against the AgentOracle production gateway on 2026-08-03 UTC,
    verifies valid: True offline against the live JWKS at
    https://agentoracle.co/.well-known/jwks.json using the
    agentoracle-receipt-verify
    PyPI reference verifier (Apache-2.0). No fixtures, no mocks, no test-mode keys.
  • Optional soul.md: not included.

Project package

  • Added showcase/agentoracle-verifiable-delivery/showcase.json
  • Added demo artifacts: receipt.json, compose_request.json, verify.py, verify-output.txt
  • Added prompt.md (scenario + reproduction) and result-redacted.md (redacted run report)
  • Added reusable skill under showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/
  • Used top-level skills/<skill-name>/ only when shared across projects (N/A — project-scoped)
  • Set skills[].sourcePath in showcase.json for the committed skill
  • Linked all public artifacts from the manifest (8 artifacts)
  • Included exactly three feedback prompts
  • Set hidden: true — not set (this is a full public entry)
  • Linked soul.md — not linked

Skill standard

Skill path: showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/

  • SKILL.md includes when to use it and when not to use it
  • Inputs, tools, credentials, and preconditions are explicit
  • Approval gates are listed for spending, posting, and deployment
  • Stop conditions and handoff rules are listed
  • Validation checks and output contract are included

Safety and redaction

  • No card numbers, CVVs, OTPs, magic links, API keys, access tokens, private prompts, wallet material, or private account records are published
  • Live workflow evidence is redacted where applicable — API key redacted to zpka_ed17...02523b32 in result-redacted.md; the Ed25519 signing private key lives in Zuplo secret storage and never appears in the tree
  • Public/private boundaries are explained (dedicated section in result-redacted.md)
  • Optional soul.md does not include private instructions, credentials, account data, wallet material, or operational secrets (soul.md not included)

Publish path

After merge to main, changes under showcase/** trigger the EconomyOS docs sync — the accepted manifest is published into /community#showcase.

Notes for the reviewer

The whole reviewer workflow is three commands, ~60 seconds:

pip install agentoracle-receipt-verify
cd showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/examples
python3 verify.py

Expected exit code 0, expected output valid: True with all three signature checks green, signer verified against the live JWKS. Full expected output is committed at .../examples/verify-output.txt for byte-comparison.

node scripts/validate-showcase.mjs at the repo root passes with this manifest included (55/55).

Framing notes

  • The shipped envelope in this demo is verification.v0.3+composed — content-addressed via RFC 8785 JCS, signed with Ed25519 (RFC 8032), packaged per RFC 7515 JWS General Serialization.
  • The v0.4 draft (sealed evidence + multi-clock anchors) is open under review as PR #5 on the spec repo and is not part of this demo — pointed at as a pointer only, not claimed as shipped.
  • The receipt format spec is filed with the IETF as draft-krausz-verification-state.

Adds a showcase package demonstrating settlement-grade signed
receipts for ACP transaction outcomes.

- showcase.json passes scripts/validate-showcase.mjs (55/55)
- receipt.json is a live production issuance against
  agentoracle-gateway-main-39fa17e.zuplo.app, signed
  ao-composed-2026-07-ed25519-3d44ba27
- verify.py reproduces valid=True against
  https://agentoracle.co/.well-known/jwks.json using the
  agentoracle-receipt-verify PyPI verifier (Apache-2.0)
- SKILL.md documents inputs, tools, credentials, approval gates,
  stop conditions, and output contract
- exactly three feedbackPrompts, exactly one acp primitive
- API key redacted in result-redacted.md; signing private key
  never in the tree
{
"slug": "agentoracle-verifiable-delivery",
"title": "AgentOracle Verifiable Delivery",
"tagline": "An ACP transaction outcome becomes a signed evidence artifact any third party can verify offline",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Totally optional, but the contributor guide suggests leading with a verb for a more active tagline. What do you think of something like this?

Suggested change
"tagline": "An ACP transaction outcome becomes a signed evidence artifact any third party can verify offline",
"tagline": "Record ACP transaction outcomes as verifiable, signed artifacts",

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Good call on the verb-first convention — taking it with one tweak, since "anyone can verify offline" is the property that distinguishes this from a log:

Turn ACP transaction outcomes into signed receipts anyone can verify offline.

Updated in the latest push (bc78661).

@github-actions

github-actions Bot commented Aug 3, 2026

Copy link
Copy Markdown

This is a fantastic submission—the level of detail, the verifiable live artifact, and the clear documentation are all top-notch. The verifiable receipt is a great example of building trust infrastructure for agent commerce.

Just a couple of small things to consider for the showcase card:

  1. To give this a hero image on the live showcase page, it'll need a posterUrl. Right now, the card will be text-only. If you add a 16:9 image to the PR (e.g., in a new showcase/agentoracle-verifiable-delivery/assets/ folder), you can add a line like this inside the visual block in showcase.json:
    "posterUrl": "https://raw.githubusercontent.com/Virtual-Protocol/acp-cli-demos/main/showcase/agentoracle-verifiable-delivery/assets/hero.png"
  2. Nit: The topics array includes a few values (verification, receipts, settlement) that aren't in the contributor guide's list. This is fine, but we might consolidate them under commerce or security for consistency unless you feel they're essential. No action needed, just flagging for maintainers.

I've left one small suggestion inline for the tagline, but feel free to take it or leave it. Thanks for this excellent contribution!

- Tagline updated to verb-first per bot suggestion, tweaked to keep
  the offline-verifiable property that distinguishes this from a log
- Added assets/hero.png (16:9) and posterUrl in the visual block so
  the community showcase card renders with a poster
- Topics left as-is (accurate to the artifact); happy for maintainers
  to consolidate if that's the house convention
@TKCollective

Copy link
Copy Markdown
Author

Added a hero image at assets/hero.png with the posterUrl line — thanks for the flag. Topics left as-is since they're accurate to the artifact; happy for maintainers to consolidate under commerce or security if that's the house convention.

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.

1 participant