Stellar区块链开发入门

零了个发
更新于 2020-01-08 15:57
阅读 3158

Stellar区块链是一个广泛使用的区块链网络。本文将介绍使用JavaScript代码创建Stellar账户、进行Stellar账户充值、并向Stellar区块链提交账户间的转账交易，帮助大家快速了解Stellar区块链开发的基础知识。

## 1、Stellar概述

* 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白皮书](https://www.stellar.org/papers/stellar-consensus-protocol.pdf)。

* 使用Docker运行Stellar Core： 只要运行一个Stellar Core实例，就可以加入Stellar网络。我们可以使用Stellar/quickstart 这个docker镜像来快速创建一个Stellar Core实例。

* 测试链 : 对于开发者而言，幸运的是Stellar也提供了一个测试链供开发使用。你可以在[这里](https://www.stellar.org/developers/guides/concepts/test-net.html) 查看其详细信息。

## 2、Stellar开发概述

在继续学习之前，希望你对JavaScript、Express和Async/Await有初步的了解。

我们将在测试链上创建两个账户，然后充值这两个账户，并在这两个账户之间进行一些随意地转账。最后，我们希望使用交易浏览器提取交易信息。

你可以在[这里](https://github.com/michielmulders/stellar-js-sdk)找到本文涉及的完整代码。本文的结尾部分也有完整的代码。

## 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要求amount参数应当声明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网络中的交易，查看这个[示例](https://horizon-testnet.stellar.org/transactions/8380cde0b2300c087427edf6cae08abb12cdc5eea30c3ec129f45f0db37c7c09)。
交易的元数据保存为XDR格式，你可以在这里进行[反序列化](https://www.stellar.org/laboratory/#xdr-viewer?input=AAAAABQfUJxjNiLOX3QqcxCIcpFemEm7uI6aeT5GGyBKRmhiAAAAZAB0LFwAAAADAAAAAAAAAAAAAAABAAAAAAAAAAEAAAAA0bR27%2ByXbgKzVd7tOZ2VreBy%2BijKqULK5aH%2F7R2EvfkAAAAAAAAAABHhowEAAAAAAAAAAUpGaGIAAABA1jaHLjUwWPe6rDpQEjv4mGMOrmZ00Ab%2BePjK1yrPZg7vpN1s%2FgsEULgbwyEXIFtteKN1imSO6k1mRFDKYpiPBQ%3D%3D&type=TransactionEnvelope&network=public)。
你可以查看指定公钥的所有交易，这是一个[示例](https://horizon-testnet.stellar.org/accounts/GA47YQ3Y4UCUSOKGAR53L5WSM4AN34JQSGFQ2CMVELJVWN7IYOWI6PBB/operations?order=desc)。

原文链接：[Exploring Stellar Lumens — Development Tutorial](https://hackernoon.com/exploring-stellar-lumens-development-tutorial-cdf6d09a0e87)

1、Stellar概述

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有初步的了解。

我们将在测试链上创建两个账户，然后充值这两个账户，并在这两个账户之间进行一些随意地转账。最后，我们希望使用交易浏览器提取交易信息。

你可以在这里找到本文涉及的完整代码。本文的结尾部分也有完整的代码。

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要求amount参数应当声明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格式，你可以在这里进行反序列化。你可以查看指定公钥的所有交易，这是一个示例。

原文链接：Exploring Stellar Lumens — Development Tutorial

学分: 14
分类: Stellar
标签: Stellar

本文参与登链社区写作激励计划，好文好收益，欢迎正在阅读的你也加入。