本页目录

签名

使用 dApp API 前先调用 enable()。CIP-30 返回的地址是十六进制编码的字节；交易和 value 参数是十六进制编码的 CBOR。在浏览器示例中使用 Buffer 时，需要显式导入 buffer 或使用字节转换工具。

了解如何在 Cardano 上签署数据用于身份验证。

签署数据 (CIP-8)

签署任意数据用于身份验证：


const api = await window.cardano.onekey.enable()
 
const addresses = await api.getUsedAddresses()
const address = addresses[0]
 
// Message to sign
const payload = Buffer.from('Hello Cardano!').toString('hex')
 
const signature = await api.signData(address, payload)
 
console.log({
  signature: signature.signature, // COSE_Sign1 signature
  key: signature.key,             // COSE_Key public key
})

验证签名


import { COSESign1, COSEKey } from '@emurgo/cardano-message-signing-browser'
 
const coseSign1 = COSESign1.from_bytes(
  Buffer.from(signature.signature, 'hex')
)
const coseKey = COSEKey.from_bytes(
  Buffer.from(signature.key, 'hex')
)
 
// Get the signed payload
const signedPayload = coseSign1.payload()
 
// Verify signature
// Parsing COSE is not verification. Use a CIP-8 verifier to check the
// protected headers, signing structure, payload, signature, and address binding.

错误处理


try {
  const api = await window.cardano.onekey.enable()
} catch (error) {
  if (error.code === -3) {
    console.log('The wallet refused the request')
  } else if (error.code === -4) {
    console.log('The account changed; reconnect and retry')
  } else {
    console.error('Error:', error.message)
  }
}

常见错误

错误码	说明
-1	请求无效
-2	内部错误
-3	请求被拒绝
-4	账户已变更