Getting Started With Xpring SDK

This tutorial familiarizes you with Xpring SDK. Xpring SDK provides tools so that you can readily develop apps on Xpring Platform, and thus send and receive value within your apps. For more information about the design and architecture of Xpring SDK, see What is Xpring and the Xpring SDK?.

Xpring SDK is currently available for JavaScript, Java, and Swift.

Install the Xpring SDK library

Follow the corresponding instructions for your preferred language.

JavaScript

Install the Xpring-JS package using npm:

$ npm i xpring-js
Java

If you are using Maven, then in your Java project, add the following lines to your pom.xml file in the dependencies object:

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


If you are using Gradle, then in your Java project, add the following line to your dependencies section in your build.gradle file:

io.xpring:xpring4j:1.20
Swift

You can use either Carthage or CocoaPods to install Xpring SDK for Swift.

To install via Carthage, add the following line to your Cartfile.

github "xpring-eng/XpringKit"


To install via CocoaPods, add the following line to your Podfile.

pod 'XpringKit'

Obtain credentials for the XRP Ledger Testnet

The XRP Ledger is available on both Mainnet and Testnet. Testnet disburses tokens that have no value, but otherwise functions in an nearly equivalent manner to Mainnet. These tokens are referred to as "test XRP." See XRP Ledger Parallel Networks.

Generate your credentials for Testnet at Xpring Portal. Save these credentials for use when generating a wallet programmatically. This wallet will be loaded with the test equivalent of 1000 XRP, so you can experiment with sending and receiving value on Testnet.

You can also generate Testnet credentials with XRP Faucets. You can generate multiple sets of credentials, and use these to test sending and receiving value between different addresses.

You are now ready to build a simple app.

Build a Simple App

You can build a simple JavaScript app that:

  1. Generates a wallet
  2. Connects to Xpring server
  3. Checks balances
  4. Sends test XRP

The following sections provide JavaScript code snippets that demonstrate these Xpring SDK capabilities.

Generate wallet

Build a wallet using the seed (Secret) from the Testnet credentials that you previously obtained.

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

Tip: Xpring SDK also supports Hierarchical Deterministic (HD) Wallets.

Connect to server

To check balances and send test XRP, your app must connect to the Xpring-hosted server that is connected to the XRP Ledger. You can reach this endpoint at grpc.xpring.tech:80.

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

Before sending test XRP, you should check your balance.

const testNetAddress = seedWallet.getAddress();
const balance = await xpringClient.getBalance(testNetAddress);
Send test XRP

To send test XRP, you use the wallet you have created, the amount you have specified, and the recipient address you have specified.

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

More examples

For more examples, see the Xpring-JS repository on GitHub.


XRP Ledger

XRP Ledgerはオープンで所有者のいないテクノロジーです。XRP Ledgerを利用してすぐに構築を開始できます。

使用開始方法

構築を開始する:
  • Xpring SDK
    XRP Ledgerで構築するための言語固有のライブラリ。JavaScriptSwiftで利用できます。
  • XRP API
    XRP Ledger用のRESTに類似したAPI。
  • XRP Ledger Explorer
    XRP Ledgerをリアルタイムで監視します。
  • XRP Devnet
    プロトコルのベータバージョンをテストします。
  • XRP Testnet
    Ledgerの最新の安定版に照らしてアプリケーションをテストします。
詳細:

インターレジャー

オープン標準を利用して、サイトやアプリに通貨を統合できます。

使用開始方法

構築を開始する:
  • ILP Wallet
    ILPの最新バージョンでアプリをテストします。
  • XpringSDK
    Interledgerをアプリケーションに組み込む最も簡単な方法
  • SDK Demos
    Java、Javascript、およびSwiftで実際のSDKを見る
詳細:

Web Monetization

コンテンツクリエイター向けの新しいインターネットネイティブの収益モデル。

使用開始方法

構築を開始する:
詳細:

ユースケース

Xpringは価値のインターネットを構築するための開発者向けのツールを作り上げています。

ウォレットと取引所

XRPは究極のブリッジ通貨です。XRPをウォレットや取引所に追加してください。

構築を開始する:
詳細:

コンテンツ

Web Monetization標準は、インターネットのネイティブアーキテクチャに組み込まれた新しい収益モデルです。広告はなく、中間業者もいません。自ら作成したものに対して対価を受け取る。利用したものに対して支払う。それだけです。

詳細:
  • Grant for the Webの発表
    Coil、Mozilla、Creative Commonsが、クリエイターに助成金を提供してオープンWeb Monetization標準を奨励するために、1億米国ドルの助成金Grant for the Webを立ち上げています。
  • Grant for the Web
    Web Monetizationのオープンかつ公正で包括的な標準とイノベーションを奨励するイニシアチブ。
  • Coil
    何かを作成してオンラインに載せれば、対価を受け取れます。他のクリエーターが作成したコンテンツに対して対価を支払うことができます。

ゲーム

プレイヤーがゲーム内の資産を保有して、それを他の資産や通貨と取引できる、新しいゲーミングエコノミーを実現します。

詳細:
Top