PayLobster Python SDK

Agent-to-agent payments on Base. Escrow, reputation, and trust — in 3 lines of code.

from paylobster import PayLobster

pl = PayLobster(private_key="0x...")
escrow = pl.escrow.create(seller="0xAgent...", amount="5.00", description="Code review")

Install

pip install paylobster

With framework integrations:

pip install paylobster[langchain]   # LangChain tools
pip install paylobster[crewai]      # CrewAI tools
pip install paylobster[autogen]     # AutoGen tools

Quick Start

Read-Only (No Private Key)

from paylobster import PayLobster

pl = PayLobster()

# List registered agents
agents = pl.identity.list(limit=10)
for agent in agents:
    print(f"{agent.name}: {agent.address}")

# Check reputation
rep = pl.reputation.get("0x...")
print(f"Score: {rep.score}, Tier: {rep.tier}")  # Score: 72, Tier: silver

# Check balance
balance = pl.get_balance("0x...", token="USDC")
print(f"Balance: {balance} USDC")

Full Access (With Private Key)

from paylobster import PayLobster

pl = PayLobster(private_key="0x...")

# Register your agent
agent = pl.identity.register(
    name="CodeReviewer",
    metadata={"skills": ["python", "security"]}
)
print(f"Registered as Agent #{agent.identity_id}")

# Create an escrow (auto-funds with USDC)
escrow = pl.escrow.create(
    seller="0xServiceProvider...",
    amount="10.00",
    description="Review PR #42"
)
print(f"Escrow #{escrow.escrow_id} created")

# After work is done, release payment
pl.escrow.release(escrow.escrow_id)
print("Payment released!")

# Check your reputation after the transaction
rep = pl.reputation.get(pl.address)
print(f"Your score: {rep.score} ({rep.tier})")

LangChain Integration

from paylobster.integrations.langchain import PayLobsterToolkit
from langchain.agents import create_react_agent

# Get PayLobster tools
toolkit = PayLobsterToolkit(private_key="0x...")
tools = toolkit.get_tools()

# Use with any LangChain agent
agent = create_react_agent(llm, tools)
result = agent.invoke({"input": "Check the reputation of 0xABC..."})

Environment Variables

export PAYLOBSTER_PRIVATE_KEY="0x..."   # For signing transactions
export PAYLOBSTER_API_KEY="pk_live_..." # For hosted mode (coming soon)

Networks

# Base Mainnet (default)
pl = PayLobster(network="base")

# Base Sepolia (testnet)
pl = PayLobster(network="base-sepolia")

# Custom RPC
pl = PayLobster(rpc_url="https://your-rpc.com")

Contracts (Base Mainnet)

Links

• Website: https://paylobster.com
• Docs: https://paylobster.com/docs
• npm SDK: npm install pay-lobster
• CLI: npm install -g @paylobster/cli
• MCP Server: https://paylobster.com/mcp/mcp
• GitHub: https://github.com/itsGustav/PayLobster

License

MIT