@solana/programs 2.0.0-experimental.5e737f9

package/LICENSE

@@ -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

@@ -0,0 +1,79 @@
+[![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/programs/experimental.svg?style=flat
+[npm-image]: https://img.shields.io/npm/v/@solana/programs/experimental.svg?style=flat
+[npm-url]: https://www.npmjs.com/package/@solana/programs/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/programs
+
+This package contains types for defining programs and helpers for resolving program errors. It can be used standalone, but it is also exported as part of the Solana JavaScript SDK [`@solana/web3.js@experimental`](https://github.com/solana-labs/solana-web3.js/tree/master/packages/library).
+
+## Types
+
+### `Program`
+
+The `Program` type defines a Solana program.
+
+```ts
+const myProgram: Program<'1234..5678'> = {
+    name: 'myProgramName',
+    address: '1234..5678' as Address<'1234..5678'>,
+};
+```
+
+### `ProgramWithErrors`
+
+The `ProgramWithErrors` type helps extend the `Program` type by defining a `getErrorFromCode` function that can be used to resolve a custom program error from a transaction error code.
+
+```ts
+enum MyProgramErrorCode {
+    UNINITIALIZED_ACCOUNT = 0,
+    INVALID_ACCOUNT_OWNER = 1,
+    INVALID_ACCOUNT_DATA = 2,
+    SOME_OTHER_ERROR = 3,
+}
+
+class MyProgramError extends Error {
+    // ...
+}
+
+const myProgram: Program<'1234..5678'> & ProgramWithErrors<MyProgramErrorCode, MyProgramError> = {
+    name: 'myProgramName',
+    address: '1234..5678' as Address<'1234..5678'>,
+    getErrorFromCode: (code: MyProgramErrorCode, originalError: Error): MyProgramError => {
+        // ...
+    },
+};
+```
+
+## Functions
+
+### `resolveTransactionError()`
+
+This function takes a raw error caused by a transaction failure and attempts to resolve it into a custom program error.
+
+For this to work, the `resolveTransactionError` function also needs the following parameters:
+
+-   The `transaction` object that failed to execute. This allows us to identify the failing instruction and correctly identify the program that caused the error.
+-   An array of all `programs` that can be used to resolve the error. If the program that caused the error is not present in the array, the function won't be able to return a custom program error.
+
+Note that, if the error cannot be resolved into a custom program error, the original error is returned as-is.
+
+```ts
+// Store your programs.
+const programs = [createSplSystemProgram(), createSplComputeBudgetProgram(), createSplAddressLookupTableProgram()];
+
+try {
+    // Send and confirm your transaction.
+} catch (error) {
+    throw resolveTransactionError(error, transaction, programs);
+}
+```

package/dist/index.browser.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// src/resolve-transaction-error.ts
+function resolveTransactionError(error, transaction, programs) {
+  const fullLogs = error.message + "\n" + (error.logs ?? []).join("\n");
+  const instructionRegex = /Error processing Instruction (\d+)/;
+  const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;
+  const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;
+  if (instructionIndex === null)
+    return error;
+  const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;
+  const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;
+  const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;
+  if (errorCode === null)
+    return error;
+  const programAddress = transaction.instructions[instructionIndex]?.programAddress ?? null;
+  if (!programAddress)
+    return error;
+  const program = programs.find(
+    (program2) => program2.address === programAddress && typeof program2.getErrorFromCode !== "undefined"
+  ) ?? null;
+  if (!program)
+    return error;
+  return program.getErrorFromCode(errorCode, error);
+}
+
+exports.resolveTransactionError = resolveTransactionError;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.browser.cjs.map

package/dist/index.browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-transaction-error.ts"],"names":["program"],"mappings":";AAkBO,SAAS,wBACZ,OACA,aACA,UACK;AAEL,QAAM,WAAW,MAAM,UAAU,QAAQ,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAI;AAGpE,QAAM,mBAAmB;AACzB,QAAM,yBAAyB,SAAS,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACxE,QAAM,mBAAmB,yBAAyB,SAAS,wBAAwB,EAAE,IAAI;AACzF,MAAI,qBAAqB;AAAM,WAAO;AAGtC,QAAM,iBAAiB;AACvB,QAAM,kBAAkB,SAAS,MAAM,cAAc,IAAI,CAAC,KAAK;AAC/D,QAAM,YAAY,kBAAkB,SAAS,iBAAiB,EAAE,IAAI;AACpE,MAAI,cAAc;AAAM,WAAO;AAG/B,QAAM,iBAAiC,YAAY,aAAa,gBAAgB,GAAG,kBAAkB;AACrG,MAAI,CAAC;AAAgB,WAAO;AAG5B,QAAM,UACF,SAAS;AAAA,IACL,CAACA,aACGA,SAAQ,YAAY,kBAAkB,OAAOA,SAAQ,qBAAqB;AAAA,EAClF,KAAK;AACT,MAAI,CAAC;AAAS,WAAO;AAGrB,SAAO,QAAQ,iBAAiB,WAAW,KAAK;AACpD","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { Transaction } from '@solana/transactions';\n\nimport { Program, ProgramWithErrors } from './program';\n\n/**\n * Resolves a custom program error from a transaction error\n * with logs using the provided list of programs.\n * The original error is returned if the error cannot be\n * resolved from the given programs.\n *\n * @param error The raw error to resolve containing the program logs.\n * @param transaction The transaction that caused the error.\n * @param programs The list of programs to go through when resolving the transaction error.\n * They should ideally contain all programs the transaction is sending instructions to.\n * @returns The resolved program error, or the original transaction error\n * if the error cannot be resolved using the provided programs.\n */\nexport function resolveTransactionError(\n    error: Error & Readonly<{ logs?: readonly string[] }>,\n    transaction: Transaction,\n    programs: Program[],\n): Error {\n    // Compute the full logs from which to parse the instruction index and error code.\n    const fullLogs = error.message + '\\n' + (error.logs ?? []).join('\\n');\n\n    // Parse the instruction number, or return the original error.\n    const instructionRegex = /Error processing Instruction (\\d+)/;\n    const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;\n    const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;\n    if (instructionIndex === null) return error;\n\n    // Parse the error code, or return the original error.\n    const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;\n    const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;\n    const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;\n    if (errorCode === null) return error;\n\n    // Get the program address from the instruction in the transaction, or return the original error.\n    const programAddress: Address | null = transaction.instructions[instructionIndex]?.programAddress ?? null;\n    if (!programAddress) return error;\n\n    // Find a matching program with error handling, or return the original error.\n    const program: ProgramWithErrors | null =\n        programs.find(\n            (program): program is Program & ProgramWithErrors =>\n                program.address === programAddress && typeof program.getErrorFromCode !== 'undefined',\n        ) ?? null;\n    if (!program) return error;\n\n    // Resolve the error from the identified program.\n    return program.getErrorFromCode(errorCode, error);\n}\n"]}

package/dist/index.browser.js

@@ -0,0 +1,27 @@
+// src/resolve-transaction-error.ts
+function resolveTransactionError(error, transaction, programs) {
+  const fullLogs = error.message + "\n" + (error.logs ?? []).join("\n");
+  const instructionRegex = /Error processing Instruction (\d+)/;
+  const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;
+  const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;
+  if (instructionIndex === null)
+    return error;
+  const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;
+  const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;
+  const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;
+  if (errorCode === null)
+    return error;
+  const programAddress = transaction.instructions[instructionIndex]?.programAddress ?? null;
+  if (!programAddress)
+    return error;
+  const program = programs.find(
+    (program2) => program2.address === programAddress && typeof program2.getErrorFromCode !== "undefined"
+  ) ?? null;
+  if (!program)
+    return error;
+  return program.getErrorFromCode(errorCode, error);
+}
+
+export { resolveTransactionError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-transaction-error.ts"],"names":["program"],"mappings":";AAkBO,SAAS,wBACZ,OACA,aACA,UACK;AAEL,QAAM,WAAW,MAAM,UAAU,QAAQ,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAI;AAGpE,QAAM,mBAAmB;AACzB,QAAM,yBAAyB,SAAS,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACxE,QAAM,mBAAmB,yBAAyB,SAAS,wBAAwB,EAAE,IAAI;AACzF,MAAI,qBAAqB;AAAM,WAAO;AAGtC,QAAM,iBAAiB;AACvB,QAAM,kBAAkB,SAAS,MAAM,cAAc,IAAI,CAAC,KAAK;AAC/D,QAAM,YAAY,kBAAkB,SAAS,iBAAiB,EAAE,IAAI;AACpE,MAAI,cAAc;AAAM,WAAO;AAG/B,QAAM,iBAAiC,YAAY,aAAa,gBAAgB,GAAG,kBAAkB;AACrG,MAAI,CAAC;AAAgB,WAAO;AAG5B,QAAM,UACF,SAAS;AAAA,IACL,CAACA,aACGA,SAAQ,YAAY,kBAAkB,OAAOA,SAAQ,qBAAqB;AAAA,EAClF,KAAK;AACT,MAAI,CAAC;AAAS,WAAO;AAGrB,SAAO,QAAQ,iBAAiB,WAAW,KAAK;AACpD","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { Transaction } from '@solana/transactions';\n\nimport { Program, ProgramWithErrors } from './program';\n\n/**\n * Resolves a custom program error from a transaction error\n * with logs using the provided list of programs.\n * The original error is returned if the error cannot be\n * resolved from the given programs.\n *\n * @param error The raw error to resolve containing the program logs.\n * @param transaction The transaction that caused the error.\n * @param programs The list of programs to go through when resolving the transaction error.\n * They should ideally contain all programs the transaction is sending instructions to.\n * @returns The resolved program error, or the original transaction error\n * if the error cannot be resolved using the provided programs.\n */\nexport function resolveTransactionError(\n    error: Error & Readonly<{ logs?: readonly string[] }>,\n    transaction: Transaction,\n    programs: Program[],\n): Error {\n    // Compute the full logs from which to parse the instruction index and error code.\n    const fullLogs = error.message + '\\n' + (error.logs ?? []).join('\\n');\n\n    // Parse the instruction number, or return the original error.\n    const instructionRegex = /Error processing Instruction (\\d+)/;\n    const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;\n    const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;\n    if (instructionIndex === null) return error;\n\n    // Parse the error code, or return the original error.\n    const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;\n    const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;\n    const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;\n    if (errorCode === null) return error;\n\n    // Get the program address from the instruction in the transaction, or return the original error.\n    const programAddress: Address | null = transaction.instructions[instructionIndex]?.programAddress ?? null;\n    if (!programAddress) return error;\n\n    // Find a matching program with error handling, or return the original error.\n    const program: ProgramWithErrors | null =\n        programs.find(\n            (program): program is Program & ProgramWithErrors =>\n                program.address === programAddress && typeof program.getErrorFromCode !== 'undefined',\n        ) ?? null;\n    if (!program) return error;\n\n    // Resolve the error from the identified program.\n    return program.getErrorFromCode(errorCode, error);\n}\n"]}

package/dist/index.development.js

@@ -0,0 +1,54 @@
+this.globalThis = this.globalThis || {};
+this.globalThis.solanaWeb3 = (function (exports) {
+  'use strict';
+
+  // src/roles.ts
+  var AccountRole = /* @__PURE__ */ ((AccountRole2) => {
+    AccountRole2[AccountRole2["WRITABLE_SIGNER"] = /* 3 */
+    3] = "WRITABLE_SIGNER";
+    AccountRole2[AccountRole2["READONLY_SIGNER"] = /* 2 */
+    2] = "READONLY_SIGNER";
+    AccountRole2[AccountRole2["WRITABLE"] = /* 1 */
+    1] = "WRITABLE";
+    AccountRole2[AccountRole2["READONLY"] = /* 0 */
+    0] = "READONLY";
+    return AccountRole2;
+  })(AccountRole || {});
+  var IS_SIGNER_BITMASK = 2;
+  var IS_WRITABLE_BITMASK = 1;
+  function downgradeRoleToNonSigner(role) {
+    return role & ~IS_SIGNER_BITMASK;
+  }
+  function downgradeRoleToReadonly(role) {
+    return role & ~IS_WRITABLE_BITMASK;
+  }
+  function isSignerRole(role) {
+    return role >= 2 /* READONLY_SIGNER */;
+  }
+  function isWritableRole(role) {
+    return (role & IS_WRITABLE_BITMASK) !== 0;
+  }
+  function mergeRoles(roleA, roleB) {
+    return roleA | roleB;
+  }
+  function upgradeRoleToSigner(role) {
+    return role | IS_SIGNER_BITMASK;
+  }
+  function upgradeRoleToWritable(role) {
+    return role | IS_WRITABLE_BITMASK;
+  }
+
+  exports.AccountRole = AccountRole;
+  exports.downgradeRoleToNonSigner = downgradeRoleToNonSigner;
+  exports.downgradeRoleToReadonly = downgradeRoleToReadonly;
+  exports.isSignerRole = isSignerRole;
+  exports.isWritableRole = isWritableRole;
+  exports.mergeRoles = mergeRoles;
+  exports.upgradeRoleToSigner = upgradeRoleToSigner;
+  exports.upgradeRoleToWritable = upgradeRoleToWritable;
+
+  return exports;
+
+})({});
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.development.js.map

package/dist/index.development.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/roles.ts"],"names":["AccountRole"],"mappings":";AAIO,IAAK,cAAL,kBAAKA,iBAAL;AAEH,EAAAA,0BAAA;AAAA,EAA0B,KAA1B;AACA,EAAAA,0BAAA;AAAA,EAA0B,KAA1B;AACA,EAAAA,0BAAA;AAAA,EAA0B,KAA1B;AACA,EAAAA,0BAAA;AAAA,EAA0B,KAA1B;AALQ,SAAAA;AAAA,GAAA;AAQZ,IAAM,oBAAoB;AAC1B,IAAM,sBAAsB;AAKrB,SAAS,yBAAyB,MAAgC;AACrE,SAAO,OAAO,CAAC;AACnB;AAKO,SAAS,wBAAwB,MAAgC;AACpE,SAAO,OAAO,CAAC;AACnB;AAEO,SAAS,aAAa,MAAsF;AAC/G,SAAO,QAAQ;AACnB;AAEO,SAAS,eAAe,MAA+E;AAC1G,UAAQ,OAAO,yBAAyB;AAC5C;AAYO,SAAS,WAAW,OAAoB,OAAiC;AAC5E,SAAO,QAAQ;AACnB;AAKO,SAAS,oBAAoB,MAAgC;AAChE,SAAO,OAAO;AAClB;AAKO,SAAS,sBAAsB,MAAgC;AAClE,SAAO,OAAO;AAClB","sourcesContent":["/**\n * Quick primer on bitwise operations: https://stackoverflow.com/a/1436448/802047\n */\n\nexport enum AccountRole {\n    // Bitflag guide: is signer ⌄⌄ is writable\n    WRITABLE_SIGNER = /* 3 */ 0b11, // prettier-ignore\n    READONLY_SIGNER = /* 2 */ 0b10, // prettier-ignore\n    WRITABLE =        /* 1 */ 0b01, // prettier-ignore\n    READONLY =        /* 0 */ 0b00, // prettier-ignore\n}\n\nconst IS_SIGNER_BITMASK = 0b10;\nconst IS_WRITABLE_BITMASK = 0b01;\n\nexport function downgradeRoleToNonSigner(role: AccountRole.READONLY_SIGNER): AccountRole.READONLY;\nexport function downgradeRoleToNonSigner(role: AccountRole.WRITABLE_SIGNER): AccountRole.WRITABLE;\nexport function downgradeRoleToNonSigner(role: AccountRole): AccountRole;\nexport function downgradeRoleToNonSigner(role: AccountRole): AccountRole {\n    return role & ~IS_SIGNER_BITMASK;\n}\n\nexport function downgradeRoleToReadonly(role: AccountRole.WRITABLE): AccountRole.READONLY;\nexport function downgradeRoleToReadonly(role: AccountRole.WRITABLE_SIGNER): AccountRole.READONLY_SIGNER;\nexport function downgradeRoleToReadonly(role: AccountRole): AccountRole;\nexport function downgradeRoleToReadonly(role: AccountRole): AccountRole {\n    return role & ~IS_WRITABLE_BITMASK;\n}\n\nexport function isSignerRole(role: AccountRole): role is AccountRole.READONLY_SIGNER | AccountRole.WRITABLE_SIGNER {\n    return role >= AccountRole.READONLY_SIGNER;\n}\n\nexport function isWritableRole(role: AccountRole): role is AccountRole.WRITABLE | AccountRole.WRITABLE_SIGNER {\n    return (role & IS_WRITABLE_BITMASK) !== 0;\n}\n\nexport function mergeRoles(roleA: AccountRole.WRITABLE, roleB: AccountRole.READONLY_SIGNER): AccountRole.WRITABLE_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole.READONLY_SIGNER, roleB: AccountRole.WRITABLE): AccountRole.WRITABLE_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole, roleB: AccountRole.WRITABLE_SIGNER): AccountRole.WRITABLE_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole.WRITABLE_SIGNER, roleB: AccountRole): AccountRole.WRITABLE_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole, roleB: AccountRole.READONLY_SIGNER): AccountRole.READONLY_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole.READONLY_SIGNER, roleB: AccountRole): AccountRole.READONLY_SIGNER; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole, roleB: AccountRole.WRITABLE): AccountRole.WRITABLE; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole.WRITABLE, roleB: AccountRole): AccountRole.WRITABLE; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole.READONLY, roleB: AccountRole.READONLY): AccountRole.READONLY; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole, roleB: AccountRole): AccountRole; // prettier-ignore\nexport function mergeRoles(roleA: AccountRole, roleB: AccountRole): AccountRole {\n    return roleA | roleB;\n}\n\nexport function upgradeRoleToSigner(role: AccountRole.READONLY): AccountRole.READONLY_SIGNER;\nexport function upgradeRoleToSigner(role: AccountRole.WRITABLE): AccountRole.WRITABLE_SIGNER;\nexport function upgradeRoleToSigner(role: AccountRole): AccountRole;\nexport function upgradeRoleToSigner(role: AccountRole): AccountRole {\n    return role | IS_SIGNER_BITMASK;\n}\n\nexport function upgradeRoleToWritable(role: AccountRole.READONLY): AccountRole.WRITABLE;\nexport function upgradeRoleToWritable(role: AccountRole.READONLY_SIGNER): AccountRole.WRITABLE_SIGNER;\nexport function upgradeRoleToWritable(role: AccountRole): AccountRole;\nexport function upgradeRoleToWritable(role: AccountRole): AccountRole {\n    return role | IS_WRITABLE_BITMASK;\n}\n"]}

package/dist/index.native.js

@@ -0,0 +1,27 @@
+// src/resolve-transaction-error.ts
+function resolveTransactionError(error, transaction, programs) {
+  const fullLogs = error.message + "\n" + (error.logs ?? []).join("\n");
+  const instructionRegex = /Error processing Instruction (\d+)/;
+  const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;
+  const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;
+  if (instructionIndex === null)
+    return error;
+  const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;
+  const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;
+  const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;
+  if (errorCode === null)
+    return error;
+  const programAddress = transaction.instructions[instructionIndex]?.programAddress ?? null;
+  if (!programAddress)
+    return error;
+  const program = programs.find(
+    (program2) => program2.address === programAddress && typeof program2.getErrorFromCode !== "undefined"
+  ) ?? null;
+  if (!program)
+    return error;
+  return program.getErrorFromCode(errorCode, error);
+}
+
+export { resolveTransactionError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.native.js.map

package/dist/index.native.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-transaction-error.ts"],"names":["program"],"mappings":";AAkBO,SAAS,wBACZ,OACA,aACA,UACK;AAEL,QAAM,WAAW,MAAM,UAAU,QAAQ,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAI;AAGpE,QAAM,mBAAmB;AACzB,QAAM,yBAAyB,SAAS,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACxE,QAAM,mBAAmB,yBAAyB,SAAS,wBAAwB,EAAE,IAAI;AACzF,MAAI,qBAAqB;AAAM,WAAO;AAGtC,QAAM,iBAAiB;AACvB,QAAM,kBAAkB,SAAS,MAAM,cAAc,IAAI,CAAC,KAAK;AAC/D,QAAM,YAAY,kBAAkB,SAAS,iBAAiB,EAAE,IAAI;AACpE,MAAI,cAAc;AAAM,WAAO;AAG/B,QAAM,iBAAiC,YAAY,aAAa,gBAAgB,GAAG,kBAAkB;AACrG,MAAI,CAAC;AAAgB,WAAO;AAG5B,QAAM,UACF,SAAS;AAAA,IACL,CAACA,aACGA,SAAQ,YAAY,kBAAkB,OAAOA,SAAQ,qBAAqB;AAAA,EAClF,KAAK;AACT,MAAI,CAAC;AAAS,WAAO;AAGrB,SAAO,QAAQ,iBAAiB,WAAW,KAAK;AACpD","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { Transaction } from '@solana/transactions';\n\nimport { Program, ProgramWithErrors } from './program';\n\n/**\n * Resolves a custom program error from a transaction error\n * with logs using the provided list of programs.\n * The original error is returned if the error cannot be\n * resolved from the given programs.\n *\n * @param error The raw error to resolve containing the program logs.\n * @param transaction The transaction that caused the error.\n * @param programs The list of programs to go through when resolving the transaction error.\n * They should ideally contain all programs the transaction is sending instructions to.\n * @returns The resolved program error, or the original transaction error\n * if the error cannot be resolved using the provided programs.\n */\nexport function resolveTransactionError(\n    error: Error & Readonly<{ logs?: readonly string[] }>,\n    transaction: Transaction,\n    programs: Program[],\n): Error {\n    // Compute the full logs from which to parse the instruction index and error code.\n    const fullLogs = error.message + '\\n' + (error.logs ?? []).join('\\n');\n\n    // Parse the instruction number, or return the original error.\n    const instructionRegex = /Error processing Instruction (\\d+)/;\n    const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;\n    const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;\n    if (instructionIndex === null) return error;\n\n    // Parse the error code, or return the original error.\n    const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;\n    const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;\n    const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;\n    if (errorCode === null) return error;\n\n    // Get the program address from the instruction in the transaction, or return the original error.\n    const programAddress: Address | null = transaction.instructions[instructionIndex]?.programAddress ?? null;\n    if (!programAddress) return error;\n\n    // Find a matching program with error handling, or return the original error.\n    const program: ProgramWithErrors | null =\n        programs.find(\n            (program): program is Program & ProgramWithErrors =>\n                program.address === programAddress && typeof program.getErrorFromCode !== 'undefined',\n        ) ?? null;\n    if (!program) return error;\n\n    // Resolve the error from the identified program.\n    return program.getErrorFromCode(errorCode, error);\n}\n"]}

package/dist/index.node.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+// src/resolve-transaction-error.ts
+function resolveTransactionError(error, transaction, programs) {
+  const fullLogs = error.message + "\n" + (error.logs ?? []).join("\n");
+  const instructionRegex = /Error processing Instruction (\d+)/;
+  const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;
+  const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;
+  if (instructionIndex === null)
+    return error;
+  const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;
+  const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;
+  const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;
+  if (errorCode === null)
+    return error;
+  const programAddress = transaction.instructions[instructionIndex]?.programAddress ?? null;
+  if (!programAddress)
+    return error;
+  const program = programs.find(
+    (program2) => program2.address === programAddress && typeof program2.getErrorFromCode !== "undefined"
+  ) ?? null;
+  if (!program)
+    return error;
+  return program.getErrorFromCode(errorCode, error);
+}
+
+exports.resolveTransactionError = resolveTransactionError;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.cjs.map

package/dist/index.node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-transaction-error.ts"],"names":["program"],"mappings":";AAkBO,SAAS,wBACZ,OACA,aACA,UACK;AAEL,QAAM,WAAW,MAAM,UAAU,QAAQ,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAI;AAGpE,QAAM,mBAAmB;AACzB,QAAM,yBAAyB,SAAS,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACxE,QAAM,mBAAmB,yBAAyB,SAAS,wBAAwB,EAAE,IAAI;AACzF,MAAI,qBAAqB;AAAM,WAAO;AAGtC,QAAM,iBAAiB;AACvB,QAAM,kBAAkB,SAAS,MAAM,cAAc,IAAI,CAAC,KAAK;AAC/D,QAAM,YAAY,kBAAkB,SAAS,iBAAiB,EAAE,IAAI;AACpE,MAAI,cAAc;AAAM,WAAO;AAG/B,QAAM,iBAAiC,YAAY,aAAa,gBAAgB,GAAG,kBAAkB;AACrG,MAAI,CAAC;AAAgB,WAAO;AAG5B,QAAM,UACF,SAAS;AAAA,IACL,CAACA,aACGA,SAAQ,YAAY,kBAAkB,OAAOA,SAAQ,qBAAqB;AAAA,EAClF,KAAK;AACT,MAAI,CAAC;AAAS,WAAO;AAGrB,SAAO,QAAQ,iBAAiB,WAAW,KAAK;AACpD","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { Transaction } from '@solana/transactions';\n\nimport { Program, ProgramWithErrors } from './program';\n\n/**\n * Resolves a custom program error from a transaction error\n * with logs using the provided list of programs.\n * The original error is returned if the error cannot be\n * resolved from the given programs.\n *\n * @param error The raw error to resolve containing the program logs.\n * @param transaction The transaction that caused the error.\n * @param programs The list of programs to go through when resolving the transaction error.\n * They should ideally contain all programs the transaction is sending instructions to.\n * @returns The resolved program error, or the original transaction error\n * if the error cannot be resolved using the provided programs.\n */\nexport function resolveTransactionError(\n    error: Error & Readonly<{ logs?: readonly string[] }>,\n    transaction: Transaction,\n    programs: Program[],\n): Error {\n    // Compute the full logs from which to parse the instruction index and error code.\n    const fullLogs = error.message + '\\n' + (error.logs ?? []).join('\\n');\n\n    // Parse the instruction number, or return the original error.\n    const instructionRegex = /Error processing Instruction (\\d+)/;\n    const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;\n    const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;\n    if (instructionIndex === null) return error;\n\n    // Parse the error code, or return the original error.\n    const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;\n    const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;\n    const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;\n    if (errorCode === null) return error;\n\n    // Get the program address from the instruction in the transaction, or return the original error.\n    const programAddress: Address | null = transaction.instructions[instructionIndex]?.programAddress ?? null;\n    if (!programAddress) return error;\n\n    // Find a matching program with error handling, or return the original error.\n    const program: ProgramWithErrors | null =\n        programs.find(\n            (program): program is Program & ProgramWithErrors =>\n                program.address === programAddress && typeof program.getErrorFromCode !== 'undefined',\n        ) ?? null;\n    if (!program) return error;\n\n    // Resolve the error from the identified program.\n    return program.getErrorFromCode(errorCode, error);\n}\n"]}

package/dist/index.node.js

@@ -0,0 +1,27 @@
+// src/resolve-transaction-error.ts
+function resolveTransactionError(error, transaction, programs) {
+  const fullLogs = error.message + "\n" + (error.logs ?? []).join("\n");
+  const instructionRegex = /Error processing Instruction (\d+)/;
+  const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;
+  const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;
+  if (instructionIndex === null)
+    return error;
+  const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;
+  const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;
+  const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;
+  if (errorCode === null)
+    return error;
+  const programAddress = transaction.instructions[instructionIndex]?.programAddress ?? null;
+  if (!programAddress)
+    return error;
+  const program = programs.find(
+    (program2) => program2.address === programAddress && typeof program2.getErrorFromCode !== "undefined"
+  ) ?? null;
+  if (!program)
+    return error;
+  return program.getErrorFromCode(errorCode, error);
+}
+
+export { resolveTransactionError };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve-transaction-error.ts"],"names":["program"],"mappings":";AAkBO,SAAS,wBACZ,OACA,aACA,UACK;AAEL,QAAM,WAAW,MAAM,UAAU,QAAQ,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAI;AAGpE,QAAM,mBAAmB;AACzB,QAAM,yBAAyB,SAAS,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACxE,QAAM,mBAAmB,yBAAyB,SAAS,wBAAwB,EAAE,IAAI;AACzF,MAAI,qBAAqB;AAAM,WAAO;AAGtC,QAAM,iBAAiB;AACvB,QAAM,kBAAkB,SAAS,MAAM,cAAc,IAAI,CAAC,KAAK;AAC/D,QAAM,YAAY,kBAAkB,SAAS,iBAAiB,EAAE,IAAI;AACpE,MAAI,cAAc;AAAM,WAAO;AAG/B,QAAM,iBAAiC,YAAY,aAAa,gBAAgB,GAAG,kBAAkB;AACrG,MAAI,CAAC;AAAgB,WAAO;AAG5B,QAAM,UACF,SAAS;AAAA,IACL,CAACA,aACGA,SAAQ,YAAY,kBAAkB,OAAOA,SAAQ,qBAAqB;AAAA,EAClF,KAAK;AACT,MAAI,CAAC;AAAS,WAAO;AAGrB,SAAO,QAAQ,iBAAiB,WAAW,KAAK;AACpD","sourcesContent":["import type { Address } from '@solana/addresses';\nimport type { Transaction } from '@solana/transactions';\n\nimport { Program, ProgramWithErrors } from './program';\n\n/**\n * Resolves a custom program error from a transaction error\n * with logs using the provided list of programs.\n * The original error is returned if the error cannot be\n * resolved from the given programs.\n *\n * @param error The raw error to resolve containing the program logs.\n * @param transaction The transaction that caused the error.\n * @param programs The list of programs to go through when resolving the transaction error.\n * They should ideally contain all programs the transaction is sending instructions to.\n * @returns The resolved program error, or the original transaction error\n * if the error cannot be resolved using the provided programs.\n */\nexport function resolveTransactionError(\n    error: Error & Readonly<{ logs?: readonly string[] }>,\n    transaction: Transaction,\n    programs: Program[],\n): Error {\n    // Compute the full logs from which to parse the instruction index and error code.\n    const fullLogs = error.message + '\\n' + (error.logs ?? []).join('\\n');\n\n    // Parse the instruction number, or return the original error.\n    const instructionRegex = /Error processing Instruction (\\d+)/;\n    const instructionIndexString = fullLogs.match(instructionRegex)?.[1] ?? null;\n    const instructionIndex = instructionIndexString ? parseInt(instructionIndexString, 10) : null;\n    if (instructionIndex === null) return error;\n\n    // Parse the error code, or return the original error.\n    const errorCodeRegex = /Custom program error: (0x[a-f0-9]+)/i;\n    const errorCodeString = fullLogs.match(errorCodeRegex)?.[1] ?? null;\n    const errorCode = errorCodeString ? parseInt(errorCodeString, 16) : null;\n    if (errorCode === null) return error;\n\n    // Get the program address from the instruction in the transaction, or return the original error.\n    const programAddress: Address | null = transaction.instructions[instructionIndex]?.programAddress ?? null;\n    if (!programAddress) return error;\n\n    // Find a matching program with error handling, or return the original error.\n    const program: ProgramWithErrors | null =\n        programs.find(\n            (program): program is Program & ProgramWithErrors =>\n                program.address === programAddress && typeof program.getErrorFromCode !== 'undefined',\n        ) ?? null;\n    if (!program) return error;\n\n    // Resolve the error from the identified program.\n    return program.getErrorFromCode(errorCode, error);\n}\n"]}

package/dist/index.production.min.js

@@ -0,0 +1,18 @@
+this.globalThis = this.globalThis || {};
+this.globalThis.solanaWeb3 = (function (exports) {
+	'use strict';
+
+	var n=(e=>(e[e.WRITABLE_SIGNER=3]="WRITABLE_SIGNER",e[e.READONLY_SIGNER=2]="READONLY_SIGNER",e[e.WRITABLE=1]="WRITABLE",e[e.READONLY=0]="READONLY",e))(n||{});function l(o){return o&-3}function A(o){return o&-2}function r(o){return o>=2}function u(o){return (o&1)!==0}function E(o,R){return o|R}function I(o){return o|2}function N(o){return o|1}
+
+	exports.AccountRole = n;
+	exports.downgradeRoleToNonSigner = l;
+	exports.downgradeRoleToReadonly = A;
+	exports.isSignerRole = r;
+	exports.isWritableRole = u;
+	exports.mergeRoles = E;
+	exports.upgradeRoleToSigner = I;
+	exports.upgradeRoleToWritable = N;
+
+	return exports;
+
+})({});

package/dist/types/accounts.d.ts

@@ -0,0 +1,31 @@
+import { Address } from '@solana/addresses';
+import { AccountRole } from './roles.js.js.js';
+export interface IAccountMeta<TAddress extends string = string> {
+    readonly address: Address<TAddress>;
+    readonly role: AccountRole;
+}
+export type ReadonlyAccount<TAddress extends string = string> = IAccountMeta<TAddress> & {
+    readonly role: AccountRole.READONLY;
+};
+export type WritableAccount<TAddress extends string = string> = IAccountMeta<TAddress> & {
+    role: AccountRole.WRITABLE;
+};
+export type ReadonlySignerAccount<TAddress extends string = string> = IAccountMeta<TAddress> & {
+    role: AccountRole.READONLY_SIGNER;
+};
+export type WritableSignerAccount<TAddress extends string = string> = IAccountMeta<TAddress> & {
+    role: AccountRole.WRITABLE_SIGNER;
+};
+export interface IAccountLookupMeta<TAddress extends string = string, TLookupTableAddress extends string = string> {
+    readonly address: Address<TAddress>;
+    readonly addressIndex: number;
+    readonly lookupTableAddress: Address<TLookupTableAddress>;
+    readonly role: AccountRole.READONLY | AccountRole.WRITABLE;
+}
+export type ReadonlyAccountLookup<TAddress extends string = string, TLookupTableAddress extends string = string> = IAccountLookupMeta<TAddress, TLookupTableAddress> & {
+    readonly role: AccountRole.READONLY;
+};
+export type WritableAccountLookup<TAddress extends string = string, TLookupTableAddress extends string = string> = IAccountLookupMeta<TAddress, TLookupTableAddress> & {
+    readonly role: AccountRole.WRITABLE;
+};
+//# sourceMappingURL=accounts.d.ts.map

package/dist/types/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,MAAM,eAAe,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG;IACrF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC;CACvC,CAAC;AACF,MAAM,MAAM,eAAe,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAA;CAAE,CAAC;AACxH,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG;IAC3F,IAAI,EAAE,WAAW,CAAC,eAAe,CAAC;CACrC,CAAC;AACF,MAAM,MAAM,qBAAqB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG;IAC3F,IAAI,EAAE,WAAW,CAAC,eAAe,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,EAAE,mBAAmB,SAAS,MAAM,GAAG,MAAM;IAC7G,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;CAC9D;AAED,MAAM,MAAM,qBAAqB,CAC7B,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChC,mBAAmB,SAAS,MAAM,GAAG,MAAM,IAC3C,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAA;CAAE,CAAC;AAChG,MAAM,MAAM,qBAAqB,CAC7B,QAAQ,SAAS,MAAM,GAAG,MAAM,EAChC,mBAAmB,SAAS,MAAM,GAAG,MAAM,IAC3C,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAA;CAAE,CAAC"}

package/dist/types/index.d.ts

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

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

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

package/dist/types/instruction.d.ts

@@ -0,0 +1,14 @@
+import { Address } from '@solana/addresses';
+import { IAccountLookupMeta, IAccountMeta } from './accounts.js.js.js';
+export interface IInstruction<TProgramAddress extends string = string, TAccounts extends readonly (IAccountMeta | IAccountLookupMeta)[] = readonly (IAccountMeta | IAccountLookupMeta)[]> {
+    readonly accounts?: TAccounts;
+    readonly data?: Uint8Array;
+    readonly programAddress: Address<TProgramAddress>;
+}
+export interface IInstructionWithAccounts<TAccounts extends readonly (IAccountMeta | IAccountLookupMeta)[]> extends IInstruction {
+    readonly accounts: TAccounts;
+}
+export interface IInstructionWithData<TData extends Uint8Array> extends IInstruction {
+    readonly data: TData;
+}
+//# sourceMappingURL=instruction.d.ts.map

package/dist/types/instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction.d.ts","sourceRoot":"","sources":["../../src/instruction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,YAAY,CACzB,eAAe,SAAS,MAAM,GAAG,MAAM,EACvC,SAAS,SAAS,SAAS,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,GAAG,SAAS,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE;IAEjH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB,CAAC,SAAS,SAAS,SAAS,CAAC,YAAY,GAAG,kBAAkB,CAAC,EAAE,CACtG,SAAQ,YAAY;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB,CAAC,KAAK,SAAS,UAAU,CAAE,SAAQ,YAAY;IAChF,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACxB"}

package/dist/types/program.d.ts

@@ -0,0 +1,31 @@
+import type { Address } from '@solana/addresses';
+/**
+ * Defines a Solana program.
+ */
+export type Program<TAddress extends string = string> = {
+    /**
+     * A unique name for the Program.
+     *
+     * To avoid conflict with other organizations, it is recommended
+     * to prefix the program name with a namespace that is unique to
+     * your organization. For instance, programs belonging to the
+     * Solana Program Library are prefixed with `spl` like so:
+     * `splMemo` or `splToken`.
+     */
+    name: string;
+    /**
+     * The base58 address of the program.
+     */
+    address: Address<TAddress>;
+    /**
+     * Retrieves a program-specific error from a given error code.
+     */
+    getErrorFromCode?: (code: number, cause?: Error) => Error;
+};
+/**
+ * Defines a Solana program that can return custom errors from a provided error code.
+ */
+export type ProgramWithErrors<TErrorCode extends number = number, TError extends Error = Error> = {
+    getErrorFromCode: (code: TErrorCode, cause?: Error) => TError;
+};
+//# sourceMappingURL=program.d.ts.map

package/dist/types/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM,IAAI;IACpD;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,KAAK,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,IAAI;IAC9F,gBAAgB,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,MAAM,CAAC;CACjE,CAAC"}

package/dist/types/resolve-transaction-error.d.ts

@@ -0,0 +1,19 @@
+import type { Transaction } from '@solana/transactions';
+import { Program } from './program.js';
+/**
+ * Resolves a custom program error from a transaction error
+ * with logs using the provided list of programs.
+ * The original error is returned if the error cannot be
+ * resolved from the given programs.
+ *
+ * @param error The raw error to resolve containing the program logs.
+ * @param transaction The transaction that caused the error.
+ * @param programs The list of programs to go through when resolving the transaction error.
+ * They should ideally contain all programs the transaction is sending instructions to.
+ * @returns The resolved program error, or the original transaction error
+ * if the error cannot be resolved using the provided programs.
+ */
+export declare function resolveTransactionError(error: Error & Readonly<{
+    logs?: readonly string[];
+}>, transaction: Transaction, programs: Program[]): Error;
+//# sourceMappingURL=resolve-transaction-error.d.ts.map

package/dist/types/resolve-transaction-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-transaction-error.d.ts","sourceRoot":"","sources":["../../src/resolve-transaction-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAC;AAEvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,EACrD,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,OAAO,EAAE,GACpB,KAAK,CA8BP"}

package/dist/types/roles.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Quick primer on bitwise operations: https://stackoverflow.com/a/1436448/802047
+ */
+export declare enum AccountRole {
+    WRITABLE_SIGNER = 3,
+    READONLY_SIGNER = 2,
+    WRITABLE = 1,
+    READONLY = 0
+}
+export declare function downgradeRoleToNonSigner(role: AccountRole.READONLY_SIGNER): AccountRole.READONLY;
+export declare function downgradeRoleToNonSigner(role: AccountRole.WRITABLE_SIGNER): AccountRole.WRITABLE;
+export declare function downgradeRoleToNonSigner(role: AccountRole): AccountRole;
+export declare function downgradeRoleToReadonly(role: AccountRole.WRITABLE): AccountRole.READONLY;
+export declare function downgradeRoleToReadonly(role: AccountRole.WRITABLE_SIGNER): AccountRole.READONLY_SIGNER;
+export declare function downgradeRoleToReadonly(role: AccountRole): AccountRole;
+export declare function isSignerRole(role: AccountRole): role is AccountRole.READONLY_SIGNER | AccountRole.WRITABLE_SIGNER;
+export declare function isWritableRole(role: AccountRole): role is AccountRole.WRITABLE | AccountRole.WRITABLE_SIGNER;
+export declare function mergeRoles(roleA: AccountRole.WRITABLE, roleB: AccountRole.READONLY_SIGNER): AccountRole.WRITABLE_SIGNER;
+export declare function mergeRoles(roleA: AccountRole.READONLY_SIGNER, roleB: AccountRole.WRITABLE): AccountRole.WRITABLE_SIGNER;
+export declare function mergeRoles(roleA: AccountRole, roleB: AccountRole.WRITABLE_SIGNER): AccountRole.WRITABLE_SIGNER;
+export declare function mergeRoles(roleA: AccountRole.WRITABLE_SIGNER, roleB: AccountRole): AccountRole.WRITABLE_SIGNER;
+export declare function mergeRoles(roleA: AccountRole, roleB: AccountRole.READONLY_SIGNER): AccountRole.READONLY_SIGNER;
+export declare function mergeRoles(roleA: AccountRole.READONLY_SIGNER, roleB: AccountRole): AccountRole.READONLY_SIGNER;
+export declare function mergeRoles(roleA: AccountRole, roleB: AccountRole.WRITABLE): AccountRole.WRITABLE;
+export declare function mergeRoles(roleA: AccountRole.WRITABLE, roleB: AccountRole): AccountRole.WRITABLE;
+export declare function mergeRoles(roleA: AccountRole.READONLY, roleB: AccountRole.READONLY): AccountRole.READONLY;
+export declare function mergeRoles(roleA: AccountRole, roleB: AccountRole): AccountRole;
+export declare function upgradeRoleToSigner(role: AccountRole.READONLY): AccountRole.READONLY_SIGNER;
+export declare function upgradeRoleToSigner(role: AccountRole.WRITABLE): AccountRole.WRITABLE_SIGNER;
+export declare function upgradeRoleToSigner(role: AccountRole): AccountRole;
+export declare function upgradeRoleToWritable(role: AccountRole.READONLY): AccountRole.WRITABLE;
+export declare function upgradeRoleToWritable(role: AccountRole.READONLY_SIGNER): AccountRole.WRITABLE_SIGNER;
+export declare function upgradeRoleToWritable(role: AccountRole): AccountRole;
+//# sourceMappingURL=roles.d.ts.map

package/dist/types/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/roles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,WAAW;IAEnB,eAAe,IAAe;IAC9B,eAAe,IAAe;IAC9B,QAAQ,IAAsB;IAC9B,QAAQ,IAAsB;CACjC;AAKD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC;AAClG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC;AAClG,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;AAKzE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AAC1F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;AACxG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;AAKxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAEjH;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,eAAe,CAE5G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;AACzH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC;AACzH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;AAChH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,eAAe,CAAC;AAChH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;AAChH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,eAAe,CAAC;AAChH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AAClG,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC,QAAQ,CAAC;AAClG,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AAC3G,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAAC;AAKhF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,eAAe,CAAC;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;AAKpE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;AACxF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;AACtG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@solana/programs",
+  "version": "2.0.0-experimental.5e737f9",
+  "description": "Helpers for defining programs and resolving program 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"
+  ],
+  "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"
+  ],
+  "devDependencies": {
+    "@solana/eslint-config-solana": "^1.0.2",
+    "@swc/jest": "^0.2.29",
+    "@types/jest": "^29.5.11",
+    "@typescript-eslint/eslint-plugin": "^6.13.2",
+    "@typescript-eslint/parser": "^6.3.0",
+    "agadoo": "^3.0.0",
+    "eslint": "^8.45.0",
+    "eslint-plugin-sort-keys-fix": "^1.1.2",
+    "jest": "^29.7.0",
+    "jest-runner-eslint": "^2.1.2",
+    "jest-runner-prettier": "^1.0.0",
+    "prettier": "^3.1",
+    "tsup": "^8.0.1",
+    "typescript": "^5.2.2",
+    "version-from-git": "^1.1.1",
+    "@solana/addresses": "2.0.0-development",
+    "@solana/transactions": "2.0.0-development",
+    "test-config": "0.0.0",
+    "tsconfig": "0.0.0",
+    "@solana/functional": "2.0.0-development",
+    "build-scripts": "0.0.0"
+  },
+  "bundlewatch": {
+    "defaultCompression": "gzip",
+    "files": [
+      {
+        "path": "./dist/index*.js"
+      }
+    ]
+  },
+  "scripts": {
+    "compile:js": "tsup --config build-scripts/tsup.config.package.ts",
+    "compile:typedefs": "tsc -p ./tsconfig.declarations.json && node node_modules/build-scripts/add-js-extension-to-types.mjs",
+    "dev": "jest -c node_modules/test-config/jest-dev.config.ts --rootDir . --watch",
+    "publish-packages": "pnpm publish --tag experimental --access public --no-git-checks",
+    "style:fix": "pnpm eslint --fix src/* && pnpm prettier -w src/* package.json",
+    "test:lint": "jest -c node_modules/test-config/jest-lint.config.ts --rootDir . --silent",
+    "test:prettier": "jest -c node_modules/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/test-config/jest-unit.config.browser.ts --rootDir . --silent",
+    "test:unit:node": "jest -c node_modules/test-config/jest-unit.config.node.ts --rootDir . --silent"
+  }
+}