Add rustdoc comments to all public contract functions

[Omoboi-dev]

Add rustdoc documentation comments to every public function in contract.rs. Each comment should explain what the function does, who can call it, what parameters it expects, what it returns, and which errors it can produce.