Security News
Introducing the Socket Python SDK
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
ipld-dag-cbor
Advanced tools
JavaScript implementation of the IPLD spec.
> npm install ipld-dag-cbor
const dagCBOR = require('ipld-dag-cbor')
The code published to npm that gets loaded on require is in fact a ES5 transpiled version with the right shims added. This means that you can require it and use with your favourite bundler without having to adjust asset management process.
var dagCBOR = require('ipld-dag-cbor')
Loading this module through a script tag will make the IpldDagCbor
obj available in the global namespace.
<script src="https://unpkg.com/ipld-dag-cbor/dist/index.min.js"></script>
<!-- OR -->
<script src="https://unpkg.com/ipld-dag-cbor/dist/index.js"></script>
const dagCBOR = require('ipld-dag-cbor')
const file = {
name: 'hello.txt',
size: 11
}
const serialized = dagCBOR.util.serialize(file)
console.log(`Encoded as a ${serialized.length} byte Buffer`)
const node = dagCBOR.util.deserialize(serialized)
console.log('Decoded as:', node)
require('assert').deepEqual(node, file) // should match
// → Encoded as a 22 byte Buffer
// → Decoded as: { name: 'hello.txt', size: 11 }
dagCBOR.util.serialize(obj)
Encodes an object into IPLD CBOR form, replacing any CIDs found within the object to CBOR tags (with an id of 42
).
obj
(any): any object able to be serialized as CBORReturns the serialized node.
dagCBOR.util.deserialize(serialized)
Decodes an IPLD CBOR encoded representation, restoring any CBOR tags (id 42
) to CIDs.
serialized
(Buffer
or String
): a binary blob representing an IPLD CBOR encoded object.Returns the deserialized object.
dagCBOR.util.configureDecoder([options])
Configure the underlying CBOR decoder.
Possible values in the options
argument are:
size
(Number
, optional): the current heap size used in CBOR parsing, this may grow automatically as larger blocks are encountered up to maxSize
. Default: 65536
(64Kb).maxSize
(Number
, optional): the maximum size the CBOR parsing heap is allowed to grow to before dagCBOR.util.deserialize()
returns an error. Default: 67108864
(64Mb).tags
(Object
, optional): an object whose keys are CBOR tag numbers and values are transform functions that accept a value
and return a decoded representation of that value
.The CBOR decoder uses a heap size that is a power of two. Setting size
to a number other than a power of two will result in a heap using the next-largest power of two.
Calling dagCBOR.util.configureDecoder()
with no arguments will reset to the default decoder size
, maxSize
and tags
.
dagCBOR.util.cid(obj[, options,])
Create a CID for the given unserialized object.
obj
(any): any object able to be serialized as CBORoptions
(Object
):hashAlg
(String
): a registered multicodec hash algorithm.hashLen
(String
): an optional hash lengthversion
(Number
): CID version number, defaults to 1
Returns a Promise with the created CID.
Feel free to join in. All welcome. Open an issue!
Check out our contributing document for more information on how we work, and about contributing in general. Please be aware that all interactions related to IPLD are subject to the IPFS Code of Conduct.
Small note: If editing the README, please conform to the standard-readme specification.
MIT © 2015 David Dias
FAQs
JavaScript implementation of the IPLD (InterpPlanetary Linked Data)
The npm package ipld-dag-cbor receives a total of 15,938 weekly downloads. As such, ipld-dag-cbor popularity was classified as popular.
We found that ipld-dag-cbor demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.
Security News
A new Rust RFC proposes "Trusted Publishing" for Crates.io, introducing short-lived access tokens via OIDC to improve security and reduce risks associated with long-lived API tokens.