tokenized-agents

Create and verify Solana token payment instructions for agent actions.

5|Updated May 2, 2026
One-click install
npx skills add https://github.com/nirholas/three-ui --skill tokenized-agents-nirholas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tokenized-agents
Source: https://github.com/nirholas/three-ui/tree/main/pump-fun-skills/tokenized-agents
Command: npx skills add https://github.com/nirholas/three-ui --skill tokenized-agents-nirholas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you charge users for agent actions by generating Solana payment instructions and reliably verifying that an on-chain invoice was actually paid.

Core Features & Use Cases

  • Build tokenized payment transactions: generates Solana transaction instructions for accepting payment using @pump-fun/agent-payments-sdk, covering both SPL tokens (e.g., USDC) and native SOL (via wrapped SOL flow).
  • Derive deterministic invoice identity (PDA): uses a deterministic invoice ID derived from mint, currency mint, amount, memo, and time window so you can prevent duplicate charging.
  • Verify payments server-side: confirms payments with validateInvoicePayment (HTTP verification with optional RPC/log fallback) before delivering the service.
  • Use Case: charge users a fixed price for a premium agent workflow (e.g., “run the 3D model animation render + export”) by building an unsigned transaction, having the user sign it, and only then unlocking the expensive work after verification.

Quick Start

Ask the user for the required agent token mint address, payment currency (USDC or SOL), price/amount in smallest units, an RPC URL (or confirm a chosen fallback), and the framework you are using (Next.js, Express, other).

Frequently Asked Questions about tokenized-agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I charge for agent actions with Solana payments?

To charge for agent actions with Solana payments, you can build unsigned payment instructions using @pump-fun/agent-payments-sdk, have the client sign and broadcast the transaction, and verify the on-chain invoice server-side before unlocking the service.

What is a deterministic invoice PDA and how does it prevent duplicate charging?

A deterministic invoice PDA is an on-chain account identity derived from the mint, currency mint, amount, memo, and time window. It prevents duplicate charging by ensuring each invoice maps to a unique, verifiable Solana account address.

Can I accept USDC and wrapped SOL for monetized agent workflows?

Yes, you can accept both SPL tokens like USDC and native SOL through a wrapped SOL flow. The SDK generates the appropriate Solana transaction instructions for accepting payment in either currency format.

How do I verify Solana token payments server-side before delivering a service?

You verify Solana token payments server-side using the validateInvoicePayment function, which confirms the on-chain payment status via HTTP verification with optional RPC and log fallbacks before you unlock the expensive agent workflow.

What parameters are required to build Solana payment instructions for agent monetization?

Building Solana payment instructions requires the agent token mint address, payment currency (USDC or SOL), price amount in smallest units, an RPC URL, and the development framework like Next.js or Express to construct the transaction.

Why should I use server-side verification guardrails for on-chain invoice payments?

Server-side verification guardrails are necessary to prevent fraudulent service access by ensuring the validateInvoicePayment function strictly confirms the exact parameter matching of the on-chain Solana transaction before any premium agent work is executed.