meshtrade 0.0.1__py3-none-any.whl → 0.0.5__py3-none-any.whl

meshtrade/trading/direct_order/v1/direct_order_pb2.pyi

@@ -0,0 +1,11 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class DirectOrder(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...

meshtrade/trading/direct_order/v1/service_pb2.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/trading/direct_order/v1/service.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/trading/direct_order/v1/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.trading.direct_order.v1 import direct_order_pb2 as meshtrade_dot_trading_dot_direct__order_dot_v1_dot_direct__order__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n/meshtrade/trading/direct_order/v1/service.proto\x12!meshtrade.trading.direct_order.v1\x1a\x34meshtrade/trading/direct_order/v1/direct_order.proto\"/\n\x15GetDirectOrderRequest\x12\x16\n\x06number\x18\x01 \x01(\tR\x06number\"j\n\x16GetDirectOrderResponse\x12P\n\x0b\x64irectorder\x18\x01 \x01(\x0b\x32..meshtrade.trading.direct_order.v1.DirectOrderR\x0b\x64irectorder2\x90\x01\n\x12\x44irectOrderService\x12z\n\x03Get\x12\x38.meshtrade.trading.direct_order.v1.GetDirectOrderRequest\x1a\x39.meshtrade.trading.direct_order.v1.GetDirectOrderResponseBCZAgithub.com/meshtrade/api/go/trading/direct_order/v1;directorderv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.trading.direct_order.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'ZAgithub.com/meshtrade/api/go/trading/direct_order/v1;directorderv1'
+  _globals['_GETDIRECTORDERREQUEST']._serialized_start=140
+  _globals['_GETDIRECTORDERREQUEST']._serialized_end=187
+  _globals['_GETDIRECTORDERRESPONSE']._serialized_start=189
+  _globals['_GETDIRECTORDERRESPONSE']._serialized_end=295
+  _globals['_DIRECTORDERSERVICE']._serialized_start=298
+  _globals['_DIRECTORDERSERVICE']._serialized_end=442
+# @@protoc_insertion_point(module_scope)

meshtrade/trading/direct_order/v1/service_pb2.pyi

@@ -0,0 +1,19 @@
+from meshtrade.trading.direct_order.v1 import direct_order_pb2 as _direct_order_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class GetDirectOrderRequest(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...
+
+class GetDirectOrderResponse(_message.Message):
+    __slots__ = ("directorder",)
+    DIRECTORDER_FIELD_NUMBER: _ClassVar[int]
+    directorder: _direct_order_pb2.DirectOrder
+    def __init__(self, directorder: _Optional[_Union[_direct_order_pb2.DirectOrder, _Mapping]] = ...) -> None: ...

meshtrade/trading/limit_order/v1/limit_order_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/trading/limit_order/v1/limit_order.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/trading/limit_order/v1/limit_order.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n2meshtrade/trading/limit_order/v1/limit_order.proto\x12 meshtrade.trading.limit_order.v1\"$\n\nLimitOrder\x12\x16\n\x06number\x18\x01 \x01(\tR\x06numberBAZ?github.com/meshtrade/api/go/trading/limit_order/v1;limitorderv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.trading.limit_order.v1.limit_order_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z?github.com/meshtrade/api/go/trading/limit_order/v1;limitorderv1'
+  _globals['_LIMITORDER']._serialized_start=88
+  _globals['_LIMITORDER']._serialized_end=124
+# @@protoc_insertion_point(module_scope)

meshtrade/trading/limit_order/v1/limit_order_pb2.pyi

@@ -0,0 +1,11 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class LimitOrder(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...

meshtrade/trading/limit_order/v1/service_pb2.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/trading/limit_order/v1/service.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/trading/limit_order/v1/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.trading.limit_order.v1 import limit_order_pb2 as meshtrade_dot_trading_dot_limit__order_dot_v1_dot_limit__order__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n.meshtrade/trading/limit_order/v1/service.proto\x12 meshtrade.trading.limit_order.v1\x1a\x32meshtrade/trading/limit_order/v1/limit_order.proto\".\n\x14GetLimitOrderRequest\x12\x16\n\x06number\x18\x01 \x01(\tR\x06number\"e\n\x15GetLimitOrderResponse\x12L\n\nlimitorder\x18\x01 \x01(\x0b\x32,.meshtrade.trading.limit_order.v1.LimitOrderR\nlimitorder2\x8b\x01\n\x11LimitOrderService\x12v\n\x03Get\x12\x36.meshtrade.trading.limit_order.v1.GetLimitOrderRequest\x1a\x37.meshtrade.trading.limit_order.v1.GetLimitOrderResponseBAZ?github.com/meshtrade/api/go/trading/limit_order/v1;limitorderv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.trading.limit_order.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z?github.com/meshtrade/api/go/trading/limit_order/v1;limitorderv1'
+  _globals['_GETLIMITORDERREQUEST']._serialized_start=136
+  _globals['_GETLIMITORDERREQUEST']._serialized_end=182
+  _globals['_GETLIMITORDERRESPONSE']._serialized_start=184
+  _globals['_GETLIMITORDERRESPONSE']._serialized_end=285
+  _globals['_LIMITORDERSERVICE']._serialized_start=288
+  _globals['_LIMITORDERSERVICE']._serialized_end=427
+# @@protoc_insertion_point(module_scope)

meshtrade/trading/limit_order/v1/service_pb2.pyi

@@ -0,0 +1,19 @@
+from meshtrade.trading.limit_order.v1 import limit_order_pb2 as _limit_order_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class GetLimitOrderRequest(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...
+
+class GetLimitOrderResponse(_message.Message):
+    __slots__ = ("limitorder",)
+    LIMITORDER_FIELD_NUMBER: _ClassVar[int]
+    limitorder: _limit_order_pb2.LimitOrder
+    def __init__(self, limitorder: _Optional[_Union[_limit_order_pb2.LimitOrder, _Mapping]] = ...) -> None: ...

meshtrade/trading/spot/v1/service_pb2.py

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/trading/spot/v1/service.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/trading/spot/v1/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.trading.spot.v1 import spot_pb2 as meshtrade_dot_trading_dot_spot_dot_v1_dot_spot__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\'meshtrade/trading/spot/v1/service.proto\x12\x19meshtrade.trading.spot.v1\x1a$meshtrade/trading/spot/v1/spot.proto\"(\n\x0eGetSpotRequest\x12\x16\n\x06number\x18\x01 \x01(\tR\x06number\"F\n\x0fGetSpotResponse\x12\x33\n\x04spot\x18\x01 \x01(\x0b\x32\x1f.meshtrade.trading.spot.v1.SpotR\x04spot2k\n\x0bSpotService\x12\\\n\x03Get\x12).meshtrade.trading.spot.v1.GetSpotRequest\x1a*.meshtrade.trading.spot.v1.GetSpotResponseB4Z2github.com/meshtrade/api/go/trading/spot/v1;spotv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.trading.spot.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z2github.com/meshtrade/api/go/trading/spot/v1;spotv1'
+  _globals['_GETSPOTREQUEST']._serialized_start=108
+  _globals['_GETSPOTREQUEST']._serialized_end=148
+  _globals['_GETSPOTRESPONSE']._serialized_start=150
+  _globals['_GETSPOTRESPONSE']._serialized_end=220
+  _globals['_SPOTSERVICE']._serialized_start=222
+  _globals['_SPOTSERVICE']._serialized_end=329
+# @@protoc_insertion_point(module_scope)

meshtrade/{account → trading/spot}/v1/service_pb2.pyi

@@ -1,4 +1,4 @@
-from meshtrade.account.v1 import account_pb2 as _account_pb2
+from meshtrade.trading.spot.v1 import spot_pb2 as _spot_pb2
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import message as _message
 from collections.abc import Mapping as _Mapping
@@ -6,14 +6,14 @@ from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
-class GetRequest(_message.Message):
+class GetSpotRequest(_message.Message):
     __slots__ = ("number",)
     NUMBER_FIELD_NUMBER: _ClassVar[int]
     number: str
     def __init__(self, number: _Optional[str] = ...) -> None: ...
 
-class GetResponse(_message.Message):
-    __slots__ = ("account",)
-    ACCOUNT_FIELD_NUMBER: _ClassVar[int]
-    account: _account_pb2.Account
-    def __init__(self, account: _Optional[_Union[_account_pb2.Account, _Mapping]] = ...) -> None: ...
+class GetSpotResponse(_message.Message):
+    __slots__ = ("spot",)
+    SPOT_FIELD_NUMBER: _ClassVar[int]
+    spot: _spot_pb2.Spot
+    def __init__(self, spot: _Optional[_Union[_spot_pb2.Spot, _Mapping]] = ...) -> None: ...

meshtrade/trading/spot/v1/spot_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/trading/spot/v1/spot.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/trading/spot/v1/spot.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$meshtrade/trading/spot/v1/spot.proto\x12\x19meshtrade.trading.spot.v1\"\x1e\n\x04Spot\x12\x16\n\x06number\x18\x01 \x01(\tR\x06numberB4Z2github.com/meshtrade/api/go/trading/spot/v1;spotv1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.trading.spot.v1.spot_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z2github.com/meshtrade/api/go/trading/spot/v1;spotv1'
+  _globals['_SPOT']._serialized_start=67
+  _globals['_SPOT']._serialized_end=97
+# @@protoc_insertion_point(module_scope)

meshtrade/trading/spot/v1/spot_pb2.pyi

@@ -0,0 +1,11 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Spot(_message.Message):
+    __slots__ = ("number",)
+    NUMBER_FIELD_NUMBER: _ClassVar[int]
+    number: str
+    def __init__(self, number: _Optional[str] = ...) -> None: ...

meshtrade/type/v1/__init__.py

@@ -0,0 +1,7 @@
+from .amount import new_amount
+from .decimal_built_in_conversions import built_in_to_decimal, decimal_to_built_in
+from .decimal_pb2 import Decimal
+from .ledger_pb2 import Ledger
+from .ledger import get_ledger_no_decimal_places
+from .token_pb2 import Token
+from .amount_pb2 import Amount

meshtrade/type/v1/address_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/type/v1/address.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/type/v1/address.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1fmeshtrade/type/v1/address.proto\x12\x11meshtrade.type.v1\"\xba\x01\n\x07\x41\x64\x64ress\x12#\n\raddress_lines\x18\x01 \x03(\tR\x0c\x61\x64\x64ressLines\x12\x16\n\x06suburb\x18\x02 \x01(\tR\x06suburb\x12\x12\n\x04\x63ity\x18\x03 \x01(\tR\x04\x63ity\x12\x1a\n\x08province\x18\x04 \x01(\tR\x08province\x12!\n\x0c\x63ountry_code\x18\x05 \x01(\tR\x0b\x63ountryCode\x12\x1f\n\x0bpostal_code\x18\x06 \x01(\tR\npostalCodeB,Z*github.com/meshtrade/api/go/type/v1;typev1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.type.v1.address_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z*github.com/meshtrade/api/go/type/v1;typev1'
+  _globals['_ADDRESS']._serialized_start=55
+  _globals['_ADDRESS']._serialized_end=241
+# @@protoc_insertion_point(module_scope)

meshtrade/type/v1/address_pb2.pyi

@@ -0,0 +1,23 @@
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Address(_message.Message):
+    __slots__ = ("address_lines", "suburb", "city", "province", "country_code", "postal_code")
+    ADDRESS_LINES_FIELD_NUMBER: _ClassVar[int]
+    SUBURB_FIELD_NUMBER: _ClassVar[int]
+    CITY_FIELD_NUMBER: _ClassVar[int]
+    PROVINCE_FIELD_NUMBER: _ClassVar[int]
+    COUNTRY_CODE_FIELD_NUMBER: _ClassVar[int]
+    POSTAL_CODE_FIELD_NUMBER: _ClassVar[int]
+    address_lines: _containers.RepeatedScalarFieldContainer[str]
+    suburb: str
+    city: str
+    province: str
+    country_code: str
+    postal_code: str
+    def __init__(self, address_lines: _Optional[_Iterable[str]] = ..., suburb: _Optional[str] = ..., city: _Optional[str] = ..., province: _Optional[str] = ..., country_code: _Optional[str] = ..., postal_code: _Optional[str] = ...) -> None: ...

meshtrade/type/v1/amount.py

@@ -0,0 +1,84 @@
+"""
+This module provides a factory function for creating Amount protobuf messages.
+"""
+
+from decimal import ROUND_DOWN, Decimal
+
+from .amount_pb2 import Amount
+from .decimal_built_in_conversions import built_in_to_decimal, decimal_to_built_in
+from .ledger import get_ledger_no_decimal_places
+from .token_pb2 import Token
+
+
+def new_amount(
+    value: Decimal,
+    token: Token,
+    precision_loss_tolerance: Decimal = Decimal("0.00000001")
+) -> Amount:
+    """Creates a new Amount, ensuring the value conforms to system-wide limits.
+
+    This function is the safe constructor for creating Amount protobuf messages.
+    While the underlying conversion from a Python `Decimal` to the protobuf's
+    `string` field is lossless, this function provides critical validation
+    to ensure the value adheres to constraints imposed by other downstream
+    systems (e.g., databases, other microservices with fixed-precision types).
+
+    Its primary operations are:
+
+    1.  **Validation:** It performs a serialization round-trip
+        (Python Decimal -> Protobuf Decimal -> Python Decimal) to simulate
+        how the value is stored and retrieved across the system. It then asserts
+        the value remains unchanged, guaranteeing it doesn't exceed the
+        precision limits of any consuming service.
+
+    2.  **Truncation:** It truncates the validated value to the exact number of
+        decimal places defined for the token's ledger, always rounding down to
+        prevent any inflation of values.
+
+    3.  **Construction:** It constructs and returns the final `Amount` message.
+
+    Args:
+        value: The numerical value of the amount as a Python `Decimal` object.
+        token: The `Token` protobuf message that defines the asset type
+               and its associated ledger.
+        precision_loss_tolerance: The maximum acceptable difference after the
+            validation round-trip. Since the string-based conversion is
+            lossless, any difference indicates a failure to conform to an
+            external system's parsing rules. Defaults to a small tolerance
+            for robustness.
+
+    Returns:
+        An `Amount` protobuf message containing the ledger-compliant, truncated
+        value and the specified token.
+
+    Raises:
+        AssertionError: If the input `value` changes during the validation
+                        round-trip, indicating it exceeds the system's
+                        representational limits and would be corrupted
+                        downstream.
+    """
+
+    # Perform a serialization round-trip to validate the value against
+    # system-wide architectural constraints. This is a lossless operation
+    # in isolation, so any change reveals an incompatibility.
+    value_after_roundtrip = decimal_to_built_in(built_in_to_decimal(value))
+
+    # Confirm the value is perfectly representable within the system's limits.
+    # If the original value had too much precision for a downstream service to
+    # parse, it would change during the round-trip, and this would fail.
+    assert abs(value_after_roundtrip - value) \
+        <= precision_loss_tolerance, \
+            "value exceeds system's precision limits and would be corrupted"
+
+    # Truncate the validated value to the number of decimal places specified by the
+    # token's ledger. ROUND_DOWN ensures the value is never inflated.
+    truncated_value = value_after_roundtrip.quantize(
+        Decimal(10) ** -get_ledger_no_decimal_places(token.ledger),
+        rounding=ROUND_DOWN,
+    )
+
+    # Construct and return the final Amount protobuf message using the sanitized value.
+    return Amount(
+        token=token,
+        value=built_in_to_decimal(truncated_value),
+    )

meshtrade/type/v1/amount_pb2.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/type/v1/amount.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/type/v1/amount.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.type.v1 import decimal_pb2 as meshtrade_dot_type_dot_v1_dot_decimal__pb2
+from meshtrade.type.v1 import token_pb2 as meshtrade_dot_type_dot_v1_dot_token__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1emeshtrade/type/v1/amount.proto\x12\x11meshtrade.type.v1\x1a\x1fmeshtrade/type/v1/decimal.proto\x1a\x1dmeshtrade/type/v1/token.proto\"j\n\x06\x41mount\x12.\n\x05token\x18\x01 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenR\x05token\x12\x30\n\x05value\x18\x02 \x01(\x0b\x32\x1a.meshtrade.type.v1.DecimalR\x05valueB,Z*github.com/meshtrade/api/go/type/v1;typev1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.type.v1.amount_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z*github.com/meshtrade/api/go/type/v1;typev1'
+  _globals['_AMOUNT']._serialized_start=117
+  _globals['_AMOUNT']._serialized_end=223
+# @@protoc_insertion_point(module_scope)

meshtrade/type/v1/amount_pb2.pyi

@@ -0,0 +1,16 @@
+from meshtrade.type.v1 import decimal_pb2 as _decimal_pb2
+from meshtrade.type.v1 import token_pb2 as _token_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Amount(_message.Message):
+    __slots__ = ("token", "value")
+    TOKEN_FIELD_NUMBER: _ClassVar[int]
+    VALUE_FIELD_NUMBER: _ClassVar[int]
+    token: _token_pb2.Token
+    value: _decimal_pb2.Decimal
+    def __init__(self, token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ..., value: _Optional[_Union[_decimal_pb2.Decimal, _Mapping]] = ...) -> None: ...

meshtrade/type/v1/contact_details_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/type/v1/contact_details.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'meshtrade/type/v1/contact_details.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\'meshtrade/type/v1/contact_details.proto\x12\x11meshtrade.type.v1\"\xa4\x02\n\x0e\x43ontactDetails\x12#\n\remail_address\x18\x01 \x01(\tR\x0c\x65mailAddress\x12!\n\x0cphone_number\x18\x03 \x01(\tR\x0bphoneNumber\x12#\n\rmobile_number\x18\x05 \x01(\tR\x0cmobileNumber\x12\x18\n\x07website\x18\x06 \x01(\tR\x07website\x12\x1a\n\x08linkedin\x18\x07 \x01(\tR\x08linkedin\x12\x1a\n\x08\x66\x61\x63\x65\x62ook\x18\x08 \x01(\tR\x08\x66\x61\x63\x65\x62ook\x12\x1c\n\tinstagram\x18\t \x01(\tR\tinstagram\x12\x1b\n\tx_twitter\x18\n \x01(\tR\x08xTwitter\x12\x18\n\x07youtube\x18\x0b \x01(\tR\x07youtubeB,Z*github.com/meshtrade/api/go/type/v1;typev1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.type.v1.contact_details_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'Z*github.com/meshtrade/api/go/type/v1;typev1'
+  _globals['_CONTACTDETAILS']._serialized_start=63
+  _globals['_CONTACTDETAILS']._serialized_end=355
+# @@protoc_insertion_point(module_scope)

meshtrade/type/v1/contact_details_pb2.pyi

@@ -0,0 +1,27 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class ContactDetails(_message.Message):
+    __slots__ = ("email_address", "phone_number", "mobile_number", "website", "linkedin", "facebook", "instagram", "x_twitter", "youtube")
+    EMAIL_ADDRESS_FIELD_NUMBER: _ClassVar[int]
+    PHONE_NUMBER_FIELD_NUMBER: _ClassVar[int]
+    MOBILE_NUMBER_FIELD_NUMBER: _ClassVar[int]
+    WEBSITE_FIELD_NUMBER: _ClassVar[int]
+    LINKEDIN_FIELD_NUMBER: _ClassVar[int]
+    FACEBOOK_FIELD_NUMBER: _ClassVar[int]
+    INSTAGRAM_FIELD_NUMBER: _ClassVar[int]
+    X_TWITTER_FIELD_NUMBER: _ClassVar[int]
+    YOUTUBE_FIELD_NUMBER: _ClassVar[int]
+    email_address: str
+    phone_number: str
+    mobile_number: str
+    website: str
+    linkedin: str
+    facebook: str
+    instagram: str
+    x_twitter: str
+    youtube: str
+    def __init__(self, email_address: _Optional[str] = ..., phone_number: _Optional[str] = ..., mobile_number: _Optional[str] = ..., website: _Optional[str] = ..., linkedin: _Optional[str] = ..., facebook: _Optional[str] = ..., instagram: _Optional[str] = ..., x_twitter: _Optional[str] = ..., youtube: _Optional[str] = ...) -> None: ...

meshtrade/type/v1/decimal_built_in_conversions.py

@@ -0,0 +1,29 @@
+import decimal
+
+from .decimal_pb2 import Decimal
+
+
+def built_in_to_decimal(decimal_value: decimal.Decimal) -> Decimal:
+    """
+    Converts an instance of the built-in decimal.Decimal type to an instance of the
+    financial Decimal protobuf type.
+
+    :param decimal_value: The decimal.Decimal object to convert.
+    :return: The converted financial Decimal protobuf object.
+    """
+
+    # Contruct and return resultant decimal object
+    return Decimal(
+        value=str(decimal_value),
+    )
+
+
+def decimal_to_built_in(decimal_value: Decimal) -> decimal.Decimal:
+    """
+    Converts an instance of the financial Decimal protobuf type to an instance of the
+    built-in decimal.Decimal type.
+
+    :param decimal_value: The decimal_pb2.Decimal object to convert.
+    :return: The converted decimal.Decimal object.
+    """
+    return decimal.Decimal( decimal_value.value if decimal_value.value != "" else "0"  )