Glossário

Reading time: 7 min

• The Graph: Um protocolo descentralizado para a indexação e consulta de dados.

• Query: Um pedido de dados. No caso do The Graph, um query é um pedido por dados de um subgraph que será respondido por um Indexador.

• GraphQL: Uma linguagem de query para APIs e tempo de execução para cumprir estes queries com os seus dados existentes. O TheGraph usa o GraphQL para consultar subgraphs.

• Endpoint (ponto final): Um URL para consultar um subgraph. O endpoint de testes para o Subgraph Studio é https://api.studio.thegraph.com/query/<ID>/<SUBGRAPH_NAME>/<VERSION> e o endpoint do Graph Explorer é https://gateway.thegraph.com/api/<API_KEY>/subgraphs/id/<SUBGRAPH_ID>. O endpoint do Graph Explorer é utilizado para consultar subgraphs na rede descentralizada do The Graph.

• Subgraph: Uma API aberta que extrai dados de uma blockchain, os processa e os armazena para que possem ser consultados com facilidade via GraphQL. Programadores podem construir e editar subgraphs à Graph Network. Depois, os Indexadores podem começar a indexar subgraphs para disponibilizá-los para queries por qualquer pessoa.

• Serviço hospedado: Um suporte temporário para construir e consultar subgraphs, enquanto a rede descentralizada do The Graph amadurece o seu custo e qualidade de serviço e experiência de programação.

• Indexadores: Participantes da rede que executam nodes de indexação para indexar dados de blockchains e servir consultas em GraphQL.

• Fontes de Renda de Indexadores: Os indexadores são recompensados em GRT com dois componentes: rebates de taxa de query e recompensas de indexação.

  1. Rebates de Taxa de Query: Pagamentos de consumidores de subgraph por servir queries na rede.

  2. Recompensas de Indexação: As recompensas que os Indexadores recebem por indexar subgraphs. Estas são geradas por novas emissões de 3% GRT ao ano.

• Auto-Stake (Stake Próprio) do Indexador: A quantia de GRT que os Indexadores usam para participar na rede descentralizada. A quantia mínima é 100.000 GRT, e não há limite máximo.

• Indexador de Atualizações: Um Indexador temporário feito para agir como uma reserva para queries de subgraphs não servidos por outros Indexadores na rede. Ele garante uma transição suave para subgraphs que atualizam do serviço hospedado à Graph Network. O Indexador de atualização não é competitivo com outros Indexadores. Ele apoia várias blockchains que antes estavam disponíveis apenas no serviço hospedado.

• Delegantes: Participantes na rede que são titulares de GRT, e delegam o seu GRT aos Indexadores. Isto permite aos Indexadores aumentar o seu stake nos subgraphs da rede. Em troca, os Delegantes recebem uma porção das Recompensas de Indexação que os Indexadores recebem por processar subgraphs.

• Taxa de Delegação: Uma taxa de 0.5% paga pelos Delegantes ao delegar GRT aos Indexadores. O GRT usado para pagar a taxa é queimado.

• Curadores: Participantes na rede que identificam subgraphs de alta qualidade, e os "curam" (por ex., sinalizam GRT neles) em troca de ações de curadoria. Quando Indexadores reivindicam taxas de query em um subgraph, 10% delas é distribuído aos Curadores daquele subgraph. Os Indexadores ganham recompensas de indexação proporcionais ao sinal em um subgraph. Perceba uma correlação entre a quantia de GRT sinalizada e o número de Indexadores que indexam um subgraph.

• Taxa de Curadoria: Uma taxa de 1% paga pelos Curadores quando sinalizam GRT em subgraphs. O GRT usado para pagar a taxa é queimado.

• Consumidor de Subgraph: Qualquer aplicativo ou utilizador que consulta um subgraph.

• Programador de Subgraph: Um programador que constrói e lança um subgraph à rede descentralizada do The Graph.

• Manifest de Subgraph: Um arquivo YAML que descreve o schema GraphQL, as fontes de dados, e outros metadados. Veja um exemplo.

• Epoch: Uma unidade de tempo na rede. Um epoch atualmente dura 6.646 blocos, ou cerca de um dia.

• Alocação: Um indexador pode alocar o seu stake total em GRT (incluindo o stake dos Delegantes) em subgraphs editados na rede descentralizada do The Graph. As alocações podem ter estados diferentes:

  1. Ativa: Uma alocação é considerada ativa quando é criada on-chain. Isto se chama abrir de uma alocação, e indica à rede que o Indexador está a indexar e servir consultas ativamente para um subgraph particular. Alocações ativas acumulam recompensas de indexação proporcionais ao sinal no subgraph, e à quantidade de GRT alocada.

  2. Fechada: Um Indexador pode resgatar as recompensas acumuladas em um subgraph selecionado ao enviar uma Prova de Indexação (POI) recente e válida. Isto se chama "fechar uma alocação". Uma alocação deve ter ficado aberta por, no mínimo, um epoch antes que possa ser fechada. O período máximo de alocação é de 28 epochs; se um indexador deixar uma alocação aberta por mais que isso, ela se torna uma alocação obsoleta. Quando uma alocação está Fechada, um Pescador ainda pode abrir uma disputa contra um Indexador por servir dados falsos.

• Subgraph Studio: um dApp poderoso para a construção, lançamento e edição de subgraphs.

• Pescadores: Um papel na Graph Network cumprido por participantes que monitoram a precisão e integridade dos dados servidos pelos Indexadores. Quando um Pescador identifica uma resposta de query ou uma POI que acreditam ser incorreta, ele pode iniciar uma disputa contra o Indexador. Se a disputa der um veredito a favor do Pescador, o Indexador é cortado, ou seja, perderá 2.5% do seu auto-stake de GRT. Desta quantidade, 50% é dado ao Pescador como recompensa pela sua vigilância, e os 50% restantes são retirados da circulação (queimados). Este mecanismo é desenhado para encorajar Pescadores a ajudar a manter a confiança na rede ao garantir que Indexadores sejam responsabilizados pelos dados que providenciam.

• Árbitros: Participantes da rede apontados por um processo de governança. O papel do Árbitro é decidir o resultado de disputas de indexação e consultas, e a sua meta é maximizar a utilidade e confiança da Graph Network.

• Corte: Os Indexadores podem tomar cortes em seu GRT em self-stake por fornecer uma prova de indexação (POI) incorreta ou servir dados imprecisos. A porcentagem de corte é um parâmetro do protocolo, atualmente configurado em 2.5% do auto-stake de um Indexador. 50% do GRT cortado vai ao Pescador que disputou os dados ou POI incorretos. Os outros 50% são queimados.

• Recompensas de Indexação: As recompensas que os Indexadores recebem por indexar subgraphs, distribuídas em GRT.

• Recompensas de Delegação: As recompensas que os Delegantes recebem por delegar GRT a Indexadores, distribuídas em GRT.

• GRT: O token de utilidade do The Graph, que oferece incentivos económicos a participantes da rede por contribuir.

• POI ou Prova de Indexação: Quando um Indexador fecha a sua alocação e quer reivindicar as suas recompensas de indexação acumuladas em um certo subgraph, ele deve providenciar uma Prova de Indexação (POI) válida e recente. Os Pescadores podem disputar a POI providenciada por um Indexador; disputas resolvidas a favor do Pescador causam um corte para o Indexador.

• Graph Node: O componente que indexa subgraphs e disponibiliza os dados resultantes abertos a queries através de uma API GraphQL. Assim ele é essencial ao stack de indexadores, e operações corretas de um Graph Node são cruciais para executar um indexador com êxito.

• Agente de Indexador: Parte do stack do indexador. Ele facilita as interações do Indexer on-chain, inclusive registos na rede, gestão de lançamentos de Subgraph ao(s) seu(s) Graph Node(s), e gestão de alocações.

• The Graph Client: Uma biblioteca para construir dApps baseados em GraphQL de maneira descentralizada.

• Graph Explorer: Um dApp desenhado para que participantes da rede explorem subgraphs e interajam com o protocolo.

• Graph CLI: Uma ferramenta de interface de comando de linha para construções e lançamentos no The Graph.

• Período de Tempo de Recarga: O tempo restante até que um Indexador que mudou os seus parâmetros de delegação possa fazê-lo novamente.

• Ferramentas de Transferência para L2: Contratos inteligentes e interfaces que permitem que os participantes na rede transfiram ativos relacionados à rede da mainnet da Ethereum ao Arbitrum One. Os participantes podem transferir GRT delegado, subgraphs, ações de curadoria, e o autostake do Indexador.

• Atualização de um subgraph à Graph Network: O processo de migrar um subgraph do serviço hospedado à Graph Network.

• Atualização de um subgraph: O processo de lançar uma nova versão de subgraph com atualizações ao manifest, schema e mapeamentos do subgraph.

• Migração: O processo de movimentar ações de curadoria da versão antiga de um subgraph a uma versão nova de um subgraph (por ex., quando a v.0.0.1 é atualizada à v.0.0.2).

• Janela de Atualização: O período para que utilizadores do serviço hospedado atualizem o(s) seu(s) subgraph(s) à Graph Network começa em 11 de abril e termina em 12 de junho de 2024.