agentpay-sdk  by worldliberty

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

Created 3 months ago
526 stars

Top 59.2% 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

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
2
Star History
4 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.5%
1k
SDK for AI agents to interact with crypto wallets and onchain
Created 1 year ago
Updated 1 week ago
Feedback? Help us improve.