Overview

Step-by-step tutorials for integrating MoltMPP with OpenClaw agents and building autonomous payment workflows.

Getting Started

New to MoltMPP? Start with the Quickstart to execute your first MPP payment in 10 minutes.

Available Guides

OpenClaw Integration

Integrate MoltMPP with the OpenClaw agent framework to enable autonomous MPP payments. Learn how to:

• Configure the SolanaPaymentProvider

• Execute payments from natural language instructions

• Build autonomous workflows with payment capabilities

• Handle errors and retries gracefully

Difficulty: Beginner Time: 20 minutes

---

Approval Policies

Configure spending limits, merchant allowlists, and approval workflows to control autonomous payment behavior. Topics include:

• Policy structure and evaluation rules

• Auto-approval for low-risk transactions

• Human-in-the-loop for high-value payments

• Daily/weekly spending limits

• Merchant verification requirements

Difficulty: Intermediate Time: 15 minutes

---

Service Discovery

Discover MPP-enabled services programmatically so agents can find and pay for APIs autonomously. Learn:

• Querying the MPP service directory

• Detecting MPP support via HTTP headers

• Parsing payment method requirements

• Building service recommendation engines

Difficulty: Intermediate Time: 25 minutes

---

Solana Wallet Setup

Set up and manage Solana wallets for agent payments. Covers:

• Creating new wallets with solana-keygen

• Funding wallets with SOL and USDC

• Secure key storage and rotation

• Multi-wallet strategies for agent fleets

• Devnet vs mainnet-beta configuration

Difficulty: Beginner Time: 15 minutes

---

MPP Protocol Deep-Dive

Technical deep-dive into the Machine Payments Protocol specification. Advanced topics:

• HTTP 402 payment request structure

• Payment credential generation

• Proof of delivery verification

• Receipt validation and dispute resolution

• MPP version negotiation

Difficulty: Advanced Time: 40 minutes

---

Common Patterns

Research Agent

Build an agent that autonomously pays for premium data APIs:

from openclaw import Agent
from moltmpp import SolanaPaymentProvider

provider = SolanaPaymentProvider(
    network="mainnet-beta",
    wallet_path="~/.config/solana/id.json",
    policies={"max_per_transaction": 10.00}
)

agent = Agent(name="research_assistant", providers=[provider])

result = agent.run("""
Find premium weather forecasts for New York City.
Pay for API access if under $10.
Return the 7-day forecast.
""")

Autonomous API Consumer

Agent that discovers services and manages payment budgets:

agent.run("""
I need to analyze sentiment for 1000 tweets.
Find a sentiment analysis API that accepts MPP.
Negotiate best price and execute payment.
Stay within $50 budget.
""")

Content Generation Pipeline

Multi-step workflow with multiple payments:

agent.run("""
1. Pay for stock photo API - search "technology"
2. Pay for copywriting API - generate product description
3. Pay for PDF generation API - create marketing flyer
4. Return final PDF
Budget: $25 total
""")

Best Practices

Start with Devnet

Always test on Solana devnet before moving to mainnet-beta:

const mpp = new MoltMPPClient({
  solanaRpc: 'https://api.devnet.solana.com',
  wallet: wallet,
  network: 'devnet'
})

Implement Spending Limits

Never deploy agents without spending limits:

policies:
  - name: daily_limit
    conditions:
      daily_limit_usd: 100
    action: auto_approve

  - name: block_over_limit
    conditions:
      min_value_usd: 100
    action: reject

Monitor Transaction History

Regularly audit payment activity:

const history = await mpp.getTransactionHistory({
  since: Date.now() - 86400000, // Last 24 hours
  includeFailures: true
})

for (const tx of history) {
  console.log(`${tx.service}: $${tx.amountUSD} - ${tx.status}`)
}

Use Merchant Allowlists

Restrict agents to verified services:

policies:
  - name: verified_only
    conditions:
      merchant_allowlist:
        - "weather-api.com"
        - "sentiment-analysis.ai"
        - "pdf-generator.io"
    action: auto_approve

Troubleshooting

"Insufficient USDC balance"

Check wallet balance and fund if needed:

solana balance <wallet-address>
# Transfer USDC to agent wallet

"MPP service not found"

Service may not support MPP yet. Check headers:

curl -I https://api.example.com/endpoint
# Look for: MPP-Version header

"Payment rejected by policy"

Review policy configuration and transaction details:

const evaluation = await mpp.evaluatePolicy({
  amount: 5_000_000,
  merchant: "merchant-address"
})
console.log(evaluation)

"Transaction timeout"

Solana RPC may be slow. Use dedicated endpoint:

const mpp = new MoltMPPClient({
  solanaRpc: 'https://your-dedicated-rpc.com',
  // or use multiple for failover
  solanaRpcBackup: 'https://backup-rpc.com'
})

Next Steps

• Architecture: Understand MPP + Solana integration

• API Reference: Complete SDK documentation

• Security: Production deployment best practices

Get Help

• Discord: discord.gg/moltmpp - #guides channel

• GitHub Discussions: github.com/moltmpp/sdk/discussions

• Email: [email protected]