ERGO
External review handoff

One pack for reviewers to inspect.

This is the operational handoff for the Ergo Agent Economy testnet proof. It lists the scope, evidence, commands, claims, and mainnet gate rules an external reviewer needs before any stronger public language can be considered.

Review posture
ready for external review not audit report

This is a reviewer handoff pack for the testnet live proof. It is not an external audit report and does not open mainnet readiness.

Network
testnet
Mainnet
closed
Evidence
39
Last review
2026-05-23

Allowed language

  • testnet live proof
  • signed Sage L1 conformance evidence
  • full post-Blob receipt bundle
  • audit-gated mainnet path

Forbidden language

  • Sage is mainnet ready
  • Accord is production certified
  • ChainCash/Basis contracts are audited
  • the current Sage payment scripts are safe for real funds

Mainnet gate rule

  • external_audit_report is a completed non-template artifact
  • mainnet_script_identity is a completed audit-bound non-template artifact

Review boundary

What is included and what is not.

The point is to keep the review target exact. The current pack covers the hosted testnet proof and the public evidence surface, not a real-funds mainnet deployment.

Included in review

Sage quote, chat, verify-payment, signer-health, activity, and receipt APIs
Agreement JSON, Verification Receipt JSON, and Settlement Receipt JSON shape and durability
Task hash canonicalization across quote, verify, receipt, conformance, and widget surfaces
Vercel Blob receipt storage write/read and fallback behavior
Sage testnet signer policy, limits, failure logging, health, and runbook
Observed Ergo testnet Reserve, Note, registers, and settlement identity
Accord L1 conformance evidence and provider signing key publication
MCP endpoint as public machine-facing infrastructure
Developer launch kit and service index as the public onboarding surface
Sage widget v0.3.0 as host-owned wallet handoff surface
Wallet-agent safety spec, policy-check API, policy playground, and reference runner for local policy, simulation, signing boundaries, strict decimal/task-hash validation, unknown-field rejection, and receipt retention
Public wording and mainnet gate controls
Release watchlist, security header checks, npm audit expectation, and post-deploy smoke targets
Current release API that reports the runtime Git/Vercel release context without creating a new static attestation for every deploy
Release attestation artifact that records the reviewed commit, deployment id, npm audit result, post-deploy watch result, and mainnet gate invariants

Excluded until separate review

real-funds mainnet custody
third-party wallet internals
third-party tenant deployments
exchange or fiat integrations
unpublished production signer setup
claims about unaudited mainnet contract safety

Evidence

Every artifact the reviewer should open.

These links point at the same receipt, conformance, signer, identity, npm, and gate artifacts surfaced by the Live Hub and Trust Gate.

full receipt bundle
https://www.ergoblockchain.org/api/sage/receipt/f8752d10a2ece92fbc88065c3b92b94da621ec65943098f43c9e084deb763d81
Open
signed conformance result
https://www.ergoblockchain.org/evidence/sage/conformance-l1-2026-05-21.signed.json
Open
latest evidence
https://www.ergoblockchain.org/evidence/sage/latest-evidence.json
Open
script identity manifest
https://www.ergoblockchain.org/agent-economy/script-identity-manifest.v0.json
Open
audit scope manifest
https://www.ergoblockchain.org/agent-economy/audit-scope-manifest.v0.json
Open
audit readiness checklist
https://www.ergoblockchain.org/agent-economy/audit-readiness-checklist.v0.json
Open
review pack
https://www.ergoblockchain.org/agent-economy/review-pack
Open
review pack api
https://www.ergoblockchain.org/api/agent-economy/review-pack
Open
developer launch kit
https://www.ergoblockchain.org/agent-economy/launch-kit
Open
developer launch kit api
https://www.ergoblockchain.org/api/agent-economy/launch-kit
Open
developer launch kit schema
https://www.ergoblockchain.org/agent-economy/developer-launch-kit.schema.v0.json
Open
release watchlist
https://www.ergoblockchain.org/agent-economy/release-watchlist.v0.json
Open
release watchlist schema
https://www.ergoblockchain.org/agent-economy/release-watchlist.schema.v0.json
Open
current release api
https://www.ergoblockchain.org/api/agent-economy/release/current
Open
current release schema
https://www.ergoblockchain.org/agent-economy/current-release.schema.v0.json
Open
release attestation 2026 05 23
https://www.ergoblockchain.org/agent-economy/release-attestation-2026-05-23.v0.json
Open
release attestation schema
https://www.ergoblockchain.org/agent-economy/release-attestation.schema.v0.json
Open
wallet agent policy check schema
https://www.ergoblockchain.org/agent-economy/wallet-agent-policy-check.schema.v0.json
Open
signer ops evidence
https://www.ergoblockchain.org/agent-economy/signer-ops-evidence.v0.json
Open
external audit review template
https://www.ergoblockchain.org/agent-economy/external-audit-review.manifest.template.json
Open
external audit review schema
https://www.ergoblockchain.org/agent-economy/external-audit-review.schema.v0.json
Open
mainnet script identity template
https://www.ergoblockchain.org/agent-economy/mainnet-script-identity.manifest.template.json
Open
mainnet script identity schema
https://www.ergoblockchain.org/agent-economy/mainnet-script-identity.schema.v0.json
Open
mcp endpoint runbook
https://github.com/bez111/ergo_v0/blob/main/docs/mcp-endpoint-runbook.md
Open
signer runbook
https://github.com/bez111/ergo_v0/blob/main/docs/sage-signer-ops.md
Open
external audit report
not published yet
Pending
mainnet script identity
not published yet
Pending
review pack page
https://www.ergoblockchain.org/agent-economy/review-pack
Open
wallet agent safety spec
https://www.ergoblockchain.org/agent-economy/wallet-agent
Open
wallet agent safety spec api
https://www.ergoblockchain.org/api/agent-economy/wallet-agent
Open
wallet agent policy schema
https://www.ergoblockchain.org/agent-economy/wallet-agent-policy.schema.v0.json
Open
wallet agent policy template
https://www.ergoblockchain.org/agent-economy/wallet-agent-policy.profile.template.json
Open
wallet agent policy check api
https://www.ergoblockchain.org/api/agent-economy/wallet-agent/policy-check
Open
wallet agent reference flow
https://www.ergoblockchain.org/build/agent-payments/wallet-agent-runner
Open
wallet agent reference flow api
https://www.ergoblockchain.org/api/agent-economy/wallet-agent/reference-flow
Open
wallet agent reference flow manifest
https://www.ergoblockchain.org/agent-economy/wallet-agent-reference-flow.v0.json
Open
wallet agent policy playground
https://www.ergoblockchain.org/build/agent-payments/policy-playground
Open
reviewer handoff doc
https://github.com/bez111/ergo_v0/blob/main/docs/agent-economy-reviewer-handoff.md
Open
sage widget npm
https://www.npmjs.com/package/@ergoblockchain/sage-widget/v/0.3.0
Open

Repositories

Source locations to pin.

A completed external review should record exact commits, lockfile hashes, deployment ids, package versions, and workflow runs.

site
https://github.com/bez111/ergo_v0
Open
sage widget
https://github.com/bez111/sage-widget
Open
mcp
https://github.com/bez111/ergoblockchain-mcp
Open
accord registry
https://github.com/accord-protocol/accord-protocol
Open

Reviewer checklist

Questions the report must answer.

The final report should be attributable and should state whether each finding blocks mainnet language.

1

Record reviewer identity, date, public key or durable attribution method.

2

Pin reviewed repository commits and deployment identifiers.

3

Record package versions, lockfile hash, and relevant workflow runs.

4

Verify that the full receipt bundle contains Agreement JSON, Verification Receipt JSON, and Settlement Receipt JSON.

5

Verify that signed conformance evidence covers the same receipt id.

6

Verify that stale, unrelated, wrong-recipient, wrong-value, wrong-reserve, or replayed Notes cannot satisfy a premium Sage request.

7

Verify that receipt completeness distinguishes full_receipt_bundle from chain_proof_only.

8

Verify that wallet-agent policy-check rejects malformed decimals, negative spend, invalid task hashes, unknown profile/action fields, unknown allowed actions, invalid receipt-retention modes, and mainnet-disabled actions.

9

Review signer policy limits, failure logging, failover posture, and redaction guarantees.

10

Verify that the wallet-agent policy-check API denies wrong-recipient, wrong-reserve, over-cap, stale-expiry, and missing-receipt actions before any signing request.

11

Verify that the wallet-agent policy playground demonstrates both allowed and blocked verdicts without touching wallet authority.

12

Verify that the wallet-agent reference flow keeps signing inside the host-owned wallet layer and stops after a denied policy verdict.

13

Verify that release watch targets, security headers, and mainnet gate invariants stay green after every production deploy.

14

Verify that the current release API reports the served commit and keeps mainnet_ready false.

15

Verify that the release attestation pins the reviewed commit, Vercel deployment id, package-lock hash, and check results.

16

Confirm that public site wording remains testnet-only until both pending mainnet gates are closed.

17

Publish findings with severity, status, remediation reference, and residual risk.

Acceptance workflow

How a review becomes gate evidence.

The next external artifact should be strict enough to pin code, deployments, script identities, findings, and residual risk without changing the public mainnet posture prematurely.

Step 1

The external reviewer pins reviewed commits, deployment id, lockfile hash, package versions, and evidence URLs.

Step 2

The reviewer publishes a completed external-audit-review.manifest.v0.json that satisfies the public schema.

Step 3

A completed mainnet-script-identity.manifest.v0.json binds every mainnet script to source artifact hash, compiled ErgoTree hash, address, and test vectors.

Step 4

Every finding states severity, status, remediation reference, residual risk, and whether it blocks mainnet language.

Step 5

The mainnet gate remains closed until both completed non-template artifacts are linked from /api/agent-economy/mainnet-gate.

Local verification

Commands to run before accepting the pack.

These commands do not replace external review. They keep the website, content claims, and public gate mechanics honest while the review is pending.

npm run type-check
npm run audit:blog
npm run audit:locales
npm run audit:agent-economy-gate
npm audit --audit-level=moderate
npm run smoke:routes
npm run smoke:staging
npm run watch:post-deploy