XpringKit is the Swift client-side library of the Xpring SDK.
Use XpringKit to perform these tasks:
- Generate and derive wallets (seed-based or HD-wallet-based)
- Validate addresses
- Retrieve account balances
- Send XRP payments
You can install XpringKit SDK with Carthage. Add the following to your Cartfile:
github "xpring-eng/XpringKit"
You can install XpringKit with CocoaPods. Add the following to your Podfile:
pod 'XpringKit'
To carry out tasks, Xpring SDK communicates with a rippled node which has gRPC enabled. Consult the rippled documentation to build your own node.
To get developers started right away, Xpring currently provides two hosted nodes: TestNet and MainNet.
TestNet is used to send and receive test funds, and is useful when you develop apps. MainNet is meant for production use to send and receive funds.
alpha.test.xrp.xpring.io:50051
alpha.xrp.xpring.io:50051
Note: Xpring SDK only works with the X-Address format. For more information about this format, see the Utilities section and http:https://xrpaddress.info.
A wallet is a fundamental model object in XpringKit that provides key management, address derivation, and signing functionality.
XpringKit can derive a wallet from a seed, or it can derive a hierarchical deterministic wallet (HDWallet) from a mnemonic and derivation path.
You can construct a seed-based wallet by passing a base58check encoded seed string.
import XpringKit
let seedWallet = Wallet(seed: "snRiAJGeKCkPVddbjB3zRwiYDBm1M")!A hierarchical deterministic wallet is created using a mnemonic and a derivation path. You pass the mnemonic and derivation path to the wallet generation function. If you omit the derivation path, a default path is used instead.
import XpringKit
let mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
let hdWallet1 = Wallet.generateWalletFromMnemonic(mnemonic: mnemonic)! // Has default derivation path
let hdWallet2 = Wallet(mnemonic: mnemonic, derivationPath: Wallet.defaultDerivationPath)! // Same as hdWallet1
let hdWallet = Wallet(mnemonic: mnemonic, derivationPath: "m/44'/144'/0'/0/1"); // Wallet with custom derivation path.XpringKit can generate a new and random HD Wallet. The result of a wallet generation call is a tuple which contains the following:
- A randomly generated mnemonic
- The derivation path used, which is the default path
- A reference to the new wallet
import XpringKit
// Generate a random wallet.
let generationResult = Wallet.generateRandomWallet()!
let newWallet = generationResult.wallet
// Wallet can be recreated with the artifacts of the initial generation.
let copyOfNewWallet = Wallet(mnemonic: generationResult.mnemonic, derivationPath: generationResult.derivationPath)A generated wallet can provide its public key, private key, and address on the XRP ledger.
import XpringKit
let mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about";
let wallet = Wallet(mnemonic: mnemonic)!
print(wallet.address) // XVMFQQBMhdouRqhPMuawgBMN1AVFTofPAdRsXG5RkPtUPNQ
print(wallet.publicKey) // 031D68BC1A142E6766B2BDFB006CCFE135EF2E0E2E94ABB5CF5C9AB6104776FBAE
print(wallet.privateKey) // 0090802A50AA84EFB6CDB225F17C27616EA94048C179142FECF03F4712A07EA7A4A wallet can also sign and verify arbitrary hex messages. Generally, users should use the functions on XRPClient to perform cryptographic functions rather than using these low-level APIs.
import XpringKit
let mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
let message = "deadbeef";
let wallet = Wallet(mnemonic: mnemonic)!
let signature = wallet.sign(message)
wallet.verify(message, signature); // trueXRPClient is a gateway into the XRP Ledger. XRPClient is initialized with a single parameter, which is the URL of the remote adapter (see: ‘Server Side Component’ section above).
import XpringKit
let remoteURL = "alpha.test.xrp.xpring.io:50051"; // TestNet URL, use
alpha.xrp.xpring.io:50051 for MainNet
let xrpClient = XRPClient(grpcURL: remoteURL)A XRPClient can check the balance of an account on the XRP Ledger.
import XpringKit
let remoteURL = "alpha.test.xrp.xpring.io:50051"; // TestNet URL, use alpha.xrp.xpring.io:50051 for MainNet
let xrpClient = XRPClient(grpcURL: remoteURL, useNewProtocolBuffers: true)
let address = "XVMFQQBMhdouRqhPMuawgBMN1AVFTofPAdRsXG5RkPtUPNQ"
let balance = try! xrpClient.getBalance(for: address)
print(balance) // Logs a balance in drops of XRPUse XRPClient to check the status of an transaction on the XRP Ledger.
XpringKit returns the following transaction states:
succeeded: The transaction was successfully validated and applied to the XRP Ledger.failed:The transaction was successfully validated, but not applied, to the XRP Ledger. Alternatively, the operation will never be validated.pending: The transaction has not yet been validated, but may be validated in the future.unknown: The transaction status could not be determined.
Note: For more information, see Reliable Transaction Submission and Transaction Results.
These states are determined by the TransactionStatus enum.
import XpringKit
let remoteURL = "talpha.test.xrp.xpring.io:50051"; // TestNet URL, use alpha.xrp.xpring.io:50051 for MainNet
let xrpClient = XRPClient(grpcURL: remoteURL, useNewProtocolBuffers: true)
let transactionHash = "9FC7D277C1C8ED9CE133CC17AEA9978E71FC644CE6F5F0C8E26F1C635D97AF4A"
let transactionStatus = xrpClient.getTransactionStatus(for: transactionHash) // TransactionStatus.succeededNote: The example transactionHash value might lead to a "Transaction not found." error as the TestNet is regularly reset, or the accessed node may only maintain one month of history. Recent transaction hashes can be found in the XRP Ledger Explorer .
A XRPClient can send XRP to other accounts on the XRP Ledger.
Note: The payment operation blocks the calling thread until the operation reaches a definitive and irreversible success or failure state.
import XpringKit
let remoteURL = "test.xrp.xpring.io:50051"; // TestNet URL, use main.xrp.xpring.io:50051 for MainNet
let xrpClient = XRPClient(grpcURL: remoteURL, useNewProtocolBuffers: true)
// Wallet which will send XRP
let generationResult = Wallet.generateRandomWallet()!
let senderWallet = generationResult.wallet
// Destination address.
let address = "X7u4MQVhU2YxS4P9fWzQjnNuDRUkP3GM6kiVjTjcQgUU3Jr"
// Amount of XRP to send, in drops.
let amount: UInt64 = 10
let transactionHash = try! xrpClient.send(amount, to: destinationAddress, from: senderWallet)Note: This example yields an "Account not found." error because the randomly generated wallet contains no XRP.
Use the Utils object to validate addresses.
import XpringKit
let rippleClassicAddress = "rnysDDrRXxz9z66DmCmfWpq4Z5s4TyUP3G"
let rippleXAddress = "X7jjQ4d6bz1qmjwxYUsw6gtxSyjYv5iWPqPEjGqqhn9Woti"
let bitcoinAddress = "1DiqLtKZZviDxccRpowkhVowsbLSNQWBE8"
Utils.isValid(address: rippleAddress); // returns true
Utils.isValid(address: bitcoinAddress); // returns falseYou can also validate if an address is an X-Address or a classic address.
import XpringKit
let rippleClassicAddress = "rnysDDrRXxz9z66DmCmfWpq4Z5s4TyUP3G"
let rippleXAddress = "X7jjQ4d6bz1qmjwxYUsw6gtxSyjYv5iWPqPEjGqqhn9Woti"
let bitcoinAddress = "1DiqLtKZZviDxccRpowkhVowsbLSNQWBE8"
Utils.isValidXAddress(address: rippleClassicAddress); // returns false
Utils.isValidXAddress(address: rippleXAddress); // returns true
Utils.isValidXAddress(address: bitcoinAddress); // returns false
Utils.isValidClassicAddress(address: rippleClassicAddress); // returns true
Utils.isValidClassicAddress(address: rippleXAddress); // returns false
Utils.isValidClassicAddress(address: bitcoinAddress); // returns falseUse XpringKit SDK to encode and decode X-Addresses.
import XpringKit
let rippleClassicAddress = "rnysDDrRXxz9z66DmCmfWpq4Z5s4TyUP3G"
let tag: UInt32 = 12345;
// Encode an X-Address.
let xAddress = Utils.encode(classicAddress: address, tag: tag) // X7jjQ4d6bz1qmjwxYUsw6gtxSyjYv5xRB7JM3ht8XC4P45P
// Decode an X-Address.
let classicAddressTuple = Utils.decode(xAddress: address)!
print(classicAddressTuple.classicAddress); // rnysDDrRXxz9z66DmCmfWpq4Z5s4TyUP3G
print(classicAddressTuple.tag); // 12345Pull requests are welcome! To get started with building this library and opening pull requests, please see contributing.md.
Thank you to all the users who have contributed to this library!
Xpring SDK is available under the MIT license. See the LICENSE file for more info.