datadictionary.org
Schema v1

Catalog Entry

Announces an item for sale on-chain. Discoverable by any MAP-aware indexer.

protocol MAP
prefix 1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5
app qart
type catalog_entry_v1

Fields

Name Type Required Description
app string yes Application identifier. Always "qart".
type string yes Schema type tag. Always "catalog_entry_v1".
item_id string yes Unique item identifier from the issuing marketplace.
title string yes Human-readable item name.
price_sats integer yes Price in satoshis.
merchant_pubkey hex yes Compressed public key of the selling merchant.
timestamp integer yes Unix timestamp of listing creation.
currency string no Currency code if not BSV (e.g. "MNEE").
description string no Item description text.
image_url uri no URL to the item image.
category string no Item category or tag.

Wire format

OP_FALSE OP_RETURN
  1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5
  SET
  app        qart
  type       catalog_entry_v1
  item_id    <uuid>
  title      <string>
  price_sats <integer>
  merchant_pubkey <hex>
  timestamp  <unix_ts>
  [currency  <string>]
  [description <string>]
  [image_url <uri>]
  [category  <string>]

Producers

  • QartQart.Protocol.Encoder.encode(%CatalogEntry{})

Consumers

  • BitblocksMapParser indexes catalog entries by merchant pubkey