恒星币Stellar对接教程
- 2019 年 10 月 30 日
- 筆記
Stellar区块链是一个广泛使用的区块链网络。在这个教程中，我们将学习使用JavaScript代码创建Stellar账户、进行Stellar账户充值、并向Stellar区块链提交账户间的转账交易。
1、Stellar概述
要快速掌握区块链和数字货币应用开发，推荐汇智网的区块链开发系列在线教程。 内容涵盖比特币、以太坊、EOS、超级账本、Tendermint等多种主流区块链 平台， 同时支持Java、C#、Python、PHP、JavaScript、Dart等多种开发 语言。
Horizon：应用程序通过Horizon开发接口与Stellar网络交互。Horizon是一个RESTful HTTP API服务器，利用Horizon API开发者可以提交交易，检查账户余额并订阅事件。你可以在web浏览器中使用Horizon API，或者使用cURL命令行访问Horizon API，不过最简单的方法就是使用官方提供的Stellar SDK，目前官方已经支持JavaScript、Java和Go，同时社区也开发了Python、C#和Ruby的SDK。
Stellar Core：是Stellar网络的主干，每个Horizon服务器都需要连接到Stellar Core。Stellar Core负责验证交易并达成共识。所有个体运行的Stellar Core形成了去中心化的Stellar网络，网络上的每个交易都需要支付一小笔费用：100 stroop（0.00001 XLM），交易手续费的目的是阻止网络上的垃圾信息。
Stellar共识协议 – SCP：SCP在安全和活性之间选择了安全 – 当出现分区事件或有行为异常的节点时，SCP会停止网络的运行，直到可以达成网络的共识。关于SCP的详细信息请参考Stellar白皮书。
使用Docker运行Stellar Core：只要运行一个Stellar Core实例，就可以加入Stellar网络。我们可以使用Stellar/quickstart这个docker镜像来快速创建一个Stellar Core实例。
测试链 对于开发者而言，幸运的是Stellar也提供了一个测试链供开发使用。你可以在这里查看其详细信息。
2、Stellar开发概述
在继续学习之前，希望你对JavaScript、Express和Async/Await有初步的了解。
我们将在测试链上创建两个账户，然后充值这两个账户，并在这两个账户之间进行一些随意地转账。最后，我们希望使用交易浏览器提取交易信息。总之，本教程的目的是让你快速了解Stellar区块链开发的基础知识。
你可以在这里找到本教程的完整代码。在本教程的结尾部分也有完整的代码。
3、创建Stellar账户
Stellar JavaScript SDK在所有官方SDK中是最稳定的一个。我们可以使用如下命令安装JS SDK：
npm i -S stellar-sdk
使用下面的JS代码来初始化一个连接测试链的Server实例：
const server = new Stellar.Server('https://horizon-testnet.stellar.org') Stellar.Network.useTestNetwork()
现在我们可以创建两个随机账户了。Stellar SDK提供了一个函数用于在不提供密码学种子的情况下创建随机密钥对：
let pairA = Stellar.Keypair.random() let pairB = Stellar.Keypair.random()
得到的Keypair对象提供了两个方法分别用于获取密钥对的公钥和密文种子：
- publicKey()：获取公钥
- secret()：获取密文种子
接下来我们定义初始化账户的路由。在下面的函数中，我们将向Stellar测试链上的friendbot发送请求以充值之前创建的密钥对账户。friendbot会自动给我们的账户分别充值10.000个Lumen。下面的代码使用request-promise包来发送请求给Horizon测试链API，这个包可以很好地配合async/await。我们在 查询字符串中传入要充值的公钥地址。
await rp.get({ uri: 'https://horizon-testnet.stellar.org/friendbot', qs: { addr: pairA.publicKey() }, json: true })
账户现在已经创建好了，但是我们在应用中还没有账户对象。使用如下的代码获取：
accountB = await server.loadAccount(pairB.publicKey())
现在可以检查我们的账户中是不是已经有了一些Stellar币了：
accountA.balances.forEach((balance) => { console.log('Type:', balance.asset_type, ', Balance:', balance.balance) })
上面的代码略加修改就可以获取账户B的余额，你可以试一下！
4、Stellar转账交易
一个交易（transaction）可以包含多个操作（operation）。出于简化考虑，我们将只使用转账操作。在下面的示例中将pairB的公钥作为转账目标地址，转账数量为30.000000001。Stellar SDK要求mount参数应当声明7位小数：
const transaction = new Stellar.TransactionBuilder(accountA) .addOperation(Stellar.Operation.payment({ destination: pairB.publicKey(), asset: Stellar.Asset.native(), amount: '30.0000001' })) .build()
酷！交易现在就等着发送账户进行签名了，我们可以使用transaction.sign(pairA)来进行这一步。好了，签完名就可以发送给Horizon了：
const transactionResult = await server.submitTransaction(transaction)
5、提取Stellar交易历史
下面的代码将每页仅返回一个交易。你可以使用historyPage的next()方法继续提取后续的交易：
let historyPage = await server.transactions() .forAccount(accountA.accountId()) .call()
我们要打印XDR编码的交易中的操作详情。首先需要解码为base64并迭代所有操作来显示发送的金额：
let txDetails = Stellar.xdr.TransactionEnvelope .fromXDR(historyPage.records[1].envelope_xdr, 'base64') txDetails._attributes.tx._attributes.operations .map(operation => console.log( `Transferred amount: ${operation._attributes.body._value._attributes.amount.low} XLM` ))
最后，让我们获取下一个historyPage：
historyPage = await historyPage.next()
