Bots & Automation

ClaimRush is permissionless — EOAs and smart contracts can play, and anyone can build automation. This page covers how to grant a trusted bot limited access to act on your behalf.

Note: ClaimToken and VeClaimNFT are permanent direct roots. MineCore, Furnace, MarketRouter, and ShareholderRoyalties are governed runtime contracts behind stable proxy addresses during the audit window. ClaimToken freezes and renounces ownership during Wire.s.sol; after the external audit, the timelocked freeze-and-burn ceremony freezes the remaining four freeze-gated contracts and removes quartet upgrade authority permanently. Surviving admin knobs remain timelocked. Gameplay is permissionless from day one. See Safety & Risk — Protocol phases.

Should I use a bot?

Most players don’t need one. Bots are useful if you:

Want to take over the Crown automatically when the cost drops to a target range
Want to auto-collect royalties or compound without logging in
Want a bot to maintain your locks (extend, merge, unlock expired) on a schedule

If you’re just locking CLAIM and collecting royalties occasionally, you don’t need bot access. The app’s built-in auto-compound handles the most common automation use case without delegation.

How it works

A bot session is:

a delegate address (the bot)
a permission set (what it can do)
an expiry time (when it automatically stops working)

Sessions are off by default and can be revoked at any time. A bot session does not give custody of your wallet and does not approve spending your ERC20 tokens — it only enables specific protocol functions.

Common uses

Crown automation: A bot pays ETH and takes over for you on a schedule. You become King and mine CLAIM; the bot receives the 75% ETH payout when you’re dethroned (so it can keep looping). Your mined CLAIM stays with you.
Collect automation: A bot runs Collect ETH / Collect & Lock for you and withdraws any fallback King payout buckets.
Furnace automation: A bot enters the Furnace for you using its own ETH/CLAIM/tokens.
Lock maintenance: A bot extends locks, merges locks, or unlocks expired ones. CLAIM always returns to you.
Config automation: A bot updates your auto-lock / auto-compound settings.

Where to manage bot access

App footer → Security → Bot access. (See: Security page)

You can: add a delegate address, choose permissions, set an expiry, Grant / Revoke.

What a bot cannot do

Spend your tokens. No permission lets a bot transfer CLAIM or other tokens from your wallet.
Manage Market positions. Listing, selling, and escrow management are intentionally not delegated in v1.0.0. For Market automation, use a bot-owned wallet.
Access your private key. Bot sessions are onchain delegation, not key sharing.

Safety checklist

Only delegate to a bot address you control or deeply trust.
Use short expiries (start with 1 day).
Start with minimal permissions and expand only if needed.
Revoke sessions you no longer use.
Use Radar notifications for security events (bot session used, session granted/revoked, recipients changed).
Verify contract addresses in the app footer → Security.

Audit and alerts

The Bot access screen helps you audit automation “like approvals”:

shows each session’s delegate, expiry, and permissions
highlights high-risk permissions with clear warnings
shows last used time + last action type
links to the transaction hash for recent activity
includes an emergency stop: Revoke all sessions

Crown bot routing

When a bot takes over for you:

You become the King identity.
By default: the bot receives the 75% ETH payout (so it can keep looping), your mined CLAIM stays with you.
Optional: grant Route reign CLAIM to bot to send mined CLAIM to the bot instead.

Mid-reign routing changes live under Advanced routing controls (collapsed by default in the Bot access UI). Prefer scoped restore options (“restore to bot only” / “restore to you only”) when possible.

Permissions reference

Permissions are grouped in the UI. Only grant what you need.

Crown (MineCore)

Permission	Meaning
Takeover for you	Bot can pay ETH to take over, but your address becomes King.
Set reign ETH recipient	Bot can redirect the dethroned-King 75% ETH payout for your current reign. High risk.
Restore reign ETH recipient (bot only)	Bot can restore the current reign so the dethroned ETH payout recipient is the bot (repair only).
Set reign CLAIM recipient	Bot can redirect the mined CLAIM stream of your current reign. High risk.
Restore reign CLAIM recipient (to you only)	Bot can restore mined CLAIM routing back to you.
Route reign CLAIM to bot (optional)	At takeover time, lets a delegated takeover start with mined CLAIM routed to the bot instead of you.

Collect (payouts)

Terminology note: some screens say “claim” because they map to onchain action types. In user flows, these correspond to Collect / Collect & Lock.

Permission	Meaning
Withdraw King bucket	Bot can withdraw your fallback King ETH bucket (ETH always goes to you).
Claim shareholder rewards	Bot can run your Baron claim (Collect ETH or Collect & Lock).
Claim all	Bot can run a bundled “claim all” for you (Baron claim + King bucket withdraw).

Furnace

Permission	Meaning
Enter with bot-paid ETH	Bot pays ETH, you receive the veCLAIM lock.
Enter with bot-paid CLAIM	Bot pays CLAIM, you receive the veCLAIM lock.
Enter with bot-paid token	Bot pays an allowlisted token, you receive the veCLAIM lock.

Locks (veCLAIM maintenance)

Permission	Meaning
Extend veCLAIM lock	Bot can extend your lock duration (can only increase, cannot shorten).
Merge veCLAIM locks	Bot can merge two of your locks into one (irreversible).
Unlock expired veCLAIM lock	Bot can unlock an expired lock; CLAIM always returns to you.

Automation settings

Permission	Meaning
Set King auto-lock config	Bot can update your King auto-lock settings (config only; does not move funds).
Set shareholder auto-compound config	Bot can update your shareholder auto-compound settings (config only; does not move funds).
Set LP auto-compound config	Bot can update your LP staking auto-compound settings (config only; does not move funds).

Developers

If you want to build a bot that plays from its own wallet (no delegation), see the developer manual: Agents and automation .