Send V 6/12/2018

Purpose:

The Send allows many coins to be authenticated at the same time but their PANs are generated by the RAIDA instead of the owner. This allows CloudCoins to be transfered from person to person with no powning necessary.

rules:

"to_sn" must be a number between 1 and 16,777,215 because it is the serial number of a CloudCoin that a user must own in order to retrieve the coins.

"tag_name" must not start or end with any white space character and must use only UTF-8 characters. All the Characters must be English Alphanumeric.

NOTE: Spaces in the tag should be represended by any 'special' characters in the 'tag' must be urlencoded.

EXAMPLE POST SENDING THREE COINS TO SN 16225354

    https://s0.teleportnow.cc/service/send
    nn=1&
    sns[]=145895&sns[]=66585&sns[]=16589554&
    ans[]=8ae06de0f9ce4917b3309df71570f92c&ans[]=b25fc7a548c341c98cefbac35689aff1&ans[]=f193f1304ffc4344822c10be9309a4c3&
    denomination[]=250&denomination[]=1&denomination[]=250&
    to_sn=16225354&
    tag_name=1Z%20999%20AA1%2001%202345%206784

        

RESPONSE IF SUCCESS:

[{
  "server":"RAIDA1",
  "status":"pass",
  "sn":"66585",
  "nn":"1",
  "message":"Authentic: 1-unit. Your coins have been sent to the address you specified.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"pass",
  "sn":"66586",
  "nn":"1",
  "message":"Authentic: 1-unit. Your coins have been sent to the address you specified.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"pass",
  "sn":"16589554",
  "nn":"1",
  "message":"Authentic: 250-unit. Your coins have been sent to the address you specified.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF TOO MANY COINS SENT (OVER 400)

          [{
  "server":"RAIDA1",
  "status":"dud",
  "message":"Length: Too many coins attached.",
  "time":"2016-44-19 7:44:PM"
}]

      

RESPONSE IF ARRAY LENGTHS NOT THE SAME

[{
        
        "server":"RAIDA1",
        
        "status":"dud",
        
        "message":"Length: Arrays not all the same length (nn,sn,an,denominations).",
        
        "time":"2016-44-19 7:44:PM"
        
        }]

Show V 6/12/2018

Purpose:

This service shows how many coins you have that belong to you that you have not taken control of yet. Each coin will be listed so that the person will know what they have.

"tag" must not start or end with any white space character and must use only UTF-8 characters.

Example GET asking to see all the coins they own in the transfer file.

	
https://s0.teleportnow.cc/service/show?nn=1&sn=1&an=1836843d928347fb22c2142b49d772b5&pan=1836843d928347fb22c2142b49d772b5&denomination=1

RESPONSE SHOWING THAT THERE ARE TEN COINS OWNED IN THE TRANSFER TABLE:

{
    "server": "RAIDA0",
    "status": "pass",
    "message": [
        {
            "sn": "11",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780031"
        },
        {
            "sn": "12",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780326"
        },
        {
            "sn": "13",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780351"
        },
        {
            "sn": "14",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780351"
        },
        {
            "sn": "15",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780351"
        },
        {
            "sn": "16",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559780351"
        },
        {
            "sn": "17",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559784415"
        },
        {
            "sn": "18",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559785124"
        },
        {
            "sn": "19",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559785224"
        },
        {
            "sn": "20",
            "tag": "q1w2e3r4 asdasda asdasdf",
            "created": "1559785553"
        }
    ],
    "time": "2019-06-13 05:27:35",
    "nn": "1",
    "sn": "21"
}

RESPONSE IF SOME PARAMETERS WERE NOT SUPPLIED

{
  "server":"RAIDA1",
  "status":"dud",
  "message":"Parameters: The request requires you to supply the id_sn, id_nn and id_ans parameters."
  "time":"2016-44-19 7:44:PM"
}

RESPONSE IF ACCOUNT DID NOT LOG IN CORRECTLY

{
  "server":"RAIDA1",
  "status":"fail",
  "message":"Login: Authenticity Number was incorrect for the Serial Number .",
  "time":"2016-44-19 7:44:PM"
}


Rename Tag Protocol V 6/12/2018

Purpose:

Rename Tag allows you to take an entire envelope and either change its name or move the entire contents into an existing envelope. This way, CloudCoins that have been sent to you may be moved to a different envelope. A person may want to do this to protect themselves from a person trying to use the same envelope name over and over again to prove that they paid for something. This is because the envelope name can be used by the sender as a proof of payment. The Rename Tag service also tells how much was in the envelope so the receiver can tell if they have been paid enough.

One option is to only rename the envelope if it contains the exact amount specified. This way, if someone receives CloudCoins as payment, they can reject it if it is not enough

In that case you can use the optional if_total_wrong_return_to_number to return the CloudCoins to sender.

Example GET asking to change the name of an tag or envelope.

https://s0.teleportnow.cc/service/rename_tag?
nn=1&
sn=1&
an=1836843d928347fb22c2142b49d772b5&
pan=1836843d928347fb22c2142b49d772b5&
denomination=1&
tag=1Z 999 AA1 01 2345 6784&
new_tag=6892ed132f8741a6ab1332eb5a4543ec
if_total=250  //THIS IS OPTIONAL
if_total_wrong_return_to_number=16777215 //THIS IS OPTIONAL

RESPONSE IF GOOD:

{
  "server":"RAIDA1",
  "status":"imported",
  "total_coins":"1562",
  "message":"Moved: The coins in the envelope specified are now in the new envelope and the old envelope has been removed",
  "time":"2016-44-19 7:44:PM"
}

0re", "time":"2016-44-19 7:44:PM" }

Receive V 6/12/2018

Purpose:

The Receive service allows many coins to be downloaded from the RAIDA at the same time. The Receiver can download all of their coins, or just some of there coins. But it must specify the coins it wants to download by serial number. This means the client will have to do a "ShowCoins" so they can get a list of the serial number that they have. This allows the RAIDA to actaully store coins for people. The Receiver must supply proof that they are the owner. They prove that they are the owner by supplying a serial number of a CloudCoin that they own (their account number) and the AN for that serial number. The RAIDA checks its tranfer table and starts giving coin until the amount of coins asked to be downloaded is reached.

This allows CloudCoins to be transfered from person to bank with no powning necessary.

rules: "to_number" must be a number between 1 and 16,777,215 because it is the serial number of a CloudCoin that a user must own in order to retrieve the coins.

"envelope_name" must not start or end with any white space character and must use only UTF-8 alpha numeric characters.

Example POST asking for specific CloudCoins

Example POST asking for specific CloudCoins

https://s0.teleportnow.cc/service/receive?
nn=1&
sn=1&
an=1836843d928347fb22c2142b49d772b5&
pan=1836843d928347fb22c2142b49d772b5&
denomination=1&
nns[]=1&
nns[]=1&
nns[]=1&
sns[]=152658&
sns[]=9955856&
sns[]=6652154&
     
 

RESPONSE IF GOOD:

[{
  "server":"RAIDA1",
  "status":"received",
  "sn":"152658",
  "nn":"1",
  "an":"c18889d9028240b796ea2389d0e36219",
  "message":"Please record the an provided within a CloudCoin file",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"received",
  "sn":"9955856",
  "nn":"1",
  "an":"e56507ecd05945d990bf6655546bdeff",
  "message":"Please record the an provided within a CloudCoin file",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"missing",
  "sn":"6652154",
  "nn":"1",
  "an":"",
  "message":"Nonexistant: That serial number has not been transfered to the id provided.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE:

[{
  "server":"RAIDA19",
  "status":"success",
  "sn":"145895",
  "nn":"1",
  "message":"Fixed: Unit's AN was changed to the PAN. Update your AN to the new PAN.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA19",
  "status":"success",
  "sn":"66585",
  "nn":"1",
  "message":"Fixed: Unit's AN was changed to the PAN. Update your AN to the new PAN.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA19",
  "status":"error",
  "sn":"16589554",
  "nn":"1",
  "message":"Connection: Could not connect to Server 11.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF TOO MANY COINS SENT (OVER 400)

[{
  "server":"RAIDA19",
  "status":"dud",
  "message":"Length: Too many coins attached.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF ARRAY LENGTHS NOT THE SAME

[{
  "server":"RAIDA19",
  "status":"dud",
  "message":"Length: Arrays not all the same length (nn,sn,an,denominations).",
  "time":"2016-44-19 7:44:PM"
}]

Transfer V 6/12/2018

Purpose:

The Transfer allows people to move coins from their account to another account.

Example POST asking to transfer 3 CloudCoin notes to user 16225354

https://s0.teleportnow.cc/service/receive?
nn=1&
sn=16777216&
an=8ae06de0f9ce4917b3309df71570f92c&
pan=8ae06de0f9ce4917b3309df71570f92c&
denomination=1&
to_sn=16225354&
nns[]=1&
nns[]=1&
nns[]=1&
sns[]16777214&
sns[]16777215&
sns[]16777216&
tag=8d0caf3

     
 

RESPONSE IF GOOD:

[{
  "server":"RAIDA1",
  "status":"transfered",
  "sn":"16777214",
  "nn":"1",
  "message":"transfered: This coin has been sent to the address you specified.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"transfered",
  "sn":"16777215",
  "nn":"1",
  "message":"Authentic: 1-unit. Your coins have been sent to the address you specified.",
  "time":"2016-44-19 7:44:PM"
},
{
  "server":"RAIDA1",
  "status":"fail",
  "sn":"16777216",
  "nn":"1",
  "message":"Nonexistant: The serial Number does not belong to id given.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF TOO MANY COINS SENT (OVER 400)

[{
  "server":"RAIDA1",
  "status":"dud",
  "message":"Length: Too many coins attached.",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF ARRAY LENGTHS NOT THE SAME

[{
  "server":"RAIDA19",
  "status":"dud",
  "message":"Length: Arrays not all the same length (nn,sn,an,denominations).",
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF ANY OF THE sns ARE THE SAME AS THE to_sn

[{
  "server":"RAIDA1",
  "status":"dud",
  "message":"sns: no sns can be the same as to_sn"
  "time":"2016-44-19 7:44:PM"
}]

RESPONSE IF ACCOUNT DID NOT LOG IN CORRECTLY

[{
  "server":"RAIDA1",
  "status":"fail",
  "message":"Login: Authenticity Number was incorrect for the Serial Number .",
  "time":"2016-44-19 7:44:PM"
}
]

How to get change

Advanced Client: Breaking 250s, 100s, 25s and 5s into smaller notes. Sequence of events: 1. User tries to transfers an amount of CloudCoins. 2. Exporter checks to see if the transfer requires change. 3. If Yes: Check if the user has a Sky Wallet. If they do have a Sky Wallet, go to step 4. If No: Tell the user "You don't have the exact change. Either specify an exact amount or create a Skywallet to receive change" (END) 4. Find a note that is bigger than the amount to be transfer. This note will be in the bank, fracked folder or vault. If the user wants to spend 4 CloudCoin. If the user wants to send 4 CloudCoins, look for a 5 note. If the user wants to send 75 CloudCoin, look first for a 100 notes. If in the vault, prompt for password. 5. Send the one note to "Change.SkyWallet.cc". Use a guid for the tag (envelope name). This tag is called the "Shared Secret". 6. Call the request_change service at https://Raida18.CloudCoin.Global/service/request_change to tell the change maker that you need change. This is how the request_change GET must be made: https://raida18.cloudcoin.global/service/request_change?sn=1366558&tag=f2f5cced72f34ca8b6b26b6d1ba6ed59&total_coins_sent=250 Note that the SN is the user account that is to receive the smaller notes. total_coins_send should be 5, 25, 100 or 250. Nothing else. 7. The Change maker will use the shared secret to check that the money has arrived into account 2. Then it will put the smaller notes in the user's account. It will use the same Shared Secret. Expect that it will take 30 second. We will try to get it faster. 6. If the request_change.php returns good: {"server":"Change","status":"Change","message":"Check your account for change.","time":"'.$date.'"} IF BAD: {"server":"Change","status":"fail","message":"Could not make change.","time":"'.$date.'"} 7. Now use "Receiver" to get the coins.The envelop or tag will be the same as the user sent. 8. Make sure the coins received are the same amount sent. 9. Continue with the transfer.