Comenzando con la SDK de Xpring

Este tutorial te ayudará familiarte con la SDK de Xpring. Esta proporciona herramientas para que puedas desarrollar fácilmente aplicaciones en la plataforma de Xpring y así enviar y recibir valor dentro de sus aplicaciones. Para obtener más información sobre el diseño y la arquitectura de Xpring SDK, navega a La SDK de Xpring.

La SDK de Xpring está actualmente disponible para JavaScript, Java y Swift y provee soporte para:

  • PayID - El identificador universal para pagos.
  • Interledger - Conjunto de protocolos abiertos para enviar pagos a través de diferentes registros contables.
  • XRP Ledger - Es el hogar del XRP, un activo digital diseñado para unir las diferentes monedas en uso en todo el mundo..

Instala la librería de la SDK de Xpring

Sigue las instrucciones correspondientes para tu lenguaje preferido.

JavaScript

Instala el módulo Xpring-JS empleando npm:

$ npm i xpring-js

Java

Si utilizas Maven, puedes incluir las siguientes líneas en tu fichero pom.xml, dentro de la sección de dependencies:

<dependency>
  <groupId>io.xpring</groupId>
  <artifactId>xpring4j</artifactId>
  <version>1.0.0</version>
</dependency>


Si empleas Gradle, añade la siguiente línea a tu sección dependencies dentro de tu fichero build.gradle:

io.xpring:xpring4j:1.20

Swift

Puedes utilizar Carthage o CocoaPods para instalar la SDK de Xpring.

Para emplear Carthage , incluye esta línea en tu Cartfile.

github "xpring-eng/XpringKit"


Si prefieres utilizar CocoaPods , añade la siguiente línea en tu Podfile.

pod 'XpringKit'

Genera credenciales para la Testnet del XRP Ledger

El XRP Ledger está disponible tanto en Mainnet como Testnet. Testnet emplea tokens que no tienen valor, pero que funcionan de manera casi equivalente a la de la Mainnet. Estos tokens se denominan "XRP de prueba". XRP Ledger Parallel Networks .

Genera tus credenciales para la Testnet en el Portal de Xpring . Guarda estas credenciales para usarlas cuando generes una billetera programáticamente. Esta billetera se cargará con 1000 XRP de prueba, para que puedas experimentar con el envío y recepción de valor en la Testnet.

También puedes generar credenciales de Testnet con XRP Faucets . Puedes generar múltiples conjuntos de credenciales y utilizarlos para probar el envío y recepción de valor entre diferentes direcciones.

Ahora ya estás listo para crear una aplicación simple.

Crear una Aplicación Simple

Puedes crear una aplicación JavaScript simple que:

  1. Genera una billetera
  2. Connecta al servidor de Xpring
  3. Verifica tu balance
  4. Envía XRP de prueba

Las siguientes secciones proporcionan fragmentos de código JavaScript que demuestran estas capacidades de la SDK de Xpring.

Genera una billetera

Genera una billetera utilizando el seed (Secret) de los credenciales de Testnet que obtuviste previamente.

const { Wallet } = require("xpring-js");
const seedWallet = Wallet.generateWalletFromSeed("ssZYH1B6yhcAHwRRNRTS1sqCMs7Pb");

Tip: La SDK de Xpring también soporta Billeteras Jerárquicas Deterministas (Hierarchical Deterministic, HD) .

Connecta al servidor

Para verificar balances y enviar XRP de prueba, tu aplicación debe conectarse al servidor alojado por Xpring que está conectado al XRP Ledger. Este servidor se encuentra en grpc.xpring.tech: 80.

const { Wallet, XRPClient } = require("xpring-js");
const seedWallet = Wallet.generateWalletFromSeed("ssZYH1B6yhcAHwRRNRTS1sqCMs7Pb");
const remoteURL = "grpc.xpring.tech:80";
const xrpClient = new XRPClient(remoteURL);

Verifica tu balance

Antes de enviar XRP de prueba, debes verificar tu balance.

const testNetAddress = seedWallet.getAddress();
const balance = await xrpClient.getBalance(testNetAddress);

Envía XRP de prueba

Para enviar XRP de prueba, usa la billetera que has creado, la cantidad que especifiques y la dirección del destinatario que desees.

const amount = BigInt("10");
const recipientAddress = "X7u4MQVhU2YxS4P9fWzQjnNuDRUkP3GM6kiVjTjcQgUU3Jr";
const result = await xpringClient.send(amount, recipientAddress, seedWallet)

Más ejemplos

Para más ejemplos, visita el Repositorio de Xpring-JS en GitHub .