Skip to content

docs: full contract API reference in README - #6

Merged
fadesany merged 1 commit into
mainfrom
docs/contract-reference
Aug 11, 2026
Merged

fadesany merged 1 commit into
mainfrom
docs/contract-reference

Conversation

@fadesany

Copy link
Copy Markdown
Collaborator

What

Adds a Contract reference section to the README documenting the complete callable interface of all three contracts. The README previously explained how the contracts work conceptually but never listed the actual entry points, so a developer couldn't see what to call.

Coverage

  • Treasury — all 20 public functions (config/approvers, categories, funds/requests, views), grouped by role with auth and validation notes; Category/Request/RequestStatus types; all 9 events (topics vs data); all 11 error codes.
  • Factory — all 5 public functions; OrgRecord type; TreasuryDeployed event; all 4 error codes. Documents the dual deployer+admin auth on deploy_treasury.
  • Test token — its 8 functions, explicitly flagged as test-only (not production surface).

Accuracy

Every signature, event, and error was read from source (contracts/*/src/{lib,types,events,errors}.rs), not inferred. Known-gap callouts link to the existing tracking issues (#2, #3). No contract logic changed — docs only.

Cover every public entry point, data type, event, and error code for
the treasury, factory, and test-token contracts, all verified against
source. Caller-facing signatures note injected Env and required auth;
errors and events link to the corresponding source.
@fadesany
fadesany merged commit be72224 into main Aug 11, 2026
1 check passed
@fadesany
fadesany deleted the docs/contract-reference branch August 11, 2026 08:49
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