Merge upstream

.ammanrc.js

@@ -0,0 +1,52 @@
+// @ts-check
+'use strict';
+const { tmpdir } = require('os');
+const path = require('path');
+const { LOCALHOST, tmpLedgerDir } = require('@metaplex-foundation/amman');
+
+const isLocal = process.env.LOCAL_MPL === '1';
+
+const localDeployDir = isLocal ?
+  path.resolve(process.cwd(), '../metaplex-program-library', 'target', 'deploy') :
+  path.join(tmpdir(), 'test', 'rust', 'target', 'deploy');
+
+const programIds = {
+  metadata: 'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s',
+  vault: 'vau1zxA2LbssAUEF7Gpw91zMM1LvXrvpzJtmZ58rPsn',
+  auction: 'auctxRXPeJoc4817jDhf4HbjnhEcr1cCXenosMhK5R8',
+  metaplex: 'p1exdMJcjVao65QdewkaZRUnU6VPSXhus9n2GzWfh98',
+};
+
+function localDeployPath(programName) {
+  return path.join(localDeployDir, `${programName}.so`);
+}
+const programs = [
+  {
+    programId: programIds.metadata,
+    deployPath: localDeployPath('mpl_token_metadata'),
+  },
+  {
+    programId: programIds.vault,
+    deployPath: localDeployPath('mpl_token_vault'),
+  },
+  { programId: programIds.auction, deployPath: localDeployPath('mpl_auction') },
+  {
+    programId: programIds.metaplex,
+    deployPath: localDeployPath('mpl_metaplex'),
+  },
+];
+
+const validator = {
+  killRunningValidators: true,
+  programs,
+  jsonRpcUrl: LOCALHOST,
+  websocketUrl: '',
+  commitment: 'confirmed',
+  ledgerDir: tmpLedgerDir(),
+  resetLedger: true,
+  verifyFees: false,
+};
+
+module.exports = {
+  validator,
+};

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,19 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

@@ -0,0 +1,28 @@
+<!--
+Thank you for contributing to this project! You must fill out the information
+below before we can review this pull request. By explaining why you're making a
+change (or linking to a pull request) and what changes you've made, we can
+triage your pull request more quickly.
+
+See our [CONTRIBUTING.md](/CONTRIBUTING.md) for information how to contribute.
+
+Thanks again!
+-->
+
+### Why?
+
+- Closes [issue link]
+
+<!--
+- If there's an existing issue for your change, please link to it.
+- If there's _not_ an existing issue, please open one first to make it more likely that this update will be accepted: https://github.com/metaplex-foundation/js/issues/new/choose. -->
+
+### What's being changed?
+
+<!-- Share artifacts of the changes like code snippets, GIFs or screenshots - whatever shares the most context. -->
+
+### Check off the following:
+
+- [ ] I have run `yarn fix` on my code before committing and opening this Pull Request
+- [ ] I made sure there are passing tests which cover this change
+- [ ] I ran `yarn test:all-local-mpl` locally and tests passed before opening this Pull Request

.github/actions/install-rust/action.yml

@@ -0,0 +1,37 @@
+name: Install Rust
+
+inputs:
+  toolchain:
+    description: The Rust version to use, default env.RUST_TOOLCHAIN
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Install Rust Stable
+      id: rust_toolchain
+      uses: actions-rs/toolchain@v1
+      with:
+          toolchain: ${{ inputs.toolchain }} 
+          override: true
+          profile: minimal
+          components: rustfmt, clippy
+
+    - name: Add Cargo bin to Path 
+      run: |
+        echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+      shell: bash
+
+    - name: Verify Rust install 
+      run: |
+        echo "Verifying rust '${{ inputs.toolchain }}' ..."
+        rustc --version
+        cargo --version
+        cargo clippy --version
+        rustfmt --version
+      shell: bash
+
+    - name: Share rustc hash
+      run: |
+       echo 'RUSTC_HASH=${{ steps.rust_toolchain.outputs.rustc_hash }}' >> $GITHUB_ENV
+      shell: bash

.github/actions/install-solana/action.yml

@@ -0,0 +1,39 @@
+name: Install Solana
+
+inputs:
+  solana_version:
+    description: Version of Solana to install, default env.SOLANA_VERSION
+    required: true
+
+runs:
+  using: "composite"
+  steps:
+    - name: Cache Solana Install
+      if: ${{ !env.ACT }}
+      id: cache-solana-install
+      uses: actions/cache@v2
+      with:
+        path: "$HOME/.local/share/solana/install/releases/${{ env.SOLANA_VERSION }}"
+        key: ${{ runner.os }}-Solana-v${{ inputs.solana_version  }}
+
+    - name: Install Solana
+      if: ${{ !env.ACT }} && steps.cache-solana-install.cache-hit != 'true'
+      run: | 
+        sh -c "$(curl -sSfL https://release.solana.com/v${{ inputs.solana_version }}/install)"
+      shell: bash
+
+    - name: Set Active Solana Version 
+      run: |
+        rm -f "$HOME/.local/share/solana/install/active_release"
+        ln -s "$HOME/.local/share/solana/install/releases/${{ inputs.solana_version }}/solana-release" "$HOME/.local/share/solana/install/active_release"
+      shell: bash
+
+    - name: Add Solana bin to Path 
+      run: |
+        echo "$HOME/.local/share/solana/install/active_release/bin" >> $GITHUB_PATH
+      shell: bash
+
+    - name: Verify Solana install 
+      run: |
+        solana --version
+      shell: bash

.github/labeler.yml

@@ -0,0 +1,5 @@
+# https://github.com/marketplace/actions/auto-labeler
+
+labels:
+  'SDK: JS':
+  - '.*'

.github/workflows/build-lint.yml

@@ -0,0 +1,22 @@
+name: Build Lint
+
+on:
+  pull_request:
+
+jobs:
+  release:
+    name: Build Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 14.17.0
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies
+        run: yarn install --immutable
+      - name: Lint
+        run: yarn lint && yarn prettier

.github/workflows/labeler.yml

@@ -0,0 +1,18 @@
+# https://github.com/marketplace/actions/auto-labeler
+
+name: Issue and Pull Request labeler
+on:
+  issues:
+    types: [opened, transferred, reopened]
+  pull_request_target:
+    types: [opened, reopened]
+
+jobs:
+  labeler:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Check Labels
+      id: labeler
+      uses: jimschubert/labeler-action@v2
+      with:
+        GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}

.github/workflows/pull_request.yml

@@ -9,16 +9,14 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-    - name: Setup Node.js
-      uses: actions/setup-node@v2
-      with:
-        node-version: 14.17.0
-        registry-url: 'https://registry.npmjs.org'
-    - name: Install dependencies
-      run: yarn install --immutable
-    - name: Lint
-      run: yarn lint && yarn prettier
-    - name: Test
-      run: yarn test
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 14.17.0
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies
+        run: yarn install --immutable
+      - name: Lint
+        run: yarn lint && yarn prettier

.github/workflows/release.yml

@@ -4,31 +4,50 @@ on:
   push:
     branches: [main]
 
+env:
+  SOLANA_VERSION: 1.8.5
+  RUST_TOOLCHAIN: stable
+
 jobs:
   release:
     name: Release
     runs-on: ubuntu-latest
 
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
-      with:
-        fetch-depth: 0
-        persist-credentials: false
-    - name: Setup Node.js
-      uses: actions/setup-node@v2
-      with:
-        node-version: 14.17.0
-        registry-url: 'https://registry.npmjs.org'
-    - name: Install dependencies
-      run: yarn install --immutable
-    - name: Test
-      run: yarn test
-    - name: Build
-      run: yarn build
-    - name: Release
-      env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        GH_TOKEN: ${{ secrets.GH_TOKEN }}
-      run: npx semantic-release
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Setup Node.js
+        uses: actions/setup-node@v2
+        with:
+          node-version: 14.17.0
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies
+        run: yarn install --immutable
+      - name: Install Solana
+        uses: ./.github/actions/install-solana
+        with:
+          solana_version: ${{ env.SOLANA_VERSION }}
+      - name: Install Rust
+        uses: ./.github/actions/install-rust
+        with:
+          toolchain: ${{ env.RUST_TOOLCHAIN }}
+      - name: Test
+        run: yarn test:all
+      - name: Build
+        run: yarn build
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
+        run: npx semantic-release
+      - name: Update docs
+        run: |
+          git remote set-url origin https://git:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git
+          yarn doc
+          yarn gh-pages -d docs -u "github-actions-bot <[email protected]>"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}