emmaodia / sdk-examples

SDK by Example

This repository contains a set of examples that demonstrate how to use the Biconomy SDk smart-account to build decentralised applications. The SmartAccount package generates a smart wallet contract for each user EOA. It takes a provider, provider can be anything, here we have different examples of providers.

Important Links

• Biconomy Docs
• Contract Addresses

This is a cli to demonstrate how to use a private key to sign transactions on the backend with new Biconomy SDK. To enable logging export below flag export BICONOMY_SDK_DEBUG=true

Set numOfParallelUserOps in config to the desired number if you want to execute parallel userOps

1. Setup

bun i

2. Edit your config.json file

Retrieve relevant bundlerUrl / paymaster api keys from the biconomy dashboard.

• bundlerUrl
• biconomyPaymasterApiKey

3. Run

bun run smartAccount --help
# get scw address

# update the correct privateKey, biconomyPaymasterUrl, rpcUrl and bundlerUrl in config.json
bun run smartAccount address

## Sessions

# single session with sponsorship
bun run smartAccount session --mode=CREATE
bun run smartAccount session --mode=USE

# single session with token payment
bun run smartAccount session --mode=CREATE --token=true
bun run smartAccount session --mode=USE --token=true

# batch session with token payment
bun run smartAccount session --mode=CREATE --token=true --batch=true
bun run smartAccount session --mode=USE --token=true --batch=true

## Gasless - Sponsorship Paymaster
bun run smartAccount deploy
bun run smartAccount mint
bun run smartAccount batchMint

## Gasless - Sponsorship Paymaster to send parallel userOps
bun run smartAccount mint --mode=PARALLEL_USER_OPS

# replace the receiver below
bun run smartAccount transfer --to=0x1234567890123456789012345678901234567890 --amount=0.001

# replace the token address and receiver below
bun run smartAccount erc20Transfer --to=0x1234567890123456789012345678901234567890 --amount=0.1 --token=0xeaBc4b91d9375796AA4F69cC764A4aB509080A58

## ERC20 - Token Paymaster
bun run smartAccount deploy --mode=TOKEN
bun run smartAccount mint --mode=TOKEN
bun run smartAccount batchMint --mode=TOKEN

## ERC20 - Token Paymaster to send parallel userOps

bun run smartAccount mint --mode=TOKEN_PARALLEL_USER_OPS

# replace the receiver below
bun run smartAccount transfer --to=0x1234567890123456789012345678901234567890 --amount=0.001 --mode=TOKEN

# replace the token address and receiver below
bun run smartAccount erc20Transfer --to=0x2cf491602ad22944D9047282aBC00D3e52F56B37 --amount=0.1 --token=0x1AF3F329e8BE154074D8769D1FFa4eE058B1DBc3 --mode=TOKEN