You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is a very common error that happens mainly when you did not set up the `projectId` correctly. Please create and use a valid projectId from https://cloud.reown.com/
11
-
12
-
```javascript
13
-
constmodal=createAppKit({
14
-
...
15
-
projectId:"..."// add a valid projectId
16
-
});
17
-
```
18
-
19
-
## No wallets are visible, only the title "Connect Wallet."
20
-
21
-
Problem: After clicking the connect button users are only seeing the modal with the title "Connect Wallet".
22
-
23
-
Solution: In general there are two possibilities for this error.
24
-
25
-
1. Check all the libraries from @reown are using the **same version** in `packages.json`.
26
-
27
-
```json
28
-
...
29
-
"dependencies": {
30
-
"@reown/appkit": "1.7.8",
31
-
"@reown/appkit-adapter-wagmi": "1.7.8",
32
-
...
33
-
}
34
-
```
35
-
36
-
2. Call `createAppKit` outside of the component to ensure correct behavior.".
37
-
38
-
```javascript
39
-
// Create modal
40
-
createAppKit({
41
-
adapters: [wagmiAdapter],
42
-
...generalConfig,
43
-
features: {
44
-
analytics:true// Optional - defaults to your Cloud configuration
45
-
}
46
-
})
47
-
48
-
exportfunctionApp() {
49
-
return (
50
-
<WagmiProvider ...>
51
-
<QueryClientProvider ...>
52
-
<appkit-button />
53
-
</QueryClientProvider>
54
-
</WagmiProvider>
55
-
}
56
-
57
-
```
58
-
59
-
## When will Reown support off-ramp?
60
-
61
-
For the moment, Reown does not currently plan to support off-ramp.
62
-
63
-
## How can I retrieve more than one address from the currently connected wallets?
64
-
65
-
To resolve this issue, please refer to our multichain example:
Currently, only enterprise clients can hide "UX by reown" in our modal by adjusting this option on our Dashboard.
89
-
90
-
## Do I need to wait for my dApp approval before using it, as it is still in "Pending Review"?
91
-
92
-
No, dApps do not need approval in order to use your projectId.
93
-
94
-
## Can `createAppKit` be lazily initialized and torn down for re-initialization with a different network configuration?
95
-
96
-
A: Currently, `createAppKit` can only be called once during the application's lifecycle.
97
-
It cannot be lazily initialized and then torn down for re-initialization.
98
-
This means you must pass in all the networks you plan to support during the initial setup.
99
-
100
-
## Can we use our own RPC in APPkit?
101
-
A: Yes, you can use your own RPC by setting the customRpcUrls option in the APPkit configuration. This lets you define custom RPC URLs for specific chains. Each entry must follow the format:
102
-
103
-
``` javascript
104
-
customRpcUrls: {
105
-
[ChainId.Ethereum]:'https://your.custom.rpc.url',
106
-
[ChainId.Polygon]:'https://your.polygon.rpc.url',
107
-
}
108
-
```
109
-
110
-
APPkit will prioritize these URLs over the default ones.
6
+
This FAQ section covers common questions and solutions for using AppKit. The questions are organized into three main categories:
7
+
8
+
-**Configuration**: Questions about setting up AppKit, including project configuration, wallet visibility, and RPC customization.
9
+
-**Features**: Information about AppKit's capabilities, including off-ramp support, multi-wallet address retrieval, and branding options.
10
+
-**Technical**: Technical details about project approval requirements and initialization constraints.
11
+
12
+
## AppKit Configuration
13
+
14
+
<AccordionGroup>
15
+
<Accordiontitle="Why am I seeing an 'Invalid App Configuration' error?">
This error typically occurs when the `projectId` is not configured correctly. To resolve this:
19
+
20
+
1. Create a valid project ID at [https://cloud.reown.com/](https://cloud.reown.com/)
21
+
2. Add it to your AppKit configuration:
22
+
23
+
```javascript
24
+
constmodal=createAppKit({
25
+
...
26
+
projectId:"..."// Add your valid projectId here
27
+
});
28
+
```
29
+
3. Ensure that you have added your domain to the allowed domains in your project settings. If you have not done so, you can do so by navigating to **"Project Domains"** on the Dashboard, clicking on **"Configure Domains"** and adding your domain.
30
+
</Accordion>
31
+
32
+
<Accordiontitle="Why can't I see any wallets in the modal and only see the 'Connect Wallet' title?">
33
+
**Problem**: Users only see the "Connect Wallet" title in the modal after clicking the connect button.
34
+
35
+
**Solution**: This issue typically has two possible causes:
36
+
37
+
1.**Version Mismatch**: Ensure all @reown libraries use the same version in your `package.json`:
38
+
39
+
```json
40
+
{
41
+
"dependencies": {
42
+
"@reown/appkit": "1.7.8",
43
+
"@reown/appkit-adapter-wagmi": "1.7.8"
44
+
// ... other dependencies
45
+
}
46
+
}
47
+
```
48
+
49
+
2.**Initialization Location**: Call `createAppKit` outside of your component to ensure proper initialization:
50
+
51
+
```javascript
52
+
// Create modal
53
+
createAppKit({
54
+
adapters: [wagmiAdapter],
55
+
...generalConfig,
56
+
features: {
57
+
analytics:true// Optional - defaults to your Cloud configuration
58
+
}
59
+
})
60
+
61
+
exportfunctionApp() {
62
+
return (
63
+
<WagmiProvider ...>
64
+
<QueryClientProvider ...>
65
+
<appkit-button />
66
+
</QueryClientProvider>
67
+
</WagmiProvider>
68
+
)
69
+
}
70
+
```
71
+
</Accordion>
72
+
73
+
<Accordiontitle="How can I use custom RPCs with AppKit?">
74
+
You can use your own RPC by setting the `customRpcUrls` option in the AppKit configuration. This lets you define custom RPC URLs for specific chains. Each entry must follow the format:
75
+
76
+
```javascript
77
+
customRpcUrls: {
78
+
[ChainId.Ethereum]:'https://your.custom.rpc.url',
79
+
[ChainId.Polygon]:'https://your.polygon.rpc.url'
80
+
}
81
+
```
82
+
83
+
AppKit will prioritize these URLs over the default ones.
84
+
</Accordion>
85
+
</AccordionGroup>
86
+
87
+
## Features
88
+
89
+
<AccordionGroup>
90
+
<Accordiontitle="When will Reown support off-ramp functionality?">
91
+
Reown currently does not plan to support off-ramp functionality.
92
+
</Accordion>
93
+
94
+
<Accordiontitle="How do I get retrieve multiple addresses from multiple connected wallets?">
95
+
To retrieve addresses from multiple connected wallets, refer to our multichain example:
<Accordiontitle="How do I remove the 'UX by Reown' branding?">
119
+
Currently, only enterprise clients can hide "UX by Reown" on the AppKit modal by adjusting this option on our Dashboard. If you are an enterprise client and would like to hide this branding, please contact sales@reown.com.
120
+
</Accordion>
121
+
122
+
<Accordiontitle="How do I increase my project's RPC limits?">
123
+
Reown currently provides 2.5 million requests per 30 days. If you wish to increase this limit, you need to upgrade to AppKit Pro.
124
+
</Accordion>
125
+
</AccordionGroup>
126
+
127
+
## Technical
128
+
129
+
<AccordionGroup>
130
+
<Accordiontitle="Do I need to wait for Web3 app approval before using my projectId?">
131
+
No, dApps do not need approval in order to use your projectId.
132
+
</Accordion>
133
+
134
+
<Accordiontitle="Can I reinitialize AppKit with different network configurations?">
135
+
Currently, `createAppKit` can only be called once during the application's lifecycle.
136
+
It cannot be lazily initialized and then torn down for re-initialization.
137
+
This means you must pass in all the networks you plan to support during the initial setup.
138
+
</Accordion>
139
+
</AccordionGroup>
140
+
141
+
## Support
142
+
143
+
<AccordionGroup>
144
+
<Accordiontitle="How do I get technical support for AppKit?">
145
+
Free tier AppKit customers only are only entitled to support via [Discord](https://discord.gg/reown). Please join the Discord server and create a forum post **#developers-forum** and the team will get back to you.
146
+
147
+
AppKit Pro and Enterprise customers get priority support via dedicated channels.
0 commit comments