Add an result_tools module

python/wax/_private/result_tools.py

+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from wax._private.exceptions import WaxValidationFailedError
+from wax.wax_result import python_error_code, python_result
+
+if TYPE_CHECKING:
+    from wax._private.models.basic import AccountName
+
+
+def to_python_string(value: bytes | str) -> str:
+    if isinstance(value, str):
+        return value
+    return value.decode()
+
+
+def to_cpp_string(value: bytes | str) -> bytes:
+    if isinstance(value, str):
+        return value.encode()
+    return value
+
+
+def validate_wax_result(result: python_result) -> None:
+    if result.status == python_error_code.fail:
+        raise WaxValidationFailedError(to_python_string(result.exception_message))
+
+
+def expose_result_as_python_string(result: python_result) -> str:
+    return to_python_string(result.result)
+
+
+def expose_result_as_cpp_string(result: python_result) -> bytes:
+    return result.result
+
+
+def decode_impacted_account_names(account_names: list[bytes]) -> list[AccountName]:
+    """
+    Decode account names from bytes to str.
+
+    Args:
+        account_names: List of account names in bytes.
+
+    Returns:
+        List of account names.
+    """
+    return [to_python_string(account_name) for account_name in account_names]