@solana/errors 6.3.1 → 6.3.2-canary-20260313112147

package/dist/cli.mjs

@@ -4,7 +4,7 @@ import { Command, InvalidArgumentError } from 'commander';
 // src/cli.ts
 
 // package.json
-var version = "6.3.1";
+var version = "6.3.2-canary-20260313112147";
 
 // src/context.ts
 function decodeEncodedContext(encodedContext) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solana/errors",
-  "version": "6.3.1",
+  "version": "6.3.2-canary-20260313112147",
   "description": "Throw, identify, and decode Solana JavaScript errors",
   "homepage": "https://www.solanakit.com/api#solanaerrors",
   "exports": {
@@ -33,7 +33,8 @@
   "types": "./dist/types/index.d.ts",
   "type": "commonjs",
   "files": [
-    "./dist/"
+    "./dist/",
+    "./src/"
   ],
   "sideEffects": false,
   "keywords": [

package/src/cli.ts

@@ -0,0 +1,60 @@
+import chalk from 'chalk';
+import { Command, InvalidArgumentError } from 'commander';
+
+import { version } from '../package.json';
+import { SolanaErrorCode } from './codes';
+import { decodeEncodedContext } from './context';
+import { getHumanReadableErrorMessage } from './message-formatter';
+import { SolanaErrorMessages } from './messages';
+
+const program = new Command();
+
+program.name('@solana/errors').description('Decode Solana JavaScript errors thrown in production').version(version);
+
+program
+    .command('decode')
+    .description('Decode a `SolanaErrorCode` to a human-readable message')
+    .argument('<code>', 'numeric error code to decode', rawCode => {
+        const code = parseInt(rawCode, 10);
+        if (isNaN(code) || `${code}` !== rawCode) {
+            throw new InvalidArgumentError('It must be an integer');
+        }
+        if (!(code in SolanaErrorMessages)) {
+            throw new InvalidArgumentError('There exists no error with that code');
+        }
+        return code;
+    })
+    .argument('[encodedContext]', 'encoded context to interpolate into the error message', encodedContext => {
+        try {
+            return decodeEncodedContext(encodedContext);
+        } catch {
+            throw new InvalidArgumentError('Encoded context malformed');
+        }
+    })
+    .action((code: number, context: object) => {
+        const message = getHumanReadableErrorMessage(code as SolanaErrorCode, context);
+        console.log(`
+${
+    chalk.bold(
+        chalk.rgb(154, 71, 255)('[') +
+            chalk.rgb(144, 108, 244)('D') +
+            chalk.rgb(134, 135, 233)('e') +
+            chalk.rgb(122, 158, 221)('c') +
+            chalk.rgb(110, 178, 209)('o') +
+            chalk.rgb(95, 195, 196)('d') +
+            chalk.rgb(79, 212, 181)('e') +
+            chalk.rgb(57, 227, 166)('d') +
+            chalk.rgb(19, 241, 149)(']'),
+    ) + chalk.rgb(19, 241, 149)(' Solana error code #' + code)
+}
+    - ${message}`);
+        if (context) {
+            console.log(`
+${chalk.yellowBright(chalk.bold('[Context]'))}
+    ${JSON.stringify(context, null, 4).split('\n').join('\n    ')}`);
+        }
+    });
+
+export function run(argv: readonly string[]) {
+    program.parse(argv);
+}