From d0d84f07db9338ccc8245167929bd71f4cb8b238 Mon Sep 17 00:00:00 2001
From: "aegir[bot]" <aegir[bot]@users.noreply.github.com>
Date: Tue, 5 Dec 2023 23:25:39 +0000
Subject: [PATCH] chore: update sibling dependencies

---
 packages/interop/package.json |   2 +-
 packages/ipns/README.md       | 110 ++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+), 1 deletion(-)

diff --git a/packages/interop/package.json b/packages/interop/package.json
index a224d226..50f46d9f 100644
--- a/packages/interop/package.json
+++ b/packages/interop/package.json
@@ -53,7 +53,7 @@
     "@chainsafe/libp2p-noise": "^13.0.0",
     "@chainsafe/libp2p-yamux": "^5.0.0",
     "@helia/interface": "^2.0.0",
-    "@helia/ipns": "^2.0.0",
+    "@helia/ipns": "^3.0.0",
     "@libp2p/interface": "^0.1.2",
     "@libp2p/kad-dht": "^10.0.4",
     "@libp2p/peer-id": "^3.0.2",
diff --git a/packages/ipns/README.md b/packages/ipns/README.md
index cdca30ff..d5ad8aaf 100644
--- a/packages/ipns/README.md
+++ b/packages/ipns/README.md
@@ -13,6 +13,116 @@
 
 > An implementation of IPNS for Helia
 
+# About
+
+IPNS operations using a Helia node
+
+## Example
+
+With IPNSRouting routers:
+
+```typescript
+import { createHelia } from 'helia'
+import { dht, pubsub } from '@helia/ipns/routing'
+import { unixfs } from '@helia/unixfs'
+
+const helia = await createHelia()
+const name = ipns(helia, {
+ routers: [
+   dht(helia),
+   pubsub(helia)
+ ]
+})
+
+// create a public key to publish as an IPNS name
+const keyInfo = await helia.libp2p.keychain.createKey('my-key')
+const peerId = await helia.libp2p.keychain.exportPeerId(keyInfo.name)
+
+// store some data to publish
+const fs = unixfs(helia)
+const cid = await fs.add(Uint8Array.from([0, 1, 2, 3, 4]))
+
+// publish the name
+await name.publish(peerId, cid)
+
+// resolve the name
+const cid = name.resolve(peerId)
+```
+
+## Example
+
+With default DNSResolver resolvers:
+
+```typescript
+import { createHelia } from 'helia'
+import { dht, pubsub } from '@helia/ipns/routing'
+import { unixfs } from '@helia/unixfs'
+
+const helia = await createHelia()
+const name = ipns(helia, {
+ resolvers: [
+   dnsOverHttps('https://private-dns-server.me/dns-query'),
+ ]
+})
+
+const cid = name.resolveDns('some-domain-with-dnslink-entry.com')
+```
+
+## Example
+
+Calling `resolveDns` with the `@helia/ipns` instance:
+
+```typescript
+// resolve a CID from a TXT record in a DNS zone file, using the default
+// resolver for the current platform eg:
+// > dig _dnslink.ipfs.io TXT
+// ;; ANSWER SECTION:
+// _dnslink.ipfs.io.          60     IN      TXT     "dnslink=/ipns/website.ipfs.io"
+// > dig _dnslink.website.ipfs.io TXT
+// ;; ANSWER SECTION:
+// _dnslink.website.ipfs.io.  60     IN      TXT     "dnslink=/ipfs/QmWebsite"
+
+const cid = name.resolveDns('ipfs.io')
+
+console.info(cid)
+// QmWebsite
+```
+
+## Example
+
+This example uses the Mozilla provided RFC 1035 DNS over HTTPS service. This
+uses binary DNS records so requires extra dependencies to process the
+response which can increase browser bundle sizes.
+
+If this is a concern, use the DNS-JSON-Over-HTTPS resolver instead.
+
+```typescript
+// use DNS-Over-HTTPS
+import { dnsOverHttps } from '@helia/ipns/dns-resolvers'
+
+const cid = name.resolveDns('ipfs.io', {
+  resolvers: [
+    dnsOverHttps('https://mozilla.cloudflare-dns.com/dns-query')
+  ]
+})
+```
+
+## Example
+
+DNS-JSON-Over-HTTPS resolvers use the RFC 8427 `application/dns-json` and can
+result in a smaller browser bundle due to the response being plain JSON.
+
+```typescript
+// use DNS-JSON-Over-HTTPS
+import { dnsJsonOverHttps } from '@helia/ipns/dns-resolvers'
+
+const cid = name.resolveDns('ipfs.io', {
+  resolvers: [
+    dnsJsonOverHttps('https://mozilla.cloudflare-dns.com/dns-query')
+  ]
+})
+```
+
 ## Table of contents <!-- omit in toc -->
 
 - [Install](#install)