庄园市场集成

如果你想在市场中集成 Decentraland 的庄园，需要注意的重要事项

将 Decentraland 的 Estate 集成到你的市场中

Decentraland 的 Estate 是一个符合 ERC721 标准的 NFT，并运行在以太坊主网上。因此，很多第三方市场都可以交易它们。为此，这个市场必须遵循某些规则，以确保用户的交易安全。

如你所知，每个 Estate 是一个由以下组成的组： LANDs 并且它有一个 字节 哈希与该组相关联，称为 指纹。每当 Estate 通过添加或移除一个 LAND 而发生变化时，它的 指纹 也会随之变化。

对于市场，尤其是没有托管系统的市场，强烈建议在有人将 Estate 上架出售或发出报价时，记录该 Estate 的 指纹 。这样，当订单/报价成功执行时，当前所有者就不能通过试图抢跑订单执行来更改该 estate。

不建议上架空的 Estates。Estate 智能合约有一个方法 getEstateSize ，它返回 Estate 中 LAND 的数量。如果结果是 0，我们建议不要上架该 Estate。如果你仍然想上架它们，你会看到类似这样的图片：

示例

未使用 Estate 指纹

• Bob 拥有 Estate1，其中包含 LAND (1,1) 和 (1,2)。Estate1 指纹：hash1

• Bob 向 Estate1 添加了 LAND (1,3)。Estate1 现在有这些 LAND：(1,1)、(1,2) 和 (1,3)。Estate1 指纹：hash2（指纹已变化）

• Bob 从 Estate1 中移除了 LAND (1,1)。Estate1 现在有这些 LAND：(1,2) 和 (1,3)。Estate1 指纹：hash3（指纹已变化）

• Bob 将 Estate1 挂牌出售。该列表在以太坊主网上链创建，包含 Estate 智能合约地址、Estate id、价格和到期日期。

• Alice 发送了一笔交易来购买 Estate，并指定了 estate id 和预期支付的价格。

• Bob 发现有人正试图购买他的 Estate1，于是发送了一笔 gas 费用高于 Alice 的交易，从 Estate1 中移除 LAND (1,2) 和 (1,3)。

• Bob 的交易先被打包。Estate1 现在有 0 个 LAND。Estate1 指纹：hash4（指纹已变化）

• Alice 的交易随后被打包。Alice 买到了一个上面没有 LAND 的 Estate1。这意味着 Alice 被 Bob 抢跑了（并被盗/被骗了）。

使用 Estate 指纹

• Bob 拥有 Estate1，其中包含 LAND (1,1) 和 (1,2)。Estate1 指纹：hash1

• Bob 向 Estate1 添加了 LAND (1,3)。Estate1 现在有这些 LAND：(1,1)、(1,2) 和 (1,3)。Estate1 指纹：hash2（指纹已变化）

• Bob 从 Estate1 中移除了 LAND (1,1)。Estate1 现在有这些 LAND：(1,2) 和 (1,3)。Estate1 指纹：hash3（指纹已变化）

• Bob 将 Estate1 挂牌出售。该列表在以太坊主网上链创建，包含 Estate 智能合约地址、Estate id、价格和到期日期。

• Alice 发送了一笔交易来购买 Estate，并指定了 estate id、预期支付的价格，以及 她看到的指纹（hash3）.

• Bob 发现有人正试图购买他的 Estate1，于是发送了一笔 gas 费用高于 Alice 的交易，从 Estate1 中移除 LAND (1,2) 和 (1,3)。

• Bob 的交易先被打包。Estate1 现在有 0 个 LAND。Estate1 指纹：hash4（指纹已变化）

• Alice 的交易被回滚，因为智能合约检查到 Alice 发送的参数中的指纹与当前 Estate1 的指纹不匹配（hash3 != hash4）。这个检查阻止了 Alice 购买一个非预期的 Estate。

Estate 智能合约指纹接口

Estate 的智能合约符合一个 指纹接口。当 Estate 被上架出售或收到报价时，通过调用 getFingerprintV2(uint256 estateId) 来记录其指纹，并保存其返回值。要检查该订单/报价在执行时是否仍然有效，请调用 verifyFingerprint(uint256 estateId, bytes fingerprint) 并使用保存的值。

请始终保存 getFingerprintV2返回的值。较旧的 getFingerprint 方法仅为向后兼容而保留，并且正在逐步淘汰：从 2026 年 11 月 26 日开始， verifyFingerprint 将不再接受它生成的值。新的集成应使用 getFingerprintV2.

你可以查看一个可运行的生产示例 这里.