npm - @solana/errors - Versions diffs - 2.0.0-experimental.021706b - Mend

@solana/errors 2.0.0-experimental.021706b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (27) hide show

package/LICENSE +20 -0
package/README.md +90 -0
package/bin/cli.js +7 -0
package/dist/cli.js +72 -0
package/dist/index.browser.cjs +113 -0
package/dist/index.browser.cjs.map +1 -0
package/dist/index.browser.js +103 -0
package/dist/index.browser.js.map +1 -0
package/dist/index.native.js +103 -0
package/dist/index.native.js.map +1 -0
package/dist/index.node.cjs +113 -0
package/dist/index.node.cjs.map +1 -0
package/dist/index.node.js +103 -0
package/dist/index.node.js.map +1 -0
package/dist/types/codes.d.ts +32 -0
package/dist/types/codes.d.ts.map +1 -0
package/dist/types/context.d.ts +39 -0
package/dist/types/context.d.ts.map +1 -0
package/dist/types/error.d.ts +14 -0
package/dist/types/error.d.ts.map +1 -0
package/dist/types/index.d.ts +3 -0
package/dist/types/index.d.ts.map +1 -0
package/dist/types/message-formatter.d.ts +4 -0
package/dist/types/message-formatter.d.ts.map +1 -0
package/dist/types/messages.d.ts +12 -0
package/dist/types/messages.d.ts.map +1 -0
package/package.json +80 -0

package/LICENSE ADDED Viewed

@@ -0,0 +1,20 @@
+Copyright (c) 2023 Solana Labs, Inc
+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:
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+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.

package/README.md ADDED Viewed

@@ -0,0 +1,90 @@
+[![npm][npm-image]][npm-url]
+[![npm-downloads][npm-downloads-image]][npm-url]
+[![semantic-release][semantic-release-image]][semantic-release-url]
+<br />
+[![code-style-prettier][code-style-prettier-image]][code-style-prettier-url]
+[code-style-prettier-image]: https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square
+[code-style-prettier-url]: https://github.com/prettier/prettier
+[npm-downloads-image]: https://img.shields.io/npm/dm/@solana/errors/experimental.svg?style=flat
+[npm-image]: https://img.shields.io/npm/v/@solana/errors/experimental.svg?style=flat
+[npm-url]: https://www.npmjs.com/package/@solana/errors/v/experimental
+[semantic-release-image]: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+[semantic-release-url]: https://github.com/semantic-release/semantic-release
+# @solana/errors
+This package brings together every error message across all Solana JavaScript modules.
+## Reading error messages
+### In development mode
+When your bundler sets the constant `__DEV__` to `true`, every error message will be included in the bundle. As such, you will be able to read them in plain language wherever they appear.
+> [!WARNING]
+> The size of your JavaScript bundle will increase significantly with the inclusion of every error message in development mode. Be sure to build your bundle with `__DEV__` set to `false` when you go to production.
+### In production mode
+When your bundler sets the constant `__DEV__` to `false`, error messages will be stripped from the bundle to save space. Only the error code will appear when an error is encountered. Follow the instructions in the error message to convert the error code back to the human-readable error message.
+For instance, to recover the error text for the error with code `123`:
+```shell
+npx @solana/errors decode 123
+```
+## Adding a new error
+1. Add a new exported error code constant to `src/codes.ts`.
+2. Add that new constant to the `SolanaErrorCode` union in `src/codes.ts`.
+3. If you would like the new error to encapsulate context about the error itself (eg. the public keys for which a transaction is missing signatures) define the shape of that context in `src/details.ts`.
+4. Add the error's message to `src/messages.ts`. Any context values that you defined above will be interpolated into the message wherever you write `$key`, where `key` is the index of a value in the context (eg. ``'Missing a signature for account `$address`'``).
+5. Publish a new version of `@solana/errors`.
+6. Bump the version of `@solana/errors` in the package from which the error is thrown.
+## Removing an error message
+-   Don't remove errors.
+-   Don't change the meaning of an error message.
+-   Don't change or reorder error codes.
+-   Don't change or remove members of an error's context.
+When an older client throws an error, we want to make sure that they can always decode the error. If you make any of the changes above, old clients will, by definition, not have received your changes. This could make the errors that they throw impossible to decode going forward.
+## Catching errors
+When you catch a `SolanaError` and assert its error code using `isSolanaError()`, TypeScript will refine the error's context to the type associated with that error code. You can use that context to render useful error messages, or to make context-aware decisions that help your application to recover from the error.
+```ts
+import {
+    SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURE,
+    SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE,
+    isSolanaError,
+} from '@solana/errors';
+import { assertTransactionIsFullySigned, getSignatureFromTransaction } from '@solana/transactions';
+try {
+    const transactionSignature = getSignatureFromTransaction(tx);
+    assertTransactionIsFullySigned(tx);
+    /* ... */
+} catch (e) {
+    if (isSolanaError(e, SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES)) {
+        displayError(
+            "We can't send this transaction without signatures for these addresses:\n- %s",
+            // The type of the `context` object is now refined to contain `addresses`.
+            e.context.addresses.join('\n- '),
+        );
+        return;
+    } else if (isSolanaError(e, SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE)) {
+        if (!tx.feePayer) {
+            displayError('Choose a fee payer for this transaction before sending it');
+        } else {
+            displayError('The fee payer still needs to sign for this transaction');
+        }
+        return;
+    }
+    throw e;
+}
+```

package/bin/cli.js ADDED Viewed

@@ -0,0 +1,7 @@
+#!/usr/bin/env -S node
+import process from 'node:process';
+import { run } from '../dist/cli.js';
+run(process.argv);

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,72 @@
+// src/cli.ts
+import chalk from "chalk";
+import { Command, InvalidArgumentError } from "commander";
+// package.json
+var version = "2.0.0-development";
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+// src/cli.ts
+var 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) => Object.fromEntries(new URLSearchParams(encodedContext).entries())
+).action((code, context) => {
+  const message = getHumanReadableErrorMessage(code, 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    ")}`);
+  }
+});
+function run(argv) {
+  program.parse(argv);
+}
+export {
+  run
+};

package/dist/index.browser.cjs ADDED Viewed

@@ -0,0 +1,113 @@
+'use strict';
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function encodeValue(value) {
+  if (Array.isArray(value)) {
+    return (
+      /* "[" */
+      "%5B" + value.map(
+        (element) => typeof element === "string" ? encodeURIComponent(`"${element.replace(/"/g, '\\"')}"`) : encodeValue(element)
+      ).join(
+        /* ", " */
+        "%2C%20"
+      ) + /* "]" */
+      "%5D"
+    );
+  } else if (typeof value === "bigint") {
+    return `${value}n`;
+  } else {
+    return encodeURIComponent(
+      String(
+        Object.getPrototypeOf(value) === null ? (
+          // Plain objects with no protoype don't have a `toString` method.
+          // Convert them before stringifying them.
+          { ...value }
+        ) : value
+      )
+    );
+  }
+}
+function encodeObjectContextEntry([key, value]) {
+  return `${key}=${encodeValue(value)}`;
+}
+function encodeContextObject(context) {
+  return Object.entries(context).map(encodeObjectContextEntry).join("&");
+}
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+function getErrorMessage(code, context = {}) {
+  if (__DEV__) {
+    return getHumanReadableErrorMessage(code, context);
+  } else {
+    let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \`npx @solana/errors decode ${code}`;
+    if (Object.keys(context).length) {
+      decodingAdviceMessage += ` $"${encodeContextObject(context)}"`;
+    }
+    return `${decodingAdviceMessage}\``;
+  }
+}
+// src/error.ts
+function isSolanaError(e, code) {
+  const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
+  if (isSolanaError2) {
+    if (code !== void 0) {
+      return e.context.__code === code;
+    }
+    return true;
+  }
+  return false;
+}
+var SolanaError = class extends Error {
+  context;
+  constructor(...[code, context]) {
+    const message = getErrorMessage(code, context);
+    super(message);
+    this.context = {
+      __code: code,
+      ...context
+    };
+    this.name = "SolanaError";
+  }
+};
+exports.SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED;
+exports.SOLANA_ERROR__INVALID_KEYPAIR_BYTES = SOLANA_ERROR__INVALID_KEYPAIR_BYTES;
+exports.SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND;
+exports.SOLANA_ERROR__NONCE_INVALID = SOLANA_ERROR__NONCE_INVALID;
+exports.SOLANA_ERROR__RPC_INTEGER_OVERFLOW = SOLANA_ERROR__RPC_INTEGER_OVERFLOW;
+exports.SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES;
+exports.SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE;
+exports.SolanaError = SolanaError;
+exports.isSolanaError = isSolanaError;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.browser.cjs.map

package/dist/index.browser.cjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../../build-scripts/env-shim.ts","../src/codes.ts","../src/messages.ts","../src/message-formatter.ts","../src/error.ts"],"names":["isSolanaError"],"mappings":";AACO,IAAM,UAA2B,uBAAO,QAAgB,KAAU,EAAE,aAAa,eAAe;;;ACOhG,IAAM,+CAA+C;AACrD,IAAM,qDAAqD;AAC3D,IAAM,qCAAqC;AAC3C,IAAM,sCAAsC;AAC5C,IAAM,sCAAsC;AAC5C,IAAM,8BAA8B;AACpC,IAAM,wCAAwC;;;ACI9C,IAAM,sBAIR;AAAA,EACD,CAAC,mCAAmC,GAChC;AAAA,EACJ,CAAC,mCAAmC,GAAG;AAAA,EACvC,CAAC,qCAAqC,GAAG;AAAA,EACzC,CAAC,2BAA2B,GACxB;AAAA,EACJ,CAAC,kCAAkC,GAC/B;AAAA,EAGJ,CAAC,4CAA4C,GAAG;AAAA,EAChD,CAAC,kDAAkD,GAC/C;AAER;;;AClCA,SAAS,YAAY,OAAwB;AACzC,MAAI,MAAM,QAAQ,KAAK,GAAG;AACtB;AAAA;AAAA,MACc,QACV,MACK;AAAA,QAAI,aACD,OAAO,YAAY,WACb,mBAAmB,IAAI,QAAQ,QAAQ,MAAM,KAAK,CAAC,GAAG,IACtD,YAAY,OAAO;AAAA,MAC7B,EACC;AAAA;AAAA,QAAgB;AAAA,MAAQ;AAAA,MACnB;AAAA;AAAA,EAElB,WAAW,OAAO,UAAU,UAAU;AAClC,WAAO,GAAG,KAAK;AAAA,EACnB,OAAO;AACH,WAAO;AAAA,MACH;AAAA,QACI,OAAO,eAAe,KAAK,MAAM;AAAA;AAAA;AAAA,UAG3B,EAAE,GAAI,MAAiB;AAAA,YACvB;AAAA,MACV;AAAA,IACJ;AAAA,EACJ;AACJ;AAEA,SAAS,yBAAyB,CAAC,KAAK,KAAK,GAAiD;AAC1F,SAAO,GAAG,GAAG,IAAI,YAAY,KAAK,CAAC;AACvC;AAEA,SAAS,oBAAoB,SAAiB;AAC1C,SAAO,OAAO,QAAQ,OAAO,EAAE,IAAI,wBAAwB,EAAE,KAAK,GAAG;AACzE;AAEO,SAAS,6BACZ,MACA,UAAkB,CAAC,GACb;AACN,QAAM,sBAAsB,oBAAoB,IAAI;AACpD,QAAM,UAAU,oBAAoB;AAAA,IAAQ;AAAA,IAAmB,CAAC,WAAW,iBACvE,gBAAgB,UAAU,GAAG,QAAQ,YAAoC,CAAC,KAAK;AAAA,EACnF;AACA,SAAO;AACX;AAEO,SAAS,gBAAoD,MAAkB,UAAkB,CAAC,GAAW;AAChH,MAAI,SAAS;AACT,WAAO,6BAA6B,MAAM,OAAO;AAAA,EACrD,OAAO;AACH,QAAI,wBAAwB,iBAAiB,IAAI,8DAA8D,IAAI;AACnH,QAAI,OAAO,KAAK,OAAO,EAAE,QAAQ;AAM7B,+BAAyB,MAAM,oBAAoB,OAAO,CAAC;AAAA,IAC/D;AACA,WAAO,GAAG,qBAAqB;AAAA,EACnC;AACJ;;;AC7DO,SAAS,cACZ,GACA,MAC4B;AAC5B,QAAMA,iBAAgB,aAAa,SAAS,EAAE,SAAS;AACvD,MAAIA,gBAAe;AACf,QAAI,SAAS,QAAW;AACpB,aAAQ,EAA8B,QAAQ,WAAW;AAAA,IAC7D;AACA,WAAO;AAAA,EACX;AACA,SAAO;AACX;AAQO,IAAM,cAAN,cAAgF,MAAM;AAAA,EAChF;AAAA,EACT,eACO,CAAC,MAAM,OAAO,GAGnB;AACE,UAAM,UAAU,gBAAgB,MAAM,OAAO;AAC7C,UAAM,OAAO;AACb,SAAK,UAAU;AAAA,MACX,QAAQ;AAAA,MACR,GAAG;AAAA,IACP;AAGA,SAAK,OAAO;AAAA,EAChB;AACJ","sourcesContent":["// Clever obfuscation to prevent the build system from inlining the value of `NODE_ENV`\nexport const __DEV__ = /* @__PURE__ */ (() => (process as any)['en' + 'v'].NODE_ENV === 'development')();\n","/**\n * To add a new error, follow the instructions at\n * https://github.com/solana-labs/solana-web3.js/tree/master/packages/error#adding-a-new-error\n *\n * WARNING:\n * - Don't remove error codes\n * - Don't change or reorder error codes.\n */\nexport const SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1 as const;\nexport const SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2 as const;\nexport const SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3 as const;\nexport const SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4 as const;\nexport const SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5 as const;\nexport const SOLANA_ERROR__NONCE_INVALID = 6 as const;\nexport const SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7 as const;\n\n/**\n * A union of every Solana error code\n *\n * You might be wondering why this is not a TypeScript enum or const enum.\n *\n * One of the goals of this library is to enable people to use some or none of it without having to\n * bundle all of it.\n *\n * If we made the set of error codes an enum then anyone who imported it (even if to only use a\n * single error code) would be forced to bundle every code and its label.\n *\n * Const enums appear to solve this problem by letting the compiler inline only the codes that are\n * actually used. Unfortunately exporting ambient (const) enums from a library like `@solana/errors`\n * is not safe, for a variety of reasons covered here: https://stackoverflow.com/a/28818850\n */\nexport type SolanaErrorCode =\n | typeof SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES\n | typeof SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE\n | typeof SOLANA_ERROR__RPC_INTEGER_OVERFLOW\n | typeof SOLANA_ERROR__INVALID_KEYPAIR_BYTES\n | typeof SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED\n | typeof SOLANA_ERROR__NONCE_INVALID\n | typeof SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND;\n","import {\n SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED,\n SOLANA_ERROR__INVALID_KEYPAIR_BYTES,\n SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND,\n SOLANA_ERROR__NONCE_INVALID,\n SOLANA_ERROR__RPC_INTEGER_OVERFLOW,\n SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES,\n SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE,\n SolanaErrorCode,\n} from './codes';\n\n/**\n * To add a new error, follow the instructions at\n * https://github.com/solana-labs/solana-web3.js/tree/master/packages/error#adding-a-new-error\n *\n * WARNING:\n * - Don't change the meaning of an error message.\n */\nexport const SolanaErrorMessages: Readonly<{\n // This type makes this data structure exhaustive with respect to `SolanaErrorCode`.\n // TypeScript will fail to build this project if add an error code without a message.\n [P in SolanaErrorCode]: string;\n}> = {\n [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]:\n 'The network has progressed past the last block for which this transaction could have been committed.',\n [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: 'Key pair bytes must be of length 64, got $byteLength.',\n [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: 'No nonce account could be found at address `$nonceAccountAddress`',\n [SOLANA_ERROR__NONCE_INVALID]:\n 'The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`',\n [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]:\n 'The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was ' +\n '`$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds ' +\n '`Number.MAX_SAFE_INTEGER`.',\n [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: 'Transaction is missing signatures for addresses: $addresses.',\n [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]:\n \"Could not determine this transaction's signature. Make sure that the transaction has \" +\n 'been signed by its fee payer.',\n};\n","import { SolanaErrorCode } from './codes';\nimport { SolanaErrorMessages } from './messages';\n\nfunction encodeValue(value: unknown): string {\n if (Array.isArray(value)) {\n return (\n /* \"[\" */ '%5B' +\n value\n .map(element =>\n typeof element === 'string'\n ? encodeURIComponent(`\"${element.replace(/\"/g, '\\\\\"')}\"`)\n : encodeValue(element),\n )\n .join(/* \", \" */ '%2C%20') +\n /* \"]\" */ '%5D'\n );\n } else if (typeof value === 'bigint') {\n return `${value}n`;\n } else {\n return encodeURIComponent(\n String(\n Object.getPrototypeOf(value) === null\n ? // Plain objects with no protoype don't have a `toString` method.\n // Convert them before stringifying them.\n { ...(value as object) }\n : value,\n ),\n );\n }\n}\n\nfunction encodeObjectContextEntry([key, value]: [string, unknown]): `${typeof key}=${string}` {\n return `${key}=${encodeValue(value)}`;\n}\n\nfunction encodeContextObject(context: object) {\n return Object.entries(context).map(encodeObjectContextEntry).join('&');\n}\n\nexport function getHumanReadableErrorMessage<TErrorCode extends SolanaErrorCode>(\n code: TErrorCode,\n context: object = {},\n): string {\n const messageFormatString = SolanaErrorMessages[code];\n const message = messageFormatString.replace(/(?<!\\\\)\\$(\\w+)/g, (substring, variableName) =>\n variableName in context ? `${context[variableName as keyof typeof context]}` : substring,\n );\n return message;\n}\n\nexport function getErrorMessage<TErrorCode extends SolanaErrorCode>(code: TErrorCode, context: object = {}): string {\n if (__DEV__) {\n return getHumanReadableErrorMessage(code, context);\n } else {\n let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \\`npx @solana/errors decode ${code}`;\n if (Object.keys(context).length) {\n /**\n * DANGER: Be sure that the shell command is escaped in such a way that makes it\n * impossible for someone to craft malicious context values that would result in\n * an exploit against anyone who bindly copy/pastes it into their terminal.\n */\n decodingAdviceMessage += ` $\"${encodeContextObject(context)}\"`;\n }\n return `${decodingAdviceMessage}\\``;\n }\n}\n","import { SolanaErrorCode } from './codes';\nimport { SolanaErrorContext } from './context';\nimport { getErrorMessage } from './message-formatter';\n\nexport function isSolanaError<TErrorCode extends SolanaErrorCode>(\n e: unknown,\n code?: TErrorCode,\n): e is SolanaError<TErrorCode> {\n const isSolanaError = e instanceof Error && e.name === 'SolanaError';\n if (isSolanaError) {\n if (code !== undefined) {\n return (e as SolanaError<TErrorCode>).context.__code === code;\n }\n return true;\n }\n return false;\n}\n\ntype SolanaErrorCodedContext = Readonly<{\n [P in SolanaErrorCode]: (SolanaErrorContext[P] extends undefined ? object : SolanaErrorContext[P]) & {\n __code: P;\n };\n}>;\n\nexport class SolanaError<TErrorCode extends SolanaErrorCode = SolanaErrorCode> extends Error {\n readonly context: SolanaErrorCodedContext[TErrorCode];\n constructor(\n ...[code, context]: SolanaErrorContext[TErrorCode] extends undefined\n ? [code: TErrorCode]\n : [code: TErrorCode, context: SolanaErrorContext[TErrorCode]]\n ) {\n const message = getErrorMessage(code, context);\n super(message);\n this.context = {\n __code: code,\n ...context,\n } as SolanaErrorCodedContext[TErrorCode];\n // This is necessary so that `isSolanaError()` can identify a `SolanaError` without having\n // to import the class for use in an `instanceof` check.\n this.name = 'SolanaError';\n }\n}\n"]}

package/dist/index.browser.js ADDED Viewed

@@ -0,0 +1,103 @@
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function encodeValue(value) {
+  if (Array.isArray(value)) {
+    return (
+      /* "[" */
+      "%5B" + value.map(
+        (element) => typeof element === "string" ? encodeURIComponent(`"${element.replace(/"/g, '\\"')}"`) : encodeValue(element)
+      ).join(
+        /* ", " */
+        "%2C%20"
+      ) + /* "]" */
+      "%5D"
+    );
+  } else if (typeof value === "bigint") {
+    return `${value}n`;
+  } else {
+    return encodeURIComponent(
+      String(
+        Object.getPrototypeOf(value) === null ? (
+          // Plain objects with no protoype don't have a `toString` method.
+          // Convert them before stringifying them.
+          { ...value }
+        ) : value
+      )
+    );
+  }
+}
+function encodeObjectContextEntry([key, value]) {
+  return `${key}=${encodeValue(value)}`;
+}
+function encodeContextObject(context) {
+  return Object.entries(context).map(encodeObjectContextEntry).join("&");
+}
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+function getErrorMessage(code, context = {}) {
+  if (__DEV__) {
+    return getHumanReadableErrorMessage(code, context);
+  } else {
+    let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \`npx @solana/errors decode ${code}`;
+    if (Object.keys(context).length) {
+      decodingAdviceMessage += ` $"${encodeContextObject(context)}"`;
+    }
+    return `${decodingAdviceMessage}\``;
+  }
+}
+// src/error.ts
+function isSolanaError(e, code) {
+  const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
+  if (isSolanaError2) {
+    if (code !== void 0) {
+      return e.context.__code === code;
+    }
+    return true;
+  }
+  return false;
+}
+var SolanaError = class extends Error {
+  context;
+  constructor(...[code, context]) {
+    const message = getErrorMessage(code, context);
+    super(message);
+    this.context = {
+      __code: code,
+      ...context
+    };
+    this.name = "SolanaError";
+  }
+};
+export { SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED, SOLANA_ERROR__INVALID_KEYPAIR_BYTES, SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND, SOLANA_ERROR__NONCE_INVALID, SOLANA_ERROR__RPC_INTEGER_OVERFLOW, SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES, SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE, SolanaError, isSolanaError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map ADDED Viewed

@@ -0,0 +1 @@

package/dist/index.native.js ADDED Viewed

@@ -0,0 +1,103 @@
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function encodeValue(value) {
+  if (Array.isArray(value)) {
+    return (
+      /* "[" */
+      "%5B" + value.map(
+        (element) => typeof element === "string" ? encodeURIComponent(`"${element.replace(/"/g, '\\"')}"`) : encodeValue(element)
+      ).join(
+        /* ", " */
+        "%2C%20"
+      ) + /* "]" */
+      "%5D"
+    );
+  } else if (typeof value === "bigint") {
+    return `${value}n`;
+  } else {
+    return encodeURIComponent(
+      String(
+        Object.getPrototypeOf(value) === null ? (
+          // Plain objects with no protoype don't have a `toString` method.
+          // Convert them before stringifying them.
+          { ...value }
+        ) : value
+      )
+    );
+  }
+}
+function encodeObjectContextEntry([key, value]) {
+  return `${key}=${encodeValue(value)}`;
+}
+function encodeContextObject(context) {
+  return Object.entries(context).map(encodeObjectContextEntry).join("&");
+}
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+function getErrorMessage(code, context = {}) {
+  if (__DEV__) {
+    return getHumanReadableErrorMessage(code, context);
+  } else {
+    let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \`npx @solana/errors decode ${code}`;
+    if (Object.keys(context).length) {
+      decodingAdviceMessage += ` $"${encodeContextObject(context)}"`;
+    }
+    return `${decodingAdviceMessage}\``;
+  }
+}
+// src/error.ts
+function isSolanaError(e, code) {
+  const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
+  if (isSolanaError2) {
+    if (code !== void 0) {
+      return e.context.__code === code;
+    }
+    return true;
+  }
+  return false;
+}
+var SolanaError = class extends Error {
+  context;
+  constructor(...[code, context]) {
+    const message = getErrorMessage(code, context);
+    super(message);
+    this.context = {
+      __code: code,
+      ...context
+    };
+    this.name = "SolanaError";
+  }
+};
+export { SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED, SOLANA_ERROR__INVALID_KEYPAIR_BYTES, SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND, SOLANA_ERROR__NONCE_INVALID, SOLANA_ERROR__RPC_INTEGER_OVERFLOW, SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES, SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE, SolanaError, isSolanaError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.native.js.map

package/dist/index.native.js.map ADDED Viewed

@@ -0,0 +1 @@

package/dist/index.node.cjs ADDED Viewed

@@ -0,0 +1,113 @@
+'use strict';
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function encodeValue(value) {
+  if (Array.isArray(value)) {
+    return (
+      /* "[" */
+      "%5B" + value.map(
+        (element) => typeof element === "string" ? encodeURIComponent(`"${element.replace(/"/g, '\\"')}"`) : encodeValue(element)
+      ).join(
+        /* ", " */
+        "%2C%20"
+      ) + /* "]" */
+      "%5D"
+    );
+  } else if (typeof value === "bigint") {
+    return `${value}n`;
+  } else {
+    return encodeURIComponent(
+      String(
+        Object.getPrototypeOf(value) === null ? (
+          // Plain objects with no protoype don't have a `toString` method.
+          // Convert them before stringifying them.
+          { ...value }
+        ) : value
+      )
+    );
+  }
+}
+function encodeObjectContextEntry([key, value]) {
+  return `${key}=${encodeValue(value)}`;
+}
+function encodeContextObject(context) {
+  return Object.entries(context).map(encodeObjectContextEntry).join("&");
+}
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+function getErrorMessage(code, context = {}) {
+  if (__DEV__) {
+    return getHumanReadableErrorMessage(code, context);
+  } else {
+    let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \`npx @solana/errors decode ${code}`;
+    if (Object.keys(context).length) {
+      decodingAdviceMessage += ` $"${encodeContextObject(context)}"`;
+    }
+    return `${decodingAdviceMessage}\``;
+  }
+}
+// src/error.ts
+function isSolanaError(e, code) {
+  const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
+  if (isSolanaError2) {
+    if (code !== void 0) {
+      return e.context.__code === code;
+    }
+    return true;
+  }
+  return false;
+}
+var SolanaError = class extends Error {
+  context;
+  constructor(...[code, context]) {
+    const message = getErrorMessage(code, context);
+    super(message);
+    this.context = {
+      __code: code,
+      ...context
+    };
+    this.name = "SolanaError";
+  }
+};
+exports.SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED;
+exports.SOLANA_ERROR__INVALID_KEYPAIR_BYTES = SOLANA_ERROR__INVALID_KEYPAIR_BYTES;
+exports.SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND;
+exports.SOLANA_ERROR__NONCE_INVALID = SOLANA_ERROR__NONCE_INVALID;
+exports.SOLANA_ERROR__RPC_INTEGER_OVERFLOW = SOLANA_ERROR__RPC_INTEGER_OVERFLOW;
+exports.SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES;
+exports.SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE;
+exports.SolanaError = SolanaError;
+exports.isSolanaError = isSolanaError;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.cjs.map

package/dist/index.node.cjs.map ADDED Viewed

@@ -0,0 +1 @@

package/dist/index.node.js ADDED Viewed

@@ -0,0 +1,103 @@
+// ../build-scripts/env-shim.ts
+var __DEV__ = /* @__PURE__ */ (() => process["env"].NODE_ENV === "development")();
+// src/codes.ts
+var SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES = 1;
+var SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE = 2;
+var SOLANA_ERROR__RPC_INTEGER_OVERFLOW = 3;
+var SOLANA_ERROR__INVALID_KEYPAIR_BYTES = 4;
+var SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED = 5;
+var SOLANA_ERROR__NONCE_INVALID = 6;
+var SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND = 7;
+// src/messages.ts
+var SolanaErrorMessages = {
+  [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: "The network has progressed past the last block for which this transaction could have been committed.",
+  [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: "Key pair bytes must be of length 64, got $byteLength.",
+  [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: "No nonce account could be found at address `$nonceAccountAddress`",
+  [SOLANA_ERROR__NONCE_INVALID]: "The nonce `$expectedNonceValue` is no longer valid. It has advanced to `$actualNonceValue`",
+  [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: "The $argumentLabel argument to the `$methodName` RPC method$optionalPathLabel was `$value`. This number is unsafe for use with the Solana JSON-RPC because it exceeds `Number.MAX_SAFE_INTEGER`.",
+  [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: "Transaction is missing signatures for addresses: $addresses.",
+  [SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE]: "Could not determine this transaction's signature. Make sure that the transaction has been signed by its fee payer."
+};
+// src/message-formatter.ts
+function encodeValue(value) {
+  if (Array.isArray(value)) {
+    return (
+      /* "[" */
+      "%5B" + value.map(
+        (element) => typeof element === "string" ? encodeURIComponent(`"${element.replace(/"/g, '\\"')}"`) : encodeValue(element)
+      ).join(
+        /* ", " */
+        "%2C%20"
+      ) + /* "]" */
+      "%5D"
+    );
+  } else if (typeof value === "bigint") {
+    return `${value}n`;
+  } else {
+    return encodeURIComponent(
+      String(
+        Object.getPrototypeOf(value) === null ? (
+          // Plain objects with no protoype don't have a `toString` method.
+          // Convert them before stringifying them.
+          { ...value }
+        ) : value
+      )
+    );
+  }
+}
+function encodeObjectContextEntry([key, value]) {
+  return `${key}=${encodeValue(value)}`;
+}
+function encodeContextObject(context) {
+  return Object.entries(context).map(encodeObjectContextEntry).join("&");
+}
+function getHumanReadableErrorMessage(code, context = {}) {
+  const messageFormatString = SolanaErrorMessages[code];
+  const message = messageFormatString.replace(
+    /(?<!\\)\$(\w+)/g,
+    (substring, variableName) => variableName in context ? `${context[variableName]}` : substring
+  );
+  return message;
+}
+function getErrorMessage(code, context = {}) {
+  if (__DEV__) {
+    return getHumanReadableErrorMessage(code, context);
+  } else {
+    let decodingAdviceMessage = `Solana error #${code}; Decode this error by running \`npx @solana/errors decode ${code}`;
+    if (Object.keys(context).length) {
+      decodingAdviceMessage += ` $"${encodeContextObject(context)}"`;
+    }
+    return `${decodingAdviceMessage}\``;
+  }
+}
+// src/error.ts
+function isSolanaError(e, code) {
+  const isSolanaError2 = e instanceof Error && e.name === "SolanaError";
+  if (isSolanaError2) {
+    if (code !== void 0) {
+      return e.context.__code === code;
+    }
+    return true;
+  }
+  return false;
+}
+var SolanaError = class extends Error {
+  context;
+  constructor(...[code, context]) {
+    const message = getErrorMessage(code, context);
+    super(message);
+    this.context = {
+      __code: code,
+      ...context
+    };
+    this.name = "SolanaError";
+  }
+};
+export { SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED, SOLANA_ERROR__INVALID_KEYPAIR_BYTES, SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND, SOLANA_ERROR__NONCE_INVALID, SOLANA_ERROR__RPC_INTEGER_OVERFLOW, SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES, SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE, SolanaError, isSolanaError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map ADDED Viewed

@@ -0,0 +1 @@

package/dist/types/codes.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+/**
+ * To add a new error, follow the instructions at
+ * https://github.com/solana-labs/solana-web3.js/tree/master/packages/error#adding-a-new-error
+ *
+ * WARNING:
+ *   - Don't remove error codes
+ *   - Don't change or reorder error codes.
+ */
+export declare const SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES: 1;
+export declare const SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE: 2;
+export declare const SOLANA_ERROR__RPC_INTEGER_OVERFLOW: 3;
+export declare const SOLANA_ERROR__INVALID_KEYPAIR_BYTES: 4;
+export declare const SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED: 5;
+export declare const SOLANA_ERROR__NONCE_INVALID: 6;
+export declare const SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND: 7;
+/**
+ * A union of every Solana error code
+ *
+ * You might be wondering why this is not a TypeScript enum or const enum.
+ *
+ * One of the goals of this library is to enable people to use some or none of it without having to
+ * bundle all of it.
+ *
+ * If we made the set of error codes an enum then anyone who imported it (even if to only use a
+ * single error code) would be forced to bundle every code and its label.
+ *
+ * Const enums appear to solve this problem by letting the compiler inline only the codes that are
+ * actually used. Unfortunately exporting ambient (const) enums from a library like `@solana/errors`
+ * is not safe, for a variety of reasons covered here: https://stackoverflow.com/a/28818850
+ */
+export type SolanaErrorCode = typeof SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES | typeof SOLANA_ERROR__TRANSACTION_SIGNATURE_NOT_COMPUTABLE | typeof SOLANA_ERROR__RPC_INTEGER_OVERFLOW | typeof SOLANA_ERROR__INVALID_KEYPAIR_BYTES | typeof SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED | typeof SOLANA_ERROR__NONCE_INVALID | typeof SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND;
+//# sourceMappingURL=codes.d.ts.map

package/dist/types/codes.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/codes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,4CAA4C,GAAa,CAAC;AACvE,eAAO,MAAM,kDAAkD,GAAa,CAAC;AAC7E,eAAO,MAAM,kCAAkC,GAAa,CAAC;AAC7D,eAAO,MAAM,mCAAmC,GAAa,CAAC;AAC9D,eAAO,MAAM,mCAAmC,GAAa,CAAC;AAC9D,eAAO,MAAM,2BAA2B,GAAa,CAAC;AACtD,eAAO,MAAM,qCAAqC,GAAa,CAAC;AAEhE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GACrB,OAAO,4CAA4C,GACnD,OAAO,kDAAkD,GACzD,OAAO,kCAAkC,GACzC,OAAO,mCAAmC,GAC1C,OAAO,mCAAmC,GAC1C,OAAO,2BAA2B,GAClC,OAAO,qCAAqC,CAAC"}

package/dist/types/context.d.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import { SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED, SOLANA_ERROR__INVALID_KEYPAIR_BYTES, SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND, SOLANA_ERROR__NONCE_INVALID, SOLANA_ERROR__RPC_INTEGER_OVERFLOW, SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES, SolanaErrorCode } from './codes.js';
+export type DefaultUnspecifiedErrorContextToUndefined<T> = {
+    [P in SolanaErrorCode]: P extends keyof T ? T[P] : undefined;
+};
+/**
+ * To add a new error, follow the instructions at
+ * https://github.com/solana-labs/solana-web3.js/tree/master/packages/error#adding-a-new-error
+ *
+ * WARNING:
+ *   - Don't change or remove members of an error's context.
+ */
+export type SolanaErrorContext = DefaultUnspecifiedErrorContextToUndefined<{
+    [SOLANA_ERROR__BLOCK_HEIGHT_EXCEEDED]: {
+        currentBlockHeight: bigint;
+        lastValidBlockHeight: bigint;
+    };
+    [SOLANA_ERROR__TRANSACTION_MISSING_SIGNATURES]: {
+        addresses: string[];
+    };
+    [SOLANA_ERROR__RPC_INTEGER_OVERFLOW]: {
+        argumentLabel: string;
+        keyPath: readonly (string | number | symbol)[];
+        methodName: string;
+        optionalPathLabel: string;
+        path?: string;
+        value: bigint;
+    };
+    [SOLANA_ERROR__INVALID_KEYPAIR_BYTES]: {
+        byteLength: number;
+    };
+    [SOLANA_ERROR__NONCE_ACCOUNT_NOT_FOUND]: {
+        nonceAccountAddress: string;
+    };
+    [SOLANA_ERROR__NONCE_INVALID]: {
+        actualNonceValue: string;
+        expectedNonceValue: string;
+    };
+}>;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/context.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,mCAAmC,EACnC,mCAAmC,EACnC,qCAAqC,EACrC,2BAA2B,EAC3B,kCAAkC,EAClC,4CAA4C,EAC5C,eAAe,EAClB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,yCAAyC,CAAC,CAAC,IAAI;KACtD,CAAC,IAAI,eAAe,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAC/D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,yCAAyC,CAAC;IACvE,CAAC,mCAAmC,CAAC,EAAE;QACnC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,oBAAoB,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,CAAC,4CAA4C,CAAC,EAAE;QAC5C,SAAS,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,CAAC,kCAAkC,CAAC,EAAE;QAClC,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;QAC/C,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,CAAC,mCAAmC,CAAC,EAAE;QACnC,UAAU,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,CAAC,qCAAqC,CAAC,EAAE;QACrC,mBAAmB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,CAAC,2BAA2B,CAAC,EAAE;QAC3B,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACL,CAAC,CAAC"}

package/dist/types/error.d.ts ADDED Viewed

@@ -0,0 +1,14 @@
+import { SolanaErrorCode } from './codes.js';
+import { SolanaErrorContext } from './context.js';
+export declare function isSolanaError<TErrorCode extends SolanaErrorCode>(e: unknown, code?: TErrorCode): e is SolanaError<TErrorCode>;
+type SolanaErrorCodedContext = Readonly<{
+    [P in SolanaErrorCode]: (SolanaErrorContext[P] extends undefined ? object : SolanaErrorContext[P]) & {
+        __code: P;
+    };
+}>;
+export declare class SolanaError<TErrorCode extends SolanaErrorCode = SolanaErrorCode> extends Error {
+    readonly context: SolanaErrorCodedContext[TErrorCode];
+    constructor(...[code, context]: SolanaErrorContext[TErrorCode] extends undefined ? [code: TErrorCode] : [code: TErrorCode, context: SolanaErrorContext[TErrorCode]]);
+}
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/types/error.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,wBAAgB,aAAa,CAAC,UAAU,SAAS,eAAe,EAC5D,CAAC,EAAE,OAAO,EACV,IAAI,CAAC,EAAE,UAAU,GAClB,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,CAS9B;AAED,KAAK,uBAAuB,GAAG,QAAQ,CAAC;KACnC,CAAC,IAAI,eAAe,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,MAAM,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAAG;QACjG,MAAM,EAAE,CAAC,CAAC;KACb;CACJ,CAAC,CAAC;AAEH,qBAAa,WAAW,CAAC,UAAU,SAAS,eAAe,GAAG,eAAe,CAAE,SAAQ,KAAK;IACxF,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAC,UAAU,CAAC,CAAC;gBAElD,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,SAAS,SAAS,GAC9D,CAAC,IAAI,EAAE,UAAU,CAAC,GAClB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAYxE"}

package/dist/types/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './codes.js';
+export * from './error.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dist/types/message-formatter.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import { SolanaErrorCode } from './codes.js';
+export declare function getHumanReadableErrorMessage<TErrorCode extends SolanaErrorCode>(code: TErrorCode, context?: object): string;
+export declare function getErrorMessage<TErrorCode extends SolanaErrorCode>(code: TErrorCode, context?: object): string;
+//# sourceMappingURL=message-formatter.d.ts.map

package/dist/types/message-formatter.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../src/message-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAuC1C,wBAAgB,4BAA4B,CAAC,UAAU,SAAS,eAAe,EAC3E,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,MAAW,GACrB,MAAM,CAMR;AAED,wBAAgB,eAAe,CAAC,UAAU,SAAS,eAAe,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAelH"}

package/dist/types/messages.d.ts ADDED Viewed

@@ -0,0 +1,12 @@
+import { SolanaErrorCode } from './codes.js';
+/**
+ * To add a new error, follow the instructions at
+ * https://github.com/solana-labs/solana-web3.js/tree/master/packages/error#adding-a-new-error
+ *
+ * WARNING:
+ *   - Don't change the meaning of an error message.
+ */
+export declare const SolanaErrorMessages: Readonly<{
+    [P in SolanaErrorCode]: string;
+}>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/types/messages.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAQH,eAAe,EAClB,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC;KAGtC,CAAC,IAAI,eAAe,GAAG,MAAM;CACjC,CAeA,CAAC"}

package/package.json ADDED Viewed

@@ -0,0 +1,80 @@
+{
+  "name": "@solana/errors",
+  "version": "2.0.0-experimental.021706b",
+  "description": "Throw, identify, and decode Solana JavaScript errors",
+  "exports": {
+    "browser": {
+      "import": "./dist/index.browser.js",
+      "require": "./dist/index.browser.cjs"
+    },
+    "node": {
+      "import": "./dist/index.node.js",
+      "require": "./dist/index.node.cjs"
+    },
+    "react-native": "./dist/index.native.js",
+    "types": "./dist/types/index.d.ts"
+  },
+  "browser": {
+    "./dist/index.node.cjs": "./dist/index.browser.cjs",
+    "./dist/index.node.js": "./dist/index.browser.js"
+  },
+  "main": "./dist/index.node.cjs",
+  "module": "./dist/index.node.js",
+  "react-native": "./dist/index.native.js",
+  "types": "./dist/types/index.d.ts",
+  "type": "module",
+  "files": [
+    "./dist/"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "blockchain",
+    "solana",
+    "web3"
+  ],
+  "bin": "./bin/cli.js",
+  "author": "Solana Labs Maintainers <maintainers@solanalabs.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/solana-labs/solana-web3.js"
+  },
+  "bugs": {
+    "url": "http://github.com/solana-labs/solana-web3.js/issues"
+  },
+  "browserslist": [
+    "supports bigint and not dead",
+    "maintained node versions"
+  ],
+  "engine": {
+    "node": ">=17.4"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0"
+  },
+  "bundlewatch": {
+    "defaultCompression": "gzip",
+    "files": [
+      {
+        "path": "./dist/index*.js"
+      }
+    ]
+  },
+  "scripts": {
+    "compile:js": "tsup --config build-scripts/tsup.config.package.ts && tsup src/cli.ts --format esm",
+    "compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/@solana/build-scripts/add-js-extension-to-types.mjs",
+    "dev": "jest -c node_modules/@solana/test-config/jest-dev.config.ts --rootDir . --watch",
+    "publish-impl": "npm view $npm_package_name@$npm_package_version > /dev/null 2>&1 || pnpm publish --tag experimental --access public --no-git-checks",
+    "publish-packages": "pnpm prepublishOnly && pnpm publish-impl",
+    "style:fix": "pnpm eslint --fix src/* && pnpm prettier -w src/* package.json",
+    "test:lint": "jest -c node_modules/@solana/test-config/jest-lint.config.ts --rootDir . --silent",
+    "test:prettier": "jest -c node_modules/@solana/test-config/jest-prettier.config.ts --rootDir . --silent",
+    "test:treeshakability:browser": "agadoo dist/index.browser.js",
+    "test:treeshakability:native": "agadoo dist/index.native.js",
+    "test:treeshakability:node": "agadoo dist/index.node.js",
+    "test:typecheck": "tsc --noEmit",
+    "test:unit:browser": "jest -c node_modules/@solana/test-config/jest-unit.config.browser.ts --rootDir . --silent",
+    "test:unit:node": "jest -c node_modules/@solana/test-config/jest-unit.config.node.ts --rootDir . --silent"
+  }
+}