> 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/scenes-sdk7/media/display-a-certified-nft.md).

# Exibir um NFT Certificado

Saiba como exibir em sua scene um NFT certificado que você possui

Pode exibir um NFT 2D (token não fungível) que você possui nas suas cenas de Decentraland.

A imagem e outros dados do NFT são obtidos de uma API, com base no contrato e no ID do token. Qualquer NFT compatível com [OpenSea](https://opensea.io/) também pode ser exibido em uma moldura para NFT em Decentraland.

{% hint style="info" %}
**💡 Dica**: no [Scene Editor no Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/about-editor.md), você pode usar um **NFT** [Smart Item](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) para fazer isso sem precisar escrever código.
{% endhint %}

A moldura é exibida de acordo com as dimensões da imagem do NFT. Se a imagem tiver 512 × 512 pixels, a moldura mantém o tamanho original. Se a imagem tiver outras dimensões, a moldura será redimensionada e esticada para corresponder a elas.

{% hint style="info" %}
**💡 Dica**: se quiser esticar ou redimensionar a imagem em relação ao que é gerado por padrão, você pode alterar a propriedade `scale` na entidade do `Transform` .
{% endhint %}

## Adicionar um NFT

Adicione um componente `NftShape` a uma entidade para exibir um token 2D na sua cena.

```ts
const nft = engine.addEntity()

Transform.create(nft, {
	position: Vector3.create(8, 1, 8),
})

NftShape.create(nft, {
	urn: 'urn:decentraland:ethereum:erc721:0x06012c8cf97bead5deae237070f9587f8e7a266d:558536',
})
```

O componente `NftShape` deve ser instanciado com um parâmetro que inclua o seguinte:

* `urn` campo. Esse campo recebe uma string que deve seguir esta estrutura:

`urn:decentraland:<CHAIN>:<CONTRACT_STANDARD>:<CONTRACT_ADDRESS>:<TOKEN_ID>`

Esta string inclui:

* A *rede* na qual esse token existe. Veja abaixo a lista de valores compatíveis.
* O *padrão do contrato* no qual esse token se baseia, por exemplo, `erc721`
* O *contrato* do token (por exemplo, o contrato de CryptoKitties)
* O *ID* do token específico a ser exibido

Por exemplo:

`urn:decentraland:ethereum:erc721:0x06012c8cf97BEaD5deAe237070F9587f8E7A266d:558536`

O exemplo acima busca um NFT com o endereço do contrato `0x06012c8cf97BEaD5deAe237070F9587f8E7A266d`, e o identificador específico `558536`. O ativo correspondente pode ser encontrado na OpenSea em <https://opensea.io/assets/0x06012c8cf97BEaD5deAe237070F9587f8E7A266d/558536>.

São suportados os seguintes valores para *network*:

* `ethereum`: Ethereum Mainnet
* `matic`: Polygon Matic
* `klaytn`: Klaytn
* `bsc`: BNB Chain
* `arbitrum`: Arbitrum
* `arbitrum_nova`: Arbitrum Nova
* `avalanche`: Avalanche
* `optimism`: Optimism
* `solana`: Solana
* `base`: Base
* `blast`: Blast
* `zora`: Zora

{% hint style="warning" %}
**📔 Nota**: As imagens podem ter até **6 MB**. Se a imagem for maior, não será renderizada na scene.
{% endhint %}

## Personalizar a moldura

Por predefinição, a imagem terá um fundo roxo e uma moldura com uma textura emissiva pulsante. Pode definir as seguintes propriedades para combinar melhor com o estilo do NFT e da scene:

* `color`: Determina a parte de trás do modelo e também o fundo da imagem caso a imagem do NFT tenha transparência.
* `style`: Seleciona um modelo de moldura a partir de um enum com várias opções predefinidas. Use um valor do enum `NftFrameType`, que contém uma lista de todos os estilos disponíveis.

```ts
NftShape.create(nftEntity, {
  urn: 'urn:decentraland:ethereum:erc721:0x06012c8cf97bead5deae237070f9587f8e7a266d:558536',
  color: Color3.Green(),
  style: NftFrameType.NFT_GOLD_EDGES,
})
```

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

Segue-se a lista completa dos estilos de moldura suportados:

* `NFT_CLASSIC`
* `NFT_BAROQUE_ORNAMENT`
* `NFT_DIAMOND_ORNAMENT`
* `NFT_MINIMAL_WIDE`
* `NFT_MINIMAL_GREY`
* `NFT_BLOCKY`
* `NFT_GOLD_EDGES`
* `NFT_GOLD_CARVED`
* `NFT_GOLD_WIDE`
* `NFT_GOLD_ROUNDED`
* `NFT_METAL_MEDIUM`
* `NFT_METAL_WIDE`
* `NFT_METAL_SLIM`
* `NFT_METAL_ROUNDED`
* `NFT_PINS`
* `NFT_MINIMAL_BLACK`
* `NFT_MINIMAL_WHITE`
* `NFT_TAPE`
* `NFT_WOOD_SLIM`
* `NFT_WOOD_WIDE`
* `NFT_WOOD_TWIGS`
* `NFT_CANVAS`
* `NFT_NONE`

Algumas molduras usam mais materiais do que outras. Por exemplo, a moldura predefinida adiciona 1 material para o próprio NFT, 1 material para um plano de fundo colorido e 2 materiais para a moldura (partilhados com outras molduras de imagem do mesmo estilo). Se precisar de reduzir o número de materiais para [se manter dentro dos limites da cena](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md), escolha um estilo mais simples. Por exemplo, "none" usa apenas 1 material para o próprio NFT.

{% hint style="info" %}
**💡 Dica**: usando o Visual Studio Code (ou outro IDE), veja a lista completa escrevendo `NftFrameType.` e aguardando que as sugestões inteligentes apresentem a lista de opções. Use `NftFrameType.NFT_NONE`para apresentar o NFT tal como está, sem moldura nem cor de fundo.
{% endhint %}

## Abrir uma UI de NFT

Abra uma UI predefinida que apresenta o nome, o proprietário e a descrição de um NFT. Também inclui o preço atual do NFT e o preço da última venda, se aplicável, e um botão com uma ligação para a página do NFT na OpenSea, onde estão disponíveis mais informações e é possível comprá-lo.

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

Abra esta UI chamando a função `openNftDialog()`. Esta função requer um objeto como argumento que contenha um único campo `urn` . Este campo recebe uma string que deve seguir esta estrutura:

`urn:decentraland:<CHAIN>:<CONTRACT_STANDARD>:<CONTRACT_ADDRESS>:<TOKEN_ID>`

Por exemplo:

`urn:decentraland:ethereum:erc721:0x00...000:123`

{% hint style="warning" %}
**📔 Nota**: a UI tem de ser aberta em resultado de um evento de botão, para evitar spam abusivo. O evento de botão não tem necessariamente de ocorrer na mesma moldura de imagem nem num `NftShape`.
{% endhint %}

Para abrir esta UI em resultado de uma ação de clique, adicione o seguinte:

```ts
import { openNftDialog } from '~system/RestrictedActions'

// Adicionar um collider de ponteiro para permitir clicar
MeshCollider.setBox(myEntity, ColliderLayer.CL_POINTER)

// Adicionar um evento de callback onPointerDown.
pointerEventsSystem.onPointerDown(
	{
		entity: myEntity,
		opts: { button: InputAction.IA_PRIMARY, hoverText: 'Click' },
	},
	function () {
		openNftDialog({
			urn: 'urn:decentraland:ethereum:erc721:0x06012c8cf97BEaD5deAe237070F9587f8E7A266d:558536',
		})
	}
)
```


---

# 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/scenes-sdk7/media/display-a-certified-nft.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.
