An all-in-one SDK for building frontend applications on VeChain, supporting wallet integration, developer hooks, pre-built UI components, and more.

<div align="center">
    <img src="https://prod-vechainkit-docs-images-bucket.s3.eu-west-1.amazonaws.com/vechain-kit-v2-shocase.png" alt="VeChain Kit Banner">
</div>

### Introduction

VeChain Kit is a comprehensive SDK designed to make building frontend applications on VeChain fast and straightforward. It offers:

-   <b>Seamless Wallet Integration:</b> Support for VeWorld, Sync2, WalletConnect, and social logins.
-   <b>Developer-Friendly Hooks:</b> Easy-to-use React Hooks that let you read and write data on the VeChainThor blockchain.
-   <b>Token Operations:</b> Send and swap tokens, check balances, manage VET domains, and more—all in one place.
-   <b>Pre-Built UI Components:</b> Ready-to-use components (e.g., TransactionModal) to simplify wallet operations and enhance your users’ experience.

> **Note**: Currently supports React and Next.js only

### Resources

-   [Live Demo](https://vechainkit.vechain.org/)
-   [Documentation](https://docs.vechainkit.vechain.org/)

### Quicks Start

#### Install dependencies

```bash
yarn add @tanstack/react-query@"^5.64.2" @chakra-ui/react@"^2.8.2" @vechain/dapp-kit-react@"2.1.0-rc.1" @vechain/vechain-kit
```

#### Basic Usage

Wrap your app with the VeChainKitProvider:

```typescript
'use client';

import { VeChainKitProvider } from '@vechain/vechain-kit';

export function Providers({ children }: { children: React.ReactNode }) {
    return (
        <VeChainKitProvider network={{ type: 'test' }}>
            {children}
        </VeChainKitProvider>
    );
}
```

#### Login

```typescript
'use client';

import { WalletButton } from '@vechain/vechain-kit';

export function Page() {
    return <WalletButton />;
}
```

# Troubleshooting

Are you having issues using the kit?

-   Check our [Troubleshooting](https://docs.vechainkit.vechain.org/vechain-kit/troubleshooting) section.
-   Contact us on [Discord](https://discord.gg/wGkQnPpRVq)
-   Open an issue on [Github](https://github.com/vechain/vechain-kit/issues)
