@walletconnect/web3wallet
TypeScript icon, indicating that this package has built-in type declarations

1.10.3 • Public • Published

@walletconnect/web3wallet

Description

The Web3Wallet SDK streamlines the integration process, making it easier for wallet developers to include the authentication and transaction signing features necessary for their users to connect and interact with all sorts of apps — now and in the future.

Getting Started

Install

npm install @walletconnect/web3wallet

Wallet Usage

  1. Initialization
import { Core } from "@walletconnect/core";
import { Web3Wallet } from "@walletconnect/web3wallet";

const core = new Core({
  projectId: process.env.PROJECT_ID,
});

const web3wallet = await Web3Wallet.init({
  core, // <- pass the shared `core` instance
  metadata: {
    name: "Demo app",
    description: "Demo Client as Wallet/Peer",
    url: "www.walletconnect.com",
    icons: [],
  },
});
  1. Sign Session Approval
web3wallet.on("session_proposal", async (proposal) => {
  const session = await web3wallet.approveSession({
    id: proposal.id,
    namespaces,
  });
});
await web3wallet.core.pairing.pair({ uri });
  1. Sign Session Rejection
web3wallet.on("session_proposal", async (proposal) => {
  const session = await web3wallet.rejectSession({
    id: proposal.id,
    reason: getSdkError("USER_REJECTED_METHODS"),
  });
});
  1. Sign Session Disconnect
await web3wallet.disconnectSession({
  topic,
  reason: getSdkError("USER_DISCONNECTED"),
});
  1. Responding to Sign Session Requests
web3wallet.on("session_request", async (event) => {
  const { id, method, params } = event.request;
  await web3wallet.respondSessionRequest({ id, result: response });
});
  1. Updating a Sign Session
await web3wallet.updateSession({ topic, namespaces: newNs });
  1. Updating a Sign Session
await web3wallet.extendSession({ topic });
  1. Emit Sign Session Events
await web3wallet.emitSessionEvent({
  topic,
  event: {
    name: "accountsChanged",
    data: ["0xab16a96D359eC26a11e2C2b3d8f8B8942d5Bfcdb"],
  },
  chainId: "eip155:1",
});
  1. Handle Sign Events
web3wallet.on("session_proposal", handler);
web3wallet.on("session_request", handler);
web3wallet.on("session_delete", handler);
  1. SIWE with a dapp
const iss = `did:pkh:eip155:1:${address}`;
web3wallet.on("auth_request", async (event) => {
  // format the payload
  const message = web3wallet.formatMessage(event.params.cacaoPayload, iss);
  // prompt the user to sign the message
  const signature = await wallet.signMessage(message);
  // respond
  await web3wallet.respondAuthRequest(
    {
      id: args.id,
      signature: {
        s: signature,
        t: "eip191",
      },
    },
    iss,
  );
});

await web3wallet.core.pairing.pair({ uri: request.uri, activatePairing: true });
  1. Handle Auth Events
web3wallet.on("auth_request", handler);

Already using Sign or Auth? Check our migration guide

Versions

Current Tags

Version History

Package Sidebar

Install

npm i @walletconnect/web3wallet

Weekly Downloads

25,815

Version

1.10.3

License

Apache-2.0

Unpacked Size

2.71 MB

Total Files

34

Last publish

Collaborators

  • cyberdrk
  • nachosan
  • boidushya
  • huxwell
  • chris13524
  • crypblizz
  • devceline
  • gancho_walletconnect
  • iljadoesdev
  • bkrem
  • pedrouid