Introduction
Getting Started
1.
Installation
2.
First steps with Alloy
Migrating from ethers-rs
3.
Reference
4.
Conversions
Building with Alloy
5.
Best Practices
❱
5.1.
Wrapping a Provider
5.2.
Interacting with multiple networks
5.3.
Signers vs EthereumWallet
5.4.
Multicall and Multicall Batching Layer
6.
Basic building blocks
❱
6.1.
Using big numbers
6.2.
Basic hash and address types
6.3.
Common conversions
6.4.
Creating instances
6.5.
Comparisons and equivalence
7.
Connecting to a blockchain
❱
7.1.
Setting up a Provider
7.2.
Creating an HTTP provider
7.3.
Creating a WS provider
7.4.
Creating an IPC provider
8.
Understanding Fillers
9.
Queries
10.
Transactions
❱
10.1.
Using the Transaction Builder
10.2.
Sending an EIP-1559 transaction
10.3.
Sending a legacy transaction
10.4.
Sending an EIP-4844 transaction
10.5.
Sending an EIP-7702 transaction
10.6.
Using access lists
Highlights
11.
The sol! procedural macro
12.
The transaction lifecycle
Examples
13.
Big numbers
❱
13.1.
Comparison and equivalence
13.2.
Conversion
13.3.
Creating instances
13.4.
Math operations
13.5.
Math utilities
14.
Contracts
❱
14.1.
Deploy from artifact
14.2.
Deploy from bytecode
14.3.
Deploy from contract
14.4.
Deploy and link library
14.5.
Interact with ABI
14.6.
Interact with contract instance
14.7.
JSON-RPC error decoding
14.8.
Handling unknown return types
14.9.
Decode revert
15.
Fillers
❱
15.1.
Gas estimation filler
15.2.
Nonce management filler
15.3.
Recommended fillers
15.4.
Wallet management filler
16.
Layers
❱
16.1.
Fallback layer
16.2.
Hyper transport layer
16.3.
Request / response logging layer
16.4.
Retry-backoff layer
17.
Node bindings
❱
17.1.
Deploy contract on local Anvil instance
17.2.
Fork instance on Anvil
17.3.
Fork provider on Anvil
17.4.
Local instance on Anvil
17.5.
Local provider on Anvil
17.6.
Local provider on Geth
17.7.
Local provider on Reth
17.8.
Mock WETH balance with Anvil
18.
Primitives
❱
18.1.
Bytes and address types
18.2.
Hashing functions
19.
Providers
❱
19.1.
Builder
19.2.
Builtin
19.3.
HTTP with authentication
19.4.
HTTP
19.5.
IPC
19.6.
Wrapping a Provider
19.7.
WS
19.8.
WS with authentication
19.9.
Multicall Builder
19.10.
JSON-RPC Batch Request
19.11.
DynProvider
20.
Queries
❱
20.1.
Query contract storage
20.2.
Query contract deployed bytecode
20.3.
Query logs
21.
The sol! macro
❱
21.1.
Contract
21.2.
Decode returns
21.3.
Events and errors
21.4.
Structs and enums
21.5.
User defined types
22.
Subscriptions
❱
22.1.
Watch and poll for contract event logs
22.2.
Subscribe and watch blocks
22.3.
Subscribe and listen for specific contract event logs
22.4.
Subscribe and listen for all contract event logs
22.5.
Subscribe and listen to pending transactions in the public mempool
22.6.
Event multiplexer
23.
Transactions
❱
23.1.
Decode input
23.2.
Encode and decode EIP-1559 transaction
23.3.
Get gas price in USD
23.4.
Decode logs from transaction receipt
23.5.
Sign and send a raw transaction
23.6.
Send transaction with access list
23.7.
Send EIP-1559 transaction
23.8.
Send EIP-4844 transaction
23.9.
Send EIP-7702 transaction
23.10.
Send legacy transaction
23.11.
Send private transaction using Flashbots Protect
23.12.
Simulate using debug_traceCallMany
23.13.
Simulate using trace_callMany
23.14.
Trace call
23.15.
Trace transaction
23.16.
Transfer ERC20 token
23.17.
Transfer ETH
23.18.
Transfer ERC20 token using a signed permit
24.
Wallets
❱
24.1.
AWS signer
24.2.
GCP signer
24.3.
Ledger signer
24.4.
Private key signer
24.5.
Mnemonic signer
24.6.
Sign message
24.7.
Verify message
24.8.
Sign permit hash
24.9.
Trezor signer
24.10.
Yubi signer
24.11.
Keystore signer
24.12.
Create keystore
25.
Advanced
❱
25.1.
Using AnyNetwork
25.2.
Decoding with json_abi
25.3.
Encoding with dyn_abi
25.4.
Static encoding with sol!
25.5.
Using foundry-fork-db
25.6.
Wrapping Provider trait over reth-db
26.
Comparison
❱
26.1.
Compare block headers between providers
26.2.
Compare pending transactions between providers
Migrating to alloy-core v1.0
27.
Highlights
28.
sol! macro changes
❱
28.1.
Removing the T transport generic
28.2.
Improving function return type
28.3.
Changes to function call bindings
28.4.
Changes to event bindings
28.5.
Changes to error bindings
29.
Simplify ABI encoding and decoding
❱
29.1.
Encoding function return structs
29.2.
Removing validate: bool from the abi_decode methods
30.
Other breaking changes
Appendix
31.
Help us improve Alloy
Light
Rust
Coal
Navy
Ayu
Alloy Book
Best Practices
Wrapping a Provider
Interacting with multiple networks
Signers vs Ethereum Wallet
Multicall and Multicall Batching layer