Squeeze Badge Hunt โ€” Builder Kit

by Squeeze ยท Solana Breakpoint 2026 badge
Get Squeeze Badge HuntJump to the template

Everything here is plain text you can read and copy. Nothing to download, no wallet, no sign-up beyond the badge site itself.

The last level of Squeeze Badge Hunt asks you to build your own badge app. Your app saves a small proof item to your inventory; the Hunt reads your inventory and checks it. About 15 minutes with the starter template.

What you need

Steps

  1. Open the editor and add the template's two files, main.lua and app.json (copy them from the Builder Kit page, or drop the builder-template folder on the editor).
  2. In app.json, change "id" to something only you use, e.g. maya-hunt-proof (3-24 characters: a-z, 0-9, -). An id someone else already took can't be tested by you.
  3. In main.lua, set local NONCE = "A949" to your nonce.
  4. Make it yours: change the title, colours, add LED colours. The Hunt only checks the item.
  5. Click Run on badge (signed in). Use the real badge, not the emulator: the emulator has its own badge ID, so its proof won't match your badge.
  6. On the badge your app shows your badge ID, nonce and code. Press SELECT: it says Saved!
  7. Press HOME, open Squeeze Badge Hunt, level 7, CHECK MY PROOF. The Hunt briefly hands the radio to Wi-Fi, reads your items and, if the proof matches, you get the trophy.

You don't have to publish your app: a signed-in test run lasts 12 hours and saves real items.

The proof (if you write your own app from scratch)

Your app needs the items permission and calls:

items.grant("squeeze-hunt-proof", "Hunt builder proof", { b = badge.id(), n = NONCE, c = code }, cb)

code is FNV-1a, 32-bit, as 8 lowercase hex characters, of the text ID|NONCE|squeeze (for example C0FFEE|A949|squeeze). In Lua 5.5 on the badge:

local function fnv(s)
  local h = 0x811C9DC5
  for i = 1, #s do h = ((h ~ s:byte(i)) * 16777619) & 0xFFFFFFFF end
  return string.format("%08x", h & 0xFFFFFFFF)
end

Check: fnv("a") is e40c292c.

Why it fails

Honest small print

The code is tied to your badge ID and your nonce, so a friend's proof doesn't work on your badge. The Hunt can check that an app running on your account saved the right proof after it showed you the nonce. It can't tell who typed the code: build it yourself, that's the fun part.

Just Squeeze It. ๐Ÿ‹ by Squeeze

The template

Paste these two files into the badge app editor. Change NONCE in main.lua and "id" in app.json, then Run on badge.

main.luaplain text
-- My Hunt Proof: a starter app for Squeeze Badge Hunt, level 7.
-- 1. Change NONCE to the 4 characters the Hunt shows you (level 7 or GUIDE).
-- 2. Change "id" in app.json to your own (e.g. maya-hunt-proof).
-- 3. Run it on your badge, press SELECT, then go back to the Hunt: CHECK MY PROOF.
-- Make it yours: change the colours, the text, add LEDs. The Hunt only checks the item.

local NONCE = "0000"   -- TODO: your nonce from the Hunt

-- FNV-1a, 32 bits, as 8 lowercase hex characters (works on the badge's 32-bit ints)
local function fnv(s)
  local h = 0x811C9DC5
  for i = 1, #s do
    h = (h ~ s:byte(i)) & 0xFFFFFFFF
    h = (h * 16777619) & 0xFFFFFFFF
  end
  return string.format("%08x", h & 0xFFFFFFFF)
end

local id = badge.id()
local code = fnv(id .. "|" .. NONCE .. "|squeeze")

ui.bg(0x15110A)
ui.label(10, 10, "MY HUNT PROOF", { size = 20, color = 0xFFE14A })
ui.label(10, 44, "Badge " .. id .. "   nonce " .. NONCE, { size = 14 })
ui.label(10, 66, "Code " .. code, { size = 14 })
local status = ui.label(10, 100, "SELECT saves the proof item", { size = 14, color = 0xFFE14A })
ui.hint("SELECT save proof   CANCEL exit")

local busy = false
function on_key(k)
  if k ~= "select" then return false end
  if busy then return true end
  if NONCE == "0000" then status:text("Put your nonce in NONCE first") return true end
  busy = true
  status:text("Saving...")
  items.grant("squeeze-hunt-proof", "Hunt builder proof", { b = id, n = NONCE, c = code }, function(ok, res)
    busy = false
    if ok then
      status:text("Saved! Open the Hunt: CHECK MY PROOF")
      if led then led.fill(255, 225, 74) end
    else
      status:text("Not saved: " .. tostring(res))
    end
  end)
  return true
end
app.jsonplain text
{
  "id": "my-hunt-proof",
  "name": "My Hunt Proof",
  "version": "1.0.0",
  "summary": "My first badge app: proof for Squeeze Badge Hunt.",
  "icon": "star",
  "accent": "FFE14A",
  "category": "tools",
  "permissions": [
    "items",
    "led"
  ]
}