@solana/web3.js 1.46.0 → 1.47.2

package/lib/index.browser.cjs.js

@@ -4532,6 +4532,41 @@ class SendTransactionError extends Error {
     this.logs = logs;
   }
 
+} // Keep in sync with client/src/rpc_custom_errors.rs
+// Typescript `enums` thwart tree-shaking. See https://bargsten.org/jsts/enums/
+
+const SolanaJSONRPCErrorCode = {
+  JSON_RPC_SERVER_ERROR_BLOCK_CLEANED_UP: -32001,
+  JSON_RPC_SERVER_ERROR_SEND_TRANSACTION_PREFLIGHT_FAILURE: -32002,
+  JSON_RPC_SERVER_ERROR_TRANSACTION_SIGNATURE_VERIFICATION_FAILURE: -32003,
+  JSON_RPC_SERVER_ERROR_BLOCK_NOT_AVAILABLE: -32004,
+  JSON_RPC_SERVER_ERROR_NODE_UNHEALTHY: -32005,
+  JSON_RPC_SERVER_ERROR_TRANSACTION_PRECOMPILE_VERIFICATION_FAILURE: -32006,
+  JSON_RPC_SERVER_ERROR_SLOT_SKIPPED: -32007,
+  JSON_RPC_SERVER_ERROR_NO_SNAPSHOT: -32008,
+  JSON_RPC_SERVER_ERROR_LONG_TERM_STORAGE_SLOT_SKIPPED: -32009,
+  JSON_RPC_SERVER_ERROR_KEY_EXCLUDED_FROM_SECONDARY_INDEX: -32010,
+  JSON_RPC_SERVER_ERROR_TRANSACTION_HISTORY_NOT_AVAILABLE: -32011,
+  JSON_RPC_SCAN_ERROR: -32012,
+  JSON_RPC_SERVER_ERROR_TRANSACTION_SIGNATURE_LEN_MISMATCH: -32013,
+  JSON_RPC_SERVER_ERROR_BLOCK_STATUS_NOT_AVAILABLE_YET: -32014,
+  JSON_RPC_SERVER_ERROR_UNSUPPORTED_TRANSACTION_VERSION: -32015,
+  JSON_RPC_SERVER_ERROR_MIN_CONTEXT_SLOT_NOT_REACHED: -32016
+};
+class SolanaJSONRPCError extends Error {
+  constructor({
+    code,
+    message,
+    data
+  }, customMessage) {
+    super(customMessage != null ? `${customMessage}: ${message}` : message);
+    this.code = void 0;
+    this.data = void 0;
+    this.code = code;
+    this.data = data;
+    this.name = 'SolanaJSONRPCError';
+  }
+
 }
 
 var fetchImpl = globalThis.fetch;
@@ -5694,7 +5729,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(superstruct.number()));
 
     if ('error' in res) {
-      throw new Error('failed to get balance for ' + publicKey.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get balance for ${publicKey.toBase58()}`);
     }
 
     return res.result;
@@ -5719,7 +5754,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.nullable(superstruct.number())));
 
     if ('error' in res) {
-      throw new Error('failed to get block time for slot ' + slot + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get block time for slot ${slot}`);
     }
 
     return res.result;
@@ -5735,7 +5770,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.number()));
 
     if ('error' in res) {
-      throw new Error('failed to get minimum ledger slot: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get minimum ledger slot');
     }
 
     return res.result;
@@ -5750,7 +5785,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, SlotRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get first available block: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get first available block');
     }
 
     return res.result;
@@ -5781,7 +5816,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetSupplyRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get supply: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get supply');
     }
 
     return res.result;
@@ -5798,7 +5833,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(TokenAmountResult));
 
     if ('error' in res) {
-      throw new Error('failed to get token supply: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get token supply');
     }
 
     return res.result;
@@ -5815,7 +5850,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(TokenAmountResult));
 
     if ('error' in res) {
-      throw new Error('failed to get token account balance: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get token account balance');
     }
 
     return res.result;
@@ -5850,7 +5885,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetTokenAccountsByOwner);
 
     if ('error' in res) {
-      throw new Error('failed to get token accounts owned by account ' + ownerAddress.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get token accounts owned by account ${ownerAddress.toBase58()}`);
     }
 
     return res.result;
@@ -5881,7 +5916,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetParsedTokenAccountsByOwner);
 
     if ('error' in res) {
-      throw new Error('failed to get token accounts owned by account ' + ownerAddress.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get token accounts owned by account ${ownerAddress.toBase58()}`);
     }
 
     return res.result;
@@ -5900,7 +5935,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetLargestAccountsRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get largest accounts: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get largest accounts');
     }
 
     return res.result;
@@ -5918,7 +5953,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetTokenLargestAccountsResult);
 
     if ('error' in res) {
-      throw new Error('failed to get token largest accounts: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get token largest accounts');
     }
 
     return res.result;
@@ -5940,7 +5975,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(superstruct.nullable(AccountInfoResult)));
 
     if ('error' in res) {
-      throw new Error('failed to get info about account ' + publicKey.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get info about account ${publicKey.toBase58()}`);
     }
 
     return res.result;
@@ -5957,7 +5992,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(superstruct.nullable(ParsedAccountInfoResult)));
 
     if ('error' in res) {
-      throw new Error('failed to get info about account ' + publicKey.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get info about account ${publicKey.toBase58()}`);
     }
 
     return res.result;
@@ -5993,7 +6028,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(superstruct.array(superstruct.nullable(AccountInfoResult))));
 
     if ('error' in res) {
-      throw new Error('failed to get info for accounts ' + keys + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get info for accounts ${keys}`);
     }
 
     return res.result;
@@ -6028,7 +6063,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(StakeActivationResult));
 
     if ('error' in res) {
-      throw new Error(`failed to get Stake Activation ${publicKey.toBase58()}: ${res.error.message}`);
+      throw new SolanaJSONRPCError(res.error, `failed to get Stake Activation ${publicKey.toBase58()}`);
     }
 
     return res.result;
@@ -6056,7 +6091,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.array(KeyedAccountInfoResult)));
 
     if ('error' in res) {
-      throw new Error('failed to get accounts owned by program ' + programId.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get accounts owned by program ${programId.toBase58()}`);
     }
 
     return res.result;
@@ -6080,7 +6115,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.array(KeyedParsedAccountInfoResult)));
 
     if ('error' in res) {
-      throw new Error('failed to get accounts owned by program ' + programId.toBase58() + ': ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `failed to get accounts owned by program ${programId.toBase58()}`);
     }
 
     return res.result;
@@ -6214,7 +6249,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.array(ContactInfoResult)));
 
     if ('error' in res) {
-      throw new Error('failed to get cluster nodes: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get cluster nodes');
     }
 
     return res.result;
@@ -6231,7 +6266,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetVoteAccounts);
 
     if ('error' in res) {
-      throw new Error('failed to get vote accounts: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get vote accounts');
     }
 
     return res.result;
@@ -6255,7 +6290,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.number()));
 
     if ('error' in res) {
-      throw new Error('failed to get slot: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get slot');
     }
 
     return res.result;
@@ -6279,7 +6314,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.string()));
 
     if ('error' in res) {
-      throw new Error('failed to get slot leader: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get slot leader');
     }
 
     return res.result;
@@ -6298,7 +6333,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.array(PublicKeyFromString)));
 
     if ('error' in res) {
-      throw new Error('failed to get slot leaders: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get slot leaders');
     }
 
     return res.result;
@@ -6336,7 +6371,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetSignatureStatusesRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get signature status: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get signature status');
     }
 
     return res.result;
@@ -6360,7 +6395,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.number()));
 
     if ('error' in res) {
-      throw new Error('failed to get transaction count: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get transaction count');
     }
 
     return res.result;
@@ -6391,7 +6426,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetInflationGovernorRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get inflation: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get inflation');
     }
 
     return res.result;
@@ -6417,7 +6452,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetInflationRewardResult);
 
     if ('error' in res) {
-      throw new Error('failed to get inflation reward: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get inflation reward');
     }
 
     return res.result;
@@ -6441,7 +6476,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetEpochInfoRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get epoch info: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get epoch info');
     }
 
     return res.result;
@@ -6456,7 +6491,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetEpochScheduleRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get epoch schedule: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get epoch schedule');
     }
 
     const epochSchedule = res.result;
@@ -6473,7 +6508,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetLeaderScheduleRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get leader schedule: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get leader schedule');
     }
 
     return res.result;
@@ -6512,7 +6547,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetRecentBlockhashAndContextRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get recent blockhash: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get recent blockhash');
     }
 
     return res.result;
@@ -6524,13 +6559,11 @@ class Connection {
 
 
   async getRecentPerformanceSamples(limit) {
-    const args = this._buildArgs(limit ? [limit] : []);
-
-    const unsafeRes = await this._rpcRequest('getRecentPerformanceSamples', args);
+    const unsafeRes = await this._rpcRequest('getRecentPerformanceSamples', limit ? [limit] : []);
     const res = superstruct.create(unsafeRes, GetRecentPerformanceSamplesRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get recent performance samples: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get recent performance samples');
     }
 
     return res.result;
@@ -6549,7 +6582,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetFeeCalculatorRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get fee calculator: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get fee calculator');
     }
 
     const {
@@ -6575,7 +6608,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResultAndContext(superstruct.nullable(superstruct.number())));
 
     if ('error' in res) {
-      throw new Error('failed to get slot: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get slot');
     }
 
     if (res.result === null) {
@@ -6634,7 +6667,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetLatestBlockhashRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get latest blockhash: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get latest blockhash');
     }
 
     return res.result;
@@ -6649,7 +6682,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(VersionResult));
 
     if ('error' in res) {
-      throw new Error('failed to get version: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get version');
     }
 
     return res.result;
@@ -6664,7 +6697,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.string()));
 
     if ('error' in res) {
-      throw new Error('failed to get genesis hash: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get genesis hash');
     }
 
     return res.result;
@@ -6681,7 +6714,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetBlockRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get confirmed block: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get confirmed block');
     }
 
     const result = res.result;
@@ -6720,7 +6753,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.number()));
 
     if ('error' in res) {
-      throw new Error('failed to get block height information: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get block height information');
     }
 
     return res.result;
@@ -6751,7 +6784,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, BlockProductionResponseStruct);
 
     if ('error' in res) {
-      throw new Error('failed to get block production information: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get block production information');
     }
 
     return res.result;
@@ -6768,7 +6801,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetTransactionRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get transaction: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get transaction');
     }
 
     const result = res.result;
@@ -6791,7 +6824,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetParsedTransactionRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get transaction: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get transaction');
     }
 
     return res.result;
@@ -6815,7 +6848,7 @@ class Connection {
       const res = superstruct.create(unsafeRes, GetParsedTransactionRpcResult);
 
       if ('error' in res) {
-        throw new Error('failed to get transactions: ' + res.error.message);
+        throw new SolanaJSONRPCError(res.error, 'failed to get transactions');
       }
 
       return res.result;
@@ -6842,7 +6875,7 @@ class Connection {
       const res = superstruct.create(unsafeRes, GetTransactionRpcResult);
 
       if ('error' in res) {
-        throw new Error('failed to get transactions: ' + res.error.message);
+        throw new SolanaJSONRPCError(res.error, 'failed to get transactions');
       }
 
       const result = res.result;
@@ -6870,7 +6903,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetConfirmedBlockRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get confirmed block: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get confirmed block');
     }
 
     const result = res.result;
@@ -6917,7 +6950,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, jsonRpcResult(superstruct.array(superstruct.number())));
 
     if ('error' in res) {
-      throw new Error('failed to get blocks: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get blocks');
     }
 
     return res.result;
@@ -6937,7 +6970,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetBlockSignaturesRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get block: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get block');
     }
 
     const result = res.result;
@@ -6965,7 +6998,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetBlockSignaturesRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get confirmed block: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get confirmed block');
     }
 
     const result = res.result;
@@ -6990,7 +7023,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetTransactionRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get transaction: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get transaction');
     }
 
     const result = res.result;
@@ -7015,7 +7048,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetParsedTransactionRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get confirmed transaction: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get confirmed transaction');
     }
 
     return res.result;
@@ -7041,7 +7074,7 @@ class Connection {
       const res = superstruct.create(unsafeRes, GetParsedTransactionRpcResult);
 
       if ('error' in res) {
-        throw new Error('failed to get confirmed transactions: ' + res.error.message);
+        throw new SolanaJSONRPCError(res.error, 'failed to get confirmed transactions');
       }
 
       return res.result;
@@ -7130,7 +7163,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetConfirmedSignaturesForAddress2RpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get confirmed signatures for address: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get confirmed signatures for address');
     }
 
     return res.result;
@@ -7152,7 +7185,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, GetSignaturesForAddressRpcResult);
 
     if ('error' in res) {
-      throw new Error('failed to get signatures for address: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, 'failed to get signatures for address');
     }
 
     return res.result;
@@ -7209,7 +7242,7 @@ class Connection {
     const res = superstruct.create(unsafeRes, RequestAirdropRpcResult);
 
     if ('error' in res) {
-      throw new Error('airdrop to ' + to.toBase58() + ' failed: ' + res.error.message);
+      throw new SolanaJSONRPCError(res.error, `airdrop to ${to.toBase58()} failed`);
     }
 
     return res.result;
@@ -7439,7 +7472,7 @@ class Connection {
     const skipPreflight = options && options.skipPreflight;
     const preflightCommitment = options && options.preflightCommitment || this.commitment;
 
-    if (options && options.maxRetries) {
+    if (options && options.maxRetries != null) {
       config.maxRetries = options.maxRetries;
     }
 
@@ -9949,6 +9982,8 @@ exports.SYSVAR_SLOT_HISTORY_PUBKEY = SYSVAR_SLOT_HISTORY_PUBKEY;
 exports.SYSVAR_STAKE_HISTORY_PUBKEY = SYSVAR_STAKE_HISTORY_PUBKEY;
 exports.Secp256k1Program = Secp256k1Program;
 exports.SendTransactionError = SendTransactionError;
+exports.SolanaJSONRPCError = SolanaJSONRPCError;
+exports.SolanaJSONRPCErrorCode = SolanaJSONRPCErrorCode;
 exports.StakeAuthorizationLayout = StakeAuthorizationLayout;
 exports.StakeInstruction = StakeInstruction;
 exports.StakeProgram = StakeProgram;