{
  "schemaVersion": "1.0",
  "item": {
    "slug": "cashu",
    "name": "Cashu",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/a1denvalu3/cashu",
    "canonicalUrl": "https://clawhub.ai/a1denvalu3/cashu",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/cashu",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=cashu",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/cashu"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/cashu",
    "agentPageUrl": "https://openagent3.xyz/skills/cashu/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cashu/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cashu/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Nutshell (Cashu CLI)",
        "body": "Nutshell is a command-line wallet for Cashu, an ecash protocol for Bitcoin. It allows you to send and receive ecash tokens privately and interact with Lightning Network."
      },
      {
        "title": "Installation",
        "body": "This skill requires the cashu CLI. Install it via pipx (recommended) or pip:\n\n# Recommended (isolated environment)\npipx install cashu\n\n# Alternative (system/user wide)\npip install cashu\n\nEnsure the binary path is in your PATH."
      },
      {
        "title": "Environment Configuration (Required)",
        "body": "The CLI requires two environment variables to function correctly:\n\nCASHU_DIR: Directory for wallet data (typically ~/.cashu).\nMINT_URL (or MINT_HOST): The URL of the Cashu mint you want to use.\n\nLinux / macOS:\nPrepend variables to commands or export them in your shell profile.\n\n# Per-command\nCASHU_DIR=~/.cashu MINT_URL=https://mint.example.com cashu balance\n\n# Persistent (add to ~/.bashrc or ~/.zshrc)\nexport CASHU_DIR=~/.cashu\nexport MINT_URL=https://mint.example.com\n\nWindows (PowerShell):\n\n$env:CASHU_DIR = \"$HOME\\.cashu\"\n$env:MINT_URL = \"https://mint.example.com\"\ncashu balance"
      },
      {
        "title": "CLI Usage",
        "body": "All examples below assume CASHU_DIR and MINT_URL are set. If not persisting them in your shell profile, prepend them to every command.\n\nAgent Tip: Always use the --yes (or -y) flag to skip interactive prompts and confirmations. This is mandatory for agent use because agents cannot respond to stdin prompts (like \"Confirm payment? [y/N]\"); omitting it will cause the command to hang and time out."
      },
      {
        "title": "Balance & Info",
        "body": "# Check wallet balance\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes balance\n\n# Check pending tokens\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pending\n\n# Get wallet info\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes info\n\n# List wallets\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes wallets"
      },
      {
        "title": "Sending & Receiving",
        "body": "Send Cashu tokens (ecash):\n\n# Send amount (generates a token string to share)\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes send <amount>\n# Example: CASHU_DIR=~/.cashu MINT_URL=https://8333.space:3338 cashu --yes send 100\n\nReceive Cashu tokens:\n\n# Receive a token string\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes receive <token_string>"
      },
      {
        "title": "Lightning Network",
        "body": "Pay a Lightning Invoice (melt):\n\n# Pay an invoice\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <bolt11_invoice>\n\nPay a Lightning Address (LNURL):\n\n# Pay an LNURL/Lightning Address (automatically resolves the invoice)\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <user@domain.com> <amount_sats>\n# Example: CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay user@npubx.cash 100\n\nCreate a Lightning Invoice (mint):\n\n# Create an invoice to receive funds into the wallet\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoice <amount>"
      },
      {
        "title": "Lightning Address (LNURL)",
        "body": "Manage your Nostr Lightning Address (e.g., user@npubx.cash) to receive payments.\n\n# Create (or display) your static Lightning Address\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl create\n\n# Check for pending payments sent to your address\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl check\n\n# Mint (claim) the pending payments\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl mint"
      },
      {
        "title": "Paying Cashu 402s (Agentic Pattern)",
        "body": "Cashu-enabled APIs may return a 402 Payment Required error with a payment request in the X-Cashu header. This is common for metered APIs or paid endpoints.\n\nThe flow:\n\nMake your HTTP request\nIf you get a 402 with X-Cashu: creqA... header, extract the payment request\n(Optional) Decode it to check accepted mints: cashu decode <payment_request>\nPay it: cashu --yes pay <payment_request>\nGet the token from the response\nRetry the original request, including the token in the X-Cashu header\n\nMint compatibility: Payment requests may encode specific mints from which ecash is accepted. If you try to pay with a wallet backed by a mint not in the allowed list, it will error. Use cashu decode <creq> to see which mints are accepted before attempting payment.\n\nExample:\n\n# 1. Initial request (returns 402)\ncurl -s -i https://api.example.com/data\n\n# Response includes:\n# HTTP/1.1 402 Payment Required\n# X-Cashu: creqA1...\n\n# 2. Pay the payment request\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay \"creqA1...\"\n\n# Returns a token like: cashuA...\n\n# 3. Retry with token\ncurl -s -H \"X-Cashu: cashuA...\" https://api.example.com/data\n\nThis pattern is agentic-friendly: handle 402 automatically, pay, retry — just like handling rate limits or auth redirects."
      },
      {
        "title": "Advanced",
        "body": "# Burn spent tokens\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes burn\n\n# View all invoices\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoices"
      },
      {
        "title": "Configuration",
        "body": "Nutshell uses a .env file inside CASHU_DIR for additional configuration.\nIf MINT_URL is not provided, it may default to a public test mint or fail. Always specify your trusted mint."
      },
      {
        "title": "Notes",
        "body": "Tokens are large strings starting with cashuA... (V3) or cashuB... (V4).\nEnsure you back up your mnemonic if using significant funds (see cashu info)."
      },
      {
        "title": "Contributing",
        "body": "Open issues or contribute at https://github.com/cashubtc/nutshell"
      }
    ],
    "body": "Nutshell (Cashu CLI)\n\nNutshell is a command-line wallet for Cashu, an ecash protocol for Bitcoin. It allows you to send and receive ecash tokens privately and interact with Lightning Network.\n\nInstallation\n\nThis skill requires the cashu CLI. Install it via pipx (recommended) or pip:\n\n# Recommended (isolated environment)\npipx install cashu\n\n# Alternative (system/user wide)\npip install cashu\n\n\nEnsure the binary path is in your PATH.\n\nEnvironment Configuration (Required)\n\nThe CLI requires two environment variables to function correctly:\n\nCASHU_DIR: Directory for wallet data (typically ~/.cashu).\nMINT_URL (or MINT_HOST): The URL of the Cashu mint you want to use.\n\nLinux / macOS: Prepend variables to commands or export them in your shell profile.\n\n# Per-command\nCASHU_DIR=~/.cashu MINT_URL=https://mint.example.com cashu balance\n\n# Persistent (add to ~/.bashrc or ~/.zshrc)\nexport CASHU_DIR=~/.cashu\nexport MINT_URL=https://mint.example.com\n\n\nWindows (PowerShell):\n\n$env:CASHU_DIR = \"$HOME\\.cashu\"\n$env:MINT_URL = \"https://mint.example.com\"\ncashu balance\n\nCLI Usage\n\nAll examples below assume CASHU_DIR and MINT_URL are set. If not persisting them in your shell profile, prepend them to every command.\n\nAgent Tip: Always use the --yes (or -y) flag to skip interactive prompts and confirmations. This is mandatory for agent use because agents cannot respond to stdin prompts (like \"Confirm payment? [y/N]\"); omitting it will cause the command to hang and time out.\n\nBalance & Info\n# Check wallet balance\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes balance\n\n# Check pending tokens\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pending\n\n# Get wallet info\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes info\n\n# List wallets\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes wallets\n\nSending & Receiving\n\nSend Cashu tokens (ecash):\n\n# Send amount (generates a token string to share)\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes send <amount>\n# Example: CASHU_DIR=~/.cashu MINT_URL=https://8333.space:3338 cashu --yes send 100\n\n\nReceive Cashu tokens:\n\n# Receive a token string\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes receive <token_string>\n\nLightning Network\n\nPay a Lightning Invoice (melt):\n\n# Pay an invoice\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <bolt11_invoice>\n\n\nPay a Lightning Address (LNURL):\n\n# Pay an LNURL/Lightning Address (automatically resolves the invoice)\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay <user@domain.com> <amount_sats>\n# Example: CASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay user@npubx.cash 100\n\n\nCreate a Lightning Invoice (mint):\n\n# Create an invoice to receive funds into the wallet\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoice <amount>\n\nLightning Address (LNURL)\n\nManage your Nostr Lightning Address (e.g., user@npubx.cash) to receive payments.\n\n# Create (or display) your static Lightning Address\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl create\n\n# Check for pending payments sent to your address\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl check\n\n# Mint (claim) the pending payments\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes lnurl mint\n\nPaying Cashu 402s (Agentic Pattern)\n\nCashu-enabled APIs may return a 402 Payment Required error with a payment request in the X-Cashu header. This is common for metered APIs or paid endpoints.\n\nThe flow:\n\nMake your HTTP request\nIf you get a 402 with X-Cashu: creqA... header, extract the payment request\n(Optional) Decode it to check accepted mints: cashu decode <payment_request>\nPay it: cashu --yes pay <payment_request>\nGet the token from the response\nRetry the original request, including the token in the X-Cashu header\n\nMint compatibility: Payment requests may encode specific mints from which ecash is accepted. If you try to pay with a wallet backed by a mint not in the allowed list, it will error. Use cashu decode <creq> to see which mints are accepted before attempting payment.\n\nExample:\n\n# 1. Initial request (returns 402)\ncurl -s -i https://api.example.com/data\n\n# Response includes:\n# HTTP/1.1 402 Payment Required\n# X-Cashu: creqA1...\n\n# 2. Pay the payment request\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes pay \"creqA1...\"\n\n# Returns a token like: cashuA...\n\n# 3. Retry with token\ncurl -s -H \"X-Cashu: cashuA...\" https://api.example.com/data\n\n\nThis pattern is agentic-friendly: handle 402 automatically, pay, retry — just like handling rate limits or auth redirects.\n\nAdvanced\n# Burn spent tokens\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes burn\n\n# View all invoices\nCASHU_DIR=~/.cashu MINT_URL=<url> cashu --yes invoices\n\nConfiguration\n\nNutshell uses a .env file inside CASHU_DIR for additional configuration. If MINT_URL is not provided, it may default to a public test mint or fail. Always specify your trusted mint.\n\nNotes\nTokens are large strings starting with cashuA... (V3) or cashuB... (V4).\nEnsure you back up your mnemonic if using significant funds (see cashu info).\nContributing\n\nOpen issues or contribute at https://github.com/cashubtc/nutshell"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/a1denvalu3/cashu",
    "publisherUrl": "https://clawhub.ai/a1denvalu3/cashu",
    "owner": "a1denvalu3",
    "version": "0.19.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/cashu",
    "downloadUrl": "https://openagent3.xyz/downloads/cashu",
    "agentUrl": "https://openagent3.xyz/skills/cashu/agent",
    "manifestUrl": "https://openagent3.xyz/skills/cashu/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/cashu/agent.md"
  }
}