Exciting news!Announcing our $4.6M Series Seed. Learn more
Socket
LoveBlogFAQ
Install
Log in

bls-wallet-clients

Package Overview
Dependencies
2
Maintainers
3
Versions
83
Issues
File Explorer

Advanced tools

bls-wallet-clients

Client libraries for interacting with BLS Wallet components

    0.6.0latest

Version published
Maintainers
3
Yearly downloads
4,828

Weekly downloads

Readme

Source

BLS Wallet Clients

Client libraries for interacting with BLS Wallet components

Network Config

Deployed contract addresses and metadata.

import { NetworkConfig, getConfig } from 'bls-wallet-clients'; const netCfg: NetworkConfig = await getConfig( '/path/to/network/config', async (path) => ... /* fetch, fs.readFile, etc. */ ); // Read from netCfg.addresses.verificationGateway, etc.

Aggregator

Exposes typed functions for interacting with the Aggregator's HTTP api.

import { Aggregator } from 'bls-wallet-clients'; const aggregator = new Aggregator('https://rinkarby.blswallet.org'); await aggregator.addTransaction(...);

BlsWalletWrapper

Wraps a BLS wallet, storing the private key and providing .sign(...) to produce a Bundle, that can be used with aggregator.addTransaction(...).

import { BlsWalletWrapper } from 'bls-wallet-clients'; const wallet = await BlsWalletWrapper.connect( privateKey, verificationGatewayAddress, provider, ); const bundle = wallet.sign({ nonce: await wallet.Nonce(), actions: [ { contract: someToken, // An ethers.Contract method: 'transfer', args: [recipientAddress, ethers.utils.parseUnits('1', 18)], }, // Additional actions can go here. When using multiple actions, they'll // either all succeed or all fail. ], }); await aggregator.addTransaction(bundle);

VerificationGateway

Exposes VerificationGateway and VerificationGateway__factory generated by typechain to enable typed interactions with the VerificationGateway.

import { VerificationGateway__factory } from 'bls-wallet-clients'; const verificationGateway = VerificationGateway__factory.connect( verificationGatewayAddress, signer, // An ethers signer ); await verificationGateway.processBundle(bundle);

Signer

Utilities for signing, aggregating and verifying transaction bundles using the bls signature scheme. Bundles are actioned in contracts.

Useful in the aggregator for verification and aggregation, and in the extension for signing and aggregation.

import ethers from "ethers"; import { initBlsWalletSigner } from "bls-wallet-clients"; (async () => { const signer = await initBlsWalletSigner({ chainId: 10 }); const privateKey = "0x...256 bits of private hex data here"; const someToken = new ethers.Contract( // See https://docs.ethers.io/v5/getting-started/ ); const bundle = signer.sign( { nonce: ethers.BigNumber.from(0), ethValue: ethers.BigNumber.from(0), contractAddress: someToken.address, // If you don't want to call a function and just send `ethValue` above, // use '0x' to signify an empty byte array here encodedFunction: someToken.interface.encodeFunctionData( "transfer", ["0x...some address...", ethers.BigNumber.from(10).pow(18)], ), }, privateKey, ); // Send bundle to an aggregator or use it with VerificationGateway directly. })();
Socket

Product

Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc