Skip to main content
The Boost V2 Docs are under active development and will be subject to changes.

Setting up an Action

Actions define what on-chain behavior you want to reward. With Boost V2, you can incentivize virtually any blockchain activity—from NFT mints to token swaps to governance votes.

What is an Action?

An action tells Boost what to look for on the blockchain. When someone performs the activity you’ve defined, they become eligible for rewards. Every action has three parts:

What to Watch

Which smart contract and which specific activity (like a mint or transfer) to monitor.

Who Gets Rewarded

How to identify the person who performed the action so they can claim their reward.

Qualifying Criteria

Any specific conditions that must be met (like a minimum amount or specific token).
Unlike Boost V1, where actions were pre-defined by the team, V2 lets you create custom actions targeting any on-chain activity.

Creating an Action from a Transaction

The easiest way to set up an action is to show Boost an example transaction. Just paste a transaction hash, and Boost will automatically figure out the details.

Step-by-Step Guide

1

Find an Example Transaction

Go to a block explorer like Basescan or Etherscan and find a transaction that represents what you want to incentivize.Good examples:
  • Someone minting an NFT you want to promote
  • A swap on your DEX
  • A vote or delegation in your governance system
Copy the transaction hash (the long string starting with 0x...).
2

Paste the Transaction Hash

Enter the transaction hash in the Boost action creator. The system will automatically:
  • Pull up the transaction details
  • Identify all the activities that happened
  • Show you which ones can be used for rewards
3

Choose the Activity to Reward

You’ll see a list of events from the transaction. Pick the one that best represents what you want to incentivize.For example, if you want to reward NFT mints, you’d typically select a Transfer or Mint event.
Don’t worry if you’re not sure which to pick—the AI assistant can help you choose the right one.

Let AI Help You Configure

Boost includes an AI assistant (powered by Claude) that can help you set up your action. Just describe what you want to reward in plain English, and the AI will suggest the best configuration.

How It Works

1

Describe What You Want

Write a simple description of the behavior you want to incentivize:
  • “Reward anyone who mints an NFT from this collection”
  • “Give rewards to users who swap at least $100 worth of tokens”
  • “Incentivize people who vote on governance proposals”
2

AI Suggests a Configuration

Based on your description and the transaction you provided, the AI will:
  • Pick the right event to track
  • Figure out how to identify who performed the action
  • Set up any filters you need
  • Recommend whether to use fixed or variable rewards
  • Explain its reasoning so you can verify it makes sense
3

Review and Adjust

Look over the AI’s suggestions. You can accept them as-is or make changes if needed.The AI will also warn you if something doesn’t look right—for example, if your description asks for something the transaction doesn’t support.

Fixed vs Variable Rewards

The AI will recommend a reward type based on your description:
Everyone who qualifies gets the same reward amount.The AI suggests fixed rewards when you say things like:
  • “Give 100 tokens for each mint”
  • “Reward exactly 50 USDC per vote”
  • “Pay 10 tokens to anyone who completes this action”
Best for: Simple campaigns where all participants should be treated equally.

Providing Project Information

When creating an action, you’ll need to provide some information about your project:
1

Project URL

Enter the URL where users can perform the action you’re incentivizing. This helps the Boost team verify your action and helps users find where to participate.Examples:
  • https://yourproject.xyz/mint
  • https://app.yourdex.com/swap
  • https://governance.yourprotocol.io
The project URL is required. Make sure it’s the actual page where users will perform the action.
2

Project Details

Add any additional context that helps explain what your project does and why you’re running this campaign.

Preview Your Action

Before submitting, you can preview recent transactions that match your configuration:
Activity preview

See which transactions would qualify for rewards

This preview helps you verify that:
  • The right transactions are being captured
  • The correct people would receive rewards
  • Your filters are working as expected
If the preview shows unexpected results, go back and adjust your configuration. It’s much easier to fix issues now than after your action is live.

Review and Approval Process

All new actions must be reviewed and approved by the Boost team before you can use them. This typically takes 24-48 hours.

Why Review is Required

The review process ensures that:
  • Your action is set up correctly and will work as intended
  • The configuration captures the right transactions
  • There are no security issues or ways to game the system
  • Your project information is accurate

What the Team Reviews

When you submit an action, the Boost team will:
Review ItemWhat They Check
Test the actionRun your configuration against real transactions to make sure it works correctly
Verify the setupConfirm the right events, parameters, and filters are configured
Check securityLook for potential abuse vectors or gaming opportunities
Validate project infoVerify the project URL and details you provided are accurate

Action Status

After submitting, your action will have one of these statuses:
StatusWhat It Means
PendingWaiting for the Boost team to review
ApprovedReady to use! You can now deploy boosts with this action
RejectedSomething needs to be fixed—check the feedback provided

If Your Action is Rejected

Don’t worry—rejections usually just mean something needs a small fix. You’ll receive feedback explaining:
  • What the issue was
  • How to fix it
You can then create a new action with the corrections. If you’re unsure about the feedback, reach out on Discord for help.

Tips for Success

When choosing your example transaction, pick one that represents normal user behavior. Unusual or edge-case transactions might lead to configurations that don’t work well for most users.
The more specific you are, the better the AI can help:
  • “Reward mints”
  • “Reward users who mint at least 2 NFTs from the CoolCats collection”
Always check the activity preview before submitting. It shows you exactly what transactions would qualify, so you can catch any issues early.
Make sure the URL you provide is correct and leads to where users can actually perform the action. This speeds up the review process.

Next Steps

Once your action is approved, you’re ready to configure your rewards and launch your campaign.

Deploying a Boost

Learn how to set up rewards and deploy your boost campaign.