xS-js-libp2p-crypto-secp256k1


Support for secp256k1 keys in xS-js-libp2p-crypto

维护者: Paul Zhang, Chunhv Liu

This repo contains a xS-js-libp2p-crypto-compatible implementation of cryptographic signature generation and verification using the secp256k1 elliptic curve popularized by Bitcoin and other crypto currencies.

Table of Contents

• 1.安装
• 2.使用
  • Example
• 3.API
  • generateKeyPair([bits,] callback)
  • unmarshalSecp256k1PublicKey(bytes)
  • unmarshalSecp256k1PrivateKey(bytes, callback)
  • Secp256k1PublicKey
    • .verify(data, sig, callback)
  • Secp256k1PrivateKey
    • .public
    • .sign(data, callback)
• 4.Contribute
• 5. 致谢
• 6. 资助我们
• 7.License

1. 安装

1npm install --save xS-js-libp2p-crypto-secp256k1

2. 使用

This module is designed to work with xS-js-libp2p-crypto
Installing xS-js-libp2p-crypto-secp256k1 will automatically add support for the 'secp256k1' key type, which can be used as an argument to the xS-js-libp2p-crypto API functions generateKeyPair, unmarshalPublicKey, and marshalPrivateKey. The keys returned from those functions will be instances of the Secp256k1PublicKey or Secp256k1PrivateKey classes provided by this module.

Example

1const crypto = require('libp2p-crypto')
2
3const msg = Buffer.from('Hello World')
4
5crypto.generateKeyPair('secp256k1', 256, (err, key) => {
6  // assuming no error, key will be an instance of Secp256k1PrivateKey
7  // the public key is available as key.public
8  key.sign(msg, (err, sig) => {
9    key.public.verify(msg, sig, (err, valid) => {
10      assert(valid, 'Something went horribly wrong')
11    })
12  })
13})

3. API

The functions below are the public API of this module.

generateKeyPair([bits, ] callback)

• bits: Number - Optional, included for compatibility with js-libp2p-crypto. Ignored if present; private keys will always be 256 bits.
• callback: Function

unmarshalSecp256k1PublicKey(bytes)

• bytes: Buffer

Converts a serialized secp256k1 public key into an instance of Secp256k1PublicKey and returns it

unmarshalSecp256k1PrivateKey(bytes, callback)

• bytes: Buffer
• callback: Function

Converts a serialized secp256k1 private key into an instance of Secp256k1PrivateKey, passing it to callback on success

Secp256k1PublicKey

.verify(data, sig, callback)

• data: Buffer
• sig: Buffer
• callback: Function

Calculates the SHA-256 hash of data, and verifies the DER-encoded signature in sig, passing the result to callback

Secp256k1PrivateKey

.public

Accessor for the Secp256k1PublicKey associated with this private key.

.sign(data, callback)

• data: Buffer

Calculates the SHA-256 hash of data and signs it, passing the DER-encoded signature to callback

4. Contribute

Contributions welcome. Please check out the issues.

5. 致谢

@multiformats multiaddr

6. 资助我们

Cryptocurrency is welcomed.

ETH: 0xCd0e5cE4a29Fd6441b95FA857753f68D09339628

7. License

MIT © 2016 Protocol Labs Inc.