This repository has been archived by the owner on Sep 22, 2023. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 38
/
setup-wallets.html
221 lines (192 loc) · 14.9 KB
/
setup-wallets.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="The protocol for connecting blockchains and other ledgers">
<!-- Bootstrap core CSS -->
<link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">
<!-- Custom styles -->
<link href="/assets/css/custom.css" rel="stylesheet">
<!-- Google fonts -->
<link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,300,200,600,700,900|Droid+Sans+Mono|Titillium+Web:400,300,600,900' rel='stylesheet' type='text/css'>
<link href="/assets/img/favicon.png" rel="icon" type="image/x-icon">
<!-- highlight js -->
<link rel="stylesheet" href="/assets/css/monokai-sublime.css">
<!-- fontawesome icons -->
<link rel="stylesheet" href="/assets/fontawesome/css/font-awesome.min.css" />
<!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
<script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
<![endif]-->
</head>
<body class="sidebar-primary ">
<!-- <div class="container"> -->
<nav class="navbar fixed-top navbar-expand-lg navbar-dark nav-innerpage">
<div class="navbar-leftbg"><a href="/" class="navbar-brand"><img src="/assets/img/[email protected]" class="logo" height="44" alt="Interledger" /></a></div>
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#navbarHolder" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
<span class="navbar-toggler-icon"></span>
</button>
<div class="collapse navbar-collapse justify-content-end" id="navbarHolder">
<ul class="nav navbar-nav">
<li class="nav-item" ><a class="nav-link" href="/overview.html">Docs</a></li>
<li class="nav-item" ><a class="nav-link" href="/libraries.html">Tools</a></li>
<li class="nav-item" ><a class="nav-link" href="/community.html">Community</a></li>
<li class="nav-item"><a class="nav-link" target="_blank" href="https://github.com/interledger">Edit on Github</a></li>
<li class="nav-item"><a class="nav-link cornerlink" href="/overview.html">Get Started</a></li>
</ul><!-- /.navbar-nav -->
<div class="cornerbox"></div>
</div>
<div class="menu-overlay"></div>
</nav>
<!-- </div> -->
<div class="container-fluid" role="document" id="main_content_wrapper">
<div class="row">
<aside class="sidebar col-md-4 col-lg-3 p-0 order-md-1" role="complementary">
<div id="sidenav" class="tree_nav">
<ul class=" sidebar_pagelist">
<li class="nav-label">Getting Started</li>
<ul class=" sidebar_pagelist sidebar_indent">
<li><a href="/overview.html">Overview</a></li>
<li><a href="/setup-wallets.html">Set Up and Use Interledger Accounts</a></li>
<li><a href="/setup-wallets-programmatically.html">Manage Interledger Accounts Programmatically</a></li>
<li><a href="/spin-up-local-network.html">Spin Up a Local ILP Network</a></li>
</ul>
</ul>
<ul class=" sidebar_pagelist">
<li class="nav-label">Community Resources</li>
<li><a class="external-link" href="https://medium.com/interledger-blog">Blog and Tutorials<i class="fa fa-external-link" aria-hidden="true"></i></a></li>
<li><a href="/libraries.html">Libraries and Tools</a></li>
<li><a href="/summit-2019.html">ILP Summit 2019 Videos</a></li>
</ul>
<div class="sidebar-nav-header">Specs</div>
<ul class=" sidebar_pagelist sidebar_indent">
<li><a href="/rfcs/0027-interledger-protocol-4/">Interledger Protocol 4 (ILPv4)</a></li>
<li><a href="/rfcs/0015-ilp-addresses/">Interledger Addresses</a></li>
<li><a href="/rfcs/0029-stream/">STREAM Protocol</a></li>
<li><a href="/rfcs/0009-simple-payment-setup-protocol/">Simple Payment Setup Protocol (SPSP)</a></li>
<li><a href="/rfcs/0030-notes-on-oer-encoding/">Notes on OER encoding</a></li>
<li><a href="/rfcs/0031-dynamic-configuration-protocol/">Dynamic Configuration Protocol (ILDCP)</a></li>
<li><a href="/rfcs/0032-peering-clearing-settlement/">Peering, Clearing and Settlement</a></li>
<li><a href="/rfcs/0038-settlement-engines/">Settlement Engines</a></li>
<li><a href="/rfcs/0035-ilp-over-http/">ILP over HTTP</a></li>
<li><a href="/rfcs/0036-spsp-pull-payments/">SPSP Pull Payments</a></li>
<li> </li>
<li><a class="external-link" target="_blank" href="https://paymentpointers.org">Payment Pointers</a></li>
<li><a class="external-link" target="_blank" href="https://webmonetization.org">Web Monetization</a></li>
<li><a class="external-link" target="_blank" href="https://w3c.github.io/webpayments/proposals/interledger-payment-method.html">W3C Web Payments</a></li>
</ul>
</div> </aside>
<!-- main column -->
<main class="main col-md-8 col-lg-6 order-md-3 " role="main" id="main_content_body">
<article class="pt-3 p-md-3">
<div class="content doc-content">
<h1 id="main-page-header">Get Started With Interledger Accounts</h1>
<p class="blurb">Make payments on a testnet.</p>
<p>To get started using Interledger, we'll walk through using a test network, which uses fake money, rather than transferring real value. This Interledger testnet is currently maintained by teams at <a class="external-link" href="https://xpring.io/" target="_blank">Xpring <i aria-hidden="true" class="fa fa-external-link"></i></a> and <a class="external-link" href="https://coil.com/" target="_blank">Coil <i aria-hidden="true" class="fa fa-external-link"></i></a>, but anyone can join.</p>
<p>The Xpring and Rafiki testnet connectors, both used in this tutorial, together form a network for users to practice sending and receiving test currency values.</p>
<p>With Interledger, all currency pairs that senders and receivers use are supported. For simplicity, this tutorial demonstrates sending and receiving test XRP only, but in practice senders and receivers can use different currencies. </p>
<p>This tutorial describes two ways to create an Interledger account to send and receive test funds:</p>
<ul>
<li>With a <a class="external-link" href="https://xpring.io" target="_blank">xpring.io <i aria-hidden="true" class="fa fa-external-link"></i></a> account</li>
<li>With a <a class="external-link" href="https://rafiki.money" target="_blank">rafiki.money <i aria-hidden="true" class="fa fa-external-link"></i></a> account</li>
</ul>
<p>Both of these types of Interledger accounts allow you to send and receive test funds, and are useful for developing and testing apps. These types of accounts can also be referred to as "wallet" accounts.</p>
<p>You can also interact with these wallets programmatically. See <a href="setup-wallets-programmatically.html">Use Interledger programmaticallly</a>.</p>
<p>If you want to send <em>actual</em> value in your app with an Interledger account, refer to the following open-source projects (contributions welcome):</p>
<ul>
<li><a class="external-link" href="https://connector.interledger4j.dev" target="_blank">Java Connector <i aria-hidden="true" class="fa fa-external-link"></i></a> — Actively maintained by Xpring and recommended for new production deployments.</li>
<li><a class="external-link" href="http://interledger.rs" target="_blank">Rust Connector <i aria-hidden="true" class="fa fa-external-link"></i></a> — Not actively maintained, but recommended to get started for its ease of use and feature-set.</li>
<li><a class="external-link" href="https://github.com/interledgerjs/ilp-connector" target="_blank">Javascript Connector <i aria-hidden="true" class="fa fa-external-link"></i></a> — Battle-tested in production.</li>
</ul>
<h3 id="1-create-interledger-wallet-accounts">1. Create Interledger Wallet Accounts</h3>
<p>For this tutorial, you should create both a xpring.io and rafiki.money wallet account.</p>
<h4 id="create-an-account-at-xpringio">Create an Account at xpring.io</h4>
<ol>
<li>Navigate to https://xpring.io and click <code>Create Dev Account</code>.</li>
<li>Log in to see the Xpring portal. Once logged-in, click on "Interledger Wallet" to get started.</li>
</ol>
<h4 id="create-an-account-at-httpsrafikimoney">Create an Account at https://rafiki.money</h4>
<p>The <a class="external-link" href="https://rafiki.money" target="_blank">rafiki.money <i aria-hidden="true" class="fa fa-external-link"></i></a> site also allows you to create an Interledger-enabled wallet that is compatible with the testnet wallet provided by Xpring. Use the following instructions to get setup:</p>
<ol>
<li>Open <a class="external-link" href="https://rafiki.money" target="_blank">rafiki.money <i aria-hidden="true" class="fa fa-external-link"></i></a>.</li>
<li>Click <strong>Create an account</strong> and follow the instructions. </li>
<li>Click <strong>Add account</strong> and enter a name for your account to create a new one. You can create multiple accounts if you want.</li>
<li>Click <strong>No default account set for Payment pointer. Click here to assign default account</strong>.</li>
<li>From the <strong>Default Account</strong> dropdown list, select an account and click <strong>Submit</strong> </li>
<li>Notice that you can send test XRP from any of these accounts, but the default account will be the recipient of any incoming testnet funds sent from another account.</li>
</ol>
<h3 id="2-locate-your-own-payment-pointer">2. Locate Your Own Payment Pointer</h3>
<ol>
<li>In each wallet, you will see a page with a payment pointer in the following formats: <code>$xpring.money/{your-account-name}</code> (Xpring Wallet) and <code>rafiki.money/p/{user-id}</code> (Rafki Money). As indicated by the payment pointer, each wallet is Interledger-enabled. </li>
<li>Because your new accounts don't have any test funds, you will want to add value to them. In Xpring, click the blue <code>Make it rain</code> button to get free money! In Rafki, click the <code>Add Funds</code> button.</li>
<li>If you want someone to pay you, provide them with your payment pointer. That's it!</li>
</ol>
<p>Note that when you subsequently log in to either testnet account, you will see the current state of your wallet with the current amount of test XRP. Your accounts can receive test XRP when you are not logged in. </p>
<h3 id="3-send-money-between-interledger-wallets">3. Send Money Between Interledger Wallets</h3>
<p>Once you have testnet funds in one of your wallets, you can send those funds to any other Interledger-enabled wallet.</p>
<ol>
<li>Sign in to your account at <a class="external-link" href="https://xpring.io" target="_blank">https://xpring.io <i aria-hidden="true" class="fa fa-external-link"></i></a></li>
<li>Look at the <strong>Send</strong> portion of the page on the right.</li>
<li>Enter the number of test XRP that you want to send.</li>
<li>Enter the payment pointer for the address you want to send test XRP to (hint: try one from <a class="external-link" href="https://rafiki.money" target="_blank">https://rafiki.money <i aria-hidden="true" class="fa fa-external-link"></i></a>).</li>
<li>Click <strong>Send</strong>.</li>
</ol>
<p>The amount of test XRP in the lower left adjusts to the new value. At the same time, if you have your rafiki.money wallet account open in another tab, you will see your balance in that wallet account go down.</p>
<p>Next, send the money back via the following steps:</p>
<ol>
<li>On the rafiki.money home page, click the account you want to use to send test XRP.</li>
<li>Click <strong>Send</strong> button (found in the upper-left of the screen).</li>
<li>Enter your Xpring <strong>Payment Pointer</strong>, the <strong>Amount (XRP)</strong>, and click <strong>Send</strong>.</li>
</ol>
<p>Experiment with sending and receiving test funds between payment pointers on different sites, adding more test funds to your accounts as desired. In this tutorial, there are no transaction costs for sending and receiving test funds, but a different Interledger implementation could impose transaction costs.</p>
</div>
</article>
</main>
<aside class="right-sidebar col-lg-3 order-lg-4 p-0" role="complementary">
<div class="card" id="page-toc-wrapper">
<div class="card-header">
<h4>On This Page</h4>
</div>
<ul class="card-body">
<li class="level-3"><a href="#1-create-interledger-wallet-accounts">1. Create Interledger Wallet Accounts</a></li>
<li class="level-3"><a href="#2-locate-your-own-payment-pointer">2. Locate Your Own Payment Pointer</a></li>
<li class="level-3"><a href="#3-send-money-between-interledger-wallets">3. Send Money Between Interledger Wallets</a></li>
</ul>
</div>
</aside>
</div><!--/.row (main layout)-->
</div>
<footer>
<div class="container">
<div class="row">
<div class="col-md-12">
<div class="col-sm-9 col-xs-12 float-left footertext">
<p><img src="/assets/img/[email protected]" height="44" alt="Interledger" align="left" /> Interledger Project<br><span>Documentation licensed under <a href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0.</a></span></p>
</div>
<div class="col-sm-3 col-xs-12 float-right">
<a href="https://twitter.com/interledger"><img src="/assets/img/Twitter.png"></a>
<a href="https://communityinviter.com/apps/interledger/interledger-working-groups-slack"><img src="/assets/img/Slack.png"></a>
</div>
</div>
</div>
</div>
</footer>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script src="/assets/js/bootstrap.min.js"></script>
<script src="/assets/js/highlight.pack.js"></script>
<script src="/assets/js/custom.js"></script>
<!-- <script src="/assets/js/home.js"></script> -->
<!-- <script type="text/javascript" src="/assets/js/svg-animation.js"></script> -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-68500608-1', 'auto');
ga('send', 'pageview');
</script>
</body>
</html>