Iran and the US have agreed to a conditional two-week ceasefire, during which shipping traffic will be allowed through the Strait of Hormuz.

This comes more than a month after the US and Israel launched co-ordinated attacks on Iran, and hours after US President Donald Trump threatened "a whole civilisation will die tonight" if Iran did not reopen the Strait.

Pakistan's Prime Minister Shehbaz Sharif, who has been mediating negotiations, said early on Wednesday that the ceasefire was effective immediately.

Here's what we know so far about the deal.

Trump said he'd agreed to "suspend the bombing and attack of Iran for a period of two weeks" if Tehran agrees to reopen the Strait of Hormuz, a vital shipping route for oil and other exports from the Gulf.