Cómo agregar una cartera cripto a tu app o sitio (WaaS)

Tu producto necesita una cartera. Tienes dos opciones

Si tu app necesita que el usuario reciba, envíe o intercambie cripto, hay un componente inevitable: una cartera. Y ahí llega la decisión que define todo lo demás: construir la infraestructura de claves o usar Wallet as a Service.

La elección no es sobre esfuerzo de desarrollo. Es sobre qué tipo de responsabilidad quieres asumir — y, sobre todo, qué quieres que exista en tu base de datos.

Qué significa construir desde cero

Generar un par de claves es trivial: unas pocas líneas con una biblioteca conocida. El problema empieza después.

Una cartera de verdad exige resolver, en orden:

• Generación segura. La aleatoriedad débil produce claves predecibles. El estándar de frase de recuperación es BIP-39, y la derivación jerárquica de direcciones es BIP-32 — no es algo para improvisar.
• Almacenamiento. ¿Dónde vive la clave? En tu servidor, y eres custodio, con todas las consecuencias regulatorias y de riesgo. En el dispositivo, y necesitas un camino de recuperación que no sea "la perdiste, mala suerte".
• Firma. Cada red tiene su formato. La firma de datos estructurados sigue EIP-712, y mostrarle al usuario qué está firmando es requisito de seguridad, no adorno.
• Múltiples redes. Cada red nueva es un conjunto nuevo de formatos, nodos de acceso y casos de error.
• Recuperación. La parte que más soporte genera y menos aparece en las demos.

Ninguno de estos puntos es opcional, y ninguno es tu producto.

Qué cambia con WaaS

Wallet as a Service saca esa capa de tu alcance. VKX WaaS integra una cartera no custodial de 8 redes en tu app, con la infraestructura alojada.

npm install @vkx/waas

El diseño tiene dos mitades:

• En el cliente, inicializas con la clave pública del proyecto. El usuario obtiene una cartera generada con seguridad y puede recibir, enviar e intercambiar dentro de tu producto.
• En el servidor, las operaciones que exigen la clave secreta quedan aisladas de la app — donde corresponde una credencial secreta.

La parte que más importa: la clave del usuario no queda contigo. No está en tu base, no se filtra en un incidente tuyo, y no te convierte en custodio. Eso deja de ser un riesgo que administras y pasa a ser una propiedad de la arquitectura.

No custodial no significa sin responsabilidad

Conviene ser preciso, porque es la confusión más común. La autocustodia no elimina el riesgo — transfiere la responsabilidad de la clave al usuario. Qué cambia para ti:

• No puedes mover fondos del usuario. Es protección, y también limitación: no existe "contracargo" en el sentido tradicional.
• Sigues siendo responsable de la experiencia — dejar claro qué es la frase de recuperación, qué pasa si se pierde, y qué hace y qué no hace tu aplicación.
• Sigues siendo responsable de nunca pedir la clave del usuario bajo ninguna circunstancia. Toda estafa de soporte falso explota justamente eso.

Cuándo WaaS es la elección correcta

Tiene sentido cuando:

• La cartera es medio, no fin. Tu producto es un juego, un marketplace, una fintech, un programa de fidelidad. La cartera habilita, pero no es la propuesta.
• No quieres ser custodio. Decidir no guardar la clave de un tercero es estratégico antes que técnico.
• Necesitas varias redes. El costo de soporte multired crece por red, no una sola vez.
• El time to market importa. Integrar toma horas; construir y mantener toma trimestres.

No tiene sentido cuando la cartera es tu producto — ahí tercerizar el núcleo no se sostiene — o cuando un requisito regulatorio específico exige un diseño de custodia propio.

Qué viene listo

• 8 redes soportadas de fábrica.
• Recibir, enviar e intercambiar dentro de tu producto, sin sacar al usuario afuera.
• Infraestructura alojada: nodos de acceso, formatos de firma y casos de error dejan de ser tu problema.

Si tu caso también involucra usuarios sin moneda nativa para pagar comisiones — común cuando la cartera es nueva —, el patrocinio de gas resuelve el paso siguiente.

Preguntas frecuentes

¿La clave del usuario pasa por mi servidor? No. La cartera es no custodial: la clave no queda contigo ni existe en tu base de datos.

¿Esto me convierte en custodio? No. No tienes forma de mover fondos del usuario — protección y limitación al mismo tiempo.

¿Cuántas redes soporta? Ocho de fábrica, con recibir, enviar e intercambiar.

¿Necesito servidor propio? Sí, para las operaciones que usan la clave secreta del proyecto. Las credenciales secretas no van en la app.

¿Y si el usuario pierde la frase de recuperación? En autocustodia, la recuperación depende de ella. Explicarlo con claridad en tu producto es parte de la responsabilidad que queda contigo.

¿Puedo usar solo el swap? Las operaciones son independientes; la página del producto tiene el alcance de cada una.

Siguiente paso

Si estás decidiendo entre construir e integrar, la prueba útil es preguntar qué seguirá manteniendo tu equipo en dos años. Los detalles de integración están en la página de WaaS y en la documentación.

Aviso: este contenido tiene carácter informativo y educativo y no constituye recomendación de inversión.