@futureverse/wagmi-connectors

wagmi Connector implementations that surface a FuturePass session as an EVM wallet to wagmi/viem.

Futureverse winddown

Futureverse (the publisher of @futureverse/*) is in winddown. The hosted services this package talked to (auth.futureverse.app, pass-api.futureverse.app, signer.futureverse.app) have been re-hosted by gen3labs at futurepass.gen3labs.tech (issuer) and fpsigner.gen3labs.tech (signer). For new projects, switch to the matching @gen3labs/* package — drop-in surface, default URLs already point at the gen3labs infra. The Asset Register API has no community replacement yet; see the Migration playbook for the per-package map.

Version

4.0.4

Published

2025-09-16

License

n/a

Status

fv-winddown

npm

https://www.npmjs.com/package/@futureverse/wagmi-connectors

Types

./index.d.ts

Maintainers

admin-futureverse, garethdainesnpm, jcsanpedro

Depends on

xumm · @polkadot/api · @futureverse/signer · @therootnetwork/api · @futureverse/transact · @futureverse/auth-core · @walletconnect/ethereum-provider

Peer deps

viem · @wagmi/core · @wagmi/connectors

Recent versions

2.11.0-beta.1 · 3.3.0 · 3.3.1 · 4.0.0 · 4.0.1 · 4.0.2 · 4.0.3 · 4.0.4

## Technical notes

Why use it

You build with wagmi and want FuturePass to appear in the same wallet picker as MetaMask, WalletConnect, etc. The connector handles signing via the Futureverse signer.

When to skip it

You only use wallet-injected providers (EIP-1193) and do not need Pass.

Pairs with

• @futureverse/auth — session source
• wagmi — host

Alternatives

• @gen3labs/futurepass-wagmi-connectors (fork-active) —

Example

import { createConfig } from 'wagmi';
import { futurepassConnector } from '@futureverse/wagmi-connectors';

export const config = createConfig({
  connectors: [futurepassConnector({ authClient })],
  // ...
});

Upstream README

Futureverse Wagmi Connectors

Provides Wagmi extensions for Futureverse wallets.

Installation

NPM:

    npm install @futureverse/wagmi-connectors --save

Yarn:

    yarn add @futureverse/wagmi-connectors

Usage

Wagmi Config Setup Example

This example shows how to create a wagmi config with Xaman futureverse wallet connector. The code also uses Futureverse Auth React.

import { createConfig, http } from 'wagmi';
import { mainnet, sepolia } from 'wagmi/chains';
import { coinbaseWallet, metaMask, walletConnect } from 'wagmi/connectors';
import { root, porcini } from '@futureverse/auth';
import { xamanWallet, futureverseCustodialWallet } from '@futureverse/wagmi-connectors';

const wagmiConfig = createConfig({
  chains: [mainnet, sepolia, root, porcini],
  connectors: [
    futureverseCustodialWallet({ authClient, custodialType: 'email' }),
    futureverseCustodialWallet({
      authClient,
      custodialType: 'facebook',
    }),
    futureverseCustodialWallet({ authClient, custodialType: 'google' }),
    metaMask({
      dappMetadata: {
        name: 'FuturePass',
      },
    }),
    coinbaseWallet({
      appName: 'FuturePass',
    }),
    ...(xamanApiKey
      ? [
          xamanWallet({
            apiKey: xamanApiKey,
            onQR: xamanOnQRCode,
            onSign: xamanOnSigned,
            authClient,
            flow,
          }),
        ]
      : []),
    ...(walletConnectProjectId ? [walletConnect({ projectId: walletConnectProjectId })] : []),
  ],
  transports: {
    [mainnet.id]: http(),
    [sepolia.id]: http(),
    [root.id]: http(),
    [porcini.id]: http(),
  },
});

Source: https://www.npmjs.com/package/@futureverse/wagmi-connectors · captured 2026-05-16