@solana/web3.js 1.46.0 → 1.47.2

package/lib/index.cjs.js

@@ -4608,6 +4608,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';
+  }
+
 }
 
 async function fetchImpl (input, init) {
@@ -5779,7 +5814,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;
@@ -5804,7 +5839,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;
@@ -5820,7 +5855,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;
@@ -5835,7 +5870,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;
@@ -5866,7 +5901,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;
@@ -5883,7 +5918,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;
@@ -5900,7 +5935,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;
@@ -5935,7 +5970,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;
@@ -5966,7 +6001,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;
@@ -5985,7 +6020,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;
@@ -6003,7 +6038,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;
@@ -6025,7 +6060,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;
@@ -6042,7 +6077,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;
@@ -6078,7 +6113,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;
@@ -6113,7 +6148,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;
@@ -6141,7 +6176,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;
@@ -6165,7 +6200,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;
@@ -6299,7 +6334,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;
@@ -6316,7 +6351,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;
@@ -6340,7 +6375,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;
@@ -6364,7 +6399,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;
@@ -6383,7 +6418,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;
@@ -6421,7 +6456,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;
@@ -6445,7 +6480,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;
@@ -6476,7 +6511,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;
@@ -6502,7 +6537,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;
@@ -6526,7 +6561,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;
@@ -6541,7 +6576,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;
@@ -6558,7 +6593,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;
@@ -6597,7 +6632,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;
@@ -6609,13 +6644,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;
@@ -6634,7 +6667,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 {
@@ -6660,7 +6693,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) {
@@ -6719,7 +6752,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;
@@ -6734,7 +6767,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;
@@ -6749,7 +6782,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;
@@ -6766,7 +6799,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;
@@ -6805,7 +6838,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;
@@ -6836,7 +6869,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;
@@ -6853,7 +6886,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;
@@ -6876,7 +6909,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;
@@ -6900,7 +6933,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;
@@ -6927,7 +6960,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;
@@ -6955,7 +6988,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;
@@ -7002,7 +7035,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;
@@ -7022,7 +7055,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;
@@ -7050,7 +7083,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;
@@ -7075,7 +7108,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;
@@ -7100,7 +7133,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;
@@ -7126,7 +7159,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;
@@ -7215,7 +7248,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;
@@ -7237,7 +7270,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;
@@ -7294,7 +7327,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;
@@ -7524,7 +7557,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;
     }
 
@@ -10034,6 +10067,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;