Ir diretamente para o conteúdo principal

Visão geral da API gRPC do Sui

Atualizado em
31 de março de 2026

Visão geral​

A API Sui gRPC proporciona acesso de alto desempenho a dados de rede através de interfaces gRPC. Constitui uma ferramenta poderosa para os programadores que precisam de:

  • Aceder a dados da blockchain com baixa latência
  • Monitorizar as atividades na cadeia de blocos e as alterações de estado
  • Consultar os estados das contas e dos objetos de forma eficiente
  • Executar transações com o mínimo de sobrecarga

Acesso​

Pode aceder ao Sui gRPC diretamente através do seu ponto de extremidade Quicknode Sui já existente — não são necessários complementos adicionais. Os serviços gRPC estão disponíveis na porta 9000, um canal dedicado e seguro para a comunicação gRPC.

Configuração do ponto final e do token​

Ao estabelecer ligação aos serviços gRPC do Sui, é necessário especificar a porta no URL:

  • Ponto final: O nome do seu ponto final, seguido de .sui-mainnet.quiknode.pro e o número da porta 9000 (por exemplo, https://docs-demo.sui-mainnet.quiknode.pro:9000)
  • Token: A sequência alfanumérica que se segue ao nome do ponto de extremidade no URL

Por exemplo, se o seu endpoint tiver o seguinte aspeto: https://docs-demo.sui-mainnet.quiknode.pro/123456789/, nesse caso, as suas credenciais de autenticação seriam:

  • Ponto final: https://docs-demo.sui-mainnet.quiknode.pro:9000
  • Token: 123456789

Disponibilidade da rede​

A API gRPC da Sui está disponível tanto na Mainnet como na Testnet.

Acesso aos dados arquivados​

As consultas ao arquivo de dados históricos da blockchain Sui estão disponíveis na Mainnet apenas através do gRPC. O acesso ao arquivo está integrado no seu ponto de extremidade gRPC existente:

  • Mesmo ponto de acesso: as consultas ao arquivo utilizam o mesmo ponto de acesso e a mesma porta (9000) que os pedidos gRPC normais — não é necessário um ponto de acesso separado
  • Encaminhamento automático: Os nós completos mantêm as últimas 14 épocas. As consultas relativas a dados com mais de 14 épocas são encaminhadas para os nós de arquivo
  • Não é necessária qualquer configuração: o acesso ao arquivo funciona sem qualquer configuração ou ajuste adicional
  • Apenas na Mainnet: o suporte ao arquivo não está disponível na Testnet

Nota: Isto difere da abordagem da Fundação Sui, que utiliza pontos de acesso separados para os dados de arquivo. Com o Quicknode, é possível consultar tanto dados recentes como históricos através de um único ponto de acesso.

Serviços oferecidos​

A API gRPC do Sui inclui os seguintes serviços:

Serviço de Registo​


  • BatchGetObjects: Recupera vários objetos numa única solicitação
  • BatchGetTransactions: Recupera várias transações numa única solicitação
  • GetCheckpoint: Recupera informações sobre o ponto de verificação
  • GetEpoch: Recupera informações sobre a época
  • GetObject: Recupera um único objeto
  • GetServiceInfo: Recupera informações sobre o serviço
  • GetTransaction: Recupera uma única transação

Serviço de Execução de Transações​


  • ExecuteTransaction: Executa uma transação na rede Sui

Serviço Público​


  • ListDynamicFields: Enumera os campos dinâmicos de um objeto
  • ListOwnedObjects: Enumera os objetos pertencentes a um endereço
  • GetCoinInfo: Recupera informações sobre a moeda
  • GetBalance: Obtém o saldo de um tipo específico de moeda
  • ListBalances: Apresenta todos os saldos de um endereço
  • SimulateTransaction: Simula a execução de uma transação

Serviço de Mudança de Pacotes​


  • GetPackage: Recupera informações sobre o pacote Move
  • GetDatatype: Recupera informações sobre o tipo de dados de um pacote
  • GetFunction: Recupera informações sobre uma função de um pacote
  • ListPackageVersions: Enumera as versões disponíveis de um pacote

Serviço de assinatura​


  • Subscrever pontos de verificação: Subscreve as atualizações dos pontos de verificação

Serviço de Verificação de Assinaturas​


  • VerifySignature: Verifica as assinaturas das transações

Limites e retenção de dados​

  • Paginação: As operações de lista e em lote devolvem resultados paginados. Verifique sempre o next_page_token campo nas respostas para recuperar páginas adicionais. Não se deve partir do princípio de que todos os dados são devolvidos numa única solicitação
  • Máscaras de campo: Utilize o read_mask campo, quando aplicável, para reduzir o tamanho da resposta e a latência, especialmente no caso de recursos de grande dimensão, como objetos e transações
  • Dados de arquivo: Os nós completos mantêm os dados das últimas 14 épocas. Na Mainnet, as consultas a dados com mais de 14 épocas são automaticamente encaminhadas para os nós de arquivo através do seu ponto de extremidade existente — não é necessária qualquer configuração adicional
  • Streaming: Utilizar Subscrever Checkpoints para dados em tempo real, em vez de sondagem. Se um fluxo for interrompido, retomar a partir do último ponto de verificação conhecido, utilizando outras APIs para preencher os dados em falta

Efetuar pedidos Sui gRPC​

Para efetuar pedidos ao Sui gRPC utilizando diferentes linguagens, consulte a documentação específica de cada método para cada serviço. Cada método inclui exemplos em:

Adoramos ❤️ os vossos comentários!​

Se tiver algum comentário ou dúvida sobre esta documentação, não hesite em contactar-nos. Adoraríamos saber a sua opinião!

Última atualização em
Partilhar este documento