Treasury Markets and Sukuk

Islamic FX Wad Arrangements

isb-islamic-fx-wad-arrangements · isb-treasury

A Shariah-native BIAN service domain in Treasury Markets and Sukuk. It applies the Process functional pattern to the Wad FX Arrangement, with the Wad FX Arrangement Procedure as its control record — one isolated Spring Boot microservice.

View repository ↗The 48-domain landscape ↗

Business DomainIslamic Treasury

Functional PatternProcess

Asset TypeWad FX Arrangement

Control RecordWad FX Arrangement Procedure

USEWhat it is used for

Representative use cases for the Islamic FX Wad Arrangements service domain within a Shariah-compliant core-banking landscape.

Place/accept interbank liquidity via Wad FX Arrangement structures instead of interest-bearing deposits
Hedge FX exposure with unilateral promise (Wa'd) constructs documented per IIFM
Screen instruments/equities for Shariah eligibility before treasury investment

APIBIAN semantic API

Each service domain exposes its control record (Wad FX Arrangement Procedure) through uniform BIAN action terms. Java 21 · Spring Boot 3, with OpenAPI at /swagger-ui.html.

Method	Path	BIAN action
GET	`/v1/service-domain`	Service metadata
POST	`/v1/wad-fx-arrangement-procedure/initiate`	Initiate
GET	`/v1/wad-fx-arrangement-procedure/{crId}/retrieve`	Retrieve
PUT	`/v1/wad-fx-arrangement-procedure/{crId}/update`	Update
PUT	`/v1/wad-fx-arrangement-procedure/{crId}/control`	Control (suspend / resume / terminate)

INTBackend integrations

The systems and standards a real deployment of Islamic FX Wad Arrangements would transact with.

Interbank: commodity Murabaha counterparties via Bursa Suq Al-Sila'/DDCAP
IIFM/ISDA Tahawwut master agreements (Wa'd-based hedging)
Central-bank Islamic facilities; Murex/Calypso Islamic configurations

RUNRun it yourself

Each domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart.

# run this domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/isb-islamic-fx-wad-arrangements
mvn -f isb-islamic-fx-wad-arrangements spring-boot:run
curl localhost:8080/v1/service-domain

# or deploy onto Kubernetes (Cilium mesh)
helm upgrade --install isb-islamic-fx-wad-arrangements ./helm -n isb-treasury

FAQQuestions

What business area does Islamic FX Wad Arrangements belong to?

Islamic FX Wad Arrangements sits in the Treasury Markets and Sukuk business area — Islamic treasury, liquidity and Sukuk markets, built on ownership of real assets rather than interest-bearing instruments. It follows the BIAN Process functional pattern over the Wad FX Arrangement asset, with the Wad FX Arrangement Procedure as its control record.

How is this isolated from conventional banking?

Completely. The Islamic landscape shares no code, repositories, namespaces or events with the conventional platform. This domain lives in the isb-treasury namespace with an isb-* repository and com.bank.islamic package, so the two can never mix by accident.

Is this a certified Shariah-compliant product?

No. It is an educational reference implementation in the BIAN service-domain style. Actual Shariah compliance of any real deployment requires certification by a qualified Shariah Supervisory Board. Standards referenced: AAOIFI, IFSB, IIFM.