ipfs-car-extract

Extract UnixFS paths from an existing DAG with merkle proofs.

A UnixFS DAG can be large, containing multiple levels of files and directories. This tool allows you to extract a portion of a DAG by specifying the path of a file/directory. The tool will export all the blocks for the targeted file and directory as well as the intermediate blocks traversed to reach the target (the proof).

Install

1npm i ipfs-car-extract

Usage

1import { CarIndexedReader } from '@ipld/car/indexed-reader'
2import { CarWriter } from '@ipld/car/writer'
3import { extract } from 'ipfs-car-extract'
4import { Readable } from 'stream'
5
6const reader = await CarIndexedReader.fromFile('my.car')
7const blocks = extract(reader, 'bafybeig5uisjbc25pkjwtyq5goocmwr7lz5ln63llrtw4d5s2y7m7nhyeu/path/to/image.png')
8const { writer, out } = CarWriter.create('bafybeig5uisjbc25pkjwtyq5goocmwr7lz5ln63llrtw4d5s2y7m7nhyeu')
9
10Readable.from(out).pipe(process.stdout)
11
12for await (const block of blocks) {
13  await writer.put(block)
14}
15await writer.close()

CLI

1ipfs-car-extract bafybeig5uisjbc25pkjwtyq5goocmwr7lz5ln63llrtw4d5s2y7m7nhyeu/path/to/image.png my.car > image.png.car
2
3# You can also extract a DAG that spans multiple CARs:
4# ipfs-car-extract <ipfs-path> <car-file> [...car-file]