Skip to Content
TutorialsCrown Price Widget + Takeover

Build a Crown price widget + takeover call

Goal:

  • display the live takeover price in your UI
  • submit a takeover transaction using the default app UX (send the current cost, handle contention reverts)

What you will use

  • MineCore.getCurrentTakeoverPrice() (preferred for a live quote)
  • MineCore.getTakeoverPrice(uint256 timestamp) (optional, arbitrary timestamp quote)
  • MineCore.takeover() (ETH entry)
  • MineCore.takeoverWithToken(tokenIn, amountIn, minEthOut) (token entry, optional)
  • deployments/<network>.json (MineCore address)

Flow

Steps

1) Read the price from chain

Preferred:

  • call the live quote helper: getCurrentTakeoverPrice()

Alternative:

  • call getTakeoverPrice(block.timestamp) if you already have a canonical timestamp source

Fallback (only if you must):

  • implement the formula from Core mechanics using:
    • referencePrice
    • currentReignStartTime

2) Provide the default takeover UX (no max price input)

Between takeovers, the takeover cost only decays downward.

The only meaningful race condition for the ETH path is:

  • someone else takes over before your tx confirms
  • the cost doubles (referencePrice = 2× last paid price)
  • your tx reverts because msg.value is now below the required price

Recommended UI pattern:

  • show priceEth (live)
  • show a short contention note:
    • “If someone takes over first, your takeover can revert. Refresh and retry.”
  • provide an explicit Refresh quote action

3) Submit the transaction (ETH path)

Recommended call (default UX):

  • MineCore.takeover() with msg.value = priceEth (tight value)

Behavior:

  • MineCore charges the current price at execution time.
  • If the price decays further before execution, any excess is refunded/credited.
  • If the Crown moves (someone else takes over first), the price doubles and your tx reverts.

After confirmation:

  • refresh UI from onchain state (do not rely on optimistic updates)

If it reverts under contention:

  • refresh the quote
  • show a clear reason (ex: “Crown moved” / “Someone took over first”)
  • offer a one-click retry

4) Token takeover path (optional, advanced)

If you support takeoverWithToken:

  • label it as Advanced
  • always show the canonical ETH price line alongside the token estimate
  • disclose that leftover value is returned in ETH (not the input token)

Safety requirements:

  • the token must be allowlisted in MineCoreEntryTokenRegistry (otherwise the call reverts)
  • require minEthOut to protect against poor execution / MEV

Canonical quoting (recommended):

  • use MineCoreQuoter.quoteTakeoverWithToken(tokenIn, amountIn) to get:
    • ethOut (expected post-swap ETH credited to the takeover flow)
    • takeoverPrice (current takeover price for comparison)
  • compute minEthOut from an explicit slippage policy:
    • minEthOut = ethOut * (10_000 - slippageBps) / 10_000
    • optional stricter guard: clamp minEthOut >= takeoverPrice

SDK example (local):

RPC_URL=http://127.0.0.1:8545 \
  npm -C agents/sdk run example:takeover-token-quote
  • listen for MineCore events:
    • Takeover
    • ReignFinalized

Use events to:

  • update the current King
  • append to the reign history list

What success looks like

  • The UI shows a takeover price that matches the official app.
  • The UI sends the current cost (no user-entered max).
  • Under contention, the UX clearly explains the revert and drives a retry.

Next reads

Index Takeovers & ReignsRun a Crown Bot