linora Python SDK

linora Python SDK provides a simple interface to interact with the linora REST and WS API.

Examples

L1 + L2 Authentication (Traditional)

from linora_py import linora
from linora_py.environment import Environment

linora = linora(env=Environment.TESTNET, l1_address="0x...", l1_private_key="0x...")
print(hex(linora.account.l2_address)) # 0x...
print(hex(linora.account.l2_public_key)) # 0x...
print(hex(linora.account.l2_private_key)) # 0x...

L2-Only Authentication (Subkey)

from linora_py import linoraSubkey
from linora_py.environment import Environment

# Use linoraSubkey for L2-only authentication
linora = linoraSubkey(
    env=Environment.TESTNET,
    l2_private_key="0x...",
    l2_address="0x..."
)
print(hex(linora.account.l2_address)) # 0x...
print(hex(linora.account.l2_public_key)) # 0x...
print(hex(linora.account.l2_private_key)) # 0x...

WebSocket Usage

async def on_message(ws_channel, message):
    print(ws_channel, message)

await linora.ws_client.connect()
await linora.ws_client.subscribe(linoraWebsocketChannel.MARKETS_SUMMARY, callback=on_message)

📖 For complete documentation refer to tradelinora.github.io/linora-py

💻 For comprehensive examples refer to following files:

• API (L1+L2): examples/call_rest_api.py
• API (L2-only): examples/subkey_rest_api.py
• WS (L1+L2): examples/connect_ws_api.py
• WS (L2-only): examples/subkey_ws_api.py
• Transfer: examples/transfer_l2_usdc.py

Development

make install
make check
make test
make build
make clean-build
make publish
make build-and-publish
make docs-test
make docs
make help

Using uv

This project uses uv for managing dependencies and building. Below are instructions for installing uv and the basic workflow for development outside of using make commands.

Installing uv

uv is a fast and modern Python package manager. You can install it using the standalone installer for macOS and Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

For other installation methods, refer to the uv installation documentation.

Basic Workflow with uv

If you prefer not to use make commands, you can directly use uv for development tasks:

• Install dependencies: Sync your environment with the project's dependencies.

  uv sync

• Run tests: Execute the test suite using pytest within the uv environment.

  uv run pytest

• Build the project: Create a distribution package for the SDK.

  uv build

For more detailed information on using uv, refer to the uv documentation.

The CI/CD pipeline will be triggered when a new pull request is opened, code is merged to main, or when new release is created.

Notes

Warning

Experimental SDK, library API is subject to change