sats-wagmi is a library with a handful of BTC wallet connectors, leaving aside the need of the developer to integrate each one individually. The library also exports useful React hooks that mimic the standard followed in the original EVM wagmi library.
The package is still in an infancy state, but feel free to recommend any adjustments that you see fit.
- 🚀 Features
- 📦 Installation
- 💻 Usage
- 📝 Contributing
- ⚖️ License
- BTC Wallet connectors:
- Metamask Snap
- Unisat
- Leather
- Xverse
- Bitget (soon)
- BTC functionality:
- send bitcoin
- inscribe (text and images)
- send inscription
- sign input (psbt)
- React hooks
To use sats-wagmi, all you need to do is install the
@gobob/sats-wagmi
:
# with Yarn
$ yarn add @gobob/sats-wagmi
# with npm
$ npm i @gobob/sats-wagmi
# with pnpm
$ pnpm add @gobob/sats-wagmi
# with Bun
$ bun add @gobob/sats-wagmi
import { MMSnapConnector } from './connectors';
const mmSnap = new MMSnapConnector(network);
mmSnap.connect();
- Wrap your application with the
SatsWagmiConfig
provided by @gobob/sats-wagmi.
import { SatsWagmiConfig } from '@gobob/sats-wagmi';
// Do this at the root of your application
function App({ children }) {
return <SatsWagmiConfig network='testnet'>{children}</SatsWagmiConfig>;
}
- Now start by connecting:
import { useConnect, SatsConnector } from '@gobob/sats-wagmi';
function Example() {
const { connectors, connect } = useConnect();
const handleConnect = (connector: SatsConnector) => {
connect({
connector
});
};
return (
<div>
{connectors.map((connector) => (
<button key={connector.name} onClick={() => handleConnect(connector)}>
{connector.name}
</button>
))}
</div>
);
}
- Once connected, you should be able to use the connector utility and have access to the connected BTC account:
import { useConnect, SatsConnector } from '@gobob/sats-wagmi';
function Example() {
const { address, connector } = useSatsAccount();
const handleTransfer = () => {
connector?.sendToAddress('tb1p9gl248kp19jgennea98e2tv8acfrvfv0yws2tc5j6u72e84caapsh2hexs', 100000000);
};
return (
<div>
<p>Address: {address}</p>
<button onClick={handleTransfer}>Transfer 1 BTC</button>
</div>
);
}
Contributions are always welcome!
See CONTRIBUTING.md for ways to get started.