附件

有时您需要在事务中提供一些其它的信息，但是这些信息无法存入备注(Memo)中，例如：KYC 信息、发票、简短说明。由于它的大小或私人性质，这些数据不应该放在总账中。您应该创建一个附件，Stellar 附件是一个 JSON 文档。此附件的 sha256 hash 作为备注(Memo)被包含在事务中。实际的附件文档可以通过其他途径发送给接收方，例如：通过接收方的认证服务器。

附件的结构

附件具有灵活的结构。它们可以选择性地包含以下字段，并且可以附加额外的信息。

{
  "nonce": "<nonce>",
  "transaction": {
    "sender_info": {
      "first_name": "<first_name>",
      "middle_name": "<middle_name>",
      "last_name": "<last_name>",
      "address": "<address>",
      "city": "<city>",
      "province": "<province>",
      "country": "<country in ISO 3166-1 alpha-2 format>",
      "date_of_birth": "<date of birth in YYYY-MM-DD format>",
      "company_name": "<company_name>"
    },
    "route": "<route>",
    "note": "<note>"
  },
  "operations": [
    {
      "sender_info": <sender_info>,
      "route": "<route>",
      "note": "<note>"
    },
    // ...
  ]
}

计算附件的 hash

要计算附件的 hash，需要对 JSON 对象进行字符串化并计算其 sha-256 hash。在 Node.js 中：

const crypto = require('crypto');
const hash = crypto.createHash('sha256');

hash.update(JSON.stringify(attachment));
var memoHashHex = hash.digest('hex');

您可以使用 TransactionBuilder.addMemo 方法向事务中添加该值。

发送附件

若要向接收方的认证服务器发送附件及事务中的散列，请阅读合规协议的文档以获取更多信息。

示例

var crypto = require('crypto');

var nonce = crypto.randomBytes(16);
var attachment = {
  "nonce": nonce.toString('hex'),
  "transaction": {
    "sender_info": {
      "name": "Sherlock Holmes",
      "address": "221B Baker Street",
      "city": "London NW1 6XE",
      "country": "UK",
      "date_of_birth": "1854-01-06"
    }
  },
  "operations": [
    // Operation #1: Payment for Dr. Watson
    {
      "route": "watson",
      "note": "Payment for helping to solve murder case"
    },
    // Operation #2: Payment for Mrs. Hudson
    {
      "route": "hudson",
      "note": "Rent"
    }
  ]
};

var hash = crypto.createHash('sha256');
hash.update(JSON.stringify(attachment));
var memoHashHex = hash.digest('hex');
console.log(memoHashHex);