Koberlet · móvil

Monedero no custodial multi-cadena (Kadena + EVM) para Android y iPhone. Las claves privadas se generan y se guardan en el teléfono; no hay servidor de Koberlet que las vea, ni cuenta que abrir, ni nada que registrar.

Es la misma app que Koberlet de escritorio, con el mismo formato de bóveda: una copia de seguridad hecha en el ordenador se restaura en el móvil y al revés.

Por qué este repositorio está abierto

Un monedero le pide a alguien que meta dentro la frase que da acceso a su dinero. Pedir eso y no dejar mirar el código es pedir un acto de fe. Aquí está todo lo que se ejecuta en el teléfono: cómo se deriva la semilla, cómo se cifra la bóveda, qué se firma y qué se envía por la red. Cualquiera puede comprobar que la frase no sale de ahí.

Lo que se publica es el código, no la infraestructura. En DNNS.es lo normal es lo contrario —los repositorios son privados—, y los dos monederos son la excepción, a propósito.

Lo que NO está aquí, y no va a estar

• La clave que firma los APK (koberlet-release.jks) ni su contraseña.
• Los certificados de Apple ni la clave de App Store Connect.
• La cuenta de servicio de Google Play.
• La clave que firma las actualizaciones del escritorio.
• Datos de ninguna cartera: ni bóvedas, ni direcciones, ni saldos.

Todo eso vive fuera del repositorio (ver .gitignore) y existe en un solo sitio. Poder leer este código no permite firmar nada en nombre de DNNS.es.

Las únicas compilaciones oficiales son las publicadas por DNNS.es: Google Play, TestFlight / App Store y descargas.dnns.es. Si te llega un APK de Koberlet por cualquier otra vía, no es nuestro, aunque se llame igual y se vea igual.

Qué hace

• Varias carteras, cada una en su red: Kadena (oficial y fork comunitario) o EVM (Ethereum, Arbitrum, Base, BNB Chain, Polygon).
• Crear o importar: semilla BIP-39 compatible con eckoWallet, Chainweaver y MetaMask, o clave privada suelta.
• Enviar y recibir con firma ed25519 (Kadena) y secp256k1 (EVM). Todo envío pide contraseña o huella.
• Códigos QR: leer una dirección con la cámara —66 caracteres tecleados a mano es la forma más habitual de mandar dinero a ninguna parte— y generar el propio, con importe y chain si se quiere. Se lee con jsQR sobre la cámara del navegador, no con el lector de Google: la imagen no sale del teléfono y funciona en cualquier Android, con o sin servicios de Play.
• Mercado: cambio KDA ⇄ kb-USDC no custodial contra el pool kaddex.exchange del fork. A partir de 5 kb-USDC el gas lo paga la gasolinera de KoberluSW y a ti no te cuesta nada.
• Órdenes límite y planes DCA sobre los contratos free.ksw2 y free.ksw-dca2. Las dispara el vigilante de KoberluSW pagando su propio gas; la app solo crea y cancela.
• Puente Kinesis (experimental): Kadena ⇄ EVM, con simulación antes de firmar.
• NFT, agenda de direcciones, historial on-chain, copias de seguridad, tema claro/oscuro e idioma ES/EN.

Seguridad (lo que interesa revisar)

• Las privadas no viven en JavaScript. Dentro del APK la bóveda es nativa (android/…/Cofre.kt, y su equivalente en Swift); el JavaScript pide firmas y recibe firmas, nunca la clave. El doble de desarrollo que sí guarda en el navegador (src/boveda/simulada.js) se carga con un import() dentro del if, para que el empaquetador lo deje en un trozo aparte que el APK no llega a pedir nunca.
• Bóveda cifrada con AES-256-GCM y clave derivada por scrypt (N=2¹⁵, los mismos parámetros que el escritorio). El IV es nuevo en cada escritura. Los parámetros van dentro del fichero pero se comprueban al abrirlo: si no, bastaría con editar una bóveda robada y poner N=2 para poder probar contraseñas a toda velocidad.
• Huella y Face ID son una comodidad para desbloquear, no otra capa de cifrado: apoyados en Android Keystore y en el llavero de iOS (Huella.kt, Huella.swift).
• Revelar una clave privada o firmar cualquier envío exige volver a identificarse.
• Sin backend propio. La app habla directamente con los nodos Chainweb, con RPC EVM públicos, con CoinGecko y con el indexador kdaindex.dnns.es. Eso tiene una consecuencia de privacidad que conviene saber: esos servidores ven qué direcciones consultas.

Fallos de seguridad

No abras un issue público. Pestaña Security → Report a vulnerability. Llega solo al mantenedor. Un fallo aquí no es un error de programa: es dinero de alguien.

Estructura

src/             la app (JavaScript plano, sin frameworks)
  boveda/        contrato de bóveda, versión nativa y doble de desarrollo
  lib/           kda, dex, dca, puente, nft, mercado, ethswap
android/         proyecto Android; lo nativo en Kotlin (bóveda, firma, derivación, huella)
ios/             proyecto iOS; lo mismo en Swift
test/            pruebas que se ejecutan con `npm test`
herramientas/    utilidades de desarrollo
play/            ficha y procedimiento de publicación en Google Play

Capacitor + Vite. PARIDAD.md lleva la cuenta de lo que hay en cada sistema y de lo que falta por nivelar; ESTADO.md es el cuaderno de qué se cambió y por qué.

Compilar

npm install
npm test          # las comprobaciones, antes que nada
npm run build     # empaqueta el web
npx cap sync

Después, android/ se abre con Android Studio y ios/ con Xcode. Sin la clave de firma —que no está aquí— saldrá un APK de depuración, que es lo correcto para un fork: fírmalo con la tuya y ponle otro nombre.

Licencia y nombre

El código es libre, bajo Apache 2.0. El nombre no: «Koberlet» y «DNNS» son marcas de DNNS.es y no se licencian con el software. Puedes hacer un fork y distribuirlo, con otro nombre. El porqué y los límites, en TRADEMARK.md.

Aviso

Esto custodia claves privadas y firma transacciones con dinero real. Se publica tal cual, sin garantía de ningún tipo, como dice la licencia. Prueba con cantidades pequeñas, guarda tu frase de recuperación fuera del teléfono y no confíes en ningún monedero —este incluido— más de lo que estés dispuesto a perder.