@vkx/waas
v0.1.1
Published
Carteira cripto de 8 redes embutida no seu site com uma linha. Não-custodial, hospedada pela VKX.
Maintainers
Readme
VKX WaaS — carteira embutida
Coloque uma carteira cripto de 8 redes (BSC, ETH, Base, Arbitrum, Polygon, BTC, TRON, Solana) dentro do seu site. Não-custodial: a chave nasce no navegador do seu usuário — nem você nem a VKX tocam nos fundos.
Começar
1. Crie seu projeto em vkxtech.com.br/waas (login com Google) e copie as 3 credenciais.
2. Instale:
npm install @vkx/waas3. No seu servidor (as credenciais nunca vão pro browser):
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 });
});4. No seu frontend:
import { mountWallet } from '@vkx/waas';
const { embedUrl } = await fetch('/api/carteira', { method: 'POST' }).then(r => r.json());
mountWallet('#carteira', { embedUrl });Pronto — seu usuário cria a carteira, vê saldos e recebe cripto sem sair do seu site.
Como funciona a 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 (a wallet se recusa a renderizar em qualquer outro) 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 para você
No painel (vkxtech.com.br/waas) 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.
Suporte
Fale com a equipe VKX citando o id do seu projeto (prj_...).
