Add vitepress docs

docs/util/address.md

@@ -0,0 +1,110 @@
+# Nostr Address
+
+The Address module provides utilities for working with Nostr Addresses (NIP-19 naddr format) and handles the conversion between different address formats.
+
+## Address Class
+
+```typescript
+class Address {
+  constructor(
+    readonly kind: number,      // Event kind
+    readonly pubkey: string,    // Author's public key
+    readonly identifier: string, // Unique identifier (d-tag)
+    readonly relays?: string[], // Optional relay hints
+  )
+}
+```
+
+## Creating Addresses
+
+### From Components
+```typescript
+const address = new Address(
+  30023,                      // kind (e.g., long-form article)
+  'ab82...123',              // pubkey
+  'my-article-title',        // identifier
+  ['wss://relay.example.com'] // relays
+)
+```
+
+### From String Format
+```typescript
+// Parse "kind:pubkey:identifier" format
+const address = Address.from('30023:ab82...123:my-article-title')
+
+// With optional relays
+const address = Address.from(
+  '30023:ab82...123:my-article-title',
+  ['wss://relay.example.com']
+)
+```
+
+### From Naddr
+```typescript
+// Parse naddr format
+const address = Address.fromNaddr('naddr1...')
+```
+
+### From Event
+```typescript
+const address = Address.fromEvent(event, relays)
+```
+
+## Converting Addresses
+
+### To String
+```typescript
+const address = new Address(kind, pubkey, identifier)
+address.toString() // => "kind:pubkey:identifier"
+```
+
+### To Naddr
+```typescript
+const address = new Address(kind, pubkey, identifier, relays)
+address.toNaddr() // => "naddr1..."
+```
+
+## Utility Functions
+
+### Check Address Format
+```typescript
+// Check if string is valid address format
+Address.isAddress('30023:abc...123:title') // => true
+Address.isAddress('not-an-address') // => false
+```
+
+### Get Address from Event
+```typescript
+import { getAddress } from '@welshman/util'
+
+// Extract address from event
+const address = getAddress(event)
+```
+
+## Examples
+
+### Working with Long-form Content
+```typescript
+// Create address for article
+const articleAddress = new Address(
+  30023,               // Long-form content kind
+  authorPubkey,
+  'my-article-slug',
+  ['wss://relay.example.com']
+)
+
+// Convert to string format for storage
+const addressString = articleAddress.toString()
+
+// Convert to naddr for sharing
+const shareableAddress = articleAddress.toNaddr()
+```
+
+### Handling Replaceable Events
+```typescript
+// Create address from replaceable event
+const address = Address.fromEvent(event)
+
+// Store latest version using address as key
+storage.set(address.toString(), event)
+```