1cfbc7b3c3
* feat(provider): allow specifying a default polling interval param This parameter is going to be used for all subsequent client calls by default. It can still be overriden with the internal `interval` calls * feat(contract): replace reference to Client with Arc * feat(abigen): adjusts codegen to use Arcs * fix(ethers): adjust examples to new apis * fix(provider): return TxHash instead of PendingTransaction on tx submission Returning a PendingTransaction allowed us to have nice ethers.js-like syntax where you submit a transaction and then can immediately await it. Unfortunately, now that we use Arcs and not lifetimes this meant that we would need to bind the function call in a variable, and then await on it, which is pretty bad UX. To fix this, we revert back to returning a TxHash and introduce a convenience method on the provider and the contract which takes a tx_hash and returns a PendingTransaction object. The syntax ends up being slightly more verbose (although more explicit), but the issue is fixed. |
||
|---|---|---|
| .github | ||
| bin | ||
| ethers | ||
| ethers-contract | ||
| ethers-core | ||
| ethers-providers | ||
| ethers-signers | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| LICENSE-APACHE | ||
| LICENSE-MIT | ||
| README.md | ||
README.md
ethers.rs
Complete Ethereum and Celo wallet implementation and utilities in Rust
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 = "github.com/gakonst/ethers-rs" }
Celo Support
Celo support is turned on via the feature-flag celo:
[dependencies]
ethers = { git = "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.
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.