.. _resources:


Resources and Learning Material
===============================

web3.py and the Ethereum Python ecosystem have an active community of developers and educators.
Here you'll find libraries, tutorials, examples, courses and other learning material.

.. warning ::

  Links on this page are community submissions and are not vetted by the team that maintains
  web3.py. As always, DYOR (Do Your Own Research).


First Steps
-----------

Resources for those brand new to Ethereum:

- `A Developer's Guide to Ethereum, Pt. 1 <https://snakecharmers.ethereum.org/a-developers-guide-to-ethereum-pt-1/>`__
- `Ethereum Python Ecosystem Tour <https://snakecharmers.ethereum.org/python-ecosystem/>`__


Courses
-------

- `freeCodeCamp Solidity and Python Course (2022) <https://www.youtube.com/watch?v=umg2fWQX6jM>`__
- `Blockchain Python Programming Tutorial (2019) <https://www.youtube.com/watch?v=pZSegEXtgAE>`__


Tutorials
---------

- Intro to `Ape development framework <https://snakecharmers.ethereum.org/intro-to-ape/>`__
- Intro to `websockets <https://snakecharmers.ethereum.org/websocketprovider/>`__ and web3.py
- Intro to `asynchronous web3.py <https://snakecharmers.ethereum.org/web3-py-patterns-intro-async/>`__
- Intro to `threaded web3.py <https://snakecharmers.ethereum.org/web3-py-patterns-multithreading/>`__
- Sign `typed data messages <https://snakecharmers.ethereum.org/typed-data-message-signing/>`__ (EIP 712)
- Look up offchain data via `CCIP Read <https://snakecharmers.ethereum.org/web3-py-patterns-off-chain-lookups/>`__
- Configure and `customize web3.py <https://snakecharmers.ethereum.org/web3-py-patterns-customizations/>`__
- `Decode a signed transaction <https://snakecharmers.ethereum.org/web3-py-patterns-decoding-signed-transactions/>`__
- Find a historical contract `revert reason <https://snakecharmers.ethereum.org/web3py-revert-reason-parsing/>`__
- Generate a `vanity address <https://snakecharmers.ethereum.org/web3-py-patterns-mining-addresses/>`__
- Simulate transactions with `call state overrides <https://snakecharmers.ethereum.org/web3-py-patterns-eth_call-overrides/>`__
- Configure web3 for `JSON-RPC fallback and MEV blocker providers <https://web3-ethereum-defi.readthedocs.io/tutorials/mev-blocker.html#mev-protection-and-multiple-json-rpcs-configuration>`__


Conference Presentations and Videos
-----------------------------------

- `Web3.Py - Now And Near Future by Marc Garreau (2022, 15 mins) <https://www.youtube.com/watch?v=hj6ubyyE_TY>`__
- `Python and DeFi by Curve Finance (2022, 15 mins) <https://www.youtube.com/watch?v=4HOU3z0LoDg>`__
- `Working with MetaMask in Python by Rishab Kattimani (2022, 15 mins) <https://www.youtube.com/watch?v=cFB1BGeCpn0>`__


Smart Contract Programming Languages
------------------------------------

- `Vyper <https://docs.vyperlang.org/en/stable/>`__ - Contract-oriented, pythonic programming language that targets EVM


Frameworks and Tooling
----------------------

- `Ape <https://www.apeworx.io/>`__ - The Ethereum development framework for Python Developers, Data Scientists, and Security Professionals
- `Titanoboa <https://github.com/vyperlang/titanoboa>`__ - A Vyper interpreter and testing framework
- `Wake <https://github.com/Ackee-Blockchain/wake>`__ - A Python-based development and testing framework for Solidity
- `Brownie <https://github.com/eth-brownie/brownie>`__ - [No longer actively maintained] A Python-based development and testing framework for smart contracts targeting EVM


Libraries
---------

- `Web3 Ethereum DeFi <https://github.com/tradingstrategy-ai/web3-ethereum-defi>`__ - Library for DeFi trading and protocols (Uniswap, PancakeSwap, Sushi, Aave, Chainlink)
- `lighter-v1-python <https://github.com/elliottech/lighter-v1-python>`__ - Lighter.xyz DEX client for Python
- `uniswap-python <https://uniswap-python.com/>`__ - Library lets you easily retrieve prices and make trades on all Uniswap versions.
- `pyWalletConnect <https://github.com/bitlogik/pyWalletConnect>`__ - WalletConnect implementation for wallets in Python
- `dydx-v3-python <https://github.com/dydxprotocol/dydx-v3-python>`__ - Python client for dYdX v3
- `Lido Python SDK <https://github.com/lidofinance/lido-python-sdk>`__ - Library with which you can get all Lido validator's signatures and check their validity


Applications
------------

- `Curve Finance <https://github.com/curvefi?q=&type=all&language=python&sort=>`__
- `Yearn Finance <https://github.com/yearn?q=&type=all&language=python&sort=>`__
- `StakeWise Oracle <https://github.com/stakewise/oracle/>`__


Hackathon Helpers
-----------------

- `ape-hackathon-kit <https://github.com/wolovim/ape-hackathon-kit>`__ - Ape project template with a web front-end (Next.js, Tailwind, RainbowKit, wagmi)
- `eth-flogger <https://github.com/wolovim/eth-flogger>`__ - Sample web app utilizing async web3.py, Flask, SQLite, Sourcify
- `Temo <https://github.com/wolovim/temo>`__ - Sample terminal app utilizing async web3py, Textual, Anvil
- `web3py-discord-bot <https://github.com/wolovim/web3py-discord-bot>`__ - Sample Discord bot utilizing websockets, ``eth_subscribe``, and discord.py
- `py-signer <https://github.com/wolovim/py-signer>`__ - Demo of typed data message signing (EIP-712) with eth-account and Ape