How to use the Grin wallet [Spanish] - mugleproject/docs GitHub Wiki
Prerequisitos
Estas instrucciones presuponen que ha descargado e instalado el software Mugle y que está ejecutando un nodo sincronizado. Las instrucciones para hacerlo se encuentran en la página Cómo ejecutar un nodo Mugle.
Iniciar la cartera
Antes de poder usar la cartera Mugle, debe estar iniciada. Este proceso iniciará la base de datos de su billetera y creará su archivo secreto de semillas.
Para hacer esto, ejecute:
mugle wallet init
Se le pedirá que introduzca una contraseña. Esta contraseña se utilizará para encriptar su archivo de semillas, y tendrá que proporcionar esta contraseña cada vez que desee utilizar su billetera.
File /home/yeastplume/.mugle/mugle-wallet.toml configured and created
Please enter a password for your new wallet
Password:
Confirm Password:
Una vez hecho esto, se generará el archivo de semillas de su billetera y se le dará una frase de recuperación de 24 palabras que puede usar para recuperar su billetera si pierde su archivo de semillas u olvida la contraseña. Escriba esta frase con lápiz y papel y guárdela en un lugar seguro, ya que cualquiera que tenga esta frase puede controlar todos sus fondos:
20190105 17:36:35.814 WARN mugle_wallet::types - Generating wallet seed file at: /home/user/.mugle/wallet_data/wallet.seed
Your recovery phrase is:
colmena for the win engage bomb fantasy life short stuff mesh bus design truck oyster ankle shallow torch double melody town century nice report
Please back-up these words in a non-digital format.
Command 'init' completed successfully
El archivo de semillas de su billetera se encuentra en .mugle/wallet_data/wallet.seed
. Asegúrese de hacer una copia de seguridad de este archivo en un lugar seguro y asegúrese de que siga siendo privado.
El archivo de configuración de su billetera se encuentra en .mugle/mugle-wallet.toml
. Puede cambiar la dirección predeterminada del nodo, los puertos de escucha predeterminados y muchas más opciones editando este archivo. A continuación encontrará más información sobre el uso de estas opciones.
Conectarse a un nodo
Su cartera siempre debe tener un nodo Mugle en funcionamiento con el que comunicarse. El nodo debe estar totalmente sincronizado.
Se recomienda que ejecute su propio nodo. Las instrucciones para hacerlo se encuentran en la página Cómo ejecutar un nodo Mugle.
De forma predeterminada, la cartera intentará comunicarse con un nodo que se ejecuta en su equipo local. Para comunicarse con otro nodo, puede especificar --api_server_address
(o -r
para abreviar) en la línea de comandos, por ejemplo:
mugle wallet -r http://some_public_node.org:16813 info
o puedes editar el valor de check_node_api_api_http_addr
en mugle-wallet.toml
Revisando el balance de su cartera
Para revisar el contenido de su billetera, use el comando info
:
# mugle wallet info
Password:
____ Wallet Summary Info - Account 'default' as of height 13833 ____
Total | 60.482000000
Immature Coinbase (< 1440) | 60.030000000
Awaiting Confirmation (< 10) | 0.452000000
Locked by previous transaction | 1200.453000000
-------------------------------- | -------------
Currently Spendable | 0.000000000
Command 'info' completed successfully
- Total Es su cantidad total, incluyendo cualquier saldo pendiente de confirmación.
- Immature Coinbase Indica cualquier transacción de base de monedas (es decir, bloques ganados) que aún no han vencido antes de que puedan ser gastados.
- Awaiting Confirmation Es el saldo que la cartera no gastará hasta un número determinado de confirmaciones (número de bloques añadidos a la cadena desde el bloque en el que se confirmó la transacción). Por defecto son 10 bloques.
- Locked by previous transaction Son salidas bloqueadas por una transacción de envío anterior, que no se pueden incluir en otras transacciones. Por lo general, desaparecen (se gastan) cuando se confirma la transacción.
Enviando Mugles
Hay varias maneras de enviar Mugle a otra billetera:
Envío por fichero
Actualmente se recomienda a los nuevos usuarios enviar Mugles a través de archivo. El proceso es el siguiente:
Creando un fichero de transacción:
mugle wallet send -m file -d my_mugle_transaction.tx 10.25
Esto creará un archivo de transacción llamado my_mugle_transaction.tx
en el directorio actual.
Enviar el fichero de transacción al destinatario
Envíe este archivo a través de cualquier medio que desee (correo electrónico, ftp) al destinatario deseado. El destinatario tendrá que realizar su parte de la transacción en su cartera y enviarle el archivo. Consulte Recepción de un archivo de transacción a continuación.
Finalizando la transacción
El destinatario le enviará un archivo de respuesta de transacción. Después de confirmar con el destinatario que procesó el archivo de envío, puede finalizar y realizar la transacción en la cadena:
mugle wallet finalize -i my_mugle_transaction.tx.response
Esto enviará la transacción al nodo Mugle de escucha, y los saldos deben confirmarse tanto en su billetera como en la del destinatario después de que se hayan generado unos cuantos bloques.
Enviando a una cartera en funcionamiento
Si el destinatario está ejecutando un oyente HTTP, puede enviar una cantidad de su billetera a la suya y enviar la transacción a la cadena en un solo paso:
mugle wallet send -d http://10.20.20.1:16815 10.25
Si tiene éxito, las cantidades se confirmarán en ambas carteras después de que se hayan encontrado unos pocos bloques.
Recibiendo Mugles
Por archivo
El remitente le enviará un archivo de transacción (como se describe en Crear un archivo de transacción), que debe importar a su cartera usando el comando receive
(Recibir):
mugle wallet receive -i my_mugle_transaction.tx
Esto creará un archivo de respuesta llamado my_mugle_transaction.tx.response
que deberá enviar al remitente para que complete y publique en la cadena.
A través del receptor de carteras
La ejecución de un oyente de billetera se considera una operación avanzada, y sólo debe ser realizada por aquellos que tienen la infraestructura para soportarla y son capaces de tratar con problemas de NAT/Firewall, problemas de DOS, etc., todos los cuales están más allá del alcance de esta guía.
De forma predeterminada, la billetera sólo escuchará las solicitudes en el equipo local. Para aceptar conexiones de billetera desde otras máquinas, puede editar ~./mugle-wallet.toml
de la siguiente manera:
Cambiamos
api_listen_interface = "127.0.0.1"
por
api_listen_interface = "0.0.0.0"
O cualquier dirección IP particular a la que desee enlazar. A continuación, puede ejecutar un receptor de billetera externo con
mugle wallet listen
De forma alternativa, puede pasar el argumento -e
(externo) de la cartera para escuchar en 0.0.0.0.0:
mugle wallet -e listen
También puede cambiar el puerto de escucha en mugle-wallet.toml
o a través de la línea de comandos (para más detalles, consulte Ayuda para la escucha de la cartera de mugle
). Una vez que su receptor se esté ejecutando, cualquier remitente que desee enviarle Mugles puede hacerlo como se describe arriba
El registro de transacciones
La cartera Mugle mantiene un registro de todas las operaciones de transacción. Realiza un seguimiento de todas las transacciones completadas y no completadas, así como de las salidas asociadas a cada una de ellas. Este registro es útil para ver de dónde provienen sus Mugles, así como para cancelar transacciones parciales que pueden no haber sido completadas.
Para ver el registro de transacciones:
mugle wallet txs
Transaction Log - Account 'default' - Block Height: 13830
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Id Type Shared Transaction Id Creation Time Confirmed? Confirmation Time Num. Num. Amount Amount Fee Net Tx
Inputs Outputs Credited Debited Difference Data
====================================================================================================================================================================================================================
0 Received Tx 20f978d4-d2a5-4df2-a1a4-806330db5718 2019-01-02 12:50:33 true 2019-01-02 15:56:23 0 1 20000.0 0.0 None 20000.0 None
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
1 Sent Tx c2dd4216-7820-4545-bd49-eea8119c39d0 2019-01-02 15:59:20 false None 1 1 19998.992 20000.0 0.008 -1.008 c2dd4216-7820-4545-bd49-eea8119c39d0.mugletx
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
2 Sent Tx c8a7b02e-78e1-4813-b8a9-7367b630a070 2019-01-02 15:59:27 false None 1 1 19997.984 19998.992 0.008 -1.008 c8a7b02e-78e1-4813-b8a9-7367b630a070.mugletx
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
3 Sent Tx 856c3c85-0cb9-4951-9f33-124f032ac21e 2019-01-02 15:59:31 false None 1 1 19996.976 19997.984 0.008 -1.008 856c3c85-0cb9-4951-9f33-124f032ac21e.mugletx
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Para ver todos los detalles de una transacción, así como qué salidas están asociadas a ella, utilice el parámetro -i
:
mugle wallet txs -i 3
Transaction Log - Account 'default' - Block Height: 13830
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Id Type Shared Transaction Id Creation Time Confirmed? Confirmation Time Num. Num. Amount Amount Fee Net Tx
Inputs Outputs Credited Debited Difference Data
==============================================================================================================================================================================================================
3 Sent Tx 856c3c85-0cb9-4951-9f33-124f032ac21e 2019-01-02 15:59:31 false None 1 1 19996.976 19997.984 0.008 -1.008 856c3c85-0cb9-4951-9f33-124f032ac21e.mugletx
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Wallet Outputs - Account 'default' - Block Height: 13830
----------------------------------------------------------------------------------------------------------------------------------------------------
Output Commitment Block Height Locked Until Status Coinbase? # Confirms Value Tx
====================================================================================================================================================
08ad4948a215e22e37f7909c7e36460afa5e38d6696361b0a27b983b38e78540c5 6742 0 Spent false 7089 19997.984000000 3
----------------------------------------------------------------------------------------------------------------------------------------------------
Cancelando transacciones
Es muy posible cuando se utiliza Mugle para crear transacciones que nunca se completarán, especialmente cuando se utilizan métodos de intercambio de transacciones basados en archivos o completamente asíncronos.
Si tiene una transacción no confirmada en su registro que no cree que se complete, puede cancelar una transacción con:
mugle wallet cancel -i 3
Esto establecerá el estado de la transacción en "Cancelado", eliminará cualquier salida de cambio no confirmada y desbloqueará cualquier salida que estuviera previamente bloqueada por la transacción, poniéndola a disposición para gastarla de nuevo. Tenga en cuenta que si usted u otra persona completa la transacción después de haberla cancelado, sus productos pueden terminar gastados y no estar disponibles para su uso por parte de su cartera. Alternativamente, si usted gasta los mismos resultados en una nueva transacción y alguien intenta completar la cancelada, la transacción contabilizada fallará.
Comprobación de la cartera
Debido a todas las posibilidades enumeradas en el comando [cancelar] (cancelar-transacciones), así como la posibilidad de bifurcaciones, es muy posible que su billetera termine en un estado inconsistente. Por esta razón, Mugle proporciona un comando manual Ver que escanea el conjunto de UTXO de la cadena en busca de cualquier salida que pertenezca a su cartera y se asegura de que se encuentren en un estado consistente con la base de datos de su billetera local.
Es importante recordar que el estado de su billetera siempre se puede reconstruir a partir de la cadena con el archivo de semillas o la frase de recuperación de su billetera. Si algo parece fuera de lugar o inesperado con su balance o salidas, tenga la seguridad de que están seguros en el equipo UTXO (siempre y cuando no se hayan gastado) y siempre se pueden recuperar a través de check
o restore
.
Para realizar una comprobación en su cartera y asegurarse de que su contenido coincide con la versión de la cadena, asegúrese de que no tiene transacciones pendientes, asegúrese de que su nodo está al día, a continuación:
mugle wallet check
Esto escanea la cadena y cancela todas las transacciones pendientes, desbloquea cualquier salida bloqueada, restaura cualquier salida que falte y asegura que el contenido de su cartera sea consistente con la versión de la cadena. Puede ejecutar este comando tantas veces como desee para comprobar y actualizar el contenido de su billetera.
Recuperación / Restauración de una cartera a partir de una frase de recuperación
Haga una copia de seguridad de su billetera existente:
mv ~/.mugle/wallet_data ~/.mugle/wallet_data_bak
A continuación:
mugle wallet init -r
[... follow onscreen instructions...]
mugle wallet restore
Consulte restore en el manual del usuario para obtener más información.
Otros comandos
Otros comandos importantes, así como los detalles de todos los comandos de esta página, se pueden encontrar en la detallada Wallet User Guide. Le recomendamos que lea esta guía para tener una idea de lo que es posible con la billetera.
Algunos de los comandos que debe tener en cuenta son: