💰 Paid Claim Module

📖 How to Use

Add this module to any page by including the HTML element with configuration:

<!-- Load Module System -->
<script src="/modules/module-loader.js"></script>

<!-- Add Module to Page -->
<div id="my-paid-claim" data-module="paid-claim" data-config='{
  "template_id": 251276,
  "price_wax": "10.00000000",
  "payment_wallet": "your.wallet",
  "collection_name": "yourcollection",
  "template_name": "Cool NFT",
  "template_image": "https://example.com/image.png",
  "max_supply": 100,
  "per_wallet_limit": 3,
  "auto_connect": false,
  "show_purchase_history": true
}'></div>

⚙️ Configuration Options

• template_id (required): NFT template ID to mint
• price_wax (required): Price in WAX with 8 decimals (e.g., "10.00000000")
• payment_wallet (required): Wallet that receives payments
• collection_name: Collection name (default: "futuresrelic")
• template_name: Display name for the NFT
• template_image: URL to NFT image/video
• max_supply: Maximum number available (optional, for display)
• per_wallet_limit: Max purchases per wallet (optional, for display)
• auto_connect: Auto-connect wallet on load (default: false)
• show_purchase_history: Show purchase history (default: true)

✨ Features

• ✅ Direct Payment Processing - Users pay WAX tokens directly
• ✅ Automatic NFT Minting - NFT minted immediately after payment verification
• ✅ Dual Wallet Support - Works with both WAX Cloud Wallet and Anchor
• ✅ Transaction Verification - On-chain payment verification prevents fraud
• ✅ Purchase History - Track all purchases per wallet
• ✅ No External Dependencies - Bypass NeftyBlocks embeds entirely
• ✅ Duplicate Prevention - Same payment can't be processed twice
• ✅ Full Customization - Complete control over styling and UX

🔄 How It Works

1. User connects their WAX wallet (WCW or Anchor)
2. Module displays purchasable NFT with price
3. User clicks "Purchase" button
4. Wallet prompts user to sign WAX token transfer
5. Payment transaction sent to blockchain
6. Frontend sends payment TX ID to backend
7. Backend verifies payment on-chain (amount, recipient, sender)
8. Backend mints NFT to user's wallet
9. Purchase recorded in database
10. User receives success confirmation with transaction links

🛠️ Backend Setup

The backend automatically handles:

• Payment Verification - POST /api/user/purchase
• Purchase History - GET /api/user/purchases/:account
• Database Tracking - All purchases logged in SQLite
• Idempotency - Prevents duplicate minting from same payment
• Error Handling - CPU exhaustion, verification failures, etc.

💡 Use Cases

• Fixed-Price NFT Sales - Sell specific templates at set prices
• Limited Edition Drops - Track supply and enforce limits
• Membership Passes - Sell access NFTs for communities
• Event Tickets - NFT-based ticketing with payment
• Digital Collectibles - Direct-to-consumer NFT sales
• Premium Content Access - Gated content via NFT purchase

🚀 Why Use This Instead of NeftyBlocks?

• ✅ Full Control - Your platform, your branding, your rules
• ✅ No Embeds - Faster loading, cleaner UI, no iframes
• ✅ Integrated Experience - Seamless with your existing modules
• ✅ Complete Data - All purchase records in your database
• ✅ Custom Features - Add discounts, bundles, time limits, etc.
• ✅ No External Dependency - Never worry about NeftyBlocks downtime
• ✅ Better UX - Streamlined flow without external redirects