> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/marketplace/estates-marketplace-integrations.md).

# Integraciones de Estates Marketplace

Cosas importantes a tener en cuenta si quieres integrar el Estate de Decentraland en tu marketplace

## Integración de Estates de Decentraland en tu Marketplace

El Estate de Decentraland es un NFT compatible con ERC721 que funciona en la red principal de Ethereum. Por lo tanto, muchos Marketplaces de terceros pueden comerciar con ellos. Para hacerlo, el Marketplace debe seguir ciertas reglas que garanticen la seguridad de las transacciones para los usuarios.

Como quizá sepas, cada [Estate](https://docs.decentraland.org/decentraland/faq/#what-is-an-estate) es un grupo de [LANDs](https://docs.decentraland.org/decentraland/faq/#what-is-land) y tiene un hash de *bytes* asociado al grupo, llamado *`fingerprint`*. Cada vez que el Estate cambia al agregar o quitar un LAND, también cambia su *`fingerprint`* .

Para los Marketplaces, en especial los que no tienen un sistema de depósito en garantía, se recomienda encarecidamente guardar un registro del *`fingerprint`* del Estate cuando alguien lo pone a la venta o hace una oferta. De ese modo, cuando la orden o la oferta se ejecuta correctamente, el propietario actual no puede cambiar el Estate intentando adelantarse a la ejecución de la orden.

No se recomienda poner a la venta Estates vacíos. El contrato inteligente de Estate tiene un método llamado `getEstateSize` que devuelve la cantidad de LANDs del Estate. Si el resultado es `0`, recomendamos no poner ese Estate a la venta. Si aun así quieres ponerlo a la venta, verás una imagen como esta:

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e98d87470ca9ff53ce25f1950c9b9649357e8511%2Fdissolved_estate.webp?alt=media)

## Ejemplo

### No usar el fingerprint del Estate

* Bob tiene el Estate1 con los LANDs (1,1) y (1,2). Fingerprint de Estate1: hash1
* Bob agrega el LAND (1,3) a Estate1. Estate1 tiene los LANDs (1,1), (1,2) y (1,3). Fingerprint de Estate1: hash2 (el fingerprint cambió)
* Bob quita el LAND (1,1) de Estate1. Estate1 tiene los LANDs (1,2) y (1,3). Fingerprint de Estate1: hash3 (el fingerprint cambió)
* Bob pone Estate1 a la venta. La oferta se crea onchain en la red principal de Ethereum con la dirección del contrato inteligente de Estate, el ID de Estate, el precio y la fecha de vencimiento.
* Alice envía una transacción para comprar Estate, indicando el ID de Estate y el precio que espera pagar.
* Bob detecta que alguien intenta comprar su Estate1 y envía una transacción con comisiones de gas más altas que las de Alice para quitar los LANDs (1,2) y (1,3) de Estate1.
* Las transacciones de Bob se minan primero. Estate1 tiene 0 LANDs. Fingerprint de Estate1: hash4 (el fingerprint cambió)
* La transacción de Alice se mina después. Alice compró Estate1, que no tiene ningún LAND. Esto significa que Bob se adelantó a Alice (y la estafó).

### Usar el fingerprint del Estate

* Bob tiene el Estate1 con los LANDs (1,1) y (1,2). Fingerprint de Estate1: hash1
* Bob agrega el LAND (1,3) a Estate1. Estate1 tiene los LANDs (1,1), (1,2) y (1,3). Fingerprint de Estate1: hash2 (el fingerprint cambió)
* Bob quita el LAND (1,1) de Estate1. Estate1 tiene los LANDs (1,2) y (1,3). Fingerprint de Estate1: hash3 (el fingerprint cambió)
* Bob pone Estate1 a la venta. La oferta se crea onchain en la red principal de Ethereum con la dirección del contrato inteligente de Estate, el ID de Estate, el precio y la fecha de vencimiento.
* Alice envía una transacción para comprar Estate, indicando el ID de Estate, el precio que espera pagar y **el fingerprint que vio (hash3)**.
* Bob detecta que alguien intenta comprar su Estate1 y envía una transacción con comisiones de gas más altas que las de Alice para quitar los LANDs (1,2) y (1,3) de Estate1.
* Las transacciones de Bob se minan primero. Estate1 tiene 0 LANDs. Fingerprint de Estate1: hash4 (el fingerprint cambió)
* La transacción de Alice se revierte porque el contrato inteligente comprobó que el fingerprint del parámetro enviado por Alice no coincidía con el fingerprint actual de Estate1 (hash3 != hash4). Esta comprobación impidió que Alice comprara un Estate que no quería.

## Interfaz de fingerprint del contrato inteligente de Estate

El contrato inteligente de Estate es compatible con una [interfaz de fingerprint](https://github.com/decentraland/land/blob/master/contracts/estate/EstateStorage.sol#L19). Cuando se pone un Estate a la venta o recibe una oferta, guarda su fingerprint llamando a *`getFingerprintV2(uint256 estateId)`* y almacena el valor que devuelve. Para comprobar si la orden o la oferta sigue siendo válida en el momento de ejecutarla, llama a *`verifyFingerprint(uint256 estateId, bytes fingerprint)`* con el valor almacenado.

Almacena siempre el valor devuelto por *`getFingerprintV2`*. El método anterior *`getFingerprint`* se conserva únicamente por compatibilidad con versiones anteriores y se está retirando gradualmente: a partir del 26 de noviembre de 2026, *`verifyFingerprint`* dejará de aceptar los valores que este método genera. Las nuevas integraciones deben usar *`getFingerprintV2`*.

Puedes consultar un ejemplo funcional en producción [aquí](https://github.com/decentraland/marketplace-contracts/blob/master/contracts/marketplace/MarketplaceV2.sol#L382).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-es/marketplace/estates-marketplace-integrations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
