@0xsequence/marketplace-sdk 0.8.11 → 0.9.0

package/src/react/_internal/api/query-keys.ts

@@ -1,4 +1,4 @@
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class CollectableKeys {
 	static all = ['collectable'] as const;
 	static details = [...CollectableKeys.all, 'details'] as const;
@@ -35,7 +35,7 @@ class CollectableKeys {
 	] as const;
 }
 
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class CollectionKeys {
 	static all = ['collections'] as const;
 	static list = [...CollectionKeys.all, 'list'] as const;
@@ -46,7 +46,7 @@ class CollectionKeys {
 	] as const;
 }
 
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class BalanceQueries {
 	static all = ['balances'] as const;
 	static lists = [...BalanceQueries.all, 'tokenBalances'] as const;
@@ -56,14 +56,14 @@ class BalanceQueries {
 	] as const;
 }
 
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class CheckoutKeys {
 	static all = ['checkouts'] as const;
 	static options = [...CheckoutKeys.all, 'options'] as const;
 	static cartItems = [...CheckoutKeys.all, 'cartItems'] as const;
 }
 
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class CurrencyKeys {
 	static all = ['currencies'] as const;
 	static lists = [...CurrencyKeys.all, 'list'] as const;
@@ -71,14 +71,21 @@ class CurrencyKeys {
 	static conversion = [...CurrencyKeys.all, 'conversion'] as const;
 }
 
-// biome-ignore lint/complexity/noStaticOnlyClass:
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
 class ConfigKeys {
 	static all = ['configs'] as const;
 	static marketplace = [...ConfigKeys.all, 'marketplace'] as const;
 }
+
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
+class MetadataKeys {
+	static all = ['metadata'] as const;
+	static tokenMetadata = [...MetadataKeys.all, 'tokenMetadata'] as const;
+}
 export const collectableKeys = CollectableKeys;
 export const collectionKeys = CollectionKeys;
 export const balanceQueries = BalanceQueries;
 export const checkoutKeys = CheckoutKeys;
 export const currencyKeys = CurrencyKeys;
 export const configKeys = ConfigKeys;
+export const metadataKeys = MetadataKeys;

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

@@ -2,19 +2,22 @@ import { SequenceAPIClient } from '@0xsequence/api';
 import { SequenceIndexer } from '@0xsequence/indexer';
 import { SequenceMetadata } from '@0xsequence/metadata';
 import { networks, stringTemplate } from '@0xsequence/network';
-import type { Env, SdkConfig } from '../../../types/sdk-config';
+import type { ApiConfig, Env, SdkConfig } from '../../../types/sdk-config';
 import { MissingConfigError } from '../../../utils/_internal/error/transaction';
+import { BuilderAPI } from './builder-api';
 import { SequenceMarketplace } from './marketplace-api';
 
 const SERVICES = {
+	// biome-ignore lint/suspicious/noTemplateCurlyInString: template placeholder for stringTemplate function
 	sequenceApi: 'https://${prefix}api.sequence.app',
+	// biome-ignore lint/suspicious/noTemplateCurlyInString: template placeholder for stringTemplate function
 	metadata: 'https://${prefix}metadata.sequence.app',
+	// biome-ignore lint/suspicious/noTemplateCurlyInString: template placeholder for stringTemplate function
 	indexer: 'https://${prefix}${network}-indexer.sequence.app',
-	marketplaceApi: 'https://${prefix}marketplace-api.sequence.app/${network}',
+	// biome-ignore lint/suspicious/noTemplateCurlyInString: template placeholder for stringTemplate function
+	marketplaceApi: 'https://${prefix}marketplace-api.sequence.app',
+	// biome-ignore lint/suspicious/noTemplateCurlyInString: template placeholder for stringTemplate function
 	builderRpcApi: 'https://${prefix}api.sequence.build',
-	//Used for fetching css and manifest
-	builderMarketplaceApi:
-		'https://${prefix}api.sequence.build/marketplace/${projectId}',
 };
 
 type ChainNameOrId = string | number;
@@ -35,19 +38,19 @@ const metadataURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.metadata, { prefix });
 };
+
 const indexerURL = (chain: ChainNameOrId, env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	const network = getNetwork(chain).name;
 	return stringTemplate(SERVICES.indexer, { network: network, prefix });
 };
 
-const marketplaceApiURL = (chain: ChainNameOrId, env: Env = 'production') => {
+const marketplaceApiURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
-	const network = getNetwork(chain).name;
-	return stringTemplate(SERVICES.marketplaceApi, { network: network, prefix });
+	return stringTemplate(SERVICES.marketplaceApi, { prefix });
 };
 
-export const builderRpcApi = (env: Env = 'production') => {
+const builderRpcApiURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.builderRpcApi, { prefix });
 };
@@ -57,58 +60,45 @@ export const sequenceApiUrl = (env: Env = 'production') => {
 	return stringTemplate(SERVICES.sequenceApi, { prefix });
 };
 
-export const builderMarketplaceApi = (
-	projectId: string,
-	env: Env = 'production',
-) => {
-	const prefix = getPrefix(env);
-	return stringTemplate(SERVICES.builderMarketplaceApi, {
-		projectId,
-		prefix,
-	});
+export const getBuilderClient = (config: SdkConfig) => {
+	const overrides = config._internal?.overrides?.api?.builder;
+	const url =
+		overrides?.url || builderRpcApiURL(overrides?.env || 'production');
+	const projectAccessKey = overrides?.accessKey || config.projectAccessKey;
+	return new BuilderAPI(url, projectAccessKey);
 };
+
 export const getMetadataClient = (config: SdkConfig) => {
-	const env = config._internal?.metadataEnv || 'production';
-	const projectAccessKey = getAccessKey({ env, config });
-	return new SequenceMetadata(metadataURL(env), projectAccessKey);
+	const overrides = config._internal?.overrides?.api?.metadata;
+	const url = overrides?.url || metadataURL(overrides?.env || 'production');
+	const projectAccessKey = overrides?.accessKey || config.projectAccessKey;
+	return new SequenceMetadata(url, projectAccessKey);
 };
+
 export const getIndexerClient = (chain: ChainNameOrId, config: SdkConfig) => {
-	const env = config._internal?.indexerEnv || 'production';
-	const projectAccessKey = getAccessKey({ env, config });
-	return new SequenceIndexer(indexerURL(chain, env), projectAccessKey);
+	const overrides = config._internal?.overrides?.api?.indexer;
+	const url =
+		overrides?.url || indexerURL(chain, overrides?.env || 'production');
+	const projectAccessKey = overrides?.accessKey || config.projectAccessKey;
+	return new SequenceIndexer(url, projectAccessKey);
 };
-export const getMarketplaceClient = (
-	chain: ChainNameOrId,
-	config: SdkConfig,
-) => {
-	const env = config._internal?.marketplaceEnv || 'production';
-	const projectAccessKey = getAccessKey({ env, config });
-	return new SequenceMarketplace(
-		marketplaceApiURL(chain, env),
-		projectAccessKey,
-	);
+
+export const getMarketplaceClient = (config: SdkConfig) => {
+	const overrides = config._internal?.overrides?.api?.marketplace;
+	const url =
+		overrides?.url || marketplaceApiURL(overrides?.env || 'production');
+	const projectAccessKey = overrides?.accessKey || config.projectAccessKey;
+	return new SequenceMarketplace(url, projectAccessKey);
 };
+
 export const getSequenceApiClient = (config: SdkConfig) => {
-	const env = config._internal?.sequenceApiEnv || 'production';
-	const projectAccessKey = getAccessKey({ env, config });
-	return new SequenceAPIClient(sequenceApiUrl(env), projectAccessKey);
-};
-const getAccessKey = ({ env, config }: { env: Env; config: SdkConfig }) => {
-	switch (env) {
-		case 'development':
-			if (!config._internal?.devAccessKey)
-				throw new MissingConfigError('devAccessKey for development env');
-			return config._internal?.devAccessKey;
-		case 'production':
-			return config.projectAccessKey;
-		case 'next':
-			if (!config._internal?.nextAccessKey)
-				throw new MissingConfigError('nextAccessKey for next env');
-			return config._internal?.nextAccessKey;
-	}
+	const overrides = config._internal?.overrides?.api?.sequenceApi;
+	const url = overrides?.url || sequenceApiUrl(overrides?.env || 'production');
+	const projectAccessKey = overrides?.accessKey || config.projectAccessKey;
+	return new SequenceAPIClient(url, projectAccessKey);
 };
 
-const getPrefix = (env: Env) => {
+const getPrefix = (env: ApiConfig['env']) => {
 	switch (env) {
 		case 'development':
 			return 'dev-';

package/src/react/_internal/index.ts

@@ -1,5 +1,5 @@
+export * from './api';
 export * from './consts';
 export * from './get-provider';
 export * from './types';
-export * from './api';
 export * from './wagmi';

package/src/react/_internal/types.ts

@@ -1,30 +1,11 @@
-import type { Address } from 'viem';
-import { z } from 'zod';
 import type { ContractType, CreateReq } from '../../types';
 import type { MarketplaceKind } from './api';
 
-export const QueryArgSchema = z
-	.object({
-		enabled: z.boolean().optional(),
-	})
-	.optional();
-
-export type QueryArg = z.infer<typeof QueryArgSchema>;
-
-export const CollectableIdSchema = z.string().or(z.number());
-
-export const AddressSchema = z.string().transform((val, ctx) => {
-	const regex = /^0x[a-fA-F0-9]{40}$/;
-
-	if (!regex.test(val)) {
-		ctx.addIssue({
-			code: z.ZodIssueCode.custom,
-			message: `Invalid Address ${val}`,
-		});
-	}
+export interface QueryArg {
+	enabled?: boolean;
+}
 
-	return val as Address;
-});
+export type CollectableId = string | number;
 
 export type CollectionType = ContractType.ERC1155 | ContractType.ERC721;
 
@@ -75,3 +56,9 @@ export interface CancelInput {
 	orderId: string;
 	marketplace: MarketplaceKind;
 }
+
+export type ValuesOptional<T> = {
+	[K in keyof T]: T[K] | undefined;
+};
+
+export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;

package/src/react/_internal/utils.ts

@@ -1,5 +1,4 @@
-import type { TypedData, TypedDataDomain } from 'viem';
-import type { Hex } from 'viem';
+import type { Hex, TypedData, TypedDataDomain } from 'viem';
 import { type PostRequest, type Signature, type Step, StepType } from './api';
 
 export interface SignatureStep {

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

@@ -3,10 +3,9 @@ import { beforeEach, describe, expect, it } from 'vitest';
 import { type Config, cookieStorage } from 'wagmi';
 import type { SdkConfig } from '../../../../types';
 import { ContractType, OrderbookKind } from '../../../../types';
-import {
-	type MarketCollection,
-	type MarketplaceConfig,
-	MarketplaceType,
+import type {
+	MarketCollection,
+	MarketplaceConfig,
 } from '../../../../types/new-marketplace-types';
 import { MarketplaceWalletType } from '../../api/builder.gen';
 import { createWagmiConfig } from '../create-config';
@@ -19,6 +18,7 @@ describe('createWagmiConfig', () => {
 		baseMarketplace = {
 			projectId: 1,
 			settings: {
+				style: {},
 				publisherId: 'test-publisher',
 				title: 'Test Marketplace',
 				socials: {
@@ -47,7 +47,7 @@ describe('createWagmiConfig', () => {
 				collections: [
 					{
 						contractType: ContractType.ERC721,
-						marketplaceType: MarketplaceType.MARKET,
+						marketplaceType: 'market',
 						chainId: polygon.id,
 						bannerUrl: '',
 						itemsAddress: '0x1234567890123456789012345678901234567890',

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

@@ -1,7 +1,7 @@
 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 { cookieStorage, createConfig, createStorage, http } from 'wagmi';
 import type { Env, SdkConfig } from '../../../types';
 import type { MarketplaceConfig } from '../../../types/new-marketplace-types';
 import { DEFAULT_NETWORK } from '../consts';
@@ -13,11 +13,17 @@ export const createWagmiConfig = (
 	ssr?: boolean,
 ) => {
 	const chains = getChainConfigs(marketplaceConfig);
-	const nodeGatewayEnv = sdkConfig._internal?.nodeGatewayEnv ?? 'production';
+	const nodeGatewayOverrides = sdkConfig._internal?.overrides?.api?.nodeGateway;
+	const nodeGatewayEnv = nodeGatewayOverrides?.env ?? 'production';
+	const nodeGatewayUrl = nodeGatewayOverrides?.url;
+	const projectAccessKey =
+		nodeGatewayOverrides?.accessKey ?? sdkConfig.projectAccessKey;
+
 	const transports = getTransportConfigs(
 		chains,
-		sdkConfig.projectAccessKey,
+		projectAccessKey,
 		nodeGatewayEnv,
+		nodeGatewayUrl,
 	);
 
 	const walletType = marketplaceConfig.settings.walletOptions.walletType;
@@ -66,18 +72,26 @@ function getChainConfigs(marketConfig: MarketplaceConfig): [Chain, ...Chain[]] {
 function getTransportConfigs(
 	chains: [Chain, ...Chain[]],
 	projectAccessKey: string,
-	nodeGatewayEnv: Env,
+	nodeGatewayEnv: Env | undefined,
+	nodeGatewayUrl?: string,
 ): Record<number, Transport> {
 	return chains.reduce(
 		(acc, chain) => {
 			const network = findNetworkConfig(allNetworks, chain.id);
 			if (network) {
-				let rpcUrl = network.rpcUrl;
-				if (nodeGatewayEnv === 'development') {
-					rpcUrl = rpcUrl.replace('nodes.', 'dev-nodes.');
+				let rpcUrl: string;
+				if (nodeGatewayUrl) {
+					// Use manual URL if provided
+					rpcUrl = nodeGatewayUrl;
+				} else {
+					// Use default URL with environment prefix
+					rpcUrl = network.rpcUrl;
+					if (nodeGatewayEnv === 'development') {
+						rpcUrl = rpcUrl.replace('nodes.', 'dev-nodes.');
+					}
+					if (!network.rpcUrl.endsWith(projectAccessKey))
+						rpcUrl = `${rpcUrl}/${projectAccessKey}`;
 				}
-				if (!network.rpcUrl.endsWith(projectAccessKey))
-					rpcUrl = `${rpcUrl}/${projectAccessKey}`;
 				acc[chain.id] = http(rpcUrl);
 			}
 			return acc;

package/src/react/_internal/wagmi/get-connectors.ts

@@ -1,6 +1,4 @@
 import {
-	type SequenceOptions,
-	type Wallet,
 	apple,
 	appleWaas,
 	coinbaseWallet,
@@ -11,8 +9,10 @@ import {
 	getConnectWallets,
 	google,
 	googleWaas,
+	type SequenceOptions,
 	sequence,
 	twitch,
+	type Wallet,
 	walletConnect,
 } from '@0xsequence/connect';
 import React, { type FunctionComponent } from 'react';
@@ -82,11 +82,16 @@ function getUniversalWalletConfigs(
 	config: SdkConfig,
 	marketplaceConfig: MarketplaceConfig,
 ): Wallet[] {
-	const { projectAccessKey } = config;
-	const sequenceWalletEnv = config._internal?.sequenceWalletEnv || 'production';
+	const sequenceWalletOverrides =
+		config._internal?.overrides?.api?.sequenceWallet;
+	const sequenceWalletUrl =
+		sequenceWalletOverrides?.url ||
+		getSequenceWalletURL(sequenceWalletOverrides?.env || 'production');
+	const projectAccessKey =
+		sequenceWalletOverrides?.accessKey || config.projectAccessKey;
 
 	const sequenceWalletOptions = {
-		walletAppURL: getSequenceWalletURL(sequenceWalletEnv),
+		walletAppURL: sequenceWalletUrl,
 		defaultNetwork: DEFAULT_NETWORK,
 		connect: {
 			projectAccessKey,

package/src/react/_internal/wallet/__tests__/wallet.test.ts

@@ -5,10 +5,10 @@ import {
 	type Address,
 	BaseError,
 	type Chain,
+	hexToBigInt,
 	type PublicClient,
 	UserRejectedRequestError as ViemUserRejectedRequestError,
 	type WalletClient,
-	hexToBigInt,
 } from 'viem';
 import { beforeEach, describe, expect, it, vi } from 'vitest';
 import type { Connector } from 'wagmi';

package/src/react/_internal/wallet/wallet.ts

@@ -4,18 +4,18 @@ import {
 	type Address,
 	BaseError,
 	type Chain,
+	custom,
+	erc20Abi,
+	erc721Abi,
 	type Hex,
+	hexToBigInt,
+	isHex,
 	type PublicClient,
 	TransactionReceiptNotFoundError,
 	type TypedDataDomain,
 	UserRejectedRequestError as ViemUserRejectedRequestError,
 	type WalletClient as ViemWalletClient,
 	WaitForTransactionReceiptTimeoutError,
-	custom,
-	erc20Abi,
-	erc721Abi,
-	hexToBigInt,
-	isHex,
 } from 'viem';
 import type { Connector } from 'wagmi';
 import type { SwitchChainErrorType } from 'wagmi/actions';
@@ -32,7 +32,7 @@ import {
 	TransactionSignatureError,
 	UserRejectedRequestError,
 } from '../../../utils/_internal/error/transaction';
-import { StepType, WalletKind, getIndexerClient } from '../api';
+import { getIndexerClient, StepType, WalletKind } from '../api';
 import { createLogger } from '../logger';
 import type { SignatureStep, TransactionStep } from '../utils';
 
@@ -132,21 +132,21 @@ export const wallet = ({
 						account: wallet.account,
 						message,
 					});
-					// biome-ignore lint/style/noUselessElse: <explanation>
-				} else if (stepItem.id === StepType.signEIP712) {
+				}
+				if (stepItem.id === StepType.signEIP712) {
 					logger.debug('Signing with EIP-712', {
 						domain: stepItem.domain,
 						types: stepItem.signature?.types,
 					});
 					return await wallet.signTypedData({
 						account: wallet.account,
-						// biome-ignore lint/style/noNonNullAssertion: <explanation>
+						// biome-ignore lint/style/noNonNullAssertion: signature is guaranteed to exist for EIP712 step type
 						domain: stepItem.signature!.domain as TypedDataDomain,
-						// biome-ignore lint/style/noNonNullAssertion: <explanation>
+						// biome-ignore lint/style/noNonNullAssertion: signature is guaranteed to exist for EIP712 step type
 						types: stepItem.signature!.types,
-						// biome-ignore lint/style/noNonNullAssertion: <explanation>
+						// biome-ignore lint/style/noNonNullAssertion: signature is guaranteed to exist for EIP712 step type
 						primaryType: stepItem.signature!.primaryType,
-						// biome-ignore lint/style/noNonNullAssertion: <explanation>
+						// biome-ignore lint/style/noNonNullAssertion: signature is guaranteed to exist for EIP712 step type
 						message: stepItem.signature!.value,
 					});
 				}
@@ -241,26 +241,26 @@ export const wallet = ({
 
 			switch (tokenType) {
 				case 'ERC20':
-					return await publicClient.readContract({
+					return (await publicClient.readContract({
 						address: contractAddress as Hex,
 						abi: erc20Abi,
 						functionName: 'allowance',
 						args: [walletAddress, spenderAddress],
-					});
+					})) as bigint;
 				case 'ERC721':
-					return await publicClient.readContract({
+					return (await publicClient.readContract({
 						address: contractAddress as Hex,
 						abi: erc721Abi,
 						functionName: 'isApprovedForAll',
 						args: [walletAddress, spenderAddress],
-					});
+					})) as boolean;
 				case 'ERC1155':
-					return await publicClient.readContract({
+					return (await publicClient.readContract({
 						address: contractAddress as Hex,
 						abi: ERC1155_ABI,
 						functionName: 'isApprovedForAll',
 						args: [walletAddress, spenderAddress],
-					});
+					})) as boolean;
 				default:
 					throw new Error('Unsupported contract type for approval checking');
 			}