@0xsequence/marketplace-sdk 0.8.7 → 0.8.8

package/src/react/{hooks/options/__mocks__/marketplaceConfig.msw.ts → _internal/api/__mocks__/builder.msw.ts}

@@ -2,15 +2,64 @@ import { http, HttpResponse } from 'msw';
 import { zeroAddress } from 'viem';
 import {
 	FilterCondition,
+	type LookupMarketplaceConfigReturn,
 	type MarketplaceConfig,
 	MarketplaceType,
 	MarketplaceWallet,
 	OrderbookKind,
 } from '../../../../types';
-import { mockCurrencies } from '../../../_internal/api/__mocks__/marketplace.msw';
+import { mockCurrencies } from './marketplace.msw';
+
+export const mockCollections = [
+	{
+		address: zeroAddress,
+		chainId: 1,
+		marketplaceType: MarketplaceType.ORDERBOOK,
+		currencyOptions: mockCurrencies.map((c) => c.contractAddress),
+		exchanges: [],
+		bannerUrl: '',
+		feePercentage: 3.5,
+		destinationMarketplace: OrderbookKind.sequence_marketplace_v2,
+		filterSettings: {
+			filterOrder: ['Type', 'Rarity'],
+			exclusions: [
+				{
+					key: 'Type',
+					condition: FilterCondition.SPECIFIC_VALUE,
+					value: 'Sample',
+				},
+			],
+		},
+	},
+	{
+		address: '0x1234567890123456789012345678901234567890',
+		chainId: 137,
+		marketplaceType: MarketplaceType.ORDERBOOK,
+		currencyOptions: [mockCurrencies[0].contractAddress],
+		exchanges: [],
+		bannerUrl: 'https://example.com/collection-banner.png',
+		feePercentage: 2.5,
+		destinationMarketplace: OrderbookKind.opensea,
+		filterSettings: {
+			filterOrder: ['Category', 'Level', 'Element'],
+			exclusions: [
+				{
+					key: 'Category',
+					condition: FilterCondition.ENTIRE_KEY,
+				},
+				{
+					key: 'Level',
+					condition: FilterCondition.SPECIFIC_VALUE,
+					value: 'Legendary',
+				},
+			],
+		},
+	},
+];
 
 // Mock data
 export const mockConfig: MarketplaceConfig = {
+	projectId: 1,
 	publisherId: 'test-publisher',
 	title: 'Test Marketplace',
 	shortDescription: 'A test marketplace',
@@ -31,52 +80,7 @@ export const mockConfig: MarketplaceConfig = {
 		connectors: ['coinbase', 'walletconnect'],
 		includeEIP6963Wallets: true,
 	},
-	collections: [
-		{
-			address: zeroAddress,
-			chainId: 1,
-			marketplaceType: MarketplaceType.ORDERBOOK,
-			currencyOptions: mockCurrencies.map((c) => c.contractAddress),
-			exchanges: [],
-			bannerUrl: '',
-			feePercentage: 3.5,
-			destinationMarketplace: OrderbookKind.sequence_marketplace_v2,
-			filterSettings: {
-				filterOrder: ['Type', 'Rarity'],
-				exclusions: [
-					{
-						key: 'Type',
-						condition: FilterCondition.SPECIFIC_VALUE,
-						value: 'Sample',
-					},
-				],
-			},
-		},
-		{
-			address: '0x1234567890123456789012345678901234567890',
-			chainId: 137,
-			marketplaceType: MarketplaceType.ORDERBOOK,
-			currencyOptions: [mockCurrencies[0].contractAddress],
-			exchanges: [],
-			bannerUrl: 'https://example.com/collection-banner.png',
-			feePercentage: 2.5,
-			destinationMarketplace: OrderbookKind.opensea,
-			filterSettings: {
-				filterOrder: ['Category', 'Level', 'Element'],
-				exclusions: [
-					{
-						key: 'Category',
-						condition: FilterCondition.ENTIRE_KEY,
-					},
-					{
-						key: 'Level',
-						condition: FilterCondition.SPECIFIC_VALUE,
-						value: 'Legendary',
-					},
-				],
-			},
-		},
-	],
+	collections: mockCollections,
 	landingPageLayout: 'default',
 	cssString: '',
 	manifestUrl: '',
@@ -108,12 +112,23 @@ const debugLog = (endpoint: string, request: Request, response: Response) => {
 	}
 };
 
-// MSW handlers
-export const createConfigHandler = (config = mockConfig) =>
-	http.get('*/marketplace/*/settings.json', ({ request }) => {
-		const response = HttpResponse.json(config);
-		debugLog('settings.json', request, response);
-		return response;
+export const mockLookupMarketplaceConfigError = () => {
+	return HttpResponse.json(
+		{ code: 3000, msg: 'Project not found' },
+		{ status: 404 },
+	);
+};
+
+export const createLookupMarketplaceConfigHandler = (config = mockConfig) =>
+	http.post('*/rpc/Builder/LookupMarketplaceConfig', () => {
+		return HttpResponse.json({
+			settings: config,
+		} satisfies LookupMarketplaceConfigReturn);
+	});
+
+export const createLookupMarketplaceConfigErrorHandler = () =>
+	http.post('*/rpc/Builder/LookupMarketplaceConfig', () => {
+		return mockLookupMarketplaceConfigError();
 	});
 
 export const createStylesHandler = (styles = mockStyles) =>
@@ -125,14 +140,6 @@ export const createStylesHandler = (styles = mockStyles) =>
 		return response;
 	});
 
-export const createErrorHandler = () =>
-	http.get('*/marketplace/*/settings.json', () => {
-		return HttpResponse.json(
-			{ code: 3000, msg: 'Project not found' },
-			{ status: 404 },
-		);
-	});
-
 export const createStylesErrorHandler = () =>
 	http.get('*/marketplace/*/styles.css', () => {
 		return new HttpResponse('', { status: 500 });
@@ -140,8 +147,8 @@ export const createStylesErrorHandler = () =>
 
 // Default handlers
 export const handlers = [
-	createConfigHandler(),
+	createLookupMarketplaceConfigHandler(),
+	createLookupMarketplaceConfigErrorHandler(),
 	createStylesHandler(),
-	createErrorHandler(),
 	createStylesErrorHandler(),
 ];

package/src/react/_internal/api/__mocks__/metadata.msw.ts

@@ -1,5 +1,6 @@
 import {
 	type ContractInfo,
+	type GetContractInfoBatchArgs,
 	type Metadata,
 	type PropertyFilter,
 	PropertyType,
@@ -28,8 +29,7 @@ const debugLog = (endpoint: string, request: unknown, response: unknown) => {
 	}
 };
 
-// Mock data
-export const mockContractInfo: ContractInfo = {
+export const mockEthCollection: ContractInfo = {
 	address: zeroAddress,
 	chainId: 1,
 	name: 'Mock Collection',
@@ -38,7 +38,7 @@ export const mockContractInfo: ContractInfo = {
 	status: ResourceStatus.AVAILABLE,
 	type: 'ERC721',
 	deployed: true,
-	updatedAt: new Date().toISOString(),
+	updatedAt: new Date('2025-05-01T04:39:56.936Z').toISOString(),
 	bytecodeHash: '0x1234567890',
 	extensions: {
 		description: 'A mock collection for testing',
@@ -57,6 +57,14 @@ export const mockContractInfo: ContractInfo = {
 	logoURI: 'https://example.com/logo.png',
 };
 
+export const mockPolCollection: ContractInfo = {
+	...mockEthCollection,
+	address: '0x1234567890123456789012345678901234567890',
+	chainId: 137,
+};
+
+export const mockCollections = [mockEthCollection, mockPolCollection];
+
 export const mockTokenMetadata: TokenMetadata = {
 	tokenId: '1',
 	name: 'Mock NFT #1',
@@ -77,7 +85,7 @@ export const mockTokenMetadata: TokenMetadata = {
 	background_color: '#ffffff',
 	animation_url: 'https://example.com/nft/1/animation',
 	decimals: 0,
-	updatedAt: new Date().toISOString(),
+	updatedAt: new Date('2025-05-01T04:39:56.936Z').toISOString(),
 	assets: [
 		{
 			id: 1,
@@ -90,7 +98,7 @@ export const mockTokenMetadata: TokenMetadata = {
 			mimeType: 'image/png',
 			width: 1000,
 			height: 1000,
-			updatedAt: new Date().toISOString(),
+			updatedAt: new Date('2025-05-01T04:39:56.936Z').toISOString(),
 		},
 	],
 	source: '',
@@ -145,7 +153,7 @@ export const mockMetadataHandler = <E extends Endpoint>(
 // MSW handlers
 export const handlers = [
 	mockMetadataHandler('GetContractInfo', {
-		contractInfo: mockContractInfo,
+		contractInfo: mockEthCollection,
 	}),
 
 	mockMetadataHandler('GetTokenMetadata', {
@@ -156,9 +164,21 @@ export const handlers = [
 		filters: mockPropertyFilters,
 	}),
 
-	mockMetadataHandler('GetContractInfoBatch', {
-		contractInfoMap: {
-			[mockContractInfo.address]: mockContractInfo,
-		},
+	http.post(mockMetadataEndpoint('GetContractInfoBatch'), async (request) => {
+		const body = (await request.request.json()) as GetContractInfoBatchArgs;
+		const chainId = Number(body.chainID);
+		const contractAddresses = body.contractAddresses;
+
+		const response = {
+			contractInfoMap: mockCollections.filter((collection) => {
+				return (
+					collection.chainId === chainId &&
+					contractAddresses.includes(collection.address)
+				);
+			}),
+		};
+
+		debugLog('GetContractInfoBatch', request, response);
+		return HttpResponse.json(response);
 	}),
 ];

package/src/react/_internal/api/builder-api.ts

@@ -0,0 +1,32 @@
+import { API } from './builder.gen';
+
+export class BuilderAPI extends API {
+	constructor(
+		hostname: string,
+		public projectAccessKey?: string,
+		public jwtAuth?: string,
+	) {
+		super(hostname.endsWith('/') ? hostname.slice(0, -1) : hostname, fetch);
+		this.fetch = this._fetch;
+	}
+
+	_fetch = (input: RequestInfo, init?: RequestInit): Promise<Response> => {
+		const headers: Record<string, string> = {};
+
+		const jwtAuth = this.jwtAuth;
+		const projectAccessKey = this.projectAccessKey;
+
+		if (jwtAuth && jwtAuth.length > 0) {
+			headers.Authorization = `BEARER ${jwtAuth}`;
+		}
+
+		if (projectAccessKey && projectAccessKey.length > 0) {
+			headers['X-Access-Key'] = projectAccessKey;
+		}
+
+		const requestInit = init || {};
+		requestInit.headers = { ...init?.headers, ...headers };
+
+		return fetch(input, requestInit);
+	};
+}

package/src/react/_internal/api/builder.gen.ts

@@ -0,0 +1,215 @@
+// Importing OrderbookKind from marketplace.gen, to avoid multiple enums
+import { OrderbookKind } from "./marketplace.gen";
+
+// Extracted from builder webrpc
+
+export interface LookupMarketplaceConfigArgs {
+  projectId?: number;
+  hostname?: string;
+}
+
+export interface LookupMarketplaceConfigReturn {
+  settings: MarketplaceSettings;
+}
+
+export interface MarketplaceSettings {
+  projectId: number;
+  publisherId: string;
+  title: string;
+  shortDescription: string;
+  socials: MarketplaceSocials;
+  faviconUrl: string;
+  landingBannerUrl: string;
+  collections: Array<MarketplaceCollection>;
+  walletOptions: MarketplaceWalletOptions;
+  landingPageLayout: string;
+  logoUrl: string;
+  bannerUrl: string;
+  fontUrl?: string;
+  ogImage?: string;
+  accessKey?: string;
+}
+
+export interface MarketplaceSocials {
+  twitter: string;
+  discord: string;
+  website: string;
+  tiktok: string;
+  instagram: string;
+  youtube: string;
+}
+
+export interface MarketplaceCollection {
+  marketplaceType: MarketplaceType;
+  chainId: number;
+  address: string;
+  exchanges: Array<string>;
+  bannerUrl: string;
+  feePercentage: number;
+  currencyOptions: Array<string>;
+  destinationMarketplace: OrderbookKind;
+  filterSettings?: CollectionFilterSettings;
+  isLAOSERC721?: boolean;
+}
+
+export interface CollectionFilterSettings {
+  filterOrder: Array<string>;
+  exclusions: Array<MetadataFilterRule>;
+}
+
+export interface OpenIdProvider {
+  iss: string;
+  aud: Array<string>;
+}
+export interface MetadataFilterRule {
+  key: string;
+  condition: FilterCondition;
+  value?: string;
+}
+
+export interface MarketplaceWalletWaasSettings {
+  tenantKey: string;
+  emailEnabled: boolean;
+  providers: Array<OpenIdProvider>;
+}
+
+export interface MarketplaceWalletOptions {
+  walletType: MarketplaceWallet;
+  oidcIssuers: { [key: string]: string };
+  connectors: Array<string>;
+  includeEIP6963Wallets: boolean;
+  ecosystem?: EcosystemWalletSettings;
+  waas?: MarketplaceWalletWaasSettings;
+}
+
+export interface EcosystemWalletSettings {
+  walletUrl: string;
+  walletAppName: string;
+  logoLightUrl?: string;
+  logoDarkUrl?: string;
+}
+
+export enum MarketplaceWallet {
+  UNIVERSAL = "UNIVERSAL",
+  EMBEDDED = "EMBEDDED",
+  ECOSYSTEM = "ECOSYSTEM",
+}
+
+export enum MarketplaceType {
+  AMM = "AMM",
+  P2P = "P2P",
+  SEQUENCE = "SEQUENCE",
+  ORDERBOOK = "ORDERBOOK",
+}
+
+export enum FilterCondition {
+  ENTIRE_KEY = "ENTIRE_KEY",
+  SPECIFIC_VALUE = "SPECIFIC_VALUE",
+}
+
+export type Fetch = (
+  input: RequestInfo,
+  init?: RequestInit
+) => Promise<Response>;
+
+export class WebrpcRequestFailedError extends Error {
+  name: string;
+  code: number;
+  message: string;
+  status: number;
+  cause?: string;
+
+  constructor(
+    name = "WebrpcRequestFailed",
+    code = -1,
+    message = `request failed`,
+    status = 0,
+    cause?: string
+  ) {
+    super(message);
+    this.name = name;
+    this.code = code;
+    this.message = message;
+    this.status = status;
+    this.cause = cause;
+    Object.setPrototypeOf(this, WebrpcRequestFailedError.prototype);
+  }
+
+  // biome-ignore lint/suspicious/noExplicitAny: <explanation>
+  static new(payload: any): WebrpcRequestFailedError {
+    return new WebrpcRequestFailedError(
+      payload.name,
+      payload.code,
+      payload.msg || payload.message,
+      payload.status,
+      payload.cause
+    );
+  }
+}
+
+const createHTTPRequest = (
+  body: object = {},
+  headers: object = {},
+  signal: AbortSignal | null = null
+): object => {
+  return {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+      ...headers,
+    },
+    body: JSON.stringify(body || {}),
+    mode: "cors",
+    signal: signal || null,
+  };
+};
+
+const buildResponse = (res: Response): Promise<any> => {
+  if (!res.ok) {
+    return res.json().then((errData) => {
+      throw WebrpcRequestFailedError.new(errData);
+    });
+  }
+  return res.json();
+};
+
+export class API {
+  protected hostname: string;
+  protected fetch: Fetch;
+  protected path = "/rpc/Builder/";
+
+  constructor(hostname: string, fetch: Fetch) {
+    this.hostname = hostname;
+    this.fetch = fetch;
+  }
+
+  private url(name: string): string {
+    return this.hostname + this.path + name;
+  }
+
+  lookupMarketplaceConfig = (
+    args: LookupMarketplaceConfigArgs,
+    headers?: object,
+    signal?: AbortSignal
+  ): Promise<LookupMarketplaceConfigReturn> => {
+    return this.fetch(
+      this.url("LookupMarketplaceConfig"),
+      createHTTPRequest(args, headers, signal)
+    ).then(
+      (res) => {
+        return buildResponse(res).then((_data) => {
+          return {
+            projectId: <number>_data.projectId,
+            settings: <MarketplaceSettings>_data.settings,
+          };
+        });
+      },
+      (error) => {
+        throw WebrpcRequestFailedError.new({
+          cause: `fetch(): ${error.message || ""}`,
+        });
+      }
+    );
+  };
+}

package/src/react/_internal/api/services.ts

@@ -10,7 +10,8 @@ const SERVICES = {
 	metadata: 'https://${prefix}metadata.sequence.app',
 	indexer: 'https://${prefix}${network}-indexer.sequence.app',
 	marketplaceApi: 'https://${prefix}marketplace-api.sequence.app/${network}',
-	imageProxy: 'https://imgproxy.sequence.xyz/',
+	builderRpcApi: 'https://${prefix}api.sequence.build',
+	//Used for fetching css and manifest
 	builderMarketplaceApi:
 		'https://${prefix}api.sequence.build/marketplace/${projectId}',
 };
@@ -29,7 +30,6 @@ const getNetwork = (nameOrId: ChainNameOrId) => {
 	throw new MissingConfigError(`Network configuration for chain ${nameOrId}`);
 };
 
-export const imageProxy = stringTemplate(SERVICES.imageProxy, {});
 const metadataURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.metadata, { prefix });
@@ -39,11 +39,18 @@ const indexerURL = (chain: ChainNameOrId, env: Env = 'production') => {
 	const network = getNetwork(chain).name;
 	return stringTemplate(SERVICES.indexer, { network: network, prefix });
 };
+
 const marketplaceApiURL = (chain: ChainNameOrId, env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	const network = getNetwork(chain).name;
 	return stringTemplate(SERVICES.marketplaceApi, { network: network, prefix });
 };
+
+export const builderRpcApi = (env: Env = 'production') => {
+	const prefix = getPrefix(env);
+	return stringTemplate(SERVICES.builderRpcApi, { prefix });
+};
+
 export const builderMarketplaceApi = (
 	projectId: string,
 	env: Env = 'production',

package/src/react/_internal/databeat/types.ts

@@ -25,6 +25,7 @@ interface Transaction extends PropsEvent {
 
 interface TradeItemsInfo extends PropsEvent {
 	marketplaceKind: MarketplaceKind;
+	userId: string;
 	collectionAddress: string;
 	currencyAddress: string;
 	currencySymbol: string;

package/src/react/_internal/wagmi/__tests__/create-config.test.ts

@@ -8,9 +8,7 @@ import {
 	OrderbookKind,
 	type SdkConfig,
 } from '../../../../types';
-import { MissingConfigError } from '../../../../utils/_internal/error/transaction';
 import { createWagmiConfig } from '../create-config';
-import { getWaasConnectors } from '../get-connectors';
 
 describe('createWagmiConfig', () => {
 	let baseMarketplaceConfig: MarketplaceConfig;
@@ -18,6 +16,7 @@ describe('createWagmiConfig', () => {
 
 	beforeEach(() => {
 		baseMarketplaceConfig = {
+			projectId: 1,
 			cssString: '',
 			manifestUrl: '',
 			publisherId: 'test-publisher',
@@ -97,9 +96,7 @@ describe('createWagmiConfig', () => {
 
 			const sdkConfig: SdkConfig = {
 				...baseSdkConfig,
-				wallet: {
-					walletConnectProjectId: 'test-wc-project-id',
-				},
+				walletConnectProjectId: 'test-wc-project-id',
 			};
 
 			const config = createWagmiConfig(marketplaceConfig, sdkConfig);
@@ -108,6 +105,14 @@ describe('createWagmiConfig', () => {
 		});
 
 		it('should create config with embedded wallet setup', () => {
+			// Valid waas tenant key format - base64 encoded JSON string containing the actual key
+			const waasTenantKey = btoa(
+				JSON.stringify({
+					key: 'valid-waas-tenant-key',
+					projectId: 'test-project-id',
+				}),
+			);
+
 			const marketplaceConfig: MarketplaceConfig = {
 				...baseMarketplaceConfig,
 				walletOptions: {
@@ -115,20 +120,17 @@ describe('createWagmiConfig', () => {
 					includeEIP6963Wallets: false,
 					walletType: MarketplaceWallet.EMBEDDED,
 					oidcIssuers: {},
+					waas: {
+						tenantKey: waasTenantKey,
+						emailEnabled: false,
+						providers: [],
+					},
 				},
 			};
 
 			const sdkConfig: SdkConfig = {
 				...baseSdkConfig,
-				wallet: {
-					embedded: {
-						waasConfigKey:
-							'eyJwcm9qZWN0SWQiOjEzNjM5LCJycGNTZXJ2ZXIiOiJodHRwczovL3dhYXMuc2VxdWVuY2UuYXBwIn0',
-						googleClientId: 'test-google-id',
-						appleClientId: 'test-apple-id',
-						appleRedirectURI: 'https://test.com/redirect',
-					},
-				},
+				walletConnectProjectId: 'test-wc-project-id',
 			};
 
 			const config = createWagmiConfig(marketplaceConfig, sdkConfig);
@@ -173,33 +175,6 @@ describe('createWagmiConfig', () => {
 	});
 
 	describe('failure cases', () => {
-		it('should throw error when trying to use embedded wallet without waasConfigKey', () => {
-			const sdkConfig: SdkConfig = {
-				...baseSdkConfig,
-				wallet: {
-					embedded: {
-						waasConfigKey: '',
-						googleClientId: 'test-google-id',
-						appleClientId: 'test-apple-id',
-						appleRedirectURI: 'https://test.com/redirect',
-					},
-				},
-			};
-
-			expect(() =>
-				getWaasConnectors({
-					...sdkConfig,
-					wallet: {
-						...sdkConfig.wallet,
-						embedded: {
-							...sdkConfig.wallet?.embedded,
-							waasConfigKey: '', // Empty waasConfigKey should trigger the error
-						},
-					},
-				}),
-			).toThrow(MissingConfigError);
-		});
-
 		it('should still create config when walletConnectProjectId is missing', () => {
 			const marketplaceConfig: MarketplaceConfig = {
 				...baseMarketplaceConfig,

package/src/react/_internal/wagmi/create-config.ts

@@ -2,12 +2,8 @@ import { getDefaultChains } from '@0xsequence/connect';
 import { allNetworks, findNetworkConfig } from '@0xsequence/network';
 import type { Chain, Transport } from 'viem';
 import { http, cookieStorage, createConfig, createStorage } from 'wagmi';
-import {
-	type Env,
-	type MarketplaceConfig,
-	MarketplaceWallet,
-	type SdkConfig,
-} from '../../../types';
+import type { Env, SdkConfig } from '../../../types';
+import type { MarketplaceConfig } from '../../queries/marketplaceConfig';
 import { DEFAULT_NETWORK } from '../consts';
 import { getConnectors } from './get-connectors';
 
@@ -24,16 +20,7 @@ export const createWagmiConfig = (
 		nodeGatewayEnv,
 	);
 
-	let walletType = marketplaceConfig.walletOptions.walletType;
-
-	// TODO: This will bring issues.. But we relay on the waasConfigKey to detect if the boilerplates should use
-	// waas or universal.. we need to find a better way to do this..
-	if (
-		sdkConfig.wallet?.embedded?.waasConfigKey &&
-		walletType !== MarketplaceWallet.ECOSYSTEM
-	) {
-		walletType = MarketplaceWallet.EMBEDDED;
-	}
+	const walletType = marketplaceConfig.walletOptions.walletType;
 
 	const connectors = getConnectors({
 		marketplaceConfig,