thirdweb 5.30.0-nightly-33777df88fb190c2af8ad25e4930040884996f1e-20240620000630 → 5.30.0-nightly-d320777eea5404f596aa39b2b49b5165d3e1959a-20240621000551

package/src/wallets/in-app/web/ecosystem.ts

@@ -0,0 +1,65 @@
+import type { ThirdwebClient } from "../../../client/client.js";
+import type { Wallet } from "../../interfaces/wallet.js";
+import type {
+  CreateWalletArgs,
+  EcosystemWalletId,
+} from "../../wallet-types.js";
+import { createEcosystemWallet } from "../core/wallet/ecosystem-core.js";
+
+/**
+ * Creates an ecosystem wallet.
+ * @param createOptions - configuration options
+ * @returns The created ecosystem wallet.
+ * @example
+ * ```ts
+ * import { ecosystemWallet } from "thirdweb/wallets";
+ *
+ * const wallet = ecosystemWallet("ecosystem.hooli");
+ *
+ * const account = await wallet.connect({
+ *   client,
+ *   chain,
+ *   strategy: "google",
+ * });
+ * ```
+ *
+ * Enable smart accounts and sponsor gas for your users:
+ * ```ts
+ * import { ecosystemWallet } from "thirdweb/wallets";
+ * const wallet = ecosystemWallet("ecosystem.hooli", {
+ *  smartAccount: {
+ *   chain: sepolia,
+ *   sponsorGas: true,
+ * },
+ * });
+ * ```
+ *
+ * Connect to a restricted ecosystem wallet with your designated integrator ID
+ * @note The integrator ID will be provided to you by the ecosystem with which you're integrating.
+ * ```ts
+ * import { ecosystemWallet } from "thirdweb/wallets";
+ * const wallet = ecosystemWallet("ecosystem.hooli", {
+ *  integratorId: "..."
+ * });
+ * ```
+ * @wallet
+ */
+export function ecosystemWallet(
+  ...args: CreateWalletArgs<EcosystemWalletId>
+): Wallet<EcosystemWalletId> {
+  const [ecosystemId, createOptions] = args;
+  return createEcosystemWallet({
+    id: ecosystemId,
+    createOptions,
+    connectorFactory: async (client: ThirdwebClient) => {
+      const { InAppWebConnector } = await import("./lib/web-connector.js");
+      return new InAppWebConnector({
+        client,
+        ecosystem: {
+          id: ecosystemId,
+          partnerId: createOptions?.partnerId,
+        },
+      });
+    },
+  });
+}

package/src/wallets/in-app/web/lib/auth/abstract-login.ts

@@ -5,7 +5,7 @@ import type {
   AuthProvider,
   SendEmailOtpReturnType,
 } from "../../../core/authentication/type.js";
-import type { ClientIdWithQuerierType } from "../../types.js";
+import type { ClientIdWithQuerierType, Ecosystem } from "../../types.js";
 import type { InAppWalletIframeCommunicator } from "../../utils/iFrameCommunication/InAppWalletIframeCommunicator.js";
 
 export type LoginQuerierTypes = {
@@ -52,9 +52,10 @@ export abstract class AbstractLogin<
   ) => Promise<AuthLoginReturnType>;
   protected client: ThirdwebClient;
   protected baseUrl: string;
+  protected ecosystem?: Ecosystem;
+
   /**
    * Used to manage the user's auth states. This should not be instantiated directly.
-   * Call {@link InAppWalletSDK.auth} instead.
    * @internal
    */
   constructor({
@@ -63,18 +64,21 @@ export abstract class AbstractLogin<
     preLogin,
     postLogin,
     client,
+    ecosystem,
   }: ClientIdWithQuerierType & {
     baseUrl: string;
     preLogin: () => Promise<void>;
     postLogin: (
       authDetails: AuthAndWalletRpcReturnType,
     ) => Promise<AuthLoginReturnType>;
+    ecosystem?: Ecosystem;
   }) {
     this.baseUrl = baseUrl;
     this.LoginQuerier = querier;
     this.preLogin = preLogin;
     this.postLogin = postLogin;
     this.client = client;
+    this.ecosystem = ecosystem;
   }
 
   abstract loginWithCustomJwt(args: {

package/src/wallets/in-app/web/lib/auth/base-login.ts

@@ -17,13 +17,17 @@ export class BaseLogin extends AbstractLogin<
   private async getOauthLoginUrl(
     authProvider: AuthProvider,
   ): Promise<GetHeadlessLoginLinkReturnType> {
-    const result = await this.LoginQuerier.call<GetHeadlessLoginLinkReturnType>(
-      {
-        procedureName: "getHeadlessOauthLoginLink",
-        params: { authProvider },
-      },
-    );
-    return result;
+    try {
+      const result =
+        await this.LoginQuerier.call<GetHeadlessLoginLinkReturnType>({
+          procedureName: "getHeadlessOauthLoginLink",
+          params: { authProvider },
+        });
+      return result;
+    } catch (e) {
+      console.error(e);
+      throw e;
+    }
   }
 
   /**
@@ -174,6 +178,8 @@ export class BaseLogin extends AbstractLogin<
                   eventType: "injectDeveloperClientIdResult",
                   developerClientId: this.client.clientId,
                   authOption: args.oauthProvider,
+                  partnerId: this.ecosystem?.partnerId,
+                  ecosystemId: this.ecosystem?.id,
                 },
                 this.baseUrl,
               );

package/src/wallets/in-app/web/lib/auth/iframe-auth.ts

@@ -6,7 +6,7 @@ import type {
   LogoutReturnType,
   SendEmailOtpReturnType,
 } from "../../../core/authentication/type.js";
-import type { ClientIdWithQuerierType } from "../../types.js";
+import type { ClientIdWithQuerierType, Ecosystem } from "../../types.js";
 import { LocalStorage } from "../../utils/Storage/LocalStorage.js";
 import type { InAppWalletIframeCommunicator } from "../../utils/iFrameCommunication/InAppWalletIframeCommunicator.js";
 import { BaseLogin } from "./base-login.js";
@@ -14,6 +14,8 @@ import { BaseLogin } from "./base-login.js";
 export type AuthQuerierTypes = {
   logout: undefined;
   initIframe: {
+    partnerId?: string;
+    ecosystemId?: string;
     clientId: string;
     authCookie: string;
     walletUserId: string;
@@ -39,16 +41,17 @@ export class Auth {
 
   /**
    * Used to manage the user's auth states. This should not be instantiated directly.
-   * Call {@link InAppWalletSdk.auth} instead.
    * @internal
    */
   constructor({
     client,
     querier,
     onAuthSuccess,
+    ecosystem,
     baseUrl,
   }: ClientIdWithQuerierType & {
     baseUrl: string;
+    ecosystem?: Ecosystem;
     onAuthSuccess: (
       authDetails: AuthAndWalletRpcReturnType,
     ) => Promise<AuthLoginReturnType>;
@@ -56,7 +59,10 @@ export class Auth {
     this.client = client;
 
     this.AuthQuerier = querier;
-    this.localStorage = new LocalStorage({ clientId: client.clientId });
+    this.localStorage = new LocalStorage({
+      clientId: client.clientId,
+      ecosystemId: ecosystem?.id,
+    });
     this.onAuthSuccess = onAuthSuccess;
     this.BaseLogin = new BaseLogin({
       postLogin: async (result) => {
@@ -65,6 +71,7 @@ export class Auth {
       preLogin: async () => {
         await this.preLogin();
       },
+      ecosystem,
       querier: querier,
       client,
       baseUrl,

package/src/wallets/in-app/web/lib/auth/index.ts

@@ -7,6 +7,7 @@ import {
   UserWalletStatus,
 } from "../../../core/authentication/type.js";
 import { getOrCreateInAppWalletConnector } from "../../../core/wallet/in-app-core.js";
+import type { Ecosystem } from "../../types.js";
 
 // ---- KEEP IN SYNC WITH /wallets/in-app/native/auth/index.ts ---- //
 // duplication needed for separate exports between web and native
@@ -14,13 +15,21 @@ import { getOrCreateInAppWalletConnector } from "../../../core/wallet/in-app-cor
 /**
  * @internal
  */
-async function getInAppWalletConnector(client: ThirdwebClient) {
-  return getOrCreateInAppWalletConnector(client, async (client) => {
-    const { InAppWebConnector } = await import("../web-connector.js");
-    return new InAppWebConnector({
-      client: client,
-    });
-  });
+async function getInAppWalletConnector(
+  client: ThirdwebClient,
+  ecosystem?: Ecosystem,
+) {
+  return getOrCreateInAppWalletConnector(
+    client,
+    async (client) => {
+      const { InAppWebConnector } = await import("../web-connector.js");
+      return new InAppWebConnector({
+        client: client,
+        ecosystem: ecosystem,
+      });
+    },
+    ecosystem,
+  );
 }
 
 /**
@@ -112,7 +121,7 @@ export async function getUserPhoneNumber(options: GetAuthenticatedUserParams) {
  * @wallet
  */
 export async function preAuthenticate(args: PreAuthArgsType) {
-  const connector = await getInAppWalletConnector(args.client);
+  const connector = await getInAppWalletConnector(args.client, args.ecosystem);
   return connector.preAuthenticate(args);
 }
 
@@ -136,6 +145,6 @@ export async function preAuthenticate(args: PreAuthArgsType) {
 export async function authenticate(
   args: AuthArgsType,
 ): Promise<AuthLoginReturnType> {
-  const connector = await getInAppWalletConnector(args.client);
+  const connector = await getInAppWalletConnector(args.client, args.ecosystem);
   return connector.authenticate(args);
 }

package/src/wallets/in-app/web/lib/auth/passkeys.ts

@@ -3,7 +3,9 @@ import type { AuthType } from "@passwordless-id/webauthn/dist/esm/types.js";
 import type { ThirdwebClient } from "../../../../../client/client.js";
 import { getThirdwebBaseUrl } from "../../../../../utils/domains.js";
 import { getClientFetch } from "../../../../../utils/fetch.js";
+import type { EcosystemWalletId } from "../../../../wallet-types.js";
 import type { AuthStoredTokenWithCookieReturnType } from "../../../core/authentication/type.js";
+import type { Ecosystem } from "../../types.js";
 import { LocalStorage } from "../../utils/Storage/LocalStorage.js";
 
 function getVerificationPath() {
@@ -21,6 +23,7 @@ function getChallengePath(type: "sign-in" | "sign-up", username?: string) {
 
 export async function registerPasskey(options: {
   client: ThirdwebClient;
+  ecosystem?: Ecosystem;
   authenticatorType?: AuthType;
   username?: string;
 }): Promise<AuthStoredTokenWithCookieReturnType> {
@@ -28,9 +31,12 @@ export async function registerPasskey(options: {
     throw new Error("Passkeys are not available on this device");
   }
   // TODO inject this
-  const storage = new LocalStorage({ clientId: options.client.clientId });
-  const fetchWithId = getClientFetch(options.client);
-  const generatedName = options.username ?? generateUsername();
+  const storage = new LocalStorage({
+    clientId: options.client.clientId,
+    ecosystemId: options.ecosystem?.id,
+  });
+  const fetchWithId = getClientFetch(options.client, options.ecosystem);
+  const generatedName = options.username ?? generateUsername(options.ecosystem);
   // 1. request challenge from  server
   const res = await fetchWithId(getChallengePath("sign-up", generatedName));
   const challengeData = await res.json();
@@ -48,11 +54,20 @@ export async function registerPasskey(options: {
   // 3. store the credentialId in local storage
   await storage.savePasskeyCredentialId(registration.credential.id);
 
+  const customHeaders: Record<string, string> = {};
+  if (options.ecosystem?.partnerId) {
+    customHeaders["x-ecosystem-partner-id"] = options.ecosystem.partnerId;
+  }
+  if (options.ecosystem?.id) {
+    customHeaders["x-ecosystem-id"] = options.ecosystem.id;
+  }
+
   // 4. send the registration object to the server
   const verifRes = await fetchWithId(getVerificationPath(), {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
+      ...customHeaders,
     },
     body: JSON.stringify({
       type: "sign-up",
@@ -78,14 +93,18 @@ export async function registerPasskey(options: {
 
 export async function loginWithPasskey(options: {
   client: ThirdwebClient;
+  ecosystem?: Ecosystem;
   authenticatorType?: AuthType;
 }): Promise<AuthStoredTokenWithCookieReturnType> {
   if (!client.isAvailable()) {
     throw new Error("Passkeys are not available on this device");
   }
   // TODO inject this
-  const storage = new LocalStorage({ clientId: options.client.clientId });
-  const fetchWithId = getClientFetch(options.client);
+  const storage = new LocalStorage({
+    clientId: options.client.clientId,
+    ecosystemId: options.ecosystem?.id,
+  });
+  const fetchWithId = getClientFetch(options.client, options.ecosystem);
   // 1. request challenge from  server/iframe
   const res = await fetchWithId(getChallengePath("sign-in"));
   const challengeData = await res.json();
@@ -101,11 +120,21 @@ export async function loginWithPasskey(options: {
     authenticatorType: options.authenticatorType ?? "auto",
     userVerification: "required",
   });
+
+  const customHeaders: Record<string, string> = {};
+  if (options.ecosystem?.partnerId) {
+    customHeaders["x-ecosystem-partner-id"] = options.ecosystem.partnerId;
+  }
+  if (options.ecosystem?.id) {
+    customHeaders["x-ecosystem-id"] = options.ecosystem.id;
+  }
+
   // 3. send the authentication object to the server/iframe
   const verifRes = await fetchWithId(getVerificationPath(), {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
+      ...customHeaders,
     },
     body: JSON.stringify({
       type: "sign-in",
@@ -134,12 +163,18 @@ export async function loginWithPasskey(options: {
  * @returns whether the device has a stored passkey
  * @wallet
  */
-export async function hasStoredPasskey(client: ThirdwebClient) {
-  const storage = new LocalStorage({ clientId: client.clientId });
+export async function hasStoredPasskey(
+  client: ThirdwebClient,
+  ecosystemId?: EcosystemWalletId,
+) {
+  const storage = new LocalStorage({
+    clientId: client.clientId,
+    ecosystemId: ecosystemId,
+  });
   const credId = await storage.getPasskeyCredentialId();
   return !!credId;
 }
 
-function generateUsername() {
-  return `wallet-${new Date().toISOString()}`;
+function generateUsername(ecosystem?: Ecosystem) {
+  return `${ecosystem?.id ?? "wallet"}-${new Date().toISOString()}`;
 }

package/src/wallets/in-app/web/lib/in-app-account.ts

@@ -4,8 +4,11 @@ import { getCachedChain } from "../../../../chains/utils.js";
 import type { ThirdwebClient } from "../../../../client/client.js";
 import { eth_sendRawTransaction } from "../../../../rpc/actions/eth_sendRawTransaction.js";
 import { getRpcClient } from "../../../../rpc/rpc.js";
-import type { Hex } from "../../../../utils/encoding/hex.js";
+import { type Hex, hexToString } from "../../../../utils/encoding/hex.js";
 import { parseTypedData } from "../../../../utils/signatures/helpers/parseTypedData.js";
+import type { Prettify } from "../../../../utils/type-utils.js";
+import { uint8ArrayToString } from "../../../../utils/uint8-array.js";
+import { getEcosystemPartnerPermissions } from "../../../ecosystem/get-ecosystem-partner-permissions.js";
 import type {
   Account,
   SendTransactionOption,
@@ -19,6 +22,7 @@ import {
 } from "../../core/authentication/type.js";
 import type {
   ClientIdWithQuerierType,
+  Ecosystem,
   GetAddressReturnType,
   SignMessageReturnType,
   SignTransactionReturnType,
@@ -45,11 +49,13 @@ export type SignerProcedureTypes = {
     message: string | Hex;
     chainId: number;
     rpcEndpoint?: string;
+    partnerId?: string;
   };
   signTransaction: {
     transaction: ethers5.ethers.providers.TransactionRequest;
     chainId: number;
     rpcEndpoint?: string;
+    partnerId?: string;
   };
   signTypedDataV4: {
     domain: TypedDataDefinition["domain"];
@@ -57,6 +63,7 @@ export type SignerProcedureTypes = {
     message: TypedDataDefinition["message"];
     chainId: number;
     rpcEndpoint?: string;
+    partnerId?: string;
   };
   //connect: { provider: Provider };
 };
@@ -69,7 +76,8 @@ type PostWalletSetup = SetUpWalletRpcReturnType & {
  *
  */
 export class IFrameWallet {
-  protected client: ThirdwebClient;
+  public client: ThirdwebClient;
+  public ecosystem?: Ecosystem;
   protected walletManagerQuerier: InAppWalletIframeCommunicator<
     WalletManagementTypes & WalletManagementUiTypes
   >;
@@ -79,11 +87,23 @@ export class IFrameWallet {
    * Not meant to be initialized directly. Call {@link initializeUser} to get an instance
    * @internal
    */
-  constructor({ client, querier }: ClientIdWithQuerierType) {
+  constructor({
+    client,
+    ecosystem,
+    querier,
+  }: Prettify<
+    ClientIdWithQuerierType & {
+      ecosystem?: Ecosystem;
+    }
+  >) {
     this.client = client;
+    this.ecosystem = ecosystem;
     this.walletManagerQuerier = querier;
 
-    this.localStorage = new LocalStorage({ clientId: client.clientId });
+    this.localStorage = new LocalStorage({
+      clientId: client.clientId,
+      ecosystemId: ecosystem?.id,
+    });
   }
 
   /**
@@ -175,6 +195,17 @@ export class IFrameWallet {
   async getAccount(): Promise<Account> {
     const querier = this
       .walletManagerQuerier as unknown as InAppWalletIframeCommunicator<SignerProcedureTypes>;
+    const client = this.client;
+    const partnerId = this.ecosystem?.partnerId;
+    const isEcosystem = !!this.ecosystem;
+
+    const permissions = this.ecosystem
+      ? await getEcosystemPartnerPermissions(
+          this.ecosystem.id,
+          this.ecosystem?.partnerId,
+        )
+      : undefined;
+
     const { address } = await querier.call<GetAddressReturnType>({
       procedureName: "getAddress",
       params: undefined,
@@ -206,12 +237,16 @@ export class IFrameWallet {
           params: {
             transaction,
             chainId: tx.chainId,
+            partnerId,
             rpcEndpoint: `https://${tx.chainId}.rpc.thirdweb.com`, // TODO (ew) shouldnt be needed
           },
+          // Can hide the iframe if the partner has full control (no user approvals)
+          showIframe: permissions?.permissions.includes("FULL_CONTROL_V1")
+            ? false
+            : isEcosystem,
         });
       return signedTransaction as Hex;
     };
-    const client = this.client;
     return {
       address,
       async signTransaction(tx) {
@@ -238,15 +273,28 @@ export class IFrameWallet {
         };
       },
       async signMessage({ message }) {
-        const messageDecoded =
-          typeof message === "string" ? message : message.raw;
+        // in-app wallets use ethers to sign messages, which always expects a string (or bytes maybe but string is safest)
+        const messageDecoded = (() => {
+          if (typeof message === "string") {
+            return message;
+          }
+          if (message.raw instanceof Uint8Array) {
+            return uint8ArrayToString(message.raw);
+          }
+          return hexToString(message.raw);
+        })();
+
         const { signedMessage } = await querier.call<SignMessageReturnType>({
           procedureName: "signMessage",
           params: {
-            // biome-ignore lint/suspicious/noExplicitAny: TODO: fix later
-            message: messageDecoded as any, // wants Bytes or string
+            message: messageDecoded, // always a string
+            partnerId,
             chainId: 1, // TODO check if we need this
           },
+          // Can hide the iframe if the partner has full control (no user approvals)
+          showIframe: permissions?.permissions.includes("FULL_CONTROL_V1")
+            ? false
+            : isEcosystem,
         });
         return signedMessage as Hex;
       },
@@ -275,8 +323,13 @@ export class IFrameWallet {
               message:
                 parsedTypedData.message as SignerProcedureTypes["signTypedDataV4"]["message"],
               chainId,
+              partnerId,
               rpcEndpoint: `https://${chainId}.rpc.thirdweb.com`, // TODO (ew) shouldnt be needed
             },
+            // Can hide the iframe if the partner has full control (no user approvals)
+            showIframe: permissions?.permissions.includes("FULL_CONTROL_V1")
+              ? false
+              : isEcosystem,
           });
         return signedTypedData as Hex;
       },

package/src/wallets/in-app/web/lib/web-connector.ts

@@ -2,12 +2,13 @@ import type { ThirdwebClient } from "../../../../client/client.js";
 import { getThirdwebBaseUrl } from "../../../../utils/domains.js";
 import type { Account } from "../../../interfaces/wallet.js";
 import {
-  type AuthArgsType,
   type AuthLoginReturnType,
   type GetUser,
   type LogoutReturnType,
-  type PreAuthArgsType,
+  type MultiStepAuthArgsType,
+  type MultiStepAuthProviderType,
   type SendEmailOtpReturnType,
+  type SingleStepAuthArgsType,
   UserWalletStatus,
   oauthStrategyToAuthProvider,
 } from "../../core/authentication/type.js";
@@ -43,7 +44,11 @@ export class InAppWebConnector implements InAppConnector {
    * `const thirdwebInAppWallet = new InAppWalletSdk({ clientId: "", chain: "Goerli" });`
    * @internal
    */
-  constructor({ client, onAuthSuccess }: InAppWalletConstructorType) {
+  constructor({
+    client,
+    onAuthSuccess,
+    ecosystem,
+  }: InAppWalletConstructorType) {
     if (this.isClientIdLegacyPaper(client.clientId)) {
       throw new Error(
         "You are using a legacy clientId. Please use the clientId found on the thirdweb dashboard settings page",
@@ -53,10 +58,12 @@ export class InAppWebConnector implements InAppConnector {
     this.client = client;
     this.querier = new InAppWalletIframeCommunicator({
       clientId: client.clientId,
+      ecosystem,
       baseUrl,
     });
     this.wallet = new IFrameWallet({
       client,
+      ecosystem,
       querier: this.querier,
     });
 
@@ -64,6 +71,7 @@ export class InAppWebConnector implements InAppConnector {
       client,
       querier: this.querier,
       baseUrl,
+      ecosystem,
       onAuthSuccess: async (authResult) => {
         onAuthSuccess?.(authResult);
         await this.wallet.postWalletSetUp({
@@ -73,6 +81,8 @@ export class InAppWebConnector implements InAppConnector {
         await this.querier.call({
           procedureName: "initIframe",
           params: {
+            partnerId: ecosystem?.partnerId,
+            ecosystemId: ecosystem?.id,
             deviceShareStored: authResult.walletDetails.deviceShareStored,
             clientId: this.client.clientId,
             walletUserId: authResult.storedToken.authDetails.userWalletId,
@@ -123,7 +133,7 @@ export class InAppWebConnector implements InAppConnector {
   }
 
   async preAuthenticate(
-    args: PreAuthArgsType,
+    args: MultiStepAuthProviderType,
   ): Promise<SendEmailOtpReturnType> {
     const strategy = args.strategy;
     switch (strategy) {
@@ -136,12 +146,14 @@ export class InAppWebConnector implements InAppConnector {
       default:
         assertUnreachable(
           strategy,
-          `Provider: ${strategy} doesnt require pre-authentication`,
+          `Provider: ${strategy} doesn't require pre-authentication`,
         );
     }
   }
 
-  async authenticate(args: AuthArgsType): Promise<AuthLoginReturnType> {
+  async authenticate(
+    args: MultiStepAuthArgsType | SingleStepAuthArgsType,
+  ): Promise<AuthLoginReturnType> {
     const strategy = args.strategy;
     switch (strategy) {
       case "email": {
@@ -189,14 +201,16 @@ export class InAppWebConnector implements InAppConnector {
       case "passkey": {
         if (args.type === "sign-up") {
           const authToken = await registerPasskey({
-            client: args.client,
+            client: this.wallet.client,
+            ecosystem: this.wallet.ecosystem,
             authenticatorType: args.authenticatorType,
             username: args.passkeyName,
           });
           return this.auth.loginWithAuthToken(authToken);
         }
         const authToken = await loginWithPasskey({
-          client: args.client,
+          client: this.wallet.client,
+          ecosystem: this.wallet.ecosystem,
           authenticatorType: args.authenticatorType,
         });
         return this.auth.loginWithAuthToken(authToken);

package/src/wallets/in-app/web/types.ts

@@ -2,9 +2,25 @@
 // types for class constructors still a little messy right now.
 
 import type { ThirdwebClient } from "../../../client/client.js";
+import type { EcosystemWalletId } from "../../wallet-types.js";
 import type { AuthAndWalletRpcReturnType } from "../core/authentication/type.js";
 import type { InAppWalletIframeCommunicator } from "./utils/iFrameCommunication/InAppWalletIframeCommunicator.js";
 
+export type Ecosystem = {
+  id: EcosystemWalletId;
+  partnerId?: string;
+};
+
+export type EcosystemPermssions = {
+  allowlistedBundleIds: string[];
+  allowlistedDomains: string[];
+  createdAt: string;
+  id: string;
+  name: string;
+  permissions: ("PROMPT_USER_V1" | "FULL_CONTROL_V1")[];
+  updatedAt: string;
+};
+
 // Open to PRs from whoever sees this and knows of a cleaner way to handle things
 export type ClientIdConstructorType = {
   /**
@@ -18,6 +34,11 @@ export type InAppWalletConstructorType = ClientIdConstructorType & {
    * @returns
    */
   onAuthSuccess?: (authResult: AuthAndWalletRpcReturnType) => void;
+
+  /**
+   * @param ecosystem - An optional set of options to connect to an ecosystem wallet.
+   */
+  ecosystem?: Ecosystem;
 };
 
 export type ClientIdWithQuerierType = ClientIdConstructorType & {