summaryrefslogtreecommitdiff
path: root/wallet.rst
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2015-12-10 17:28:42 +0100
committerFlorian Dold <florian.dold@gmail.com>2015-12-10 17:28:42 +0100
commita41b6cb04d4bd18c8a1e1eb54999dfe2e9c5331f (patch)
tree751eade7a8da24bda0f34d9c0aea501c25ef920a /wallet.rst
parenta926dfe58dc6ea7a7d45279ba75f33e0818b64f9 (diff)
downloaddocs-a41b6cb04d4bd18c8a1e1eb54999dfe2e9c5331f.tar.gz
docs-a41b6cb04d4bd18c8a1e1eb54999dfe2e9c5331f.tar.bz2
docs-a41b6cb04d4bd18c8a1e1eb54999dfe2e9c5331f.zip
Describe canonical base URLs.
Diffstat (limited to 'wallet.rst')
-rw-r--r--wallet.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/wallet.rst b/wallet.rst
index c8e4c528..836e178e 100644
--- 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
--------------------