tron-x402-payment

What This Skill Does

The tron-x402-payment skill enables seamless, automated cryptocurrency payments for AI agent interactions on the TRON blockchain. It specifically facilitates the x402 Payment Protocol, allowing an AI agent to automatically settle micro-payments using TRC20 tokens like USDT or USDD when accessing paid API endpoints. By abstracting the complexities of blockchain transactions, such as allowance approvals, signing EIP-712 typed data, and gas fee handling, this skill allows users to pay for premium agent compute or data resources without manual intervention. It functions by intercepting 402 Payment Required responses from agents and completing the necessary on-chain transactions before retrying the original request.

Installation

To integrate this skill into your environment, use the OpenClaw installer command via your terminal:

clawhub install openclaw/skills/skills/wzc1206/tron-x402-payment

After installation, ensure you have a valid TRON private key configured in your environment as TRON_PRIVATE_KEY or stored within ~/.mcporter/mcporter.json. If you are operating on the TRON Mainnet, it is highly recommended to provide a TRON_GRID_API_KEY to prevent rate limiting during payment verification and transaction broadcasts.

Use Cases

• Monetized AI Agents: Providing seamless access to paid AI services, analytical models, or specialized data endpoints.
• Automated Research: Paying for multiple API requests across various x402-enabled agent services during complex data gathering tasks.
• Decentralized SaaS: Paying for compute resources or external agent outputs in a trustless environment where standard credit card gateways are not available or applicable.

Example Prompts

1. "Invoke the agent at https://api.paid-model.com with the prompt 'Analyze the latest market sentiment for TRX' and handle the payment automatically."
2. "Check if my TRON wallet is correctly configured for the x402-payment skill and show me my current address."
3. "Call the agent endpoint https://market-oracle.io/entrypoints/price-check/invoke with input '{"symbol": "USDT"}' and pay using my default TRC20 token."

Tips & Limitations

• Gas Fees: Ensure your wallet holds enough TRX for transaction gas. The skill handles the token logic, but TRX is mandatory for network fees.
• Security: Never share your private key. Use secure environment variables or the standard ~/.mcporter/mcporter.json file configuration.
• Status Checks: Always run the --status command to verify your wallet configuration before initiating high-value transactions.
• Compatibility: This skill is optimized for TRC20 tokens; ensure your chosen agent supports USDT or USDD as specified in their documentation.