Catalog

1
import urllib.error
2
import urllib.request
3
4
GLOBAL_URL = "https://downloads.voodoo.center/catalog.lmdb.zst"
5
PERSONAL_URL = "https://downloads.voodoo.center/{client_id}.lmdb.zst"
6
7
8
def download_catalog(client_id: str, dest: str = "catalog.lmdb.zst") -> str:
9
    # Prefer the personal catalog (your negotiated prices); fall back to the
10
    # global one if this account has no personal file (a 404 on the personal URL).
11
    try:
12
        urllib.request.urlretrieve(PERSONAL_URL.format(client_id=client_id), dest)
13
    except urllib.error.HTTPError as exc:
14
        if exc.code != 404:
15
            raise
16
        urllib.request.urlretrieve(GLOBAL_URL, dest)
17
    return dest
18
19
20
# Grab your client id from the dashboard's API page.
21
download_catalog("your-client-id")   # -> catalog.lmdb.zst
22
# Now decompress, open and read it exactly as shown below.

$
pip install zstandard lmdb

$
# Download the compressed snapshot
$
curl -o catalog.lmdb.zst https://downloads.voodoo.center/catalog.lmdb.zst
$
$
# Decompress the zstd frame to a single-file LMDB database
$
zstd -d catalog.lmdb.zst -o catalog.lmdb    # or: unzstd catalog.lmdb.zst

1
import json
2
import struct
3
import urllib.request
4
5
import lmdb
6
import zstandard
7
8
CATALOG_URL = "https://downloads.voodoo.center/catalog.lmdb.zst"
9
10
11
def item_key(item_id: int) -> bytes:
12
    # Records are keyed by the 8-byte big-endian item id (so they sort by id).
13
    return struct.pack(">Q", item_id)
14
15
16
# 1. Download the compressed snapshot.
17
urllib.request.urlretrieve(CATALOG_URL, "catalog.lmdb.zst")
18
19
# 2. Stream-decompress the zstd frame into a single-file LMDB database.
20
dctx = zstandard.ZstdDecompressor()
21
with open("catalog.lmdb.zst", "rb") as fin, open("catalog.lmdb", "wb") as fout:
22
    dctx.copy_stream(fin, fout)
23
24
# 3. Open the env read-only. It is a single FILE, not a directory (subdir=False),
25
#    and read-only readers must pass lock=False.
26
env = lmdb.open("catalog.lmdb", subdir=False, readonly=True, lock=False)
27
28
# Look up one item by id.
29
with env.begin() as txn:
30
    raw = txn.get(item_key(4211))
31
    item = json.loads(raw) if raw else None
32
    print(item)
33
34
# Iterate the whole catalog (records come out ordered by id).
35
with env.begin() as txn:
36
    for key, value in txn.cursor():
37
        item = json.loads(value)
38
        if item["in_stock"]:
39
            price = item["price"] / 100  # cents -> major units
40
            print(item["id"], item["product_type"], f"{price:.2f}", item["name"])

1
{
2
  "id": 4211,
3
  "name": "Sample Game Top-up",
4
  "product_type": "topup",
5
  "min_quantity": 1,
6
  "max_quantity": 1000,
7
  "price": 1250,
8
  "base_price": 1250,
9
  "subscriber_price": 1150,
10
  "amount_per_price": 1,
11
  "in_stock": true,
12
  "updated_at": "2026-07-05T12:00:00+00:00",
13
  "fields": [
14
    { "id": 88, "name": "player_id", "type": "string", "required": true, "options": [] },
15
    {
16
      "id": 91, "name": "server", "type": "choice", "required": true,
17
      "options": [
18
        { "id": 17, "value": "Europe (EU-West)" },
19
        { "id": 18, "value": "North America" }
20
      ]
21
    }
22
  ]
23
}

1
# `item` is a record read from the catalog above; `access_token` is your
2
# Bearer token (see Authentication).
3
import urllib.request, json
4
5
body = {
6
    "item_id": item["id"],
7
    "quantity": 10,                 # within min_quantity..max_quantity
8
    "merchant_order_id": "po-10232",
9
    "fields": {
10
        "player_id": "123456789",   # a text field -> its string value
11
        "server": 17,               # a choice field -> the option's id
12
    },
13
}
14
req = urllib.request.Request(
15
    "https://api.voodoo.center/api/v1/orders",
16
    data=json.dumps(body).encode(),
17
    headers={"Authorization": f"Bearer {access_token}", "Content-Type": "application/json"},
18
    method="POST",
19
)
20
order = json.loads(urllib.request.urlopen(req).read())
21
print(order["id"], order["status"])

$
# -z makes curl send If-Modified-Since based on the local file's mtime;
>
# a 304 leaves your file untouched.
>
curl -o catalog.lmdb.zst -z catalog.lmdb.zst https://downloads.voodoo.center/catalog.lmdb.zst