Wallets

type Wallet = {
  /** Stable Tally cuid. Use as `wallet_id` to permission routes (grant,
   *  edit, revoke). */
  id: string;
  /** EVM address. Use as `wallet` in `tally.payments.create({ wallet })`. */
  address: string;
  /** Friendly name set when the wallet was created. */
  display_name: string;
  /** Optional role label (e.g., "treasury", "ops"); null if unset. */
  role_label: string | null;
  mode: "test" | "live";
  /** ISO 8601 timestamp. */
  created_at: string;
};

type WalletCreateInput = {
  /** Human-friendly name. 1–60 chars after trimming. */
  display_name: string;
  /** Optional role label (1–40 chars after trimming). */
  role_label?: string;
};

const wallets = await tally.wallets.list();

for (const w of wallets) {
  console.log(`${w.display_name} (${w.role_label ?? "—"}): ${w.address}`);
}

const wallet = await tally.wallets.create({
  display_name: "Treasury",
  role_label: "ops",
});

console.log(`Created ${wallet.address}`);