meshtrade 1.0.1__py3-none-any.whl → 1.29.0__py3-none-any.whl

meshtrade/ledger/transaction/v1/service_meshpy.py

@@ -0,0 +1,176 @@
+# Code generated by protoc-gen-meshpy. DO NOT EDIT.
+# source: meshtrade/ledger/transaction/v1/service.proto
+
+"""
+TransactionService gRPC service wrapper with authentication, timeouts, and resource management.
+
+This module provides a high-level gRPC service for the TransactionService service that combines
+the service interface with resource management capabilities, providing authentication,
+timeouts, and proper connection handling.
+"""
+
+from collections.abc import Iterator
+from datetime import timedelta
+from typing import Optional
+
+from meshtrade.common import BaseGRPCClient
+from meshtrade.iam.api_user.v1.api_credentials import find_credentials
+
+from meshtrade.common.service_options import ServiceOptions
+from .service_pb2 import (
+GetTransactionStateRequest,
+GetTransactionStateResponse,
+MonitorTransactionStateRequest,
+MonitorTransactionStateResponse,
+)
+from .service_pb2_grpc import TransactionServiceStub
+
+
+def _create_transactionservice_stub(channel):
+    """Factory function to create TransactionServiceStub from gRPC channel."""
+    return TransactionServiceStub(channel)
+
+
+class TransactionService(BaseGRPCClient):
+    """TransactionService gRPC service with authentication, timeouts, and resource management.
+
+    This service provides a complete implementation of the TransactionService with proper authentication, timeout handling, and automatic resource cleanup.
+
+    Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/ledger/transaction/v1
+
+    Basic service usage with default SDK Configuration:
+    ```python
+    service = TransactionService()
+
+    with service:   # `with` ensures proper clean up of underlying connection after use
+        response = service.get_api_user(request)
+    ```
+        
+    With default configuration API credentials are searched for using the standard discovery hierarchy:
+    
+    1. MESH_API_CREDENTIALS environment variable
+    
+    2. Default credential file location:
+    
+    - Linux:   `$XDG_CONFIG_HOME/mesh/credentials.json` or fallback to `$HOME/.config/mesh/credentials.json`
+    - macOS:   `$HOME/Library/Application Support/mesh/credentials.json`
+    - Windows: `C:\\Users\\<user>\\AppData\\Roaming\\mesh\\credentials.json`
+    
+    For more information on authentication: https://meshtrade.github.io/api/docs/architecture/authentication
+
+    The service may also be configured with custom options:
+    ```python
+    from .service_options_meshpy import ServiceOptions
+    from datetime import timedelta
+
+    options = ServiceOptions(
+        url="api.staging.example.com",
+        port=443,
+        api_key="your-api-key",
+        group="groups/your-group-id",
+        timeout=timedelta(seconds=60)
+    )
+
+    service = TransactionService(options)
+
+    with service: # `with` ensures proper clean up of underlying connection after use
+        response = service.get_api_user(request)
+    ```
+
+    For more information on service configuration: https://meshtrade.github.io/api/docs/architecture/sdk-configuration
+    """
+
+    def __init__(self, options: Optional[ServiceOptions] = None):
+        """Construct and initialize the TransactionService service.
+
+        Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/ledger/transaction/v1
+
+        Args:
+            options: Optional ServiceOptions for configuring the service.
+                    If None, service is constructed with default configuration.
+                    With default configuration API credentials are searched for using the standard discovery hierarchy:
+                    
+                    1. MESH_API_CREDENTIALS environment variable
+                    
+                    2. Default credential file location:
+                    
+                    - Linux:   `$XDG_CONFIG_HOME/mesh/credentials.json` or fallback to `$HOME/.config/mesh/credentials.json`
+                    - macOS:   `$HOME/Library/Application Support/mesh/credentials.json`
+                    - Windows: `C:\\Users\\<user>\\AppData\\Roaming\\mesh\\credentials.json`      
+
+                    For more information on authentication: https://meshtrade.github.io/api/docs/architecture/authentication
+
+                    For more information on service configuration: https://meshtrade.github.io/api/docs/architecture/sdk-configuration            
+
+        Example:
+        ```python
+        # construct with default configuration
+        service = TransactionService()
+
+        # construct with custom configuration
+        options = ServiceOptions(
+            url="api.example.com",
+            api_key="your-key",
+            group="groups/your-group"
+        )
+        service = TransactionService(options)
+        ```
+        """
+        if options is None:
+            options = ServiceOptions()
+
+        # Initialize the base client with all common functionality
+        super().__init__(
+            service_name="TransactionService",
+            stub_factory=_create_transactionservice_stub,
+            find_credentials_func=find_credentials,
+            url=options.url,
+            port=options.port,
+            api_key=options.api_key,
+            group=options.group,
+            timeout=options.timeout,
+            tls=options.tls,
+        )
+
+    def get_transaction_state(self, request: GetTransactionStateRequest, timeout: Optional[timedelta] = None) -> GetTransactionStateResponse:
+        """GetTransactionState method.
+
+        Args:
+            request: The GetTransactionState request message
+            timeout: Optional timeout override for this call
+
+        Returns:
+            The GetTransactionState response message
+
+        Raises:
+            grpc.RpcError: If the gRPC call fails
+            ValueError: If authentication credentials are missing
+        """
+        return self._execute_method("GetTransactionState", request, timeout)
+
+    def monitor_transaction_state(self, request: MonitorTransactionStateRequest, timeout: Optional[timedelta] = None) -> Iterator[MonitorTransactionStateResponse]:
+        """MonitorTransactionState server-side streaming method with authentication and validation.
+
+        Args:
+            request: The MonitorTransactionState request message
+            timeout: Optional timeout override for this call
+
+        Yields:
+            MonitorTransactionStateResponse: Stream of response messages
+
+        Raises:
+            grpc.RpcError: If the gRPC call fails
+            ValueError: If authentication credentials are missing or request validation fails
+
+        Example:
+            >>> stream = service.monitor_transaction_state(request)
+            >>> for response in stream:
+            ...     # Process each response
+            ...     print(response)
+        """
+        return self._execute_streaming_method("MonitorTransactionState", request, timeout)
+
+
+# Create aliases to match expected exports
+TransactionServiceGRPCClient = TransactionService
+TransactionServiceGRPCClientInterface = TransactionService

meshtrade/ledger/transaction/v1/service_pb2.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/ledger/transaction/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/ledger/transaction/v1/service.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from buf.validate import validate_pb2 as buf_dot_validate_dot_validate__pb2
+from meshtrade.ledger.transaction.v1 import transaction_state_pb2 as meshtrade_dot_ledger_dot_transaction_dot_v1_dot_transaction__state__pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as meshtrade_dot_option_dot_method__options_dot_v1_dot_method__options__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n-meshtrade/ledger/transaction/v1/service.proto\x12\x1fmeshtrade.ledger.transaction.v1\x1a\x1b\x62uf/validate/validate.proto\x1a\x37meshtrade/ledger/transaction/v1/transaction_state.proto\x1a\x37meshtrade/option/method_options/v1/method_options.proto\"t\n\x1aGetTransactionStateRequest\x12V\n\x04name\x18\x01 \x01(\tBB\xbaH?r:25^transactions/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\x98\x01\'\xc8\x01\x01R\x04name\"f\n\x1bGetTransactionStateResponse\x12G\n\x05state\x18\x01 \x01(\x0e\x32\x31.meshtrade.ledger.transaction.v1.TransactionStateR\x05state\"x\n\x1eMonitorTransactionStateRequest\x12V\n\x04name\x18\x01 \x01(\tBB\xbaH?r:25^transactions/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\x98\x01\'\xc8\x01\x01R\x04name\"j\n\x1fMonitorTransactionStateResponse\x12G\n\x05state\x18\x01 \x01(\x0e\x32\x31.meshtrade.ledger.transaction.v1.TransactionStateR\x05state2\x80\x03\n\x12TransactionService\x12\xac\x01\n\x13GetTransactionState\x12;.meshtrade.ledger.transaction.v1.GetTransactionStateRequest\x1a<.meshtrade.ledger.transaction.v1.GetTransactionStateResponse\"\x1a\xb2\xb5\x18\x16\x08\x01\x10\x02\x1a\x10\xc0\x9f\xab\x03\xc1\x9f\xab\x03\xc2\x9f\xab\x03\xc3\x9f\xab\x03\x12\xba\x01\n\x17MonitorTransactionState\x12?.meshtrade.ledger.transaction.v1.MonitorTransactionStateRequest\x1a@.meshtrade.ledger.transaction.v1.MonitorTransactionStateResponse\"\x1a\xb2\xb5\x18\x16\x08\x01\x10\x02\x1a\x10\xc0\x9f\xab\x03\xc1\x9f\xab\x03\xc2\x9f\xab\x03\xc3\x9f\xab\x03\x30\x01\x42j\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.ledger.transaction.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1'
+  _globals['_GETTRANSACTIONSTATEREQUEST'].fields_by_name['name']._loaded_options = None
+  _globals['_GETTRANSACTIONSTATEREQUEST'].fields_by_name['name']._serialized_options = b'\272H?r:25^transactions/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\230\001\'\310\001\001'
+  _globals['_MONITORTRANSACTIONSTATEREQUEST'].fields_by_name['name']._loaded_options = None
+  _globals['_MONITORTRANSACTIONSTATEREQUEST'].fields_by_name['name']._serialized_options = b'\272H?r:25^transactions/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$\230\001\'\310\001\001'
+  _globals['_TRANSACTIONSERVICE'].methods_by_name['GetTransactionState']._loaded_options = None
+  _globals['_TRANSACTIONSERVICE'].methods_by_name['GetTransactionState']._serialized_options = b'\262\265\030\026\010\001\020\002\032\020\300\237\253\003\301\237\253\003\302\237\253\003\303\237\253\003'
+  _globals['_TRANSACTIONSERVICE'].methods_by_name['MonitorTransactionState']._loaded_options = None
+  _globals['_TRANSACTIONSERVICE'].methods_by_name['MonitorTransactionState']._serialized_options = b'\262\265\030\026\010\001\020\002\032\020\300\237\253\003\301\237\253\003\302\237\253\003\303\237\253\003'
+  _globals['_GETTRANSACTIONSTATEREQUEST']._serialized_start=225
+  _globals['_GETTRANSACTIONSTATEREQUEST']._serialized_end=341
+  _globals['_GETTRANSACTIONSTATERESPONSE']._serialized_start=343
+  _globals['_GETTRANSACTIONSTATERESPONSE']._serialized_end=445
+  _globals['_MONITORTRANSACTIONSTATEREQUEST']._serialized_start=447
+  _globals['_MONITORTRANSACTIONSTATEREQUEST']._serialized_end=567
+  _globals['_MONITORTRANSACTIONSTATERESPONSE']._serialized_start=569
+  _globals['_MONITORTRANSACTIONSTATERESPONSE']._serialized_end=675
+  _globals['_TRANSACTIONSERVICE']._serialized_start=678
+  _globals['_TRANSACTIONSERVICE']._serialized_end=1062
+# @@protoc_insertion_point(module_scope)

meshtrade/ledger/transaction/v1/service_pb2.pyi

@@ -0,0 +1,32 @@
+from buf.validate import validate_pb2 as _validate_pb2
+from meshtrade.ledger.transaction.v1 import transaction_state_pb2 as _transaction_state_pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as _method_options_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class GetTransactionStateRequest(_message.Message):
+    __slots__ = ("name",)
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    def __init__(self, name: _Optional[str] = ...) -> None: ...
+
+class GetTransactionStateResponse(_message.Message):
+    __slots__ = ("state",)
+    STATE_FIELD_NUMBER: _ClassVar[int]
+    state: _transaction_state_pb2.TransactionState
+    def __init__(self, state: _Optional[_Union[_transaction_state_pb2.TransactionState, str]] = ...) -> None: ...
+
+class MonitorTransactionStateRequest(_message.Message):
+    __slots__ = ("name",)
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    def __init__(self, name: _Optional[str] = ...) -> None: ...
+
+class MonitorTransactionStateResponse(_message.Message):
+    __slots__ = ("state",)
+    STATE_FIELD_NUMBER: _ClassVar[int]
+    state: _transaction_state_pb2.TransactionState
+    def __init__(self, state: _Optional[_Union[_transaction_state_pb2.TransactionState, str]] = ...) -> None: ...

meshtrade/ledger/transaction/v1/service_pb2_grpc.py

@@ -0,0 +1,131 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from meshtrade.ledger.transaction.v1 import service_pb2 as meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2
+
+
+class TransactionServiceStub(object):
+    """
+    TransactionService manages Transaction lifecycle.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.GetTransactionState = channel.unary_unary(
+                '/meshtrade.ledger.transaction.v1.TransactionService/GetTransactionState',
+                request_serializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateResponse.FromString,
+                _registered_method=True)
+        self.MonitorTransactionState = channel.unary_stream(
+                '/meshtrade.ledger.transaction.v1.TransactionService/MonitorTransactionState',
+                request_serializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateResponse.FromString,
+                _registered_method=True)
+
+
+class TransactionServiceServicer(object):
+    """
+    TransactionService manages Transaction lifecycle.
+    """
+
+    def GetTransactionState(self, request, context):
+        """
+        Retrieves a single Transaction state by the unique identifier of the transaction
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def MonitorTransactionState(self, request, context):
+        """
+        Monitor Transaction state changes by the unique identifier of the transaction.
+        Server-side streaming method that sends state updates as the transaction progresses.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_TransactionServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'GetTransactionState': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetTransactionState,
+                    request_deserializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateRequest.FromString,
+                    response_serializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateResponse.SerializeToString,
+            ),
+            'MonitorTransactionState': grpc.unary_stream_rpc_method_handler(
+                    servicer.MonitorTransactionState,
+                    request_deserializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateRequest.FromString,
+                    response_serializer=meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'meshtrade.ledger.transaction.v1.TransactionService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('meshtrade.ledger.transaction.v1.TransactionService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class TransactionService(object):
+    """
+    TransactionService manages Transaction lifecycle.
+    """
+
+    @staticmethod
+    def GetTransactionState(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/meshtrade.ledger.transaction.v1.TransactionService/GetTransactionState',
+            meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateRequest.SerializeToString,
+            meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.GetTransactionStateResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def MonitorTransactionState(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_stream(
+            request,
+            target,
+            '/meshtrade.ledger.transaction.v1.TransactionService/MonitorTransactionState',
+            meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateRequest.SerializeToString,
+            meshtrade_dot_ledger_dot_transaction_dot_v1_dot_service__pb2.MonitorTransactionStateResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

meshtrade/ledger/transaction/v1/transaction_action_pb2.py

@@ -24,14 +24,14 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n8meshtrade/ledger/transaction/v1/transaction_action.proto\x12\x1fmeshtrade.ledger.transaction.v1*\xf8\x01\n\x11TransactionAction\x12\"\n\x1eTRANSACTION_ACTION_UNSPECIFIED\x10\x00\x12!\n\x1dTRANSACTION_ACTION_DO_NOTHING\x10\x01\x12\x1c\n\x18TRANSACTION_ACTION_BUILD\x10\x02\x12\x1d\n\x19TRANSACTION_ACTION_COMMIT\x10\x03\x12\x1b\n\x17TRANSACTION_ACTION_SIGN\x10\x04\x12#\n\x1fTRANSACTION_ACTION_MARK_PENDING\x10\x05\x12\x1d\n\x19TRANSACTION_ACTION_SUBMIT\x10\x06\x42i\n&co.meshtrade.api.ledger.transaction.v1Z?github.com/meshtrade/api/go/ledger/transaction/v1;transactionv1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n8meshtrade/ledger/transaction/v1/transaction_action.proto\x12\x1fmeshtrade.ledger.transaction.v1*\xf8\x01\n\x11TransactionAction\x12\"\n\x1eTRANSACTION_ACTION_UNSPECIFIED\x10\x00\x12!\n\x1dTRANSACTION_ACTION_DO_NOTHING\x10\x01\x12\x1c\n\x18TRANSACTION_ACTION_BUILD\x10\x02\x12\x1d\n\x19TRANSACTION_ACTION_COMMIT\x10\x03\x12\x1b\n\x17TRANSACTION_ACTION_SIGN\x10\x04\x12#\n\x1fTRANSACTION_ACTION_MARK_PENDING\x10\x05\x12\x1d\n\x19TRANSACTION_ACTION_SUBMIT\x10\x06\x42j\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.ledger.transaction.v1.transaction_action_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
-  _globals['DESCRIPTOR']._serialized_options = b'\n&co.meshtrade.api.ledger.transaction.v1Z?github.com/meshtrade/api/go/ledger/transaction/v1;transactionv1'
+  _globals['DESCRIPTOR']._serialized_options = b'\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1'
   _globals['_TRANSACTIONACTION']._serialized_start=94
   _globals['_TRANSACTIONACTION']._serialized_end=342
 # @@protoc_insertion_point(module_scope)

meshtrade/ledger/transaction/v1/transaction_state_machine.py

@@ -0,0 +1,75 @@
+"""Transaction state machine validation and transition logic.
+
+This module provides state machine functions for transaction states and actions,
+implementing the transaction lifecycle management logic.
+"""
+
+from meshtrade.ledger.transaction.v1.transaction_action_pb2 import TransactionAction
+from meshtrade.ledger.transaction.v1.transaction_state_pb2 import TransactionState
+
+
+def transaction_state_can_perform_action_at_state(state: TransactionState | None, action: TransactionAction | None) -> bool:
+    """Check if the given action can be performed at the current transaction state.
+
+    This implements the state machine logic for transaction lifecycle management.
+
+    State Transitions:
+    - DRAFT -> BUILD/COMMIT -> SIGNING_IN_PROGRESS
+    - SIGNING_IN_PROGRESS -> SIGN/MARK_PENDING -> PENDING
+    - PENDING -> SUBMIT -> SUBMISSION_IN_PROGRESS
+    - SUBMISSION_IN_PROGRESS -> SUBMIT (retry) -> INDETERMINATE or SUCCESS/FAILED
+    - INDETERMINATE -> SUBMIT (retry) -> SUCCESS/FAILED
+    - FAILED/SUCCESSFUL -> No further actions allowed (terminal states)
+
+    Args:
+        state: The current TransactionState (can be None)
+        action: The TransactionAction to perform (can be None)
+
+    Returns:
+        True if the action can be performed at the given state, False otherwise
+
+    None Safety:
+        Returns False if either state or action is None
+
+    Example:
+        >>> transaction_state_can_perform_action_at_state(
+        ...     TransactionState.TRANSACTION_STATE_DRAFT,
+        ...     TransactionAction.TRANSACTION_ACTION_BUILD
+        ... )
+        True
+        >>> transaction_state_can_perform_action_at_state(
+        ...     TransactionState.TRANSACTION_STATE_SUCCESSFUL,
+        ...     TransactionAction.TRANSACTION_ACTION_SUBMIT
+        ... )
+        False
+    """
+    if state is None or action is None:
+        return False
+
+    if state == TransactionState.TRANSACTION_STATE_DRAFT:
+        return action in {
+            TransactionAction.TRANSACTION_ACTION_BUILD,
+            TransactionAction.TRANSACTION_ACTION_COMMIT,
+        }
+
+    elif state == TransactionState.TRANSACTION_STATE_SIGNING_IN_PROGRESS:
+        return action in {
+            TransactionAction.TRANSACTION_ACTION_SIGN,
+            TransactionAction.TRANSACTION_ACTION_MARK_PENDING,
+        }
+
+    elif state in {
+        TransactionState.TRANSACTION_STATE_PENDING,
+        TransactionState.TRANSACTION_STATE_SUBMISSION_IN_PROGRESS,
+        TransactionState.TRANSACTION_STATE_INDETERMINATE,
+    }:
+        return action == TransactionAction.TRANSACTION_ACTION_SUBMIT
+
+    elif state in {
+        TransactionState.TRANSACTION_STATE_FAILED,
+        TransactionState.TRANSACTION_STATE_SUCCESSFUL,
+    }:
+        return False
+
+    else:
+        return False

meshtrade/ledger/transaction/v1/transaction_state_pb2.py

@@ -24,14 +24,14 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n7meshtrade/ledger/transaction/v1/transaction_state.proto\x12\x1fmeshtrade.ledger.transaction.v1*\xaf\x02\n\x10TransactionState\x12!\n\x1dTRANSACTION_STATE_UNSPECIFIED\x10\x00\x12\x1b\n\x17TRANSACTION_STATE_DRAFT\x10\x01\x12)\n%TRANSACTION_STATE_SIGNING_IN_PROGRESS\x10\x02\x12\x1d\n\x19TRANSACTION_STATE_PENDING\x10\x03\x12,\n(TRANSACTION_STATE_SUBMISSION_IN_PROGRESS\x10\x04\x12\x1c\n\x18TRANSACTION_STATE_FAILED\x10\x05\x12#\n\x1fTRANSACTION_STATE_INDETERMINATE\x10\x06\x12 \n\x1cTRANSACTION_STATE_SUCCESSFUL\x10\x07\x42i\n&co.meshtrade.api.ledger.transaction.v1Z?github.com/meshtrade/api/go/ledger/transaction/v1;transactionv1b\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n7meshtrade/ledger/transaction/v1/transaction_state.proto\x12\x1fmeshtrade.ledger.transaction.v1*\xaf\x02\n\x10TransactionState\x12!\n\x1dTRANSACTION_STATE_UNSPECIFIED\x10\x00\x12\x1b\n\x17TRANSACTION_STATE_DRAFT\x10\x01\x12)\n%TRANSACTION_STATE_SIGNING_IN_PROGRESS\x10\x02\x12\x1d\n\x19TRANSACTION_STATE_PENDING\x10\x03\x12,\n(TRANSACTION_STATE_SUBMISSION_IN_PROGRESS\x10\x04\x12\x1c\n\x18TRANSACTION_STATE_FAILED\x10\x05\x12#\n\x1fTRANSACTION_STATE_INDETERMINATE\x10\x06\x12 \n\x1cTRANSACTION_STATE_SUCCESSFUL\x10\x07\x42j\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1b\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.ledger.transaction.v1.transaction_state_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
-  _globals['DESCRIPTOR']._serialized_options = b'\n&co.meshtrade.api.ledger.transaction.v1Z?github.com/meshtrade/api/go/ledger/transaction/v1;transactionv1'
+  _globals['DESCRIPTOR']._serialized_options = b'\n&co.meshtrade.api.ledger.transaction.v1Z@github.com/meshtrade/api/go/ledger/transaction/v1;transaction_v1'
   _globals['_TRANSACTIONSTATE']._serialized_start=93
   _globals['_TRANSACTIONSTATE']._serialized_end=396
 # @@protoc_insertion_point(module_scope)

meshtrade/{reporting/income_report → market_data/price}/v1/__init__.py

@@ -1,4 +1,4 @@
-"""Income Report v1 package."""
+"""Price v1 package."""
 
 # ===================================================================
 # AUTO-GENERATED SECTION - ONLY EDIT BELOW THE CLOSING COMMENT BLOCK
@@ -13,18 +13,15 @@
 # ===================================================================
 
 # Generated protobuf imports
-from .disclaimer_pb2 import Disclaimer
-from .entry_pb2 import Entry, Narrative
-from .income_report_pb2 import IncomeReport
-from .service_pb2 import GetExcelIncomeReportRequest, GetExcelIncomeReportResponse, GetIncomeReportRequest
+from .price_pb2 import Price
+from .service_pb2 import GetCurrentPriceByTokenPairRequest
 
 # Generated service imports
 from .service_meshpy import (
-    IncomeReportService,
-    IncomeReportServiceGRPCClient,
-    IncomeReportServiceGRPCClientInterface,
+    PriceService,
+    PriceServiceGRPCClient,
+    PriceServiceGRPCClientInterface,
 )
-from .service_options_meshpy import ClientOptions
 
 # ===================================================================
 # END OF AUTO-GENERATED SECTION
@@ -46,15 +43,9 @@ from .service_options_meshpy import ClientOptions
 # Combined auto-generated and manual exports
 __all__ = [
     # Generated exports
-    "ClientOptions",
-    "Disclaimer",
-    "Entry",
-    "GetExcelIncomeReportRequest",
-    "GetExcelIncomeReportResponse",
-    "GetIncomeReportRequest",
-    "IncomeReport",
-    "IncomeReportService",
-    "IncomeReportServiceGRPCClient",
-    "IncomeReportServiceGRPCClientInterface",
-    "Narrative",
+    "GetCurrentPriceByTokenPairRequest",
+    "Price",
+    "PriceService",
+    "PriceServiceGRPCClient",
+    "PriceServiceGRPCClientInterface",
 ]

meshtrade/market_data/price/v1/price_pb2.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/market_data/price/v1/price.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/market_data/price/v1/price.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+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*meshtrade/market_data/price/v1/price.proto\x12\x1emeshtrade.market_data.price.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1fmeshtrade/type/v1/decimal.proto\x1a\x1dmeshtrade/type/v1/token.proto\"\xe4\x01\n\x05Price\x12\x37\n\nbase_token\x18\x01 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenR\tbaseToken\x12\x39\n\x0bquote_token\x18\x02 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenR\nquoteToken\x12\x37\n\tmid_price\x18\x03 \x01(\x0b\x32\x1a.meshtrade.type.v1.DecimalR\x08midPrice\x12.\n\x04time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x04timeBb\n%co.meshtrade.api.market_data.price.v1Z9github.com/meshtrade/api/go/market_data/price/v1;price_v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.market_data.price.v1.price_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n%co.meshtrade.api.market_data.price.v1Z9github.com/meshtrade/api/go/market_data/price/v1;price_v1'
+  _globals['_PRICE']._serialized_start=176
+  _globals['_PRICE']._serialized_end=404
+# @@protoc_insertion_point(module_scope)

meshtrade/market_data/price/v1/price_pb2.pyi

@@ -0,0 +1,23 @@
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+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 Price(_message.Message):
+    __slots__ = ("base_token", "quote_token", "mid_price", "time")
+    BASE_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    QUOTE_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    MID_PRICE_FIELD_NUMBER: _ClassVar[int]
+    TIME_FIELD_NUMBER: _ClassVar[int]
+    base_token: _token_pb2.Token
+    quote_token: _token_pb2.Token
+    mid_price: _decimal_pb2.Decimal
+    time: _timestamp_pb2.Timestamp
+    def __init__(self, base_token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ..., quote_token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ..., mid_price: _Optional[_Union[_decimal_pb2.Decimal, _Mapping]] = ..., time: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ...) -> None: ...