@pezkuwi/wasm-crypto 7.5.6 → 7.5.8

package/test/all/sr25519.js

@@ -0,0 +1,211 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+/* global it */
+
+import crypto from 'crypto';
+
+import { assert, hexToU8a, stringToU8a, u8aToHex } from '@pezkuwi/util';
+
+/**
+ * @internal
+ * @param {*} pair
+ */
+function extractKeys (pair) {
+  return [pair, pair.slice(64), pair.slice(0, 64)];
+}
+
+/**
+ * @internal
+ * @param {*} wasm
+ */
+function randomPair (wasm) {
+  return extractKeys(wasm.sr25519KeypairFromSeed(crypto.randomBytes(32)));
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519PairFromSeed (wasm) {
+  it('creates a known pair from a known seed', () => {
+    const pair = wasm.sr25519KeypairFromSeed(stringToU8a('12345678901234567890123456789012'));
+
+    // console.log('\tSEC', u8aToHex(pair.slice(0, 64)));
+    // console.log('\tPUB', u8aToHex(pair.slice(64)));
+
+    assert(u8aToHex(pair) === '0xf0106660c3dda23f16daa9ac5b811b963077f5bc0af89f85804f0de8e424f050f98d66f39442506ff947fd911f18c7a7a5da639a63e8d3b4e233f74143d951c1741c08a06f41c596608f6774259bd9043304adfa5d3eea62760bd9be97634d63', 'ERROR: pairFromSeed() does not match');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DevFromSeed (wasm) {
+  it('creates a known development pair', () => {
+    const pair = wasm.sr25519KeypairFromSeed(hexToU8a('0xfac7959dbfe72f052e5a0c3c8d6530f202b02fd8f9f5ca3580ec8deb7797479e'));
+
+    // console.log('\tSEC', u8aToHex(pair.slice(0, 64)));
+    // console.log('\tPUB', u8aToHex(pair.slice(64)));
+
+    assert(u8aToHex(pair) === '0x28b0ae221c6bb06856b287f60d7ea0d98552ea5a16db16956849aa371db3eb51fd190cce74df356432b410bd64682309d6dedb27c76845daf388557cbac3ca3446ebddef8cd9bb167dc30878d7113b7e168e6f0646beffd77d69d39bad76b47a', 'ERROR: devFromSeed() does not match');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519VerifyExisting (wasm) {
+  it('verifies a known signature', () => {
+    const PK = hexToU8a('0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d');
+    const MESSAGE = stringToU8a('I hereby verify that I control 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY');
+    const SIGNATURE = hexToU8a('0xb83881d3bd7302981ee1c504fe5b7b394682927131fc0846fd616bb40fa14d02640fd2aca785b4cb57904765c2e4e75f59a7dd30154c209964369912091f6981');
+
+    const isValid = wasm.sr25519Verify(SIGNATURE, MESSAGE, PK);
+
+    // console.log('\tRES', isValid);
+
+    assert(isValid, 'ERROR: Unable to verify signature');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519SignDeterministic (wasm) {
+  it('creates non-deterministic signatures', () => {
+    const [, pk, sk] = randomPair(wasm);
+    const sig1 = u8aToHex(wasm.sr25519Sign(pk, sk, stringToU8a('this is a message')));
+    const sig2 = u8aToHex(wasm.sr25519Sign(pk, sk, stringToU8a('this is a message')));
+
+    // console.log('\tSG1', sig1);
+    // console.log('\tSG2', sig2);
+
+    assert(sig1 !== sig2, 'ERROR: Signatures are deterministic');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519SignAndVerify (wasm) {
+  it('verifies a created signature', () => {
+    const [, pk, sk] = randomPair(wasm);
+    const signature = wasm.sr25519Sign(pk, sk, stringToU8a('this is a message'));
+    const isValid = wasm.sr25519Verify(signature, stringToU8a('this is a message'), pk);
+
+    // console.log('\tSIG', u8aToHex(signature));
+    // console.log('\tRES', isValid);
+
+    assert(isValid, 'ERROR: Unable to verify signature');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DeriveHard (wasm) {
+  it('derives using a hard path', () => {
+    const [pair] = randomPair(wasm);
+    const derived = wasm.sr25519DeriveKeypairHard(pair, hexToU8a('0x0c666f6f00000000000000000000000000000000000000000000000000000000'));
+
+    // console.log('\tSEC', u8aToHex(derived.slice(0, 64)));
+    // console.log('\tPUB', u8aToHex(derived.slice(64)));
+
+    assert(derived.length === 96, 'Derived key length mismatch');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DeriveHardKnown (wasm) {
+  it('derives a known hard key', () => {
+    const derived = wasm.sr25519DeriveKeypairHard(hexToU8a('0x28b0ae221c6bb06856b287f60d7ea0d98552ea5a16db16956849aa371db3eb51fd190cce74df356432b410bd64682309d6dedb27c76845daf388557cbac3ca3446ebddef8cd9bb167dc30878d7113b7e168e6f0646beffd77d69d39bad76b47a'), hexToU8a('0x14416c6963650000000000000000000000000000000000000000000000000000'));
+    const publicKey = u8aToHex(derived.slice(64));
+
+    // console.log('\tSEC', u8aToHex(derived.slice(0, 64)));
+    // console.log('\tPUB', publicKey);
+
+    assert(publicKey === '0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d', 'Unmatched resulting public keys');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DeriveSoft (wasm) {
+  it('derives using a soft path', () => {
+    const [pair] = randomPair(wasm);
+    const derived = wasm.sr25519DeriveKeypairSoft(pair, hexToU8a('0x0c666f6f00000000000000000000000000000000000000000000000000000000'));
+
+    // console.log('\tSEC', u8aToHex(derived.slice(0, 64)));
+    // console.log('\tPUB', u8aToHex(derived.slice(64)));
+
+    assert(derived.length === 96, 'Derived key length mismatch');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DeriveSoftKnown (wasm) {
+  it('derives a known soft key', () => {
+    const derived = wasm.sr25519DeriveKeypairSoft(hexToU8a('0x28b0ae221c6bb06856b287f60d7ea0d98552ea5a16db16956849aa371db3eb51fd190cce74df356432b410bd64682309d6dedb27c76845daf388557cbac3ca3446ebddef8cd9bb167dc30878d7113b7e168e6f0646beffd77d69d39bad76b47a'), hexToU8a('0x0c666f6f00000000000000000000000000000000000000000000000000000000'));
+    const publicKey = u8aToHex(derived.slice(64));
+
+    // console.log('\tSEC', u8aToHex(derived.slice(0, 64)));
+    // console.log('\tPUB', publicKey);
+
+    assert(publicKey === '0x40b9675df90efa6069ff623b0fdfcf706cd47ca7452a5056c7ad58194d23440a', 'Unmatched resulting public keys');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519DeriveSoftPubkey (wasm) {
+  it('derives a known soft publicKey', () => {
+    const derived = u8aToHex(wasm.sr25519DerivePublicSoft(hexToU8a('0x46ebddef8cd9bb167dc30878d7113b7e168e6f0646beffd77d69d39bad76b47a'), hexToU8a('0x0c666f6f00000000000000000000000000000000000000000000000000000000')));
+
+    // console.log('\tPUB', derived);
+
+    assert(derived === '0x40b9675df90efa6069ff623b0fdfcf706cd47ca7452a5056c7ad58194d23440a', 'Unmatched resulting public keys');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519KeyAgreement (wasm) {
+  it('allows for agreements', () => {
+    const pair1 = wasm.sr25519KeypairFromSeed(hexToU8a('0x3b44c558f9a8f3dc9690d53088558c1ba2529b677e316c6054d1852595b004af'));
+    const pair2 = wasm.sr25519KeypairFromSeed(hexToU8a('0x923b80f79c6981fe756272128ec236eb510ae016dd20bdccbd77a9416b7ab94e'));
+    const [, pk1, sk1] = extractKeys(pair1);
+    const [, pk2, sk2] = extractKeys(pair2);
+
+    assert(u8aToHex(wasm.sr25519Agree(pk1, sk2)) === '0xfa7b90001b790fe42ff78b8cd86f6cf7a7c0a70b72f6b4c771b5d67536450222', 'Unmatched agreement keys');
+    assert(u8aToHex(wasm.sr25519Agree(pk2, sk1)) === '0xfa7b90001b790fe42ff78b8cd86f6cf7a7c0a70b72f6b4c771b5d67536450222', 'Unmatched agreement keys');
+
+    for (let i = 0; i < 256; i++) {
+      const [, pk1, sk1] = randomPair(wasm);
+      const [, pk2, sk2] = randomPair(wasm);
+
+      assert(u8aToHex(wasm.sr25519Agree(pk1, sk2)) === u8aToHex(wasm.sr25519Agree(pk2, sk1)), 'Unmatched agreement keys');
+    }
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function sr25519Benchmark (wasm) {
+  it('runs a verification benchmark', () => {
+    const MESSAGE = stringToU8a('this is a message');
+
+    for (let i = 0; i < 256; i++) {
+      const [, pk, sk] = randomPair(wasm);
+
+      assert(wasm.sr25519Verify(wasm.sr25519Sign(pk, sk, MESSAGE), MESSAGE, pk), 'ERROR: Unable to verify signature');
+    }
+  });
+}

package/test/all/vrf.js

@@ -0,0 +1,74 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+/* global it */
+
+import crypto from 'crypto';
+
+import { assert, stringToU8a, u8aToHex } from '@pezkuwi/util';
+
+/**
+ * @internal
+ * @param {*} pair
+ */
+function extractKeys (pair) {
+  return [pair, pair.slice(64), pair.slice(0, 64)];
+}
+
+/**
+ * @internal
+ * @param {*} wasm
+ */
+function randomPair (wasm) {
+  return extractKeys(wasm.sr25519KeypairFromSeed(crypto.randomBytes(32)));
+}
+
+/**
+ * @param {*} wasm
+ */
+export function vrfSignAndVerifyCompat (wasm) {
+  it('can sign and verify (1)', () => {
+    const [, pk, sk] = randomPair(wasm);
+    const outAndProof = wasm.vrfSign(sk, stringToU8a('my VRF context'), stringToU8a('this is a message'), new Uint8Array());
+    const isValid = wasm.vrfVerify(pk, stringToU8a('my VRF context'), stringToU8a('this is a message'), new Uint8Array(), outAndProof);
+
+    // console.log('\tVRF', u8aToHex(outAndProof));
+    // console.log('\tRES', isValid);
+
+    assert(isValid, 'ERROR: Unable to verify VRF output & proof');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function vrfSignAndVerify (wasm) {
+  it('can sign and verify (2)', () => {
+    const [, pk, sk] = randomPair(wasm);
+    const outAndProof = wasm.vrfSign(sk, stringToU8a('my VRF context'), stringToU8a('this is a message'), stringToU8a('extra param'));
+    const isValid = wasm.vrfVerify(pk, stringToU8a('my VRF context'), stringToU8a('this is a message'), stringToU8a('extra param'), outAndProof);
+
+    // console.log('\tVRF', u8aToHex(outAndProof));
+    // console.log('\tRES', isValid);
+
+    assert(isValid, 'ERROR: Unable to verify VRF extra output & proof');
+  });
+}
+
+/**
+ * @param {*} wasm
+ */
+export function vrfSignAndVerifyDeterministic (wasm) {
+  it('has non-deterministic outputs', () => {
+    const [,, sk] = randomPair(wasm);
+    const outAndProof1 = wasm.vrfSign(sk, stringToU8a('my VRF context'), stringToU8a('this is a message'), stringToU8a('extra param'));
+    const outAndProof2 = wasm.vrfSign(sk, stringToU8a('my VRF context'), stringToU8a('this is a message'), stringToU8a('extra param'));
+    const sig1 = u8aToHex(outAndProof1.slice(0, 32));
+    const sig2 = u8aToHex(outAndProof2.slice(0, 32));
+
+    // console.log('\tSG1', sig1);
+    // console.log('\tSG2', sig2);
+
+    assert(sig1 === sig2, 'ERROR: VRF extra outputs are non-deterministic');
+  });
+}

package/test/asm.js

@@ -0,0 +1,10 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import '@pezkuwi/wasm-crypto/initOnlyAsm';
+
+import * as wasm from '@pezkuwi/wasm-crypto';
+
+import { runUnassisted } from './all/index.js';
+
+runUnassisted('ASM', wasm);

package/test/deno.ts

@@ -0,0 +1,37 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// This is a Deno file, so we can allow .ts imports
+/* eslint-disable import/extensions */
+
+// NOTE We don't use ts-expect-error here since the build folder may or may
+// not exist (so the error may or may not be there)
+//
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore This should only run against the compiled ouput, where this should exist
+import * as wasm from '../build-deno/mod.ts';
+import { initRun, tests } from './all/index.js';
+
+type Tests = Record<string, (wasm: unknown) => void>;
+
+declare const globalThis: {
+  it: (name: string, fn: () => void) => unknown;
+};
+declare const Deno: {
+  test: (name: string, test: () => unknown) => unknown;
+};
+
+await initRun('wasm', wasm);
+
+// We use it to denote the tests
+globalThis.it = (name: string, fn: () => void) => Deno.test(name, () => fn());
+
+Object
+  .entries<Tests>(tests)
+  .forEach(([describeName, tests]) => {
+    console.log('***', describeName);
+
+    Object
+      .values(tests)
+      .forEach((test) => test(wasm));
+  });

package/test/jest.spec.ts

@@ -0,0 +1,24 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+/// <reference types="@pezkuwi/dev-test/globals.d.ts" />
+
+// NOTE We don't use ts-expect-error here since the build folder may or may
+// not exist (so the error may or may not be there)
+//
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore This should only run against the compiled ouput, where this should exist
+import * as wasm from '../build/index.js';
+import { initRun, tests } from './all/index.js';
+
+describe('wasm-crypto', (): void => {
+  beforeAll(() => initRun('wasm', wasm));
+
+  for (const name of Object.keys(tests)) {
+    describe(`${name}`, (): void => {
+      Object
+        .values<(wasm: unknown) => void>(tests[name as keyof typeof tests])
+        .forEach((fn) => fn(wasm));
+    });
+  }
+});

package/test/loader-build.js

@@ -0,0 +1,39 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import path from 'node:path';
+import process from 'node:process';
+import { pathToFileURL } from 'node:url';
+
+/**
+ * Adjusts the resolver to point to the build output
+ *
+ * @param {*} specifier
+ * @param {*} context
+ * @param {*} nextResolve
+ * @returns {*}
+ */
+export function resolve (specifier, context, nextResolve) {
+  if (specifier.startsWith('@pezkuwi/wasm-')) {
+    const parts = specifier.split(/[\\/]/);
+
+    return {
+      format: 'module',
+      shortCircuit: true,
+      url: pathToFileURL(
+        path.join(
+          process.cwd(),
+          ['packages', parts[1], 'build', ...parts.slice(2)]
+            .join('/')
+            .replace(/\/wasm-crypto-init\/build$/, '/wasm-crypto-init/build/wasm.js')
+            .replace(/\/wasm-crypto-init\/build\/asm$/, '/wasm-crypto-init/build/asm.js')
+            .replace(/\/wasm-crypto\/build\/initOnlyAsm$/, '/wasm-crypto/build/initOnlyAsm.js')
+            .replace(/\/build\/packageInfo$/, '/build/packageInfo.js')
+            .replace(/\/build$/, '/build/index.js')
+        )
+      ).href
+    };
+  }
+
+  return nextResolve(specifier, context);
+}

package/test/wasm.js

@@ -0,0 +1,8 @@
+// Copyright 2019-2026 @pezkuwi/wasm-crypto authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import * as wasm from '@pezkuwi/wasm-crypto';
+
+import { runUnassisted } from './all/index.js';
+
+runUnassisted('WASM', wasm);

package/tsconfig.build.json

@@ -0,0 +1,19 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": "..",
+    "outDir": "./build",
+    "rootDir": "./src"
+  },
+  "exclude": [
+    "**/mod.ts",
+    "**/test/**/*"
+  ],
+  "references": [
+    { "path": "../wasm-bridge/tsconfig.build.json" },
+    { "path": "../wasm-crypto-init/tsconfig.build.json" },
+    { "path": "../wasm-crypto-asmjs/tsconfig.build.json" },
+    { "path": "../wasm-crypto-wasm/tsconfig.build.json" },
+    { "path": "../wasm-util/tsconfig.build.json" }
+  ]
+}

package/tsconfig.spec.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": "..",
+    "outDir": "./build",
+    "rootDir": "./test",
+    "emitDeclarationOnly": false,
+    "noEmit": true
+  },
+  "include": [
+    "**/test/**/*"
+  ],
+  "references": [
+    { "path": "../wasm-crypto/tsconfig.build.json" }
+  ]
+}

package/LICENSE

@@ -1,201 +0,0 @@
-                              Apache License
-                        Version 2.0, January 2004
-                    http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-  "License" shall mean the terms and conditions for use, reproduction,
-  and distribution as defined by Sections 1 through 9 of this document.
-
-  "Licensor" shall mean the copyright owner or entity authorized by
-  the copyright owner that is granting the License.
-
-  "Legal Entity" shall mean the union of the acting entity and all
-  other entities that control, are controlled by, or are under common
-  control with that entity. For the purposes of this definition,
-  "control" means (i) the power, direct or indirect, to cause the
-  direction or management of such entity, whether by contract or
-  otherwise, or (ii) ownership of fifty percent (50%) or more of the
-  outstanding shares, or (iii) beneficial ownership of such entity.
-
-  "You" (or "Your") shall mean an individual or Legal Entity
-  exercising permissions granted by this License.
-
-  "Source" form shall mean the preferred form for making modifications,
-  including but not limited to software source code, documentation
-  source, and configuration files.
-
-  "Object" form shall mean any form resulting from mechanical
-  transformation or translation of a Source form, including but
-  not limited to compiled object code, generated documentation,
-  and conversions to other media types.
-
-  "Work" shall mean the work of authorship, whether in Source or
-  Object form, made available under the License, as indicated by a
-  copyright notice that is included in or attached to the work
-  (an example is provided in the Appendix below).
-
-  "Derivative Works" shall mean any work, whether in Source or Object
-  form, that is based on (or derived from) the Work and for which the
-  editorial revisions, annotations, elaborations, or other modifications
-  represent, as a whole, an original work of authorship. For the purposes
-  of this License, Derivative Works shall not include works that remain
-  separable from, or merely link (or bind by name) to the interfaces of,
-  the Work and Derivative Works thereof.
-
-  "Contribution" shall mean any work of authorship, including
-  the original version of the Work and any modifications or additions
-  to that Work or Derivative Works thereof, that is intentionally
-  submitted to Licensor for inclusion in the Work by the copyright owner
-  or by an individual or Legal Entity authorized to submit on behalf of
-  the copyright owner. For the purposes of this definition, "submitted"
-  means any form of electronic, verbal, or written communication sent
-  to the Licensor or its representatives, including but not limited to
-  communication on electronic mailing lists, source code control systems,
-  and issue tracking systems that are managed by, or on behalf of, the
-  Licensor for the purpose of discussing and improving the Work, but
-  excluding communication that is conspicuously marked or otherwise
-  designated in writing by the copyright owner as "Not a Contribution."
-
-  "Contributor" shall mean Licensor and any individual or Legal Entity
-  on behalf of whom a Contribution has been received by Licensor and
-  subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  copyright license to reproduce, prepare Derivative Works of,
-  publicly display, publicly perform, sublicense, and distribute the
-  Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-  this License, each Contributor hereby grants to You a perpetual,
-  worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-  (except as stated in this section) patent license to make, have made,
-  use, offer to sell, sell, import, and otherwise transfer the Work,
-  where such license applies only to those patent claims licensable
-  by such Contributor that are necessarily infringed by their
-  Contribution(s) alone or by combination of their Contribution(s)
-  with the Work to which such Contribution(s) was submitted. If You
-  institute patent litigation against any entity (including a
-  cross-claim or counterclaim in a lawsuit) alleging that the Work
-  or a Contribution incorporated within the Work constitutes direct
-  or contributory patent infringement, then any patent licenses
-  granted to You under this License for that Work shall terminate
-  as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-  Work or Derivative Works thereof in any medium, with or without
-  modifications, and in Source or Object form, provided that You
-  meet the following conditions:
-
-  (a) You must give any other recipients of the Work or
-      Derivative Works a copy of this License; and
-
-  (b) You must cause any modified files to carry prominent notices
-      stating that You changed the files; and
-
-  (c) You must retain, in the Source form of any Derivative Works
-      that You distribute, all copyright, patent, trademark, and
-      attribution notices from the Source form of the Work,
-      excluding those notices that do not pertain to any part of
-      the Derivative Works; and
-
-  (d) If the Work includes a "NOTICE" text file as part of its
-      distribution, then any Derivative Works that You distribute must
-      include a readable copy of the attribution notices contained
-      within such NOTICE file, excluding those notices that do not
-      pertain to any part of the Derivative Works, in at least one
-      of the following places: within a NOTICE text file distributed
-      as part of the Derivative Works; within the Source form or
-      documentation, if provided along with the Derivative Works; or,
-      within a display generated by the Derivative Works, if and
-      wherever such third-party notices normally appear. The contents
-      of the NOTICE file are for informational purposes only and
-      do not modify the License. You may add Your own attribution
-      notices within Derivative Works that You distribute, alongside
-      or as an addendum to the NOTICE text from the Work, provided
-      that such additional attribution notices cannot be construed
-      as modifying the License.
-
-  You may add Your own copyright statement to Your modifications and
-  may provide additional or different license terms and conditions
-  for use, reproduction, or distribution of Your modifications, or
-  for any such Derivative Works as a whole, provided Your use,
-  reproduction, and distribution of the Work otherwise complies with
-  the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-  any Contribution intentionally submitted for inclusion in the Work
-  by You to the Licensor shall be under the terms and conditions of
-  this License, without any additional terms or conditions.
-  Notwithstanding the above, nothing herein shall supersede or modify
-  the terms of any separate license agreement you may have executed
-  with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-  names, trademarks, service marks, or product names of the Licensor,
-  except as required for reasonable and customary use in describing the
-  origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-  agreed to in writing, Licensor provides the Work (and each
-  Contributor provides its Contributions) on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-  implied, including, without limitation, any warranties or conditions
-  of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-  PARTICULAR PURPOSE. You are solely responsible for determining the
-  appropriateness of using or redistributing the Work and assume any
-  risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-  whether in tort (including negligence), contract, or otherwise,
-  unless required by applicable law (such as deliberate and grossly
-  negligent acts) or agreed to in writing, shall any Contributor be
-  liable to You for damages, including any direct, indirect, special,
-  incidental, or consequential damages of any character arising as a
-  result of this License or out of the use or inability to use the
-  Work (including but not limited to damages for loss of goodwill,
-  work stoppage, computer failure or malfunction, or any and all
-  other commercial damages or losses), even if such Contributor
-  has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-  the Work or Derivative Works thereof, You may choose to offer,
-  and charge a fee for, acceptance of support, warranty, indemnity,
-  or other liability obligations and/or rights consistent with this
-  License. However, in accepting such obligations, You may act only
-  on Your own behalf and on Your sole responsibility, not on behalf
-  of any other Contributor, and only if You agree to indemnify,
-  defend, and hold each Contributor harmless for any liability
-  incurred by, or claims asserted against, such Contributor by reason
-  of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-  To apply the Apache License to your work, attach the following
-  boilerplate notice, with the fields enclosed by brackets "[]"
-  replaced with your own identifying information. (Don't include
-  the brackets!)  The text should be enclosed in the appropriate
-  comment syntax for the file format. We also recommend that a
-  file or class name and description of purpose be included on the
-  same "printed page" as the copyright notice for easier
-  identification within third-party archives.
-
-Copyright [yyyy] [name of copyright owner]
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.