Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs Revisions: In-app & ecosystem wallet FAQs page, Pay -> Univ Bridge, Wallets Get Started #6494

Merged
merged 8 commits into from
Mar 20, 2025
2 changes: 1 addition & 1 deletion apps/portal/src/app/connect/pay/get-started/page.mdx
Original file line number Diff line number Diff line change
@@ -46,7 +46,7 @@ Log in to [the thirdweb dashboard](https://thirdweb.com/team). Navigate to the *

## Option 1: ConnectButton

Pay is available by default with our `ConnectButton` component. When users log in with Connect, they'll be able to onramp and purchase crypto directly from the logged in Connect interface. You can read more about `ConnectButton` [in this guide](/connect/sign-in/ConnectButton).
Universal Bridge is available by default with our `ConnectButton` component. When users log in with Connect, they'll be able to onramp and purchase crypto directly from the logged in Connect interface. You can read more about `ConnectButton` [in this guide](/connect/sign-in/ConnectButton).

```tsx
import { ThirdwebProvider, ConnectButton } from "thirdweb/react";
2 changes: 1 addition & 1 deletion apps/portal/src/app/connect/pay/testing-pay/page.mdx
Original file line number Diff line number Diff line change
@@ -3,7 +3,7 @@ import { createMetadata, Callout } from "@doc";

export const metadata = createMetadata({
image: {
title: "thirdweb Pay - Test Mode",
title: "thirdweb Universal Bridge - Test Mode",
icon: "thirdweb",
},
title: "Enable Test Mode for Universal bridge — thirdweb docs",
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The capitalization of "Universal bridge" should be standardized to "Universal Bridge" to maintain consistent capitalization throughout the documentation. This inconsistency appears only in this title while other instances use the proper capitalization format.

Suggested change
title: "Enable Test Mode for Universal bridge — thirdweb docs",
title: "Enable Test Mode for Universal Bridge — thirdweb docs",

Spotted by Diamond

Is this helpful? React 👍 or 👎 to let us know.

8 changes: 8 additions & 0 deletions apps/portal/src/app/connect/sidebar.tsx
Original file line number Diff line number Diff line change
@@ -75,6 +75,10 @@ export const sidebar: SideBar = {
name: "Guest Mode",
href: `${walletSlug}/sign-in-methods/guest`,
},
{
name: "FAQ",
href: `${walletSlug}/in-app-wallet/faq`,
},
{
name: "Custom Authentication",
links: [
@@ -130,6 +134,10 @@ export const sidebar: SideBar = {
name: "Register with WalletConnect",
href: `${walletSlug}/ecosystem/register-walletconnect`,
},
{
name: "FAQ",
href: `${walletSlug}/ecosystem/faq`,
},
],
},
//Account abstraction
58 changes: 58 additions & 0 deletions apps/portal/src/app/connect/wallet/ecosystem/faq/page.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
import { createMetadata } from "@doc";

export const metadata = createMetadata({
title: "Ecosystem Wallet FAQs",
description: "Frequently asked questions about thirdweb's Ecosystem Wallet",
image: {
title: "FAQs for thirdweb Ecosystem Wallet",
icon: "wallets",
},
});

# Ecosystem Wallet FAQs

### What is an Ecosystem Wallet?

An ecosystem wallet is a managed in-app wallet service that allows platforms to create a branded wallet and login system, manage their partners, and allow any number of partners to spin up in-app wallets. End users that create in-app wallets through your partner applications (either with email, phone number, passkey, or socials) will receive **one account and wallet address** that they can access across the entire ecosystem.

### How do Ecosystem Wallets work?

Ecosystem Wallets are a fully managed and containerized in-app wallet backend service that is white labeled to your application. By giving you access to this backend service, you can power any application with in-app wallets just like thirdweb does for over 70,000 developers.

### What is an Ecosystem Partner?

Ecosystem partners are games or applications that you have permissioned to spin up in-app wallets underneath your brand. They will have access to the same account (funds, assets, etc.) for any end users that 1) use your branded login system or 2) log in with your wallet.

You can manage ecosystem partners in the Permissions tab of your Ecosystem Wallet dashboard.

### Which login providers can display my Ecosystem Wallet?

thirdweb Connect, with WalletConnect and any wagmi- or viem-based login providers coming soon.

### How can Partners integrate my Ecosystem Wallet?

Partners can integrate your Ecosystem Wallet in three different ways:

**Login System**

Partners can install thirdweb SDK and use the Partner ID you created for them to display your branded sign in flow. All login options in this sign in flow will create an in-app wallet.

**Branded Wallet Connector**

Partners can add your wallet as a wallet connector option in their existing sign in flow on any domains they've whitelisted by calling the follow endpoint from their application.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There appears to be a small typo in this sentence. "calling the follow endpoint" should be "calling the following endpoint" to maintain proper grammar.

Suggested change
Partners can add your wallet as a wallet connector option in their existing sign in flow on any domains they've whitelisted by calling the follow endpoint from their application.
Partners can add your wallet as a wallet connector option in their existing sign in flow on any domains they've whitelisted by calling the following endpoint from their application.

Spotted by Diamond

Is this helpful? React 👍 or 👎 to let us know.


**WalletConnect (Coming Soon)**

Partners using WalletConnect will automatically display your wallet as a WalletConnect option on any domains they've whitelisted.

### What is the difference between Anyone and Allowlist scopes for Ecosystem Wallet?

The **Anyone** scope allows any developer to integrate your ecosystem wallet, even if you have not given them permission. Any developer with thirdweb Connect, for example, would now display your wallet as a login option.

The **Allowlist** scope allows developers that you have explicitly added to your list of Partners to display your wallet as a login option.

You can manage scope in the Permissions tab of your Ecosystem Wallet dashboard.

### How does billing work for Ecosystem Wallets?

As the ecosystem admin, you will be billed $250 monthly for your Ecosystem Wallet. This allows any application or game in your ecosystem generate in-app wallets. Each month, we allow you and your ecosystem partners to generate 30,000 wallets for free. Once you've generated 30,000 wallets, you will be charged $0.02 per in-app wallet. At the end of each month, we will provide you with an invoice with a usage breakdown across all partners.
57 changes: 0 additions & 57 deletions apps/portal/src/app/connect/wallet/faq/page.mdx
Original file line number Diff line number Diff line change
@@ -57,63 +57,6 @@ Currently, users will rely on the built-in recovery of their auth method. Refer

Users can also link their account to a different auth method (e.g. email, phone, or social). All linked methods will be able to be used to access their accounts, providing an alternate recovery method in the case where one is lost.

# In App Wallet FAQs

### How do users connect to their in-app wallet in a third-party app?

Users can access it by doing a manual connection via wallet connect. They will then have to use the connect button or embed and select manage wallet -> connect an App.

### How is pricing calculated for in-app wallets?

In-app wallets are billed based on "monthly active wallets". An active wallet is defined as a wallet where a user logs in during the billing period. In-app wallets are completely free up to 1,000 monthly active wallets, and $0.02 per wallet after that.

# Ecosystem Wallet FAQs

### What is an Ecosystem Wallet?

An ecosystem wallet is a managed in-app wallet service that allows you to create a branded wallet and login system, manage your partners, and allow any number of partners to spin up in-app wallets. End users that create in-app wallets through your partner applications (either with email, phone number, passkey, or socials) will receive **one account and wallet address** that they can access across the entire ecosystem.

### How do Ecosystem Wallets work?

Ecosystem Wallets are a fully managed and containerized in-app wallet backend service that is white labeled to your application. By giving you access to this backend service, you can power any application with in-app wallets just like thirdweb does for over 70,000 developers.

### What is an Ecosystem Partner?

Ecosystem partners are games or applications that you have permissioned to spin up in-app wallets underneath your brand. They will have access to the same account (funds, assets, etc.) for any end users that 1) use your branded login system or 2) log in with your wallet.

You can manage ecosystem partners in the Permissions tab of your Ecosystem Wallet dashboard.

### Which login providers can display my Ecosystem Wallet?

thirdweb Connect, with WalletConnect and any wagmi- or viem-based login providers coming soon.

### How can Partners integrate my Ecosystem Wallet?

Partners can integrate your Ecosystem Wallet in three different ways:

**Login System**

Partners can install thirdweb SDK and use the Partner ID you created for them to display your branded sign in flow. All login options in this sign in flow will create an in-app wallet.

**Branded Wallet Connector**

Partners can add your wallet as a wallet connector option in their existing sign in flow on any domains they've whitelisted by calling the follow endpoint from their application.

**WalletConnect (Coming Soon)**

Partners using WalletConnect will automatically display your wallet as a WalletConnect option on any domains they've whitelisted.

### What is the difference between Anyone and Allowlist scopes for Ecosystem Wallet?

The **Anyone** scope allows any developer to integrate your ecosystem wallet, even if you have not given them permission. Any developer with thirdweb Connect, for example, would now display your wallet as a login option.

The **Allowlist** scope allows developers that you have explicitly added to your list of Partners to display your wallet as a login option.

You can manage scope in the Permissions tab of your Ecosystem Wallet dashboard.

### How does billing work for Ecosystem Wallets?

As the ecosystem admin, you will be billed $250 monthly for your Ecosystem Wallet. This allows any application or game in your ecosystem generate in-app wallets. Each month, we allow you and your ecosystem partners to generate 30,000 wallets for free. Once you’ve generated 30,000 wallets, you will be charged $0.02 per in-app wallet. At the end of each month, we will provide you with an invoice with a usage breakdown across all partners.

# Security FAQs

Loading