{"id":15817066,"url":"https://github.com/riccardobl/nostrduino","last_synced_at":"2025-09-04T23:32:14.424Z","repository":{"id":247207148,"uuid":"824257012","full_name":"riccardobl/nostrduino","owner":"riccardobl","description":"A nostr-tools inspired library for Arduino (and other) microcontrollers. With NWC support","archived":false,"fork":false,"pushed_at":"2025-04-06T21:10:23.000Z","size":996,"stargazers_count":10,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-28T01:08:30.021Z","etag":null,"topics":["arduino","bitcoin","esp32","lightning","nostr","nwc"],"latest_commit_sha":null,"homepage":"http://rblb.it/nostrduino/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/riccardobl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-04T17:42:38.000Z","updated_at":"2025-08-15T13:58:44.000Z","dependencies_parsed_at":"2024-07-30T17:14:36.694Z","dependency_job_id":"80312f5b-853e-433d-ad28-4f3a312e0cbb","html_url":"https://github.com/riccardobl/nostrduino","commit_stats":null,"previous_names":["riccardobl/nostrduino"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/riccardobl/nostrduino","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riccardobl%2Fnostrduino","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riccardobl%2Fnostrduino/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riccardobl%2Fnostrduino/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riccardobl%2Fnostrduino/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/riccardobl","download_url":"https://codeload.github.com/riccardobl/nostrduino/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/riccardobl%2Fnostrduino/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273688219,"owners_count":25150285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","bitcoin","esp32","lightning","nostr","nwc"],"created_at":"2024-10-05T05:21:57.498Z","updated_at":"2025-09-04T23:32:09.405Z","avatar_url":"https://github.com/riccardobl.png","language":"C++","funding_links":[],"categories":["NWC Developer Tools \u0026 Libraries"],"sub_categories":["Shopping"],"readme":"# Nostrduino\n\nA [nostr-tools](https://github.com/nbd-wtf/nostr-tools) inspired library for Arduino (and others).\n\nThis was created using [arduino-nostr](https://github.com/lnbits/arduino-nostr) as starting point, most of the code was rewritten and the library was expanded to include more features.\n\n## Compatibility \nThis library is compatible with esp32 based boards out of the box.\nBut it can be ported to other boards by reimplementing the platform specific code in the `src/esp32`.\n\n## Features\n\n+ [Nip01](https://github.com/nostr-protocol/nips/blob/master/01.md) : Basic protocol flow\n+ [Nip04](https://github.com/nostr-protocol/nips/blob/master/04.md) : Encrypted messages\n+ [Nip47](https://github.com/nostr-protocol/nips/blob/master/47.md) : Nostr Wallet Connect\n+ [(bonus) Lightning Address](https://lightningaddress.com/) : Can request invoices from lightning addresses\n+ [NWC managed service](src/services/NWC.h) : A managed service to interact with NWC \n\n\n## Philosophy\nThis library is built with a DIY philosophy in mind, similar to nostr-tools, this library provides helpers to create, sign and verify messages and to use some of the NIPs features (see the `src/Nip*` files).\n\nIn addition to that, the library provides some \"managed\" services (in `src/services` folder) that you can use in your sketches without worrying about the details and complexity of the nostr protocol.\n\n## Installation\n\nCheck the [platformio registry page](https://registry.platformio.org/libraries/rblb/Nostrduino/installation) for instructions.\n\n### ESP32 dependencies\nThis library depends on the following additional libraries for the esp32 platform:\n- WebSockets@^2.4.1\n\n\n## Usage\nSee the example scripts in `examples/` for simple examples of how to use this library.\n\n\n## Development\n### Setting up the build environment\n\n```bash\n# create venv\npython3 -m venv venv\n# activate venv\nsource venv/bin/activate\n# install platformio\npip install platformio\n```\n\n\n\n### Compiling Tests\n\n#### Test NIP01\nEdit `examples/ESP32TestNip01/ESP32TestNip01.cpp` and set the `WIFI_SSID`,  `WIFI_PASS` and `WIFI_CHANNEL`.\n\nThen compile with:\n```\npio run -e ESP32TestNip01\n```\n\n\n### Test NIP04\n\nCompile with:\n```\npio run -e ESP32TestNip04\n```\n\n\n### Test NWC\nEdit `examples/ESP32TestNWC/ESP32TestNWC.cpp` and set the `WIFI_SSID`,  `WIFI_PASS` , `WIFI_CHANNEL` and `NWC_URL`.\nNB: you can get a nwc url from [https://nwc.getalby.com/](https://nwc.getalby.com/) or [https://app.mutinywallet.com/settings/connections](https://app.mutinywallet.com/settings/connections).\n\nThen compile with:\n```\npio run -e ESP32TestNWC\n```\n\n### Running tests\nYou can upload the compiled tests to your ESP32 with:\n```\npio run -e TEST_NAME -t upload\n```\n\nor use an emulator like [wokwi](https://wokwi.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friccardobl%2Fnostrduino","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Friccardobl%2Fnostrduino","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Friccardobl%2Fnostrduino/lists"}