Skip to content

Instantly share code, notes, and snippets.

@Aboudjem
Last active March 30, 2026 08:06
Show Gist options
  • Select an option

  • Save Aboudjem/3223e06924a68052f08ab6ad70e052d9 to your computer and use it in GitHub Desktop.

Select an option

Save Aboudjem/3223e06924a68052f08ab6ad70e052d9 to your computer and use it in GitHub Desktop.
Integra PRD: 05-selling-agent (HTML)
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>PRD: Selling 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">&larr; Back to Master Plan</a><h1>Selling 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">selling-agent.integralayer.com</p></div><div class="container"><div class="section"><h2>Overview</h2><div class=""><p>An AI agent that lists tokenized properties on the Global Order Book and autonomously negotiates with potential buyers. The owner sets rules — minimum price, maximum discount, deadline, auto-accept threshold — and the agent handles counteroffers, acceptance, and on-chain execution via AgentAuth delegation. First autonomous seller on Integra, proving the AI-agent-as-fiduciary model end-to-end.</p></div></div>
<div class="section"><h2>Features</h2><div class=""><ul><li><strong>Rule-Based Listing</strong> — owner configures min price, max discount %, deadline, and auto-accept threshold per token</li></ul><ul><li><strong>Autonomous Negotiation</strong> — agent evaluates incoming offers against rules, counters or accepts without manual intervention</li></ul><ul><li><strong>AgentAuth Delegation</strong> — user grants scoped authorization (list, accept, counter, cancel) with IRL spending limit</li></ul><ul><li><strong>Real-Time Dashboard</strong> — listing status, offer history, agent action log, and notification feed</li></ul><ul><li><strong>Override Controls</strong> — owner can override any pending agent decision or revoke authorization instantly</li></ul><ul><li><strong>Agent Arena Registration</strong> — agent appears in the catalog with stats (listings, sales, avg time-to-sell)</li></ul><ul><li><strong>Multi-Token Support</strong> — list and manage multiple properties simultaneously from one dashboard</li></ul><ul><li><strong>Event-Driven Notifications</strong> — push alerts on new offers, counteroffers, acceptances, and expirations</li></ul><ul><li><strong>Deadline Enforcement</strong> — auto-cancels listings when deadline passes without a qualifying offer</li></ul><ul><li><strong>On-Chain Execution</strong> — all trades settle on-chain via GOB with full tx transparency</li></ul></div></div>
<div class="section"><h2>Functions</h2><div class=""><ul><li><code>configure</code> — set selling rules (min price, max discount, deadline, auto-accept) for a specific token</li></ul><ul><li><code>listOnGOB</code> — create a GOB listing for a property token using AgentAuth</li></ul><ul><li><code>evaluateOffer</code> — score an incoming offer against configured rules and decide accept/counter/reject</li></ul><ul><li><code>counterOffer</code> — submit a counteroffer within the allowed discount range</li></ul><ul><li><code>cancelListing</code> — remove an active listing from GOB and release the token</li></ul><ul><li><code>registerAgent</code> — register the selling agent in Agent Arena with metadata and performance stats</li></ul><ul><li><code>revokeAuth</code> — immediately revoke all AgentAuth permissions and halt agent activity</li></ul></div></div>
<div class="section"><h2>User Flow</h2><div class=""><ul><li>Connect wallet via Web3Auth and view IRWA holdings</li></ul><ul><li>Select a property token to list for sale</li></ul><ul><li>Configure selling rules: min price, max discount %, deadline, auto-accept threshold</li></ul><ul><li>Grant AgentAuth authorization with IRL spending limit</li></ul><ul><li>Agent creates GOB listing and registers in Agent Arena</li></ul><ul><li>Agent receives offers, counters within rules, accepts when terms match</li></ul><ul><li>Owner reviews activity in dashboard; can override or revoke at any time</li></ul><ul><li>On sale completion, token transfers on-chain and agent logs the result</li></ul></div></div>
<div class="section"><h2>Deliverables</h2><div class="checklist"><ul class="checklist"><li>Selling rules configuration UI (min price, max discount, deadline, auto-accept)</li></ul><ul class="checklist"><li>AgentAuth integration with scoped selectors and spending limits</li></ul><ul class="checklist"><li>GOB listing creation and management via agent wallet</li></ul><ul class="checklist"><li>Automated offer evaluation and counter/accept engine</li></ul><ul class="checklist"><li>Real-time dashboard with offer history and agent action log</li></ul><ul class="checklist"><li>Agent Arena registration with performance statistics</li></ul><ul class="checklist"><li>Override and revocation controls for the owner</li></ul><ul class="checklist"><li>Event emission for all agent actions (list, offer, counter, accept, cancel)</li></ul></div></div>
<div class="section"><h2>Integration Points</h2><div class=""><ul><li><strong>Depends on:</strong> GOB (listing/trading), AgentAuth (delegation), Asset Passport ERC-721 (property metadata), IRWAToken (transfer on sale)</li></ul><ul><li><strong>Used by:</strong> Buyer Agent (agent-to-agent negotiation), 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>List property on GOB</td><td>50 XP</td></tr><tr><td>Receive and respond to offer</td><td>20 XP</td></tr><tr><td>Complete a sale</td><td>200 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>Avg time from list to first offer</td><td>< 24h</td></tr><tr><td>Agent-completed sales (no manual override)</td><td>> 80%</td></tr><tr><td>User override/revocation rate</td><td>< 15%</td></tr><tr><td>Listings created in first week</td><td>50+</td></tr></tbody></table></div></div>
</div><div class="footer">Integra Testnet PRD — Selling 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