How to use the Grin wallet [Spanish]
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.
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.
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
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.
Hay varias maneras de enviar Grin a otra billetera:
Actualmente se recomienda a los nuevos usuarios enviar Grins a través de archivo. El proceso es el siguiente:
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.
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.
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.
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.
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.
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
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.
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
----------------------------------------------------------------------------------------------------------------------------------------------------
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á.
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.
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 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:
Basics
- Getting Started
- User Documentation
- MimbleWimble
- FAQ
- Planned releases (Roadmap)
- Code of Conduct
Contributing
- Contributing Guide
- Code Structure
- Code coverage and metrics
- Code Reviews and Audits
- Adding repos to /mimblewimble
Development
Mining
Infrastructure
Exchange integrations
R&D
Grin Community
Grin Governance
Risk Management
Grin Internals
- Block Header Data Structure
- Detailed validation logic
- P2P Protocol
Misc