3.帐户
帐户是一种资料存款结构，其中包含与私钥相关联的资讯和资产的记录。只有使用与帐户相关联的私钥进行签署，才能在区块链上更新资料。
3.1 创建帐户
帐户包含一对密钥，即私钥和公钥，以及地址和其他信息。首先，尝试随机创建一个帐户，并检查其中包含的信息。
创建一个新帐户
alice = sym.Account.generateNewAccount(networkType);
console.log(alice);
示例输出
> Account
address: Address {address: 'TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ', networkType: 152}
keyPair: {privateKey: Uint8Array(32), publicKey: Uint8Array(32)}
网络类型如下。
{104: 'MAIN_NET', 152: 'TEST_NET'}
生成公钥和私钥
console.log(alice.privateKey);
console.log(alice.publicKey);
> 1E9139CC1580B4AED6A1FE110085281D4982ED0D89CE07F3380EB83069B1****
> D4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD2
注意事项
如果私钥遗失，与该帐户相关的数据将无法更改，并且任何资金将会遗失。此外，私钥不得与他人分享，因为知道私钥将可完全存取该帐户。 在一般的网路服务中，密码是分配给「帐户 ID」的，因此密码可以从帐户更改，但在区块链中，私钥是密码，因此唯一的 ID（位址）会分配给私钥，因此无法从帐户更改或重新产生与帐户关联的私钥。
产生位址
aliceRawAddress = alice.address.plain();
console.log(aliceRawAddress);
> TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ
以上这些是操作区块链所需的最基本信息。建议进一步了解如何从私钥生成帐户，以及如何生成仅处理公钥和位址的类别。
从私钥生成帐户
alice = sym.Account.createFromPrivateKey(
"1E9139CC1580B4AED6A1FE110085281D4982ED0D89CE07F3380EB83069B1****",
networkType,
);
公钥类别的生成
alicePublicAccount = sym.PublicAccount.createFromPublicKey(
"D4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD2",
networkType,
);
console.log(alicePublicAccount);
示例输出
> PublicAccount
address: Address {address: 'TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ', networkType: 152}
publicKey: "D4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD2"
地址生成
aliceAddress = sym.Address.createFromRawAddress(
"TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ",
);
console.log(aliceAddress);
示例输出
> Address
address: "TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ"
networkType: 152
3.2 转帐交易到另一个帐户
创建账户并不仅仅意味着数据可以在区块链上传输。
公共区块链需要数据传输费用才能有效利用资源。
在 Symbol 区块链上，使用称为 XYM 的原生代币支付费用。
生成帐户后，将 XYM 发送到该帐户以支付交易费用（在后面的章节中描述）。
从水龙头接收 XYM
可以使用水龙头免费获得测试网 XYM。 对于主网交易，可以在交易所购买XYM，也可以使用NEMLOG、QUEST等打赏服务获得捐款。
测试网
主网
使用区块链浏览器
从水龙头转账到您创建的账户后，可以在浏览器中查看交易。
3.3 查看账户信息
检索节点存储的帐户信息
检索拥有的马赛克列表
accountRepo = repo.createAccountRepository();
accountInfo = await accountRepo.getAccountInfo(aliceAddress).toPromise();
console.log(accountInfo);
示例输出
> AccountInfo
address: Address {address: 'TBXUTAX6O6EUVPB6X7OBNX6UUXBMPPAFX7KE5TQ', networkType: 152}
publicKey: "0000000000000000000000000000000000000000000000000000000000000000"
> mosaics: Array(1)
0: Mosaic
amount: UInt64 {lower: 10000000, higher: 0}
id: MosaicId
id: Id {lower: 760461000, higher: 981735131}
公钥
客户端刚刚创建的、尚未参与区块链交易的账户信息不被记录。当地址首次出现在交易中时，帐户信息将存储在区块链上。因此，此时 publicKey 记为“00000...”。
UInt64
当数字太大时，JavaScript会溢出，因此ID和金额以UInt64的格式在SDK中进行管理。使用toString()将其转换为字符串，使用compact()将其转换为数字，使用toHex()将其转换为十六进制。
console.log("addressHeight:"); //Block height at which the address is recorded
console.log(accountInfo.addressHeight.compact()); //Numerics
accountInfo.mosaics.forEach((mosaic) => {
console.log("id:" + mosaic.id.toHex()); //Hexadecimal
console.log("amount:" + mosaic.amount.toString()); //String
});
使用COMPACT将一个太大的ID值反转为数值时，可能会导致错误。
Compacted value is greater than Number.Max_Value.
显示位数的调整
将拥有的代币数量作为整数值处理，以避免出现舍入误差。我们可以从代币定义中获取可分割性(divisibility)，因此可以使用该值显示所拥有的代币的精确数量。
mosaicRepo = repo.createMosaicRepository();
mosaicAmount = accountInfo.mosaics[0].amount.toString();
mosaicInfo = await mosaicRepo.getMosaic(accountInfo.mosaics[0].id).toPromise();
divisibility = mosaicInfo.divisibility; //Divisibility
if (divisibility > 0) {
displayAmount =
mosaicAmount.slice(0, mosaicAmount.length - divisibility) || "0" +
"." +
mosaicAmount.slice(-divisibility);
} else {
displayAmount = mosaicAmount;
}
console.log(displayAmount);
3.4 使用提示
加密和签名
为帐户生成的私钥和公钥均可用于常规加密和数字签名。即使应用程序存在可靠性问题，也可以在 p2p（端到端）的基础上验证数据的机密性和合法性。
预先准备：为连通性测试生成Bob帐户
bob = sym.Account.generateNewAccount(networkType);
bobPublicAccount = bob.publicAccount;
加密
用Alice的私钥和Bob的公钥加密，用Alice的公钥和Bob的私钥解密（AES-GCM格式）。
message = "Hello Symol!";
encryptedMessage = alice.encryptMessage(message, bob.publicAccount);
console.log(encryptedMessage);
> 294C8979156C0D941270BAC191F7C689E93371EDBC36ADD8B920CF494012A97BA2D1A3759F9A6D55D5957E9D
解密
decryptMessage = bob.decryptMessage(
new sym.EncryptedMessage(
"294C8979156C0D941270BAC191F7C689E93371EDBC36ADD8B920CF494012A97BA2D1A3759F9A6D55D5957E9D",
),
alice.publicAccount,
).payload;
console.log(decryptMessage);
> "Hello Symol!"
签名
使用 Alice 的私钥对消息进行签名，并使用 Alice 的公钥和签名验证消息。
Buffer = require("/node_modules/buffer").Buffer;
payload = Buffer.from("Hello Symol!", "utf-8");
signature = Buffer.from(sym.KeyPair.sign(alice.keyPair, payload))
.toString("hex")
.toUpperCase();
console.log(signature);
> B8A9BCDE9246BB5780A8DED0F4D5DFC80020BBB7360B863EC1F9C62CAFA8686049F39A9F403CB4E66104754A6AEDEF8F6B4AC79E9416DEEDC176FDD24AFEC60E
验证
isVerified = sym.KeyPair.verify(
alice.keyPair.publicKey,
Buffer.from("Hello Symol!", "utf-8"),
Buffer.from(signature, "hex"),
);
console.log(isVerified);
> true
请注意，不使用区块链的签名可能会被多次重复使用。
帐户管理
本节介绍如何管理您的帐户。
私钥不应以纯文本形式存储。以下是使用symbol-qr-library对私钥进行加密并使用密码保护存储的方法。
私钥加密
qr = require("/node_modules/symbol-qr-library");
//Passphrase-Locked account generation
signerQR = qr.QRCodeGenerator.createExportAccount(
alice.privateKey,
networkType,
generationHash,
"Passphrase",
);
//QR code display
signerQR.toBase64().subscribe((x) => {
//Example of displaying a QR code on an HTML body
(tag = document.createElement("img")).src = x;
document.getElementsByTagName("body")[0].appendChild(tag);
});
//Display accounts as encrypted JSON data
jsonSignerQR = signerQR.toJSON();
console.log(jsonSignerQR);
示例输出
> {"v":3,"type":2,"network_id":152,"chain_id":"7FCCD304802016BEBBCD342A332F91FF1F3BB5E902988B352697BE245F48E836","data":{"ciphertext":"e9e2f76cb482fd054bc13b7ca7c9d086E7VxeGS/N8n1WGTc5MwshNMxUiOpSV2CNagtc6dDZ7rVZcnHXrrESS06CtDTLdD7qrNZEZAi166ucDUgk4Yst0P/XJfesCpXRxlzzNgcK8Q=","salt":"54de9318a44cc8990e01baba1bcb92fa111d5bcc0b02ffc6544d2816989dc0e9"}}
此jsonSignerQR输出的QR码或文本可随时保存，以便恢复私钥。
加密私钥解密
//Assign stored text or text retrieved from a QR code scan into json signer QR
jsonSignerQR =
'{"v":3,"type":2,"network_id":152,"chain_id":"7FCCD304802016BEBBCD342A332F91FF1F3BB5E902988B352697BE245F48E836","data":{"ciphertext":"e9e2f76cb482fd054bc13b7ca7c9d086E7VxeGS/N8n1WGTc5MwshNMxUiOpSV2CNagtc6dDZ7rVZcnHXrrESS06CtDTLdD7qrNZEZAi166ucDUgk4Yst0P/XJfesCpXRxlzzNgcK8Q=","salt":"54de9318a44cc8990e01baba1bcb92fa111d5bcc0b02ffc6544d2816989dc0e9"}}';
qr = require("/node_modules/symbol-qr-library");
signerQR = qr.AccountQR.fromJSON(jsonSignerQR, "Passphrase");
console.log(signerQR.accountPrivateKey);
示例输出
> 1E9139CC1580B4AED6A1FE110085281D4982ED0D89CE07F3380EB83069B1****