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:

1
npm i -S stellar-sdk

使用下面的JS代码来初始化一个连接测试链的Server实例:

1
2
const server = new Stellar.Server('https://horizon-testnet.stellar.org')
Stellar.Network.useTestNetwork()

现在我们可以创建两个随机账户了。Stellar SDK提供了一个函数用于在不提供 密码学种子的情况下创建随机密钥对:

1
2
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。我们在 查询字符串中传入要充值的公钥地址。

1
2
3
4
5
await rp.get({
uri: 'https://horizon-testnet.stellar.org/friendbot',
qs: { addr: pairA.publicKey() },
json: true
})

账户现在已经创建好了,但是我们在应用中还没有账户对象。使用如下的代码 获取:

1
accountB = await server.loadAccount(pairB.publicKey())

现在可以检查我们的账户中是不是已经有了一些Stellar币了:

1
2
3
accountA.balances.forEach((balance) => {
console.log('Type:', balance.asset_type, ', Balance:', balance.balance)
})

上面的代码略加修改就可以获取账户B的余额,你可以试一下!

4、Stellar转账交易

一个交易(transaction)可以包含多个操作(operation)。出于简化考虑,我们将 只使用转账操作。在下面的示例中将pairB的公钥作为转账目标地址,转账数量为 30.000000001。Stellar SDK要求amount参数应当声明7位小数:

1
2
3
4
5
6
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了:

1
const transactionResult = await server.submitTransaction(transaction)

5、提取Stellar交易历史

下面的代码将每页仅返回一个交易。你可以使用historyPagenext()方法 继续提取后续的交易:

1
2
3
let historyPage = await server.transactions()
.forAccount(accountA.accountId())
.call()

我们要打印XDR编码的交易中的操作详情。首先需要解码为base64并迭代所有操作 来显示发送的金额:

1
2
3
4
5
6
7
8
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

1
historyPage = await historyPage.next()

6、Stellar补充技能

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

原文链接:Exploring Stellar Lumens — Development Tutorial

汇智网翻译整理,转载请标明出处