MoltsPay Skill

MoltsPay Client Skill

Pay for AI services using USDC/USDT across 8 crypto chains (gasless), or in CNY via Alipay (支付宝) — the fiat rail added in MoltsPay 2.0.

When to Use

• User asks to generate a video, image, or use any paid AI service
• User asks about wallet balance or payment history
• User wants to discover available services
• User mentions "pay", "buy", "purchase" + AI service

Available Commands

Supported Chains

Fiat Rail — Alipay (new in MoltsPay 2.0)

In addition to the crypto chains above, MoltsPay 2.0 adds a fiat rail: pay in CNY via Alipay (支付宝).

• Use it the same way as a chain: moltspay pay --chain alipay.
• A service exposes a CNY price when its provider has the Alipay rail enabled; if a service is crypto-only, pay on one of the crypto chains instead.
• Settlement is handled by the Alipay rail — the agent does not manage a crypto wallet for these payments.

Wallet Setup

moltspay init creates wallets for all chains:

EVM Chains (Base, Polygon, BNB, opBNB, Tempo):

• Single address works on all EVM chains
• Same private key, different networks

Solana:

• Separate Ed25519 keypair
• Different address from EVM

After setup, tell user their wallet addresses and that they need to fund with USDC on their preferred chain.

Discover Services

Marketplace Discovery

List all services on MoltsPay marketplace:

moltspay services https://moltspay.com

Single Provider Discovery

List services from a specific provider:

moltspay services https://juai8.com/zen7

Shows provider name, wallet, supported chains, and all services with prices.

Present results as a table to users:

Never show raw JSON to users - always format nicely.

Chain Selection (Pay Only)

When paying:

• If server accepts only one chain → auto-selected
• If server accepts multiple chains → specify with --chain

Examples:

# Pay on Base (recommended)
moltspay pay https://juai8.com/zen7 text-to-video --prompt "a cat dancing" --chain base

# Pay on Polygon
moltspay pay https://juai8.com/zen7 text-to-video --prompt "a cat dancing" --chain polygon

# Pay on BNB
moltspay pay https://juai8.com/zen7 text-to-video --prompt "a cat dancing" --chain bnb

# Pay on Solana
moltspay pay https://example.com/service image-gen --prompt "sunset" --chain solana

# Pay in CNY via Alipay (fiat, no crypto balance needed)
moltspay pay https://example.com/service text-to-video --prompt "a cat dancing" --chain alipay

Paying for Services

Use the moltspay pay command with the provider URL and service ID.

Parameters vary by service:

• --prompt for text-based services
• --image for image-based services
• --chain to specify which chain to pay on
• --token to specify token (USDC or USDT, default USDC)

Example: Zen7 video generation

moltspay pay https://juai8.com/zen7 text-to-video --prompt "sunset over ocean" --chain base

Spending Limits

Users can configure:

• max-per-tx: Maximum per transaction (default $2)
• max-per-day: Daily spending limit (default $10)

Use moltspay config to modify limits.

Funding Your Wallet

Option 1: QR Code (Easiest - No crypto needed!)

# Fund $10 on Base (recommended)
moltspay fund 10

# Fund $20 on Polygon  
moltspay fund 20 --chain polygon

# Fund $10 on Solana
moltspay fund 10 --chain solana

Scan QR code → pay with US debit card or Apple Pay → tokens arrive in ~2 minutes.

No CDP credentials or crypto knowledge needed. Server handles everything.

Option 2: Direct Transfer

EVM Chains - Same address works on Base, Polygon, BNB, opBNB:

• Send USDC from Coinbase, MetaMask, etc.
• Make sure you're on the correct network!

Solana - Different address:

• Send USDC to your Solana wallet address
• Check with moltspay status

⚠️ Important:

• Balance on Base ≠ Balance on Polygon ≠ Balance on Solana (separate!)
• Check balance per chain with moltspay status
• No ETH/MATIC/SOL needed for gas (gasless transactions via x402)
• Exception: BNB needs tiny amount of BNB for first approval (~$0.0001)

Common User Requests

"Generate a video of X"

1. Check wallet status (moltspay status)
2. If not initialized → run moltspay init
3. If balance is 0 → tell user to fund wallet
4. If funded → pay for text-to-video service with appropriate chain
5. Return video URL to user

"What's my balance?"

Run moltspay status and report:

• Wallet addresses (EVM + Solana)
• Balance on each chain
• Spending limits
• Today's usage

"What services are available?"

Run moltspay services https://moltspay.com to list marketplace. Format results as a clean table with service names, prices, and providers.

Error Handling

Testnet Faucets

For testing without real money:

# Get 1 USDC on Base Sepolia
moltspay faucet --chain base_sepolia

# Get 1 USDC on BNB Testnet (+ 0.001 tBNB for gas)
moltspay faucet --chain bnb_testnet

# Get 1 USDC on Solana Devnet
moltspay faucet --chain solana_devnet

Limit: 1 USDC per address per 24 hours.

Links

• Docs: https://moltspay.com/docs
• Marketplace: https://moltspay.com/services
• GitHub: https://github.com/Yaqing2023/moltspay-skill