Skip to content

docs: Comprehensive API Documentation for PrivacyPool Contract#149

Open
foorttesst-oss wants to merge 1 commit intoANAVHEOBA:mainfrom
foorttesst-oss:bounty/api-documentation
Open

docs: Comprehensive API Documentation for PrivacyPool Contract#149
foorttesst-oss wants to merge 1 commit intoANAVHEOBA:mainfrom
foorttesst-oss:bounty/api-documentation

Conversation

@foorttesst-oss
Copy link

Bounty: #62 — Create API Documentation with OpenAPI

What's included:

📚 Full API documentation covering:

  • All contract functions (initialize, deposit, withdraw)
  • View functions (get_root, deposit_count, is_known_root, is_spent, get_config)
  • Admin functions (pause, unpause)
  • Complete type definitions (Denomination, Proof, PublicInputs, PoolConfig, Error)
  • Event documentation (DepositEvent, WithdrawEvent)
  • Architecture diagram
  • Error codes reference table

Format:

  • Clean Markdown (docs/API.md)
  • Ready for GitHub rendering
  • Tables for parameters, errors, and types
  • ASCII architecture diagram

Notes:

  • Generated from reading the actual contract source code
  • Covers the Soroban/Stellar smart contract API
  • OpenAPI/Swagger spec can be added in follow-up PR for relayer endpoints

Resolves #62

- Full documentation of all contract functions (initialize, deposit, withdraw)
- View functions (get_root, deposit_count, is_known_root, is_spent, get_config)
- Admin functions (pause, unpause)
- Complete type definitions (Denomination, Proof, PublicInputs, PoolConfig, Error)
- Event documentation (DepositEvent, WithdrawEvent)
- Architecture diagram
- Error codes reference table

Resolves ANAVHEOBA#62
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.

[BOUNTY] Create API Documentation with OpenAPI

1 participant