Hooks
useGetTokenMetadata
Hook para obtener metadatos específicos de tokens individuales dentro de un contrato
Importar
Uso
Tipo de retorno: UseQueryResult<TokenMetadata[]>
El hook retorna todas las propiedades de UseQueryResult
de React Query con los metadatos de los tokens. Esta es la estructura detallada:
Propiedades
data
TokenMetadata[] | undefined
Arreglo de objetos que contienen metadatos para cada token solicitado:
tokenId
: ID del token específicosource
: Fuente/origen de los metadatos del token (por ejemplo, “sequence”, “opensea”)name
: Nombre del token específico (por ejemplo, “Bored Ape #1234”)description
: Descripción del token específicoimage
: URL de la imagen del token (proxy automático a través del servicio de imágenes)video
: URL de video si el token tiene contenido en videoaudio
: URL de audio si el token tiene contenido en audioproperties
: Propiedades adicionales de metadatos como pares clave-valorattributes
: Arreglo de objetos de atributos para NFTsimage_data
: Datos SVG/imágenes en crudo si se proporcionanexternal_url
: URL externa asociada al tokenbackground_color
: Color de fondo en formato hexadecimalanimation_url
: URL para contenido animadodecimals
: Decimales del token (para tokens ERC1155 fungibles)updatedAt
: Marca de tiempo ISO de la última actualización de metadatosassets
: Arreglo de archivos de activos adicionalesstatus
: Estado actual de los metadatos (“READY”, “PENDING”, “ERROR”)queuedAt
: Marca de tiempo ISO cuando el indexado de metadatos fue puesto en colalastFetched
: Marca de tiempo ISO de la última obtención exitosa
isLoading
boolean
Estado de carga para la obtención de datos.
isError
boolean
Estado de error que indica si la consulta falló.
error
Error | null
Cualquier error que ocurrió durante la obtención de datos.
Parámetros
El hook acepta dos parámetros:
args: GetTokenMetadataArgs
Parámetro | Type | Description |
---|---|---|
chainID | string | ID de cadena como string (por ejemplo, “1” para Ethereum mainnet) |
contractAddress | string | Dirección del contrato del token/NFT |
tokenIDs | string[] | Arreglo de IDs de tokens para obtener metadatos |
options: HooksOptions
Parámetro | Type | Description |
---|---|---|
disabled | boolean | (Opcional) Deshabilitar la consulta para que no se ejecute automáticamente |
retry | boolean | (Opcional) Indica si se deben reintentar las consultas fallidas |