@particle-network/connectkit on Lumia Demo

Particle Connect on Lumia

Particle Connect enables a unified modal driving connection with social logins (through Particle Auth) and standard Web3 wallets, creating an equally accessible experience for Web3 natives and traditional consumers. Particle Connect is an all-in-one SDK capable of handling end-to-end onboarding and wallet connection.

This app enables you to log in using social logins or Web3 methods via Particle Connect and interact with the Lumia chain. You can view your account information and send transfer transactions to any address you input in the UI.

Built using:

• Particle Connect 2.0
• ethers.js V6.x.x
• TypeScript
• Tailwind CSS

Find the Particle Connect SDK docs.

---

👉 Learn more about Particle Network.

🛠️ Quickstart

Clone this repository

git clone https://github.com/Particle-Network/connectkit-lumia-demo

Move into the app directory

cd particle-connect

Install dependencies

yarn install

Or

npm install

Set environment variables

This project requires several keys from Particle Network to be defined in .env. The following should be defined:

• NEXT_PUBLIC_PROJECT_ID, the ID of the corresponding application in your Particle Network dashboard.
• NEXT_PUBLIC_CLIENT_KEY, the ID of the corresponding project in your Particle Network dashboard.
• NEXT_PUBLIC_APP_ID, the client key of the corresponding project in your Particle Network dashboard.

Start the project

npm run dev

Or

yarn dev

What is Lumia

Lumia is a hyper-liquid, capital-efficient zkEVM leveraging advanced technologies like PolygonCDK, AvailDA, and a custom Data Availability Committee (DAC) for redundancy.

Built through a collaboration between GatewayFM and Lumia’s tech team, Lumia integrates features such as its liquidity network (Lumia Stream), decentralized sequencers and zkProvers, fast finality, and robust validity proofs.

Build with Particle Connect (from scratch)

To get started with Particle Connect in your application, follow these steps:

🛠 Configuration & Integration

This is based on a standard Next JS application initialized with npx create-next-app@latest.

1. Install the SDK:

   Begin by installing the ConnectKit SDK:

   yarn add @particle-network/connectkit viem@^2

2. Create Connectkit.tsx and Configure the SDK:

Create a new component named Connectkit.tsx to set up your Particle Connect configuration.

Required Configurations:

• projectId, clientKey, and appId — Obtain these from the Particle dashboard.
• chains — Specify the supported chains for your dApp.
• walletConnectors — Define the wallets you want to support.

Optional Configurations:

• theme and language for the connection modal UI.
• Additional appearance customizations.

'use client';

 import React from 'react';
 import { ConnectKitProvider, createConfig } from '@particle-network/connectkit';
 import { authWalletConnectors } from '@particle-network/connectkit/auth';
 import { defineChain } from '@particle-network/connectkit/chains';

 // Define the Lumia testnet
 const LumiaTestnet = defineChain({
 id: 1952959480,
 name: "Lumia Testnet",
 nativeCurrency: {
     decimals: 18,
     name: "LUMIA",
     symbol: "LUMIA",
 },
 rpcUrls: {
     default: {
     http: ["https://testnet-rpc.lumia.org"],
     },
 },
 blockExplorers: {
     default: { name: "Explorer", url: "https://testnet-explorer.lumia.org/" },
 },
 testnet: true,
 });

 const config = createConfig({
 projectId: process.env.NEXT_PUBLIC_PROJECT_ID!,
 clientKey: process.env.NEXT_PUBLIC_CLIENT_KEY!,
 appId: process.env.NEXT_PUBLIC_APP_ID!,
 walletConnectors: [authWalletConnectors({})],

 chains: [LumiaTestnet],
 });

 export const ParticleConnectkit = ({ children }: React.PropsWithChildren) => {
 return <ConnectKitProvider config={config}>{children}</ConnectKitProvider>;
 };

3. Wrap Your App:

   Import and wrap your application with the ParticleConnectKit component (export of ConnectKitProvider) in your index or layout file. Here’s an example for a layout.tsx file:

   import type { Metadata } from "next";
   import { Inter } from "next/font/google";
   import "./globals.css";
   import { ParticleConnectkit } from "./components/Connectkit";
   
   const inter = Inter({ subsets: ["latin"] });
   
   export const metadata: Metadata = {
     title: "Particle Connect",
     description: "Demo showcasing a quickstart for Particle Connect 2.0 on Lumia",
   };
   
   export default function RootLayout({ children }: Readonly<{ children: React.ReactNode }>) {
     return (
       <html lang="en">
         <body className={inter.className}>
           <ParticleConnectkit>{children}</ParticleConnectkit>
         </body>
       </html>
     );
   }

4. Add a Connection Button:

   Include the Connect button in your main App component to allow users to log in via Particle Connect.

   Example integration:

   import { ConnectButton, useAccount } from '@particle-network/connectkit';
   
   export const App = () => {
       const { address, isConnected, chainId } = useAccount();
   
       return (
           <>
           {isConnected ? (
               <>
               <h2>Address: {address}</h2>
               <h2>Chain ID: {chainId}</h2>
               </>
           ) : (
               <ConnectButton />
           )}
           </>
       );
   };

Particle Connect features

Find the features available in the Particle Connect SDK docs.