Coherence Layer — Prove Before Act

Close the loop between intent and result. Anchor your WHY before acting, anchor your WHAT after, link the pair to produce a public, on-chain coherence score.

Full 4W loop

W	Tool / endpoint	When	Role
WHO	MX-8004 / SIGIL NFT	Registration	Agent identity, on-chain
WHY	`check_coherence`	Before act	Intent + context + decision hash
WHAT	`certify_file`	After act	Result / output hash
WHEN	MultiversX timestamp	Automatic	Immutable block timestamp

check_coherence — Anchor your WHY before acting

MCP tool implementing Prove Before Act. Call BEFORE executing any significant action. Pass intent, context, and decision.

{ "name": "check_coherence", "arguments": { "intent": "...", "context": "...", "decision": "...", "who": "optional" } }

Response: proof_id, coherence_anchor (SHA-256), timestamp, verify_url, next_step.link_why_to_what.
Cost: $0.01/anchor. First 10 free. Idempotent: identical payloads return the same proof_id.

POST /api/coherence/link — Close the loop

After executing and certifying your WHAT, link the two proofs. Auth: Bearer pm_...

curl -X POST https://provebeforeact.com/api/coherence/link \
  -H "Authorization: Bearer pm_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"why_proof_id": "<UUID from check_coherence>", "what_proof_id": "<UUID from certify_file>"}'

Coherence score: 50 base + 15 if WHAT within 1 h + 20 if WHAT metadata.why_proof_id references WHY + 15 if WHAT on-chain confirmed.

Unlinked WHY anchor: pending for <1 h, then divergent after 1 h; flagged as proposed fault violation after 2 h TTL.

require_coherence_anchor — Coherence Artisan policy gate

MCP tool for orchestrators. Before delegating a sub-action, verify a valid WHY anchor exists. Free — no credit consumed.

allowed: true → anchor valid; returns anchor_id, expires_at, verify_url
allowed: false → reason NO_ANCHOR or ANCHOR_EXPIRED; required_action: "check_coherence"

Coherence history

GET https://provebeforeact.com/api/agents/{wallet}/coherence?limit=50&offset=0

Returns per-anchor status (linked | pending <1 h | divergent ≥1 h) plus aggregate coherence_rate and avg_coherence_score. Public, no auth required.

Fleet coherence

Aggregate coherence across an entire fleet — the Coherence Artisan view.

GET https://provebeforeact.com/api/fleet/coherence?org=<wallet_prefix>
GET https://provebeforeact.com/api/fleet/coherence?fleet=<slug>

Returns per-agent stats plus fleet_score = round(0.7 × coherence_rate + 0.3 × avg_coherence_score). Interactive view: https://provebeforeact.com/fleet

Resources

Agent context page — full API reference for AI agents
llms.txt — machine-readable tool list
xproof.md — full specification
Fleet view — interactive fleet coherence dashboard