Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/second-state--payment-skill/badge.svg)](/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

i

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)

  1. # Payment skill for AI agents
  2. 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
  3. ## Quick start
  4. Copy and paste the following sentence to give your agent the ability to request and receive payments.
  5. For OpenClaw:
  6. > 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.
  7. For Claude Code:
  8. > 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.
  9. ## Overview
  10. This project provides four CLI tools for Ethereum wallet management and token payments:
  11. ### create-wallet
  12. 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.
  13. ```bash
  14. create-wallet [OPTIONS]
  15. ```
  16. Key features:
  17. - Generates cryptographically secure private keys
  18. - Encrypts wallet using scrypt + AES-128-CTR
  19. - Auto-generates secure password if not provided
  20. - Outputs the wallet address to stdout
  21. ### get-address
  22. Retrieves the Ethereum address and token balance from an existing wallet without requiring the password.
  23. ```bash
  24. get-address [OPTIONS]
  25. ```
  26. Key features:
  27. - Reads address directly from keystore (no decryption needed)
  28. - Queries current token balance from blockchain (if network configured)
  29. - Outputs JSON with address, balance, token info, and network
  30. - Creates a new wallet automatically if none exists
  31. ### pay
  32. Transfers ERC-20 tokens or native ETH from your wallet to a recipient address.
  33. ```bash
  34. pay --to <ADDRESS> --amount <AMOUNT> [OPTIONS]
  35. ```
  36. Key features:
  37. - Supports ERC-20 token transfers (USDC, etc.)
  38. - Supports native ETH/gas token transfers
  39. - Checks balance before sending
  40. - Waits for transaction confirmation by default
  41. - Uses configuration for network and token defaults
  42. ### payment-config
  43. Manages configuration for all x402 tools. Stores settings in `config.toml` (located in the skill root directory, alongside the binaries).
  44. ```bash
  45. payment-config <COMMAND>
  46. ```
  47. Commands:
  48. - `show` - Display all current configuration
  49. - `get <KEY>` - Get a specific config value
  50. - `set <KEY> <VALUE>` - Set config values
  51. - `use-network <PROFILE>` - Apply a predefined network profile (base-sepolia, base-mainnet, etc.)
  52. - `list-networks` - List available network profiles
  53. - `list-keys` - List all valid config keys
  54. ## Personal Data Storage
  55. All personal data is stored in the skill root directory (the parent of the `scripts/` directory where binaries live):
  56. ```
  57. <skill-root>/
  58. ├── config.toml # Network, token, and payment settings
  59. ├── wallet.json # Encrypted wallet keystore (Web3 Secret Storage format)
  60. └── password.txt # Wallet password (auto-generated, 600 permissions)
  61. ```
  62. 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).
  63. ## Skill Directory Structure
  64. Platform-specific skill files live under `claude/` and `openclaw/`:
  65. ```
  66. claude/skills/payment/ # For Claude Code
  67. ├── bootstrap.sh
  68. ├── config-default.toml
  69. ├── install.md
  70. ├── SKILL.md
  71. └── scripts/
  72. openclaw/skills/payment/ # For OpenClaw
  73. ├── bootstrap.sh
  74. ├── config-default.toml
  75. ├── install.md
  76. ├── SKILL.md
  77. └── scripts/
  78. ```
  79. ### How Installation Works
  80. 1. **Clone skill files**: The install script copies the platform-specific directory to the agent's skill path:
  81. - Claude Code: `~/.claude/skills/payment/`
  82. - OpenClaw: `~/.openclaw/skills/payment/`
  83. 2. **Bootstrap binaries**: Running `bootstrap.sh` detects your platform (OS + architecture) and downloads the appropriate pre-compiled binaries from GitHub Releases
  84. 3. **Binary installation**: Binaries are extracted to the `scripts/` subdirectory and made executable
  85. Supported platforms:
  86. - Linux x86_64 / aarch64
  87. - macOS x86_64 / aarch64 (Apple Silicon)
  88. - Windows x86_64
  89. ### Final installed structure
  90. ```
  91. ~/.claude/skills/payment/ # (or ~/.openclaw/skills/payment/)
  92. ├── bootstrap.sh
  93. ├── config.toml # Created from config-default.toml
  94. ├── wallet.json # Created by create-wallet
  95. ├── password.txt # Auto-generated wallet password
  96. ├── SKILL.md
  97. └── scripts/
  98. ├── create-wallet
  99. ├── get-address
  100. ├── pay
  101. └── payment-config
  102. ```
  103. ## Development
  104. This is a Rust workspace with the following crates:
  105. | Crate | Description |
  106. |-------|-------------|
  107. | `payment-common` | Shared library for configuration, errors, and utilities |
  108. | `create-wallet` | Wallet creation CLI |
  109. | `get-address` | Address retrieval CLI |
  110. | `pay` | Token payment CLI |
  111. | `payment-config` | Configuration management CLI |
  112. ### Building
  113. ```bash
  114. cargo build --release
  115. ```
  116. ### Running tests
  117. ```bash
  118. cargo test
  119. ```
  120. ### Cross-compilation
  121. The project uses GitHub Actions to build binaries for all supported platforms. See `.github/workflows/ci.yml` for the CI configuration.
  122. ## License
  123. See [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.