subnoto-api-client 1.1.0

Python client for the Subnoto Public API

Subnoto Python SDK

Python client for the Subnoto Public API

Note: the SDK is only available on the linux/amd64 platform for now

Installation

pip install subnoto-api-client

Or with Bazel:

# In your BUILD file
load("@pypi//:requirements.bzl", "requirement")

py_binary(
    name = "my_app",
    srcs = ["main.py"],
    deps = [
        "//libs/api-client-py:api_client_py",
    ],
)

Usage

Basic Example

import asyncio
from subnoto_api_client import SubnotoClient, SubnotoConfig

async def main():
    # Create client with configuration
    config = SubnotoConfig(
        api_base_url="https://enclave.subnoto.com",
        access_key="your-access-key",
        secret_key="your-secret-key-hex",
        unattested=True  # Set to False for production with attestation
    )

    async with SubnotoClient(config) as client:
        # List workspaces
        response = await client.post("/public/workspace/list", json={})
        workspaces = response.json()
        print(f"Workspaces: {workspaces}")

        # Get current user info
        response = await client.post("/public/utils/whoami", json={})
        user_info = response.json()
        print(f"User: {user_info}")

if __name__ == "__main__":
    asyncio.run(main())

Configuration

Option	Type	Required	Description
api_base_url	str	Yes	API base URL (e.g., https://enclave.subnoto.com)
access_key	str	Yes	API access key from your team settings
secret_key	str	Yes	API secret key (hex-encoded) from your team settings
unattested	bool	No	Use unattested mode for development (default: False)
attester_key	bytes	No	Public key for attestation verification (required if attested)