Skip to content

Latest commit

 

History

History
110 lines (80 loc) · 4.5 KB

ethereum.md

File metadata and controls

110 lines (80 loc) · 4.5 KB

Ethereum Lock

Here, we are conducting comparative testing using the official Ethereum tool go-ethereum (Version 1.12.2).

Install

Supported installation methods:

Within the geth package, there are multiple executable files. Here, we will focus on using geth and ethkey.

  • geth for creating accounts and generating addresses.
  • ethkey for signature and verification.

Note that if using a standalone bundle or building from source, it's advisable to add the installation directory to environment variables for ease of use.

Build from source code

Keep in mind that compiling geth requires a golang environment.

git clone https://github.com/ethereum/go-ethereum.git
cd go-ethereum
make all

As ethkey is required, we compile all components for convenience. The compiled results can be found in the build/bin directory. It's recommended to add this directory to 'PATH' environment variable for ease of use.

Address

First, A test account is required:

geth account new

Once created, look for this line in the output:

Public address of the key:   <BIN>
Path of the secret key file: <FILE_PATH>

Here, the account's address and private key file are displayed. To query account information again, use: geth account list.

In Ethereum, the Address is a 20-byte fixed-length array. When used in programs (geth and ckb-auth-cli), it will handle the leading 0x.

If automation testing is needed, the passwordfile and keystore parameters can be employed to handle password and key storage.

eth_password_file=`pwd`/password.txt
echo $RANDOM > $eth_password_file
eth_account_dir=`pwd`/account
rm -rf $eth_account_dir
mkdir -p $eth_account_dir
geth account new --password $eth_password_file --keystore $eth_account_dir > /dev/null 2>&1

eth_account_info=`geth account list --keystore $eth_account_dir 2>/dev/null`
eth_address=`echo $eth_account_info | grep -oE -m 1 '\{[a-f0-9]+\}' | sed 's/{\(.*\)}/\1/'`
eth_privkey_file=`echo $eth_account_info | grep -oE 'keystore://[^ ]+' | awk -F 'keystore:' '{print $2}'`

echo Address: $eth_address
echo PrivateKeyFile: $eth_privkey_file

After executing the above code. The value eth_address is ethereum address, eth_privkey_file is private key file path. In subsequent operations, these two variables can be used directly.

Signature

Ethereum's message is calculated using sha3: Ethereum Signed Message:\n + 'message' hash. While ckb-auth's message is a fixed length of 32 bytes, so here, ethkey supports the input of messages in both textual form and through a file (by using the --msgfile parameter). In this context, Ethereum's message is directly utilized as a data parameter hash, necessitating the use of the --msgfile to input a file.

Here, ethkey needs to use message_file, use ckb-auth-cli ethereum generate to convert the message to file:

message=0011223344556677889900112233445500112233445566778899001122334455
message_file=`pwd`/message_file.bin
ckb-auth-cli ethereum generate -m $message --msgfile $message_file

(Other paths can also be used)

After generating the message file, ethkey can be used for signing:

ethkey signmessage --msgfile $message_file --passwordfile $eth_password_file $eth_privkey_file

output:

Signature: 5a62aa66a32a41fb44a58e7284ca964952da485dc0fcec24dadb7402d65274d8733f9a2c34274c573d09743d04f25fdfb00ffee8d821a1422c7d3f4e97ce97e100

If it's an automated test, obtaining the signature can also be accomplished through a script.

eth_sign_info=`ethkey signmessage --msgfile $message_file --passwordfile $eth_password_file $eth_privkey_file`
eth_signature=`echo $eth_sign_info | awk -F 'Signature: ' '{print $2}'`
echo Signature: $eth_signature

Now, the value in eth_signature is signature.

After signing, verification can be done using geth to prevent any basic errors:

ethkey verifymessage --msgfile $message_file $eth_address $eth_signature
  • Here need to pay attention to the order of command parameters.

Verify

This can now be verified in ckb-auth:

ckb-auth-cli ethereum verify -a $eth_address -s $eth_signature -m $message