Wallet Authentication

Access to core network

The Gudix Core System consists of wallets. A wallet is made up of a public key, private key, password and system-relevant security data for encryption. A hash based on Bcrypt is created from a password, which is known as a seed in known systems. The Bcrypt hash is the internal wallet identification and is called NulletID. The NulletID is for internal use only and does not leave the network. The NulletID is encrypted to a public and private key. The private key is called Nullet and is known to the user. Each nullet is unique as a displayed string in the network. The same NulletID can generate different Nullets, but points to the same value memory and the same password. Any number of receiver addresses (public keys) can be generated. Each public key is unique. Public keys can be published and information can also be encoded. So it is possible that a receiver address is enriched with a webhook URL to which the network sends information when a transaction is carried out.

To create a nullet, a POST request must be sent to the core. Any password can be chosen. The password alone is only to be understood as a seed. Only with a password you have no access to the network, the nullets (private key) and the password are required. Even with the private key alone, you have no access to the password, but read permission is granted. Whoever owns the private key has read access to the data it contains. The public key is only a recipient address and cannot be assigned to any nullet from outside. To ensure anonymity, we recommend creating a new receiver for each transaction. Mixing values is therefore unnecessary.

Blockchain
and Gas


A nut is similar to gas on the Ethereum blockchain (generation 2), but has a different function. Gas is paid out to the miner, who validates transactions. The confirmation time varies. If a transaction is to be carried out quickly, gas must be increased. On the Bitcoin blockchain, the transaction must also be incremented in order to confirm the transaction more quickly. Also, by lowering fees, it can take 24 hours for a transaction to be confirmed.

Permissionen

It is possible to grant a third party access to the wallet via a permission. A permission is an encryption and a hash between the private key and the public key of the additionally authorized party. It is possible that your own nullet are connected to a master account and it is possible that the master account creates a nullets for sub-accounts. Both ways mean that the master account has full access to the sub-account without knowing the password of the sub-account and without having to save the null (private key) of the sub-account. The master account is only in possession of its own nullet and has authorization for the sub-account. The master logs into the sub-account with his nullet and authorization.

1. Generetaion
Blockchain


The first generation of the blockchain had the disadvantage that the possession of the private key also granted access to the wallet. About 98% of the private keys of Bitcoin wallets are currently stored by providers such as Coinbase, PayPal or Robin Hood. In order to fine-tune the security concept behind it, we decided to work with permissions so that no private keys or passwords have to be saved. In the worst case, a stolen permission is useless for the attacker, since the permission can only be used together with the master nullet. A permission works similarly to a Merkle tree. A hash that lies between 2 hashes is only connected between the first and the next hash. The permission is only valid for the first nullet and connects the next nullet. The permission takes up the space in the middle and cannot be used for other nullets. The attacker would have to have the master nullet's private key and the master nullet's password in order to access the sub-nullet together with the permission.

Introduction

The Gudix® Core is accessible via an API interface. The interface guarantees a connection to any application. The creation of a nullet and the use of Gudix® Net is free and unlimited. Gudix is responsible for ensuring that Nuts and tokens can change owners securely via the interface.

Extensions

This API documentation and the API interface are constantly being expanded. Please let us know what information you need so that we can activate the extension. all information on gudix net is also accessible via the API.

JSON Format

Read the interface documentation for more details. The API interface only accepts JSON-formatted requests and also delivers responses in JSON-formatted form. The interface accepts JSON body information.

HTTP/HTTPS

We communicate via HTTPS. For security reasons, we recommend using HTTPS only. HTTP requests will be redirected to HTTPS.

Errors

We strive to ensure the use of the interface as uniformly as possible. If a format is incorrect or something else goes wrong, we will return a status code 400 with a JSON error and a short explanation.

Requestmethods

Only POST or GET Methods allowed.

How to connect to the interface

Every program and every application that allow HTTPS requests are suitable to access the Gudix® Net. A relatively simple use can be realized with Postman. Simply import the collection into POSTMAN, complete parameters and get started.

Enduser Interface

As an enduser it's recommended to use web interface to access to the Gudix® Net. Just press the login button.

Test the Gudix Network trough Postman Interface

Create nullet


To generate a nullet, all you need is an individual password. We encrypt the password and supplement it with server information, which results in a nullet id. The nullet id is for private use only and not for public. Only creator can see the nullet, not even we know your nullet. Only those who have the nullet and password can access the value. We recommend that you print out the nullet for restore purpuse only. We also see an advantage in having the nullet generated as a QR code.


https://api.gudix.net/createnullet
POST

password string

Random String and free of choice in characters and length. Please choose high security password in your own choice. The password can't be changed. Choose wise


webhook string

we send POST Request to this URL when recieving nuts.

JSON Body:
{
	"password": "whatYouWant"
}
Response:
{
    "nullet": "C8BNwokULVf2YmvUJtI2_RI3iEdLKRdG3YpVEMnXlSrFFAz0x0uz62bs4vTsSy0X22GB3lJdLltA9Ptd8lwv7G_Cy12M5QA4xGjROaRaY1VzGUOvOcrs3vnHHRdus92kCUGWvD6G2bMwJimqHJKn0FtOwIZvRUi0B3p4RutF7Zp1_cXQBN0HjqjklXl3gRid4K0xIPDA",
    "reciever": "Sx-QgbgH5uE6_R-Ylg2x1dQ3rZsb2v8H8BivVXwpbB4jqaqQb2SYPVS7ua1GiyA26drdErobl_kb5bIn3y405LtklmxEQwo0Ach0zbVkfEQyF_k5qkS3igbx99NN_XTK7jRFk3yka-jub0pLrhdzvFJ5hqyN38ZT55Hap-UEqst1_sypRpwxNZJichKWJEZt8AFx5ClFT23_iZPuLqvNsad-CtQKdGElCbZw4i_Pq4qguBhlbZQL9hsdcRXULoQpk7c=",
    "message": "Do not share your Nullet-ID. Just share reciever id to get nuts."
}

Create permission


you can give some one access to your nullet without sharing your nullet or password. This is practical for service providers, marketplaces or plattform to give them the possibility to access your nullet. The master can log in on your behalf.


https://api.gudix.net/createnullet
POST

nullet string

private key


password string

Random String and free of choice in characters and length. Please choose high security password in your own choice. The password can't be changed. Choose wise


reciever string

you have to send the public key of the masternullet you want to authorize.

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "reciever": "NGHYUY2C2Wk8Vwg2shfMI5l9bcAdNmfbjilgA_Bb9mOpRDxQDPG0MPHnZVoXGDHk2DQRJsGzcPPfFMsescIUwP63SOgTQzzbC3KueB4MNKghC3ihGscI6yweXDKXrgtHbfEP7c9WTWztZqv1oZ1srQtOFMJz_8kM5s9yWplxkmXB_zFOoC4rbAI2pCenMUBsHeY0XkTKASFCy3AR3gEZQjLe4VdHdXf64SP32wom1fL0OY4kJiqxxwk1ti2ZtHGVXSLpScpL9mbi5Sn-F1WVBkcC_z4="

}
Response:
{
    "permission": "WQQ4x0fFJhGjC38KUcHfk3NZUsvHpaxPfp6_weV3mljpLzLglznPbITXHzDYzMDTP1w6VBemDhj6GH_YlyimOziVo4LjLmQJjqUb96KkIhwh6DgUBP9cPr5AivhPTwRF8DXc2vxNm9XGlemxb5uPdCeV9KwA5CJn5KXnGK27issqCQJnCdaSAk2JIEWn68ui0xbx3pUhG1mGtktyRuug4owKtF9N8LDeHv_XjlxyHhL_NAq52roei3ujlK-8Hnbhm3Tx1m6KtPxeEKsw25wP2IwVLoUE6D_SaMPK3y8dnPdYFej3Nb7TyTOptJsAzASAi3MqFRLn6AWdJly2Her9PFnyOQL4GedkJRordrGy7QbsrVZ7XJSLIrm5_G8pY1Msi6Q4omEgovA34cpXZnM8BZc="
}

Check permission


Every time a password is needed a masternullet can use a permission string in case of the password. If the permission is created based on the masters public address from (see the above). The master is loged in like the subnullet


https://api.gudix.net/createnullet
POST

nullet string

private key


password string

validates nullet


permission string

encrypted string

JSON Body:
{
    "nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "permission": "WQQ4x0fFJhGjC38KUcHfk3NZUsvHpaxPfp6_weV3mljpLzLglznPbITXHzDYzMDTP1w6VBemDhj6GH_YlyimOziVo4LjLmQJjqUb96KkIhwh6DgUBP9cPr5AivhPTwRF8DXc2vxNm9XGlemxb5uPdCeV9KwA5CJn5KXnGK27issqCQJnCdaSAk2JIEWn68ui0xbx3pUhG1mGtktyRuug4owKtF9N8LDeHv_XjlxyHhL_NAq52roei3ujlK-8Hnbhm3Tx1m6KtPxeEKsw25wP2IwVLoUE6D_SaMPK3y8dnPdYFej3Nb7TyTOptJsAzASAi3MqFRLn6AWdJly2Her9PFnyOQL4GedkJRordrGy7QbsrVZ7XJSLIrm5_G8pY1Msi6Q4omEgovA34cpXZnM8BZc="
}
Response:
{
    "nuts": 5,
    "balance": 5,
    "xchf": 0,
    "chf": 0,
    "token": null
}

Create reciever address


Reciever address is the public key. Any amount of receiver addresses can be generated with just one nullet. This is a public id. You can share publid address with the world to recieve value. A receiver can contain a webhook, which receives a POST request from each time it recieves some nuts, tokens or fiat. We recommend testing the webhook function at webhook.site.


https://api.gudix.net/reciever
POST

nullet string

private key


webhook string

we send POST Request to this URL when recieving token.

JSON Body:
{
	"nullet": "p48OxschQ6icQzqEkk64B08F23HTxdNl4VV6zxWsTAZ3eUcTzdQaxoZ1CupKk8P7OaZlThC5QL3hVGSYAEhn1UJwb7IwTgYABWeyRSzErDd5pHmtyOmnzPRUf--0hpM1fuVhzhL6NZqmYottoHaSlcf_3oPBQjg91izV-j6reRHq4bsGNj3DbGw3PZkJcRlgG_rn_wpR",
	"webhook": "https://webhook.site/b945870a-4419-4649-a4f0-4332027869bc"
}
Response:
{
    "reciever": "9ZS7UFZjlE9jdR8uBZCgJ8ttusSfvHQDmfz7jdOjbGkxwDzrUBo5oWg_zymqdd7bwjDlloGeYkOvxYAqaFvrNKNSv5XE8WyxfGYCtQehn5IeRm8acXMtpgKTdh7926LEEBBuMKHlyfLsAtOWoreuJhCCKw5yPN2Co-4ZyN-Xr4VwtTiKy_FxHkx4JlKCuG1nPucV6ueJGqxf0Unc1OM6t16IJitgmYW8-VKz9JSN11nmFJFRC0iDwc014jfetbtkh8a3zgQCsv7WFzOLE7NyCoLQ4X6SEi2H55S_PUBZoEYYTOfB-lzw-KaemwxszlAXwwj4AnpTjHuMdWfsoMFea14SwZVKG-3OeQLG2Oiq9PliSPXyyIvynDY5_b2p3ImNRAiw"
}

Send nuts


To send nuts, you need a recipient's reciever address. You cannot send nuts to a nullet id.

Paper
Nuts are digital goods that you can get out of the digital world if necessary. Send the nuts to the reciever gudix_paper and you will get a transaction code that you can print out and bring to safety. The printed-out nuts are like a physical wallet; if you have the paper, you can put the nuts back into the network. You can also provide the paper with a separate password to ensure additional security. Think of it like a bearer share. The one who owns the bearer share can dispose of it.


https://api.gudix.net/sendnuts
POST

sender string

private key


password string


nuts integer

is required, also for paying invoice to check the correct amount.


reciever string

choose gudix_paper as reciever if you want to store the nuts offline and take it out of the network.


message string

reciever of nuts can read this message


paperpw string

if sending nuts to offline papers you can protect paper with paper password.

JSON Body:
{
    "sender": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
    "password": "asdfasdf",
    "reciever": "gudix_paper",
    "nuts": 600,
    "message": "have fun with your Gudix® Nuts"
}
Response:
{
    "transaction": "vNxSkJdIU6W5zKaILcpQ2hHLrZseSBqyqLZHjUocRxkhFainN_-xHyrkmx7JH_vzdXB7MipvceqnboNlE1C6Bb-wWehVVt2tAg3Dio3Z9nf50MbN-rzS4Vd1kC5m9ESB_VjrPXspdDHUHAVCJlZX85BQQ8qnxUmRQXmuTNqXfW6v6bnuEbXu8WJEtdrYyGMXJrn2jM6BVMaEA0cizCnVrxj78TTYIi9uIIgQ0VUg71EmA5tU1XC0VbiIV0Lm2J_KHWZOmOR6bQta-fII8LrOihcbHAd8Bew_-N0_A84SIrdXqdwj2ZiN3psuDCKskKCuGxcYcYriRvoM1EXC0Abv7I0B9PO7pFU_aYlecs79VdNrNrgwdBfXT-_U5K3lg_U9AwiDn8lT98cOcJ4lLJABvcqBNn6OX7C-zLcGhgtzWwXCV4aACXNcig0Of_TIRwwlgbnKSNSkOGhnvZ5zZ_c9iOA6YVp9NL_bRQPB-NGXmyXs6fekZvgB9iuwhUmm47meRiZHNwRojWYsLqx5IJmb2H_w6mc="
}

Nullet balance


Get all the balances from the nullet


https://api.gudix.net/balance
POST

nullet string

private key


genesis boolean

get genesis value

tokendetails boolean

gives details like token balance or permissions. Default ist false

JSON Body:
{
	"nullet": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
    "genesis": true,
    "tokendetails": false
}
Response:
{
    "nuts": 13,
    "xchf": 0,
    "genesis": 0.13943661972,
    "token": {}
}

Paper balance


A paper is a document outside the network. The document was created with Send nuts to "gudix_paper". Comparable to a bearer share.


https://api.gudix.net/paperbalance
POST

paper string

This is the transaction id from sending nuts to the reciever gudix_paper

JSON Body:
{
    "paper": "a2Ld1KK-FnuuOUk9oIMf7SF3QZsjv3Jo4LOt05xL8FUBePxEC6lV5EbMQek6Dhqd_RtzSTBQuV0gX2AxNeSjaJRRAixPO1vCzKMtIRCi2NwA5R0eDxtvqBrWLjVFGEUOasQuDWchAQmwdSNbFaXs7v5e0Ve-T4wAvC9Eoqy5Izm5hU5Dr9mfeL6v8-t6q9wCinr0HkjgSb9U99d4JdP9kzjzUPpgH2fPru9pwlj6JoduzSO4OCUzop9kzqbqjkqgZZnZ3u8hlvgdgCzoYK2OyVwgL6H8ohL3AZ9iOz1XpY6qdm8-2lE5TmTTjXj2V-RUeCTZw3Au0HwlIqRQqHdBO29l4Ikt20t9VGCRYUeQPFz1Sn4cvGO4fKJ5q9fxBu9nCRDBiUiJFxe1qBmT5FFv8QGZ5TUAfYb3X9Ee3ic3E4j_3f4-0LhbkHv4BQuPQSGSsDXP1veV--QzCP8cRvHDf0EZwsY_NdYmEaTnave1-HnirlSej5kP9yhBPWMW4edgX5nKq8rQB7rYvWBFjJeHzf5lj1oh6sKVTimiAlupm0bp8iH0P9PsoAmR22-sX9qHwYdwBbs8Nerq9VFKxdbx-F6wFnoWccN6dY4ta3vnuXSbLtZoT0Lr4dc57xm8jbFZ2-yFqHmCfr9vxUX443Y4U2uCwRrnDNiFoQB4LaUTWy_xMSQIHX_Y8tm7UohVS14Whe1VBIPBr15NWNnLk0YJvkfpgz2Q7DQY4TRd7u09uKgrmeN1yacgOkiiFe5Bss8="
}
Response:
{
    "balance": 600
}

Create token


To create token, you have to pay at least 1 Nut to encrypt and save your token in the core network.


https://api.gudix.net/createtoken
POST

nullet string

private key


password string


tokenid string

the unique token id also called token name.


nuts integer

to encrypt the token and to write in the core at least 1 Gudix Nut is necessary. The more nuts you put in, the more valuable the token becomes.


quant integer

To split your token you can define a number from 1 to 100'000'000'000 (100 Billions).

JSON Body:
{
    "nullet": "4KFkQQaPGMpf9SdDn17H6WSPuIRQe4aUzGxPdUDMnjKPnkM-hVC-mhsj0Vo7OC-0MNpEugOSeBpaTfFIfFq97TqBSj_ozxEJCslR_ti_3tPZL2uVstdBZKTPOCHA-u3P9SmBfliOM2kc6345Sc8wdncpmo5abocQk-RgMZwETEhR5Qqubadx_8NhPNtXwI__IRyDnkQh",
	"password": "NicePw",
    "nuts": 10,
    "tokenid": "genix",
    "quant": 100000
}
Response:
{
    "transaction": "Qh1U8XGWG71DGg0A5g9DCG5UQ_bJg3I9XjgTVnXiQTTb_IujSRkRvA5QFOaX2Jr3ihwS4erMMpWrsf_LBwtagYNuM3f64GuFtP9Txr1qyD6NPPBq1V8U95OBc217PhEY_A5Tt7qZrEEvAyFjPyysmRrWcHYOthhAa_e5bT9tIKTMnzIgUsYEuYYoZOB7jTx0nsj0-v7lvb-hzak7byj9LSRs6zzuRbl3xpgVzn2bz3wwuWkSfICtcA4BrtxC1etLoPdjgjlKNGWwCxAc22jRi9BG5I1dNQfapile97dBZPK2nGtCLnTqV5bqWeF3zn940NurzCriX7xo8aFT1EeN2nB3Gn4e16L1R8eNfeQbAciLOKE5aX_yg4yduaTOw4dczUZ3bW-L3xRJ2QHzq8ldJ8bjz8AZsqjpaE1C3MipqODWtOBZuSecfL3yiHFaphyFclCCXmvzZ3Qov75wni4_zRswtmovitKULobK9w27SlO3SzfCbxLo8SXGALDZ7rq1zj6bz9mMW1gKjYuZ9mmOm-VzjPK2VtQ="
}

Top up token


Make a token more valuable. We know the value of Gudix Nuts. When you put more Gudix Nuts to your token, it becomes more valuable. Also you can put in XCHF, the digital Swiss Franc. XCHF is the value of our Gudix Nuts and is the same as a token, just with fixed value. 1 XCHF = 1 CHF

With every Nut you put in, you can add an one extra field to encrypt with the token. You can add as many fields you wish, every info field is accassible by public. The exchange will read the extra fields and link fore example the tokenwebsite or token whitepaper. You can just add fields, but you can't change the values after encryption.

IMPORTANT INFO
to add some extra fields you must own more the 50% of the token.


https://api.gudix.net/blowtoken
POST

nullet string

private key


password string


tokenid string

the unique token id also called token name.


nuts integer

The more nuts you put in, the more valuable the token becomes.


xchf integer

this is integer, but have attention to the quantification. 1 Swiss Franc (CHF) is for the API 1 * 100 * 1'000'000. So if you want to send 1 Swiss Franc you have to send 100000000 XCHF


datakey string

if you want to add extra data to your token, use "datakey" to define it. You can use whitepaper or url to make your these links visible in the exchange.


datavalue string

the field value for what you defined the datakey

JSON Body:
{
    "nullet": "4KFkQQaPGMpf9SdDn17H6WSPuIRQe4aUzGxPdUDMnjKPnkM-hVC-mhsj0Vo7OC-0MNpEugOSeBpaTfFIfFq97TqBSj_ozxEJCslR_ti_3tPZL2uVstdBZKTPOCHA-u3P9SmBfliOM2kc6345Sc8wdncpmo5abocQk-RgMZwETEhR5Qqubadx_8NhPNtXwI__IRyDnkQh",
	"password": "NicePw",
    "nuts": 10,
    "tokenid": "genix",
    "datakey": "IoT_Reference",
    "datavalue": "the_thing_is_1234565355"
}
Response:
{
    "transaction": "vNxSkJdIU6W5zKaILcpQ2hHLrZseSBqyqLZHjUocRxkhFainN_-xHyrkmx7JH_vzdXB7MipvceqnboNlE1C6Bb-wWehVVt2tAg3Dio3Z9nf50MbN-rzS4Vd1kC5m9ESB_VjrPXspdDHUHAVCJlZX85BQQ8qnxUmRQXmuTNqXfW6v6bnuEbXu8WJEtdrYyGMXJrn2jM6BVMaEA0cizCnVrxj78TTYIi9uIIgQ0VUg71EmA5tU1XC0VbiIV0Lm2J_KHWZOmOR6bQta-fII8LrOihcbHAd8Bew_-N0_A84SIrdXqdwj2ZiN3psuDCKskKCuGxcYcYriRvoM1EXC0Abv7I0B9PO7pFU_aYlecs79VdNrNrgwdBfXT-_U5K3lg_U9AwiDn8lT98cOcJ4lLJABvcqBNn6OX7C-zLcGhgtzWwXCV4aACXNcig0Of_TIRwwlgbnKSNSkOGhnvZ5zZ_c9iOA6YVp9NL_bRQPB-NGXmyXs6fekZvgB9iuwhUmm47meRiZHNwRojWYsLqx5IJmb2H_w6mc="
}

Send token


To send token, you need a recipient's reciever address.


https://api.gudix.net/sendtoken
POST

sender string

private key


password string


tokenid string

the unique token id also called token name.


quant integer

is required, also for paying invoice to check the correct amount.


message string

reciever of nuts can read this message

JSON Body:
{
    "sender": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
    "password": "asdfasdf",
    "reciever": "",
    "tokenid": "MyTesttoken-1dds",
    "quant": 300,
    "message": "the one and only token"
}
Response:
{
    "transaction": "vNxSkJdIU6W5zKaILcpQ2hHLrZseSBqyqLZHjUocRxkhFainN_-xHyrkmx7JH_vzdXB7MipvceqnboNlE1C6Bb-wWehVVt2tAg3Dio3Z9nf50MbN-rzS4Vd1kC5m9ESB_VjrPXspdDHUHAVCJlZX85BQQ8qnxUmRQXmuTNqXfW6v6bnuEbXu8WJEtdrYyGMXJrn2jM6BVMaEA0cizCnVrxj78TTYIi9uIIgQ0VUg71EmA5tU1XC0VbiIV0Lm2J_KHWZOmOR6bQta-fII8LrOihcbHAd8Bew_-N0_A84SIrdXqdwj2ZiN3psuDCKskKCuGxcYcYriRvoM1EXC0Abv7I0B9PO7pFU_aYlecs79VdNrNrgwdBfXT-_U5K3lg_U9AwiDn8lT98cOcJ4lLJABvcqBNn6OX7C-zLcGhgtzWwXCV4aACXNcig0Of_TIRwwlgbnKSNSkOGhnvZ5zZ_c9iOA6YVp9NL_bRQPB-NGXmyXs6fekZvgB9iuwhUmm47meRiZHNwRojWYsLqx5IJmb2H_w6mc="
}

Token data


Get all details from token


https://api.gudix.net/token/:tokenid
GET

:tokenid string

Token ID

Example GET Request with Parameters:
GET https://api.gudix.net/token/testtoken95
Response:
{
    "sender": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
    "password": "asdfasdf",
    "reciever": "oWI4lWkd7Dt2JBWf1qQtFqWLvJTwaUwXr2vYCsjCiTy0wBVgNGOOaxutwBfiGFdcf5i9TVtdIQky4z_9aGp6KyGXEBJf0AqqMyzK5qf46RfX8cEeoaVtFq3BcCRX1UNBqJdTUp5Kx-07ZyWU1l7ozCnGA15nUL4mfyFWTM0ptMvnV_Unjqfw2iffGTCh8bOnZnA010DrvT4bt7fDcZw16Cp1fysPkuVWTqRHnedON25-_KOg2k_rrVR-SsdBDgOJ7tP_VV5JBbD8Op5ZUWp4hpMGhAw=",
    "tokenid": "MyTesttoken-1dds",
    "quant": 300,
    "message": "the one and only token",
    "custom19": "something I want to encrypt with my token"
}

Market data / Exchange


get all ask and bid prices directly from exchange


https://api.gudix.net/market/:tokenid
https://api.gudix.net/exchange/:tokenid
GET

:tokenid string

Token ID

Example GET Request with Parameters:
GET https://api.gudix.net/market/BetaGamma
Response:
[
    {
        "sellbuy": "sell",
        "quant": 110,
        "price": 100
    },
    {
        "sellbuy": "sell",
        "quant": 1,
        "price": 100
    },
    {
        "sellbuy": "sell",
        "quant": 1,
        "price": 101
    }
]

Genesis informations


Get a list of all token you sended to genesis and the parameters for calculating daily Gudix Nuts what is earned (harvest). It just can generate full integer nuts and no decimals. If genesis is less than 1, there are no nuts to harvest.


https://api.gudix.net/genesis
POST

Nullet string

private key

JSON Body:
{
    "nullet": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
}
Response:
{
    "xchf": 106558194,
    "nutspriceaverage": 100,
    "nuts": 106.58194,
    "performance": 80.45124,
    "genesis": 21.3108896,
    "harvest": 21,
    "dailyprofitpercent": 0.42701173692120037
}

Create token permission
(object permission)


A Token is always also called Object. If you want to send a Token, but the reciever can't get in the same moment. You create a token permission.


https://api.gudix.net/creditObjectPermission
POST

nullet string

private key


password string

validates nullet


quant integer

quantity of token units


tokenid string

unique token ID

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "quant": 1,
    "tokenid": "Yobuco"
}
Response:
{
    "tokenid": "Yobuco",
    "quant": 1,
    "permission": "799197ad260ee6caf2ec6d4fa311971a3f1655658c4643e3319408cbfff01730"
}

Get token from permission hash


With the Permission created above, the reciever gets the token, when he is ready.


https://api.gudix.net/creditObject
POST

nullet string

private key


password string

validates nullet


permission string

permission hash

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "permission": "799197ad260ee6caf2ec6d4fa311971a3f1655658c4643e3319408cbfff01730"
}
Response:
{
    "credit": "610e4c15ae4143638c3342a2"
}

Credit permission


With the credit permission you give someone the right to withdraw money direct from your wallet. This creates a hash for a specific reciever.


https://api.gudix.net/creditPermission
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


permission string

permission hash

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 200
}
Response:
{
    "currency": "chf",
    "amount": 200,
    "chf": 200,
    "permission": "accd5a56b6e18a851b856533aaff7d353a9551122fad2098ba462568d76be4be"
}

Credit money from fiat permission hash


If you are the reciever of the hash defined above, you can recieve the money directly from wallet of hash creator.


https://api.gudix.net/credit
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


permission string

permission hash

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 200,
    "permission": "accd5a56b6e18a851b856533aaff7d353a9551122fad2098ba462568d76be4be"
}
Response:
{
    "credit": "610e4c15a46254733342a2"
}

Check permission hash


Check, if the Object Permission or credit permission hash is valid.


https://api.gudix.net/token/:tokenid
GET

:permission string

permission hash

Example GET Request with Parameters:
GET https://api.gudix.net/checkCreditPermission/accd5a56b6e18a851b856533aaff7d353a9551122fad2098ba462568d76be4be
Response:
{
    "permission": "accd5a56b6e18a851b856533aaff7d353a9551122fad2098ba462568d76be4be",
    "valid": true
}

Send money in fiat


If you wallet holds tokenized value, it is shows as EUR, USD or CHF. You can send it to reciever directly by using core network. You can send EUR, USD or CHF, the network exchange it in background to tokenized value in CHF by itself.


https://api.gudix.net/sendFiat
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


reciever string

public key from reciever

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "currency": "EUR",
    "reciever": "lmTaIkElA2ALQ2X6QuWQYMpcvgWX46zVbtXjKWuedniYF66kCnFgyNRz7v7H9SXXzqV1iLo3g47z4-FcPObC8BNBj1T1FIYruQb4S8Ur0Abj9hvOAPbPJ8dkDc795bEJJnAsspb-iMwhHvEsrNEx52AT_xCWwbPpmki70bBK6hR1E2grO9WdobY4Y_UqsqFKr_8CUZJWlz7AXGP_00z832ioDXBhTY3d59MwimkziHt16MiykFZETmzwNS6LCi9i3IiI-xQDLbIr2AoWWcehkVy6F1U="
}
Response:
{
    "currency": "EUR",
    "amount": 100,
    "chf": 107,
    "transaction": "610e510910614a2b55336fa5"
}

Send fiat to handler


A Handler makes something with value he gets. For example he can distribute to all token holders.


https://api.gudix.net/sendFiat2Handler
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


tokenid string

unique token id


handler string

balance
top up the token balance

owner
token owner (51% ownership or more) gets full amount

holder
amount is proportionally distributed to the holders

permission
amount will be creditet to your account and the token gets the permission to deduct the amount

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "currency": "EUR",
    "reciever": "lmTaIkElA2ALQ2X6QuWQYMpcvgWX46zVbtXjKWuedniYF66kCnFgyNRz7v7H9SXXzqV1iLo3g47z4-FcPObC8BNBj1T1FIYruQb4S8Ur0Abj9hvOAPbPJ8dkDc795bEJJnAsspb-iMwhHvEsrNEx52AT_xCWwbPpmki70bBK6hR1E2grO9WdobY4Y_UqsqFKr_8CUZJWlz7AXGP_00z832ioDXBhTY3d59MwimkziHt16MiykFZETmzwNS6LCi9i3IiI-xQDLbIr2AoWWcehkVy6F1U=",
    "tokenid": "Yobuco",
    "handler": "balance"
}
Response:
{
    "currency": "EUR",
    "amount": 100,
    "chf": 107,
    "transaction": {
        "$oid": "610e51c4df4f5c707320a775"
    }
}

buy token units


if someone creates a token and he wants to sell it outside the exchange, he can use the P2P Payment Module to configure a transaction. On the p2p transaction page the buyer can buy token from seller. With this api call you can buy token with http request outside the p2p payment module. If you want to use this function from API call, it's just possible if the Nullet is linked to Telegram Account. This means you have to login once with telegram login, after this, the function is enabled.


https://api.gudix.net/buyToken
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


tokenid string

unique token id


handler string

Must be buyToken because if you send money here, the token will be bought directly in exchange

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "tokenid": "Yobuco",
    "handler": "buyToken"
}
Response:
{
    "result": true
}

Create fiat withdrawal permission for token owner


The Token Owner is the Nullet who holds more or equals 51% of all token units. With this api call you grant permission to withdraw money from your wallet if you hold the token. The owner of token (owner ≠ holder) can withdraw money from your wallet.


https://api.gudix.net/tokenFiatPermission
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "tokenid": "Yobuco"
}
Response:
{
    "result": true,
    "permission": "HsKBQjIDZORTPXbmIwDgpNTcCDyAU9D3wYdOiPjcfjH8TqUJXhQKEisINbuf1myHGHxz-mTpV7Lutwvci34CuD0LROHIH8ptjTQ9egY1Xex8rMFly-rQP48nSWePdWKj4TBmDAo1FXqF_nNavfthj1Ul2DFbK72qyKej7q0vZclswpjTFPY067IgTpENTHzK"
}

transaction


This is only for checking the transaction validity. It can be used for getting informations about transactions. It's useful to create a receipt.


https://api.gudix.net/transaction/:transaction
GET POST

:transaction string

transaction id

Example GET Request with Parameters:
GET https://api.gudix.net/transaction/py5OE-qF7ukwJ3N61Y-Tq2kGP8Nz5I4B3l6PckC2BWQsCErpUFH3wSU3SPekxZ300f0It3bXbgVklx-C78u0pGtWSEEPeEe4SvY=
Response:
{
    "id": "610d256d84bc922b510a6b74",
    "timestamp": "1628251501273",
    "amount": 30,
    "currency": "chf",
    "customdata": {
        "tokenpermission": {
            "$oid": "61027e95f8eee32d06847a4c"
        }
    },
    "receipt": {
        "api": "https://api.gudix.net/transaction/py5OE-qF7ukwJ3N61Y-Tq2kGP8Nz5I4B3l6PckC2BWQsCErpUFH3wSU3SPekxZ300f0It3bXbgVklx-C78u0pGtWSEEPeEe4SvY=",
        "frontend": "https://gudix.net/receipt?id=py5OE-qF7ukwJ3N61Y-Tq2kGP8Nz5I4B3l6PckC2BWQsCErpUFH3wSU3SPekxZ300f0It3bXbgVklx-C78u0pGtWSEEPeEe4SvY=",
        "qr": "https://chart.apis.google.com/chart?chs=500x500&cht=qr&chld=M&chl=https://gudix.net/receipt?id=py5OE-qF7ukwJ3N61Y-Tq2kGP8Nz5I4B3l6PckC2BWQsCErpUFH3wSU3SPekxZ300f0It3bXbgVklx-C78u0pGtWSEEPeEe4SvY="
    },
    "status": "live"
}

Finalize transaction


Think about this situation: You are a seller of a product or a service. You recieve money from your customer. The customer gets the receipt from transaction call above. Now you recieved the transaction. From financial perspective it is finalized, but you have the deliver your service or your product now. With finalizing this transaction you finalize the contract. You confirm the delivery of the product or the service.


https://api.gudix.net/finalizeTransaction/:transaction
POST

:transaction string

transaction id - The Url containing the transaction id to where you send the nullet


Nullet string

private key

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls"
}
Response:
{
    "result": true
}

Top up token balance


Since a token is not only a token, it is contract or a value store you can store value into the token. This is called token balance. But takte attention of token holder and owner. If you are the only holder and only owner of the token, there is nothing to look out for. But if you're just a holder of a token from another owner, it is possible the owner gets access to the token balance too. This is for banking business models. The Bank opens an account for you, in this case its not caled an account, it's a token. You can top up your token and send it trough the bank. In this case the bank has access to your token balance because the bank manages your funds.


https://api.gudix.net/topupTokenBalance
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "tokenid": "Yobuco"
}
Response:
{
    "result": true,
    "credit": "--rjhZm9U6Cl0o88F8K-xC2iZ424oaT801wv4lDfDkXIUKz9x_nlolZf-qKGiZvhsUwGAjs31-u-FdXflv13HkgZLXNzDlnv9-aMoqvOT5D-mvykcNIz-KXGjnbaOcBnBRL-yIP_1Cwwb_Kue_BDf3LhoYYBz5faXMRJMik_ylBCdI0AsFotSLxrPvQ="
}

Top up token balance from owner


If you're not the only holder of your token and there is another owner of token, both of you can top up the token balance and both of you can withdraw token balance.


https://api.gudix.net/topupTokenBalanceFromOwner
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 100,
    "tokenid": "Yobuco"
}
Response:
{
    "result": true,
    "credit": "--rjhZm9U6Cl0o88F8K-xC2iZ424oaT801wv4lDfDkXIUKz9x_nlolZf-qKGiZvhsUwGAjs31-u-FdXflv13HkgZLXNzDlnv9-aMoqvOT5D-mvykcNIz-KXGjnbaOcBnBRL-yIP_1Cwwb_Kue_BDf3LhoYYBz5faXMRJMik_ylBCdI0AsFotSLxrPvQ="
}

get token balance


Finally this is the api call to withdraw token balance. It moves funds from token balance into your wallet.


https://api.gudix.net/getTokenBalance
POST

nullet string

private key


password string

validates nullet


amount integer

amount in decimal


currency string

is optional. Default is CHF = Swiss Francs. It can be USD, EUR and CHF


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 10,
    "tokenid": "Yobuco"
}
Response:
{
    "result": true,
    "credit": "rI5xsG3BamJFHwwWOWVkppXCPqC28GBnAxKXLEUDmTT7fqbaFuY4Y9v5xYMjF7O-iLuRJr377P6WzdKASHBmEg_u7xUA0fWOcKk3DEs4yTrQRAPHTVrxi55gTjNqE-rT6V1DRENXS7wKWWALjToGp2fr8JtSYsG2rFufQzSX6l3UmJle5ptoBqapbU8="
}

Token configuration


This is one of the most powerful module of gudixnet, it belongs to the core functions. Configure a token means to create a pre created NFT contract. A token as a NFT contract that integrates tokens in nearly every business model. Gudix NFT contracts are created for your individual needs from Gudix. After createion the contract usable from other users. Please check our use cases. All use cases are based on NFT contracts. Best way to configure a token is to generate first, then go to https://gudix.net/smart/contract/genix to configure (genix )


https://api.gudix.net/tokenconf
POST

nullet string

private key


password string

validates nullet


conf object

sends all the parameters to configure the token

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": true,
    "tokenid": "Yobuco",
    "conf": {
        "holderlist": true,
        "balancelist": true
    }
}
Response:
{
    "result": true,
}

Custom token configuration


You can change some parameters just in your scope. For example you can hide the token in the Dashboard. we are continuously adding to the parameters. Please contact us if you need some configuration possibilities


https://api.gudix.net/customTokenConf
POST

nullet string

private key


password string

validates nullet


key string

the key you want to change


value string

the value to define

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "tokenid": "Yobuco",
    "key": "hide",
    "value": true
}
Response:
{
    "result": true,
}

Token liquidation


If you don't need the token anymore in your wallet, you can liquidate it. All NFT contract conditions will be deleted imediately. If if there is intrinsic value on the token units, the value will be stored in your wallet in the intrinsic field. You can then put the value into another token. If there is balance on your token, the balance ramains untouched when there are another units left in your wallet. If it was the last token unit you liquidate, then the balance goes back to your wallet.


https://api.gudix.net/liquidate
POST

nullet string

private key


password string

validates nullet


quant integer

token units


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "tokenid": "Yobuco",
    "quant": 1
}
Response:
{
    "result": true
}

Release funds


Think about this situation. You offers a crowdfunding and with tokenconf payout conditions you can define when you can release the funds. There is a amount and a timestamp condition. With no conditions, you can release funds anytime. You as the owner sees the sum of all balances on the token. With this token call you can release the funds and move it to your wallet in one step.


https://api.gudix.net/releaseFunds
POST

nullet string

private key


password string

validates nullet


tokenid string

unique token id

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "tokenid": "Yobuco"
}
Response:
{
    "result": true
}

Selling funds


Because of decentralisation there is no third party what can send your funds to your bank account. Gudix is not a bank. Because of this you can only sell your tokenized value bilateral. The funds in your wallet is tokenized value. if you find a buyer for your tokenized value, he gets an invoice from you. He will pay the invoice or pay out out directly. Every token can be configured as NFT with payout function. Payout function means you can sell tokenized value to the token owner. If you don't have a token with payout function, there is a default contract between seller and the company gudix. Check the default payout contract here:


https://api.gudix.net/sellingFunds
POST

nullet string

private key


password string

validates nullet


amount integer

amount in Swiss Francs

JSON Body:
{
	"nullet": "rILR3gC9l8YAhDriszHdNoD0dPvOXK9JSVC2VvIlmBZmphb8QoF_dqnwYd1grcX8sDuv3tCWWXxp9gPO7rnEV07nGIXHFlBHc33NsZsTeUtEDs1HSvxBn0J8NWtielhdoMfJGf5QFsNSkwInpuI1JApkw5ie5sT45m011Af5RW6Bfh4FJ9kNND0gsPfbNuP55iEh_yls",
    "password": "asdf",
    "amount": 5000
}
Response:
{
    "result": true
}