chore: add VerificationResult documentation and extend CсommitmentScheme trait

[avorylli]

Description

This PR enhances the documentation and functionality of the lib.rs file by:

• Adding comprehensive documentation for the VerificationResult type, detailing its purpose, use cases, and return values.
• Extending the CommitmentScheme trait for improved modularity and usability.

These changes aim to make the codebase more readable and maintainable, ensuring clear guidelines for developers working with the verification and commitment functionality.

Key Places to Review

• lib.rs file:
  • VerificationResult type: Added detailed documentation.
  • CommitmentScheme trait: Review the added extensions and ensure they align with the existing framework.

---

Checklist

• Targeted PR against the correct branch (main).
• Linked to GitHub issue or provided an explanation of the necessity of these changes.
• Wrote unit tests (N/A for documentation updates but required for new trait methods).
• Updated relevant documentation in the code.
• Added relevant changelog entries to CHANGELOG.md for affected crates.
• Re-reviewed Files changed in the GitHub PR explorer.

---

Notes

If further clarification or updates are needed, please feel free to comment on this PR.

[CLAassistant]

All committers have signed the CLA.