xrpl-py

library5.0.0pypypi✓ verified 84d ago

A complete Python library for interacting with the XRP Ledger, supporting wallets, transactions, and network communication. Currently at version 4.5.0, with active development and a release cadence of roughly monthly.

http-networking database communication payments

pip install xrpl-py

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · XRPL-PY

xrpl-py

http-networkingpythonv5.0.0

Install

3.7s avg

Import

1665ms

Disk

35MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 1.742s · 35.9MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 3.7s · import 1.588s · 37MB

35MB installed

● package 35MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

xrpl

✓ import xrpl

Wallet

✓ from xrpl.wallet import Wallet

✗ from xrpl import Wallet (causes AttributeError)

Wallet is in the wallet subpackage

XRPClient

✓ from xrpl.clients import XRPClient

✗ from xrpl import XRPClient (causes AttributeError)

Create a testnet client and a new wallet.

import xrpl from xrpl.clients import XRPClient from xrpl.wallet import Wallet client = XRPClient(json_rpc_url='https://s.altnet.rippletest.net:51234') wallet = Wallet.create() print(f'Classic address: {wallet.classic_address}') print(f'Seed: {wallet.seed}')

Debug

Known issues

breakingIn v4.0.0, the transaction model classes were renamed (e.g., Payment became PaymentTx). Code using old names will break.

fix

Update imports to use new class names: from xrpl.models.transactions import PaymentTx

affects: <4.0.0

breakingIn v4.0.0, the Wallet class moved from xrpl.core to xrpl.wallet and its constructor changed. Import from xrpl.wallet instead.

fix

Use from xrpl.wallet import Wallet

affects: <4.0.0

deprecatedxrpl.clients.websocket_client.WebsocketClient is deprecated. Use xrpl.asyncio.clients.WebsocketClient instead.

fix

Use from xrpl.asyncio.clients import WebsocketClient

affects: >=4.0.0

gotchaDo NOT use xrpl.clients.JsonRpcClient for signing transactions; it's only for submitting. Use xrpl.transaction.submit_and_wait for full lifecycle.

fix

Use xrpl.transaction.submit_and_wait(...) to handle signing and submission.

affects: all

Errors

Common errors & fixes

AttributeError: module 'xrpl' has no attribute 'Wallet'

Importing Wallet directly from the top-level xrpl package.

fix

Use from xrpl.wallet import Wallet

ModuleNotFoundError: No module named 'xrpl'

Library not installed or not activated in current virtual environment.

fix

pip install xrpl-py

ValueError: The secret is invalid.

Using an incorrect seed format or trying to recover a wallet from an invalid family seed.

fix

Ensure the seed is a valid XRPL family seed (starts with 's') and use Wallet.from_seed(seed)

Upgrade

Version history

5.0.0latest on PyPI · released Jun 3, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

62 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/XRPLF/xrpl-py ↗

packagehttps://pypi.org/project/xrpl-py/ ↗

homepagehttps://xrpl.org ↗

docshttps://xrpl-py.readthedocs.io ↗