Skip to content

Latest commit

 

History

History
151 lines (118 loc) · 6.03 KB

register-prep-node-public-key.md

File metadata and controls

151 lines (118 loc) · 6.03 KB
Raw

Register PRep Node Public Key

The process of registering a PRep Node Public Key requires you to first generate a public key from the node wallet and then invoke the registerPRepNodePublicKey method of the chain contract (cx000..00).

Using goloop CLI

If you dont have the goloop CLI installed in your computer please follow these instructions.

Check if a Public Key exists

To verify if a PRep address has already registered a Public Key using the goloop CLI you can use the following command:

goloop rpc call --to cx0000000000000000000000000000000000000000 \
 --method getPRepNodePublicKey \
 --param address=hxfc56203484921c3b7a4dee9579d8614d8c8daaf5 \
 --uri https://ctz.solidwallet.io/api/v3

Replace the address with your prep address.

If the response emits “null”, you need to register the public key. If it emits a hex string value, thats the Public Key and no further action is required.

Alternatively you can use the tracker, click on the "Contract" tab, and find the getPRepNodePublicKey method. You should then enter your P-Rep's address.

Link: https://tracker.icon.community/contract/cx0000000000000000000000000000000000000000

Generate Public Key

To generate the Public Key using the goloop CLI you can use the goloop ks pubkey command command as shown in the following example:

goloop ks pubkey -k KEYSTORE_FILE.json -p KEYSTORE_PASSWORD

Note: If you are using a node address, use that keystore and password to generate the public address.

Register Public Key

To register a public key we can use the goloop CLI to send a transaction calling the registerPRepNodePublicKey method of the chain contract as shown in the following example:

goloop rpc sendtx call --to cx0000000000000000000000000000000000000000 \
 --method registerPRepNodePublicKey \
 --param address=hxe45ef7de9eef0200a4090e57d6b92f40377eaea1 \
 --param pubKey=0x02b5f48123b05497c1e39d532b8de987c4d87e0156a03539fc9880d886422506c6 \
 --key_store KEYSTORE_FILE.json \
 --key_password KEYSTORE_PASSWORD \
 --uri https://lisbon.net.solidwallet.io/api/v3 \
 --nid 2 \
 --step_limit 0x30000

Alternatively you can use the tracker. Use your prep address and the public key as the inputs to the transaction for the registerPRepNodePublicKey method.

Using Javascript and curl

Check if a Public Key exists

You can verify if your PRep node has already registered a Public Key by calling the getPRep method of the chain contract.

The response object will have a param called hasPublicKey showing if a Public Key has already been registered or not.

The following curl command showcase how to call the getPRep readonly method of the chain contract.

curl -X POST --data '{"jsonrpc":"2.0","method":"icx_call","id":484,"params":{"to":"cx0000000000000000000000000000000000000000","dataType":"call","data":{"method":"getPRep", "params": {"address": "hxb6b5791be0b5ef67063b3c10b840fb81514db2fd"}}}}' https://RPC_URL:PORT/api/v3

The following example shows the response of the call.

{
  "jsonrpc":"2.0",
  "result": {
    "address": "hxb6b5791be0b5ef67063b3c10b840fb81514db2fd",
    "bonded":"0x152d02c7e14af6800000",
    "city":"Seoul",
    "country":"KOR",
    "delegated":"0x153020c0eaa50f7600000",
    "details":"https://test.example.com/details",
    "email":"test@example.com",
    "grade":"0x0",
    "hasPublicKey":"0x1",
    "irep":"0xa968163f0a57b400000",
    "irepUpdateBlockHeight":"0x0",
    "lastHeight":"0x66",
    "name":"node_hxb6b5791be0b5ef67063b3c10b840fb81514db2fd",
    "nodeAddress":"hxb6b5791be0b5ef67063b3c10b840fb81514db2fd",
    "p2pEndpoint":"test.example.com:7100",
    "penalty":"0x0",
    "power":"0x1682f0ed68b9bede00000",
    "status":"0x0",
    "totalBlocks":"0xd2f54",
    "validatedBlocks":"0xd2f54",
    "website":"https://test.example.com"
    },
  "id":484
}

Generate Public Key

You can also use the icon-sdk-js and call the .getPublicKey(bool) method of the IconWallet object to generate a Public key.


/**
* Get public key of wallet instance.
* param {bool} compressed - Select compressed or uncompressed key
* @return {string} The public key.
* returns compressed/uncompressed publicKey according to passed `compressed` argument
*/

Instantiate a wallet object from the IconWallet object class using your private key and call the .getPublicKey(true) method to get your wallet private key.

// Load wallet object
const wallet = IconWallet.loadPrivateKey('2ab···e4c');
// Get public key of `Wallet` instance.
const publicKey = wallet.getPublicKey(true)

RPC Call for registering Public Key

The following is an example of the RPC JSON Call required to call registerPRepNodePublicKey.

{
  "jsonrpc": "2.0",
  "method": "icx_call",
  "id": 1234,
  "params": {
    "to": "cx0000000000000000000000000000000000000000",
    "from": "hxb6b5791be0b5ef67063b3c10b840fb81514db2fd",
    "nid": "0x1",
    "version": "0x3",
    "timestamp": "0x603670a75b140",
    "stepLimit": "0x1312d00",
    "nonce": "0x1",
    "dataType": "call",
    "data": {
      "method": "registerPRepNodePublicKey",
      "params": {
        "pubKey": "038b...34",
        "address": "hxb6b5791be0b5ef67063b3c10b840fb81514db2fd"
      }
    },
    "signature": "Wk/...30gE="
  }
}