Skip to content

Instantly share code, notes, and snippets.

@Aboudjem

Aboudjem/03-global-order-book.md

Last active March 30, 2026 08:07
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Aboudjem/1ae8dcd11fb39524c84f0f40e606a9dc to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Aboudjem/1ae8dcd11fb39524c84f0f40e606a9dc to your computer and use it in GitHub Desktop.
Download ZIP
Integra Testnet PRD-03: Global Order Book (GOB)
Raw
03-global-order-book.md

Global Order Book (GOB)

Owner: Nawar + Kalki | Ship: Week 2-3 | Est: 2-3 days | Chain: integra-testnet-1 (EVM 26218) URL: gob.integralayer.com

Overview

The Global Order Book is where wrapped IRWA tokens find their price and change hands. Unlike AMM-based DEXs, the GOB is built for real-world asset trading -- supporting OTC-style negotiation with optional AI agent assistance, limit and market orders, and atomic on-chain settlement. This is the final destination in the core user flow (Passport > Wrapper > GOB) and the primary venue for price discovery across all tokenized assets in the Integra ecosystem.

Features

  • Limit Orders -- set a specific price to buy or sell a wrapped IRWA token
  • Market Orders -- buy or sell immediately at the best available price
  • OTC Negotiation -- offer/counter-offer flow with a maximum of 5 negotiation rounds before forced accept or reject
  • AI Agent Negotiation -- deploy an AI agent to negotiate on your behalf with configurable aggression level
  • Atomic Settlement -- token and payment swap in a single transaction, no partial delivery risk
  • Escrow -- tokens locked in escrow during active negotiation until settlement or cancellation
  • Order Book Depth -- real-time visualization of bids and asks for each asset
  • Trade History -- per-asset and per-user trade history with price, volume, and timestamp
  • Advanced Filters -- filter listings by asset type, token standard, price range, and recency
  • IRL as Payment Token -- all trades settle in IRL (the native testnet token)
  • Partial Fills for ERC-20 -- fungible wrapped tokens support partial order fills
  • Multi-Standard Support -- trade any wrapped token standard (ERC-20, ERC-721, ERC-3643, ERC-1404)
  • Asset Listing Cards -- rich cards showing asset type, valuation, standard, owner, and Explorer link
  • Notifications -- seller notified when a bid is placed; buyer notified on counter-offer
  • XP for All Trading Actions -- points for listing, bidding, counter-offering, and completing trades

Functions

  • listAsset -- create a sell order for a wrapped IRWA token at a specified price
  • cancelListing -- cancel an active sell order and return the token from escrow
  • placeBid -- place a buy bid on a listed asset
  • counterOffer -- respond to a bid with a counter-price (up to 5 rounds)
  • acceptOffer -- accept a bid or counter-offer, triggering atomic settlement
  • rejectOffer -- reject a bid or counter-offer, ending the negotiation
  • placeMarketOrder -- buy at best available ask price (instant fill)
  • placeLimitOrder -- buy or sell at a specific price, queued until matched
  • getOrderBook -- return current bids and asks for a given asset or asset type
  • getTradeHistory -- return completed trades filtered by asset, user, or time range
  • getActiveNegotiations -- list all open negotiation threads for a user
  • settleAtomically -- execute the token-for-IRL swap in a single transaction
  • emitXPAction -- emit XP events for each trading action

User Flow

  1. User navigates to gob.integralayer.com and connects wallet via Web3Auth
  2. User browses listed assets using filters (asset type, standard, price range)
  3. User selects an asset and views detail card with metadata, price, and Explorer link
  4. Buyer path: User places a bid (or market order for immediate purchase)
  5. Seller path: Seller receives notification and can accept, reject, or counter-offer
  6. Negotiation proceeds for up to 5 rounds (manually or via AI agent)
  7. On acceptance, atomic settlement executes: IRWA token transfers to buyer, IRL transfers to seller
  8. Trade appears in both users' history; XP awarded to both parties

Deliverables

  • Order book smart contract deployed and verified on Integra Explorer
  • Frontend accessible at gob.integralayer.com
  • Limit and market order support
  • OTC negotiation flow (up to 5 rounds)
  • AI agent negotiation integration
  • Escrow mechanism for listed tokens
  • Atomic settlement (IRWA <> IRL swap)
  • Order book depth visualization
  • Trade history per asset and per user
  • XP integration (all trading actions emit points)
  • Integra Explorer deep links for trades and tokens
  • Ecosystem Hub listing

Integration Points

  • Depends on: Wrapper (wrapped IRWA tokens must exist), Smart Wallet (Nawar), AI negotiation agent (Kalki), XP System (Milind + Kalki), App Domain Router (Adam)
  • Used by: Agent Arena (trading agents operate on GOB), Lending App (price reference), Tokenization Playground (shows trading as final step)
  • Explorer: Trade transactions and token transfers on Integra Explorer (github.com/Integra-layer/integra-explorer)

XP Rewards

Action Points
List an asset for sale 25
Place a bid 25
Complete a trade (buyer) 100
Complete a trade (seller) 100
AI-assisted trade 50 (bonus)
Counter-offer in negotiation 10 per round

Success Metrics

Metric Target
Total trades completed on testnet 10,000+
Unique traders 2,000+
AI-assisted trades (% of total) > 30%
Average negotiation rounds before settlement 2-3
Order book listings 5,000+
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment