Changeset 159 for trunk/standards

Show
Ignore:
Timestamp:
03/02/08 05:19:58 (4 years ago)
Author:
ocmathew
Message:

Update wallet.to.wallet to SUM_ANNOUNCE/ACCEPT/REJECT and TOKEN_REDEEM/REJECT/ACCEPT
Modify formatting of IS.to.wallet to make it uniform (No changes to content)
Update all.txt to include changes to IS.to.wallet and wallet.to.wallet

Location:
trunk/standards/messages
Files:
3 modified

Legend:

Unmodified
Added
Removed

  • trunk/standards/messages/IS.to.wallet.txt

    r149 r159  
    1212 
    1313Wallet: 
    14   MINT_KEY_FETCH_DENOMINATION    list(denomination, ...) TIME(time)|0 
     14  MINT_KEY_FETCH_DENOMINATION   list(denomination, ...) TIME(time)|'0' 
    1515    Prior:  Hello 
    1616    Follow: MINT_KEY_PASS 
    1717            MINT_KEY_FAILURE 
    1818             
    19   MINT_KEY_FETCH_KEYID   list(#base64(key_identifier), ...) 
     19  MINT_KEY_FETCH_KEYID  list(#base64(key_identifier), ...) 
    2020    Prior:  Hello 
    2121    Follow: MINT_KEY_PASS 
    … …  
    2323 
    2424IS: 
    25   MINT_KEY_PASS  list(keycertificate, ...) 
     25  MINT_KEY_PASS     list(keycertificate, ...) 
    2626    Prior:  MINT_KEY_FETCH_DENOMINATION 
    2727            MINT_KEY_FETCH_KEYID 
    … …  
    2929             
    3030  MINT_KEY_FAILURE  list(([denomination|#base64(key_identifier)], reason), ...) 
    31                     Reasons: 
    32                         Unknown denomination 
    33                         Unknown key_identifier 
    34                         Revoked key_identifier 
     31                                Reasons: 
     32                                        Unknown denomination 
     33                                        Unknown key_identifier 
     34                                        Revoked key_identifier 
    3535    Prior:  MINT_KEY_FETCH_DENOMINATION 
    3636            MINT_KEY_FETCH_KEYID 
    … …  
    4848                            list(token,...) 
    4949                            list(('type', type), (option, value),...) 
    50                             Types: 
    51                                 'redeem' 
    52                                 'exchange' 
    53                                 'mint' 
     50                                Types: 
     51                                        'redeem' 
     52                                        'exchange' 
     53                                        'mint' 
    5454    Prior:  Hello 
    5555    Follow: TRANSFER_TOKEN_REJECT 
    … …  
    5757            TRANSFER_TOKEN_DELAY 
    5858             
    59   TRANSFER_TOKEN_RESUME #base64(transaction_id) 
     59  TRANSFER_TOKEN_RESUME     #base64(transaction_id) 
    6060    Prior:  Hello 
    6161    Follow: TRANSFER_TOKEN_REJECT 
    … …  
    6464                 
    6565IS: 
    66   TRANSFER_TOKEN_REJECT #base64(transaction_id) 
    67                         type 
    68                         reason 
    69                         list(reason-detail)|list() 
    70                         Types: 
    71                             'Generic' 
    72                             'Option' 
    73                             'Target' 
    74                             'Token' 
    75                             'Blind' 
    76                         Reasons: 
    77                             Generic: 
    78                                 'Rejected' 
    79                             Option: 
    80                                 'Rejected' 
    81                                 'Unknown option' 
    82                                 'Incorrect type' 
    83                                 'See detail': 
    84                                     'None' 
    85                                     All options of Reason, except 'See detail' 
    86                             Target: 
    87                                 'Rejected' 
    88                                 'IS-Reject' + Issuer specific rejection string 
    89                             Token: 
    90                                 'Rejected' 
    91                                 'Invalid key_identifier' 
    92                                 'Revoked key' 
    93                                 'Invalid token' 
    94                                 'See detail': 
    95                                     'None' 
    96                                     All options of Reason, except 'See detail' 
    97                             Blind: 
    98                                 'Rejected' 
    99                                 'Invalid key_identifier' 
    100                                 'Key too soon' 
    101                                 'Key expired' 
    102                                 'Revoked key' 
    103                                 'Unable to sign' 
    104                                 'See detail': 
    105                                     'None' 
    106                                     All options of Reason, except 'See detail' 
     66  TRANSFER_TOKEN_REJECT     #base64(transaction_id) 
     67                            type 
     68                            reason 
     69                            list(reason-detail)|list() 
     70                                Types: 
     71                                        'Generic' 
     72                                        'Option' 
     73                                        'Target' 
     74                                        'Token' 
     75                                        'Blind' 
     76                                Reasons: 
     77                                        Generic: 
     78                                                'Rejected' 
     79                                        Option: 
     80                                                'Rejected' 
     81                                                'Unknown option' 
     82                                                'Incorrect type' 
     83                                                'See detail': 
     84                                                        'None' 
     85                                                        All options of Reason, except 'See detail' 
     86                                        Target: 
     87                                                'Rejected' 
     88                                                'IS-Reject' + Issuer specific rejection string 
     89                                        Token: 
     90                                                'Rejected' 
     91                                                'Invalid key_identifier' 
     92                                                'Revoked key' 
     93                                                'Invalid token' 
     94                                                'See detail': 
     95                                                        'None' 
     96                                                        All options of Reason, except 'See detail' 
     97                                        Blind: 
     98                                                'Rejected' 
     99                                                'Invalid key_identifier' 
     100                                                'Key too soon' 
     101                                                'Key expired' 
     102                                                'Revoked key' 
     103                                                'Unable to sign' 
     104                                                'See detail': 
     105                                                        'None' 
     106                                                        All options of Reason, except 'See detail' 
    107107    Prior:  TRANSFER_TOKEN_REQUEST 
    108108            TRANSFER_TOKEN_RESUME 
    109109    Follow: Goodbye 
    110110     
    111   TRANSFER_TOKEN_ACCEPT #base64(transaction_id) 
    112                         list(signed_blind,...) 
     111  TRANSFER_TOKEN_ACCEPT     #base64(transaction_id) 
     112                            list(signed_blind,...) 
    113113    Prior:  TRANSFER_TOKEN_REQUEST 
    114114            TRANSFER_TOKEN_RESUME 

  • trunk/standards/messages/all.txt

    r148 r159  
    55 
    66=============           ===================== 
    7 = BLANK     =           = MINT_KEY          = 
    8 = COIN      =           = TRANSFER_TOKEN    = 
     7= SUM       =           = MINT_KEY          = 
     8= TOKEN     =           = TRANSFER_TOKEN    = 
    99=============           ===================== 
    1010                         
    … …  
    2323 
    2424============= 
    25 = BLANK     = 
    26 = COIN      = 
     25= SUM       = 
     26= TOKEN     = 
    2727============= 
    2828 
    29 BLANK 
     29SUM 
    3030----- 
    3131 
    3232A: 
    33   BLANK_PRESENT dsdb_keycertificate #hex_string(number_of_blanks) 
    34                 blank1 
    35                 blank2 
     33  SUM_ANNOUNCE  #base64(transaction_id) 
     34                standard identifier 
     35                currency identifier 
     36                amount 
     37                target (what exactly is the target? Should it be base64 encoded?) 
    3638        Prior:  Hello 
    37         Follow: BLANK_FAILURE 
    38                 BLANK_REJECT 
    39                 BLANK_ACCEPT 
     39        Follow: SUM_ACCEPT  
     40                SUM_REJECT 
    4041 
    4142B: 
    42   BLANK_REJECT  #hex_string(number_of_failures) 
    43                 #base64(encrypted serial of blank1) "Reason1" 
    44                 #base64(encrypted serial of blank2) "Reason2" 
    45                     Reasons: 
    46                         Malformed blank 
    47                         Unknown issuer 
    48                             Note: Also used for an untrusted issuer 
    49         Prior:  BLANK_PRESENT 
     43  SUM_ACCEPT 
     44        Prior:  SUM_ANNOUNCE 
     45        Follow: TOKEN_REDEEM 
     46                         
     47  SUM_REJECT 
     48        Prior:  SUM_ANNOUNCE 
    5049        Follow: Goodbye 
    5150                         
    52   BLANK_REJECT  #hex_string(0) "reason" 
    53                     Reason: 
    54                         Cancelled 
    55                         Insufficient currency 
    56         Prior:  BLANK_PRESENT 
     51 
     52 
     53TOKEN 
     54----- 
     55 
     56A: 
     57  TOKEN_REDEEM  list(token) 
     58        Prior:  SUM_ACCEPT 
     59        Follow: TOKEN_REJECT 
     60                TOKEN_ACCEPT 
     61 
     62B: 
     63  TOKEN_REJECT  type 
     64                list(detail-reason)|list() 
     65                    Reasons: 
     66                        'Rejected' 
     67                        'Invalid token' 
     68                        'See detail': 
     69                            'None' 
     70                            All options of Reason, except 'See detail' 
     71        Prior:  TOKEN_REDEEM 
     72        Follow: TOKEN_REDEEM 
     73                Goodbye 
     74 
     75  TOKEN_ACCEPT 
     76        Prior:  TOKEN_REDEEM 
    5777        Follow: Goodbye 
    58                          
    59  
    60   BLANK_FAILURE #hex_string(number_of_failures) 
    61                 #base64(encrypted serial of blank1) "Reason1" 
    62                 #base64(encrypted serial of blank2) "Reason2" 
    63                     Reasons: 
    64                         DSDB: Key ID of DSDB is unknown or expired      Permanant 
    65                         DSDB: Key ID of blank is unknown or expired     Permanant 
    66                         DSDB: Decryption of serial failed               Permanant 
    67                         DSDB: Serial already redeemed                   Permanant 
    68                         DSDB: Serial locked (not spent)                 Temporary 
    69         Prior:  BLANK_PRESENT 
    70         Follow: Goodbye 
    71  
    72   BLANK_FAILURE #hex_string(0) "reason" 
    73                     Reasons: 
    74                         Cancelled 
    75         Prior:  BLANK_PRESENT 
    76                 BLANK_ACCEPT (Message from self) 
    77         Follow: Goodbye 
    78  
    79   BLANK_ACCEPT 
    80         Note:   After ACCEPT, a REJECT #hex_string(0) can be given to abort the transaction 
    81         Prior:  BLANK_PRESENT 
    82         Follow: COIN_REDEEM 
    83                 BLANK_REJECT (Message from self) 
    84  
    85  
    86  
    87 COIN 
    88 ----- 
    89  
    90 A: 
    91   COIN_REDEEM   #hex_string(number_of) 
    92                 #base64(coin1) 
    93                 #base64(coin2) 
    94         Prior:  BLANK_ACCEPT 
    95         Follow: COIN_REJECT 
    96                 COIN_ACCEPT 
    97  
    98 B: 
    99   COIN_REJECT   #hex_string(number_of) 
    100                 #base64(coin1) "Reason1" 
    101                 #base64(coin2) "Reason2" 
    102                     Reasons: 
    103                         Invalid coin 
    104                         Unknown coin 
    105                             Note: Used when the coin we are given is different than the blank 
    106         Prior:  COIN_REDEEM 
    107         Follow: COIN_REDEEM 
    108                 Goodbye 
    109  
    110   COIN_REJECT   #hex_string(0) "Reason" 
    111                     Reasons: 
    112                         *I can't think of anything valid* 
    113         Prior:  COIN_REDEEM 
    114         Follow: COIN_REDEEM 
    115                 Goodbye 
    116  
    117   COIN_ACCEPT 
    118         Prior:  COIN_REDEEM 
    119         Follow: Goodbye 
     78 
    12079 
    12180 
    … …  
    13897 
    13998Wallet: 
    140   MINT_KEY_FETCH_DENOMINATION   list(denomination, ...) #TIME(time) 
     99  MINT_KEY_FETCH_DENOMINATION   list(denomination, ...) TIME(time)|'0' 
    141100    Prior:  Hello 
    142101    Follow: MINT_KEY_PASS 
    … …  
    155114             
    156115  MINT_KEY_FAILURE  list(([denomination|#base64(key_identifier)], reason), ...) 
    157                     Reasons: 
    158                         Unknown denomination 
    159                         Unknown key_id 
     116                                Reasons: 
     117                                        Unknown denomination 
     118                                        Unknown key_identifier 
     119                                        Revoked key_identifier 
    160120    Prior:  MINT_KEY_FETCH_DENOMINATION 
    161121            MINT_KEY_FETCH_KEYID 
    … …  
    170130  TRANSFER_TOKEN_REQUEST    #base64(transaction_id) 
    171131                            target 
    172                             list(i-don't-remember-what-this-could-be-for,...) 
    173132                            list((#base64(key_identifier), list(blind,...)),...) 
    174                             list(coin,...) 
     133                            list(token,...) 
    175134                            list(('type', type), (option, value),...) 
    176                             Types: 
    177                                 'Redeem' 
    178                                 'Exchange' (What does this one infer?) 
     135                                Types: 
     136                                        'redeem' 
     137                                        'exchange' 
     138                                        'mint' 
    179139    Prior:  Hello 
    180140    Follow: TRANSFER_TOKEN_REJECT 
    … …  
    182142            TRANSFER_TOKEN_DELAY 
    183143             
    184   TRANSFER_TOKEN_RESUME #base64(transaction_id) 
     144  TRANSFER_TOKEN_RESUME     #base64(transaction_id) 
    185145    Prior:  Hello 
    186146    Follow: TRANSFER_TOKEN_REJECT 
    … …  
    189149                 
    190150IS: 
    191   TRANSFER_TOKEN_REJECT #base64(transaction_id) 
    192                         type 
    193                         reason 
    194                         list(reason-detail, reason-detail) 
    195                         Types: 
    196                             'Generic' 
    197                             'Option' 
    198                             'Blind' 
    199                             'Token' 
    200                         Reasons: 
    201                             Generic: 
    202                                 'Rejected' 
    203                             Option: 
    204                                 'Rejected' 
    205                                 'Unknown option' 
    206                                 'Incorrect type' 
    207                                 'See detail': 
    208                                     'None' 
    209                                     All options of Reason, except 'See detail' 
    210                             Blind: 
    211                                 'Rejected' 
    212                                 'Unknown key_identifier' 
    213                                 'Key too soon' 
    214                                 'Key expired' 
    215                                 'Unable to blind' 
    216                                 'See detail': 
    217                                     'None' 
    218                                     All options of Reason, except 'See detail' 
    219                             Token: 
    220                                 'Rejected' 
    221                                 'Unknown key_identifier' 
    222                                 'Key rejected' (we made the key invalid. ugh. what's the word?) 
    223                                 'Improper token' 
    224                                 'See detail': 
    225                                     'None' 
    226                                     All options of Reason, except 'See detail' 
     151  TRANSFER_TOKEN_REJECT     #base64(transaction_id) 
     152                            type 
     153                            reason 
     154                            list(reason-detail)|list() 
     155                                Types: 
     156                                        'Generic' 
     157                                        'Option' 
     158                                        'Target' 
     159                                        'Token' 
     160                                        'Blind' 
     161                                Reasons: 
     162                                        Generic: 
     163                                                'Rejected' 
     164                                        Option: 
     165                                                'Rejected' 
     166                                                'Unknown option' 
     167                                                'Incorrect type' 
     168                                                'See detail': 
     169                                                        'None' 
     170                                                        All options of Reason, except 'See detail' 
     171                                        Target: 
     172                                                'Rejected' 
     173                                                'IS-Reject' + Issuer specific rejection string 
     174                                        Token: 
     175                                                'Rejected' 
     176                                                'Invalid key_identifier' 
     177                                                'Revoked key' 
     178                                                'Invalid token' 
     179                                                'See detail': 
     180                                                        'None' 
     181                                                        All options of Reason, except 'See detail' 
     182                                        Blind: 
     183                                                'Rejected' 
     184                                                'Invalid key_identifier' 
     185                                                'Key too soon' 
     186                                                'Key expired' 
     187                                                'Revoked key' 
     188                                                'Unable to sign' 
     189                                                'See detail': 
     190                                                        'None' 
     191                                                        All options of Reason, except 'See detail' 
    227192    Prior:  TRANSFER_TOKEN_REQUEST 
    228193            TRANSFER_TOKEN_RESUME 
    229194    Follow: Goodbye 
    230195     
    231   TRANSFER_TOKEN_ACCEPT #base64(transaction_id) 
    232                         list(signed_blind,...) 
     196  TRANSFER_TOKEN_ACCEPT     #base64(transaction_id) 
     197                            list(signed_blind,...) 
    233198    Prior:  TRANSFER_TOKEN_REQUEST 
    234199            TRANSFER_TOKEN_RESUME 

  • trunk/standards/messages/wallet.to.wallet.txt

    r81 r159  
    44 
    55============= 
    6 = BLANK     = 
    7 = COIN      = 
     6= SUM       = 
     7= TOKEN     = 
    88============= 
    99 
    10 BLANK 
     10SUM 
    1111----- 
    1212 
    1313A: 
    14   BLANK_PRESENT dsdb_keycertificate #hex_string(number_of_blanks) 
    15                 blank1 
    16                 blank2 
     14  SUM_ANNOUNCE  #base64(transaction_id) 
     15                standard identifier 
     16                currency identifier 
     17                amount 
     18                target (what exactly is the target? Should it be base64 encoded?) 
    1719        Prior:  Hello 
    18         Follow: BLANK_FAILURE 
    19                 BLANK_REJECT 
    20                 BLANK_ACCEPT 
     20        Follow: SUM_ACCEPT  
     21                SUM_REJECT 
    2122 
    2223B: 
    23   BLANK_REJECT  #hex_string(number_of_failures) 
    24                 #base64(encrypted serial of blank1) "Reason1" 
    25                 #base64(encrypted serial of blank2) "Reason2" 
    26                     Reasons: 
    27                         Malformed blank 
    28                         Unknown issuer 
    29                             Note: Also used for an untrusted issuer 
    30         Prior:  BLANK_PRESENT 
    31         Follow: Goodbye 
     24  SUM_ACCEPT 
     25        Prior:  SUM_ANNOUNCE 
     26        Follow: TOKEN_REDEEM 
    3227                         
    33   BLANK_REJECT  #hex_string(0) "reason" 
    34                     Reason: 
    35                         Cancelled 
    36                         Insufficient currency 
    37         Prior:  BLANK_PRESENT 
     28  SUM_REJECT 
     29        Prior:  SUM_ANNOUNCE 
    3830        Follow: Goodbye 
    3931                         
    4032 
    41   BLANK_FAILURE #hex_string(number_of_failures) 
    42                 #base64(encrypted serial of blank1) "Reason1" 
    43                 #base64(encrypted serial of blank2) "Reason2" 
    44                     Reasons: 
    45                         DSDB: Key ID of DSDB is unknown or expired      Permanant 
    46                         DSDB: Key ID of blank is unknown or expired     Permanant 
    47                         DSDB: Decryption of serial failed               Permanant 
    48                         DSDB: Serial already redeemed                   Permanant 
    49                         DSDB: Serial locked (not spent)                 Temporary 
    50         Prior:  BLANK_PRESENT 
    51         Follow: Goodbye 
    5233 
    53   BLANK_FAILURE #hex_string(0) "reason" 
    54                     Reasons: 
    55                         Cancelled 
    56         Prior:  BLANK_PRESENT 
    57                 BLANK_ACCEPT (Message from self) 
    58         Follow: Goodbye 
    59  
    60   BLANK_ACCEPT 
    61         Note:   After ACCEPT, a REJECT #hex_string(0) can be given to abort the transaction 
    62         Prior:  BLANK_PRESENT 
    63         Follow: COIN_REDEEM 
    64                 BLANK_REJECT (Message from self) 
    65  
    66  
    67  
    68 COINS 
     34TOKEN 
    6935----- 
    7036 
    7137A: 
    72   COIN_REDEEM   #hex_string(number_of) 
    73                 #base64(coin1) 
    74                 #base64(coin2) 
    75         Prior:  BLANK_ACCEPT 
    76         Follow: COIN_REJECT 
    77                 COIN_ACCEPT 
     38  TOKEN_REDEEM  list(token) 
     39        Prior:  SUM_ACCEPT 
     40        Follow: TOKEN_REJECT 
     41                TOKEN_ACCEPT 
    7842 
    7943B: 
    80   COIN_REJECT   #hex_string(number_of) 
    81                 #base64(coin1) "Reason1" 
    82                 #base64(coin2) "Reason2" 
     44  TOKEN_REJECT  type 
     45                list(detail-reason)|list() 
    8346                    Reasons: 
    84                         Invalid coin 
    85                         Unknown coin 
    86                             Note: Used when the coin we are given is different than the blank 
    87         Prior:  COIN_REDEEM 
    88         Follow: COIN_REDEEM 
     47                        'Rejected' 
     48                        'Invalid token' 
     49                        'See detail': 
     50                            'None' 
     51                            All options of Reason, except 'See detail' 
     52        Prior:  TOKEN_REDEEM 
     53        Follow: TOKEN_REDEEM 
    8954                Goodbye 
    9055 
    91   COIN_REJECT   #hex_string(0) "Reason" 
    92                     Reasons: 
    93                         *I can't think of anything valid* 
    94         Prior:  COIN_REDEEM 
    95         Follow: COIN_REDEEM 
    96                 Goodbye 
    97  
    98   COIN_ACCEPT 
    99         Prior:  COIN_REDEEM 
     56  TOKEN_ACCEPT 
     57        Prior:  TOKEN_REDEEM 
    10058        Follow: Goodbye