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
328 Commits 2 Branches 30 Tags 16 MiB
Rust 99.6%
Shell 0.3%
Go to file
Georgios Konstantopoulos dcbfacf5bc
feat: typed txs provider / middleware changes (part 3) (#357) 
* feat(providers): add eth_feeHistory api

* add access list

* feat: fill transactions with access list / default sender info

* feat: add helpers for operating on the txs enum

* feat: send_transaction takes TypedTransaction now

* fix(contract): temp wrap all contract txs as Legacy txs

* feat(middleware): use TypedTransaction in Transformer

* feat(signers): use TypedTransaction in Wallet/Ledger

* feat(core): add helpers for setting typed tx fields

* feat(signer): use typed transactions

* fix(middleware): adjust nonce/gas/escalators for TypedTxs

The GPO and the Escalators will throw an error if they are provided an EIP1559 transaction

* fix(providers): ensure the correct account's nonce is filled

* fix: add .into() to txs until we make the fn call more generic

* Revert "fix: add .into() to txs until we make the fn call more generic"

This reverts commit 04dc34b26d0e3f418ed3fc69ea35ad538b83dd50.

* feat: generalize send_transaction interface

* fix: only set the nonce manually in the Signer middleware

* fix(transformer): fill the transaction after transformation

* chore: fix compilation errors & lints

* fix(signer): set the correct account's nonce

* feat: make trace_call / call take TypedTransaction

* fix: set sender to transaction in signer

* chore: ethgasstation broke

* chore: cargo fmt / lints

* Fix(signer): pass the chain id

* fix: final tx encoding fixes

1. Normalize v values for eip1559/2730
2. Make access lists mandatory for 1559
3. do not double-rlp on rlp_signed

* fix: set access list only if available

* test: check 1559 / 2930 txs

* fix: do not prepend a 0 for Legacy txs & test

* chore: code review comments

* chore: fix aws signer signature
 		2021-08-09 03:31:11 +03:00
.github fix: make chain_id mandatory (#286) 2021-07-29 23:22:25 +03:00
bin docs: add contributing.md 2020-06-15 18:05:29 +03:00
ethers fix: make chain_id mandatory (#286) 2021-07-29 23:22:25 +03:00
ethers-contract feat: typed txs provider / middleware changes (part 3) (#357) 2021-08-09 03:31:11 +03:00
ethers-core feat: typed txs provider / middleware changes (part 3) (#357) 2021-08-09 03:31:11 +03:00
ethers-middleware feat: typed txs provider / middleware changes (part 3) (#357) 2021-08-09 03:31:11 +03:00
ethers-providers feat: typed txs provider / middleware changes (part 3) (#357) 2021-08-09 03:31:11 +03:00
ethers-signers feat: typed txs provider / middleware changes (part 3) (#357) 2021-08-09 03:31:11 +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: 1559/2930 txs (part 2) (#355) 2021-08-09 01:59:07 +03:00
Cargo.toml Upgrade reqwest to 0.11.0 to ensure only 1 version of tokio used (#136) 2021-01-07 15:24:07 +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 docs: add more docs (#130) 2020-12-31 21:08:12 +02: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. 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.

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.

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