⚠️Blast API (blastapi.io) ends Oct 31. Migrate to Dwellir and skip Alchemy's expensive compute units.
Switch Today →
Skip to main content

Marketplace Integration

Mythos pairs pallet_marketplace, pallet_escrow, and pallet_dmarket to recreate Mythical Marketplace functionality directly on-chain. Listings, bids, and escrowed settlements are handled without centralized custody.

Architectural Overview

  • Listings & Orders: pallet_marketplace lets studios configure timed listings, whitelisted buyers, and royalties via runtime constants.
  • Escrow Management: pallet_escrow holds MYTH payments until both sides confirm, protecting buyers during cross-game swaps.
  • Signed Trades: pallet_dmarket exposes helper APIs to pre-sign off-chain bids/asks that settle on-chain for minimal latency.

Integrating with Backend Services

  1. Index Events: Subscribe to marketplace.ItemBought and pallet_escrow events via author_subscribeExtrinsic to update storefronts.
  2. Price Discovery: Use DotLake analytics (3.3M+ Mythos transactions) to monitor floor prices and adjust in-game economy levers.
  3. KYC or Limited Access: Combine DAO governance proposals with set_price whitelists for age-gated drops or region-specific campaigns.

Sample Listing Flow

graph TD;
A[Player signs ask via pallet_dmarket helper] --> B[Submit author_submitExtrinsic call];
B --> C[pallet_marketplace::set_price];
C --> D{Buyer executes buy_item}
D -->|Escrow payment| E[pallet_escrow::make_deposit];
D -->|NFT transfer| F[pallet_nfts::transfer];
E --> G[Funds released after Block Finalization];

Recent sale proof: extrinsic 0x6f26cdb2c3398f2cabaa0bf51d3c8ec3f3cbe75ffb8b9b8853718055517b2497 minted and listed a Nitro Nation crate, demonstrating end-to-end settlement on Mythos.

UX Best Practices

  • Batch listing updates with pallet_multibatching when rotating store catalogs.
  • Surface escrow status inside game HUDs to educate players during first purchases.
  • Encourage MYTH staking incentives through DAO proposals aligned with marketplace campaigns.