8000 GitHub - silius-rs/silius: ERC-4337 (Account Abstraction) - modular and efficient bundler implementation in Rust.
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content
/ silius Public

ERC-4337 (Account Abstraction) - modular and efficient bundler implementation in Rust.

silius.rs/

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
265 stars 42 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

silius-rs/silius

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

601 Commits
.cargo
.cargo
 
 
.github
.github
 
 
.idea
.idea
 
 
assets
assets
 
 
bin/silius
bin/silius
 
 
book
book
 
 
bundler-spec-tests
bundler-spec-tests
 
 
crates
crates
 
 
docs
docs
 
 
examples
examples
 
 
scripts
scripts
 
 
tests
tests
 
 
.dockerignore
.dockerignore
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
CNAME
CNAME
 
 
CODEOWNERS
CODEOWNERS
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
Cargo.lock
Cargo.lock
 
 
Cargo.toml
Cargo.toml
 
 
Cross.toml
Cross.toml
 
 
Dockerfile
Dockerfile
 
 
Dockerfile.cross
Dockerfile.cross
 
 
LICENSE-APACHE
LICENSE-APACHE
 
 
LICENSE-MIT
LICENSE-MIT
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
book.toml
book.toml
 
 
docker-compose.yml
docker-compose.yml
 
 
rust-toolchain.toml
rust-toolchain.toml
 
 
rustfmt.toml
rustfmt.toml
 
 
tomlfmt.toml
tomlfmt.toml
 
 

Repository files navigation

Silius

CI workflow Docker workflow Telegram Group GitHub stars GitHub forks

Silius - ERC-4337 (Account Abstraction) bundler implementation in Rust.

For more information: https://hackmd.io/@Vid201/aa-bundler-rust

This project is still under active development.

Getting started

Native

Prerequisites:

Rust version: 1.81.0

  1. libclang-dev, pkg-config and libssl-dev on Debian/Ubuntu.
  2. Ethereum execution client JSON-RPC API with enabled debug_traceCall. For production, you can use Geth or Erigon. For testing, we are using Geth dev mode (tested with v1.14.11); so you need to install Geth for running tests.
  3. solc.
  4. cargo-sort and cargo-udeps.

Set up third-party dependencies (ERC-4337 smart contracts and bundler tests):

make fetch-thirdparty
make setup-thirdparty

Create wallet for bundler:

cargo run --release -- create-wallet --output-path ${HOME}/.silius --chain-id 5

Run bundler (with user operation pool and JSON-RPC API):

cargo run --release -- node --eth-client-address http://127.0.0.1:8545 --mnemonic-file ${HOME}/.silius/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --beneficiary 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --entry-points 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 --http --ws

Run only bundling component:

cargo run --release -- bundler --eth-client-address ws://127.0.0.1:8546 --mnemonic-file ${HOME}/.silius/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --beneficiary 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --entry-points 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789

Run only user operation pool:

cargo run --release -- uopool --eth-client-address ws://127.0.0.1:8546 --entry-points 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789

Run only JSON-RPC API:

cargo run --release -- rpc --http --ws
< 8000 div class="markdown-heading" dir="auto">

Docker

docker run --net=host -v ./bundler-spec-tests/keys/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266:/data/silius/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 -v ./.local/db:/data/silius/db ghcr.io/silius-rs/silius:latest node --eth-client-address http://127.0.0.1:8545 --datadir data/silius --mnemonic-file data/silius/0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --beneficiary 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266 --entry-points 0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789 --http --http.addr 0.0.0.0 --http.port 3000 --http.api eth,debug,web3 --ws --ws.addr 0.0.0.0 --ws.port 3001 --ws.api eth,debug,web3 --eth-client-proxy-address http://127.0.0.1:8545

Supported networks

Silius was tested on the following networks, and some public endpoints are available for testing. If you have problems with any endpoint below, you are welcome to fire an issue.

Chain Supported Status Public RPC URL
Ethereum ✔️ https://rpc.silius.xyz/api/v1/chain/ethereum-mainnet
Ethereum Sepolia ✔️ https://rpc.silius.xyz/api/v1/chain/ethereum-sepolia
Ethereum Holesky ✔️ https://rpc.silius.xyz/api/v1/chain/ethereum-holesky
Polygon ✔️ https://rpc.silius.xyz/api/v1/chain/polygon-mainnet
Linea ✔️ https://rpc.silius.xyz/api/v1/chain/linea-mainnet
Optimism ✔️ https://rpc.silius.xyz/api/v1/chain/optimism-mainnet
Optimism Sepolia ✔️ https://rpc.silius.xyz/api/v1/chain/optimism-sepolia
Arbitrum ✔️ https://rpc.silius.xyz/api/v1/chain/arbitrum-mainnet
Arbitrum Sepolia ✔️ https://rpc.silius.xyz/api/v1/chain/arbitrum-sepolia
BSC ✔️ https://rpc.silius.xyz/api/v1/chain/bsc-mainnet
BSC Testnet ✔️ https://rpc.silius.xyz/api/v1/chain/bsc-testnet
Base ✔️ https://rpc.silius.xyz/api/v1/chain/base-mainnet
Base Sepolia ✔️ https://rpc.silius.xyz/api/v1/chain/base-sepolia
Avalanche ✔️ https://rpc.silius.xyz/api/v1/chain/avalanche-mainnet
Avalanche Fuji ✔️ https://rpc.silius.xyz/api/v1/chain/avalanche-fuji
Blast ✔️ https://rpc.silius.xyz/api/v1/chain/blast-mainnet
Blast Sepolia ✔️ https://rpc.silius.xyz/api/v1/chain/blast-sepolia

Bundler's account: 0x0a4E15d25E97e747bD568979A3B7dbEb95970Eb3

You can also try the Silius on any other EVM network, but you may encounter some problems (e.g., gas calculating differences on L2s) - please use it at our own risk! You are always welcome to open up a new issue when you meet any problem. ⚠️

Supported entry point

The address of the entry point smart contract is the same on all EVM networks.

Address Version Commit Audited
0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789 0.6.0 9b5f2e4 April 2023

Paymasters and account factories

You can find a list of many paymasters and account factories here.

Examples

To get started, check the examples here. More examples will be added in the future.

Contributing

Thank you for showing interest in contributing to the project!

There is a contributing guide to help get you started.

There are some additional prerequisites for testing:

  1. geth

Before making a PR, make sure to run the following commands:

make format
make lint
make test

Official bundler spec tests developed by the eth-infinitism team are also included in the repo's CI pipeline (commit: 6209cdeaba48105cd7352468844be3882e7f3f23). You can find more information on how to run tests here. Make sure your contribution doesn't break the tests!

Contact

The best place for the discussion is the dedicated Telegram group.

Authors

Projects using Silius

Licenses

This project is dual-licensed under Apache 2.0 and MIT terms:

Donations

Silius is an open-source project and a public good. If you want to help the project, you can send donations of any size via:

  • Ethereum address: 0x7cB801446AC4f5EA8f7333EFc58ab787eB611558

Acknowledgements

About

ERC-4337 (Account Abstraction) - modular and efficient bundler implementation in Rust.

silius.rs/

Topics

rust bundler modular ethereum p2p account-abstraction eip-4337 erc-4337

Resources

Readme

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Activity
Custom properties

Stars

265 stars

Watchers

8 watching

Forks

42 forks
Report repository

Releases

5 tags

Packages

 
 
 

Contributors 5

Languages

0