https://github.com/getwax/bls-wallet

Core components to use layer 2 smart contract wallets with the BLS signature scheme
https://github.com/getwax/bls-wallet

Last synced: 3 months ago
JSON representation

Core components to use layer 2 smart contract wallets with the BLS signature scheme

• Host: GitHub
• URL: https://github.com/getwax/bls-wallet
• Owner: getwax
• License: mit
• Archived: true
• Created: 2021-10-17T23:13:51.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-08-15T15:06:17.000Z (about 1 year ago)
• Last Synced: 2024-04-18T12:51:22.599Z (7 months ago)
• Language: TypeScript
• Size: 9.23 MB
• Stars: 177
• Watchers: 4
• Forks: 43
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![BLS Wallet](./docs/images/bls-github-banner.svg)

## What is BLS Wallet?

A set of components to bring lower gas costs to EVM rollups via aggregated [BLS signatures](https://en.wikipedia.org/wiki/BLS_digital_signature). Our smart contract wallet supports recovery, atomic multi-action operations, sponsored transactions and user-controlled upgradability.

You can watch a full end-to-end demo of the project [here](https://www.youtube.com/watch?v=MOQ3sCLP56g).

## Getting Started

- See an [overview](./docs/system_overview.md) of BLS Wallet & how the components work together.

- Use BLS Wallet in [a browser/NodeJS/Deno app](./docs/use_bls_wallet_clients.md).

- Use BLS Wallet in [your L2 dApp](./docs/use_bls_wallet_dapp.md) for cheaper, multi action transactions.

- Use BLS Wallet components and features with an [ethers.js provider and signer](./use_bls_provider.md)

### Setup your development environment

- [Local development](./docs/local_development.md)

- [Remote development](./docs/remote_development.md)

## Components

[contracts](./contracts/)

Solidity smart contracts for wallets, BLS signature verification, and deployment/testing tools.

[aggregator](./aggregator/)

Service which accepts BLS signed transactions and bundles them into one for submission.

[aggregator-proxy](./aggregator-proxy/)

npm package for proxying to another aggregator instance.

[bls-wallet-clients](./contracts/clients/)

npm package which provides easy to use constructs to interact with the contracts and aggregator.

[extension](./extension/)

Prototype browser extension used to manage BLS Wallets and sign transactions.

## Contract Deployments

See the [networks directory](./contracts/networks/) for a list of all contract deployment (network) manifests. Have an L2/rollup testnet you'd like BLS Wallet deployed on? [Open an issue](https://github.com/web3well/bls-wallet/issues/new) or [Deploy it yourself](./docs/remote_development.md)

- [Arbitrum Goerli](./contracts/networks/arbitrum-goerli.json)

- [Optimism Goerli](./contracts/networks/optimism-goerli.json)

## Ways to Contribute

- [Work on an open issue](https://github.com/web3well/bls-wallet/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)

- [Use BLS Wallet](./docs/use_bls_wallet_clients.md) in your project and [share it with us](https://github.com/web3well/bls-wallet/discussions)

- [Report a bug or request a feature](https://github.com/web3well/bls-wallet/issues/new)

- [Ask a question or answer an existing one](https://github.com/web3well/bls-wallet/discussions)

- [Try or add to our documentation](https://github.com/web3well/bls-wallet/tree/main/docs)

See our [contribution instructions & guidelines](./CONTRIBUTING.md) for more details.