Skip to content

Wallets

Connectors are used to connect the user's wallet to your dapp. If you dapp requires the user to submit a transaction or sign a message, you must provide a list of supported wallets to Starknet React.

Connectors

This in an alphabetical list of connectors supported by Starknet React.

Injected Connector

An injected connector is a wallet that injects itself in the web page. This type of wallets are also known as "browser wallets".

Configure a new injected wallet with the following properties:

  • id (required): unique wallet id, used when injecting the wallet in the web page.
  • name (optional): human friendly name.
  • icon (optional): wallet icons, for both light and dark mode. Icons should be base 64 encoded svg images that developers can use as src properties on an img HTML tag.

Injected

This helper is useful to create a new connector with the provided StarknetWindowObject

import { StarknetInjectedWallet } from "@starknet-io/get-starknet-core";
 
const connector = new StarknetInjectedWallet(window.starknet_myWallet);

Ready Wallet (formerly Argent X)

The Ready Wallet (formerly Argent X) wallet is supported out of the box.

import { readyWallet } from "@starknet-io/get-starknet-core/wallets";
 
const wallets = [readyWallet];

Braavos

The Braavos wallet is supported out of the box.

import { braavos } from "@starknet-io/get-starknet-core/wallets";
 
const wallets = [braavos];

Cartridge Controller

The Cartridge Controller wallet is supported however, you need to install both the @cartridge/connector and @cartridge/controller packages.

The Controller enables seamless use of Session Keys.

pnpm i @cartridge/connector @cartridge/controller
// TODO: This Code has to be updated as per get-starknet standards.
import { ControllerConnector } from "@cartridge/connector";
import { Connector } from "@starknet-start/react";
import { constants } from "starknet";
 
// Without Session Keys
const connectors = [
  new ControllerConnector({
    chains: [
      {
        rpcUrl: "https://api.cartridge.gg/x/starknet/sepolia",
      },
      {
        rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet",
      },
    ],
    defaultChainId: constants.StarknetChainId.SN_SEPOLIA,
  }),
];
// TODO: This Code has to be updated as per get-starknet standards.
import { ControllerConnector } from "@cartridge/connector";
import { SessionPolicies } from "@cartridge/controller";
import { Connector } from "@starknet-start/react";
import { constants } from "starknet";
 
// Define session policies
const policies: SessionPolicies = {
  contracts: {
    "0x3f96056436be253753351fe689110ced7d53f5db3fd98f13df3f19058311b95": {
      name: "Example Contract",
      description: "Example contract interaction",
      methods: [
        {
          name: "Create",
          description: "Create a new instance",
          entrypoint: "create",
        },
      ],
    },
  },
};
 
// With Session Keys
const connectors = [
  new ControllerConnector({
    chains: [
      {
        rpcUrl: "https://api.cartridge.gg/x/starknet/sepolia",
      },
      {
        rpcUrl: "https://api.cartridge.gg/x/starknet/mainnet",
      },
    ],
    defaultChainId: constants.StarknetChainId.SN_SEPOLIA,
    policies,
  }),
];