feat(headless): connect with delegated client shard

packages/waypoint/headless/client/headless-client.ts

@@ -12,9 +12,12 @@ export type CreateHeadlessClientOpts = {
 export type BaseParams = {
   waypointToken: string
 }
-export type ConnectParam = BaseParams & {
+export type ConnectParams = BaseParams & {
   recoveryPassword: string
 }
+export type ConnectWithShardParams = BaseParams & {
+  clientShard: string
+}
 export type ReconnectParams = BaseParams
 export type ValidateSponsorTxParams = BaseParams & {
   txRequest: TransactionParams
@@ -52,7 +55,7 @@ export class HeadlessClient {
     return this.baseClient.getProvider()
   }
 
-  connect = async (params: ConnectParam) => {
+  connect = async (params: ConnectParams) => {
     const { recoveryPassword, waypointToken } = params
     const { baseClient, storage } = this
 
@@ -71,6 +74,24 @@ export class HeadlessClient {
     }
   }
 
+  connectWithShard = async (params: ConnectWithShardParams) => {
+    const { clientShard, waypointToken } = params
+    const { baseClient, storage } = this
+
+    baseClient.setWaypointToken(waypointToken)
+    baseClient.setClientShard(clientShard)
+
+    const address = await baseClient.getAddressFromClientShard()
+    const provider = await baseClient.getProvider()
+
+    storage.set(clientShard)
+
+    return {
+      address,
+      provider,
+    }
+  }
+
   reconnect = async (params: ReconnectParams) => {
     const { waypointToken } = params
     const { baseClient, storage } = this

packages/waypoint/headless/index.ts

@@ -3,7 +3,8 @@
 // simple client
 export {
   HeadlessClient,
-  type ConnectParam,
+  type ConnectParams,
+  type ConnectWithShardParams,
   type CreateHeadlessClientOpts,
   type ReconnectParams,
   type ValidateSponsorTxParams,