@bleepay/web3

Wagmi connector for Bleepay Wallet — session-based payments using a 6-digit code.

Installation

npm install @bleepay/web3 @bleepay/ui @bleepay/core @wagmi/core viem

Setup

import {createBleepConnector} from '@bleepay/web3';
import {createConfig, http} from '@wagmi/core';
import {mainnet} from '@wagmi/core/chains';

const config = createConfig({
  chains: [mainnet],
  transports: {[mainnet.id]: http()},
  connectors: [
    createBleepConnector({
      name: 'Bleep Wallet',
      defaultChainId: mainnet.id,
    }),
  ],
});

Connect

import {connect} from '@wagmi/core';

const result = await connect(config, {connector: config.connectors[0]});
// Opens a modal — user enters a 6-digit code from the Bleepay mobile app
console.log(result.accounts); // ['0x...']

Execute Transaction

import {getConnectorClient} from '@wagmi/core';
import {createEvmNetwork, createEvmPayment} from '@bleepay/core';

const client = await getConnectorClient(config);

const paymentIds = await client.request({
  method: 'bleep_redeem',
  params: [
    [createEvmNetwork({network: 'mainnet', chainId: 1})],    // networks
    [],                                                        // extras (e.g. approval txs)
    [createEvmPayment({from: '0x...', to: '0x...', value: '0x0', data: '0x', networkIndex: 0})],
    null,
    [{label: 'Pay', value: '0.1 ETH'}],                      // displayData (shown in modal)
  ],
});

Get Transaction by Code

const tx = await client.request({
  method: 'bleep_getByCode',
  params: ['123456'],
});

RainbowKit

import {createBleepConnector} from '@bleepay/web3';
import {getDefaultConfig} from '@rainbow-me/rainbowkit';

const config = getDefaultConfig({
  appName: 'My App',
  projectId: 'YOUR_PROJECT_ID',
  wallets: [{
    groupName: 'Popular',
    wallets: [() => ({
      id: 'bleep',
      name: 'Bleep Wallet',
      createConnector: () => createBleepConnector({name: 'Bleep Wallet'}),
    })],
  }],
});

Options

| Option | Type | Default | Description | |--------|------|---------|-------------| | name | string | 'Bleep' | Wallet name displayed in UI | | icon | string | — | Wallet icon URL | | defaultChainId | number | 1 | Default chain ID |