Skip to main content

A lightweight, fast Python library for Ethereum JSON-RPC

Project description

borreguil

A lightweight, fast Python library for Ethereum JSON-RPC. Built as a minimal alternative to web3.py with low overhead and a small, explicit API.

Install

uv add borreguil

Usage

from borreguil.provider import HttpProvider
from borreguil.contract import Contract

provider = HttpProvider("https://eth.llamarpc.com")

# Query chain state
block_number = provider.get_block_number()

# Call a contract
usdc = Contract(address="0xA0b...", abi=ABI, provider=provider)
response = usdc.functions.balanceOf("0x...").call()

Why borreguil

  • Minimal: No middleware stacks or heavy abstractions, just direct JSON-RPC wrappers.
  • Fast: Low per-call overhead; uses orjson and httpx under the hood.
  • Typed: Modern Python 3.11+ type hints throughout.
  • Small API surface: Easy to learn and maintain.

Documentation

See docs/ for the full guide and examples/ for runnable snippets.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

borreguil-0.2.0.tar.gz (11.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

borreguil-0.2.0-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file borreguil-0.2.0.tar.gz.

File metadata

  • Download URL: borreguil-0.2.0.tar.gz
  • Upload date:
  • Size: 11.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for borreguil-0.2.0.tar.gz
Algorithm Hash digest
SHA256 612545d8a00e5f28d0e0c6466eb6ab41877a0ddfd2a37be10c8381bf7df753a4
MD5 197d106c59fb6235895f74406391f5d7
BLAKE2b-256 e18af1886400ee3f9a9ec43ef708b9688b6fb8f3b3b6560fc86d4dabfcfbfc09

See more details on using hashes here.

Provenance

The following attestation bundles were made for borreguil-0.2.0.tar.gz:

Publisher: release.yml on mufezcom/borreguil

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file borreguil-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: borreguil-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for borreguil-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 730061c2ac5a00582292b7438da993b7bc93c3993a5b9144b7e6a43fe3a7ab68
MD5 84a76742f826e53a9e894e5599f3151c
BLAKE2b-256 8b38426b385fc76ebb15ac378aec67bb7da32048701fb34be6f4de2299ceb1e0

See more details on using hashes here.

Provenance

The following attestation bundles were made for borreguil-0.2.0-py3-none-any.whl:

Publisher: release.yml on mufezcom/borreguil

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page