@stardust-collective/web3-react-stargazer-connector

Stargazer Wallet Connectors

The official Web 3 connectors (web3-react, wagmi, react-hooks) for the Stargazer Wallet.

Install

If you're using NPM

npm install @stardust-collective/web3-react-stargazer-connector

If you're using Yarn

yarn add @stardust-collective/web3-react-stargazer-connector

Example (web3-react / v6)

import {StargazerWeb3ReactConnector} from '@stardust-collective/web3-react-stargazer-connector';
import {useWeb3React} from '@web3-react/core';

const stargazerConnector = new StargazerWeb3ReactConnector({
  supportedChainIds: [1, 3]
});

const web3react = useWeb3React();

/**
 * Activation
 * https://github.com/Uniswap/web3-react/blob/v6/docs/README.md
 */

web3react.activate(stargazerConnector);

Example (wagmi)

import {stargazerWalletWagmiConnector} from '@stardust-collective/web3-react-stargazer-connector';
import { mainnet, polygon } from 'wagmi/chains'
import { createConfig, http, useConnect } from 'wagmi'

const stargazerConnector = stargazerWalletWagmiConnector();

declare module 'wagmi' {
  interface Register {
    config: typeof config
  }
}

const config = createConfig({
  chains: [mainnet, polygon],
  transports: {
    [mainnet.id]: http('[your rpc endpoint url]'),
    [polygon.id]: http('[your rpc endpoint url]'),
  },
  connectors: [
    stargazerWalletWagmiConnector({}),
    ...other wallet connectors
  ],
})

/**
 * Activation
 * https://wagmi.sh/react/guides/connect-wallet#_3-display-wallet-options
 */

const { connectors, connect } = useConnect()

for(const connector of connectors){
  if(connector.type === stargazerWalletWagmiConnector.type){
    connect({ connector })
  }
}

Example (react-hooks)

import {useStargazerWallet} from '@stardust-collective/web3-react-stargazer-connector';

type IStargazerWalletHookState = {
  activate: () => Promise<void>;
  deactivate: () => Promise<void>;
} & (
  | {
      active: true;
      account: string;
      provider: StargazerEIPProvider;
      request: StargazerEIPProvider['request'];
    }
  | {active: false}
);

const stargazerWalletState = useStargazerWallet();

const {activate, deactivate, ...state}: IStargazerWalletHookState = stargazerWalletState;

/*
 * Requests wallet activation for Constellation (DAG) accounts
 */
await activate();

/*
 * Resets state, deactivates the wallet
 */
await deactivate();

/*
 * Contains information about the current connected wallet,
 * and exposes a EIP-1193 provider to interact with the wallet
 *
 * More info about the RPC EIP-1193 API:
 * https://docs.constellationnetwork.io/stargazer/APIReference/constellationRPCAPI/
 */
state;

Development

This project runs on TypeScript 5, Node 18, and web3-react 6.

yarn build

Builds the project and stores its contents in the ./dist folder.

yarn dev

Builds the project and watches for changes.

License

This project is licensed under the MIT License