Showcase: AgentOracle Verifiable Delivery — signed ACP-outcome receipts, verified offline - #97
Conversation
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", |
There was a problem hiding this comment.
Totally optional, but the contributor guide suggests leading with a verb for a more active tagline. What do you think of something like this?
| "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", |
There was a problem hiding this comment.
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).
|
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:
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
|
Added a hero image at |
|
Heads-up for maintainers: the draft advisory-review workflow errors on scripts/showcase-review/run.mjs (MODULE_NOT_FOUND) with a Node 20 deprecation warning — both look repo-side rather than anything in this diff. Local scripts/validate-showcase.mjs passes 55/55, and the advisory bot’s earlier review on this PR has already been addressed (hero image wired and tagline updated to the verb-first convention). |
|
One small note before this goes further: the manifest, SKILL.md, and README currently mention pricing in a few places throughout. A single clear call-to-action (such as “Learn more” or “Get access”) is totally welcome and can be a helpful way for users to follow up. Since this is a product/technical showcase, it would be great to slightly reframe the content so the focus stays on the technical capabilities, functionality, & usage examples rather than promotional messaging. This will help highlight the product details while keeping the entry informative, developer-focused, and aligned with the showcase format! thank youuu! |
- README.md: drop pricing bullet from References; add single 'Learn more' section at end - showcase.json: soften install snippet — API key without price - SKILL.md: strip pricing from Tools + Credentials + Approval gates; retain full technical detail (endpoints, rate limits, RFC refs, algorithm choices) - prompt.md: technical framing for key acquisition; reproduction steps unchanged in substance No changes to any technical content: receipt.json, compose_request.json, verify.py, verify-output.txt, result-redacted.md, hero.png untouched. Showcase now fully technical.
|
Done — pricing references removed from the manifest, SKILL.md, the skill's example prompt, and README; kept a single "Learn more" link at the README's end. Showcase is now fully technical. Thanks for the clear guidance! |
What shipped
agentoracle-verifiable-deliveryacpshowcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/examples/receipt.json.Produced against the AgentOracle production gateway on 2026-08-03 UTC,
verifies
valid: Trueoffline against the live JWKS athttps://agentoracle.co/.well-known/jwks.json using the
agentoracle-receipt-verifyPyPI reference verifier (Apache-2.0). No fixtures, no mocks, no test-mode keys.
Project package
showcase/agentoracle-verifiable-delivery/showcase.jsonreceipt.json,compose_request.json,verify.py,verify-output.txtprompt.md(scenario + reproduction) andresult-redacted.md(redacted run report)showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/skills/<skill-name>/only when shared across projects (N/A — project-scoped)skills[].sourcePathinshowcase.jsonfor the committed skillhidden: true— not set (this is a full public entry)soul.md— not linkedSkill standard
Skill path:
showcase/agentoracle-verifiable-delivery/skills/agentoracle-signed-receipt/SKILL.mdincludes when to use it and when not to use itSafety and redaction
zpka_ed17...02523b32inresult-redacted.md; the Ed25519 signing private key lives in Zuplo secret storage and never appears in the treeresult-redacted.md)soul.mddoes not include private instructions, credentials, account data, wallet material, or operational secrets (soul.md not included)Publish path
After merge to
main, changes undershowcase/**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.pyExpected exit code
0, expected outputvalid: Truewith all three signature checks green, signer verified against the live JWKS. Full expected output is committed at.../examples/verify-output.txtfor byte-comparison.node scripts/validate-showcase.mjsat the repo root passes with this manifest included (55/55).Framing notes
verification.v0.3+composed— content-addressed via RFC 8785 JCS, signed with Ed25519 (RFC 8032), packaged per RFC 7515 JWS General Serialization.draft-krausz-verification-state.