• dagula ls – I wanted a quick way to check if a remote node has an entire DAG without needing to save the block data locally (see #2)
• dagula tree - You wanted a pretty way to see a DAG

So why not both!? This PR takes the liberty of yeilding the decoded Block rather than the { cid, bytes } combo, so it can access the links info. It's neat because a decoded Block also as cid, and bytes, so it work! 🎉

On a snapshot of the dagula source we get:

ls

❯ ./bin.js ls bafybeianow3xqswlzqmmqp4enj4mul3snpg52rya4rvpanip5tycw43elm
bafybeianow3xqswlzqmmqp4enj4mul3snpg52rya4rvpanip5tycw43elm
bafkreifjt56wbljg574jp3ij3iz56rr3ligwf3tmcwmyqufabuhytiirq4
bafkreibsrowqy5n4jpr7en25pepmw2psg6mnhoxzm6yodqubw6uqkl3nau
bafkreid52wbs2t5bjl7k4jqvcmvmpwnwifnvresgdmstcpwhw3h2wb4h6e
bafkreienidxwfi26e7zz54wgkugorvzuugrkaijievwwbrjal37qsnmvye
bafkreicaz5es35z2z2rpu63wukkg2ij2vctmsogmviudlbeb4dfpjfya2u
bafkreicsmlfxu3b4d2ubhlkk5bjo46nnxs5foee7x5bndnn5tpq7ghpo34
bafybeife4dxf7mfar2qsqgexkhze6b4w43a46rvfeoesnkooc5ktdc4uim
bafkreieaixgg2evxchw4wwzzcegecjayq2dn7ka7dblps425royn7ujg5m
bafkreiekuaqztmk7upvdftvq5lwjfmwbg3ffsl7l2oxayrjlqlbj3egcwm
bafkreihblq7u4qvbte34agifm7cjhaerpwxt5q53xy4jnfw47im5hzlqdi
bafkreifpiqrfihldtiziyos6u2k35lf45qrewid2hoylaj5uyi35u5xmbq
bafkreihrp4ceuqkpfl7ytv4kk5qn2ztsyi2weka6gmc346iixlqzupmw5a
bafkreiencnfom77cudkikff7dyy7osc5e22vqset7vpotcyudv274xilq4
bafkreihvxng4xlbbpqrd2ob67btegs3pnocsqf6bq7ahqqo7ofyx7payhy
bafkreic3qg76debp4uwj5hnfpawaqbcv6qyptwn2sz4oxp73md66kdtree
bafkreia5kv2iq3ewgdravhtrlz7zeywhm6cynwx5xieggjl4dlysv772t4
bafkreiejwjgkdtnox6pulwpa4gyjyuczbz4t3k7waeq64i5lgbxjdfifri

tree

❯ ./bin.js tree bafybeianow3xqswlzqmmqp4enj4mul3snpg52rya4rvpanip5tycw43elm
bafybeianow3xqswlzqmmqp4enj4mul3snpg52rya4rvpanip5tycw43elm
├── bafkreifpiqrfihldtiziyos6u2k35lf45qrewid2hoylaj5uyi35u5xmbq
├── bafkreic3qg76debp4uwj5hnfpawaqbcv6qyptwn2sz4oxp73md66kdtree
├── bafkreihrp4ceuqkpfl7ytv4kk5qn2ztsyi2weka6gmc346iixlqzupmw5a
├── bafkreicaz5es35z2z2rpu63wukkg2ij2vctmsogmviudlbeb4dfpjfya2u
├── bafkreihblq7u4qvbte34agifm7cjhaerpwxt5q53xy4jnfw47im5hzlqdi
├─┬ bafybeife4dxf7mfar2qsqgexkhze6b4w43a46rvfeoesnkooc5ktdc4uim
│ ├── bafkreia5kv2iq3ewgdravhtrlz7zeywhm6cynwx5xieggjl4dlysv772t4
│ └── bafkreiejwjgkdtnox6pulwpa4gyjyuczbz4t3k7waeq64i5lgbxjdfifri
├── bafkreieaixgg2evxchw4wwzzcegecjayq2dn7ka7dblps425royn7ujg5m
├── bafkreienidxwfi26e7zz54wgkugorvzuugrkaijievwwbrjal37qsnmvye
├── bafkreid52wbs2t5bjl7k4jqvcmvmpwnwifnvresgdmstcpwhw3h2wb4h6e
├── bafkreifjt56wbljg574jp3ij3iz56rr3ligwf3tmcwmyqufabuhytiirq4
├── bafkreicsmlfxu3b4d2ubhlkk5bjo46nnxs5foee7x5bndnn5tpq7ghpo34
├── bafkreibsrowqy5n4jpr7en25pepmw2psg6mnhoxzm6yodqubw6uqkl3nau
├── bafkreihvxng4xlbbpqrd2ob67btegs3pnocsqf6bq7ahqqo7ofyx7payhy
├── bafkreiencnfom77cudkikff7dyy7osc5e22vqset7vpotcyudv274xilq4
└── bafkreiekuaqztmk7upvdftvq5lwjfmwbg3ffsl7l2oxayrjlqlbj3egcwm

i believe we are seeing the gen dir at bafybeife4dxf7mfar2qsqgexkhze6b4w43a46rvfeoesnkooc5ktdc4uim with 2 children... YES! IT TRUE https://bafybeife4dxf7mfar2qsqgexkhze6b4w43a46rvfeoesnkooc5ktdc4uim.ipfs.w3s.link

License: MIT Signed-off-by: Oli Evans [email protected]

I was noodling around and wondered if I could re-use the dagula decode'n'walk logic on a CAR file. It was a success, but made slightly rougher by the different expectations of what a Block{store|Reader}'s get method signature should be.

dagular Blockstore return a promise of the bytes or throw

get: (cid: CID, options?: { signal?: AbortSignal }) => Promise<Uint8Array>

source

@ipld/car BlockReader return a promise of {cid: CID, bytes: Uint8Array} or undefined

get(key: CID): Promise<Block | undefined>

source

I wanted a quick way to check if a remote node has an entire DAG without needing to save the block data locally, so I added dagula walk.

It could be also be called refs to match what ipfs refs does, but I went with walk.

License: MIT Signed-off-by: Oli Evans [email protected]

node 16 is LTS. signal.throwIfAborted landed in node 17. This PR makes dagular work on node 16 and tests it.

see: https://nodejs.org/api/globals.html#abortsignalthrowifaborted see: https://github.com/nodejs/node/commit/3f72c72bbb89154bc15fbcef7ccbe3cf0dd017ba

Also the setup-node@v3 action now supports caching deps, so we drop bahmutov/npm-install@v1. see: https://github.com/actions/setup-node/blob/main/docs/advanced-usage.md#caching-packages-data

License: MIT Signed-off-by: Oli Evans [email protected]

BREAKING CHANGE: The blockstore interface used by this library has been updated. If passing a blockstore to the constructor it should return undefined if the block is not present in the blockstore. If it is present, it should return a { bytes: Uint8Array, cid: CID } object (a "Block"). Secondly the getBlock method now returns a Block instead of a Uint8Array.

resolves https://github.com/web3-storage/dagula/issues/3