https://github.com/ipfs/js-ipns
Utilities for creating, parsing, and validating IPNS records
https://github.com/ipfs/js-ipns
Last synced: 2 months ago
JSON representation
Utilities for creating, parsing, and validating IPNS records
- Host: GitHub
- URL: https://github.com/ipfs/js-ipns
- Owner: ipfs
- License: apache-2.0
- Created: 2018-06-21T09:12:41.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-10-14T10:05:29.000Z (8 months ago)
- Last Synced: 2025-11-23T16:24:53.602Z (7 months ago)
- Language: TypeScript
- Homepage:
- Size: 1.94 MB
- Stars: 89
- Watchers: 23
- Forks: 27
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# ipns
[](https://ipfs.tech)
[](https://discuss.ipfs.tech)
[](https://codecov.io/gh/ipfs/js-ipns)
[](https://github.com/ipfs/js-ipns/actions/workflows/js-test-and-release.yml?query=branch%3Amain)
> IPNS record definitions
# About
Implements parsing and serialization of [IPNS Records](https://specs.ipfs.tech/ipns/ipns-record/).
## Example - Create record
```TypeScript
import { createIPNSRecord } from 'ipns'
import { generateKeyPair } from '@libp2p/crypto/keys'
const privateKey = await generateKeyPair('Ed25519')
const value = 'hello world'
const sequenceNumber = 0
const lifetime = 3_600_000 // ms, e.g. one hour
const ipnsRecord = await createIPNSRecord(privateKey, value, sequenceNumber, lifetime)
```
## Example - Validate record against public key
```TypeScript
import { validate } from 'ipns/validator'
import { generateKeyPair } from '@libp2p/crypto/keys'
const privateKey = await generateKeyPair('Ed25519')
const publicKey = privateKey.publicKey
const marshalledRecord = Uint8Array.from([0, 1, 2, 3])
await validate(publicKey, marshalledRecord)
// if no error thrown, the record is valid
```
## Example - Validate record against routing key
This is useful when validating IPNS names that use RSA keys, whose public key is embedded in the record (rather than in the routing key as with Ed25519).
```TypeScript
import { ipnsValidator } from 'ipns/validator'
import { multihashToIPNSRoutingKey } from 'ipns'
import { generateKeyPair } from '@libp2p/crypto/keys'
const privateKey = await generateKeyPair('Ed25519')
const routingKey = multihashToIPNSRoutingKey(privateKey.publicKey.toMultihash())
const marshalledRecord = Uint8Array.from([0, 1, 2, 3])
await ipnsValidator(routingKey, marshalledRecord)
```
## Example - Extract public key from record
```TypeScript
import { extractPublicKeyFromIPNSRecord, createIPNSRecord } from 'ipns'
import { generateKeyPair } from '@libp2p/crypto/keys'
const privateKey = await generateKeyPair('Ed25519')
const record = await createIPNSRecord(privateKey, 'hello world', 0, 3_600_000)
const publicKey = await extractPublicKeyFromIPNSRecord(record)
```
## Example - Marshal data with proto buffer
```TypeScript
import { createIPNSRecord, marshalIPNSRecord } from 'ipns'
import { generateKeyPair } from '@libp2p/crypto/keys'
const privateKey = await generateKeyPair('Ed25519')
const record = await createIPNSRecord(privateKey, 'hello world', 0, 3_600_000)
// ...
const marshalledData = marshalIPNSRecord(record)
// ...
```
Returns the record data serialized.
## Example - Unmarshal data from proto buffer
```TypeScript
import { unmarshalIPNSRecord } from 'ipns'
const storedData = Uint8Array.from([0, 1, 2, 3, 4])
const ipnsRecord = unmarshalIPNSRecord(storedData)
```
Returns the `IPNSRecord` after being deserialized.
# Install
```console
$ npm i ipns
```
## Browser `` tag
Loading this module through a script tag will make its exports available as `Ipns` in the global namespace.
```html
<script src="https://unpkg.com/ipns/dist/index.min.js">
```
# API Docs
-
# License
Licensed under either of
- Apache 2.0, ([LICENSE-APACHE](https://github.com/ipfs/js-ipns/LICENSE-APACHE) / )
- MIT ([LICENSE-MIT](https://github.com/ipfs/js-ipns/LICENSE-MIT) / )
# Contribute
Contributions welcome! Please check out [the issues](https://github.com/ipfs/js-ipns/issues).
Also see our [contributing document](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md) for more information on how we work, and about contributing in general.
Please be aware that all interactions related to this repo are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
[](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)