type TorStatus = 
  | 'Disabled'      // Tor not enabled
  | 'Enabling'      // Starting Tor service
  | 'Bootstrapping' // Building circuits (0-100%)
  | 'Connected'     // Fully connected and routing
  | 'Error'         // Connection failed
  | 'Misbehaving';  // Tor process issues

interface TorController {
  // Start Tor service
  start(): Promise<void>;
  
  // Stop Tor service
  stop(): Promise<void>;
  
  // Get current status
  getStatus(): TorStatus;
  
  // Request new identity (circuit)
  requestIdentity(): Promise<Identity>;
  
  // Set bridge configuration
  setBridges(bridges: string[]): Promise<void>;
  
  // Get bootstrap progress
  getBootstrapProgress(): number;
}

// Request new Tor circuit
const identity = await torController.requestIdentity();

// Use identity for specific request
const response = await fetch(url, {
  agent: createProxyAgent({
    host: '127.0.0.1',
    port: 9050,
    auth: identity.credentials,
  }),
});

// Different identity for different service
const identity2 = await torController.requestIdentity();
// This uses completely different circuit

suite.trezor.io → [Tor .onion address]

// Configure custom backend with .onion address
const backend = {
  coin: 'btc',
  url: 'http://[onion-address].onion',
  tor: true, // Route through Tor
};

# Windows
%APPDATA%/Trezor Suite/tor/

# macOS  
~/Library/Application Support/Trezor Suite/tor/

# Linux
~/.config/trezor-suite/tor/

// Access Tor logs
import { getTorLogs } from '@suite-native/tor';

const logs = await getTorLogs();
console.log(logs);

// Tor-aware HTTP client
import { createTorAgent } from '@trezor/request-manager';

const agent = createTorAgent({
  host: '127.0.0.1',
  port: 9050,
  identity: torIdentity,
});

const response = await fetch(url, { agent });

interface TorState {
  enabled: boolean;
  status: TorStatus;
  bootstrapProgress: number;
  bridges: string[];
  circuits: TorCircuit[];
  error: string | null;
}

// Actions
dispatch(enableTor());
dispatch(disableTor());
dispatch(setTorBridges(bridges));
dispatch(requestNewIdentity());