Trails

.github/workflows/pre-release-deploy.yml

@@ -3,8 +3,6 @@ name: Publish Pre-release
 on:
   workflow_dispatch:
   push:
-    branches:
-      - master
 
 jobs:
   publish:
@@ -62,14 +60,14 @@ jobs:
           # Initialize git in tmp directory
           cd /tmp/marketplace-sdk
           git init
-          git checkout -b pre-release
+          git checkout -b trails-testing
 
           # Configure git
           git config user.name "github-actions"
           git config user.email "[email protected]"
 
           # Commit and push
           git add .
-          git commit -m "Build: publish marketplace-sdk pre-release"
+          git commit -m "Build: publish marketplace-sdk trails-testing"
           git remote add origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git
-          git push -f origin HEAD:pre-release
+          git push -f origin HEAD:trails-testing

package.json

@@ -22,7 +22,7 @@
 		"coverage": "pnpm run --r --filter \"./sdk\" coverage",
 		"tailwind": "pnpm --filter \"./sdk\" tailwind"
 	},
-	"packageManager": "pnpm@10.15.1",
+	"packageManager": "pnpm@10.16.1",
 	"engines": {
 		"node": "24.x"
 	},
@@ -31,15 +31,16 @@
 			"@0xsequence/marketplace-sdk": "workspace:*"
 		},
 		"onlyBuiltDependencies": [
+			"@tailwindcss/oxide",
 			"msw",
 			"oxc-resolver"
 		]
 	},
 	"devDependencies": {
 		"@biomejs/biome": "catalog:",
-		"@types/node": "^24.3.1",
+		"@types/node": "^24.3.3",
 		"knip": "^5.63.1",
-		"lefthook": "^1.12.4",
+		"lefthook": "^1.13.0",
 		"typescript": "catalog:"
 	},
 	"prepare": "lefthook install"

playgrounds/shared/package.json

@@ -35,6 +35,7 @@
 		"@tailwindcss/vite": "^4.1.13",
 		"date-fns": "^4.1.0",
 		"postcss": "^8.5.6",
-		"react-virtuoso": "^4.14.0"
+		"react-virtuoso": "^4.14.0",
+		"zod": "3.25.76"
 	}
 }

pnpm-workspace.yaml

@@ -29,6 +29,7 @@ catalog:
   nuqs: ^2.6.0
   react: ^19.1.1
   react-day-picker: ^9.9.0
+  0xtrails: ^0.1.6
   react-dom: ^19.1.1
   tailwindcss: ^4.1.13
   tsup: ^8.5.0

sdk/package.json

@@ -64,6 +64,7 @@
 		"@legendapp/state": "catalog:",
 		"@tailwindcss/cli": "^4.1.13",
 		"@xstate/store": "catalog:",
+		"xtrails": "npm:0xtrails@^0.1.6",
 		"class-variance-authority": "^0.7.1",
 		"clsx": "^2.1.1",
 		"date-fns": "catalog:",

sdk/src/react/hooks/data/orders/useOrders.tsx

@@ -0,0 +1,73 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import type { Optional } from '../../../_internal';
+import {
+	type FetchOrdersParams,
+	type OrdersQueryOptions,
+	ordersQueryOptions,
+} from '../../../queries/orders';
+import { useConfig } from '../../config/useConfig';
+
+export type UseOrdersParams = Optional<OrdersQueryOptions, 'config'>;
+
+/**
+ * Hook to fetch orders from the marketplace
+ *
+ * Retrieves orders based on the provided parameters from the marketplace.
+ *
+ * @param params - Configuration parameters
+ * @param params.chainId - Optional chain ID to filter orders
+ * @param params.contractAddress - Optional contract address to filter orders
+ * @param params.tokenId - Optional token ID to filter orders
+ * @param params.maker - Optional maker address to filter orders
+ * @param params.taker - Optional taker address to filter orders
+ * @param params.status - Optional status to filter orders
+ * @param params.side - Optional side to filter orders
+ * @param params.pagination - Optional pagination parameters
+ * @param params.query - Optional React Query configuration
+ *
+ * @returns Query result containing the orders data
+ *
+ * @example
+ * Basic usage:
+ * ```typescript
+ * const { data, isLoading } = useOrders({
+ *   chainId: '137',
+ *   contractAddress: '0x...'
+ * })
+ * ```
+ *
+ * @example
+ * With pagination:
+ * ```typescript
+ * const { data, isLoading } = useOrders({
+ *   chainId: '1',
+ *   pagination: {
+ *     limit: 20,
+ *     offset: 0
+ *   },
+ *   query: {
+ *     refetchInterval: 15000
+ *   }
+ * })
+ * ```
+ */
+export function useOrders(params: UseOrdersParams) {
+	const defaultConfig = useConfig();
+
+	const { config = defaultConfig, ...rest } = params;
+
+	const queryOptions = ordersQueryOptions({
+		config,
+		...rest,
+	});
+
+	return useQuery({
+		...queryOptions,
+	});
+}
+
+export { ordersQueryOptions };
+
+export type { FetchOrdersParams, OrdersQueryOptions };

sdk/src/react/hooks/transactions/index.ts

@@ -1,9 +1,14 @@
+export * from './useBuyTransaction';
 export * from './useCancelOrder';
 export * from './useCancelTransactionSteps';
 export * from './useGenerateCancelTransaction';
 export * from './useGenerateListingTransaction';
 export * from './useGenerateOfferTransaction';
 export * from './useGenerateSellTransaction';
+export * from './useMarketTransactionSteps';
 export * from './useOrderSteps';
+export * from './usePrimarySaleTransactionSteps';
 export * from './useProcessStep';
+export * from './useTransactionExecution';
+export * from './useTransactionType';
 export * from './useTransferTokens';

sdk/src/react/hooks/transactions/useBuyTransaction.ts

@@ -0,0 +1,79 @@
+import { zeroAddress } from 'viem';
+import { useAccount } from 'wagmi';
+import { TransactionType } from '../../../types/transactions';
+import { ContractType } from '../../_internal';
+import { MarketplaceKind } from '../../_internal/api';
+import { useMarketPlatformFee } from '../../ui/modals/BuyModal/hooks/useMarketPlatformFee';
+import type { BuyModalProps } from '../../ui/modals/BuyModal/store';
+import { isMarketProps, isShopProps } from '../../ui/modals/BuyModal/store';
+import { useMarketTransactionSteps } from './useMarketTransactionSteps';
+import { usePrimarySaleTransactionSteps } from './usePrimarySaleTransactionSteps';
+import { useTransactionType } from './useTransactionType';
+
+/**
+ * Unified hook that handles both market and primary sale transactions
+ * Automatically selects the appropriate transaction type based on modal props
+ */
+export function useBuyTransaction(modalProps: BuyModalProps) {
+	const { address: buyer } = useAccount();
+	const transactionType = useTransactionType(modalProps);
+	const marketPlatformFee = useMarketPlatformFee({
+		chainId: modalProps.chainId,
+		collectionAddress: modalProps.collectionAddress,
+	});
+
+	// Market transaction query
+	const marketQuery = useMarketTransactionSteps({
+		chainId: modalProps.chainId,
+		collectionAddress: modalProps.collectionAddress,
+		buyer: buyer!,
+		marketplace: isMarketProps(modalProps)
+			? modalProps.marketplace
+			: MarketplaceKind.sequence_marketplace_v2,
+		orderId: isMarketProps(modalProps) ? modalProps.orderId : '',
+		collectibleId: isMarketProps(modalProps) ? modalProps.collectibleId : '',
+		quantity: '1', // Single item purchase for now
+		additionalFees: [marketPlatformFee],
+		enabled: transactionType === TransactionType.MARKET_BUY && !!buyer,
+	});
+
+	// Primary sale transaction query
+	const primaryQuery = usePrimarySaleTransactionSteps({
+		chainId: modalProps.chainId,
+		buyer: buyer!,
+		salesContractAddress: isShopProps(modalProps)
+			? modalProps.salesContractAddress
+			: zeroAddress,
+		tokenIds: isShopProps(modalProps)
+			? modalProps.items.map((item) => item.tokenId || '0')
+			: [],
+		amounts: isShopProps(modalProps)
+			? modalProps.items.map((item) => Number(item.quantity) || 1)
+			: [],
+		maxTotal: isShopProps(modalProps) ? modalProps.salePrice.amount : '0',
+		paymentToken: isShopProps(modalProps)
+			? modalProps.salePrice.currencyAddress
+			: zeroAddress,
+		contractType: ContractType.ERC1155, // TODO: Determine from contract
+		enabled: transactionType === TransactionType.PRIMARY_SALE && !!buyer,
+	});
+
+	// Return the active query based on transaction type
+	if (transactionType === TransactionType.MARKET_BUY) {
+		return {
+			data: marketQuery.data,
+			isLoading: marketQuery.isLoading,
+			error: marketQuery.error,
+			isError: marketQuery.isError,
+			refetch: marketQuery.refetch,
+		};
+	}
+
+	return {
+		data: primaryQuery.data,
+		isLoading: primaryQuery.isLoading,
+		error: primaryQuery.error,
+		isError: primaryQuery.isError,
+		refetch: primaryQuery.refetch,
+	};
+}

sdk/src/react/hooks/transactions/useMarketTransactionSteps.ts

@@ -0,0 +1,74 @@
+import { useQuery } from '@tanstack/react-query';
+import { useMemo } from 'react';
+import type { Address } from 'viem';
+import type { AdditionalFee, MarketplaceKind, Step } from '../../_internal/api';
+import { getMarketplaceClient, WalletKind } from '../../_internal/api';
+import { useConfig } from '../config';
+
+export interface UseMarketTransactionStepsParams {
+	chainId: number;
+	collectionAddress: Address;
+	buyer: Address;
+	marketplace: MarketplaceKind;
+	orderId: string;
+	collectibleId: string;
+	quantity: string;
+	additionalFees?: AdditionalFee[];
+	enabled?: boolean;
+}
+
+/**
+ * Hook to generate transaction steps for market transactions (secondary sales)
+ * This directly calls the marketplace API without using generators
+ */
+export function useMarketTransactionSteps({
+	chainId,
+	collectionAddress,
+	buyer,
+	marketplace,
+	orderId,
+	collectibleId,
+	quantity,
+	additionalFees = [],
+	enabled = true,
+}: UseMarketTransactionStepsParams) {
+	const config = useConfig();
+	const marketplaceClient = useMemo(
+		() => getMarketplaceClient(config),
+		[config],
+	);
+
+	return useQuery<Step[], Error>({
+		queryKey: [
+			'market-transaction-steps',
+			{
+				chainId,
+				collectionAddress,
+				buyer,
+				orderId,
+				collectibleId,
+				quantity,
+			},
+		],
+		queryFn: async () => {
+			const response = await marketplaceClient.generateBuyTransaction({
+				chainId: chainId.toString(),
+				collectionAddress,
+				buyer,
+				marketplace,
+				ordersData: [
+					{
+						orderId,
+						quantity,
+						tokenId: collectibleId,
+					},
+				],
+				additionalFees,
+				walletType: WalletKind.sequence,
+			});
+
+			return response.steps;
+		},
+		enabled: enabled && !!buyer,
+	});
+}