docs: rustdoc oracles public entrypoints (v7) (#948)

[Awointa]

Adds NatSpec-style rustdoc comments to every public fn in contracts/oracles/src/lib.rs — purpose, params, return values, panics/errors, and relevant security notes for each entrypoint.

• No functional/logic changes; docs-only
• cargo doc builds clean, no warnings
• Lint/test suite run, all passing (output included in PR)

Closes #948.

[drips-wave]

@Awointa Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[greatest0fallt1me]

Merging — thanks for polishing this up. 👍

[Awointa]

I am grateful