caver.validator

The caver.validator package provides validation functions that should be used when implementing applications on kaia.

NOTE caver.validator is supported since caver-js v1.6.3.

validateSignedMessage

caver.validator.validateSignedMessage(message, signatures, address [, isHashed])

Validates a signed message by comparing the public key recovered from the signature with the account key of the kaia account.

Parameters

Name	Type	Description
message	string	The raw message string. If this message is hashed with the kaia-specific prefix, the third parameter should be passed as true.
signatures	object \	An object in the format of { v, r, s }, an instance of SignatureData, or an array of SignatureData. '[ v, r, s ]' or '[[ v, r, s ]]' array can also be passed as a parameter, and in this case, it is internally converted to SignatureData type.
address	string	The address of the account that signed the message.
isHashed	boolean	(optional, default: false) Whether the message passed as a parameter is hashed with the prefix "\x19Kaia Signed Message:\n" + message.length + message.

Return Value

Promise returning boolean: The promise will be resolved with a boolean value of whether the signature on the message is valid or not.

Examples

const address = '0xa84a1ce657e9d5b383cece6f4ba365e23fa234dd'

const message = 'Some Message'

const signature = [

'0x1b',

'0x8213e560e7bbe1f2e28fd69cbbb41c9108b84c98cd7c2c88d3c8e3549fd6ab10',

'0x3ca40c9e20c1525348d734a6724db152b9244bff6e0ff0c2b811d61d8f874f00',

]

> caver.validator.validateSignedMessage(message, signature, address).then(console.log)

const address = '0xa84a1ce657e9d5b383cece6f4ba365e23fa234dd'

const hashedMessage = '0xa4b1069c1000981f4fdca0d62302dfff77c2d0bc17f283d961e2dc5961105b18'

const signature = [

'0x1b',

'0x8213e560e7bbe1f2e28fd69cbbb41c9108b84c98cd7c2c88d3c8e3549fd6ab10',

'0x3ca40c9e20c1525348d734a6724db152b9244bff6e0ff0c2b811d61d8f874f00',

]

> caver.validator.validateSignedMessage(hashedMessage, signature, address, true).then(console.log)

validateTransaction

caver.validator.validateTransaction(tx)

Validates a transaction. This function compares the public keys from the account key of the kaia account with the public keys recovered from signatures. If the transaction is fee-delegated with the feePayerSignatures variable inside, this function compares the public keys recovered from feePayerSignatures with the public keys of the fee payer.

Parameters

Name	Type	Description
tx	object	An instance of Transaction to validate.

Return Value

Promise returning boolean: The promise will be resolved with a boolean value of whether the transacion is valid or not.

Examples

// Basic transaction will be validated with `signatures`.

const tx = caver.transaction.valueTransfer.create({...})

> caver.validator.validateTransaction(tx).then(console.log)

// Fee-delegation transaction will be validated with `signatures` and `feePayerSignatures`.

const tx = caver.transaction.feeDelegatedValueTransfer.create({...})

> caver.validator.validateTransaction(tx).then(console.log)

validateSender

caver.validator.validateSender(tx)

Validates the sender of the transaction. This function compares the public keys of the account key of the kaia account with the public keys recovered from signatures.

Parameters

Name	Type	Description
tx	object	An instance of Transaction to validate.

Return Value

Promise returning boolean: The promise will be resolved with a boolean value of whether the transaction is valid or not.

Examples

const tx = caver.transaction.valueTransfer.create({...})

> caver.validator.validateSender(tx).then(console.log)

validateFeePayer

caver.validator.validateFeePayer(tx)

Validates a fee payer in the transaction. This function compares the public keys of the account key of the fee payer with the public keys recovered from feePayerSignatures.

Parameters

Name	Type	Description
tx	object	An instance of Transaction to validate.

Return Value

Promise returning boolean: The promise will be resolved with a boolean value of whether the transaction is valid or not.

Examples

const tx = caver.transaction.feeDelegatedValueTransfer.create({...})

> caver.validator.validateFeePayer(tx).then(console.log)