github.com/fibonacci-chain/fbc@v0.0.0-20231124064014-c7636198c1e9/libs/cosmos-sdk/docs/cn/clients/service-providers.md (about)

     1  # 服务提供商（Service Providers）
     2  
     3  我们将“服务提供商”定义为可以为最终用户提供服务的实体，这些实体涉及与基于 Cosmos-SDK 的区块链（包括Cosmos Hub）的某种形式的交互。更具体地说，本文档将集中于与 token 的交互。
     4  
     5  本节不涉及想要提供[轻客户端](https://github.com/cosmos/cosmos-sdk/tree/master/docs/interfaces/lite)功能的钱包开发者。服务提供商将作为最终用户的区块链的可信接入点。
     6  
     7  ## 架构的高级描述
     8  
     9  有三个主要部分需要考虑：
    10  
    11  - 全节点：与区块链交互。
    12   - Rest Server：它充当 HTTP 调用的中继者。
    13   - Rest API：为 Rest Server 定义可用端点。
    14  
    15  ##运行全节点
    16  
    17  ###安装和配置
    18  
    19  我们将描述为 Cosmos Hub 运行和交互全节点的步骤。对于其他基于 SDK 的区块链，该过程是类似的。
    20  
    21  首先，您需要[安装软件](../cosmos-hub/installation.md).
    22  
    23  然后，您可以开始[运行全节点](../cosmos-hub/join-testnet.md).
    24  
    25  ### 命令行界面（CLI）
    26  
    27  接下来，您将用一些 CLI 命令与全节点交互。
    28  
    29  #### 创建秘钥对
    30  
    31  生成新秘钥（默认使用 secp256k1椭圆曲线算法）：
    32  
    33  ```bash
    34  gaiacli keys add <your_key_name>
    35  ```
    36  
    37  系统将要求您为此密钥对输入密码（至少8个字符）。该命令返回4个信息：
    38  
    39  - `NAME`: 秘钥名称。
    40  - `TYPE`：秘钥类型，总是`local`。
    41  - `ADDRESS`：您的地址，用于接收资金。
    42  - `PUBKEY`：您的公钥 Your public key. Useful for validators.
    43  - `MNEMONIC`： 由24个单词组成的助记词。 **将这个助记词保存在安全的地方**，它用于在您忘记密码时恢复您的私钥。
    44  
    45  您可以输入以下命令查看所有可用密钥：
    46  
    47  ```bash
    48  gaiacli keys list
    49  ```
    50  
    51  #### 检查您的余额
    52  
    53  收到代币到您的地址后，您可以输入以下命令查看帐户的余额：
    54  
    55  ```bash
    56  gaiacli account <YOUR_ADDRESS>
    57  ```
    58  
    59  *注意：当您查询没有 token 帐户的余额时，您将得到以下错误：找不到地址为<YOUR_ADDRESS>的帐户。这是预料之中的！我们正在努力改进我们的错误提示信息。*
    60  
    61  #### 通过 CLI 发送代币
    62  
    63  以下是通过 CLI 发送代币的命令：
    64  
    65  ```bash
    66  gaiacli tx send <from_key_or_address> <to_address> <amount> \
    67      --chain-id=<name_of_testnet_chain> 
    68  ```
    69  
    70  参数：
    71  - `<from_key_or_address>`: 发送账户的名称或地址。
    72  - `<to_address>`: 接收者地址。
    73  - `<amount>`: 接受`<value|coinName>`格式的参数，例如 `10faucetToken`。
    74  
    75  标识：
    76  
    77  - `--chain-id`: 此标志允许您指定链的ID，不同的testnet链和主链会有不同的 id。
    78  
    79  #### 帮助
    80  
    81  如果您需要进行其他操作，最合适的命令是：
    82  
    83  ```bash
    84  gaiacli 
    85  ```
    86  
    87  它将显示所有可用命令。对于每个命令，您可以使用`--help`标识来获取更多信息。 
    88  
    89  ## 设置 Rest 服务器
    90  
    91  Rest 服务器充当前端点和全节点之间的媒介。 Rest 服务器不必与全节点同一台计算机上运行。
    92  
    93  要启动 Rest 服务器：
    94  
    95  ```bash
    96  gaiacli rest-server --node=<full_node_address:full_node_port>
    97  ```
    98  
    99  Flags:
   100  - `--trust-node`: 布尔类型。如果为`true`，轻节点校验将被禁用。如果为`false`, 则会校验返回结果。 对于服务提供商，应将其设置为`true`。默认情况下，它设置为`true`。
   101  - `--node`: 全节点的IP地址和端口。格式为` <full_node_address:full_node_port>`。如果全节点在同一台机器上，则地址应为`tcp：// localhost：26657`。
   102  - `--laddr`: 此标识允许您指定 Rest 服务器的地址和端口（默认为“1317”）。通常只使用这个标识指定端口，此时只需输入“localhost”作为地址，格式为`<rest_server_address:port>`。
   103  
   104  
   105  ### 监听入向交易
   106  
   107  监听入向交易推荐的方法是通过 LCD 的以下端点定期查询区块链：
   108  
   109  <!-- [`/bank/balance/{address}`](https://cosmos.network/rpc/#/ICS20/get_bank_balances__address_) -->
   110  
   111  ## Rest API
   112  
   113  Rest API 记录了可用于与全节点交互的所有可用端点，您可以在[这里](https://cosmos.network/rpc/)查看。
   114  
   115  API 针对每种类别的端点归纳为 ICS 标准。例如，[ICS20](https://cosmos.network/rpc/#/ICS20/)描述了API 与 token 的交互。
   116  
   117  为了给开发者提供更大的灵活性，我们提供了生成未签名交易、[签名](https://cosmos.network/rpc/#/ICS20/post_tx_sign)和[广播](https://cosmos.network/rpc/#/ICS20/post_tx_broadcast)等不同的 API 端点。这允许服务提供商使用他们自己的签名机制。
   118  
   119  为了生成一个未签名交易（例如 [coin transfer](https://cosmos.network/rpc/#/ICS20/post_bank_accounts__address__transfers)），你需要在`base_req`的主体中使用`generate_only`字段。
   120  
   121  ## Cosmos SDK 交易签名
   122  
   123  Cosmos SDK 签名是一个相当简单的过程。
   124  
   125  每个 Cosmos SDK 交易都有一个规范的 JSON 描述。 `gaiacli`和 REST 接口为交易提供规范的 JSON 描述，“广播”功能将提供紧凑的 Amino（类似 protobuf 的格式）编码转换。
   126  
   127  签名消息时的注意事项：
   128  
   129  格式如下
   130  
   131  ```json
   132  {
   133    "account_number": XXX,
   134    "chain_id": XXX,
   135    "fee": XXX,
   136    "sequence": XXX,
   137    "memo": XXX,
   138    "msgs": XXX
   139  }
   140  ```
   141  
   142  签名者必须提供 `"chain_id"`、 `"account number"` 和 `"sequence number"`。
   143  
   144  交易构造接口将生成 `"fee"`、 `"msgs"` 和 `"memo"` 等字段.
   145  
   146  You can load the mempool of a full node or validator with a sequence of uncommitted transactions with incrementing
   147  sequence numbers and it will mostly do the correct thing.  
   148  
   149  `"account_number"` 和 `"sequence"` 字段可以直接从区块链或本地缓存中查询。 错误的获取了这些数值和chainId，是产生无效签名错误的常见原因。您可以通过加载全节点或验证人中的 mempool 来获取未提交交易的自增序号，这样大大增加成功概率。
   150  
   151   您可以使用递增序列号的一系列未提交事务加载完整节点或验证器的mempool，它将主要执行正确的操作。
   152  
   153  在签名之前，所有键都要按字典顺序排序，并从 JSON 输出中删除所有空格。
   154  
   155  签名编码是 ECDSArands 的 64字节连结（即`r || s`），其中`s`按字典顺序小于其反转以防止延展性。 这就像以太坊一样，但没有用户公钥恢复的额外字节，因为 Tendermint 假定公钥一定会提供。
   156  
   157  已签名交易中的签名和公钥示例:
   158  
   159  ``` json
   160  {
   161    "type": "cosmos-sdk/StdTx",
   162    "value": {
   163      "msg": [...],
   164      "signatures": [
   165        {
   166          "pub_key": {
   167            "type": "tendermint/PubKeySecp256k1",
   168            "value": XXX
   169          },
   170          "signature": XXX
   171        }
   172      ],
   173    }
   174  }
   175  ```
   176  
   177  正确生成签名后，将 JSON 插入生成的交易中，然后调用广播端点进行广播。