Update: Add installation guide, change to AGPL, emphasize did:nostr and Solid

- Add comprehensive installation instructions to test page
- Change license from MIT to AGPL-3.0
- Update all descriptions to emphasize did:nostr and Solid authentication
- Add did:nostr specification link throughout
- Update popup UI to mention did:nostr and Solid

Author: melvincarvalho

LICENSE

@@ -1,21 +1,17 @@
-MIT License
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
 
-Copyright (c) 2026 JavaScriptSolidServer
+Copyright (C) 2026 JavaScriptSolidServer
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

README.md

@@ -1,13 +1,13 @@
 # 🔑 Podkey
 
-> World-class Nostr wallet extension with Solid superpowers
+> Browser extension for **did:nostr** and **Solid** authentication
 
 [![Version](https://img.shields.io/badge/version-0.0.4-blue.svg)](https://github.com/JavaScriptSolidServer/podkey/releases)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-AGPL--3.0-green.svg)](LICENSE)
 [![NIP-07](https://img.shields.io/badge/NIP--07-compatible-purple.svg)](https://github.com/nostr-protocol/nips/blob/master/07.md)
 [![Test Page](https://img.shields.io/badge/test--page-live-brightgreen)](https://javascriptsolidserver.github.io/podkey/test-page/)
 
-**Podkey** is a beautiful, secure Nostr wallet browser extension that goes beyond basic key management. Built specifically for the Solid ecosystem, it provides seamless authentication to Solid pods while remaining fully compatible with the broader Nostr ecosystem.
+**Podkey** is a beautiful, secure browser extension for **did:nostr** and **Solid** authentication. It provides a NIP-07-compatible Nostr wallet that enables seamless authentication to Solid pods using [did:nostr](https://nostrcg.github.io/did-nostr/) identities, while remaining fully compatible with the broader Nostr ecosystem.
 
 ## ✨ What Makes Podkey Different
 
@@ -19,12 +19,12 @@
 - 📊 **Trust management** with per-origin permissions
 - 🌈 **Delightful user experience** with intuitive design
 
-### Solid Superpowers
+### did:nostr & Solid Superpowers
 
-- **Zero-redirect authentication** to Solid servers
-- **Automatic signing** for trusted pods
-- **did:nostr identity** integration
-- **WebID linking** (coming soon)
+- **did:nostr identity** - Full support for [did:nostr](https://nostrcg.github.io/did-nostr/) decentralized identifiers
+- **Solid authentication** - Zero-redirect authentication to Solid servers using did:nostr
+- **Automatic signing** - Automatic signing for trusted Solid pods
+- **WebID linking** - Link did:nostr identities to Solid WebIDs (coming soon)
 
 ## 🚀 Quick Start
 
@@ -223,7 +223,7 @@ npm test
 
 ## 🔐 did:nostr Identity
 
-Podkey ensures all public keys are proper 64-character hexadecimal strings, making them compatible with the [did:nostr](https://github.com/w3c-ccg/did-method-nostr) specification:
+Podkey is built for **did:nostr** and **Solid** authentication. All public keys are proper 64-character hexadecimal strings, making them fully compatible with the [did:nostr specification](https://nostrcg.github.io/did-nostr/):
 
 ```javascript
 const pubkey = await window.nostr.getPublicKey()
@@ -233,9 +233,10 @@ const did = `did:nostr:${pubkey}`
 
 This enables:
 
-- ✅ Decentralized identity
+- ✅ **did:nostr** decentralized identifiers per [W3C specification](https://nostrcg.github.io/did-nostr/)
+- ✅ **Solid pod authentication** using did:nostr identities
 - ✅ Cross-platform identity portability
-- ✅ Solid pod authentication (future)
+- ✅ Verifiable credentials and authentication
 
 ## 📖 API Reference
 
@@ -320,7 +321,7 @@ We love contributions! Here's how to get started:
 
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) for details
+AGPL-3.0 License - see [LICENSE](LICENSE) for details
 
 ## 🙏 Acknowledgments
 
@@ -334,8 +335,10 @@ MIT License - see [LICENSE](LICENSE) for details
 - **GitHub**: https://github.com/JavaScriptSolidServer/podkey
 - **Issues**: https://github.com/JavaScriptSolidServer/podkey/issues
 - **Test Page**: https://javascriptsolidserver.github.io/podkey/test-page/
+- **did:nostr Specification**: https://nostrcg.github.io/did-nostr/
 - **NIP-07 Spec**: https://github.com/nostr-protocol/nips/blob/master/07.md
 - **NIP-98 Spec**: https://github.com/nostr-protocol/nips/blob/master/98.md
+- **Solid Project**: https://solidproject.org/
 
 ---
 

USAGE.md

@@ -1,5 +1,7 @@
 # 🚀 How to Use Podkey
 
+**Podkey** is a browser extension for **did:nostr** and **Solid** authentication. It provides NIP-07-compatible Nostr wallet functionality with seamless Solid pod authentication using [did:nostr](https://nostrcg.github.io/did-nostr/) identities.
+
 ## Quick Start Guide
 
 ### Step 1: Install Dependencies

manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Podkey",
   "version": "0.0.4",
-  "description": "World-class Nostr wallet with Solid superpowers - your keys, your identity, your data",
+  "description": "did:nostr and Solid authentication extension - NIP-07 wallet for decentralized identity",
   "permissions": [
     "storage",
     "webRequest"

package.json

@@ -1,7 +1,7 @@
 {
   "name": "podkey",
   "version": "0.0.4",
-  "description": "World-class Nostr wallet extension with Solid superpowers - NIP-07 provider + auto-authentication",
+  "description": "did:nostr and Solid authentication extension - NIP-07 provider for decentralized identity",
   "main": "src/index.js",
   "type": "module",
   "scripts": {
@@ -24,7 +24,7 @@
     "pod"
   ],
   "author": "JavaScriptSolidServer",
-  "license": "MIT",
+  "license": "AGPL-3.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/JavaScriptSolidServer/podkey.git"

popup/popup.html

@@ -12,7 +12,7 @@
     <div class="header">
       <div class="logo">🔑</div>
       <h1>Welcome to Podkey</h1>
-      <p class="subtitle">Your Nostr identity for the decentralized web</p>
+      <p class="subtitle">did:nostr and Solid authentication for the decentralized web</p>
     </div>
 
     <div class="section">
@@ -26,7 +26,7 @@ <h1>Welcome to Podkey</h1>
 
     <div class="info-box">
       <p><strong>What is Podkey?</strong></p>
-      <p>A world-class Nostr wallet with Solid superpowers. Store your cryptographic identity and authenticate seamlessly to Solid pods.</p>
+      <p>A browser extension for <strong>did:nostr</strong> and <strong>Solid</strong> authentication. Store your cryptographic identity and authenticate seamlessly to Solid pods using did:nostr identities.</p>
     </div>
   </div>
 

test-page/index.html

@@ -219,6 +219,52 @@
       <div class="header">
         <h1>🔑 Podkey Test Page</h1>
         <p>Real-time diagnostics for NIP-07 extension testing</p>
+        <p style="margin-top: 12px; font-size: 13px; color: #64748b;">
+          Extension for <strong>did:nostr</strong> and <strong>Solid</strong> authentication
+        </p>
+      </div>
+
+      <div class="status-card" id="installationCard" style="display: none;">
+        <h2>📦 Installation Instructions</h2>
+        <div style="line-height: 1.8; font-size: 14px;">
+          <p><strong>Don't have Podkey installed yet?</strong></p>
+          <ol style="margin-left: 20px; margin-top: 12px;">
+            <li style="margin-bottom: 8px;">
+              <strong>Clone the repository:</strong><br>
+              <code style="background: #f1f5f9; padding: 4px 8px; border-radius: 4px; font-size: 12px;">
+                git clone https://github.com/JavaScriptSolidServer/podkey.git
+              </code>
+            </li>
+            <li style="margin-bottom: 8px;">
+              <strong>Install dependencies:</strong><br>
+              <code style="background: #f1f5f9; padding: 4px 8px; border-radius: 4px; font-size: 12px;">
+                cd podkey && npm install
+              </code>
+            </li>
+            <li style="margin-bottom: 8px;">
+              <strong>Build the extension:</strong><br>
+              <code style="background: #f1f5f9; padding: 4px 8px; border-radius: 4px; font-size: 12px;">
+                npm run build
+              </code>
+            </li>
+            <li style="margin-bottom: 8px;">
+              <strong>Load in Chrome:</strong>
+              <ul style="margin-left: 20px; margin-top: 4px;">
+                <li>Open <code style="background: #f1f5f9; padding: 2px 6px; border-radius: 4px; font-size: 11px;">chrome://extensions/</code></li>
+                <li>Enable <strong>"Developer mode"</strong> (top-right toggle)</li>
+                <li>Click <strong>"Load unpacked"</strong></li>
+                <li>Select the <code style="background: #f1f5f9; padding: 2px 6px; border-radius: 4px; font-size: 11px;">podkey</code> directory</li>
+              </ul>
+            </li>
+            <li>
+              <strong>Reload this page</strong> and the extension should be detected!
+            </li>
+          </ol>
+          <p style="margin-top: 16px; padding: 12px; background: #fef3c7; border-radius: 8px; border: 1px solid #fbbf24;">
+            <strong>💡 Tip:</strong> Podkey is an extension for <strong>did:nostr</strong> and <strong>Solid</strong> authentication. 
+            Learn more at <a href="https://nostrcg.github.io/did-nostr/" target="_blank" style="color: #7c3aed; font-weight: 600;">did-nostr specification</a>
+          </p>
+        </div>
       </div>
 
       <div class="status-card">
@@ -338,14 +384,16 @@ <h2>📊 Event Log</h2>
       function updateExtensionStatus() {
         const statusEl = document.getElementById('extensionStatus')
         const infoEl = document.getElementById('extensionInfo')
+        const installCard = document.getElementById('installationCard')
 
         if (typeof window.nostr !== 'undefined') {
           statusEl.className = 'status-indicator active'
+          installCard.style.display = 'none'
           infoEl.innerHTML = `
           <strong>✅ Podkey Extension Detected</strong>
           <span class="badge badge-success">Active</span>
           <div style="margin-top: 8px; font-size: 12px; color: #64748b;">
-            window.nostr is available
+            window.nostr is available for <strong>did:nostr</strong> and <strong>Solid</strong> authentication
           </div>
         `
           log(
@@ -354,11 +402,12 @@ <h2>📊 Event Log</h2>
           )
         } else {
           statusEl.className = 'status-indicator error'
+          installCard.style.display = 'block'
           infoEl.innerHTML = `
           <strong>❌ Podkey Extension Not Found</strong>
           <span class="badge badge-error">Not Installed</span>
           <div style="margin-top: 8px; font-size: 12px; color: #64748b;">
-            window.nostr is undefined. Make sure the extension is installed and enabled.
+            window.nostr is undefined. Install the extension for <strong>did:nostr</strong> and <strong>Solid</strong> support.
           </div>
         `
           log('Podkey extension not found - window.nostr is undefined', 'error')