Add NDK skill documentation and examples
- Introduced comprehensive documentation for the Nostr Development Kit (NDK) including an overview, quick reference, and troubleshooting guide. - Added detailed examples covering initialization, authentication, event publishing, querying, and user profile management. - Structured the documentation to facilitate quick lookups and deep learning, based on real-world usage patterns from the Plebeian Market application. - Created an index for examples to enhance usability and navigation. - Bumped version to 1.0.0 to reflect the addition of this new skill set.
This commit is contained in:
423
.claude/skills/ndk/examples/05-users-profiles.ts
Normal file
423
.claude/skills/ndk/examples/05-users-profiles.ts
Normal file
@@ -0,0 +1,423 @@
|
||||
/**
|
||||
* NDK User and Profile Handling
|
||||
*
|
||||
* Examples from: src/queries/profiles.tsx, src/components/Profile.tsx
|
||||
*/
|
||||
|
||||
import NDK, { NDKUser, NDKUserProfile } from '@nostr-dev-kit/ndk'
|
||||
import { nip19 } from 'nostr-tools'
|
||||
|
||||
// ============================================================
|
||||
// FETCH PROFILE BY NPUB
|
||||
// ============================================================
|
||||
|
||||
const fetchProfileByNpub = async (ndk: NDK, npub: string): Promise<NDKUserProfile | null> => {
|
||||
try {
|
||||
// Get user object from npub
|
||||
const user = ndk.getUser({ npub })
|
||||
|
||||
// Fetch profile from relays
|
||||
const profile = await user.fetchProfile()
|
||||
|
||||
return profile
|
||||
} catch (error) {
|
||||
console.error('Failed to fetch profile:', error)
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// FETCH PROFILE BY HEX PUBKEY
|
||||
// ============================================================
|
||||
|
||||
const fetchProfileByPubkey = async (ndk: NDK, pubkey: string): Promise<NDKUserProfile | null> => {
|
||||
try {
|
||||
const user = ndk.getUser({ hexpubkey: pubkey })
|
||||
const profile = await user.fetchProfile()
|
||||
|
||||
return profile
|
||||
} catch (error) {
|
||||
console.error('Failed to fetch profile:', error)
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// FETCH PROFILE BY NIP-05
|
||||
// ============================================================
|
||||
|
||||
const fetchProfileByNip05 = async (ndk: NDK, nip05: string): Promise<NDKUserProfile | null> => {
|
||||
try {
|
||||
// Resolve NIP-05 identifier to user
|
||||
const user = await ndk.getUserFromNip05(nip05)
|
||||
|
||||
if (!user) {
|
||||
console.log('User not found for NIP-05:', nip05)
|
||||
return null
|
||||
}
|
||||
|
||||
// Fetch profile
|
||||
const profile = await user.fetchProfile()
|
||||
|
||||
return profile
|
||||
} catch (error) {
|
||||
console.error('Failed to fetch profile by NIP-05:', error)
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// FETCH PROFILE BY ANY IDENTIFIER
|
||||
// ============================================================
|
||||
|
||||
const fetchProfileByIdentifier = async (
|
||||
ndk: NDK,
|
||||
identifier: string
|
||||
): Promise<{ profile: NDKUserProfile | null; user: NDKUser | null }> => {
|
||||
try {
|
||||
// Check if it's a NIP-05 (contains @)
|
||||
if (identifier.includes('@')) {
|
||||
const user = await ndk.getUserFromNip05(identifier)
|
||||
if (!user) return { profile: null, user: null }
|
||||
|
||||
const profile = await user.fetchProfile()
|
||||
return { profile, user }
|
||||
}
|
||||
|
||||
// Check if it's an npub
|
||||
if (identifier.startsWith('npub')) {
|
||||
const user = ndk.getUser({ npub: identifier })
|
||||
const profile = await user.fetchProfile()
|
||||
return { profile, user }
|
||||
}
|
||||
|
||||
// Assume it's a hex pubkey
|
||||
const user = ndk.getUser({ hexpubkey: identifier })
|
||||
const profile = await user.fetchProfile()
|
||||
return { profile, user }
|
||||
} catch (error) {
|
||||
console.error('Failed to fetch profile:', error)
|
||||
return { profile: null, user: null }
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// GET CURRENT USER
|
||||
// ============================================================
|
||||
|
||||
const getCurrentUser = async (ndk: NDK): Promise<NDKUser | null> => {
|
||||
if (!ndk.signer) {
|
||||
console.log('No signer set')
|
||||
return null
|
||||
}
|
||||
|
||||
try {
|
||||
const user = await ndk.signer.user()
|
||||
return user
|
||||
} catch (error) {
|
||||
console.error('Failed to get current user:', error)
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// PROFILE DATA STRUCTURE
|
||||
// ============================================================
|
||||
|
||||
interface ProfileData {
|
||||
// Standard fields
|
||||
name?: string
|
||||
displayName?: string
|
||||
display_name?: string
|
||||
picture?: string
|
||||
image?: string
|
||||
banner?: string
|
||||
about?: string
|
||||
|
||||
// Contact
|
||||
nip05?: string
|
||||
lud06?: string // LNURL
|
||||
lud16?: string // Lightning address
|
||||
|
||||
// Social
|
||||
website?: string
|
||||
|
||||
// Raw data
|
||||
[key: string]: any
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// EXTRACT PROFILE INFO
|
||||
// ============================================================
|
||||
|
||||
const extractProfileInfo = (profile: NDKUserProfile | null) => {
|
||||
if (!profile) {
|
||||
return {
|
||||
displayName: 'Anonymous',
|
||||
avatar: null,
|
||||
bio: null,
|
||||
lightningAddress: null,
|
||||
nip05: null
|
||||
}
|
||||
}
|
||||
|
||||
return {
|
||||
displayName: profile.displayName || profile.display_name || profile.name || 'Anonymous',
|
||||
avatar: profile.picture || profile.image || null,
|
||||
banner: profile.banner || null,
|
||||
bio: profile.about || null,
|
||||
lightningAddress: profile.lud16 || profile.lud06 || null,
|
||||
nip05: profile.nip05 || null,
|
||||
website: profile.website || null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// UPDATE PROFILE
|
||||
// ============================================================
|
||||
|
||||
import { NDKEvent } from '@nostr-dev-kit/ndk'
|
||||
|
||||
const updateProfile = async (ndk: NDK, profileData: Partial<ProfileData>) => {
|
||||
if (!ndk.signer) {
|
||||
throw new Error('No signer available')
|
||||
}
|
||||
|
||||
// Get current profile
|
||||
const currentUser = await ndk.signer.user()
|
||||
const currentProfile = await currentUser.fetchProfile()
|
||||
|
||||
// Merge with new data
|
||||
const updatedProfile = {
|
||||
...currentProfile,
|
||||
...profileData
|
||||
}
|
||||
|
||||
// Create kind 0 (metadata) event
|
||||
const event = new NDKEvent(ndk)
|
||||
event.kind = 0
|
||||
event.content = JSON.stringify(updatedProfile)
|
||||
event.tags = []
|
||||
|
||||
await event.sign()
|
||||
await event.publish()
|
||||
|
||||
console.log('✅ Profile updated')
|
||||
return event.id
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// BATCH FETCH PROFILES
|
||||
// ============================================================
|
||||
|
||||
const fetchMultipleProfiles = async (
|
||||
ndk: NDK,
|
||||
pubkeys: string[]
|
||||
): Promise<Map<string, NDKUserProfile | null>> => {
|
||||
const profiles = new Map<string, NDKUserProfile | null>()
|
||||
|
||||
// Fetch all profiles in parallel
|
||||
await Promise.all(
|
||||
pubkeys.map(async (pubkey) => {
|
||||
try {
|
||||
const user = ndk.getUser({ hexpubkey: pubkey })
|
||||
const profile = await user.fetchProfile()
|
||||
profiles.set(pubkey, profile)
|
||||
} catch (error) {
|
||||
console.error(`Failed to fetch profile for ${pubkey}:`, error)
|
||||
profiles.set(pubkey, null)
|
||||
}
|
||||
})
|
||||
)
|
||||
|
||||
return profiles
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// CONVERT BETWEEN FORMATS
|
||||
// ============================================================
|
||||
|
||||
const convertPubkeyFormats = (identifier: string) => {
|
||||
try {
|
||||
// If it's npub, convert to hex
|
||||
if (identifier.startsWith('npub')) {
|
||||
const decoded = nip19.decode(identifier)
|
||||
if (decoded.type === 'npub') {
|
||||
return {
|
||||
hex: decoded.data as string,
|
||||
npub: identifier
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// If it's hex, convert to npub
|
||||
if (/^[0-9a-f]{64}$/.test(identifier)) {
|
||||
return {
|
||||
hex: identifier,
|
||||
npub: nip19.npubEncode(identifier)
|
||||
}
|
||||
}
|
||||
|
||||
throw new Error('Invalid pubkey format')
|
||||
} catch (error) {
|
||||
console.error('Format conversion failed:', error)
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// REACT HOOK FOR PROFILE
|
||||
// ============================================================
|
||||
|
||||
import { useQuery } from '@tanstack/react-query'
|
||||
import { useEffect, useState } from 'react'
|
||||
|
||||
function useProfile(ndk: NDK | null, npub: string | undefined) {
|
||||
return useQuery({
|
||||
queryKey: ['profile', npub],
|
||||
queryFn: async () => {
|
||||
if (!ndk || !npub) throw new Error('NDK or npub missing')
|
||||
return await fetchProfileByNpub(ndk, npub)
|
||||
},
|
||||
enabled: !!ndk && !!npub,
|
||||
staleTime: 5 * 60 * 1000, // 5 minutes
|
||||
cacheTime: 30 * 60 * 1000 // 30 minutes
|
||||
})
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// REACT COMPONENT EXAMPLE
|
||||
// ============================================================
|
||||
|
||||
interface ProfileDisplayProps {
|
||||
ndk: NDK
|
||||
pubkey: string
|
||||
}
|
||||
|
||||
function ProfileDisplay({ ndk, pubkey }: ProfileDisplayProps) {
|
||||
const [profile, setProfile] = useState<NDKUserProfile | null>(null)
|
||||
const [loading, setLoading] = useState(true)
|
||||
|
||||
useEffect(() => {
|
||||
const loadProfile = async () => {
|
||||
setLoading(true)
|
||||
try {
|
||||
const user = ndk.getUser({ hexpubkey: pubkey })
|
||||
const fetchedProfile = await user.fetchProfile()
|
||||
setProfile(fetchedProfile)
|
||||
} catch (error) {
|
||||
console.error('Failed to load profile:', error)
|
||||
} finally {
|
||||
setLoading(false)
|
||||
}
|
||||
}
|
||||
|
||||
loadProfile()
|
||||
}, [ndk, pubkey])
|
||||
|
||||
if (loading) {
|
||||
return <div>Loading profile...</div>
|
||||
}
|
||||
|
||||
const info = extractProfileInfo(profile)
|
||||
|
||||
return (
|
||||
<div className="profile">
|
||||
{info.avatar && <img src={info.avatar} alt={info.displayName} />}
|
||||
<h2>{info.displayName}</h2>
|
||||
{info.bio && <p>{info.bio}</p>}
|
||||
{info.nip05 && <span>✓ {info.nip05}</span>}
|
||||
{info.lightningAddress && <span>⚡ {info.lightningAddress}</span>}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// FOLLOW/UNFOLLOW USER
|
||||
// ============================================================
|
||||
|
||||
const followUser = async (ndk: NDK, pubkeyToFollow: string) => {
|
||||
if (!ndk.signer) {
|
||||
throw new Error('No signer available')
|
||||
}
|
||||
|
||||
// Fetch current contact list (kind 3)
|
||||
const currentUser = await ndk.signer.user()
|
||||
const contactListFilter = {
|
||||
kinds: [3],
|
||||
authors: [currentUser.pubkey]
|
||||
}
|
||||
|
||||
const existingEvents = await ndk.fetchEvents(contactListFilter)
|
||||
const existingContactList = existingEvents.size > 0
|
||||
? Array.from(existingEvents)[0]
|
||||
: null
|
||||
|
||||
// Get existing p tags
|
||||
const existingPTags = existingContactList
|
||||
? existingContactList.tags.filter(tag => tag[0] === 'p')
|
||||
: []
|
||||
|
||||
// Check if already following
|
||||
const alreadyFollowing = existingPTags.some(tag => tag[1] === pubkeyToFollow)
|
||||
if (alreadyFollowing) {
|
||||
console.log('Already following this user')
|
||||
return
|
||||
}
|
||||
|
||||
// Create new contact list with added user
|
||||
const event = new NDKEvent(ndk)
|
||||
event.kind = 3
|
||||
event.content = existingContactList?.content || ''
|
||||
event.tags = [
|
||||
...existingPTags,
|
||||
['p', pubkeyToFollow]
|
||||
]
|
||||
|
||||
await event.sign()
|
||||
await event.publish()
|
||||
|
||||
console.log('✅ Now following user')
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// USAGE EXAMPLE
|
||||
// ============================================================
|
||||
|
||||
async function profileExample(ndk: NDK) {
|
||||
// Fetch by different identifiers
|
||||
const profile1 = await fetchProfileByNpub(ndk, 'npub1...')
|
||||
const profile2 = await fetchProfileByNip05(ndk, 'user@domain.com')
|
||||
const profile3 = await fetchProfileByPubkey(ndk, 'hex pubkey...')
|
||||
|
||||
// Extract display info
|
||||
const info = extractProfileInfo(profile1)
|
||||
console.log('Display name:', info.displayName)
|
||||
console.log('Avatar:', info.avatar)
|
||||
|
||||
// Update own profile
|
||||
await updateProfile(ndk, {
|
||||
name: 'My Name',
|
||||
about: 'My bio',
|
||||
picture: 'https://example.com/avatar.jpg',
|
||||
lud16: 'me@getalby.com'
|
||||
})
|
||||
|
||||
// Follow someone
|
||||
await followUser(ndk, 'pubkey to follow')
|
||||
}
|
||||
|
||||
export {
|
||||
fetchProfileByNpub,
|
||||
fetchProfileByPubkey,
|
||||
fetchProfileByNip05,
|
||||
fetchProfileByIdentifier,
|
||||
getCurrentUser,
|
||||
extractProfileInfo,
|
||||
updateProfile,
|
||||
fetchMultipleProfiles,
|
||||
convertPubkeyFormats,
|
||||
useProfile,
|
||||
followUser
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user