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)}
networkType は以下の通りです。
{104: 'MAIN_NET', 152: 'TEST_NET'}
秘密鍵と公開鍵の導出
console.log(alice.privateKey);
console.log(alice.publicKey);
> 1E9139CC1580B4AED6A1FE110085281D4982ED0D89CE07F3380EB83069B1****
> D4933FC1E4C56F9DF9314E9E0533173E1AB727BDB2A04B59F048124E93BEFBD2
注意事項
秘密鍵を紛失するとそのアカウントに紐づけられたデータを操作することが出来なくなります。また、他人は知らないという秘密鍵の性質を利用してデータ操作の署名を行うので、秘密鍵を他人に教えてはいけません。組織のなかで秘密鍵を譲り受けて運用を続けるといった行為も控えましょう。 一般的な Web サービスでは「アカウント 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 を購入するか、投げ銭サービス(NEMLOG,QUEST)などを利用して寄付を募りましょう。
テストネット
- FAUCET(蛇口)
メインネット
エクスプローラーで確認
フォーセットから作成したアカウントへ送信が成功したらエクスプローラーで確認してみましょう。
- テストネット
- メインネット
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
クライアント側で作成しただけで、ブロックチェーンでまだ利用されていないアカウント情報は記録されていません。宛先として指定されて受信することで初めてアカウント情報が記録され、署名したトランザクションを送信することで公開鍵の情報が記録されます。そのため、publicKey は現在00000...表記となっています。
UInt64
JavaScript では大きすぎる数値はあふれてしまうため、id や amount は UInt64 という sdk の独自フォーマットで管理されています。文字列に変換する場合は toString()、数値に変換する場合は compact()、16 進数にする場合は toHex() で変換してください。
console.log("addressHeight:"); //アドレスが記録されたブロック高
console.log(accountInfo.addressHeight.compact()); //数値
accountInfo.mosaics.forEach((mosaic) => {
console.log("id:" + mosaic.id.toHex()); //16進数
console.log("amount:" + mosaic.amount.toString()); //文字列
});
大きすぎる id 値を compact で数値変換するとエラーが発生することがあります。
Compacted value is greater than Number.Max_Value.
表示桁数の調整
所有するトークンの量は誤差の発生を防ぐため、整数値で扱います。トークンの定義から可分性を取得することができるので、その値を使って正確な所有量を表示してみます。
mosaicRepo = repo.createMosaicRepository();
mosaicAmount = accountInfo.mosaics[0].amount.toString();
mosaicInfo = await mosaicRepo.getMosaic(accountInfo.mosaics[0].id).toPromise();
divisibility = mosaicInfo.divisibility; //可分性
if (divisibility > 0) {
displayAmount =
mosaicAmount.slice(0, mosaicAmount.length - divisibility) || "0" +
"." +
mosaicAmount.slice(-divisibility);
} else {
displayAmount = mosaicAmount;
}
console.log(displayAmount);
3.4 現場で使えるヒント
暗号化と署名
アカウントとして生成した秘密鍵や公開鍵は、そのまま従来の暗号化や電子署名として活用することができます。信頼性に問題点があるアプリケーションを使用する必要がある場合も、個人間（エンドツーエンド）でデータの秘匿性・正当性を検証することができます。
事前準備：対話のための 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");
//パスフレーズでロックされたアカウント生成
signerQR = qr.QRCodeGenerator.createExportAccount(
alice.privateKey,
networkType,
generationHash,
"パスフレーズ",
);
//QRコード表示
signerQR.toBase64().subscribe((x) => {
//HTML body上にQRコードを表示する例
(tag = document.createElement("img")).src = x;
document.getElementsByTagName("body")[0].appendChild(tag);
});
//アカウントを暗号化したJSONデータとして表示
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 コード、あるいはテキストを保存しておけばいつでも秘密鍵を復元することができます。
暗号化された秘密鍵の復号
//保存しておいたテキスト、あるいはQRコードスキャンで得られたテキストをjsonSignerQRに代入
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, "パスフレーズ");
console.log(signerQR.accountPrivateKey);
出力例
> 1E9139CC1580B4AED6A1FE110085281D4982ED0D89CE07F3380EB83069B1****