https://github.com/icehugh/btc-connect
Btc connect for unisat okx
https://github.com/icehugh/btc-connect
btc btc-wallet connect dapp okx unisat web3
Last synced: about 2 months ago
JSON representation
Btc connect for unisat okx
- Host: GitHub
- URL: https://github.com/icehugh/btc-connect
- Owner: IceHugh
- Created: 2024-03-23T08:37:22.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-12T09:34:28.000Z (7 months ago)
- Last Synced: 2025-03-20T23:07:49.453Z (2 months ago)
- Topics: btc, btc-wallet, connect, dapp, okx, unisat, web3
- Language: TypeScript
- Homepage:
- Size: 1.08 MB
- Stars: 15
- Watchers: 1
- Forks: 6
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BTC Connect
BTC Connect is a library that allows you to easily integrate Bitcoin wallets (Unisat and OKX) into your web application. With this library, you can enable your users to manage their Bitcoin addresses, send and receive transactions, and interact with Bitcoin wallets directly from your web app.
## Features
- Connect to popular Bitcoin wallets (Unisat and OKX)
- Manage Bitcoin addresses and check balances
- Send and receive Bitcoin transactions
- Sign messages and PSBTs
- Push transactions and PSBTs to the network
- Switch between different connectors and networks
- Customizable UI theme (light and dark)
- Typescript support
- Support for React components
- Support for pure JavaScript usage (compatible with Vue, vanilla JS, etc.)
## Installation
You can install the package via npm, yarn, pnpm or bun:
### npm
```bash
npm install btc-connect-core
```
### Yarn
```bash
yarn add btc-connect-core
```
### pnpm
```bash
pnpm add btc-connect-core
```
### bun
```bash
bun add btc-connect-core
```
## Requirements
For React:
- react (>=16.8.0)
- react-dom (>=16.8.0)
The library also uses the `zustand` state management library for React hooks.
## Usage
### React
Import the `WalletConnectReact` component and wrap your application with it:
```jsx
import React from 'react';
import { WalletConnectReact } from 'btc-connect/dist/react';
import "btc-connect/dist/style/index.css";
const App = () => {
const config = {
network: 'livenet', // or 'testnet'
defaultConnectorId: 'unisat', // or 'okx'
};
return (
{
// Handle successful connection
}}
theme="dark"
onConnectError={(error) => {
// Handle connection error
}}
onDisconnectSuccess={() => {
// Handle successful disconnection
}}
onDisconnectError={(error) => {
// Handle disconnection error
}}
>
{/* Your app components */}
);
};
export default App;
```
You can also use the `useReactWalletStore` hook to access the wallet store and perform various actions:
```jsx
import React from 'react';
import { useReactWalletStore } from 'btc-connect/dist/react';
const MyComponent = () => {
const walletStore = useReactWalletStore();
const connect = () => {
walletStore.connect();
};
const disconnect = () => {
walletStore.disconnect();
};
const sendBitcoin = async () => {
const toAddress = '...';
const amount = 1000;
const txid = await walletStore.btcWallet?.sendToAddress(toAddress, amount);
console.log('Transaction ID:', txid);
};
return (
Connect
Disconnect
Send Bitcoin
);
};
export default MyComponent;
```
### Pure JavaScript
You can use the `BtcWalletConnect` class directly in your JavaScript code:
```javascript
import BtcWalletConnect from 'btc-connect-core';
const config = {
network: 'livenet',
};
const btcWallet = new BtcWalletConnect(config);
// Connect to the wallet
btcWallet.connect()
.then(() => {
// Handle successful connection
})
.catch((error) => {
// Handle connection error
});
// Send Bitcoin
const toAddress = '...';
const amount = 1000;
btcWallet.sendToAddress(toAddress, amount)
.then((txid) => {
console.log('Transaction ID:', txid);
})
.catch((error) => {
// Handle error
});
// Disconnect from the wallet
btcWallet.disconnect()
.then(() => {
// Handle successful disconnection
})
.catch((error) => {
// Handle disconnection error
});
```
This pure JavaScript usage makes it compatible with Vue, vanilla JavaScript, and other frameworks or libraries.
For more detailed information and examples, please refer to the [Doc](https://github.com/IceHugh/btc-connect/doc.md).
## TODO
- Support for Vue components
## Contributing
Contributions are welcome! Please read the [contributing guidelines](https://github.com/IceHugh/btc-connect/blob/main/CONTRIBUTING.md) for more information.
## License
BTC Connect is licensed under the [MIT License](https://github.com/IceHugh/btc-connect/blob/main/LICENSE).
## Support and Donation
If you find this project helpful and you would like to support its continued development, feel free to make a donation through one of the following methods. Your support is a tremendous encouragement for us!
## Cryptocurrency
You can also donate using the following cryptocurrency addresses:
- BTC: bc1pnacumj3jhn28x8lwj5fqfwzxcq0kfhyrtzadd4unlg4cu57mp3wghp0j73
Thank you to every supporter for your contributions!