berrypay_skill

This skill manages BerryPay CLI operations for Nano (XNO), enabling balance checks, sending, charges, and automatic sweeping with JSON outputs.

TypeScript

1

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill strawberry-labs/berrypay-cli --skill berrypay

SKILL.md12.5 KB

Overview

This skill manages a Nano (XNO) wallet and payment processing via the BerryPay CLI. It provides passwordless, JSON-first commands for balance checks, sending/receiving XNO, creating timed payment charges with webhooks, generating QR codes, and automatic sweeping of ephemeral addresses to your main wallet. Designed for automation and AI agents, it supports environment-seeded wallets and continuous listener operation.

How this skill works

The skill wraps BerryPay CLI operations to inspect wallet state, create ephemeral charge addresses, and monitor the Nano network via WebSocket. Commands emit JSON for programmatic parsing; balance and send commands auto-receive pending funds. Charge creation starts a background listener that detects payments, auto-receives and auto-sweeps funds to the main wallet, and POSTs a webhook when a charge completes.

When to use it

Accept one-off or timed Nano (XNO) payments with webhook notifications
Programmatically check wallet balance and incoming pending funds before sending
Create payment QR codes to share with users via chat or web
Automatically sweep ephemeral payment addresses into the main wallet
Run unattended transfers or integrations in server/agent contexts

Best practices

Set BERRYPAY_SEED via environment variable for secure, reproducible agent operation
Always use --yes when invoking send to skip interactive confirmation in automation
Parse JSON-only output (use --json) for reliable downstream processing
Use webhook callbacks instead of polling charge status to reduce API calls
Store charge IDs and webhook metadata so you can correlate payments to orders or jobs

Example use cases

Create a charge with webhook and metadata to request XNO for a service, then deliver service after webhook confirms payment
Generate a PNG QR for a payment and send it to a chat user; webhook notifies when payment is swept
Periodic agent job checks balance, auto-receives pending funds, and sends payouts using --yes
Integrate BerryPay into a Node.js backend to create charges programmatically and handle charge:swept events

FAQ

Set BERRYPAY_SEED environment variable to your 64-character hex seed. It overrides local config and is preferred for agents.

How do I know a charge completed and funds were moved to the main wallet?

Use berrypay charge status <id> or receive a POST to your webhook. Status shows isPaid and swept fields; webhook payload includes sweepTxHash and timestamps.