elixir-dasl#

An Elixir implementation of DASL primitives.

Overview#

DASL (Decentralized Authenticated Structure Layer) is a family of specifications for content-addressed data that is interoperable with the broader IPFS/IPLD ecosystem while remaining minimal and self-contained.

This library provides:

• DASL.CID: — content identifiers, a compact, self-describing pointer to a piece of data.
• DASL.DRISL: — deterministic CBOR serialization.
• DASL.CAR: — Content-Addressable aRchive encoding and decoding, as well as a stream decoder.
• DASL.CAR.DRISL: — a higher-level CAR variant where block values are Elixir terms rather than raw binaries, and are encoded/decoded via DRISL transparently.

Quick start#

# CIDs
cid = DASL.CID.compute("hello world")
DASL.CID.verify?(cid, "hello world")  # => true
DASL.CID.encode(cid)                  # => "bafkrei..."

# Round-trip a CID string
{:ok, cid} = DASL.CID.new("bafkreifzjut3te2nhyekklss27nh3k72ysco7y32koao5eei66wof36n5e")

# DRISL encode/decode
{:ok, bin} = DASL.DRISL.encode(%{"key" => [1, 2, 3]})
{:ok, term, ""} = DASL.DRISL.decode(bin)

# Build and encode a CAR archive
{car, cid1} = DASL.CAR.add_block(%DASL.CAR{}, "block one")
{car, cid2} = DASL.CAR.add_block(car, "block two")
{:ok, car}  = DASL.CAR.add_root(car, cid1)
{:ok, bin}  = DASL.CAR.encode(car)

# Decode it back
{:ok, car} = DASL.CAR.decode(bin)

# Stream a large CAR file
File.stream!("large.car", 65_536)
|> DASL.CAR.stream_decode()
|> Enum.each(fn
  {:header, _version, roots} -> IO.inspect(roots, label: "roots")
  {:block, cid, _data}       -> IO.inspect(cid,   label: "block")
end)

Installation#

Get elixir-dasl from hex.pm by adding it to your mix.exs:

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

Documentation can be found on HexDocs at https://hexdocs.pm/dasl.

This project is licensed under the MIT License.