architect-py 3.2.2__py3-none-any.whl → 5.0.0b1__py3-none-any.whl

architect_py/{grpc_client → grpc/models}/Algo/AlgoOrderForTwapAlgo.py

@@ -25,7 +25,7 @@ class AlgoOrderForTwapAlgo(Struct, omit_defaults=True):
     last_error_time: Optional[datetime] = None
     parent_order_id: Optional[definitions.OrderId] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Algo/CreateAlgoOrderRequestForTwapAlgo.py

@@ -2,7 +2,7 @@
 #   filename:  Algo/CreateAlgoOrderRequestForTwapAlgo.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Algo.AlgoOrderForTwapAlgo import AlgoOrderForTwapAlgo
+from architect_py.grpc.models.Algo.AlgoOrderForTwapAlgo import AlgoOrderForTwapAlgo
 
 from typing import Optional
 
@@ -19,7 +19,7 @@ class CreateAlgoOrderRequestForTwapAlgo(Struct, omit_defaults=True):
     parent_order_id: Optional[definitions.OrderId] = None
     trader: Optional[definitions.UserId] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Algo/ModifyAlgoOrderRequestForTwapAlgo.py

@@ -2,7 +2,7 @@
 #   filename:  Algo/ModifyAlgoOrderRequestForTwapAlgo.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Algo.AlgoOrderForTwapAlgo import AlgoOrderForTwapAlgo
+from architect_py.grpc.models.Algo.AlgoOrderForTwapAlgo import AlgoOrderForTwapAlgo
 
 from msgspec import Struct
 
@@ -13,7 +13,7 @@ class ModifyAlgoOrderRequestForTwapAlgo(Struct, omit_defaults=True):
     algo_order_id: definitions.OrderId
     params: definitions.TwapParams
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Algo/__init__.py

@@ -1,2 +1,2 @@
 # generated by datamodel-codegen:
-#   filename:  processed_schemas
+#   filename:  schemas

architect_py/grpc/models/Auth/CreateJwtRequest.py

@@ -0,0 +1,47 @@
+# generated by datamodel-codegen:
+#   filename:  Auth/CreateJwtRequest.json
+
+from __future__ import annotations
+from architect_py.grpc.models.Auth.CreateJwtResponse import CreateJwtResponse
+
+from msgspec import Struct
+
+
+class CreateJwtRequest(Struct, omit_defaults=True):
+    """
+    Create a session JWT to use for authentication with upstream gRPC services.
+    """
+
+    api_key: str
+    api_secret: str
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+        api_key: str,
+        api_secret: str,
+    ):
+        return cls(
+            api_key,
+            api_secret,
+        )
+
+    def __str__(self) -> str:
+        return f"CreateJwtRequest(api_key={self.api_key},api_secret={self.api_secret})"
+
+    @staticmethod
+    def get_response_type():
+        return CreateJwtResponse
+
+    @staticmethod
+    def get_unannotated_response_type():
+        return CreateJwtResponse
+
+    @staticmethod
+    def get_route() -> str:
+        return "/json.architect.Auth/CreateJwt"
+
+    @staticmethod
+    def get_rpc_method():
+        return "unary"

architect_py/grpc/models/Auth/CreateJwtResponse.py

@@ -0,0 +1,23 @@
+# generated by datamodel-codegen:
+#   filename:  Auth/CreateJwtResponse.json
+
+from __future__ import annotations
+
+from msgspec import Struct
+
+
+class CreateJwtResponse(Struct, omit_defaults=True):
+    jwt: str
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+        jwt: str,
+    ):
+        return cls(
+            jwt,
+        )
+
+    def __str__(self) -> str:
+        return f"CreateJwtResponse(jwt={self.jwt})"

architect_py/{grpc_client/Cpty → grpc/models/Auth}/__init__.py

@@ -1,2 +1,2 @@
 # generated by datamodel-codegen:
-#   filename:  processed_schemas
+#   filename:  schemas

architect_py/grpc/models/Core/ConfigRequest.py

@@ -0,0 +1,37 @@
+# generated by datamodel-codegen:
+#   filename:  Core/ConfigRequest.json
+
+from __future__ import annotations
+from architect_py.grpc.models.Core.ConfigResponse import ConfigResponse
+
+from msgspec import Struct
+
+
+class ConfigRequest(Struct, omit_defaults=True):
+    pass
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+    ):
+        return cls()
+
+    def __str__(self) -> str:
+        return f"ConfigRequest()"
+
+    @staticmethod
+    def get_response_type():
+        return ConfigResponse
+
+    @staticmethod
+    def get_unannotated_response_type():
+        return ConfigResponse
+
+    @staticmethod
+    def get_route() -> str:
+        return "/json.architect.Core/Config"
+
+    @staticmethod
+    def get_rpc_method():
+        return "unary"

architect_py/grpc/models/Core/ConfigResponse.py

@@ -0,0 +1,25 @@
+# generated by datamodel-codegen:
+#   filename:  Core/ConfigResponse.json
+
+from __future__ import annotations
+
+from typing import Dict
+
+from msgspec import Struct
+
+
+class ConfigResponse(Struct, omit_defaults=True):
+    marketdata: Dict[str, str]
+
+    # Constructor that takes all field titles as arguments for convenience
+    @classmethod
+    def new(
+        cls,
+        marketdata: Dict[str, str],
+    ):
+        return cls(
+            marketdata,
+        )
+
+    def __str__(self) -> str:
+        return f"ConfigResponse(marketdata={self.marketdata})"

architect_py/{grpc_client/Folio → grpc/models/Core}/__init__.py

@@ -1,2 +1,2 @@
 # generated by datamodel-codegen:
-#   filename:  processed_schemas
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Cpty/CptyRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Cpty/CptyRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Cpty.CptyResponse import (
+from architect_py.grpc.models.Cpty.CptyResponse import (
     CptyResponse,
     Symbology,
     ReconcileOrder,
@@ -23,7 +23,7 @@ class CancelOrder(Struct, omit_defaults=True, tag_field="t", tag="cancel_order")
     cancel: Cancel
     original_order: Optional[Order] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Cpty/CptyResponse.py

@@ -20,7 +20,7 @@ class UpdateAccountSummary(Struct, omit_defaults=True, tag_field="t", tag="as"):
     positions: Optional[Dict[str, Any]] = None
     statistics: Optional[definitions.AccountStatistics] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
@@ -49,7 +49,7 @@ class UpdateAccountSummary(Struct, omit_defaults=True, tag_field="t", tag="as"):
 class Symbology(Struct, omit_defaults=True, tag_field="t", tag="xs"):
     execution_info: Dict[str, Dict[str, definitions.ExecutionInfo]]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
@@ -67,7 +67,7 @@ class ReconcileOpenOrders(Struct, omit_defaults=True, tag_field="t", tag="oo"):
     orders: List[Order]
     snapshot_for_account: Optional[definitions.AccountIdOrName] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Cpty/CptyStatus.py

@@ -24,7 +24,7 @@ class CptyStatus(Struct, omit_defaults=True):
     logged_in: bool
     instance: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Cpty/CptyStatusRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Cpty/CptyStatusRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Cpty.CptyStatus import CptyStatus
+from architect_py.grpc.models.Cpty.CptyStatus import CptyStatus
 
 from typing import Optional
 
@@ -13,7 +13,7 @@ class CptyStatusRequest(Struct, omit_defaults=True):
     kind: str
     instance: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Cpty/CptysRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Cpty/CptysRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Cpty.CptysResponse import CptysResponse
+from architect_py.grpc.models.Cpty.CptysResponse import CptysResponse
 
 from msgspec import Struct
 
@@ -10,7 +10,7 @@ from msgspec import Struct
 class CptysRequest(Struct, omit_defaults=True):
     pass
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Cpty/CptysResponse.py

@@ -13,7 +13,7 @@ from .CptyStatus import CptyStatus
 class CptysResponse(Struct, omit_defaults=True):
     cptys: List[CptyStatus]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/grpc/models/Cpty/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Folio/AccountHistoryRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountHistoryRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountHistoryResponse import AccountHistoryResponse
+from architect_py.grpc.models.Folio.AccountHistoryResponse import AccountHistoryResponse
 
 from datetime import datetime
 from typing import Optional
@@ -17,7 +17,7 @@ class AccountHistoryRequest(Struct, omit_defaults=True):
     from_inclusive: Optional[datetime] = None
     to_exclusive: Optional[datetime] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountHistoryResponse.py

@@ -13,7 +13,7 @@ from .AccountSummary import AccountSummary
 class AccountHistoryResponse(Struct, omit_defaults=True):
     history: List[AccountSummary]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummariesRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountSummariesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountSummariesResponse import (
+from architect_py.grpc.models.Folio.AccountSummariesResponse import (
     AccountSummariesResponse,
 )
 
@@ -27,7 +27,7 @@ class AccountSummariesRequest(Struct, omit_defaults=True):
     """
     trader: Optional[definitions.TraderIdOrEmail] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummariesResponse.py

@@ -13,7 +13,7 @@ from .AccountSummary import AccountSummary
 class AccountSummariesResponse(Struct, omit_defaults=True):
     account_summaries: List[AccountSummary]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummary.py

@@ -74,7 +74,7 @@ class AccountSummary(Struct, omit_defaults=True):
     Yesterday total account equity.
     """
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/AccountSummaryRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/AccountSummaryRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.AccountSummary import AccountSummary
+from architect_py.grpc.models.Folio.AccountSummary import AccountSummary
 
 from msgspec import Struct
 
@@ -12,7 +12,7 @@ from .. import definitions
 class AccountSummaryRequest(Struct, omit_defaults=True):
     account: definitions.AccountIdOrName
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalFillsRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/HistoricalFillsRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.HistoricalFillsResponse import (
+from architect_py.grpc.models.Folio.HistoricalFillsResponse import (
     HistoricalFillsResponse,
 )
 
@@ -18,7 +18,7 @@ class HistoricalFillsRequest(Struct, omit_defaults=True):
     account: Optional[definitions.AccountIdOrName] = None
     from_inclusive: Optional[datetime] = None
     limit: Optional[
-        Annotated[Optional[int], Meta(description="Default maximum is 1000.", ge=0)]
+        Annotated[Optional[int], Meta(description="Default maximum is 1000.")]
     ] = None
     """
     Default maximum is 1000.
@@ -28,7 +28,7 @@ class HistoricalFillsRequest(Struct, omit_defaults=True):
     trader: Optional[definitions.TraderIdOrEmail] = None
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalFillsResponse.py

@@ -14,7 +14,7 @@ class HistoricalFillsResponse(Struct, omit_defaults=True):
     aberrant_fills: List[definitions.AberrantFill]
     fills: List[definitions.Fill]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalOrdersRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Folio/HistoricalOrdersRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Folio.HistoricalOrdersResponse import (
+from architect_py.grpc.models.Folio.HistoricalOrdersResponse import (
     HistoricalOrdersResponse,
 )
 
@@ -18,7 +18,7 @@ class HistoricalOrdersRequest(Struct, omit_defaults=True):
     account: Optional[definitions.AccountIdOrName] = None
     from_inclusive: Optional[datetime] = None
     limit: Optional[
-        Annotated[Optional[int], Meta(description="Default maximum is 1000.", ge=0)]
+        Annotated[Optional[int], Meta(description="Default maximum is 1000.")]
     ] = None
     """
     Default maximum is 1000.
@@ -37,7 +37,7 @@ class HistoricalOrdersRequest(Struct, omit_defaults=True):
     trader: Optional[definitions.TraderIdOrEmail] = None
     venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Folio/HistoricalOrdersResponse.py

@@ -13,7 +13,7 @@ from ..Oms.Order import Order
 class HistoricalOrdersResponse(Struct, omit_defaults=True):
     orders: List[Order]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/grpc/models/Folio/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Health/HealthCheckRequest.py

@@ -2,7 +2,7 @@
 #   filename:  Health/HealthCheckRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Health.HealthCheckResponse import HealthCheckResponse
+from architect_py.grpc.models.Health.HealthCheckResponse import HealthCheckResponse
 
 from typing import Annotated, Optional
 
@@ -25,7 +25,7 @@ class HealthCheckRequest(Struct, omit_defaults=True):
     Generally, this will only be set when querying the API gateway.  It's not recommended to rely on internal subservice names being stable.
     """
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Health/HealthCheckResponse.py

@@ -14,7 +14,7 @@ class HealthCheckResponse(Struct, omit_defaults=True):
     status: definitions.HealthStatus
     metrics: Optional[Dict[str, Any]] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/grpc/models/Health/__init__.py

@@ -0,0 +1,2 @@
+# generated by datamodel-codegen:
+#   filename:  schemas

architect_py/{grpc_client → grpc/models}/Marketdata/Candle.py

@@ -37,7 +37,7 @@ class Candle(Struct, omit_defaults=True):
     mo: Optional[Annotated[Optional[Decimal], Meta(title="mid_open")]] = None
     o: Optional[Annotated[Optional[Decimal], Meta(title="open")]] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/HistoricalCandlesRequest.py

@@ -2,11 +2,11 @@
 #   filename:  Marketdata/HistoricalCandlesRequest.json
 
 from __future__ import annotations
-from architect_py.grpc_client.Marketdata.HistoricalCandlesResponse import (
+from architect_py.grpc.models.Marketdata.HistoricalCandlesResponse import (
     HistoricalCandlesResponse,
 )
 
-from datetime import datetime
+from typing import Optional
 
 from msgspec import Struct
 
@@ -15,28 +15,31 @@ from .. import definitions
 
 class HistoricalCandlesRequest(Struct, omit_defaults=True):
     candle_width: definitions.CandleWidth
-    end_date: datetime
-    start_date: datetime
+    end_date: definitions.DateTimeOrUtc
+    start_date: definitions.DateTimeOrUtc
     symbol: str
+    venue: Optional[str] = None
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
         candle_width: definitions.CandleWidth,
-        end_date: datetime,
-        start_date: datetime,
+        end_date: definitions.DateTimeOrUtc,
+        start_date: definitions.DateTimeOrUtc,
         symbol: str,
+        venue: Optional[str] = None,
     ):
         return cls(
             candle_width,
             end_date,
             start_date,
             symbol,
+            venue,
         )
 
     def __str__(self) -> str:
-        return f"HistoricalCandlesRequest(candle_width={self.candle_width},end_date={self.end_date},start_date={self.start_date},symbol={self.symbol})"
+        return f"HistoricalCandlesRequest(candle_width={self.candle_width},end_date={self.end_date},start_date={self.start_date},symbol={self.symbol},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

architect_py/{grpc_client → grpc/models}/Marketdata/HistoricalCandlesResponse.py

@@ -13,7 +13,7 @@ from .Candle import Candle
 class HistoricalCandlesResponse(Struct, omit_defaults=True):
     candles: List[Candle]
 
-    # below is a constructor that takes all field titles as arguments for convenience
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,

architect_py/{grpc_client → grpc/models}/Marketdata/L1BookSnapshot.py

@@ -16,8 +16,21 @@ class L1BookSnapshot(Struct, omit_defaults=True):
     ts: Annotated[int, Meta(title="timestamp")]
     a: Optional[Annotated[List[Decimal], Meta(title="best_ask")]] = None
     b: Optional[Annotated[List[Decimal], Meta(title="best_bid")]] = None
-
-    # below is a constructor that takes all field titles as arguments for convenience
+    rt: Optional[
+        Annotated[
+            Optional[int],
+            Meta(
+                description="Time that Architect feed received the message; only set if streaming from direct L1 feeds",
+                title="recv_time",
+            ),
+        ]
+    ] = None
+    """
+    Time that Architect feed received the message; only set if streaming from direct L1 feeds
+    """
+    rtn: Optional[Annotated[Optional[int], Meta(title="recv_time_ns")]] = None
+
+    # Constructor that takes all field titles as arguments for convenience
     @classmethod
     def new(
         cls,
@@ -26,6 +39,8 @@ class L1BookSnapshot(Struct, omit_defaults=True):
         timestamp: int,
         best_ask: Optional[List[Decimal]] = None,
         best_bid: Optional[List[Decimal]] = None,
+        recv_time: Optional[int] = None,
+        recv_time_ns: Optional[int] = None,
     ):
         return cls(
             symbol,
@@ -33,10 +48,12 @@ class L1BookSnapshot(Struct, omit_defaults=True):
             timestamp,
             best_ask,
             best_bid,
+            recv_time,
+            recv_time_ns,
         )
 
     def __str__(self) -> str:
-        return f"L1BookSnapshot(symbol={self.s},timestamp_ns={self.tn},timestamp={self.ts},best_ask={self.a},best_bid={self.b})"
+        return f"L1BookSnapshot(symbol={self.s},timestamp_ns={self.tn},timestamp={self.ts},best_ask={self.a},best_bid={self.b},recv_time={self.rt},recv_time_ns={self.rtn})"
 
     @property
     def symbol(self) -> str:
@@ -85,3 +102,19 @@ class L1BookSnapshot(Struct, omit_defaults=True):
     @best_bid.setter
     def best_bid(self, value: Optional[List[Decimal]]) -> None:
         self.b = value
+
+    @property
+    def recv_time(self) -> Optional[int]:
+        return self.rt
+
+    @recv_time.setter
+    def recv_time(self, value: Optional[int]) -> None:
+        self.rt = value
+
+    @property
+    def recv_time_ns(self) -> Optional[int]:
+        return self.rtn
+
+    @recv_time_ns.setter
+    def recv_time_ns(self, value: Optional[int]) -> None:
+        self.rtn = value