Changeset 142 for trunk/standards

Timestamp:

02/28/08 20:57:50 (4 years ago)

Author:

ocnils

Message:

Replaced "coin" with "token" except for "OpenCoin?" and "COIN_SPEND"

Files:

• trunk/standards/protocol.txt (modified) (13 diffs)

trunk/standards/protocol.txt

@@ -28 +28 @@
    - licence of this document?
    - "Introduction"
-   - replace "coin" with "token"
+   - replace "COIN_SPEND" with "TRANSFER_TOKEN"
    - decide whether the protocol atoms are tokens or lists of tokens
    - throw out reduntant "TRANSFER_TOKEN" explanatoins
@@ -43 +43 @@
       3.3.5."TRANSFER_TOKEN": A generic wallet-issuer request
       3.4.  Wallet send minting request to issuer  
-      3.5.  Wallet gets coin back
-      3.6.  Wallet to Wallet
-      3.7.  Redeeming Coins 
+      3.5.  Wallet gets token back
+      3.6.  Wallet to wallet
+      3.7.  Redeeming tokens
    4. References
 
@@ -95 +95 @@
     not_before          = TIME(...)
     key_not_after       = TIME(...)
-    coin_not_after      = TIME(...)
+    token_not_after      = TIME(...)
     public key          = base64(pP)
 
@@ -162 +162 @@
 3.3.5 "TRANSFER_TOKEN": A generic wallet-issuer request
 
-The atom for this transaction is a list of coins - if one of the coins /blanks
+The atom for this transaction is a list of tokens - if one of the tokens /blanks
 fail, the whole transaction fails.
 
@@ -171 +171 @@
 
    TRANSFER_TOKEN_REQUEST( transaction_id, list_of_options, target, \
-                            list_of_blinds, list_of_coins )
+                            list_of_blinds, list_of_tokens )
     
    XXX list of blinds -> list of (blinds + denomination key/id)
@@ -182 +182 @@
   * option may contain variable=value pairs like "JITM=mandatory".
   * target 
-    * value(list_of_blinds) = value(list_of_coins): empty
-    * value(list_of_blinds) > value(list_of_coins): payment reference
-    * value(list_of_blinds) < value(list_of_coins): account reference
+    * value(list_of_blinds) = value(list_of_tokens): empty
+    * value(list_of_blinds) > value(list_of_tokens): payment reference
+    * value(list_of_blinds) < value(list_of_tokens): account reference
 
   For now, only 'pure' transactions are allowed, so one of these must 
   be empty:
-  * target        : coin exchange (value(list_of_blinds) = value(list_of_coins))
-  * list_of_coins : mint request
+  * target        : token exchange (value(list_of_blinds) = value(list_of_tokens))
+  * list_of_tokens : mint request
   * list_of_blinds: redemption
 
-  If at least one of the blinds or coins is rejected, the issuer answers
+  If at least one of the blinds or tokens is rejected, the issuer answers
 
     TRANSFER_TOKEN_REJECT( transaction_id, reason,
                            list( (blind1.key_id, reason1), ... ), \
-                           list( (coin1.key_id,  reason1), ... )  )
+                           list( (token1.key_id,  reason1), ... )  )
 
   where "reason" may be some general failure like "500 minting not available".
@@ -241 +241 @@
 
   In case of delayed minting, mint processes request (signs blind with key_id)
-  some time later and passes "signed blind"="blind coin" back to IS 
-
-
-3.5 Wallet gets coin back
+  some time later and passes "signed blind"="blind token" back to IS 
+
+
+3.5 Wallet gets token back
 
 * Wallet asks issuer service [was: FETCH_MINTED_REQUEST]
@@ -273 +273 @@
   (optional: if yes, inform issuer that he may delete the request)
 
-* Wallet unblinds signed blind and yields coin  (or reblinds)
-
-
-3.6 Wallet to Wallet
-
-Alice - sends a coin
-Bob   - receives the coin
+* Wallet unblinds signed blind and yields token  (or reblinds)
+
+
+3.6 Wallet to wallet
+
+Alice - sends a token
+Bob   - receives the token
 
 Note: 
@@ -288 +288 @@
   * Wallet Alice locates Wallet Bob and sets up (secure) connection
   * Alice knows how much to send and tells her Wallet
-  * Wallet Alice calculates a splitting of sum into coins (units)
-    and reates a list of coins to send
+  * Wallet Alice calculates a splitting of sum into tokens (units)
+    and reates a list of tokens to send
   * Wallet Alice and Wallet Bob are synchronized to UTC (within some small 
     margin of error)
@@ -305 +305 @@
 
 
-* Wallet Alice sends coins to Wallet Bob (this time including their clear 
+* Wallet Alice sends tokens to Wallet Bob (this time including their clear 
   serial and signature)
   
-    A:      COIN_SPEND( transaction_id, list(coin1, ...) )
+    A:      COIN_SPEND( transaction_id, list(token1, ...) )
 
 
@@ -318 +318 @@
   them:
 
-    B:      COIN_REJECT( transaction_id, list( (coinN, "ReasonN") ) )
+    B:      COIN_REJECT( transaction_id, list( (tokenN, "ReasonN") ) )
         or  COIN_REJECT( transaction_id, emptylist, "Reason")
         or  COIN_ACCEPT( transaction_id )
@@ -331 +331 @@
 
 
-3.7 Redeeming Coins 
-
-* Wallet sends coins + target to IS
+3.7 Redeeming tokens 
+
+* Wallet sends tokens + target to IS
 
     W:  TRANSFER_TOKEN_REQUEST(
-            transaction_id, list_of_options, target, (empty list), list_of_coins 
+            transaction_id, list_of_options, target, (empty list), list_of_tokens 
         )
 
@@ -347 +347 @@
 
 * IS checks if tokens and target are valid
-    - if minting keys are still valid (XXX coin has not expired)
+    - if minting keys are still valid (XXX token has not expired)
     - if serial is still valid (against DSDB)
     - if signature is valid
 
-  If not, IS rejects with reason (key id unknown, coin outdated, coin spent, 
-  signature invalid) per coin or sweeping
+  If not, IS rejects with reason (key id unknown, token outdated, token spent, 
+  signature invalid) per token or sweeping
 
     IS: TRANSFER_TOKEN_REJECT( 
-            transaction_id, reason, (empty list), list( (coin1.key_id,  reason1), ... )  )
+            transaction_id, reason, (empty list), list( (token1.key_id,  reason1), ... )  )
         )