Funciones Avanzadas

Dash Electrum se basa en Electrum, una billetera de Bitcoin. La mayoría de las funciones son idénticas, lo que significa que no es necesario reproducir la totalidad de la documentación de Electrum aquí. Las siguientes secciones describen algunas funciones avanzadas de uso frecuente. Para obtener más detalles sobre otras funciones avanzadas en Electrum para Bitcoin y Dash, haz click en los enlaces a continuación.

Masternodes en Dash Electrum

Dash Electrum admite la creación de masternodes a través de una interfaz llamada Administrador de Masternode. La funcionalidad está disponible a partir de la versión de protocolo 70201.

Administrador de masternode

se puede acceder al administrador de masternode desde el menú en Billetera > Masternodes o presionando Ctrl+M. Este administrador muestra el estado de tu masternode(s). Una billetera sin masternodes comenzará con un masternode predeterminado para el cual puedes completar la información necesaria.

El administrador muestra los siguientes datos sobre cada masternode que tu has configurado:

  • El alias (nombre) del masternode.
  • El estado del masternode (por ejemplo, si se ha activado).
  • El pago de garatías de el masternode
  • La llave de delegado privado.
  • La dirección IP y el puerto con el que se puede contactar a tu masternode.
  • La versión del protocolo que admite tu masternode

Configuración del masternode

Un masternode requiere una llave de «delegado», que es conocida tanto por Dash Electrum como por tu masternode. Tu masternode usará esta llave para firmar mensajes, y la red Dash sabrá que tu lo autorizaste. Una llave de delegado puede ser una de tus llaves de Dash Electrum o una llave importada. De cualquier forma, tu masternode y Dash Electrum necesitarán conocer la llave privada.

Para usar una de tus llaves de Dash Electrum como una llave de delegado, pon su llave privada en el campo Llave privada de masternode de la pestaña Ver masternode.

Dirección IP y versión de protocolo

Se requiere cierta información sobre tu masternode. La dirección IP y el puerto que utiliza tu masternode deben ser suministrados. Además, se requiere la versión de protocolo que admite tu masternode. Esta información se completa automáticamente si importas un archivo «masternode.conf».

../../_images/mn-view.png

Ingresar la información de IP y de protocolo

Garantía

Para ejecutar un masternode, debes tener un pago de 1000 DASH disponible en tu billetera. Puedes escanear tu billetera para realizar 1000 pagos DASH en la pestaña del Administrador de masternodes Elegir garantía.

Después de escanear, se mostrará una lista de los pagos disponibles de garantías de 1000 DASH. Seleccionar uno de ellos hará que se llenen los datos del masternode seleccionado, aunque estos cambios no se guardarán hasta que hagas click en el botón Guardar en la esquina inferior derecha de la pestaña.

../../_images/mn-collateral.png

Ingresar la información de IP y de protocolo

Activar tu masternode

Después de seleccionar un pago de garantía y especificar una llave de delegado, puedes activar su masternode. Haz esto haciendo click en Activar Masternode en la pestaña Activar Masternode del Administrador de masternode . Si no se puede hacer clic en el botón Activar Masternode, mira el mensaje en la barra de Estado. Te mostrará por qué tu masternode no se puede activar.

La activación requerirá tu contraseña si tu billetera está encriptada, porque un mensaje debe estar firmado. Después de esperar que Dash Electrum firme y transmita tu anuncio de masternode, se te presentará un mensaje que detalla el resultado. El estado de tu masternode se actualizará en la tabla y en la pestaña Ver Masternode .

../../_images/mn-enabling.png

Ingresar la información de IP y de protocolo

Importar masternode.conf

Puedes importar un archivo masternode.conf utilizando la pestaña Masternode.conf del Administrador de Masternode. Esta es la forma recomendada de configurar los masternodes, ya que te permite configurar masternodes para Dash Core y Dash Electrum de la misma manera. La importación de un archivo masternode.conf establecerá automáticamente una o más configuraciones del masternode en Administrador de masternode.

Billeteras multifirma

Este tutorial muestra cómo crear una billetera multifima 2 de 2. Una multifirma 2 de 2 consta de 2 billeteras separadas (generalmente en máquinas separadas y potencialmente controladas por personas separadas) que deben usarse en conjunto para acceder a los fondos. Ambas billeteras tienen el mismo conjunto de direcciones.

  • Un caso de uso común para esto es si deseas controlar los fondos en conjunto: tal vez tu y tu amigo dirijen una compañía juntos y ciertos fondos solo deberían ser gastados si ambos están de acuerdo.
  • Otro caso es la seguridad: una de las billeteras puede estar en tu máquina principal, mientras que la otra está en una máquina fuera de línea. De esta forma, se le dificulta a un atacante o un malware robar tus monedas.

Crear un par de billeteras 2-de-2

Cada cosignatario debe hacer esto: en el menú, seleccionar Archivo > Nuevo, luego seleccionar Billetera multifirma. En la pantalla siguiente, seleccionar 2 de 2.

../../_images/faq-multisig-create.png

Selección de firmas x de y para una billetera multifirma

Después de generar y confirmar tu semilla de recuperación, se te mostrará la dirección de xpub para esta billetera.

../../_images/faq-multisig-xpub.png

La llave xpub de la primera billetera

Después de generar una semilla (guárdala de forma segura!) deberás proporcionar la llave pública maestra de la otra billetera. Por supuesto, cuando creas la otra billetera, coloca la llave pública maestra de la primera billetera.

../../_images/faq-multisig-share-xpub.png

Ingresar xpub de la segunda billetera en la primera billetera

Tendrás que hacer esto en paralelo para las dos billeteras. Ten en cuenta que puedes presionar cancelar durante este paso y volver a abrir el archivo más tarde.

Recibiendo

Verifica que ambas billeteras generen el mismo conjunto de direcciones. Ahora puedes enviar a estas Direcciones (ten en cuenta que comienzan con un «7») con cualquier billetera que pueda enviar a Direcciones P2SH.

Enviando

Para gastar monedas de una billetera 2-de-2, dos cosignatarios deben firmar una transacción en conjunto. Para lograr esto, crea una transacción utilizando una de las billeteras (completando el formulario en la pestaña Enviar). Después de firmar, se muestra una ventana con los detalles de la transacción.

../../_images/faq-multisig-partially-signed.png

Transacción de multifirma 2-de-2 parcialmente firmada en Dash Electrum

La transacción ahora debe enviarse a la segunda billetera. Varias opciones están disponibles para esto:

  • Puedes transferir el archivo a una memoria USB

    Puedes guardar la transacción parcialmente firmada en un archivo (usando el botón Guardar), transferirla a la máquina donde se está ejecutando la segunda billetera (a través de una memoria USB, por ejemplo) y cargarla allí (usando Herramientas > Cargar transacción > Desde archivo)

  • Puedes usar códigos QR

    Un botón que muestra un ícono de código QR también está disponible. Al hacer click en este botón se mostrará un código QR que contiene la transacción, el cual se puede escanear en la segunda billetera (Herramientas > Cargar transacción > Desde código QR)

Con los dos métodos anteriores, ahora puedes agregar la segunda firma a la transacción (usando el botón Firmar). Luego se transmitirá a la red.

../../_images/faq-multisig-fully-signed.png

Transacción multifirma 2-de-2 completamente firmada en Dash Electrum

Arrastrar una billetera de papel

Es posible que hayas recibido una billetera de papel como regalo de otro usuario de Dash o que hayas guardado una previamente en una caja de seguridad. Los fondos son arrastrados de una Billetera de papel a una billetera viva importando su llave privada, que es una larga secuencia de caracteres que comienza con el número «7» o la letra mayúscula «X». El siguiente ejemplo muestra una llave privada (formato WIF).

../../_images/sweep-secret.png

Dirección pública y llave privada asociada, producidas por un generador de billeteras de papel de Dash

Los fondos de las billeteras de papel se arrastran a una billetera de Dash Electrum creando una transacción utilizando la llave privada y enviándola a una nueva dirección de tu billetera. Esto es necesario porque no es posible agregar nuevas llaves públicas o privadas a una serie determinista existente de direcciones derivadas de una frase semilla.

Comienza seleccionando la opción de menú Billetera > Llaves privadas > Arrastrar. Aparecerá el cuadro de diálogo Arrastrar llaves privadas, donde puedes pegar tu(s) llaves privadas. Una dirección no utilizada controlada por tu billetera Dash Electrum aparece en el campo inferior, y se puede cambiar haciendo clic en el botón Dirección. Una vez que hayas pegado su llave privada, haz clic en el botón Arrastrar.

../../_images/sweep-privkey.png

Ingresar una llave privada

Dash Electrum luego prepara una transacción usando la llave privada que acabas de importar para derivar la dirección pública para la entrada de la transacción y la dirección de tu billetera como salida, y luego firma el mensaje. Haz click en Transmisión para ingresar a la transacción en la cadena de bloques. El saldo aparecerá en tu billetera debajo de la dirección especificada. La dirección que arrastraste quedará con saldo cero.

../../_images/sweep-broadcast.png

Transmisión de la transacción arrastrada

Almacenamiento en frío

Esta sección muestra cómo crear una billetera fuera de línea que contiene tus Dash y una billetera en línea solo para mirar el de la otra billetera historial y para crear transacciones que deben firmarse con la billetera fuera de línea antes de ser transmitidas en la billetera en línea.

Crear una billetera fuera de línea

Crea una billetera en una máquina fuera de línea, según el proceso habitual (Archivo > Nuevo). Después de crear la billetera, ve a Billetera -> Llaves públicas maestras.

../../_images/faq-cold-xpub.png

Llave pública maestra de una nueva billetera fuera de línea

La llave pública maestra de tu billetera es la cadena que se muestra en esta ventana emergente. Transfiere esa llave a tu máquina en línea de alguna manera.

Crea una versión de solo lectura de tu billetera

En tu máquina en línea, abre Dash Electrum y selecciona Archivo > Nuevo/Restaurar. Ingresa un nombre para la billetera y selecciona Usar llaves públicas o privadas. Pega tu llave pública maestra en el cuadro. Haz click en Siguiente para completar la creación de tu billetera. Cuando termines, deberías ver una ventana emergente que te informa que estás abriendo una billetera de solo lectura.

../../_images/faq-cold-watching.png

Llave pública maestra de una nueva billetera fuera de línea

El historial de transacciones de tu billetera fría debería aparecer.

Crear una transacción sin firmar

Ve a la pestaña Enviar de tu billetera de solo lectura en línea, ingresa los datos de la transacción y haz click en Enviar. Aparecerá una ventana para informarte que se agregará una comisión de transacción. Continuar. En la ventana que aparece, haz click en Guardar y guarda el archivo de transacción en algún lugar de tu computadora. Cierra la ventana y transfiere el archivo de transacción a tu máquina fuera de línea (por ejemplo, con una memoria USB).

Firmar tu transacción

En tu billetera fuera de línea, selecciona en el menú Herramientas > Cargar transacción -> Desde archivo y selecciona el archivo de transacción creado en el paso anterior. Haz clic en Firmar. Una vez que se firme la transacción, la identificación de la transacción aparecerá en su campo designado. Haz clic en Guardar, almacena el archivo en algún lugar de tu computadora y transfiérelo a tu máquina en línea.

Transmitir tu transacción

En tu máquina en línea, selecciona en el menú Herramientas -> Cargar transacción -> Desde archivo. Selecciona el archivo de transacción firmado. En la ventana que se abre, haz click en Transmisión. La transacción se transmitirá a través de la red Dash.

Línea de comandos

Dash Electrum tiene una poderosa línea de comandos disponible cuando se ejecuta en Linux o macOS. Esta sección te mostrará algunos principios básicos.

Usar la ayuda entre líneas

Para ver la lista de comandos de Dash Electrum, escribe:

electrum help

Para ver la documentación de un comando, escribe:

electrum help <command>

Palabras mágicas

Los argumentos pasados a los comandos pueden ser una de las siguientes palabras mágicas: ! ? : -.

El signo de exclamación ! Es un atajo que significa “la cantidad máxima disponible’. Ten en cuenta que la comisión de transacción se calculará y descontará de la cantidad. Ejemplo:

electrum payto Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq !

Un signo de interrogación ? Significa que deseas que se solicite el parámetro. Ejemplo:

electrum signmessage Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq ?

Usa dos puntos : si deseas que el parámetro solicitado se oculte (no se repite en tu terminal). Ten en cuenta que se te solicitarán dos veces en este ejemplo, primero para la llave privada y luego para la contraseña de tu billetera:

electrum importprivkey :

Un parámetro reemplazado por un guión - se leerá de la entrada estándar (en una tubería):

cat LICENCE | electrum signmessage Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq -

Aliases

Puede usar alias de DNS en lugar de direcciones de bitcoin, en la mayoría de los comandos:

electrum payto ecdsa.net !

Formatear salidas usando jq

Las salidas de los comandos son cadenas simples o datos estructurados de json. Un producto muy útil es el programa “jq”. Instálalo con:

sudo apt-get install jq

Los siguientes ejemplos lo usan

Firma y verifica mensajes

Podemos usar una variable para almacenar la firma y verificarla:

sig=$(cat LICENCE| electrum signmessage Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq -)

Y:

cat LICENCE | electrum verifymessage Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq $sig -

Mostrar los valores de tus saldos no gastados

El comando listunspent devuelve una lista de objetos, con varios campos. Supongamos que queremos extraer el campo valor de cada registro. Esto se puede lograr con el comando jq:

electrum listunspent | jq 'map(.value)'

Selecciona solo las transacciones entrantes del historial

Las transacciones entrantes tienen un campo de ‘valor’ positivo:

electrum history | jq '.[] | select(.value>0)'

Filtrar transacciones por fecha

El siguiente comando selecciona las transacciones que tienen marca de tiempo después de una fecha determinada:

after=$(date -d '07/01/2015' +"%s")
electrum history | jq --arg after $after '.[] | select(.timestamp>($after|tonumber))'

Del mismo modo, podemos exportar transacciones por un período de tiempo dado:

before=$(date -d '08/01/2015' +"%s")
after=$(date -d '07/01/2015' +"%s")
electrum history | jq --arg before $before --arg after $after '.[] | select(.timestamp&gt;($after|tonumber) and .timestamp&lt;($before|tonumber))'

Encriptar y desencriptar mensajes

Primero necesitamos la llave pública de una dirección de billetera:

pk=$(electrum getpubkeys Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq| jq -r '.[0]')

Encriptar:

cat | electrum encrypt $pk -

Desencriptar:

electrum decrypt $pk ?

Nota: este comando te pedirá el mensaje encriptado, luego la contraseña de la billetera.

Exportar llaves privadas y arrastrar monedas

El siguiente comando exportará las llaves privadas de todas las direcciones de la billetera que contienen algunos Dash

electrum listaddresses --funded | electrum getprivatekeys -

Esto devolverá una lista de listas de llaves privadas. En la mayoría de los casos, deseas obtener una lista simple. Esto puede hacerse agregando un archivador jq, de la siguiente manera:

electrum listaddresses --funded | electrum getprivatekeys - | jq 'map(.[0])'

Finalmente, usemos esta lista de llaves privadas como entrada para el comando de arrastre:

electrum listaddresses --funded | electrum getprivatekeys - | jq 'map(.[0])' | electrum sweep - [destination address]

Usar el almacenamiento en frío con la línea de comandos

Esta sección te mostrará cómo firmar una transacción con una billetera Dash Electrum fuera de línea usando la línea de comandos.

Crear una transacción sin firmar

Con tu billetera en línea (solo de lectura), crea una transacción sin firmar:

electrum payto Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq 0.1 --unsigned > unsigned.txn

La transacción sin firmar se almacena en un archivo llamado ‘unsigned.txn’. Ten en cuenta que la - opción no firmada no es necesaria si usas una billetera solo de lectura.

Lo podrás ver usando:

cat unsigned.txn | electrum deserialize -

Firmar la transacción

El formato de serialización de Dash Electrum contiene la llave pública maestra necesaria y la derivación de llave utilizada por la billetera fuera de línea para firmar la transacción. Por lo tanto, solo tenemos que pasar la transacción serializada a la billetera fuera de línea:

cat unsigned.txn | electrum signtransaction - > signed.txn

El comando te pedirá tu contraseña y guardará la transacción firmada en ‘signed.txn’.

Transmitir la transacción

Manda tu transacción a la red de Dash, usando transmisión:

cat signed.txn | electrum broadcast -

Si tiene éxito, el comando devolverá la identificación de la transacción.

Cómo aceptar Dash en un sitio web usando Dash Electrum

Este tutorial te mostrará cómo aceptar Dash en un sitio web con solicitudes de pago SSL firmadas. Está actualizado para Dash Electrum 2.6.

Requisitos

  • Un servidor web que sirve HTML estático
  • Un certificado SSL (firmado por una CA)
  • Vesión de Electrum >= 2.6

Crear una billetera

Crear una billetera en tu servidor web:

electrum create

También puedes usar una billetera de solo lectura (restaurada desde xpub), si deseas mantener las llaves privadas fuera del servidor. Una vez que haya creado tu billetera, inicia Dash Electrum como un daemon:

electrum daemon start

Agrega tu certificado SSL a tu configuración

Debes tener una llave privada y un certificado público para tu dominio. Crea un archivo que contenga solo la llave privada:

-----BEGIN PRIVATE KEY-----
your private key
-----BEGIN END KEY-----

Establece la ruta a tu archivo de llave privada con setconfig:

electrum setconfig ssl_privkey /path/to/ssl.key

Crea otro archivo que contenga tu certificado y la lista de certificados de los que depende, hasta la raíz CA. Tu certificado debe estar en la parte superior de la lista y la raíz CA al final:

-----BEGIN CERTIFICATE-----
your cert
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
intermediate cert
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
root cert
-----END CERTIFICATE-----

Configura la ruta ssl_chain con setconfig:

electrum setconfig ssl_chain /path/to/ssl.chain

Configurar un directorio de solicitudes

Este directorio debe ser servido por tu servidor web (por ejemplo, Apache):

electrum setconfig requests_dir /var/www/r/

De forma predeterminada, Dash Electrum mostrará las URL locales, comenzando con‘file://‘ Para mostrar las URL públicas, necesitamos establecer otra variable de configuración, url_rewrite. Por ejemplo:

electrum setconfig url_rewrite "['file:///var/www/','https://electrum.org/']"

Crear una solicitud de pago firmada

electrum addrequest 3.14 -m "this is a test"
{
   "URI": "dash:Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq?amount=3.14&r=https://electrum.org/r/7c2888541a",
   "address": "Xtdw4fezqbSpC341vcr8u9HboiJMFa9gBq",
   "amount": 314000000,
   "amount (DASH)": "3.14",
   "exp": 3600,
   "id": "7c2888541a",
   "index_url": "https://electrum.org/r/index.html?id=7c2888541a",
   "memo": "this is a test",
   "request_url": "https://electrum.org/r/7c2888541a",
   "status": "Pending",
   "time": 1450175741
}

Este comando devuelve un objeto json con dos URL:

  • request_url es la URL de la solicitud BIP70 firmada.
  • index_url es la URL de una página web que muestra la solicitud.

Ten en cuenta que request_url y index_url usan el nombre de dominio que definimos en url_rewrite. Puedes ver la lista actual de solicitudes usando el comando listrequests.

Abre la página de solicitud de pago en tu navegador

Vamos a abrir index_url en un navegador web.

../../_images/payrequest.png

Página de solicitud de pago en un navegador web

La página muestra la solicitud de pago. Puede abrir Dash: URI con una billetera o escanear el código QR. La línea inferior muestra el tiempo restante hasta que caduque la solicitud.

../../_images/payreq_window.png

Billetera esperando un pago

Esta página ya puede usarse para recibir pagos. Sin embargo, no detectará que se haya pagado una solicitud; para eso tenemos que configurar websockets.

Agregar soporte para web socket

Obtén SimpleWebSocketServer desde aquí:

git clone https://github.com/ecdsa/simple-websocket-server.git

Configurar websocket_server y websocket_port en tu configuración:

electrum setconfig websocket_server <FQDN of your server>
electrum setconfig websocket_port 9999

Y reiniciar el daemon:

electrum daemon stop
electrum daemon start

Ahora, la página es completamente interactiva: se actualizará sola cuando se reciba el pago. Ten en cuenta que los puertos más altos pueden estar bloqueados en los firewalls de algunos clientes, por lo que es más seguro, por ejemplo, revertir la transmisión de proxy websockets utilizando el puerto estándar 443 en un subdominio adicional.

Interfaz JSONRPC

Los comandos para el daemon de Dash Electrum se pueden enviar usando JSONRPC. Esto es útil si quieres usar Dash Electrum en un script PHP.

Ten en cuenta que el daemon usa un número de puerto aleatorio por defecto. Para utilizar un número de puerto estable, debes establecer la variable de configuración rpcport (y reiniciar el daemon):

electrum setconfig rpcport 7777

Con esta configuración, podemos realizar consultas usando Curl o PHP. Ejemplo:

curl --data-binary '{"id":"curltext","method":"getbalance","params":[]}' http://127.0.0.1:7777

Consulta con parámetros nombrados:

curl --data-binary '{"id":"curltext","method":"listaddresses","params":{"funded":true}}' http://127.0.0.1:7777

Crear una solicitud de pago:

curl --data-binary '{"id":"curltext","method":"addrequest","params":{"amount":"3.14","memo":"test"}}' http://127.0.0.1:7777