Configuración de su estación de trabajo

Esta primera guía lo orientará a través de una instalación paso a paso de las herramientas necesarias para start developing applications on Bitxor.

Estaremos usando el test network, que utiliza la misma tecnología y características del main network. Esta red de prueba permite a los desarrolladores experimentar con el set de transacciones ofrecido por Bitxor en una red real sin perder sus activos valiosos.

Creando una cuenta

una cuenta es una caja de depósito donde puedes guardar tokens e interactuar con ellos por anunciando transacciones.

Estamos creando una nueva cuenta con el Bitxor CLI, una herramienta de línea de comandos diseñada para diseñar soluciones e interactuar con redes Bitxor de manera eficiente.

  1. Bitxor CLI requiere Node.js 12 LTS para ejecutarse. Abra una nueva terminal y verifique la versión instalada con:

    node --version

    Si obtiene un error o la versión devuelta no coincide con v12.X, visite nodejs.org para instalar el requisito (Aunque se recomienda instalar a través de nvm).

  2. Para instalar Bitxor CLI, correr el siguiente codigo.

    npm install --global bitxor-cli

  3. Luego, genere una nueva cuenta y guárdela como profile.

    bitxor-cli account generate

Introduzca el tipo de red (MAIN_NET, TEST_NET): TEST_NET
¿Quieres guardar la cuenta? [y/n]: y
Seleccione un tipo de importación: » PrivateKey
Ingresar Bitxor Node URL. (Example: http://localhost:3000): <NODE_URL>
Insertar el nombre de perfil: testnet
¿Desea configurar la cuenta como el perfil predeterminado? [y/n]: y

  4. Si todo va bien, debería ver las credenciales de la cuenta en la terminal.

    Profile stored correctly
┌─────────────┬──────────────────────────────────────────────────────────────┐
│ Property    │ Value                                                        │
├─────────────┼──────────────────────────────────────────────────────────────┤
│ Address     │ BXRYXK-VYBMO4-NBCUF3-AXKJMX-CGVSYQ-OS7ZG2-TLI                │
├─────────────┼──────────────────────────────────────────────────────────────┤
│ Public Key  │ 203...C0A                                                    │
├─────────────┼──────────────────────────────────────────────────────────────┤
│ Private Key │ AAA...AAA                                                    │
└─────────────┴──────────────────────────────────────────────────────────────┘

    Note

    Asegúrese de mantener la clave privada en secreto y hacer una copia de seguridad de forma segura en algún lugar fuera de línea.

Si obtienes el error The CLI cannot reach the node, las causas más comunes podrían ser:

  • Incorrect node URL: La URL utilizada no pertenece a un nodo activo. Abra la URL proporcionada en una nueva pestaña del navegador y verifique si obtiene una respuesta. Si el nodo de red de prueba no funciona, puede utilizar otra url de nodo desde this list o ejecutar su propio nodo testnet accediendo a la siguiente guía.

  • Internet connection: La CLI resuelve algunos valores del nodo. Si decide usar la herramienta sin estar conectado a internet, tendrá que pasar las opciones --network, --generation-hash, --namespace-id, and divisibility. Type bitxor-cli account generate --help para saber más sobre cada parámetro.

Obtener moneda de prueba

Para anunciar una transacción, el remitente debe pagar un fee para incentivar a quienes validan y aseguran la red y hacen funcionar la infraestructura. Este costo se paga en bitxor (BXR coin), la moneda nativa de la red pública.

Ahora que ha creado su primera cuenta, solicite bitxor unidades de bitxor tokens del testnet faucet. Navigate here el fondo de tokens de pruebas existente. Haga clic aquí (Navigate here), luego indique la cantidad de bitxor tokens a recibir, ingrese la dirección que se le asignó (Address) y haga clic en “CLAIM!”.

Después de que se confirme la transacción, verifique si su cuenta ha recibido bitxor Usando la herramienta command-line.

bitxor-cli account info --profile testnet

información de
┌──────────────────┬─────────────────┬─────────────────┬───────────────────┐
│ Token Id        │ Cantidad relativa │ Importe absoluto│ Altura de caducidad│
├──────────────────┼─────────────────┼─────────────────┼───────────────────┤
│ 5E62990DCAC5BE8A │ 750.0           │ 750000000       | Never             │
└──────────────────┴─────────────────┴─────────────────┴───────────────────┘

Note

Testnet faucet tiene una cantidad limitada de bitxor tokens y debe reponerse antes de que se agote. Si su prueba ha finalizado y le han sobrado bitxor tokens, envíelos de vuelta a la cuenta indicada en la página del testnet faucet.

Creando un projecto

Ahora que tiene su cuenta con los bitxor tokens necesarios, es hora de elegir el lenguaje de programación choose a programming language. Elija el que le resulte más cómodo o siga los requisitos de su proyecto.

A continuación, cree una carpeta para su nuevo proyecto y ejecute las instrucciones para el lenguaje seleccionado. Si ninguno de los lenguajes se ajusta a su proyecto, siempre puedee consultar la blockchain directamente usando la Puerta de Enlace REST gateway.

Note

Bitxor SDK requiere Node.js 12 LTS para ejecutarse.

  1. Crear un archivo. package.json

    npm init

  2. Instalar Bitxor SDK y libreria RxJS.

    npm install bitxor-sdk rxjs

  3. Instalar globalmente TypeScript dependency:

    npm install --global typescript
typescript --version

  4. Instalar ts-node para ejecutar archivos TypeScript con node.

    sudo npm install --global ts-node