feat Add rustdoc examples and inline usage snippets to all public con…

[Vibeofkd]

…tract functions

Summary

Linked issue(s)

Type of change

• Bug fix
• New feature
• Refactor / code quality
• Documentation
• CI / tooling
• Cross-repo change (affects shared contracts — see below)

What was tested

# e.g.
pytest tests/test_benford.py -v
cargo test

Cross-repo impact

• RiskScore struct (contract / core / data / api)
• Asset pair identifier format
• submit_score / get_score contract ABI
• Risk thresholds (RISK_SCORE_FLAG_THRESHOLD, MAD_NONCONFORMITY_THRESHOLD)
• Environment variable / config keys

Linked cross-repo PRs:

Checklist

• Tests pass locally (pytest / cargo test)
• Python: black . and ruff check . pass (Python repos)
• Rust: cargo fmt --check and cargo clippy -- -D warnings pass (contract repo)
• New code has tests
• Documentation updated where needed
• No secrets, .env files, or API keys committed
• PR title is concise and descriptive

[Inkman007]

please pass checks