Nutoff Wallet Proxy

About Nutoff Wallet Proxy

Nutoff is a proxy service that enables you to use your local nutoff wallet as a Lightning Address, even when running locally. The service bridges the gap between your local wallet (reachable via Nostr through contextvm) and the Lightning Network by providing an HTTP interface that Lightning wallets can understand and interact with.

Features

  • Proxy for local nutoff wallets
  • Lightning Address support (LUD-16)
  • Nostr integration for local wallet connectivity
  • HTTP interface for Lightning wallet compatibility
  • Public service available for everyone

Getting Started

Follow these steps to get your nutoff wallet working with the proxy:

  1. Install and run your nutoff wallet:
    Visit https://github.com/gzuuus/nutoff-wallet and follow the installation instructions to run your local wallet.
  2. Get your wallet's public key:
    Once your wallet is running, obtain its public key.
  3. Create your Lightning Address:
    Your Lightning Address will be in the format: pubkey...@proxy.tls
  4. Start receiving payments:
    Lightning wallets can now send payments to your address through the proxy.

About the HTTP Proxy

The HTTP proxy is a public service that anyone can run. The source code is available at https://github.com/gzuuus/nutoff-http. This proxy translates between your local nutoff wallet (using contextvm and Nostr) and the expected API interface of a Lightning Address, making your locally wallet instantly reachable and usable through the Lightning Network.

Available Endpoints

GET /.well-known/lnurlp/:username

LNURL-P endpoint for payment requests

GET /lnurlp/callback/:username?amount=:amount

Callback endpoint for invoice generation

GET /health

Health check endpoint

Security & Privacy Model

Your security and privacy are paramount in the Nutoff architecture. The proxy service has no access to your wallet or your nuts. All your funds and sensitive data remain local to your computer - there is no database in the proxy that stores any of your information.

The proxy acts as a simple API adapter: it translates requests from Lightning wallets into the format your local nutoff wallet understands (via Nostr and contextvm), and forwards responses back. It never handles your private keys, sees your balances, or has access to your transaction history.

Your are responsible for your own security and privacy.