refactor!: move autonat into separate package

doc/migrations/v0.46-v1.0.0.md

@@ -1,16 +1,101 @@
+<!--Specify versions for migration below-->
 # Migrating to libp2p@1.0.0 <!-- omit in toc -->
 
-A migration guide for refactoring your application code from libp2p `v0.46` to `v1.0.0`.
+A migration guide for refactoring your application code from libp2p v0.46 to v1.0.0.
 
 ## Table of Contents <!-- omit in toc -->
 
-- [New features](#new-features)
-- [Breaking changes](#breaking-changes)
+- [API](#api)
+- [Module Updates](#module-updates)
+- [Metrics](#metrics)
 
-## New features
+## API
 
-...
+<!--Describe breaking APIs with examples for Before and After
+Example:
 
-## Breaking changes
+### Peer Discovery
 
-...
+__Describe__
+
+**Before**
+
+```js
+
+```
+
+**After**
+
+```js
+
+```
+
+-->
+
+### KeyChain
+
+The KeyChain object is no longer included on Libp2p and must be instantiated explicitly if desired.
+
+**Before**
+
+```ts
+import type { KeyChain } from '@libp2p/interface/keychain'
+
+const libp2p = await createLibp2p(...)
+
+const keychain: KeyChain = libp2p.keychain
+```
+
+**After**
+
+```ts
+import { DefaultKeyChain } from '@libp2p/keychain'
+import type { KeyChain } from '@libp2p/interface/keychain'
+
+const libp2p = await createLibp2p({
+  ...
+  services: {
+    keychain: (components) => new DefaultKeyChain(components, {
+      ...DefaultKeyChain.generateOptions()
+    })
+  }
+})
+
+const keychain: KeyChain = libp2p.services.keychain
+```
+
+### AutoNAT
+
+The AutoNAT service is now published in its own package.
+
+**Before**
+
+```ts
+import { autoNATService } from 'libp2p/autonat'
+```
+
+**After**
+
+```ts
+import { autoNATService } from '@libp2p/autonat'
+```
+
+## Module Updates
+
+With this release you should update the following libp2p modules if you are relying on them:
+
+<!--Specify module versions in JSON for migration below.
+It's recommended to check package.json changes for this:
+`git diff <release> <prev> -- package.json`
+-->
+
+```json
+
+```
+
+## Metrics
+
+The following metrics were renamed:
+
+`libp2p_dialler_pending_dials` => `libp2p_dial_queue_pending_dials`
+`libp2p_dialler_in_progress_dials` => `libp2p_dial_queue_in_progress_dials`