asterpay-autogpt 1.0.0

AsterPay payment component for AutoGPT and AgentGPT - Enable AI agents to make x402 payments

AsterPay AutoGPT/AgentGPT Integration

Payment capabilities for autonomous AI agents.

Overview

asterpay-autogpt provides payment tools for AI agent frameworks:

• AutoGPT - Component-based architecture support
• AgentGPT - Generic tool interface
• Any Framework - OpenAI function calling format

Installation

pip install asterpay-autogpt

Quick Start

AutoGPT Component

from autogpt.agents import Agent
from asterpay_autogpt import AsterPayComponent

class PaymentAgent(Agent):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.asterpay = AsterPayComponent(
            private_key=os.environ["AGENT_PRIVATE_KEY"],
            network="base",
            daily_limit=10.0,
            max_auto_pay=0.50,
        )

Generic Tools (Any Framework)

from asterpay_autogpt import AsterPayTools

tools = AsterPayTools(
    private_key=os.environ["AGENT_KEY"],
    daily_limit=10.0,
)

# Check balance
balance = await tools.check_balance()
print(f"Balance: {balance}")

# Access paid API
result = await tools.paid_fetch("https://api.paid-service.com/data")
print(f"Data: {result['data']}")

# Make payment
payment = await tools.make_payment(
    recipient="0x...",
    amount=5.00,
    memo="Service payment"
)

OpenAI Function Calling

from asterpay_autogpt import AsterPayTools
import openai

tools = AsterPayTools(private_key=os.environ["KEY"])

# Get function definitions
functions = tools.get_openai_function_definitions()

# Use with OpenAI
response = openai.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Check my wallet balance"}],
    tools=functions,
)

# Execute function call
if response.choices[0].message.tool_calls:
    call = response.choices[0].message.tool_calls[0]
    result = await tools.execute_function(
        call.function.name,
        json.loads(call.function.arguments)
    )

Available Commands

Command	Description
asterpay_balance	Check wallet USDC balance
asterpay_spending	View spending against limits
asterpay_fetch	Fetch URLs with automatic x402 payment
asterpay_pay	Make direct USDC payments
asterpay_transactions	View payment history

Spending Limits

Protect your agent with configurable limits:

AsterPayComponent(
    private_key=key,
    per_transaction_limit=2.0,  # Max $2 per transaction
    hourly_limit=5.0,           # Max $5/hour
    daily_limit=25.0,           # Max $25/day
    monthly_limit=200.0,        # Max $200/month
    max_auto_pay=0.50,          # Max auto-pay for x402
)

Networks

Network	Chain ID	Use Case
base	8453	Production (recommended)
base-sepolia	84532	Testing
polygon	137	Alternative L2
arbitrum	42161	Alternative L2

Environment Variables

# Required
AGENT_PRIVATE_KEY=0x...

# Optional
ASTERPAY_NETWORK=base
ASTERPAY_DAILY_LIMIT=10.0

Security

1. Never hardcode private keys
2. Set appropriate spending limits
3. Use testnet for development
4. Monitor agent transactions

Links

• Website: asterpay.io
• Demo: demo.asterpay.io
• Docs: asterpay.io/docs

License

MIT License