Skip to content

Commit

Permalink
docs: update experimental-features doc with IPNS over pubsub changes.
Browse files Browse the repository at this point in the history
  • Loading branch information
aschmahmann committed May 20, 2020
1 parent 2a32d9f commit a38987a
Showing 1 changed file with 9 additions and 5 deletions.
14 changes: 9 additions & 5 deletions docs/experimental-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -427,7 +427,9 @@ ipfs config --json Experimental.ShardingEnabled true

### In Version

0.4.14
Introduced: 0.4.14

Latest Major Change: 0.5.0

### State

Expand All @@ -439,20 +441,22 @@ When it is enabled:
- IPNS publishers push records to a name-specific pubsub topic,
in addition to publishing to the DHT.
- IPNS resolvers subscribe to the name-specific topic on first
resolution and receive subsequently published records through pubsub in real time. This makes subsequent resolutions instant, as they are resolved through the local cache. Note that the initial resolution still goes through the DHT, as there is no message history in pubsub.
resolution and receive subsequently published records through pubsub in real time.
This makes subsequent resolutions instant, as they are resolved through the local cache.

Both the publisher and the resolver nodes need to have the feature enabled for it to work effectively.

Note: While IPNS pubsub has been available since 0.4.14, it received major changes in 0.5.0.
Users interested in this feature should upgrade to at least 0.5.0

### How to enable

run your daemon with the `--enable-namesys-pubsub` flag; enables pubsub.

### Road to being a real feature

- [ ] Needs more people to use and report on how well it works
- [ ] Add a mechanism for last record distribution on subscription,
so that we don't have to hit the DHT for the initial resolution.
Alternatively, we could republish the last record periodically.
- [ ] Pubsub enabled as a real feature

## QUIC

Expand Down

0 comments on commit a38987a

Please sign in to comment.