Eclipse Global Wallet

The Eclipse Global Wallet is a plug-and-play wallet integration powered by Dynamic, designed to provide a self-custodial, cross-app login experience for users across the Eclipse ecosystem. It follows the Solana Wallet Standard, ensuring compatibility with any SVM-native wallet adapter.

📦 NPM: @eclipse-laboratories-inc/eclipse-global-wallet

---

✅ Installation

npm i @eclipse-laboratories-inc/eclipse-global-wallet
# or
yarn add @eclipse-laboratories-inc/eclipse-global-wallet
# or
pnpm add @eclipse-laboratories-inc/eclipse-global-wallet

---

⚡ Quick Start

Import the registration module once during application startup. This makes the wallet discoverable to all wallet-standard compatible libraries (e.g. @solana/wallet-adapter).

React (Vite)

// src/main.tsx
import "@eclipse-laboratories-inc/eclipse-global-wallet/solana";

import React from "react";
import ReactDOM from "react-dom/client";
import App from "./App";

ReactDOM.createRoot(document.getElementById("root")!).render(<App />);

Next.js (App Router or Pages)

// app/providers.tsx or pages/_app.tsx
"use client";
import "@eclipse-laboratories-inc/eclipse-global-wallet/solana";

export default function Providers({ children }: { children: React.ReactNode }) {
  return <>{children}</>;
}

---

🔌 Add to Wallet Adapter Stack

If you're using @solana/wallet-adapter, simply register the wallet like so:

import { WalletProvider } from "@solana/wallet-adapter-react";
import { getEclipseWallet } from "@eclipse-laboratories-inc/eclipse-global-wallet/solana";

const wallets = [getEclipseWallet()];

<WalletProvider wallets={wallets} autoConnect>
  <YourApp />
</WalletProvider>;

---

🌐 Use Eclipse RPC

When using @solana/web3.js, point to an Eclipse RPC endpoint:

import { Connection } from "@solana/web3.js";

const connection = new Connection("https://testnet.dev2.eclipsenetwork.xyz", "confirmed");

---

🛠 Troubleshooting

• Ensure the package is installed:

  npm ls @eclipse-laboratories-inc/eclipse-global-wallet

• Update to the latest version:

  npm i @eclipse-laboratories-inc/eclipse-global-wallet@latest

• Double-check that you're importing the wallet registration file (/solana) at the top level of your app.

• Ensure you're using wallet-standard compatible libraries. If not, you'll need to manually wire the wallet into your stack using getEclipseWallet().

---

🔒 Security Notes

• All keys are generated client-side and remain in the user’s control.

• The wallet is powered by Dynamic, which supports passkey-based MFA and secure auth flows.

• No private keys are ever transmitted or stored server-side.

---

📚 References

• Solana Wallet Standard

• Eclipse RPC Docs

• NPM Package

• GitHub Repo