elfa-42-skill

name	elfa-42-skill
description	Guide agent to wire Elfa AUTO triggers to 42.space price-market mints on BNB Smart Chain, with claim watcher for finalised rounds. Skill provides flow, constraints, references, and thin helpers so agents can apply this integration in their own environment.

elfa-42-skill

Guide agent to wire Elfa AUTO triggers to 42.space price-market mints.

This skill is knowledge plus thin bash helpers, not runtime. Agent chooses runtime and implementation details.

What skill provides

• Strategy authoring flow with Elfa Builder Chat (/v2/auto/chat) + expert /v2/chat trade suggestion
• Query management (/v2/auto/queries) for automated triggers
• Receiver flow with signature-verified webhook intake, local dedupe, guardrails, executor quote/buy
• Claim watcher flow for finalised markets
• Execution handoff through scripts/trade.sh, which wraps the upstream wenlanbot executor
• Minimal API wrappers in scripts/

Upstream references:

• Elfa skill/docs: https://github.com/elfa-ai/skills

Required auth and boundaries

• Outbound Elfa calls use x-elfa-api-key.
• 42.space REST uses no auth.
• On-chain quotes, mints, and claims run through scripts/trade.sh with BSC_PRIVATE_KEY.
• Webhook receivers must verify Auto signatures with AUTO_SECRET before any fund-moving action.
• Execution details live in references/executor.md; this repo does not vendor executor source.
• Execution wrappers require bun and git.

Core constraints

• Query action must be exactly one webhook action.
• Use Builder Chat conditions only. Build action block locally.
• Price-markets-only: market categories must include "Price".
• Never call sell path for price markets.
• Enforce per-strategy cap_usdt_total before mint.
• Pin (market_address, token_id, outcome_index, outcome_name, intent_text) at authoring time.
• Execute buys with token_id only; never pass outcome_index as executable token id.
• Treat cap_usdt_total as total cumulative spend across all fires for a strategy.

High-level flow

1. Author strategy: build conditions, ask expert /v2/chat to suggest trade bucket, validate query, create query.
2. Receiver on fire: verify Auto signature, require X-Auto-Event-Id, dedupe by event_id, load strategy by queryId, run guardrails, quote then mint via executor.
3. Claim watcher: poll pending claims, when market finalised call claim command, record claimed or lost.

Setup summary

1. Get Elfa API key.
2. Prepare BSC wallet with BNB and USDT.
3. Run scripts/setup_executor.sh.
4. Stand up receiver with public HTTPS URL and AUTO_SECRET.
5. Run claim watcher loop.

Reference layout

File	Purpose
references/setup.md	Setup, env, smoke test, production requirements
references/architecture.md	Authoring, receiver, claim watcher, local store
references/endpoints.md	Elfa + 42 endpoints used by this skill
references/elfa-eql.md	EQL subset used by strategy authoring
references/auto-trigger-templates.md	Concrete Elfa Auto params and query templates for 42 triggers
references/elfa-chat-bucket.md	Expert /v2/chat trade suggestion template
references/elfa-webhooks.md	Webhook intake and dedupe behavior
references/ft-price-markets.md	Price-market mechanics and no-sell rule
references/executor.md	Executor wrapper usage and commands
references/strategy-authoring.md	Step-by-step authoring flow
references/troubleshooting.md	Actionable failure fixes
scripts/elfa_call.sh	Elfa API wrapper
scripts/ft_call.sh	42 REST wrapper
scripts/setup_executor.sh	Ensure local executor checkout and install
scripts/trade.sh	Execute status, buy, claim, and portfolio