Pular para o conteúdo
LabS Atlas
Digital Assets
Entrar

Controle de Acesso por Papéis em Contratos Inteligentes

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Controle 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.

Erro de permissão é permanente

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.