user

This module allows you to access both personal information of the node runner. The module is accessed from the global variable user.
getKeys
user.getKeys()
Gets the address of all keys stored on the keystore of the node.
Returns
Array<String>: A list of addresses.
Example
JavaScript
Output
user.getKeys()
[
   "os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u",
   "os1wfx7vp8qfyv98cctvamqwec5xjrj48tpklxklh"
]
getKey
user.getKey(addrOrIndex, [passphrase])
Gets the private key of a key by its address or keystore index. If the key exists, it will be unlocked using the provided passphrase. If passphrase is not provided, an interactive prompt will be launched to ask for it.
Parameters
1.addrOrIndex - String|Number: The address or keystore index of the key
2.passphrase - String: (Optional) The passphrase to use to unlock the key. If not provided, you will be prompted to provide it. 
Returns
String: The base58 encoded private key.
Example
JavaScript
Output
user.getKey("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
"wXVFmgEmKumxVnQGSnL67krnWkBj4Q...W711b7UnmARiUWtSNSJ6pVhmk1ppiPQPGrD8F3"
getPublicKey
user.getPublicKey(addrOrIndex, [passphrase])
Gets the public key of a key by its address or keystore index. If the key exists, it will be unlocked using the provided passphrase. If passphrase is not provided, an interactive prompt will be launched to ask for it.
Parameters
1.addrOrIndex - String|Number: The address or keystore index of the key
2.passphrase - String: (Optional) The passphrase to use to unlock the key. If not provided, you will be prompted to provide it. 
Returns
String: The base58 encoded public key.
Example
JavaScript
Output
chain.getPublicKey("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
"48hpSpVR39MX947pHPSxRzKHoe65rLWzLWuC14sBU1n6tu7Jg5x"
getNonce
user.getNonce(address, [height])
Gets the current nonce of a user account.
Parameters
1.address - String: The address of the target user account.
2.height - String|Number: (Optional) The block height to query (Default: latest).
Returns
String: The current nonce.
Example
JavaScript
Output
user.getNonce("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
"12"
get
user.get(address, [height])
Gets a user account by its address.
Parameters
1.address - String: The address of the target user account.
2.height - String|Number: (Optional) The block height to query (Default: latest).
Returns
Object: The account object balance - String: The native coin balance. nonce - String: The account nonce. stakes - Object: Staked coin information delegatorCommission - String: Commission to receive from delegators.
Example
JavaScript
Output
user.get("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
{
  "balance": "1984872.35",
  "nonce": "91"
}
getBalance
user.getBalance(address, [height])
Gets the coin balance of a user account.
Parameters
1.address - String: The address of the target user account.
2.height - String|Number: (Optional) The block height to query (Default: latest).
Returns
String: The coin balance.
Example
JavaScript
Output
user.getBalance("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
"12.3"
getStakedBalance
user.getStakedBalance(address, [height])
Gets the total amount of the native coin a user account has staked.
Parameters
1.address - String: The address of the target user account.
2.height - String|Number: (Optional) The block height to query (Default: latest).
Returns
String: The coin balance.
Example
JavaScript
Output
user.getStakedBalance("os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u")
"12.3"
getValidator
user.getValidator(includePrivKey)
Gets the node’s validator key.
Parameters
1.includePrivKey - Boolean: When true, the private key is included in the result.
Returns
Object: The validator key information.
Example
JavaScript
Output
user.getValidator(true)
{
    "address": "os174vnayvd6teyzcfze5z7xsdmzg4kxk8l6jry7n",
    "privateKey": "wnrZynYB6837qB5mRN7V4To1MDB...nYZxaU9qQZPWhsFUPHefAdQEyRUu",
    "publicKey": "48J1NrCGHu4D8qkbsGYKRRaVhJgPt3gfFmgwmSeNjMcrsX1fuas",
    "tmAddress": "5CFFB08E0403EF88770EBAEA3499324779D0FB06"
}
setCommission
user.setCommission(txObject, [signingKey | payloadOnly | [signingKey, payloadOnly]])
Create a transaction that updates the delegator commission percentage of a validator account.
Parameters
1.txObject - Object: The transaction object
commission - String:  The percentage of reward to receive from delegators.
nonce - Number|String : The signing account’s next nonce. 
fee - String: The network fee to be paid by the signing account. 
timestamp - String: (optional) The unix timestamp of the transaction.
sig - String : (optional) The transaction signature. If not provided, the transaction will be signed using the signingKey.
2.signingKey - String: (optional) The private key to use to sign the transaction. 
3.payloadOnly - Boolean: (optional) When true, the transaction payload is returned instead of being sent to the network.
Returns
Object - The result object
hash - String: A 32 bytes transaction hash.
Example
user.setCommission({ 
    commission: "100",
    fee: "1"
}, user.getKey(accounts[0]))
send
user.send(txObject, [signingKey | payloadOnly | [signingKey, payloadOnly]])
Create a transaction that sends coins from the signers account to another account or repository.
Parameters
1.txObject - Object: The transaction object
value - Number|String:  The amount of native coin to be sent.
to - String: The address of the recipient; A user address or a repository name prefixed with r/.
nonce - Number|String : The signing account’s next nonce. 
fee - String: The network fee to be paid by the signing account. 
timestamp - String: (optional) The unix timestamp of the transaction.
sig - String : (optional) The transaction signature. If not provided, the transaction will be signed using the signingKey.
2.signingKey - String: (optional) The private key to use to sign the transaction. 
3.payloadOnly - Boolean: (optional) When true, the transaction payload is returned instead of being sent to the network.
Returns
Object - The result object
hash - String: A 32 bytes transaction hash.
Example
user.send({ 
    to: "os1qfrysysaawvjlgfz5ecqv569adkkw7sxudy36u", 
    value:"5000", 
    fee: "1" 
}, user.getKey(accounts[0]))

Last modified 2yr ago