This is the document that converts "someone's trading bot" into something a Muslim developer will trust, and it does not exist. Right now the fiqh reasoning is spread across code comments (guards.py rail 17 on §65.4 qabd, screen.py on sector and backing, the DOGE issuance discussion in the run log). A reader cannot assess the basis without reading the source.
What it must contain
Standard
Cite sources the way the codebase already does — verbatim quotes with a fetchable reference, and "not stated" where a source is silent. Do not paper over disagreement between schools; name it.
This is the document that converts "someone's trading bot" into something a Muslim developer will trust, and it does not exist. Right now the fiqh reasoning is spread across code comments (
guards.pyrail 17 on §65.4 qabd,screen.pyon sector and backing, the DOGE issuance discussion in the run log). A reader cannot assess the basis without reading the source.What it must contain
pays_yieldis about a bare holder rather than "staking exists"Standard
Cite sources the way the codebase already does — verbatim quotes with a fetchable reference, and "not stated" where a source is silent. Do not paper over disagreement between schools; name it.