get direct access to erigon database over grpc api.
this interface wraps the kv api and allows you to read and iterate over any table.
from erigon.kv import ErigonKV
kv = ErigonKV()
await kv.connect()
async with kv.open('Code') as cursor:
await cursor.seek(b'\xff\xff')
async for row in cursor:
print(row)ErigonKV.connect connects to the private api (default: 127.0.0.1:9090) and opens a read transaction. a transaction offers a consistent view over the database, but be wary of long-running transactions, as they can impact the database performance.
ErigonKV.open returns an ErigonCursor object which supports async iteration and seeking. it will also automatically close the cursor when you are finished.
you can also open a table in a dup sort mode, in which a key can have more than one value associated. this mode is utilized in the PlainState table for contract storage.
ErigonCursor supports seek, seek_exact, first, last, prev methods, as well as iteration. there is also a read method which you can use with rarer ops.
the cursor starts at the first row by default, so you can just iterate over it.
not all tables use an intuitive layout, read the annotated source for a description of the key and value structure of each bucket.
this interface provides common shortcuts to read block headers, accounts, and to enumerate account storage.