Controle de Acesso por Papéis em Contratos Inteligentes
Ir para notas que citam estaControle de acesso por papéis em contratos inteligentes é a prática de amarrar cada função a um papel atribuído a endereços, para que a própria rede rejeite a chamada de quem não tem permissão. Ele responde a um problema de todo contrato inteligente: o contrato funciona como um cofre autônomo, sem chave física e sem intermediário, que precisa decidir sozinho quem pode abri-lo.
Não há senha guardada no contrato. Ele mantém uma lista de endereços autorizados e confere se o endereço que assina a chamada está nela, como um crachá conferido na portaria.
Papéis, listas de endereços e o modificador onlyRole
Um desenho típico tem três papéis: administrador, editor e visualizador. Cada papel é guardado como um hash de 32 bytes, e não como texto, porque ocupa menos espaço e sai mais barato; o administrador usa o identificador reservado conhecido como default admin role. Para cada papel o contrato mantém um array com os endereços que o possuem e uma estrutura auxiliar com a posição de cada membro nesse array, o que permite listar todos os endereços de um papel.
A verificação fica num modificador, onlyRole, aplicado às funções sensíveis. Antes de executar o corpo da função, ele checa se quem chamou tem o papel exigido e, se não tiver, reverte a transação com acesso negado. Repetir a checagem em cada função também funcionaria, mas gasta mais linhas e processamento.
O papel de visualizador é opcional. Deixar as funções de consulta sem modificador abre a verificação a qualquer pessoa, o que serve a quem quer auditoria pública. O padrão corporativo é o inverso: até a leitura exige permissão.
Por que a permissão precisa estar no contrato e não só na interface
Em um contrato, o padrão é permissivo: uma função sem restrição explícita pode ser chamada por qualquer pessoa, como uma API publicada sem autenticação. Esquecer o modificador em funções como sacar fundos ou desativar o contrato deixa-as abertas.
Esconder o botão no front-end, portanto, não protege nada: o contrato está publicado na rede e qualquer carteira pode chamá-lo diretamente, sem passar pela interface. A validação na aplicação pode melhorar a experiência, mas a barreira que vale é a do próprio contrato.
O código publicado não pode ser editado. Uma função crítica deixada sem restrição só se resolve substituindo o contrato por outro. Seguir padrões consolidados pela comunidade, como os do OpenZeppelin, e testar cada função com carteiras sem permissão antes de publicar reduz esse risco, tema de Segurança de Contratos Inteligentes.
Conceder e revogar papéis sem travar transações em lote
A função de conceder papel deve apenas checar se quem chama tem autoridade para conceder e então atribuir. Um require que recusa a concessão quando o destinatário já tem o papel cobra duas vezes: a mensagem de erro consome gas e, numa transação em lote que distribui o papel a várias contas, um único require que falhe reverte a operação inteira e ninguém recebe a permissão. Na revogação, um simples if que pula a execução quando a conta não tem o papel evita o erro sem reverter nada.
O papel que concede papéis merece cuidado próprio. Sem restrição adicional, o administrador pode entregar o papel de administrador a outra carteira. Transferir autoridade ou trocar o dono do contrato só é possível se a função para isso existir desde a criação; nada pode ser acrescentado depois da publicação.
Eventos de auditoria e o custo de guardar permissões
Emitir eventos quando um papel é concedido, quando é revogado e quando um registro é feito grava na cadeia um log que qualquer pessoa consulta depois num explorador de blocos. O evento custa gas extra, mas é o que torna auditável a história das permissões. Em redes públicas, cada papel guardado, concessão e evento entram na conta; em rede privada sem cobrança de gas isso perde urgência, sem deixar de ser boa prática. Testar com várias contas no Remix mostra o mecanismo inteiro: quem criou o contrato concede e remove papéis, e uma conta sem papel de administrador recebe acesso negado.