# @raydeck/usemetamask

Latest version **1.2.0** (published 2022-08-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install @raydeck/usemetamask
pnpm add @raydeck/usemetamask
yarn add @raydeck/usemetamask
bun add @raydeck/usemetamask
```

Provides the command `usemetamask`.

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2022-08-19 |
| First published | 2022-07-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 33.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Ray Deck |
| Maintainers | raydeck |

## Links

- npm: https://www.npmjs.com/package/@raydeck/usemetamask
- Repository: https://github.com/rhdeck/usemetamask
- Homepage: https://github.com/rhdeck/usemetamask#README
- Issues: https:/github.com/rhdeck/usemetamask/issues
- npm.io page: https://npm.io/package/@raydeck/usemetamask

## Dependencies (3)

- [inquirer](https://npm.io/package/inquirer.md) ^7.3.3
- [commander](https://npm.io/package/commander.md) ^6.2.1
- [@raydeck/metamask-ts](https://npm.io/package/@raydeck/metamask-ts.md) ^1.0.2

## Recent versions

- 1.2.0 (latest) — 2022-08-19
- 1.1.0 — 2022-07-18
- 1.0.2 — 2022-07-10
- 1.0.1 — 2022-07-10
- 1.0.0 — 2022-07-10

## README

<a name="readmemd"></a>

# @raydeck/usemetamask
React Components and hooks for interacting with metamask. Built with [metamask-ts](https://npmjs.com/package/@raydeck/metamask-ts)

<a name="_librarymd"></a>

@raydeck/usemetamask - v1.2.0

# @raydeck/usemetamask - v1.2.0

## Table of contents

### Hooks Functions

- [useAccount](#useaccount)
- [useAccounts](#useaccounts)
- [useChainId](#usechainid)
- [useConnected](#useconnected)
- [useMessage](#usemessage)
- [useReloadOnChainChange](#usereloadonchainchange)

### Other Functions

- [MetamaskConnected](#metamaskconnected)
- [MetamaskDisconnected](#metamaskdisconnected)
- [MetamaskInstalled](#metamaskinstalled)
- [MetamaskNotInstalled](#metamasknotinstalled)
- [MetamaskProvider](#metamaskprovider)
- [MetamaskWrongChain](#metamaskwrongchain)

## Hooks Functions

### useAccount

▸ **useAccount**(): `string`

Returns the current account

**`Example`**

```ts
import { useAccount } from "@raydeck/usemetamask";
const account = useAccount();
```

**`Export`**

#### Returns

`string`

string

___

### useAccounts

▸ **useAccounts**(): `string`[]

Returns the current accounts

**`Example`**

```ts
import { useAccounts } from "@raydeck/usemetamask";
const accounts = useAccounts();
```

**`Export`**

#### Returns

`string`[]

string[]

___

### useChainId

▸ **useChainId**(): `string`

**`Example`**

```ts
import { useChainId } from "@raydeck/usemetamask";
const chainId = useChainId();
```

**`Export`**

#### Returns

`string`

The current chain ID.

___

### useConnected

▸ **useConnected**(): `boolean`

Returns whether the wallet is connected to this site.

**`Example`**

```ts
import { useConnected } from "@raydeck/usemetamask";
const connected = useConnected();
```

**`Export`**

#### Returns

`boolean`

boolean.

___

### useMessage

▸ **useMessage**(): `ProviderMessage`

Returns the current message

**`Example`**

```ts
import { useMessage } from "@raydeck/usemetamask";
const message = useMessage();
```

**`Export`**

#### Returns

`ProviderMessage`

ProviderMessage

___

### useReloadOnChainChange

▸ **useReloadOnChainChange**(): `void`

Trigger a window reload when the chain changes. (best practice)

**`Export`**

**`Example`**

```ts
import { useChainChanged } from "@raydeck/usemetamask";
useChainChanged();
```

#### Returns

`void`

___

## Other Functions

### MetamaskConnected

▸ **MetamaskConnected**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.chainIds?` | `string`[] |
| `props.children` | `ReactNode` |
| `props.unconnected?` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

___

### MetamaskDisconnected

▸ **MetamaskDisconnected**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.chainId?` | `string` |
| `props.children` | `ReactNode` |
| `props.connected?` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

___

### MetamaskInstalled

▸ **MetamaskInstalled**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.children` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

___

### MetamaskNotInstalled

▸ **MetamaskNotInstalled**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.children` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

___

### MetamaskProvider

▸ **MetamaskProvider**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.children` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

___

### MetamaskWrongChain

▸ **MetamaskWrongChain**(`props`, `context?`): ``null`` \| `ReactElement`<`any`, `any`\>

#### Parameters

| Name | Type |
| :------ | :------ |
| `props` | `Object` |
| `props.chainIds?` | `string`[] |
| `props.children` | `ReactNode` |
| `props.unconnected?` | `ReactNode` |
| `context?` | `any` |

#### Returns

``null`` \| `ReactElement`<`any`, `any`\>

---
_Source: https://npm.io/package/@raydeck/usemetamask · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
