Stellar区块链开发入门

区块链技术 11 4 月 22, 2024 0 区块链315

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：