Skip to content

docs: add complete escrow entrypoint and error-code reference#72

Merged
mikewheeleer merged 1 commit into
Agentpay-Org:mainfrom
1nonlypiece:docs/contracts-26-api-reference
Jun 24, 2026
Merged

docs: add complete escrow entrypoint and error-code reference#72
mikewheeleer merged 1 commit into
Agentpay-Org:mainfrom
1nonlypiece:docs/contracts-26-api-reference

Conversation

@1nonlypiece

Copy link
Copy Markdown
Contributor

Closes #26.

Summary

Adds docs/escrow/api.md — a single, source-checked API reference for the escrow contract, linked from the README's Documentation section.

Contents

  • Write entrypoints table: params, required signing principal, pause behaviour, return, and the error codes each can panic with.
  • Read entrypoints list with their default-when-absent semantics.
  • Error-code catalogue: every EscrowError variant → numeric code, trigger condition, and the entrypoints that raise it.
  • Notes the append-only error-code policy and the version() vs get_schema_version() distinction.

Tests

test result: ok. 51 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.50s

Docs-only change; no source modified.

Security notes

The doc states auth and pause requirements per entrypoint exactly as enforced in lib.rs (verified line-by-line), so integrators cannot misread which calls are admin-gated.

Adds docs/escrow/api.md documenting every entrypoint (signature, auth, pause
behaviour, returns, panics) and the full EscrowError catalogue, cross-checked
against the source. Linked from README. No logic change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mikewheeleer mikewheeleer merged commit 47900e2 into Agentpay-Org:main Jun 24, 2026
1 check passed
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.

Document the full escrow entrypoint reference and error code catalogue

2 participants