@solana/web3.js 0.98.0 → 1.0.1

package/README.md

@@ -47,11 +47,17 @@ $ npm install --save @solana/web3.js
 <script src="https://unpkg.com/@solana/web3.js@0.92.0/lib/index.iife.min.js"></script>
 ```
 
+## Development Environment Setup
 
-### Development Environment Setup
-To build and run tests:
-1. Install Rust from https://rustup.rs/
-2. Install the latest Solana release from https://docs.solana.com/cli/install-solana-cli-tools
+Install the latest Solana release from https://docs.solana.com/cli/install-solana-cli-tools
+
+### Run test validator
+
+**Use `solana-test-validator` from the latest Solana release**
+
+### BPF program development
+
+**Use `cargo build-bpf` from the latest Solana release**
 
 ## Usage
 
@@ -84,14 +90,6 @@ activate it:
 node_modules/@solana/web3.js/module.flow.js
 ```
 
-## Examples
-See the [examples/](https://github.com/solana-labs/solana-web3.js/tree/master/examples) directory for small snippets.
-
-Standalone examples:
-* Message feed (BPF Rust and C): https://github.com/solana-labs/example-messagefeed
-* Tic-tac-toe (BPF C): https://github.com/solana-labs/example-tictactoe
-* Web wallet: https://github.com/solana-labs/example-webwallet
-
 ## Releases
 Releases are available on [Github](https://github.com/solana-labs/solana-web3.js/releases)
 and [npmjs.com](https://www.npmjs.com/package/@solana/web3.js)
@@ -99,46 +97,3 @@ and [npmjs.com](https://www.npmjs.com/package/@solana/web3.js)
 Each Github release features a tarball containing API documentation and a
 minified version of the module suitable for direct use in a browser environment
 (&lt;script&gt; tag)
-
-## Deprecated
-
-### Local Network
-
-**Please use `solana-test-validator` from the latest Solana release instead of the information in this section**
-
-The `solana-localnet` program is provided to easily start a test Solana cluster
-locally on your machine.  Docker must be installed.  The JSON RPC endpoint of
-the local cluster is `http://localhost:8899`.
-
-To start, first fetch the latest Docker image by running:
-```bash
-$ npx solana-localnet update
-```
-
-Then run the following command to start the cluster
-```bash
-$ npx solana-localnet up
-```
-
-While the cluster is running logs are available with:
-```bash
-$ npx solana-localnet logs -f
-```
-
-Stop the cluster with:
-```bash
-$ npx solana-localnet down
-```
-
-### BPF program development
-
-**Please use `cargo build-bpf` from the latest Solana release instead of the information in this section**
-
-The Solana BPF SDK is located in the `bpf-sdk/` subdirectory if you installed
-solana-web3.js from npmjs.com.
-
-From a git clone, run `npm run bpf-sdk:install` to fetch the latest BPF SDK.
-
-Additionally Rust must be installed to build Rust BPF programs such as
-`examples/bpf-rust-noop/`.  See https://www.rust-lang.org/install.html for
-installation details.

package/lib/index.browser.esm.js

@@ -1,5 +1,6 @@
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
-import nacl, { sign } from 'tweetnacl';
+import * as nacl from 'tweetnacl';
+import nacl__default from 'tweetnacl';
 import BN from 'bn.js';
 import { sha256 } from 'crypto-hash';
 import fetch from 'node-fetch';
@@ -2696,7 +2697,7 @@ class PublicKey {
 
 } // @ts-ignore
 
-let naclLowLevel = nacl.lowlevel; // Check that a pubkey is on the curve.
+let naclLowLevel = nacl__default.lowlevel; // Check that a pubkey is on the curve.
 // This function and its dependents were sourced from:
 // https://github.com/dchest/tweetnacl-js/blob/f1ec050ceae0861f34280e62498b1d3ed9c350c6/nacl.js#L792
 
@@ -2764,9 +2765,9 @@ class Account {
     _defineProperty(this, "_keypair", void 0);
 
     if (secretKey) {
-      this._keypair = sign.keyPair.fromSecretKey(toBuffer(secretKey));
+      this._keypair = nacl.sign.keyPair.fromSecretKey(toBuffer(secretKey));
     } else {
-      this._keypair = sign.keyPair();
+      this._keypair = nacl.sign.keyPair();
     }
   }
   /**
@@ -4728,6 +4729,36 @@ function encodeLength(bytes, len) {
   }
 }
 
+const END_OF_BUFFER_ERROR_MESSAGE = 'Reached end of buffer unexpectedly';
+/**
+ * Delegates to `Array#shift`, but throws if the array is zero-length.
+ */
+
+function guardedShift(byteArray) {
+  if (byteArray.length === 0) {
+    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+  }
+
+  return byteArray.shift();
+}
+/**
+ * Delegates to `Array#splice`, but throws if the section being spliced out extends past the end of
+ * the array.
+ */
+
+function guardedSplice(byteArray, ...args) {
+  var _args$;
+
+  const [start] = args;
+
+  if (args.length === 2 // Implies that `deleteCount` was supplied
+  ? start + ((_args$ = args[1]) !== null && _args$ !== void 0 ? _args$ : 0) > byteArray.length : start >= byteArray.length) {
+    throw new Error(END_OF_BUFFER_ERROR_MESSAGE);
+  }
+
+  return byteArray.splice(...args);
+}
+
 /**
  * The message header, identifying signed and read-only account
  *
@@ -4818,32 +4849,28 @@ class Message {
   static from(buffer$1) {
     // Slice up wire data
     let byteArray = [...buffer$1];
-    const numRequiredSignatures = byteArray.shift();
-    const numReadonlySignedAccounts = byteArray.shift();
-    const numReadonlyUnsignedAccounts = byteArray.shift();
+    const numRequiredSignatures = guardedShift(byteArray);
+    const numReadonlySignedAccounts = guardedShift(byteArray);
+    const numReadonlyUnsignedAccounts = guardedShift(byteArray);
     const accountCount = decodeLength(byteArray);
     let accountKeys = [];
 
     for (let i = 0; i < accountCount; i++) {
-      const account = byteArray.slice(0, PUBKEY_LENGTH);
-      byteArray = byteArray.slice(PUBKEY_LENGTH);
+      const account = guardedSplice(byteArray, 0, PUBKEY_LENGTH);
       accountKeys.push(bs58.encode(buffer.Buffer.from(account)));
     }
 
-    const recentBlockhash = byteArray.slice(0, PUBKEY_LENGTH);
-    byteArray = byteArray.slice(PUBKEY_LENGTH);
+    const recentBlockhash = guardedSplice(byteArray, 0, PUBKEY_LENGTH);
     const instructionCount = decodeLength(byteArray);
     let instructions = [];
 
     for (let i = 0; i < instructionCount; i++) {
-      const programIdIndex = byteArray.shift();
+      const programIdIndex = guardedShift(byteArray);
       const accountCount = decodeLength(byteArray);
-      const accounts = byteArray.slice(0, accountCount);
-      byteArray = byteArray.slice(accountCount);
+      const accounts = guardedSplice(byteArray, 0, accountCount);
       const dataLength = decodeLength(byteArray);
-      const dataSlice = byteArray.slice(0, dataLength);
+      const dataSlice = guardedSplice(byteArray, 0, dataLength);
       const data = bs58.encode(buffer.Buffer.from(dataSlice));
-      byteArray = byteArray.slice(dataLength);
       instructions.push({
         programIdIndex,
         accounts,
@@ -5314,7 +5341,7 @@ class Transaction {
   _partialSign(message, ...signers) {
     const signData = message.serialize();
     signers.forEach(signer => {
-      const signature = nacl.sign.detached(signData, signer.secretKey);
+      const signature = nacl__default.sign.detached(signData, signer.secretKey);
 
       this._addSignature(signer.publicKey, toBuffer(signature));
     });
@@ -5370,7 +5397,7 @@ class Transaction {
           return false;
         }
       } else {
-        if (!nacl.sign.detached.verify(signData, signature, publicKey.toBuffer())) {
+        if (!nacl__default.sign.detached.verify(signData, signature, publicKey.toBuffer())) {
           return false;
         }
       }
@@ -5468,8 +5495,7 @@ class Transaction {
     let signatures = [];
 
     for (let i = 0; i < signatureCount; i++) {
-      const signature = byteArray.slice(0, SIGNATURE_LENGTH);
-      byteArray = byteArray.slice(SIGNATURE_LENGTH);
+      const signature = guardedSplice(byteArray, 0, SIGNATURE_LENGTH);
       signatures.push(bs58.encode(buffer.Buffer.from(signature)));
     }
 
@@ -11106,10 +11132,8 @@ class ValidatorInfo {
     const configKeys = [];
 
     for (let i = 0; i < 2; i++) {
-      const publicKey = new PublicKey(byteArray.slice(0, PUBKEY_LENGTH));
-      byteArray = byteArray.slice(PUBKEY_LENGTH);
-      const isSigner = byteArray.slice(0, 1)[0] === 1;
-      byteArray = byteArray.slice(1);
+      const publicKey = new PublicKey(guardedSplice(byteArray, 0, PUBKEY_LENGTH));
+      const isSigner = guardedShift(byteArray) === 1;
       configKeys.push({
         publicKey,
         isSigner