Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.extractor.live/llms.txt

Use this file to discover all available pages before exploring further.

A Smart Contract Action defines a specific contract function call that Extractor can trigger automatically when a monitoring event fires, or that you can run manually at any time.

​
Prerequisites

Before creating an action:
  1. An Action Provider must exist on the same network as the contract.
  2. The provider must have been granted the required role on your contract.
  3. The provider must have sufficient balance to pay gas fees.

​
Create an action

1

Open the Actions tab

In the left sidebar, navigate to your monitored contract and click Actions. Then click Create Action.
2

Enter a name

Give the action a descriptive name (e.g., Pause Contract, Emergency Withdraw).
3

Select the contract function

In the Function dropdown, choose the function you want to execute. Functions are loaded from the contract’s ABI and shown in the format functionName() returnType.
4

Choose a trigger and/or detector (optional)

Select a trigger and/or a detector that should automatically fire this action when an event is detected.
  • Trigger — fires the action based on on-chain conditions (e.g., a specific function call, ERC-20 transfer, failed transaction).
  • Detector — fires the action based on on-chain or off-chain signals (e.g., price drop, AML alert, balance threshold, contract hash change).
Both can be selected together. If left empty, the action can only be run manually.
5

Configure gas settings (optional)

FieldDescription
Gas priceOverride the network’s default gas price (in gwei). Leave blank to use market values.
Gas limitMaximum gas units for the transaction. Leave blank to use the estimated value.
Gas TipPriority fee for EIP-1559 networks to speed up transaction inclusion.
ValueAmount of native token to send with the call (usually 0).
6

Save

Click Create Action. The action appears in the Actions tab with status ENABLED.
The action will execute automatically when the selected trigger fires and the linked Action Provider has enough balance to cover gas. If no provider is linked for the contract’s network, the action will appear as Unlinked and will not run until a matching provider is added.

​
Enable / Disable an action

Open the action’s detail page and use the Monitoring dropdown to switch between ENABLED and DISABLED. Disabling pauses automatic execution without deleting the action.

​
Run an action manually

You can trigger any action on demand, regardless of monitoring events.
1

Open the action row menu

On the Actions tab, find the action and click ··· → View Details, then use the Run Manually option. Alternatively, click the run icon directly in the action row.
2

Configure the manual run

FieldDescription
SeveritySeverity label to attach to this manual execution (default: Info).
Alert messageCustom message for the execution log (defaults to the detector/trigger message).
Gas priceOverride gas price for this run only (defaults to market value).
Gas limitOverride gas limit for this run only.
3

Click Run

Click Run to submit the transaction. The execution will appear in the Executions tab and the action’s Action History.

​
Delete an action

On the Actions tab, click ··· → Delete Action on the action row. This permanently removes the action and cannot be undone.