feat(1651): code review aligments

Signed-off-by: matevszm <mateusz.marcinkowski@blockydevs.com>

Author: matevszm

docs/output-schemas-guide.md

@@ -541,6 +541,37 @@ Lists all tokens from all networks stored in state.
 }
 ```
 
+#### `token delete`
+
+**Output** (network delete):
+
+```json
+{
+  "transactionId": "0.0.123@1700000000.123456789",
+  "deletedToken": {
+    "name": "MyToken",
+    "tokenId": "0.0.67890"
+  },
+  "network": "testnet",
+  "removedAliases": ["my-token (testnet)"]
+}
+```
+
+**Output** (`--state-only`):
+
+```json
+{
+  "deletedToken": {
+    "name": "MyToken",
+    "tokenId": "0.0.67890"
+  },
+  "network": "testnet",
+  "removedAliases": ["my-token (testnet)"]
+}
+```
+
+`transactionId` is absent for `--state-only`. `removedAliases` is omitted when no aliases exist.
+
 ### Topic Plugin
 
 #### `topic create`

src/plugins/batch/manifest.ts

@@ -103,6 +103,7 @@ export const batchPluginManifest: PluginManifest = {
         'token-create-nft-batch-state',
         'token-create-nft-from-file-batch-state',
         'token-associate-batch-state',
+        'token-delete-batch-state',
       ],
       options: [
         {

src/plugins/token/README.md

@@ -61,7 +61,7 @@ src/plugins/token/
 │   │   ├── output.ts        # Output schema and template
 │   │   └── index.ts         # Command exports
 │   ├── delete/
-│   │   ├── handler.ts       # Token delete handler (local state only)
+│   │   ├── handler.ts       # Token delete handler (network or local state)
 │   │   ├── input.ts         # Input schema
 │   │   ├── output.ts        # Output schema and template
 │   │   └── index.ts         # Command exports
@@ -353,21 +353,30 @@ hcli token transfer-nft \
 
 ### Token Delete
 
-Delete a token from local state. This only removes the token from the local address book, not from the Hedera network.
+Delete a token from the Hedera network and remove it from local state. The token must have an admin key to be deleted from the network.
 
 ```bash
-# Delete by token alias
+# Delete by token alias (network delete)
 hcli token delete --token mytoken-alias
 
-# Delete by token ID
+# Delete by token ID (network delete)
 hcli token delete --token 0.0.123456
+
+# Provide admin key explicitly
+hcli token delete --token 0.0.123456 --admin-key <key-ref>
+
+# Remove from local state only (no network transaction)
+hcli token delete --token mytoken-alias --state-only
 ```
 
 **Parameters:**
 
 - `--token` / `-T`: Token identifier: either a token alias or token-id - **Required**
+- `--admin-key`: Admin key reference for signing (auto-resolved from key manager if omitted) - **Optional**
+- `--key-manager`: Key manager type, defaults to config setting - **Optional**
+- `--state-only`: Remove token from local state only, without a network transaction - **Optional**
 
-Any aliases associated with the token on the current network will also be removed.
+`--state-only` and `--admin-key` are mutually exclusive. Any aliases associated with the token on the current network will also be removed.
 
 ### Token List
 

src/plugins/token/commands/delete/handler.ts

@@ -1,4 +1,4 @@
-import type { CommandHandlerArgs, CommandResult } from '@/core';
+import type { CommandHandlerArgs, CommandResult, CoreApi } from '@/core';
 import type { ResolvedPublicKey } from '@/core/services/key-resolver/types';
 import type {
   KeyManager,
@@ -62,7 +62,12 @@ export class TokenDeleteCommand extends BaseTransactionCommand<
     const tokenState = new ZustandTokenStateHelper(api.state, logger);
 
     const resolvedToken = resolveTokenParameter(validArgs.token, api, network);
-    const tokenId = resolvedToken!.tokenId;
+    if (!resolvedToken) {
+      throw new NotFoundError('Token not found', {
+        context: { token: validArgs.token },
+      });
+    }
+    const tokenId = resolvedToken.tokenId;
     const key = composeKey(network, tokenId);
 
     const tokenInState = tokenState.getToken(key);
@@ -113,7 +118,12 @@ export class TokenDeleteCommand extends BaseTransactionCommand<
     const network = api.network.getCurrentNetwork();
 
     const resolvedToken = resolveTokenParameter(validArgs.token, api, network);
-    const tokenId = resolvedToken!.tokenId;
+    if (!resolvedToken) {
+      throw new NotFoundError('Token not found', {
+        context: { token: validArgs.token },
+      });
+    }
+    const tokenId = resolvedToken.tokenId;
 
     const tokenInfo = await api.mirror.getTokenInfo(tokenId);
 
@@ -147,7 +157,7 @@ export class TokenDeleteCommand extends BaseTransactionCommand<
   }
 
   private async resolveAdminKey(
-    api: CommandHandlerArgs['api'],
+    api: CoreApi,
     validArgs: TokenDeleteInput,
     keyManager: KeyManager,
     tokenAdminPublicKey: string,