https://github.com/gnosisguild/react-multisend
A headless React library for crafting multi-send transactions from a Gnosis Safe
https://github.com/gnosisguild/react-multisend
dao dao-interface ethereum gnosis-safe headless multi-send react zodiac
Last synced: 8 months ago
JSON representation
A headless React library for crafting multi-send transactions from a Gnosis Safe
- Host: GitHub
- URL: https://github.com/gnosisguild/react-multisend
- Owner: gnosisguild
- License: lgpl-3.0
- Created: 2021-09-30T11:19:14.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-11-13T08:41:47.000Z (over 2 years ago)
- Last Synced: 2025-08-09T14:36:02.539Z (10 months ago)
- Topics: dao, dao-interface, ethereum, gnosis-safe, headless, multi-send, react, zodiac
- Language: TypeScript
- Homepage: https://gnosis.github.io/react-multisend/
- Size: 7.39 MB
- Stars: 9
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# react-multisend
[](https://github.com/gnosis/react-multisend/actions/workflows/ci.yml)
[](https://github.com/gnosis/CODE_OF_CONDUCT)
A headless React library for crafting multi-send transactions from a Gnosis Safe
## The problem
DAO governance proposals typically include a set of transactions, which can be encoded into a single multi-send transaction for execution from the DAO's Gnosis Safe when the vote passes.
On the user interface level, this requires components for creating and displaying batches of arbitrary transactions in an easy and understandable way.
## This solution
This library offers a set of hooks and utility functions for building React components that allow users to craft transactions for execution from a Gnosis Safe:
- [useSafeBalances](#useSafeBalances) for listing a Gnosis Safe's ETH and ERC20 balances
- [useSafeCollectibles](#useSafeCollectibles) for listing a Gnosis Safe's NFT holdings
- [useContractCall](#useContractCall) for querying contract ABIs and managing input values for contract function calls
- [encodeMulti](#encodeMulti) for encoding a set of transactions into a multi-send transaction batch
Rather than offering ready-to-use UI components, react-multisend is a toolkit of primitives enabling developers of DAO tools to build user interfaces using their own UX patterns and design system components.
## Docs & example application
For examples on how to use the hooks, check out our [documentation](https://gnosis.github.io/react-multisend/).
These example components are a good starting point for creating your own components.
## Installation
This module is distributed via npm. For adding it to your project, run:
```
npm install --save react-multisend
```
To install it using yarn, run:
```
yarn add react-multisend
```
This package also depends on `react`. Please make sure you have it installed as well.