VKX Technologies Docs

VKX Infrastructure

Uma carteira de 8 redes dentro do seu produto. Não-custodial de verdade: a chave nasce no navegador do seu usuário — nem você nem a VKX tocam nos fundos.

Começar

npm install @vkx/waas

Crie o projeto em /waas/painel e copie as três credenciais.

No seu servidor

As credenciais nunca vão para o navegador.

const { createEmbedSession } = require('@vkx/waas/server');

app.post('/api/carteira', async (req, res) => {
  const session = await createEmbedSession({
    apiKey: process.env.VKX_API_KEY,
    hmacSecret: process.env.VKX_HMAC_SECRET,
    externalUserId: req.user.id,      // o id do usuário NO SEU sistema
    origin: 'https://seusite.com',
  });
  res.json({ embedUrl: session.embedUrl });
});

No seu frontend

import { mountWallet } from '@vkx/waas';

const { embedUrl } = await fetch('/api/carteira', { method: 'POST' }).then(r => r.json());
mountWallet('#carteira', { embedUrl });

Segurança

  • A seed é gerada no navegador do usuário, cifrada com a senha dele (Argon2id + AES-256-GCM). A VKX guarda apenas endereços públicos.
  • A sessão de embed dura minutos, vale só para o seu domínio e o token viaja no fragmento da URL — não aparece em logs.
  • Suas credenciais de servidor assinam cada pedido com HMAC anti-replay.

Receita

No painel você define um markup de 0% a 0,70% sobre cada swap dos seus usuários e cadastra as carteiras onde recebe. A VKX cobra 0,30% fixo por swap.