ToolVet
78trust / 100

Lnurl Invoice

by nostr.halowerk.com in Markets & finance

x402 APIPassing, checked 3 h ago

Accepts three forms of recipient. A bech32 lnurl is decoded to its callback URL, a Lightning address is resolved through the well-known lnurlp path, and a Nostr public key is resolved by reading its kind 0 profile from relays and taking the lud16 or lud06 field it publishes.

POST https://nostr.halowerk.com/lnurl-invoice

Last 30 days

All checks passedSome failedAll failedNot checked

Status and outage history · Atom feed

Uptime
100%
Response time
127 ms typical, 178 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

POST https://nostr.halowerk.com/lnurl-invoice

Each call costs $0.002 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

POST https://nostr.halowerk.com/lnurl-invoice
content-type: application/json

{
  "amount_sats": 1,
  "recipient": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"
}

Parameters

ParameterTypeRequiredDescription
amount_satsintegerYesAmount in satoshi. Must lie within the limits the service declares.
commentstringNoComment for the payment. Only sent if the service allows comments and only up to the length it allows.
recipientstringYeslnurl1… string, Lightning address name@domain, or a Nostr public key as hex, npub or nprofile.
relaysarray of stringNowss relay addresses used only when the recipient is a Nostr public key.
zap_requestobjectNoA signed NIP-57 kind 9734 zap request. Only sent if the service declares allowsNostr.

Example response

The listing has no example response.

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.002.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://nostr.halowerk.com/lnurl-invoice' \
  -H 'content-type: application/json' \
  --data-raw '{"amount_sats":1,"recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://nostr.halowerk.com/lnurl-invoice' \
  -H 'content-type: application/json' \
  --data-raw '{"amount_sats":1,"recipient":"0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.002 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.002" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.002 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fnostr.halowerk.com%2Flnurl-invoice&method=POST
const res = await pay("https://nostr.halowerk.com/lnurl-invoice", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "amount_sats": 1,
    "recipient": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E"
  }),
});
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.002 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.002"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://nostr.halowerk.com/lnurl-invoice",
        json={
            "amount_sats": 1,
            "recipient": "0x2880EdfFF13100677Bf97A3CBdF3Bc34771C4E5E",
        },
    )
    print(res.status_code, res.text)

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402140 ms$0.002
7 h agoPassed40299 ms$0.002
11 h agoPassed402134 ms$0.002
15 h agoPassed402127 ms$0.002
19 h agoPassed402178 ms$0.002
23 h agoPassed402150 ms$0.002
27 h agoPassed40241 ms$0.002
30 h agoPassed402167 ms$0.002
34 h agoPassed402547 ms$0.002
37 h agoPassed40241 ms$0.002
40 h agoPassed402156 ms$0.002
44 h agoPassed40240 ms$0.002
47 h agoPassed402121 ms$0.002
2 days agoPassed402133 ms$0.002
2 days agoPassed402144 ms$0.002