commit a41b6cb04d4bd18c8a1e1eb54999dfe2e9c5331f parent a926dfe58dc6ea7a7d45279ba75f33e0818b64f9 Author: Florian Dold <florian.dold@gmail.com> Date: Thu, 10 Dec 2015 17:28:42 +0100 Describe canonical base URLs. Diffstat:
| M | wallet.rst | | | 16 | ++++++++++++++++ |
1 file changed, 16 insertions(+), 0 deletions(-)
diff --git a/wallet.rst b/wallet.rst @@ -11,6 +11,22 @@ The Wallet Reference This section explains how to set up a wallet. It is worth noting that there are two versions for this componenet - one browser based and the other implemented as an `app` for mobile systems. +------- +General +------- + +Mints and merchants have a base URL for their service. This URL *must* be in a +canonical form when it is stored (e.g. in the wallet's database) or transmitted +(e.g. to a bank page). + +1. The URL must be absolute. This implies that the URL has a schema. +2. The path component of the URL must end with a slash. +3. The URL must not contain a fragment or query. + +When a user enters a URL that is, technically, relative (such as "alice.example.com/mint"), wallets +*may* transform it into a canonical base URL ("http://alice.example.com/mint/"). Other components *should not* accept +URLs that are not canonical. + -------------------- Browser based wallet --------------------