Stellar区块链对接教程

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()

6、Stellar补充技能

• 你可以浏览Stellar网络中的交易，查看这个示例。
• 交易的元数据保存为XDR格式，你可以在这里进行反序列化。
• 你可以查看指定公钥的所有交易，这是一个示例。

原文链接：Stellar区块链开发入门教程 - 汇智网