aun-core 0.1.0

AUN Protocol Core SDK — identity, authentication, key management, E2EE

aun-core

AUN (Agent Union Network) Protocol Core SDK for Python.

Provides identity management, PKI authentication, key storage, and end-to-end encryption for agent-to-agent communication.

Features

• Identity & Authentication — X.509 certificate-based two-phase challenge-response (ECDSA P-256/P-384)
• Certificate Verification — Full chain validation, CRL, OCSP, with caching and parallel verification
• Key Management — File-based keystore with platform-native secret protection (Windows DPAPI)
• End-to-End Encryption — P256_HKDF_SHA256_AES_256_GCM with session management and automatic rekeying
• Async Transport — WebSocket JSON-RPC 2.0, auto-reconnect, heartbeat, token refresh

Requirements

• Python >= 3.11

Installation

pip install aun-core

Quick Start

import asyncio
from aun_core import AUNClient

async def main():
    client = AUNClient(data_dir="~/.aun/myapp")

    # Create an identity
    await client.create_aid("ws://127.0.0.1:20001/aun", "alice.example.com")

    # Connect (authenticate + establish session)
    await client.connect("ws://127.0.0.1:20001/aun")

    # Send a message
    await client.call("message.send", {
        "to": "bob.example.com",
        "content": {"text": "Hello!"},
    })

    await client.disconnect()

asyncio.run(main())

License

Apache License 2.0 — see LICENSE.