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

meshtrade/reporting/account_report/v1/fee_entry_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/reporting/account_report/v1/fee_entry.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/reporting/account_report/v1/fee_entry.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 amount_pb2 as meshtrade_dot_type_dot_v1_dot_amount__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n5meshtrade/reporting/account_report/v1/fee_entry.proto\x12%meshtrade.reporting.account_report.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1emeshtrade/type/v1/amount.proto\"\xc7\x02\n\x08\x46\x65\x65\x45ntry\x12\x45\n\x10transaction_date\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x0ftransactionDate\x12%\n\x0etransaction_id\x18\x02 \x01(\tR\rtransactionId\x12 \n\x0b\x64\x65scription\x18\x03 \x01(\tR\x0b\x64\x65scription\x12\x31\n\x06\x61mount\x18\x04 \x01(\x0b\x32\x19.meshtrade.type.v1.AmountR\x06\x61mount\x12Q\n\x17reported_currency_value\x18\x05 \x01(\x0b\x32\x19.meshtrade.type.v1.AmountR\x15reportedCurrencyValue\x12%\n\x0etoken_currency\x18\x06 \x01(\tR\rtokenCurrencyBy\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.reporting.account_report.v1.fee_entry_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1'
+  _globals['_FEEENTRY']._serialized_start=162
+  _globals['_FEEENTRY']._serialized_end=489
+# @@protoc_insertion_point(module_scope)

meshtrade/reporting/account_report/v1/fee_entry_pb2.pyi

@@ -0,0 +1,26 @@
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from meshtrade.type.v1 import amount_pb2 as _amount_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 FeeEntry(_message.Message):
+    __slots__ = ("transaction_date", "transaction_id", "description", "amount", "reported_currency_value", "token_currency")
+    TRANSACTION_DATE_FIELD_NUMBER: _ClassVar[int]
+    TRANSACTION_ID_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    AMOUNT_FIELD_NUMBER: _ClassVar[int]
+    REPORTED_CURRENCY_VALUE_FIELD_NUMBER: _ClassVar[int]
+    TOKEN_CURRENCY_FIELD_NUMBER: _ClassVar[int]
+    transaction_date: _timestamp_pb2.Timestamp
+    transaction_id: str
+    description: str
+    amount: _amount_pb2.Amount
+    reported_currency_value: _amount_pb2.Amount
+    token_currency: str
+    def __init__(self, transaction_date: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., transaction_id: _Optional[str] = ..., description: _Optional[str] = ..., amount: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ..., reported_currency_value: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ..., token_currency: _Optional[str] = ...) -> None: ...

meshtrade/reporting/account_report/v1/fee_entry_pb2_grpc.py

@@ -0,0 +1,4 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+

meshtrade/reporting/account_report/v1/income_entry.py

@@ -0,0 +1,35 @@
+"""Income entry utility functions."""
+
+from meshtrade.reporting.account_report.v1.income_entry_pb2 import IncomeNarrative
+
+
+def income_narrative_pretty_string(narrative: IncomeNarrative) -> str:
+    """Generate human-readable string for income narrative.
+
+    Converts enum values to concise, display-friendly strings suitable for
+    reports and user interfaces.
+
+    Args:
+        narrative: IncomeNarrative enum value
+
+    Returns:
+        Pretty-printed string representation:
+        - "-" for unspecified narratives
+        - Descriptive names for known types (e.g., "Yield", "Dividend")
+        - Empty string for unknown values
+    """
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_UNSPECIFIED:
+        return "-"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_YIELD:
+        return "Yield"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_DIVIDEND:
+        return "Dividend"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_INTEREST:
+        return "Interest"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_PRINCIPAL:
+        return "Principal"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_DISTRIBUTION:
+        return "Distribution"
+    if narrative == IncomeNarrative.INCOME_NARRATIVE_PROFIT_DISTRIBUTION:
+        return "Profit Distribution"
+    return ""

meshtrade/reporting/account_report/v1/income_entry_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/reporting/account_report/v1/income_entry.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/reporting/account_report/v1/income_entry.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from meshtrade.type.v1 import token_pb2 as meshtrade_dot_type_dot_v1_dot_token__pb2
+from meshtrade.type.v1 import amount_pb2 as meshtrade_dot_type_dot_v1_dot_amount__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n8meshtrade/reporting/account_report/v1/income_entry.proto\x12%meshtrade.reporting.account_report.v1\x1a\x1dmeshtrade/type/v1/token.proto\x1a\x1emeshtrade/type/v1/amount.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x8a\x03\n\x0bIncomeEntry\x12\x1d\n\nasset_name\x18\x01 \x01(\tR\tassetName\x12.\n\x05token\x18\x02 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenR\x05token\x12.\n\x04\x64\x61te\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampR\x04\x64\x61te\x12 \n\x0b\x64\x65scription\x18\x04 \x01(\tR\x0b\x64\x65scription\x12T\n\tnarrative\x18\x05 \x01(\x0e\x32\x36.meshtrade.reporting.account_report.v1.IncomeNarrativeR\tnarrative\x12\x31\n\x06\x61mount\x18\x06 \x01(\x0b\x32\x19.meshtrade.type.v1.AmountR\x06\x61mount\x12Q\n\x17reported_currency_value\x18\x07 \x01(\x0b\x32\x19.meshtrade.type.v1.AmountR\x15reportedCurrencyValue*\xfa\x01\n\x0fIncomeNarrative\x12 \n\x1cINCOME_NARRATIVE_UNSPECIFIED\x10\x00\x12\x1a\n\x16INCOME_NARRATIVE_YIELD\x10\x01\x12\x1d\n\x19INCOME_NARRATIVE_DIVIDEND\x10\x02\x12\x1d\n\x19INCOME_NARRATIVE_INTEREST\x10\x03\x12\x1e\n\x1aINCOME_NARRATIVE_PRINCIPAL\x10\x04\x12!\n\x1dINCOME_NARRATIVE_DISTRIBUTION\x10\x05\x12(\n$INCOME_NARRATIVE_PROFIT_DISTRIBUTION\x10\x06\x42y\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.reporting.account_report.v1.income_entry_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1'
+  _globals['_INCOMENARRATIVE']._serialized_start=593
+  _globals['_INCOMENARRATIVE']._serialized_end=843
+  _globals['_INCOMEENTRY']._serialized_start=196
+  _globals['_INCOMEENTRY']._serialized_end=590
+# @@protoc_insertion_point(module_scope)

meshtrade/reporting/{income_report/v1/entry_pb2.pyi → account_report/v1/income_entry_pb2.pyi}

@@ -11,16 +11,24 @@ from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
 
 DESCRIPTOR: _descriptor.FileDescriptor
 
-class Narrative(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+class IncomeNarrative(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     __slots__ = ()
-    NARRATIVE_UNSPECIFIED: _ClassVar[Narrative]
-    NARRATIVE_YIELD: _ClassVar[Narrative]
-    NARRATIVE_COUPON: _ClassVar[Narrative]
-NARRATIVE_UNSPECIFIED: Narrative
-NARRATIVE_YIELD: Narrative
-NARRATIVE_COUPON: Narrative
+    INCOME_NARRATIVE_UNSPECIFIED: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_YIELD: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_DIVIDEND: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_INTEREST: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_PRINCIPAL: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_DISTRIBUTION: _ClassVar[IncomeNarrative]
+    INCOME_NARRATIVE_PROFIT_DISTRIBUTION: _ClassVar[IncomeNarrative]
+INCOME_NARRATIVE_UNSPECIFIED: IncomeNarrative
+INCOME_NARRATIVE_YIELD: IncomeNarrative
+INCOME_NARRATIVE_DIVIDEND: IncomeNarrative
+INCOME_NARRATIVE_INTEREST: IncomeNarrative
+INCOME_NARRATIVE_PRINCIPAL: IncomeNarrative
+INCOME_NARRATIVE_DISTRIBUTION: IncomeNarrative
+INCOME_NARRATIVE_PROFIT_DISTRIBUTION: IncomeNarrative
 
-class Entry(_message.Message):
+class IncomeEntry(_message.Message):
     __slots__ = ("asset_name", "token", "date", "description", "narrative", "amount", "reported_currency_value")
     ASSET_NAME_FIELD_NUMBER: _ClassVar[int]
     TOKEN_FIELD_NUMBER: _ClassVar[int]
@@ -33,7 +41,7 @@ class Entry(_message.Message):
     token: _token_pb2.Token
     date: _timestamp_pb2.Timestamp
     description: str
-    narrative: Narrative
+    narrative: IncomeNarrative
     amount: _amount_pb2.Amount
     reported_currency_value: _amount_pb2.Amount
-    def __init__(self, asset_name: _Optional[str] = ..., token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ..., date: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., description: _Optional[str] = ..., narrative: _Optional[_Union[Narrative, str]] = ..., amount: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ..., reported_currency_value: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ...) -> None: ...
+    def __init__(self, asset_name: _Optional[str] = ..., token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ..., date: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., description: _Optional[str] = ..., narrative: _Optional[_Union[IncomeNarrative, str]] = ..., amount: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ..., reported_currency_value: _Optional[_Union[_amount_pb2.Amount, _Mapping]] = ...) -> None: ...

meshtrade/reporting/account_report/v1/income_entry_pb2_grpc.py

@@ -0,0 +1,4 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+

meshtrade/reporting/{income_report → account_report}/v1/service_meshpy.py

@@ -1,45 +1,46 @@
 # Code generated by protoc-gen-meshpy. DO NOT EDIT.
-# source: meshtrade/reporting/income_report/v1/service.proto
+# source: meshtrade/reporting/account_report/v1/service.proto
 
 """
-IncomeReportService gRPC service wrapper with authentication, timeouts, and resource management.
+AccountReportService gRPC service wrapper with authentication, timeouts, and resource management.
 
-This module provides a high-level gRPC service for the IncomeReportService service that combines
+This module provides a high-level gRPC service for the AccountReportService 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 .service_options_meshpy import ServiceOptions
+from .account_report_pb2 import AccountReport
+from meshtrade.common.service_options import ServiceOptions
 from .service_pb2 import (
-GetExcelIncomeReportRequest,
-GetExcelIncomeReportResponse,
-GetIncomeReportRequest,
-IncomeReport,
+GetAccountReportRequest,
+GetExcelAccountReportRequest,
+GetExcelAccountReportResponse,
 )
-from .service_pb2_grpc import IncomeReportServiceStub
+from .service_pb2_grpc import AccountReportServiceStub
 
 
-def _create_incomereportservice_stub(channel):
-    """Factory function to create IncomeReportServiceStub from gRPC channel."""
-    return IncomeReportServiceStub(channel)
+def _create_accountreportservice_stub(channel):
+    """Factory function to create AccountReportServiceStub from gRPC channel."""
+    return AccountReportServiceStub(channel)
 
 
-class IncomeReportService(BaseGRPCClient):
-    """IncomeReportService gRPC service with authentication, timeouts, and resource management.
+class AccountReportService(BaseGRPCClient):
+    """AccountReportService gRPC service with authentication, timeouts, and resource management.
 
-    This service provides a complete implementation of the IncomeReportService with proper authentication, timeout handling, and automatic resource cleanup.
+    This service provides a complete implementation of the AccountReportService with proper authentication, timeout handling, and automatic resource cleanup.
 
-    Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/reporting/income_report/v1
+    Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/reporting/account_report/v1
 
     Basic service usage with default SDK Configuration:
     ```python
-    service = IncomeReportService()
+    service = AccountReportService()
 
     with service:   # `with` ensures proper clean up of underlying connection after use
         response = service.get_api_user(request)
@@ -70,7 +71,7 @@ class IncomeReportService(BaseGRPCClient):
         timeout=timedelta(seconds=60)
     )
 
-    service = IncomeReportService(options)
+    service = AccountReportService(options)
 
     with service: # `with` ensures proper clean up of underlying connection after use
         response = service.get_api_user(request)
@@ -80,9 +81,9 @@ class IncomeReportService(BaseGRPCClient):
     """
 
     def __init__(self, options: Optional[ServiceOptions] = None):
-        """Construct and initialize the IncomeReportService service.
+        """Construct and initialize the AccountReportService service.
 
-        Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/reporting/income_report/v1
+        Full Service documentation: https://meshtrade.github.io/api/docs/api-reference/reporting/account_report/v1
 
         Args:
             options: Optional ServiceOptions for configuring the service.
@@ -104,7 +105,7 @@ class IncomeReportService(BaseGRPCClient):
         Example:
         ```python
         # construct with default configuration
-        service = IncomeReportService()
+        service = AccountReportService()
 
         # construct with custom configuration
         options = ServiceOptions(
@@ -112,7 +113,7 @@ class IncomeReportService(BaseGRPCClient):
             api_key="your-key",
             group="groups/your-group"
         )
-        service = IncomeReportService(options)
+        service = AccountReportService(options)
         ```
         """
         if options is None:
@@ -120,8 +121,8 @@ class IncomeReportService(BaseGRPCClient):
 
         # Initialize the base client with all common functionality
         super().__init__(
-            service_name="IncomeReportService",
-            stub_factory=_create_incomereportservice_stub,
+            service_name="AccountReportService",
+            stub_factory=_create_accountreportservice_stub,
             find_credentials_func=find_credentials,
             url=options.url,
             port=options.port,
@@ -131,39 +132,39 @@ class IncomeReportService(BaseGRPCClient):
             tls=options.tls,
         )
 
-    def get_income_report(self, request: GetIncomeReportRequest, timeout: Optional[timedelta] = None) -> IncomeReport:
-        """GetIncomeReport method.
+    def get_account_report(self, request: GetAccountReportRequest, timeout: Optional[timedelta] = None) -> AccountReport:
+        """GetAccountReport method.
 
         Args:
-            request: The GetIncomeReport request message
+            request: The GetAccountReport request message
             timeout: Optional timeout override for this call
 
         Returns:
-            The GetIncomeReport response message
+            The GetAccountReport response message
 
         Raises:
             grpc.RpcError: If the gRPC call fails
             ValueError: If authentication credentials are missing
         """
-        return self._execute_method("GetIncomeReport", request, timeout)
+        return self._execute_method("GetAccountReport", request, timeout)
 
-    def get_excel_income_report(self, request: GetExcelIncomeReportRequest, timeout: Optional[timedelta] = None) -> GetExcelIncomeReportResponse:
-        """GetExcelIncomeReport method.
+    def get_excel_account_report(self, request: GetExcelAccountReportRequest, timeout: Optional[timedelta] = None) -> GetExcelAccountReportResponse:
+        """GetExcelAccountReport method.
 
         Args:
-            request: The GetExcelIncomeReport request message
+            request: The GetExcelAccountReport request message
             timeout: Optional timeout override for this call
 
         Returns:
-            The GetExcelIncomeReport response message
+            The GetExcelAccountReport response message
 
         Raises:
             grpc.RpcError: If the gRPC call fails
             ValueError: If authentication credentials are missing
         """
-        return self._execute_method("GetExcelIncomeReport", request, timeout)
+        return self._execute_method("GetExcelAccountReport", request, timeout)
 
 
 # Create aliases to match expected exports
-IncomeReportServiceGRPCClient = IncomeReportService
-IncomeReportServiceGRPCClientInterface = IncomeReportService
+AccountReportServiceGRPCClient = AccountReportService
+AccountReportServiceGRPCClientInterface = AccountReportService

meshtrade/reporting/account_report/v1/service_pb2.py

@@ -0,0 +1,72 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: meshtrade/reporting/account_report/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/reporting/account_report/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 google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as meshtrade_dot_option_dot_method__options_dot_v1_dot_method__options__pb2
+from meshtrade.reporting.account_report.v1 import account_report_pb2 as meshtrade_dot_reporting_dot_account__report_dot_v1_dot_account__report__pb2
+from meshtrade.type.v1 import token_pb2 as meshtrade_dot_type_dot_v1_dot_token__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n3meshtrade/reporting/account_report/v1/service.proto\x12%meshtrade.reporting.account_report.v1\x1a\x1b\x62uf/validate/validate.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x37meshtrade/option/method_options/v1/method_options.proto\x1a:meshtrade/reporting/account_report/v1/account_report.proto\x1a\x1dmeshtrade/type/v1/token.proto\"\xa7\x03\n\x17GetAccountReportRequest\x12\x39\n\x0e\x61\x63\x63ount_number\x18\x01 \x01(\tB\x12\xbaH\x0fr\r2\x0b^1[0-9]{6}$R\raccountNumber\x12\x45\n\x0cperiod_start\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\xbaH\x03\xc8\x01\x01R\x0bperiodStart\x12\x41\n\nperiod_end\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\xbaH\x03\xc8\x01\x01R\tperiodEnd\x12T\n\x15reporting_asset_token\x18\x04 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenB\x06\xbaH\x03\xc8\x01\x01R\x13reportingAssetToken:q\xbaHn\x1al\n\x18period.chronological.get\x12+period_end must be on or after period_start\x1a#this.period_end > this.period_start\"\xaf\x03\n\x1cGetExcelAccountReportRequest\x12\x39\n\x0e\x61\x63\x63ount_number\x18\x01 \x01(\tB\x12\xbaH\x0fr\r2\x0b^1[0-9]{6}$R\raccountNumber\x12\x45\n\x0cperiod_start\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\xbaH\x03\xc8\x01\x01R\x0bperiodStart\x12\x41\n\nperiod_end\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x06\xbaH\x03\xc8\x01\x01R\tperiodEnd\x12T\n\x15reporting_asset_token\x18\x04 \x01(\x0b\x32\x18.meshtrade.type.v1.TokenB\x06\xbaH\x03\xc8\x01\x01R\x13reportingAssetToken:t\xbaHq\x1ao\n\x1aperiod.chronological.excel\x12+period_end must be on or after period_start\x1a$this.period_end >= this.period_start\"B\n\x1dGetExcelAccountReportResponse\x12!\n\x0c\x65xcel_base64\x18\x01 \x01(\tR\x0b\x65xcelBase642\xee\x02\n\x14\x41\x63\x63ountReportService\x12\x9c\x01\n\x10GetAccountReport\x12>.meshtrade.reporting.account_report.v1.GetAccountReportRequest\x1a\x34.meshtrade.reporting.account_report.v1.AccountReport\"\x12\xb2\xb5\x18\x0e\x08\x01\x10\x02\x1a\x08\x80\x9b\xee\x02\x81\x9b\xee\x02\x12\xb6\x01\n\x15GetExcelAccountReport\x12\x43.meshtrade.reporting.account_report.v1.GetExcelAccountReportRequest\x1a\x44.meshtrade.reporting.account_report.v1.GetExcelAccountReportResponse\"\x12\xb2\xb5\x18\x0e\x08\x01\x10\x02\x1a\x08\x80\x9b\xee\x02\x81\x9b\xee\x02\x42y\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'meshtrade.reporting.account_report.v1.service_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n,co.meshtrade.api.reporting.account_report.v1ZIgithub.com/meshtrade/api/go/reporting/account_report/v1;account_report_v1'
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['account_number']._loaded_options = None
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['account_number']._serialized_options = b'\272H\017r\r2\013^1[0-9]{6}$'
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['period_start']._loaded_options = None
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['period_start']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['period_end']._loaded_options = None
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['period_end']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['reporting_asset_token']._loaded_options = None
+  _globals['_GETACCOUNTREPORTREQUEST'].fields_by_name['reporting_asset_token']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETACCOUNTREPORTREQUEST']._loaded_options = None
+  _globals['_GETACCOUNTREPORTREQUEST']._serialized_options = b'\272Hn\032l\n\030period.chronological.get\022+period_end must be on or after period_start\032#this.period_end > this.period_start'
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['account_number']._loaded_options = None
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['account_number']._serialized_options = b'\272H\017r\r2\013^1[0-9]{6}$'
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['period_start']._loaded_options = None
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['period_start']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['period_end']._loaded_options = None
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['period_end']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['reporting_asset_token']._loaded_options = None
+  _globals['_GETEXCELACCOUNTREPORTREQUEST'].fields_by_name['reporting_asset_token']._serialized_options = b'\272H\003\310\001\001'
+  _globals['_GETEXCELACCOUNTREPORTREQUEST']._loaded_options = None
+  _globals['_GETEXCELACCOUNTREPORTREQUEST']._serialized_options = b'\272Hq\032o\n\032period.chronological.excel\022+period_end must be on or after period_start\032$this.period_end >= this.period_start'
+  _globals['_ACCOUNTREPORTSERVICE'].methods_by_name['GetAccountReport']._loaded_options = None
+  _globals['_ACCOUNTREPORTSERVICE'].methods_by_name['GetAccountReport']._serialized_options = b'\262\265\030\016\010\001\020\002\032\010\200\233\356\002\201\233\356\002'
+  _globals['_ACCOUNTREPORTSERVICE'].methods_by_name['GetExcelAccountReport']._loaded_options = None
+  _globals['_ACCOUNTREPORTSERVICE'].methods_by_name['GetExcelAccountReport']._serialized_options = b'\262\265\030\016\010\001\020\002\032\010\200\233\356\002\201\233\356\002'
+  _globals['_GETACCOUNTREPORTREQUEST']._serialized_start=305
+  _globals['_GETACCOUNTREPORTREQUEST']._serialized_end=728
+  _globals['_GETEXCELACCOUNTREPORTREQUEST']._serialized_start=731
+  _globals['_GETEXCELACCOUNTREPORTREQUEST']._serialized_end=1162
+  _globals['_GETEXCELACCOUNTREPORTRESPONSE']._serialized_start=1164
+  _globals['_GETEXCELACCOUNTREPORTRESPONSE']._serialized_end=1230
+  _globals['_ACCOUNTREPORTSERVICE']._serialized_start=1233
+  _globals['_ACCOUNTREPORTSERVICE']._serialized_end=1599
+# @@protoc_insertion_point(module_scope)

meshtrade/reporting/account_report/v1/service_pb2.pyi

@@ -0,0 +1,43 @@
+import datetime
+
+from buf.validate import validate_pb2 as _validate_pb2
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from meshtrade.option.method_options.v1 import method_options_pb2 as _method_options_pb2
+from meshtrade.reporting.account_report.v1 import account_report_pb2 as _account_report_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 GetAccountReportRequest(_message.Message):
+    __slots__ = ("account_number", "period_start", "period_end", "reporting_asset_token")
+    ACCOUNT_NUMBER_FIELD_NUMBER: _ClassVar[int]
+    PERIOD_START_FIELD_NUMBER: _ClassVar[int]
+    PERIOD_END_FIELD_NUMBER: _ClassVar[int]
+    REPORTING_ASSET_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    account_number: str
+    period_start: _timestamp_pb2.Timestamp
+    period_end: _timestamp_pb2.Timestamp
+    reporting_asset_token: _token_pb2.Token
+    def __init__(self, account_number: _Optional[str] = ..., period_start: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., period_end: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., reporting_asset_token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ...) -> None: ...
+
+class GetExcelAccountReportRequest(_message.Message):
+    __slots__ = ("account_number", "period_start", "period_end", "reporting_asset_token")
+    ACCOUNT_NUMBER_FIELD_NUMBER: _ClassVar[int]
+    PERIOD_START_FIELD_NUMBER: _ClassVar[int]
+    PERIOD_END_FIELD_NUMBER: _ClassVar[int]
+    REPORTING_ASSET_TOKEN_FIELD_NUMBER: _ClassVar[int]
+    account_number: str
+    period_start: _timestamp_pb2.Timestamp
+    period_end: _timestamp_pb2.Timestamp
+    reporting_asset_token: _token_pb2.Token
+    def __init__(self, account_number: _Optional[str] = ..., period_start: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., period_end: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., reporting_asset_token: _Optional[_Union[_token_pb2.Token, _Mapping]] = ...) -> None: ...
+
+class GetExcelAccountReportResponse(_message.Message):
+    __slots__ = ("excel_base64",)
+    EXCEL_BASE64_FIELD_NUMBER: _ClassVar[int]
+    excel_base64: str
+    def __init__(self, excel_base64: _Optional[str] = ...) -> None: ...

meshtrade/reporting/account_report/v1/service_pb2_grpc.py

@@ -0,0 +1,161 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+
+from meshtrade.reporting.account_report.v1 import account_report_pb2 as meshtrade_dot_reporting_dot_account__report_dot_v1_dot_account__report__pb2
+from meshtrade.reporting.account_report.v1 import service_pb2 as meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2
+
+
+class AccountReportServiceStub(object):
+    """
+    The AccountReportService provides endpoints for generating and exporting
+    comprehensive account activity reports.
+
+    Clients can use this service to retrieve structured reports containing income,
+    fees, and trading statements for a specified account and time period. All
+    financial values within the reports are denominated in a user-specified
+    reporting currency.
+
+    Access to all service methods requires appropriate Reporting domain permissions.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.GetAccountReport = channel.unary_unary(
+                '/meshtrade.reporting.account_report.v1.AccountReportService/GetAccountReport',
+                request_serializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetAccountReportRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_account__report__pb2.AccountReport.FromString,
+                _registered_method=True)
+        self.GetExcelAccountReport = channel.unary_unary(
+                '/meshtrade.reporting.account_report.v1.AccountReportService/GetExcelAccountReport',
+                request_serializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportRequest.SerializeToString,
+                response_deserializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportResponse.FromString,
+                _registered_method=True)
+
+
+class AccountReportServiceServicer(object):
+    """
+    The AccountReportService provides endpoints for generating and exporting
+    comprehensive account activity reports.
+
+    Clients can use this service to retrieve structured reports containing income,
+    fees, and trading statements for a specified account and time period. All
+    financial values within the reports are denominated in a user-specified
+    reporting currency.
+
+    Access to all service methods requires appropriate Reporting domain permissions.
+    """
+
+    def GetAccountReport(self, request, context):
+        """
+        Retrieves a structured account report.
+
+        Generates a detailed report for the given account and time range, with all
+        values denominated in the specified reporting asset token.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetExcelAccountReport(self, request, context):
+        """
+        Exports an account report as a downloadable Excel file.
+
+        Generates the same report as GetAccountReport but returns it as a
+        base64-encoded string representing an Excel (.xlsx) file.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_AccountReportServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'GetAccountReport': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetAccountReport,
+                    request_deserializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetAccountReportRequest.FromString,
+                    response_serializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_account__report__pb2.AccountReport.SerializeToString,
+            ),
+            'GetExcelAccountReport': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetExcelAccountReport,
+                    request_deserializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportRequest.FromString,
+                    response_serializer=meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'meshtrade.reporting.account_report.v1.AccountReportService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('meshtrade.reporting.account_report.v1.AccountReportService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class AccountReportService(object):
+    """
+    The AccountReportService provides endpoints for generating and exporting
+    comprehensive account activity reports.
+
+    Clients can use this service to retrieve structured reports containing income,
+    fees, and trading statements for a specified account and time period. All
+    financial values within the reports are denominated in a user-specified
+    reporting currency.
+
+    Access to all service methods requires appropriate Reporting domain permissions.
+    """
+
+    @staticmethod
+    def GetAccountReport(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.reporting.account_report.v1.AccountReportService/GetAccountReport',
+            meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetAccountReportRequest.SerializeToString,
+            meshtrade_dot_reporting_dot_account__report_dot_v1_dot_account__report__pb2.AccountReport.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetExcelAccountReport(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.reporting.account_report.v1.AccountReportService/GetExcelAccountReport',
+            meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportRequest.SerializeToString,
+            meshtrade_dot_reporting_dot_account__report_dot_v1_dot_service__pb2.GetExcelAccountReportResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)