keyx v0.4.0 KeyX

Documentation for KeyX.

Link to this section Summary

Functions

Generate secret shares using Shamir’s Secret Sharing alrgorithm

Same as generate_shares but no extra error handlineg

Recover secrets from an appropriate number of shares. Must be equal or greater than the K parameters

Same as recover_secret but no extra error handlineg

Link to this section Functions

Link to this function generate_shares(k, n, secret, base \\ :binary, base_opts \\ [case: :lower])
generate_shares(k :: pos_integer, n :: pos_integer, secret :: String.t, base :: atom, base_opts :: [atom]) :: [binary, ...]

Generate secret shares using Shamir’s Secret Sharing alrgorithm.

Parameters

  • k: specifies the number of shares necessary to recover the secret.
  • n: is the identifier of the share and varies between 1 and n where n is the total number of generated shares.
  • secret: Binary (String) of raw secret to split N ways, requiring K shares to recover.
  • base: Encoding for binary. Can be :raw, :base16, :base32, :base64. Default: :binary
  • base_opts: Options to pass to Base.baseXX encoding functions.

Examples

iex> KeyX.generate_shares(2,2, "super duper secret")
{:ok, :binary,
 [<<186, 234, 192, 2, 71, 115, 247, 148, 55, 75, 121, 181, 11, 109, 136, 102,
    91, 211, 158>>,
  <<174, 39, 169, 16, 201, 53, 245, 20, 59, 53, 134, 93, 172, 231, 45, 44, 42,
    133, 137>>]}
Link to this function generate_shares!(k, n, secret)

Same as generate_shares but no extra error handlineg.

Parameters

  • k: specifies the number of shares necessary to recover the secret.
  • n: is the identifier of the share and varies between 1 and n where n is the total number of generated shares.
  • secret: Binary (String) of raw secret to split N ways, requiring K shares to recover.
Link to this function recover_secret(shares, base \\ :binary, base_opts \\ [case: :lower])

Recover secrets from an appropriate number of shares. Must be equal or greater than the K parameters.

Parameters

  • Shares: List of shares (Base64 encoding) containing information about the share, and if signed, the signature.
  • base: Encoding for binary. Can be :raw, :base16, :base32, :base64. Default: :binary
  • base_opts: Options to pass to Base.baseXX decoding functions.

Examples

iex> KeyX.recover_secret(["1-2-c3VwZXIgZHVwZXIgc2VjcmV0", "1-2-c3VwZXIgZHVwZXIgc2VjcmV0"])
{:ok, "super duper secret"}
Link to this function recover_secret!(shares)

Same as recover_secret but no extra error handlineg.

Parameters

  • Shares: List of shares (Base64 encoding) containing information about the share, and if signed, the signature.