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/Marketplace Overview
Marketplace

Marketplace Overview

How the decentralized marketplace works end-to-end. Listing creation, order lifecycle, settlement flows, fee distribution, and the role of every participant.

#Marketplace Overview

Agorix is a general-purpose decentralized marketplace for digital assets -- an eBay replacement where no single company controls listings, pricing, or settlement. Every operation is enforced by code running identically on every node in the network.

#Core Participants

RoleDescription
SellerLists assets for sale by signing chain-native authorization (PSBT, EIP-712, SPL)
BuyerSubmits purchase intent, receives a signed quote, and completes settlement
Witness nodesSelected deterministically to validate and attest transactions
Reward poolPer-chain wallet that receives the network half of the marketplace fee. It is shared out to nodes each epoch by measured work
FoundationReceives 50% of the marketplace fee for protocol development
UI providerThe node serving the buyer's frontend session

#Listing Creation

Sellers create listings by signing a chain-native authorization that commits their asset to a specific price. The listing is published as a LISTING_CREATE protocol event gossiped to every node.

Bitcoin (Ordinals):

The seller signs a PSBT with SIGHASH_SINGLE|ANYONECANPAY. The signed PSBT is then encrypted with AES-GCM, split into Shamir 3-of-4 secret shares, and distributed to 4 independent shard-holder nodes. No single node can reconstruct the PSBT alone.

Ethereum / EVM L2s:

The seller signs an EIP-712 typed data order containing the asset contract, token ID, price, nonce, salt, expiration, and fee breakdown. The signature is verifiable on-chain by AgorixV1.sol.

Solana:

The seller creates an SPL token transfer authorization via the agorix_marketplace program, scoped to the specific asset and price.

#Listing State Machine

Every listing follows a simple three-state lifecycle:

text
OPEN  -->  FILLED     (purchase completed, settlement confirmed)
  |
  +-->  CANCELLED   (seller delists or listing expires)
  • OPEN: Available for purchase, visible in search, accepting order intents
  • FILLED: Successfully sold -- order completed and confirmed on-chain
  • CANCELLED: Removed by seller action or expiration timestamp reached

Each listing tracks a revealNonce counter that increments after every PSBT share reveal attempt, preventing replay attacks on Bitcoin settlement.

#Order Lifecycle

- BTC: Buyer requests PSBT shard reveals, reconstructs the transaction, signs, and broadcasts

- EVM: Smart contract verifies signatures, checks attestation quorum, executes atomic swap

- SOL: Marketplace program executes SPL transfer with on-chain fee distribution

  • Intent -- Buyer submits an ORDER_INTENT with their public key and the listing they want to purchase
  • Quote -- The serving node generates a signed quote containing the price, fees, and expiration window. Quotes are stored in sessionQuotes with the serving node's Ed25519 signature
  • Settlement -- Chain-specific execution:
  • Attestation -- Witness nodes verify the on-chain transaction and sign attestations (2/3 supermajority required)
  • Finalization -- Once quorum is reached, the listing is marked FILLED and the sale is credited as work weight to the nodes named in the purchase

#Fee Structure

The marketplace charges a 2% (200 basis points) fee on every sale, computed using integer arithmetic with no floating point:

RecipientShareExample on 100 USD sale
Foundation50% of fee (1% of sale)1.00 USD
Reward pool50% of fee (1% of sale)1.00 USD
Creator royaltiesConfigurable per collection (0-100%)Variable
SellerPrice minus fees minus royalties98.00 USD minus royalties

All fee calculations use basis points (1 bps = 0.01%). The fee range is governance-configurable between 50-500 bps.

#Fee Address Routing

Listings specify a uiFeeAddress that determines where the non-foundation share of fees goes:

  • Reward pool: Fees route to the chain's reward pool wallet (governance key rewardPool.recipients). This is the normal case. If no pool wallet is configured for the chain, the sale is refused
  • Direct node: Fees route to a specific node address (used in development or curated marketplaces)

#Purchase Recording

When settlement completes, the system validates the full output breakdown:

  • Seller received: price minus marketplace fee minus royalties
  • Foundation received: exactly 50% of the marketplace fee
  • Reward pool received: exactly 50% of the marketplace fee
  • Creator received: the correct royalty percentage

A PURCHASE_RECORDED protocol event is published and gossiped to all nodes. The sale's fee is credited as work weight to the serving, media, witness and custody nodes named in the purchase. Rewards are paid through signed claims after the epoch settles.

PreviousLocal Node Telemetry RollupsNext Atomic Buy Locks

On this page

  • Marketplace Overview
  • Core Participants
  • Listing Creation
  • Listing State Machine
  • Order Lifecycle
  • Fee Structure
  • Fee Address Routing
  • Purchase Recording