AgentSync Python SDK

Python SDK for the AgentSync x402 micropayment gateway on Radix.

Install

pip install agentsync-sdk

Note: the distribution name is agentsync-sdk; the import package remains agentsync (from agentsync import ...). For local development use pip install -e . in the repo.

Development

pip install -e ".[dev]"
pytest

Platform Attestation Verification

Verify a platform-signed attestation envelope against the trusted platform Ed25519 public key:

from agentsync import SignatureEnvelope, verify_platform_attestation

trusted_public_key = "9afcc1cf66b256d7d9567a906fba4317305d92c3e7fd7f27386dffe182332576"
envelope = SignatureEnvelope(
    payload="account_tdx_2_...:5.500000:0",
    signature="<128-char hex>",
    public_key=trusted_public_key,
    algorithm="ed25519+sha256",
)

valid = verify_platform_attestation(envelope, trusted_public_key)  # bool

verify_platform_attestation() is pure and synchronous: the trusted key is injected by the caller and never fetched from the network. It asserts that the envelope's public_key matches the trusted key before verifying the Ed25519(SHA-256(payload)) signature.

The TypeScript counterpart lives at ../sdk-typescript.