architect-py 5.1.2__py3-none-any.whl → 5.1.3__py3-none-any.whl

architect_py/__init__.py

@@ -1,6 +1,6 @@
 # ruff: noqa:I001
 
-__version__ = "5.1.2"
+__version__ = "5.1.3"
 
 from .utils.nearest_tick import TickRoundMethod
 from .async_client import AsyncClient

architect_py/async_client.py

@@ -364,6 +364,15 @@ class AsyncClient:
             "as of v5.0.0: enable_orderflow is deprecated; orderflow is enabled by default"
         )
 
+    async def cpty_status(self, kind: str, instance: Optional[str] = None) -> CptyStatus:
+        """
+        Get cpty status.
+        """
+        grpc_client = await self.core()
+        req = CptyStatusRequest(kind=kind, instance=instance)
+        res: CptyStatus = await grpc_client.unary_unary(req)
+        return res
+
     # ------------------------------------------------------------
     # Symbology
     # ------------------------------------------------------------
@@ -1382,28 +1391,16 @@ class AsyncClient:
 
         Example:
             ```python
-            async for of in client.stream_orderflow(account, execution_venue, trader):
-                print(of)
+            async for event in client.stream_orderflow(account, execution_venue, trader):
+                print(event)
             ```
         """
         grpc_client = await self.core()
-        request: SubscribeOrderflowRequest = SubscribeOrderflowRequest(
+        req: SubscribeOrderflowRequest = SubscribeOrderflowRequest(
             account=account, execution_venue=execution_venue, trader=trader
         )
-        grpc_client = await self.core()
-        decoder = grpc_client.get_decoder(SubscribeOrderflowRequest)
-        stub: grpc.aio.UnaryStreamMultiCallable[
-            SubscribeOrderflowRequest, Orderflow
-        ] = grpc_client.channel.unary_stream(
-            SubscribeOrderflowRequest.get_route(),
-            request_serializer=grpc_client.encoder().encode,
-            response_deserializer=decoder.decode,
-        )
-        call: grpc.aio._base_call.UnaryStreamCall[
-            SubscribeOrderflowRequest, Orderflow
-        ] = stub(request, metadata=(("authorization", f"Bearer {grpc_client.jwt}"),))
-        async for update in call:
-            yield update
+        async for res in grpc_client.unary_stream(req):  # type: ignore
+            yield res
 
     # ------------------------------------------------------------
     # Order entry

architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py

@@ -10,6 +10,17 @@ from msgspec import Meta, Struct
 
 
 class SubscribeL1BookSnapshotsRequest(Struct, omit_defaults=True):
+    send_initial_snapshots: Optional[
+        Annotated[
+            bool,
+            Meta(
+                description="If true, send an initial snapshot to subscribers on symbol subscription"
+            ),
+        ]
+    ] = False
+    """
+    If true, send an initial snapshot to subscribers on symbol subscription
+    """
     symbols: Optional[
         Annotated[
             List[str],
@@ -25,16 +36,18 @@ class SubscribeL1BookSnapshotsRequest(Struct, omit_defaults=True):
     @classmethod
     def new(
         cls,
+        send_initial_snapshots: Optional[bool] = False,
         symbols: Optional[List[str]] = None,
         venue: Optional[str] = None,
     ):
         return cls(
+            send_initial_snapshots,
             symbols,
             venue,
         )
 
     def __str__(self) -> str:
-        return f"SubscribeL1BookSnapshotsRequest(symbols={self.symbols},venue={self.venue})"
+        return f"SubscribeL1BookSnapshotsRequest(send_initial_snapshots={self.send_initial_snapshots},symbols={self.symbols},venue={self.venue})"
 
     @staticmethod
     def get_response_type():

{architect_py-5.1.2.dist-info → architect_py-5.1.3.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: architect-py
-Version: 5.1.2
+Version: 5.1.3
 Summary: Python SDK for the Architect trading platform and brokerage.
 Author-email: "Architect Financial Technologies, Inc." <hello@architect.co>
 License-Expression: Apache-2.0
-Project-URL: Homepage, https://www.architect.co/brokerage/overview
 Project-URL: Documentation, https://docs.architect.co
+Project-URL: Homepage, https://www.architect.co/brokerage/overview
 Project-URL: Repository, https://github.com/architect-xyz/architect-py
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -48,7 +48,7 @@ Go to [FUNCTIONS.md](FUNCTIONS.md) file to see a catalog of methods.
 
 ## Examples
 
-Go to the [Examples](./examples) to see examples of a variety of common use cases.
+Go to the [Examples](./examples) to see examples of a variety of common use cases.  To run a specific example, use e.g. `python -m examples.orderflow_streaming`.
 
 ## Documentation 
 

{architect_py-5.1.2.dist-info → architect_py-5.1.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
-architect_py/__init__.py,sha256=0AUu9lue-XJfjKuCe_CgnQXdOlwhgBSwRLFc5yeU4LI,16121
-architect_py/async_client.py,sha256=0cpFvY36YquphGqD7z7hdWEb59OyuJiDYgrHzfykuC4,61646
+architect_py/__init__.py,sha256=IA3WJIRKMNE_PPf4JFDfvwwcgS0692icwFM1ckFL8Fk,16121
+architect_py/async_client.py,sha256=IdR1vtC4eGRXKBUZ7A5bxaX6jh5jXPSgcHxl22dZ5eQ,61394
 architect_py/client.py,sha256=yC0OVzz6uXUMdIIhqqR3GyVuBApYSm00AS51QM8xPak,4911
 architect_py/client.pyi,sha256=VJrg85KaupKzWY4BvS86xREs67S_TFrItNirczYLrgc,24565
 architect_py/common_types/__init__.py,sha256=fzOdIlKGWVN9V2Onc5z1v2bpvtZ4H9RSFA9ymJcBi3k,197
@@ -99,7 +99,7 @@ architect_py/grpc/models/Marketdata/MarketStatus.py,sha256=4Kt2z16t7dpjpiELWshJy
 architect_py/grpc/models/Marketdata/MarketStatusRequest.py,sha256=ajyI4UlvFusyM0743dukT4KFZTlp9iUh0lTGWl6n7nw,1056
 architect_py/grpc/models/Marketdata/SubscribeCandlesRequest.py,sha256=ck5pQx54uymlpR-jxFpxcW0LPDLU7R8GvqLqF-7GmoU,1508
 architect_py/grpc/models/Marketdata/SubscribeCurrentCandlesRequest.py,sha256=QuSNIXARFT--djk_Kl3SUWHfUwAfaasqzZ0cyZfzeN0,1930
-architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py,sha256=dMyz0aPYxNiOg3CjWPQxUu0kf4QznFfm-adl4EotWls,1384
+architect_py/grpc/models/Marketdata/SubscribeL1BookSnapshotsRequest.py,sha256=Pq8tqLBHLwGbcJwWqKvurvRT3ARXVktLYWhyQtIeHX0,1855
 architect_py/grpc/models/Marketdata/SubscribeL2BookUpdatesRequest.py,sha256=8olH2zWguzq1RnmIAZ59tFTmGIBLAYuGanbiI3kamm0,1133
 architect_py/grpc/models/Marketdata/SubscribeLiquidationsRequest.py,sha256=6BhC4FJvHxm4yq9l_TmEioegdu8ZMFaoEA-bRC8WY7A,1039
 architect_py/grpc/models/Marketdata/SubscribeManyCandlesRequest.py,sha256=pel2GGysDsJXjPY7rkyqqyGS3MPl13YezJS7apihiFc,1512
@@ -170,19 +170,22 @@ architect_py/utils/orderbook.py,sha256=JM02NhHbmK3sNaS2Ara8FBY4TvKvtMIzJW1oVd8KC
 architect_py/utils/pandas.py,sha256=QHz2ynj4T92FobuzRaNoH3ypArHoSDCiGtZ3PVXJ2vo,1017
 architect_py/utils/price_bands.py,sha256=j7ioSA3dx025CD5E2Vg7XQvmjPvxQb-gzQBfQTovpTw,21874
 architect_py/utils/symbol_parsing.py,sha256=OjJzk2c6QU2s0aJMSyVEzlWD5Vy-RlakJVW7jNHVDJk,845
-architect_py-5.1.2.dist-info/licenses/LICENSE,sha256=6P0_5gYN8iPWPZeqA9nxiO3tRQmcSA1ijAVR7C8j1SI,11362
+architect_py-5.1.3.dist-info/licenses/LICENSE,sha256=6P0_5gYN8iPWPZeqA9nxiO3tRQmcSA1ijAVR7C8j1SI,11362
 examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-examples/book_subscription.py,sha256=W7pldoHIPOclhxhxFvVmsBTB1wx1aS4OgAg0EFXeAzA,1461
-examples/candles.py,sha256=Vc1IgwgFPmpAtURdNXGhgdL82y_JNcryADE30r3vVY0,756
-examples/common.py,sha256=K2ppu4vdlTNsL1oX5RDrNKczljfPVOTPzDia1Abrppg,2987
+examples/book_subscription.py,sha256=1WFQN_QCE8cRS_CIv2k0NxqpK37fA9-Ja2Kfxs8vsb8,1461
+examples/candles.py,sha256=T71TsxbfXCT6mrJZmTgdTKesJFdQhYP_4AsiNK-8KyQ,756
+examples/config.py,sha256=rv6x7QYJO6ckvpRcwghyJbkL_lTBPnK0u6nKgkYTvxQ,1858
 examples/external_cpty.py,sha256=xxGXONXwoWIS8ys0SgxHLSmntAi1BlwV2NR9WD1kvpc,2527
-examples/funding_rate_mean_reversion_algo.py,sha256=3wy9SsQ5brYRRyzEAl6IV5g-MGFSfYInmHN0T50jzOg,6502
-examples/order_sending.py,sha256=1OV5YSmEVXqeuzLsUWmwnjsdsLFNUdnmwdmdwnKuIYI,3313
-examples/stream_l1_marketdata.py,sha256=6Hkfacbexmgj7n-zT7bIyGksghSl5asrDErtRcjAn2E,728
-examples/stream_l2_marketdata.py,sha256=ZeQlap7YeLg19IdAHnSc95IFFaQ7PgCY2S0MZY4RIvY,1091
-examples/trades.py,sha256=ikMvpLy_b5Y4_2URhkAgdOTzAEC-DAAKilUZenw_J_c,561
-examples/tutorial_async.py,sha256=paanYeCyydHVE_srO-lxj9tpmf4r535dhYaXUV95SN8,2646
-examples/tutorial_sync.py,sha256=G6jsxlpxnaewll4XCER6AYMCAK-1Z_A0Zef4D9CKGvw,2824
+examples/funding_rate_mean_reversion_algo.py,sha256=Y9zJ7N4TEm36TH3jIHMbDxucKOOlD2VHe5oNcLai11o,6502
+examples/order_sending.py,sha256=0M5eK20nDO5KXJZV-yidC7HR_RHP3uJL9f-q9FF0BIs,3313
+examples/orderflow_channel.py,sha256=L6W9aZS95Xmjl1IvrKA1Cp06r9-QOERsBETLOg3EImk,1891
+examples/orderflow_streaming.py,sha256=BtVwCYWBCpytaAFN9u2WPgGCugyNMsGa6nA1dPWuVLs,1300
+examples/stream_l1_marketdata.py,sha256=ZkXcm5XOpG6epPn3EhmqlVJyYBwh87I0QHtuOmKjRpg,728
+examples/stream_l2_marketdata.py,sha256=AeVOBBLdg-0OQE0gouHiLaUfGAAmUoVxif9XBrRo1tQ,1091
+examples/termutils.py,sha256=ZZrky5Ftn4UoLPKGffGvUl1Z8CtvDoNjEtUH4S1a_KY,1133
+examples/trades.py,sha256=0OzWQVTuIrC0KlisY0Tc-3pmWNP0m0-eCSntCV6Qdh8,561
+examples/tutorial_async.py,sha256=FNMjP2WmszRB0OXoMbshJ775LoPDzm55UZICa9ztr5w,2639
+examples/tutorial_sync.py,sha256=w5Sqa0YFh0XnpoXuhD3WsKRKpR5cuTTNb7pCp-Aqnz0,2846
 scripts/add_imports_to_inits.py,sha256=bryhz6RpKAJsSieVMnXnRyLp8evNkpOsNUkBUPkk1WQ,4518
 scripts/correct_sync_interface.py,sha256=O8qxSqNSNIL8KrgZ4C8rjs_pUCdcA1WeqKAggM2DINw,4056
 scripts/generate_functions_md.py,sha256=-rVRhbHlDodGH2a32UCsMLIpgXtDvOhBmkHa0RqDpCA,6232
@@ -191,7 +194,7 @@ scripts/preprocess_grpc_schema.py,sha256=p9LdoMZzixBSsVx7Dy3_8uJzOy_QwCoVMkAABQK
 scripts/prune_graphql_schema.py,sha256=hmfw5FD_iKGKMFkq6H1neZiXXtljFFrOwi2fiusTWE4,6210
 templates/exceptions.py,sha256=tIHbiO5Q114h9nPwJXsgHvW_bERLwxuNp9Oj41p6t3A,2379
 templates/juniper_base_client.py,sha256=B8QF4IFSwqBK5UY2aFPbSdYnX9bcwnlxLK4ojPRaW0E,12705
-architect_py-5.1.2.dist-info/METADATA,sha256=9Kut96FHWLTstvnSxNhaf5bvSCdI1JzzY4BettvbdBk,2559
-architect_py-5.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-architect_py-5.1.2.dist-info/top_level.txt,sha256=UjtO97OACFQ9z5MzS-X2wBlt5Ovk1vxakQPKfokI454,40
-architect_py-5.1.2.dist-info/RECORD,,
+architect_py-5.1.3.dist-info/METADATA,sha256=Ozka0r2vOt_iWe4muYQRt8dLA--nNXXUeQSQ1Oi2S14,2638
+architect_py-5.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+architect_py-5.1.3.dist-info/top_level.txt,sha256=UjtO97OACFQ9z5MzS-X2wBlt5Ovk1vxakQPKfokI454,40
+architect_py-5.1.3.dist-info/RECORD,,

examples/book_subscription.py

@@ -6,7 +6,7 @@ from pydantic import ValidationError
 from architect_py import AsyncClient, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 buy_columns = "{:>15} {:>15} {:>15}"
 sell_columns = "{:<15} {:<15} {:<15}"

examples/candles.py

@@ -3,7 +3,7 @@ import asyncio
 from architect_py import AsyncClient, CandleWidth, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/{common.py → config.py}

@@ -16,15 +16,17 @@ class Config:
 
 def load_config() -> Config:
     loaded = load_dotenv()
+
     if not loaded:
         raise ValueError(
-            "⚠️  .env file not found or had no new variables\n"
-            "Please create a .env file with the following variables:\n"
+            "⚠️  .env file not found or had no new variables\n\n"
+            "Please create a .env file with the following variables:\n\n"
             "ARCHITECT_ENDPOINT=your_endpoint (e.g. app.architect.co)\n"
             "ARCHITECT_API_KEY=your_api_key (get from https://app.architect.co/user/account)\n"
             "ARCHITECT_API_SECRET=your_api_secret\n"
             "ARCHITECT_PAPER_TRADING=true/false\n"
         )
+
     endpoint = os.environ["ARCHITECT_ENDPOINT"]
     api_key = os.getenv("ARCHITECT_API_KEY")
     api_secret = os.getenv("ARCHITECT_API_SECRET")
@@ -49,7 +51,6 @@ def load_config() -> Config:
 
 def connect_client():
     config = load_config()
-
     c = Client(
         endpoint=config.endpoint,
         api_key=config.api_key,
@@ -68,48 +69,3 @@ async def connect_async_client():
         paper_trading=config.paper_trading,
     )
     return c
-
-
-buy_columns = "{:>15} {:>15} {:>15}"
-sell_columns = "{:<15} {:<15} {:<15}"
-green = "\033[32m"
-red = "\033[31m"
-normal = "\033[0m"
-
-
-def print_book(book):
-    print(
-        (buy_columns + " " + sell_columns).format(
-            "Total", "Size", "Bid", "Ask", "Size", "Total"
-        )
-    )
-    for i in range(min(20, len(book.bids), len(book.asks))):
-        b = book.bids[i]
-        s = book.asks[i]
-        print(
-            (green + buy_columns).format(b.total, b.amount, b.price),
-            (red + sell_columns).format(s.price, s.amount, s.total),
-        )
-    print(normal)
-
-
-def print_open_orders(orders):
-    if len(orders) == 0:
-        print("No open orders")
-    else:
-        for o in orders:
-            print(
-                f"  • {o.order.market.name} {o.order.dir} {o.order.quantity} {o.order.order_type.limit_price}"
-            )
-
-
-def confirm(prompt: str):
-    """
-    Ask user to enter Y or N (case-insensitive).
-    :return: True if the answer is Y.
-    :rtype: bool
-    """
-    answer = ""
-    while answer not in ["y", "n"]:
-        answer = input(f"{prompt} [Y/N]? ").lower()
-    return answer == "y"

examples/funding_rate_mean_reversion_algo.py

@@ -24,7 +24,7 @@ from architect_py.grpc.models.Orderflow.OrderflowRequest import (
     PlaceOrder,
 )
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 venue = "BINANCE"
 product = "BTC-USDT Perpetual"

examples/order_sending.py

@@ -4,7 +4,7 @@ from datetime import datetime, timedelta, timezone
 from decimal import Decimal
 
 from architect_py import AsyncClient, OrderDir, OrderType, TimeInForce, TradableProduct
-from examples.common import connect_async_client
+from examples.config import connect_async_client
 
 LOGGER = logging.getLogger(__name__)
 

examples/orderflow_channel.py

@@ -0,0 +1,56 @@
+# """
+# Example of using a bidirectional orderflow channel with the Architect OEMS.
+
+# This connection style is ~equivalent to having a websocket.
+
+# This code example sends a series of orders to Architect while concurrently
+# listening to orderflow events.  Compare to `examples/orderflow_streaming.py`,
+# which accomplishes the same thing but using a separate asyncio task.
+# """
+
+# import asyncio
+# from decimal import Decimal
+
+# from architect_py import AsyncClient, OrderDir, PlaceOrderRequest
+# from architect_py.grpc.models.Orderflow.OrderflowRequest import PlaceOrder
+
+# from .config import connect_async_client
+
+
+# async def send_orders(client: AsyncClient):
+#     symbol = await client.get_front_future("ES CME Futures")
+#     print(f"symbol={symbol}")
+
+#     while True:
+#         await asyncio.sleep(1)
+#         snap = await client.get_l1_book_snapshot(symbol, "CME")
+#         if snap.best_ask is not None:
+#             limit_price = snap.best_ask[0]
+#             print(f"\nPlacing buy order at {limit_price}\n")
+#             try:
+#                 req = PlaceOrderRequest.new(
+#                     symbol=symbol,
+#                     execution_venue="CME",
+#                     dir=OrderDir.BUY,
+#                     quantity=Decimal(1),
+#                     limit_price=limit_price,
+#                     post_only=True,
+#                     time_in_force="DAY",
+#                     order_type="LIMIT",
+#                 )
+#                 print(f"req={req}")
+#                 yield PlaceOrder(req)
+#             except Exception as e:
+#                 print(f"Error placing order: {e}")
+#         else:
+#             print("\nNo ask price from snapshot, doing nothing\n")
+
+
+# async def main():
+#     client = await connect_async_client()
+
+#     async for event in client.orderflow(send_orders(client)):
+#         print(f" --> {event}")
+
+
+# asyncio.run(main())

examples/orderflow_streaming.py

@@ -0,0 +1,47 @@
+"""
+Example of streaming orderflow events from the Architect OEMS.
+
+This code example sends a series of orders to Architect in one asyncio
+task, while concurrently listening to orderflow events in another.
+"""
+
+import asyncio
+from decimal import Decimal
+
+from architect_py import AsyncClient, OrderDir
+
+from .config import connect_async_client
+
+
+async def send_orders(client: AsyncClient):
+    symbol = await client.get_front_future("ES CME Futures")
+    print(f"symbol={symbol}")
+
+    while True:
+        await asyncio.sleep(1)
+        snap = await client.get_l1_book_snapshot(symbol, "CME")
+        if snap.best_ask is not None:
+            limit_price = snap.best_ask[0]
+            print(f"\nPlacing buy order at {limit_price}\n")
+            await client.place_limit_order(
+                symbol=symbol,
+                execution_venue="CME",
+                dir=OrderDir.BUY,
+                quantity=Decimal(1),
+                limit_price=limit_price,
+                post_only=True,
+            )
+        else:
+            print("\nNo ask price from snapshot, doing nothing\n")
+
+
+async def main():
+    client = await connect_async_client()
+
+    asyncio.create_task(send_orders(client))
+
+    async for event in client.stream_orderflow():
+        print(f" --> {event}")
+
+
+asyncio.run(main())

examples/stream_l1_marketdata.py

@@ -2,7 +2,7 @@ import asyncio
 
 from architect_py import AsyncClient, TradableProduct
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/stream_l2_marketdata.py

@@ -2,7 +2,7 @@ import asyncio
 
 from architect_py import AsyncClient, TradableProduct
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 buy_columns = "{:>15} {:>15}"
 sell_columns = "{:<15} {:<15}"

examples/termutils.py

@@ -0,0 +1,44 @@
+buy_columns = "{:>15} {:>15} {:>15}"
+sell_columns = "{:<15} {:<15} {:<15}"
+green = "\033[32m"
+red = "\033[31m"
+normal = "\033[0m"
+
+
+def print_book(book):
+    print(
+        (buy_columns + " " + sell_columns).format(
+            "Total", "Size", "Bid", "Ask", "Size", "Total"
+        )
+    )
+    for i in range(min(20, len(book.bids), len(book.asks))):
+        b = book.bids[i]
+        s = book.asks[i]
+        print(
+            (green + buy_columns).format(b.total, b.amount, b.price),
+            (red + sell_columns).format(s.price, s.amount, s.total),
+        )
+    print(normal)
+
+
+def print_open_orders(orders):
+    if len(orders) == 0:
+        print("No open orders")
+    else:
+        for o in orders:
+            print(
+                f"  • {o.order.market.name} {o.order.dir} {o.order.quantity} {o.order.order_type.limit_price}"
+            )
+
+
+def confirm(prompt: str):
+    """
+    Ask user to enter Y or N (case-insensitive).
+
+    :return: True if the answer is Y.
+    :rtype: bool
+    """
+    answer = ""
+    while answer not in ["y", "n"]:
+        answer = input(f"{prompt} [Y/N]? ").lower()
+    return answer == "y"

examples/trades.py

@@ -3,7 +3,7 @@ import asyncio
 from architect_py import AsyncClient, TradableProduct
 from architect_py.graphql_client.exceptions import GraphQLClientHttpError
 
-from .common import connect_async_client
+from .config import connect_async_client
 
 
 async def main():

examples/tutorial_async.py

@@ -2,7 +2,8 @@ import asyncio
 from decimal import Decimal
 
 from architect_py import OrderDir, OrderStatus, TradableProduct
-from examples.common import connect_async_client
+
+from .config import connect_async_client
 
 
 async def main():

examples/tutorial_sync.py

@@ -5,7 +5,8 @@ from decimal import Decimal
 from architect_py import OrderDir, OrderStatus
 from architect_py.utils.nearest_tick import TickRoundMethod
 
-from .common import confirm, connect_client, print_book, print_open_orders
+from .config import connect_client
+from .termutils import confirm, print_book, print_open_orders
 
 c = connect_client()