Skip to main content

Pre-execution evidence · coherence layer

Coherence Layer — Prove Before Act

Link a declared WHY commitment to a recorded WHAT. This can produce a public, on-chain coherence score; it does not establish private intention or independently witness arbitrary off-chain execution. The operator must enforce its action gate.

Full 4W loop

W Tool / endpoint When Role
WHOMX-8004 identity (optional)When activeAgent identity, when configured
WHYcheck_coherenceBefore actDeclared intent + context + decision basis hash
WHATcertify_fileAfter actResult / output hash
WHENMultiversX timestampAutomaticImmutable block timestamp

check_coherence — Anchor a declared decision basis before acting

xProof's MCP tool implements the Prove Before Act pattern. Pass a declared decision basis and context before execution; do not provide internal chain-of-thought. The commitment is verifiable, not private intention, and this tool does not block execution. The operator must enforce its own action gate.

{ "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 (live rate). 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, check whether a valid declared decision-basis (WHY) anchor exists. The caller must enforce any action gate. Free — no credit consumed.

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