add docstrings to candid interface

[letmejustputthishere]

currently the candid interface is lacking comments, it would be great to add those to add context for developers. see the icrc1 ledger interface for example.