All plugins

earnfi

Work, Money & Execution Layer for Hermes — hire humans and agents, fund real-world work via x402, escrow, and receipts across Solana, Base, NEAR, and OKX X Layer. Disclosure — Crypto payments: connects to EarnFi's hosted MCP server at app.earnfi.fun, whose tools create paid jobs, fund escrow, settle x402 payments and withdraw USDC on Solana, Base, NEAR and OKX X Layer. The server is declared untrusted, so every write or payment tool asks for Hermes approval, with no spend cap by default. earnfi_sign_x402 signs an x402 payment locally with the user's dedicated wallet key only after a Hermes approval prompt showing network, amount, asset and payee. Optional Node setup scripts install exact-pinned npm packages (with install scripts disabled) and create dedicated wallet keys that the user stores in the plugin's secret settings.

EarnFiToolsv1.5.2Updated 5 days ago

About

Work, Money & Execution Layer for Hermes — hire humans and agents, fund real-world work via x402, escrow, and receipts across Solana, Base, NEAR, and OKX X Layer. Disclosure — Crypto payments: connects to EarnFi's hosted MCP server at app.earnfi.fun, whose tools create paid jobs, fund escrow, settle x402 payments and withdraw USDC on Solana, Base, NEAR and OKX X Layer. The server is declared untrusted, so every write or payment tool asks for Hermes approval, with no spend cap by default. earnfi_sign_x402 signs an x402 payment locally with the user's dedicated wallet key only after a Hermes approval prompt showing network, amount, asset and payee. Optional Node setup scripts install exact-pinned npm packages (with install scripts disabled) and create dedicated wallet keys that the user stores in the plugin's secret settings.

EarnFi - Work, Money & Execution Layer

EarnFi brings a Work, Money & Execution Layer to Hermes Agent.

Most AI agents can reason, call tools and interact with APIs. But when a task requires a capability outside their runtime — physical verification, local research, product testing, human expertise or specialised execution — they need more than another tool. They need a way to delegate and get the work completed.

EarnFi connects Hermes agents to a marketplace of human and AI-agent capabilities. Through its hosted MCP and Agent API infrastructure, agents can discover services, find workers, create jobs, coordinate delivery, access escrow-backed transactions and use programmable payment infrastructure.

The plugin provides a native Hermes experience with registered slash commands, live diagnostics, workflow skills and access to EarnFi's hosted MCP server.

It supports distinct payment and agent-registration workflows across Solana, Base, NEAR and OKX X Layer, with network-specific signing requirements and payment proofs.

Rather than reimplementing marketplace or settlement logic inside the plugin, EarnFi uses its production MCP/API infrastructure as the execution layer. Hermes provides the native agent interface, while EarnFi handles the underlying work and money workflows.

The goal is to let agents do more than consume tools or move funds. It gives them a way to turn resources into completed work, including work performed by other agents and people.

Aligned with https://app.earnfi.fun/skill.md.

What does the plugin do?

  • Discover human workers, AI agents, services and available work.
  • Create, manage and coordinate jobs through EarnFi.
  • Hire human specialists and agent service providers.
  • Coordinate human-execution workflows, submissions and evidence.
  • Launch and access campaigns, social media campaigns, social tasks, contests and bounties.
  • Create and manage Deals with escrow-backed transaction workflows.
  • Access supported x402 payment workflows.
  • Generate dedicated agent wallets and complete network-specific agent registration.
  • Access balance, earnings, payment status and transaction receipts.
  • Apply Equity Guard workflows for supported tokenised-asset actions.
  • Diagnose EarnFi connectivity, API availability, network configuration and MCP capabilities.

The plugin includes native Hermes commands, a read-only diagnostic tool and 13 workflow skills. Marketplace, job, payment and escrow execution remains on EarnFi's hosted MCP/API infrastructure.

What makes it innovative?

EarnFi extends the practical capabilities of autonomous agents beyond their software runtime.

Existing agent infrastructure increasingly enables agents to reason, discover tools, communicate with other agents and make payments. However, access to tools and the ability to pay for digital services do not automatically give an agent access to capabilities that require human expertise or physical-world execution.

EarnFi addresses this gap by connecting agents to a marketplace where they can discover capabilities, commission work, hire human specialists or other agents, allocate budgets, coordinate delivery and receive verifiable outcomes.

Its architecture combines native Hermes integration, hosted MCP execution, agent identity, network-specific wallet registration, x402 payments, marketplace workflows and escrow-backed transactions.

The important distinction is that EarnFi is not simply giving an agent another tool or a wallet. It is giving the agent infrastructure to source capabilities and turn economic resources into completed work.

This creates a practical path towards agents functioning as economic participants in a human-agent economy.

Technical implementation

EarnFi for Hermes is an independently packaged native Hermes plugin.

It uses Hermes' native plugin interface through plugin.yaml and __init__.py, with register(ctx) registering the plugin's diagnostic tool, slash commands and bundled workflow skills.

Native components include:

  • earnfi_doctor — read-only connection and capability diagnostics
  • earnfi_sign_x402 — build x402 payment_signature from plugin settings (no private keys in chat)
  • /earnfi — plugin overview
  • /earnfi-help — commands and workflow guidance
  • /earnfi-status — live system diagnostics
  • /earnfi-smoke — read-only integration checks
  • /earnfi-wallet — register wallet from plugin settings (keygen in your OS terminal only)
  • 13 Hermes-specific workflow skills
  • Pinned Node deps: package.json + package-lock.json (npm ci in plugin root)

The plugin connects to EarnFi's hosted Streamable HTTP MCP endpoint at https://app.earnfi.fun/mcp. The MCP server exposes approximately 141 tools across marketplace, jobs, human actions, agent identity, payments, escrow, campaigns, contests, Deals, balances and related capabilities. The live server card inventory is authoritative because the count can change.

Payment workflows preserve the signing requirements of each network:

NetworkPayment proof
SolanaEd25519 transaction-signature payment proof
BaseEIP-3009 typed-data payment proof
NEARNEP-366 signed delegate action
OKX X LayerDedicated OKX payment tools and EVM payment payload

Base and OKX agent registration use ethers.Wallet.signMessage for the challenge message. Registration signatures are distinct from payment proofs.

Install

hermes plugins install earnfidotfun/earnfi-hermes-plugin
hermes plugins enable earnfi

Local checkout:

hermes plugins install /path/to/earnfi-hermes-plugin --no-enable
hermes plugins enable earnfi
hermes plugins validate . --install-deps
hermes plugins doctor . --ci

Try it

/earnfi-status
/earnfi-smoke
/earnfi-wallet solana --name "Media Buddy"
  • "What networks does EarnFi support?"
  • "Generate a Solana wallet" / "Create a dedicated Base wallet" → /earnfi-wallet <network> --name "…" (never node scripts/… from the agent terminal tool)
  • "Pay for a social campaign" → MCP quote → approve → earnfi_sign_x402 → MCP retry with payment_signature
  • "Find someone who can verify this business under $5 USDC." → MCP marketplace tools

Agent wallet (catalog-safe)

  1. Generate a key in your OS terminal: node scripts/<network>-setup.mjs --name "Your Agent" (secret prints once on console).
  2. Paste the secret into Settings → Plugins → earnfi.
  3. /earnfi-wallet <solana|base|near|okx> --name "Your Agent" — register using the saved secret (no keygen on gateway).
  4. Use MCP for jobs, marketplace, and x402 (earnfi_sign_x402 requires approval; pass full quote_json from the 402 response).

Payment safety

  1. Quote without payment_signature.
  2. Disclose amount, asset, network; get approval.
  3. Sign one matching accept. Never mix Solana / Base / NEAR / OKX proofs.
  4. Retry the same tool with payment_signature.
  5. Report success only after EarnFi confirms settlement.

Automated withdrawals are Solana USDC only. See docs/SECURITY.md.

Documentation

DocContents
INSTALLATION.mdInstall, enable, uninstall
CONFIGURATION.mdMCP URL, secrets, trust
CAPABILITIES.mdLive MCP tool inventory
SECURITY.mdApprovals, settlement, disclosure
EXAMPLES.mdWorked prompts
TROUBLESHOOTING.mdCommon failures

License

MIT — see LICENSE.

Links

README from the reviewed commit 3d595e9; it updates when the author re-pins.

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section