Current section

Files

Jump to
bitcoinlib lib key public_key deserialization.ex
Raw

lib/key/public_key/deserialization.ex

defmodule BitcoinLib.Key.PublicKey.Deserialization do
@moduledoc """
Extended public key deserialization module
To test the results, use https://www.npmjs.com/package/@swan-bitcoin/xpub-cli
Serialization types: https://github.com/satoshilabs/slips/blob/master/slip-0132.md
"""
@bip32_mainnet_human_readable "xpub"
@bip49_mainnet_human_readable "ypub"
@bip84_mainnet_human_readable "zpub"
alias BitcoinLib.Key.PublicKey
@doc """
Deserialization of a public key from its xpub version
## Examples
values from https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki#test-vector-1
iex> "xpub661MyMwAqRbcFtXgS5sYJABqqG9YLmC4Q1Rdap9gSE8NqtwybGhePY2gZ29ESFjqJoCu1Rupje8YtGqsefD265TMg7usUDFdp6W1EGMcet8"
...> |> BitcoinLib.Key.PublicKey.deserialize()
%BitcoinLib.Key.PublicKey{
key: 0x339A36013301597DAEF41FBE593A02CC513D0B55527EC2DF1050E2E8FF49C85C2,
chain_code: 0x873DFF81C02F525623FD1FE5167EAC3A55A049DE3D314BB42EE227FFED37D508,
depth: 0,
index: 0,
parent_fingerprint: 0
}
"""
@spec deserialize(binary()) :: {:ok, %PublicKey{}} | {:error, binary()}
def deserialize(@bip32_mainnet_human_readable <> _data = serialized) do
{:ok, execute(serialized)}
end
def deserialize(@bip49_mainnet_human_readable <> _data = serialized) do
{:ok, execute(serialized)}
end
def deserialize(@bip84_mainnet_human_readable <> _data = serialized) do
{:ok, execute(serialized)}
end
def deserialize(_) do
{:error, "unknown pub key serialization format"}
end
defp execute(serialized_public_key) do
<<
_::32,
depth::8,
parent_fingerprint::bitstring-32,
index::32,
chain_code::bitstring-256,
key::bitstring-264,
_checksum::32
>> =
serialized_public_key
|> Base58.decode()
%PublicKey{
key: key,
chain_code: chain_code,
depth: depth,
index: index,
parent_fingerprint: parent_fingerprint
}
end
end