Agent Integration

Your agent needs to prove that a request is real — not generated by a bot, not replayed, not free.

Sharenote gives it a mathematically unforgeable way to do that. Your agent sets a difficulty target. The user’s client outsources the work to the market. When the proof comes back, your backend verifies it in milliseconds.

The Invoice Pattern

Your agent operates on a simple Request-Invoice-Fulfillment pattern:

  1. User Request: A user (or another system) submits a request to your agent via NIP-90 (Data Vending Machine) or your proprietary API.
  2. Set the Target: Your agent issues a challenge requiring a specific Sharenote denomination (e.g., 20Z00 for basic feed sorting, or 30Z50 for LLM fine-tuning data validation).
  3. Execution: The user’s client outsources that requirement to the market. A Hashrate Provider solves it, and the user submits the mathematically generated proof back to your agent.
  4. Server Verification: Your backend computes the exact continuous difficulty of the submitted hash to verify it meets the requested floor.
  5. Fulfillment: If valid, the agent executes the action.

Vibe Coding Your Integration

You don’t need to manually write complex parsing logic or continuously audit logarithmic difficulty conversions. Instead, you can rapidly prototype and execute your Agent Builder flow using AI-assisted “vibe coding.”

Read the official Skills & AI Integration Guide

No accounts. No API keys. The proof-of-work note is the only credential your agent needs.