Wallet management

This doc specifies Messages to be used to manage wallets and token transactions, where,

<Wallet> is a JSON object compliant with Wallet data model.
<Transaction> is a JSON object compliant with Wallet Transaction data model.

Wallet creation request

Message sent by the Wallet Hyperty to the Wallet Manager hyperty, requesting a wallet creation.

"id" : 1,
"type" : "create",
"from" : "hyperty://<wallet-manager-domain>/<wallet-hyperty-identifier>",
"to" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>"
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>",
"to" :  "hyperty://<wallet-manager-domain>/<wallet-hyperty-identifier>"
"body": {
  "code": 200,
  "value": {<Wallet>}
}
Plaintext

Wallet delete request

Message sent by the Wallet Hyperty to the Wallet Manager hyperty, requesting a wallet removal.

"id" : 1,
"type" : "delete",
"from" : "hyperty://<wallet-manager-domain>/<wallet-hyperty-identifier>",
"to" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>"
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>",
"to" :  "hyperty://<wallet-manager-domain>/<wallet-hyperty-identifier>"
"body": {
  "code": 200
}
Plaintext

Wallet Address request

Message sent to the Wallet Manager hyperty, requesting the wallet address of a certain user.

"id" : 1,
"type" : "read",
"from" : "hyperty://<sp-domain>/<hyperty-identifier>",
"to" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>",
"body": {
  "resource": 'user',
  "value": "userId"
}
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty-identifier>",
"to" :  "hyperty://<sp-domain>/<hyperty-identifier>",
"body": {
  "code": 200,
  "value": "<wallet-address>"
}
Plaintext

Read Wallet

Message sent to the Wallet address, requesting to read the full wallet of a certain user, including all transactions.

"id" : 1,
"type" : "read",
"from" : "hyperty://<sp-domain>/<hyperty-identifier>",
"to" : "wallet://<wallet-manager-domain>/<wallet-identifier>"
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "wallet://<wallet-manager-domain>/<wallet-identifier>",
"to" :  "hyperty://<sp-domain>/<hyperty-identifier>",
"body": {
  "code": 200,
  "value": "{<Wallet>}"
}
Plaintext

Wallet Transfer

Message sent to the Wallet address, requesting to transfer a certain amount.

"id" : 1,
"type" : "create",
"from" : "hyperty://<sp-domain>/<hyperty-identifier>",
"to" : "hyperty://<sp-domain>/<wallet-identifier>",
"body": {
  "value": "{<Transaction>}"
}
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "wallet://<wallet-manager-domain>/<wallet-identifier>",
"to" :  "hyperty://<sp-domain>/<hyperty-identifier>",
"body": {
  "code": 200,
  "value": "{<Transaction>}"
}
Plaintext

Wallet update

Message sent by the Wallet Manager Hyperty, publishing an update of a certain wallet.

"id" : 1,
"type" : "update",
"from": "hyperty://<wallet-manager-domain>/<wallet-manager-hyperty>,
"to" : "hyperty://<sp-domain>/<wallet-identifier>/changes",
"body": {
  "value": "{<Transaction>}"
}
Plaintext

Response

"id" : 1,
"type" : "response",
"from" : "wallet://<wallet-manager-domain>/<wallet-identifier>",
"to" :  "hyperty://<sp-domain>/<hyperty-identifier>",
"body": {
  "code": 200,
  "value": "{<Transaction>}"
}
Plaintext