An open API service indexing awesome lists of open source software.

https://github.com/starknet-io/get-starknet

StarkNet wallet <-> dApp bridge
https://github.com/starknet-io/get-starknet

Last synced: about 2 months ago
JSON representation

StarkNet wallet <-> dApp bridge

Awesome Lists containing this project

README

        

# get-starknet

[![npm](https://img.shields.io/npm/v/get-starknet.svg)](https://www.npmjs.com/package/get-starknet)

## Goals

- â¤ī¸â€đŸŠš Allow Starknet dApps and wallets to seamlessly connect
- đŸĒļ Lightweight and easy to use
- 🏎 Fast integration, building and testing
- âš™ī¸ Customizable and extensible
- 🌍 Open source and controlled by the community

## Installation

```
# using npm
npm install @starknet-io/get-starknet starknet@next

# using yarn
yarn add @starknet-io/get-starknet starknet@next

# using pnpm
pnpm add @starknet-io/get-starknet starknet@next
```

Read more about the new Starkent Dapp<>Wallet API in the
[post](https://community.starknet.io/t/new-starknet-wallet-dapp-api/114295)

## Usage for dApp developers

You can use the built-in UI to connect to any Starknet wallet as fast as
possible like this:

```tsx
import { connect, disconnect } from "@starknet-io/get-starknet"

return connect()}>Connect wallet
```

### Advanced usage

You can also choose to customize the UI by overwriting the CSS classes, or by
implementing your very own UI. This is possible due to a split into a `core` and
`ui` package. As a library author or dapp developer who wants to implement a
custom UI, you can use the `core` package.

```tsx
import {
disconnect,
enable,
getAvailableWallets,
getDiscoveryWallets,
getLastConnectedWallet,
getPreAuthorizedWallets,
} from "@starknet-io/get-starknet-core"

interface GetStarknetResult {
// Returns all wallets available in the window object
getAvailableWallets: (
options?: GetWalletOptions,
) => Promise
// Returns only preauthorized wallets available in the window object
getPreAuthorizedWallets: (
options?: GetWalletOptions,
) => Promise
// Returns all wallets in existence (from discovery file)
getDiscoveryWallets: (options?: GetWalletOptions) => Promise
// Returns the last wallet connected when it's still connected
getLastConnectedWallet: () => Promise
// Connects to a wallet
enable: (
wallet: StarknetWindowObject,
options?: {
starknetVersion?: "v4" | "v5"
},
) => Promise
// Disconnects from a wallet
disconnect: (options?: { clearLastWallet?: boolean }) => Promise
}
```

## Development

You need Node and pnpm installed. Make sure to clone this repo and run:

```bash
pnpm install
pnpm build
```

To start watching for changes, run:

```bash
pnpm dev
```

and open `http://localhost:5173/`

### Running tests

For running tests:

```bash
pnpm test
```