wallet.ts

/**
 * Wallet connection utilities — frontend integration surface.
 *
 * This is the shape matchids-web's checkout will call to prompt a wallet
 * connection (e.g. via Valora, MetaMask + Celo network, or whatever
 * wallet CeloHT's flow expects). No real connection logic is wired in —
 * CeloHT's docs will determine exactly how a wallet handshake should
 * work, and that call replaces the TODO below.
 */

export interface WalletConnection {
  address: string;
  network: "celo-mainnet" | "celo-alfajores";
}

export async function connectWallet(): Promise<WalletConnection> {
  throw new Error(
    "connectWallet is an integration point — implement the real wallet " +
      "connection flow once CeloHT's wallet integration details are available."
  );
}

export async function getWalletBalance(
  _address: string,
  _asset: "CELO" | "USDM"
): Promise<{ balance: string }> {
  throw new Error(
    "getWalletBalance is an integration point — never fabricate a balance; " +
      "this must read from the chain or CeloHT's API once connected."
  );
}