wallets.getByAddress()

wallets.getByAddress(address: string): Promise<Wallet>

interface Wallet {
  id: string;
  wallet_address: string;
  wallet_address_network: WalletNetwork;
  username: string | null;
  picture_url: string | null;
  created_at: number;
  updated_at: number;
}

const wallet = await grapevine.wallets.getByAddress(
  '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb'
);
 
console.log('Wallet ID:', wallet.id);
console.log('Username:', wallet.username || 'Not set');
console.log('Created:', new Date(wallet.created_at * 1000));

// In a React app with wagmi
import { useAccount } from 'wagmi';
 
function UserProfile() {
  const { address } = useAccount();
  const [profile, setProfile] = useState(null);
  
  useEffect(() => {
    if (address) {
      grapevine.wallets.getByAddress(address)
        .then(setProfile)
        .catch(console.error);
    }
  }, [address]);
  
  if (!profile) return <div>Loading...</div>;
  
  return (
    <div>
      <h2>{profile.username || 'Anonymous'}</h2>
      {profile.picture_url && <img src={profile.picture_url} alt="Avatar" />}
    </div>
  );
}

async function walletExists(address: string): Promise<boolean> {
  try {
    await grapevine.wallets.getByAddress(address);
    return true;
  } catch (error) {
    if (error.message.includes('404')) {
      return false;
    }
    throw error;
  }
}

async function getFullWalletProfile(address: string) {
  const wallet = await grapevine.wallets.getByAddress(address);
  const stats = await grapevine.wallets.getStats(wallet.id);
  
  return {
    ...wallet,
    stats
  };
}
 
// Usage
const profile = await getFullWalletProfile('0x742d35Cc...');
console.log('Total revenue:', profile.stats.total_revenue_earned);

// ✅ Valid formats
await grapevine.wallets.getByAddress('0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb');
 
// ❌ Invalid - missing 0x prefix
await grapevine.wallets.getByAddress('742d35Cc6634C0532925a3b844Bc9e7595f0bEb');
// Error: Invalid wallet address format
 
// ❌ Invalid - wrong length
await grapevine.wallets.getByAddress('0x742d35');
// Error: Invalid wallet address format

try {
  const wallet = await grapevine.wallets.getByAddress(address);
  console.log('Found wallet:', wallet);
} catch (error) {
  if (error.message.includes('Invalid wallet address')) {
    console.error('Invalid address format - must be 0x followed by 40 hex characters');
  } else if (error.message.includes('404')) {
    console.error('No wallet found for this address');
  } else {
    console.error('Error:', error.message);
  }
}