LumeWeb
/
ethers-rs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Complete Ethereum & Celo library and wallet implementation in Rust. https://docs.rs/ethers
504 Commits 2 Branches 30 Tags 16 MiB
Rust 99.6%
Shell 0.3%
Go to file
Georgios Konstantopoulos bfdf70cbea
feat(solc): allow providing --allow-args (#553) 
* feat(solc): allow providing additional arguments

* feat(solc): allow providing --allow-args

* feat: more allow paths integration (#565)

* feat: more allow paths integration

* Update ethers-solc/src/compile.rs

Co-authored-by: Georgios Konstantopoulos <me@gakonst.com>

* chore: only enable macros if feature is enabled

* test: add tests for multiple libs

* chore: fix solc test

* chore: only pas --allow-paths if there are any paths needed

Co-authored-by: Matthias Seitz <matthias.seitz@outlook.de>
 		2021-11-08 22:11:45 +02:00
.github ci: remove failing workflow 2021-11-06 19:34:18 +00:00
bin docs: add contributing.md 2020-06-15 18:05:29 +03:00
ethers-contract Refactor crate determination in new ethers-macro crate (#555) 2021-11-05 15:00:01 +02:00
ethers-core fix: lift macros feature to lib level (#567) 2021-11-08 22:08:03 +02:00
ethers-etherscan chore: add rustfmt.toml (#537) 2021-10-29 14:29:35 +02:00
ethers-middleware feat: use ethers_solc::Solc instead of ethers_core::utils::Solc (#546) 2021-10-31 13:34:51 +02:00
ethers-providers chore(deps): bump auto_impl from 0.4.1 to 0.5.0 (#564) 2021-11-08 09:43:55 +00:00
ethers-signers (fix): new_keystore returns uuid as well (#559) 2021-11-05 12:28:16 +02:00
ethers-solc feat(solc): allow providing --allow-args (#553) 2021-11-08 22:11:45 +02:00
examples fix: failing test and check --all-targets in ci (#560) 2021-11-05 19:58:03 +02:00
scripts ci: run examples in CI (#421) 2021-08-30 14:00:30 +03:00
src feat: use ethers_solc::Solc instead of ethers_core::utils::Solc (#546) 2021-10-31 13:34:51 +02:00
tests chore: add rustfmt.toml (#537) 2021-10-29 14:29:35 +02:00
.gitignore derive-eip712: initial implementation of eip712 derive macro (#481) 2021-10-08 16:22:51 +01:00
CHANGELOG.md (fix): new_keystore returns uuid as well (#559) 2021-11-05 12:28:16 +02:00
CONTRIBUTING.md Refactor crate determination in new ethers-macro crate (#555) 2021-11-05 15:00:01 +02:00
Cargo.lock chore(deps): bump cargo_metadata from 0.14.0 to 0.14.1 (#563) 2021-11-08 09:44:04 +00:00
Cargo.toml feat(solc): Multiple Solc Version detection (#551) 2021-11-03 10:05:09 +02:00
LICENSE-APACHE Dual license under MIT/Apache 2 (#28) 2020-06-18 08:20:20 +03:00
LICENSE-MIT Dual license under MIT/Apache 2 (#28) 2020-06-18 08:20:20 +03:00
README.md chore: add rustfmt.toml (#537) 2021-10-29 14:29:35 +02:00
rustfmt.toml chore: add rustfmt.toml (#537) 2021-10-29 14:29:35 +02:00

README.md

ethers.rs

Complete Ethereum and Celo wallet implementation and utilities in Rust

Github Actions Telegram Chat Crates.io

Documentation

Extensive documentation and examples are available here.

Alternatively, you may clone the repository and run cd ethers/ && cargo doc --open

You can also run any of the examples by executing: cargo run -p ethers --example <name>

Add ethers-rs to your repository

[dependencies]

ethers = { git = "https://github.com/gakonst/ethers-rs" }

Running the tests

Tests require the following installed:

  1. solc. We also recommend using solc-select for more flexibility.
  2. ganache-cli

In addition, it is recommended that you set the ETHERSCAN_API_KEY environment variable for the abigen via Etherscan tests. You can get one here.

EVM-compatible chains support

There are many chains live which are Ethereum JSON-RPC & EVM compatible, but do not yet have support for EIP-2718 Typed Transactions. This means that transactions submitted to them by default in ethers-rs will have invalid serialization. To address that, you must use the legacy feature flag:

[dependencies]

ethers = { git = "https://github.com/gakonst/ethers-rs", features = ["legacy"] }

Celo Support

Celo support is turned on via the feature-flag celo:

[dependencies]

ethers = { git = "https://github.com/gakonst/ethers-rs", features = ["celo"] }

Celo's transactions differ from Ethereum transactions by including 3 new fields:

  • fee_currency: The currency fees are paid in (None for CELO, otherwise it's an Address)
  • gateway_fee_recipient: The address of the fee recipient (None for no gateway fee paid)
  • gateway_fee: Gateway fee amount (None for no gateway fee paid)

The feature flag enables these additional fields in the transaction request builders and in the transactions which are fetched over JSON-RPC.

Features

  • Ethereum JSON-RPC Client
  • Interacting and deploying smart contracts
  • Type safe smart contract bindings code generation
  • Querying past events
  • Event monitoring as Streams
  • ENS as a first class citizen
  • Celo support
  • Websockets / eth_subscribe
  • Hardware Wallet Support
  • Parity APIs (tracing, parity_blockWithReceipts)
  • Geth TxPool API
  • WASM Bindings
  • FFI Bindings
  • CLI for common operations

Getting Help

First, see if the answer to your question can be found in the API documentation. If the answer is not there, try opening an issue with the question.

Join the ethers-rs telegram to chat with the community!

Contributing

Thanks for your help improving the project! We are so happy to have you! We have a contributing guide to help you get involved in the ethers-rs project.

If you make a Pull Request, do not forget to add your changes in the CHANGELOG and ensure your code if properly formatted with cargo +nightly fmt and clippy is happy cargo clippy, you can even try to let clippy fix simple issues itself: cargo +nightly clippy --fix -Z unstable-options

Related Projects

This library would not have been possibly without the great work done in:

A lot of the code was inspired and adapted from them, to a unified and opinionated interface, built with async/await and std futures from the ground up.

Projects using ethers-rs