soma-sdk

library0.1.15pypypi✓ verified 79d ago

Python SDK for the SOMA network, enabling interaction with the SOMA blockchain, wallet management, and transaction building. Current version is 0.1.15, with active development on testnet-v0.1.21. Release cadence is rapid, with frequent patch releases.

http-networking database auth-security

pip install soma-sdk

github ↗package ↗

INSTALL

IMPORT

SIG · SOMA-SDK

soma-sdk

http-networkingpythonv0.1.15

Install

2.0s avg

Import

—

Disk

30MB

Pass rate

8/ 10

Env Coverage8 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.1.15 · 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

glibc

py 3.10

✓ —

✓ 2.1s

py 3.11

✓ —

✓ 1.9s

py 3.12

✓ —

✓ 1.6s

py 3.13

✓ —

✓ 2.4s

py 3.9

✕ build_error

30MB installed

● package 30MB

Code

Verified usage

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

SomaClient

✓ from soma_sdk import SomaClient

✗ from somasdk import SomaClient

Keypair

✓ from soma_sdk import Keypair

soma_sdk

✓ import soma_sdk

Basic usage: create a client and generate a wallet.

import os from somasdk import SomaClient, Wallet # Initialize client (no auth required for public testnet) client = SomaClient(node_url=os.environ.get('SOMA_NODE_URL', 'https://testnet.soma.org')) # Create a new wallet wallet = Wallet.generate() print("Address:", wallet.address) print("Mnemonic:", wallet.mnemonic) # Get balance balance = client.get_balance(wallet.address) print("Balance:", balance)

soma --version

Debug

Known issues

gotchaThe SDK uses `somasdk` as the package name, not `soma_sdk`. The PyPI distribution is `soma-sdk` but imports use `somasdk`.

fix

Use `import somasdk` or `from somasdk import ...`.

affects: all

breakingThe `SomaClient` constructor changed in testnet-v0.1.18: `api_key` parameter removed; authentication is now via `auth_token` header.

fix

Update code to use `headers={'Authorization': f'Bearer {token}'}` instead of `api_key`.

affects: >=0.1.18

deprecated`Wallet.from_mnemonic()` is deprecated in favor of `Wallet.from_phrase()`.

fix

Replace `Wallet.from_mnemonic(mnemonic)` with `Wallet.from_phrase(mnemonic)`.

affects: >=0.1.15

gotchaNode URLs must include `http://` or `https://` prefix; otherwise silent failure.

fix

Always include scheme: `https://testnet.soma.org`.

affects: all

Upgrade

Version history

0.1.15latest on PyPI · released Mar 20, 2026

Audit

Dependencies

requestsrequiredHTTP calls to SOMA nodes

pydanticrequiredData models and validation

cryptographyrequiredKey generation and signing

Agent activity

34 hits · last 30 days

node