Introduction

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

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 deliver 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 HTTP 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 Telegram Bot Interface to access to the Gudix® Net for free.

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 the public. Only creator can see the nullet id, not even we save your nullet id. Only those who have the nullet id and password can have your nuts. We recommend that you print out the nullet id for restore purpuse. We also see an advantage in having the nullet id 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 reciever address


Any number of receiver addresses can be generated with just one nullet. A receiver can contain a webhook, which receives a POST request from each time it recieves some nuts. We recommend testing the webhook function at webhook.site.


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

nullet string

Nullet ID


webhook string

we send POST Request to this URL when recieving nuts.


appservice boolean

to activate appservice on this nullet, set this true


appfee integer

an app recieve an appfee when transmitting nuts from sender to reciever.

JSON Body:
{
	"nullet": "p48OxschQ6icQzqEkk64B08F23HTxdNl4VV6zxWsTAZ3eUcTzdQaxoZ1CupKk8P7OaZlThC5QL3hVGSYAEhn1UJwb7IwTgYABWeyRSzErDd5pHmtyOmnzPRUf--0hpM1fuVhzhL6NZqmYottoHaSlcf_3oPBQjg91izV-j6reRHq4bsGNj3DbGw3PZkJcRlgG_rn_wpR",
	"webhook": "https://webhook.site/b945870a-4419-4649-a4f0-4332027869bc",
	"appservice": true,
	"appfee": 20
}
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

Nullet ID


password string


nuts integer

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


guarantee integer

To pay only guarantee of an invoice what equals to product send confirmation it required to send guarantee and no nuts. If you pay guarantee, you have to send invoice as well.


guaranteereciever integer

Just required if sending guarantee. Define a webhook to get informed when getting back the guarantee.


invoice string

pay invoice without any further parameter needed. Just send the invoice code. The invoice code you get with the invoice function.


creditnotereciever string

if paying appinvoice optional define a reciever with webhook to get informed in case of cancelling invoice and get information about getting back the nuts. If no moneybackreciever we send back the nuts to your nullet


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="
}

Invoice


To predefine some data for sending nuts it's possible to create an invoice. The Invoice contains all the necessary data to send nuts the fast way.

Also you can use a third party to create invoices and earn appfee. Some examples: If you have a plattform and your users use your plattform to sell products so you can now provide a secure and anonym payment service. The buyer buys the product the seller sells. You create an invoice with reciever address from the seller, also you define an additional appfee, what is your return in the end. After creating an invoice the product buyer can easy pay the nuts. You and the product buyer gets an invoice id, what can be used at the end to release the nuts. After you make sure the product seller distributed the product or the product buyer gets the product you can release the invoice and the nuts. You get the appfee and the product seller gets the nuts

another example: You're a broker or an intermediary and you want to sell nuts from a nut seller to a nut buyer. The same way you can create an invoice with nut reciever and some appfees. When the Nut buyer buys the nuts he sends you the money and you can release the invoice because the nut buyer did pay the nuts. Now it's your turn to send the money from the nut buyer to the nut seller.


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

reciever string

First you need a reciever address. You can define a webhook with for example an invoice number. If someone pays the invoice we send a POST request to webhook and you get the invoice number back.


nuts integer

nuts definition is optional. If nuts are not defined, the sender can define how many nuts he will pay.


guarantee integer

It's possible to define a guarantee. If a guarantee is defined, plattform has to pay the guarantee first. After the invoice payer pays a total amount of nuts + appfee + guarantee in one payment. In this state it's possible to release and to cancel an invoice in case of product sender do not send product. The nut reciever of nuts (product sender) can now bring his part (send product) and parallel he also have to pay with the same invoice code the amount of guarantee nuts to give a guarantee he sended the product (use guarantee parameter and use sendnuts function). After this it's not possible for app and for nut sender to cancel the invoice, just release. After release every guarantee payer gets back the guarantee.


message string


nullet string

just required when creating an invoice as a third party


password string

just required when creating an invoice as a third party


appfeereciever string

The appfee reciever you get when creating a new reciever with reciever. When creating an appfeereciever you can define the hight of the appfee and you can define a webhook to get informed when someone pays the invoice. Keep it in mind: You can pass GET-Paramters with every webhook.


customid string

as an option you can define your own invoice id


todo string

you have to send todo parameter appinvoice if you want to use appservice. If you do not send this parameter it's defined as simple invoice as default.

JSON Body for simple invoice WITHOUT appservice:
{
    "reciever": "spQapZoam6ARcHcc8fouBvj2tP5l412oLANEcdiOXml_Qe3kATChS-kjsZYQ51qfXo_m9YEvXUQcEM1P1vrV0GJtbph2g1A-6DDdGvsH4-S80wbstIQUytnGpFDfUVqpzzH8iMDO54QDXFcqjXjbGYL7XM_Ldh5X_dKoGVFtBmoE5DG_z-Ku_q_YK7_GjCD66IcStlUYO6YDkK0Mj4vgwGzpiYwAsbF8a16INjcsG8h6iYvTMB2V3NZxmrz6971VWuJrEnl9nkqTdU4Fx0mc4ufukNzIzSa4CrpNiiOji-q4pwgSCI6pG4it8NM=",
    "nuts": 10,
    "message": "something to write"
}
Response:
{
    "invoice": "AmMSspyerF6L4_vYYV7SbGig_3Gd203csXrFtFKRpFDY5VaagiSsDglfZt8sJV7uRILgve6xuGhF_JiQjwznW62Q0dCVRkK4hScnIoUMOfdpiKsT63yTcqq6os45C0PyJ0wpmdFTLBmuUNG1o3Cv_YdsZJnCF0n8kkPqFzxwT7fj7Qnc4T_3MXma8JsX29tlriF5V7_sg0-RCEH_JX7VW7f3rYSzQer7pFnHW1993CnwxzpXWiZpb6ABVDPMG-eOClk1j4ypI62P8R9ZqXOMHU1X8hsPCL5Hq7mw_j9p9GVfCm7-BHerxaClv-QwdJwrmrUw3n8bWqaR_bm1jWvl92fAM54E1kt69WMSThpXFZBunAKIQJg-f7V1uksOzJ-7ijYahrKoKXLxSL2whFYAXL12NNS8lbyb"
}
JSON Body for third party invoice WITH appservice:
{
	"nullet": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg",
    "password": "asdfasdf",
	"todo": "appinvoice",
    "reciever": "9ZS7UFZjlE9jdR8uBZCgJ8ttusSfvHQDmfz7jdOjbGkxwDzrUBo5oWg_zymqdd7bwjDlloGeYkOvxYAqaFvrNKNSv5XE8WyxfGYCtQehn5IeRm8acXMtpgKTdh7926LEEBBuMKHlyfLsAtOWoreuJhCCKw5yPN2Co-4ZyN-Xr4VwtTiKy_FxHkx4JlKCuG1nPucV6ueJGqxf0Unc1OM6t16IJitgmYW8-VKz9JSN11nmFJFRC0iDwc014jfetbtkh8a3zgQCsv7WFzOLE7NyCoLQ4X6SEi2H55S_PUBZoEYYTOfB-lzw-KaemwxszlAXwwj4AnpTjHuMdWfsoMFea14SwZVKG-3OeQLG2Oiq9PliSPXyyIvynDY5_b2p3ImNRAiw",
    "nuts": 10,
    "appfeereciever": "Sx-QgbgH5uE6_R-Ylg2x1dQ3rZsb2v8H8BivVXwpbB4jqaqQb2SYPVS7ua1GiyA26drdErobl_kb5bIn3y405LtklmxEQwo0Ach0zbVkfEQyF_k5qkS3igbx99NN_XTK7jRFk3yka-jub0pLrhdzvFJ5hqyN38ZT55Hap-UEqst1_sypRpwxNZJichKWJEZt8AFx5ClFT23_iZPuLqvNsad-CtQKdGElCbZw4i_Pq4qguBhlbZQL9hsdcRXULoQpk7c=",
    "message": "some optional text",
    "customid": "custom_identification_id"
}
Response:
{
    "invoice": "-bmq4nMNZUmlHn79jIEdQ6c00gVxCvCfIFAwv2EsjnAfx-vbZiod4ZyHwMOc81kPZ13UbRPBaEo0syyBWsb-Uyor5HPGz6H_5BtGwFRDQSNekvVrcTCcOoNfJ7m9XTdunReHst7igRYh3PhZLUIxkhznJABqmuxOC-qy_lfO5HPdJnmxBY16K4DbxbcPHZ0t25mXaCuC6T90aSAmJUZFzQh2WiiZOBVBvApGbPppObRjY5aJaeF-JIeZSTq7h_BKlcy6bQOVI6syqgTIjoEfYc1yLeec9aqL29P_mpDJSYWsiN5l_3SGPgdBTH32ZBNFqhLieZxHU6tYzMSQSI7jb72SCMTdsks_aED7VeYCLiNPJNc-Vdm7v11Oo2p_cnrnoCo77b2QRdhlmRSlD_Ces_0-uylzVf5oPDPPhs61VRj8NmvOwBgFC0LfatPFZiP07zaH-sZsada-cz4p059nucRSaJ3HmaHFAMQhVKeiXkJ2pZJRKxfAAcY7R4TxvbKxeYBnv2skY0yt8DnhbunWGvLjeTI_V6LhnnmPUMMNj8NFBDImpuYJFW5zQFcVmDBhYvaTexs=",
    "nuts": 100,
    "appfee": 2,
    "guarantee": 10,
    "invoiceid": "5ecca3509045891d072f1eb3"
}

Nullet balance


The nut balance is accessible with the nullet id.


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

nullet string

Nullet ID

JSON Body:
{
	"nullet": "bgNPuIUVHuOEZF6OyrLlr2b6Hjtxh5KRqc3Rc7fhMUGFIcnnewVr1TS4PQZisy_7krm4061auEtkptVcfVGTd9ogh8902AsgLQfaaciEGqzUGbsC0lznJQL09at9OOkEcqji9M1PUbGHcjFVtGZqpPfPMeDEOJDf1bQFdrTLRoxpNFhlZxZ96u0I7lxufoy0sHCMaqtg"
}
Response:
{
    "balance": "79150"
}

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"
}

Convert paper to nuts


You can bring nuts on paper documents back into the digital world. (DEPRECATED)


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

paper string

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


paperpw string

Just if paper is protected with separat password


reciever string


nuts integer

JSON Body:
{
	"paper": "a2Ld1KK-FnuuOUk9oIMf7SF3QZsjv3Jo4LOt05xL8FUBePxEC6lV5EbMQek6Dhqd_RtzSTBQuV0gX2AxNeSjaJRRAixPO1vCzKMtIRCi2NwA5R0eDxtvqBrWLjVFGEUOasQuDWchAQmwdSNbFaXs7v5e0Ve-T4wAvC9Eoqy5Izm5hU5Dr9mfeL6v8-t6q9wCinr0HkjgSb9U99d4JdP9kzjzUPpgH2fPru9pwlj6JoduzSO4OCUzop9kzqbqjkqgZZnZ3u8hlvgdgCzoYK2OyVwgL6H8ohL3AZ9iOz1XpY6qdm8-2lE5TmTTjXj2V-RUeCTZw3Au0HwlIqRQqHdBO29l4Ikt20t9VGCRYUeQPFz1Sn4cvGO4fKJ5q9fxBu9nCRDBiUiJFxe1qBmT5FFv8QGZ5TUAfYb3X9Ee3ic3E4j_3f4-0LhbkHv4BQuPQSGSsDXP1veV--QzCP8cRvHDf0EZwsY_NdYmEaTnave1-HnirlSej5kP9yhBPWMW4edgX5nKq8rQB7rYvWBFjJeHzf5lj1oh6sKVTimiAlupm0bp8iH0P9PsoAmR22-sX9qHwYdwBbs8Nerq9VFKxdbx-F6wFnoWccN6dY4ta3vnuXSbLtZoT0Lr4dc57xm8jbFZ2-yFqHmCfr9vxUX443Y4U2uCwRrnDNiFoQB4LaUTWy_xMSQIHX_Y8tm7UohVS14Whe1VBIPBr15NWNnLk0YJvkfpgz2Q7DQY4TRd7u09uKgrmeN1yacgOkiiFe5Bss8=",
	"reciever": "3RTRrN7yKPnE_2s4GxjsDLQgQvLX6WkVBCv7c_HoNiUfgw8W9zH-YdZM7XUWAq99xEMr9SMj6RdHITZtFGqlR72M1uaXCEkWFvrCTk7XRzEjYShA7by2-ZZkxO9A2q1YWQ_ncAF7aX7UZHCbaryXEyiWynvHX_wC6RHjZCDh_es7SWDTIJt2rkzu89EQm4r2JfZFwbsc3ueB4oEtAGmyfkQFTQXzfnLlTLl0hA-hOI4VNr3bSFtOF-0wYhjnSRGE_J-PphMJ9KsPdR9SrmaOz6LKNCkpBnIjNs9jgC--BYXJQpaR_bT7YheDn_9jX9yyU8tFGOxUpxW4JXku38CLQv3uIvE8U2NXlqGSbQwBAazTeoYDaOlb3ThzTlYhxG0U0dmKnp0=",
	"nuts": 20
}
Response:
{
    "transaction": "RisvhyeM7qmZ4o-VKmHoWMgWHcLrwitFRASBxfpt5A-0mHP_Y6z_D5sCqBrwYAOzOTrr5RfgVjGmqe8BIc-SbeRZE9aTQLkIDFW48rDvfeM2sSCLy1Qt2g3xpGBlprXpxvBJmI0ewfZc1mOdQ_zCXgfOIcKAcXpxgcQWyvnjmhMHEvww2wfQ_cVZ19BfPz8KimeRrzmZKyMDOwNu1KFdYbuDW-pv1aWsj4F8IQfDFG1x6q7IvZ-G7H5kchyqZcEisM5PoAoXx0RoMw3Qw9xKnAWTeU2umrEEJc8yUyfSa46ldIugUeo0kDNO7kmluju9zhqFCgJOOTu5gKH5x1zTIQQe1HhPqrJLVZuBd6SYzM7FZYJYwcR_6-Ympcqxm8W2h4JgbAI-rnBPPdfSyxvKN0r5xzb7p2mGb4ZrIKcFbVniKZ4Aqgaoq5VuciPba-FcEVYIMp8N43U9-eRV_C0OoPytA0HbVFpqYj8VybcYh8RZZ0fcAUGwOGLpIhjpTnd52vyAI_s2p0nHGdjFiDn8JA=="
}

Release contract or appservice invoice


The nut seller or authorized appservice can release contracts after completing a contract with seller and buyer. The seller releases the contract after recieving the return. In case of release the guarantee nuts get back to owners and if set the appfee will bi transacted to the appservice nullet.


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

nullet string

nullet of app in case of releasing a transaction controled by an app or nullet from the seller in case of realeasing a contract.


password string


contract string

if realeasing a contract after seller recieving the payment from buyer.


invoiceid string

Instead of contract id you can send invoice id to release nuts from gudix appservice nullet.

JSON Body Example releasing a App Transaction:
{
	"nullet": "56ClrhWo61EOpIP6J3mIGuvhUV0xS0LaMvXc_1payxVF7VI929ax9-cvi0an6EBK2Sb6cmIWGPIfkZGQpJOzOivpmw2X7VVm_IR1qMAGFl5AZap-DpaLk-rDH6hvhTu21959gmM8PMwfJiv9Vpegm_lgzcLviBMsWSvTJ2yE5ZBkJPo5P0gAaoYiyswRnCSv-rb8v_Nj",
	"password": "asdfasdf",
	"contract": "clVr7B0OBMRgrlRX8ssIeoopZ7"
}
Response:
{
    "transaction": "r6FKn8GCgs3bUahxTgqdmXgbGYzxnRNXwUfcu8UsGArswXTXnRJlpSJ4LwTVpfOUgU5_Hmc54xVs2BXh38884mp2CDJjqh5FF1Y-bLQMranpNUxeh1B5C63-hp-mkOK4Eiww8sciB0LrqutgETZj8dYZh0dh1clVr7B0OBMRgrlRX8ssIeoopZ7mVqaBGg23N7HOKD3fJgOXaFxOSepQMlUmFkiH3kjEkbXCmYHyPn_h_LvQx1Us7NDnc63J7zdjriG-TCnfxpaakzFzEK8NK1WAoWrv3iCSG3_XVwq3RDRFU2sYffBtM4JC1_uVl7DKsHpMmozoMQ6L6mMJyp7gdzdpmnRPMSTck6ADHfUVlr4fE7CylbkHi8kj9wSDBx6FNR94jEALZsLAP3kg6fQTtjEUcqBDD8_wcW57crRnTc9WA3csLrFSHP03nVk7RiAGcCrZDi-MuHQHJx1QTAS-nlQLBg8AxuGp4tE2UYqCIEJykguqYNiEoKiy15w6kaqVO1fj03RiUF7Wp16tmkX_Be3n5e96E6lOnCDqChRsmJqhC0Cjvs-ZeRtVglCY",
    "feetransaction": "sX69D_6L2JnxvtMOX8iYccfhbG394bvhcel-o-ZeZVSRS-5YqSCEqRL3Huy1slrJbO3tp6BpNi5hw7MzN2FqYDaya-dSPS_HLAfIm_bG9MaHyAi6Q_B198ksHm9IV6t5qziZvjFz1axk0JD1vfSZH6bzUp4VQUQJ5yu2h04QiXt4HEcAMtgufvgw_NMzGj3ZJNAB9dOotp0EFcYipRdhdCat4EPsbt97rxOXgPjkiWo2V3VYo7-jW7GSgsSHiY8MtiO-PGCrVTUrs4x3mnXJo96AQm9XPDSF87zfn21kGJn-Tn1CAAcAQ5MMO_gqsR-ocGX394IyYDhQdyq0I3L055Z1-7_g1V6hoLkDNtB_g6vs5nDPE4XbwWOMogAZwr050jpnCp3NRcyLt5Pndw-4H6hdfuKY_uMbJXBQYQSZRCQ2Kgi8eLlEwzV47Imze7QvMVttddss5sd3flj06uCcT5rrap4xFykWcngkwosErk4aaVK8NRCVk5tOwaqp8g9YQCm9Hj3XCUJxIGR0-_b7EV-XYF6JIpkuBZgJOC-L-x7hHREtAuIn41BEiw=="
}

Cancel contract or appservice invoice


A contract creator can cancel contract before completing a contract with the other part.


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

nullet string

nullet from sender in case of pending a transaction controled by an app or nullet contract creater.


password string


contract string

if canceling a contract with contract id


invoiceid string

if canceling an third party invoice.

JSON Body Example releasing a App Transaction:
{
	"nullet": "56ClrhWo61EOpIP6J3mIGuvhUV0xS0LaMvXc_1payxVF7VI929ax9-cvi0an6EBK2Sb6cmIWGPIfkZGQpJOzOivpmw2X7VVm_IR1qMAGFl5AZap-DpaLk-rDH6hvhTu21959gmM8PMwfJiv9Vpegm_lgzcLviBMsWSvTJ2yE5ZBkJPo5P0gAaoYiyswRnCSv-rb8v_Nj",
	"password": "asdfasdf",
	"contract": "clVr7B0OBMRgrlRX8ssIeoopZ7"
}
Response:
{
    "result": true
}

Validation


You can validate some encrypted data. For example if the reciever address is valid and also if the reciever address belongs to a nullet.


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

type string

validation


data string

the encrypted code you think it is defined as type. Send the request without any other fields and you get the result if the reciever address is valid.


nullet string

If you want to check if the reciever belongs to an specific nullet, just add another field and put in the nullet id.


password string

In case of nullet check you have to enter the right password.

JSON Body:
{
    "type": "reciever",
    "data": "DhByPA8u7anAeLTAqGMTwYvjbqMoXh4sTAYkAIVgWlC9UEC5jxK2NbTiFCsxlI4YyItbnuubbog8Ul3d-LXOq6IttYavTJtbmLSVGT0ll6H_gI-Rx9Xi-atPtx4uGN2Nc2LfNY97F_do_ndNeejwrmraeqcpVAbH4pNCQxgjZoETj_FRmzc2D22pdfXRG5i82izBxMpFAvYiXZBY-ZPh7tVVAcStoOGA-qu369yYO1a2e785YKbyyFTn24a_BNrA2Xw=",
    "nullet": "edgeK-GP1ThfFjZr3aodXH_zhC3wMfMANEelC7L0lXm_-27u0uKpxXRzCP7rj9ueUY5lfYYxol47Crx1lbLxpaAFqY4v8e69h8VTYnsw3ZbLGoB4bh28CsIpDCGoi4qa3uXmUT1GpimbvlweztIdF8TsZhJg3JV7StfQH6fMS38yxlFJnaH9R0_4AemPAgZVkZV6n9di",
    "password": "rightPassWord"
}
Response:
{
    "result": true
}