@thenamespace/avatar uploads, updates, and deletes avatar and header images for ENS subnames through the Namespace Metadata Service. Authentication uses SIWE v4, and the SDK accepts a Viem WalletClient, an Ethers Wallet or Signer, or any object matching the WalletProvider interface directly, no adapter required.
SIWE v4 Authentication
Sign-In with Ethereum for EOA and smart-contract wallet signatures.
Direct Wallet Integration
Pass Viem, Ethers, or any wallet client directly, no adapters needed.
Pre-registration Uploads
Upload images for a subname before it is registered.
Progress & Validation
Real-time upload progress and built-in file size and format checks.
Next steps
- Install and configure the SDK: Installation
- Upload images: Upload images
- Remove images: Delete images
- Sign manually: Manual SIWE flow
- Handle errors: Error handling