@0xsequence/marketplace-sdk 2.0.0 → 2.0.2

package/src/utils/__tests__/marketplaceNormalization.test.ts

@@ -0,0 +1,38 @@
+import { MarketplaceKind, OrderbookKind } from '@0xsequence/api-client';
+import * as BuilderMocks from '@0xsequence/api-client/mocks/builder';
+import * as MarketplaceMocks from '@0xsequence/api-client/mocks/marketplace';
+import { describe, expect, it } from 'vitest';
+import { toLookupMarketplaceReturn } from '../../../../api/src/adapters/builder/transforms';
+import { toOrder } from '../../../../api/src/adapters/marketplace/transforms';
+
+const { mockConfig } = BuilderMocks;
+const { mockOrder } = MarketplaceMocks;
+
+describe('marketplace normalization adapters', () => {
+	it('should map Magic Eden destination marketplaces to OpenSea', () => {
+		const normalizedConfig = toLookupMarketplaceReturn({
+			...mockConfig,
+			marketCollections: mockConfig.marketCollections.map((collection, index) =>
+				index === 1
+					? {
+						...collection,
+						destinationMarketplace: OrderbookKind.magic_eden,
+					}
+					: collection,
+			),
+		});
+
+		expect(
+			normalizedConfig.marketplace.market.collections[1]?.destinationMarketplace,
+		).toBe(OrderbookKind.opensea);
+	});
+
+	it('should map Magic Eden order marketplaces to OpenSea', () => {
+		const normalizedOrder = toOrder({
+			...mockOrder,
+			marketplace: MarketplaceKind.magic_eden,
+		});
+
+		expect(normalizedOrder.marketplace).toBe(MarketplaceKind.opensea);
+	});
+});

package/src/utils/collection.ts

@@ -0,0 +1,19 @@
+import type { MarketCollection } from '@0xsequence/api-client';
+import { compareAddress } from './address';
+
+/**
+ * Finds a market collection matching both the collection address and chain ID.
+ * Always use this instead of manually searching market.collections to avoid
+ * multi-chain bugs where the same collection address exists on different chains.
+ */
+export const findMarketCollection = (
+	collections: MarketCollection[],
+	collectionAddress: string,
+	chainId: string | number,
+): MarketCollection | undefined => {
+	return collections.find(
+		(collection) =>
+			compareAddress(collection.itemsAddress, collectionAddress) &&
+			Number(collection.chainId) === Number(chainId),
+	);
+};

package/src/utils/getConduitAddressForOrderbook.ts

@@ -4,6 +4,7 @@ import {
 	SEQUENCE_MARKET_V2_ADDRESS,
 } from '../consts';
 import { OrderbookKind } from '../types';
+import { normalizeOrderbookKind } from './normalizeMarketplace';
 
 /**
  * OpenSea Conduit address
@@ -12,25 +13,16 @@ import { OrderbookKind } from '../types';
 export const OPENSEA_SEAPORT_CONDUIT_ADDRESS =
 	'0x1E0049783F008A0085193E00003D00cd54003c71' as Address;
 
-/**
- * Magic Eden Conduit address
- * https://etherscan.io/address/0x2052f8A2Ff46283B30084e5d84c89A2fdBE7f74b
- */
-export const MAGICEDEN_CONDUIT_ADDRESS =
-	'0x2052f8A2Ff46283B30084e5d84c89A2fdBE7f74b' as Address;
-
 export function getConduitAddressForOrderbook(
 	orderbookKind: OrderbookKind | undefined,
 ): Address | undefined {
-	switch (orderbookKind) {
+	switch (normalizeOrderbookKind(orderbookKind)) {
 		case OrderbookKind.sequence_marketplace_v1:
 			return SEQUENCE_MARKET_V1_ADDRESS as Address;
 		case OrderbookKind.sequence_marketplace_v2:
 			return SEQUENCE_MARKET_V2_ADDRESS as Address;
 		case OrderbookKind.opensea:
 			return OPENSEA_SEAPORT_CONDUIT_ADDRESS;
-		case OrderbookKind.magic_eden:
-			return MAGICEDEN_CONDUIT_ADDRESS;
 		default:
 			// Default to v2 for unknown orderbooks
 			return SEQUENCE_MARKET_V2_ADDRESS as Address;

package/src/utils/getMarketplaceDetails.ts

@@ -11,6 +11,7 @@ import {
 	SequenceLogo,
 	X2y2Logo,
 } from '../react/ui/components/marketplace-logos';
+import { normalizeMarketplaceKind } from './normalizeMarketplace';
 
 interface Marketplace {
 	logo: ComponentType<React.ComponentProps<typeof Image>>;
@@ -75,13 +76,19 @@ export function getMarketplaceDetails({
 	originName,
 	kind,
 }: MarketplaceDetailsProp) {
+	const normalizedKind = normalizeMarketplaceKind(kind);
+
 	if (
-		kind === MarketplaceKind.sequence_marketplace_v1 ||
-		kind === MarketplaceKind.sequence_marketplace_v2
+		normalizedKind === MarketplaceKind.sequence_marketplace_v1 ||
+		normalizedKind === MarketplaceKind.sequence_marketplace_v2
 	) {
 		return MARKETPLACES.sequence;
 	}
 
+	if (normalizedKind === MarketplaceKind.opensea) {
+		return MARKETPLACES.opensea;
+	}
+
 	let name = originName.toLowerCase();
 
 	try {
@@ -99,8 +106,8 @@ export function getMarketplaceDetails({
 		return details;
 	}
 
-	if (KIND_TO_MARKETPLACE[kind]) {
-		return MARKETPLACES[KIND_TO_MARKETPLACE[kind]];
+	if (normalizedKind && KIND_TO_MARKETPLACE[normalizedKind]) {
+		return MARKETPLACES[KIND_TO_MARKETPLACE[normalizedKind]];
 	}
 }
 

package/src/utils/getWebRPCErrorMessage.ts

@@ -1,6 +1,27 @@
 import type { WebrpcError } from '@0xsequence/api-client';
 
 export const getWebRPCErrorMessage = (error: WebrpcError): string => {
+	const causeMessage =
+		typeof error.cause === 'string'
+			? error.cause
+			: error.cause instanceof Error
+				? error.cause.message
+				: '';
+
+	const rawDetails = [error.message, causeMessage]
+		.join(' ')
+		.toLowerCase();
+
+	if (
+		rawDetails.includes('outoffund') ||
+		rawDetails.includes('out of fund') ||
+		rawDetails.includes('insufficient funds') ||
+		rawDetails.includes('insufficient balance') ||
+		rawDetails.includes('not enough balance')
+	) {
+		return 'Insufficient balance to complete this transaction.';
+	}
+
 	switch (error.code) {
 		// Protocol Errors (negative numbers)
 		case -1: // WebrpcRequestFailed

package/src/utils/index.ts

@@ -1,6 +1,7 @@
 export * from './abi';
 export * from './address';
 export * from './cn';
+export * from './collection';
 export * from './getMarketplaceDetails';
 export * from './network';
 export * from './networkconfigToWagmiChain';

package/src/utils/normalizeMarketplace.ts

@@ -0,0 +1,31 @@
+import { MarketplaceKind, OrderbookKind } from '@0xsequence/api-client';
+
+export function normalizeMarketplaceKind(
+	kind: MarketplaceKind | undefined,
+): MarketplaceKind | undefined {
+	if (!kind) {
+		return kind;
+	}
+
+	return kind === MarketplaceKind.magic_eden
+		? MarketplaceKind.opensea
+		: kind;
+}
+
+export function normalizeOrderbookKind(
+	kind: OrderbookKind | undefined,
+): OrderbookKind | undefined {
+	if (!kind) {
+		return kind;
+	}
+
+	return kind === OrderbookKind.magic_eden
+		? OrderbookKind.opensea
+		: kind;
+}
+
+export function isOpenSeaOrderbook(
+	kind: OrderbookKind | undefined,
+): boolean {
+	return normalizeOrderbookKind(kind) === OrderbookKind.opensea;
+}