VKX Technologies Docs

VKX Infrastructure

An 8-network wallet inside your product. Truly non-custodial: the key is born in your user's browser — neither you nor VKX touch the funds.

Empezar

npm install @vkx/waas

Create the project at /waas/painel and copy the three credentials.

En tu servidor

The credentials never reach the 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 });
});

En tu frontend

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

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

Seguridad

  • The seed is generated in the user's browser, encrypted with their password (Argon2id + AES-256-GCM). VKX stores only public addresses.
  • The embed session lasts minutes, is valid only for your domain, and the token travels in the URL fragment — it never shows in logs.
  • Your server credentials sign every request with anti-replay HMAC.

Ingresos

In the dashboard you set a markup from 0% to 0.70% on each swap by your users and register the wallets where you receive. VKX charges a flat 0.30% per swap.