Add comprehensive NatSpec documentation

[RonTuretzky]

Adds detailed NatSpec documentation to all Solidity contracts in the project.

Summary

• Added @title, @notice, @dev, @param, and @return tags to all interfaces, implementations, examples, tests, and scripts
• Improved clarity on data structures, error conditions, and contract interactions
• Documented all public functions with their behavior and parameters

Files Updated

• Core contracts: IOpacitySDK.sol, OpacitySDK.sol
• Example consumers: SimpleVerificationConsumer.sol, StorageQueryConsumer.sol
• Tests: OpacitySDK.t.sol, ExampleConsumers.t.sol
• Deployment script: Deploy.s.sol

All tests pass successfully (17 passed).