mallow docs
v1Marketplace

Send signed gumball draws

POST
/v1/sendDrawGumballTxs/{gumballKey}

Co-signs and sends draw transactions signed by the buyer. Post the transactions from POST /v1/getDrawGumballTxs/{gumballKey} exactly as returned apart from the buyer's signature, before their blockhash expires. mallow sends each one after a short random delay, so the buyer can't influence which item is drawn.

Each result has a txId, an error, or a pendingId to check with POST /v1/sendDrawGumballTxs/{gumballKey}/status.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Path Parameters

gumballKey*string

Address of the gumball machine (base58).

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/sendDrawGumballTxs/string" \  -H "Content-Type: application/json" \  -d '{    "txs": [      "string"    ]  }'
{  "result": {    "results": [      {        "txId": "string",        "pendingId": "string",        "error": {          "message": "string",          "logs": [            "string"          ]        }      }    ]  }}

Draw a Gumball POST

Builds the buyer's draw transactions. Have the buyer sign them, then post them to POST /v1/sendDrawGumballTxs/{gumballKey}. mallow has to co-sign them, so don't send them yourself.

Gumball draw status POST

Returns the outcome of draws that came back with a pendingId. Poll about every two seconds until each resolves to a txId or an error. An id can be checked for five minutes.