solana-pay

What This Skill Does

The solana-pay skill provides a robust interface for interacting with the Solana Pay decentralized payment protocol. It enables OpenClaw agents to generate standardized payment requests that are compatible with any Solana Pay-compliant wallet like Phantom or Solflare. Beyond simple transfers, this skill supports SPL token transactions, allowing merchants to accept USDC, USDT, or meme coins natively. The skill streamlines the merchant experience by automating the generation of cryptographically secure payment references, managing QR code generation for physical or digital point-of-sale displays, and providing the necessary tooling to verify transaction finality via direct RPC interaction. By bridging the gap between blockchain logic and human-readable payment requests, it transforms the agent into a reliable financial processing engine.

Installation

To integrate this skill into your environment, use the OpenClaw package manager:

clawhub install openclaw/skills/skills/0xterrybit/solana-pay

After installation, ensure your environment is configured with the required SOLANA_KEYPAIR_PATH. You may optionally configure SOLANA_RPC_URL if you wish to use a dedicated private node for higher request reliability.

Use Cases

• Point of Sale Systems: Generate dynamic QR codes for in-person transactions where the agent acts as the payment processor.
• E-commerce Checkout: Integrate the agent into a web backend to generate unique payment links for specific order IDs using the reference parameter.
• Automated Invoicing: Create and track payment requests for digital service subscriptions or freelance invoices where programmatic verification is required.

Example Prompts

1. "Generate a Solana Pay payment request for 50 USDC to my merchant wallet, include 'Invoice #992' as the memo, and save the QR code to my desktop."
2. "Verify the status of the transaction associated with the reference code 8a7b6c5d... and confirm if the payment was received in full."
3. "Show me the current QR code for a 2 SOL payment to my configured merchant address with the label 'Premium Subscription'."

Tips & Limitations

When using this skill, always double-check the mint address of the SPL token being used, as transactions to incorrect mints can be difficult to recover. Ensure your RPC provider is stable, as heavy traffic on the mainnet might cause delays in signature verification. Always maintain strict security over the SOLANA_KEYPAIR_PATH, as this file provides full control over the funds. Remember that payment verification relies on the presence of the transaction signature within the account history; if a user sends funds without using the provided reference, the agent will not be able to automatically map the payment to a specific order.