Doma Marketplace

Doma Marketplace is provided to simplify trading of tokenized names on-chain. It has following components:

• Orderbook Rest API for on-chain trading using SeaPort protocol.

• Poll API for marketplace-related events.

• Marketplace-related data (listings, offers) in Doma Subgraph.

• Syndicated listings and offers from external marketplaces (OpenSea).

• @doma-protocol/orderbook-sdk to simplify integrations of Doma Marketplace.

How to Use Orderbook API

• It's highly recommended to use @doma-protocol/orderbook-sdk to interact with Orderbook API, since it abstracts underlying complexities of working with Seaport Protocol, granting on-chain approvals, and computing fees.

• When not using @doma-protocol/orderbook-sdk, seaport-js library is recommended (which is used by SDK under the hood).

Marketplace Fees

Doma Orderbook API enforces inclusion of following fees into consideration items:

• Doma Protocol Fee

  • Receiver Address:

    • Testnet: 0x2E7cC63800e77BB8c662c45Ef33D1cCc23861532

    • Mainnet: 0x5f1F2b4ad2E3a7587276B226c9B58Cb9227177bB

  • Percentage: 0.5%

• Name Token Royalties. Can be fetched by calling royaltyInfo method on an Ownership Token Smart contract.

• OpenSea Fee (only when creating a listing/offer on OpenSea orderbook). Collection fee value can be fetched using Get Collection API (required fee values from response should be included).

  • Since OpenSea API will also include royalty items, they should be filtered out to prevent double inclusion into considerations.

To simplify fees calculation, Fee Information API is provided.

When using @doma-protocol/orderbook-sdk, fees are calculated automatically.

Supported Currencies

Supported currencies can be fetched programmatically using Currencies API.

@doma-protocol/orderbook-sdk provides a helper getSupportedCurrencies method, which returns list of all supported currencies.

Making ETH Offers

Since SeaPort doesn't support making offers in ETH (as it's a native gas token, not an ERC-20), ETH should be wrapped to wETH using a wrapper contract. Supported wrapper contract addresses can be obtained using Currencies API - wrapper contracts have a nativeWrapper flag set in the response.

When using @doma-protocol/orderbook-sdk, wrapping is performed automatically.