@dotrino/identity 0.54.1 → 0.55.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotrino/identity",
-  "version": "0.54.1",
+  "version": "0.55.0",
   "description": "Identidad y rating de usuarios compartidos entre apps de Dotrino (vault iframe + postMessage)",
   "type": "module",
   "main": "src/index.js",

package/src/node.js

@@ -170,6 +170,20 @@ export class Identity {
   // Acta de perfil (qué llaves son del perfil y qué puede cada una; ver acta-de-perfil.md)
   profileActa () { return this._h('profileActa') }
   profileMembers () { return this._h('profileMembers') }
+  /**
+   * Quien SELLA SOBRES (la bóveda) registra aquí cómo estrenar su llave de sellado: se
+   * llama al sellar cada acta, porque esa llave rota con el acta (§8.9 de
+   * `dotrino-vault/docs/secretos-sellados.md`). Va por aquí y no por el iframe porque
+   * este puente es en-proceso: al navegador no se le puede pasar una función, y tampoco
+   * la necesita — no sella secretos de nadie.
+   */
+  /** Abre un sobre sellado A ESTE aparato (envoltura + sobre). Ver `core.js`. */
+  openSealedValue (wrap, envelope) { return this._h('openSealedValue', { wrap, envelope }) }
+  setSealKeyProvider (provider) { return this._h('setSealKeyProvider', { provider }) }
+  /** Estrena la llave de sellado en un acta nueva, sin tocar a ningún miembro. */
+  rotateSealKey () { return this._h('rotateSealKey') }
+  /** Con qué llave se comprueban los sobres que se firmaron con el acta `seq`. */
+  sealKeyAt (seq) { return this._h('sealKeyAt', { seq }) }
   myMembership () { return this._h('myMembership') }
   /**
    * La CADENA de actas desde `sinceSeq` (para que un dispositivo que estuvo apagado

package/vault/core.js

@@ -1470,8 +1470,9 @@ export async function createIdentityCore ({ kv: rawKv, peers, makeSync = null, k
      * Es opt-in a propósito: una identidad de navegador no sella nada, y un acta sin llave
      * de sellado es perfectamente válida.
      */
-    setSealKeyProvider (fn) {
-      sealKeyProvider = typeof fn === 'function' ? fn : null
+    setSealKeyProvider ({ provider } = {}) {
+      sealKeyProvider = typeof provider === 'function' ? provider : null
+      return { ok: true, set: !!sealKeyProvider }
     },
 
     /**
@@ -1486,7 +1487,7 @@ export async function createIdentityCore ({ kv: rawKv, peers, makeSync = null, k
     },
 
     /** La llave con la que se firmaron los sobres de un acta dada. Para VERIFICARLOS. */
-    sealKeyAt (seq) {
+    sealKeyAt ({ seq } = {}) {
       return Acta.sealKeyAt(loadActa(), seq)
     },
 
@@ -1648,6 +1649,24 @@ export async function createIdentityCore ({ kv: rawKv, peers, makeSync = null, k
       return Content.encryptWithCek({ cek: mine.cek, gen: mine.gen, plaintext: String(plaintext) })
     },
 
+    /**
+     * Abre un sobre SELLADO A ESTE APARATO: primero la envoltura de la llave —con la
+     * privada de cifrado de este dispositivo, que nunca sale de aquí— y con ella el sobre.
+     *
+     * Es lo que deja a un aparato de administración VER un secreto de la bóveda **sin
+     * teclear ninguna contraseña** (§8.2 de `dotrino-vault/docs/secretos-sellados.md`):
+     * la capacidad de leer deja de ser una frase que se escribe en cualquier parte y pasa
+     * a ser una llave que no se mueve del aparato.
+     *
+     * Distinto de `openContent`, que usa el llavero del PERFIL (el contenido del usuario);
+     * aquí la envoltura viene suelta, del llavero de un cajón de secretos.
+     */
+    async openSealedValue ({ wrap, envelope } = {}) {
+      if (!wrap || !envelope) throw new Error('openSealedValue: missing the wrap or the envelope')
+      const cek = await Content.openWrap({ wrap, myEncPrivateKey: encKeypair.privateKey })
+      return Content.decryptWithCek({ cek, envelope })
+    },
+
     /** Abre un sobre de contenido con el llavero del perfil (todas las generaciones). */
     async openContent ({ envelope } = {}) {
       return Content.decryptWithKeyring({