multiformats / multiformats/js-multiformats
Proposal: Multiblock encoder interface
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 268
- Forks
- 57
- PR merge metrics
- No merged PRs in 30d
Description
We're running into more and more cases where BlockEncoder interface just does not fit the bill:
- With IPNFT geared towards NFTs we've discovered that NFT metadata can easily exceed 1MiB size which would hinder our ability to serve such blocks on gateway etc....
- With new UnixFS code we basically want pass file and get set of blocks with a root back.
- Now with UCANs we want to pass auth chain and produce block per link in chain.
I am sure I'm forgetting some and we are likely to encounter more use cases where we want to turn some input into a DAG represented by many blocks. Which is why I would like to propose adopting following interfaces:
export interface SyncDAGEncoder<Code extends number = number, T extends unknown = unknown> {
encoder(data:T): IterableIterator<{ code: Code, bytes: Uint8Array }>
}
export interface AsyncDAGEncoder<Code extends number = number, T extends unknown = unknown> {
encoder(data:T): AsyncIterableIterator<{ code: Code, bytes: Uint8Array }>
}
export type DAGEncoder<Code extends number = number, T extends unknown = unknown> =
| SyncDAGEncoder<Code, T>
| AsyncDAGEncoder<Code, T>
Last block would be a DAG root block (which is natural due to hash linking)
Such interfaces would cover all above use cases. Additionally we could make all our block codecs implement these interface too making them compatible.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the existing BlockEncoder interface and the block codecs mentioned in the proposal. Compare their current contracts with the proposed synchronous and asynchronous DAG encoder interfaces, including multi-block output and the final root block. Done requires an agreed interface design and a clear plan for compatibility with existing codecs.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- backend-api-design
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100