Skip to content

LedgerProof/laen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LAEN — On-Demand Unblocking for Autonomous Execution

When an agent or pipeline halts on an unverified assertion, LAEN turns the halt into a procurement event: find the matching blocker (free), pay $0.25–$0.50 USDC via x402 on Base with your own delegated wallet, receive independently verifiable, cryptographically anchored evidence, and resume. No accounts, no API keys, no humans.

  • MCP server (official registry): io.github.LedgerProof/laen Remote: https://jmspfggpztykyubyzvlx.supabase.co/functions/v1/laen-mcp Tools: laen_find_blockers (free) · laen_quote (free) · laen_resolve (paid, your wallet signs)
  • Blocker feed (free discovery): https://jmspfggpztykyubyzvlx.supabase.co/functions/v1/laen-feed/blockers
  • Settlement: x402 · USDC on Base mainnet · fail-closed (no settled payment → no evidence)
  • Metric: TTU — time-to-unblock, from your halt to delivered clearance
  • Trust: certificates carry a verify_url that is independently checkable — trust the evidence, not LAEN

The loop

your runtime halts on an unverified assertion
  → find_blockers(signature)           free
  → quote(blocker_id, product)         free
  → sign x402 payment (YOUR wallet)    $0.25 receipt | $0.50 anchored certificate
  → resolve → evidence (+ verify_url)  fail-closed
  → resume

Budget sovereignty is yours: the interceptor refuses to exceed policy.maxCostCents. LAEN never holds, requests, or signs your funds.

Use it three ways

1. MCP (agent runtimes: Claude, Cursor, custom loops)

Add the remote server and the three tools appear in the agent's toolbelt: https://jmspfggpztykyubyzvlx.supabase.co/functions/v1/laen-mcp

2. Runtime interceptor (any JS/TS agent loop)

import { unblock, withLaen } from "./interceptor.mjs"; // or fetch from the live URL below

const clearance = await unblock({
  signature: { identifier: "api.example.com" },   // what you halted on
  wallet,                                          // viem wallet, YOUR delegated funds
  policy: { maxCostCents: 50, product: "receipt" },
});
// clearance.evidence, clearance.certificate?.verify_url, clearance.ttu_ms

Live module: https://jmspfggpztykyubyzvlx.supabase.co/functions/v1/laen-interceptor/interceptor.mjs Deps: x402-fetch, viem.

3. CI/CD (GitHub Action — this repo)

When a provenance/compliance verification step fails, buy the proof and keep the pipeline moving:

- name: Unblock on unverified provenance
  if: failure()
  uses: LedgerProof/laen@v1
  with:
    identifier: "api.example.com"        # failure signature
    product: receipt                      # or: certificate (adds anchored verify_url)
    max-cost-cents: "25"                  # hard spend cap for this step
    wallet-key: ${{ secrets.LAEN_WALLET_KEY }}

Wallet safety: use a DEDICATED wallet holding only a small USDC float on Base, stored as a repo secret. The key is used locally to sign the x402 payment and is never transmitted. The action enforces max-cost-cents; one run spends at most one resolution.

Outputs: paid, cost-cents, ttu-ms, verify-url, and laen-evidence.json in the workspace.

What the evidence is (and is not)

Evidence reports the faithful state of an anchored public record (and, where applicable, a live observation of the primary source at fulfillment time), with a recomputable confidence formula. It attests existence + integrity of the cited material — it does not assert the truth of any conclusion or anyone's legal status, and a non-match is never proof of absence. The certificate tier mints a fresh, cryptographically anchored receipt with a public verify_url.

License

License terms not yet published. Contact LedgerProof (https://ledgerproofhq.io).

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages