@0xsequence/marketplace-sdk 0.8.12 → 0.10.0

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

@@ -5,7 +5,7 @@
 //
 // webrpc-gen -schema=builder.main.ridl -target=typescript -client -out=../../webapp/src/rpc/proto/builder.gen.ts
 
-import { OrderbookKind } from "./marketplace.gen";
+import type { OrderbookKind } from "./marketplace.gen";
 
 export const WebrpcHeader = "Webrpc";
 export const WebrpcHeaderValue =
@@ -59,10 +59,10 @@ export interface MarketplaceSettings {
 }
 
 export interface MarketplacePage {
-  enabled: boolean;
-  title: string;
-  bannerUrl: string;
-  ogImage: string;
+  enabled: boolean
+  bannerUrl: string
+  ogImage: string
+  private: boolean
 }
 
 export interface MarketplaceSocials {
@@ -135,7 +135,7 @@ export interface ShopCollection {
   saleAddress: string;
   name: string;
   bannerUrl: string;
-  saleBannerUrl: string;
+  tokenIds: Array<string>;
   createdAt?: string;
   updatedAt?: string;
 }

package/src/react/_internal/api/get-query-client.ts

@@ -1,6 +1,6 @@
 import {
-	QueryClient,
 	defaultShouldDehydrateQuery,
+	QueryClient,
 } from '@tanstack/react-query';
 import { hashFn } from 'wagmi/query';
 
@@ -20,7 +20,7 @@ function makeQueryClient() {
 	});
 }
 
-let browserQueryClient: QueryClient | undefined = undefined;
+let browserQueryClient: QueryClient | undefined;
 
 export function getQueryClient() {
 	if (typeof globalThis.document === 'undefined') {

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

@@ -1,6 +1,6 @@
 export * from './get-query-client';
-export * from './marketplace-api';
+export * from './laos-api';
 export * from './marketplace.gen';
+export * from './marketplace-api';
 export * from './query-keys';
 export * from './services';
-export * from './laos-api';

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

@@ -22,6 +22,7 @@ export type TokenSuppliesParams = {
 export type TokenBalancesParams = {
 	chainId: string;
 	accountAddress: string;
+	contractAddress: string;
 	includeMetadata?: boolean;
 	page?: PaginationOptions;
 };
@@ -71,6 +72,7 @@ export class LaosAPI {
 	async getTokenBalances({
 		chainId,
 		accountAddress,
+		contractAddress,
 		includeMetadata = true,
 		page = {
 			sort: [
@@ -89,6 +91,7 @@ export class LaosAPI {
 			body: JSON.stringify({
 				chainId,
 				accountAddress,
+				contractAddress,
 				includeMetadata,
 				page,
 			}),

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

@@ -1,5 +1,5 @@
 /* eslint-disable */
-// marketplace-api  966f8f49f445aaef13f2daccc968a931178cd71b
+// marketplace-api  cf3a5fae407a732cd5a90e4fd68184ac5591b2c1
 // --
 // Code generated by webrpc-gen@v0.25.4 with typescript generator. DO NOT EDIT.
 //
@@ -8,7 +8,7 @@
 export const WebrpcHeader = "Webrpc";
 
 export const WebrpcHeaderValue =
-  "webrpc@v0.25.4;gen-typescript@v0.17.0;marketplace-api@v0.0.0-966f8f49f445aaef13f2daccc968a931178cd71b";
+  "webrpc@v0.25.4;gen-typescript@v0.17.0;marketplace-api@v0.0.0-cf3a5fae407a732cd5a90e4fd68184ac5591b2c1;marketplace-sdk@v0.10.0";
 
 // WebRPC description and code-gen version
 export const WebRPCVersion = "v1";
@@ -17,7 +17,7 @@ export const WebRPCVersion = "v1";
 export const WebRPCSchemaVersion = "";
 
 // Schema hash generated from your RIDL schema
-export const WebRPCSchemaHash = "966f8f49f445aaef13f2daccc968a931178cd71b";
+export const WebRPCSchemaHash = "cf3a5fae407a732cd5a90e4fd68184ac5591b2c1";
 
 type WebrpcGenVersions = {
   webrpcGenVersion: string;
@@ -585,7 +585,9 @@ export interface PrimarySaleItem {
   priceDecimals: number;
   priceAmount: string;
   priceAmountFormatted: string;
+  supply: string;
   supplyCap: string;
+  unlimitedSupply: boolean;
   createdAt: string;
   updatedAt: string;
   deletedAt?: string;
@@ -1024,6 +1026,11 @@ export interface Marketplace {
     headers?: object,
     signal?: AbortSignal
   ): Promise<SupportedMarketplacesReturn>;
+  getPrimarySaleItem(
+    args: GetPrimarySaleItemArgs,
+    headers?: object,
+    signal?: AbortSignal
+  ): Promise<GetPrimarySaleItemReturn>;
   listPrimarySaleItems(
     args: ListPrimarySaleItemsArgs,
     headers?: object,
@@ -1437,6 +1444,15 @@ export interface SupportedMarketplacesArgs {
 export interface SupportedMarketplacesReturn {
   marketplaces: Array<MarketplaceKind>;
 }
+export interface GetPrimarySaleItemArgs {
+  chainId: string;
+  primarySaleContractAddress: string;
+  tokenId: string;
+}
+
+export interface GetPrimarySaleItemReturn {
+  item: CollectiblePrimarySaleItem;
+}
 export interface ListPrimarySaleItemsArgs {
   chainId: string;
   primarySaleContractAddress: string;
@@ -2764,6 +2780,30 @@ export class Marketplace implements Marketplace {
     );
   };
 
+  getPrimarySaleItem = (
+    args: GetPrimarySaleItemArgs,
+    headers?: object,
+    signal?: AbortSignal
+  ): Promise<GetPrimarySaleItemReturn> => {
+    return this.fetch(
+      this.url("GetPrimarySaleItem"),
+      createHTTPRequest(args, headers, signal)
+    ).then(
+      (res) => {
+        return buildResponse(res).then((_data) => {
+          return {
+            item: <CollectiblePrimarySaleItem>_data.item,
+          };
+        });
+      },
+      (error) => {
+        throw WebrpcRequestFailedError.new({
+          cause: `fetch(): ${error.message || ""}`,
+        });
+      }
+    );
+  };
+
   listPrimarySaleItems = (
     args: ListPrimarySaleItemsArgs,
     headers?: object,

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,29 @@ 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 TokenKeys {
+	static all = ['tokens'] as const;
+	static metadata = [...TokenKeys.all, 'metadata'] as const;
+	static supplies = [...TokenKeys.all, 'supplies'] as const;
+}
+
+// biome-ignore lint/complexity/noStaticOnlyClass: static class provides better organization and type safety for query keys
+class TokenSuppliesKeys {
+	static all = ['tokenSupplies'] as const;
+	static maps = [...TokenSuppliesKeys.all, 'map'] 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 tokenKeys = TokenKeys;
+export const tokenSuppliesKeys = TokenSuppliesKeys;

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

@@ -1,34 +1,27 @@
 import { SequenceAPIClient } from '@0xsequence/api';
 import { SequenceIndexer } from '@0xsequence/indexer';
 import { SequenceMetadata } from '@0xsequence/metadata';
-import { networks, stringTemplate } from '@0xsequence/network';
+import { stringTemplate } from '@0xsequence/network';
 import type { ApiConfig, Env, SdkConfig } from '../../../types/sdk-config';
-import { MissingConfigError } from '../../../utils/_internal/error/transaction';
+import { getNetwork } from '../../../utils/network';
 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',
+	// 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',
 };
 
 type ChainNameOrId = string | number;
 
-const getNetwork = (nameOrId: ChainNameOrId) => {
-	for (const network of Object.values(networks)) {
-		if (
-			network.name === String(nameOrId).toLowerCase() ||
-			network.chainId === Number(nameOrId)
-		) {
-			return network;
-		}
-	}
-	throw new MissingConfigError(`Network configuration for chain ${nameOrId}`);
-};
-
 const metadataURL = (env: Env = 'production') => {
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.metadata, { prefix });
@@ -41,10 +34,6 @@ const indexerURL = (chain: ChainNameOrId, env: Env = 'production') => {
 };
 
 const marketplaceApiURL = (env: Env = 'production') => {
-	// TODO: remove this once we have a production endpoint
-	if (env === 'development') {
-		return 'https://dev-marketplace-api-v2.sequence-dev.app';
-	}
 	const prefix = getPrefix(env);
 	return stringTemplate(SERVICES.marketplaceApi, { prefix });
 };
@@ -60,45 +49,41 @@ export const sequenceApiUrl = (env: Env = 'production') => {
 };
 
 export const getBuilderClient = (config: SdkConfig) => {
-	const env = config._internal?.overrides?.api?.builder?.env || 'production';
-	const projectAccessKey =
-		config._internal?.overrides?.api?.builder?.accessKey ||
-		config.projectAccessKey;
-	return new BuilderAPI(builderRpcApiURL(env), projectAccessKey);
+	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?.overrides?.api?.metadata?.env || 'production';
-	const projectAccessKey =
-		config._internal?.overrides?.api?.metadata?.accessKey ||
-		config.projectAccessKey;
-	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?.overrides?.api?.indexer?.env || 'production';
-	const projectAccessKey =
-		config._internal?.overrides?.api?.indexer?.accessKey ||
-		config.projectAccessKey;
-	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 = (config: SdkConfig) => {
-	const env =
-		config._internal?.overrides?.api?.marketplace?.env || 'production';
-	const projectAccessKey =
-		config._internal?.overrides?.api?.marketplace?.accessKey ||
-		config.projectAccessKey;
-	return new SequenceMarketplace(marketplaceApiURL(env), projectAccessKey);
+	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?.overrides?.api?.sequenceApi?.env || 'production';
-	const projectAccessKey =
-		config._internal?.overrides?.api?.sequenceApi?.accessKey ||
-		config.projectAccessKey;
-	return new SequenceAPIClient(sequenceApiUrl(env), projectAccessKey);
+	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: ApiConfig['env']) => {

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

@@ -1,9 +1,11 @@
-import type { Auth, Event as DatabeatEvent } from '@databeat/tracker';
+import type { Event as DatabeatEvent } from '@databeat/tracker';
 import { Databeat } from '@databeat/tracker';
+import { useContext } from 'react';
 
-import { useConfig } from '../../hooks';
+import { MarketplaceSdkContext } from '../../provider';
 import type {
 	EventType,
+	TrackBuyModalOpened,
 	TrackCreateListing,
 	TrackCreateOffer,
 	TrackSellItems,
@@ -22,6 +24,14 @@ export class DatabeatAnalytics extends Databeat<Extract<EventTypes, string>> {
 		});
 	}
 
+	trackBuyModalOpened(args: TrackBuyModalOpened) {
+		this.track({
+			event: 'BUY_MODAL_OPENED',
+			props: args.props,
+			nums: args.nums,
+		});
+	}
+
 	trackCreateListing(args: TrackCreateListing) {
 		this.track({
 			event: 'CREATE_LISTING',
@@ -47,16 +57,7 @@ export class DatabeatAnalytics extends Databeat<Extract<EventTypes, string>> {
 }
 
 export const useAnalytics = () => {
-	const config = useConfig();
-	const server = 'https://nodes.sequence.app';
-
-	const auth: Auth = {};
-	auth.headers = { 'X-Access-Key': config.projectAccessKey };
-
-	return new DatabeatAnalytics(server, auth, {
-		defaultEnabled: true,
-		initProps: () => {
-			return { origin: window.location.origin };
-		},
-	});
+	const context = useContext(MarketplaceSdkContext);
+
+	return context.analytics;
 };

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

@@ -1,3 +1,4 @@
+import type { BuyModalProps } from '../../ui/modals/BuyModal/store';
 import type { MarketplaceKind, OrderbookKind } from '../api';
 
 export enum EventType {
@@ -8,6 +9,7 @@ export enum EventType {
 	CANCEL_LISTING = 4,
 	CANCEL_OFFER = 5,
 	TRANSACTION_FAILED = 6,
+	BUY_MODAL_OPENED = 7,
 }
 
 interface PropsEvent {
@@ -41,6 +43,26 @@ export interface TrackBuyItems {
 	nums: TradeItemsValues;
 }
 
+type BuyModalOpenedProps = Omit<
+	BuyModalProps,
+	| 'marketplaceType'
+	| 'customCreditCardProviderCallback'
+	| 'chainId'
+	| 'skipNativeBalanceCheck'
+	| 'nativeTokenAddress'
+> & {
+	buyAnalyticsId: string;
+};
+
+type BuyModalOpenedNums = {
+	chainId: number;
+};
+
+export interface TrackBuyModalOpened {
+	props: BuyModalOpenedProps;
+	nums: BuyModalOpenedNums;
+}
+
 export interface TrackSellItems {
 	props: TradeItemsInfo & Transaction;
 	nums: TradeItemsValues;

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

@@ -0,0 +1,26 @@
+// Flattens an object and turns it into a string and number object for use with analytics
+// Ignores arrays and converts booleans to strings
+export function flattenAnalyticsArgs(args: object) {
+	const analyticsProps: Record<string, string> = {};
+	const analyticsNums: Record<string, number> = {};
+
+	function recurse(obj: object, prefix = '') {
+		for (const [key, value] of Object.entries(obj)) {
+			const path = prefix ? `${prefix}.${key}` : key;
+			if (typeof value === 'string' || typeof value === 'boolean') {
+				analyticsProps[path] = value.toString();
+			} else if (typeof value === 'number') {
+				analyticsNums[path] = value;
+			} else if (isPojo(value)) {
+				recurse(value, path);
+			}
+		}
+	}
+
+	recurse(args);
+	return { analyticsProps, analyticsNums };
+}
+
+function isPojo(val: unknown): val is Record<string, unknown> {
+	return typeof val === 'object' && val !== null && !Array.isArray(val);
+}

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 { Address, Hex, TypedData, TypedDataDomain } from 'viem';
 import { type PostRequest, type Signature, type Step, StepType } from './api';
 
 export interface SignatureStep {
@@ -7,7 +6,7 @@ export interface SignatureStep {
 	domain?: TypedDataDomain;
 	types?: TypedData;
 	primaryType?: string;
-	to: Hex; // TODO: This should not be here, its wrongly typed in webrpc
+	to: Address; // TODO: This should not be here, its wrongly typed in webrpc
 	data: string;
 	value: string;
 	price: string;
@@ -23,7 +22,7 @@ export interface TransactionStep {
 		| StepType.createOffer
 		| StepType.createListing;
 	data: Hex;
-	to: Hex;
+	to: Address;
 	value: Hex;
 	price: Hex;
 	maxFeePerGas?: Hex;
@@ -33,7 +32,7 @@ export interface TransactionStep {
 export interface ApprovalStep {
 	id: StepType.tokenApproval;
 	data: string;
-	to: Hex;
+	to: Address;
 	value: string;
 	price: string;
 }

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';
@@ -12,18 +12,10 @@ export const createWagmiConfig = (
 	sdkConfig: SdkConfig,
 	ssr?: boolean,
 ) => {
-	const chains = getChainConfigs(marketplaceConfig);
-	const nodeGatewayEnv =
-		sdkConfig._internal?.overrides?.api?.nodeGateway?.env ?? 'production';
-	const projectAccessKey =
-		sdkConfig._internal?.overrides?.api?.nodeGateway?.accessKey ??
-		sdkConfig.projectAccessKey;
-
-	const transports = getTransportConfigs(
-		chains,
-		projectAccessKey,
-		nodeGatewayEnv,
-	);
+	const { chains, transports } = getWagmiChainsAndTransports({
+		marketplaceConfig,
+		sdkConfig,
+	});
 
 	const walletType = marketplaceConfig.settings.walletOptions.walletType;
 
@@ -50,6 +42,30 @@ export const createWagmiConfig = (
 	});
 };
 
+export function getWagmiChainsAndTransports({
+	marketplaceConfig,
+	sdkConfig,
+}: {
+	marketplaceConfig: MarketplaceConfig;
+	sdkConfig: SdkConfig;
+}) {
+	const chains = getChainConfigs(marketplaceConfig);
+	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,
+		projectAccessKey,
+		nodeGatewayEnv,
+		nodeGatewayUrl,
+	);
+
+	return { chains, transports };
+}
+
 function getAllCollections(marketConfig: MarketplaceConfig) {
 	return [...marketConfig.market.collections, ...marketConfig.shop.collections];
 }
@@ -71,18 +87,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;