Skip to content

Decide and enforce the Shape 2 binding contract #64

@OkeyAmy

Description

@OkeyAmy

Problem

HTTP Shape 1 can prove that the executed request body matches the signed invocation. Pure JSON-RPC Shape 2 currently verifies the bundle from _meta, but it does not send the actual JSON-RPC params as the /verify binding body. That is fine if we say it clearly. It is dangerous if users think Shape 2 has the same execution-integrity guarantee as Shape 1.

What to do

Choose one contract and make the code, tests, and docs match it:

  1. implement Shape 2 params/body binding parity, or
  2. explicitly scope Shape 2 to provenance verification only for the first pilot wedge

Acceptance criteria

  • one written decision exists in the docs
  • helper package behavior matches that decision
  • tests prove the chosen behavior
  • README and builder docs do not imply stronger guarantees than the code provides

Out of scope

  • plugin work
  • new transports
  • broad standards positioning

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthighHigh severityproductProduct wedge, adoption path, or demo worksecuritySecurity vulnerability or hardening

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions