> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levery.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeiros Passos

> Explore nossos guias para implementar, configurar e operar Levery com segurança.

<Frame>
  <img style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/levery/6C5ksHgEFzZe_XUM/images/levery-home-dark.jpg?fit=max&auto=format&n=6C5ksHgEFzZe_XUM&q=85&s=6a6071c5f46f19c3bd3359f478b15f0c" alt="Dashboard da Conta Levery" className="block dark:hidden" width="2880" height="1800" data-path="images/levery-home-dark.jpg" />

  <img style={{ borderRadius: "0.5rem" }} src="https://mintcdn.com/levery/6C5ksHgEFzZe_XUM/images/levery-home-dark.jpg?fit=max&auto=format&n=6C5ksHgEFzZe_XUM&q=85&s=6a6071c5f46f19c3bd3359f478b15f0c" alt="Dashboard da Conta Levery" className="hidden dark:block" width="2880" height="1800" data-path="images/levery-home-dark.jpg" />
</Frame>

# Introdução

Levery é uma **stack white-label de exchange DeFi com foco em conformidade (compliance-first)**, projetada para instituições
reguladas que desejam oferecer mercados on-chain sem precisar reconstruir do zero a infraestrutura central de negociação,
os controles de acesso e as salvaguardas operacionais.

***

## Capacidades centrais de Levery

Levery reúne tudo o que um Provedor de Serviços de Ativos Virtuais (VASP) regulado precisa para operar uma plataforma DeFi com sua própria marca.

A infraestrutura oferece um ambiente completo, sob a marca e as políticas da instituição, incorporando os controles e interfaces necessários para as equipes de risco, compliance, tesouraria e operações.

<CardGroup cols={2}>
  <Card title="Plataforma White-Label" icon="store">
    Clientes autorizados interagem por meio de uma interface customizada com a marca da instituição, com negociação e portfólio integrados.
  </Card>

  <Card title="Console Administrativo" icon="shield-halved">
    Pelo console administra-se KYC/KYB, admissão de carteiras, políticas de ativos, monitoramento em tempo real e
    permissões de usuários.
  </Card>

  <Card title="Criação de Pool de Liquidez" icon="droplet">
    Por meio do console, a instituição configura e lança pools e pode alocar liquidez própria de forma segregada.
  </Card>

  <Card title="Controle de Acesso" icon="user-check">
    Os clientes devem concluir KYC/KYB para ingressar. Após a aprovação, as carteiras designadas são admitidas e
    vinculadas à entidade legal.
  </Card>

  <Card title="Checagens Prévias" icon="gavel">
    Antes de operações de swap ou de liquidez, as políticas são validadas pelos smart contracts, para uma aplicação
    consistente e auditável.
  </Card>

  <Card title="Registros Pós-Negociação" icon="receipt">
    Cada ação emite eventos padronizados e com registro temporal, que alimentam os extratos dos clientes e os painéis dos
    operadores.
  </Card>

  <Card title="Integração via API" icon="code">
    APIs seguras e documentadas para integração com sistemas bancários, mecanismos de compliance, relatórios e portais de
    clientes.
  </Card>

  <Card title="Dashboard de Monitoramento" icon="chart-line">
    Painel de monitoramento e auditoria dá às equipes de operações, compliance e risco visibilidade em tempo real sobre as atividades da plataforma.
  </Card>
</CardGroup>

<Note>
  Esta documentação explica **como Levery funciona** e **como integrá-lo e operá-lo**. Não é um aconselhamento jurídico.
  Sempre valide os requisitos com suas equipes de compliance e jurídico para a sua jurisdição.
</Note>

***

## Princípios de design

Levery é projetada em torno de um conjunto de princípios arquiteturais que mantêm políticas, controles de risco e
responsabilidades operacionais explícitos, aplicáveis e auditáveis em cada mercado e para cada participante.

<CardGroup cols={1}>
  <Card title="Motor de AMM Permissionado" icon="shield-check">
    Antes de qualquer mudança de estado, Levery executa verificações on-chain de admissão e risco. Chamadas não
    conformes são revertidas de forma determinística; ações conformes são executadas normalmente, garantindo que apenas
    contas autorizadas possam negociar nos pools e gerir liquidez.
  </Card>

  <Card title="Execução On-chain Auditável" icon="file-lock">
    Sem a custódia de terceiros ou intermediação, os ativos são controlados por smart contracts. Após o deploy, código e
    estado tornam-se imutáveis, a execução é determinística e cada transição fica registrada no ledger, formando uma
    trilha auditável com capacidade de evidenciar violação e garantir integridade.
  </Card>

  <Card title="Taxas Dinâmicas Guiadas por Oráculo" icon="chart-line">
    Levery integra oráculos de preços de mercado para precificação justa e taxas dinâmicas. Conforme a divergência entre
    oráculo e pool, as taxas são ajustadas em tempo real para ancorar a execução a uma referência externa, equilibrando
    competitividade de preços e proteção aos provedores de liquidez.
  </Card>

  <Card title="Posições Intransferíveis" icon="fingerprint">
    As posições de liquidez são tokenizadas como ERC-721 não transferíveis, vinculando cada posição ao seu proprietário
    verificado. Esse design assegura o KYC/KYB em todo o ciclo de vida do provedor de liquidez (LP), impede transferências
    não autorizadas e simplifica os relatórios de conformidade.
  </Card>

  <Card title="Controles Administrativos" icon="sliders">
    Funções de administração on-chain permitem às instituições atualizar administradores, ajustar taxas globalmente ou por
    pool, revisar fontes de oráculos e redefinir permissões quando requerido por procedimentos.
  </Card>

  <Card title="Taxa de Serviço Configurável" icon="users-gear">
    A taxa de serviço é direcionada a um cofre seguro, viabilizando tesouraria transparente e partilha de receitas. A
    apropriação e a distribuição são executadas on-chain, assegurando rastreabilidade e clareza contábil.
  </Card>
</CardGroup>

O resultado é uma experiência semelhante a uma DEX, mas operável com o rigor exigido em serviços financeiros: mercados
on-chain com regras explícitas, controles verificáveis e evidências nativas para conciliação, auditoria e supervisão
contínua, sem depender de confiança em intermediários ou processos manuais off-chain.

***

## Conceitos-chave que você verá em todo lugar

Esses conceitos são a “linguagem” de Levery. Ficar confortável com eles desde o início torna o restante da documentação
muito mais fácil.

| **Concept**              | **Definition**                                                                                                                      |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| **Accounts / Contas**    | Wallets vinculadas a um usuário ou entidade, usadas para trading e ações de liquidity.                                              |
| **Policies / Políticas** | Regras que governam quais ações são permitidas (trade, provide liquidity, access pools) com base em identidade e contexto.          |
| **Assets / Ativos**      | Instrumentos negociáveis com metadata (decimals, symbols), fontes de preço e flags de risco.                                        |
| **Pools / Mercados**     | Mercados que definem o par de trading, comportamento de fee e limites de política.                                                  |
| **Positions / Posições** | Posições de liquidez com propriedade definida, eventos de lifecycle e resultados auditáveis.                                        |
| **LP fees**              | Taxas pagas por traders a um pool e acumuladas para provedores de liquidez (LP) sob regras de fee específicas do mercado.           |
| **Taxas de serviço**     | Taxas do protocolo/operador cobradas conforme configuração, com accounting rastreável.                                              |
| **Oráculos**             | Feeds on-chain opcionais (preço de mercado) usados para informar a lógica de fees e controles de risco dependendo do setup do pool. |

<Tip>Para uma lista completa de definições, veja **[Glossário](/pt/glossary).**</Tip>

***

## Auditoria de segurança

A suite de smart contracts de Levery é auditada pela Runtime Verification, empresa de auditoria de segurança sediada em
Chicago reconhecida globalmente por mais de uma centena de publicações e ferramentas que moldaram o campo. Ativa em
segurança blockchain desde 2017, a equipe já atendeu protocolos high-TVL incluindo Ethereum, Uniswap, Lido, Maker e
Optimism.

A missão foi ir além da revisão do código e estabelecer se propriedades críticas se mantêm em todas as execuções
admissíveis, usando técnicas com base matemática além da análise convencional.

<Tip>
  Para uma visão mais profunda do modelo de segurança, controles e assurance posture de Levery, veja
  **[Segurança](/pt/security).**
</Tip>

***

## Próximos passos

Escolha seu caminho com base no seu papel e no que você precisa a seguir:

<CardGroup cols={3}>
  <Card title="O que é Levery" icon="layer-group" href="/pt/what-is-levery">
    Visão geral do produto, principais diferenciais e stack institucional de digital assets.
  </Card>

  <Card title="Arquitetura" icon="diagram-project" href="/pt/architecture">
    Uma visão técnica dos componentes on-chain e do fluxo end-to-end.
  </Card>

  <Card title="Segurança" icon="shield-check" href="/pt/security">
    Revise a postura de segurança de Levery e o relatório de auditoria dos smart contracts.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Deployments Institucionais" icon="server" href="/pt/institutional-deployments">
    Opções de deployment single-tenant para instituições reguladas com trust boundaries e governance fortes.
  </Card>

  <Card title="Guia do Usuário" icon="book-user" href="/end-user/onboarding">
    Como os clientes fazem onboarding, conectam carteiras, fazem trade, investem e gerenciam ativos e posições.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Perguntas Frequentes" icon="circle-question" href="/pt/end-user/common-questions">
    FAQ operacional para usuários finais do venue da instituição.
  </Card>

  <Card title="Glossário" icon="spell-check" href="/pt/glossary">
    Conceitos e terminologia centrais usados em toda a plataforma.
  </Card>
</CardGroup>
