Cookbook > Gerador de Código Seguro para Subgraphs

Gerador de Código Seguro para Subgraphs

Reading time: 2 min

O Subgraph Uncrashable é uma ferramenta geradora de código, que gera um conjunto de funções de helper a partir do schema GraphQL de um projeto. Ela garante total segurança e consistência em todas as interações com entidades no seu subgraph.

Por que integrar com a Subgraph Uncrashable?

Link para esta seção
  • Atividade Contínua. Entidades mal-cuidadas podem causar panes em subgraphs, o que pode ser perturbador para projetos dependentes no The Graph. Prepare funções de helper para deixar os seus subgraphs "incrasháveis" e garantir a continuidade dos negócios.

  • Totalmente Seguro. Alguns dos problemas comuns vistos no desenvolvimento de subgraphs são problemas de carregamento de entidades não definidas; o não-preparo ou inicialização de todos os valores de entidades; e condições de corrida sobre carregamento e salvamento de entidades. Garanta que todas as interações com entidades sejam completamente atômicas.

  • Configurável pelo Usuário. Determine valores padrões e configure o nível de checagens de segurança necessário para o seu projeto individual. São gravados logs de aviso, que indicam onde há uma brecha de lógica no subgraph para ajudar a solucionar o problema e garantir a precisão dos dados.

Características Importantes

  • A ferramenta de geração de código acomoda todos os tipos de subgraph e pode ser configurada para que os utilizadores coloquem padrões razoáveis nos valores. A geração de código usará esta configuração para gerar funções de helper que combinem com a especificação do utilizador.

  • A estrutura também inclui uma maneira (através do arquivo de configuração) de criar funções personalizadas, mas seguras, para configurar grupos de variáveis de entidade. Desta maneira, é impossível que o utilizador carregue/use uma entidade de graph obsoleta, e também é impossível esquecer de salvar ou determinar uma variável exigida pela função.

  • Logs de aviso são gravados como logs que indicam onde há uma brecha na lógica do subgraph para ajudar a solucionar o problema e garantir a precisão dos dados. Estes logs podem ser visualizados no serviço hospedado do The Graph, na seção 'Logs'.

A Subgraph Uncrashable pode ser executada como flag opcional usando o comando codegen no Graph CLI.

graph codegen -u [options] [<subgraph-manifest>]

Visite a documentação da Subgraph Uncrashable ou assista este tutorial em vídeo para aprender mais e começar a desenvolver subgraphs mais seguros.

Editar página

Anterior
Como Substituir um Contrato e Manter a sua História com Enxertos
Próximo
Subgraphs movidos por substreams
Editar página