create black db methods