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).
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
client.multiGetObjects(input: MultiGetObjectsParams): Promise<SuiObjectResponse[]>
Parámetros
El método acepta un objeto de configuración con las siguientes propiedades:
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
ids | string[] | Sí | Un array de ID de objeto hexadecimales de 32 bytes. |
options | SuiObjectDataOptions | No | Indicadores de configuración para activar campos de datos específicos. Se aplica a todos los objetos solicitados. |
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:
[
{
"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:
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:
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 conids[0]results[1]se corresponde conids[1]
Puedes confiar en este orden para mapear los resultados directamente a tu fuente de datos original.
Ver también
getObject: recuperar detalles de un objeto individual en la cadena.getOwnedObjects: listar todos los objetos que pertenecen a una dirección específica.- Cómo obtener datos de objetos: tutorial paso a paso que utiliza operaciones de lectura en un script de Node.js.
- La arquitectura de SuiClient: descripción conceptual de
SuiClienty las operaciones de lectura.