Last active
March 30, 2026 08:06
-
-
Save Aboudjem/0f3cc894ad7f1d67ffc45e03919deaab to your computer and use it in GitHub Desktop.
Integra PRD: 07-affiliate-agent (HTML)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>PRD: Affiliate Agent</title><style>*{margin:0;padding:0;box-sizing:border-box}body{background:#0A0A1A;color:#E8E8F0;font-family:'Inter',system-ui,sans-serif;line-height:1.7}a{color:#00CEC9;text-decoration:none}a:hover{text-decoration:underline}.hero{padding:48px 32px 36px;border-bottom:1px solid #2A2A4A;background:linear-gradient(135deg,#0A0A1A 0%,#1A1040 50%,#0A0A1A 100%)}.hero h1{font-size:2rem;font-weight:800;color:#fff;margin-bottom:8px}.hero .meta{display:flex;gap:10px;flex-wrap:wrap;margin-bottom:12px}.badge{display:inline-block;padding:4px 12px;border-radius:6px;font-size:12px;font-weight:700}.badge-owner{background:rgba(108,92,231,0.15);color:#A29BFE;border:1px solid rgba(108,92,231,0.3)}.badge-week{background:rgba(0,206,201,0.15);color:#00CEC9;border:1px solid rgba(0,206,201,0.3)}.badge-est{background:rgba(0,184,148,0.15);color:#00B894;border:1px solid rgba(0,184,148,0.3)}.container{max-width:900px;margin:0 auto;padding:32px 24px}.section{background:#12122A;border:1px solid #2A2A4A;border-radius:12px;padding:24px;margin-bottom:20px}.section h2{font-size:0.8rem;font-weight:700;color:#8888AA;text-transform:uppercase;letter-spacing:1.5px;margin-bottom:14px;padding-bottom:8px;border-bottom:1px solid #2A2A4A}.section h3{font-size:0.95rem;font-weight:600;color:#E8E8F0;margin:12px 0 6px}.section p{font-size:0.95rem;margin-bottom:8px}.section ul{list-style:none;padding:0}.section ul li{padding:6px 0 6px 20px;position:relative;font-size:0.95rem}.section ul li::before{content:'>';position:absolute;left:0;color:#A29BFE;font-weight:700;font-family:monospace}.section code{background:rgba(108,92,231,0.1);padding:2px 6px;border-radius:4px;font-size:0.88rem;color:#A29BFE}table{width:100%;border-collapse:collapse;font-size:0.9rem;margin:8px 0}th{text-align:left;padding:8px 12px;background:rgba(108,92,231,0.08);color:#A29BFE;font-size:0.75rem;text-transform:uppercase;letter-spacing:1px;border-bottom:1px solid #2A2A4A}td{padding:8px 12px;border-bottom:1px solid rgba(42,42,74,0.5)}.checklist li::before{content:'\2610' !important;color:#8888AA !important;font-family:inherit !important}.back{display:inline-block;margin-bottom:16px;color:#8888AA;font-size:0.9rem}.footer{text-align:center;padding:24px;color:#555577;font-size:0.82rem;border-top:1px solid #2A2A4A;margin-top:32px}</style></head><body><div class="hero"><a class="back" href="https://gist.githack.com/Aboudjem/0af8c2ce9d5b62038a18eeff09603553/raw/integra-testnet-master-plan.html">← Back to Master Plan</a><h1>Affiliate Agent</h1><div class="meta"><span class="badge badge-owner">Kalki</span><span class="badge badge-week">Week 2</span><span class="badge badge-est">0.5-1d</span></div><p style="color:#8888AA;font-size:0.9rem">affiliate-agent.integralayer.com</p></div><div class="container"><div class="section"><h2>Overview</h2><div class=""><p>An AI agent that promotes GOB property listings via on-chain referral links and earns IRL commission (0.5% of sale price) on completed transactions. No property ownership required — anyone can deploy one with zero capital. The agent selects high-value listings to promote, generates unique referral codes, and tracks attribution on-chain. Commission comes from the GOB protocol fee, adding no extra cost to buyers or sellers.</p></div></div> | |
| <div class="section"><h2>Features</h2><div class=""><ul><li><strong>Zero-Capital Entry</strong> — no property ownership or upfront funding required to start earning</li></ul><ul><li><strong>On-Chain Referral Tracking</strong> — unique referral codes tied to agent wallet, attribution verified on-chain</li></ul><ul><li><strong>Smart Listing Selection</strong> — agent picks listings to promote based on configurable preferences (type, price, recency)</li></ul><ul><li><strong>Auto-Commission Distribution</strong> — 0.5% of sale price auto-distributes to affiliate wallet on conversion</li></ul><ul><li><strong>Earnings Dashboard</strong> — referrals generated, click tracking, conversions, and IRL earned in one view</li></ul><ul><li><strong>Batch Commission Claiming</strong> — claim all accumulated commissions in a single transaction</li></ul><ul><li><strong>Promotion Preferences</strong> — configure which property types, price ranges, and styles the agent promotes</li></ul><ul><li><strong>Conversion Funnel Analytics</strong> — track the full funnel from referral generation to completed sale</li></ul><ul><li><strong>Agent Arena Listing</strong> — registered as affiliate type with conversion rate, total earnings, and activity stats</li></ul><ul><li><strong>One-Click Promote</strong> — browse GOB listings and generate referral links instantly</li></ul></div></div> | |
| <div class="section"><h2>Functions</h2><div class=""><ul><li><code>registerAffiliate</code> — register the agent in the AffiliateRegistry and receive an affiliate ID</li></ul><ul><li><code>generateReferral</code> — create a unique on-chain referral code for a specific GOB listing</li></ul><ul><li><code>claimCommission</code> — withdraw accumulated commissions from completed referral conversions</li></ul><ul><li><code>getEarnings</code> — view total and unclaimed earnings across all referral codes</li></ul><ul><li><code>setPreferences</code> — configure promotion preferences: property types, min listing price, promotion style</li></ul><ul><li><code>scanListings</code> — find high-value GOB listings matching promotion preferences</li></ul></div></div> | |
| <div class="section"><h2>User Flow</h2><div class=""><ul><li>Connect wallet via Web3Auth and land on the Affiliate Agent setup page</li></ul><ul><li>Configure promotion preferences: property types, min listing price, promotion style</li></ul><ul><li>Grant AgentAuth authorization for referral generation and commission claiming</li></ul><ul><li>Agent scans GOB for high-value listings matching preferences</li></ul><ul><li>Agent generates unique referral links with on-chain referral IDs</li></ul><ul><li>Buyers who purchase through a referral link trigger 0.5% commission auto-distribution</li></ul><ul><li>User views earnings dashboard: referrals generated, conversions, IRL earned</li></ul><ul><li>User claims accumulated commissions in a single transaction</li></ul></div></div> | |
| <div class="section"><h2>Deliverables</h2><div class="checklist"><ul class="checklist"><li>AffiliateRegistry contract for referral tracking and commission distribution</li></ul><ul class="checklist"><li>Referral code generation tied to agent wallet</li></ul><ul class="checklist"><li>On-chain attribution from referral click through to sale completion</li></ul><ul class="checklist"><li>0.5% commission auto-distribution from GOB protocol fee</li></ul><ul class="checklist"><li>Earnings dashboard with conversion funnel (generated, clicked, converted, earned)</li></ul><ul class="checklist"><li>Batch commission claiming in a single tx</li></ul><ul class="checklist"><li>Promotion preference configuration UI</li></ul><ul class="checklist"><li>Browsable GOB listings page with one-click promote</li></ul><ul class="checklist"><li>Agent Arena registration as affiliate type with earnings stats</li></ul></div></div> | |
| <div class="section"><h2>Integration Points</h2><div class=""><ul><li><strong>Depends on:</strong> GOB (active listings, sale completion hook), AffiliateRegistry (referral tracking, commission), AgentAuth (delegation)</li></ul><ul><li><strong>Used by:</strong> Agent Arena (catalog discovery), No-Code Launchpad (template)</li></ul><ul><li><strong>Explorer:</strong> Integra Explorer (github.com/Integra-layer/integra-explorer)</li></ul></div></div> | |
| <div class="section"><h2>XP Rewards</h2><div class=""><table><thead><tr><th>Action</th><th>Points</th></tr></thead><tbody><tr><td>Register as affiliate</td><td>25 XP</td></tr><tr><td>Generate referral link</td><td>10 XP</td></tr><tr><td>Referral conversion (sale completed)</td><td>150 XP</td></tr><tr><td>Earn 100+ IRL in commissions (milestone)</td><td>500 XP</td></tr></tbody></table></div></div> | |
| <div class="section"><h2>Success Metrics</h2><div class=""><table><thead><tr><th>Metric</th><th>Target</th></tr></thead><tbody><tr><td>Affiliate agents registered in first week</td><td>100+</td></tr><tr><td>Referral-to-conversion rate</td><td>> 3%</td></tr><tr><td>Total IRL distributed in commissions (month 1)</td><td>1,000+ IRL</td></tr><tr><td>Avg referrals generated per agent per day</td><td>> 10</td></tr></tbody></table></div></div> | |
| </div><div class="footer">Integra Testnet PRD — Affiliate Agent — Chain: integra-testnet-1 (EVM 26218)</div></body></html> |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment