payment-skill
Agentic skill for requesting and accepting payments from / to humans and agents
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/second-state--payment-skill)HTML
<a href="/listings/second-state--payment-skill"><img src="/api/listings/second-state--payment-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Copy and paste the following sentence to give your agent the ability to request and receive payments.
For OpenClaw:
> Read https://raw.githubusercontent.com/second-state/payment-skill/refs/heads/main/openclaw/skills/payment/install.md and follow the instructions to set up the skill to request and receive payments from agents and humans.
For Claude Code:
> Read https://raw.githubusercontent.com/second-state/payment-skill/refs/heads/main/claude/skills/payment/install.md and follow the instructions to set up the skill to request and receive payments from agents and humans.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 174 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Payment skill for AI agents
- Agentic skill for AI agents to request and receive payments. If you are looking for the agentic skill to make payments for services and products, checkout https://money.flows.network
- ## Quick start
- Copy and paste the following sentence to give your agent the ability to request and receive payments.
- For OpenClaw:
- > Read https://raw.githubusercontent.com/second-state/payment-skill/refs/heads/main/openclaw/skills/payment/install.md and follow the instructions to set up the skill to request and receive payments from agents and humans.
- For Claude Code:
- > Read https://raw.githubusercontent.com/second-state/payment-skill/refs/heads/main/claude/skills/payment/install.md and follow the instructions to set up the skill to request and receive payments from agents and humans.
- ## Overview
- This project provides four CLI tools for Ethereum wallet management and token payments:
- ### create-wallet
- Creates a new Ethereum-compatible wallet with a secure random private key. The wallet is encrypted using the Web3 Secret Storage standard (keystore format) and saved to disk.
- ```bash
- create-wallet [OPTIONS]
- ```
- Key features:
- - Generates cryptographically secure private keys
- - Encrypts wallet using scrypt + AES-128-CTR
- - Auto-generates secure password if not provided
- - Outputs the wallet address to stdout
- ### get-address
- Retrieves the Ethereum address and token balance from an existing wallet without requiring the password.
- ```bash
- get-address [OPTIONS]
- ```
- Key features:
- - Reads address directly from keystore (no decryption needed)
- - Queries current token balance from blockchain (if network configured)
- - Outputs JSON with address, balance, token info, and network
- - Creates a new wallet automatically if none exists
- ### pay
- Transfers ERC-20 tokens or native ETH from your wallet to a recipient address.
- ```bash
- pay --to <ADDRESS> --amount <AMOUNT> [OPTIONS]
- ```
- Key features:
- - Supports ERC-20 token transfers (USDC, etc.)
- - Supports native ETH/gas token transfers
- - Checks balance before sending
- - Waits for transaction confirmation by default
- - Uses configuration for network and token defaults
- ### payment-config
- Manages configuration for all x402 tools. Stores settings in `config.toml` (located in the skill root directory, alongside the binaries).
- ```bash
- payment-config <COMMAND>
- ```
- Commands:
- - `show` - Display all current configuration
- - `get <KEY>` - Get a specific config value
- - `set <KEY> <VALUE>` - Set config values
- - `use-network <PROFILE>` - Apply a predefined network profile (base-sepolia, base-mainnet, etc.)
- - `list-networks` - List available network profiles
- - `list-keys` - List all valid config keys
- ## Personal Data Storage
- All personal data is stored in the skill root directory (the parent of the `scripts/` directory where binaries live):
- ```
- <skill-root>/
- ├── config.toml # Network, token, and payment settings
- ├── wallet.json # Encrypted wallet keystore (Web3 Secret Storage format)
- └── password.txt # Wallet password (auto-generated, 600 permissions)
- ```
- The data directory is determined at runtime via `std::env::current_exe()` — each binary resolves paths relative to its own location (`../` from the `scripts/` directory).
- ## Skill Directory Structure
- Platform-specific skill files live under `claude/` and `openclaw/`:
- ```
- claude/skills/payment/ # For Claude Code
- ├── bootstrap.sh
- ├── config-default.toml
- ├── install.md
- ├── SKILL.md
- └── scripts/
- openclaw/skills/payment/ # For OpenClaw
- ├── bootstrap.sh
- ├── config-default.toml
- ├── install.md
- ├── SKILL.md
- └── scripts/
- ```
- ### How Installation Works
- 1. **Clone skill files**: The install script copies the platform-specific directory to the agent's skill path:
- - Claude Code: `~/.claude/skills/payment/`
- - OpenClaw: `~/.openclaw/skills/payment/`
- 2. **Bootstrap binaries**: Running `bootstrap.sh` detects your platform (OS + architecture) and downloads the appropriate pre-compiled binaries from GitHub Releases
- 3. **Binary installation**: Binaries are extracted to the `scripts/` subdirectory and made executable
- Supported platforms:
- - Linux x86_64 / aarch64
- - macOS x86_64 / aarch64 (Apple Silicon)
- - Windows x86_64
- ### Final installed structure
- ```
- ~/.claude/skills/payment/ # (or ~/.openclaw/skills/payment/)
- ├── bootstrap.sh
- ├── config.toml # Created from config-default.toml
- ├── wallet.json # Created by create-wallet
- ├── password.txt # Auto-generated wallet password
- ├── SKILL.md
- └── scripts/
- ├── create-wallet
- ├── get-address
- ├── pay
- └── payment-config
- ```
- ## Development
- This is a Rust workspace with the following crates:
- | Crate | Description |
- |-------|-------------|
- | `payment-common` | Shared library for configuration, errors, and utilities |
- | `create-wallet` | Wallet creation CLI |
- | `get-address` | Address retrieval CLI |
- | `pay` | Token payment CLI |
- | `payment-config` | Configuration management CLI |
- ### Building
- ```bash
- cargo build --release
- ```
- ### Running tests
- ```bash
- cargo test
- ```
- ### Cross-compilation
- The project uses GitHub Actions to build binaries for all supported platforms. See `.github/workflows/ci.yml` for the CI configuration.
- ## License
- See [LICENSE](LICENSE) for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.