Mersennet Python SDK

Python client for Mersennet - JSON-RPC, CLOB (order book), and WebSocket subscriptions.

Installation

pip install "git+https://github.com/mersennet/sdk-python.git@v0.1.0"   # PyPI publication pending

Or from source:

cd sdk-python
pip install -e .

Quick Start

from mersennet import MersennetProvider, MersennetOrders

provider = MersennetProvider("http://localhost:8545")

# Chain info
print("Chain ID:", provider.chain_id())
print("Block:", provider.block_number())
print("Gas price:", provider.gas_price())

# Account
balance = provider.get_balance("0xYourAddress")
print("Balance:", balance)

# Order book
orders = MersennetOrders(provider)
book = orders.get_order_book(1)
print("Bids:", book.bids)
print("Asks:", book.asks)

API Reference

MersennetProvider

MersennetOrders

MersennetSubscriber (WebSocket)

Shielded Notes

Use view_notes to fetch encrypted note envelopes, then call scan_granted_notes with a decrypt function that applies your granted viewing material locally.

from mersennet import GrantedViewingMaterial, MersennetProvider, make_mock_note_decryptor, scan_granted_notes

provider = MersennetProvider("http://localhost:8545")

material = GrantedViewingMaterial(
    grant_id_hex="0x...",
    recipient_public_key="0x...",
    decrypt_note_ciphertext=make_mock_note_decryptor("0x..."),
)

result = scan_granted_notes(provider, material, limit=64)
print("Decrypted notes:", len(result.notes))

See the runnable end-to-end example in examples/view_notes_end_to_end.py.

WebSocket Example

from mersennet import MersennetSubscriber

sub = MersennetSubscriber("ws://localhost:8545")
sub.connect()

def on_block(block):
    print("New block:", block)

sub_id = sub.subscribe_blocks(on_block)
# ...
sub.unsubscribe(sub_id)
sub.disconnect()

Error Handling

from mersennet.provider import MersennetError

try:
    balance = provider.get_balance("0x...")
except MersennetError as e:
    print(f"Error {e.code}: {e}")

Part of the Mersennet ecosystem — trade · explorer · docs · run a node · Telegram
_{© 2026 Mersennet Foundation · MIT License · security@mersennet.com}