Saltar al contenido principal

multiGetObjects

Recupera detalles y metadatos en cadena de muchos objetos Sui en una sola solicitud por lotes mediante sus ID de objeto hexadecimales de 32 bytes.

Utiliza este método para combinar muchas consultas de objetos en una sola llamada de red. Este enfoque reduce la latencia en comparación con consultar objetos de forma individual. multiGetObjects lee directamente desde el estado local del nodo completo. Se ejecuta de inmediato sin una transacción ni gas.

  • Clase: SuiClient
  • Paquete: @mysten/sui/client
  • Tipo de operación: operación de lectura

Descripción general​

La llamada a multiGetObjects resulta mucho más eficiente que llamar a getObject en un bucle. Reduce la latencia de red al combinar muchas consultas de objetos en una única llamada a procedimiento remoto (RPC).

Comparación entre el modo secuencial y el modo por lotes
getObject secuencial (N idas y vueltas):
App ── getObject(A) ──► Fullnode ──► App ── getObject(B) ──► Fullnode

multiGetObjects por lotes (1 ida y vuelta):
App ──────────── multiGetObjects([A, B, C]) ────────────► Fullnode
App ◄─────────── [ResultA, ResultB, ResultC] ─────────── Fullnode

Firma​

Firma
client.multiGetObjects(input: MultiGetObjectsParams): Promise<SuiObjectResponse[]>

Parámetros​

El método acepta un objeto de configuración con las siguientes propiedades:

ParámetroTipoRequeridoDescripción
idsstring[]SíUn array de ID de objeto hexadecimales de 32 bytes.
optionsSuiObjectDataOptionsNoIndicadores de configuración para activar campos de datos específicos. Se aplica a todos los objetos solicitados.
nota

La mayoría de los nodos RPC públicos imponen un límite de, normalmente, 50 ID por solicitud. Para lotes más grandes, debes dividir tu array en fragmentos.


Valor de retorno​

Devuelve una Promise que se resuelve en un array de objetos SuiObjectResponse.

El orden del array se corresponde exactamente con el orden de los ID de objeto pasados en la solicitud:

Respuesta
[
{
"data": { "objectId": "0xA...", "version": "1" }
},
{
"error": { "code": "notExists", "object_id": "0xB..." }
},
{
"data": { "objectId": "0xC...", "version": "5" }
}
]

Ejemplos de uso​

Obtención masiva de metadatos de tokens no fungibles y atributos de visualización​

Consulta una lista de identificadores de tokens no fungibles (NFT). La solicitud muestra campos en la cadena y las URL de las imágenes:

bulkFetch.js
const objectIds = ['0x123...', '0x456...', '0x789...'];

const results = await client.multiGetObjects({
ids: objectIds,
options: {
showContent: true,
showDisplay: true
}
});

// Procesar los resultados
results.forEach((result) => {
if (result.data) {
console.log("Elemento encontrado:", result.data.display?.data?.name);
} else {
console.warn("No se pudo cargar el elemento:", result.error);
}
});

Fragmentar listas grandes de ID para límites de procesamiento por lotes​

Dado que en la mayoría de los nodos RPC públicos se aplica un límite de 50 elementos por solicitud, utiliza una función auxiliar de fragmentación para listas extensas:

chunking.js
import { chunk } from 'lodash'; // o tu propia función auxiliar

const allIds = [/* ... array de 200 IDs ... */];
const CHUNK_SIZE = 50;
const chunks = chunk(allIds, CHUNK_SIZE);

for (const batch of chunks) {
const batchResults = await client.multiGetObjects({
ids: batch,
options: { showType: true }
});
// Procesar batchResults...
}

Prácticas recomendadas​

Manejar fallos parciales por elemento​

A diferencia de una consulta de base de datos estándar que podría detener todo el lote en caso de error, multiGetObjects devuelve un resultado para cada ID. Aunque un objeto falle, por ejemplo, cuando una transacción lo elimina, el resto de elementos del lote se devuelven con éxito. Comprueba siempre data frente a error para cada elemento del array devuelto.

Confiar en la preservación del orden de índices​

El SDK preserva el orden de índices del array de entrada:

  • results[0] se corresponde con ids[0]
  • results[1] se corresponde con ids[1]

Puedes confiar en este orden para mapear los resultados directamente a tu fuente de datos original.


Ver también​