mallow docs
v1Marketplace

Gumball draw status

POST
/v1/sendDrawGumballTxs/{gumballKey}/status

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.

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/status" \  -H "Content-Type: application/json" \  -d '{    "pendingIds": [      "string"    ]  }'
{  "result": {    "results": [      {        "pending": true,        "txId": "string",        "error": {          "message": "string"        }      }    ]  }}

Send signed gumball draws POST

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.

Draw a Jellybean POST

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