Complete Ethereum & Celo library and wallet implementation in Rust. https://docs.rs/ethers
Go to file
Georgios Konstantopoulos 95fcbe5240
feat: ledger support (#66)
* feat: ledger support

Adds support for Ledger Nano S Eth app (v1.3.7)

- sign message
- sign transaction
- get addresses
- get app version

* fix: fix eth docstring

* fix: take into account EIP155

* feat: convert Signer to async

* feat: implement Signer for Ledger

* ci: run celo-only tests explicitly

This is done to avoid using --all-features

* fix: remove async from with_signer

* chore: fix doctests

* fix: add Send/Sync to SignerError

* ci: update etherscan key

* test: disable etherscan abigen tests temporarily
2020-09-20 18:17:02 +03:00
.github feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
bin docs: add contributing.md 2020-06-15 18:05:29 +03:00
ethers feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
ethers-contract feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
ethers-core feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
ethers-providers fix(BREAKING): return Option for txs/receipts/blocks (#64) 2020-09-17 14:06:56 +03:00
ethers-signers feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
.gitignore lock 2020-05-24 19:33:24 +03:00
CONTRIBUTING.md docs: add contributing.md 2020-06-15 18:05:29 +03:00
Cargo.lock feat: ledger support (#66) 2020-09-20 18:17:02 +03:00
Cargo.toml refactor: pull crates to root dir 2020-06-01 21:24:22 +03: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 fix: make multicall work by reference (#58) 2020-08-21 15:54:23 +03:00

README.md

ethers.rs

Complete Ethereum and Celo wallet implementation and utilities in Rust

Github Actions

Documentation

Extensive documentation and examples are available here.

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

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
  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.

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
  • 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.

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.

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.