agentCLAWHUBUnverified

Bitcoin Identity

Integrate HODLXXI as a Bitcoin-native identity provider that bridges OAuth2/OIDC and Lightning LNURL-Auth for client registration, authorization flows, JWT verification, and health monitoring. Skill: Bitcoin Identity Owner: hodlxxi Summary: Integrate HODLXXI as a Bitcoin-native identity provider that bridges OAuth2/OIDC and Lightning LNURL-Auth for client registration, authorization flows, JWT verification, and health monitoring. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-02-02T00:38:57.473Z | auto Initial release of HODLXXI Bitcoin-native identity provider integration. - Bridges OAuth2/OIDC and Lig

OpenClaw

Rank

62

Safety

84

Downloads

1.1k

Updated

Apr 15, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 4/15/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Apr 15, 2026
Protocol compatibility
OpenClawcompatibility · observed Apr 15, 2026
Adoption signal
1.1K downloadsadoption · observed Apr 15, 2026
Latest release
0.1.0release · observed Feb 2, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install kn74zc3ycywt0h1b0sgr2e779x80agkh:hodlxxi-bitcoin-identity
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-hodlxxi-hodlxxi-bitcoin-identity/snapshot"

Documentation

CLAWHUB

8,718 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: hodlxxi-bitcoin-identity
version: 1.0.0
description: Integrate HODLXXI as a Bitcoin-native identity provider that bridges OAuth2/OIDC and Lightning LNURL-Auth for client registration, authorization flows, JWT verification, and health monitoring.
homepage: https://github.com/hodlxxi/Universal-Bitcoin-Identity-Layer
metadata:
  category: authentication
  license: MIT
  tags:
    - oauth2
    - oidc
    - lnurl-auth
    - jwt
    - bitcoin
  dependencies:
    - curl
    - python
    - ecdsa
    - pyjwt
    - requests
---

# HODLXXI Bitcoin Identity

## Overview

Use this skill to integrate HODLXXI (Universal Bitcoin Identity Layer) for agent authentication, LNURL-Auth linking, and JWT-based identity claims.

## Installation

1. Fetch the skill file from the repository (raw link works for installable agents):

```bash
curl -L -o SKILL.md \
  https://raw.githubusercontent.com/hodlxxi/Universal-Bitcoin-Identity-Layer/main/skills/public/hodlxxi-bitcoin-identity/SKILL.md
```

2. Install helper dependencies for local verification scripts:

```bash
python -m pip install ecdsa pyjwt requests
```

## Quick start

1. Set a base URL for the HODLXXI deployment.
2. Register an OAuth client to obtain `client_id` and `client_secret`.
3. Run the OAuth2/OIDC authorization code flow (PKCE recommended).
4. Start an LNURL-Auth session for Lightning wallet login.
5. Verify JWTs with the JWKS endpoint.

## Usage steps

### 1) Configure the base URL

Set the base URL to the HODLXXI deployment (update as needed):

```bash
BASE_URL="https://hodlxxi.com"
```

### 2) Register an OAuth client

Register a client to get credentials:

```bash
curl -X POST "$BASE_URL/oauth/register" \
  -H "Content-Type: application/json" \
  -d '{"client_name": "YourAgentName", "redirect_uris": ["https://your-callback-url"], "scopes": ["openid", "profile"]}'
```

Store `client_id` and `client_secret` securely.

### 3) Run OAuth2/OIDC authorization code flow

Discover endpoints:

```bash
curl "$BASE_URL/.well-known/openid-configuration"
```

Create an authorization request (PKCE recommended):

```bash
curl "$BASE_URL/oauth/authorize?client_id=your_client_id&redirect_uri=your_callback&response_type=code&scope=openid%20profile&code_challenge=your_challenge&code_challenge_method=S256"
```

Exchange the authorization code for tokens:

```bash
curl -X POST "$BASE_URL/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code&code=received_code&redirect_uri=your_callback&client_id=your_client_id&code_verifier=your_verifier"
```

Expect an access token, ID token (JWT), and optional refresh token.

### 4) Start an LNURL-Auth session

Create a session and show the LNURL to the user:

```bash
curl -X POST "$BASE_URL/api/lnurl-auth/create" \
  -H "Accept: application/json"
```

Poll for completion after the user scans the LNURL with a Lightning wallet:

```bash
curl "$BASE_URL/api/lnurl-auth/check/your_session_id"
```

### 5) Verify JWTs

Fetch JWKS:

_meta.json

{
  "ownerId": "kn74zc3ycywt0h1b0sgr2e779x80agkh",
  "slug": "hodlxxi-bitcoin-identity",
  "version": "0.1.0",
  "publishedAt": 1769992737473
}

HEARTBEAT.md

# HODLXXI Skill Heartbeat

Use this checklist to verify the HODLXXI identity surface is healthy. Recommended cadence: every 5 minutes for production, hourly for staging.

## Required checks

```bash
BASE_URL="https://your-hodlxxi-deployment.com"

curl -fsS "$BASE_URL/health"
curl -fsS "$BASE_URL/.well-known/openid-configuration"
curl -fsS "$BASE_URL/oauth/jwks.json"
curl -fsS "$BASE_URL/oauthx/status"
```

## LNURL-Auth check

```bash
session_json=$(curl -fsS -X POST "$BASE_URL/api/lnurl-auth/create")
session_id=$(python3 -c 'import json,sys; print(json.loads(sys.argv[1])["session_id"])' "$session_json")
curl -fsS "$BASE_URL/api/lnurl-auth/check/$session_id"
```

## Alerting suggestions

- Trigger an alert if `/health` or `/oauthx/status` fails twice in a row.
- Track JWKS expiry/rotation cadence and alert if keys are missing or empty.
- Log LNURL-Auth creation failures to catch Lightning integration regressions.

templates/oauth-client.json

{
  "client_name": "ExampleAgent",
  "redirect_uris": ["https://example.com/callback"],
  "scopes": ["openid", "profile"],
  "grant_types": ["authorization_code"],
  "response_types": ["code"],
  "token_endpoint_auth_method": "client_secret_basic"
}
Github ReposUpdated 7h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceUrl": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-hodlxxi-hodlxxi-bitcoin-identity/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hodlxxi-hodlxxi-bitcoin-identity/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.1K downloads",
      "href": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceUrl": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-04-15T00:45:39.800Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.0",
      "href": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceUrl": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-02T00:38:57.473Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-hodlxxi-hodlxxi-bitcoin-identity/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-hodlxxi-hodlxxi-bitcoin-identity/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.0",
      "description": "Initial release of HODLXXI Bitcoin-native identity provider integration. - Bridges OAuth2/OIDC and Lightning LNURL-Auth for agent registration, authentication, and identity flows. - Supports JWT verification via JWKS endpoint and provides health/status monitoring endpoints. - Includes code examples, best practices, and advanced usage documentation. - Introduces per-client billing via Lightning payments and 402 response handling. - Provides helper scripts and templates for easier client integration and signature verification.",
      "href": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceUrl": "https://clawhub.ai/hodlxxi/hodlxxi-bitcoin-identity",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-02T00:38:57.473Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Bitcoin Identity and adjacent AI workflows.