How to use the Grin wallet [Spanish]

Prerequisitos

Estas instrucciones presuponen que ha descargado e instalado el software Grin y que está ejecutando un nodo sincronizado. Las instrucciones para hacerlo se encuentran en la página Cómo ejecutar un nodo Grin.

Iniciar la cartera

Antes de poder usar la cartera Grin, debe estar iniciada. Este proceso iniciará la base de datos de su billetera y creará su archivo secreto de semillas.

Para hacer esto, ejecute:

grin 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/.grin/grin-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 grin_wallet::types - Generating wallet seed file at: /home/user/.grin/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 .grin/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 .grin/grin-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 Grin 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 Grin.

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:

grin wallet -r http://some_public_node.org:13413 info

o puedes editar el valor de check_node_api_api_http_addr en grin-wallet.toml

Revisando el balance de su cartera

Para revisar el contenido de su billetera, use el comando info:

# grin 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 Grins

Hay varias maneras de enviar Grin a otra billetera:

Envío por fichero

Actualmente se recomienda a los nuevos usuarios enviar Grins a través de archivo. El proceso es el siguiente:

Creando un fichero de transacción:

grin wallet send -m file -d my_grin_transaction.tx 10.25 

Esto creará un archivo de transacción llamado my_grin_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:

grin wallet finalize -i my_grin_transaction.tx.response 

Esto enviará la transacción al nodo Grin 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:

grin wallet send -d http://10.20.20.1:13415 10.25 

Si tiene éxito, las cantidades se confirmarán en ambas carteras después de que se hayan encontrado unos pocos bloques.

Recibiendo Grins

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):

grin wallet receive -i my_grin_transaction.tx 

Esto creará un archivo de respuesta llamado my_grin_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 ~./grin-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

grin wallet listen

De forma alternativa, puede pasar el argumento -e (externo) de la cartera para escuchar en 0.0.0.0.0:

grin wallet -e listen

También puede cambiar el puerto de escucha en grin-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 grin). Una vez que su receptor se esté ejecutando, cualquier remitente que desee enviarle Grins puede hacerlo como se describe arriba

El registro de transacciones

La cartera Grin 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 Grins, así como para cancelar transacciones parciales que pueden no haber sido completadas.

Para ver el registro de transacciones:

grin 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.grintx                           
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------                          
 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.grintx                           
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------                          
 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.grintx                           
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 

Para ver todos los detalles de una transacción, así como qué salidas están asociadas a ella, utilice el parámetro -i:

grin 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.grintx 
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------


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 Grin 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:

grin 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, Grin 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:

grin 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 ~/.grin/wallet_data ~/.grin/wallet_data_bak

A continuación:

grin wallet init -r
[... follow onscreen instructions...]
grin 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:

• recover - Recupera las semillas de su cartera a partir de una frase de semillas, o vea su frase de recuperación existente
• restore - Restaura una cartera vacía desde cero a partir de un archivo de semillas