Skip to content

aratz-lasa/ex_multiaddr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ex-multiaddr

IPFS multiaddr implementation in Elixir

Installation

Available in Hex, the package can be installed by adding ex_multiaddr to your list of dependencies in mix.exs:

def deps do
  [
    {:ex_multiaddr, "~> 0.1.0"}
  ]
end

The docs can be found at https://hexdocs.pm/ex_multiaddr.

Protocols

  • ip4
  • tcp
  • udp
  • dccp
  • ip6
  • ip6zone
  • dns
  • dns4
  • dns6
  • dnsaddr
  • sctp
  • udt
  • utp
  • unix
  • p2p
  • ipfs
  • onion
  • onion3
  • garlic64
  • garlic32
  • quic
  • http
  • https
  • ws
  • wss
  • p2p-websocket-star
  • p2p-stardust
  • p2p-webrtc-star
  • p2p-webrtc-direct
  • p2p-circuit
  • memory

Usage

Create Multiaddr

maddr_string = "/ip4/127.0.0.1/tcp/80"
{:ok, maddr} = Multiaddr.new_multiaddr_from_string(maddr_string)
# {:ok, %Multiaddr{bytes: <<4, 127, 0, 0, 1, 6, 0, 80>>}}

En/Decapsulate

{:ok, maddr_1} = Multiaddr.new_multiaddr_from_string("/ip4/127.0.0.1")
{:ok, maddr_2} = Multiaddr.new_multiaddr_from_string("/tcp/80")
{:ok, maddr_en} = Multiaddr.encapsulate(maddr_1, maddr_2)
# {:ok, %Multiaddr{bytes: <<4, 127, 0, 0, 1, 6, 0, 80>>}}
Multiaddr.string(maddr_en)
# "/ip4/127.0.0.1/tcp/80"

{:ok, maddr_de} = Multiaddr.decapsulate(maddr_en, maddr_2)
# {:ok, %Multiaddr{bytes: <<4, 127, 0, 0, 1>>}}
Multiaddr.string(maddr_de)
# "/ip4/127.0.0.1"

Inspect Multiaddr

{:ok, maddr} = Multiaddr.new_multiaddr_from_string("/ip4/127.0.0.1/tcp/80")
protocols = Multiaddr.protocols(maddr)

{:ok, prot_1} = Enum.fetch(protocols, 0)
#{:ok, %Multiaddr.Protocol{
#   code: 4, name: "ip4", size: 32,
#   transcoder: %Multiaddr.Transcoder{
#     bytes_to_string: #Function<2.41508498/1 in Multiaddr.Transcoder.ip4_transcoder/0>,
#     string_to_bytes: #Function<3.41508498/1 in Multiaddr.Transcoder.ip4_transcoder/0>
#   },
#   vcode: <<4>>
# }}
{:ok, ip4_value} = Multiaddr.value_for_protocol(maddr, "ip4")
# {:ok, "127.0.0.1"}
{:ok, tcp_value} = Multiaddr.value_for_protocol(maddr, "tcp")
# {:ok, "80"}

About

IPFS multiaddr implementation in Elixir

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages