OnchainSuite: arquitetura, produto e metade da conta
Software de retenção e CRM para times de blockchain: veja quais carteiras estão prestes a sair e reconquiste-as por e-mail e mensagem no app.
- Função
- Engenheiro de software
- Período
- out. de 2025 a hoje
- Stack
- NestJS, Next.js, Postgres, Redis, Docker, Coolify, DigitalOcean
- Problema
- Times Web3 têm dados on-chain, mas nenhuma forma de agir sobre eles, e a plataforma precisava crescer sem que os custos crescessem junto.
- O que eu fiz
- Ajudei a definir a arquitetura e a base do backend, sou responsável pelo app web, das decisões de design à UX, junto com o product owner, migrei a produção para uma VM self-hosted que escala verticalmente e reviso todo pull request antes de ir para produção.
- Resultado
- Custos de hospedagem 58% menores. Cerca de 10 organizações usam a plataforma, e parceiros como Surgence Labs e Vault777 a operam para os próprios clientes.

O sistema
Times Web3 têm dados on-chain ricos e quase nenhuma forma de agir sobre eles. O OnchainSuite junta atividade de carteiras, eventos de contratos e saldos com mensagens de ciclo de vida, para que um time de growth segmente pelo que os usuários realmente fazem on-chain, dispare campanhas e automações e meça o resultado. São três produtos em um só workspace: R3tain para e-mails de retenção e automações, Onch3n para analytics e inteligência on-chain, e 3ridge para autenticação por carteira e identidade. Alguns dos maiores usuários também são parceiros: Surgence Labs e Vault777 rodam campanhas por ele para os próprios clientes.
Entrei em outubro de 2025 e desde então trabalho na stack inteira: a arquitetura e a base do backend da plataforma, o produto web, a infraestrutura em que ele roda e quanto ela custa, e o fluxo de review e release.
Engenheiro de software desde outubro de 2025. Ajudei a definir a arquitetura da plataforma e criei a base do backend. Comecei o app web e construí boa parte do produto de 2026 sobre ele: campanhas, automações, audiências, os editores de e-mail e de formulários, inteligência, configurações e o blog. Cortei a conta de hospedagem em 58% com uma VM self-hosted pensada para escalar verticalmente, troquei fornecedores caros por mais baratos e reviso os pull requests do time antes de irem para produção. Colegas escreveram a maior parte da ingestão de dados da blockchain e da camada de IA.
- de corte na hospedagem
- 58%
- organizações usando
- 10
- fornecedores caros substituídos
- 4
A plataforma em um relance. Passe o mouse ou toque em um nó.
Uma arquitetura que começa em uma máquina só
Dockerfile + main.ts (simplified)
ENV PROCESS_ROLE=all # web | worker | allCMD node --max-old-space-size=$NODE_HEAP_MB dist/main.js if (role !== "worker") await app.listen(port);if (role !== "web") startWorkers(env.QUEUE_PROCESSOR_GROUPS);
Uma imagem Docker pode subir como web, worker ou ambos.
Criei a base do backend como um monólito modular em NestJS: módulos de fila, cache, throttling, logging estruturado e health check, um bootstrap reforçado (headers de segurança, compressão, limites de body, validação e tratamento de erros globais) e o plano de estrutura de código que mantém as funcionalidades em módulos e a infraestrutura compartilhada em um só lugar, cada módulo com seu próprio README e contrato de API.
O formato do deploy vem daí. Uma única imagem Docker sobe como API, como worker ou como ambos, escolhido por uma variável de ambiente. Isso permite que a plataforma inteira rode em uma única máquina bem dimensionada e cresça verticalmente, com uma máquina maior, um heap maior no Node e mais grupos de processadores de fila, antes que qualquer coisa precise ser distribuída. Quando o worker precisar da própria máquina, ele muda sem nenhuma alteração de código.
PROCESS_ROLE, NODE_HEAP_MB e QUEUE_PROCESSOR_GROUPS no Dockerfile e no bootstrap, e um plano de estrutura de código documentado.
Menos da metade da conta de hospedagem
Antes: hospedagem gerenciada, Postgres gerenciado e um WAF pago.
A produção rodava em serviços gerenciados: Render para o app, Neon para o Postgres e AWS para o WAF e o e-mail. Migrei tudo para uma VM self-hosted na DigitalOcean rodando Coolify, com Postgres, pgvector e Redis na mesma máquina e o proxy da Cloudflare fazendo o papel do WAF de graça. A hospedagem agora custa 58% menos, com espaço para escalar antes de custar mais.
Migrar a produção com segurança exigiu um runbook, que escrevi para que qualquer pessoa do time pudesse executá-lo. Primeiro o TTL do DNS é reduzido, os jobs na fila são drenados e o worker para antes do serviço web, para que nenhum job grave em um banco que está sendo copiado. Depois vêm dump, restore, verificação, baseline das migrations, deploy e checagem de health e webhooks antes de o DNS mudar, com o host antigo em standby para rollback.
Um runbook de migração documentado e um modelo de custos de hospedagem.
Dados e envios mais baratos
Os maiores custos variáveis eram fornecedores, então os troquei por caminhos mais baratos. A atividade on-chain saiu do streaming da GoldRush para webhooks da Alchemy e nosso próprio indexador, eliminando um custo de streaming que crescia a cada novo cliente. O e-mail foi consolidado em SendGrid e SES, aposentando o Azure Communication Services.
Cada mudança manteve o comportamento do produto igual: os mesmos eventos chegam às automações, as mesmas campanhas são enviadas. Só a conta mudou.
Toda a superfície do produto
Um visitante se cadastra com e-mail ou uma conta social.
Comecei o app web desde o primeiro commit: cadastro e onboarding em várias etapas, o shell do dashboard com rotas protegidas e as primeiras interfaces do R3tain, do 3ridge e do Onch3n. Ao longo de 2026 construí uma boa parte do produto sobre ele: campanhas, uma reformulação completa das automações, audiências com supressões e sincronização ao vivo, as telas de inteligência, um editor de e-mail com um modelo de documento de blocos e estilos, um editor de formulários com páginas hospedadas centradas na carteira, configurações, passkeys e autenticação em dois fatores, convites de equipe, onboarding que pode ser retomado, telas de cobrança e as ferramentas gratuitas do site institucional.
Sou responsável pelo app web no dia a dia, o que inclui as decisões de design e de UX, tomadas com o product owner, tanto quanto o código. O resto desta página se aprofunda nas partes com a engenharia mais interessante por trás.
O histórico do app web desde o primeiro commit, de outubro de 2025 a outubro de 2026.
Entregando o trabalho de um time agitado
Os colegas abrem pull requests para dev.
Um time pequeno que anda rápido gera muitos pull requests. Reviso cada um antes do merge, tanto na API quanto no app web. O trabalho mergeado vai para dev e depois é promovido em lotes para staging e então para produção.
Pouquíssimos merges precisam de conflitos resolvidos à mão, porque as branches são mantidas pequenas e atualizadas.
Publicar sem deploy
posts.hooks.ts (simplified)
beforeChange: ({ data, req }) => { if (data._status === "published" && !isAdmin(req.user)) throw new Forbidden("Editors can only save drafts");},afterChange: ({ doc }) => { revalidateTag("posts"); revalidatePath(`/blog/${doc.slug}`);},
Um editor escreve um post. Editores podem salvar rascunhos.
Os textos de marketing ficavam dentro dos componentes, então cada mudança de texto exigia um pull request e um deploy. Adicionei um Payload CMS dentro do app Next.js, com sua API montada longe do /api/v1 da plataforma, para que as duas nunca colidam.
Não existe um segundo login: uma estratégia de autenticação customizada repassa a sessão do OnchainSuite do visitante para o backend e só admite papéis de admin, espelhados como usuários somente leitura sem colunas de senha. Editores podem criar rascunhos, mas não publicar, e isso é garantido por um hook, não por um botão escondido. Publicar revalida a página estática no próprio processo, então um post fica no ar em cerca de um segundo. As mídias são organizadas por post percorrendo a árvore de rich text, e apagar um post só remove imagens que nada mais usa.
Decisões que valem a pena defender
Escalar verticalmente antes de horizontalmente
Uma máquina bem dimensionada é mais barata e mais simples de operar do que uma frota de que a carga ainda não precisa. O código está pronto para ser separado quando precisar.
Uma imagem, três papéis de processo
Web e worker sempre rodam o mesmo código e as mesmas migrations, e podem dividir uma máquina ou se separar com uma única variável de ambiente.
Parar o worker antes do serviço web
Um job rodando no meio do dump grava no banco antigo depois do snapshot. Parar os workers primeiro mantém a cópia consistente.
Pagar por capacidade, não por conveniência
Hospedagem gerenciada, um WAF pago e créditos de streaming eram custos de conveniência. Alternativas mais baratas fizeram o mesmo trabalho.
Nas palavras deles
Mujeeb was there from day one at OnchainSuite. He wrote the first lines of both our dashboard and our backend. When we needed to move production from Render to DigitalOcean and Coolify, he spent his weekends on the Docker setup and wrote the cutover runbook we followed to switch over. I’d recommend him to any team that needs a full-stack engineer who can also be trusted with their infrastructure.
Obafemi Joshua