Inflynce Create Campaign

What is Inflynce?

Inflynce Marketing lets anyone boost a link using USDC and reward real users based on measurable social influence (Mindshare). You set a budget and eligible users (Farcaster for now, expanding to X) engage with your link to earn rewards instantly. You can BOOST any link on internet — tweets, project websites, Youtube videos, Farcaster casts — to get visibility. Inflynce runs on Base and does not custody user funds.

This skill creates boost campaigns on Inflynce via the postBoostWeb GraphQL mutation.

Project Structure

inflynce-create-campaign/
├── scripts/
│   ├── create_campaign.js   # Create a boost campaign (main script)
│   ├── pay_fee.js           # Pay 0.25 USDC platform fee (requires PRIVATE_KEY)
│   └── top_up.js            # Approve USDC budget for boosts contract (requires PRIVATE_KEY)
├── test/
│   └── create_campaign.test.js
├── package.json
├── clawhub.json
└── SKILL.md

Prerequisites

1. Install dependencies: Run npm install once before using any script.
2. Platform fee: Each campaign requires 0.25 USDC. The creator wallet MUST have already sent exactly 0.25 USDC to Inflynce on Base. See "How to Pay 0.25 USDC" below.
3. Config: Set GRAPHQL_URL to https://boost.inflynce.com/api/graphql. For programmatic pay/top-up, also set PRIVATE_KEY (creator wallet private key).
4. Gas: The wallet running pay_fee.js or top_up.js needs Base ETH for gas, in addition to USDC.

Environment variables

GRAPHQL_URL=https://boost.inflynce.com/api/graphql
PRIVATE_KEY=0x...   # optional — only needed for pay_fee.js and top_up.js

# Optional: supply your own Base RPC to avoid public endpoint rate limits
RPC_URL=https://mainnet.base.org

Note on RPC: pay_fee.js and top_up.js use viem's default public Base RPC if no RPC_URL is provided. This may be rate-limited under heavy load. For production use, supply a dedicated RPC URL from a provider such as Alchemy, Infura, or QuickNode.

Security

GRAPHQL_URL is enforced at runtime. The script validates that the URL host is exactly boost.inflynce.com and that the protocol is https. Any other value causes an immediate error before any data is sent. You cannot override this to a different endpoint.

PRIVATE_KEY is highly sensitive. It signs real Base transactions. Only supply it if you understand the risk. Prefer doing the 0.25 USDC payment and top-ups manually via boost.inflynce.com to avoid storing a private key in the agent.

Hardcoded addresses (verify at boost.inflynce.com or Inflynce docs):

Usage

Live campaign

npm install && node scripts/create_campaign.js \
  --cast-url "https://..." \
  --payment-hash "0x\x3CTX_HASH_OF_0.25_USDC_PAYMENT>" \
  --creator-wallet "0x..." \
  --budget "50" \
  [--multiplier 1] \
  [--graphql-url "https://boost.inflynce.com/api/graphql"]

Dry run (no API call, no payment required)

Use --dry-run to validate inputs and inspect what would be sent without creating a real campaign. Any valid-format payment hash works for testing.

node scripts/create_campaign.js \
  --dry-run \
  --cast-url "https://x.com/user/status/123" \
  --payment-hash "0x$(python3 -c 'print("ab"*32)')" \
  --creator-wallet "0x..." \
  --budget "10"

Or use run_script with the script path. Required args:

• --cast-url: Any https URL — tweet, project website, Farcaster cast, etc.
• --payment-hash: On-chain tx hash proving 0.25 USDC payment
• --creator-wallet: Ethereum address (validated against payment sender)
• --budget: Campaign budget in USDC (minimum 5 USDC)

Optional args:

• --multiplier: Integer 1–10, default 1. Scales the reward cost per engagement. Use a higher multiplier to attract higher-influence users; use 1 for broad, cost-efficient reach.
• --graphql-url: Override the GraphQL endpoint (must still be https://boost.inflynce.com). Useful when GRAPHQL_URL env var is not set.
• --dry-run: Validate inputs and print the payload without calling the API.

Example output

A successful campaign creation returns:

{
  "id": "cm9abc123def456",
  "boostStatus": "ACTIVE",
  "creatorWallet": "0x000...0001"
}

Use id to track or reference the campaign. boostStatus will be ACTIVE immediately after creation.

Supported URLs

• Tweets: https://x.com/... or https://twitter.com/...
• Project websites: https://example.com
• Farcaster casts: https://warpcast.com/~/casts/0x...
• Any https link

API Reference

• Endpoint: POST https://boost.inflynce.com/api/graphql
• Mutation: postBoostWeb(input: PostBoostWebInput!)
• Auth: None (payment hash proves authorization)
• Returns: { id, boostStatus, creatorWallet }
• appType: This skill sends appType: 2 (Agent). Web UI uses appType: 1. Filter mindshare_boosts by app_type = 2 to find agent-created campaigns.

Flow

1. Top up — Approve USDC for the boosts contract (min 5 USDC). See "How to Top Up" below.
2. Pay 0.25 USDC — Platform fee per campaign. See "How to Pay 0.25 USDC" below.
3. Run this skill with the payment tx hash; campaign is created and returns boost ID.
4. Top up again anytime to increase budget.

How to Pay 0.25 USDC

Each campaign requires a 0.25 USDC transfer to Inflynce on Base. The tx hash is the proof.

Agent (programmatic)

⚠️ No dry-run available. This script broadcasts a real transaction immediately. Ensure the wallet has USDC and Base ETH for gas before running.

npm install && node scripts/pay_fee.js
# Pass PRIVATE_KEY via env:
PRIVATE_KEY=0x... node scripts/pay_fee.js
# Or pass inline as a flag:
node scripts/pay_fee.js --private-key 0x...

Sends USDC.transfer(0xA61529732F4E71ef1586252dDC97202Ce198A38A, 0.25) on Base.

Output:

{ "txHash": "0xabc...def", "amount": 0.25, "chain": "base" }

Extract txHash from stdout and pass it as --payment-hash to create_campaign.js.

Human (wallet)

1. Ensure wallet has USDC on Base
2. Send exactly 0.25 USDC to 0xA61529732F4E71ef1586252dDC97202Ce198A38A
3. Use the transaction hash as --payment-hash

How to Top Up

Option A: Agent (programmatic)

⚠️ No dry-run available. This script broadcasts a real transaction immediately. Ensure the wallet has USDC and Base ETH for gas before running.

npm install && node scripts/top_up.js --amount 50
# Pass PRIVATE_KEY via env:
PRIVATE_KEY=0x... node scripts/top_up.js --amount 50
# Or pass inline as a flag:
node scripts/top_up.js --private-key 0x... --amount 50

--amount defaults to 50 if omitted. Minimum is 5 USDC.

This sends an ERC-20 approve tx: USDC.approve(BOOSTS_CONTRACT, amount) on Base. The agent's wallet must hold USDC and Base ETH for gas.

Output:

{ "txHash": "0xabc...def", "amount": 50, "chain": "base" }

Option B: Human (web UI)

1. Go to boost.inflynce.com
2. Connect the creator wallet
3. Click Top Up Your Spending or Approve USDC
4. Enter amount (minimum 5 USDC), confirm in wallet

Errors & Troubleshooting

FAQ

What URL formats are supported? Any valid https:// URL can be used in an Inflynce Boost campaign. This includes tweets from x.com or twitter.com, project websites, YouTube links, and Farcaster casts from base.app or farcaster.xyz. For Farcaster casts, the system extracts the cast hash directly from the URL path. For all other URLs, the system generates a unique identifier using keccak256(URL).

What is the minimum budget? The minimum campaign budget is 5 USDC. Before creating a campaign, you must set a spending limit using top_up.js or the web interface at boost.inflynce.com.

Does Inflynce custody my funds? No. Inflynce does not custody user funds. When creating a campaign, you approve USDC to the boost contract, and rewards are paid directly from your wallet to users when they engage with the campaign.

How do I get USDC on Base? You can obtain USDC on Base by bridging funds from Ethereum or another supported network, swapping tokens on Base for USDC, or withdrawing USDC from an exchange that supports the Base network such as Coinbase. You will need USDC on Base for campaign fees and budgets, and ETH on Base to pay gas fees.

Can I reuse a payment hash for multiple campaigns? No. Each campaign requires its own 0.25 USDC payment. You must run pay_fee.js or send a 0.25 USDC payment manually once for every new campaign that you create.

How do I know if a campaign was created by an AI agent? Campaigns created through this skill include the parameter appType: 2. You can identify them by filtering the mindshare_boosts table where app_type = 2. Campaigns created through the web interface use appType: 1.

What is Mindshare? Mindshare is Inflynce's metric for measuring a user's social influence on the Farcaster network for now. It is calculated from meaningful engagement signals such as likes, replies, recasts, and follows. Users with higher Mindshare receive higher rewards when participating in campaigns because payouts are pegged to Mindshare.

What is minMindshare? For this skill, the minMindshare value is fixed at 0.003. This threshold ensures that only users with a minimum level of influence can participate in campaigns, which protects campaign budgets from bots, scripted accounts, and low-quality engagement.

What is the cost multiplier? The --multiplier parameter controls the reward cost per engagement. It accepts values from 1 to 10, and the default value is 1. Increasing the multiplier attracts users with higher Mindshare but will consume the campaign budget faster. For most campaigns, starting with a multiplier of 1 is recommended.

Which chain is used for payments? All payments are executed on Base mainnet. Testnet networks are not supported for pay_fee or top_up operations.