Improve Documentation for Script Tools Module

[ethsmartcoder]

Changes

Added detailed function comments:

• Provided clear explanations for the purpose, parameters, return values, and exceptions for all exported and key internal functions.
• Used Typedoc-compatible annotations to facilitate automatic documentation generation.

Removed unclear or outdated comments:

• Eliminated comments that were ambiguous or redundant with the code logic.
• Ensured the remaining comments are concise, relevant, and directly useful for understanding the code.