Skip to main content
Coming Soon: This tutorial will be available after the Shop Registry Contract is deployed to mainnet.

​
What You’ll Learn

This tutorial will cover:
  • How to query shop information
  • How to view shop performance metrics
  • How to track tokens burned per shop
  • How to filter shops by location or status
  • How to monitor shop operator performance
  • Understanding shop lifecycle and status changes

​
Prerequisites

Before starting this tutorial, you’ll need:
  • Access to a blockchain explorer or Web3 interface
  • Basic understanding of reading contract data
  • Familiarity with the SHAWARMA.TRADE dashboard

​
Tutorial Sections

Query Shop Data

Retrieve information for specific shops

View Performance

Analyze revenue and burn metrics

Filter by Location

Find shops in specific regions

Track Operators

Monitor operator performance

​
Shop Data Fields

Each shop in the registry contains:
FieldDescription
Shop IDUnique identifier
LocationCity and country
Operator AddressEthereum address of operator
Launch DateWhen the shop opened
StatusPilot, Active, Paused, or Closed
Cumulative BurnedTotal SHAMA burned from this shop
Total RevenueHistorical revenue reported

​
Shop Status Types

Status Meanings:
  • Pilot: One of the first 4 team-operated shops
  • Active: Operating shop in good standing
  • Paused: Temporarily closed (maintenance, relocation)
  • Closed: Permanently closed

​
Use Cases

​
For Token Holders

  • Monitor which shops are performing best
  • Verify burn contributions from each location
  • Track expansion progress
  • Identify underperforming shops for governance action

​
For Operators

  • View your shop’s historical performance
  • Compare your metrics to other shops
  • Track your burn contributions
  • Monitor your operator status

​
For Researchers

  • Analyze geographic expansion patterns
  • Study revenue trends across locations
  • Evaluate operator effectiveness
  • Research burn rate correlations

​
Querying Examples

// Coming soon: JavaScript example
// Get shop information
const shopInfo = await shopRegistry.getShop(shopId);
console.log(shopInfo);

​
Stay Updated

Join our Discord or follow us on Twitter to be notified when this tutorial is published.

Contract Documentation

Read the technical documentation

View Dashboard

Explore shop data visually