nik/nsecbunkerd
1
0
Fork 0
mirror of https://github.com/kind-0/nsecbunkerd.git synced 2026-05-03 07:00:11 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add "Since" column to README tables and mention v0.11.0 tests

Browse Source 
- Added a "Since" column to all command tables in the README to indicate version availability.
- Noted that unit tests for admin commands were introduced in v0.11.0 using Vitest.
This commit is contained in:
tcheeric 2025-11-28 12:40:02 +00:00
parent 241a9c56e8
commit 49a36ca67c
1 changed files with 35 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
README.md
View File

@ -211,23 +211,23 @@ Only npubs listed in the `ADMIN_NPUBS` environment variable can access admin met
### Key Management ### Key Management
| Method | Parameters | Description | | Method | Parameters | Description | Since |
|--------|------------|-------------| |--------|------------|-------------|-------|
| `get_keys` | none | List all keys with their status (locked/unlocked) | | `get_keys` | none | List all keys with their status (locked/unlocked) | |
| `get_key` | `keyName` | Get details about a specific key | | `get_key` | `keyName` | Get details about a specific key | v0.11.0 |
| `create_new_key` | `keyName`, `passphrase`, `[nsec]` | Create a new key or import existing nsec | | `create_new_key` | `keyName`, `passphrase`, `[nsec]` | Create a new key or import existing nsec | |
| `unlock_key` | `keyName`, `passphrase` | Unlock an encrypted key | | `unlock_key` | `keyName`, `passphrase` | Unlock an encrypted key | |
| `delete_key` | `keyName` | Soft-delete a key and its tokens | | `delete_key` | `keyName` | Soft-delete a key and its tokens | v0.11.0 |
| `rotate_key` | `oldKeyName`, `newKeyName`, `passphrase` | Create new key and migrate permissions | | `rotate_key` | `oldKeyName`, `newKeyName`, `passphrase` | Create new key and migrate permissions | v0.11.0 |
### Policy Management ### Policy Management
| Method | Parameters | Description | | Method | Parameters | Description | Since |
|--------|------------|-------------| |--------|------------|-------------|-------|
| `get_policies` | none | List all policies with their rules | | `get_policies` | none | List all policies with their rules | |
| `get_policy` | `policyId` | Get details about a specific policy | | `get_policy` | `policyId` | Get details about a specific policy | v0.11.0 |
| `create_new_policy` | `policyJson` | Create a new policy with rules | | `create_new_policy` | `policyJson` | Create a new policy with rules | |
| `delete_policy` | `policyId` | Soft-delete a policy | | `delete_policy` | `policyId` | Soft-delete a policy | v0.11.0 |
**Policy JSON Format:** **Policy JSON Format:**
```json ```json
@ -243,31 +243,31 @@ Only npubs listed in the `ADMIN_NPUBS` environment variable can access admin met
### Permission Management ### Permission Management
| Method | Parameters | Description | | Method | Parameters | Description | Since |
|--------|------------|-------------| |--------|------------|-------------|-------|
| `get_key_users` | `keyName` | List all users with access to a key | | `get_key_users` | `keyName` | List all users with access to a key | |
| `grant_permission` | `keyName`, `userPubkey`, `policyId`, `[description]` | Grant user access to a key with a policy | | `grant_permission` | `keyName`, `userPubkey`, `policyId`, `[description]` | Grant user access to a key with a policy | v0.11.0 |
| `revoke_permission` | `keyName`, `userPubkey` | Revoke user's access to a key | | `revoke_permission` | `keyName`, `userPubkey` | Revoke user's access to a key | v0.11.0 |
| `get_permissions` | `keyName`, `userPubkey` | Get user's permissions on a key | | `get_permissions` | `keyName`, `userPubkey` | Get user's permissions on a key | v0.11.0 |
| `rename_key_user` | `userPubkey`, `description` | Update a user's description | | `rename_key_user` | `userPubkey`, `description` | Update a user's description | |
| `revoke_user` | `keyUserId` | Revoke user by ID | | `revoke_user` | `keyUserId` | Revoke user by ID | |
### Token Management ### Token Management
| Method | Parameters | Description | | Method | Parameters | Description | Since |
|--------|------------|-------------| |--------|------------|-------------|-------|
| `get_key_tokens` | `keyName` | List all tokens for a key | | `get_key_tokens` | `keyName` | List all tokens for a key | |
| `get_token` | `tokenId` | Get details about a specific token | | `get_token` | `tokenId` | Get details about a specific token | v0.11.0 |
| `create_new_token` | `keyName`, `clientName`, `policyId`, `[durationInHours]` | Create an access token | | `create_new_token` | `keyName`, `clientName`, `policyId`, `[durationInHours]` | Create an access token | |
| `revoke_token` | `tokenId` | Revoke (soft-delete) a token | | `revoke_token` | `tokenId` | Revoke (soft-delete) a token | v0.11.0 |
| `validate_token` | `tokenString` | Check if a token is valid | | `validate_token` | `tokenString` | Check if a token is valid | v0.11.0 |
### Utility ### Utility
| Method | Parameters | Description | | Method | Parameters | Description | Since |
|--------|------------|-------------| |--------|------------|-------------|-------|
| `ping` | none | Health check - returns "pong" | | `ping` | none | Health check - returns "pong" | |
| `create_account` | `[username]`, `[domain]`, `[email]` | Create a new user account (OAuth flow) | | `create_account` | `[username]`, `[domain]`, `[email]` | Create a new user account (OAuth flow) | |
## Response Format ## Response Format
@ -284,6 +284,8 @@ All responses follow NIP-46 format:
### Running Tests ### Running Tests
Unit tests for all admin commands were added in v0.11.0 using Vitest.
```bash ```bash
# Run all tests # Run all tests
npm test npm test