Cómo ceder el control de la cuenta principal de un nodo a una cuenta externa, de modo que nunca se requiera la clave privada de la cuenta externa en el proceso de configuración del nodo.
Esto es útil, por ejemplo, para los proveedores de servicios (también conocidos como proveedores de servicios de replanteo o proveedores de servicios de alojamiento) que trabajan de manera sin custodia. Es decir, los clientes contratan al proveedor de servicios para que les configure nodos y les envíen las recompensas de los nodos a sus cuentas principales, sin siquiera enviar sus claves de cuenta al proveedor de servicios.
Esta guía está destinada al proveedor de servicios que configura un nodo en nombre de su cliente.
Hay muchos mecanismos para lograr esto en Bitxor. Esta página explica la más simple, asumiendo que el cliente no es experto en tecnología (y por lo tanto prefiere no usar herramientas de línea de comandos como bitxor-cli), y que la clave del cliente no está permitido en una máquina en línea.
Note
El proceso es aún más simple si se permite que la clave del cliente esté en línea.
Pronto se agregará una guía a esta página que describe este escenario.
En resumen, una vez que el nodo esté completamente configurado, el control total de la cuenta principal del nodo se transferirá a la cuenta del cliente (llamada cuenta externa) al convertir la cuenta principal en un :doc:` ../../conceptos/cuenta-multigrado`:
El proveedor de servicios preparará una transacción para firmar fuera de línea y se la enviará al cliente.
El cliente firma la transacción utilizando su Wallet desde una máquina fuera de línea y devuelve la firma.
El proveedor de servicios anuncia la transacción.
En la máquina de Nodo:
Tenga un nodo de Bitxor en ejecución, configúrelo con la guía Ejecutar un nodo seguro.
En la máquina de Configuración:
Tener bitxor-cli instalado. Esto ya se ha instalado en la guía Ejecutar un nodo seguro.
Tener un perfil bitxor-cli para la cuenta principal del nodo. Esto también se ha hecho ya en la guía.
Asegúrese de que el perfil correcto sea el predeterminado (utilice bitxor-cli profile setdefault o agregue el parámetro --profile a todos los comandos a continuación).
En la máquina del Cliente:
Tener Bitxor Desktop Wallet instalado y configurado con la cuenta del cliente (cuenta externa).
Hasta ahora, la cuenta principal del nodo es una cuenta normal. Se anunciará una MultisigAccountModificationTransaction que la convertirá en una Cuenta Multifirma con un único cosignatario: la cuenta externa.
Esto significa que cualquier operación en la cuenta principal requerirá la firma de la cuenta externa.
Esta transacción será preparada por el proveedor de servicios utilizando bitxor-cli y enviada al cliente para su firma.
Notas sobre esta transacción:
El parámetro --max-fee 1000000 significa que se pagará 1 BXR por la transacción. Siéntase libre de usar un número diferente después de leer la documentación de fees.
El plazo de transacción por defecto en bitxor-cli es de 2 horas. Utilice el parámetro --deadline si necesita más tiempo para obtener la firma del cliente.
Ejecute esto desde la máquina de configuración:
bitxor-cli transaction multisigmodification --max-fee 1000000 \
--mode normal --min-removal-delta 1 --min-approval-delta 1 \
--action Add --aggregate-type AGGREGATE_COMPLETE \
--cosignatory-addresses ●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●
Use la dirección de cuenta externa como cosignatario y no anuncie la transacción:
✔ Enter your wallet password: … *********
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ AGGREGATE_COMPLETE │
├──────────────────────────────────────────────┬──────────────────────────────────────────────────────────────────┤
│ Max fee: │ 1,000,000 │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ Network type: │ TEST_NET │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ Deadline: │ 2021-03-27 14:51:01.099 │
├──────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────┤
│ Inner transaction 1 of 1 - MULTISIG_ACCOUNT_MODIFICATION │
├──────────────────────────────────────────────┬──────────────────────────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Min approval delta: │ 1 │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Min removal delta: │ 1 │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Address addition (1 / 1): │ TAJ3DW-DCRWBU-V6CXBQ-TNAAKH-UPRPQ6-I2QW7V-7JA │
├──────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────┤
│ Signature details │
├──────────────────────────────────────────────┬──────────────────────────────────────────────────────────────────┤
│ Payload: │ F800000000000000FAE63B1603A8FA30BF5F8A7E5C7906349AAA89591BD20651 │
│ │ 013704F4E03894206D6543339716A8E4391E53873F8F43BEC10D9706F74764C7 │
│ │ 940C07A756F4950ACC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528F │
│ │ B902600CB7DA1033000000000198414140420F0000000000EB39311C0A000000 │
│ │ 5B8F6FEBA2C4D0C7E1C084DA1E828B68C46EE7EE247811BE3DBDCE913E40E027 │
│ │ 50000000000000005000000000000000CC6D13D64FB9BF69B72846C3FE99127D │
│ │ 48C3293F473D528FB902600CB7DA103300000000019855410101010000000000 │
│ │ 9813B1D8628D834AF8570C26D00147A3E2F8791A85BF5FA4 │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ Hash: │ 13241107ACC87B4F7B047C335856326D86AC0F4FF2C0F52CCA1D7FC4E6491CB8 │
├──────────────────────────────────────────────┼──────────────────────────────────────────────────────────────────┤
│ Signer: │ CC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA1033 │
└──────────────────────────────────────────────┴──────────────────────────────────────────────────────────────────┘
✔ Do you want to announce this transaction? … no
Seleccione todo el texto en el cuadro Payload y péguelo en un nuevo archivo de texto llamado payload.txt. Elimine todos los espacios y otras decoraciones para obtener una sola línea que contenga solo números y letras mayúsculas:
F800000000000000FAE63B1603A8FA30BF5F8A7E5C7906349AAA89591BD20651013704F4E03894206D6543339716A8E4391E53873F8F43BEC10D9706F74764C7940C07A756F4950ACC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA1033000000000198414140420F0000000000EB39311C0A0000005B8F6FEBA2C4D0C7E1C084DA1E828B68C46EE7EE247811BE3DBDCE913E40E02750000000000000005000000000000000CC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA1033000000000198554101010100000000009813B1D8628D834AF8570C26D00147A3E2F8791A85BF5FA4
Esta carga útil no se puede anunciar sin una firma de la cuenta externa, ya que se ha agregado como cosignatario.
Envíe payload.txt al cliente, como un archivo de texto sin formato.
El cliente utiliza su Bitxor Desktop Wallet para crear una firma para la carga útil recibida:
Abra Desktop Wallet y haga clic en Ir a transacciones fuera de línea en la esquina superior derecha.
Seleccione la pestaña Cosignar transacción.
Pegue la carga útil completa en el cuadro grande con la etiqueta Pegar la carga útil de la transacción.
Haz clic en Importar carga útil.
Seleccione el Nombre del perfil y la cuenta externa (en el cuadro De:).
Ingrese la Contraseña de la billetera y haga clic en Confirmar.
Se obtendrá un código QR y una larga línea de texto similar a esta:
{"parentHash":"13241107ACC87B4F7B047C335856326D86AC0F4FF2C0F52CCA1D7FC4E6491CB8","signature":"1D8FD3A815C45B9FFCCD48FF9DE24FAD172D373E889D25F3005FDAA0F87DB70AB9ABD2ECB79E467577FCE49B760729706247B24479CB32A88A4A1C1974D4220A","signerPublicKey":"7F71566C57A8E5B03EADBA28E4CA057428DDB37C766604B2827BC2D79BB195B8","version":{"lower":0,"higher":0}}
Copy the whole line of text (for example by triple-clicking on it) and paste it into a new text file named signature.txt.
Envíe signature.txt al proveedor de servicios, como un archivo de texto sin formato.
Anuncie la transacción de modificación multisig desde cualquier máquina en línea que tenga instalado bitxor-cli y tenga un perfil de anunciador (como se explica en Ejecutar un nodo seguro ):
bitxor-cli transaction payload --sync --announce --profile C
? Enter the transaction payload: F8000000000...
SUCCESS Transaction loaded:
┌──────────────────────────────────────────────────────────────────────────────────────────────┐
│ AGGREGATE_COMPLETE │
├──────────────────────────────────────────────┬───────────────────────────────────────────────┤
│ Max fee: │ 1,000,000 │
├──────────────────────────────────────────────┼───────────────────────────────────────────────┤
│ Network type: │ TEST_NET │
├──────────────────────────────────────────────┼───────────────────────────────────────────────┤
│ Deadline: │ 2021-03-27 14:51:01.099 │
├──────────────────────────────────────────────┼───────────────────────────────────────────────┤
│ Signer: │ TBGPYD-CO35V2-AMOYEJ-LEM44H-372M3I-6RWVFY-QCY │
├──────────────────────────────────────────────┴───────────────────────────────────────────────┤
│ Inner transaction 1 of 1 - MULTISIG_ACCOUNT_MODIFICATION │
├──────────────────────────────────────────────┬───────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Min approval delta: │ 1 │
├──────────────────────────────────────────────┼───────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Min removal delta: │ 1 │
├──────────────────────────────────────────────┼───────────────────────────────────────────────┤
│ [Inner tx. 1 of 1] Address addition (1 / 1): │ TAJ3DW-DCRWBU-V6CXBQ-TNAAKH-UPRPQ6-I2QW7V-7JA │
└──────────────────────────────────────────────┴───────────────────────────────────────────────┘
? Matriz JSON de cofirma entre corchetes (ingresar para omitir): [{"parentHash"...
Cuando se le solicite la carga útil de la transacción, pegue el contenido de payload.txt (la línea larga de caracteres hexadecimales).
Cuando se le solicite la firma conjunta, pegue el contenido de signature.txt (la línea larga de texto JSON que el cliente devolvió), PERO ENCÉRRELO ENTRE BRACKETS.
This is, the cosignature should start with [ and end with ].
Después de unos segundos debería obtener:
...
SUCCESS Transacción anunciada
ÉXITO Transacción confirmada
A partir de este momento, no se puede realizar ninguna operación en la cuenta principal del nodo sin la autorización de la cuenta externa, que es controlada por el cliente.
El cliente puede realizar operaciones en la cuenta principal utilizando el Bitxor Desktop Wallet y sus facilidades multisig.
Last updated by John Doe
on 2023‑06‑19.
