Skip to content

docs(aivmbridge): contributor-onboarding README - #8

Closed
abhicris wants to merge 1 commit into
luxfi:mainfrom
abhicris:docs/aivmbridge-readme
Closed

docs(aivmbridge): contributor-onboarding README#8
abhicris wants to merge 1 commit into
luxfi:mainfrom
abhicris:docs/aivmbridge-readme

Conversation

@abhicris

Copy link
Copy Markdown
Contributor

What this adds

A contributor-onboarding aivmbridge/README.md for the AIVMBridge precompile.

Why

The precompile shipped in 9fbe02b (2026-06-24, computeproof.go — the native computeattest op closing audit G10) and is normatively specified in LP-5301. The package has no in-tree README, so contributors landing on it have to reconstruct the address, selectors, bridge law, and 12-vector security map from file headers. This adds a single anchor doc that:

  • States the address (0x0300…0004) and the three selectors (Pattern A submit, Pattern B verify, verifyComputeProof).
  • Names the LP-5301 §Security 12-vector defenses with file citations into this package.
  • Quotes the LP-5300 Bridge Law (no live-A-read, no live-A-mutate, no consensus path outside ZAP) in the form enforced here.
  • Lists every file with one-line roles.
  • Points to LP-5300 / LP-5301 / HIP-0114 / ZIP-0901 for the corpus.

Risk

Pure docs. No new code. No build/test impact. No new dependencies.

Governance

  • LP-5301 — normative spec for this precompile.
  • LP-5300 — Thinking Chains / Cognitive Consensus / PoT (bridge law, off-chain attack surface).
  • HIP-0114 — ZAP Inter-VM Cognitive Transport (cog.* procedures); ZAP-transport-only rule honored — README states ZAP is never a consensus input on its own and is not in the intent_id preimage.
  • ZIP-0901 — Zoo-side Thinking Chains profile (referenced for the cross-org corpus).

Not auto-merged; opened for review.

Adds README.md for the AIVMBridge precompile shipped in 9fbe02b
(2026-06-24). Anchors LP-5301 §Security 12-vector map, Bridge Law
constraints, and file table to actual code.

Pure docs. No behavior change.
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