├── .env.example ├── .eslintrc.json ├── .gitignore ├── LICENSE.md ├── README.md ├── lib ├── initFirebase.ts ├── initFirebaseAdmin.ts ├── useFirebaseUser.ts └── useFirebaseUserDocument.ts ├── next-env.d.ts ├── next.config.js ├── package.json ├── pages ├── _app.tsx ├── api │ └── auth │ │ └── login.ts └── index.tsx ├── public ├── favicon.ico ├── firebase.png ├── thirdweb.png └── thirdweb.svg ├── styles ├── Home.module.css └── globals.css └── tsconfig.json /.env.example: -------------------------------------------------------------------------------- 1 | NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN= 2 | NEXT_PUBLIC_API_KEY= 3 | NEXT_PUBLIC_AUTH_DOMAIN= 4 | NEXT_PUBLIC_PROJECT_ID= 5 | NEXT_PUBLIC_STORAGE_BUCKET= 6 | NEXT_PUBLIC_MESSAGING_SENDER_ID= 7 | NEXT_PUBLIC_APP_ID= 8 | FIREBASE_PRIVATE_KEY= 9 | FIREBASE_CLIENT_ID= 10 | FIREBASE_PRIVATE_KEY_ID= 11 | FIREBASE_CLIENT_EMAIL= -------------------------------------------------------------------------------- /.eslintrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "extends": "next/core-web-vitals" 3 | } 4 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files. 2 | 3 | # dependencies 4 | /node_modules 5 | /.pnp 6 | .pnp.js 7 | 8 | # testing 9 | /coverage 10 | 11 | # next.js 12 | /.next/ 13 | /out/ 14 | 15 | # production 16 | /build 17 | 18 | # misc 19 | .DS_Store 20 | *.pem 21 | 22 | # debug 23 | npm-debug.log* 24 | yarn-debug.log* 25 | yarn-error.log* 26 | .pnpm-debug.log* 27 | 28 | # local env files 29 | .env.local 30 | .env.development.local 31 | .env.test.local 32 | .env.production.local 33 | 34 | # vercel 35 | .vercel 36 | 37 | # typescript 38 | *.tsbuildinfo 39 | -------------------------------------------------------------------------------- /LICENSE.md: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "[]" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright 2021 Non-Fungible Labs, Inc 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | > [!Important] 2 | > This repository is referencing the `mumbai` chain. 3 | > 4 | > `Mumbai` [is deprecated since 08/04/2024](https://blog.thirdweb.com/deprecation-of-mumbai-testnet/), meaning the code in this repository will no longer work out of the box. 5 | > 6 | > You can still use this repository, however you will have to switch any references to `mumbai` to another chain. 7 | 8 | # thirdweb Auth + Firebase 9 | 10 | This template shows you can use thirdweb Auth as a custom authentication provider for Firebase, and automatically create a document in the `users` Firestore collection when a user signs up successfully. 11 | 12 |
13 |
14 | 20 |
21 |
22 | 23 | ## Pre-requisites 24 | 25 | - [Create a Firebase project](https://firebase.google.com/docs/web/setup#create-project) 26 | - [Register your Firebase app](https://firebase.google.com/docs/web/setup#register-app) 27 | - [Create and export a service account as a JSON file](https://firebase.google.com/docs/admin/setup#initialize-sdk) 28 | - Make sure to enable Firebase Authentication as we'll be using the [Custom Authentication](https://firebase.google.com/docs/auth/web/custom-auth?hl=en&authuser=0) method and create a [Cloud Firestore](https://firebase.google.com/docs/firestore/quickstart?hl=en&authuser=0) database within your project. 29 | 30 | ## Set Up 31 | 32 | To begin with, let's create a new Next.js project with the SDK configured: 33 | 34 | ```bash 35 | npx thirdweb create app --next --ts 36 | ``` 37 | 38 | From within the created directory, we need to install `@thirdweb-dev/auth`, `firebase` and `firebase-admin`: 39 | 40 | ```bash npm2yarn 41 | npm install @thirdweb-dev/auth firebase firebase-admin 42 | ``` 43 | 44 | ### Configure Firebase 45 | 46 | We'll use environment variables to store our Firebase configuration. 47 | 48 | Create a `.env.local` file in the root of your project and add the corresponding values from your Firebase project: 49 | 50 | ``` 51 | NEXT_PUBLIC_API_KEY= 52 | NEXT_PUBLIC_AUTH_DOMAIN= 53 | NEXT_PUBLIC_PROJECT_ID= 54 | NEXT_PUBLIC_STORAGE_BUCKET= 55 | NEXT_PUBLIC_MESSAGING_SENDER_ID= 56 | NEXT_PUBLIC_APP_ID= 57 | FIREBASE_PRIVATE_KEY= 58 | FIREBASE_CLIENT_ID= 59 | FIREBASE_PRIVATE_KEY_ID= 60 | FIREBASE_CLIENT_EMAIL= 61 | ``` 62 | 63 | Most of the above environment variables can be found in the settings page of your Firebase project (after adding a Web app to your project), or in the service role JSON file you created and downloaded earlier. 64 | 65 | Create a new directory called `lib` and create two helper scripts to initialize Firebase in the browser and server: 66 | 67 | - [lib/initFirebase.ts](https://github.com/thirdweb-example/firebase-auth/blob/main/lib/initFirebase.ts) 68 | - [lib/initFirebaseAdmin.ts](https://github.com/thirdweb-example/firebase-auth/blob/main/lib/initFirebaseAdmin.ts) 69 | 70 | Now we have an easy way to access Firebase Auth and Firestore in both client and server environments! 71 | 72 | ### Configure thirdweb Auth 73 | 74 | Finally, to configure thirdweb Auth, we just need to add the `NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN` evironment variable to the `.env.local` file as follows: 75 | 76 | ``` 77 | NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN= 78 | ``` 79 | 80 | The `NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN` is used to prevent phishing attacks - and is usually set to the domain of your project like `example.com`. You can read more about it in the [thirdweb Auth Documentation](https://portal.thirdweb.com/auth/how-auth-works/sign-in-with-wallet#domain). 81 | 82 | ### ThirdwebProvider 83 | 84 | Inside the `pages/_app.tsx` file, configure the `authConfig` option: 85 | 86 | ```ts title="pages/_app.tsx" 87 | import type { AppProps } from "next/app"; 88 | import { ThirdwebProvider } from "@thirdweb-dev/react"; 89 | 90 | // This is the chain your dApp will work on. 91 | const activeChain = "mumbai"; 92 | 93 | function MyApp({ Component, pageProps }: AppProps) { 94 | return ( 95 | 101 | 102 | 103 | ); 104 | } 105 | 106 | export default MyApp; 107 | ``` 108 | 109 | ## Sign Up / Log In Users 110 | 111 | The process of creating users in Firebase by authenticating them with their wallet has two steps: 112 | 113 | 1. Authenticate the user with their wallet 114 | 2. Create a user in Firebase with the knowledge that they own this wallet 115 | 116 | On the homepage (`pages/index.tsx`), we'll allow the user to connect their wallet and then sign in with Ethereum. 117 | 118 | ```tsx title="pages/index.tsx" 119 | import React from "react"; 120 | import { ConnectWallet, useAddress, useAuth } from "@thirdweb-dev/react"; 121 | import { doc, serverTimestamp, setDoc } from "firebase/firestore"; 122 | import { signInWithCustomToken } from "firebase/auth"; 123 | import initializeFirebaseClient from "../lib/initFirebase"; 124 | 125 | export default function Login() { 126 | const thirdwebAuth = useAuth(); 127 | const address = useAddress(); 128 | const { auth, db } = initializeFirebaseClient(); 129 | 130 | return ( 131 |
132 | {address ? ( 133 | 134 | ) : ( 135 | 136 | )} 137 |
138 | ); 139 | } 140 | ``` 141 | 142 | The `signIn` function: 143 | 144 | 1. Makes a request to the `api/auth/login` endpoint to get a custom token from Firebase 145 | 2. Signs the user in with the custom token 146 | 3. Creates a user in Firestore with the verified user's address 147 | 148 | ```tsx title="pages/index.tsx" 149 | // Note: This function lives inside the Login component above. 150 | const signIn = async () => { 151 | // Use the same address as the one specified in _app.tsx. 152 | const payload = await thirdwebAuth?.login(); 153 | 154 | try { 155 | // Make a request to the API with the payload. 156 | const res = await fetch("/api/auth/login", { 157 | method: "POST", 158 | headers: { 159 | "Content-Type": "application/json", 160 | }, 161 | body: JSON.stringify({ payload }), 162 | }); 163 | 164 | // Get the returned JWT token to use it to sign in with 165 | const { token } = await res.json(); 166 | 167 | // Sign in with the token. 168 | const userCredential = await signInWithCustomToken(auth, token); 169 | // On success, we have access to the user object. 170 | const user = userCredential.user; 171 | 172 | // If this is a new user, we create a new document in the database. 173 | const usersRef = doc(db, "users", user.uid!); 174 | const userDoc = await getDoc(usersRef); 175 | 176 | if (!userDoc.exists()) { 177 | // User now has permission to update their own document outlined in the Firestore rules. 178 | setDoc(usersRef, { createdAt: serverTimestamp() }, { merge: true }); 179 | } 180 | } catch (error) { 181 | console.error(error); 182 | } 183 | }; 184 | ``` 185 | 186 | In this function, you'll notice we're calling the `/api/auth/login` endpoint to get a 187 | [custom JWT token from Firebase](https://firebase.google.com/docs/auth/admin/create-custom-tokens#create_custom_tokens_using_the_firebase_admin_sdk). 188 | 189 | Let's take a look at that API route. 190 | 191 | ### Auth API Route 192 | 193 | Create a folder that lives in the `/pages/api/auth` directory called `login.ts`. 194 | 195 | This API route is responsible for: 196 | 197 | 1. Verifying the payload provided by the client 198 | 2. Once the payload is verified, creating a [custom token](https://firebase.google.com/docs/auth/admin/create-custom-tokens#create_custom_tokens_using_the_firebase_admin_sdk) 199 | for the user to sign in to Firebase with. 200 | 201 | ```ts title="pages/api/auth/login.ts" 202 | import { NextApiRequest, NextApiResponse } from "next"; 203 | import { verifyLogin } from "@thirdweb-dev/auth/evm"; 204 | import initializeFirebaseServer from "../../../lib/initFirebaseAdmin"; 205 | 206 | const login = async (req: NextApiRequest, res: NextApiResponse) => { 207 | // Grab the login payload the user sent us with their request. 208 | const payload = req.body.payload; 209 | 210 | const { address, error } = await verifyLogin( 211 | process.env.NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN as string, 212 | payload 213 | ); 214 | if (!address) { 215 | return res.status(401).json({ error }); 216 | } 217 | 218 | // Initialize the Firebase Admin SDK. 219 | const { auth } = initializeFirebaseServer(); 220 | 221 | // Generate a JWT token for the user to be used on the client-side. 222 | const token = await auth.createCustomToken(address); 223 | 224 | // Send the token to the client-side. 225 | return res.status(200).json({ token }); 226 | }; 227 | 228 | export default login; 229 | ``` 230 | 231 | You'll now be able to use Firebase Authentication to authenticate users with their wallets! 232 | 233 | ### Firestore Rules (Optional) 234 | 235 | You'll likely want to add a [security rule](https://firebase.google.com/docs/firestore/security/get-started) 236 | to your Firestore database that only allows users to update their documents. 237 | 238 | ```cel title="firestore.rules" 239 | rules_version = '2'; 240 | service cloud.firestore { 241 | match /databases/{database}/documents { 242 | // The wildcard expression {userId} makes the userId variable available in rules. 243 | match /users/{userId} { 244 | // Only allow users to update their own documents. 245 | allow create, update, delete: if request.auth != null && request.auth.uid == userId; 246 | // But anybody can read their profile. 247 | allow read; 248 | } 249 | } 250 | } 251 | ``` 252 | 253 | ### Viewing the Result 254 | 255 | When you click the "Sign in with Ethereum" button and successfully sign in, you'll be signed up as a user in Firebase and a new document will be created in your `users` collection in Firestore: 256 | 257 | You can now use all the functionality of Firebase Authentication and Firestore to build your app! 258 | 259 | ## What's Next? 260 | 261 | - [Get the current Firebase user](https://github.com/thirdweb-example/firebase-auth/blob/main/lib/useFirebaseUser.ts) 262 | - [Read the current user's document from Firestore](https://github.com/thirdweb-example/firebase-auth/blob/main/lib/useFirebaseUserDocument.ts) 263 | - [Sign out](https://github.com/thirdweb-example/firebase-auth/blob/main/pages/index.tsx#L84-L89) 264 | -------------------------------------------------------------------------------- /lib/initFirebase.ts: -------------------------------------------------------------------------------- 1 | import { initializeApp } from "firebase/app"; 2 | import { Auth, getAuth } from "firebase/auth"; 3 | import { Firestore, getFirestore } from "firebase/firestore"; 4 | 5 | // Create Client-Side Instance of Firebase 6 | export default function initializeFirebaseClient(): { 7 | db: Firestore; 8 | auth: Auth; 9 | } { 10 | const firebaseApp = initializeApp({ 11 | apiKey: process.env.NEXT_PUBLIC_API_KEY, 12 | authDomain: process.env.NEXT_PUBLIC_AUTH_DOMAIN, 13 | projectId: process.env.NEXT_PUBLIC_PROJECT_ID, 14 | storageBucket: process.env.NEXT_PUBLIC_STORAGE_BUCKET, 15 | messagingSenderId: process.env.NEXT_PUBLIC_MESSAGING_SENDER_ID, 16 | appId: process.env.NEXT_PUBLIC_APP_ID, 17 | }); 18 | 19 | const db = getFirestore(firebaseApp); 20 | const auth = getAuth(firebaseApp); 21 | 22 | return { 23 | db, 24 | auth, 25 | }; 26 | } 27 | -------------------------------------------------------------------------------- /lib/initFirebaseAdmin.ts: -------------------------------------------------------------------------------- 1 | import admin from "firebase-admin"; 2 | import { initializeApp, cert } from "firebase-admin/app"; 3 | import { Auth, getAuth } from "firebase-admin/auth"; 4 | import { Firestore, getFirestore } from "firebase-admin/firestore"; 5 | 6 | // Create Server-Side Instance of Firebase 7 | export default function initializeFirebaseServer(): { 8 | db: Firestore; 9 | auth: Auth; 10 | } { 11 | const clientEmail = process.env.FIREBASE_CLIENT_EMAIL; 12 | const privateKey = (process.env.FIREBASE_PRIVATE_KEY as string).replace( 13 | /\\n/g, 14 | "\n" 15 | ); 16 | const projectId = process.env.NEXT_PUBLIC_PROJECT_ID; 17 | 18 | if (admin.apps.length === 0) { 19 | initializeApp({ 20 | credential: cert({ 21 | clientEmail, 22 | privateKey, 23 | projectId, 24 | }), 25 | }); 26 | } 27 | 28 | const db = getFirestore(); 29 | const auth = getAuth(); 30 | 31 | return { 32 | db, 33 | auth, 34 | }; 35 | } 36 | -------------------------------------------------------------------------------- /lib/useFirebaseUser.ts: -------------------------------------------------------------------------------- 1 | import { onAuthStateChanged, User } from "firebase/auth"; 2 | import { useEffect, useState } from "react"; 3 | import initializeFirebaseClient from "./initFirebase"; 4 | 5 | // Helpful hook for you to get the currently authenticated user in Firebase. 6 | export default function useFirebaseUser() { 7 | const [isLoading, setIsLoading] = useState(true); 8 | const [user, setUser] = useState(null); 9 | const { auth } = initializeFirebaseClient(); 10 | 11 | useEffect(() => { 12 | const listener = onAuthStateChanged(auth, (user) => { 13 | setUser(user); 14 | setIsLoading(false); 15 | }); 16 | return () => { 17 | listener(); 18 | }; 19 | }, [auth]); 20 | 21 | return { isLoading, user }; 22 | } 23 | -------------------------------------------------------------------------------- /lib/useFirebaseUserDocument.ts: -------------------------------------------------------------------------------- 1 | import { doc, DocumentData, onSnapshot } from "firebase/firestore"; 2 | import { useEffect, useState } from "react"; 3 | import initializeFirebaseClient from "./initFirebase"; 4 | import useFirebaseUser from "./useFirebaseUser"; 5 | 6 | // Helpful hook for you to read the currently authenticated user's document from Firestore using their ID 7 | export default function useFirebaseDocument() { 8 | const { db } = initializeFirebaseClient(); 9 | const { user, isLoading: loadingUser } = useFirebaseUser(); 10 | const [isLoading, setIsLoading] = useState(true); 11 | const [document, setDocument] = useState(null); 12 | 13 | useEffect(() => { 14 | if (!loadingUser && user && db) { 15 | (async () => { 16 | const docRef = doc(db, "users", user.uid); 17 | const listener = onSnapshot(docRef, (doc) => { 18 | if (doc.exists()) { 19 | setDocument({ 20 | ...doc.data(), 21 | id: doc.id, 22 | }); 23 | } else { 24 | console.log("hey", doc); 25 | setDocument(null); 26 | } 27 | setIsLoading(false); 28 | }); 29 | 30 | return () => { 31 | listener(); 32 | }; 33 | })(); 34 | } else { 35 | setIsLoading(false); 36 | } 37 | }, [db, user, loadingUser]); 38 | 39 | return { isLoading, document }; 40 | } 41 | -------------------------------------------------------------------------------- /next-env.d.ts: -------------------------------------------------------------------------------- 1 | /// 2 | /// 3 | 4 | // NOTE: This file should not be edited 5 | // see https://nextjs.org/docs/basic-features/typescript for more information. 6 | -------------------------------------------------------------------------------- /next.config.js: -------------------------------------------------------------------------------- 1 | /** @type {import('next').NextConfig} */ 2 | const nextConfig = { 3 | reactStrictMode: true, 4 | } 5 | 6 | module.exports = nextConfig 7 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "thirdweb-auth-with-firebase", 3 | "version": "0.1.0", 4 | "private": true, 5 | "scripts": { 6 | "dev": "next dev", 7 | "build": "next build", 8 | "start": "next start", 9 | "lint": "next lint" 10 | }, 11 | "dependencies": { 12 | "@thirdweb-dev/auth": "^3", 13 | "@thirdweb-dev/react": "^3", 14 | "@thirdweb-dev/sdk": "^3", 15 | "ethers": "^5", 16 | "firebase": "^9.17.1", 17 | "firebase-admin": "^11.5.0", 18 | "next": "^13", 19 | "react": "^18.2", 20 | "react-dom": "^18.2" 21 | }, 22 | "devDependencies": { 23 | "@types/node": "^18.14.0", 24 | "@types/react": "^18.0.28", 25 | "eslint": "^8.34.0", 26 | "eslint-config-next": "^13", 27 | "typescript": "^4.9.5" 28 | } 29 | } -------------------------------------------------------------------------------- /pages/_app.tsx: -------------------------------------------------------------------------------- 1 | import type { AppProps } from "next/app"; 2 | import { ThirdwebProvider } from "@thirdweb-dev/react"; 3 | import "../styles/globals.css"; 4 | 5 | function MyApp({ Component, pageProps }: AppProps) { 6 | // This is the chain your dApp will work on. 7 | const activeChain = "mumbai"; 8 | 9 | return ( 10 | 16 | 17 | 18 | ); 19 | } 20 | 21 | export default MyApp; 22 | -------------------------------------------------------------------------------- /pages/api/auth/login.ts: -------------------------------------------------------------------------------- 1 | import { NextApiRequest, NextApiResponse } from "next"; 2 | import { verifyLogin } from "@thirdweb-dev/auth/evm"; 3 | import initializeFirebaseServer from "../../../lib/initFirebaseAdmin"; 4 | 5 | const login = async (req: NextApiRequest, res: NextApiResponse) => { 6 | // Grab the login payload the user sent us with their request. 7 | const payload = req.body.payload; 8 | 9 | const { address, error } = await verifyLogin( 10 | process.env.NEXT_PUBLIC_THIRDWEB_AUTH_DOMAIN as string, 11 | payload 12 | ); 13 | if (!address) { 14 | return res.status(401).json({ error }); 15 | } 16 | 17 | // Initialize the Firebase Admin SDK. 18 | const { auth } = initializeFirebaseServer(); 19 | 20 | // Generate a JWT token for the user to be used on the client-side. 21 | const token = await auth.createCustomToken(address); 22 | 23 | // Send the token to the client-side. 24 | return res.status(200).json({ token }); 25 | }; 26 | 27 | export default login; 28 | -------------------------------------------------------------------------------- /pages/index.tsx: -------------------------------------------------------------------------------- 1 | import { ConnectWallet, useAddress, useAuth } from "@thirdweb-dev/react"; 2 | import { signInWithCustomToken, signOut } from "firebase/auth"; 3 | import React from "react"; 4 | import initializeFirebaseClient from "../lib/initFirebase"; 5 | import { getDoc, doc, serverTimestamp, setDoc } from "firebase/firestore"; 6 | import styles from "../styles/Home.module.css"; 7 | import useFirebaseUser from "../lib/useFirebaseUser"; 8 | import useFirebaseDocument from "../lib/useFirebaseUserDocument"; 9 | import Image from "next/image"; 10 | 11 | export default function Login() { 12 | const thirdwebAuth = useAuth(); 13 | const address = useAddress(); 14 | const { auth, db } = initializeFirebaseClient(); 15 | const { user, isLoading: loadingAuth } = useFirebaseUser(); 16 | const { document, isLoading: loadingDocument } = useFirebaseDocument(); 17 | 18 | const signIn = async () => { 19 | // Use the same address as the one specified in _app.tsx. 20 | const payload = await thirdwebAuth?.login(); 21 | 22 | try { 23 | // Make a request to the API with the payload. 24 | const res = await fetch("/api/auth/login", { 25 | method: "POST", 26 | headers: { 27 | "Content-Type": "application/json", 28 | }, 29 | body: JSON.stringify({ payload }), 30 | }); 31 | 32 | // Get the returned JWT token to use it to sign in with 33 | const { token } = await res.json(); 34 | 35 | // Sign in with the token. 36 | const userCredential = await signInWithCustomToken(auth, token); 37 | // On success, we have access to the user object. 38 | const user = userCredential.user; 39 | 40 | // If this is a new user, we create a new document in the database. 41 | const usersRef = doc(db, "users", user.uid!); 42 | const userDoc = await getDoc(usersRef); 43 | 44 | if (!userDoc.exists()) { 45 | // User now has permission to update their own document outlined in the Firestore rules. 46 | setDoc(usersRef, { createdAt: serverTimestamp() }, { merge: true }); 47 | } 48 | } catch (error) { 49 | console.error(error); 50 | } 51 | }; 52 | 53 | return ( 54 |
55 |
56 |
57 | thirdweb icon 64 | firebase icon 71 |
72 | 73 |

thirdweb + Firebase

74 | 75 |

76 | By clicking the button below, you authenticate with your wallet. 77 |

78 |

79 | You will have a user created for you in Firebase Auth and a document 80 | created for you in Firestore. 81 |

82 | 83 | {address ? ( 84 |
85 | {!user ? ( 86 | 89 | ) : ( 90 | 96 | )} 97 | 98 |
99 | 100 |

Current Firebase Information

101 | 102 |

103 | User ID: 104 | {loadingAuth ? "Loading..." : user?.uid || "Not logged in"} 105 |

106 | 107 |

108 | Document ID: 109 | {loadingDocument ? "Loading..." : document?.id || "No document"} 110 |

111 |
112 | ) : ( 113 | 114 | )} 115 |
116 |
117 | ); 118 | } 119 | -------------------------------------------------------------------------------- /public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/thirdweb-example/firebase-auth/1b2e68fea74d9f5567e6b3365cd19929530a6ef3/public/favicon.ico -------------------------------------------------------------------------------- /public/firebase.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/thirdweb-example/firebase-auth/1b2e68fea74d9f5567e6b3365cd19929530a6ef3/public/firebase.png -------------------------------------------------------------------------------- /public/thirdweb.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/thirdweb-example/firebase-auth/1b2e68fea74d9f5567e6b3365cd19929530a6ef3/public/thirdweb.png -------------------------------------------------------------------------------- /public/thirdweb.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | -------------------------------------------------------------------------------- /styles/Home.module.css: -------------------------------------------------------------------------------- 1 | .container { 2 | margin-top: 96px; 3 | display: flex; 4 | flex-direction: column; 5 | align-items: center; 6 | justify-content: center; 7 | width: 100vw; 8 | padding: 0 24px; 9 | } 10 | 11 | .h1 { 12 | margin-bottom: 0px; 13 | } 14 | 15 | .iconContainer { 16 | display: flex; 17 | flex-direction: row; 18 | justify-content: center; 19 | align-items: center; 20 | margin-top: 24px; 21 | gap: 24px; 22 | } 23 | 24 | .icon { 25 | object-fit: contain; 26 | } 27 | 28 | .explain { 29 | font-size: 1.125rem; 30 | } 31 | 32 | .purple { 33 | color: #9f2c9d; 34 | } 35 | 36 | .divider { 37 | width: 50%; 38 | border-color: grey; 39 | opacity: 0.25; 40 | } 41 | 42 | .mainButton { 43 | cursor: pointer; 44 | display: inline-flex; 45 | appearance: none; 46 | align-items: center; 47 | -webkit-box-align: center; 48 | justify-content: center; 49 | white-space: nowrap; 50 | vertical-align: middle; 51 | outline: 2px solid transparent; 52 | outline-offset: 2px; 53 | line-height: 1.2; 54 | font-weight: 600; 55 | transition-property: background-color, border-color, color, fill, stroke, 56 | opacity, box-shadow, transform; 57 | transition-duration: 200ms; 58 | height: 3rem; 59 | min-width: 3rem; 60 | font-size: 1rem; 61 | background: #e5e5ea; 62 | background-image: linear-gradient(to left, #cc25b3 0%, #418dff 101.52%); 63 | color: #fff; 64 | min-width: 180px; 65 | padding-left: 20px; 66 | padding-right: 20px; 67 | text-align: center; 68 | border-radius: 9999px; 69 | border-style: none; 70 | } 71 | 72 | .mainButton:hover { 73 | opacity: 0.8; 74 | } 75 | 76 | .connectBtn { 77 | max-width: 300px; 78 | margin: 0 auto; 79 | } 80 | -------------------------------------------------------------------------------- /styles/globals.css: -------------------------------------------------------------------------------- 1 | @import url("https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap"); 2 | 3 | /* Box sizing rules */ 4 | *, 5 | *::before, 6 | *::after { 7 | box-sizing: border-box; 8 | } 9 | 10 | /* Set core body defaults */ 11 | body { 12 | min-height: 100vh; 13 | text-rendering: optimizeSpeed; 14 | line-height: 1.5; 15 | padding-bottom: 250px; 16 | } 17 | 18 | /* Inherit fonts for inputs and buttons */ 19 | input, 20 | button, 21 | textarea, 22 | select { 23 | font: inherit; 24 | } 25 | 26 | :root { 27 | --background-color: #1c1e21; 28 | --white: #ffffff; 29 | --tw-color1: #a855f7; 30 | --tw-color1-hover: #9333ea; 31 | } 32 | 33 | body { 34 | background: var(--background-color); 35 | font-family: "Inter", sans-serif; 36 | color: var(--white); 37 | display: flex; 38 | margin: 0; 39 | text-align: center; 40 | } 41 | 42 | h2 { 43 | font-size: 2rem; 44 | } 45 | -------------------------------------------------------------------------------- /tsconfig.json: -------------------------------------------------------------------------------- 1 | { 2 | "compilerOptions": { 3 | "target": "es5", 4 | "lib": ["dom", "dom.iterable", "esnext"], 5 | "allowJs": true, 6 | "skipLibCheck": true, 7 | "strict": true, 8 | "forceConsistentCasingInFileNames": true, 9 | "noEmit": true, 10 | "esModuleInterop": true, 11 | "module": "esnext", 12 | "moduleResolution": "node", 13 | "resolveJsonModule": true, 14 | "isolatedModules": true, 15 | "jsx": "preserve", 16 | "incremental": true 17 | }, 18 | "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"], 19 | "exclude": ["node_modules"] 20 | } 21 | --------------------------------------------------------------------------------