Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aratz-lasa/ex_multiaddr
IPFS multiaddr implementation in Elixir
https://github.com/aratz-lasa/ex_multiaddr
elixir ipfs-multiaddr multiaddr p2p
Last synced: about 2 months ago
JSON representation
IPFS multiaddr implementation in Elixir
- Host: GitHub
- URL: https://github.com/aratz-lasa/ex_multiaddr
- Owner: aratz-lasa
- License: mit
- Created: 2019-10-17T16:57:40.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-05-07T11:04:21.000Z (over 2 years ago)
- Last Synced: 2024-11-01T17:48:09.550Z (about 2 months ago)
- Topics: elixir, ipfs-multiaddr, multiaddr, p2p
- Language: Elixir
- Homepage:
- Size: 61.5 KB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ex-multiaddr
[IPFS multiaddr](https://multiformats.io/multiaddr/) implementation in Elixir
## Installation
[Available in Hex](https://hex.pm/docs/publish), the package can be installed
by adding `ex_multiaddr` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:ex_multiaddr, "~> 0.1.0"}
]
end
```
The docs can be found at [https://hexdocs.pm/ex_multiaddr](https://hexdocs.pm/ex_multiaddr).
## Protocols
- [X] ip4
- [X] tcp
- [X] udp
- [X] dccp
- [X] ip6
- [X] ip6zone
- [X] dns
- [X] dns4
- [X] dns6
- [X] dnsaddr
- [X] sctp
- [X] udt
- [X] utp
- [X] unix
- [X] p2p
- [X] ipfs
- [X] onion
- [X] onion3
- [X] garlic64
- [X] garlic32
- [X] quic
- [X] http
- [X] https
- [X] ws
- [X] wss
- [ ] p2p-websocket-star
- [ ] p2p-stardust
- [ ] p2p-webrtc-star
- [X] p2p-webrtc-direct
- [X] p2p-circuit
- [ ] memory
## Usage
### Create Multiaddr
```elixir
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
```Elixir
{: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
```elixir
{: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"}
```