Relevant newsfragments for ethereum#3125

Author: fselmo

newsfragments/3125.docs.rst

@@ -0,0 +1 @@
+Update ``WebsocketProviderV2`` documentation. Document a general overview of the ``RequestProcessor`` class and its internal caches.

newsfragments/3125.feature.rst

@@ -0,0 +1 @@
+Properly define an ``__await__()`` method on the ``_PersistentConnectionWeb3`` class so a persistent connection may be initialized using the ``await`` pattern. Integration tests added for initializing the persistent connection using the ``await`` pattern.

newsfragments/3125.internal.rst

@@ -0,0 +1 @@
+Updates and refactoring for the ``WebsocketProviderV2`` class and its internal supporting classes and logic. Separation of one-to-one and one-to-many request responses. Storing of one-to-many responses in a ``deque`` and one-to-one responses in a ``SimpleCache`` class. Provide an async lock around the websocket ``recv()``.