> 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-pt/marketplace/estates-marketplace-integrations.md).

# Integrações de Marketplace para Estates

Coisas importantes a ter em mente se você quiser integrar o Estate do Decentraland ao seu marketplace

## Integrar os Estate da Decentraland no seu Marketplace

O Estate da Decentraland é um NFT compatível com ERC721 e funciona na Ethereum Mainnet. Por isso, muitos marketplaces de terceiros podem negociá-los. Para isso, este marketplace tem de seguir determinadas regras para manter as transações seguras para os utilizadores.

Como talvez saiba, cada [Estate](https://docs.decentraland.org/decentraland/faq/#what-is-an-estate) é um grupo de [LANDs](https://docs.decentraland.org/decentraland/faq/#what-is-land) e tem um hash de *bytes* associado ao grupo, chamado *`fingerprint`*. Sempre que o Estate muda por adição ou remoção de um LAND, o seu *`fingerprint`* também muda.

Para os marketplaces, especialmente os que não têm um sistema de escrow, é altamente recomendável registar a *`fingerprint`* do Estate quando alguém o coloca à venda ou faz uma oferta. Assim, quando a ordem/oferta é executada com sucesso, o proprietário atual não pode alterar o Estate tentando antecipar-se à execução da ordem.

Não é recomendável colocar à venda Estates vazios. O smart contract do Estate tem um método `getEstateSize` que devolve o número de LANDs no Estate. Se o resultado for `0`, recomendamos que não coloque esse Estate à venda. Se ainda assim quiser colocá-lo à venda, verá uma imagem como esta:

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

## Exemplo

### Sem usar a fingerprint do Estate

* Bob tem o Estate1 com os LANDs (1,1) e (1,2). Fingerprint do Estate1: hash1
* Bob adiciona o LAND (1,3) ao Estate1. O Estate1 tem os LANDs: (1,1), (1,2) e (1,3). Fingerprint do Estate1: hash2 (Fingerprint alterada)
* Bob remove o LAND (1,1) do Estate1. O Estate1 tem os LANDs: (1,2) e (1,3). Fingerprint do Estate1: hash3 (Fingerprint alterada)
* Bob coloca o Estate1 à venda. A listagem é criada on-chain na Ethereum Mainnet com o endereço do smart contract do Estate, o ID do Estate, o preço e a data de expiração.
* Alice envia uma transação para comprar o Estate, indicando o ID do Estate e o preço que espera pagar.
* Bob percebe que alguém está a tentar comprar o Estate1 e envia uma transação com taxas de gas superiores às de Alice para remover os LANDs (1,2) e (1,3) do Estate1.
* As transações de Bob são mineradas primeiro. O Estate1 fica com 0 LANDs. Fingerprint do Estate1: hash4 (Fingerprint alterada)
* A transação de Alice é minerada depois. Alice comprou o Estate1 sem LANDs. Isto significa que Bob se antecipou a Alice (e a enganou ou roubou).

### Usando a fingerprint do Estate

* Bob tem o Estate1 com os LANDs (1,1) e (1,2). Fingerprint do Estate1: hash1
* Bob adiciona o LAND (1,3) ao Estate1. O Estate1 tem os LANDs: (1,1), (1,2) e (1,3). Fingerprint do Estate1: hash2 (Fingerprint alterada)
* Bob remove o LAND (1,1) do Estate1. O Estate1 tem os LANDs: (1,2) e (1,3). Fingerprint do Estate1: hash3 (Fingerprint alterada)
* Bob coloca o Estate1 à venda. A listagem é criada on-chain na Ethereum Mainnet com o endereço do smart contract do Estate, o ID do Estate, o preço e a data de expiração.
* Alice envia uma transação para comprar o Estate, indicando o ID do Estate, o preço que espera pagar e **a fingerprint que viu (hash3)**.
* Bob percebe que alguém está a tentar comprar o Estate1 e envia uma transação com taxas de gas superiores às de Alice para remover os LANDs (1,2) e (1,3) do Estate1.
* As transações de Bob são mineradas primeiro. O Estate1 fica com 0 LANDs. Fingerprint do Estate1: hash4 (Fingerprint alterada)
* A transação de Alice é revertida porque o smart contract verificou que a fingerprint no parâmetro enviado por Alice não correspondia à fingerprint atual do Estate1 (hash3 != hash4). Esta verificação impediu Alice de comprar um Estate diferente do pretendido.

## Interface de fingerprint do smart contract do Estate

O smart contract do Estate é compatível com uma [interface de fingerprint](https://github.com/decentraland/land/blob/master/contracts/estate/EstateStorage.sol#L19). Quando um Estate é colocado à venda ou recebe uma oferta, registe a sua fingerprint chamando *`getFingerprintV2(uint256 estateId)`* e armazene o valor devolvido. Para verificar se essa ordem/oferta continua válida no momento da execução, chame *`verifyFingerprint(uint256 estateId, bytes fingerprint)`* com o valor armazenado.

Armazene sempre o valor devolvido por *`getFingerprintV2`*. O método mais antigo *`getFingerprint`* é mantido apenas por compatibilidade com versões anteriores e está a ser descontinuado: a partir de 26 de novembro de 2026, *`verifyFingerprint`* deixará de aceitar valores produzidos por esse método. As novas integrações devem usar *`getFingerprintV2`*.

Pode consultar um exemplo funcional em produção [aqui](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-pt/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.
