Last active
March 30, 2026 08:06
-
-
Save Aboudjem/fde2b556094f9b52d9441e243bec4f6c to your computer and use it in GitHub Desktop.
Integra PRD: 06-buyer-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: Buyer 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>Buyer 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">buyer-agent.integralayer.com</p></div><div class="container"><div class="section"><h2>Overview</h2><div class=""><p>An AI agent that scans the GOB orderbook 24/7 for properties matching user-defined criteria and submits offers automatically. Runs as a persistent background process, negotiates across timezones, and executes purchases via AgentAuth when terms are met. Completes the two-sided agent marketplace alongside the Selling Agent, enabling fully autonomous agent-to-agent negotiation.</p></div></div> | |
| <div class="section"><h2>Features</h2><div class=""><ul><li><strong>Criteria-Based Search</strong> — user defines property type, price range, location tags, minimum yield, and max portfolio size</li></ul><ul><li><strong>Continuous Scanning</strong> — agent polls GOB listings on a recurring interval, scoring matches against criteria</li></ul><ul><li><strong>Auto-Offer Submission</strong> — submits offers on matching properties above a configurable match threshold</li></ul><ul><li><strong>Counteroffer Handling</strong> — evaluates and responds to seller counteroffers within the user's spending cap</li></ul><ul><li><strong>Spending Cap Enforcement</strong> — hard limit on total IRL the agent can deploy, enforced at the AgentAuth level</li></ul><ul><li><strong>Agent-to-Agent Negotiation</strong> — interacts directly with Selling Agents for fully autonomous deal flow</li></ul><ul><li><strong>Acquisition Portfolio View</strong> — dedicated page showing all acquired assets with cost basis and current value</li></ul><ul><li><strong>Pause and Reconfigure</strong> — user can pause the agent, update criteria, or revoke access at any time</li></ul><ul><li><strong>Agent Arena Registration</strong> — listed in the catalog with match rate, offers/acquisitions ratio, and avg price vs ask</li></ul><ul><li><strong>Activity Feed</strong> — real-time log of scans, offers sent, counters received, and acquisitions completed</li></ul></div></div> | |
| <div class="section"><h2>Functions</h2><div class=""><ul><li><code>setCriteria</code> — define search parameters: property types, price range, tags, min yield, max holdings</li></ul><ul><li><code>scanAndOffer</code> — scan GOB listings, score against criteria, submit offers for qualifying matches</li></ul><ul><li><code>handleCounter</code> — evaluate a seller's counteroffer and accept or walk away based on spending rules</li></ul><ul><li><code>withdrawFunds</code> — pull undeployed IRL back from the agent wallet to the user wallet</li></ul><ul><li><code>pauseAgent</code> — temporarily halt all scanning and offer activity without revoking auth</li></ul><ul><li><code>registerAgent</code> — register in Agent Arena with discovery metadata and performance stats</li></ul></div></div> | |
| <div class="section"><h2>User Flow</h2><div class=""><ul><li>Connect wallet via Web3Auth and land on the criteria configuration page</li></ul><ul><li>Set search criteria: property type, price range, location tags, min yield, max properties</li></ul><ul><li>Fund the agent wallet with IRL and set a spending cap</li></ul><ul><li>Grant AgentAuth authorization for offer submission and counter handling</li></ul><ul><li>Agent begins scanning GOB and submitting offers on matches</li></ul><ul><li>Agent handles counteroffers autonomously within spending rules</li></ul><ul><li>User monitors all activity in the dashboard: scans, offers, counters, acquisitions</li></ul><ul><li>User can pause, reconfigure criteria, or revoke the agent at any time</li></ul></div></div> | |
| <div class="section"><h2>Deliverables</h2><div class="checklist"><ul class="checklist"><li>Criteria configuration UI (type, price range, tags, yield, max properties)</li></ul><ul class="checklist"><li>Agent wallet funding and spending cap enforcement</li></ul><ul class="checklist"><li>GOB scanning engine with match scoring</li></ul><ul class="checklist"><li>Automated offer submission via AgentAuth</li></ul><ul class="checklist"><li>Counteroffer evaluation and response logic</li></ul><ul class="checklist"><li>Real-time activity dashboard with offer status tracking</li></ul><ul class="checklist"><li>Acquired assets portfolio view with cost basis</li></ul><ul class="checklist"><li>Agent Arena registration with performance metrics</li></ul><ul class="checklist"><li>Pause, reconfigure, and revocation controls</li></ul></div></div> | |
| <div class="section"><h2>Integration Points</h2><div class=""><ul><li><strong>Depends on:</strong> GOB (listing discovery, offer/counter/trade), AgentAuth (delegation), Asset Passport ERC-721 (property metadata matching), IRWAToken (transfer on acquisition)</li></ul><ul><li><strong>Used by:</strong> Selling Agent (agent-to-agent negotiation), Agent Arena (catalog), 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>Configure search criteria</td><td>25 XP</td></tr><tr><td>Submit offer on GOB</td><td>30 XP</td></tr><tr><td>Complete an acquisition</td><td>250 XP</td></tr><tr><td>Agent active for 24h+</td><td>10 XP/day</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>Offers submitted per active agent per day</td><td>> 5</td></tr><tr><td>Offer-to-acquisition conversion rate</td><td>> 10%</td></tr><tr><td>Avg acquisition price vs listing ask</td><td>< 95%</td></tr><tr><td>Active buyer agents in first week</td><td>30+</td></tr></tbody></table></div></div> | |
| </div><div class="footer">Integra Testnet PRD — Buyer 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