Leer desde la Blockchain
Para leer datos desde la blockchain, utilice la implementación nativa de Unity del Sequence Indexer.
Leer desde la Blockchain
La lectura desde la blockchain se realiza usando la implementación nativa de Unity de nuestro Sequence Indexer.
Recomendamos crear una instancia de la clase ChainIndexer
. Esto le dará acceso a toda la funcionalidad que ofrece la interfaz IIndexer
.
Puede verificar si la API del indexador para su red está activa usando la tarea asíncrona Ping
. Esto puede ser útil si una solicitud está fallando. Durante el desarrollo, también puede revisar el estado de nuestros indexadores en nuestra página de estado.
Obtener Balance
Para consultar el balance de Ether (o la moneda de gas predeterminada de su red) de un usuario, utilice la tarea asíncrona GetEtherBalance
.
Obtener Balances de Tokens
Para obtener los balances de tokens de un usuario, debe usar la tarea asíncrona GetTokenBalances
.
Cuando se obtienen de esta manera, solo recibirá una instancia de token por cada smart contract. Obtener sin especificar la dirección es útil para determinar de qué contratos posee tokens su jugador y qué ERC20 tiene en su wallet.
Para obtener balances individuales de tokens ERC721 o ERC1155, debe especificar el contrato en su GetTokenBalancesArgs
.
Si el jugador tiene muchos tokenIds para un contrato dado (o posee tokens de muchos contratos), tendrá que manejar la paginación. En este caso, debe revisar el Page
que recibe en su GetTokenBalancesReturn
para ver si hay más y, si es así, hacer otra solicitud incluyendo el Page.
Para simplificar esta operación, hemos creado un wrapper GetTokenBalancesOrganizedInDictionary
. Esto obtendrá todos los TokenBalances para un contractAddress y userAccountAddress dados y los organizará en un Dictionary que mapea tokenID (BigInteger) a TokenBalance. En general, esta será la forma más común de uso.
Esto hará que consultar el balance respectivo de cada token id sea mucho más sencillo también.
Obtener Suministro de Tokens
Si necesita obtener el suministro total de tokens para un smart contract específico, puede usar la tarea asíncrona GetTokenSupplies
.
No esperamos que esta sea una operación muy común, pero está disponible por si la necesita.
Obtener Mapa de Suministros de Tokens
Para usuarios avanzados de GetTokenSupplies
, también ofrecemos la tarea asíncrona GetTokenSuppliesMap
que le permite obtener los suministros de múltiples contratos de tokens y token ids en un mapa.
Aquí, puede esperar que suppliesMap[usdcAddress].Length = 1
con el objeto TokenSupply relacionado al suministro del token ERC20.
De manera similar, puede esperar que suppliesMap[skyweaverAddress].Length = 3
con el objeto TokenSupply relacionado a los token ids especificados.
Obtener Historial de Transacciones
Para obtener el historial de transacciones de una cuenta, debe usar el método GetTransactionHistory
.
El objeto TransactionHistoryFilter
le permite especificar cómo desea filtrar su consulta de historial de transacciones, por ejemplo, por dirección(es) de cuenta, dirección(es) de contrato, etc. Más información aquí.