Using the sdk fulfillorder get error "You must supply the appropriate criterias for criteria based items"

[BernardGeorge]

Component

Other (please describe)

Have you ensured that all of these are up to date?

• opensea-js
• Node (minimum v16)

What version of opensea-js are you on?

8.0.3

What function is the bug in?

sdk.fulfillOrder

Operating System

macOS (Apple Silicon)

Describe the bug

📦 Environment

• opensea-js version: 8.0.0 (also tested with 7.4.0)
• @opensea/seaport-js version: 4.0.5
• ethers version: 6.9.0
• Node.js version: v23.7.0
• Network: Arbitrum
• Protocol Address: 0x0000000000000068F116a894984e2DB1123eB395 (Seaport 1.6)

When attempting to fulfill a Collection Offer using sdk.fulfillOrder() , the transaction fails with the error:

const transactionHash = await sdk.fulfillOrder({
order: bestOffer,
accountAddress: accountAddress,
assetContractAddress: '0x80c3c93e6c3cde742fa0435c38f1044ca401e585',
tokenId: '1',
});

Result: ❌ Fails with error:

Error: You must supply the appropriate criterias for criteria based items
    at fulfillStandardOrder (.../seaport-js/lib/utils/fulfill.js:204:15)
    at Seaport.fulfillOrder (.../seaport-js/lib/seaport.js:547:51)
    at FulfillmentManager.fulfillOrder (.../opensea-js/lib/sdk/fulfillment.js:121:39)

The problem: Although assetContractAddress and tokenId are passed to the OpenSea API's generateFulfillmentData endpoint, they are NOT converted to considerationCriteria when calling the underlying seaport.fulfillOrder() method.

💡 Expected Behavior

sdk.fulfillOrder() should work for Collection Offers when assetContractAddress and tokenId are provided:

let considerationCriteria = [];
  if (assetContractAddress && tokenId) {
    considerationCriteria = [{
      identifier: tokenId,
      proof: []
    }];
  }
  
  const seaport = getSeaportInstance(protocolAddress, this.context.seaport);
  const { executeAllActions } = await seaport.fulfillOrder({
    order: protocolData,
    accountAddress,
    recipientAddress,
    unitsToFill: effectiveUnitsToFill,
    extraData,
    domain,
    overrides,
    offerCriteria: [],              // ✅ ADD THIS
    considerationCriteria,          // ✅ ADD THIS
  });

[BernardGeorge]

After I dealt with the considerationCriteria issue， i get new error
code: 'CALL_EXCEPTION',
action: 'estimateGas',
data: '0xd232fd2ccf112f697208a4d3abd0f6c140b333ca54b51a7a38727865d28a558a5025019f',
reason: null,
transaction: {
to: '0x0000000000000068F116a894984e2DB1123eB395',
data: '0xe7acab24000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000005600000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000046000000000000000000000000000000000000000000000000000000000000004c0000000000000000000000000aaf0d60d622ef1f81a232f3467b8edd981566b6e000000000000000000000000000056f7000000ece9003ca63978907a00ffd1000000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000068f1ab64000000000000000000000000000000000000000000000000000000006919386400000000000000000000000000000000000000000000000000000000000000003d958fe20000000000000000000000000000000000000000ea0872cc67172de20000007b02230091a7ed01230072f7006a004d60a8d4e71d599b8104250f000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000082af49447d8a07e3bd95bd0d56f35241523fbab1000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005af3107a400000000000000000000000000000000000000000000000000000005af3107a40000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000400000000000000000000000080c3c93e6c3cde742fa0435c38f1044ca401e585000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000aaf0d60d622ef1f81a232f3467b8edd981566b6e000000000000000000000000000000000000000000000000000000000000000100000000000000000000000082af49447d8a07e3bd95bd0d56f35241523fbab10000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e8d4a51000000000000000000000000000000000000000000000000000000000e8d4a510000000000000000000000000000000a26b00c1f0df003000390027140000faa71900000000000000000000000000000000000000000000000000000000000000402c8b2d753e94d78106c9b84df7bfe6594522d2047a316afc1713b150e40186622f024e52ff5dba08d3924065ff3f0f640b36189f4af89154b6894559488586b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000000',
from: '0xC01C9D15fADD83E81CD9764292e6e201e1fDE4D0'
},
invocation: null,
revert: null,
shortMessage: 'execution reverted (unknown custom error)',
info: {
error: {
code: 3,
message: 'execution reverted',
data: '0xd232fd2ccf112f697208a4d3abd0f6c140b333ca54b51a7a38727865d28a558a5025019f'
},
payload: {
method: 'eth_estimateGas',
params: [Array],
id: 19,
jsonrpc: '2.0'
}
}

[BernardGeorge]

when i use sdk.fulfillorder can buy nft from listings success

const response = await sdk.api.getAllListings(
        CONFIG.collectionSlug,
        CONFIG.searchLimit
      );
const targetListing = response.listings[0]
const transactionHash = await sdk.fulfillOrder({
        order: targetListing,
        accountAddress: accountAddress,
      });