feat: add scv.to_void and scv.from_void. (#863)

CHANGELOG.md

@@ -2,6 +2,8 @@ Release History
 ==============
 
 ### Pending
+#### Update
+- feat: add `scv.to_void` and `scv.from_void`. ([#863](https://github.com/StellarCN/py-stellar-base/pull/863))
 
 ### Version 9.1.3
 

stellar_sdk/scval.py

@@ -8,6 +8,8 @@
     "from_address",
     "to_bool",
     "from_bool",
+    "to_void",
+    "from_void",
     "to_bytes",
     "from_bytes",
     "to_duration",
@@ -95,6 +97,26 @@ def from_bool(sc_val: stellar_xdr.SCVal) -> bool:
     return sc_val.b
 
 
+def to_void() -> stellar_xdr.SCVal:
+    """Creates a new :class:`stellar_sdk.xdr.SCVal` XDR object of type :class:`stellar_sdk.xdr.SCValType.SCV_VOID`.
+
+    :return: A new :class:`stellar_sdk.xdr.SCVal` XDR object of type :class:`stellar_sdk.xdr.SCValType.SCV_VOID`.
+    """
+    return stellar_xdr.SCVal(stellar_xdr.SCValType.SCV_VOID)
+
+
+def from_void(sc_val: stellar_xdr.SCVal) -> None:
+    """Creates a None value from a :class:`stellar_sdk.xdr.SCVal` XDR object.
+
+    :param sc_val: The :class:`stellar_sdk.xdr.SCVal` XDR object to convert.
+    :return: None.
+    :raises: :exc:`ValueError` if ``sc_val`` is not of type :class:`stellar_sdk.xdr.SCValType.SCV_VOID`.
+    """
+    if sc_val.type != stellar_xdr.SCValType.SCV_VOID:
+        raise ValueError(f"Invalid sc_val type, must be SCV_VOID, got {sc_val.type}")
+    return None
+
+
 def to_bytes(data: bytes) -> stellar_xdr.SCVal:
     """Creates a new :class:`stellar_sdk.xdr.SCVal` XDR object from a bytes value.
 

tests/test_scval.py

@@ -22,6 +22,13 @@ def test_bool():
     assert from_bool(scval) is True
 
 
+def test_void():
+    scval = to_void()
+    expected_scval = xdr.SCVal(stellar_xdr.SCValType.SCV_VOID)
+    assert scval == expected_scval
+    assert from_void(scval) is None
+
+
 def test_bytes():
     v = b"hello"
     scval = to_bytes(v)