Multiformat port to Kotlin Multiplatform

This library is a port of https://github.com/erwin-kok/multiformat - by Erwin Kok to pure Kotlin with only kotlinx dependencies.

All platform-specific dependencies were removed, and external libraries were replaced with internal re-implementations that do not depend on any platform. Various libraries could be removed and replaced with functionality that is nowadays by the Kotlin standard library.

TODO: Small tasks for Multiplatform
1/2: Signatures by a Multiplatform signature library (instead of java.security.MessageDigest)
2/2: ktor-network is only included for ConcurrentSet & Closeable

TODO: Bigger tasks: Not implemented (yet)
1/1: MultiAddress schemes IP4 / IP6, IP4Zone / IP6Zone (porting of dependency was started)

Find below the original README for more information:

multiformat

Self-describing values for Future-proofing

Introduction

This project implements various protocols defined at: https://multiformats.io/

Notably, the following protocols are implemented:

• multiaddr: network addresses
• multibase: base encodings
• multicodec: serialization codes
• multihash: cryptographic hashes
• multistream-select: Friendly protocol multiplexing.

Next to this, it also implements Cid: https://github.com/multiformats/cid

Usage

A (very) brief description on how to use multiformats:

...but please also look at the various tests.

multiaddr

val addr1 = Multiaddress.fromString("/ip4/127.0.0.1/p2p/QmcgpsyWgH8Y8ajJz1Cu72KnS5uo2Aa2LpzU7kinSupNKC/tcp/1234")
    .getOrElse {
        log.error { "Could not parse Multiaddress: ${it.message}" }
        return Result.failure(it)
    }
val ip6Addr = Multiaddress.fromString("/ip6/2001:8a0:7ac5:4201:3ac9:86ff:fe31:7095").getOrThrow()
val tcpAddr = Multiaddress.fromString("/tcp/8000").getOrThrow()
val webAddr = Multiaddress.fromString("/ws").getOrThrow()
val actual1 = Multiaddress.fromString("/").expectNoErrors()
    .encapsulate(ip6Addr).expectNoErrors()
    .encapsulate(tcpAddr).expectNoErrors()
    .encapsulate(webAddr).expectNoErrors()
    .toString()

multibase

val multibase = Multibase.encode("base16", "foobar".toByteArray()).getOrThrow()
val bytes = Multibase.decode("f666f6f626172").getOrThrow()

multicodec

val codec = Multicodec.nameToType("cidv2")

multihash

val multihash = Multihash.fromBase58("QmPfjpVaf593UQJ9a5ECvdh2x17XuJYG5Yanv5UFnH3jPE")

multistream-select

val selected = MultistreamMuxer.selectOneOf(setOf("/a", "/b", "/c"), connection)
    .getOrElse {
        log.error { "Error selecting protocol: ${it.message}" }
        return Result.failure(it)
    }

Sub-modules

This project has three submodules:

git submodule add https://github.com/multiformats/multicodec src/main/kotlin/org/erwinkok/multiformat/spec/multicodec
git submodule add https://github.com/multiformats/multibase src/main/kotlin/org/erwinkok/multiformat/spec/multibase
git submodule add https://github.com/multiformats/multihash src/main/kotlin/org/erwinkok/multiformat/spec/multihash

These are the official specifications repositories, which are used here for auto-generation code and or verifying the test results are according to spec.

Contributing

Bug reports and pull requests are welcome on GitHub.

Contact

If you want to contact me, please write an e-mail to: [email protected]

License

This project is licensed under the BSD-3-Clause license, see LICENSE file for more details.