@vkx/bridge
v0.1.0
Published
VKX Bridge API em uma função: move USDT entre redes com uma chamada.
Readme
VKX Bridge
Mova USDT entre redes com um comando. Sem integrar bridge, sem gerenciar gás em cada rede, sem infraestrutura própria.
Começar (2 minutos)
1. Solicite sua chave de acesso à equipe VKX.
2. Configure (uma vez só):
npx @vkx/bridge initCole a chave quando pedir. Pronto — tudo interligado.
3. Envie:
npx @vkx/bridge send --from POL --to BSC --amount 100 --dest 0xSeuEnderecoNaBSCO terminal acompanha a ordem até a entrega e mostra os comprovantes (hash do depósito e da entrega no destino).
Redes
| Origem | Destinos | |---|---| | Polygon (POL) — sem precisar de POL para gás ⛽ | BSC, Arbitrum, Avalanche, Optimism | | BSC | Polygon, Arbitrum, Avalanche, Optimism, Ethereum, Base |
Na Polygon o depósito é gasless: sua carteira só assina, a VKX transmite e paga o gás.
Comandos
npx @vkx/bridge init # configura chave e carteira (uma vez)
npx @vkx/bridge send --from POL --to BSC --amount 100 --dest 0x...
npx @vkx/bridge send ... --speed express # entrega em ~60s
npx @vkx/bridge status VKX-BRIDGE-... # consulta uma ordemSe algo falhar no caminho, o valor é devolvido automaticamente à carteira de origem.
Usar no seu código (opcional)
O mesmo motor do terminal, como biblioteca:
const { bridge } = require('@vkx/bridge');
const { ethers } = require('ethers');
const signer = new ethers.Wallet(process.env.WALLET_KEY,
new ethers.JsonRpcProvider('https://polygon-bor-rpc.publicnode.com'));
const r = await bridge({
apiKey: process.env.VKX_API_KEY,
signer,
from: 'POL', to: 'BSC',
amount: '100',
toAddress: '0x...',
});
console.log(r.success, r.destinationTxHash);Retries seguros: passe o mesmo idempotencyKey ao repetir uma chamada que estourou timeout — você recebe a mesma ordem de volta, nunca uma duplicata.
Segurança
- Sua chave privada nunca sai da sua máquina — fica em
~/.vkx/bridge.json(permissão 600) ou na variávelVKX_WALLET_KEY. - A chave de acesso VKX pode ser restrita a um endereço de destino fixo (allowlist) — peça à equipe ao solicitar.
Suporte
Fale direto com a equipe VKX citando o número da ordem (VKX-BRIDGE-...).
