gelato

Gelato automation: schedule or condition contract calls through Gelato Automate (interval, cron, on-chain checker, event and one-shot triggers, optional dedicated msg.sender), publish TypeScript Web3 Functions straight from a <<<TS heredoc and attach them to tasks, fund and withdraw the Gas Tank (1Balance) that pays for executions, and read tasks, balances and dedicated msg.senders back.

⚗️ Experimental — available at next.evmcrispr.com.

load gelato

Commands

Command	Description
gelato:automate	Create a Gelato Automate task that calls a contract function on a trigger: --every (interval), --cron , --when (an on-chain checker whose --check function returns whether and with what calldata to execute), --on --event (event trigger), or --once (execute as soon as possible, a single time). With --function the task runs a published Web3 Function instead and executes the calls it returns. Every execution is sent from your dedicated msg.sender (@gelato:dedicatedMsgSender), so targets that restrict callers must allow that address. Executions are billed to your Gas Tank unless --pay names a fee token the target pays with.
gelato:cancel	Cancel a Gelato Automate task you created. Find task ids with @gelato:tasks or @gelato:lastTask.
gelato:cancel-withdrawal	Put a settled withdrawal request back into the Gelato Gas Tank instead of withdrawing it (on Polygon). Needs the same merkle proof as gelato:withdraw — fetched from the 1Balance API, or given with --proof and --total.
gelato:fund	Deposit USDC into the Gelato Gas Tank (1Balance) that pays for Automate, Web3 Function and VRF executions on every chain. Deposits happen on Polygon only; for <sponsor> credits another account (a DAO, a Safe) instead of yours. Approves the exact amount first when the allowance falls short.
gelato:publish-function	Bundle a TypeScript Web3 Function written inline (a <<<TS heredoc) and publish it to Gelato's function store, binding the resulting CID to for gelato:automate --function. Bundling runs in the terminal with esbuild: import @gelatonetwork/web3-functions-sdk, ethers or ky bare, anything else pinned as pkg@1.2.3; every package comes from a tarball verified against the npm registry. In a simulation the function is bundled and validated but not uploaded; gets a placeholder CID that gelato:automate --function accepts inside that simulation only.
gelato:request-withdrawal	Ask the Gelato Gas Tank to release USDC back to you (step 1 of 2, on Polygon). Gelato settles requests off-chain; once settled, gelato:withdraw moves the funds and gelato:cancel-withdrawal puts them back into the tank.
gelato:simulate-task	Execute a Gelato Automate task the way Gelato's executors would — only inside a simulation: impersonates the Gelato executor and calls Automate.exec, so the resolver, the dedicated msg.sender proxy, single-exec cancellation and fee accounting all run for real against the fork. Resolver tasks are executed only when their checker says canExec; Web3 Function tasks cannot be simulated (the function runs off-chain).
gelato:withdraw	Withdraw settled USDC from the Gelato Gas Tank (step 2 of 2, on Polygon). Presents the merkle proof Gelato published after settling your gelato:request-withdrawal; fetched from the 1Balance API, or given with --proof and --total.

Helpers

Helper	Returns	Description
@gelato:automate	address	Address of the Gelato Automate task registry on the current chain, for direct calls.
@gelato:balance	number	USDC a sponsor has put into the Gelato Gas Tank and not withdrawn (deposits minus withdrawals, 6 decimals), read from Polygon whatever chain the script is on. Fees Gelato has already charged are not deducted — the live balance is on app.gelato.cloud.
@gelato:dedicatedMsgSender	address	The dedicated msg.sender Gelato assigns an account on this chain: the proxy that Web3 Function and --dedicated tasks call targets from, and the operator a VRF consumer is deployed with. Deterministic, so it resolves before the proxy is deployed.
@gelato:lastTask	bytes32	Id of the most recently created active Gelato Automate task of an account — handy right after gelato:automate.
@gelato:tasks	array	Ids of the active Gelato Automate tasks an account created, oldest first.
@gelato:withdrawn	number	USDC a sponsor has withdrawn from the Gelato Gas Tank in total (6 decimals), read from Polygon.