package briolette.token

Get desktop application:
View/edit binary Protocol Buffers messages

Used in: mint.GetTokensRequest, receiver.TransactionItem, Descriptor, Tag

• int32 whole = 1

• float fractional = 2

  Must be [0.0, 1.0)

• AmountType code = 3

  Specifies the currency type promised but does not imply issuing authority for the currency. That will depend on mint (group) keys.

ISO Currency Codes (ISO 4217:2015) plus arbitrary codes.

Used in: Amount

• TEST_TOKEN = 0

• AED = 784

• AFN = 971

• ALL = 8

• AMD = 51

• ANG = 532

• AOA = 973

• ARS = 32

• AUD = 36

• AWG = 533

• AZN = 944

• BAM = 977

• BBD = 52

• BDT = 50

• BGN = 975

• BHD = 48

• BIF = 108

• BMD = 60

• BND = 96

• BOB = 68

• BOV = 984

• BRL = 986

• BSD = 44

• BTN = 64

• BWP = 72

• BYN = 933

• BZD = 84

• CAD = 124

• CDF = 976

• CHE = 947

• CHF = 756

• CHW = 948

• CLF = 990

• CLP = 152

• CNY = 156

• COP = 170

• COU = 970

• CRC = 188

• CUC = 931

• CUP = 192

• CVE = 132

• CZK = 203

• DJF = 262

• DKK = 208

• DOP = 214

• DZD = 12

• EGP = 818

• ERN = 232

• ETB = 230

• EUR = 978

• FJD = 242

• FKP = 238

• GBP = 826

• GEL = 981

• GHS = 936

• GIP = 292

• GMD = 270

• GNF = 324

• GTQ = 320

• GYD = 328

• HKD = 344

• HNL = 340

• HRK = 191

• HTG = 332

• HUF = 348

• IDR = 360

• ILS = 376

• INR = 356

• IQD = 368

• IRR = 364

• ISK = 352

• JMD = 388

• JOD = 400

• JPY = 392

• KES = 404

• KGS = 417

• KHR = 116

• KMF = 174

• KPW = 408

• KRW = 410

• KWD = 414

• KYD = 136

• KZT = 398

• LAK = 418

• LBP = 422

• LKR = 144

• LRD = 430

• LSL = 426

• LYD = 434

• MAD = 504

• MDL = 498

• MGA = 969

• MKD = 807

• MMK = 104

• MNT = 496

• MOP = 446

• MRU = 929

• MUR = 480

• MVR = 462

• MWK = 454

• MXN = 484

• MXV = 979

• MYR = 458

• MZN = 943

• NAD = 516

• NGN = 566

• NIO = 558

• NOK = 578

• NPR = 524

• NZD = 554

• OMR = 512

• PAB = 590

• PEN = 604

• PGK = 598

• PHP = 608

• PKR = 586

• PLN = 985

• PYG = 600

• QAR = 634

• RON = 946

• RSD = 941

• RUB = 643

• RWF = 646

• SAR = 682

• SBD = 90

• SCR = 690

• SDG = 938

• SEK = 752

• SGD = 702

• SHP = 654

• SLL = 694

• SOS = 706

• SRD = 968

• SSP = 728

• STN = 930

• SVC = 222

• SYP = 760

• SZL = 748

• THB = 764

• TJS = 972

• TMT = 934

• TND = 788

• TOP = 776

• TRY = 949

• TTD = 780

• TWD = 901

• TZS = 834

• UAH = 980

• UGX = 800

• USD = 840

• USN = 997

• UYI = 940

• UYU = 858

• UYW = 927

• UZS = 860

• VES = 928

• VND = 704

• VUV = 548

• WST = 882

• XAF = 950

• XCD = 951

• XDR = 960

• XOF = 952

• XPF = 953

• XSU = 994

• XUA = 965

• YER = 886

• ZAR = 710

• ZMW = 967

Used in: Token

• Version version = 1

• optional Amount value = 2

Used in: Token

• optional Transfer transfer = 1

• bytes signature = 2

  0th signature must be signed by a mint credential and uses recoverable ecdsa NistP256. All other signatures must be signed by a TTC credential. For all non-base signatures, the first bytes are the serialized credential. Trimming "reissues" the History and adds the trimmed_from tag. Trim servers use a different keypair than the mint which enables easier discovery of trim key abuse. The risk is still high, so other approaches may be appealing -- token swapping or having every trim server act as the "first" minted credential such that they can double spend but never change the value or original token tags.

Used in: clerk.GetTicketsReply, mint.GetTokensRequest, receiver.InitiateReply, swapper.GetDestinationReply, Transfer, tokenmap.StoreTicketsRequest

• optional Ticket ticket = 1

• bytes signature = 2

  Signature over a serialized ticket with a recovery byte appended.

Used in: mint.GetTokensRequest, Transfer

• oneof value

  • uint64 valid_until = 2

    epoch timestamp; only honored in first transfer.

  • bytes trimmed_from = 3

    original transfer signature (only verifiable by authority)

  • Amount split_value = 4

    new value which is less than the Descriptor value

Used in: SignedTicket

• bytes credential = 1

• optional TicketData tags = 2

Used in: Ticket

• uint32 group_number = 1

  Initially, a number in the range [0, 64).

• uint32 lifetime = 2

  # of epochs (currently 86400 second periods) it is valid.

• uint64 created_on = 3

  currrent epoch value and the required ticket request signature basename.

Used in: mint.GetTokensReply, receiver.TransactionItemMethod, receiver.TransferRequest, swapper.SwapTokensReply, swapper.SwapTokensRequest, tokenmap.Entry, tokenmap.UpdateRequest, validate.ValidateTokensRequest

• optional Descriptor descriptor = 1

• optional History base = 2

• repeated History history = 3

  TODO: optional "hint" value for splits?

Used in: History

• optional SignedTicket recipient = 1

  Credential commitment with policy.

• repeated Tag tags = 2

• bytes previous_signature = 3

  This is only populated during signing or verification, not for transport.

  Or digest(descriptor) for the 0th.

Used in: Descriptor

• V0 = 0