agentpay-sdk  by worldliberty

Empowering AI agents with self-custodial, policy-aware blockchain payments

Created 2 months ago
558 stars

Top 56.9% on SourcePulse

GitHubView on GitHub
Project Summary

AgentPay SDK provides a local runtime for self-custodial, policy-aware blockchain wallet operations, enabling AI agents to manage funds and execute transactions across chains with built-in policy enforcement and human approval workflows. It targets developers and power users building agentic financial systems, offering secure and controlled money movement.

How It Works

A local daemon, managed by the agentpay CLI, handles wallet access, balance management, policy enforcement, and transaction signing/broadcasting. Users configure policies, manage wallets, and initiate transfers via the CLI, with options for automated or manual approval paths for transactions.

Quick Start & Requirements

  • Primary Install: A one-click script (curl -fsSL https://wlfi.sh | bash) is recommended for macOS and Linux. This script installs prebuilt binaries, manages Node.js (v20+) installation, and integrates AI agent skills/adapters.
  • Prerequisites: macOS or Linux, network access. Homebrew is needed only if Node.js is absent. The --skills-only option requires network access and a writable home directory.
  • Source Install: Windows supports only JavaScript workspace installation (pnpm install); Rust daemon source installation is unsupported.
  • Documentation: https://docs.worldlibertyfinancial.com/agentpay-sdk

Highlighted Details

  • Policy Layers: Supports default limits, per-destination overrides, and manual approval overlays for transactions.
  • TUI Policy Editor: agentpay admin tui offers an interactive interface for defining token limits, destination overrides, and manual approval rules.
  • Manual Approval: Transactions can be paused for operator review via agentpay admin add-manual-approval-policy and managed through CLI commands.
  • Managed Wallet: The daemon is managed by launchd (macOS) or systemd (Linux), with secure credential storage (macOS Keychain, Linux Secret Service).
  • Advanced Transactions: Supports agentpay x402 for EIP-3009 payments and agentpay mpp for Tempo/Charge and Tempo/Session HTTP requests with configurable parameters.

Maintenance & Community

No specific details on maintainers, community channels (like Discord/Slack), or roadmap were found in the provided README text.

Licensing & Compatibility

  • License: MIT License.
  • Compatibility: The permissive MIT license generally allows commercial use and linking with closed-source projects.

Limitations & Caveats

Rust daemon/runtime source installation is unsupported on Windows. Browser-based relay and web approval services are explicitly unsupported in this release. Recovery from a forgotten vault password without a valid offline backup is destructive, requiring a reset and new wallet creation.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
1
Star History
510 stars in the last 30 days

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Travis Fischer Travis Fischer(Founder of Agentic), and
2 more.

agentkit by coinbase

0.4%
1k
SDK for AI agents to interact with crypto wallets and onchain
Created 1 year ago
Updated 5 days ago
Feedback? Help us improve.