Onchain tasks

This page walks through building an onchain task end-to-end. Read it once; it maps directly to every field of the Build Task dialog.

Contract address

Paste the deployed contract address. As soon as the field validates as a hex address, the app fires a Sourcify lookup (300ms debounced — rapid edits don’t race).

• Full match → ABI loaded, source-verified.
• Partial match → ABI loaded with a warning chip.
• No match → red banner. You can still paste a custom ABI manually below.

Function

The dropdown lists every state-mutating function (anything not pure or view). Pick the one you want to call — typically mint, mintPublic, claim, etc.

Once selected, the dialog renders one input per ABI argument.

Arg fields and template tokens

For each arg, you can either type a literal value or use a token:

Token	Resolves to	Notes
{address}	The wallet running the row	Per-row substitution at fire time.
{id}	A scavenger-found uint256 ID	Triggers Scavenger search.
{amount}	A free-form amount field exposed in the dialog	Useful for mint(uint256 qty).

Mixing literals and tokens is fine: mint(uint256 id, uint256 qty) can be {id} + 5.

Value (msg.value)

The ETH the function call carries. For paid mints this is price × qty. Field accepts ETH or wei — use the ETH/WEI toggle.

Gas

EIP-1559 fields:

• Max fee per gas (gwei) — your ceiling.
• Max priority fee per gas (gwei) — your tip to validators.
• Gas limit — leave blank to let the runner estimate, or override for known mints.

The values here override Settings defaults. The live gas ticker on the page shows the current network baseline.

Wallet group

Pick which wallet group fires this task. One row is created per wallet in the group.

Mode

• Simulate — snipe-loop: re-checks eth_call readiness on a delay, fires on first non-revert.
• Spam — currently treated as Instant (parallel-nonce fanout is a roadmap item).
• Instant — sign + broadcast immediately.

See Simulate / Spam / Instant for the full breakdown.

RPC override (optional)

By default the runner pulls from your RPC list for the chain. You can pin specific endpoint IDs here to force a subset — useful for tests or when you want a private RPC to do the work alone.

Flashbots (optional, mainnet only)

If you’ve set a Flashbots bundle-signing key (separate from your wallet keys), you can opt this task into the relay. The bundle key is stored in flashbots.key under your data dir; it’s a reputation key, not a wallet key.

Save and fire

Save creates the rows. They sit Pending. Hit Start on the group to fire all of them — or per-row Start on individual rows.

Status updates flow live. Successful runs show Completed + tx hash linking to the explorer. Failures show Failed + revert reason inline.