CloudCoin > RAIDA Protocol > RAIDA Change Services

Change Services (Command Group 9)

Takes larger notes and breaks them into smaller notes or vice versa.

Command Codes Code Meanings Get Available SNs Break Join

Command Codes

Command Code Service
91 Get Available SNs
92 Break
93 Join

Code Meanings

Code Meaning Sample in HEX
DN Denomination First four bits random.
SN Serial Number 16777215
AN Authenticity Number F5DD153926DA42E8A062A915AD763DF0
CH Challenge A random number generated by the client that they RAIDA must decrypt
SI Session ID FF01AABB

Get Available Change SNs

Returns SNs available to create change or to create joins. Returns a small number of tokens of one denomination lower. The number of returned tokens is 32 so far.

Request Format:

CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH SI SI SI SI // Session ID OP //Operation: 01 = Break, 02 = Join DN //Denominations you need SNs for to break or join 3E 3E

Example Return: 32 serial number of lower denomination.

DN SN SN SN SN SN SN SN SN SN SN SN SN SN SN SN SN ... SN SN SN SN 3E 3E

Break

Breaks one token into 10 smaller ones. When given an authentic token, and the SNs of 10 new tokens to be made, the RAIDA Will return 10 tokens of the next lower denomination. Only breaks one token per call.

Denomination Breakdown:

1000 -> 100×10
100 -> 10×10
10 -> 1×10
1 -> .10×10

Sample Break Request:

CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH SI SI SI SI //Session ID DN SN SN SN SN //The token that will be broke. AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN //The AN of the token to be broke. DN SN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN //The tokens to be returned and their new ANs DN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN DN SN SN SN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN //There's always 10 tokens returned. E3 E3

JOIN

Status: Not Implemented Yet

Takes any number of tokens that add up to one denomination and return that denomination. Then destroys the old tokens.

Format:

CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH CH SI SI SI SI //Session ID DN SN SN SN SN //The token that will be created and returned. PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN PN // The AN of the token to be returned DN SN SN SN SN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN // The tokens joined and destroyed DN SN SN SN PN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN SN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN PN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN SN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN PN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN SN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN PN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN SN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN DN SN SN SN PN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN AN // There will be a variable amount of tokens. .... E3 E3