Create an Action

Create a smart contract action that executes automatically in response to Hacken Extractor monitoring events, or manually on demand from the dashboard.

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)

   Field	Description
   Gas price	Override the network’s default gas price (in gwei). Leave blank to use market values.
   Gas limit	Maximum gas units for the transaction. Leave blank to use the estimated value.
   Gas Tip	Priority fee for EIP-1559 networks to speed up transaction inclusion.
   Value	Amount 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

   Field	Description
   Severity	Severity label to attach to this manual execution (default: Info).
   Alert message	Custom message for the execution log (defaults to the detector/trigger message).
   Gas price	Override gas price for this run only (defaults to market value).
   Gas limit	Override 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.