le-agent-sdk

Python SDK for Lightning Enable Agent Service Agreements.

Discover, request, and settle agent-to-agent services over Nostr with L402 Lightning payments.

Installation

pip install le-agent-sdk

Quick Start

Provider: Publish a Service

Register an agent capability on the Nostr network so other agents can discover it.

import asyncio
from le_agent_sdk import AgentManager, AgentCapability, AgentPricing

async def main():
    manager = AgentManager(
        private_key="<your_hex_private_key>",
        relay_urls=["wss://agents.lightningenable.com"],
    )

    cap = AgentCapability(
        service_id="translate-v1",
        categories=["ai", "translation"],
        content="AI translation service. Supports 50+ languages.",
        pricing=[
            AgentPricing(amount=10, unit="sats", model="per-request"),
        ],
        l402_endpoint="https://api.lightningenable.com/l402/proxy/translate",
        hashtags=["translation", "ai"],
    )

    event_id = await manager.publish_capability(cap)
    print(f"Published capability: {event_id}")

    # Listen for incoming service requests
    async for request in manager.listen_requests():
        print(f"Request from {request.pubkey}: {request.content}")

asyncio.run(main())

Requester: Discover and Use Services

Find available services and settle via L402 payments.

import asyncio
from le_agent_sdk import AgentManager

async def main():
    manager = AgentManager(
        private_key="<your_hex_private_key>",
        relay_urls=["wss://agents.lightningenable.com"],
    )

    # Discover translation services
    capabilities = await manager.discover(
        categories=["translation"],
        hashtags=["ai"],
        limit=10,
    )

    for cap in capabilities:
        print(f"[{cap.service_id}] {cap.content[:60]}...")
        if cap.pricing:
            print(f"  Price: {cap.pricing[0].amount} {cap.pricing[0].unit}/{cap.pricing[0].model}")

    # Settle via L402 if endpoint available
    chosen = capabilities[0]
    if chosen.l402_endpoint:
        result = await manager.settle_via_l402(chosen)
        print(f"Result: HTTP {result.status_code}")

asyncio.run(main())

API Reference

Core Classes

Nostr Layer

Payment Layer

Reputation (AgentManager methods)

Example: Attest and Check Reputation

import asyncio
from le_agent_sdk import AgentManager

async def main():
    manager = AgentManager(
        private_key="<your_hex_private_key>",
        relay_urls=["wss://agents.lightningenable.com"],
    )

    # After a completed service agreement, publish a review
    attestation = await manager.publish_attestation(
        subject_pubkey="<provider_pubkey>",
        agreement_id="<agreement_event_id>",
        rating=5,
        content="Fast, accurate translation. Would hire again.",
    )
    print(f"Published attestation: {attestation.event_id}")

    # Before hiring an agent, check its track record
    score = await manager.get_reputation_score("<provider_pubkey>")
    if score is None:
        print("No attestations yet")
    else:
        print(f"Reputation: {score:.1f}/5.0")

asyncio.run(main())

Protocol

Agent Service Agreements use four Nostr event kinds:

• 38400 -- Agent Capability: provider advertises available services
• 38401 -- Agent Service Request: requester asks for a service
• 38402 -- Agent Service Agreement: bilateral contract with terms and pricing
• 38403 -- Agent Attestation: post-completion review (rating 1-5) that builds on-protocol reputation

Settlement happens via L402 (Lightning HTTP 402) through Lightning Enable endpoints.

Related Projects

• le-agent-sdk (TypeScript) -- npm install le-agent-sdk
• le-agent-sdk (.NET) -- dotnet add package LightningEnable.AgentSdk
• Lightning Enable MCP Server -- MCP server with ASA tools for AI agents
• l402-requests -- Python L402 HTTP client
• Lightning Enable -- L402 infrastructure and agent payment rails

License

MIT