现在您拥有了一个账户，您可以通过 Stellar 网络发送和接收资金。如果您还没有创建一个账户的话，请阅读入门指南的第二步。
大多数时候，您会把资产发送给另外一个拥有账户的人。然而在本教程中，您应当再创建一个账户，以此来模拟付款操作。
在 Stellar 中，付款、改变您的账户或交易各种货币等会改变总账的行为被称为操作。[1] 为了实际执行一项操作，您需要创建一项事务，它只是一组附带一些额外信息的操作，比如这项事务是哪个账户发起的，以及一个用于验证事务真实性的加密签名。[2]
如果事务中的任何操作失败，则所有操作都会失败。例如，假设您有 100 Lumens，您做了两次支付操作，每次支付 60 Lumens。如果您进行两项事务(每项事务有一个操作) ，第一项事务将成功，第二项事务将失败，因为您没有足够 Lumens。您会剩下 40 Lumens。然而，如果您将这两笔支付放在一项事务中，它们都会失败，并且您的账户中还会剩下 100 Lumens。
最后，每笔交易都要支付一小笔费用。就像账户的最低余额一样，这项费用可以让系统避免因大量的恶意交易而超负荷运转。这笔费用被称为基本费用，数额很小——每次操作的费用为 100 stroops (即 0.00001 XLM，当表示极小数额的时候 stroops 比 lumen 更方便)。一笔包含了两次操作的事务要花费 200 stroops。[3]
Stellar 以 XDR 编码的二进制格式存储和传输事务数据。[4] Stellar SDK 提供了一些工具来简化这些工作。下面是将 10 Lumens 发送到另一个账户的示例：
var StellarSdk = require('stellar-sdk');
StellarSdk.Network.useTestNetwork();
var server = new StellarSdk.Server('https://horizon-testnet.stellar.org');
var sourceKeys = StellarSdk.Keypair
.fromSecret('SCZANGBA5YHTNYVVV4C3U252E2B6P6F5T3U6MM63WBSBZATAQI3EBTQ4');
var destinationId = 'GA2C5RFPE6GCKMY3US5PAB6UZLKIGSPIUKSLRB6Q723BM2OARMDUYEJ5';
// 事务信息应该被保留，以便我们在无法确定事务状态的情况下重新提交它
var transaction;
// 首先，确认接收账户真实存在于网络中。
// 您也可以跳过这一步，但是如果接收账户不存在的话，事务将执行失败，但手续费还是会被扣除。
server.loadAccount(destinationId)
// 如果接收账户不存在的话，打印错误信息
.catch(StellarSdk.NotFoundError, function (error) {
throw new Error('The destination account does not exist!');
})
// 如果此处没有错误的话，载入您的账户的最新信息。
.then(function() {
return server.loadAccount(sourceKeys.publicKey());
})
.then(function(sourceAccount) {
// 开始构建一个事务。
transaction = new StellarSdk.TransactionBuilder(sourceAccount)
.addOperation(StellarSdk.Operation.payment({
destination: destinationId,
// 因为 Stellar 允许用户发送多种类型的资产，所以您需要指定资产类型。
// "native" 代表着原生资产 Lumens。
asset: StellarSdk.Asset.native(),
amount: "10"
}))
// 您可以将备注信息添加在事务的 memo 中。这是一个可选值。
.addMemo(StellarSdk.Memo.text('Test Transaction'))
.build();
// 签署这个事务，这表明您同意执行该事务。
transaction.sign(sourceKeys);
// 最后，将它发送到 Stellar 网络上。
return server.submitTransaction(transaction);
})
.then(function(result) {
console.log('Success! Results:', result);
})
.catch(function(error) {
console.error('Something went wrong!', error);
// 如果结果未知（没有回应信息，超时等），我们可以简单的重新提交这个已经构建好的事务。
// server.submitTransaction(transaction);
});
Network.useTestNetwork();
Server server = new Server("https://horizon-testnet.stellar.org");
KeyPair source = KeyPair.fromSecretSeed("SCZANGBA5YHTNYVVV4C3U252E2B6P6F5T3U6MM63WBSBZATAQI3EBTQ4");
KeyPair destination = KeyPair.fromAccountId("GA2C5RFPE6GCKMY3US5PAB6UZLKIGSPIUKSLRB6Q723BM2OARMDUYEJ5");
// 首先，确认接收账户真实存在于网络中。
// 您也可以跳过这一步，但是如果接收账户不存在的话，事务将执行失败，但手续费还是会被扣除。
// 如果接收账户不存在或是有其它错误，这里会抛出 HttpResponseException 异常。
server.accounts().account(destination);
// 如果此处没有错误的话，载入您的账户的最新信息。
AccountResponse sourceAccount = server.accounts().account(source);
// 开始构建一个事务。
Transaction transaction = new Transaction.Builder(sourceAccount)
.addOperation(new PaymentOperation.Builder(destination, new AssetTypeNative(), "10").build())
// 您可以将备注信息添加在事务的 memo 中。这是一个可选值。
.addMemo(Memo.text("Test Transaction"))
.build();
// 签署这个事务，这表明您同意执行该事务。
transaction.sign(source);
// 最后，将它发送到 Stellar 网络上。
try {
SubmitTransactionResponse response = server.submitTransaction(transaction);
System.out.println("Success!");
System.out.println(response);
} catch (Exception e) {
System.out.println("Something went wrong!");
System.out.println(e.getMessage());
// 如果结果未知（没有回应信息，超时等），我们可以简单的重新提交这个已经构建好的事务。
// SubmitTransactionResponse response = server.submitTransaction(transaction);
}
package main
import (
"github.com/stellar/go/build"
"github.com/stellar/go/clients/horizon"
"fmt"
)
func main () {
source := "SCZANGBA5YHTNYVVV4C3U252E2B6P6F5T3U6MM63WBSBZATAQI3EBTQ4"
destination := "GA2C5RFPE6GCKMY3US5PAB6UZLKIGSPIUKSLRB6Q723BM2OARMDUYEJ5"
// 确认接收账户真实存在于网络中。
if _, err := horizon.DefaultTestNetClient.LoadAccount(destination); err != nil {
panic(err)
}
tx, err := build.Transaction(
build.TestNetwork,
build.SourceAccount{source},
build.AutoSequence{horizon.DefaultTestNetClient},
build.Payment(
build.Destination{destination},
build.NativeAmount{"10"},
),
)
if err != nil {
panic(err)
}
// 签署这个事务，这表明您同意执行该事务。
txe, err := tx.Sign(source)
if err != nil {
panic(err)
}
txeB64, err := txe.Base64()
if err != nil {
panic(err)
}
// 最后，将它发送到 Stellar 网络上。
resp, err := horizon.DefaultTestNetClient.SubmitTransaction(txeB64)
if err != nil {
panic(err)
}
fmt.Println("Successful Transaction:")
fmt.Println("Ledger:", resp.Ledger)
fmt.Println("Hash:", resp.Hash)
}
到底发生了什么？ 让我们来逐步的分析一下。
通过从 Stellar 网络加载收款账户 ID 的数据，确认该账户确实存在于 Stellar 网络中。如果您跳过这个步骤，代码仍然可以正常运行，但是载入账户数据可以让您避免提交一项失败的事务。您还可以在此检查可能要在目标账户上执行的任何其他验证。例如，如果您正在编写银行软件，您可以在这里插入监管合规性检查和 KYC 验证。
server.loadAccount(destinationId)
.then(function(account) { /* 验证账户 */ })
server.accounts().account(destination);
if _, err := horizon.DefaultTestNetClient.LoadAccount(destination); err != nil {
panic(err)
}
加载要付款账户的数据。一个账户一次只能执行一个事务[5]，每个账户都有一个序列号，它这个序号可以帮助 Stellar 验证事务的顺序。事务的序列号需要与账户的序列号相匹配，因此您需要从网络中获取账户的当前序列号。
.then(function() {
return server.loadAccount(sourceKeys.publicKey());
})
AccountResponse sourceAccount = server.accounts().account(source);
当您构建一项事务时，SDK 会自动增加账户的序列号，因此如果您想执行第二项事务，无需再次查询序列号。
开始建立一个交易。这需要一个账户对象，而不仅仅是一个账户 ID，因为这个操作将使账户的序列号增加。
var transaction = new StellarSdk.TransactionBuilder(sourceAccount)
Transaction transaction = new Transaction.Builder(sourceAccount)
tx, err := build.Transaction(
// ...
)
添加一个支付操作。值得注意的是，您需要指定您发送的资产类型——Stellar 的"原生"资产是 Lumen，但您可以发送任何类型的资产或货币，可以是美元或比特币，也可以是您信任的发行人发行的任何类型的资产（这里介绍了更多的细节）。但是在这里我们还是使用 Lumen，它在 SDK 中被称为 “原生 (native)” 资产：
.addOperation(StellarSdk.Operation.payment({
destination: destinationId,
asset: StellarSdk.Asset.native(),
amount: "10"
}))
.addOperation(new PaymentOperation.Builder(destination, new AssetTypeNative(), "10").build())
tx, err := build.Transaction(
build.TestNetwork,
build.SourceAccount{source},
build.AutoSequence{horizon.DefaultTestNetClient},
build.MemoText{"Test Transaction"},
build.Payment(
build.Destination{destination},
build.NativeAmount{"10"},
),
)
您应该注意到金额是一个字符串而不是一个数字。当处理极小或极大的值时，浮点数可能会引入误差。由于并非所有的系统都有一个原生的方法来精确地表示极小或极大的小数，Stellar 使用字符串作为一种可靠的方法来表示精确的值。
您还可以将元数据(在 Stellar 中被称为 “memo”)添加到事务中。Stellar 不会对这些数据做任何处理，但您可以将其用于任何您想要的目的。例如，如果您是一家代理其他人收款或付款的银行，您可能会在这里填写收付款的实际对象。
.addMemo(StellarSdk.Memo.text('Test Transaction'))
.addMemo(Memo.text("Test Transaction"));
build.MemoText{"Test Transaction"},
现在事务已经拥有了它所需要的所有数据，随后您必须使用您的私密种子对它进行加密签名。签名可以证明数据是由您提供的，而非他人冒充。
transaction.sign(sourceKeys);
transaction.sign(source);
txe, err := tx.Sign(source)
txeB64, err := txe.Base64()
最后让我们把它提交到 Stellar 网络上。
server.submitTransaction(transaction);
server.submitTransaction(transaction);
resp, err := horizon.DefaultTestNetClient.SubmitTransaction(txeB64)
重要 由于 bug、网络状况等原因，您可能无法收到 Horizon 服务器的响应。在这种情况下，您将无法确定事务的状态。因此我们应该始终将构建的事务(或以 XDR 格式编码的事务)保存在变量或数据库中，并在不知道其状态时重新提交它。如果交易已经成功地并入到总账中，Horizon 将直接返回事务的结果，并且不会再次尝试提交该事务。只有在交易状态未知（并且有机会被并入总账）的情况下，才会重新提交到网络。
你无需做任何事情就可以接收 Stellar 账户的付款——如果付款人成功地提交了将资产发送到你的账户的事务，那么这些资产将自动添加你的账户。
然而，您也许想知道某人是否真的支付了钱给您。如果您是一家代表他人接受付款的银行，您需要查明付款人给您支付了多少钱，以便您可以向指定的收件人支付资金。如果您经营的是零售业务，您需要在把商品交给他们之前确认他们是否已经支付过钱了。如果您是一辆拥有 Stellar 账户的自动出租汽车，您也许想要在前排座位上的顾客启动引擎之前确认他是否已经付了款。
下面是一个简单的程序，通过它您可以看到支付信息：
var StellarSdk = require('stellar-sdk');
var server = new StellarSdk.Server('https://horizon-testnet.stellar.org');
var accountId = 'GC2BKLYOOYPDEFJKLKY6FNNRQMGFLVHJKQRGNSSRRGSMPGF32LHCQVGF';
// 调用 API 接口查询与特定账户相关的支付信息。
var payments = server.payments().forAccount(accountId);
// 如果其中一些支付信息已经被处理了，那么您可以接着处理之后的支付信息。
// (该游标在 `handlePayment` 中保存)
var lastToken = loadLastPagingToken();
if (lastToken) {
payments.cursor(lastToken);
}
// `stream` 会一个个发送所有已有的支付信息，并且会保持连接以向您发送新产生的支付信息。
payments.stream({
onmessage: function(payment) {
// 记录游标，以便我们下次能从此处开始处理支付信息。
savePagingToken(payment.paging_token);
// 支付 Stream 包含了收款与付款信息，在这里我们只想处理收款信息。
if (payment.to !== accountId) {
return;
}
// 在 Stellar 的 API 中，Lumens 的资产类型为 "native"
// 其它类型的资产还包含了一些其它的字段。
var asset;
if (payment.asset_type === 'native') {
asset = 'lumens';
}
else {
asset = payment.asset_code + ':' + payment.asset_issuer;
}
console.log(payment.amount + ' ' + asset + ' from ' + payment.from);
},
onerror: function(error) {
console.error('Error in payment stream');
}
});
function savePagingToken(token) {
// 在大多数情况下，您应该将这个值储存在本地数据库或文件中，以便您在下次监听支付信息时使用它。
}
function loadLastPagingToken() {
// 从本地数据库或文件中获取最新的游标。
}
Server server = new Server("https://horizon-testnet.stellar.org");
KeyPair account = KeyPair.fromAccountId("GC2BKLYOOYPDEFJKLKY6FNNRQMGFLVHJKQRGNSSRRGSMPGF32LHCQVGF");
// 调用 API 接口查询与特定账户相关的支付信息。
PaymentsRequestBuilder paymentsRequest = server.payments().forAccount(account);
// 如果其中一些支付信息已经被处理了，那么您可以接着处理之后的支付信息。
// (该游标在 `handlePayment` 中保存)
String lastToken = loadLastPagingToken();
if (lastToken != null) {
paymentsRequest.cursor(lastToken);
}
// 会一个个发送所有已有的支付信息，并且会保持连接以向您发送新产生的支付信息。
paymentsRequest.stream(new EventListener<OperationResponse>() {
@Override
public void onEvent(OperationResponse payment) {
// 记录游标，以便我们下次能从此处开始处理支付信息。
savePagingToken(payment.getPagingToken());
// 支付 Stream 包含了收款与付款信息，在这里我们只想处理收款信息。
if (payment instanceof PaymentOperationResponse) {
if (((PaymentOperationResponse) payment).getTo().equals(account)) {
return;
}
String amount = ((PaymentOperationResponse) payment).getAmount();
Asset asset = ((PaymentOperationResponse) payment).getAsset();
String assetName;
if (asset.equals(new AssetTypeNative())) {
assetName = "lumens";
} else {
StringBuilder assetNameBuilder = new StringBuilder();
assetNameBuilder.append(((AssetTypeCreditAlphaNum) asset).getCode());
assetNameBuilder.append(":");
assetNameBuilder.append(((AssetTypeCreditAlphaNum) asset).getIssuer().getAccountId());
assetName = assetNameBuilder.toString();
}
StringBuilder output = new StringBuilder();
output.append(amount);
output.append(" ");
output.append(assetName);
output.append(" from ");
output.append(((PaymentOperationResponse) payment).getFrom().getAccountId());
System.out.println(output.toString());
}
}
});
````
```go
package main
import (
"context"
"fmt"
"github.com/stellar/go/clients/horizon"
)
func main() {
const address = "GC2BKLYOOYPDEFJKLKY6FNNRQMGFLVHJKQRGNSSRRGSMPGF32LHCQVGF"
ctx := context.Background()
cursor := horizon.Cursor("now")
fmt.Println("Waiting for a payment...")
err := horizon.DefaultTestNetClient.StreamPayments(ctx, address, &cursor, func(payment horizon.Payment) {
fmt.Println("Payment type", payment.Type)
fmt.Println("Payment Paging Token", payment.PagingToken)
fmt.Println("Payment From", payment.From)
fmt.Println("Payment To", payment.To)
fmt.Println("Payment Asset Type", payment.AssetType)
fmt.Println("Payment Asset Code", payment.AssetCode)
fmt.Println("Payment Asset Issuer", payment.AssetIssuer)
fmt.Println("Payment Amount", payment.Amount)
fmt.Println("Payment Memo Type", payment.Memo.Type)
fmt.Println("Payment Memo", payment.Memo.Value)
})
if err != nil {
panic(err)
}
}
这个程序由两个主要部分组成。首先，为涉及给定账户的支付创建一个查询。与 Stellar 中的大多数查询一样，这可能返回大量的条目，因此 API 返回分页信息，您可以稍后使用这些信息从之前中断的地方开始查询。在上面的例子中，保存和加载分页信息的函数是空白的，但是在一个真正的应用程序中，您需要将分页信息保存到一个文件或者数据库中，这样您就可以在程序崩溃或者用户关闭它的情况下使用分页信息从中断的地方继续查询。
var payments = server.payments().forAccount(accountId);
var lastToken = loadLastPagingToken();
if (lastToken) {
payments.cursor(lastToken);
}
PaymentsRequestBuilder paymentsRequest = server.payments().forAccount(account)
String lastToken = loadLastPagingToken();
if (lastToken != null) {
paymentsRequest.cursor(lastToken);
}
其次，查询的结果是以 Stream 流提供的，这是监听支付信息最简单的方式。Stream 会推送所有已存在的支付信息，当所有信息推送完成后，Stream 会保持开启的状态，一旦有新的支付行为，Stream 便会推送该支付信息。
尝试一下: 运行这个程序，然后在另一个窗口中创建并提交付款。您应该能看到这个程序打印出支付记录。
payments.stream({
onmessage: function(payment) {
// 处理支付信息。
}
});
paymentsRequest.stream(new EventListener<OperationResponse>() {
@Override
public void onEvent(OperationResponse payment) {
// 处理支付信息。
}
});
您也可以分组或分页查询支付信息。当您处理完一页付款信息后，您可以获取并处理下一页。
payments.call().then(function handlePage(paymentsPage) {
paymentsPage.records.forEach(function(payment) {
// 处理支付信息。
});
return paymentsPage.next().then(handlePage);
});
Page<OperationResponse> page = payments.execute();
for (OperationResponse operation : page.getRecords()) {
// 处理付款信息
}
page = page.getNextPage();
Stellar 网络最让人惊叹的一点便是您可以收发多种类型的资产，比如美元、尼日利亚奈拉、比特币等数字资产，甚至是您自己发行的新资产。
Stellar 的原生资产是 Lumens，所有其他资产可以被认为是某个特定账户发行的信贷。事实上，当您在 Stellar 网络上交易美元时，您并不是在交易真正的美元，而是在交易某个特定账户发行的美元信贷。这就是为什么上面例子中的资产既有 code 又有 issuer。issuer 是创建资产的帐户的 ID。在您信任某个资产前请先确保您对这个账户有所了解，确保它能够将您在 Stellar 网络中的资产兑换为真实世界的资产。正因为如此，您通常只会信任由大型金融机构发行的国家货币。
Stellar 还支持允许发送者发送一种货币，而接收者收到另外一种货币。您可以发送奈拉（尼日利亚的货币单位）给在德国的朋友，而他们却能够收到欧元。这种货币兑换是通过一种内置的交易市场机制实现的，在这种机制下，人们可以购买和出售不同类型的资产。Stellar 会自动找到最佳的兑换模式，以便将您的奈拉兑换成欧元。这个系统被称为分布式交易所
您可以在资产概述中阅读有关资产详细信息的更多内容。
现在您已经能够使用 Stellar 的 API 进行付款和收款了，您可以开始编写各种令人惊叹的财务软件了。您也可以开始尝试 Stellar 的其它 API，然后阅读一些更加深入的主题：
这 100 stroops 被称为恒星的基本费用。基本费用是可以调整的，但是它可能多年才会调整一次。您可以通过检查最新的总账信息查询当前的费用。 ↩︎
尽管 Horizon REST API 的大部分响应都使用 JSON，但 Stellar 中的大部分数据实际上是以一种称为 XDR(External Data Representation) 的格式存储的。使用 XDR 编码的数据比用 JSON 编码的数据更小，并且以更规范的方式存储数据，这使得签名和验证 XDR 编码的消息更加容易。您可以在此获取更多有关 XDR 的信息。 ↩︎
在需要在短时间内执行大量事务的情况下(例如，一家银行可能使用一个 Stellar 账户代表多个客户执行事务) ，您可以创建多个 Stellar 账户同时工作。在 channels 指南中了解更多信息 ↩︎