Hit the boss
smack_bossLand one smack on the current boss and return the damage dealt and the remaining hit points. One swing per call — call it repeatedly to keep hitting.
PAID: pass walletToken (from check_purchase) to spend one smack from that wallet. Paid hits are the real thing — they can crit, they take the momentum multiplier, and only a paid hit can land the killing blow and put a name on the grave forever.
FREE: pass visitorId instead and it costs nothing. Three per visitorId — the count is held for about thirty days — then FREE_EXHAUSTED, which is the limit working and not a fault. It is NOT an hourly allowance: waiting does not give them back. A free smack can never land the killing blow and free damage is capped per boss, so the engraving stays with somebody who paid for it.
Pass one or the other. If both arrive, the wallet is spent.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional display name for the public hit feed, the leaderboard, and — on a killing blow — the grave. Visible to everyone, and permanent once engraved. | |
| visitorId | No | For a free smack. A stable identifier you generate once and reuse so the free allowance is tracked. Any opaque string; a UUID is ideal. Nothing personal in it. | |
| walletToken | No | A walletToken from check_purchase. Spends one paid smack. Takes precedence over visitorId. |