在 Web3 开发和 NFT 交易中，与智能合约的交互是核心环节。本文深入解析两种主要合约类型：聚合器合约和自营市场合约，帮助你理解其工作原理、参数设置及交互方式。
聚合器合约解析
聚合器合约的核心功能是整合多个市场的流动性，通过统一的 API 接口简化交易操作。其核心 API 是 trade，该接口封装了调用其他市场合约所需的 calldata 数据。
MarketRegistry 注册合约
MarketRegistry 是所有支持市场合约的注册中心，任何市场合约必须在此注册后才能被聚合器调用。关键参数包括：
- marketId：市场的自定义标识符
- value：支付原生币的数量（如 ETH）
- orderHash：订单的哈希值
- tradeData：在其他市场实际执行交易的 calldata 数据
AggregatorParamV3 参数详解
AggregatorParamV3 结构定义了交易的具体参数：
- actionType：操作类型，目前支持 Seaport 的多种操作
- payAmount：用于支付的 ERC20 Token 数量
- payToken：支付所使用的 ERC20 Token 地址
- tokenAddress：ERC721/ERC1155 的 Token 地址
- tokenId：Token 的唯一标识
- amount：Token 数量
- tradeType：交易类型标识
- extraData：扩展数据，包含订单相关地址信息
原子性执行控制
isAtomic 参数控制批量执行的原子性：设置为 true 时，任何订单失败都会触发整体回滚；设置为 false 时，失败订单不会影响其他订单的执行。
自营市场合约操作指南
自营市场合约提供更直接的交易功能，支持多种订单类型和执行方式。
一口价挂单机制
一口价挂单是简单的NFT销售方式，卖家设定固定价格等待买家购买。挂单过程包括生成订单和进行签名，创建后订单进入市场等待匹配。
订单执行接口
自营市场支持两种订单执行接口：fulfillBasicOrder 和 fulfillAdvancedOrder。
fulfillBasicOrder 基础接口
该接口适用于标准订单执行，主要参数包括：
- considerationToken：竞价盘 token 的标的物地址
- considerationIdentifier：竞价盘 token 的 id
- considerationAmount：竞价盘 token 的数量
- offerer：报价者的账户地址
- zone：订单对应的 zone
- 其他关键参数如时间设置、签名信息等
fulfillAdvancedOrder 高级接口
高级接口支持更复杂的交易场景，包含三个核心组件：
- fulfillerConduitKey：吃单者的 ConduitKey
- recipient：指定 token 的接收者地址
- CriteriaResolver：条件解析器，用于验证 merkle 路径等参数
AdvancedOrder 结构包含完整的订单参数，支持部分成交等高级功能：
- numerator/denominator：部分成交的比例控制
- signature：订单签名
- parameters：订单参数集合
订单参数中，OfferItem 和 ConsiderationItem 定义了交易的具体资产信息，包括 token 地址、数量范围以及接收方等关键数据。
👉 查看实时交易工具
订单下架操作
支持批量撤单功能，但仅限于 offerer 和 zone 执行。OrderComponents 数据结构与 OrderParameters 基本一致，增加了 counter 字段用于交易量计数。
常见问题
聚合器合约和自营市场合约有什么区别？
聚合器合约整合多个市场的流动性，通过统一接口简化操作；自营市场合约提供直接的交易功能，支持更丰富的订单类型和执行方式。选择取决于具体需求：需要多市场流动性时使用聚合器，需要特定功能时使用自营市场。
isAtomic 参数应该如何设置？
设置为 true 保证交易的原子性，任何失败都会回滚所有操作，确保一致性；设置为 false 允许部分成功，适合批量处理中允许个别失败的场景。根据业务需求选择适当设置。
fulfillBasicOrder 和 fulfillAdvancedOrder 如何选择？
基础接口适合标准交易场景，参数简单明了；高级接口支持部分成交、条件验证等复杂功能。根据交易复杂度选择接口，简单交易用基础接口，复杂需求用高级接口。
下架操作有哪些权限限制？
只有订单的 offerer（挂单者）和 zone（区域控制者）可以执行下架操作。这种限制保证了订单的安全性和可控性，防止未经授权的撤单行为。
如何确保交易的安全性？
通过签名验证、权限控制、条件解析等多种机制确保安全。订单执行需要有效签名，下架操作有权限限制，复杂交易有条件验证。多重保障机制确保每笔交易的安全可靠。
通过深入理解这些合约的交互方式，开发者可以构建更高效、安全的Web3应用，为用户提供流畅的交易体验。掌握这些知识点将为你的区块链开发之路打下坚实基础。