js-multiformats
js-multiformats copied to clipboard
Multidecoder Interface
Right now -- I should say, from how I understand it -- js-multiformats
defines an interface for encoding and decoding using individual codecs. This encapsulates the codec pattern perfectly well. In fact, for encoding, it's really all you need; seeing as you can only encode something using a single codec.
However, when dealing with IPLD in the more general sense (which strives to be polymorphic over its serializations), developers are left on their own to create codec/hash registries that will hopefully be complete enough to be able to deserialize what's given to them.
This is especially exacerbated in the case of libraries which take CIDs from their users. Library authors have to either:
- Include as many codecs as possible
- This introduces massive dependency size overhead
- Future needs for codecs means library updates are necessary
- Accept extra codecs to be matched against when deserializing data
Obviously, the former of the two is an obvious antipattern. The latter, though, has been used successfully in many of the higher level JavaScript IPFS libraries to provide generic interfaces libraries can consume -- dependency injection.
I propose a similar interface, named something like a PolyMultidecoder
which exposes an add()
and remove()
to (de)register BlockDecoder
s, and a single decode()
which resolves and uses the correct decoder, or throws an error if it's otherwise missing.
I've written a stopgap library that exports this exact interface, which you can find here
Related: https://github.com/multiformats/js-multiformats/issues/141
And even further back: https://github.com/multiformats/js-multiformats/pull/38
This needs to get finished, it keeps on coming up. Someone just needs to iterate on what's been attempted and discussed already and make a new PR to make new progress.