Wallets

async register(request: RegisterWalletRequest): Promise<WalletResponse>

interface RegisterWalletRequest {
  /** Wallet address on the blockchain */
  walletAddress: string;
  /** Blockchain network */
  blockchain: 'solana' | 'polygon' | 'ethereum' | 'base';
  /** External user or account ID for multi-wallet management */
  userId?: string;
  /** Organization-specific metadata */
  orgMetadata?: Record<string, unknown>;
}

async list(query?: WalletListQuery): Promise<WalletListResponse>

interface WalletListQuery {
  /** Filter by external user ID */
  userId?: string;
  /** Filter by blockchain */
  blockchain?: 'solana' | 'polygon' | 'ethereum' | 'base';
  /** Page number (default: 1) */
  page?: number;
  /** Items per page (default: 50, max: 100) */
  limit?: number;
}

interface WalletListResponse {
  wallets: WalletResponse[];
  total: number;
  page: number;
  limit: number;
}

async get(walletId: number): Promise<WalletResponse>

async update(walletId: number, request: UpdateWalletRequest): Promise<WalletResponse>

interface UpdateWalletRequest {
  /** External user ID */
  userId?: string;
  /** Organization-specific metadata */
  orgMetadata?: Record<string, unknown>;
}

interface WalletResponse {
  /** Wallet identifier */
  walletId: number;
  /** Wallet address on the blockchain */
  walletAddress: string;
  /** Blockchain network */
  blockchain: 'solana' | 'polygon' | 'ethereum' | 'base';
  /** External user ID */
  userId?: string;
  /** Organization-specific metadata */
  orgMetadata?: Record<string, unknown>;
  /** Creation timestamp (ISO 8601) */
  createdAt: string;
}