agorix
AirdropMarketsCollectionsLeaderboardActivity
Agorix · Decentralized Marketplace
Independent · Resilient · Community-Run

A cross-chain marketplace, run by the community.

Discover, list, and trade across Bitcoin, Ethereum, and Solana on an open, community-run network.

Marketplace
CollectionsMarketsLeaderboardActivity
Network
GovernanceExplorerAirdropDocs
Account
ProfileSettings
Legal
Terms of ServicePrivacy PolicyYour Privacy Choices
agorix.io — Lasting Access
CID: 0xA60R1X · v0.1
AirdropMarketsCollections
D
Protocol Docs
Marketplace OverviewAtomic Buy LocksDatabase ArchitectureProfiles & AuthenticationCollections & RoyaltiesCreator Royalty SystemMedia Cache & OptimizationModeration & ReputationSearch & DiscoveryCollection Rarity AlgorithmsLive Activity & LeaderboardsCollection Preseed Queue
Docs/Marketplace/Collection Preseed Queue
Marketplace

Collection Preseed Queue

How the marketplace discovers and warms popular collections before users search them. Per-chain prefill controllers, OrdNet/OpenSea metadata enrichment, volume thresholds, paused-chains controls, and pg_notify-driven worker dispatch.

#Collection Preseed Queue

The marketplace cannot wait for a user to type a contract address before showing them anything. The preseed queue continuously discovers popular collections across BTC, EVM, and Solana, fetches their metadata, warms their media, and seeds the index so the first user query returns rich results instantly.

#What Gets Preseeded

The queue tracks two kinds of work:

KindSourcePayload
EVM collectionsOpenSea / popular-contracts feedsContract address, chain, volume metadata
BTC ordinal collectionsOrdNet / curated listsOrdinal slug, parent inscription, href

Each chain has its own prefill controller that knows how to fetch its source list, dedupe candidates against already-indexed collections, and rank by configured volume thresholds.

#Per-Chain Pause Controls

The controller config carries a pausedChains array. Operators (and admins via the indexer admin UI) can pause specific chains independently — useful when one upstream feed is degraded or when an operator wants to focus throughput on one chain. Paused chains:

  • Stop accepting new prefill jobs
  • Leave already-queued jobs in place (they drain naturally)
  • Are skipped by the dispatch loop's isJobChainPaused() check

The pause flag is per-chain, per-controller — not global. Pausing ETH does not pause BTC.

#Job Lifecycle

Preseed jobs flow through marketplaceIndexerJobs:

  • Discovery — controller pulls a fresh batch from the upstream feed, normalizes payloads, dedupes
  • Enqueue — surviving candidates are inserted as pending jobs, then a pg_notify(marketplace_preseed_queued) fires so workers wake immediately instead of waiting for the next poll tick
  • Claim — a worker picks up the job, marks it in-flight with a stale-claim timeout, and starts enrichment
  • Enrich — fetch metadata (name, description, image, banner, supply, traits, social links) from chain-specific sources (OrdNet for BTC, OpenSea/Magic Eden for EVM)
  • Materialize — write collectionMetadata, fan out media warmup jobs, populate collectionTokenStats
  • Complete — job marked done; if enrichment fails, the job is retried with backoff and a recorded lastError

Stale claims (worker died mid-job) are reset by a sweeper so jobs do not get stranded.

#Volume Thresholds

Not every contract is worth preseeding — most have zero secondary activity. Each controller carries volume thresholds (in USD-cents) that gate which candidates make it onto the queue. Below the threshold, a collection waits until a real user manually requests it.

#OrdNet Integration (BTC)

For Bitcoin ordinal collections, the BTC controller talks to OrdNet via fetchOrdNetCollectionDetail. This pulls inscription range, parent inscription metadata, social links, and a curated description. OrdNet acts as the upstream "discovery" layer for BTC — the marketplace caches and re-publishes the metadata under its own collection records.

#Popular ETH Collections

The popularEthCollections module maintains a slot of curated, hand-picked EVM contracts that are always preseeded — major historical collections that any general-purpose marketplace must show. These bypass volume thresholds and are split across multiple cache modules to keep startup memory in check.

#Worker Coordination

The dispatch loop runs continuously, but pg_notify lets workers wake within milliseconds of a new job arriving. The notify channel marketplace_preseed_queued carries only a count — workers re-query the queue rather than trusting the payload. This keeps the notification mechanism cheap while still scaling to many concurrent workers.

#Admin Controls

The admin UI exposes per-chain pause toggles, volume threshold overrides, and live job-status views. Operators can drain the queue, reset stuck jobs, or kick off a forced refresh of a specific contract without bouncing the node.

PreviousLive Activity & LeaderboardsNext Governance

On this page

  • Collection Preseed Queue
  • What Gets Preseeded
  • Per-Chain Pause Controls
  • Job Lifecycle
  • Volume Thresholds
  • OrdNet Integration (BTC)
  • Popular ETH Collections
  • Worker Coordination
  • Admin Controls