From a22bc3d4004b050449569bf66fe7431ccd04a16c Mon Sep 17 00:00:00 2001 From: James Zaki Date: Mon, 15 Apr 2024 16:15:19 +0100 Subject: [PATCH 01/56] fix: generate_aztecnr_reference.js not getting generics or multi-line params (#5679) --- docs/src/preprocess/generate_aztecnr_reference.js | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/src/preprocess/generate_aztecnr_reference.js b/docs/src/preprocess/generate_aztecnr_reference.js index 0d06932453c..007b952b41d 100644 --- a/docs/src/preprocess/generate_aztecnr_reference.js +++ b/docs/src/preprocess/generate_aztecnr_reference.js @@ -95,7 +95,8 @@ function parseFunctions(content) { } const implBlockContent = content.substring(implMatch.index, currentPos); - const methodRegex = /(?:pub )?fn (\w+)\((.*?)\)(?: -> (.*?))? {/g; + const methodRegex = + /(?:pub\s+)?fn\s+(\w+)(?:<.*?>)?\s*\(([\s\S]*?)\)\s*(?:->\s*(.*?))?\s*{/g; let methodMatch; while ((methodMatch = methodRegex.exec(implBlockContent)) !== null) { @@ -119,7 +120,7 @@ function parseFunctions(content) { } } - const standaloneFunctionRegex = /(?:pub\s+)?fn\s+(\w+)(?:<.*?>)?\s*\((.*?)\)\s*(?:->\s*(.*?))?\s*{/g; + const standaloneFunctionRegex = /(?:pub\s+)?fn\s+(\w+)(?:<.*?>)?\s*\(([\s\S]*?)\)\s*(?:->\s*(.*?))?\s*{/g; let standaloneFunctionMatch; while ((standaloneFunctionMatch = standaloneFunctionRegex.exec(content)) !== null) { const name = standaloneFunctionMatch[1]; From 8f3794dad170dba616c505d85bc1731fb6177ce0 Mon Sep 17 00:00:00 2001 From: spypsy Date: Mon, 15 Apr 2024 16:33:07 +0100 Subject: [PATCH 02/56] fix(ci): wait for mainnet fork deployment (#5735) --- .circleci/config.yml | 1 + iac/mainnet-fork/scripts/wait_for_fork | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index be6f871400d..dee04c71758 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -869,6 +869,7 @@ jobs: command: | should_deploy || exit 0 deploy_terraform_services iac/mainnet-fork mainnet-fork mainnet-fork aws_efs_file_system.aztec_mainnet_fork_data_store + ./iac/scripts/wait_for_fork - run: name: "Release canary to NPM: bb.js" command: | diff --git a/iac/mainnet-fork/scripts/wait_for_fork b/iac/mainnet-fork/scripts/wait_for_fork index 831e06723e2..ddafc00cc2e 100755 --- a/iac/mainnet-fork/scripts/wait_for_fork +++ b/iac/mainnet-fork/scripts/wait_for_fork @@ -6,7 +6,7 @@ set -e # This script waits on a healthy status from the fork - a valid response to the chainid request # We retry every 20 seconds, and wait for a total of 5 minutes (15 times) -export ETHEREUM_HOST="https://aztec-mainnet-fork.aztec.network:8545/$API_KEY" +export ETHEREUM_HOST="https://$DEPLOY_TAG-mainnet-fork.aztec.network:8545/$API_KEY" curl -H "Content-Type: application/json" -X POST --data '{"method":"eth_chainId","params":[],"id":33,"jsonrpc":"2.0"}' \ --connect-timeout 30 \ From 66dc5091b2aff53580e1a313e1001369ffc87e6b Mon Sep 17 00:00:00 2001 From: josh crites Date: Mon, 15 Apr 2024 12:27:56 -0400 Subject: [PATCH 03/56] feat(docs): Merge yellow paper into docs protocol specs section (#5668) This PR removes the yellow-paper directory and adds the contents to the docs, under the protocol-specs section. Adds a new item called "Protocol Specs" with its own sidebar to the top Navigation bar. ![image](https://github.com/AztecProtocol/aztec-packages/assets/18372439/39b1b962-9567-4425-a932-7bd32d109307) --- .circleci/config.yml | 15 - .vscode/settings.json | 4 - CONTRIBUTING.md | 3 +- avm-transpiler/src/opcodes.rs | 2 +- build_manifest.yml | 5 - .../addresses-and-keys/address.md | 2 +- .../diversified-and-stealth.md | 2 +- .../diversified-and-stealth-keys.md | 5 - .../example-usage/encrypt-and-tag.md | 5 - .../example-usage/nullifier.md | 11 +- .../example-usage/tag-sequence-derivation.md | 5 - .../addresses-and-keys/index.md | 2 +- .../addresses-and-keys/keys-requirements.md | 0 .../protocol-specs/addresses-and-keys/keys.md | 5 +- .../addresses-and-keys/precompiles.md | 0 .../docs/protocol-specs}/bytecode/index.md | 16 +- .../protocol-specs}/calls/batched-calls.md | 0 .../protocol-specs}/calls/delegate-calls.md | 0 .../protocol-specs}/calls/enqueued-calls.md | 0 .../docs/protocol-specs}/calls/index.md | 0 .../calls/public-private-messaging.md | 2 +- .../protocol-specs}/calls/static-calls.md | 0 .../docs/protocol-specs}/calls/sync-calls.md | 0 .../calls/unconstrained-calls.md | 0 .../circuits/high-level-topology.md | 2 +- .../circuits/private-function.md | 0 .../circuits/private-kernel-initial.mdx | 2 +- .../circuits/private-kernel-inner.mdx | 2 +- .../circuits/private-kernel-reset.md | 0 .../circuits/private-kernel-tail.md | 0 .../circuits/public-kernel-initial.md | 0 .../circuits/public-kernel-inner.md | 0 .../circuits/public-kernel-tail.md | 0 .../docs/protocol-specs}/constants.md | 0 .../contract-deployment/classes.md | 0 .../contract-deployment/index.md | 0 .../contract-deployment/instances.md | 0 .../cryptography/hashing/hashing.md | 4 +- .../cryptography/hashing/pedersen.md | 0 .../cryptography/hashing/poseidon2.md | 0 .../protocol-specs}/cryptography/index.md | 0 .../cryptography/merkle-trees.md | 0 .../cryptography/proving-system/data-bus.md | 0 .../cryptography/proving-system/overview.md | 4 +- .../proving-system/performance-targets.md | 0 .../index.md | 0 .../overview.md | 0 .../published-data.md | 0 .../decentralization/actors.md | 0 .../decentralization/block-production.md | 4 +- .../decentralization/governance.md | 10 +- .../decentralization/p2p-network.md | 53 +- .../gas-and-fees/fee-payments-and-metering.md | 41 +- .../gas-and-fees/fee-schedule.md | 0 .../protocol-specs}/gas-and-fees/index.md | 0 .../docs/protocol-specs}/intro.md | 0 .../l1-smart-contracts/frontier.md | 38 +- .../l1-smart-contracts/index.md | 138 +- .../docs/protocol-specs}/logs/index.md | 2 +- .../pre-compiled-contracts/index.md | 0 .../pre-compiled-contracts/registry.md | 0 .../private-message-delivery/index.md | 0 .../private-msg-delivery.md | 0 .../send-note-guidelines.md | 0 .../public-vm/_nested-context.md | 0 .../docs/protocol-specs}/public-vm/alu.md | 2 +- .../protocol-specs}/public-vm/avm-circuit.md | 0 .../public-vm/bytecode-validation-circuit.md | 0 .../public-vm/circuit-index.md | 0 .../protocol-specs}/public-vm/context.mdx | 0 .../protocol-specs}/public-vm/control-flow.md | 2 +- .../protocol-specs}/public-vm/execution.md | 0 .../public-vm/gen/_instruction-set.mdx | 102 +- .../docs/protocol-specs}/public-vm/index.md | 0 .../public-vm/instruction-set.mdx | 0 .../docs/protocol-specs}/public-vm/intro.md | 0 .../protocol-specs}/public-vm/memory-model.md | 2 +- .../public-vm/nested-calls.mdx | 0 .../protocol-specs}/public-vm/security.md | 0 .../docs/protocol-specs}/public-vm/state.md | 0 .../protocol-specs}/public-vm/type-structs.md | 0 .../rollup-circuits/base-rollup.md | 0 .../protocol-specs}/rollup-circuits/index.md | 0 .../rollup-circuits/merge-rollup.md | 0 .../rollup-circuits/root-rollup.md | 0 .../rollup-circuits/tree-parity.md | 0 .../docs/protocol-specs}/state/archive.md | 0 .../docs/protocol-specs}/state/index.md | 4 +- .../protocol-specs}/state/note-hash-tree.md | 0 .../protocol-specs}/state/nullifier-tree.md | 2 +- .../protocol-specs}/state/public-data-tree.md | 2 +- .../state/tree-implementations.md | 0 .../docs => docs/docs/protocol-specs}/todo.md | 0 .../protocol-specs}/transactions/index.md | 0 .../transactions/local-execution.md | 4 +- .../transactions/public-execution.md | 0 .../protocol-specs}/transactions/tx-object.md | 6 +- .../protocol-specs}/transactions/validity.md | 0 docs/docusaurus.config.js | 18 +- docs/package.json | 1 + docs/sidebars.js | 227 +- docs/src/katex-macros.js | 80 + .../InstructionSet/InstructionSet.js | 1624 ++++ .../InstructionSet/InstructionSize.js | 0 .../InstructionSet/genBitFormats.js | 0 .../preprocess/InstructionSet/genMarkdown.js | 162 + docs/src/preprocess/index.js | 4 + .../addresses-and-keys/image-1.png | Bin .../addresses-and-keys/image-3.png | Bin .../addresses-and-keys/image-4.png | Bin .../addresses-and-keys/image-5.png | Bin .../addresses-and-keys/image.png | Bin .../calls/pub_pvt_messaging.png | Bin .../calls/pvt_pub_ordering.png | Bin .../cryptography}/proof-system-components.png | Bin .../Aztec-Block-Production-1.png | Bin .../Aztec-Block-Production-2.png | Bin .../Aztec-Block-Production-3.png | Bin .../Aztec-Governance-Summary-1.png | Bin .../Aztec-Governance-Summary-2.png | Bin .../Aztec-Governance-Summary-3.png | Bin .../Aztec-Governance-Summary-4.png | Bin .../Aztec-Governance-Summary-5.png | Bin .../decentralization}/network.png | Bin .../gas-and-fees/Transaction.png | Bin .../l1-smart-contracts}/com-abs-6.png | Bin .../l1-smart-contracts}/frontier/image-1.png | Bin .../l1-smart-contracts}/frontier/image-2.png | Bin .../l1-smart-contracts}/frontier/image-3.png | Bin .../l1-smart-contracts}/frontier/image-4.png | Bin .../l1-smart-contracts}/frontier/image-5.png | Bin .../l1-smart-contracts}/frontier/image-6.png | Bin .../l1-smart-contracts}/frontier/image-7.png | Bin .../l1-smart-contracts}/tree-order.png | Bin .../img/protocol-specs/public-vm}/alu.png | Bin .../public-vm}/avm-control-flow.png | Bin .../public-vm}/bit-formats/ADD.png | Bin .../public-vm}/bit-formats/ADDRESS.png | Bin .../public-vm}/bit-formats/AND.png | Bin .../bit-formats/BLOCKDAGASLIMIT.png | Bin .../bit-formats/BLOCKHEADERBYNUM.png | Bin .../bit-formats/BLOCKL1GASLIMIT.png | Bin .../bit-formats/BLOCKL2GASLIMIT.png | Bin .../public-vm}/bit-formats/BLOCKNUMBER.png | Bin .../public-vm}/bit-formats/CALL.png | Bin .../public-vm}/bit-formats/CALLDATACOPY.png | Bin .../public-vm}/bit-formats/CAST.png | Bin .../public-vm}/bit-formats/CHAINID.png | Bin .../public-vm}/bit-formats/CMOV.png | Bin .../public-vm}/bit-formats/COINBASE.png | Bin .../bit-formats/CONTRACTCALLDEPTH.png | Bin .../public-vm}/bit-formats/DAGASLEFT.png | Bin .../public-vm}/bit-formats/DIV.png | Bin .../public-vm}/bit-formats/EMITNOTEHASH.png | Bin .../public-vm}/bit-formats/EMITNULLIFIER.png | Bin .../bit-formats/EMITUNENCRYPTEDLOG.png | Bin .../public-vm}/bit-formats/EQ.png | Bin .../public-vm}/bit-formats/FEEPERDAGAS.png | Bin .../public-vm}/bit-formats/FEEPERL1GAS.png | Bin .../public-vm}/bit-formats/FEEPERL2GAS.png | Bin .../bit-formats/INTERNALCALLDEPTH.png | Bin .../public-vm}/bit-formats/INTERNALRETURN.png | Bin .../public-vm}/bit-formats/JUMP.png | Bin .../public-vm}/bit-formats/JUMPI.png | Bin .../public-vm}/bit-formats/L1GASLEFT.png | Bin .../public-vm}/bit-formats/L2GASLEFT.png | Bin .../public-vm}/bit-formats/LT.png | Bin .../public-vm}/bit-formats/LTE.png | Bin .../public-vm}/bit-formats/MOV.png | Bin .../public-vm}/bit-formats/MUL.png | Bin .../public-vm}/bit-formats/NOT.png | Bin .../public-vm}/bit-formats/OR.png | Bin .../public-vm}/bit-formats/ORIGIN.png | Bin .../public-vm}/bit-formats/PORTAL.png | Bin .../public-vm}/bit-formats/READL1TOL2MSG.png | Bin .../public-vm}/bit-formats/RETURN.png | Bin .../public-vm}/bit-formats/REVERT.png | Bin .../public-vm}/bit-formats/SENDER.png | Bin .../public-vm}/bit-formats/SENDL2TOL1MSG.png | Bin .../public-vm}/bit-formats/SET.png | Bin .../public-vm}/bit-formats/SHL.png | Bin .../public-vm}/bit-formats/SHR.png | Bin .../public-vm}/bit-formats/SLOAD.png | Bin .../public-vm}/bit-formats/SSTORE.png | Bin .../public-vm}/bit-formats/STATICCALL.png | Bin .../public-vm}/bit-formats/STORAGEADDRESS.png | Bin .../public-vm}/bit-formats/SUB.png | Bin .../public-vm}/bit-formats/TIMESTAMP.png | Bin .../public-vm}/bit-formats/VERSION.png | Bin .../public-vm}/bit-formats/XOR.png | Bin .../public-vm}/bit-formats/internalcall.png | Bin .../img/protocol-specs/public-vm}/memory.png | Bin docs/yarn.lock | 74 +- l1-contracts/src/core/libraries/HeaderLib.sol | 2 +- .../src/contract/contract_address.ts | 2 +- .../private_function_membership_proof.ts | 2 +- ...unconstrained_function_membership_proof.ts | 2 +- yarn-project/foundation/src/fields/fields.ts | 2 +- .../src/avm/opcodes/context_getters.ts | 2 +- yellow-paper/.gitignore | 20 - yellow-paper/Dockerfile | 4 - yellow-paper/README.md | 41 - yellow-paper/babel.config.js | 3 - yellow-paper/docs-tutorial-reference/intro.md | 47 - .../tutorial-basics/_category_.json | 8 - .../tutorial-basics/congratulations.md | 23 - .../tutorial-basics/create-a-blog-post.md | 34 - .../tutorial-basics/create-a-document.md | 57 - .../tutorial-basics/create-a-page.md | 43 - .../tutorial-basics/deploy-your-site.md | 31 - .../tutorial-basics/markdown-features.mdx | 150 - .../tutorial-extras/_category_.json | 7 - .../img/docsVersionDropdown.png | Bin 25427 -> 0 bytes .../tutorial-extras/img/localeDropdown.png | Bin 27841 -> 0 bytes .../tutorial-extras/manage-docs-versions.md | 55 - .../tutorial-extras/translate-your-site.md | 88 - .../0-keys-latex-preamble.md | 90 - yellow-paper/docusaurus.config.js | 154 - yellow-paper/package.json | 52 - yellow-paper/sidebars.js | 236 - .../src/components/HomepageFeatures/index.tsx | 70 - .../HomepageFeatures/styles.module.css | 11 - yellow-paper/src/css/custom.css | 30 - yellow-paper/src/pages/index.module.css | 23 - yellow-paper/src/pages/index.tsx | 43 - yellow-paper/src/pages/markdown-page.md | 7 - .../InstructionSet/InstructionSet.js | 1256 --- .../preprocess/InstructionSet/genMarkdown.js | 139 - yellow-paper/src/preprocess/index.js | 6 - yellow-paper/static/.nojekyll | 0 yellow-paper/static/img/DO_NOT_USE.txt | 1 - .../static/img/docusaurus-social-card.jpg | Bin 55746 -> 0 bytes yellow-paper/static/img/docusaurus.png | Bin 5142 -> 0 bytes yellow-paper/static/img/favicon.ico | Bin 3626 -> 0 bytes yellow-paper/static/img/logo.svg | 1 - .../static/img/undraw_docusaurus_mountain.svg | 171 - .../static/img/undraw_docusaurus_react.svg | 170 - .../static/img/undraw_docusaurus_tree.svg | 40 - yellow-paper/tsconfig.json | 7 - yellow-paper/yarn.lock | 8277 ----------------- 240 files changed, 2421 insertions(+), 11686 deletions(-) rename {yellow-paper/docs => docs/docs/protocol-specs}/addresses-and-keys/address.md (98%) rename {yellow-paper/docs => docs/docs/protocol-specs}/addresses-and-keys/diversified-and-stealth.md (95%) rename yellow-paper/docs/addresses-and-keys/example-usage/diversified-and-stealth-keys.mdx => docs/docs/protocol-specs/addresses-and-keys/example-usage/diversified-and-stealth-keys.md (96%) rename yellow-paper/docs/addresses-and-keys/example-usage/encrypt-and-tag.mdx => docs/docs/protocol-specs/addresses-and-keys/example-usage/encrypt-and-tag.md (97%) rename yellow-paper/docs/addresses-and-keys/example-usage/nullifier.mdx => docs/docs/protocol-specs/addresses-and-keys/example-usage/nullifier.md (86%) rename yellow-paper/docs/addresses-and-keys/example-usage/tag-sequence-derivation.mdx => docs/docs/protocol-specs/addresses-and-keys/example-usage/tag-sequence-derivation.md (96%) rename {yellow-paper/docs => docs/docs/protocol-specs}/addresses-and-keys/index.md (85%) rename {yellow-paper/docs => docs/docs/protocol-specs}/addresses-and-keys/keys-requirements.md (100%) rename yellow-paper/docs/addresses-and-keys/keys.mdx => docs/docs/protocol-specs/addresses-and-keys/keys.md (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/addresses-and-keys/precompiles.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/bytecode/index.md (90%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/batched-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/delegate-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/enqueued-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/public-private-messaging.md (98%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/static-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/sync-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/calls/unconstrained-calls.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/high-level-topology.md (95%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/private-function.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/private-kernel-initial.mdx (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/private-kernel-inner.mdx (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/private-kernel-reset.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/private-kernel-tail.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/public-kernel-initial.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/public-kernel-inner.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/circuits/public-kernel-tail.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/constants.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/contract-deployment/classes.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/contract-deployment/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/contract-deployment/instances.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/hashing/hashing.md (92%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/hashing/pedersen.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/hashing/poseidon2.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/merkle-trees.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/proving-system/data-bus.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/proving-system/overview.md (98%) rename {yellow-paper/docs => docs/docs/protocol-specs}/cryptography/proving-system/performance-targets.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/data-publication-and-availability/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/data-publication-and-availability/overview.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/data-publication-and-availability/published-data.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/decentralization/actors.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/decentralization/block-production.md (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/decentralization/governance.md (97%) rename {yellow-paper/docs => docs/docs/protocol-specs}/decentralization/p2p-network.md (91%) rename {yellow-paper/docs => docs/docs/protocol-specs}/gas-and-fees/fee-payments-and-metering.md (97%) rename {yellow-paper/docs => docs/docs/protocol-specs}/gas-and-fees/fee-schedule.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/gas-and-fees/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/intro.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/l1-smart-contracts/frontier.md (87%) rename {yellow-paper/docs => docs/docs/protocol-specs}/l1-smart-contracts/index.md (92%) rename {yellow-paper/docs => docs/docs/protocol-specs}/logs/index.md (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/pre-compiled-contracts/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/pre-compiled-contracts/registry.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/private-message-delivery/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/private-message-delivery/private-msg-delivery.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/private-message-delivery/send-note-guidelines.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/_nested-context.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/alu.md (97%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/avm-circuit.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/bytecode-validation-circuit.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/circuit-index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/context.mdx (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/control-flow.md (97%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/execution.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/gen/_instruction-set.mdx (93%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/instruction-set.mdx (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/intro.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/memory-model.md (99%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/nested-calls.mdx (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/security.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/state.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/public-vm/type-structs.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/rollup-circuits/base-rollup.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/rollup-circuits/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/rollup-circuits/merge-rollup.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/rollup-circuits/root-rollup.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/rollup-circuits/tree-parity.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/archive.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/index.md (98%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/note-hash-tree.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/nullifier-tree.md (98%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/public-data-tree.md (96%) rename {yellow-paper/docs => docs/docs/protocol-specs}/state/tree-implementations.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/todo.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/transactions/index.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/transactions/local-execution.md (97%) rename {yellow-paper/docs => docs/docs/protocol-specs}/transactions/public-execution.md (100%) rename {yellow-paper/docs => docs/docs/protocol-specs}/transactions/tx-object.md (96%) rename {yellow-paper/docs => docs/docs/protocol-specs}/transactions/validity.md (100%) create mode 100644 docs/src/katex-macros.js create mode 100644 docs/src/preprocess/InstructionSet/InstructionSet.js rename {yellow-paper => docs}/src/preprocess/InstructionSet/InstructionSize.js (100%) rename {yellow-paper => docs}/src/preprocess/InstructionSet/genBitFormats.js (100%) create mode 100644 docs/src/preprocess/InstructionSet/genMarkdown.js rename {yellow-paper/docs/addresses-and-keys/images => docs/static/img/protocol-specs}/addresses-and-keys/image-1.png (100%) rename {yellow-paper/docs/addresses-and-keys/images => docs/static/img/protocol-specs}/addresses-and-keys/image-3.png (100%) rename {yellow-paper/docs/addresses-and-keys/images => docs/static/img/protocol-specs}/addresses-and-keys/image-4.png (100%) rename {yellow-paper/docs/addresses-and-keys/images => docs/static/img/protocol-specs}/addresses-and-keys/image-5.png (100%) rename {yellow-paper/docs/addresses-and-keys/images => docs/static/img/protocol-specs}/addresses-and-keys/image.png (100%) rename {yellow-paper/docs/calls/images => docs/static/img/protocol-specs}/calls/pub_pvt_messaging.png (100%) rename {yellow-paper/docs/calls/images => docs/static/img/protocol-specs}/calls/pvt_pub_ordering.png (100%) rename {yellow-paper/docs/cryptography/images => docs/static/img/protocol-specs/cryptography}/proof-system-components.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Block-Production-1.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Block-Production-2.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Block-Production-3.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Governance-Summary-1.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Governance-Summary-2.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Governance-Summary-3.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Governance-Summary-4.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/Aztec-Governance-Summary-5.png (100%) rename {yellow-paper/docs/decentralization/images => docs/static/img/protocol-specs/decentralization}/network.png (100%) rename {yellow-paper/docs/gas-and-fees/images => docs/static/img/protocol-specs}/gas-and-fees/Transaction.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/com-abs-6.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-1.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-2.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-3.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-4.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-5.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-6.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/frontier/image-7.png (100%) rename {yellow-paper/docs/l1-smart-contracts/images => docs/static/img/protocol-specs/l1-smart-contracts}/tree-order.png (100%) rename {yellow-paper/docs/public-vm/images => docs/static/img/protocol-specs/public-vm}/alu.png (100%) rename {yellow-paper/docs/public-vm/images => docs/static/img/protocol-specs/public-vm}/avm-control-flow.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/ADD.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/ADDRESS.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/AND.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/BLOCKDAGASLIMIT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/BLOCKHEADERBYNUM.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/BLOCKL1GASLIMIT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/BLOCKL2GASLIMIT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/BLOCKNUMBER.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CALL.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CALLDATACOPY.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CAST.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CHAINID.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CMOV.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/COINBASE.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/CONTRACTCALLDEPTH.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/DAGASLEFT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/DIV.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/EMITNOTEHASH.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/EMITNULLIFIER.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/EMITUNENCRYPTEDLOG.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/EQ.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/FEEPERDAGAS.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/FEEPERL1GAS.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/FEEPERL2GAS.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/INTERNALCALLDEPTH.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/INTERNALRETURN.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/JUMP.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/JUMPI.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/L1GASLEFT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/L2GASLEFT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/LT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/LTE.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/MOV.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/MUL.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/NOT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/OR.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/ORIGIN.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/PORTAL.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/READL1TOL2MSG.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/RETURN.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/REVERT.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SENDER.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SENDL2TOL1MSG.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SET.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SHL.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SHR.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SLOAD.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SSTORE.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/STATICCALL.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/STORAGEADDRESS.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/SUB.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/TIMESTAMP.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/VERSION.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/XOR.png (100%) rename {yellow-paper/docs/public-vm/gen/images => docs/static/img/protocol-specs/public-vm}/bit-formats/internalcall.png (100%) rename {yellow-paper/docs/public-vm/images => docs/static/img/protocol-specs/public-vm}/memory.png (100%) delete mode 100644 yellow-paper/.gitignore delete mode 100644 yellow-paper/Dockerfile delete mode 100644 yellow-paper/README.md delete mode 100644 yellow-paper/babel.config.js delete mode 100644 yellow-paper/docs-tutorial-reference/intro.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/_category_.json delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/congratulations.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-blog-post.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-document.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-page.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/deploy-your-site.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-basics/markdown-features.mdx delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-extras/_category_.json delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-extras/img/docsVersionDropdown.png delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-extras/img/localeDropdown.png delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-extras/manage-docs-versions.md delete mode 100644 yellow-paper/docs-tutorial-reference/tutorial-extras/translate-your-site.md delete mode 100644 yellow-paper/docs/addresses-and-keys/0-keys-latex-preamble.md delete mode 100644 yellow-paper/docusaurus.config.js delete mode 100644 yellow-paper/package.json delete mode 100644 yellow-paper/sidebars.js delete mode 100644 yellow-paper/src/components/HomepageFeatures/index.tsx delete mode 100644 yellow-paper/src/components/HomepageFeatures/styles.module.css delete mode 100644 yellow-paper/src/css/custom.css delete mode 100644 yellow-paper/src/pages/index.module.css delete mode 100644 yellow-paper/src/pages/index.tsx delete mode 100644 yellow-paper/src/pages/markdown-page.md delete mode 100644 yellow-paper/src/preprocess/InstructionSet/InstructionSet.js delete mode 100644 yellow-paper/src/preprocess/InstructionSet/genMarkdown.js delete mode 100644 yellow-paper/src/preprocess/index.js delete mode 100644 yellow-paper/static/.nojekyll delete mode 100644 yellow-paper/static/img/DO_NOT_USE.txt delete mode 100644 yellow-paper/static/img/docusaurus-social-card.jpg delete mode 100644 yellow-paper/static/img/docusaurus.png delete mode 100644 yellow-paper/static/img/favicon.ico delete mode 100644 yellow-paper/static/img/logo.svg delete mode 100644 yellow-paper/static/img/undraw_docusaurus_mountain.svg delete mode 100644 yellow-paper/static/img/undraw_docusaurus_react.svg delete mode 100644 yellow-paper/static/img/undraw_docusaurus_tree.svg delete mode 100644 yellow-paper/tsconfig.json delete mode 100644 yellow-paper/yarn.lock diff --git a/.circleci/config.yml b/.circleci/config.yml index dee04c71758..29418495446 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -807,18 +807,6 @@ jobs: echo "Deploying docs" docs/deploy_netlify.sh $BRANCH $PULL_REQUEST - yellow-paper: - machine: - image: default - resource_class: large - steps: - - *checkout - - *setup_env - - run: - name: "Build yellow paper" - command: build yellow-paper - aztec_manifest_key: yellow-paper - e2e-join: docker: - image: cimg/base:2023.09 @@ -1073,8 +1061,6 @@ workflows: - mainnet-fork: *defaults - - yellow-paper: *defaults - - noir-projects: requires: - avm-transpiler @@ -1178,7 +1164,6 @@ workflows: - guides-up-quick-start - boxes-vanilla - boxes-react - - yellow-paper - noir-packages-tests - yarn-project-test - prover-client-test diff --git a/.vscode/settings.json b/.vscode/settings.json index 21f55227f99..8661488d112 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -125,10 +125,6 @@ "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }, - // Now when a new file is pasted in /yellow-paper/docs/readme.md, the image file is created at /yellow-paper/docs/images/readme/image.png. - "markdown.copyFiles.destination": { - "/yellow-paper/**/*": "images/${documentBaseName}/" - }, /////////////////////////////////////// // C++/Circuits settings /////////////////////////////////////// diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 50e57f5789f..501ea2492a6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,9 +25,10 @@ When opening the pull request you will be presented with a template and a series If you're looking for a good place to start, look for issues labeled ["good first issue"](https://github.com/AztecProtocol/aztec-packages/labels/good%20first%20issue)! ## Pull request checklist: + - I've provided a paragraph or two giving a summary of the change in the description, including relevant motivation and context. - I've enabled auto-merge if the PR is ready to merge. -- I have updated the yellow paper when making changes to associated functionality (e.g. outward-facing spec changes). +- I have updated the protocol specs in the docs (aka the yellow paper) when making changes to associated functionality (e.g. outward-facing spec changes). - I have reviewed my diff in github, line by line and removed unexpected formatting changes, testing logs, or commented-out code. - Every change is related to the PR description. - I have [linked](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) this pull request to relevant issues (if any exist). diff --git a/avm-transpiler/src/opcodes.rs b/avm-transpiler/src/opcodes.rs index 38d26fa31f1..1ee44d1210c 100644 --- a/avm-transpiler/src/opcodes.rs +++ b/avm-transpiler/src/opcodes.rs @@ -1,5 +1,5 @@ /// All AVM opcodes -/// Keep updated with TS and yellow paper! +/// Keep updated with TS and docs protocol specs! #[derive(PartialEq, Copy, Clone, Debug)] pub enum AvmOpcode { // Compute diff --git a/build_manifest.yml b/build_manifest.yml index afba6e3820f..eb20879ecae 100644 --- a/build_manifest.yml +++ b/build_manifest.yml @@ -263,8 +263,3 @@ docs: - noir-packages - l1-contracts - noir-projects - -yellow-paper: - buildDir: yellow-paper - rebuildPatterns: - - ^yellow-paper/ diff --git a/yellow-paper/docs/addresses-and-keys/address.md b/docs/docs/protocol-specs/addresses-and-keys/address.md similarity index 98% rename from yellow-paper/docs/addresses-and-keys/address.md rename to docs/docs/protocol-specs/addresses-and-keys/address.md index e2fc1a1acff..5cd2e3ac20d 100644 --- a/yellow-paper/docs/addresses-and-keys/address.md +++ b/docs/docs/protocol-specs/addresses-and-keys/address.md @@ -73,7 +73,7 @@ address_crh( } ``` -The `public_keys` array can vary depending on the format of keys used by the address, but it is suggested it includes the master keys defined in the [keys section](./keys.mdx). For example: +The `public_keys` array can vary depending on the format of keys used by the address, but it is suggested it includes the master keys defined in the [keys section](./keys.md). For example: ```rust let public_keys_hash: Field = poseidon2( diff --git a/yellow-paper/docs/addresses-and-keys/diversified-and-stealth.md b/docs/docs/protocol-specs/addresses-and-keys/diversified-and-stealth.md similarity index 95% rename from yellow-paper/docs/addresses-and-keys/diversified-and-stealth.md rename to docs/docs/protocol-specs/addresses-and-keys/diversified-and-stealth.md index f4fc8613f80..51a274e12b4 100644 --- a/yellow-paper/docs/addresses-and-keys/diversified-and-stealth.md +++ b/docs/docs/protocol-specs/addresses-and-keys/diversified-and-stealth.md @@ -2,7 +2,7 @@ title: Diversified and Stealth Accounts --- -The [keys specification](./keys.mdx) describes derivation mechanisms for diversified and stealth public keys. However, the protocol requires users to interact with addresses. +The [keys specification](./keys.md) describes derivation mechanisms for diversified and stealth public keys. However, the protocol requires users to interact with addresses. ## Computing Addresses diff --git a/yellow-paper/docs/addresses-and-keys/example-usage/diversified-and-stealth-keys.mdx b/docs/docs/protocol-specs/addresses-and-keys/example-usage/diversified-and-stealth-keys.md similarity index 96% rename from yellow-paper/docs/addresses-and-keys/example-usage/diversified-and-stealth-keys.mdx rename to docs/docs/protocol-specs/addresses-and-keys/example-usage/diversified-and-stealth-keys.md index b973e567ff5..fed3329e895 100644 --- a/yellow-paper/docs/addresses-and-keys/example-usage/diversified-and-stealth-keys.mdx +++ b/docs/docs/protocol-specs/addresses-and-keys/example-usage/diversified-and-stealth-keys.md @@ -1,8 +1,3 @@ - - -import LatexPreamble from "../0-keys-latex-preamble.md"; -; - ## Deriving diversified public keys A diversified public key can be derived from Alice's keys, to enhance Alice's transaction privacy. If Alice's counterparties' databases are compromised, it enables Alice to retain privacy from such leakages. Diversified public keys are used for generating diversified addresses. diff --git a/yellow-paper/docs/addresses-and-keys/example-usage/encrypt-and-tag.mdx b/docs/docs/protocol-specs/addresses-and-keys/example-usage/encrypt-and-tag.md similarity index 97% rename from yellow-paper/docs/addresses-and-keys/example-usage/encrypt-and-tag.mdx rename to docs/docs/protocol-specs/addresses-and-keys/example-usage/encrypt-and-tag.md index 92835a848e9..c25642d832f 100644 --- a/yellow-paper/docs/addresses-and-keys/example-usage/encrypt-and-tag.mdx +++ b/docs/docs/protocol-specs/addresses-and-keys/example-usage/encrypt-and-tag.md @@ -1,8 +1,3 @@ - - -import LatexPreamble from "../0-keys-latex-preamble.md"; -; - ## Encrypt and tag an incoming message Bob wants to send Alice a private message, e.g. the contents of a note, which we'll refer to as the $\plaintext$. Bob and Alice are using a "tag hopping" scheme to help with note discovery. Let's assume they've already handshaked to establish a shared secret $\sharedsecret_{m,tagging}^{Bob \rightarrow Alice}$, from which a sequence of tags $\tagg_{m,i}^{Bob \rightarrow Alice}$ can be derived. diff --git a/yellow-paper/docs/addresses-and-keys/example-usage/nullifier.mdx b/docs/docs/protocol-specs/addresses-and-keys/example-usage/nullifier.md similarity index 86% rename from yellow-paper/docs/addresses-and-keys/example-usage/nullifier.mdx rename to docs/docs/protocol-specs/addresses-and-keys/example-usage/nullifier.md index 6504066b7ce..5c3419d8fbe 100644 --- a/yellow-paper/docs/addresses-and-keys/example-usage/nullifier.mdx +++ b/docs/docs/protocol-specs/addresses-and-keys/example-usage/nullifier.md @@ -1,8 +1,3 @@ - - -import LatexPreamble from "../0-keys-latex-preamble.md"; -; - ## Deriving a nullifier within an app contract Let's assume a developer wants a nullifier of a note to be derived as: @@ -17,14 +12,14 @@ Here's example for how an app circuit _could_ constrain the nullifier key to be It's easiest to take a look at this first: -![Alt text](../images/addresses-and-keys/image.png) +![Alt text](/img/protocol-specs/addresses-and-keys/image.png) ### Within the app circuit Within the app, we can prove links between: -- the user's [$\nskapp$](../keys.mdx#app-siloed-nullifier-secret-key) and their [$\Nkapp$](../keys.mdx#app-siloed-nullifier-key); and between -- the user's [$\Npkm$](../keys.mdx#master-nullifier-public-key) and their [$\address$](../address.md). +- the user's [$\nskapp$](../keys.md#app-siloed-nullifier-secret-key) and their [$\Nkapp$](../keys.md#app-siloed-nullifier-key); and between +- the user's [$\Npkm$](../keys.md#master-nullifier-public-key) and their [$\address$](../address.md). The link that's missing is to prove that $\Npkm$ relates to $\nskapp$. To compute this missing link requires the $\nskm$, which MUST NOT be passed into an app circuit, and may only be passed into a kernel circuit. See the next ['Within the kernel circuit'](#within-the-kernel-circuit) section for details of this logic. diff --git a/yellow-paper/docs/addresses-and-keys/example-usage/tag-sequence-derivation.mdx b/docs/docs/protocol-specs/addresses-and-keys/example-usage/tag-sequence-derivation.md similarity index 96% rename from yellow-paper/docs/addresses-and-keys/example-usage/tag-sequence-derivation.mdx rename to docs/docs/protocol-specs/addresses-and-keys/example-usage/tag-sequence-derivation.md index 4919c665fce..3484ec38560 100644 --- a/yellow-paper/docs/addresses-and-keys/example-usage/tag-sequence-derivation.mdx +++ b/docs/docs/protocol-specs/addresses-and-keys/example-usage/tag-sequence-derivation.md @@ -1,8 +1,3 @@ - - -import LatexPreamble from "../0-keys-latex-preamble.md"; -; - # Handshaking for tag-hopping Deriving a sequence of tags for tag-hopping. diff --git a/yellow-paper/docs/addresses-and-keys/index.md b/docs/docs/protocol-specs/addresses-and-keys/index.md similarity index 85% rename from yellow-paper/docs/addresses-and-keys/index.md rename to docs/docs/protocol-specs/addresses-and-keys/index.md index bc0f6f27ab5..d9c2730d8fd 100644 --- a/yellow-paper/docs/addresses-and-keys/index.md +++ b/docs/docs/protocol-specs/addresses-and-keys/index.md @@ -14,7 +14,7 @@ Keys in Aztec are used both for authorization and privacy. Authorization keys ar Privacy keys are used for note encryption, tagging, and nullifying. These are also not enforced by the protocol. However, for facilitating composability, the protocol enshrines a set of enshrined encryption and tagging mechanisms, that can be leveraged by applications as they interact with accounts. -The [requirements](./keys-requirements.md) section outlines the features that were sought when designing Aztec's addresses and keys. We then specify how [addresses](./address.md) are derived, as well as the default way in which [keys](./keys.mdx) will be derived. The [precompiles](./precompiles.md) section describes enshrined contract addresses, with implementations defined by the protocol, used for note encryption and tagging. +The [requirements](./keys-requirements.md) section outlines the features that were sought when designing Aztec's addresses and keys. We then specify how [addresses](./address.md) are derived, as well as the default way in which [keys](./keys.md) will be derived. The [precompiles](./precompiles.md) section describes enshrined contract addresses, with implementations defined by the protocol, used for note encryption and tagging. Last, the [diversified and stealth accounts](./diversified-and-stealth.md) sections describe application-level recommendations for diversified and stealth accounts. diff --git a/yellow-paper/docs/addresses-and-keys/keys-requirements.md b/docs/docs/protocol-specs/addresses-and-keys/keys-requirements.md similarity index 100% rename from yellow-paper/docs/addresses-and-keys/keys-requirements.md rename to docs/docs/protocol-specs/addresses-and-keys/keys-requirements.md diff --git a/yellow-paper/docs/addresses-and-keys/keys.mdx b/docs/docs/protocol-specs/addresses-and-keys/keys.md similarity index 99% rename from yellow-paper/docs/addresses-and-keys/keys.mdx rename to docs/docs/protocol-specs/addresses-and-keys/keys.md index 03eb55d1544..3e275e60dd7 100644 --- a/yellow-paper/docs/addresses-and-keys/keys.mdx +++ b/docs/docs/protocol-specs/addresses-and-keys/keys.md @@ -7,9 +7,6 @@ description: Specification for default privacy keys format and derivation, and n -import LatexPreamble from "./0-keys-latex-preamble.md"; -; - ## Cheat Sheet The protocol does not enforce the usage of any of the following keys, and does not enforce the keys to conform to a particular length or algorithm. Users are expected to pick a set of keys valid for the encryption and tagging precompile they choose for their account. @@ -51,7 +48,7 @@ The protocol does not enforce the usage of any of the following keys, and does n Diagram is out of date vs the content on this page ::: -![Alt text](images/addresses-and-keys/image-5.png) + The red boxes are uncertainties, which are explained later in this doc. diff --git a/yellow-paper/docs/addresses-and-keys/precompiles.md b/docs/docs/protocol-specs/addresses-and-keys/precompiles.md similarity index 100% rename from yellow-paper/docs/addresses-and-keys/precompiles.md rename to docs/docs/protocol-specs/addresses-and-keys/precompiles.md diff --git a/yellow-paper/docs/bytecode/index.md b/docs/docs/protocol-specs/bytecode/index.md similarity index 90% rename from yellow-paper/docs/bytecode/index.md rename to docs/docs/protocol-specs/bytecode/index.md index a7484820b14..4f54d240c5f 100644 --- a/yellow-paper/docs/bytecode/index.md +++ b/docs/docs/protocol-specs/bytecode/index.md @@ -42,7 +42,7 @@ There are three different (but related) bytecode standards that are used in Azte # AVM Bytecode -The AVM bytecode is the compilation target of the public functions of a contract. It's specified in the [AVM section](../public-vm/instruction-set). It allows control flow and uses a flat memory model which tracks bit sizes of values stored in memory via tagging of memory indexes. Sequencers run the AVM bytecode of the public functions of a contract using the AVM and prove the correct execution of it. +The AVM bytecode is the compilation target of the public functions of a contract. It's specified in the [AVM section](../public-vm/instruction-set.mdx). It allows control flow and uses a flat memory model which tracks bit sizes of values stored in memory via tagging of memory indexes. Sequencers run the AVM bytecode of the public functions of a contract using the AVM and prove the correct execution of it. # Brillig Bytecode @@ -52,7 +52,7 @@ Brillig bytecode will be very similar to AVM bytecode. While AVM bytecode is spe Oracles allow nondeterminism during the execution of a given function, allowing the simulator entity to choose the value that an oracle will return during the simulation process. Oracles are heavily used by aztec.nr to fetch data during simulation of private and unconstrained functions, such as fetching notes. They are also used to notify the simulator about events arising during execution, such as a nullified note so that it's not offered again during the simulation. -However, AVM bytecode doesn't allow arbitrary oracles, any nondeterminism introduced is done in a way that the protocol can ensure that the simulator entity (the sequencer) cannot manipulate the result of an oracle. As such, when transforming brillig bytecode to AVM bytecode, all the oracles are replaced by the specific opcodes that the AVM supports for nondeterminism, like [TIMESTAMP](../public-vm/instruction-set#isa-section-timestamp), [ADDRESS](../public-vm/instruction-set#isa-section-address), etc. Any opcode that requires the simulator entity to provide data external to the AVM memory is non-deterministic. +However, AVM bytecode doesn't allow arbitrary oracles, any nondeterminism introduced is done in a way that the protocol can ensure that the simulator entity (the sequencer) cannot manipulate the result of an oracle. As such, when transforming brillig bytecode to AVM bytecode, all the oracles are replaced by the specific opcodes that the AVM supports for nondeterminism, like [TIMESTAMP](../public-vm/instruction-set.mdx#isa-section-timestamp), [ADDRESS](../public-vm/instruction-set.mdx#isa-section-address), etc. Any opcode that requires the simulator entity to provide data external to the AVM memory is non-deterministic. The current implementation of Brillig can be found [in the noir repository](https://github.com/noir-lang/noir/blob/master/acvm-repo/brillig/src/opcodes.rs#L60). It's actively being changed to become "AVM bytecode without arbitrary oracles" and right now the differences are handled by a transpiler. @@ -73,7 +73,7 @@ This implies that a block of ACIR bytecode can represent more than one program, ## Compiling a contract -When a contract is compiled, an artifact will be generated. This artifact needs to be hashed in a specific manner [detailed in the deployment section](../contract-deployment/classes#artifact-hash) for publishing. +When a contract is compiled, an artifact will be generated. This artifact needs to be hashed in a specific manner [detailed in the deployment section](../contract-deployment/classes.md#artifact-hash) for publishing. The exact form of the artifact is not specified by the protocol, but it needs at least the following information: @@ -148,19 +148,19 @@ If the function is public, the entry will be its ABI. If the function is private ### Bytecode in the artifact -The protocol mandates that public bytecode needs to be published to a data availability solution, since the sequencers need to have the data available to run the public functions. Also, it needs to use an encoding that is friendly to the public VM, such as the one specified in the [AVM section](../public-vm/bytecode-validation-circuit). +The protocol mandates that public bytecode needs to be published to a data availability solution, since the sequencers need to have the data available to run the public functions. Also, it needs to use an encoding that is friendly to the public VM, such as the one specified in the [AVM section](../public-vm/bytecode-validation-circuit.md). -The bytecode of private and unconstrained functions doesn't need to be published, instead, users that desire to use a given contract can add the artifact to their PXE before interacting with it. Publishing it is [supported but not required](../contract-deployment/classes/#broadcast) by the protocol. However, the verification key of a private function is hashed into the function's leaf of the contract's function tree, so the user can prove to the protocol that he executed the function correctly. Also, contract classes contain an [artifact hash](../contract-deployment/classes#artifact-hash) so the PXE can verify that the artifact corresponds with the contract class. +The bytecode of private and unconstrained functions doesn't need to be published, instead, users that desire to use a given contract can add the artifact to their PXE before interacting with it. Publishing it is [supported but not required](../contract-deployment/classes.md#broadcast) by the protocol. However, the verification key of a private function is hashed into the function's leaf of the contract's function tree, so the user can prove to the protocol that he executed the function correctly. Also, contract classes contain an [artifact hash](../contract-deployment/classes.md#artifact-hash) so the PXE can verify that the artifact corresponds with the contract class. The encoding of private and unconstrained functions is not specified by the protocol, but it's recommended to follow [the encoding](https://github.com/noir-lang/noir/blob/master/acvm-repo/acir/src/circuit/mod.rs#L157) that Barretenberg and the ACVM share that is serialization using bincode and gzip for compression. -This implies that the encoding of private and unconstrained functions does not need to be friendly to circuits, since when publishing it the protocol only sees a [generic array of field elements](../contract-deployment/classes#broadcast). +This implies that the encoding of private and unconstrained functions does not need to be friendly to circuits, since when publishing it the protocol only sees a [generic array of field elements](../contract-deployment/classes.md#broadcast). ## Executing a private function When executing a private function, its ACIR bytecode will be executed by the PXE using the ACVM. The ACVM will generate the witness of the execution. The proving system can be used to generate a proof of the correctness of the witness. -The fact that the correct function was executed is checked by the protocol by verifying that the [contract class ID](../contract-deployment/classes#class-identifier) contains one leaf in the function tree with this selector and the verification key of the function. +The fact that the correct function was executed is checked by the protocol by verifying that the [contract class ID](../contract-deployment/classes.md#class-identifier) contains one leaf in the function tree with this selector and the verification key of the function. ## Executing an unconstrained function @@ -170,4 +170,4 @@ When executing an unconstrained function, its Brillig bytecode will be executed When executing a public function, its AVM bytecode will be executed by the sequencer with the specified selector and arguments. The sequencer will generate a public VM proof of the correct execution of the AVM bytecode. -The fact that the correct bytecode was executed is checked by the protocol by verifying that the [contract class ID](../contract-deployment/classes#class-identifier) contains the [commitment](../public-vm/bytecode-validation-circuit#committed-representation) to the bytecode used. +The fact that the correct bytecode was executed is checked by the protocol by verifying that the [contract class ID](../contract-deployment/classes.md#class-identifier) contains the [commitment](../public-vm/bytecode-validation-circuit.md#committed-representation) to the bytecode used. diff --git a/yellow-paper/docs/calls/batched-calls.md b/docs/docs/protocol-specs/calls/batched-calls.md similarity index 100% rename from yellow-paper/docs/calls/batched-calls.md rename to docs/docs/protocol-specs/calls/batched-calls.md diff --git a/yellow-paper/docs/calls/delegate-calls.md b/docs/docs/protocol-specs/calls/delegate-calls.md similarity index 100% rename from yellow-paper/docs/calls/delegate-calls.md rename to docs/docs/protocol-specs/calls/delegate-calls.md diff --git a/yellow-paper/docs/calls/enqueued-calls.md b/docs/docs/protocol-specs/calls/enqueued-calls.md similarity index 100% rename from yellow-paper/docs/calls/enqueued-calls.md rename to docs/docs/protocol-specs/calls/enqueued-calls.md diff --git a/yellow-paper/docs/calls/index.md b/docs/docs/protocol-specs/calls/index.md similarity index 100% rename from yellow-paper/docs/calls/index.md rename to docs/docs/protocol-specs/calls/index.md diff --git a/yellow-paper/docs/calls/public-private-messaging.md b/docs/docs/protocol-specs/calls/public-private-messaging.md similarity index 98% rename from yellow-paper/docs/calls/public-private-messaging.md rename to docs/docs/protocol-specs/calls/public-private-messaging.md index 9d8e164625c..edbe6720dce 100644 --- a/yellow-paper/docs/calls/public-private-messaging.md +++ b/docs/docs/protocol-specs/calls/public-private-messaging.md @@ -81,4 +81,4 @@ To elaborate, a public function may not have read access to encrypted private st In the picture below, it is worth noting that all data reads performed by private functions are historical in nature, and that private functions are not capable of modifying public storage. Conversely, public functions have the capacity to manipulate private storage (e.g., inserting new note hashes, potentially as part of transferring funds from the public domain to the private domain). -![Public - Private Messaging](./images/calls/pub_pvt_messaging.png) +![Public - Private Messaging](/img/protocol-specs/calls/pub_pvt_messaging.png) diff --git a/yellow-paper/docs/calls/static-calls.md b/docs/docs/protocol-specs/calls/static-calls.md similarity index 100% rename from yellow-paper/docs/calls/static-calls.md rename to docs/docs/protocol-specs/calls/static-calls.md diff --git a/yellow-paper/docs/calls/sync-calls.md b/docs/docs/protocol-specs/calls/sync-calls.md similarity index 100% rename from yellow-paper/docs/calls/sync-calls.md rename to docs/docs/protocol-specs/calls/sync-calls.md diff --git a/yellow-paper/docs/calls/unconstrained-calls.md b/docs/docs/protocol-specs/calls/unconstrained-calls.md similarity index 100% rename from yellow-paper/docs/calls/unconstrained-calls.md rename to docs/docs/protocol-specs/calls/unconstrained-calls.md diff --git a/yellow-paper/docs/circuits/high-level-topology.md b/docs/docs/protocol-specs/circuits/high-level-topology.md similarity index 95% rename from yellow-paper/docs/circuits/high-level-topology.md rename to docs/docs/protocol-specs/circuits/high-level-topology.md index a25e9b5007d..43f00cb05ea 100644 --- a/yellow-paper/docs/circuits/high-level-topology.md +++ b/docs/docs/protocol-specs/circuits/high-level-topology.md @@ -9,7 +9,7 @@ Once all functions in a transaction are executed, the accumulated data is output To illustrate, consider a transaction involving the following functions, where circles depict private functions, and squares denote public functions: :::info -A note for Aztec protocol developers: In this yellow paper, the order in which the kernel circuit processes calls is different from previous literature, and is different from the current implementation (as at January 2024). +A note for Aztec protocol developers: In this protocol spec, the order in which the kernel circuit processes calls is different from previous literature, and is different from the current implementation (as at January 2024). ::: + diff --git a/yellow-paper/docs/circuits/private-kernel-inner.mdx b/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx similarity index 99% rename from yellow-paper/docs/circuits/private-kernel-inner.mdx rename to docs/docs/protocol-specs/circuits/private-kernel-inner.mdx index 1f13b5f3b5c..ca4e5af9cce 100644 --- a/yellow-paper/docs/circuits/private-kernel-inner.mdx +++ b/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx @@ -1,6 +1,6 @@ # Private Kernel Circuit - Inner - + ## Requirements diff --git a/yellow-paper/docs/circuits/private-kernel-reset.md b/docs/docs/protocol-specs/circuits/private-kernel-reset.md similarity index 100% rename from yellow-paper/docs/circuits/private-kernel-reset.md rename to docs/docs/protocol-specs/circuits/private-kernel-reset.md diff --git a/yellow-paper/docs/circuits/private-kernel-tail.md b/docs/docs/protocol-specs/circuits/private-kernel-tail.md similarity index 100% rename from yellow-paper/docs/circuits/private-kernel-tail.md rename to docs/docs/protocol-specs/circuits/private-kernel-tail.md diff --git a/yellow-paper/docs/circuits/public-kernel-initial.md b/docs/docs/protocol-specs/circuits/public-kernel-initial.md similarity index 100% rename from yellow-paper/docs/circuits/public-kernel-initial.md rename to docs/docs/protocol-specs/circuits/public-kernel-initial.md diff --git a/yellow-paper/docs/circuits/public-kernel-inner.md b/docs/docs/protocol-specs/circuits/public-kernel-inner.md similarity index 100% rename from yellow-paper/docs/circuits/public-kernel-inner.md rename to docs/docs/protocol-specs/circuits/public-kernel-inner.md diff --git a/yellow-paper/docs/circuits/public-kernel-tail.md b/docs/docs/protocol-specs/circuits/public-kernel-tail.md similarity index 100% rename from yellow-paper/docs/circuits/public-kernel-tail.md rename to docs/docs/protocol-specs/circuits/public-kernel-tail.md diff --git a/yellow-paper/docs/constants.md b/docs/docs/protocol-specs/constants.md similarity index 100% rename from yellow-paper/docs/constants.md rename to docs/docs/protocol-specs/constants.md diff --git a/yellow-paper/docs/contract-deployment/classes.md b/docs/docs/protocol-specs/contract-deployment/classes.md similarity index 100% rename from yellow-paper/docs/contract-deployment/classes.md rename to docs/docs/protocol-specs/contract-deployment/classes.md diff --git a/yellow-paper/docs/contract-deployment/index.md b/docs/docs/protocol-specs/contract-deployment/index.md similarity index 100% rename from yellow-paper/docs/contract-deployment/index.md rename to docs/docs/protocol-specs/contract-deployment/index.md diff --git a/yellow-paper/docs/contract-deployment/instances.md b/docs/docs/protocol-specs/contract-deployment/instances.md similarity index 100% rename from yellow-paper/docs/contract-deployment/instances.md rename to docs/docs/protocol-specs/contract-deployment/instances.md diff --git a/yellow-paper/docs/cryptography/hashing/hashing.md b/docs/docs/protocol-specs/cryptography/hashing/hashing.md similarity index 92% rename from yellow-paper/docs/cryptography/hashing/hashing.md rename to docs/docs/protocol-specs/cryptography/hashing/hashing.md index d720c250cc9..a3e4cb5f5e7 100644 --- a/yellow-paper/docs/cryptography/hashing/hashing.md +++ b/docs/docs/protocol-specs/cryptography/hashing/hashing.md @@ -24,6 +24,6 @@ Pseudo-randomness is required in cases such as: - Fiat-Shamir challenge generation. - Expanding a random seed to generate additional randomness. - - See the derivation of [master secret keys](../../addresses-and-keys/keys.mdx#master-keys). + - See the derivation of [master secret keys](../../addresses-and-keys/keys.md#master-keys). - Deriving a nullifier, and siloing a nullifier. - - See [deriving a nullifier](../../addresses-and-keys/keys.mdx#deriving-a-nullifier-within-an-app-contract). + - See [deriving a nullifier](../../addresses-and-keys/keys.md#deriving-a-nullifier-within-an-app-contract). diff --git a/yellow-paper/docs/cryptography/hashing/pedersen.md b/docs/docs/protocol-specs/cryptography/hashing/pedersen.md similarity index 100% rename from yellow-paper/docs/cryptography/hashing/pedersen.md rename to docs/docs/protocol-specs/cryptography/hashing/pedersen.md diff --git a/yellow-paper/docs/cryptography/hashing/poseidon2.md b/docs/docs/protocol-specs/cryptography/hashing/poseidon2.md similarity index 100% rename from yellow-paper/docs/cryptography/hashing/poseidon2.md rename to docs/docs/protocol-specs/cryptography/hashing/poseidon2.md diff --git a/yellow-paper/docs/cryptography/index.md b/docs/docs/protocol-specs/cryptography/index.md similarity index 100% rename from yellow-paper/docs/cryptography/index.md rename to docs/docs/protocol-specs/cryptography/index.md diff --git a/yellow-paper/docs/cryptography/merkle-trees.md b/docs/docs/protocol-specs/cryptography/merkle-trees.md similarity index 100% rename from yellow-paper/docs/cryptography/merkle-trees.md rename to docs/docs/protocol-specs/cryptography/merkle-trees.md diff --git a/yellow-paper/docs/cryptography/proving-system/data-bus.md b/docs/docs/protocol-specs/cryptography/proving-system/data-bus.md similarity index 100% rename from yellow-paper/docs/cryptography/proving-system/data-bus.md rename to docs/docs/protocol-specs/cryptography/proving-system/data-bus.md diff --git a/yellow-paper/docs/cryptography/proving-system/overview.md b/docs/docs/protocol-specs/cryptography/proving-system/overview.md similarity index 98% rename from yellow-paper/docs/cryptography/proving-system/overview.md rename to docs/docs/protocol-specs/cryptography/proving-system/overview.md index f7f786a257e..c76a01969d0 100644 --- a/yellow-paper/docs/cryptography/proving-system/overview.md +++ b/docs/docs/protocol-specs/cryptography/proving-system/overview.md @@ -62,7 +62,7 @@ The "Fold" Prover/Verifier validates that `k` instances of a defined relation (i #### Protogalaxy Decider -The "Decider" Prover/Verifier validate whether an accumulator instance correctly satisfies the accumulator relation. The accumulator being satisfiable inductively shows that all instances that have been folded were satisfied as well. (additional protocol checks are required to reason about _which_ instances have been folded into the accumulator. See the [IVC specification](https://hackmd.io/h0yTcOHiQWeeTXnxTQhTNQ?view) for more information. (note to zac: put this in the yellow paper!) +The "Decider" Prover/Verifier validate whether an accumulator instance correctly satisfies the accumulator relation. The accumulator being satisfiable inductively shows that all instances that have been folded were satisfied as well. (additional protocol checks are required to reason about _which_ instances have been folded into the accumulator. See the [IVC specification](https://hackmd.io/h0yTcOHiQWeeTXnxTQhTNQ?view) for more information. (note to zac: put this in the protocol specs!) ## Goblin Plonk @@ -122,4 +122,4 @@ To batch-verify multiple opening proofs, we use the technique articulated in the The following block diagrams describe the components used by the client-side and server-side Provers when computing client proofs and rollup proofs respectively. -![proof-system-components](../images/proof-system-components.png) +![proof-system-components](/img/protocol-specs/cryptography/proof-system-components.png) diff --git a/yellow-paper/docs/cryptography/proving-system/performance-targets.md b/docs/docs/protocol-specs/cryptography/proving-system/performance-targets.md similarity index 100% rename from yellow-paper/docs/cryptography/proving-system/performance-targets.md rename to docs/docs/protocol-specs/cryptography/proving-system/performance-targets.md diff --git a/yellow-paper/docs/data-publication-and-availability/index.md b/docs/docs/protocol-specs/data-publication-and-availability/index.md similarity index 100% rename from yellow-paper/docs/data-publication-and-availability/index.md rename to docs/docs/protocol-specs/data-publication-and-availability/index.md diff --git a/yellow-paper/docs/data-publication-and-availability/overview.md b/docs/docs/protocol-specs/data-publication-and-availability/overview.md similarity index 100% rename from yellow-paper/docs/data-publication-and-availability/overview.md rename to docs/docs/protocol-specs/data-publication-and-availability/overview.md diff --git a/yellow-paper/docs/data-publication-and-availability/published-data.md b/docs/docs/protocol-specs/data-publication-and-availability/published-data.md similarity index 100% rename from yellow-paper/docs/data-publication-and-availability/published-data.md rename to docs/docs/protocol-specs/data-publication-and-availability/published-data.md diff --git a/yellow-paper/docs/decentralization/actors.md b/docs/docs/protocol-specs/decentralization/actors.md similarity index 100% rename from yellow-paper/docs/decentralization/actors.md rename to docs/docs/protocol-specs/decentralization/actors.md diff --git a/yellow-paper/docs/decentralization/block-production.md b/docs/docs/protocol-specs/decentralization/block-production.md similarity index 99% rename from yellow-paper/docs/decentralization/block-production.md rename to docs/docs/protocol-specs/decentralization/block-production.md index f554c304865..43731b8d14f 100644 --- a/yellow-paper/docs/decentralization/block-production.md +++ b/docs/docs/protocol-specs/decentralization/block-production.md @@ -115,7 +115,7 @@ Anyone ->> Network: eligible as a sequencer - get rid of "pre-confirmed" ::: -![Governance Summary Image](./images/Aztec-Block-Production-1.png) +![Governance Summary Image](/img/protocol-specs/decentralization/Aztec-Block-Production-1.png) Every staked sequencers participate in the following phases, comprising an Aztec slot: @@ -275,7 +275,7 @@ It is likely that this proving ecosystem will emerge around a [flashbots mev-boo Specifically, Proof boost is expected to be open source software sequencers can optionally run alongside their clients that will facilitate a negotiation for the rights to prove this block, therefore earning block rewards in the form of the native protocol token. After the negotiation, the sequencer will commit to an address, and that address will need to put up an economic commitment (deposit) that will be slashed in the event that the block's proofs are not produced within the alloted timeframe. -![image](./images/Aztec-Block-Production-3.png) +![image](/img/protocol-specs/decentralization/Aztec-Block-Production-3.png) Initially it's expected that the negotiations and commitment could be facilitated by a trusted relay, similar to L1 block building, but options such as onchain proving pools are under consideration. Due to the out of protocol nature of [Sidecar](https://forum.aztec.network/t/proposal-prover-coordination-sidecar/2428), these designs can be iterated and improved upon outside the scope of other Aztec related governance or upgrades - as long as they maintain compatibility with the currently utilized proving system(s). Eventually, any upgrade or governance mechanism may choose to enshrine a specific well adopted proving protocol, if it makes sense to do so. diff --git a/yellow-paper/docs/decentralization/governance.md b/docs/docs/protocol-specs/decentralization/governance.md similarity index 97% rename from yellow-paper/docs/decentralization/governance.md rename to docs/docs/protocol-specs/decentralization/governance.md index 249b3149edf..ee7208b76f9 100644 --- a/yellow-paper/docs/decentralization/governance.md +++ b/docs/docs/protocol-specs/decentralization/governance.md @@ -12,13 +12,13 @@ These instances may choose to be immutable themselves, or have governance that e The version registry will keep track of all historical versions of Aztec & provide them with incentives proportionate to their current stake. Additionally the governance contract will point to what the _current canonical_ version of Aztec is, particularly relevant for 3rd parties to follow, such as centralized exchanges, or portals that wish to follow Aztec governance. -![Governance Summary Image](./images/Aztec-Governance-Summary-1.png) +![Governance Summary Image](/img/protocol-specs/decentralization/Aztec-Governance-Summary-1.png) ## Rewards We propose introducing a governance "version registry" which keeps track of a) which deployments of Aztec have been canonical, and b) which instances currently have tokens staked to them, specifically in order to issue a consistent, single new token in the form of _incentives_ or "rollup/block rewards". -![Rewards Summary Image](./images/Aztec-Governance-Summary-2.png) +![Rewards Summary Image](/img/protocol-specs/decentralization/Aztec-Governance-Summary-2.png) Given that deployments may be immutable, it is necessary to ensure that there are operators, i.e., sequencers & provers, running the infrastructure for a given deployment as long as users are interested in it. Therefore we suggest a model where all previous canonical instances of Aztec are rewarded pro-rata to their current proportion of stake. @@ -35,11 +35,11 @@ Upon initial deployment, there will be an immutable set of governance contracts The initial instance will be called "Aztec v0" and (the current thinking is that v0) will not include the ability to process user transactions. Sequencers can register for Fernet's sequencer selection algorithm by staking tokens to that particular instance, and practice proposing blocks on mainnet prior to deciding to "go live" with v1, which _does_ enable the processing of user transactions. This instance would then _"restake"_ these tokens within the governance contract, to have a voting weight equal to the amount of tokens staked by its sequencer set. This is in order to ensure that the sequencer selection algorithm is working properly and the community of operators themselves can decide what happens to the network next, i.e., if it's ready to actually "go live" with transactions. It will also serve as a production readiness test of the upgradeability. In the event that these v0 tests are unable to be successfully completed as expected, the community (with potential foundation approval) may need to redeploy and try again. -![Initial Deployment Image](./images/Aztec-Governance-Summary-3.png) +![Initial Deployment Image](/img/protocol-specs/decentralization/Aztec-Governance-Summary-3.png) The ability to upgrade to v1 is articulated below, and should follow a "happy path" upgrade where a majority of the v0 sequencer set must agree to upgrade by voting during their block proposals, similar to what was articulated in [the empire stakes back](https://forum.aztec.network/t/upgrade-proposal-the-empire-stakes-back/626). Additionally, token holders can directly participate in the vote, or choose to delegate a vote with the weight of their tokens to another address, including the v0 rollup. -![Version 1 Deployment Image](./images/Aztec-Governance-Summary-4.png) +![Version 1 Deployment Image](/img/protocol-specs/decentralization/Aztec-Governance-Summary-4.png) ## Proposing a new version @@ -224,7 +224,7 @@ Sequencers ->> Next Rollup: Proposing new blocks here! Emergency mode is proposed to be introduced to the initial instance "v0" or "v1" of Aztec, whatever the first instance or deployment is. Emergency mode **will not be included as part of the canonical governance contracts or registry**. If future deployments wish to have a similar security council, they can choose to do so. In this design, the current rollup can determine the timelock period as articulated above, within some predefined constraints, e.g., 3-30 days. Explicitly, the current rollup can give a security council the ability to define what this timelock period may be, and in the case of a potential vulnerability or otherwise, may be well within it's rights to choose the smallest value defined by the immutable governance contract to ensure that the network is able to recover and come back online as quickly as possible. -![Emergency Mode Image](./images/Aztec-Governance-Summary-4.png) +![Emergency Mode Image](/img/protocol-specs/decentralization/Aztec-Governance-Summary-4.png) ### Unpausing by default diff --git a/yellow-paper/docs/decentralization/p2p-network.md b/docs/docs/protocol-specs/decentralization/p2p-network.md similarity index 91% rename from yellow-paper/docs/decentralization/p2p-network.md rename to docs/docs/protocol-specs/decentralization/p2p-network.md index 69e2206e7eb..62c1bbe4c7f 100644 --- a/yellow-paper/docs/decentralization/p2p-network.md +++ b/docs/docs/protocol-specs/decentralization/p2p-network.md @@ -29,7 +29,7 @@ Anyone can operate an instance of the Aztec Node configured to serve their needs Client PXEs will interact with instances of the Aztec Node via it's JSON RPC interface. -![P2P Network](./images/network.png) +![P2P Network](/img/protocol-specs/decentralization/network.png) ### Transaction Size @@ -40,7 +40,6 @@ Client PXEs will interact with instances of the Aztec Node via it's JSON RPC int | Public Inputs, Public Calls and Emitted Logs | ~8KB | | Private Kernel Proof | ~32KB | - ### Sequencer-to-Prover Communication Proving is an out-of-protocol activity. The nature of the communication between sequencers and provers will depend entirely on the prover/s selected by the sequencer. Provers may choose to run their own Transaction Pool Node infrastructure so that they are prepared for generating proofs and don't need to receive this data out-of-band. @@ -82,11 +81,11 @@ The underlying transport for DiscV5 communication is UDP. Whilst UDP is not reli ##### Bootstrapping -When a node wishes to join the network for the first time. It needs to locate at least 1 initial peer in order to 'discover' other nodes. This role is performed by known public 'bootnodes'. Bootnodes may not be full network participants, they may simply be entrypoints containing well populated routing tables for nodes to query. +When a node wishes to join the network for the first time. It needs to locate at least 1 initial peer in order to 'discover' other nodes. This role is performed by known public 'bootnodes'. Bootnodes may not be full network participants, they may simply be entrypoints containing well populated routing tables for nodes to query. ##### Topics -Topics are part of the DiscV5 specification, though the spec is as yet unfinished and implementations do not yet exist. The intention of topics is for the Ethereum P2P network to efficiently support any number of applications under the same discovery scheme. To date, many other applications use Ethereum's discovery network but the only way to 'discover' other nodes for the same application is to query nodes at random and interrogate them. Topics will allow this to be done more efficiently with nodes being able to 'advertise' themselves as supporting specific applications across the network. +Topics are part of the DiscV5 specification, though the spec is as yet unfinished and implementations do not yet exist. The intention of topics is for the Ethereum P2P network to efficiently support any number of applications under the same discovery scheme. To date, many other applications use Ethereum's discovery network but the only way to 'discover' other nodes for the same application is to query nodes at random and interrogate them. Topics will allow this to be done more efficiently with nodes being able to 'advertise' themselves as supporting specific applications across the network. ##### DiscV5 on Aztec @@ -100,17 +99,16 @@ Using Ethereum's DiscV5 network will have significant benefits for Aztec. Networ The node record for an Aztec node will contain the following key/value pairs. The network endpoints don't all need to be specified but nodes will require at least one ip address and port. The public key is required to verify the signature included with the node record. The id is the identity scheme with "v4" being that currently used by Ethereum. - -| key | value | -| -------- | -------- | -| id | "v4" | -| secp256k1 | The node's public key | -| ip | ipv4 address | -| tcp | tcp port | -| ip6 | ipv6 address | -| tcp6 | tcp port for v6 address | -| aztec | The aztec chain id | -| eth | The ethereum chain id | +| key | value | +| --------- | ----------------------- | +| id | "v4" | +| secp256k1 | The node's public key | +| ip | ipv4 address | +| tcp | tcp port | +| ip6 | ipv6 address | +| tcp6 | tcp port for v6 address | +| aztec | The aztec chain id | +| eth | The ethereum chain id | ### Transaction Gossip @@ -128,7 +126,7 @@ LibP2P supports the multiplexing of stream based transports such as TCP. There a #### Encryption handshake -Communication between nodes within LibP2P is encrypted. This is important to protect individual nodes and the network at large from malicious actors. Establishing keys requires a secure handshake protocol. Client's must specify LibP2P's [noise](https://docs.libp2p.io/concepts/secure-comm/noise/) protocol for this purpose. +Communication between nodes within LibP2P is encrypted. This is important to protect individual nodes and the network at large from malicious actors. Establishing keys requires a secure handshake protocol. Client's must specify LibP2P's [noise](https://docs.libp2p.io/concepts/secure-comm/noise/) protocol for this purpose. #### GossipSub @@ -161,17 +159,16 @@ Aztec will use LibP2P's GossipSub protocol for transaction propagation. Nodes mu The table below contains some of the relevant configuration properties and their default values. These parameters can be validated on testnet but it is expected that for the Aztec network, clients would use similar values, perhaps reducing peering degree slightly to favour reduced bandwidth over message propagation latency. +| Parameter | Description | Value | +| ------------------ | -------------------------------------------------------------------- | -------- | +| D | The desired peering degree | 6 | +| D_low | The peering degree low watermark | 4 | +| D_high | The peering degree high watermark | 12 | +| heartbeat_interval | The time between heartbeats\* | 1 second | +| mcache_len | The number of history windows before messages are ejected from cache | 5 | +| mcache_gossip | The number of history windows for messages to be gossiped | 3 | -| Parameter | Description | Value | -| -------- | -------- | -------- | -| D | The desired peering degree | 6 | -| D_low | The peering degree low watermark | 4 | -| D_high | The peering degree high watermark | 12 | -| heartbeat_interval | The time between heartbeats* | 1 second | -| mcache_len | The number of history windows before messages are ejected from cache | 5 | -| mcache_gossip | The number of history windows for messages to be gossiped | 3 | - -(*)Several things happen at the heartbeat interval: +(\*)Several things happen at the heartbeat interval: 1. The nature of peerings are evaluated and changed if necessary 2. Message IDs are gossiped to a randomly selected set of metadata only peers @@ -197,6 +194,6 @@ GossipSub does not include a mechanism for synchronising the global set of messa 1. Aztec transactions are large, approximately 40Kb. Downloading the entire pool would require transferring in the order of 100s of MB of data. At best this is undesirable and at worst it represents a DoS vector. -2. It is largely redundant. At the point at which a node joins the network, it is likely that production of a block is already underway and many of the transactions that would be downloaded will be removed as soon as that block is published. +2. It is largely redundant. At the point at which a node joins the network, it is likely that production of a block is already underway and many of the transactions that would be downloaded will be removed as soon as that block is published. -3. Clients will naturally synchronise the transaction pool by joining the gossiping network and waiting for 1 or 2 blocks. New transactions will be received into the client's local pool and old transactions unknown to the client will be removed as blocks are published. \ No newline at end of file +3. Clients will naturally synchronise the transaction pool by joining the gossiping network and waiting for 1 or 2 blocks. New transactions will be received into the client's local pool and old transactions unknown to the client will be removed as blocks are published. diff --git a/yellow-paper/docs/gas-and-fees/fee-payments-and-metering.md b/docs/docs/protocol-specs/gas-and-fees/fee-payments-and-metering.md similarity index 97% rename from yellow-paper/docs/gas-and-fees/fee-payments-and-metering.md rename to docs/docs/protocol-specs/gas-and-fees/fee-payments-and-metering.md index 22042f28de9..b8a7c1db90e 100644 --- a/yellow-paper/docs/gas-and-fees/fee-payments-and-metering.md +++ b/docs/docs/protocol-specs/gas-and-fees/fee-payments-and-metering.md @@ -55,7 +55,7 @@ Transactions will be divided into 3 phases: All of these phases occur **within the same transaction**, ultimately resulting in 2 sets of public inputs being emitted from the private kernel circuits. Those related to the fee payment and those related to the application logic. State changes requested by the application logic are reverted if any component fails. State changes in the fee preparation and distribution components are only reverted if either of those components fail. -![Transaction Components](../gas-and-fees/images/gas-and-fees/Transaction.png) +![Transaction Components](/img/protocol-specs/gas-and-fees/Transaction.png) The fee preparation and fee distribution phases respectively are responsible for ensuring that sufficient quantity of the fee payment asset is made available for the transaction and that it is correctly distributed to the sequencer with any refund being returned to the transaction sender. The sequencer will have have agency over which contract methods they are willing to accept for execution in these phases and will have visibility over the arguments passed to them. This is important as these functions must be successfully executed in order for the sequencer to be paid. It is assumed that the network will settle on a number of universally recognised fee payment contracts implementing fee preparation and distribution. @@ -90,12 +90,12 @@ An example of L2 gas amortization could be the transaction sender specifying a m TotalGasToBeAmortised = (1024 - 2) * GMerge + GRoot L2AmortizedGasLimit = TotalGasToBeAmortised / 1024 -Where +Where GMerge = The gas cost of proving the merge rollup circuit. GRoot = The gas cost of proving the root rollup circuit. ``` -In this example, were the transaction to be included within a rollup larger than 1024 transactions, the transaction sender would be refunded this amortization difference. +In this example, were the transaction to be included within a rollup larger than 1024 transactions, the transaction sender would be refunded this amortization difference. The private kernel circuits will output 8 `Gas` values. The 6 `GasLimit`'s represent maximum quantities of gas that the transaction sender permits to be consumed. Insufficient limits will cause the transaction to revert with an `OutOfGas` condition. Fees will be refunded to the transaction sender for unused quantities of gas, The `FeeDistributionGas` values are fixed amounts of gas effectively representing fixed fees that the transaction sender is willing to pay for their chosen fee distribution. @@ -129,7 +129,7 @@ L1Fee = (L1AmortizedGasLimit + L1TxGasLimit) * feePerL1Gas L2Fee = (L2AmortizedGasLimit + L2TxGasLimit + L2FeeDistributionGas) * feePerL2Gas DAFee = (DAAmortizedGasLimit + DATxGasLimit + DAFeeDistributionGas) * feePerDAGas -TotalFee = L1Fee + L2Fee + DAFee +TotalFee = L1Fee + L2Fee + DAFee ``` ## Executing Transactions and Collecting Fees @@ -150,12 +150,11 @@ The transaction's fee preparation and fee distribution functions must be called | `DAGasUsed` | The accumulated quantity of DA gas used, both amortized and per-transaction | | `feeRecipient` | The aztec address designated as the recipient of fees for the current block | - The values of gas used must be calculated and applied appropriately by the sequencer, a variety of constraints are in place for this. 1. The sequencer specifies the size of rollup being produced to the base rollup circuit and uses this value when calculating amortized gas consumption. This value is a public input of the base rollup circuit. 2. The sequencer specifies the fee recipient to the base rollup circuit and uses this value in fee distribution calls. This value is a public input of the base rollup circuit. -3. The sequencer calculates an initial set of values for consumed transaction specific and amortized gas. +3. The sequencer calculates an initial set of values for consumed transaction specific and amortized gas. 4. All forms of gas usage are accumulated by the public VM circuit and form part of the public inputs for the public kernel circuit. 5. The public kernel circuit public inputs also include the gas and fee related inputs provided to the public VM circuit. 6. The base rollup circuit computes the total amount of L1, L2 and DA gas consumed by the transaction, considering both private and public execution and transaction specific and amortized gas. It also considers reverted public execution. These values are public inputs to the circuit. @@ -198,7 +197,7 @@ sequenceDiagram Alice->>AccountContract: run entrypoint AccountContract->>FPA: enqueue FPA.pay_fee(max_fee) msg_sender == Alice as fee distribution function AccountContract->>App: app logic - App->>AccountContract: + App->>AccountContract: AccountContract->>Alice: finished private execution Alice->>Sequencer: tx object @@ -208,7 +207,7 @@ sequenceDiagram FPA->>Sequencer: Alice has >= funds required from tx object Sequencer->>App: app logic - App->>Sequencer: + App->>Sequencer: Sequencer->>FPA: FPA.pay_fee(max_fee) FPA->>FPA: calculate fee based on inputs to VM circuit @@ -238,13 +237,13 @@ sequenceDiagram Alice->>Alice: transient auth witness for AST private transfer Alice->>AccountContract: run entrypoint AccountContract->>FPC: private_fee_entrypoint(AST, max_fee, nonce) - + FPC->>AST: AST.transfer(FPC, max_fee + commission, nonce) AST->>AccountContract: check auth witness FPC->>FPC: enqueue FPA.private_fee_payment(max_fee) msg_sender == FPC as fee distribution function - FPC->>AccountContract: + FPC->>AccountContract: AccountContract->>App: app logic - App->>AccountContract: + App->>AccountContract: AccountContract->>Alice: finished private execution Alice->>Sequencer: tx object @@ -254,7 +253,7 @@ sequenceDiagram FPA->>Sequencer: FPC has >= funds required from tx object Sequencer->>App: app logic - App->>Sequencer: + App->>Sequencer: Sequencer->>FPA: FPA.private_fee_payment(max_fee) FPA->>FPA: calculate fee based on inputs to VM circuit @@ -288,10 +287,10 @@ sequenceDiagram activate FPC FPC->>FPC: enqueue FPC.public_fee_preparation(Alice, AST, max_fee, nonce) as fee preparation with msg_sender == FPC FPC->>FPC: enqueue FPC.public_fee_payment(Alice, AST, max_fee) as fee distribution with msg_sender == FPC - FPC->>AccountContract: + FPC->>AccountContract: deactivate FPC AccountContract->>App: app logic - App->>AccountContract: + App->>AccountContract: AccountContract->>Alice: finished private execution Alice->>Sequencer: tx object @@ -301,15 +300,15 @@ sequenceDiagram activate FPC FPC->>AST: AST.transfer_public(Alice, FPC, max_fee + commission, nonce) AST->>AccountContract: check auth witness - AccountContract->>AST: - AST->>FPC: + AccountContract->>AST: + AST->>FPC: FPC->>FPA: FPA.check_balance(max_fee) - FPA->>FPC: + FPA->>FPC: FPC->>Sequencer: FPC has the funds deactivate FPC Sequencer->>App: app logic - App->>Sequencer: + App->>Sequencer: Sequencer->>Sequencer: Recognise whitelisted function FPC.public_fee_payment(Alice, AST, max_fee) and msg.sender == FPC Sequencer->>FPC: FPC.public_fee_payment(Alice, AST, max_fee) @@ -319,7 +318,7 @@ sequenceDiagram FPA->>Sequencer: Sequencer's balance is increased by fee amount FPA->>FPC: rebate value FPC->>AST: AST.transfer_public(FPC, Alice, rebate, 0) - AST->>FPC: + AST->>FPC: FPC->>Alice: Alice's balance is increased by rebate value deactivate FPC ``` @@ -343,7 +342,7 @@ sequenceDiagram Alice->>DApp: run entrypoint DApp->>AccountContract: check auth witness - AccountContract->>DApp: + AccountContract->>DApp: DApp->>DApp: check if will sponsor action DApp->>FPA: enqueue FPA.pay_fee(max_fee) and msg_sender == DApp as fee distribution DApp->>DApp: app logic @@ -356,7 +355,7 @@ sequenceDiagram FPA->>Sequencer: DApp has >= funds required from tx object Sequencer->>DApp: app logic - DApp->>Sequencer: + DApp->>Sequencer: Sequencer->>FPA: FPA.pay_fee(max_fee) FPA->>FPA: calculate fee based on inputs to VM circuit diff --git a/yellow-paper/docs/gas-and-fees/fee-schedule.md b/docs/docs/protocol-specs/gas-and-fees/fee-schedule.md similarity index 100% rename from yellow-paper/docs/gas-and-fees/fee-schedule.md rename to docs/docs/protocol-specs/gas-and-fees/fee-schedule.md diff --git a/yellow-paper/docs/gas-and-fees/index.md b/docs/docs/protocol-specs/gas-and-fees/index.md similarity index 100% rename from yellow-paper/docs/gas-and-fees/index.md rename to docs/docs/protocol-specs/gas-and-fees/index.md diff --git a/yellow-paper/docs/intro.md b/docs/docs/protocol-specs/intro.md similarity index 100% rename from yellow-paper/docs/intro.md rename to docs/docs/protocol-specs/intro.md diff --git a/yellow-paper/docs/l1-smart-contracts/frontier.md b/docs/docs/protocol-specs/l1-smart-contracts/frontier.md similarity index 87% rename from yellow-paper/docs/l1-smart-contracts/frontier.md rename to docs/docs/protocol-specs/l1-smart-contracts/frontier.md index 682c4b0e0a2..885ae870e0c 100644 --- a/yellow-paper/docs/l1-smart-contracts/frontier.md +++ b/docs/docs/protocol-specs/l1-smart-contracts/frontier.md @@ -5,21 +5,21 @@ title: Frontier Merkle Tree The Frontier Merkle Tree is an append only Merkle tree that is optimized for minimal storage on chain. By storing only the right-most non-empty node at each level of the tree we can always extend the tree with a new leaf or compute the root without needing to store the entire tree. We call these values the frontier of the tree. -If we have the next index to insert at and the current frontier, we have everything needed to extend the tree or compute the root, with much less storage than a full merkle tree. +If we have the next index to insert at and the current frontier, we have everything needed to extend the tree or compute the root, with much less storage than a full merkle tree. Note that we're not actually keeping track of the data in the tree: we only store what's minimally required in order to be able to compute the root after inserting a new element. We will go through a few diagrams and explanations to understand how this works. And then a pseudo implementation is provided. - ## Insertion + Whenever we are inserting, we need to update the "root" of the largest subtree possible. This is done by updating the node at the level of the tree, where we have just inserted its right-most descendant. -This can sound a bit confusing, so we will go through a few examples. +This can sound a bit confusing, so we will go through a few examples. At first, say that we have the following tree, and that it is currently entirely empty. -![alt text](images/frontier/image-1.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-1.png) ### The first leaf @@ -27,7 +27,7 @@ When we are inserting the first leaf (lets call it A), the largest subtree is th In this case, we simply need to store the leaf value in `frontier[0]` and then we are done. For the sake of visualization, we will be drawing the elements in the `frontier` in blue. -![alt text](images/frontier/image-2.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-2.png) Notice that this will be the case whenever we are inserting a leaf at an even index. @@ -40,13 +40,14 @@ Therefore, we will compute the root of this subtree, `H(frontier[0],B)` and stor Notice, that we don't need to store the leaf B itself, since we won't be needing it for any future computations. This is what makes the frontier tree efficient - we get away with storing very little data. -![alt text](images/frontier/image-3.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-3.png) ### Third leaf + When inserting the third leaf, we are again back to the largest subtree being filled by the insertion being itself at level 0. The update will look similar to the first, where we only update `frontier[0]` with the new leaf. -![alt text](images/frontier/image-4.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-4.png) ### Fourth leaf @@ -56,39 +57,39 @@ Now the largest subtree getting filled by the insertion is at level 2. To compute the new subtree root, we have to compute `F = H(frontier[0], E)` and then `G = H(frontier[1], F)`. G is then stored in `frontier[2]`. - -As before, notice that we are only updating one value in the frontier. -![alt text](images/frontier/image-5.png) +As before, notice that we are only updating one value in the frontier. +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-5.png) ## Figuring out what to update To figure out which level to update in the frontier, we simply need to figure out what the height is of the largest subtree that is filled by the insertion. -While this might sound complex, it is actually quite simple. +While this might sound complex, it is actually quite simple. Consider the following extension of the diagram. We have added the level to update, along with the index of the leaf in binary. Seeing any pattern? -![alt text](images/frontier/image-6.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-6.png) The level to update is simply the number of trailing ones in the binary representation of the index. -For a binary tree, we have that every `1` in the binary index represents a "right turn" down the tree. +For a binary tree, we have that every `1` in the binary index represents a "right turn" down the tree. Walking up the tree from the leaf, we can simply count the number of right turns until we hit a left-turn. ## How to compute the root -Computing the root based on the frontier is also quite simple. +Computing the root based on the frontier is also quite simple. We can use the last index inserted a leaf at to figure out how high up the frontier we should start. -Then we know that anything that is at the right of the frontier has not yet been inserted, so all of these values are simply "zeros" values. +Then we know that anything that is at the right of the frontier has not yet been inserted, so all of these values are simply "zeros" values. Zeros here are understood as the root for a subtree only containing zeros. For example, if we take the tree from above and compute the root for it, we would see that level 2 was updated last. Meaning that we can simply compute the root as `H(frontier[2], zeros[2])`. -![alt text](images/frontier/image-7.png) +![alt text](/img/protocol-specs/l1-smart-contracts/frontier/image-7.png) For cases where we have built further, we simply "walk" up the tree and use either the frontier value or the zero value for the level. ## Pseudo implementation + ```python class FrontierTree: HEIGHT: immutable(uint256) @@ -107,7 +108,7 @@ class FrontierTree: def compute_level(_index: uint256) -> uint256: ''' - We can get the right of the most filled subtree by + We can get the right of the most filled subtree by counting the number of trailing ones in the index ''' count = 0 @@ -154,6 +155,5 @@ class FrontierTree: ``` ## Optimizations -- The `zeros` can be pre-computed and stored in the `Inbox` directly, this way they can be shared across all of the trees. - +- The `zeros` can be pre-computed and stored in the `Inbox` directly, this way they can be shared across all of the trees. diff --git a/yellow-paper/docs/l1-smart-contracts/index.md b/docs/docs/protocol-specs/l1-smart-contracts/index.md similarity index 92% rename from yellow-paper/docs/l1-smart-contracts/index.md rename to docs/docs/protocol-specs/l1-smart-contracts/index.md index ad676a95d75..0a2f7a924d8 100644 --- a/yellow-paper/docs/l1-smart-contracts/index.md +++ b/docs/docs/protocol-specs/l1-smart-contracts/index.md @@ -4,7 +4,7 @@ title: Cross-chain communication This section describes what our L1 contracts do, what they are responsible for and how they interact with the circuits. -Note that the only reason that we even have any contracts is to facilitate cross-chain communication. +Note that the only reason that we even have any contracts is to facilitate cross-chain communication. The contracts are not required for the rollup to function, but required to bridge assets and to reduce the cost of light nodes. :::info Purpose of contracts @@ -12,11 +12,11 @@ The purpose of the L1 contracts are simple: - Facilitate cross-chain communication such that L1 liquidity can be used on L2 - Act as a validating light node for L2 that every L1 node implicitly run -::: + ::: ## Overview -When presented with a new [`ProvenBlock`](../rollup-circuits/root-rollup.md) and its proof, an Aztec node can be convinced of its validity if the proof passes and the `Header.last_archive` matches the `archive` of the node (archive here represents a root of [archive tree](../state/archive.md)). +When presented with a new [`ProvenBlock`](../rollup-circuits/root-rollup.md) and its proof, an Aztec node can be convinced of its validity if the proof passes and the `Header.last_archive` matches the `archive` of the node (archive here represents a root of [archive tree](../state/archive.md)). The `archive` used as public input is the archive after the new header is inserted (see [root rollup](./../rollup-circuits/root-rollup.md)). ```python @@ -31,8 +31,8 @@ def process(block: ProvenBlock, proof: Proof): assert proof.verify(header, block.archive) assert self.inbox.consume() == header.in_hash assert self.outbox.insert( - block_number, - header.content_commitment.out_hash, + block_number, + header.content_commitment.out_hash, header.content_commitment.tx_tree_height + math.ceil(log2(MAX_NEW_L2_TO_L1_MSGS_PER_TX)) ) self.archive = block.archive @@ -44,15 +44,15 @@ def process(block: ProvenBlock, proof: Proof): The argument to the `insert` function is the `outbox` is the heigh of the message tree. Since every transaction can hold more than 1 message, it might add multiple layers to the tree. For a binary tree, the number of extra layers to add is computed as `math.ceil(log2(MAX_NEW_L2_TO_L1_MSGS_PER_TX))`. -Currently, `MAX_NEW_L2_TO_L1_MSGS_PER_TX = 2` which means that we are simply adding 1 extra layer. +Currently, `MAX_NEW_L2_TO_L1_MSGS_PER_TX = 2` which means that we are simply adding 1 extra layer. ::: -While the `ProvenBlock` must be published and available for nodes to build the state of the rollup, we can build the validating light node (the contract) such that as long as the node can be _convinced_ that the data is available we can progress the state. +While the `ProvenBlock` must be published and available for nodes to build the state of the rollup, we can build the validating light node (the contract) such that as long as the node can be _convinced_ that the data is available we can progress the state. This means our light node can be built to only require a subset of the `ProvenBlock` to be published to Ethereum L1 as calldata and use a different data availability layer for most of the block body. Namely, we need the cross-chain messages to be published to L1, but the rest of the block body can be published to a different data availability layer. :::info Validium or Rollup -If a different data availability layer than Ethereum is used for the block body, we are effectively building a Validium. +If a different data availability layer than Ethereum is used for the block body, we are effectively building a Validium. If we use Ethereum for the block body, we are building a Rollup. ::: @@ -91,8 +91,8 @@ StateTransitioner --> Verifier: verify() ### State transitioner -The state transitioner is the heart of the validating light node for the L2. -The contract keeps track of the current state of the L2 and progresses this state when a valid L2 block is received. +The state transitioner is the heart of the validating light node for the L2. +The contract keeps track of the current state of the L2 and progresses this state when a valid L2 block is received. It also facilitates cross-chain communication (communication between the L1 inbox and outbox contracts). ```python @@ -124,8 +124,8 @@ class StateTransitioner: assert VERIFIER.verify(header, archive, proof) assert self.INBOX.consume() == header.content_commitment.in_hash assert self.OUTBOX.insert( - block_number, - header.content_commitment.out_hash, + block_number, + header.content_commitment.out_hash, header.content_commitment.tx_tree_height + math.ceil(log2(MAX_NEW_L2_TO_L1_MSGS_PER_TX)) ) self.archive = archive @@ -148,7 +148,7 @@ class StateTransitioner: The state transitioner should be connected to an oracle which addresses the availability condition. -For the case of a rollup, this "oracle" will be deriving the `TxsHash` from calldata and blobs. +For the case of a rollup, this "oracle" will be deriving the `TxsHash` from calldata and blobs. For a validium it should be connected to a bridge that it can use to verify that the data is available on the other chain. For a generic DA that publishes data commitments to Ethereum, the oracle could be a snark proof that opens the data commitment from the bridge and computes the `TxsHash` from it. @@ -157,7 +157,7 @@ By having the availability oracle be independent from state progression we can e For more information around the requirements we have for the availability oracle, see [Data Availability](../data-publication-and-availability/index.md). -An interesting observation around the availability oracle is that the `OutHash` and `InHash` don't need to be explicitly proven available through it. +An interesting observation around the availability oracle is that the `OutHash` and `InHash` don't need to be explicitly proven available through it. The `InHash` is already proven as part of the L1 inbox, as we will see in a second. And the `OutHash` consists entirely of a subset of the contents of the `TxsHash`, which is already proven available. @@ -165,30 +165,30 @@ And the `OutHash` consists entirely of a subset of the contents of the `TxsHash` ### Registry -To keep one location where all the core rollup contracts can be found, we have a registry contract. -The registry is a contract that holds the current and historical addresses of the core rollup contracts. -The addresses of a rollup deployment are contained in a snapshot, and the registry is tracking version-snapshot pairs. -Depending on the upgrade scheme, it might be used to handle upgrades, or it could entirely be removed. -It is generally the one address that a node MUST know about, as it can then tell the node where to find the remainder of the contracts. +To keep one location where all the core rollup contracts can be found, we have a registry contract. +The registry is a contract that holds the current and historical addresses of the core rollup contracts. +The addresses of a rollup deployment are contained in a snapshot, and the registry is tracking version-snapshot pairs. +Depending on the upgrade scheme, it might be used to handle upgrades, or it could entirely be removed. +It is generally the one address that a node MUST know about, as it can then tell the node where to find the remainder of the contracts. This is for example used when looking for the address new L2 blocks should be published to. ## Message Bridges To let users communicate between L1 and the L2, we are using message bridges, namely an L1 inbox that is paired to an L2 outbox, and an L2 inbox that is paired to an L1 outbox. -![Alt text](images/com-abs-6.png) +![Alt text](/img/protocol-specs/l1-smart-contracts/com-abs-6.png) :::info Naming is based from the PoV of the state transitioner. ::: -While we logically have 4 boxes, we practically only require 3 of those. -The L2 inbox is not real - but only logical. -This is due to the fact that they are always inserted and then consumed in the same block! +While we logically have 4 boxes, we practically only require 3 of those. +The L2 inbox is not real - but only logical. +This is due to the fact that they are always inserted and then consumed in the same block! Insertions require a L2 transaction, and it is then to be consumed and moved to the L1 outbox by the state transitioner in the same block. ### Portals -When deploying a contract on L2, it is possible to specify its "portal" address. +When deploying a contract on L2, it is possible to specify its "portal" address. This is an immutable variable, that can be used to constrain who the L2 contract expects messages from, and who it sends messages to. ### Messages @@ -220,32 +220,32 @@ struct L2ToL1Msg { } ``` -Beware, that while we speak of messages, we are practically passing around only their **hashes** to reduce cost. -The `version` value of the `L2Actor` is the version of the rollup, which is intended to be used to specify which version of the rollup the message is intended for or sent from. +Beware, that while we speak of messages, we are practically passing around only their **hashes** to reduce cost. +The `version` value of the `L2Actor` is the version of the rollup, which is intended to be used to specify which version of the rollup the message is intended for or sent from. This way, multiple rollup instances can use the same inbox/outbox contracts. :::info Why a single hash? -Compute on L1 is expensive, but storage is extremely expensive! -To reduce overhead, we trade storage for computation and only commit to the messages and then "open" these for consumption later. -However, since computation also bears significant we need to use a hash function that is relatively cheap on L1, while still being doable inside a snark. +Compute on L1 is expensive, but storage is extremely expensive! +To reduce overhead, we trade storage for computation and only commit to the messages and then "open" these for consumption later. +However, since computation also bears significant we need to use a hash function that is relatively cheap on L1, while still being doable inside a snark. For this purpose a modded SHA256 was chosen, modded here meaning that it fits the output value into a single field element using the modulo operator. ::: Some additional discussion/comments on the message structure can be found in [The Republic](https://forum.aztec.network/t/the-republic-a-flexible-optional-governance-proposal-with-self-governed-portals/609/2#supporting-pending-messages-5). -Since any data that is moving from one chain to the other at some point will live on L1, it will be PUBLIC. +Since any data that is moving from one chain to the other at some point will live on L1, it will be PUBLIC. While this is fine for L1 consumption (which is public in itself), we want to ensure that the L2 consumption can be private. -To support this, we use a nullifier scheme similar to what we are doing for the other [notes](./../state/note-hash-tree.md). +To support this, we use a nullifier scheme similar to what we are doing for the other [notes](./../state/note-hash-tree.md). As part of the nullifier computation we then use the `secret` which hashes to the `secretHash`, this ensures that only actors with knowledge of `secret` will be able to see when it is spent on L2. -Any message that is consumed on one side MUST be moved to the other side. -This is to ensure that the messages exist AND are only consumed once. +Any message that is consumed on one side MUST be moved to the other side. +This is to ensure that the messages exist AND are only consumed once. The L1 contracts can handle one side, but the circuits must handle the other. :::info Is `secretHash` required? We are using the `secretHash` to ensure that the user can spend the message privately with a generic nullifier computation. -However, as the nullifier computation is almost entirely controlled by the app circuit (except the siloing, see [Nullifier Tree](./../state/nullifier-tree.md) ) applications could be made to simply use a different nullifier computation and have it become part of the content. -However, this reduces the developer burden and is quite easy to mess up. +However, as the nullifier computation is almost entirely controlled by the app circuit (except the siloing, see [Nullifier Tree](./../state/nullifier-tree.md) ) applications could be made to simply use a different nullifier computation and have it become part of the content. +However, this reduces the developer burden and is quite easy to mess up. For those reasons we have decided to use the `secretHash` as part of the message. ::: @@ -256,21 +256,20 @@ For those reasons we have decided to use the `secretHash` as part of the message When we say inbox, we are generally referring to the L1 contract that handles the L1 to L2 messages. The inbox takes messages from L1 contracts and inserts them into a series of message trees. -We build multiple "trees" instead of a single tree, since we are building one tree for every block and not one large with all the messages. +We build multiple "trees" instead of a single tree, since we are building one tree for every block and not one large with all the messages. The reasoning is fairly straight-forward; we need to split it into epochs such that a sequencer can build a proof based on a tree that is not going to update in the middle of the proof building. Such updates would allow DOS attacks on the sequencer, which is undesirable. To support this, we can simply introduce a "lag" between when trees are built and when they must be included. We can actually do this quite easily. -Say that whenever a new block is published, we start building a new tree. +Say that whenever a new block is published, we start building a new tree. Essentially meaning that at block $n$ we include tree $n$ which was created earlier (during block $n-1$). - Example visualized below. Here we have that tree $n$ is "fixed" when block $n$ needs to be published. And that tree $n+1$ is being built upon until block $n$ is being published. -![Feeding trees into the blocks](images/tree-order.png) +![Feeding trees into the blocks](/img/protocol-specs/l1-smart-contracts/tree-order.png) When the state transitioner is consuming a tree, it MUST insert the subtree into the "L2 outbox" ([message tree](./../state/index.md)). @@ -279,27 +278,27 @@ When a message is inserted into the inbox, the inbox **MUST** fill in the `sende - `L1Actor.actor`: The sender of the message (the caller), `msg.sender` - `L1Actor.chainId`: The chainId of the L1 chain sending the message, `block.chainId` -We MUST populate these values in the inbox, since we cannot rely on the user providing anything meaningful. -From the `L1ToL2Msg` we compute a hash of the message. +We MUST populate these values in the inbox, since we cannot rely on the user providing anything meaningful. +From the `L1ToL2Msg` we compute a hash of the message. This hash is what is moved by the state transitioner to the L2 outbox. -Since message from L1 to L2 can be inserted independently of the L2 block, the message transfer (moving from inbox into outbox) is not synchronous as it is for L2 to L1 messages. -This means that the message can be inserted into the inbox, but not yet moved to the outbox. -The message will then be moved to the outbox when the state transitioner is consuming the message as part of a block. +Since message from L1 to L2 can be inserted independently of the L2 block, the message transfer (moving from inbox into outbox) is not synchronous as it is for L2 to L1 messages. +This means that the message can be inserted into the inbox, but not yet moved to the outbox. +The message will then be moved to the outbox when the state transitioner is consuming the message as part of a block. Since the sequencers are required to move the entire subtree at once, you can be sure that the message will be moved to the outbox at some point. As mentioned earlier, this is done to ensure that the messages are not used to DOS the state transitioner. -Since we will be building the tree on L1, we need to use a gas-friendly hash-function such as SHA256. -However, as we need to allow users to prove inclusion in this tree, we cannot just insert the SHA256 tree into the rollup state, it requires too many constraints to be used by most small users. +Since we will be building the tree on L1, we need to use a gas-friendly hash-function such as SHA256. +However, as we need to allow users to prove inclusion in this tree, we cannot just insert the SHA256 tree into the rollup state, it requires too many constraints to be used by most small users. Therefore, we need to "convert" the tree into a tree using a more snark-friendly hash. This part is done in the [tree parity circuits](./../rollup-circuits/tree-parity.md). -Furthermore, to build the tree on L1, we need to put some storage on L1 such that the insertions don't need to provide a lot of merkle-related data which could be cumbersome to do and prone to race-conditions. -For example two insertions based on inclusion paths that are created at the same time will invalidate each other. -As storage costs an arm and a leg on L1, we need to be careful with how we store this. +Furthermore, to build the tree on L1, we need to put some storage on L1 such that the insertions don't need to provide a lot of merkle-related data which could be cumbersome to do and prone to race-conditions. +For example two insertions based on inclusion paths that are created at the same time will invalidate each other. +As storage costs an arm and a leg on L1, we need to be careful with how we store this. -Luckily for us, we can use a "frontier" merkle tree to store the messages. +Luckily for us, we can use a "frontier" merkle tree to store the messages. This is a special kind of append-only merkle tree that allows us to store very few elements in storage, but just enough for us to be able to extend it, and compute the root of the tree. Consult [Frontier Merkle Tree](#frontier-merkle-tree]) for more information on this. @@ -307,7 +306,6 @@ Assuming that we have these trees, we can build an `inbox` utilizing them as fol When a new block is published, we start building a new tree. Notice however, that if we have entirely filled the current tree, we can start building a new one immediately, and the blocks can then "catch up". - ```python class Inbox: STATE_TRANSITIONER: immutable(address) @@ -328,7 +326,7 @@ class Inbox: self.STATE_TRANSITIONER = _state_transitioner self.trees[1] = FrontierTree(self.HEIGHT) - + def insert(self, message: L1ToL2Message) -> bytes32: ''' Insert into the next FrontierTree. If the tree is full, creates a new one @@ -366,7 +364,7 @@ class Inbox: #### L2 Inbox -While the L2 inbox is not a real contract, it is a logical contract that apply mutations to the data similar to the L1 inbox to ensure that the sender cannot fake his position. +While the L2 inbox is not a real contract, it is a logical contract that apply mutations to the data similar to the L1 inbox to ensure that the sender cannot fake his position. This logic is handled by the kernel and rollup circuits. Just like the L1 variant, we must populate the `sender`: @@ -378,7 +376,7 @@ In practice, this is done in the kernel circuit of the L2, and the message hashe ### Outbox -The outboxes are the location where a user can consume messages from. +The outboxes are the location where a user can consume messages from. An outbox can only contain elements that have previously been removed from the paired inbox. diff --git a/yellow-paper/docs/state/note-hash-tree.md b/docs/docs/protocol-specs/state/note-hash-tree.md similarity index 100% rename from yellow-paper/docs/state/note-hash-tree.md rename to docs/docs/protocol-specs/state/note-hash-tree.md diff --git a/yellow-paper/docs/state/nullifier-tree.md b/docs/docs/protocol-specs/state/nullifier-tree.md similarity index 98% rename from yellow-paper/docs/state/nullifier-tree.md rename to docs/docs/protocol-specs/state/nullifier-tree.md index 036b69cff01..e33c294643d 100644 --- a/yellow-paper/docs/state/nullifier-tree.md +++ b/docs/docs/protocol-specs/state/nullifier-tree.md @@ -40,7 +40,7 @@ Missing info: - Details of the hash to use, and a domain separator for the hash. We might not know the final hash that we'll use, but we should propose one, and we should probably also give each hash a name. - E.g. `compute_parent_node("nullifier parent node".to_field(), left_child, right_child)` where `compute_siloed_nullifier = pedersen_hash` (for now). -Pseudocode/algorithms for insertion, batch insertion, membership proofs, non-membership proofs, so that the security of our approach can be validated. We should discuss the best way to consistently present such information, for all sections of the yellow paper. +Pseudocode/algorithms for insertion, batch insertion, membership proofs, non-membership proofs, so that the security of our approach can be validated. We should discuss the best way to consistently present such information, for all sections of the protocol specs. EDIT: maybe all these comments should actually go in cryptography/merkle-tree.md --> diff --git a/yellow-paper/docs/state/public-data-tree.md b/docs/docs/protocol-specs/state/public-data-tree.md similarity index 96% rename from yellow-paper/docs/state/public-data-tree.md rename to docs/docs/protocol-specs/state/public-data-tree.md index 1c48c23a4d5..9489cfc40aa 100644 --- a/yellow-paper/docs/state/public-data-tree.md +++ b/docs/docs/protocol-specs/state/public-data-tree.md @@ -39,5 +39,5 @@ Missing info: - Details of the hash to use, and a domain separator for the hash. We might not know the final hash that we'll use, but we should propose one, and we should probably also give each hash a name. - E.g. `compute_parent_node("nullifier parent node".to_field(), left_child, right_child)` where `compute_siloed_nullifier = pedersen_hash` (for now. Poseidon eventually, iiuc. Perhaps we should write this spec to state Poseidon). -Pseudocode/algorithms for insertion, batch insertion, membership proofs, non-membership proofs, so that the security of our approach can be validated. We should discuss the best way to consistently present such information, for all sections of the yellow paper. (EDIT: put this in cryptography/merkle-trees) +Pseudocode/algorithms for insertion, batch insertion, membership proofs, non-membership proofs, so that the security of our approach can be validated. We should discuss the best way to consistently present such information, for all sections of the protocol specs. (EDIT: put this in cryptography/merkle-trees) --> diff --git a/yellow-paper/docs/state/tree-implementations.md b/docs/docs/protocol-specs/state/tree-implementations.md similarity index 100% rename from yellow-paper/docs/state/tree-implementations.md rename to docs/docs/protocol-specs/state/tree-implementations.md diff --git a/yellow-paper/docs/todo.md b/docs/docs/protocol-specs/todo.md similarity index 100% rename from yellow-paper/docs/todo.md rename to docs/docs/protocol-specs/todo.md diff --git a/yellow-paper/docs/transactions/index.md b/docs/docs/protocol-specs/transactions/index.md similarity index 100% rename from yellow-paper/docs/transactions/index.md rename to docs/docs/protocol-specs/transactions/index.md diff --git a/yellow-paper/docs/transactions/local-execution.md b/docs/docs/protocol-specs/transactions/local-execution.md similarity index 97% rename from yellow-paper/docs/transactions/local-execution.md rename to docs/docs/protocol-specs/transactions/local-execution.md index adce86b68b6..f9f7e5c57c7 100644 --- a/yellow-paper/docs/transactions/local-execution.md +++ b/docs/docs/protocol-specs/transactions/local-execution.md @@ -5,8 +5,8 @@ Transactions are initiated via a _transaction execution request_ sent from the u - `origin` diff --git a/yellow-paper/docs/transactions/validity.md b/docs/docs/protocol-specs/transactions/validity.md similarity index 100% rename from yellow-paper/docs/transactions/validity.md rename to docs/docs/protocol-specs/transactions/validity.md diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js index d2ffd760db2..b0a158adaf4 100644 --- a/docs/docusaurus.config.js +++ b/docs/docusaurus.config.js @@ -7,6 +7,7 @@ const math = require("remark-math"); const katex = require("rehype-katex"); const path = require("path"); const fs = require("fs"); +const macros = require("./src/katex-macros.js"); /** @type {import('@docusaurus/types').Config} */ const config = { @@ -52,7 +53,16 @@ const config = { }, routeBasePath: "/", remarkPlugins: [math], - rehypePlugins: [katex], + rehypePlugins: [ + [ + katex, + { + throwOnError: true, + globalGroup: true, + macros, + }, + ], + ], }, blog: false, theme: { @@ -199,6 +209,12 @@ const config = { position: "left", label: "Aztec Protocol", }, + { + type: "docSidebar", + sidebarId: "protocolSpecSidebar", + position: "left", + label: "Protocol Specification", + }, ], }, footer: { diff --git a/docs/package.json b/docs/package.json index 67a53d63e89..10f82ae2712 100644 --- a/docs/package.json +++ b/docs/package.json @@ -31,6 +31,7 @@ "prism-react-renderer": "^1.3.1", "react": "^17.0.2", "react-dom": "^17.0.2", + "react-markdown": "6.0.0", "react-player": "^2.12.0", "rehype-katex": "5", "remark-math": "3" diff --git a/docs/sidebars.js b/docs/sidebars.js index f9b18d8372e..5a5e9b00006 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -51,7 +51,6 @@ const aztecNRSidebar = buildSidebarItemsFromStructure( "developers/contracts/references/aztec-nr" ); -console.log(aztecNRSidebar); /** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */ const sidebars = { docsSidebar: [ @@ -635,6 +634,232 @@ const sidebars = { "misc/aztec_connect_sunset", ], + + protocolSpecSidebar: [ + "protocol-specs/intro", + { + label: "Cryptography", + type: "category", + link: { type: "doc", id: "protocol-specs/cryptography/index" }, + items: [ + { + label: "Proving System", + type: "category", + link: { + type: "doc", + id: "protocol-specs/cryptography/proving-system/performance-targets", + }, + items: [ + "protocol-specs/cryptography/proving-system/performance-targets", + "protocol-specs/cryptography/proving-system/overview", + "protocol-specs/cryptography/proving-system/data-bus", + ], + }, + { + label: "Hashing", + type: "category", + link: { + type: "doc", + id: "protocol-specs/cryptography/hashing/hashing", + }, + items: [ + "protocol-specs/cryptography/hashing/hashing", + "protocol-specs/cryptography/hashing/poseidon2", + "protocol-specs/cryptography/hashing/pedersen", + ], + }, + "protocol-specs/cryptography/merkle-trees", + ], + }, + { + label: "Addresses & Keys", + type: "category", + link: { type: "doc", id: "protocol-specs/addresses-and-keys/index" }, + items: [ + "protocol-specs/addresses-and-keys/address", + "protocol-specs/addresses-and-keys/keys-requirements", + "protocol-specs/addresses-and-keys/keys", + { + label: "Example Usage of Keys", + type: "category", + items: [ + "protocol-specs/addresses-and-keys/example-usage/nullifier", + "protocol-specs/addresses-and-keys/example-usage/diversified-and-stealth-keys", + "protocol-specs/addresses-and-keys/example-usage/tag-sequence-derivation", + "protocol-specs/addresses-and-keys/example-usage/encrypt-and-tag", + ], + }, + "protocol-specs/addresses-and-keys/precompiles", + "protocol-specs/addresses-and-keys/diversified-and-stealth", + ], + }, + { + label: "State", + type: "category", + link: { type: "doc", id: "protocol-specs/state/index" }, + items: [ + "protocol-specs/state/tree-implementations", + "protocol-specs/state/archive", + "protocol-specs/state/note-hash-tree", + "protocol-specs/state/nullifier-tree", + "protocol-specs/state/public-data-tree", + ], + }, + { + label: "Transactions", + type: "category", + link: { type: "doc", id: "protocol-specs/transactions/index" }, + items: [ + "protocol-specs/transactions/local-execution", + "protocol-specs/transactions/public-execution", + "protocol-specs/transactions/tx-object", + "protocol-specs/transactions/validity", + ], + }, + { + label: "Bytecode", + type: "category", + link: { type: "doc", id: "protocol-specs/bytecode/index" }, + items: [], + }, + { + label: "Contract Deployment", + type: "category", + link: { type: "doc", id: "protocol-specs/contract-deployment/index" }, + items: [ + "protocol-specs/contract-deployment/classes", + "protocol-specs/contract-deployment/instances", + ], + }, + { + label: "Calls", + type: "category", + link: { type: "doc", id: "protocol-specs/calls/index" }, + items: [ + "protocol-specs/calls/sync-calls", + "protocol-specs/calls/enqueued-calls", + "protocol-specs/calls/batched-calls", + "protocol-specs/calls/static-calls", + "protocol-specs/calls/delegate-calls", + "protocol-specs/calls/unconstrained-calls", + "protocol-specs/calls/public-private-messaging", + ], + }, + { + label: "L1 smart contracts", + type: "category", + link: { type: "doc", id: "protocol-specs/l1-smart-contracts/index" }, + items: ["protocol-specs/l1-smart-contracts/frontier"], + }, + { + label: "Data availability", + type: "category", + link: { + type: "doc", + id: "protocol-specs/data-publication-and-availability/index", + }, + items: [ + "protocol-specs/data-publication-and-availability/overview", + "protocol-specs/data-publication-and-availability/published-data", + ], + }, + { + label: "Logs", + type: "category", + link: { type: "doc", id: "protocol-specs/logs/index" }, + items: [], + }, + { + label: "Pre-compiled Contracts", + type: "category", + link: { type: "doc", id: "protocol-specs/pre-compiled-contracts/index" }, + items: ["protocol-specs/pre-compiled-contracts/registry"], + }, + { + label: "Private Message Delivery", + type: "category", + link: { + type: "doc", + id: "protocol-specs/private-message-delivery/index", + }, + items: [ + "protocol-specs/private-message-delivery/private-msg-delivery", // renamed to avoid routing problems + "protocol-specs/private-message-delivery/send-note-guidelines", + ], + }, + { + label: "Gas & Fees", + type: "category", + link: { type: "doc", id: "protocol-specs/gas-and-fees/index" }, + items: [ + "protocol-specs/gas-and-fees/fee-payments-and-metering", + "protocol-specs/gas-and-fees/fee-schedule", + ], + }, + { + label: "Decentralization", + type: "category", + link: { type: "doc", id: "protocol-specs/decentralization/governance" }, + items: [ + "protocol-specs/decentralization/actors", + "protocol-specs/decentralization/governance", + "protocol-specs/decentralization/block-production", + "protocol-specs/decentralization/p2p-network", + ], + }, + { + label: "Circuits", + type: "category", + link: { type: "doc", id: "protocol-specs/circuits/high-level-topology" }, + items: [ + "protocol-specs/circuits/private-function", + "protocol-specs/circuits/private-kernel-initial", + "protocol-specs/circuits/private-kernel-inner", + "protocol-specs/circuits/private-kernel-reset", + "protocol-specs/circuits/private-kernel-tail", + "protocol-specs/circuits/public-kernel-initial", + "protocol-specs/circuits/public-kernel-inner", + "protocol-specs/circuits/public-kernel-tail", + ], + }, + { + label: "Rollup Circuits", + type: "category", + link: { type: "doc", id: "protocol-specs/rollup-circuits/index" }, + items: [ + "protocol-specs/rollup-circuits/base-rollup", + "protocol-specs/rollup-circuits/merge-rollup", + "protocol-specs/rollup-circuits/tree-parity", + "protocol-specs/rollup-circuits/root-rollup", + ], + }, + { + label: "Aztec (Public) VM", + type: "category", + link: { type: "doc", id: "protocol-specs/public-vm/index" }, + items: [ + "protocol-specs/public-vm/intro", + "protocol-specs/public-vm/state", + "protocol-specs/public-vm/memory-model", + "protocol-specs/public-vm/context", + "protocol-specs/public-vm/execution", + "protocol-specs/public-vm/nested-calls", + "protocol-specs/public-vm/instruction-set", + { + label: "AVM Circuit", + type: "category", + link: { type: "doc", id: "protocol-specs/public-vm/circuit-index" }, + items: [ + "protocol-specs/public-vm/avm-circuit", + "protocol-specs/public-vm/control-flow", + "protocol-specs/public-vm/alu", + "protocol-specs/public-vm/bytecode-validation-circuit", + ], + }, + "protocol-specs/public-vm/type-structs", + ], + }, + ], }; module.exports = sidebars; diff --git a/docs/src/katex-macros.js b/docs/src/katex-macros.js new file mode 100644 index 00000000000..f60a6f0b66b --- /dev/null +++ b/docs/src/katex-macros.js @@ -0,0 +1,80 @@ +module.exports = { + "\\sk": "\\color{red}{sk}\\color{black}{}", + "\\seed": "\\color{red}\\text{{seed}}\\color{black}{}", + "\\nskm": "\\color{red}{nsk_m}\\color{black}{}", + "\\tskm": "\\color{red}{tsk_m}\\color{black}{}", + "\\ivskm": "\\color{red}{ivsk_m}\\color{black}{}", + "\\ovskm": "\\color{red}{ovsk_m}\\color{black}{}", + + "\\Npkm": "\\color{green}{Npk_m}\\color{black}{}", + "\\Tpkm": "\\color{green}{Tpk_m}\\color{black}{}", + "\\Ivpkm": "\\color{green}{Ivpk_m}\\color{black}{}", + "\\Ovpkm": "\\color{green}{Ovpk_m}\\color{black}{}", + + "\\address": "\\color{green}{address}\\color{black}{}", + "\\codehash": "\\color{green}{code_hash}\\color{black}{}", + "\\constructorhash": "\\color{green}{constructor_hash}\\color{black}{}", + "\\classid": "\\color{green}{classid}\\color{black}{}", + + "\\nskapp": "\\color{red}{nsk_{app}}\\color{black}{}", + "\\tskapp": "\\color{red}{tsk_{app}}\\color{black}{}", + "\\ivskapp": "\\color{red}{ivsk_{app}}\\color{black}{}", + "\\ovskapp": "\\color{red}{ovsk_{app}}\\color{black}{}", + + "\\Nkapp": "\\color{orange}{Nk_{app}}\\color{black}{}", + + "\\Npkapp": "\\color{green}{Npk_{app}}\\color{black}{}", + + "\\Ivpkapp": "\\color{green}{Ivpk_{app}}\\color{black}{}", + + "\\happL": "\\color{green}{h_{app}^L}\\color{black}{}", + "\\happn": "\\color{green}{h_{app}^n}\\color{black}{}", + "\\happiv": "\\color{green}{h_{app}^{iv}}\\color{black}{}", + + "\\d": "\\color{green}{d}\\color{black}{}", + "\\Gd": "\\color{green}{G_d}\\color{black}{}", + + "\\Ivpkappd": "\\color{violet}{Ivpk_{app,d}}\\color{black}{}", + "\\shareableIvpkappd": + "\\color{violet}{\\widetilde{Ivpk_{app,d}}}\\color{black}{}", + "\\Ivpkmd": "\\color{violet}{Ivpk_{m,d}}\\color{black}{}", + "\\shareableIvpkmd": + "\\color{violet}{\\widetilde{Ivpk_{m,d}}}\\color{black}{}", + + "\\ivskappstealth": "\\color{red}{ivsk_{app,stealth}}\\color{black}{}", + "\\Ivpkappdstealth": "\\color{violet}{Ivpk_{app,d,stealth}}\\color{black}{}", + "\\Pkappdstealth": "\\color{violet}{Pk_{app,d,stealth}}\\color{black}{}", + "\\ivskmstealth": "\\color{red}{ivsk_{m,stealth}}\\color{black}{}", + "\\Ivpkmdstealth": "\\color{violet}{Ivpk_{m,d,stealth}}\\color{black}{}", + "\\Pkmdstealth": "\\color{violet}{Pk_{m,d,stealth}}\\color{black}{}", + + "\\hstealth": "\\color{violet}{h_{stealth}}\\color{black}{}", + + "\\esk": "\\color{red}{esk}\\color{black}{}", + "\\Epk": "\\color{green}{Epk}\\color{black}{}", + "\\Epkd": "\\color{green}{Epk_d}\\color{black}{}", + "\\eskheader": "\\color{red}{esk_{header}}\\color{black}{}", + "\\Epkheader": "\\color{green}{Epk_{header}}\\color{black}{}", + "\\Epkdheader": "\\color{green}{Epk_{d,header}}\\color{black}{}", + + "\\sharedsecret": "\\color{violet}{\\text{S}}\\color{black}{}", + "\\sharedsecretmheader": + "\\color{violet}{\\text{S_{m,header}}}\\color{black}{}", + "\\sharedsecretappheader": + "\\color{violet}{\\text{S_{app,header}}}\\color{black}{}", + + "\\hmencheader": "\\color{violet}{h_{m,enc,header}}\\color{black}{}", + "\\happencheader": "\\color{violet}{h_{app,enc,header}}\\color{black}{}", + "\\hmenc": "\\color{violet}{h_{m,enc}}\\color{black}{}", + "\\happenc": "\\color{violet}{h_{app,enc}}\\color{black}{}", + "\\incomingenckey": "\\color{violet}{h_{incoming_enc_key}}\\color{black}{}", + + "\\plaintext": "\\color{red}{\\text{plaintext}}\\color{black}{}", + "\\ciphertext": "\\color{green}{\\text{ciphertext}}\\color{black}{}", + "\\ciphertextheader": + "\\color{green}{\\text{ciphertext\\_header}}\\color{black}{}", + "\\payload": "\\color{green}{\\text{payload}}\\color{black}{}", + + "\\tagg": "\\color{green}{\\text{tag}}\\color{black}{}", + "\\Taghs": "\\color{green}{\\text{Tag}\\_{hs}}\\color{black}{}", +}; diff --git a/docs/src/preprocess/InstructionSet/InstructionSet.js b/docs/src/preprocess/InstructionSet/InstructionSet.js new file mode 100644 index 00000000000..936a15b0c23 --- /dev/null +++ b/docs/src/preprocess/InstructionSet/InstructionSet.js @@ -0,0 +1,1624 @@ +const { instructionSize } = require("./InstructionSize"); + +const TOPICS_IN_TABLE = ["Name", "Summary", "Expression"]; +const TOPICS_IN_SECTIONS = [ + "Name", + "Summary", + "Category", + "Flags", + "Args", + "Expression", + "Details", + "World State access tracing", + "Additional AVM circuit checks", + "Triggers downstream circuit operations", + "Tag checks", + "Tag updates", + "Bit-size", +]; + +const IN_TAG_DESCRIPTION = + "The [tag/size](./memory-model#tags-and-tagged-memory) to check inputs against and tag the destination with."; +const IN_TAG_DESCRIPTION_NO_FIELD = + IN_TAG_DESCRIPTION + " `field` type is NOT supported for this instruction."; +const DST_TAG_DESCRIPTION = + "The [tag/size](./memory-model#tags-and-tagged-memory) to tag the destination with but not to check inputs against."; +const INDIRECT_FLAG_DESCRIPTION = + "Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`."; + +const CALL_INSTRUCTION_ARGS = [ + { + name: "gasOffset", + description: + "offset to three words containing `{l1GasLeft, l2GasLeft, daGasLeft}`: amount of gas to provide to the callee", + }, + { name: "addrOffset", description: "address of the contract to call" }, + { + name: "argsOffset", + description: "memory offset to args (will become the callee's calldata)", + }, + { + name: "argsSize", + description: "number of words to pass via callee's calldata", + mode: "immediate", + type: "u32", + }, + { + name: "retOffset", + description: + "destination memory offset specifying where to store the data returned from the callee", + }, + { + name: "retSize", + description: "number of words to copy from data returned by callee", + mode: "immediate", + type: "u32", + }, + { + name: "successOffset", + description: + "destination memory offset specifying where to store the call's success (0: failure, 1: success)", + type: "u8", + }, +]; +const CALL_INSTRUCTION_DETAILS = ` + ["Nested contract calls"](./nested-calls) provides a full explanation of this + instruction along with the shorthand used in the expression above. + The explanation includes details on charging gas for nested calls, + nested context derivation, world state tracing, and updating the parent context + after the nested call halts.`; + +const INSTRUCTION_SET_RAW = [ + { + id: "add", + Name: "`ADD`", + Category: "Compute - Arithmetic", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] + M[bOffset] mod 2^k`", + Summary: "Addition (a + b)", + Details: "Wraps on overflow", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "sub", + Name: "`SUB`", + Category: "Compute - Arithmetic", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] - M[bOffset] mod 2^k`", + Summary: "Subtraction (a - b)", + Details: "Wraps on undeflow", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "mul", + Name: "`MUL`", + Category: "Compute - Arithmetic", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] * M[bOffset] mod 2^k`", + Summary: "Multiplication (a * b)", + Details: "Wraps on overflow", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "div", + Name: "`DIV`", + Category: "Compute - Arithmetic", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] / M[bOffset]`", + Summary: "Unsigned integer division (a / b)", + Details: "If the input is a field, it will be interpreted as an integer", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "fdiv", + Name: "`FDIV`", + Category: "Compute - Arithmetic", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] / M[bOffset]`", + Summary: "Field division (a / b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == field`", + "Tag updates": "`T[dstOffset] = field`", + }, + { + id: "eq", + Name: "`EQ`", + Category: "Compute - Comparators", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + type: "u8", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] == M[bOffset] ? 1 : 0`", + Summary: "Equality check (a == b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = u8`", + }, + { + id: "lt", + Name: "`LT`", + Category: "Compute - Comparators", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + type: "u8", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] < M[bOffset] ? 1 : 0`", + Summary: "Less-than check (a < b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = u8`", + }, + { + id: "lte", + Name: "`LTE`", + Category: "Compute - Comparators", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + type: "u8", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] <= M[bOffset] ? 1 : 0`", + Summary: "Less-than-or-equals check (a <= b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = u8`", + }, + { + id: "and", + Name: "`AND`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] AND M[bOffset]`", + Summary: "Bitwise AND (a & b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "or", + Name: "`OR`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] OR M[bOffset]`", + Summary: "Bitwise OR (a | b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "xor", + Name: "`XOR`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] XOR M[bOffset]`", + Summary: "Bitwise XOR (a ^ b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "not", + Name: "`NOT`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = NOT M[aOffset]`", + Summary: "Bitwise NOT (inversion)", + Details: "", + "Tag checks": "`T[aOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "shl", + Name: "`SHL`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] << M[bOffset]`", + Summary: "Bitwise leftward shift (a << b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "shr", + Name: "`SHR`", + Category: "Compute - Bitwise", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "inTag", description: IN_TAG_DESCRIPTION_NO_FIELD }, + ], + Args: [ + { + name: "aOffset", + description: "memory offset of the operation's left input", + }, + { + name: "bOffset", + description: "memory offset of the operation's right input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[aOffset] >> M[bOffset]`", + Summary: "Bitwise rightward shift (a >> b)", + Details: "", + "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "cast", + Name: "`CAST`", + Category: "Type Conversions", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { name: "dstTag", description: DST_TAG_DESCRIPTION }, + ], + Args: [ + { name: "aOffset", description: "memory offset of word to cast" }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = cast(M[aOffset])`", + Summary: "Type cast", + Details: + "Cast a word in memory based on the `dstTag` specified in the bytecode. Truncates (`M[dstOffset] = M[aOffset] mod 2^dstsize`) when casting to a smaller type, left-zero-pads when casting to a larger type. See [here](./memory-model#cast-and-tag-conversions) for more details.", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = dstTag`", + }, + { + id: "address", + Name: "`ADDRESS`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.address`", + Summary: "Get the address of the currently executing l2 contract", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "storageaddress", + Name: "`STORAGEADDRESS`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.storageAddress`", + Summary: "Get the _storage_ address of the currently executing context", + Details: "The storage address is used for public storage accesses.", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "origin", + Name: "`ORIGIN`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.origin`", + Summary: "Get the transaction's origination address", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "sender", + Name: "`SENDER`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.sender`", + Summary: "Get the address of the sender (caller of the current context)", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "portal", + Name: "`PORTAL`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.portal`", + Summary: "Get the address of the l1 portal contract", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "feeperl1gas", + Name: "`FEEPERL1GAS`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.feePerL1Gas`", + Summary: + 'Get the fee to be paid per "L1 gas" - constant for entire transaction', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "feeperl2gas", + Name: "`FEEPERL2GAS`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.feePerL2Gas`", + Summary: + 'Get the fee to be paid per "L2 gas" - constant for entire transaction', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "feeperdagas", + Name: "`FEEPERDAGAS`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.feePerDaGas`", + Summary: + 'Get the fee to be paid per "DA gas" - constant for entire transaction', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "contractcalldepth", + Name: "`CONTRACTCALLDEPTH`", + Category: "Execution Environment", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.contractCallDepth`", + Summary: "Get how many contract calls deep the current call context is", + Details: + "Note: security issues with EVM's tx.origin can be resolved by asserting `calldepth == 0`.", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u8`", + }, + { + id: "chainid", + Name: "`CHAINID`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.chainId`", + Summary: "Get this rollup's L1 chain ID", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "version", + Name: "`VERSION`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.version`", + Summary: "Get this rollup's L2 version ID", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "blocknumber", + Name: "`BLOCKNUMBER`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.blocknumber`", + Summary: "Get this L2 block's number", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "timestamp", + Name: "`TIMESTAMP`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.timestamp`", + Summary: "Get this L2 block's timestamp", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u64`", + }, + { + id: "coinbase", + Name: "`COINBASE`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.coinbase`", + Summary: "Get the block's beneficiary address", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "blockl1gaslimit", + Name: "`BLOCKL1GASLIMIT`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.l1GasLimit`", + Summary: 'Total amount of "L1 gas" that a block can consume', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "blockl2gaslimit", + Name: "`BLOCKL2GASLIMIT`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.l2GasLimit`", + Summary: 'Total amount of "L2 gas" that a block can consume', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "blockdagaslimit", + Name: "`BLOCKDAGASLIMIT`", + Category: "Execution Environment - Globals", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.environment.globals.daGasLimit`", + Summary: 'Total amount of "DA gas" that a block can consume', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "calldatacopy", + Name: "`CALLDATACOPY`", + Category: "Execution Environment - Calldata", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "cdOffset", description: "offset into calldata to copy from" }, + { + name: "copySize", + description: "number of words to copy", + mode: "immediate", + type: "u32", + }, + { + name: "dstOffset", + description: "memory offset specifying where to copy the first word to", + }, + ], + Expression: + "`M[dstOffset:dstOffset+copySize] = context.environment.calldata[cdOffset:cdOffset+copySize]`", + Summary: "Copy calldata into memory", + Details: + "Calldata is read-only and cannot be directly operated on by other instructions. This instruction moves words from calldata into memory so they can be operated on normally.", + "Tag checks": "", + "Tag updates": "`T[dstOffset:dstOffset+copySize] = field`", + }, + { + id: "l1gasleft", + Name: "`L1GASLEFT`", + Category: "Machine State - Gas", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.machineState.l1GasLeft`", + Summary: 'Remaining "L1 gas" for this call (after this instruction)', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "l2gasleft", + Name: "`L2GASLEFT`", + Category: "Machine State - Gas", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.MachineState.l2GasLeft`", + Summary: 'Remaining "L2 gas" for this call (after this instruction)', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "dagasleft", + Name: "`DAGASLEFT`", + Category: "Machine State - Gas", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = context.machineState.daGasLeft`", + Summary: 'Remaining "DA gas" for this call (after this instruction)', + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = u32`", + }, + { + id: "jump", + Name: "`JUMP`", + Category: "Machine State - Control Flow", + Flags: [], + Args: [ + { + name: "loc", + description: "target location to jump to", + mode: "immediate", + type: "u32", + }, + ], + Expression: "`context.machineState.pc = loc`", + Summary: "Jump to a location in the bytecode", + Details: + "Target location is an immediate value (a constant in the bytecode).", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "jumpi", + Name: "`JUMPI`", + Category: "Machine State - Control Flow", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "loc", + description: "target location conditionally jump to", + mode: "immediate", + type: "u32", + }, + { + name: "condOffset", + description: "memory offset of the operations 'conditional' input", + }, + ], + Expression: + "`context.machineState.pc = M[condOffset] > 0 ? loc : context.machineState.pc`", + Summary: "Conditionally jump to a location in the bytecode", + Details: + "Target location is an immediate value (a constant in the bytecode). `T[condOffset]` is not checked because the greater-than-zero suboperation is the same regardless of type.", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "internalcall", + Name: "`INTERNALCALL`", + Category: "Machine State - Control Flow", + Flags: [], + Args: [ + { + name: "loc", + description: "target location to jump/call to", + mode: "immediate", + type: "u32", + }, + ], + Expression: ` +context.machineState.internalCallStack.push(context.machineState.pc) +context.machineState.pc = loc +`, + Summary: + "Make an internal call. Push the current PC to the internal call stack and jump to the target location.", + Details: + "Target location is an immediate value (a constant in the bytecode).", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "internalreturn", + Name: "`INTERNALRETURN`", + Category: "Machine State - Control Flow", + Flags: [], + Args: [], + Expression: + "`context.machineState.pc = context.machineState.internalCallStack.pop()`", + Summary: + "Return from an internal call. Pop from the internal call stack and jump to the popped location.", + Details: "", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "set", + Name: "`SET`", + Category: "Machine State - Memory", + Flags: [ + { name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }, + { + name: "inTag", + description: + "The [type/size](./memory-model#tags-and-tagged-memory) to check inputs against and tag the destination with. `field` type is NOT supported for SET.", + }, + ], + Args: [ + { + name: "const", + description: + "an N-bit constant value from the bytecode to store in memory (any type except `field`)", + mode: "immediate", + }, + { + name: "dstOffset", + description: "memory offset specifying where to store the constant", + }, + ], + Expression: "`M[dstOffset] = const`", + Summary: "Set a memory word from a constant in the bytecode", + Details: + "Set memory word at `dstOffset` to `const`'s immediate value. `const`'s bit-size (N) can be 8, 16, 32, 64, or 128 based on `inTag`. It _cannot be 254 (`field` type)_!", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = inTag`", + }, + { + id: "mov", + Name: "`MOV`", + Category: "Machine State - Memory", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "srcOffset", description: "memory offset of word to move" }, + { + name: "dstOffset", + description: "memory offset specifying where to store that word", + }, + ], + Expression: "`M[dstOffset] = M[srcOffset]`", + Summary: "Move a word from source memory location to destination", + Details: "", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = T[srcOffset]`", + }, + { + id: "cmov", + Name: "`CMOV`", + Category: "Machine State - Memory", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "aOffset", + description: "memory offset of word 'a' to conditionally move", + }, + { + name: "bOffset", + description: "memory offset of word 'b' to conditionally move", + }, + { + name: "condOffset", + description: "memory offset of the operations 'conditional' input", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: "`M[dstOffset] = M[condOffset] > 0 ? M[aOffset] : M[bOffset]`", + Summary: + "Move a word (conditionally chosen) from one memory location to another (`d = cond > 0 ? a : b`)", + Details: + "One of two source memory locations is chosen based on the condition. `T[condOffset]` is not checked because the greater-than-zero suboperation is the same regardless of type.", + "Tag checks": "", + "Tag updates": + "`T[dstOffset] = M[condOffset] > 0 ? T[aOffset] : T[bOffset]`", + }, + { + id: "sload", + Name: "`SLOAD`", + Category: "World State - Public Storage", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "slotOffset", + description: "memory offset of the storage slot to load from", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result", + }, + ], + Expression: ` +M[dstOffset] = S[M[slotOffset]] +`, + Summary: + "Load a word from this contract's persistent public storage. Zero is loaded for unwritten slots.", + Details: ` +// Expression is shorthand for +leafIndex = hash(context.environment.storageAddress, M[slotOffset]) +exists = context.worldState.publicStorage.has(leafIndex) // exists == previously-written +if exists: + value = context.worldState.publicStorage.get(leafIndex: leafIndex) +else: + value = 0 +M[dstOffset] = value +`, + "World State access tracing": ` +context.worldStateAccessTrace.publicStorageReads.append( + TracedStorageRead { + callPointer: context.environment.callPointer, + slot: M[slotOffset], + exists: exists, // defined above + value: value, // defined above + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Storage slot siloing (hash with contract address), public data tree membership check", + "Tag checks": "", + "Tag updates": "`T[dstOffset] = field`", + }, + { + id: "sstore", + Name: "`SSTORE`", + Category: "World State - Public Storage", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "srcOffset", description: "memory offset of the word to store" }, + { + name: "slotOffset", + description: "memory offset containing the storage slot to store to", + }, + ], + Expression: ` +S[M[slotOffset]] = M[srcOffset] +`, + Summary: "Write a word to this contract's persistent public storage", + Details: ` +// Expression is shorthand for +context.worldState.publicStorage.set({ + leafIndex: hash(context.environment.storageAddress, M[slotOffset]), + leaf: M[srcOffset], +}) +`, + "World State access tracing": ` +context.worldStateAccessTrace.publicStorageWrites.append( + TracedStorageWrite { + callPointer: context.environment.callPointer, + slot: M[slotOffset], + value: M[srcOffset], + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Storage slot siloing (hash with contract address), public data tree update", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "notehashexists", + Name: "`NOTEHASHEXISTS`", + Category: "World State - Notes & Nullifiers", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "noteHashOffset", description: "memory offset of the note hash" }, + { + name: "leafIndexOffset", + description: "memory offset of the leaf index", + }, + { + name: "existsOffset", + description: + "memory offset specifying where to store operation's result (whether the note hash leaf exists)", + }, + ], + Expression: ` +exists = context.worldState.noteHashes.has({ + leafIndex: M[leafIndexOffset] + leaf: hash(context.environment.storageAddress, M[noteHashOffset]), +}) +M[existsOffset] = exists +`, + Summary: + "Check whether a note hash exists in the note hash tree (as of the start of the current block)", + "World State access tracing": ` +context.worldStateAccessTrace.noteHashChecks.append( + TracedNoteHashCheck { + callPointer: context.environment.callPointer, + leafIndex: M[leafIndexOffset] + noteHash: M[noteHashOffset], + exists: exists, // defined above + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Note hash siloing (hash with storage contract address), note hash tree membership check", + "Tag checks": "", + "Tag updates": "`T[existsOffset] = u8`", + }, + { + id: "emitnotehash", + Name: "`EMITNOTEHASH`", + Category: "World State - Notes & Nullifiers", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "noteHashOffset", description: "memory offset of the note hash" }, + ], + Expression: ` +context.worldState.noteHashes.append( + hash(context.environment.storageAddress, M[noteHashOffset]) +) +`, + Summary: "Emit a new note hash to be inserted into the note hash tree", + "World State access tracing": ` +context.worldStateAccessTrace.newNoteHashes.append( + TracedNoteHash { + callPointer: context.environment.callPointer, + noteHash: M[noteHashOffset], // unsiloed note hash + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Note hash siloing (hash with contract address), note hash tree insertion.", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "nullifierexists", + Name: "`NULLIFIEREXISTS`", + Category: "World State - Notes & Nullifiers", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "nullifierOffset", + description: "memory offset of the unsiloed nullifier", + }, + { + name: "addressOffset", + description: "memory offset of the storage address", + }, + { + name: "existsOffset", + description: + "memory offset specifying where to store operation's result (whether the nullifier exists)", + }, + ], + Expression: ` +exists = pendingNullifiers.has(M[addressOffset], M[nullifierOffset]) || context.worldState.nullifiers.has( + hash(M[addressOffset], M[nullifierOffset]) +) +M[existsOffset] = exists +`, + Summary: + "Check whether a nullifier exists in the nullifier tree (including nullifiers from earlier in the current transaction or from earlier in the current block)", + "World State access tracing": ` +context.worldStateAccessTrace.nullifierChecks.append( + TracedNullifierCheck { + callPointer: context.environment.callPointer, + nullifier: M[nullifierOffset], + storageAddress: M[addressOffset], + exists: exists, // defined above + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Nullifier siloing (hash with storage contract address), nullifier tree membership check", + "Tag checks": "", + "Tag updates": "`T[existsOffset] = u8`", + }, + { + id: "emitnullifier", + Name: "`EMITNULLIFIER`", + Category: "World State - Notes & Nullifiers", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { name: "nullifierOffset", description: "memory offset of nullifier" }, + ], + Expression: ` +context.worldState.nullifiers.append( + hash(context.environment.storageAddress, M[nullifierOffset]) +) +`, + Summary: "Emit a new nullifier to be inserted into the nullifier tree", + "World State access tracing": ` +context.worldStateAccessTrace.newNullifiers.append( + TracedNullifier { + callPointer: context.environment.callPointer, + nullifier: M[nullifierOffset], // unsiloed nullifier + counter: ++context.worldStateAccessTrace.accessCounter, + } +) +`, + "Triggers downstream circuit operations": + "Nullifier siloing (hash with contract address), nullifier tree non-membership-check and insertion.", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "l1tol2msgexists", + Name: "`L1TOL2MSGEXISTS`", + Category: "World State - Messaging", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "msgHashOffset", + description: "memory offset of the message hash", + }, + { + name: "msgLeafIndexOffset", + description: + "memory offset of the message's leaf index in the L1-to-L2 message tree", + }, + { + name: "existsOffset", + description: + "memory offset specifying where to store operation's result (whether the message exists in the L1-to-L2 message tree)", + }, + ], + Expression: ` +exists = context.worldState.l1ToL2Messages.has({ + leafIndex: M[msgLeafIndexOffset], leaf: M[msgHashOffset] +}) +M[existsOffset] = exists +`, + Summary: "Check if a message exists in the L1-to-L2 message tree", + "World State access tracing": ` +context.worldStateAccessTrace.l1ToL2MessagesChecks.append( + L1ToL2Message { + callPointer: context.environment.callPointer, + leafIndex: M[msgLeafIndexOffset], + msgHash: M[msgHashOffset], + exists: exists, // defined above + } +) +`, + "Triggers downstream circuit operations": + "L1-to-L2 message tree membership check", + "Tag checks": "", + "Tag updates": ` +T[existsOffset] = u8, +`, + }, + { + id: "headermember", + Name: "`HEADERMEMBER`", + Category: "World State - Archive Tree & Headers", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "blockIndexOffset", + description: + "memory offset of the block index (same as archive tree leaf index) of the header to access", + }, + { + name: "memberIndexOffset", + description: + "memory offset of the index of the member to retrieve from the header of the specified block", + }, + { + name: "existsOffset", + description: + "memory offset specifying where to store operation's result (whether the leaf exists in the archive tree)", + }, + { + name: "dstOffset", + description: + "memory offset specifying where to store operation's result (the retrieved header member)", + }, + ], + Expression: ` +exists = context.worldState.header.has({ + leafIndex: M[blockIndexOffset], leaf: M[msgKeyOffset] +}) +M[existsOffset] = exists +if exists: + header = context.worldState.headers.get(M[blockIndexOffset]) + M[dstOffset] = header[M[memberIndexOffset]] // member +`, + Summary: + "Check if a header exists in the [archive tree](../state/archive) and retrieve the specified member if so", + "World State access tracing": ` +context.worldStateAccessTrace.archiveChecks.append( + TracedArchiveLeafCheck { + leafIndex: M[blockIndexOffset], // leafIndex == blockIndex + leaf: exists ? hash(header) : 0, // "exists" defined above + } +) +`, + "Additional AVM circuit checks": + "Hashes entire header to archive leaf for tracing. Aggregates header accesses and so that a header need only be hashed once.", + "Triggers downstream circuit operations": "Archive tree membership check", + "Tag checks": "", + "Tag updates": ` +T[existsOffset] = u8 +T[dstOffset] = field +`, + }, + { + id: "getcontractinstance", + Name: "`GETCONTRACTINSTANCE`", + Category: "Other", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "addressOffset", + description: "memory offset of the contract instance address", + }, + { + name: "dstOffset", + description: "location to write the contract instance information to", + }, + ], + Expression: ` +M[dstOffset:dstOffset+CONTRACT_INSTANCE_SIZE+1] = [ + instance_found_in_address, + instance.salt ?? 0, + instance.deployer ?? 0, + instance.contractClassId ?? 0, + instance.initializationHash ?? 0, + instance.portalContractAddress ?? 0, + instance.publicKeysHash ?? 0, +] +`, + Summary: "Copies contract instance data to memory", + "Tag checks": "", + "Tag updates": "T[dstOffset:dstOffset+CONTRACT_INSTANCE_SIZE+1] = field", + "Additional AVM circuit checks": "TO-DO", + "Triggers downstream circuit operations": "TO-DO", + }, + { + id: "emitunencryptedlog", + Name: "`EMITUNENCRYPTEDLOG`", + Category: "Accrued Substate - Logging", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "eventSelectorOffset", + description: "memory offset of the event selector", + }, + { name: "logOffset", description: "memory offset of the data to log" }, + { + name: "logSize", + description: "number of words to log", + mode: "immediate", + type: "u32", + }, + ], + Expression: ` +context.accruedSubstate.unencryptedLogs.append( + UnencryptedLog { + address: context.environment.address, + eventSelector: M[eventSelectorOffset], + log: M[logOffset:logOffset+logSize], + } +) +`, + Summary: "Emit an unencrypted log", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "sendl2tol1msg", + Name: "`SENDL2TOL1MSG`", + Category: "Accrued Substate - Messaging", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "recipientOffset", + description: "memory offset of the message recipient", + }, + { + name: "contentOffset", + description: "memory offset of the message content", + }, + ], + Expression: ` +context.accruedSubstate.sentL2ToL1Messages.append( + SentL2ToL1Message { + address: context.environment.address, + recipient: M[recipientOffset], + message: M[contentOffset] + } +) +`, + Summary: "Send an L2-to-L1 message", + "Tag checks": "", + "Tag updates": "", + }, + { + id: "call", + Name: "`CALL`", + Category: "Control Flow - Contract Calls", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: CALL_INSTRUCTION_ARGS, + Expression: ` +// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } +chargeGas(context, + l1GasCost=M[instr.args.gasOffset], + l2GasCost=M[instr.args.gasOffset+1], + daGasCost=M[instr.args.gasOffset+2]) +traceNestedCall(context, instr.args.addrOffset) +nestedContext = deriveContext(context, instr.args, isStaticCall=false, isDelegateCall=false) +execute(nestedContext) +updateContextAfterNestedCall(context, instr.args, nestedContext) +`, + Summary: "Call into another contract", + Details: + `Creates a new (nested) execution context and triggers execution within that context. + Execution proceeds in the nested context until it reaches a halt at which point + execution resumes in the current/calling context. + A non-existent contract or one with no code will return success. ` + + CALL_INSTRUCTION_DETAILS, + "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", + "Tag updates": ` +T[successOffset] = u8 +T[retOffset:retOffset+retSize] = field +`, + }, + { + id: "staticcall", + Name: "`STATICCALL`", + Category: "Control Flow - Contract Calls", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: CALL_INSTRUCTION_ARGS, + Expression: ` +// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } +chargeGas(context, + l1GasCost=M[instr.args.gasOffset], + l2GasCost=M[instr.args.gasOffset+1], + daGasCost=M[instr.args.gasOffset+2]) +traceNestedCall(context, instr.args.addrOffset) +nestedContext = deriveContext(context, instr.args, isStaticCall=true, isDelegateCall=false) +execute(nestedContext) +updateContextAfterNestedCall(context, instr.args, nestedContext) +`, + Summary: + "Call into another contract, disallowing World State and Accrued Substate modifications", + Details: + `Same as \`CALL\`, but disallows World State and Accrued Substate modifications. ` + + CALL_INSTRUCTION_DETAILS, + "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", + "Tag updates": ` +T[successOffset] = u8 +T[retOffset:retOffset+retSize] = field +`, + }, + { + id: "delegatecall", + Name: "`DELEGATECALL`", + Category: "Control Flow - Contract Calls", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: CALL_INSTRUCTION_ARGS, + Expression: ` +// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } +chargeGas(context, + l1GasCost=M[instr.args.gasOffset], + l2GasCost=M[instr.args.gasOffset+1], + daGasCost=M[instr.args.gasOffset+2]) +traceNestedCall(context, instr.args.addrOffset) +nestedContext = deriveContext(context, instr.args, isStaticCall=false, isDelegateCall=true) +execute(nestedContext) +updateContextAfterNestedCall(context, instr.args, nestedContext) +`, + Summary: + "Call into another contract, but keep the caller's `sender` and `storageAddress`", + Details: + `Same as \`CALL\`, but \`sender\` and \`storageAddress\` remains + the same in the nested call as they were in the caller. ` + + CALL_INSTRUCTION_DETAILS, + "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", + "Tag updates": ` +T[successOffset] = u8 +T[retOffset:retOffset+retSize] = field +`, + }, + { + id: "return", + Name: "`RETURN`", + Category: "Control Flow - Contract Calls", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "retOffset", + description: "memory offset of first word to return", + }, + { + name: "retSize", + description: "number of words to return", + mode: "immediate", + type: "u32", + }, + ], + Expression: ` +context.contractCallResults.output = M[retOffset:retOffset+retSize] +halt +`, + Summary: + "Halt execution within this context (without revert), optionally returning some data", + Details: + 'Return control flow to the calling context/contract. Caller will accept World State and Accrued Substate modifications. See ["Halting"](./execution#halting) to learn more. See ["Nested contract calls"](./nested-calls) to see how the caller updates its context after the nested call halts.', + "Tag checks": "", + "Tag updates": "", + }, + { + id: "revert", + Name: "`REVERT`", + Category: "Control Flow - Contract Calls", + Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], + Args: [ + { + name: "retOffset", + description: "memory offset of first word to return", + }, + { + name: "retSize", + description: "number of words to return", + mode: "immediate", + type: "u32", + }, + ], + Expression: ` +context.contractCallResults.output = M[retOffset:retOffset+retSize] +context.contractCallResults.reverted = true +halt +`, + Summary: + "Halt execution within this context as `reverted`, optionally returning some data", + Details: + 'Return control flow to the calling context/contract. Caller will reject World State and Accrued Substate modifications. See ["Halting"](./execution#halting) to learn more. See ["Nested contract calls"](./nested-calls) to see how the caller updates its context after the nested call halts.', + "Tag checks": "", + "Tag updates": "", + }, +]; +const INSTRUCTION_SET = INSTRUCTION_SET_RAW.map((instr) => { + instr["Bit-size"] = instructionSize(instr); + return instr; +}); + +module.exports = { + TOPICS_IN_TABLE, + TOPICS_IN_SECTIONS, + INSTRUCTION_SET, +}; diff --git a/yellow-paper/src/preprocess/InstructionSet/InstructionSize.js b/docs/src/preprocess/InstructionSet/InstructionSize.js similarity index 100% rename from yellow-paper/src/preprocess/InstructionSet/InstructionSize.js rename to docs/src/preprocess/InstructionSet/InstructionSize.js diff --git a/yellow-paper/src/preprocess/InstructionSet/genBitFormats.js b/docs/src/preprocess/InstructionSet/genBitFormats.js similarity index 100% rename from yellow-paper/src/preprocess/InstructionSet/genBitFormats.js rename to docs/src/preprocess/InstructionSet/genBitFormats.js diff --git a/docs/src/preprocess/InstructionSet/genMarkdown.js b/docs/src/preprocess/InstructionSet/genMarkdown.js new file mode 100644 index 00000000000..c67b7fd08fa --- /dev/null +++ b/docs/src/preprocess/InstructionSet/genMarkdown.js @@ -0,0 +1,162 @@ +const fs = require("fs"); +const path = require("path"); + +const { + TOPICS_IN_TABLE, + TOPICS_IN_SECTIONS, + INSTRUCTION_SET, + instructionSize, +} = require("./InstructionSet"); + +function escapeBraces(str) { + return str.replace(//g, ">"); +} + +function stripBraces(str) { + return str.replace(/[<>]/g, ""); +} + +function instructionSetPreface() { + let preface = "[comment]: # (THIS IS A GENERATED FILE! DO NOT EDIT!)\n"; + preface += "[comment]: # (Generated via `yarn preprocess`)\n\n"; + preface += + "[comment]: # (Generated by genMarkdown.js, InstructionSet.js, InstructionSize.js)\n\n"; + preface += "import Markdown from 'react-markdown'\n"; + preface += "import CodeBlock from '@theme/CodeBlock'\n\n"; + return preface; +} + +function toOpcode(index) { + return "0x" + index.toString(16).padStart(2, "0"); +} + +function htmlInstructionSetTable() { + let table = "## Instructions Table\n"; + table += "\nClick on an instruction name to jump to its section.\n"; + table += "\n\n"; + let header = ""; + for (let t = 0; t < TOPICS_IN_TABLE.length; t++) { + header += ``; + } + table += `${header}\n`; + + for (let i = 0; i < INSTRUCTION_SET.length; i++) { + const instr = INSTRUCTION_SET[i]; + const name = instr["Name"]; + let row = `\n`; + row += `\t`; + row += `\t`; + + for (let t = 0; t < TOPICS_IN_TABLE.length; t++) { + const topic = TOPICS_IN_TABLE[t]; + + if (topic == "Name") continue; // skip + let cell = instr[topic]; + if (cell[0] == "\n") { + // if string starts with newline, assume it's a multi-line code block + cell = `\n{\`${cell.trim()}\`}\n\t`; + } else if (cell[0] == "`" && topic != "Name") { + cell = `{\n\t\t\`${cell.replace( + /`/g, + "" + )}\`\n\t}`; + } else { + cell = escapeBraces(cell); // escape html + cell = `${cell}`; + } + row += `\n\t`; + } + row += "\n"; + table += `${row}\n`; + } + table += "
Opcode${TOPICS_IN_TABLE[t]}
${toOpcode(i)}[${stripBraces(name)}](#isa-section-${ + instr["id"] + })${cell}
\n"; + return table; +} + +function markdownSublist(items) { + let markdown = ""; + for (let i = 0; i < items.length; i++) { + let item = items[i]; + if (typeof item === "string") { + markdown += `\n\t- ${item}`; + } else { + markdown += `\n\t- **${item["name"]}**: ${item["description"]}`; + } + } + return markdown; +} + +function markdownInstructionSetSection(docsDir) { + let markdown = "## Instructions\n"; + for (let i = 0; i < INSTRUCTION_SET.length; i++) { + const instr = INSTRUCTION_SET[i]; + const name = instr["Name"]; + let subsection = `### ${name}\n`; + subsection += `${instr["Summary"]}\n\n`; + subsection += `[See in table.](#isa-table-${instr["id"]})\n\n`; + subsection += `- **Opcode**: ${toOpcode(i)}\n`; + for (let t = 0; t < TOPICS_IN_SECTIONS.length; t++) { + const topic = TOPICS_IN_SECTIONS[t]; + let field = instr[topic]; + if (topic == "Name" || topic == "Summary" || !field || field.length == 0) + continue; // skip + + let item = `- **${topic}**: `; + if (Array.isArray(field)) { + item += markdownSublist(field); + } else if (field[0] == "\n") { + // if string starts with newline, assume it's a multi-line code block + item += `\n\n{\`${field.trim()}\`}\n`; + } else { + item += field; + } + subsection += `${item}\n`; + } + + // docusaurus will get images from static/img + const urlPath = `/img/protocol-specs/public-vm/bit-formats/${name.replace( + /`/g, + "" + )}.png`; + + const bitFormatImagePath = path.join(docsDir, "..", `static${urlPath}`); + + if (fs.existsSync(bitFormatImagePath)) { + subsection += `\n[![](${urlPath})](${urlPath})`; + } + markdown += `\n${subsection}\n`; + } + return markdown; +} + +async function generateInstructionSet() { + const rootDir = path.join(__dirname, "../../../../"); + const docsDir = path.join(rootDir, "docs", "docs"); + + const relPath = path.relative( + docsDir, + "docs/protocol-specs/public-vm/gen/_instruction-set.mdx" + ); + const docsFilePath = path.resolve(docsDir, relPath); + const docsDirName = path.dirname(docsFilePath); + if (!fs.existsSync(docsDirName)) { + fs.mkdirSync(docsDirName, { recursive: true }); + } + + const preface = instructionSetPreface(); + const table = htmlInstructionSetTable(); + + const section = markdownInstructionSetSection(docsDir); + const doc = `${preface}\n${table}\n\n${section}`; + fs.writeFileSync(docsFilePath, doc); + + console.log("Preprocessing complete."); +} + +module.exports = { + generateInstructionSet, +}; diff --git a/docs/src/preprocess/index.js b/docs/src/preprocess/index.js index 129321d4ecd..13b90499ca7 100644 --- a/docs/src/preprocess/index.js +++ b/docs/src/preprocess/index.js @@ -5,6 +5,8 @@ const childProcess = require("child_process"); const { preprocessIncludeCode } = require("./include_code"); const { preprocessIncludeVersion } = require("./include_version"); +const { generateInstructionSet } = require("./InstructionSet/genMarkdown"); + async function processMarkdownFilesInDir(rootDir, docsDir, regex) { const files = fs.readdirSync(docsDir); const contentUpdates = []; @@ -117,6 +119,8 @@ async function writeProcessedFiles(docsDir, destDir, cachedDestDir, content) { } async function run() { + await generateInstructionSet(); + const rootDir = path.join(__dirname, "../../../"); const docsDir = path.join(rootDir, "docs", "docs"); const destDir = path.join(rootDir, "docs", "processed-docs"); diff --git a/yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-1.png b/docs/static/img/protocol-specs/addresses-and-keys/image-1.png similarity index 100% rename from yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-1.png rename to docs/static/img/protocol-specs/addresses-and-keys/image-1.png diff --git a/yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-3.png b/docs/static/img/protocol-specs/addresses-and-keys/image-3.png similarity index 100% rename from yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-3.png rename to docs/static/img/protocol-specs/addresses-and-keys/image-3.png diff --git a/yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-4.png b/docs/static/img/protocol-specs/addresses-and-keys/image-4.png similarity index 100% rename from yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-4.png rename to docs/static/img/protocol-specs/addresses-and-keys/image-4.png diff --git a/yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-5.png b/docs/static/img/protocol-specs/addresses-and-keys/image-5.png similarity index 100% rename from yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image-5.png rename to docs/static/img/protocol-specs/addresses-and-keys/image-5.png diff --git a/yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image.png b/docs/static/img/protocol-specs/addresses-and-keys/image.png similarity index 100% rename from yellow-paper/docs/addresses-and-keys/images/addresses-and-keys/image.png rename to docs/static/img/protocol-specs/addresses-and-keys/image.png diff --git a/yellow-paper/docs/calls/images/calls/pub_pvt_messaging.png b/docs/static/img/protocol-specs/calls/pub_pvt_messaging.png similarity index 100% rename from yellow-paper/docs/calls/images/calls/pub_pvt_messaging.png rename to docs/static/img/protocol-specs/calls/pub_pvt_messaging.png diff --git a/yellow-paper/docs/calls/images/calls/pvt_pub_ordering.png b/docs/static/img/protocol-specs/calls/pvt_pub_ordering.png similarity index 100% rename from yellow-paper/docs/calls/images/calls/pvt_pub_ordering.png rename to docs/static/img/protocol-specs/calls/pvt_pub_ordering.png diff --git a/yellow-paper/docs/cryptography/images/proof-system-components.png b/docs/static/img/protocol-specs/cryptography/proof-system-components.png similarity index 100% rename from yellow-paper/docs/cryptography/images/proof-system-components.png rename to docs/static/img/protocol-specs/cryptography/proof-system-components.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Block-Production-1.png b/docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-1.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Block-Production-1.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-1.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Block-Production-2.png b/docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-2.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Block-Production-2.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-2.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Block-Production-3.png b/docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-3.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Block-Production-3.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Block-Production-3.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-1.png b/docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-1.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-1.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-1.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-2.png b/docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-2.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-2.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-2.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-3.png b/docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-3.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-3.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-3.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-4.png b/docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-4.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-4.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-4.png diff --git a/yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-5.png b/docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-5.png similarity index 100% rename from yellow-paper/docs/decentralization/images/Aztec-Governance-Summary-5.png rename to docs/static/img/protocol-specs/decentralization/Aztec-Governance-Summary-5.png diff --git a/yellow-paper/docs/decentralization/images/network.png b/docs/static/img/protocol-specs/decentralization/network.png similarity index 100% rename from yellow-paper/docs/decentralization/images/network.png rename to docs/static/img/protocol-specs/decentralization/network.png diff --git a/yellow-paper/docs/gas-and-fees/images/gas-and-fees/Transaction.png b/docs/static/img/protocol-specs/gas-and-fees/Transaction.png similarity index 100% rename from yellow-paper/docs/gas-and-fees/images/gas-and-fees/Transaction.png rename to docs/static/img/protocol-specs/gas-and-fees/Transaction.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/com-abs-6.png b/docs/static/img/protocol-specs/l1-smart-contracts/com-abs-6.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/com-abs-6.png rename to docs/static/img/protocol-specs/l1-smart-contracts/com-abs-6.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-1.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-1.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-1.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-1.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-2.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-2.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-2.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-2.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-3.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-3.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-3.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-3.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-4.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-4.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-4.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-4.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-5.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-5.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-5.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-5.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-6.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-6.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-6.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-6.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/frontier/image-7.png b/docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-7.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/frontier/image-7.png rename to docs/static/img/protocol-specs/l1-smart-contracts/frontier/image-7.png diff --git a/yellow-paper/docs/l1-smart-contracts/images/tree-order.png b/docs/static/img/protocol-specs/l1-smart-contracts/tree-order.png similarity index 100% rename from yellow-paper/docs/l1-smart-contracts/images/tree-order.png rename to docs/static/img/protocol-specs/l1-smart-contracts/tree-order.png diff --git a/yellow-paper/docs/public-vm/images/alu.png b/docs/static/img/protocol-specs/public-vm/alu.png similarity index 100% rename from yellow-paper/docs/public-vm/images/alu.png rename to docs/static/img/protocol-specs/public-vm/alu.png diff --git a/yellow-paper/docs/public-vm/images/avm-control-flow.png b/docs/static/img/protocol-specs/public-vm/avm-control-flow.png similarity index 100% rename from yellow-paper/docs/public-vm/images/avm-control-flow.png rename to docs/static/img/protocol-specs/public-vm/avm-control-flow.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/ADD.png b/docs/static/img/protocol-specs/public-vm/bit-formats/ADD.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/ADD.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/ADD.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/ADDRESS.png b/docs/static/img/protocol-specs/public-vm/bit-formats/ADDRESS.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/ADDRESS.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/ADDRESS.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/AND.png b/docs/static/img/protocol-specs/public-vm/bit-formats/AND.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/AND.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/AND.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKDAGASLIMIT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKDAGASLIMIT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKDAGASLIMIT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKDAGASLIMIT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKHEADERBYNUM.png b/docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKHEADERBYNUM.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKHEADERBYNUM.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKHEADERBYNUM.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKL1GASLIMIT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKL1GASLIMIT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKL1GASLIMIT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKL1GASLIMIT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKL2GASLIMIT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKL2GASLIMIT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKL2GASLIMIT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKL2GASLIMIT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKNUMBER.png b/docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKNUMBER.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/BLOCKNUMBER.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/BLOCKNUMBER.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CALL.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CALL.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CALL.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CALL.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CALLDATACOPY.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CALLDATACOPY.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CALLDATACOPY.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CALLDATACOPY.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CAST.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CAST.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CAST.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CAST.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CHAINID.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CHAINID.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CHAINID.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CHAINID.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CMOV.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CMOV.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CMOV.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CMOV.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/COINBASE.png b/docs/static/img/protocol-specs/public-vm/bit-formats/COINBASE.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/COINBASE.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/COINBASE.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/CONTRACTCALLDEPTH.png b/docs/static/img/protocol-specs/public-vm/bit-formats/CONTRACTCALLDEPTH.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/CONTRACTCALLDEPTH.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/CONTRACTCALLDEPTH.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/DAGASLEFT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/DAGASLEFT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/DAGASLEFT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/DAGASLEFT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/DIV.png b/docs/static/img/protocol-specs/public-vm/bit-formats/DIV.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/DIV.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/DIV.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/EMITNOTEHASH.png b/docs/static/img/protocol-specs/public-vm/bit-formats/EMITNOTEHASH.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/EMITNOTEHASH.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/EMITNOTEHASH.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/EMITNULLIFIER.png b/docs/static/img/protocol-specs/public-vm/bit-formats/EMITNULLIFIER.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/EMITNULLIFIER.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/EMITNULLIFIER.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/EMITUNENCRYPTEDLOG.png b/docs/static/img/protocol-specs/public-vm/bit-formats/EMITUNENCRYPTEDLOG.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/EMITUNENCRYPTEDLOG.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/EMITUNENCRYPTEDLOG.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/EQ.png b/docs/static/img/protocol-specs/public-vm/bit-formats/EQ.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/EQ.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/EQ.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERDAGAS.png b/docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERDAGAS.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERDAGAS.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERDAGAS.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERL1GAS.png b/docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERL1GAS.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERL1GAS.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERL1GAS.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERL2GAS.png b/docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERL2GAS.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/FEEPERL2GAS.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/FEEPERL2GAS.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/INTERNALCALLDEPTH.png b/docs/static/img/protocol-specs/public-vm/bit-formats/INTERNALCALLDEPTH.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/INTERNALCALLDEPTH.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/INTERNALCALLDEPTH.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/INTERNALRETURN.png b/docs/static/img/protocol-specs/public-vm/bit-formats/INTERNALRETURN.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/INTERNALRETURN.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/INTERNALRETURN.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/JUMP.png b/docs/static/img/protocol-specs/public-vm/bit-formats/JUMP.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/JUMP.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/JUMP.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/JUMPI.png b/docs/static/img/protocol-specs/public-vm/bit-formats/JUMPI.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/JUMPI.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/JUMPI.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/L1GASLEFT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/L1GASLEFT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/L1GASLEFT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/L1GASLEFT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/L2GASLEFT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/L2GASLEFT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/L2GASLEFT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/L2GASLEFT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/LT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/LT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/LT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/LT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/LTE.png b/docs/static/img/protocol-specs/public-vm/bit-formats/LTE.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/LTE.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/LTE.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/MOV.png b/docs/static/img/protocol-specs/public-vm/bit-formats/MOV.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/MOV.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/MOV.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/MUL.png b/docs/static/img/protocol-specs/public-vm/bit-formats/MUL.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/MUL.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/MUL.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/NOT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/NOT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/NOT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/NOT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/OR.png b/docs/static/img/protocol-specs/public-vm/bit-formats/OR.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/OR.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/OR.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/ORIGIN.png b/docs/static/img/protocol-specs/public-vm/bit-formats/ORIGIN.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/ORIGIN.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/ORIGIN.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/PORTAL.png b/docs/static/img/protocol-specs/public-vm/bit-formats/PORTAL.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/PORTAL.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/PORTAL.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/READL1TOL2MSG.png b/docs/static/img/protocol-specs/public-vm/bit-formats/READL1TOL2MSG.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/READL1TOL2MSG.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/READL1TOL2MSG.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/RETURN.png b/docs/static/img/protocol-specs/public-vm/bit-formats/RETURN.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/RETURN.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/RETURN.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/REVERT.png b/docs/static/img/protocol-specs/public-vm/bit-formats/REVERT.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/REVERT.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/REVERT.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SENDER.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SENDER.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SENDER.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SENDER.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SENDL2TOL1MSG.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SENDL2TOL1MSG.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SENDL2TOL1MSG.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SENDL2TOL1MSG.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SET.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SET.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SET.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SET.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SHL.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SHL.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SHL.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SHL.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SHR.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SHR.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SHR.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SHR.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SLOAD.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SLOAD.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SLOAD.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SLOAD.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SSTORE.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SSTORE.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SSTORE.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SSTORE.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/STATICCALL.png b/docs/static/img/protocol-specs/public-vm/bit-formats/STATICCALL.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/STATICCALL.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/STATICCALL.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/STORAGEADDRESS.png b/docs/static/img/protocol-specs/public-vm/bit-formats/STORAGEADDRESS.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/STORAGEADDRESS.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/STORAGEADDRESS.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/SUB.png b/docs/static/img/protocol-specs/public-vm/bit-formats/SUB.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/SUB.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/SUB.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/TIMESTAMP.png b/docs/static/img/protocol-specs/public-vm/bit-formats/TIMESTAMP.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/TIMESTAMP.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/TIMESTAMP.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/VERSION.png b/docs/static/img/protocol-specs/public-vm/bit-formats/VERSION.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/VERSION.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/VERSION.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/XOR.png b/docs/static/img/protocol-specs/public-vm/bit-formats/XOR.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/XOR.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/XOR.png diff --git a/yellow-paper/docs/public-vm/gen/images/bit-formats/internalcall.png b/docs/static/img/protocol-specs/public-vm/bit-formats/internalcall.png similarity index 100% rename from yellow-paper/docs/public-vm/gen/images/bit-formats/internalcall.png rename to docs/static/img/protocol-specs/public-vm/bit-formats/internalcall.png diff --git a/yellow-paper/docs/public-vm/images/memory.png b/docs/static/img/protocol-specs/public-vm/memory.png similarity index 100% rename from yellow-paper/docs/public-vm/images/memory.png rename to docs/static/img/protocol-specs/public-vm/memory.png diff --git a/docs/yarn.lock b/docs/yarn.lock index be4e6d0886b..33eee5c977f 100644 --- a/docs/yarn.lock +++ b/docs/yarn.lock @@ -3870,7 +3870,7 @@ debug@2.6.9, debug@^2.6.0: dependencies: ms "2.0.0" -debug@4, debug@^4, debug@^4.1.0, debug@^4.1.1, debug@^4.3.1: +debug@4, debug@^4, debug@^4.0.0, debug@^4.1.0, debug@^4.1.1, debug@^4.3.1: version "4.3.4" resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.4.tgz#1319f6579357f2338d3337d2cdd4914bb5dcc865" integrity sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ== @@ -5775,6 +5775,17 @@ mdast-util-definitions@^4.0.0: dependencies: unist-util-visit "^2.0.0" +mdast-util-from-markdown@^0.8.0: + version "0.8.5" + resolved "https://registry.yarnpkg.com/mdast-util-from-markdown/-/mdast-util-from-markdown-0.8.5.tgz#d1ef2ca42bc377ecb0463a987910dae89bd9a28c" + integrity sha512-2hkTXtYYnr+NubD/g6KGBS/0mFmBcifAsI0yIWRiRo0PjVs6SSOSOdtzbp6kSGnShDN6G5aWZpKQ2lWRy27mWQ== + dependencies: + "@types/mdast" "^3.0.0" + mdast-util-to-string "^2.0.0" + micromark "~2.11.0" + parse-entities "^2.0.0" + unist-util-stringify-position "^2.0.0" + mdast-util-to-hast@10.0.1: version "10.0.1" resolved "https://registry.yarnpkg.com/mdast-util-to-hast/-/mdast-util-to-hast-10.0.1.tgz#0cfc82089494c52d46eb0e3edb7a4eb2aea021eb" @@ -5789,6 +5800,20 @@ mdast-util-to-hast@10.0.1: unist-util-position "^3.0.0" unist-util-visit "^2.0.0" +mdast-util-to-hast@^10.2.0: + version "10.2.0" + resolved "https://registry.yarnpkg.com/mdast-util-to-hast/-/mdast-util-to-hast-10.2.0.tgz#61875526a017d8857b71abc9333942700b2d3604" + integrity sha512-JoPBfJ3gBnHZ18icCwHR50orC9kNH81tiR1gs01D8Q5YpV6adHNO9nKNuFBCJQ941/32PT1a63UF/DitmS3amQ== + dependencies: + "@types/mdast" "^3.0.0" + "@types/unist" "^2.0.0" + mdast-util-definitions "^4.0.0" + mdurl "^1.0.0" + unist-builder "^2.0.0" + unist-util-generated "^1.0.0" + unist-util-position "^3.0.0" + unist-util-visit "^2.0.0" + mdast-util-to-string@^2.0.0: version "2.0.0" resolved "https://registry.yarnpkg.com/mdast-util-to-string/-/mdast-util-to-string-2.0.0.tgz#b8cfe6a713e1091cb5b728fc48885a4767f8b97b" @@ -5863,6 +5888,14 @@ methods@~1.1.2: resolved "https://registry.yarnpkg.com/methods/-/methods-1.1.2.tgz#5529a4d67654134edcc5266656835b0f851afcee" integrity sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w== +micromark@~2.11.0: + version "2.11.4" + resolved "https://registry.yarnpkg.com/micromark/-/micromark-2.11.4.tgz#d13436138eea826383e822449c9a5c50ee44665a" + integrity sha512-+WoovN/ppKolQOFIAajxi7Lu9kInbPxFuTBVEavFcL8eAfVstoc5MocPmqBeAdBOJV00uaVjegzH4+MA0DN/uA== + dependencies: + debug "^4.0.0" + parse-entities "^2.0.0" + micromatch@^4.0.2, micromatch@^4.0.4, micromatch@^4.0.5: version "4.0.5" resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.5.tgz#bc8999a7cbbf77cdc89f132f6e467051b49090c6" @@ -6961,6 +6994,11 @@ react-is@^16.13.1, react-is@^16.6.0, react-is@^16.7.0: resolved "https://registry.yarnpkg.com/react-is/-/react-is-16.13.1.tgz#789729a4dc36de2999dc156dd6c1d9c18cea56a4" integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ== +react-is@^17.0.0: + version "17.0.2" + resolved "https://registry.yarnpkg.com/react-is/-/react-is-17.0.2.tgz#e691d4a8e9c789365655539ab372762b0efb54f0" + integrity sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w== + "react-is@^17.0.1 || ^18.0.0": version "18.2.0" resolved "https://registry.yarnpkg.com/react-is/-/react-is-18.2.0.tgz#199431eeaaa2e09f86427efbb4f1473edb47609b" @@ -6988,6 +7026,24 @@ react-loadable-ssr-addon-v5-slorber@^1.0.1: dependencies: "@babel/runtime" "^7.10.3" +react-markdown@6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/react-markdown/-/react-markdown-6.0.0.tgz#e63cd32d095e864384d524986c44c34c919de517" + integrity sha512-MC+zljUJeoLb4RbDm/wRbfoQFEZGz4TDOt/wb4dEehdaJWxLMn/T2IgwhQy0VYhuPEd2fhd7iOayE8lmENU0FA== + dependencies: + "@types/hast" "^2.0.0" + "@types/unist" "^2.0.3" + comma-separated-tokens "^1.0.0" + prop-types "^15.7.2" + property-information "^5.0.0" + react-is "^17.0.0" + remark-parse "^9.0.0" + remark-rehype "^8.0.0" + space-separated-tokens "^1.1.0" + style-to-object "^0.3.0" + unified "^9.0.0" + unist-util-visit "^2.0.0" + react-player@^2.12.0: version "2.14.1" resolved "https://registry.yarnpkg.com/react-player/-/react-player-2.14.1.tgz#fc434c0e1e6161e76f5d5970721596c4acec52b1" @@ -7246,6 +7302,20 @@ remark-parse@8.0.3: vfile-location "^3.0.0" xtend "^4.0.1" +remark-parse@^9.0.0: + version "9.0.0" + resolved "https://registry.yarnpkg.com/remark-parse/-/remark-parse-9.0.0.tgz#4d20a299665880e4f4af5d90b7c7b8a935853640" + integrity sha512-geKatMwSzEXKHuzBNU1z676sGcDcFoChMK38TgdHJNAYfFtsfHDQG7MoJAjs6sgYMqyLduCYWDIWZIxiPeafEw== + dependencies: + mdast-util-from-markdown "^0.8.0" + +remark-rehype@^8.0.0: + version "8.1.0" + resolved "https://registry.yarnpkg.com/remark-rehype/-/remark-rehype-8.1.0.tgz#610509a043484c1e697437fa5eb3fd992617c945" + integrity sha512-EbCu9kHgAxKmW1yEYjx3QafMyGY3q8noUbNUI5xyKbaFP89wbhDrKxyIQNukNYthzjNHZu6J7hwFg7hRm1svYA== + dependencies: + mdast-util-to-hast "^10.2.0" + remark-squeeze-paragraphs@4.0.0: version "4.0.0" resolved "https://registry.yarnpkg.com/remark-squeeze-paragraphs/-/remark-squeeze-paragraphs-4.0.0.tgz#76eb0e085295131c84748c8e43810159c5653ead" @@ -7745,7 +7815,7 @@ source-map@^0.6.0, source-map@^0.6.1, source-map@~0.6.0: resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.6.1.tgz#74722af32e9614e9c287a8d0bbde48b5e2f1a263" integrity sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g== -space-separated-tokens@^1.0.0: +space-separated-tokens@^1.0.0, space-separated-tokens@^1.1.0: version "1.1.5" resolved "https://registry.yarnpkg.com/space-separated-tokens/-/space-separated-tokens-1.1.5.tgz#85f32c3d10d9682007e917414ddc5c26d1aa6899" integrity sha512-q/JSVd1Lptzhf5bkYm4ob4iWPjx0KiRe3sRFBNrVqbJkFaBm5vbbowy1mymoPNLRa52+oadOhJ+K49wsSeSjTA== diff --git a/l1-contracts/src/core/libraries/HeaderLib.sol b/l1-contracts/src/core/libraries/HeaderLib.sol index 24eb199e0b5..db04f207f17 100644 --- a/l1-contracts/src/core/libraries/HeaderLib.sol +++ b/l1-contracts/src/core/libraries/HeaderLib.sol @@ -70,7 +70,7 @@ library HeaderLib { struct StateReference { AppendOnlyTreeSnapshot l1ToL2MessageTree; - // Note: Can't use "partial" name here as in yellow paper because it is a reserved solidity keyword + // Note: Can't use "partial" name here as in protocol specs because it is a reserved solidity keyword PartialStateReference partialStateReference; } diff --git a/yarn-project/circuits.js/src/contract/contract_address.ts b/yarn-project/circuits.js/src/contract/contract_address.ts index 96196f01971..695ef983a54 100644 --- a/yarn-project/circuits.js/src/contract/contract_address.ts +++ b/yarn-project/circuits.js/src/contract/contract_address.ts @@ -11,7 +11,7 @@ import { type PublicKey } from '../types/public_key.js'; // TODO(@spalladino): Review all generator indices in this file /** - * Returns the deployment address for a given contract instance as defined on the [Yellow Paper](../../../../yellow-paper/docs/addresses-and-keys/specification.md). + * Returns the deployment address for a given contract instance as defined on the [Protocol Specs](../../../../docs/docs/protocol-specs/addresses-and-keys/specification.md). * ``` * salted_initialization_hash = pedersen([salt, initialization_hash, deployer, portal_contract_address as Field], GENERATOR__SALTED_INITIALIZATION_HASH) * partial_address = pedersen([contract_class_id, salted_initialization_hash], GENERATOR__CONTRACT_PARTIAL_ADDRESS_V1) diff --git a/yarn-project/circuits.js/src/contract/private_function_membership_proof.ts b/yarn-project/circuits.js/src/contract/private_function_membership_proof.ts index cbd39f5f253..2857b463c24 100644 --- a/yarn-project/circuits.js/src/contract/private_function_membership_proof.ts +++ b/yarn-project/circuits.js/src/contract/private_function_membership_proof.ts @@ -82,7 +82,7 @@ export function createPrivateFunctionMembershipProof( /** * Verifies that a private function with a membership proof as emitted by the ClassRegisterer contract is valid, - * as defined in the yellow paper at contract-deployment/classes: + * as defined in the protocol specs at contract-deployment/classes: * * ``` * // Load contract class from local db diff --git a/yarn-project/circuits.js/src/contract/unconstrained_function_membership_proof.ts b/yarn-project/circuits.js/src/contract/unconstrained_function_membership_proof.ts index 6df7afdb72e..a6b368c6d5e 100644 --- a/yarn-project/circuits.js/src/contract/unconstrained_function_membership_proof.ts +++ b/yarn-project/circuits.js/src/contract/unconstrained_function_membership_proof.ts @@ -66,7 +66,7 @@ export function createUnconstrainedFunctionMembershipProof( /** * Verifies that an unconstrained function with a membership proof as emitted by the ClassRegisterer contract is valid, - * as defined in the yellow paper at contract-deployment/classes: + * as defined in the protocol specs at contract-deployment/classes: * * ``` * // Load contract class from local db diff --git a/yarn-project/foundation/src/fields/fields.ts b/yarn-project/foundation/src/fields/fields.ts index bc180fa9ecb..c9b3c88fe96 100644 --- a/yarn-project/foundation/src/fields/fields.ts +++ b/yarn-project/foundation/src/fields/fields.ts @@ -372,7 +372,7 @@ function extendedEuclidean(a: bigint, modulus: bigint): [bigint, bigint, bigint] /** * GrumpkinScalar is an Fq. * @remarks Called GrumpkinScalar because it is used to represent elements in Grumpkin's scalar field as defined in - * the Aztec Yellow Paper. + * the Aztec Protocol Specs. */ export type GrumpkinScalar = Fq; export const GrumpkinScalar = Fq; diff --git a/yarn-project/simulator/src/avm/opcodes/context_getters.ts b/yarn-project/simulator/src/avm/opcodes/context_getters.ts index e07948e4657..d1fbc639771 100644 --- a/yarn-project/simulator/src/avm/opcodes/context_getters.ts +++ b/yarn-project/simulator/src/avm/opcodes/context_getters.ts @@ -7,7 +7,7 @@ export class L2GasLeft extends GetterInstruction { static type: string = 'L2GASLEFT'; static readonly opcode: Opcode = Opcode.L2GASLEFT; - // TODO(@spalladino) Yellow paper specifies that the value should be an Uint32, not a Field. + // TODO(@spalladino) Protocol specs specifies that the value should be an Uint32, not a Field. protected getValue(context: AvmContext): MemoryValue { return new Field(context.machineState.l2GasLeft); } diff --git a/yellow-paper/.gitignore b/yellow-paper/.gitignore deleted file mode 100644 index b2d6de30624..00000000000 --- a/yellow-paper/.gitignore +++ /dev/null @@ -1,20 +0,0 @@ -# Dependencies -/node_modules - -# Production -/build - -# Generated files -.docusaurus -.cache-loader - -# Misc -.DS_Store -.env.local -.env.development.local -.env.test.local -.env.production.local - -npm-debug.log* -yarn-debug.log* -yarn-error.log* diff --git a/yellow-paper/Dockerfile b/yellow-paper/Dockerfile deleted file mode 100644 index ab8cb91196d..00000000000 --- a/yellow-paper/Dockerfile +++ /dev/null @@ -1,4 +0,0 @@ -FROM node:18.19.0-alpine -WORKDIR /usr/src -COPY . . -RUN yarn && yarn build --no-minify \ No newline at end of file diff --git a/yellow-paper/README.md b/yellow-paper/README.md deleted file mode 100644 index aaba2fa1e16..00000000000 --- a/yellow-paper/README.md +++ /dev/null @@ -1,41 +0,0 @@ -# Website - -This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator. - -### Installation - -``` -$ yarn -``` - -### Local Development - -``` -$ yarn start -``` - -This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. - -### Build - -``` -$ yarn build -``` - -This command generates static content into the `build` directory and can be served using any static contents hosting service. - -### Deployment - -Using SSH: - -``` -$ USE_SSH=true yarn deploy -``` - -Not using SSH: - -``` -$ GIT_USER= yarn deploy -``` - -If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch. diff --git a/yellow-paper/babel.config.js b/yellow-paper/babel.config.js deleted file mode 100644 index e00595dae7d..00000000000 --- a/yellow-paper/babel.config.js +++ /dev/null @@ -1,3 +0,0 @@ -module.exports = { - presets: [require.resolve('@docusaurus/core/lib/babel/preset')], -}; diff --git a/yellow-paper/docs-tutorial-reference/intro.md b/yellow-paper/docs-tutorial-reference/intro.md deleted file mode 100644 index 8a2e69d95f9..00000000000 --- a/yellow-paper/docs-tutorial-reference/intro.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Tutorial Intro - -Let's discover **Docusaurus in less than 5 minutes**. - -## Getting Started - -Get started by **creating a new site**. - -Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**. - -### What you'll need - -- [Node.js](https://nodejs.org/en/download/) version 16.14 or above: - - When installing Node.js, you are recommended to check all checkboxes related to dependencies. - -## Generate a new site - -Generate a new Docusaurus site using the **classic template**. - -The classic template will automatically be added to your project after you run the command: - -```bash -npm init docusaurus@latest my-website classic -``` - -You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor. - -The command also installs all necessary dependencies you need to run Docusaurus. - -## Start your site - -Run the development server: - -```bash -cd my-website -npm run start -``` - -The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there. - -The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/. - -Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes. diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/_category_.json b/yellow-paper/docs-tutorial-reference/tutorial-basics/_category_.json deleted file mode 100644 index 2e6db55b1eb..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "Tutorial - Basics", - "position": 2, - "link": { - "type": "generated-index", - "description": "5 minutes to learn the most important Docusaurus concepts." - } -} diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/congratulations.md b/yellow-paper/docs-tutorial-reference/tutorial-basics/congratulations.md deleted file mode 100644 index 04771a00b72..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/congratulations.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -sidebar_position: 6 ---- - -# Congratulations! - -You have just learned the **basics of Docusaurus** and made some changes to the **initial template**. - -Docusaurus has **much more to offer**! - -Have **5 more minutes**? Take a look at **[versioning](../tutorial-extras/manage-docs-versions.md)** and **[i18n](../tutorial-extras/translate-your-site.md)**. - -Anything **unclear** or **buggy** in this tutorial? [Please report it!](https://github.com/facebook/docusaurus/discussions/4610) - -## What's next? - -- Read the [official documentation](https://docusaurus.io/) -- Modify your site configuration with [`docusaurus.config.js`](https://docusaurus.io/docs/api/docusaurus-config) -- Add navbar and footer items with [`themeConfig`](https://docusaurus.io/docs/api/themes/configuration) -- Add a custom [Design and Layout](https://docusaurus.io/docs/styling-layout) -- Add a [search bar](https://docusaurus.io/docs/search) -- Find inspirations in the [Docusaurus showcase](https://docusaurus.io/showcase) -- Get involved in the [Docusaurus Community](https://docusaurus.io/community/support) diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-blog-post.md b/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-blog-post.md deleted file mode 100644 index ea472bbaf87..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-blog-post.md +++ /dev/null @@ -1,34 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Create a Blog Post - -Docusaurus creates a **page for each blog post**, but also a **blog index page**, a **tag system**, an **RSS** feed... - -## Create your first Post - -Create a file at `blog/2021-02-28-greetings.md`: - -```md title="blog/2021-02-28-greetings.md" ---- -slug: greetings -title: Greetings! -authors: - - name: Joel Marcey - title: Co-creator of Docusaurus 1 - url: https://github.com/JoelMarcey - image_url: https://github.com/JoelMarcey.png - - name: Sébastien Lorber - title: Docusaurus maintainer - url: https://sebastienlorber.com - image_url: https://github.com/slorber.png -tags: [greetings] ---- - -Congratulations, you have made your first post! - -Feel free to play around and edit this post as much you like. -``` - -A new blog post is now available at [http://localhost:3000/blog/greetings](http://localhost:3000/blog/greetings). diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-document.md b/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-document.md deleted file mode 100644 index ffddfa8eb8a..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-document.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Create a Document - -Documents are **groups of pages** connected through: - -- a **sidebar** -- **previous/next navigation** -- **versioning** - -## Create your first Doc - -Create a Markdown file at `docs/hello.md`: - -```md title="docs/hello.md" -# Hello - -This is my **first Docusaurus document**! -``` - -A new document is now available at [http://localhost:3000/docs/hello](http://localhost:3000/docs/hello). - -## Configure the Sidebar - -Docusaurus automatically **creates a sidebar** from the `docs` folder. - -Add metadata to customize the sidebar label and position: - -```md title="docs/hello.md" {1-4} ---- -sidebar_label: 'Hi!' -sidebar_position: 3 ---- - -# Hello - -This is my **first Docusaurus document**! -``` - -It is also possible to create your sidebar explicitly in `sidebars.js`: - -```js title="sidebars.js" -module.exports = { - tutorialSidebar: [ - 'intro', - // highlight-next-line - 'hello', - { - type: 'category', - label: 'Tutorial', - items: ['tutorial-basics/create-a-document'], - }, - ], -}; -``` diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-page.md b/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-page.md deleted file mode 100644 index 20e2ac30055..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/create-a-page.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Create a Page - -Add **Markdown or React** files to `src/pages` to create a **standalone page**: - -- `src/pages/index.js` → `localhost:3000/` -- `src/pages/foo.md` → `localhost:3000/foo` -- `src/pages/foo/bar.js` → `localhost:3000/foo/bar` - -## Create your first React Page - -Create a file at `src/pages/my-react-page.js`: - -```jsx title="src/pages/my-react-page.js" -import React from 'react'; -import Layout from '@theme/Layout'; - -export default function MyReactPage() { - return ( - -

My React page

-

This is a React page

- - ); -} -``` - -A new page is now available at [http://localhost:3000/my-react-page](http://localhost:3000/my-react-page). - -## Create your first Markdown Page - -Create a file at `src/pages/my-markdown-page.md`: - -```mdx title="src/pages/my-markdown-page.md" -# My Markdown page - -This is a Markdown page -``` - -A new page is now available at [http://localhost:3000/my-markdown-page](http://localhost:3000/my-markdown-page). diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/deploy-your-site.md b/yellow-paper/docs-tutorial-reference/tutorial-basics/deploy-your-site.md deleted file mode 100644 index 1c50ee063ef..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/deploy-your-site.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -sidebar_position: 5 ---- - -# Deploy your site - -Docusaurus is a **static-site-generator** (also called **[Jamstack](https://jamstack.org/)**). - -It builds your site as simple **static HTML, JavaScript and CSS files**. - -## Build your site - -Build your site **for production**: - -```bash -npm run build -``` - -The static files are generated in the `build` folder. - -## Deploy your site - -Test your production build locally: - -```bash -npm run serve -``` - -The `build` folder is now served at [http://localhost:3000/](http://localhost:3000/). - -You can now deploy the `build` folder **almost anywhere** easily, **for free** or very small cost (read the **[Deployment Guide](https://docusaurus.io/docs/deployment)**). diff --git a/yellow-paper/docs-tutorial-reference/tutorial-basics/markdown-features.mdx b/yellow-paper/docs-tutorial-reference/tutorial-basics/markdown-features.mdx deleted file mode 100644 index 0337f34d6a5..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-basics/markdown-features.mdx +++ /dev/null @@ -1,150 +0,0 @@ ---- -sidebar_position: 4 ---- - -# Markdown Features - -Docusaurus supports **[Markdown](https://daringfireball.net/projects/markdown/syntax)** and a few **additional features**. - -## Front Matter - -Markdown documents have metadata at the top called [Front Matter](https://jekyllrb.com/docs/front-matter/): - -```text title="my-doc.md" -// highlight-start ---- -id: my-doc-id -title: My document title -description: My document description -slug: /my-custom-url ---- -// highlight-end - -## Markdown heading - -Markdown text with [links](./hello.md) -``` - -## Links - -Regular Markdown links are supported, using url paths or relative file paths. - -```md -Let's see how to [Create a page](/create-a-page). -``` - -```md -Let's see how to [Create a page](./create-a-page.md). -``` - -**Result:** Let's see how to [Create a page](./create-a-page.md). - -## Images - -Regular Markdown images are supported. - -You can use absolute paths to reference images in the static directory (`static/img/docusaurus.png`): - -```md -![Docusaurus logo](/img/docusaurus.png) -``` - -![Docusaurus logo](/img/docusaurus.png) - -You can reference images relative to the current file as well. This is particularly useful to colocate images close to the Markdown files using them: - -```md -![Docusaurus logo](./img/docusaurus.png) -``` - -## Code Blocks - -Markdown code blocks are supported with Syntax highlighting. - - ```jsx title="src/components/HelloDocusaurus.js" - function HelloDocusaurus() { - return ( -

Hello, Docusaurus!

- ) - } - ``` - -```jsx title="src/components/HelloDocusaurus.js" -function HelloDocusaurus() { - return

Hello, Docusaurus!

; -} -``` - -## Admonitions - -Docusaurus has a special syntax to create admonitions and callouts: - - :::tip My tip - - Use this awesome feature option - - ::: - - :::danger Take care - - This action is dangerous - - ::: - -:::tip My tip - -Use this awesome feature option - -::: - -:::danger Take care - -This action is dangerous - -::: - -## MDX and React Components - -[MDX](https://mdxjs.com/) can make your documentation more **interactive** and allows using any **React components inside Markdown**: - -```jsx -export const Highlight = ({children, color}) => ( - { - alert(`You clicked the color ${color} with label ${children}`) - }}> - {children} - -); - -This is Docusaurus green ! - -This is Facebook blue ! -``` - -export const Highlight = ({children, color}) => ( - { - alert(`You clicked the color ${color} with label ${children}`); - }}> - {children} - -); - -This is Docusaurus green ! - -This is Facebook blue ! diff --git a/yellow-paper/docs-tutorial-reference/tutorial-extras/_category_.json b/yellow-paper/docs-tutorial-reference/tutorial-extras/_category_.json deleted file mode 100644 index a8ffcc19300..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-extras/_category_.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "label": "Tutorial - Extras", - "position": 3, - "link": { - "type": "generated-index" - } -} diff --git a/yellow-paper/docs-tutorial-reference/tutorial-extras/img/docsVersionDropdown.png b/yellow-paper/docs-tutorial-reference/tutorial-extras/img/docsVersionDropdown.png deleted file mode 100644 index 97e4164618b5f8beda34cfa699720aba0ad2e342..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 25427 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 diff --git a/yellow-paper/docs-tutorial-reference/tutorial-extras/img/localeDropdown.png b/yellow-paper/docs-tutorial-reference/tutorial-extras/img/localeDropdown.png deleted file mode 100644 index e257edc1f932985396bf59584c7ccfaddf955779..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 27841 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 JrC|B>e*nH7H{}2T diff --git a/yellow-paper/docs-tutorial-reference/tutorial-extras/manage-docs-versions.md b/yellow-paper/docs-tutorial-reference/tutorial-extras/manage-docs-versions.md deleted file mode 100644 index e12c3f3444f..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-extras/manage-docs-versions.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -sidebar_position: 1 ---- - -# Manage Docs Versions - -Docusaurus can manage multiple versions of your docs. - -## Create a docs version - -Release a version 1.0 of your project: - -```bash -npm run docusaurus docs:version 1.0 -``` - -The `docs` folder is copied into `versioned_docs/version-1.0` and `versions.json` is created. - -Your docs now have 2 versions: - -- `1.0` at `http://localhost:3000/docs/` for the version 1.0 docs -- `current` at `http://localhost:3000/docs/next/` for the **upcoming, unreleased docs** - -## Add a Version Dropdown - -To navigate seamlessly across versions, add a version dropdown. - -Modify the `docusaurus.config.js` file: - -```js title="docusaurus.config.js" -module.exports = { - themeConfig: { - navbar: { - items: [ - // highlight-start - { - type: 'docsVersionDropdown', - }, - // highlight-end - ], - }, - }, -}; -``` - -The docs version dropdown appears in your navbar: - -![Docs Version Dropdown](./img/docsVersionDropdown.png) - -## Update an existing version - -It is possible to edit versioned docs in their respective folder: - -- `versioned_docs/version-1.0/hello.md` updates `http://localhost:3000/docs/hello` -- `docs/hello.md` updates `http://localhost:3000/docs/next/hello` diff --git a/yellow-paper/docs-tutorial-reference/tutorial-extras/translate-your-site.md b/yellow-paper/docs-tutorial-reference/tutorial-extras/translate-your-site.md deleted file mode 100644 index caeaffb0554..00000000000 --- a/yellow-paper/docs-tutorial-reference/tutorial-extras/translate-your-site.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Translate your site - -Let's translate `docs/intro.md` to French. - -## Configure i18n - -Modify `docusaurus.config.js` to add support for the `fr` locale: - -```js title="docusaurus.config.js" -module.exports = { - i18n: { - defaultLocale: 'en', - locales: ['en', 'fr'], - }, -}; -``` - -## Translate a doc - -Copy the `docs/intro.md` file to the `i18n/fr` folder: - -```bash -mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ - -cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md -``` - -Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. - -## Start your localized site - -Start your site on the French locale: - -```bash -npm run start -- --locale fr -``` - -Your localized site is accessible at [http://localhost:3000/fr/](http://localhost:3000/fr/) and the `Getting Started` page is translated. - -:::caution - -In development, you can only use one locale at a same time. - -::: - -## Add a Locale Dropdown - -To navigate seamlessly across languages, add a locale dropdown. - -Modify the `docusaurus.config.js` file: - -```js title="docusaurus.config.js" -module.exports = { - themeConfig: { - navbar: { - items: [ - // highlight-start - { - type: 'localeDropdown', - }, - // highlight-end - ], - }, - }, -}; -``` - -The locale dropdown now appears in your navbar: - -![Locale Dropdown](./img/localeDropdown.png) - -## Build your localized site - -Build your site for a specific locale: - -```bash -npm run build -- --locale fr -``` - -Or build your site to include all the locales at once: - -```bash -npm run build -``` diff --git a/yellow-paper/docs/addresses-and-keys/0-keys-latex-preamble.md b/yellow-paper/docs/addresses-and-keys/0-keys-latex-preamble.md deleted file mode 100644 index c0a5816a572..00000000000 --- a/yellow-paper/docs/addresses-and-keys/0-keys-latex-preamble.md +++ /dev/null @@ -1,90 +0,0 @@ -$$ - - -\gdef\sk{\color{red}{sk}\color{black}{}} -\gdef\seed{\color{red}\text{{seed}}\color{black}{}} - -\gdef\nskm{\color{red}{nsk_m}\color{black}{}} -\gdef\tskm{\color{red}{tsk_m}\color{black}{}} -\gdef\ivskm{\color{red}{ivsk_m}\color{black}{}} -\gdef\ovskm{\color{red}{ovsk_m}\color{black}{}} - -\gdef\Npkm{\color{green}{Npk_m}\color{black}{}} -\gdef\Tpkm{\color{green}{Tpk_m}\color{black}{}} -\gdef\Ivpkm{\color{green}{Ivpk_m}\color{black}{}} -\gdef\Ovpkm{\color{green}{Ovpk_m}\color{black}{}} - - -\gdef\address{\color{green}{address}\color{black}{}} -\gdef\codehash{\color{green}{code\_hash}\color{black}{}} -\gdef\constructorhash{\color{green}{constructor\_hash}\color{black}{}} -\gdef\classid{\color{green}{class\id}\color{black}{}} - - -\gdef\nskapp{\color{red}{nsk_{app}}\color{black}{}} -\gdef\tskapp{\color{red}{tsk_{app}}\color{black}{}} -\gdef\ivskapp{\color{red}{ivsk_{app}}\color{black}{}} -\gdef\ovskapp{\color{red}{ovsk_{app}}\color{black}{}} - -\gdef\Nkapp{\color{orange}{Nk_{app}}\color{black}{}} - -\gdef\Npkapp{\color{green}{Npk_{app}}\color{black}{}} - - -\gdef\Ivpkapp{\color{green}{Ivpk_{app}}\color{black}{}} - - -\gdef\happL{\color{green}{h_{app}^L}\color{black}{}} -\gdef\happn{\color{green}{h_{app}^n}\color{black}{}} -\gdef\happiv{\color{green}{h_{app}^{iv}}\color{black}{}} - - -\gdef\d{\color{green}{d}\color{black}{}} -\gdef\Gd{\color{green}{G_d}\color{black}{}} - -\gdef\Ivpkappd{\color{violet}{Ivpk_{app,d}}\color{black}{}} -\gdef\shareableIvpkappd{\color{violet}{\widetilde{Ivpk_{app,d}}}\color{black}{}} -\gdef\Ivpkmd{\color{violet}{Ivpk_{m,d}}\color{black}{}} -\gdef\shareableIvpkmd{\color{violet}{\widetilde{Ivpk_{m,d}}}\color{black}{}} - - -\gdef\ivskappstealth{\color{red}{ivsk_{app,stealth}}\color{black}{}} -\gdef\Ivpkappdstealth{\color{violet}{Ivpk_{app,d,stealth}}\color{black}{}} -\gdef\Pkappdstealth{\color{violet}{Pk_{app,d,stealth}}\color{black}{}} -\gdef\ivskmstealth{\color{red}{ivsk_{m,stealth}}\color{black}{}} -\gdef\Ivpkmdstealth{\color{violet}{Ivpk_{m,d,stealth}}\color{black}{}} -\gdef\Pkmdstealth{\color{violet}{Pk_{m,d,stealth}}\color{black}{}} - -\gdef\hstealth{\color{violet}{h_{stealth}}\color{black}{}} - - -\gdef\esk{\color{red}{esk}\color{black}{}} -\gdef\Epk{\color{green}{Epk}\color{black}{}} -\gdef\Epkd{\color{green}{Epk_d}\color{black}{}} -\gdef\eskheader{\color{red}{esk_{header}}\color{black}{}} -\gdef\Epkheader{\color{green}{Epk_{header}}\color{black}{}} -\gdef\Epkdheader{\color{green}{Epk_{d,header}}\color{black}{}} - -\gdef\sharedsecret{\color{violet}{\text{S}}\color{black}{}} -\gdef\sharedsecretmheader{\color{violet}{\text{S_{m,header}}}\color{black}{}} -\gdef\sharedsecretappheader{\color{violet}{\text{S_{app,header}}}\color{black}{}} - - -\gdef\hmencheader{\color{violet}{h_{m,enc,header}}\color{black}{}} -\gdef\happencheader{\color{violet}{h_{app,enc,header}}\color{black}{}} -\gdef\hmenc{\color{violet}{h_{m,enc}}\color{black}{}} -\gdef\happenc{\color{violet}{h_{app,enc}}\color{black}{}} -\gdef\incomingenckey{\color{violet}{h_{incoming\_enc\_key}}\color{black}{}} - - -\gdef\plaintext{\color{red}{\text{plaintext}}\color{black}{}} -\gdef\ciphertext{\color{green}{\text{ciphertext}}\color{black}{}} -\gdef\ciphertextheader{\color{green}{\text{ciphertext\_header}}\color{black}{}} -\gdef\payload{\color{green}{\text{payload}}\color{black}{}} - - -\gdef\tagg{\color{green}{\text{tag}}\color{black}{}} -\gdef\Taghs{\color{green}{\text{Tag}_{hs}}\color{black}{}} - - -$$ diff --git a/yellow-paper/docusaurus.config.js b/yellow-paper/docusaurus.config.js deleted file mode 100644 index 550b39ee385..00000000000 --- a/yellow-paper/docusaurus.config.js +++ /dev/null @@ -1,154 +0,0 @@ -// @ts-check -// Note: type annotations allow type checking and IDEs autocompletion - -const lightCodeTheme = require("prism-react-renderer/themes/github"); -const darkCodeTheme = require("prism-react-renderer/themes/dracula"); -const math = require("remark-math"); -const katex = require("rehype-katex"); - -let macros = {}; - -/** @type {import('@docusaurus/types').Config} */ -const config = { - title: "Aztec Protocol Description", - tagline: "The Aztec Protocol, described.", - // favicon: "img/favicon.ico", - - // Set the production url of your site here - url: "https://your-docusaurus-test-site.com", - // Set the // pathname under which your site is served - // For GitHub pages deployment, it is often '//' - baseUrl: "/", - - // GitHub pages deployment config. - // If you aren't using GitHub pages, you don't need these. - organizationName: "AztecProtocol", // Usually your GitHub org/user name. - projectName: "aztec-packages", // Usually your repo name. - - onBrokenLinks: "throw", - onBrokenMarkdownLinks: "warn", - - // Even if you don't use internalization, you can use this field to set useful - // metadata like html lang. For example, if your site is Chinese, you may want - // to replace "en" with "zh-Hans". - i18n: { - defaultLocale: "en", - locales: ["en"], - }, - - markdown: { - mermaid: true, - }, - - themes: ["@docusaurus/theme-mermaid"], - - presets: [ - [ - "classic", - /** @type {import('@docusaurus/preset-classic').Options} */ - ({ - docs: { - sidebarPath: require.resolve("./sidebars.js"), - // Please change this to your repo. - // Remove this to remove the "edit this page" links. - editUrl: - "https://github.com/AztecProtocol/aztec-packages/edit/master/yellow-paper/docs/", - remarkPlugins: [math], - rehypePlugins: [ - [ - katex, - { - throwOnError: true, - globalGroup: true, - macros, - }, - ], - ], - }, - theme: { - customCss: require.resolve("./src/css/custom.css"), - }, - }), - ], - ], - - stylesheets: [ - { - href: "https://cdn.jsdelivr.net/npm/katex@0.13.24/dist/katex.min.css", - type: "text/css", - integrity: - "sha384-odtC+0UGzzFL/6PNoE8rX/SPcQDXBJ+uRepguP4QkPCm2LBxH3FA3y+fKSiJ+AmM", - crossorigin: "anonymous", - }, - ], - - themeConfig: - /** @type {import('@docusaurus/preset-classic').ThemeConfig} */ - ({ - algolia: { - appId: "6RXKCCZJK7", - apiKey: "aa09855dba35e5b48be3a126d7714170", - indexName: "yp-aztec", - }, - navbar: { - title: "Home", - // logo: { - // alt: "My Site Logo", - // src: "img/logo.svg", - // }, - items: [ - { - type: "docSidebar", - sidebarId: "yellowPaperSidebar", - position: "left", - label: "Protocol Description", - }, - { - href: "https://github.com/AztecProtocol/aztec-packages", - label: "GitHub", - position: "right", - }, - ], - }, - footer: { - style: "dark", - links: [ - { - title: "Docs", - items: [ - { - label: "Docs", - href: "https://docs.aztec.network", - }, - ], - }, - { - title: "Forum", - items: [ - { - label: "Forum", - href: "https://forum.aztec.network", - }, - ], - }, - { - title: "More", - items: [ - { - label: "GitHub", - href: "https://github.com/AztecProtocol/aztec-packages", - }, - ], - }, - ], - copyright: `Copyright © ${new Date().getFullYear()} Aztec Labs, Inc. Built with Docusaurus.`, - }, - - prism: { - theme: lightCodeTheme, - darkTheme: darkCodeTheme, - }, - }), -}; - -module.exports = config; diff --git a/yellow-paper/package.json b/yellow-paper/package.json deleted file mode 100644 index 5dc63509814..00000000000 --- a/yellow-paper/package.json +++ /dev/null @@ -1,52 +0,0 @@ -{ - "name": "classic", - "version": "0.0.0", - "private": true, - "scripts": { - "docusaurus": "docusaurus", - "start": "yarn preprocess && docusaurus start --host 0.0.0.0", - "start:dev": "yarn preprocess && docusaurus start --host 0.0.0.0", - "build": "docusaurus build", - "swizzle": "docusaurus swizzle", - "deploy": "docusaurus deploy", - "clear": "docusaurus clear", - "serve": "docusaurus serve", - "preprocess": "yarn node ./src/preprocess/index.js", - "write-translations": "docusaurus write-translations", - "write-heading-ids": "docusaurus write-heading-ids", - "typecheck": "tsc" - }, - "dependencies": { - "@docusaurus/core": "2.4.3", - "@docusaurus/preset-classic": "2.4.3", - "@docusaurus/theme-mermaid": "^2.4.3", - "@mdx-js/react": "^1.6.22", - "clsx": "^1.2.1", - "prism-react-renderer": "^1.3.5", - "react": "^17.0.2", - "react-dom": "^17.0.2", - "react-markdown": "6.0.0", - "rehype-katex": "5", - "remark-math": "3" - }, - "devDependencies": { - "@docusaurus/module-type-aliases": "2.4.3", - "@tsconfig/docusaurus": "^1.0.5", - "typescript": "^4.7.4" - }, - "browserslist": { - "production": [ - ">0.5%", - "not dead", - "not op_mini all" - ], - "development": [ - "last 1 chrome version", - "last 1 firefox version", - "last 1 safari version" - ] - }, - "engines": { - "node": ">=16.14" - } -} diff --git a/yellow-paper/sidebars.js b/yellow-paper/sidebars.js deleted file mode 100644 index 72e5a35c7df..00000000000 --- a/yellow-paper/sidebars.js +++ /dev/null @@ -1,236 +0,0 @@ -/** - * Creating a sidebar enables you to: - - create an ordered group of docs - - render a sidebar for each doc of that group - - provide next/previous navigation - - The sidebars can be generated from the filesystem, or explicitly defined here. - - Create as many sidebars as you want. - */ - -// @ts-check - -/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */ -const sidebars = { - // By default, Docusaurus generates a sidebar from the docs folder structure - // tutorialSidebar: [{type: 'autogenerated', dirName: '.'}], - - // But you can create a sidebar manually - - yellowPaperSidebar: [ - "intro", - { - label: "Cryptography", - type: "category", - link: { type: "doc", id: "cryptography/index" }, - items: [ - { - label: "Proving System", - type: "category", - link: { - type: "doc", - id: "cryptography/proving-system/performance-targets", - }, - items: [ - "cryptography/proving-system/performance-targets", - "cryptography/proving-system/overview", - "cryptography/proving-system/data-bus", - ], - }, - { - label: "Hashing", - type: "category", - link: { type: "doc", id: "cryptography/hashing/hashing" }, - items: [ - "cryptography/hashing/hashing", - "cryptography/hashing/poseidon2", - "cryptography/hashing/pedersen", - ], - }, - "cryptography/merkle-trees", - ], - }, - { - label: "Addresses & Keys", - type: "category", - link: { type: "doc", id: "addresses-and-keys/index" }, - items: [ - "addresses-and-keys/address", - "addresses-and-keys/keys-requirements", - "addresses-and-keys/keys", - { - label: "Example Usage of Keys", - type: "category", - items: [ - "addresses-and-keys/example-usage/nullifier", - "addresses-and-keys/example-usage/diversified-and-stealth-keys", - "addresses-and-keys/example-usage/tag-sequence-derivation", - "addresses-and-keys/example-usage/encrypt-and-tag", - ], - }, - "addresses-and-keys/precompiles", - "addresses-and-keys/diversified-and-stealth", - ], - }, - { - label: "State", - type: "category", - link: { type: "doc", id: "state/index" }, - items: [ - "state/tree-implementations", - "state/archive", - "state/note-hash-tree", - "state/nullifier-tree", - "state/public-data-tree", - ], - }, - { - label: "Transactions", - type: "category", - link: { type: "doc", id: "transactions/index" }, - items: [ - "transactions/local-execution", - "transactions/public-execution", - "transactions/tx-object", - "transactions/validity", - ], - }, - { - label: "Bytecode", - type: "category", - link: { type: "doc", id: "bytecode/index" }, - items: [], - }, - { - label: "Contract Deployment", - type: "category", - link: { type: "doc", id: "contract-deployment/index" }, - items: ["contract-deployment/classes", "contract-deployment/instances"], - }, - { - label: "Calls", - type: "category", - link: { type: "doc", id: "calls/index" }, - items: [ - "calls/sync-calls", - "calls/enqueued-calls", - "calls/batched-calls", - "calls/static-calls", - "calls/delegate-calls", - "calls/unconstrained-calls", - "calls/public-private-messaging", - ], - }, - { - label: "L1 smart contracts", - type: "category", - link: { type: "doc", id: "l1-smart-contracts/index" }, - items: ["l1-smart-contracts/frontier"], - }, - { - label: "Data availability", - type: "category", - link: { type: "doc", id: "data-publication-and-availability/index" }, - items: [ - "data-publication-and-availability/overview", - "data-publication-and-availability/published-data", - ], - }, - { - label: "Logs", - type: "category", - link: { type: "doc", id: "logs/index" }, - items: [], - }, - { - label: "Pre-compiled Contracts", - type: "category", - link: { type: "doc", id: "pre-compiled-contracts/index" }, - items: ["pre-compiled-contracts/registry"], - }, - { - label: "Private Message Delivery", - type: "category", - link: { type: "doc", id: "private-message-delivery/index" }, - items: [ - "private-message-delivery/private-msg-delivery", // renamed to avoid routing problems - "private-message-delivery/send-note-guidelines", - ], - }, - { - label: "Gas & Fees", - type: "category", - link: { type: "doc", id: "gas-and-fees/index" }, - items: [ - "gas-and-fees/fee-payments-and-metering", - "gas-and-fees/fee-schedule", - ], - }, - { - label: "Decentralization", - type: "category", - link: { type: "doc", id: "decentralization/governance" }, - items: [ - "decentralization/actors", - "decentralization/governance", - "decentralization/block-production", - "decentralization/p2p-network", - ], - }, - { - label: "Circuits", - type: "category", - link: { type: "doc", id: "circuits/high-level-topology" }, - items: [ - "circuits/private-function", - "circuits/private-kernel-initial", - "circuits/private-kernel-inner", - "circuits/private-kernel-reset", - "circuits/private-kernel-tail", - "circuits/public-kernel-initial", - "circuits/public-kernel-inner", - "circuits/public-kernel-tail", - ], - }, - { - label: "Rollup Circuits", - type: "category", - link: { type: "doc", id: "rollup-circuits/index" }, - items: [ - "rollup-circuits/base-rollup", - "rollup-circuits/merge-rollup", - "rollup-circuits/tree-parity", - "rollup-circuits/root-rollup", - ], - }, - { - label: "Aztec (Public) VM", - type: "category", - link: { type: "doc", id: "public-vm/index" }, - items: [ - "public-vm/intro", - "public-vm/state", - "public-vm/memory-model", - "public-vm/context", - "public-vm/execution", - "public-vm/nested-calls", - "public-vm/instruction-set", - { - label: "AVM Circuit", - type: "category", - link: { type: "doc", id: "public-vm/circuit-index" }, - items: [ - "public-vm/avm-circuit", - "public-vm/control-flow", - "public-vm/alu", - "public-vm/bytecode-validation-circuit", - ], - }, - "public-vm/type-structs", - ], - }, - ], -}; - -module.exports = sidebars; diff --git a/yellow-paper/src/components/HomepageFeatures/index.tsx b/yellow-paper/src/components/HomepageFeatures/index.tsx deleted file mode 100644 index 91ef4601d2f..00000000000 --- a/yellow-paper/src/components/HomepageFeatures/index.tsx +++ /dev/null @@ -1,70 +0,0 @@ -import React from 'react'; -import clsx from 'clsx'; -import styles from './styles.module.css'; - -type FeatureItem = { - title: string; - Svg: React.ComponentType>; - description: JSX.Element; -}; - -const FeatureList: FeatureItem[] = [ - { - title: 'Easy to Use', - Svg: require('@site/static/img/undraw_docusaurus_mountain.svg').default, - description: ( - <> - Docusaurus was designed from the ground up to be easily installed and - used to get your website up and running quickly. - - ), - }, - { - title: 'Focus on What Matters', - Svg: require('@site/static/img/undraw_docusaurus_tree.svg').default, - description: ( - <> - Docusaurus lets you focus on your docs, and we'll do the chores. Go - ahead and move your docs into the docs directory. - - ), - }, - { - title: 'Powered by React', - Svg: require('@site/static/img/undraw_docusaurus_react.svg').default, - description: ( - <> - Extend or customize your website layout by reusing React. Docusaurus can - be extended while reusing the same header and footer. - - ), - }, -]; - -function Feature({title, Svg, description}: FeatureItem) { - return ( -
-
- -
-
-

{title}

-

{description}

-
-
- ); -} - -export default function HomepageFeatures(): JSX.Element { - return ( -
-
-
- {FeatureList.map((props, idx) => ( - - ))} -
-
-
- ); -} diff --git a/yellow-paper/src/components/HomepageFeatures/styles.module.css b/yellow-paper/src/components/HomepageFeatures/styles.module.css deleted file mode 100644 index b248eb2e5de..00000000000 --- a/yellow-paper/src/components/HomepageFeatures/styles.module.css +++ /dev/null @@ -1,11 +0,0 @@ -.features { - display: flex; - align-items: center; - padding: 2rem 0; - width: 100%; -} - -.featureSvg { - height: 200px; - width: 200px; -} diff --git a/yellow-paper/src/css/custom.css b/yellow-paper/src/css/custom.css deleted file mode 100644 index 2bc6a4cfdef..00000000000 --- a/yellow-paper/src/css/custom.css +++ /dev/null @@ -1,30 +0,0 @@ -/** - * Any CSS included here will be global. The classic template - * bundles Infima by default. Infima is a CSS framework designed to - * work well for content-centric websites. - */ - -/* You can override the default Infima variables here. */ -:root { - --ifm-color-primary: #2e8555; - --ifm-color-primary-dark: #29784c; - --ifm-color-primary-darker: #277148; - --ifm-color-primary-darkest: #205d3b; - --ifm-color-primary-light: #33925d; - --ifm-color-primary-lighter: #359962; - --ifm-color-primary-lightest: #3cad6e; - --ifm-code-font-size: 95%; - --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1); -} - -/* For readability concerns, you should choose a lighter palette in dark mode. */ -[data-theme='dark'] { - --ifm-color-primary: #25c2a0; - --ifm-color-primary-dark: #21af90; - --ifm-color-primary-darker: #1fa588; - --ifm-color-primary-darkest: #1a8870; - --ifm-color-primary-light: #29d5b0; - --ifm-color-primary-lighter: #32d8b4; - --ifm-color-primary-lightest: #4fddbf; - --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3); -} diff --git a/yellow-paper/src/pages/index.module.css b/yellow-paper/src/pages/index.module.css deleted file mode 100644 index 9f71a5da775..00000000000 --- a/yellow-paper/src/pages/index.module.css +++ /dev/null @@ -1,23 +0,0 @@ -/** - * CSS files with the .module.css suffix will be treated as CSS modules - * and scoped locally. - */ - -.heroBanner { - padding: 4rem 0; - text-align: center; - position: relative; - overflow: hidden; -} - -@media screen and (max-width: 996px) { - .heroBanner { - padding: 2rem; - } -} - -.buttons { - display: flex; - align-items: center; - justify-content: center; -} diff --git a/yellow-paper/src/pages/index.tsx b/yellow-paper/src/pages/index.tsx deleted file mode 100644 index f22d68a05c2..00000000000 --- a/yellow-paper/src/pages/index.tsx +++ /dev/null @@ -1,43 +0,0 @@ -import React from 'react'; -import clsx from 'clsx'; -import Link from '@docusaurus/Link'; -import useDocusaurusContext from '@docusaurus/useDocusaurusContext'; -import Layout from '@theme/Layout'; -import HomepageFeatures from '@site/src/components/HomepageFeatures'; - -import styles from './index.module.css'; - -function HomepageHeader() { - const {siteConfig} = useDocusaurusContext(); - return ( -
-
-

{siteConfig.title}

-

{siteConfig.tagline}

-
- - Read now - -
-
-
- ); -} - -export default function Home(): JSX.Element { - const {siteConfig} = useDocusaurusContext(); - return ( - - - - {/* TODO: put some pretty content in here: -
- -
*/} - - ); -} diff --git a/yellow-paper/src/pages/markdown-page.md b/yellow-paper/src/pages/markdown-page.md deleted file mode 100644 index 9756c5b6685..00000000000 --- a/yellow-paper/src/pages/markdown-page.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Markdown page example ---- - -# Markdown page example - -You don't need React to write simple standalone pages. diff --git a/yellow-paper/src/preprocess/InstructionSet/InstructionSet.js b/yellow-paper/src/preprocess/InstructionSet/InstructionSet.js deleted file mode 100644 index ac5def0355e..00000000000 --- a/yellow-paper/src/preprocess/InstructionSet/InstructionSet.js +++ /dev/null @@ -1,1256 +0,0 @@ -const {instructionSize} = require('./InstructionSize'); - -const TOPICS_IN_TABLE = [ - "Name", "Summary", "Expression", -]; -const TOPICS_IN_SECTIONS = [ - "Name", "Summary", "Category", "Flags", "Args", "Expression", "Details", "World State access tracing", "Additional AVM circuit checks", "Triggers downstream circuit operations", "Tag checks", "Tag updates", "Bit-size", -]; - -const IN_TAG_DESCRIPTION = "The [tag/size](./memory-model#tags-and-tagged-memory) to check inputs against and tag the destination with."; -const IN_TAG_DESCRIPTION_NO_FIELD = IN_TAG_DESCRIPTION + " `field` type is NOT supported for this instruction."; -const DST_TAG_DESCRIPTION = "The [tag/size](./memory-model#tags-and-tagged-memory) to tag the destination with but not to check inputs against."; -const INDIRECT_FLAG_DESCRIPTION = "Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`."; - -const CALL_INSTRUCTION_ARGS = [ - {"name": "gasOffset", "description": "offset to three words containing `{l1GasLeft, l2GasLeft, daGasLeft}`: amount of gas to provide to the callee"}, - {"name": "addrOffset", "description": "address of the contract to call"}, - {"name": "argsOffset", "description": "memory offset to args (will become the callee's calldata)"}, - {"name": "argsSize", "description": "number of words to pass via callee's calldata", "mode": "immediate", "type": "u32"}, - {"name": "retOffset", "description": "destination memory offset specifying where to store the data returned from the callee"}, - {"name": "retSize", "description": "number of words to copy from data returned by callee", "mode": "immediate", "type": "u32"}, - {"name": "successOffset", "description": "destination memory offset specifying where to store the call's success (0: failure, 1: success)", "type": "u8"}, -]; -const CALL_INSTRUCTION_DETAILS = ` - ["Nested contract calls"](./nested-calls) provides a full explanation of this - instruction along with the shorthand used in the expression above. - The explanation includes details on charging gas for nested calls, - nested context derivation, world state tracing, and updating the parent context - after the nested call halts.`; - -const INSTRUCTION_SET_RAW = [ - { - "id": "add", - "Name": "`ADD`", - "Category": "Compute - Arithmetic", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] + M[bOffset] mod 2^k`", - "Summary": "Addition (a + b)", - "Details": "Wraps on overflow", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "sub", - "Name": "`SUB`", - "Category": "Compute - Arithmetic", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] - M[bOffset] mod 2^k`", - "Summary": "Subtraction (a - b)", - "Details": "Wraps on undeflow", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "mul", - "Name": "`MUL`", - "Category": "Compute - Arithmetic", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] * M[bOffset] mod 2^k`", - "Summary": "Multiplication (a * b)", - "Details": "Wraps on overflow", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "div", - "Name": "`DIV`", - "Category": "Compute - Arithmetic", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] / M[bOffset]`", - "Summary": "Unsigned integer division (a / b)", - "Details": "If the input is a field, it will be interpreted as an integer", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "fdiv", - "Name": "`FDIV`", - "Category": "Compute - Arithmetic", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] / M[bOffset]`", - "Summary": "Field division (a / b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == field`", - "Tag updates": "`T[dstOffset] = field`", - }, - { - "id": "eq", - "Name": "`EQ`", - "Category": "Compute - Comparators", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result", "type": "u8"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] == M[bOffset] ? 1 : 0`", - "Summary": "Equality check (a == b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = u8`", - }, - { - "id": "lt", - "Name": "`LT`", - "Category": "Compute - Comparators", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result", "type": "u8"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] < M[bOffset] ? 1 : 0`", - "Summary": "Less-than check (a < b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = u8`", - }, - { - "id": "lte", - "Name": "`LTE`", - "Category": "Compute - Comparators", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result", "type": "u8"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] <= M[bOffset] ? 1 : 0`", - "Summary": "Less-than-or-equals check (a <= b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = u8`", - }, - { - "id": "and", - "Name": "`AND`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] AND M[bOffset]`", - "Summary": "Bitwise AND (a & b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "or", - "Name": "`OR`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] OR M[bOffset]`", - "Summary": "Bitwise OR (a | b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "xor", - "Name": "`XOR`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] XOR M[bOffset]`", - "Summary": "Bitwise XOR (a ^ b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "not", - "Name": "`NOT`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = NOT M[aOffset]`", - "Summary": "Bitwise NOT (inversion)", - "Details": "", - "Tag checks": "`T[aOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "shl", - "Name": "`SHL`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] << M[bOffset]`", - "Summary": "Bitwise leftward shift (a << b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "shr", - "Name": "`SHR`", - "Category": "Compute - Bitwise", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": IN_TAG_DESCRIPTION_NO_FIELD}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of the operation's left input"}, - {"name": "bOffset", "description": "memory offset of the operation's right input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[aOffset] >> M[bOffset]`", - "Summary": "Bitwise rightward shift (a >> b)", - "Details": "", - "Tag checks": "`T[aOffset] == T[bOffset] == inTag`", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "cast", - "Name": "`CAST`", - "Category": "Type Conversions", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "dstTag", "description": DST_TAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of word to cast"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = cast(M[aOffset])`", - "Summary": "Type cast", - "Details": "Cast a word in memory based on the `dstTag` specified in the bytecode. Truncates (`M[dstOffset] = M[aOffset] mod 2^dstsize`) when casting to a smaller type, left-zero-pads when casting to a larger type. See [here](./memory-model#cast-and-tag-conversions) for more details.", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = dstTag`", - }, - { - "id": "address", - "Name": "`ADDRESS`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.address`", - "Summary": "Get the address of the currently executing l2 contract", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "storageaddress", - "Name": "`STORAGEADDRESS`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.storageAddress`", - "Summary": "Get the _storage_ address of the currently executing context", - "Details": "The storage address is used for public storage accesses.", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "origin", - "Name": "`ORIGIN`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.origin`", - "Summary": "Get the transaction's origination address", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "sender", - "Name": "`SENDER`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.sender`", - "Summary": "Get the address of the sender (caller of the current context)", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "portal", - "Name": "`PORTAL`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.portal`", - "Summary": "Get the address of the l1 portal contract", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "feeperl1gas", - "Name": "`FEEPERL1GAS`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.feePerL1Gas`", - "Summary": "Get the fee to be paid per \"L1 gas\" - constant for entire transaction", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "feeperl2gas", - "Name": "`FEEPERL2GAS`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.feePerL2Gas`", - "Summary": "Get the fee to be paid per \"L2 gas\" - constant for entire transaction", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "feeperdagas", - "Name": "`FEEPERDAGAS`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.feePerDaGas`", - "Summary": "Get the fee to be paid per \"DA gas\" - constant for entire transaction", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "contractcalldepth", - "Name": "`CONTRACTCALLDEPTH`", - "Category": "Execution Environment", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.contractCallDepth`", - "Summary": "Get how many contract calls deep the current call context is", - "Details": "Note: security issues with EVM's tx.origin can be resolved by asserting `calldepth == 0`.", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u8`", - }, - { - "id": "chainid", - "Name": "`CHAINID`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.chainId`", - "Summary": "Get this rollup's L1 chain ID", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "version", - "Name": "`VERSION`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.version`", - "Summary": "Get this rollup's L2 version ID", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "blocknumber", - "Name": "`BLOCKNUMBER`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.blocknumber`", - "Summary": "Get this L2 block's number", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "timestamp", - "Name": "`TIMESTAMP`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.timestamp`", - "Summary": "Get this L2 block's timestamp", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u64`", - }, - { - "id": "coinbase", - "Name": "`COINBASE`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.coinbase`", - "Summary": "Get the block's beneficiary address", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "blockl1gaslimit", - "Name": "`BLOCKL1GASLIMIT`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.l1GasLimit`", - "Summary": "Total amount of \"L1 gas\" that a block can consume", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "blockl2gaslimit", - "Name": "`BLOCKL2GASLIMIT`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.l2GasLimit`", - "Summary": "Total amount of \"L2 gas\" that a block can consume", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "blockdagaslimit", - "Name": "`BLOCKDAGASLIMIT`", - "Category": "Execution Environment - Globals", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.environment.globals.daGasLimit`", - "Summary": "Total amount of \"DA gas\" that a block can consume", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "calldatacopy", - "Name": "`CALLDATACOPY`", - "Category": "Execution Environment - Calldata", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "cdOffset", "description": "offset into calldata to copy from"}, - {"name": "copySize", "description": "number of words to copy", "mode": "immediate", "type": "u32"}, - {"name": "dstOffset", "description": "memory offset specifying where to copy the first word to"}, - ], - "Expression": "`M[dstOffset:dstOffset+copySize] = context.environment.calldata[cdOffset:cdOffset+copySize]`", - "Summary": "Copy calldata into memory", - "Details": "Calldata is read-only and cannot be directly operated on by other instructions. This instruction moves words from calldata into memory so they can be operated on normally.", - "Tag checks": "", - "Tag updates": "`T[dstOffset:dstOffset+copySize] = field`", - }, - { - "id": "l1gasleft", - "Name": "`L1GASLEFT`", - "Category": "Machine State - Gas", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.machineState.l1GasLeft`", - "Summary": "Remaining \"L1 gas\" for this call (after this instruction)", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "l2gasleft", - "Name": "`L2GASLEFT`", - "Category": "Machine State - Gas", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.MachineState.l2GasLeft`", - "Summary": "Remaining \"L2 gas\" for this call (after this instruction)", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "dagasleft", - "Name": "`DAGASLEFT`", - "Category": "Machine State - Gas", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = context.machineState.daGasLeft`", - "Summary": "Remaining \"DA gas\" for this call (after this instruction)", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, - { - "id": "jump", - "Name": "`JUMP`", - "Category": "Machine State - Control Flow", - "Flags": [], - "Args": [ - {"name": "loc", "description": "target location to jump to", "mode": "immediate", "type": "u32"}, - ], - "Expression": "`context.machineState.pc = loc`", - "Summary": "Jump to a location in the bytecode", - "Details": "Target location is an immediate value (a constant in the bytecode).", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "jumpi", - "Name": "`JUMPI`", - "Category": "Machine State - Control Flow", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "loc", "description": "target location conditionally jump to", "mode": "immediate", "type": "u32"}, - {"name": "condOffset", "description": "memory offset of the operations 'conditional' input"}, - ], - "Expression": "`context.machineState.pc = M[condOffset] > 0 ? loc : context.machineState.pc`", - "Summary": "Conditionally jump to a location in the bytecode", - "Details": "Target location is an immediate value (a constant in the bytecode). `T[condOffset]` is not checked because the greater-than-zero suboperation is the same regardless of type.", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "internalcall", - "Name": "`INTERNALCALL`", - "Category": "Machine State - Control Flow", - "Flags": [], - "Args": [ - {"name": "loc", "description": "target location to jump/call to", "mode": "immediate", "type": "u32"}, - ], - "Expression": ` -context.machineState.internalCallStack.push(context.machineState.pc) -context.machineState.pc = loc -`, - "Summary": "Make an internal call. Push the current PC to the internal call stack and jump to the target location.", - "Details": "Target location is an immediate value (a constant in the bytecode).", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "internalreturn", - "Name": "`INTERNALRETURN`", - "Category": "Machine State - Control Flow", - "Flags": [], - "Args": [], - "Expression": "`context.machineState.pc = context.machineState.internalCallStack.pop()`", - "Summary": "Return from an internal call. Pop from the internal call stack and jump to the popped location.", - "Details": "", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "set", - "Name": "`SET`", - "Category": "Machine State - Memory", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - {"name": "inTag", "description": "The [type/size](./memory-model#tags-and-tagged-memory) to check inputs against and tag the destination with. `field` type is NOT supported for SET."}, - ], - "Args": [ - {"name": "const", "description": "an N-bit constant value from the bytecode to store in memory (any type except `field`)", "mode": "immediate"}, - {"name": "dstOffset", "description": "memory offset specifying where to store the constant"}, - ], - "Expression": "`M[dstOffset] = const`", - "Summary": "Set a memory word from a constant in the bytecode", - "Details": "Set memory word at `dstOffset` to `const`'s immediate value. `const`'s bit-size (N) can be 8, 16, 32, 64, or 128 based on `inTag`. It _cannot be 254 (`field` type)_!", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = inTag`", - }, - { - "id": "mov", - "Name": "`MOV`", - "Category": "Machine State - Memory", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "srcOffset", "description": "memory offset of word to move"}, - {"name": "dstOffset", "description": "memory offset specifying where to store that word"}, - ], - "Expression": "`M[dstOffset] = M[srcOffset]`", - "Summary": "Move a word from source memory location to destination", - "Details": "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = T[srcOffset]`", - }, - { - "id": "cmov", - "Name": "`CMOV`", - "Category": "Machine State - Memory", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "aOffset", "description": "memory offset of word 'a' to conditionally move"}, - {"name": "bOffset", "description": "memory offset of word 'b' to conditionally move"}, - {"name": "condOffset", "description": "memory offset of the operations 'conditional' input"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": "`M[dstOffset] = M[condOffset] > 0 ? M[aOffset] : M[bOffset]`", - "Summary": "Move a word (conditionally chosen) from one memory location to another (`d = cond > 0 ? a : b`)", - "Details": "One of two source memory locations is chosen based on the condition. `T[condOffset]` is not checked because the greater-than-zero suboperation is the same regardless of type.", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = M[condOffset] > 0 ? T[aOffset] : T[bOffset]`", - }, - { - "id": "sload", - "Name": "`SLOAD`", - "Category": "World State - Public Storage", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "slotOffset", "description": "memory offset of the storage slot to load from"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result"}, - ], - "Expression": ` -M[dstOffset] = S[M[slotOffset]] -`, - "Summary": "Load a word from this contract's persistent public storage. Zero is loaded for unwritten slots.", - "Details": ` -// Expression is shorthand for -leafIndex = hash(context.environment.storageAddress, M[slotOffset]) -exists = context.worldState.publicStorage.has(leafIndex) // exists == previously-written -if exists: - value = context.worldState.publicStorage.get(leafIndex: leafIndex) -else: - value = 0 -M[dstOffset] = value -`, - "World State access tracing": ` -context.worldStateAccessTrace.publicStorageReads.append( - TracedStorageRead { - callPointer: context.environment.callPointer, - slot: M[slotOffset], - exists: exists, // defined above - value: value, // defined above - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Storage slot siloing (hash with contract address), public data tree membership check", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = field`", - }, - { - "id": "sstore", - "Name": "`SSTORE`", - "Category": "World State - Public Storage", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "srcOffset", "description": "memory offset of the word to store"}, - {"name": "slotOffset", "description": "memory offset containing the storage slot to store to"}, - ], - "Expression": ` -S[M[slotOffset]] = M[srcOffset] -`, - "Summary": "Write a word to this contract's persistent public storage", - "Details": ` -// Expression is shorthand for -context.worldState.publicStorage.set({ - leafIndex: hash(context.environment.storageAddress, M[slotOffset]), - leaf: M[srcOffset], -}) -`, - "World State access tracing": ` -context.worldStateAccessTrace.publicStorageWrites.append( - TracedStorageWrite { - callPointer: context.environment.callPointer, - slot: M[slotOffset], - value: M[srcOffset], - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Storage slot siloing (hash with contract address), public data tree update", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "notehashexists", - "Name": "`NOTEHASHEXISTS`", - "Category": "World State - Notes & Nullifiers", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "noteHashOffset", "description": "memory offset of the note hash"}, - {"name": "leafIndexOffset", "description": "memory offset of the leaf index"}, - {"name": "existsOffset", "description": "memory offset specifying where to store operation's result (whether the note hash leaf exists)"}, - ], - "Expression": ` -exists = context.worldState.noteHashes.has({ - leafIndex: M[leafIndexOffset] - leaf: hash(context.environment.storageAddress, M[noteHashOffset]), -}) -M[existsOffset] = exists -`, - "Summary": "Check whether a note hash exists in the note hash tree (as of the start of the current block)", - "World State access tracing": ` -context.worldStateAccessTrace.noteHashChecks.append( - TracedNoteHashCheck { - callPointer: context.environment.callPointer, - leafIndex: M[leafIndexOffset] - noteHash: M[noteHashOffset], - exists: exists, // defined above - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Note hash siloing (hash with storage contract address), note hash tree membership check", - "Tag checks": "", - "Tag updates": "`T[existsOffset] = u8`", - }, - { - "id": "emitnotehash", - "Name": "`EMITNOTEHASH`", - "Category": "World State - Notes & Nullifiers", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "noteHashOffset", "description": "memory offset of the note hash"}, - ], - "Expression": ` -context.worldState.noteHashes.append( - hash(context.environment.storageAddress, M[noteHashOffset]) -) -`, - "Summary": "Emit a new note hash to be inserted into the note hash tree", - "World State access tracing": ` -context.worldStateAccessTrace.newNoteHashes.append( - TracedNoteHash { - callPointer: context.environment.callPointer, - noteHash: M[noteHashOffset], // unsiloed note hash - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Note hash siloing (hash with contract address), note hash tree insertion.", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "nullifierexists", - "Name": "`NULLIFIEREXISTS`", - "Category": "World State - Notes & Nullifiers", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "nullifierOffset", "description": "memory offset of the unsiloed nullifier"}, - {"name": "addressOffset", "description": "memory offset of the storage address"}, - {"name": "existsOffset", "description": "memory offset specifying where to store operation's result (whether the nullifier exists)"}, - ], - "Expression": ` -exists = pendingNullifiers.has(M[addressOffset], M[nullifierOffset]) || context.worldState.nullifiers.has( - hash(M[addressOffset], M[nullifierOffset]) -) -M[existsOffset] = exists -`, - "Summary": "Check whether a nullifier exists in the nullifier tree (including nullifiers from earlier in the current transaction or from earlier in the current block)", - "World State access tracing": ` -context.worldStateAccessTrace.nullifierChecks.append( - TracedNullifierCheck { - callPointer: context.environment.callPointer, - nullifier: M[nullifierOffset], - storageAddress: M[addressOffset], - exists: exists, // defined above - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Nullifier siloing (hash with storage contract address), nullifier tree membership check", - "Tag checks": "", - "Tag updates": "`T[existsOffset] = u8`", - }, - { - "id": "emitnullifier", - "Name": "`EMITNULLIFIER`", - "Category": "World State - Notes & Nullifiers", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "nullifierOffset", "description": "memory offset of nullifier"}, - ], - "Expression": ` -context.worldState.nullifiers.append( - hash(context.environment.storageAddress, M[nullifierOffset]) -) -`, - "Summary": "Emit a new nullifier to be inserted into the nullifier tree", - "World State access tracing": ` -context.worldStateAccessTrace.newNullifiers.append( - TracedNullifier { - callPointer: context.environment.callPointer, - nullifier: M[nullifierOffset], // unsiloed nullifier - counter: ++context.worldStateAccessTrace.accessCounter, - } -) -`, - "Triggers downstream circuit operations": "Nullifier siloing (hash with contract address), nullifier tree non-membership-check and insertion.", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "l1tol2msgexists", - "Name": "`L1TOL2MSGEXISTS`", - "Category": "World State - Messaging", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "msgHashOffset", "description": "memory offset of the message hash"}, - {"name": "msgLeafIndexOffset", "description": "memory offset of the message's leaf index in the L1-to-L2 message tree"}, - {"name": "existsOffset", "description": "memory offset specifying where to store operation's result (whether the message exists in the L1-to-L2 message tree)"}, - ], - "Expression": ` -exists = context.worldState.l1ToL2Messages.has({ - leafIndex: M[msgLeafIndexOffset], leaf: M[msgHashOffset] -}) -M[existsOffset] = exists -`, - "Summary": "Check if a message exists in the L1-to-L2 message tree", - "World State access tracing": ` -context.worldStateAccessTrace.l1ToL2MessagesChecks.append( - L1ToL2Message { - callPointer: context.environment.callPointer, - leafIndex: M[msgLeafIndexOffset], - msgHash: M[msgHashOffset], - exists: exists, // defined above - } -) -`, - "Triggers downstream circuit operations": "L1-to-L2 message tree membership check", - "Tag checks": "", - "Tag updates": ` -T[existsOffset] = u8, -`, - }, - { - "id": "headermember", - "Name": "`HEADERMEMBER`", - "Category": "World State - Archive Tree & Headers", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "blockIndexOffset", "description": "memory offset of the block index (same as archive tree leaf index) of the header to access"}, - {"name": "memberIndexOffset", "description": "memory offset of the index of the member to retrieve from the header of the specified block"}, - {"name": "existsOffset", "description": "memory offset specifying where to store operation's result (whether the leaf exists in the archive tree)"}, - {"name": "dstOffset", "description": "memory offset specifying where to store operation's result (the retrieved header member)"}, - ], - "Expression": ` -exists = context.worldState.header.has({ - leafIndex: M[blockIndexOffset], leaf: M[msgKeyOffset] -}) -M[existsOffset] = exists -if exists: - header = context.worldState.headers.get(M[blockIndexOffset]) - M[dstOffset] = header[M[memberIndexOffset]] // member -`, - "Summary": "Check if a header exists in the [archive tree](../state/archive) and retrieve the specified member if so", - "World State access tracing": ` -context.worldStateAccessTrace.archiveChecks.append( - TracedArchiveLeafCheck { - leafIndex: M[blockIndexOffset], // leafIndex == blockIndex - leaf: exists ? hash(header) : 0, // "exists" defined above - } -) -`, - "Additional AVM circuit checks": "Hashes entire header to archive leaf for tracing. Aggregates header accesses and so that a header need only be hashed once.", - "Triggers downstream circuit operations": "Archive tree membership check", - "Tag checks": "", - "Tag updates": ` -T[existsOffset] = u8 -T[dstOffset] = field -`, - }, - { - "id": "getcontractinstance", - "Name": "`GETCONTRACTINSTANCE`", - "Category": "Other", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "addressOffset", "description": "memory offset of the contract instance address"}, - {"name": "dstOffset", "description": "location to write the contract instance information to"}, - ], - "Expression": ` -M[dstOffset:dstOffset+CONTRACT_INSTANCE_SIZE+1] = [ - instance_found_in_address, - instance.salt ?? 0, - instance.deployer ?? 0, - instance.contractClassId ?? 0, - instance.initializationHash ?? 0, - instance.portalContractAddress ?? 0, - instance.publicKeysHash ?? 0, -] -`, - "Summary": "Copies contract instance data to memory", - "Tag checks": "", - "Tag updates": "T[dstOffset:dstOffset+CONTRACT_INSTANCE_SIZE+1] = field", - "Additional AVM circuit checks": "TO-DO", - "Triggers downstream circuit operations": "TO-DO", - }, - { - "id": "emitunencryptedlog", - "Name": "`EMITUNENCRYPTEDLOG`", - "Category": "Accrued Substate - Logging", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "eventSelectorOffset", "description": "memory offset of the event selector"}, - {"name": "logOffset", "description": "memory offset of the data to log"}, - {"name": "logSize", "description": "number of words to log", "mode": "immediate", "type": "u32"}, - ], - "Expression": ` -context.accruedSubstate.unencryptedLogs.append( - UnencryptedLog { - address: context.environment.address, - eventSelector: M[eventSelectorOffset], - log: M[logOffset:logOffset+logSize], - } -) -`, - "Summary": "Emit an unencrypted log", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "sendl2tol1msg", - "Name": "`SENDL2TOL1MSG`", - "Category": "Accrued Substate - Messaging", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "recipientOffset", "description": "memory offset of the message recipient"}, - {"name": "contentOffset", "description": "memory offset of the message content"}, - ], - "Expression": ` -context.accruedSubstate.sentL2ToL1Messages.append( - SentL2ToL1Message { - address: context.environment.address, - recipient: M[recipientOffset], - message: M[contentOffset] - } -) -`, - "Summary": "Send an L2-to-L1 message", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "call", - "Name": "`CALL`", - "Category": "Control Flow - Contract Calls", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": CALL_INSTRUCTION_ARGS, - "Expression":` -// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } -chargeGas(context, - l1GasCost=M[instr.args.gasOffset], - l2GasCost=M[instr.args.gasOffset+1], - daGasCost=M[instr.args.gasOffset+2]) -traceNestedCall(context, instr.args.addrOffset) -nestedContext = deriveContext(context, instr.args, isStaticCall=false, isDelegateCall=false) -execute(nestedContext) -updateContextAfterNestedCall(context, instr.args, nestedContext) -`, - "Summary": "Call into another contract", - "Details": `Creates a new (nested) execution context and triggers execution within that context. - Execution proceeds in the nested context until it reaches a halt at which point - execution resumes in the current/calling context. - A non-existent contract or one with no code will return success. ` - + CALL_INSTRUCTION_DETAILS, - "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", - "Tag updates": ` -T[successOffset] = u8 -T[retOffset:retOffset+retSize] = field -`, - }, - { - "id": "staticcall", - "Name": "`STATICCALL`", - "Category": "Control Flow - Contract Calls", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": CALL_INSTRUCTION_ARGS, - "Expression": ` -// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } -chargeGas(context, - l1GasCost=M[instr.args.gasOffset], - l2GasCost=M[instr.args.gasOffset+1], - daGasCost=M[instr.args.gasOffset+2]) -traceNestedCall(context, instr.args.addrOffset) -nestedContext = deriveContext(context, instr.args, isStaticCall=true, isDelegateCall=false) -execute(nestedContext) -updateContextAfterNestedCall(context, instr.args, nestedContext) -`, - "Summary": "Call into another contract, disallowing World State and Accrued Substate modifications", - "Details": `Same as \`CALL\`, but disallows World State and Accrued Substate modifications. ` - + CALL_INSTRUCTION_DETAILS, - "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", - "Tag updates": ` -T[successOffset] = u8 -T[retOffset:retOffset+retSize] = field -`, - }, - { - "id": "delegatecall", - "Name": "`DELEGATECALL`", - "Category": "Control Flow - Contract Calls", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": CALL_INSTRUCTION_ARGS, - "Expression": ` -// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } -chargeGas(context, - l1GasCost=M[instr.args.gasOffset], - l2GasCost=M[instr.args.gasOffset+1], - daGasCost=M[instr.args.gasOffset+2]) -traceNestedCall(context, instr.args.addrOffset) -nestedContext = deriveContext(context, instr.args, isStaticCall=false, isDelegateCall=true) -execute(nestedContext) -updateContextAfterNestedCall(context, instr.args, nestedContext) -`, - "Summary": "Call into another contract, but keep the caller's `sender` and `storageAddress`", - "Details": `Same as \`CALL\`, but \`sender\` and \`storageAddress\` remains - the same in the nested call as they were in the caller. ` - + CALL_INSTRUCTION_DETAILS, - "Tag checks": "`T[gasOffset] == T[gasOffset+1] == T[gasOffset+2] == u32`", - "Tag updates": ` -T[successOffset] = u8 -T[retOffset:retOffset+retSize] = field -`, - }, - { - "id": "return", - "Name": "`RETURN`", - "Category": "Control Flow - Contract Calls", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "retOffset", "description": "memory offset of first word to return"}, - {"name": "retSize", "description": "number of words to return", "mode": "immediate", "type": "u32"}, - ], - "Expression": ` -context.contractCallResults.output = M[retOffset:retOffset+retSize] -halt -`, - "Summary": "Halt execution within this context (without revert), optionally returning some data", - "Details": "Return control flow to the calling context/contract. Caller will accept World State and Accrued Substate modifications. See [\"Halting\"](./execution#halting) to learn more. See [\"Nested contract calls\"](./nested-calls) to see how the caller updates its context after the nested call halts.", - "Tag checks": "", - "Tag updates": "", - }, - { - "id": "revert", - "Name": "`REVERT`", - "Category": "Control Flow - Contract Calls", - "Flags": [ - {"name": "indirect", "description": INDIRECT_FLAG_DESCRIPTION}, - ], - "Args": [ - {"name": "retOffset", "description": "memory offset of first word to return"}, - {"name": "retSize", "description": "number of words to return", "mode": "immediate", "type": "u32"}, - ], - "Expression": ` -context.contractCallResults.output = M[retOffset:retOffset+retSize] -context.contractCallResults.reverted = true -halt -`, - "Summary": "Halt execution within this context as `reverted`, optionally returning some data", - "Details": "Return control flow to the calling context/contract. Caller will reject World State and Accrued Substate modifications. See [\"Halting\"](./execution#halting) to learn more. See [\"Nested contract calls\"](./nested-calls) to see how the caller updates its context after the nested call halts.", - "Tag checks": "", - "Tag updates": "", - }, -]; -const INSTRUCTION_SET = INSTRUCTION_SET_RAW.map((instr) => {instr['Bit-size'] = instructionSize(instr); return instr;}); - -module.exports = { - TOPICS_IN_TABLE, - TOPICS_IN_SECTIONS, - INSTRUCTION_SET, -}; diff --git a/yellow-paper/src/preprocess/InstructionSet/genMarkdown.js b/yellow-paper/src/preprocess/InstructionSet/genMarkdown.js deleted file mode 100644 index 4070fdc76a5..00000000000 --- a/yellow-paper/src/preprocess/InstructionSet/genMarkdown.js +++ /dev/null @@ -1,139 +0,0 @@ -const fs = require("fs"); -const path = require("path"); - -const { - TOPICS_IN_TABLE, - TOPICS_IN_SECTIONS, - INSTRUCTION_SET, - instructionSize -} = require('./InstructionSet'); - -function escapeBraces(str) { - return str.replace(//g, ">"); -} - -function stripBraces(str) { - return str.replace(/[<>]/g, ''); -} - -function instructionSetPreface() { - let preface = "[comment]: # (THIS IS A GENERATED FILE! DO NOT EDIT!)\n"; - preface += "[comment]: # (Generated via `yarn preprocess`)\n\n"; - preface += "[comment]: # (Generated by genMarkdown.js, InstructionSet.js, InstructionSize.js)\n\n"; - preface += "import Markdown from 'react-markdown'\n"; - preface += "import CodeBlock from '@theme/CodeBlock'\n\n"; - return preface; -} - -function toOpcode(index) { - return '0x' + index.toString(16).padStart(2, '0'); -} - -function htmlInstructionSetTable() { - let table = "## Instructions Table\n"; - table += "\nClick on an instruction name to jump to its section.\n"; - table += "\n\n"; - let header = ""; - for (let t = 0; t < TOPICS_IN_TABLE.length; t++) { - header += ``; - } - table += `${header}\n`; - - for (let i = 0; i < INSTRUCTION_SET.length; i++) { - const instr = INSTRUCTION_SET[i]; - const name = instr['Name']; - let row = `\n`; - row += `\t`; - row += `\t`; - - for (let t = 0; t < TOPICS_IN_TABLE.length; t++) { - const topic = TOPICS_IN_TABLE[t]; - - if (topic == 'Name') continue; // skip - let cell = instr[topic]; - if (cell[0] == '\n') { // if string starts with newline, assume it's a multi-line code block - cell = `\n{\`${cell.trim()}\`}\n\t`; - } else if (cell[0] == '`' && topic != 'Name') { - cell = `{\n\t\t\`${cell.replace(/`/g, '')}\`\n\t}`; - } else { - cell = escapeBraces(cell); // escape html - cell = `${cell}`; - } - row += `\n\t`; - } - row += "\n"; - table += `${row}\n`; - } - table += "
Opcode${TOPICS_IN_TABLE[t]}
${toOpcode(i)}[${stripBraces(name)}](#isa-section-${instr['id']})${cell}
\n"; - return table; -} - -function markdownSublist(items) { - let markdown = ""; - for (let i = 0; i < items.length; i++) { - let item = items[i]; - if (typeof item === 'string') { - markdown += `\n\t- ${item}`; - } else { - markdown += `\n\t- **${item['name']}**: ${item['description']}`; - } - } - return markdown; -} - -function markdownInstructionSetSection(pathToGenDir) { - let markdown = "## Instructions\n"; - for (let i = 0; i < INSTRUCTION_SET.length; i++) { - const instr = INSTRUCTION_SET[i]; - const name = instr['Name']; - let subsection = `### ${name}\n`; - subsection += `${instr['Summary']}\n\n`; - subsection += `[See in table.](#isa-table-${instr['id']})\n\n`; - subsection += `- **Opcode**: ${toOpcode(i)}\n`; - for (let t = 0; t < TOPICS_IN_SECTIONS.length; t++) { - const topic = TOPICS_IN_SECTIONS[t]; - let field = instr[topic]; - if (topic == 'Name' || topic == 'Summary' || !field || field.length == 0) continue; // skip - - let item = `- **${topic}**: ` - if (Array.isArray(field) ) { - item += markdownSublist(field); - } else if (field[0] == '\n') { // if string starts with newline, assume it's a multi-line code block - item += `\n\n{\`${field.trim()}\`}\n`; - } else { - item += field; - } - subsection += `${item}\n`; - } - const bitFormatPath = `./images/bit-formats/${name.replace(/`/g, '')}.png`; - if (fs.existsSync(`${pathToGenDir}/${bitFormatPath}`)) { - subsection += `\n[![](${bitFormatPath})](${bitFormatPath})`; - } - markdown += `\n${subsection}\n`; - } - return markdown; -} - -async function generateInstructionSet() { - const rootDir = path.join(__dirname, "../../../"); - const docsDir = path.join(rootDir, "docs", "docs"); - - const relPath = path.relative(docsDir, "docs/public-vm/gen/_instruction-set.mdx"); - const docsFilePath = path.resolve(docsDir, relPath); - const docsDirName = path.dirname(docsFilePath); - if (!fs.existsSync(docsDirName)) { - fs.mkdirSync(docsDirName, { recursive: true }); - } - - const preface = instructionSetPreface(); - const table = htmlInstructionSetTable(); - const section = markdownInstructionSetSection(docsDirName); - const doc = `${preface}\n${table}\n\n${section}`; - fs.writeFileSync(docsFilePath, doc); - - console.log("Preprocessing complete."); -} - -module.exports = { - generateInstructionSet, -}; \ No newline at end of file diff --git a/yellow-paper/src/preprocess/index.js b/yellow-paper/src/preprocess/index.js deleted file mode 100644 index fe2167bdf09..00000000000 --- a/yellow-paper/src/preprocess/index.js +++ /dev/null @@ -1,6 +0,0 @@ -const {generateInstructionSet} = require('./InstructionSet/genMarkdown'); - -async function run() { - await generateInstructionSet(); -} -run(); \ No newline at end of file diff --git a/yellow-paper/static/.nojekyll b/yellow-paper/static/.nojekyll deleted file mode 100644 index e69de29bb2d..00000000000 diff --git a/yellow-paper/static/img/DO_NOT_USE.txt b/yellow-paper/static/img/DO_NOT_USE.txt deleted file mode 100644 index 2e8a4a837c1..00000000000 --- a/yellow-paper/static/img/DO_NOT_USE.txt +++ /dev/null @@ -1 +0,0 @@ -Instead, pics will be auto-pasted into an `images` subdir of any doc that you paste an image into. \ No newline at end of file diff --git a/yellow-paper/static/img/docusaurus-social-card.jpg b/yellow-paper/static/img/docusaurus-social-card.jpg deleted file mode 100644 index ffcb448210e1a456cb3588ae8b396a597501f187..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 55746 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 fgzs%Vr*-jYG(YMS<ttdtee# diff --git a/yellow-paper/static/img/docusaurus.png b/yellow-paper/static/img/docusaurus.png deleted file mode 100644 index f458149e3c8f53335f28fbc162ae67f55575c881..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 5142 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 F{0H{b<4^zq diff --git a/yellow-paper/static/img/favicon.ico b/yellow-paper/static/img/favicon.ico deleted file mode 100644 index c01d54bcd39a5f853428f3cd5aa0f383d963c484..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3626 zcmb`Je@s(X6vrR`EK3%b%orErlDW({vnABqA zcfaS{d+xbU5JKp0*;0YOg+;Fl!eT)XRuapIwFLL`=imZCSon$`se`_<%@MB=M~KG+ z=EW^FL`w|Bo>*ktlaS^(fut!95`iG5u=SZ8nfDHO#GaTlH1-XG^;vsjUb^gWTVz0+ z^=WR1wv9-2oeR=_;fL0H7rNWqAzGtO(D;`~cX(RcN0w2v24Y8)6t`cS^_ghs`_ho? z{0ka~1Dgo8TfAP$r*ua?>$_V+kZ!-(TvEJ7O2f;Y#tezt$&R4 zLI}=-y@Z!grf*h3>}DUL{km4R>ya_I5Ag#{h_&?+HpKS!;$x3LC#CqUQ8&nM?X))Q zXAy2?`YL4FbC5CgJu(M&Q|>1st8XXLZ|5MgwgjP$m_2Vt0(J z&Gu7bOlkbGzGm2sh?X`){7w69Y$1#@P@7DF{ZE=4%T0NDS)iH`tiPSKpDNW)zmtn( zw;4$f>k)4$LBc>eBAaTZeCM2(iD+sHlj!qd z2GjRJ>f_Qes(+mnzdA^NH?^NB(^o-%Gmg$c8MNMq&`vm@9Ut;*&$xSD)PKH{wBCEC z4P9%NQ;n2s59ffMn8*5)5AAg4-93gBXBDX`A7S& zH-|%S3Wd%T79fk-e&l`{!?lve8_epXhE{d3Hn$Cg!t=-4D(t$cK~7f&4s?t7wr3ZP z*!SRQ-+tr|e1|hbc__J`k3S!rMy<0PHy&R`v#aJv?`Y?2{avK5sQz%=Us()jcNuZV z*$>auD4cEw>;t`+m>h?f?%VFJZj8D|Y1e_SjxG%J4{-AkFtT2+ZZS5UScS~%;dp!V>)7zi`w(xwSd*FS;Lml=f6hn#jq)2is4nkp+aTrV?)F6N z>DY#SU0IZ;*?Hu%tSj4edd~kYNHMFvS&5}#3-M;mBCOCZL3&;2obdG?qZ>rD|zC|Lu|sny76pn2xl|6sk~Hs{X9{8iBW zwiwgQt+@hi`FYMEhX2 \ No newline at end of file diff --git a/yellow-paper/static/img/undraw_docusaurus_mountain.svg b/yellow-paper/static/img/undraw_docusaurus_mountain.svg deleted file mode 100644 index af961c49a88..00000000000 --- a/yellow-paper/static/img/undraw_docusaurus_mountain.svg +++ /dev/null @@ -1,171 +0,0 @@ - - Easy to Use - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/yellow-paper/static/img/undraw_docusaurus_react.svg b/yellow-paper/static/img/undraw_docusaurus_react.svg deleted file mode 100644 index 94b5cf08f88..00000000000 --- a/yellow-paper/static/img/undraw_docusaurus_react.svg +++ /dev/null @@ -1,170 +0,0 @@ - - Powered by React - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/yellow-paper/static/img/undraw_docusaurus_tree.svg b/yellow-paper/static/img/undraw_docusaurus_tree.svg deleted file mode 100644 index d9161d33920..00000000000 --- a/yellow-paper/static/img/undraw_docusaurus_tree.svg +++ /dev/null @@ -1,40 +0,0 @@ - - Focus on What Matters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/yellow-paper/tsconfig.json b/yellow-paper/tsconfig.json deleted file mode 100644 index 6f4756980d4..00000000000 --- a/yellow-paper/tsconfig.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - // This file is not used in compilation. It is here just for a nice editor experience. - "extends": "@tsconfig/docusaurus/tsconfig.json", - "compilerOptions": { - "baseUrl": "." - } -} diff --git a/yellow-paper/yarn.lock b/yellow-paper/yarn.lock deleted file mode 100644 index 7e3c4614e87..00000000000 --- a/yellow-paper/yarn.lock +++ /dev/null @@ -1,8277 +0,0 @@ -# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY. -# yarn lockfile v1 - - -"@algolia/autocomplete-core@1.9.3": - version "1.9.3" - resolved "https://registry.yarnpkg.com/@algolia/autocomplete-core/-/autocomplete-core-1.9.3.tgz#1d56482a768c33aae0868c8533049e02e8961be7" - integrity sha512-009HdfugtGCdC4JdXUbVJClA0q0zh24yyePn+KUGk3rP7j8FEe/m5Yo/z65gn6nP/cM39PxpzqKrL7A6fP6PPw== - dependencies: - "@algolia/autocomplete-plugin-algolia-insights" "1.9.3" - "@algolia/autocomplete-shared" "1.9.3" - -"@algolia/autocomplete-plugin-algolia-insights@1.9.3": - version "1.9.3" - resolved "https://registry.yarnpkg.com/@algolia/autocomplete-plugin-algolia-insights/-/autocomplete-plugin-algolia-insights-1.9.3.tgz#9b7f8641052c8ead6d66c1623d444cbe19dde587" - integrity sha512-a/yTUkcO/Vyy+JffmAnTWbr4/90cLzw+CC3bRbhnULr/EM0fGNvM13oQQ14f2moLMcVDyAx/leczLlAOovhSZg== - dependencies: - "@algolia/autocomplete-shared" "1.9.3" - -"@algolia/autocomplete-preset-algolia@1.9.3": - version "1.9.3" - resolved "https://registry.yarnpkg.com/@algolia/autocomplete-preset-algolia/-/autocomplete-preset-algolia-1.9.3.tgz#64cca4a4304cfcad2cf730e83067e0c1b2f485da" - integrity sha512-d4qlt6YmrLMYy95n5TB52wtNDr6EgAIPH81dvvvW8UmuWRgxEtY0NJiPwl/h95JtG2vmRM804M0DSwMCNZlzRA== - dependencies: - "@algolia/autocomplete-shared" "1.9.3" - -"@algolia/autocomplete-shared@1.9.3": - version "1.9.3" - resolved "https://registry.yarnpkg.com/@algolia/autocomplete-shared/-/autocomplete-shared-1.9.3.tgz#2e22e830d36f0a9cf2c0ccd3c7f6d59435b77dfa" - integrity sha512-Wnm9E4Ye6Rl6sTTqjoymD+l8DjSTHsHboVRYrKgEt8Q7UHm9nYbqhN/i0fhUYA3OAEH7WA8x3jfpnmJm3rKvaQ== - -"@algolia/cache-browser-local-storage@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/cache-browser-local-storage/-/cache-browser-local-storage-4.20.0.tgz#357318242fc542ffce41d6eb5b4a9b402921b0bb" - integrity sha512-uujahcBt4DxduBTvYdwO3sBfHuJvJokiC3BP1+O70fglmE1ShkH8lpXqZBac1rrU3FnNYSUs4pL9lBdTKeRPOQ== - dependencies: - "@algolia/cache-common" "4.20.0" - -"@algolia/cache-common@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/cache-common/-/cache-common-4.20.0.tgz#ec52230509fce891091ffd0d890618bcdc2fa20d" - integrity sha512-vCfxauaZutL3NImzB2G9LjLt36vKAckc6DhMp05An14kVo8F1Yofb6SIl6U3SaEz8pG2QOB9ptwM5c+zGevwIQ== - -"@algolia/cache-in-memory@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/cache-in-memory/-/cache-in-memory-4.20.0.tgz#5f18d057bd6b3b075022df085c4f83bcca4e3e67" - integrity sha512-Wm9ak/IaacAZXS4mB3+qF/KCoVSBV6aLgIGFEtQtJwjv64g4ePMapORGmCyulCFwfePaRAtcaTbMcJF+voc/bg== - dependencies: - "@algolia/cache-common" "4.20.0" - -"@algolia/client-account@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/client-account/-/client-account-4.20.0.tgz#23ce0b4cffd63100fb7c1aa1c67a4494de5bd645" - integrity sha512-GGToLQvrwo7am4zVkZTnKa72pheQeez/16sURDWm7Seyz+HUxKi3BM6fthVVPUEBhtJ0reyVtuK9ArmnaKl10Q== - dependencies: - "@algolia/client-common" "4.20.0" - "@algolia/client-search" "4.20.0" - "@algolia/transporter" "4.20.0" - -"@algolia/client-analytics@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/client-analytics/-/client-analytics-4.20.0.tgz#0aa6bef35d3a41ac3991b3f46fcd0bf00d276fa9" - integrity sha512-EIr+PdFMOallRdBTHHdKI3CstslgLORQG7844Mq84ib5oVFRVASuuPmG4bXBgiDbcsMLUeOC6zRVJhv1KWI0ug== - dependencies: - "@algolia/client-common" "4.20.0" - "@algolia/client-search" "4.20.0" - "@algolia/requester-common" "4.20.0" - "@algolia/transporter" "4.20.0" - -"@algolia/client-common@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/client-common/-/client-common-4.20.0.tgz#ca60f04466515548651c4371a742fbb8971790ef" - integrity sha512-P3WgMdEss915p+knMMSd/fwiHRHKvDu4DYRrCRaBrsfFw7EQHon+EbRSm4QisS9NYdxbS04kcvNoavVGthyfqQ== - dependencies: - "@algolia/requester-common" "4.20.0" - "@algolia/transporter" "4.20.0" - -"@algolia/client-personalization@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/client-personalization/-/client-personalization-4.20.0.tgz#ca81308e8ad0db3b27458b78355f124f29657181" - integrity sha512-N9+zx0tWOQsLc3K4PVRDV8GUeOLAY0i445En79Pr3zWB+m67V+n/8w4Kw1C5LlbHDDJcyhMMIlqezh6BEk7xAQ== - dependencies: - "@algolia/client-common" "4.20.0" - "@algolia/requester-common" "4.20.0" - "@algolia/transporter" "4.20.0" - -"@algolia/client-search@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/client-search/-/client-search-4.20.0.tgz#3bcce817ca6caedc835e0eaf6f580e02ee7c3e15" - integrity sha512-zgwqnMvhWLdpzKTpd3sGmMlr4c+iS7eyyLGiaO51zDZWGMkpgoNVmltkzdBwxOVXz0RsFMznIxB9zuarUv4TZg== - dependencies: - "@algolia/client-common" "4.20.0" - "@algolia/requester-common" "4.20.0" - "@algolia/transporter" "4.20.0" - -"@algolia/events@^4.0.1": - version "4.0.1" - resolved "https://registry.yarnpkg.com/@algolia/events/-/events-4.0.1.tgz#fd39e7477e7bc703d7f893b556f676c032af3950" - integrity sha512-FQzvOCgoFXAbf5Y6mYozw2aj5KCJoA3m4heImceldzPSMbdyS4atVjJzXKMsfX3wnZTFYwkkt8/z8UesLHlSBQ== - -"@algolia/logger-common@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/logger-common/-/logger-common-4.20.0.tgz#f148ddf67e5d733a06213bebf7117cb8a651ab36" - integrity sha512-xouigCMB5WJYEwvoWW5XDv7Z9f0A8VoXJc3VKwlHJw/je+3p2RcDXfksLI4G4lIVncFUYMZx30tP/rsdlvvzHQ== - -"@algolia/logger-console@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/logger-console/-/logger-console-4.20.0.tgz#ac443d27c4e94357f3063e675039cef0aa2de0a7" - integrity sha512-THlIGG1g/FS63z0StQqDhT6bprUczBI8wnLT3JWvfAQDZX5P6fCg7dG+pIrUBpDIHGszgkqYEqECaKKsdNKOUA== - dependencies: - "@algolia/logger-common" "4.20.0" - -"@algolia/requester-browser-xhr@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/requester-browser-xhr/-/requester-browser-xhr-4.20.0.tgz#db16d0bdef018b93b51681d3f1e134aca4f64814" - integrity sha512-HbzoSjcjuUmYOkcHECkVTwAelmvTlgs48N6Owt4FnTOQdwn0b8pdht9eMgishvk8+F8bal354nhx/xOoTfwiAw== - dependencies: - "@algolia/requester-common" "4.20.0" - -"@algolia/requester-common@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/requester-common/-/requester-common-4.20.0.tgz#65694b2263a8712b4360fef18680528ffd435b5c" - integrity sha512-9h6ye6RY/BkfmeJp7Z8gyyeMrmmWsMOCRBXQDs4mZKKsyVlfIVICpcSibbeYcuUdurLhIlrOUkH3rQEgZzonng== - -"@algolia/requester-node-http@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/requester-node-http/-/requester-node-http-4.20.0.tgz#b52b182b52b0b16dec4070832267d484a6b1d5bb" - integrity sha512-ocJ66L60ABSSTRFnCHIEZpNHv6qTxsBwJEPfYaSBsLQodm0F9ptvalFkHMpvj5DfE22oZrcrLbOYM2bdPJRHng== - dependencies: - "@algolia/requester-common" "4.20.0" - -"@algolia/transporter@4.20.0": - version "4.20.0" - resolved "https://registry.yarnpkg.com/@algolia/transporter/-/transporter-4.20.0.tgz#7e5b24333d7cc9a926b2f6a249f87c2889b944a9" - integrity sha512-Lsii1pGWOAISbzeyuf+r/GPhvHMPHSPrTDWNcIzOE1SG1inlJHICaVe2ikuoRjcpgxZNU54Jl+if15SUCsaTUg== - dependencies: - "@algolia/cache-common" "4.20.0" - "@algolia/logger-common" "4.20.0" - "@algolia/requester-common" "4.20.0" - -"@ampproject/remapping@^2.2.0": - version "2.2.1" - resolved "https://registry.yarnpkg.com/@ampproject/remapping/-/remapping-2.2.1.tgz#99e8e11851128b8702cd57c33684f1d0f260b630" - integrity sha512-lFMjJTrFL3j7L9yBxwYfCq2k6qqwHyzuUl/XBnif78PWTJYyL/dfowQHWE3sp6U6ZzqWiiIZnpTMO96zhkjwtg== - dependencies: - "@jridgewell/gen-mapping" "^0.3.0" - "@jridgewell/trace-mapping" "^0.3.9" - -"@babel/code-frame@^7.0.0", "@babel/code-frame@^7.10.4", "@babel/code-frame@^7.16.0", "@babel/code-frame@^7.22.13", "@babel/code-frame@^7.8.3": - version "7.22.13" - resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.22.13.tgz#e3c1c099402598483b7a8c46a721d1038803755e" - integrity sha512-XktuhWlJ5g+3TJXc5upd9Ks1HutSArik6jf2eAjYFyIOf4ej3RN+184cZbzDvbPnuTJIUhPKKJE3cIsYTiAT3w== - dependencies: - "@babel/highlight" "^7.22.13" - chalk "^2.4.2" - -"@babel/compat-data@^7.22.20", "@babel/compat-data@^7.22.6", "@babel/compat-data@^7.22.9": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/compat-data/-/compat-data-7.22.20.tgz#8df6e96661209623f1975d66c35ffca66f3306d0" - integrity sha512-BQYjKbpXjoXwFW5jGqiizJQQT/aC7pFm9Ok1OWssonuguICi264lbgMzRp2ZMmRSlfkX6DsWDDcsrctK8Rwfiw== - -"@babel/core@7.12.9": - version "7.12.9" - resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.12.9.tgz#fd450c4ec10cdbb980e2928b7aa7a28484593fc8" - integrity sha512-gTXYh3M5wb7FRXQy+FErKFAv90BnlOuNn1QkCK2lREoPAjrQCO49+HVSrFoe5uakFAF5eenS75KbO2vQiLrTMQ== - dependencies: - "@babel/code-frame" "^7.10.4" - "@babel/generator" "^7.12.5" - "@babel/helper-module-transforms" "^7.12.1" - "@babel/helpers" "^7.12.5" - "@babel/parser" "^7.12.7" - "@babel/template" "^7.12.7" - "@babel/traverse" "^7.12.9" - "@babel/types" "^7.12.7" - convert-source-map "^1.7.0" - debug "^4.1.0" - gensync "^1.0.0-beta.1" - json5 "^2.1.2" - lodash "^4.17.19" - resolve "^1.3.2" - semver "^5.4.1" - source-map "^0.5.0" - -"@babel/core@^7.18.6", "@babel/core@^7.19.6": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.23.0.tgz#f8259ae0e52a123eb40f552551e647b506a94d83" - integrity sha512-97z/ju/Jy1rZmDxybphrBuI+jtJjFVoz7Mr9yUQVVVi+DNZE333uFQeMOqcCIy1x3WYBIbWftUSLmbNXNT7qFQ== - dependencies: - "@ampproject/remapping" "^2.2.0" - "@babel/code-frame" "^7.22.13" - "@babel/generator" "^7.23.0" - "@babel/helper-compilation-targets" "^7.22.15" - "@babel/helper-module-transforms" "^7.23.0" - "@babel/helpers" "^7.23.0" - "@babel/parser" "^7.23.0" - "@babel/template" "^7.22.15" - "@babel/traverse" "^7.23.0" - "@babel/types" "^7.23.0" - convert-source-map "^2.0.0" - debug "^4.1.0" - gensync "^1.0.0-beta.2" - json5 "^2.2.3" - semver "^6.3.1" - -"@babel/generator@^7.12.5", "@babel/generator@^7.18.7", "@babel/generator@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.23.0.tgz#df5c386e2218be505b34837acbcb874d7a983420" - integrity sha512-lN85QRR+5IbYrMWM6Y4pE/noaQtg4pNiqeNGX60eqOfo6gtEj6uw/JagelB8vVztSd7R6M5n1+PQkDbHbBRU4g== - dependencies: - "@babel/types" "^7.23.0" - "@jridgewell/gen-mapping" "^0.3.2" - "@jridgewell/trace-mapping" "^0.3.17" - jsesc "^2.5.1" - -"@babel/helper-annotate-as-pure@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.22.5.tgz#e7f06737b197d580a01edf75d97e2c8be99d3882" - integrity sha512-LvBTxu8bQSQkcyKOU+a1btnNFQ1dMAd0R6PyW3arXes06F6QLWLIrd681bxRPIXlrMGR3XYnW9JyML7dP3qgxg== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-builder-binary-assignment-operator-visitor@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-builder-binary-assignment-operator-visitor/-/helper-builder-binary-assignment-operator-visitor-7.22.15.tgz#5426b109cf3ad47b91120f8328d8ab1be8b0b956" - integrity sha512-QkBXwGgaoC2GtGZRoma6kv7Szfv06khvhFav67ZExau2RaXzy8MpHSMO2PNoP2XtmQphJQRHFfg77Bq731Yizw== - dependencies: - "@babel/types" "^7.22.15" - -"@babel/helper-compilation-targets@^7.22.15", "@babel/helper-compilation-targets@^7.22.5", "@babel/helper-compilation-targets@^7.22.6": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-compilation-targets/-/helper-compilation-targets-7.22.15.tgz#0698fc44551a26cf29f18d4662d5bf545a6cfc52" - integrity sha512-y6EEzULok0Qvz8yyLkCvVX+02ic+By2UdOhylwUOvOn9dvYc9mKICJuuU1n1XBI02YWsNsnrY1kc6DVbjcXbtw== - dependencies: - "@babel/compat-data" "^7.22.9" - "@babel/helper-validator-option" "^7.22.15" - browserslist "^4.21.9" - lru-cache "^5.1.1" - semver "^6.3.1" - -"@babel/helper-create-class-features-plugin@^7.22.11", "@babel/helper-create-class-features-plugin@^7.22.15", "@babel/helper-create-class-features-plugin@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-create-class-features-plugin/-/helper-create-class-features-plugin-7.22.15.tgz#97a61b385e57fe458496fad19f8e63b63c867de4" - integrity sha512-jKkwA59IXcvSaiK2UN45kKwSC9o+KuoXsBDvHvU/7BecYIp8GQ2UwrVvFgJASUT+hBnwJx6MhvMCuMzwZZ7jlg== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-environment-visitor" "^7.22.5" - "@babel/helper-function-name" "^7.22.5" - "@babel/helper-member-expression-to-functions" "^7.22.15" - "@babel/helper-optimise-call-expression" "^7.22.5" - "@babel/helper-replace-supers" "^7.22.9" - "@babel/helper-skip-transparent-expression-wrappers" "^7.22.5" - "@babel/helper-split-export-declaration" "^7.22.6" - semver "^6.3.1" - -"@babel/helper-create-regexp-features-plugin@^7.18.6", "@babel/helper-create-regexp-features-plugin@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-create-regexp-features-plugin/-/helper-create-regexp-features-plugin-7.22.15.tgz#5ee90093914ea09639b01c711db0d6775e558be1" - integrity sha512-29FkPLFjn4TPEa3RE7GpW+qbE8tlsu3jntNYNfcGsc49LphF1PQIiD+vMZ1z1xVOKt+93khA9tc2JBs3kBjA7w== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - regexpu-core "^5.3.1" - semver "^6.3.1" - -"@babel/helper-define-polyfill-provider@^0.4.2": - version "0.4.2" - resolved "https://registry.yarnpkg.com/@babel/helper-define-polyfill-provider/-/helper-define-polyfill-provider-0.4.2.tgz#82c825cadeeeee7aad237618ebbe8fa1710015d7" - integrity sha512-k0qnnOqHn5dK9pZpfD5XXZ9SojAITdCKRn2Lp6rnDGzIbaP0rHyMPk/4wsSxVBVz4RfN0q6VpXWP2pDGIoQ7hw== - dependencies: - "@babel/helper-compilation-targets" "^7.22.6" - "@babel/helper-plugin-utils" "^7.22.5" - debug "^4.1.1" - lodash.debounce "^4.0.8" - resolve "^1.14.2" - -"@babel/helper-environment-visitor@^7.22.20", "@babel/helper-environment-visitor@^7.22.5": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/helper-environment-visitor/-/helper-environment-visitor-7.22.20.tgz#96159db61d34a29dba454c959f5ae4a649ba9167" - integrity sha512-zfedSIzFhat/gFhWfHtgWvlec0nqB9YEIVrpuwjruLlXfUSnA8cJB0miHKwqDnQ7d32aKo2xt88/xZptwxbfhA== - -"@babel/helper-function-name@^7.22.5", "@babel/helper-function-name@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/helper-function-name/-/helper-function-name-7.23.0.tgz#1f9a3cdbd5b2698a670c30d2735f9af95ed52759" - integrity sha512-OErEqsrxjZTJciZ4Oo+eoZqeW9UIiOcuYKRJA4ZAgV9myA+pOXhhmpfNCKjEH/auVfEYVFJ6y1Tc4r0eIApqiw== - dependencies: - "@babel/template" "^7.22.15" - "@babel/types" "^7.23.0" - -"@babel/helper-hoist-variables@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-hoist-variables/-/helper-hoist-variables-7.22.5.tgz#c01a007dac05c085914e8fb652b339db50d823bb" - integrity sha512-wGjk9QZVzvknA6yKIUURb8zY3grXCcOZt+/7Wcy8O2uctxhplmUPkOdlgoNhmdVee2c92JXbf1xpMtVNbfoxRw== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-member-expression-to-functions@^7.22.15": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/helper-member-expression-to-functions/-/helper-member-expression-to-functions-7.23.0.tgz#9263e88cc5e41d39ec18c9a3e0eced59a3e7d366" - integrity sha512-6gfrPwh7OuT6gZyJZvd6WbTfrqAo7vm4xCzAXOusKqq/vWdKXphTpj5klHKNmRUU6/QRGlBsyU9mAIPaWHlqJA== - dependencies: - "@babel/types" "^7.23.0" - -"@babel/helper-module-imports@^7.22.15", "@babel/helper-module-imports@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-module-imports/-/helper-module-imports-7.22.15.tgz#16146307acdc40cc00c3b2c647713076464bdbf0" - integrity sha512-0pYVBnDKZO2fnSPCrgM/6WMc7eS20Fbok+0r88fp+YtWVLZrp4CkafFGIp+W0VKw4a22sgebPT99y+FDNMdP4w== - dependencies: - "@babel/types" "^7.22.15" - -"@babel/helper-module-transforms@^7.12.1", "@babel/helper-module-transforms@^7.22.5", "@babel/helper-module-transforms@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/helper-module-transforms/-/helper-module-transforms-7.23.0.tgz#3ec246457f6c842c0aee62a01f60739906f7047e" - integrity sha512-WhDWw1tdrlT0gMgUJSlX0IQvoO1eN279zrAUbVB+KpV2c3Tylz8+GnKOLllCS6Z/iZQEyVYxhZVUdPTqs2YYPw== - dependencies: - "@babel/helper-environment-visitor" "^7.22.20" - "@babel/helper-module-imports" "^7.22.15" - "@babel/helper-simple-access" "^7.22.5" - "@babel/helper-split-export-declaration" "^7.22.6" - "@babel/helper-validator-identifier" "^7.22.20" - -"@babel/helper-optimise-call-expression@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-optimise-call-expression/-/helper-optimise-call-expression-7.22.5.tgz#f21531a9ccbff644fdd156b4077c16ff0c3f609e" - integrity sha512-HBwaojN0xFRx4yIvpwGqxiV2tUfl7401jlok564NgB9EHS1y6QT17FmKWm4ztqjeVdXLuC4fSvHc5ePpQjoTbw== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-plugin-utils@7.10.4": - version "7.10.4" - resolved "https://registry.yarnpkg.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.10.4.tgz#2f75a831269d4f677de49986dff59927533cf375" - integrity sha512-O4KCvQA6lLiMU9l2eawBPMf1xPP8xPfB3iEQw150hOVTqj/rfXz0ThTb4HEzqQfs2Bmo5Ay8BzxfzVtBrr9dVg== - -"@babel/helper-plugin-utils@^7.0.0", "@babel/helper-plugin-utils@^7.10.4", "@babel/helper-plugin-utils@^7.12.13", "@babel/helper-plugin-utils@^7.14.5", "@babel/helper-plugin-utils@^7.18.6", "@babel/helper-plugin-utils@^7.22.5", "@babel/helper-plugin-utils@^7.8.0", "@babel/helper-plugin-utils@^7.8.3": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-plugin-utils/-/helper-plugin-utils-7.22.5.tgz#dd7ee3735e8a313b9f7b05a773d892e88e6d7295" - integrity sha512-uLls06UVKgFG9QD4OeFYLEGteMIAa5kpTPcFL28yuCIIzsf6ZyKZMllKVOCZFhiZ5ptnwX4mtKdWCBE/uT4amg== - -"@babel/helper-remap-async-to-generator@^7.22.5", "@babel/helper-remap-async-to-generator@^7.22.9": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/helper-remap-async-to-generator/-/helper-remap-async-to-generator-7.22.20.tgz#7b68e1cb4fa964d2996fd063723fb48eca8498e0" - integrity sha512-pBGyV4uBqOns+0UvhsTO8qgl8hO89PmiDYv+/COyp1aeMcmfrfruz+/nCMFiYyFF/Knn0yfrC85ZzNFjembFTw== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-environment-visitor" "^7.22.20" - "@babel/helper-wrap-function" "^7.22.20" - -"@babel/helper-replace-supers@^7.22.5", "@babel/helper-replace-supers@^7.22.9": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/helper-replace-supers/-/helper-replace-supers-7.22.20.tgz#e37d367123ca98fe455a9887734ed2e16eb7a793" - integrity sha512-qsW0In3dbwQUbK8kejJ4R7IHVGwHJlV6lpG6UA7a9hSa2YEiAib+N1T2kr6PEeUT+Fl7najmSOS6SmAwCHK6Tw== - dependencies: - "@babel/helper-environment-visitor" "^7.22.20" - "@babel/helper-member-expression-to-functions" "^7.22.15" - "@babel/helper-optimise-call-expression" "^7.22.5" - -"@babel/helper-simple-access@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-simple-access/-/helper-simple-access-7.22.5.tgz#4938357dc7d782b80ed6dbb03a0fba3d22b1d5de" - integrity sha512-n0H99E/K+Bika3++WNL17POvo4rKWZ7lZEp1Q+fStVbUi8nxPQEBOlTmCOxW/0JsS56SKKQ+ojAe2pHKJHN35w== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-skip-transparent-expression-wrappers@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-skip-transparent-expression-wrappers/-/helper-skip-transparent-expression-wrappers-7.22.5.tgz#007f15240b5751c537c40e77abb4e89eeaaa8847" - integrity sha512-tK14r66JZKiC43p8Ki33yLBVJKlQDFoA8GYN67lWCDCqoL6EMMSuM9b+Iff2jHaM/RRFYl7K+iiru7hbRqNx8Q== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-split-export-declaration@^7.22.6": - version "7.22.6" - resolved "https://registry.yarnpkg.com/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.22.6.tgz#322c61b7310c0997fe4c323955667f18fcefb91c" - integrity sha512-AsUnxuLhRYsisFiaJwvp1QF+I3KjD5FOxut14q/GzovUe6orHLesW2C7d754kRm53h5gqrz6sFl6sxc4BVtE/g== - dependencies: - "@babel/types" "^7.22.5" - -"@babel/helper-string-parser@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.22.5.tgz#533f36457a25814cf1df6488523ad547d784a99f" - integrity sha512-mM4COjgZox8U+JcXQwPijIZLElkgEpO5rsERVDJTc2qfCDfERyob6k5WegS14SX18IIjv+XD+GrqNumY5JRCDw== - -"@babel/helper-validator-identifier@^7.22.20": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.20.tgz#c4ae002c61d2879e724581d96665583dbc1dc0e0" - integrity sha512-Y4OZ+ytlatR8AI+8KZfKuL5urKp7qey08ha31L8b3BwewJAoJamTzyvxPR/5D+KkdJCGPq/+8TukHBlY10FX9A== - -"@babel/helper-validator-option@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/helper-validator-option/-/helper-validator-option-7.22.15.tgz#694c30dfa1d09a6534cdfcafbe56789d36aba040" - integrity sha512-bMn7RmyFjY/mdECUbgn9eoSY4vqvacUnS9i9vGAGttgFWesO6B4CYWA7XlpbWgBt71iv/hfbPlynohStqnu5hA== - -"@babel/helper-wrap-function@^7.22.20": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/helper-wrap-function/-/helper-wrap-function-7.22.20.tgz#15352b0b9bfb10fc9c76f79f6342c00e3411a569" - integrity sha512-pms/UwkOpnQe/PDAEdV/d7dVCoBbB+R4FvYoHGZz+4VPcg7RtYy2KP7S2lbuWM6FCSgob5wshfGESbC/hzNXZw== - dependencies: - "@babel/helper-function-name" "^7.22.5" - "@babel/template" "^7.22.15" - "@babel/types" "^7.22.19" - -"@babel/helpers@^7.12.5", "@babel/helpers@^7.23.0": - version "7.23.1" - resolved "https://registry.yarnpkg.com/@babel/helpers/-/helpers-7.23.1.tgz#44e981e8ce2b9e99f8f0b703f3326a4636c16d15" - integrity sha512-chNpneuK18yW5Oxsr+t553UZzzAs3aZnFm4bxhebsNTeshrC95yA7l5yl7GBAG+JG1rF0F7zzD2EixK9mWSDoA== - dependencies: - "@babel/template" "^7.22.15" - "@babel/traverse" "^7.23.0" - "@babel/types" "^7.23.0" - -"@babel/highlight@^7.22.13": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.22.20.tgz#4ca92b71d80554b01427815e06f2df965b9c1f54" - integrity sha512-dkdMCN3py0+ksCgYmGG8jKeGA/8Tk+gJwSYYlFGxG5lmhfKNoAy004YpLxpS1W2J8m/EK2Ew+yOs9pVRwO89mg== - dependencies: - "@babel/helper-validator-identifier" "^7.22.20" - chalk "^2.4.2" - js-tokens "^4.0.0" - -"@babel/parser@^7.12.7", "@babel/parser@^7.18.8", "@babel/parser@^7.22.15", "@babel/parser@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.23.0.tgz#da950e622420bf96ca0d0f2909cdddac3acd8719" - integrity sha512-vvPKKdMemU85V9WE/l5wZEmImpCtLqbnTvqDS2U1fJ96KrxoW7KrXhNsNCblQlg8Ck4b85yxdTyelsMUgFUXiw== - -"@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression/-/plugin-bugfix-safari-id-destructuring-collision-in-function-expression-7.22.15.tgz#02dc8a03f613ed5fdc29fb2f728397c78146c962" - integrity sha512-FB9iYlz7rURmRJyXRKEnalYPPdn87H5no108cyuQQyMwlpJ2SJtpIUBI27kdTin956pz+LPypkPVPUTlxOmrsg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining/-/plugin-bugfix-v8-spread-parameters-in-optional-chaining-7.22.15.tgz#2aeb91d337d4e1a1e7ce85b76a37f5301781200f" - integrity sha512-Hyph9LseGvAeeXzikV88bczhsrLrIZqDPxO+sSmAunMPaGrBGhfMWzCPYTtiW9t+HzSE2wtV8e5cc5P6r1xMDQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-skip-transparent-expression-wrappers" "^7.22.5" - "@babel/plugin-transform-optional-chaining" "^7.22.15" - -"@babel/plugin-proposal-object-rest-spread@7.12.1": - version "7.12.1" - resolved "https://registry.yarnpkg.com/@babel/plugin-proposal-object-rest-spread/-/plugin-proposal-object-rest-spread-7.12.1.tgz#def9bd03cea0f9b72283dac0ec22d289c7691069" - integrity sha512-s6SowJIjzlhx8o7lsFx5zmY4At6CTtDvgNQDdPzkBQucle58A6b/TTeEBYtyDgmcXjUTM+vE8YOGHZzzbc/ioA== - dependencies: - "@babel/helper-plugin-utils" "^7.10.4" - "@babel/plugin-syntax-object-rest-spread" "^7.8.0" - "@babel/plugin-transform-parameters" "^7.12.1" - -"@babel/plugin-proposal-private-property-in-object@7.21.0-placeholder-for-preset-env.2": - version "7.21.0-placeholder-for-preset-env.2" - resolved "https://registry.yarnpkg.com/@babel/plugin-proposal-private-property-in-object/-/plugin-proposal-private-property-in-object-7.21.0-placeholder-for-preset-env.2.tgz#7844f9289546efa9febac2de4cfe358a050bd703" - integrity sha512-SOSkfJDddaM7mak6cPEpswyTRnuRltl429hMraQEglW+OkovnCzsiszTmsrlY//qLFjCpQDFRvjdm2wA5pPm9w== - -"@babel/plugin-syntax-async-generators@^7.8.4": - version "7.8.4" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-async-generators/-/plugin-syntax-async-generators-7.8.4.tgz#a983fb1aeb2ec3f6ed042a210f640e90e786fe0d" - integrity sha512-tycmZxkGfZaxhMRbXlPXuVFpdWlXpir2W4AMhSJgRKzk/eDlIXOhb2LHWoLpDF7TEHylV5zNhykX6KAgHJmTNw== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-class-properties@^7.12.13": - version "7.12.13" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-class-properties/-/plugin-syntax-class-properties-7.12.13.tgz#b5c987274c4a3a82b89714796931a6b53544ae10" - integrity sha512-fm4idjKla0YahUNgFNLCB0qySdsoPiZP3iQE3rky0mBUtMZ23yDJ9SJdg6dXTSDnulOVqiF3Hgr9nbXvXTQZYA== - dependencies: - "@babel/helper-plugin-utils" "^7.12.13" - -"@babel/plugin-syntax-class-static-block@^7.14.5": - version "7.14.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-class-static-block/-/plugin-syntax-class-static-block-7.14.5.tgz#195df89b146b4b78b3bf897fd7a257c84659d406" - integrity sha512-b+YyPmr6ldyNnM6sqYeMWE+bgJcJpO6yS4QD7ymxgH34GBPNDM/THBh8iunyvKIZztiwLH4CJZ0RxTk9emgpjw== - dependencies: - "@babel/helper-plugin-utils" "^7.14.5" - -"@babel/plugin-syntax-dynamic-import@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-dynamic-import/-/plugin-syntax-dynamic-import-7.8.3.tgz#62bf98b2da3cd21d626154fc96ee5b3cb68eacb3" - integrity sha512-5gdGbFon+PszYzqs83S3E5mpi7/y/8M9eC90MRTZfduQOYW76ig6SOSPNe41IG5LoP3FGBn2N0RjVDSQiS94kQ== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-export-namespace-from@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-export-namespace-from/-/plugin-syntax-export-namespace-from-7.8.3.tgz#028964a9ba80dbc094c915c487ad7c4e7a66465a" - integrity sha512-MXf5laXo6c1IbEbegDmzGPwGNTsHZmEy6QGznu5Sh2UCWvueywb2ee+CCE4zQiZstxU9BMoQO9i6zUFSY0Kj0Q== - dependencies: - "@babel/helper-plugin-utils" "^7.8.3" - -"@babel/plugin-syntax-import-assertions@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-import-assertions/-/plugin-syntax-import-assertions-7.22.5.tgz#07d252e2aa0bc6125567f742cd58619cb14dce98" - integrity sha512-rdV97N7KqsRzeNGoWUOK6yUsWarLjE5Su/Snk9IYPU9CwkWHs4t+rTGOvffTR8XGkJMTAdLfO0xVnXm8wugIJg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-syntax-import-attributes@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-import-attributes/-/plugin-syntax-import-attributes-7.22.5.tgz#ab840248d834410b829f569f5262b9e517555ecb" - integrity sha512-KwvoWDeNKPETmozyFE0P2rOLqh39EoQHNjqizrI5B8Vt0ZNS7M56s7dAiAqbYfiAYOuIzIh96z3iR2ktgu3tEg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-syntax-import-meta@^7.10.4": - version "7.10.4" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-import-meta/-/plugin-syntax-import-meta-7.10.4.tgz#ee601348c370fa334d2207be158777496521fd51" - integrity sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g== - dependencies: - "@babel/helper-plugin-utils" "^7.10.4" - -"@babel/plugin-syntax-json-strings@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-json-strings/-/plugin-syntax-json-strings-7.8.3.tgz#01ca21b668cd8218c9e640cb6dd88c5412b2c96a" - integrity sha512-lY6kdGpWHvjoe2vk4WrAapEuBR69EMxZl+RoGRhrFGNYVK8mOPAW8VfbT/ZgrFbXlDNiiaxQnAtgVCZ6jv30EA== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-jsx@7.12.1": - version "7.12.1" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.12.1.tgz#9d9d357cc818aa7ae7935917c1257f67677a0926" - integrity sha512-1yRi7yAtB0ETgxdY9ti/p2TivUxJkTdhu/ZbF9MshVGqOx1TdB3b7xCXs49Fupgg50N45KcAsRP/ZqWjs9SRjg== - dependencies: - "@babel/helper-plugin-utils" "^7.10.4" - -"@babel/plugin-syntax-jsx@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-jsx/-/plugin-syntax-jsx-7.22.5.tgz#a6b68e84fb76e759fc3b93e901876ffabbe1d918" - integrity sha512-gvyP4hZrgrs/wWMaocvxZ44Hw0b3W8Pe+cMxc8V1ULQ07oh8VNbIRaoD1LRZVTvD+0nieDKjfgKg89sD7rrKrg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-syntax-logical-assignment-operators@^7.10.4": - version "7.10.4" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-logical-assignment-operators/-/plugin-syntax-logical-assignment-operators-7.10.4.tgz#ca91ef46303530448b906652bac2e9fe9941f699" - integrity sha512-d8waShlpFDinQ5MtvGU9xDAOzKH47+FFoney2baFIoMr952hKOLp1HR7VszoZvOsV/4+RRszNY7D17ba0te0ig== - dependencies: - "@babel/helper-plugin-utils" "^7.10.4" - -"@babel/plugin-syntax-nullish-coalescing-operator@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-nullish-coalescing-operator/-/plugin-syntax-nullish-coalescing-operator-7.8.3.tgz#167ed70368886081f74b5c36c65a88c03b66d1a9" - integrity sha512-aSff4zPII1u2QD7y+F8oDsz19ew4IGEJg9SVW+bqwpwtfFleiQDMdzA/R+UlWDzfnHFCxxleFT0PMIrR36XLNQ== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-numeric-separator@^7.10.4": - version "7.10.4" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-numeric-separator/-/plugin-syntax-numeric-separator-7.10.4.tgz#b9b070b3e33570cd9fd07ba7fa91c0dd37b9af97" - integrity sha512-9H6YdfkcK/uOnY/K7/aA2xpzaAgkQn37yzWUMRK7OaPOqOpGS1+n0H5hxT9AUw9EsSjPW8SVyMJwYRtWs3X3ug== - dependencies: - "@babel/helper-plugin-utils" "^7.10.4" - -"@babel/plugin-syntax-object-rest-spread@7.8.3", "@babel/plugin-syntax-object-rest-spread@^7.8.0", "@babel/plugin-syntax-object-rest-spread@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-object-rest-spread/-/plugin-syntax-object-rest-spread-7.8.3.tgz#60e225edcbd98a640332a2e72dd3e66f1af55871" - integrity sha512-XoqMijGZb9y3y2XskN+P1wUGiVwWZ5JmoDRwx5+3GmEplNyVM2s2Dg8ILFQm8rWM48orGy5YpI5Bl8U1y7ydlA== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-optional-catch-binding@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-optional-catch-binding/-/plugin-syntax-optional-catch-binding-7.8.3.tgz#6111a265bcfb020eb9efd0fdfd7d26402b9ed6c1" - integrity sha512-6VPD0Pc1lpTqw0aKoeRTMiB+kWhAoT24PA+ksWSBrFtl5SIRVpZlwN3NNPQjehA2E/91FV3RjLWoVTglWcSV3Q== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-optional-chaining@^7.8.3": - version "7.8.3" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-optional-chaining/-/plugin-syntax-optional-chaining-7.8.3.tgz#4f69c2ab95167e0180cd5336613f8c5788f7d48a" - integrity sha512-KoK9ErH1MBlCPxV0VANkXW2/dw4vlbGDrFgz8bmUsBGYkFRcbRwMh6cIJubdPrkxRwuGdtCk0v/wPTKbQgBjkg== - dependencies: - "@babel/helper-plugin-utils" "^7.8.0" - -"@babel/plugin-syntax-private-property-in-object@^7.14.5": - version "7.14.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-private-property-in-object/-/plugin-syntax-private-property-in-object-7.14.5.tgz#0dc6671ec0ea22b6e94a1114f857970cd39de1ad" - integrity sha512-0wVnp9dxJ72ZUJDV27ZfbSj6iHLoytYZmh3rFcxNnvsJF3ktkzLDZPy/mA17HGsaQT3/DQsWYX1f1QGWkCoVUg== - dependencies: - "@babel/helper-plugin-utils" "^7.14.5" - -"@babel/plugin-syntax-top-level-await@^7.14.5": - version "7.14.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-top-level-await/-/plugin-syntax-top-level-await-7.14.5.tgz#c1cfdadc35a646240001f06138247b741c34d94c" - integrity sha512-hx++upLv5U1rgYfwe1xBQUhRmU41NEvpUvrp8jkrSCdvGSnM5/qdRMtylJ6PG5OFkBaHkbTAKTnd3/YyESRHFw== - dependencies: - "@babel/helper-plugin-utils" "^7.14.5" - -"@babel/plugin-syntax-typescript@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-typescript/-/plugin-syntax-typescript-7.22.5.tgz#aac8d383b062c5072c647a31ef990c1d0af90272" - integrity sha512-1mS2o03i7t1c6VzH6fdQ3OA8tcEIxwG18zIPRp+UY1Ihv6W+XZzBCVxExF9upussPXJ0xE9XRHwMoNs1ep/nRQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-syntax-unicode-sets-regex@^7.18.6": - version "7.18.6" - resolved "https://registry.yarnpkg.com/@babel/plugin-syntax-unicode-sets-regex/-/plugin-syntax-unicode-sets-regex-7.18.6.tgz#d49a3b3e6b52e5be6740022317580234a6a47357" - integrity sha512-727YkEAPwSIQTv5im8QHz3upqp92JTWhidIC81Tdx4VJYIte/VndKf1qKrfnnhPLiPghStWfvC/iFaMCQu7Nqg== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.18.6" - "@babel/helper-plugin-utils" "^7.18.6" - -"@babel/plugin-transform-arrow-functions@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-arrow-functions/-/plugin-transform-arrow-functions-7.22.5.tgz#e5ba566d0c58a5b2ba2a8b795450641950b71958" - integrity sha512-26lTNXoVRdAnsaDXPpvCNUq+OVWEVC6bx7Vvz9rC53F2bagUWW4u4ii2+h8Fejfh7RYqPxn+libeFBBck9muEw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-async-generator-functions@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-async-generator-functions/-/plugin-transform-async-generator-functions-7.22.15.tgz#3b153af4a6b779f340d5b80d3f634f55820aefa3" - integrity sha512-jBm1Es25Y+tVoTi5rfd5t1KLmL8ogLKpXszboWOTTtGFGz2RKnQe2yn7HbZ+kb/B8N0FVSGQo874NSlOU1T4+w== - dependencies: - "@babel/helper-environment-visitor" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-remap-async-to-generator" "^7.22.9" - "@babel/plugin-syntax-async-generators" "^7.8.4" - -"@babel/plugin-transform-async-to-generator@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-async-to-generator/-/plugin-transform-async-to-generator-7.22.5.tgz#c7a85f44e46f8952f6d27fe57c2ed3cc084c3775" - integrity sha512-b1A8D8ZzE/VhNDoV1MSJTnpKkCG5bJo+19R4o4oy03zM7ws8yEMK755j61Dc3EyvdysbqH5BOOTquJ7ZX9C6vQ== - dependencies: - "@babel/helper-module-imports" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-remap-async-to-generator" "^7.22.5" - -"@babel/plugin-transform-block-scoped-functions@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-block-scoped-functions/-/plugin-transform-block-scoped-functions-7.22.5.tgz#27978075bfaeb9fa586d3cb63a3d30c1de580024" - integrity sha512-tdXZ2UdknEKQWKJP1KMNmuF5Lx3MymtMN/pvA+p/VEkhK8jVcQ1fzSy8KM9qRYhAf2/lV33hoMPKI/xaI9sADA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-block-scoping@^7.22.15": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-block-scoping/-/plugin-transform-block-scoping-7.23.0.tgz#8744d02c6c264d82e1a4bc5d2d501fd8aff6f022" - integrity sha512-cOsrbmIOXmf+5YbL99/S49Y3j46k/T16b9ml8bm9lP6N9US5iQ2yBK7gpui1pg0V/WMcXdkfKbTb7HXq9u+v4g== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-class-properties@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-class-properties/-/plugin-transform-class-properties-7.22.5.tgz#97a56e31ad8c9dc06a0b3710ce7803d5a48cca77" - integrity sha512-nDkQ0NfkOhPTq8YCLiWNxp1+f9fCobEjCb0n8WdbNUBc4IB5V7P1QnX9IjpSoquKrXF5SKojHleVNs2vGeHCHQ== - dependencies: - "@babel/helper-create-class-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-class-static-block@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-class-static-block/-/plugin-transform-class-static-block-7.22.11.tgz#dc8cc6e498f55692ac6b4b89e56d87cec766c974" - integrity sha512-GMM8gGmqI7guS/llMFk1bJDkKfn3v3C4KHK9Yg1ey5qcHcOlKb0QvcMrgzvxo+T03/4szNh5lghY+fEC98Kq9g== - dependencies: - "@babel/helper-create-class-features-plugin" "^7.22.11" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-class-static-block" "^7.14.5" - -"@babel/plugin-transform-classes@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-classes/-/plugin-transform-classes-7.22.15.tgz#aaf4753aee262a232bbc95451b4bdf9599c65a0b" - integrity sha512-VbbC3PGjBdE0wAWDdHM9G8Gm977pnYI0XpqMd6LrKISj8/DJXEsWqgRuTYaNE9Bv0JGhTZUzHDlMk18IpOuoqw== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-compilation-targets" "^7.22.15" - "@babel/helper-environment-visitor" "^7.22.5" - "@babel/helper-function-name" "^7.22.5" - "@babel/helper-optimise-call-expression" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-replace-supers" "^7.22.9" - "@babel/helper-split-export-declaration" "^7.22.6" - globals "^11.1.0" - -"@babel/plugin-transform-computed-properties@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-computed-properties/-/plugin-transform-computed-properties-7.22.5.tgz#cd1e994bf9f316bd1c2dafcd02063ec261bb3869" - integrity sha512-4GHWBgRf0krxPX+AaPtgBAlTgTeZmqDynokHOX7aqqAB4tHs3U2Y02zH6ETFdLZGcg9UQSD1WCmkVrE9ErHeOg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/template" "^7.22.5" - -"@babel/plugin-transform-destructuring@^7.22.15": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-destructuring/-/plugin-transform-destructuring-7.23.0.tgz#6447aa686be48b32eaf65a73e0e2c0bd010a266c" - integrity sha512-vaMdgNXFkYrB+8lbgniSYWHsgqK5gjaMNcc84bMIOMRLH0L9AqYq3hwMdvnyqj1OPqea8UtjPEuS/DCenah1wg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-dotall-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-dotall-regex/-/plugin-transform-dotall-regex-7.22.5.tgz#dbb4f0e45766eb544e193fb00e65a1dd3b2a4165" - integrity sha512-5/Yk9QxCQCl+sOIB1WelKnVRxTJDSAIxtJLL2/pqL14ZVlbH0fUQUZa/T5/UnQtBNgghR7mfB8ERBKyKPCi7Vw== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-duplicate-keys@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-duplicate-keys/-/plugin-transform-duplicate-keys-7.22.5.tgz#b6e6428d9416f5f0bba19c70d1e6e7e0b88ab285" - integrity sha512-dEnYD+9BBgld5VBXHnF/DbYGp3fqGMsyxKbtD1mDyIA7AkTSpKXFhCVuj/oQVOoALfBs77DudA0BE4d5mcpmqw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-dynamic-import@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-dynamic-import/-/plugin-transform-dynamic-import-7.22.11.tgz#2c7722d2a5c01839eaf31518c6ff96d408e447aa" - integrity sha512-g/21plo58sfteWjaO0ZNVb+uEOkJNjAaHhbejrnBmu011l/eNDScmkbjCC3l4FKb10ViaGU4aOkFznSu2zRHgA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-dynamic-import" "^7.8.3" - -"@babel/plugin-transform-exponentiation-operator@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-exponentiation-operator/-/plugin-transform-exponentiation-operator-7.22.5.tgz#402432ad544a1f9a480da865fda26be653e48f6a" - integrity sha512-vIpJFNM/FjZ4rh1myqIya9jXwrwwgFRHPjT3DkUA9ZLHuzox8jiXkOLvwm1H+PQIP3CqfC++WPKeuDi0Sjdj1g== - dependencies: - "@babel/helper-builder-binary-assignment-operator-visitor" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-export-namespace-from@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-export-namespace-from/-/plugin-transform-export-namespace-from-7.22.11.tgz#b3c84c8f19880b6c7440108f8929caf6056db26c" - integrity sha512-xa7aad7q7OiT8oNZ1mU7NrISjlSkVdMbNxn9IuLZyL9AJEhs1Apba3I+u5riX1dIkdptP5EKDG5XDPByWxtehw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-export-namespace-from" "^7.8.3" - -"@babel/plugin-transform-for-of@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-for-of/-/plugin-transform-for-of-7.22.15.tgz#f64b4ccc3a4f131a996388fae7680b472b306b29" - integrity sha512-me6VGeHsx30+xh9fbDLLPi0J1HzmeIIyenoOQHuw2D4m2SAU3NrspX5XxJLBpqn5yrLzrlw2Iy3RA//Bx27iOA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-function-name@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-function-name/-/plugin-transform-function-name-7.22.5.tgz#935189af68b01898e0d6d99658db6b164205c143" - integrity sha512-UIzQNMS0p0HHiQm3oelztj+ECwFnj+ZRV4KnguvlsD2of1whUeM6o7wGNj6oLwcDoAXQ8gEqfgC24D+VdIcevg== - dependencies: - "@babel/helper-compilation-targets" "^7.22.5" - "@babel/helper-function-name" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-json-strings@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-json-strings/-/plugin-transform-json-strings-7.22.11.tgz#689a34e1eed1928a40954e37f74509f48af67835" - integrity sha512-CxT5tCqpA9/jXFlme9xIBCc5RPtdDq3JpkkhgHQqtDdiTnTI0jtZ0QzXhr5DILeYifDPp2wvY2ad+7+hLMW5Pw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-json-strings" "^7.8.3" - -"@babel/plugin-transform-literals@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-literals/-/plugin-transform-literals-7.22.5.tgz#e9341f4b5a167952576e23db8d435849b1dd7920" - integrity sha512-fTLj4D79M+mepcw3dgFBTIDYpbcB9Sm0bpm4ppXPaO+U+PKFFyV9MGRvS0gvGw62sd10kT5lRMKXAADb9pWy8g== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-logical-assignment-operators@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-logical-assignment-operators/-/plugin-transform-logical-assignment-operators-7.22.11.tgz#24c522a61688bde045b7d9bc3c2597a4d948fc9c" - integrity sha512-qQwRTP4+6xFCDV5k7gZBF3C31K34ut0tbEcTKxlX/0KXxm9GLcO14p570aWxFvVzx6QAfPgq7gaeIHXJC8LswQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-logical-assignment-operators" "^7.10.4" - -"@babel/plugin-transform-member-expression-literals@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-member-expression-literals/-/plugin-transform-member-expression-literals-7.22.5.tgz#4fcc9050eded981a468347dd374539ed3e058def" - integrity sha512-RZEdkNtzzYCFl9SE9ATaUMTj2hqMb4StarOJLrZRbqqU4HSBE7UlBw9WBWQiDzrJZJdUWiMTVDI6Gv/8DPvfew== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-modules-amd@^7.22.5": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-modules-amd/-/plugin-transform-modules-amd-7.23.0.tgz#05b2bc43373faa6d30ca89214731f76f966f3b88" - integrity sha512-xWT5gefv2HGSm4QHtgc1sYPbseOyf+FFDo2JbpE25GWl5BqTGO9IMwTYJRoIdjsF85GE+VegHxSCUt5EvoYTAw== - dependencies: - "@babel/helper-module-transforms" "^7.23.0" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-modules-commonjs@^7.22.15", "@babel/plugin-transform-modules-commonjs@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-modules-commonjs/-/plugin-transform-modules-commonjs-7.23.0.tgz#b3dba4757133b2762c00f4f94590cf6d52602481" - integrity sha512-32Xzss14/UVc7k9g775yMIvkVK8xwKE0DPdP5JTapr3+Z9w4tzeOuLNY6BXDQR6BdnzIlXnCGAzsk/ICHBLVWQ== - dependencies: - "@babel/helper-module-transforms" "^7.23.0" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-simple-access" "^7.22.5" - -"@babel/plugin-transform-modules-systemjs@^7.22.11": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-modules-systemjs/-/plugin-transform-modules-systemjs-7.23.0.tgz#77591e126f3ff4132a40595a6cccd00a6b60d160" - integrity sha512-qBej6ctXZD2f+DhlOC9yO47yEYgUh5CZNz/aBoH4j/3NOlRfJXJbY7xDQCqQVf9KbrqGzIWER1f23doHGrIHFg== - dependencies: - "@babel/helper-hoist-variables" "^7.22.5" - "@babel/helper-module-transforms" "^7.23.0" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-validator-identifier" "^7.22.20" - -"@babel/plugin-transform-modules-umd@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-modules-umd/-/plugin-transform-modules-umd-7.22.5.tgz#4694ae40a87b1745e3775b6a7fe96400315d4f98" - integrity sha512-+S6kzefN/E1vkSsKx8kmQuqeQsvCKCd1fraCM7zXm4SFoggI099Tr4G8U81+5gtMdUeMQ4ipdQffbKLX0/7dBQ== - dependencies: - "@babel/helper-module-transforms" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-named-capturing-groups-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-named-capturing-groups-regex/-/plugin-transform-named-capturing-groups-regex-7.22.5.tgz#67fe18ee8ce02d57c855185e27e3dc959b2e991f" - integrity sha512-YgLLKmS3aUBhHaxp5hi1WJTgOUb/NCuDHzGT9z9WTt3YG+CPRhJs6nprbStx6DnWM4dh6gt7SU3sZodbZ08adQ== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-new-target@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-new-target/-/plugin-transform-new-target-7.22.5.tgz#1b248acea54ce44ea06dfd37247ba089fcf9758d" - integrity sha512-AsF7K0Fx/cNKVyk3a+DW0JLo+Ua598/NxMRvxDnkpCIGFh43+h/v2xyhRUYf6oD8gE4QtL83C7zZVghMjHd+iw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-nullish-coalescing-operator@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-nullish-coalescing-operator/-/plugin-transform-nullish-coalescing-operator-7.22.11.tgz#debef6c8ba795f5ac67cd861a81b744c5d38d9fc" - integrity sha512-YZWOw4HxXrotb5xsjMJUDlLgcDXSfO9eCmdl1bgW4+/lAGdkjaEvOnQ4p5WKKdUgSzO39dgPl0pTnfxm0OAXcg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-nullish-coalescing-operator" "^7.8.3" - -"@babel/plugin-transform-numeric-separator@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-numeric-separator/-/plugin-transform-numeric-separator-7.22.11.tgz#498d77dc45a6c6db74bb829c02a01c1d719cbfbd" - integrity sha512-3dzU4QGPsILdJbASKhF/V2TVP+gJya1PsueQCxIPCEcerqF21oEcrob4mzjsp2Py/1nLfF5m+xYNMDpmA8vffg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-numeric-separator" "^7.10.4" - -"@babel/plugin-transform-object-rest-spread@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-object-rest-spread/-/plugin-transform-object-rest-spread-7.22.15.tgz#21a95db166be59b91cde48775310c0df6e1da56f" - integrity sha512-fEB+I1+gAmfAyxZcX1+ZUwLeAuuf8VIg67CTznZE0MqVFumWkh8xWtn58I4dxdVf080wn7gzWoF8vndOViJe9Q== - dependencies: - "@babel/compat-data" "^7.22.9" - "@babel/helper-compilation-targets" "^7.22.15" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-object-rest-spread" "^7.8.3" - "@babel/plugin-transform-parameters" "^7.22.15" - -"@babel/plugin-transform-object-super@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-object-super/-/plugin-transform-object-super-7.22.5.tgz#794a8d2fcb5d0835af722173c1a9d704f44e218c" - integrity sha512-klXqyaT9trSjIUrcsYIfETAzmOEZL3cBYqOYLJxBHfMFFggmXOv+NYSX/Jbs9mzMVESw/WycLFPRx8ba/b2Ipw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-replace-supers" "^7.22.5" - -"@babel/plugin-transform-optional-catch-binding@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-optional-catch-binding/-/plugin-transform-optional-catch-binding-7.22.11.tgz#461cc4f578a127bb055527b3e77404cad38c08e0" - integrity sha512-rli0WxesXUeCJnMYhzAglEjLWVDF6ahb45HuprcmQuLidBJFWjNnOzssk2kuc6e33FlLaiZhG/kUIzUMWdBKaQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-optional-catch-binding" "^7.8.3" - -"@babel/plugin-transform-optional-chaining@^7.22.15": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-optional-chaining/-/plugin-transform-optional-chaining-7.23.0.tgz#73ff5fc1cf98f542f09f29c0631647d8ad0be158" - integrity sha512-sBBGXbLJjxTzLBF5rFWaikMnOGOk/BmK6vVByIdEggZ7Vn6CvWXZyRkkLFK6WE0IF8jSliyOkUN6SScFgzCM0g== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-skip-transparent-expression-wrappers" "^7.22.5" - "@babel/plugin-syntax-optional-chaining" "^7.8.3" - -"@babel/plugin-transform-parameters@^7.12.1", "@babel/plugin-transform-parameters@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-parameters/-/plugin-transform-parameters-7.22.15.tgz#719ca82a01d177af358df64a514d64c2e3edb114" - integrity sha512-hjk7qKIqhyzhhUvRT683TYQOFa/4cQKwQy7ALvTpODswN40MljzNDa0YldevS6tGbxwaEKVn502JmY0dP7qEtQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-private-methods@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-private-methods/-/plugin-transform-private-methods-7.22.5.tgz#21c8af791f76674420a147ae62e9935d790f8722" - integrity sha512-PPjh4gyrQnGe97JTalgRGMuU4icsZFnWkzicB/fUtzlKUqvsWBKEpPPfr5a2JiyirZkHxnAqkQMO5Z5B2kK3fA== - dependencies: - "@babel/helper-create-class-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-private-property-in-object@^7.22.11": - version "7.22.11" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-private-property-in-object/-/plugin-transform-private-property-in-object-7.22.11.tgz#ad45c4fc440e9cb84c718ed0906d96cf40f9a4e1" - integrity sha512-sSCbqZDBKHetvjSwpyWzhuHkmW5RummxJBVbYLkGkaiTOWGxml7SXt0iWa03bzxFIx7wOj3g/ILRd0RcJKBeSQ== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-create-class-features-plugin" "^7.22.11" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-private-property-in-object" "^7.14.5" - -"@babel/plugin-transform-property-literals@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-property-literals/-/plugin-transform-property-literals-7.22.5.tgz#b5ddabd73a4f7f26cd0e20f5db48290b88732766" - integrity sha512-TiOArgddK3mK/x1Qwf5hay2pxI6wCZnvQqrFSqbtg1GLl2JcNMitVH/YnqjP+M31pLUeTfzY1HAXFDnUBV30rQ== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-react-constant-elements@^7.18.12": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-react-constant-elements/-/plugin-transform-react-constant-elements-7.22.5.tgz#6dfa7c1c37f7d7279e417ceddf5a04abb8bb9c29" - integrity sha512-BF5SXoO+nX3h5OhlN78XbbDrBOffv+AxPP2ENaJOVqjWCgBDeOY3WcaUcddutGSfoap+5NEQ/q/4I3WZIvgkXA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-react-display-name@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-react-display-name/-/plugin-transform-react-display-name-7.22.5.tgz#3c4326f9fce31c7968d6cb9debcaf32d9e279a2b" - integrity sha512-PVk3WPYudRF5z4GKMEYUrLjPl38fJSKNaEOkFuoprioowGuWN6w2RKznuFNSlJx7pzzXXStPUnNSOEO0jL5EVw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-react-jsx-development@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-react-jsx-development/-/plugin-transform-react-jsx-development-7.22.5.tgz#e716b6edbef972a92165cd69d92f1255f7e73e87" - integrity sha512-bDhuzwWMuInwCYeDeMzyi7TaBgRQei6DqxhbyniL7/VG4RSS7HtSL2QbY4eESy1KJqlWt8g3xeEBGPuo+XqC8A== - dependencies: - "@babel/plugin-transform-react-jsx" "^7.22.5" - -"@babel/plugin-transform-react-jsx@^7.22.15", "@babel/plugin-transform-react-jsx@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-react-jsx/-/plugin-transform-react-jsx-7.22.15.tgz#7e6266d88705d7c49f11c98db8b9464531289cd6" - integrity sha512-oKckg2eZFa8771O/5vi7XeTvmM6+O9cxZu+kanTU7tD4sin5nO/G8jGJhq8Hvt2Z0kUoEDRayuZLaUlYl8QuGA== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-module-imports" "^7.22.15" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-jsx" "^7.22.5" - "@babel/types" "^7.22.15" - -"@babel/plugin-transform-react-pure-annotations@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-react-pure-annotations/-/plugin-transform-react-pure-annotations-7.22.5.tgz#1f58363eef6626d6fa517b95ac66fe94685e32c0" - integrity sha512-gP4k85wx09q+brArVinTXhWiyzLl9UpmGva0+mWyKxk6JZequ05x3eUcIUE+FyttPKJFRRVtAvQaJ6YF9h1ZpA== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-regenerator@^7.22.10": - version "7.22.10" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-regenerator/-/plugin-transform-regenerator-7.22.10.tgz#8ceef3bd7375c4db7652878b0241b2be5d0c3cca" - integrity sha512-F28b1mDt8KcT5bUyJc/U9nwzw6cV+UmTeRlXYIl2TNqMMJif0Jeey9/RQ3C4NOd2zp0/TRsDns9ttj2L523rsw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - regenerator-transform "^0.15.2" - -"@babel/plugin-transform-reserved-words@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-reserved-words/-/plugin-transform-reserved-words-7.22.5.tgz#832cd35b81c287c4bcd09ce03e22199641f964fb" - integrity sha512-DTtGKFRQUDm8svigJzZHzb/2xatPc6TzNvAIJ5GqOKDsGFYgAskjRulbR/vGsPKq3OPqtexnz327qYpP57RFyA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-runtime@^7.18.6": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-runtime/-/plugin-transform-runtime-7.22.15.tgz#3a625c4c05a39e932d7d34f5d4895cdd0172fdc9" - integrity sha512-tEVLhk8NRZSmwQ0DJtxxhTrCht1HVo8VaMzYT4w6lwyKBuHsgoioAUA7/6eT2fRfc5/23fuGdlwIxXhRVgWr4g== - dependencies: - "@babel/helper-module-imports" "^7.22.15" - "@babel/helper-plugin-utils" "^7.22.5" - babel-plugin-polyfill-corejs2 "^0.4.5" - babel-plugin-polyfill-corejs3 "^0.8.3" - babel-plugin-polyfill-regenerator "^0.5.2" - semver "^6.3.1" - -"@babel/plugin-transform-shorthand-properties@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-shorthand-properties/-/plugin-transform-shorthand-properties-7.22.5.tgz#6e277654be82b5559fc4b9f58088507c24f0c624" - integrity sha512-vM4fq9IXHscXVKzDv5itkO1X52SmdFBFcMIBZ2FRn2nqVYqw6dBexUgMvAjHW+KXpPPViD/Yo3GrDEBaRC0QYA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-spread@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-spread/-/plugin-transform-spread-7.22.5.tgz#6487fd29f229c95e284ba6c98d65eafb893fea6b" - integrity sha512-5ZzDQIGyvN4w8+dMmpohL6MBo+l2G7tfC/O2Dg7/hjpgeWvUx8FzfeOKxGog9IimPa4YekaQ9PlDqTLOljkcxg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-skip-transparent-expression-wrappers" "^7.22.5" - -"@babel/plugin-transform-sticky-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-sticky-regex/-/plugin-transform-sticky-regex-7.22.5.tgz#295aba1595bfc8197abd02eae5fc288c0deb26aa" - integrity sha512-zf7LuNpHG0iEeiyCNwX4j3gDg1jgt1k3ZdXBKbZSoA3BbGQGvMiSvfbZRR3Dr3aeJe3ooWFZxOOG3IRStYp2Bw== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-template-literals@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-template-literals/-/plugin-transform-template-literals-7.22.5.tgz#8f38cf291e5f7a8e60e9f733193f0bcc10909bff" - integrity sha512-5ciOehRNf+EyUeewo8NkbQiUs4d6ZxiHo6BcBcnFlgiJfu16q0bQUw9Jvo0b0gBKFG1SMhDSjeKXSYuJLeFSMA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-typeof-symbol@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-typeof-symbol/-/plugin-transform-typeof-symbol-7.22.5.tgz#5e2ba478da4b603af8673ff7c54f75a97b716b34" - integrity sha512-bYkI5lMzL4kPii4HHEEChkD0rkc+nvnlR6+o/qdqR6zrm0Sv/nodmyLhlq2DO0YKLUNd2VePmPRjJXSBh9OIdA== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-typescript@^7.22.15": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-typescript/-/plugin-transform-typescript-7.22.15.tgz#15adef906451d86349eb4b8764865c960eb54127" - integrity sha512-1uirS0TnijxvQLnlv5wQBwOX3E1wCFX7ITv+9pBV2wKEk4K+M5tqDaoNXnTH8tjEIYHLO98MwiTWO04Ggz4XuA== - dependencies: - "@babel/helper-annotate-as-pure" "^7.22.5" - "@babel/helper-create-class-features-plugin" "^7.22.15" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/plugin-syntax-typescript" "^7.22.5" - -"@babel/plugin-transform-unicode-escapes@^7.22.10": - version "7.22.10" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-unicode-escapes/-/plugin-transform-unicode-escapes-7.22.10.tgz#c723f380f40a2b2f57a62df24c9005834c8616d9" - integrity sha512-lRfaRKGZCBqDlRU3UIFovdp9c9mEvlylmpod0/OatICsSfuQ9YFthRo1tpTkGsklEefZdqlEFdY4A2dwTb6ohg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-unicode-property-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-unicode-property-regex/-/plugin-transform-unicode-property-regex-7.22.5.tgz#098898f74d5c1e86660dc112057b2d11227f1c81" - integrity sha512-HCCIb+CbJIAE6sXn5CjFQXMwkCClcOfPCzTlilJ8cUatfzwHlWQkbtV0zD338u9dZskwvuOYTuuaMaA8J5EI5A== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-unicode-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-unicode-regex/-/plugin-transform-unicode-regex-7.22.5.tgz#ce7e7bb3ef208c4ff67e02a22816656256d7a183" - integrity sha512-028laaOKptN5vHJf9/Arr/HiJekMd41hOEZYvNsrsXqJ7YPYuX2bQxh31fkZzGmq3YqHRJzYFFAVYvKfMPKqyg== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/plugin-transform-unicode-sets-regex@^7.22.5": - version "7.22.5" - resolved "https://registry.yarnpkg.com/@babel/plugin-transform-unicode-sets-regex/-/plugin-transform-unicode-sets-regex-7.22.5.tgz#77788060e511b708ffc7d42fdfbc5b37c3004e91" - integrity sha512-lhMfi4FC15j13eKrh3DnYHjpGj6UKQHtNKTbtc1igvAhRy4+kLhV07OpLcsN0VgDEw/MjAvJO4BdMJsHwMhzCg== - dependencies: - "@babel/helper-create-regexp-features-plugin" "^7.22.5" - "@babel/helper-plugin-utils" "^7.22.5" - -"@babel/preset-env@^7.18.6", "@babel/preset-env@^7.19.4": - version "7.22.20" - resolved "https://registry.yarnpkg.com/@babel/preset-env/-/preset-env-7.22.20.tgz#de9e9b57e1127ce0a2f580831717f7fb677ceedb" - integrity sha512-11MY04gGC4kSzlPHRfvVkNAZhUxOvm7DCJ37hPDnUENwe06npjIRAfInEMTGSb4LZK5ZgDFkv5hw0lGebHeTyg== - dependencies: - "@babel/compat-data" "^7.22.20" - "@babel/helper-compilation-targets" "^7.22.15" - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-validator-option" "^7.22.15" - "@babel/plugin-bugfix-safari-id-destructuring-collision-in-function-expression" "^7.22.15" - "@babel/plugin-bugfix-v8-spread-parameters-in-optional-chaining" "^7.22.15" - "@babel/plugin-proposal-private-property-in-object" "7.21.0-placeholder-for-preset-env.2" - "@babel/plugin-syntax-async-generators" "^7.8.4" - "@babel/plugin-syntax-class-properties" "^7.12.13" - "@babel/plugin-syntax-class-static-block" "^7.14.5" - "@babel/plugin-syntax-dynamic-import" "^7.8.3" - "@babel/plugin-syntax-export-namespace-from" "^7.8.3" - "@babel/plugin-syntax-import-assertions" "^7.22.5" - "@babel/plugin-syntax-import-attributes" "^7.22.5" - "@babel/plugin-syntax-import-meta" "^7.10.4" - "@babel/plugin-syntax-json-strings" "^7.8.3" - "@babel/plugin-syntax-logical-assignment-operators" "^7.10.4" - "@babel/plugin-syntax-nullish-coalescing-operator" "^7.8.3" - "@babel/plugin-syntax-numeric-separator" "^7.10.4" - "@babel/plugin-syntax-object-rest-spread" "^7.8.3" - "@babel/plugin-syntax-optional-catch-binding" "^7.8.3" - "@babel/plugin-syntax-optional-chaining" "^7.8.3" - "@babel/plugin-syntax-private-property-in-object" "^7.14.5" - "@babel/plugin-syntax-top-level-await" "^7.14.5" - "@babel/plugin-syntax-unicode-sets-regex" "^7.18.6" - "@babel/plugin-transform-arrow-functions" "^7.22.5" - "@babel/plugin-transform-async-generator-functions" "^7.22.15" - "@babel/plugin-transform-async-to-generator" "^7.22.5" - "@babel/plugin-transform-block-scoped-functions" "^7.22.5" - "@babel/plugin-transform-block-scoping" "^7.22.15" - "@babel/plugin-transform-class-properties" "^7.22.5" - "@babel/plugin-transform-class-static-block" "^7.22.11" - "@babel/plugin-transform-classes" "^7.22.15" - "@babel/plugin-transform-computed-properties" "^7.22.5" - "@babel/plugin-transform-destructuring" "^7.22.15" - "@babel/plugin-transform-dotall-regex" "^7.22.5" - "@babel/plugin-transform-duplicate-keys" "^7.22.5" - "@babel/plugin-transform-dynamic-import" "^7.22.11" - "@babel/plugin-transform-exponentiation-operator" "^7.22.5" - "@babel/plugin-transform-export-namespace-from" "^7.22.11" - "@babel/plugin-transform-for-of" "^7.22.15" - "@babel/plugin-transform-function-name" "^7.22.5" - "@babel/plugin-transform-json-strings" "^7.22.11" - "@babel/plugin-transform-literals" "^7.22.5" - "@babel/plugin-transform-logical-assignment-operators" "^7.22.11" - "@babel/plugin-transform-member-expression-literals" "^7.22.5" - "@babel/plugin-transform-modules-amd" "^7.22.5" - "@babel/plugin-transform-modules-commonjs" "^7.22.15" - "@babel/plugin-transform-modules-systemjs" "^7.22.11" - "@babel/plugin-transform-modules-umd" "^7.22.5" - "@babel/plugin-transform-named-capturing-groups-regex" "^7.22.5" - "@babel/plugin-transform-new-target" "^7.22.5" - "@babel/plugin-transform-nullish-coalescing-operator" "^7.22.11" - "@babel/plugin-transform-numeric-separator" "^7.22.11" - "@babel/plugin-transform-object-rest-spread" "^7.22.15" - "@babel/plugin-transform-object-super" "^7.22.5" - "@babel/plugin-transform-optional-catch-binding" "^7.22.11" - "@babel/plugin-transform-optional-chaining" "^7.22.15" - "@babel/plugin-transform-parameters" "^7.22.15" - "@babel/plugin-transform-private-methods" "^7.22.5" - "@babel/plugin-transform-private-property-in-object" "^7.22.11" - "@babel/plugin-transform-property-literals" "^7.22.5" - "@babel/plugin-transform-regenerator" "^7.22.10" - "@babel/plugin-transform-reserved-words" "^7.22.5" - "@babel/plugin-transform-shorthand-properties" "^7.22.5" - "@babel/plugin-transform-spread" "^7.22.5" - "@babel/plugin-transform-sticky-regex" "^7.22.5" - "@babel/plugin-transform-template-literals" "^7.22.5" - "@babel/plugin-transform-typeof-symbol" "^7.22.5" - "@babel/plugin-transform-unicode-escapes" "^7.22.10" - "@babel/plugin-transform-unicode-property-regex" "^7.22.5" - "@babel/plugin-transform-unicode-regex" "^7.22.5" - "@babel/plugin-transform-unicode-sets-regex" "^7.22.5" - "@babel/preset-modules" "0.1.6-no-external-plugins" - "@babel/types" "^7.22.19" - babel-plugin-polyfill-corejs2 "^0.4.5" - babel-plugin-polyfill-corejs3 "^0.8.3" - babel-plugin-polyfill-regenerator "^0.5.2" - core-js-compat "^3.31.0" - semver "^6.3.1" - -"@babel/preset-modules@0.1.6-no-external-plugins": - version "0.1.6-no-external-plugins" - resolved "https://registry.yarnpkg.com/@babel/preset-modules/-/preset-modules-0.1.6-no-external-plugins.tgz#ccb88a2c49c817236861fee7826080573b8a923a" - integrity sha512-HrcgcIESLm9aIR842yhJ5RWan/gebQUJ6E/E5+rf0y9o6oj7w0Br+sWuL6kEQ/o/AdfvR1Je9jG18/gnpwjEyA== - dependencies: - "@babel/helper-plugin-utils" "^7.0.0" - "@babel/types" "^7.4.4" - esutils "^2.0.2" - -"@babel/preset-react@^7.18.6": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/preset-react/-/preset-react-7.22.15.tgz#9a776892b648e13cc8ca2edf5ed1264eea6b6afc" - integrity sha512-Csy1IJ2uEh/PecCBXXoZGAZBeCATTuePzCSB7dLYWS0vOEj6CNpjxIhW4duWwZodBNueH7QO14WbGn8YyeuN9w== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-validator-option" "^7.22.15" - "@babel/plugin-transform-react-display-name" "^7.22.5" - "@babel/plugin-transform-react-jsx" "^7.22.15" - "@babel/plugin-transform-react-jsx-development" "^7.22.5" - "@babel/plugin-transform-react-pure-annotations" "^7.22.5" - -"@babel/preset-typescript@^7.18.6": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/preset-typescript/-/preset-typescript-7.23.0.tgz#cc6602d13e7e5b2087c811912b87cf937a9129d9" - integrity sha512-6P6VVa/NM/VlAYj5s2Aq/gdVg8FSENCg3wlZ6Qau9AcPaoF5LbN1nyGlR9DTRIw9PpxI94e+ReydsJHcjwAweg== - dependencies: - "@babel/helper-plugin-utils" "^7.22.5" - "@babel/helper-validator-option" "^7.22.15" - "@babel/plugin-syntax-jsx" "^7.22.5" - "@babel/plugin-transform-modules-commonjs" "^7.23.0" - "@babel/plugin-transform-typescript" "^7.22.15" - -"@babel/regjsgen@^0.8.0": - version "0.8.0" - resolved "https://registry.yarnpkg.com/@babel/regjsgen/-/regjsgen-0.8.0.tgz#f0ba69b075e1f05fb2825b7fad991e7adbb18310" - integrity sha512-x/rqGMdzj+fWZvCOYForTghzbtqPDZ5gPwaoNGHdgDfF2QA/XZbCBp4Moo5scrkAMPhB7z26XM/AaHuIJdgauA== - -"@babel/runtime-corejs3@^7.18.6": - version "7.23.1" - resolved "https://registry.yarnpkg.com/@babel/runtime-corejs3/-/runtime-corejs3-7.23.1.tgz#d03f5819f4ba81a21dd1f80edfb19983e9e20fc1" - integrity sha512-OKKfytwoc0tr7cDHwQm0RLVR3y+hDGFz3EPuvLNU/0fOeXJeKNIHj7ffNVFnncWt3sC58uyUCRSzf8nBQbyF6A== - dependencies: - core-js-pure "^3.30.2" - regenerator-runtime "^0.14.0" - -"@babel/runtime@^7.1.2", "@babel/runtime@^7.10.3", "@babel/runtime@^7.12.13", "@babel/runtime@^7.12.5", "@babel/runtime@^7.18.6", "@babel/runtime@^7.20.13", "@babel/runtime@^7.8.4": - version "7.23.1" - resolved "https://registry.yarnpkg.com/@babel/runtime/-/runtime-7.23.1.tgz#72741dc4d413338a91dcb044a86f3c0bc402646d" - integrity sha512-hC2v6p8ZSI/W0HUzh3V8C5g+NwSKzKPtJwSpTjwl0o297GP9+ZLQSkdvHz46CM3LqyoXxq+5G9komY+eSqSO0g== - dependencies: - regenerator-runtime "^0.14.0" - -"@babel/template@^7.12.7", "@babel/template@^7.22.15", "@babel/template@^7.22.5": - version "7.22.15" - resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.22.15.tgz#09576efc3830f0430f4548ef971dde1350ef2f38" - integrity sha512-QPErUVm4uyJa60rkI73qneDacvdvzxshT3kksGqlGWYdOTIUOwJ7RDUL8sGqslY1uXWSL6xMFKEXDS3ox2uF0w== - dependencies: - "@babel/code-frame" "^7.22.13" - "@babel/parser" "^7.22.15" - "@babel/types" "^7.22.15" - -"@babel/traverse@^7.12.9", "@babel/traverse@^7.18.8", "@babel/traverse@^7.23.0": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.23.0.tgz#18196ddfbcf4ccea324b7f6d3ada00d8c5a99c53" - integrity sha512-t/QaEvyIoIkwzpiZ7aoSKK8kObQYeF7T2v+dazAYCb8SXtp58zEVkWW7zAnju8FNKNdr4ScAOEDmMItbyOmEYw== - dependencies: - "@babel/code-frame" "^7.22.13" - "@babel/generator" "^7.23.0" - "@babel/helper-environment-visitor" "^7.22.20" - "@babel/helper-function-name" "^7.23.0" - "@babel/helper-hoist-variables" "^7.22.5" - "@babel/helper-split-export-declaration" "^7.22.6" - "@babel/parser" "^7.23.0" - "@babel/types" "^7.23.0" - debug "^4.1.0" - globals "^11.1.0" - -"@babel/types@^7.12.7", "@babel/types@^7.20.0", "@babel/types@^7.22.15", "@babel/types@^7.22.19", "@babel/types@^7.22.5", "@babel/types@^7.23.0", "@babel/types@^7.4.4": - version "7.23.0" - resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.23.0.tgz#8c1f020c9df0e737e4e247c0619f58c68458aaeb" - integrity sha512-0oIyUfKoI3mSqMvsxBdclDwxXKXAUA8v/apZbc+iSyARYou1o8ZGDxbUYyLFoW2arqS2jDGqJuZvv1d/io1axg== - dependencies: - "@babel/helper-string-parser" "^7.22.5" - "@babel/helper-validator-identifier" "^7.22.20" - to-fast-properties "^2.0.0" - -"@braintree/sanitize-url@^6.0.0": - version "6.0.4" - resolved "https://registry.yarnpkg.com/@braintree/sanitize-url/-/sanitize-url-6.0.4.tgz#923ca57e173c6b232bbbb07347b1be982f03e783" - integrity sha512-s3jaWicZd0pkP0jf5ysyHUI/RE7MHos6qlToFcGWXVp+ykHOy77OUMrfbgJ9it2C5bow7OIQwYYaHjk9XlBQ2A== - -"@colors/colors@1.5.0": - version "1.5.0" - resolved "https://registry.yarnpkg.com/@colors/colors/-/colors-1.5.0.tgz#bb504579c1cae923e6576a4f5da43d25f97bdbd9" - integrity sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ== - -"@discoveryjs/json-ext@0.5.7": - version "0.5.7" - resolved "https://registry.yarnpkg.com/@discoveryjs/json-ext/-/json-ext-0.5.7.tgz#1d572bfbbe14b7704e0ba0f39b74815b84870d70" - integrity sha512-dBVuXR082gk3jsFp7Rd/JI4kytwGHecnCoTtXFb7DB6CNHp4rg5k1bhg0nWdLGLnOV71lmDzGQaLMy8iPLY0pw== - -"@docsearch/css@3.5.2": - version "3.5.2" - resolved "https://registry.yarnpkg.com/@docsearch/css/-/css-3.5.2.tgz#610f47b48814ca94041df969d9fcc47b91fc5aac" - integrity sha512-SPiDHaWKQZpwR2siD0KQUwlStvIAnEyK6tAE2h2Wuoq8ue9skzhlyVQ1ddzOxX6khULnAALDiR/isSF3bnuciA== - -"@docsearch/react@^3.1.1": - version "3.5.2" - resolved "https://registry.yarnpkg.com/@docsearch/react/-/react-3.5.2.tgz#2e6bbee00eb67333b64906352734da6aef1232b9" - integrity sha512-9Ahcrs5z2jq/DcAvYtvlqEBHImbm4YJI8M9y0x6Tqg598P40HTEkX7hsMcIuThI+hTFxRGZ9hll0Wygm2yEjng== - dependencies: - "@algolia/autocomplete-core" "1.9.3" - "@algolia/autocomplete-preset-algolia" "1.9.3" - "@docsearch/css" "3.5.2" - algoliasearch "^4.19.1" - -"@docusaurus/core@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/core/-/core-2.4.3.tgz#d86624901386fd8164ce4bff9cc7f16fde57f523" - integrity sha512-dWH5P7cgeNSIg9ufReX6gaCl/TmrGKD38Orbwuz05WPhAQtFXHd5B8Qym1TiXfvUNvwoYKkAJOJuGe8ou0Z7PA== - dependencies: - "@babel/core" "^7.18.6" - "@babel/generator" "^7.18.7" - "@babel/plugin-syntax-dynamic-import" "^7.8.3" - "@babel/plugin-transform-runtime" "^7.18.6" - "@babel/preset-env" "^7.18.6" - "@babel/preset-react" "^7.18.6" - "@babel/preset-typescript" "^7.18.6" - "@babel/runtime" "^7.18.6" - "@babel/runtime-corejs3" "^7.18.6" - "@babel/traverse" "^7.18.8" - "@docusaurus/cssnano-preset" "2.4.3" - "@docusaurus/logger" "2.4.3" - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/react-loadable" "5.5.2" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-common" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - "@slorber/static-site-generator-webpack-plugin" "^4.0.7" - "@svgr/webpack" "^6.2.1" - autoprefixer "^10.4.7" - babel-loader "^8.2.5" - babel-plugin-dynamic-import-node "^2.3.3" - boxen "^6.2.1" - chalk "^4.1.2" - chokidar "^3.5.3" - clean-css "^5.3.0" - cli-table3 "^0.6.2" - combine-promises "^1.1.0" - commander "^5.1.0" - copy-webpack-plugin "^11.0.0" - core-js "^3.23.3" - css-loader "^6.7.1" - css-minimizer-webpack-plugin "^4.0.0" - cssnano "^5.1.12" - del "^6.1.1" - detect-port "^1.3.0" - escape-html "^1.0.3" - eta "^2.0.0" - file-loader "^6.2.0" - fs-extra "^10.1.0" - html-minifier-terser "^6.1.0" - html-tags "^3.2.0" - html-webpack-plugin "^5.5.0" - import-fresh "^3.3.0" - leven "^3.1.0" - lodash "^4.17.21" - mini-css-extract-plugin "^2.6.1" - postcss "^8.4.14" - postcss-loader "^7.0.0" - prompts "^2.4.2" - react-dev-utils "^12.0.1" - react-helmet-async "^1.3.0" - react-loadable "npm:@docusaurus/react-loadable@5.5.2" - react-loadable-ssr-addon-v5-slorber "^1.0.1" - react-router "^5.3.3" - react-router-config "^5.1.1" - react-router-dom "^5.3.3" - rtl-detect "^1.0.4" - semver "^7.3.7" - serve-handler "^6.1.3" - shelljs "^0.8.5" - terser-webpack-plugin "^5.3.3" - tslib "^2.4.0" - update-notifier "^5.1.0" - url-loader "^4.1.1" - wait-on "^6.0.1" - webpack "^5.73.0" - webpack-bundle-analyzer "^4.5.0" - webpack-dev-server "^4.9.3" - webpack-merge "^5.8.0" - webpackbar "^5.0.2" - -"@docusaurus/cssnano-preset@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/cssnano-preset/-/cssnano-preset-2.4.3.tgz#1d7e833c41ce240fcc2812a2ac27f7b862f32de0" - integrity sha512-ZvGSRCi7z9wLnZrXNPG6DmVPHdKGd8dIn9pYbEOFiYihfv4uDR3UtxogmKf+rT8ZlKFf5Lqne8E8nt08zNM8CA== - dependencies: - cssnano-preset-advanced "^5.3.8" - postcss "^8.4.14" - postcss-sort-media-queries "^4.2.1" - tslib "^2.4.0" - -"@docusaurus/logger@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/logger/-/logger-2.4.3.tgz#518bbc965fb4ebe8f1d0b14e5f4161607552d34c" - integrity sha512-Zxws7r3yLufk9xM1zq9ged0YHs65mlRmtsobnFkdZTxWXdTYlWWLWdKyNKAsVC+D7zg+pv2fGbyabdOnyZOM3w== - dependencies: - chalk "^4.1.2" - tslib "^2.4.0" - -"@docusaurus/mdx-loader@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/mdx-loader/-/mdx-loader-2.4.3.tgz#e8ff37f30a060eaa97b8121c135f74cb531a4a3e" - integrity sha512-b1+fDnWtl3GiqkL0BRjYtc94FZrcDDBV1j8446+4tptB9BAOlePwG2p/pK6vGvfL53lkOsszXMghr2g67M0vCw== - dependencies: - "@babel/parser" "^7.18.8" - "@babel/traverse" "^7.18.8" - "@docusaurus/logger" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@mdx-js/mdx" "^1.6.22" - escape-html "^1.0.3" - file-loader "^6.2.0" - fs-extra "^10.1.0" - image-size "^1.0.1" - mdast-util-to-string "^2.0.0" - remark-emoji "^2.2.0" - stringify-object "^3.3.0" - tslib "^2.4.0" - unified "^9.2.2" - unist-util-visit "^2.0.3" - url-loader "^4.1.1" - webpack "^5.73.0" - -"@docusaurus/module-type-aliases@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/module-type-aliases/-/module-type-aliases-2.4.3.tgz#d08ef67e4151e02f352a2836bcf9ecde3b9c56ac" - integrity sha512-cwkBkt1UCiduuvEAo7XZY01dJfRn7UR/75mBgOdb1hKknhrabJZ8YH+7savd/y9kLExPyrhe0QwdS9GuzsRRIA== - dependencies: - "@docusaurus/react-loadable" "5.5.2" - "@docusaurus/types" "2.4.3" - "@types/history" "^4.7.11" - "@types/react" "*" - "@types/react-router-config" "*" - "@types/react-router-dom" "*" - react-helmet-async "*" - react-loadable "npm:@docusaurus/react-loadable@5.5.2" - -"@docusaurus/plugin-content-blog@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-content-blog/-/plugin-content-blog-2.4.3.tgz#6473b974acab98e967414d8bbb0d37e0cedcea14" - integrity sha512-PVhypqaA0t98zVDpOeTqWUTvRqCEjJubtfFUQ7zJNYdbYTbS/E/ytq6zbLVsN/dImvemtO/5JQgjLxsh8XLo8Q== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/logger" "2.4.3" - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-common" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - cheerio "^1.0.0-rc.12" - feed "^4.2.2" - fs-extra "^10.1.0" - lodash "^4.17.21" - reading-time "^1.5.0" - tslib "^2.4.0" - unist-util-visit "^2.0.3" - utility-types "^3.10.0" - webpack "^5.73.0" - -"@docusaurus/plugin-content-docs@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-content-docs/-/plugin-content-docs-2.4.3.tgz#aa224c0512351e81807adf778ca59fd9cd136973" - integrity sha512-N7Po2LSH6UejQhzTCsvuX5NOzlC+HiXOVvofnEPj0WhMu1etpLEXE6a4aTxrtg95lQ5kf0xUIdjX9sh3d3G76A== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/logger" "2.4.3" - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/module-type-aliases" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - "@types/react-router-config" "^5.0.6" - combine-promises "^1.1.0" - fs-extra "^10.1.0" - import-fresh "^3.3.0" - js-yaml "^4.1.0" - lodash "^4.17.21" - tslib "^2.4.0" - utility-types "^3.10.0" - webpack "^5.73.0" - -"@docusaurus/plugin-content-pages@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-content-pages/-/plugin-content-pages-2.4.3.tgz#7f285e718b53da8c8d0101e70840c75b9c0a1ac0" - integrity sha512-txtDVz7y3zGk67q0HjG0gRttVPodkHqE0bpJ+7dOaTH40CQFLSh7+aBeGnPOTl+oCPG+hxkim4SndqPqXjQ8Bg== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - fs-extra "^10.1.0" - tslib "^2.4.0" - webpack "^5.73.0" - -"@docusaurus/plugin-debug@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-debug/-/plugin-debug-2.4.3.tgz#2f90eb0c9286a9f225444e3a88315676fe02c245" - integrity sha512-LkUbuq3zCmINlFb+gAd4ZvYr+bPAzMC0hwND4F7V9bZ852dCX8YoWyovVUBKq4er1XsOwSQaHmNGtObtn8Av8Q== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - fs-extra "^10.1.0" - react-json-view "^1.21.3" - tslib "^2.4.0" - -"@docusaurus/plugin-google-analytics@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-google-analytics/-/plugin-google-analytics-2.4.3.tgz#0d19993136ade6f7a7741251b4f617400d92ab45" - integrity sha512-KzBV3k8lDkWOhg/oYGxlK5o9bOwX7KpPc/FTWoB+SfKhlHfhq7qcQdMi1elAaVEIop8tgK6gD1E58Q+XC6otSQ== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - tslib "^2.4.0" - -"@docusaurus/plugin-google-gtag@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-google-gtag/-/plugin-google-gtag-2.4.3.tgz#e1a80b0696771b488562e5b60eff21c9932d9e1c" - integrity sha512-5FMg0rT7sDy4i9AGsvJC71MQrqQZwgLNdDetLEGDHLfSHLvJhQbTCUGbGXknUgWXQJckcV/AILYeJy+HhxeIFA== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - tslib "^2.4.0" - -"@docusaurus/plugin-google-tag-manager@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-google-tag-manager/-/plugin-google-tag-manager-2.4.3.tgz#e41fbf79b0ffc2de1cc4013eb77798cff0ad98e3" - integrity sha512-1jTzp71yDGuQiX9Bi0pVp3alArV0LSnHXempvQTxwCGAEzUWWaBg4d8pocAlTpbP9aULQQqhgzrs8hgTRPOM0A== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - tslib "^2.4.0" - -"@docusaurus/plugin-sitemap@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/plugin-sitemap/-/plugin-sitemap-2.4.3.tgz#1b3930900a8f89670ce7e8f83fb4730cd3298c32" - integrity sha512-LRQYrK1oH1rNfr4YvWBmRzTL0LN9UAPxBbghgeFRBm5yloF6P+zv1tm2pe2hQTX/QP5bSKdnajCvfnScgKXMZQ== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/logger" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-common" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - fs-extra "^10.1.0" - sitemap "^7.1.1" - tslib "^2.4.0" - -"@docusaurus/preset-classic@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/preset-classic/-/preset-classic-2.4.3.tgz#074c57ebf29fa43d23bd1c8ce691226f542bc262" - integrity sha512-tRyMliepY11Ym6hB1rAFSNGwQDpmszvWYJvlK1E+md4SW8i6ylNHtpZjaYFff9Mdk3i/Pg8ItQq9P0daOJAvQw== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/plugin-content-blog" "2.4.3" - "@docusaurus/plugin-content-docs" "2.4.3" - "@docusaurus/plugin-content-pages" "2.4.3" - "@docusaurus/plugin-debug" "2.4.3" - "@docusaurus/plugin-google-analytics" "2.4.3" - "@docusaurus/plugin-google-gtag" "2.4.3" - "@docusaurus/plugin-google-tag-manager" "2.4.3" - "@docusaurus/plugin-sitemap" "2.4.3" - "@docusaurus/theme-classic" "2.4.3" - "@docusaurus/theme-common" "2.4.3" - "@docusaurus/theme-search-algolia" "2.4.3" - "@docusaurus/types" "2.4.3" - -"@docusaurus/react-loadable@5.5.2", "react-loadable@npm:@docusaurus/react-loadable@5.5.2": - version "5.5.2" - resolved "https://registry.yarnpkg.com/@docusaurus/react-loadable/-/react-loadable-5.5.2.tgz#81aae0db81ecafbdaee3651f12804580868fa6ce" - integrity sha512-A3dYjdBGuy0IGT+wyLIGIKLRE+sAk1iNk0f1HjNDysO7u8lhL4N3VEm+FAubmJbAztn94F7MxBTPmnixbiyFdQ== - dependencies: - "@types/react" "*" - prop-types "^15.6.2" - -"@docusaurus/theme-classic@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/theme-classic/-/theme-classic-2.4.3.tgz#29360f2eb03a0e1686eb19668633ef313970ee8f" - integrity sha512-QKRAJPSGPfDY2yCiPMIVyr+MqwZCIV2lxNzqbyUW0YkrlmdzzP3WuQJPMGLCjWgQp/5c9kpWMvMxjhpZx1R32Q== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/module-type-aliases" "2.4.3" - "@docusaurus/plugin-content-blog" "2.4.3" - "@docusaurus/plugin-content-docs" "2.4.3" - "@docusaurus/plugin-content-pages" "2.4.3" - "@docusaurus/theme-common" "2.4.3" - "@docusaurus/theme-translations" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-common" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - "@mdx-js/react" "^1.6.22" - clsx "^1.2.1" - copy-text-to-clipboard "^3.0.1" - infima "0.2.0-alpha.43" - lodash "^4.17.21" - nprogress "^0.2.0" - postcss "^8.4.14" - prism-react-renderer "^1.3.5" - prismjs "^1.28.0" - react-router-dom "^5.3.3" - rtlcss "^3.5.0" - tslib "^2.4.0" - utility-types "^3.10.0" - -"@docusaurus/theme-common@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/theme-common/-/theme-common-2.4.3.tgz#bb31d70b6b67d0bdef9baa343192dcec49946a2e" - integrity sha512-7KaDJBXKBVGXw5WOVt84FtN8czGWhM0lbyWEZXGp8AFfL6sZQfRTluFp4QriR97qwzSyOfQb+nzcDZZU4tezUw== - dependencies: - "@docusaurus/mdx-loader" "2.4.3" - "@docusaurus/module-type-aliases" "2.4.3" - "@docusaurus/plugin-content-blog" "2.4.3" - "@docusaurus/plugin-content-docs" "2.4.3" - "@docusaurus/plugin-content-pages" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-common" "2.4.3" - "@types/history" "^4.7.11" - "@types/react" "*" - "@types/react-router-config" "*" - clsx "^1.2.1" - parse-numeric-range "^1.3.0" - prism-react-renderer "^1.3.5" - tslib "^2.4.0" - use-sync-external-store "^1.2.0" - utility-types "^3.10.0" - -"@docusaurus/theme-mermaid@^2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/theme-mermaid/-/theme-mermaid-2.4.3.tgz#b40194fb4f46813a18d1350a188d43b68a8192dd" - integrity sha512-S1tZ3xpowtFiTrpTKmvVbRHUYGOlEG5CnPzWlO4huJT1sAwLR+pD6f9DYUlPv2+9NezF3EfUrUyW9xLH0UP58w== - dependencies: - "@docusaurus/core" "2.4.3" - "@docusaurus/module-type-aliases" "2.4.3" - "@docusaurus/theme-common" "2.4.3" - "@docusaurus/types" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - "@mdx-js/react" "^1.6.22" - mermaid "^9.2.2" - tslib "^2.4.0" - -"@docusaurus/theme-search-algolia@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/theme-search-algolia/-/theme-search-algolia-2.4.3.tgz#32d4cbefc3deba4112068fbdb0bde11ac51ece53" - integrity sha512-jziq4f6YVUB5hZOB85ELATwnxBz/RmSLD3ksGQOLDPKVzat4pmI8tddNWtriPpxR04BNT+ZfpPUMFkNFetSW1Q== - dependencies: - "@docsearch/react" "^3.1.1" - "@docusaurus/core" "2.4.3" - "@docusaurus/logger" "2.4.3" - "@docusaurus/plugin-content-docs" "2.4.3" - "@docusaurus/theme-common" "2.4.3" - "@docusaurus/theme-translations" "2.4.3" - "@docusaurus/utils" "2.4.3" - "@docusaurus/utils-validation" "2.4.3" - algoliasearch "^4.13.1" - algoliasearch-helper "^3.10.0" - clsx "^1.2.1" - eta "^2.0.0" - fs-extra "^10.1.0" - lodash "^4.17.21" - tslib "^2.4.0" - utility-types "^3.10.0" - -"@docusaurus/theme-translations@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/theme-translations/-/theme-translations-2.4.3.tgz#91ac73fc49b8c652b7a54e88b679af57d6ac6102" - integrity sha512-H4D+lbZbjbKNS/Zw1Lel64PioUAIT3cLYYJLUf3KkuO/oc9e0QCVhIYVtUI2SfBCF2NNdlyhBDQEEMygsCedIg== - dependencies: - fs-extra "^10.1.0" - tslib "^2.4.0" - -"@docusaurus/types@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/types/-/types-2.4.3.tgz#4aead281ca09f721b3c0a9b926818450cfa3db31" - integrity sha512-W6zNLGQqfrp/EoPD0bhb9n7OobP+RHpmvVzpA+Z/IuU3Q63njJM24hmT0GYboovWcDtFmnIJC9wcyx4RVPQscw== - dependencies: - "@types/history" "^4.7.11" - "@types/react" "*" - commander "^5.1.0" - joi "^17.6.0" - react-helmet-async "^1.3.0" - utility-types "^3.10.0" - webpack "^5.73.0" - webpack-merge "^5.8.0" - -"@docusaurus/utils-common@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/utils-common/-/utils-common-2.4.3.tgz#30656c39ef1ce7e002af7ba39ea08330f58efcfb" - integrity sha512-/jascp4GbLQCPVmcGkPzEQjNaAk3ADVfMtudk49Ggb+131B1WDD6HqlSmDf8MxGdy7Dja2gc+StHf01kiWoTDQ== - dependencies: - tslib "^2.4.0" - -"@docusaurus/utils-validation@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/utils-validation/-/utils-validation-2.4.3.tgz#8122c394feef3e96c73f6433987837ec206a63fb" - integrity sha512-G2+Vt3WR5E/9drAobP+hhZQMaswRwDlp6qOMi7o7ZypB+VO7N//DZWhZEwhcRGepMDJGQEwtPv7UxtYwPL9PBw== - dependencies: - "@docusaurus/logger" "2.4.3" - "@docusaurus/utils" "2.4.3" - joi "^17.6.0" - js-yaml "^4.1.0" - tslib "^2.4.0" - -"@docusaurus/utils@2.4.3": - version "2.4.3" - resolved "https://registry.yarnpkg.com/@docusaurus/utils/-/utils-2.4.3.tgz#52b000d989380a2125831b84e3a7327bef471e89" - integrity sha512-fKcXsjrD86Smxv8Pt0TBFqYieZZCPh4cbf9oszUq/AMhZn3ujwpKaVYZACPX8mmjtYx0JOgNx52CREBfiGQB4A== - dependencies: - "@docusaurus/logger" "2.4.3" - "@svgr/webpack" "^6.2.1" - escape-string-regexp "^4.0.0" - file-loader "^6.2.0" - fs-extra "^10.1.0" - github-slugger "^1.4.0" - globby "^11.1.0" - gray-matter "^4.0.3" - js-yaml "^4.1.0" - lodash "^4.17.21" - micromatch "^4.0.5" - resolve-pathname "^3.0.0" - shelljs "^0.8.5" - tslib "^2.4.0" - url-loader "^4.1.1" - webpack "^5.73.0" - -"@hapi/hoek@^9.0.0": - version "9.3.0" - resolved "https://registry.yarnpkg.com/@hapi/hoek/-/hoek-9.3.0.tgz#8368869dcb735be2e7f5cb7647de78e167a251fb" - integrity sha512-/c6rf4UJlmHlC9b5BaNvzAcFv7HZ2QHaV0D4/HNlBdvFnvQq8RI4kYdhyPCl7Xj+oWvTWQ8ujhqS53LIgAe6KQ== - -"@hapi/topo@^5.0.0": - version "5.1.0" - resolved "https://registry.yarnpkg.com/@hapi/topo/-/topo-5.1.0.tgz#dc448e332c6c6e37a4dc02fd84ba8d44b9afb012" - integrity sha512-foQZKJig7Ob0BMAYBfcJk8d77QtOe7Wo4ox7ff1lQYoNNAb6jwcY1ncdoy2e9wQZzvNy7ODZCYJkK8kzmcAnAg== - dependencies: - "@hapi/hoek" "^9.0.0" - -"@jest/schemas@^29.6.3": - version "29.6.3" - resolved "https://registry.yarnpkg.com/@jest/schemas/-/schemas-29.6.3.tgz#430b5ce8a4e0044a7e3819663305a7b3091c8e03" - integrity sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA== - dependencies: - "@sinclair/typebox" "^0.27.8" - -"@jest/types@^29.6.3": - version "29.6.3" - resolved "https://registry.yarnpkg.com/@jest/types/-/types-29.6.3.tgz#1131f8cf634e7e84c5e77bab12f052af585fba59" - integrity sha512-u3UPsIilWKOM3F9CXtrG8LEJmNxwoCQC/XVj4IKYXvvpx7QIi/Kg1LI5uDmDpKlac62NUtX7eLjRh+jVZcLOzw== - dependencies: - "@jest/schemas" "^29.6.3" - "@types/istanbul-lib-coverage" "^2.0.0" - "@types/istanbul-reports" "^3.0.0" - "@types/node" "*" - "@types/yargs" "^17.0.8" - chalk "^4.0.0" - -"@jridgewell/gen-mapping@^0.3.0", "@jridgewell/gen-mapping@^0.3.2": - version "0.3.3" - resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.3.tgz#7e02e6eb5df901aaedb08514203b096614024098" - integrity sha512-HLhSWOLRi875zjjMG/r+Nv0oCW8umGb0BgEhyX3dDX3egwZtB8PqLnjz3yedt8R5StBrzcg4aBpnh8UA9D1BoQ== - dependencies: - "@jridgewell/set-array" "^1.0.1" - "@jridgewell/sourcemap-codec" "^1.4.10" - "@jridgewell/trace-mapping" "^0.3.9" - -"@jridgewell/resolve-uri@^3.1.0": - version "3.1.1" - resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.1.tgz#c08679063f279615a3326583ba3a90d1d82cc721" - integrity sha512-dSYZh7HhCDtCKm4QakX0xFpsRDqjjtZf/kjI/v3T3Nwt5r8/qz/M19F9ySyOqU94SXBmeG9ttTul+YnR4LOxFA== - -"@jridgewell/set-array@^1.0.1": - version "1.1.2" - resolved "https://registry.yarnpkg.com/@jridgewell/set-array/-/set-array-1.1.2.tgz#7c6cf998d6d20b914c0a55a91ae928ff25965e72" - integrity sha512-xnkseuNADM0gt2bs+BvhO0p78Mk762YnZdsuzFV018NoG1Sj1SCQvpSqa7XUaTam5vAGasABV9qXASMKnFMwMw== - -"@jridgewell/source-map@^0.3.3": - version "0.3.5" - resolved "https://registry.yarnpkg.com/@jridgewell/source-map/-/source-map-0.3.5.tgz#a3bb4d5c6825aab0d281268f47f6ad5853431e91" - integrity sha512-UTYAUj/wviwdsMfzoSJspJxbkH5o1snzwX0//0ENX1u/55kkZZkcTZP6u9bwKGkv+dkk9at4m1Cpt0uY80kcpQ== - dependencies: - "@jridgewell/gen-mapping" "^0.3.0" - "@jridgewell/trace-mapping" "^0.3.9" - -"@jridgewell/sourcemap-codec@^1.4.10", "@jridgewell/sourcemap-codec@^1.4.14": - version "1.4.15" - resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz#d7c6e6755c78567a951e04ab52ef0fd26de59f32" - integrity sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg== - -"@jridgewell/trace-mapping@^0.3.17", "@jridgewell/trace-mapping@^0.3.9": - version "0.3.19" - resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.19.tgz#f8a3249862f91be48d3127c3cfe992f79b4b8811" - integrity sha512-kf37QtfW+Hwx/buWGMPcR60iF9ziHa6r/CZJIHbmcm4+0qrXiVdxegAH0F6yddEVQ7zdkjcGCgCzUu+BcbhQxw== - dependencies: - "@jridgewell/resolve-uri" "^3.1.0" - "@jridgewell/sourcemap-codec" "^1.4.14" - -"@leichtgewicht/ip-codec@^2.0.1": - version "2.0.4" - resolved "https://registry.yarnpkg.com/@leichtgewicht/ip-codec/-/ip-codec-2.0.4.tgz#b2ac626d6cb9c8718ab459166d4bb405b8ffa78b" - integrity sha512-Hcv+nVC0kZnQ3tD9GVu5xSMR4VVYOteQIr/hwFPVEvPdlXqgGEuRjiheChHgdM+JyqdgNcmzZOX/tnl0JOiI7A== - -"@mdx-js/mdx@^1.6.22": - version "1.6.22" - resolved "https://registry.yarnpkg.com/@mdx-js/mdx/-/mdx-1.6.22.tgz#8a723157bf90e78f17dc0f27995398e6c731f1ba" - integrity sha512-AMxuLxPz2j5/6TpF/XSdKpQP1NlG0z11dFOlq+2IP/lSgl11GY8ji6S/rgsViN/L0BDvHvUMruRb7ub+24LUYA== - dependencies: - "@babel/core" "7.12.9" - "@babel/plugin-syntax-jsx" "7.12.1" - "@babel/plugin-syntax-object-rest-spread" "7.8.3" - "@mdx-js/util" "1.6.22" - babel-plugin-apply-mdx-type-prop "1.6.22" - babel-plugin-extract-import-names "1.6.22" - camelcase-css "2.0.1" - detab "2.0.4" - hast-util-raw "6.0.1" - lodash.uniq "4.5.0" - mdast-util-to-hast "10.0.1" - remark-footnotes "2.0.0" - remark-mdx "1.6.22" - remark-parse "8.0.3" - remark-squeeze-paragraphs "4.0.0" - style-to-object "0.3.0" - unified "9.2.0" - unist-builder "2.0.3" - unist-util-visit "2.0.3" - -"@mdx-js/react@^1.6.22": - version "1.6.22" - resolved "https://registry.yarnpkg.com/@mdx-js/react/-/react-1.6.22.tgz#ae09b4744fddc74714ee9f9d6f17a66e77c43573" - integrity sha512-TDoPum4SHdfPiGSAaRBw7ECyI8VaHpK8GJugbJIJuqyh6kzw9ZLJZW3HGL3NNrJGxcAixUvqROm+YuQOo5eXtg== - -"@mdx-js/util@1.6.22": - version "1.6.22" - resolved "https://registry.yarnpkg.com/@mdx-js/util/-/util-1.6.22.tgz#219dfd89ae5b97a8801f015323ffa4b62f45718b" - integrity sha512-H1rQc1ZOHANWBvPcW+JpGwr+juXSxM8Q8YCkm3GhZd8REu1fHR3z99CErO1p9pkcfcxZnMdIZdIsXkOHY0NilA== - -"@nodelib/fs.scandir@2.1.5": - version "2.1.5" - resolved "https://registry.yarnpkg.com/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz#7619c2eb21b25483f6d167548b4cfd5a7488c3d5" - integrity sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g== - dependencies: - "@nodelib/fs.stat" "2.0.5" - run-parallel "^1.1.9" - -"@nodelib/fs.stat@2.0.5", "@nodelib/fs.stat@^2.0.2": - version "2.0.5" - resolved "https://registry.yarnpkg.com/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz#5bd262af94e9d25bd1e71b05deed44876a222e8b" - integrity sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A== - -"@nodelib/fs.walk@^1.2.3": - version "1.2.8" - resolved "https://registry.yarnpkg.com/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz#e95737e8bb6746ddedf69c556953494f196fe69a" - integrity sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg== - dependencies: - "@nodelib/fs.scandir" "2.1.5" - fastq "^1.6.0" - -"@polka/url@^1.0.0-next.20": - version "1.0.0-next.23" - resolved "https://registry.yarnpkg.com/@polka/url/-/url-1.0.0-next.23.tgz#498e41218ab3b6a1419c735e5c6ae2c5ed609b6c" - integrity sha512-C16M+IYz0rgRhWZdCmK+h58JMv8vijAA61gmz2rspCSwKwzBebpdcsiUmwrtJRdphuY30i6BSLEOP8ppbNLyLg== - -"@sideway/address@^4.1.3": - version "4.1.4" - resolved "https://registry.yarnpkg.com/@sideway/address/-/address-4.1.4.tgz#03dccebc6ea47fdc226f7d3d1ad512955d4783f0" - integrity sha512-7vwq+rOHVWjyXxVlR76Agnvhy8I9rpzjosTESvmhNeXOXdZZB15Fl+TI9x1SiHZH5Jv2wTGduSxFDIaq0m3DUw== - dependencies: - "@hapi/hoek" "^9.0.0" - -"@sideway/formula@^3.0.1": - version "3.0.1" - resolved "https://registry.yarnpkg.com/@sideway/formula/-/formula-3.0.1.tgz#80fcbcbaf7ce031e0ef2dd29b1bfc7c3f583611f" - integrity sha512-/poHZJJVjx3L+zVD6g9KgHfYnb443oi7wLu/XKojDviHy6HOEOA6z1Trk5aR1dGcmPenJEgb2sK2I80LeS3MIg== - -"@sideway/pinpoint@^2.0.0": - version "2.0.0" - resolved "https://registry.yarnpkg.com/@sideway/pinpoint/-/pinpoint-2.0.0.tgz#cff8ffadc372ad29fd3f78277aeb29e632cc70df" - integrity sha512-RNiOoTPkptFtSVzQevY/yWtZwf/RxyVnPy/OcA9HBM3MlGDnBEYL5B41H0MTn0Uec8Hi+2qUtTfG2WWZBmMejQ== - -"@sinclair/typebox@^0.27.8": - version "0.27.8" - resolved "https://registry.yarnpkg.com/@sinclair/typebox/-/typebox-0.27.8.tgz#6667fac16c436b5434a387a34dedb013198f6e6e" - integrity sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA== - -"@sindresorhus/is@^0.14.0": - version "0.14.0" - resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-0.14.0.tgz#9fb3a3cf3132328151f353de4632e01e52102bea" - integrity sha512-9NET910DNaIPngYnLLPeg+Ogzqsi9uM4mSboU5y6p8S5DzMTVEsJZrawi+BoDNUVBa2DhJqQYUFvMDfgU062LQ== - -"@slorber/static-site-generator-webpack-plugin@^4.0.7": - version "4.0.7" - resolved "https://registry.yarnpkg.com/@slorber/static-site-generator-webpack-plugin/-/static-site-generator-webpack-plugin-4.0.7.tgz#fc1678bddefab014e2145cbe25b3ce4e1cfc36f3" - integrity sha512-Ug7x6z5lwrz0WqdnNFOMYrDQNTPAprvHLSh6+/fmml3qUiz6l5eq+2MzLKWtn/q5K5NpSiFsZTP/fck/3vjSxA== - dependencies: - eval "^0.1.8" - p-map "^4.0.0" - webpack-sources "^3.2.2" - -"@svgr/babel-plugin-add-jsx-attribute@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-add-jsx-attribute/-/babel-plugin-add-jsx-attribute-6.5.1.tgz#74a5d648bd0347bda99d82409d87b8ca80b9a1ba" - integrity sha512-9PYGcXrAxitycIjRmZB+Q0JaN07GZIWaTBIGQzfaZv+qr1n8X1XUEJ5rZ/vx6OVD9RRYlrNnXWExQXcmZeD/BQ== - -"@svgr/babel-plugin-remove-jsx-attribute@*": - version "8.0.0" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-remove-jsx-attribute/-/babel-plugin-remove-jsx-attribute-8.0.0.tgz#69177f7937233caca3a1afb051906698f2f59186" - integrity sha512-BcCkm/STipKvbCl6b7QFrMh/vx00vIP63k2eM66MfHJzPr6O2U0jYEViXkHJWqXqQYjdeA9cuCl5KWmlwjDvbA== - -"@svgr/babel-plugin-remove-jsx-empty-expression@*": - version "8.0.0" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-remove-jsx-empty-expression/-/babel-plugin-remove-jsx-empty-expression-8.0.0.tgz#c2c48104cfd7dcd557f373b70a56e9e3bdae1d44" - integrity sha512-5BcGCBfBxB5+XSDSWnhTThfI9jcO5f0Ai2V24gZpG+wXF14BzwxxdDb4g6trdOux0rhibGs385BeFMSmxtS3uA== - -"@svgr/babel-plugin-replace-jsx-attribute-value@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-replace-jsx-attribute-value/-/babel-plugin-replace-jsx-attribute-value-6.5.1.tgz#fb9d22ea26d2bc5e0a44b763d4c46d5d3f596c60" - integrity sha512-8DPaVVE3fd5JKuIC29dqyMB54sA6mfgki2H2+swh+zNJoynC8pMPzOkidqHOSc6Wj032fhl8Z0TVn1GiPpAiJg== - -"@svgr/babel-plugin-svg-dynamic-title@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-svg-dynamic-title/-/babel-plugin-svg-dynamic-title-6.5.1.tgz#01b2024a2b53ffaa5efceaa0bf3e1d5a4c520ce4" - integrity sha512-FwOEi0Il72iAzlkaHrlemVurgSQRDFbk0OC8dSvD5fSBPHltNh7JtLsxmZUhjYBZo2PpcU/RJvvi6Q0l7O7ogw== - -"@svgr/babel-plugin-svg-em-dimensions@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-svg-em-dimensions/-/babel-plugin-svg-em-dimensions-6.5.1.tgz#dd3fa9f5b24eb4f93bcf121c3d40ff5facecb217" - integrity sha512-gWGsiwjb4tw+ITOJ86ndY/DZZ6cuXMNE/SjcDRg+HLuCmwpcjOktwRF9WgAiycTqJD/QXqL2f8IzE2Rzh7aVXA== - -"@svgr/babel-plugin-transform-react-native-svg@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-transform-react-native-svg/-/babel-plugin-transform-react-native-svg-6.5.1.tgz#1d8e945a03df65b601551097d8f5e34351d3d305" - integrity sha512-2jT3nTayyYP7kI6aGutkyfJ7UMGtuguD72OjeGLwVNyfPRBD8zQthlvL+fAbAKk5n9ZNcvFkp/b1lZ7VsYqVJg== - -"@svgr/babel-plugin-transform-svg-component@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-plugin-transform-svg-component/-/babel-plugin-transform-svg-component-6.5.1.tgz#48620b9e590e25ff95a80f811544218d27f8a250" - integrity sha512-a1p6LF5Jt33O3rZoVRBqdxL350oge54iZWHNI6LJB5tQ7EelvD/Mb1mfBiZNAan0dt4i3VArkFRjA4iObuNykQ== - -"@svgr/babel-preset@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/babel-preset/-/babel-preset-6.5.1.tgz#b90de7979c8843c5c580c7e2ec71f024b49eb828" - integrity sha512-6127fvO/FF2oi5EzSQOAjo1LE3OtNVh11R+/8FXa+mHx1ptAaS4cknIjnUA7e6j6fwGGJ17NzaTJFUwOV2zwCw== - dependencies: - "@svgr/babel-plugin-add-jsx-attribute" "^6.5.1" - "@svgr/babel-plugin-remove-jsx-attribute" "*" - "@svgr/babel-plugin-remove-jsx-empty-expression" "*" - "@svgr/babel-plugin-replace-jsx-attribute-value" "^6.5.1" - "@svgr/babel-plugin-svg-dynamic-title" "^6.5.1" - "@svgr/babel-plugin-svg-em-dimensions" "^6.5.1" - "@svgr/babel-plugin-transform-react-native-svg" "^6.5.1" - "@svgr/babel-plugin-transform-svg-component" "^6.5.1" - -"@svgr/core@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/core/-/core-6.5.1.tgz#d3e8aa9dbe3fbd747f9ee4282c1c77a27410488a" - integrity sha512-/xdLSWxK5QkqG524ONSjvg3V/FkNyCv538OIBdQqPNaAta3AsXj/Bd2FbvR87yMbXO2hFSWiAe/Q6IkVPDw+mw== - dependencies: - "@babel/core" "^7.19.6" - "@svgr/babel-preset" "^6.5.1" - "@svgr/plugin-jsx" "^6.5.1" - camelcase "^6.2.0" - cosmiconfig "^7.0.1" - -"@svgr/hast-util-to-babel-ast@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/hast-util-to-babel-ast/-/hast-util-to-babel-ast-6.5.1.tgz#81800bd09b5bcdb968bf6ee7c863d2288fdb80d2" - integrity sha512-1hnUxxjd83EAxbL4a0JDJoD3Dao3hmjvyvyEV8PzWmLK3B9m9NPlW7GKjFyoWE8nM7HnXzPcmmSyOW8yOddSXw== - dependencies: - "@babel/types" "^7.20.0" - entities "^4.4.0" - -"@svgr/plugin-jsx@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/plugin-jsx/-/plugin-jsx-6.5.1.tgz#0e30d1878e771ca753c94e69581c7971542a7072" - integrity sha512-+UdQxI3jgtSjCykNSlEMuy1jSRQlGC7pqBCPvkG/2dATdWo082zHTTK3uhnAju2/6XpE6B5mZ3z4Z8Ns01S8Gw== - dependencies: - "@babel/core" "^7.19.6" - "@svgr/babel-preset" "^6.5.1" - "@svgr/hast-util-to-babel-ast" "^6.5.1" - svg-parser "^2.0.4" - -"@svgr/plugin-svgo@^6.5.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/plugin-svgo/-/plugin-svgo-6.5.1.tgz#0f91910e988fc0b842f88e0960c2862e022abe84" - integrity sha512-omvZKf8ixP9z6GWgwbtmP9qQMPX4ODXi+wzbVZgomNFsUIlHA1sf4fThdwTWSsZGgvGAG6yE+b/F5gWUkcZ/iQ== - dependencies: - cosmiconfig "^7.0.1" - deepmerge "^4.2.2" - svgo "^2.8.0" - -"@svgr/webpack@^6.2.1": - version "6.5.1" - resolved "https://registry.yarnpkg.com/@svgr/webpack/-/webpack-6.5.1.tgz#ecf027814fc1cb2decc29dc92f39c3cf691e40e8" - integrity sha512-cQ/AsnBkXPkEK8cLbv4Dm7JGXq2XrumKnL1dRpJD9rIO2fTIlJI9a1uCciYG1F2aUsox/hJQyNGbt3soDxSRkA== - dependencies: - "@babel/core" "^7.19.6" - "@babel/plugin-transform-react-constant-elements" "^7.18.12" - "@babel/preset-env" "^7.19.4" - "@babel/preset-react" "^7.18.6" - "@babel/preset-typescript" "^7.18.6" - "@svgr/core" "^6.5.1" - "@svgr/plugin-jsx" "^6.5.1" - "@svgr/plugin-svgo" "^6.5.1" - -"@szmarczak/http-timer@^1.1.2": - version "1.1.2" - resolved "https://registry.yarnpkg.com/@szmarczak/http-timer/-/http-timer-1.1.2.tgz#b1665e2c461a2cd92f4c1bbf50d5454de0d4b421" - integrity sha512-XIB2XbzHTN6ieIjfIMV9hlVcfPU26s2vafYWQcZHWXHOxiaRZYEDKEwdl129Zyg50+foYV2jCgtrqSA6qNuNSA== - dependencies: - defer-to-connect "^1.0.1" - -"@trysound/sax@0.2.0": - version "0.2.0" - resolved "https://registry.yarnpkg.com/@trysound/sax/-/sax-0.2.0.tgz#cccaab758af56761eb7bf37af6f03f326dd798ad" - integrity sha512-L7z9BgrNEcYyUYtF+HaEfiS5ebkh9jXqbszz7pC0hRBPaatV0XjSD3+eHrpqFemQfgwiFF0QPIarnIihIDn7OA== - -"@tsconfig/docusaurus@^1.0.5": - version "1.0.7" - resolved "https://registry.yarnpkg.com/@tsconfig/docusaurus/-/docusaurus-1.0.7.tgz#a3ee3c8109b3fec091e3d61a61834e563aeee3c3" - integrity sha512-ffTXxGIP/IRMCjuzHd6M4/HdIrw1bMfC7Bv8hMkTadnePkpe0lG0oDSdbRpSDZb2rQMAgpbWiR10BvxvNYwYrg== - -"@types/body-parser@*": - version "1.19.3" - resolved "https://registry.yarnpkg.com/@types/body-parser/-/body-parser-1.19.3.tgz#fb558014374f7d9e56c8f34bab2042a3a07d25cd" - integrity sha512-oyl4jvAfTGX9Bt6Or4H9ni1Z447/tQuxnZsytsCaExKlmJiU8sFgnIBRzJUpKwB5eWn9HuBYlUlVA74q/yN0eQ== - dependencies: - "@types/connect" "*" - "@types/node" "*" - -"@types/bonjour@^3.5.9": - version "3.5.11" - resolved "https://registry.yarnpkg.com/@types/bonjour/-/bonjour-3.5.11.tgz#fbaa46a1529ea5c5e46cde36e4be6a880db55b84" - integrity sha512-isGhjmBtLIxdHBDl2xGwUzEM8AOyOvWsADWq7rqirdi/ZQoHnLWErHvsThcEzTX8juDRiZtzp2Qkv5bgNh6mAg== - dependencies: - "@types/node" "*" - -"@types/connect-history-api-fallback@^1.3.5": - version "1.5.1" - resolved "https://registry.yarnpkg.com/@types/connect-history-api-fallback/-/connect-history-api-fallback-1.5.1.tgz#6e5e3602d93bda975cebc3449e1a318340af9e20" - integrity sha512-iaQslNbARe8fctL5Lk+DsmgWOM83lM+7FzP0eQUJs1jd3kBE8NWqBTIT2S8SqQOJjxvt2eyIjpOuYeRXq2AdMw== - dependencies: - "@types/express-serve-static-core" "*" - "@types/node" "*" - -"@types/connect@*": - version "3.4.36" - resolved "https://registry.yarnpkg.com/@types/connect/-/connect-3.4.36.tgz#e511558c15a39cb29bd5357eebb57bd1459cd1ab" - integrity sha512-P63Zd/JUGq+PdrM1lv0Wv5SBYeA2+CORvbrXbngriYY0jzLUWfQMQQxOhjONEz/wlHOAxOdY7CY65rgQdTjq2w== - dependencies: - "@types/node" "*" - -"@types/eslint-scope@^3.7.3": - version "3.7.5" - resolved "https://registry.yarnpkg.com/@types/eslint-scope/-/eslint-scope-3.7.5.tgz#e28b09dbb1d9d35fdfa8a884225f00440dfc5a3e" - integrity sha512-JNvhIEyxVW6EoMIFIvj93ZOywYFatlpu9deeH6eSx6PE3WHYvHaQtmHmQeNw7aA81bYGBPPQqdtBm6b1SsQMmA== - dependencies: - "@types/eslint" "*" - "@types/estree" "*" - -"@types/eslint@*": - version "8.44.4" - resolved "https://registry.yarnpkg.com/@types/eslint/-/eslint-8.44.4.tgz#28eaff82e1ca0a96554ec5bb0188f10ae1a74c2f" - integrity sha512-lOzjyfY/D9QR4hY9oblZ76B90MYTB3RrQ4z2vBIJKj9ROCRqdkYl2gSUx1x1a4IWPjKJZLL4Aw1Zfay7eMnmnA== - dependencies: - "@types/estree" "*" - "@types/json-schema" "*" - -"@types/estree@*", "@types/estree@^1.0.0": - version "1.0.2" - resolved "https://registry.yarnpkg.com/@types/estree/-/estree-1.0.2.tgz#ff02bc3dc8317cd668dfec247b750ba1f1d62453" - integrity sha512-VeiPZ9MMwXjO32/Xu7+OwflfmeoRwkE/qzndw42gGtgJwZopBnzy2gD//NN1+go1mADzkDcqf/KnFRSjTJ8xJA== - -"@types/express-serve-static-core@*", "@types/express-serve-static-core@^4.17.33": - version "4.17.37" - resolved "https://registry.yarnpkg.com/@types/express-serve-static-core/-/express-serve-static-core-4.17.37.tgz#7e4b7b59da9142138a2aaa7621f5abedce8c7320" - integrity sha512-ZohaCYTgGFcOP7u6aJOhY9uIZQgZ2vxC2yWoArY+FeDXlqeH66ZVBjgvg+RLVAS/DWNq4Ap9ZXu1+SUQiiWYMg== - dependencies: - "@types/node" "*" - "@types/qs" "*" - "@types/range-parser" "*" - "@types/send" "*" - -"@types/express@*", "@types/express@^4.17.13": - version "4.17.19" - resolved "https://registry.yarnpkg.com/@types/express/-/express-4.17.19.tgz#6ff9b4851fda132c5d3dcd2f89fdb6a7a0031ced" - integrity sha512-UtOfBtzN9OvpZPPbnnYunfjM7XCI4jyk1NvnFhTVz5krYAnW4o5DCoIekvms+8ApqhB4+9wSge1kBijdfTSmfg== - dependencies: - "@types/body-parser" "*" - "@types/express-serve-static-core" "^4.17.33" - "@types/qs" "*" - "@types/serve-static" "*" - -"@types/hast@^2.0.0": - version "2.3.6" - resolved "https://registry.yarnpkg.com/@types/hast/-/hast-2.3.6.tgz#bb8b05602112a26d22868acb70c4b20984ec7086" - integrity sha512-47rJE80oqPmFdVDCD7IheXBrVdwuBgsYwoczFvKmwfo2Mzsnt+V9OONsYauFmICb6lQPpCuXYJWejBNs4pDJRg== - dependencies: - "@types/unist" "^2" - -"@types/history@^4.7.11": - version "4.7.11" - resolved "https://registry.yarnpkg.com/@types/history/-/history-4.7.11.tgz#56588b17ae8f50c53983a524fc3cc47437969d64" - integrity sha512-qjDJRrmvBMiTx+jyLxvLfJU7UznFuokDv4f3WRuriHKERccVpFU+8XMQUAbDzoiJCsmexxRExQeMwwCdamSKDA== - -"@types/html-minifier-terser@^6.0.0": - version "6.1.0" - resolved "https://registry.yarnpkg.com/@types/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz#4fc33a00c1d0c16987b1a20cf92d20614c55ac35" - integrity sha512-oh/6byDPnL1zeNXFrDXFLyZjkr1MsBG667IM792caf1L2UPOOMf65NFzjUH/ltyfwjAGfs1rsX1eftK0jC/KIg== - -"@types/http-errors@*": - version "2.0.2" - resolved "https://registry.yarnpkg.com/@types/http-errors/-/http-errors-2.0.2.tgz#a86e00bbde8950364f8e7846687259ffcd96e8c2" - integrity sha512-lPG6KlZs88gef6aD85z3HNkztpj7w2R7HmR3gygjfXCQmsLloWNARFkMuzKiiY8FGdh1XDpgBdrSf4aKDiA7Kg== - -"@types/http-proxy@^1.17.8": - version "1.17.12" - resolved "https://registry.yarnpkg.com/@types/http-proxy/-/http-proxy-1.17.12.tgz#86e849e9eeae0362548803c37a0a1afc616bd96b" - integrity sha512-kQtujO08dVtQ2wXAuSFfk9ASy3sug4+ogFR8Kd8UgP8PEuc1/G/8yjYRmp//PcDNJEUKOza/MrQu15bouEUCiw== - dependencies: - "@types/node" "*" - -"@types/istanbul-lib-coverage@*", "@types/istanbul-lib-coverage@^2.0.0": - version "2.0.4" - resolved "https://registry.yarnpkg.com/@types/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.4.tgz#8467d4b3c087805d63580480890791277ce35c44" - integrity sha512-z/QT1XN4K4KYuslS23k62yDIDLwLFkzxOuMplDtObz0+y7VqJCaO2o+SPwHCvLFZh7xazvvoor2tA/hPz9ee7g== - -"@types/istanbul-lib-report@*": - version "3.0.1" - resolved "https://registry.yarnpkg.com/@types/istanbul-lib-report/-/istanbul-lib-report-3.0.1.tgz#412e0725ef41cde73bfa03e0e833eaff41e0fd63" - integrity sha512-gPQuzaPR5h/djlAv2apEG1HVOyj1IUs7GpfMZixU0/0KXT3pm64ylHuMUI1/Akh+sq/iikxg6Z2j+fcMDXaaTQ== - dependencies: - "@types/istanbul-lib-coverage" "*" - -"@types/istanbul-reports@^3.0.0": - version "3.0.2" - resolved "https://registry.yarnpkg.com/@types/istanbul-reports/-/istanbul-reports-3.0.2.tgz#edc8e421991a3b4df875036d381fc0a5a982f549" - integrity sha512-kv43F9eb3Lhj+lr/Hn6OcLCs/sSM8bt+fIaP11rCYngfV6NVjzWXJ17owQtDQTL9tQ8WSLUrGsSJ6rJz0F1w1A== - dependencies: - "@types/istanbul-lib-report" "*" - -"@types/json-schema@*", "@types/json-schema@^7.0.4", "@types/json-schema@^7.0.5", "@types/json-schema@^7.0.8", "@types/json-schema@^7.0.9": - version "7.0.13" - resolved "https://registry.yarnpkg.com/@types/json-schema/-/json-schema-7.0.13.tgz#02c24f4363176d2d18fc8b70b9f3c54aba178a85" - integrity sha512-RbSSoHliUbnXj3ny0CNFOoxrIDV6SUGyStHsvDqosw6CkdPV8TtWGlfecuK4ToyMEAql6pzNxgCFKanovUzlgQ== - -"@types/katex@^0.11.0": - version "0.11.1" - resolved "https://registry.yarnpkg.com/@types/katex/-/katex-0.11.1.tgz#34de04477dcf79e2ef6c8d23b41a3d81f9ebeaf5" - integrity sha512-DUlIj2nk0YnJdlWgsFuVKcX27MLW0KbKmGVoUHmFr+74FYYNUDAaj9ZqTADvsbE8rfxuVmSFc7KczYn5Y09ozg== - -"@types/mdast@^3.0.0": - version "3.0.13" - resolved "https://registry.yarnpkg.com/@types/mdast/-/mdast-3.0.13.tgz#b7ba6e52d0faeb9c493e32c205f3831022be4e1b" - integrity sha512-HjiGiWedR0DVFkeNljpa6Lv4/IZU1+30VY5d747K7lBudFc3R0Ibr6yJ9lN3BE28VnZyDfLF/VB1Ql1ZIbKrmg== - dependencies: - "@types/unist" "^2" - -"@types/mime@*": - version "3.0.2" - resolved "https://registry.yarnpkg.com/@types/mime/-/mime-3.0.2.tgz#c1ae807f13d308ee7511a5b81c74f327028e66e8" - integrity sha512-Wj+fqpTLtTbG7c0tH47dkahefpLKEbB+xAZuLq7b4/IDHPl/n6VoXcyUQ2bypFlbSwvCr0y+bD4euTTqTJsPxQ== - -"@types/mime@^1": - version "1.3.3" - resolved "https://registry.yarnpkg.com/@types/mime/-/mime-1.3.3.tgz#bbe64987e0eb05de150c305005055c7ad784a9ce" - integrity sha512-Ys+/St+2VF4+xuY6+kDIXGxbNRO0mesVg0bbxEfB97Od1Vjpjx9KD1qxs64Gcb3CWPirk9Xe+PT4YiiHQ9T+eg== - -"@types/node@*": - version "20.8.4" - resolved "https://registry.yarnpkg.com/@types/node/-/node-20.8.4.tgz#0e9ebb2ff29d5c3302fc84477d066fa7c6b441aa" - integrity sha512-ZVPnqU58giiCjSxjVUESDtdPk4QR5WQhhINbc9UBrKLU68MX5BF6kbQzTrkwbolyr0X8ChBpXfavr5mZFKZQ5A== - dependencies: - undici-types "~5.25.1" - -"@types/node@^17.0.5": - version "17.0.45" - resolved "https://registry.yarnpkg.com/@types/node/-/node-17.0.45.tgz#2c0fafd78705e7a18b7906b5201a522719dc5190" - integrity sha512-w+tIMs3rq2afQdsPJlODhoUEKzFP1ayaoyl1CcnwtIlsVe7K7bA1NGm4s3PraqTLlXnbIN84zuBlxBWo1u9BLw== - -"@types/parse-json@^4.0.0": - version "4.0.0" - resolved "https://registry.yarnpkg.com/@types/parse-json/-/parse-json-4.0.0.tgz#2f8bb441434d163b35fb8ffdccd7138927ffb8c0" - integrity sha512-//oorEZjL6sbPcKUaCdIGlIUeH26mgzimjBB77G6XRgnDl/L5wOnpyBGRe/Mmf5CVW3PwEBE1NjiMZ/ssFh4wA== - -"@types/parse5@^5.0.0": - version "5.0.3" - resolved "https://registry.yarnpkg.com/@types/parse5/-/parse5-5.0.3.tgz#e7b5aebbac150f8b5fdd4a46e7f0bd8e65e19109" - integrity sha512-kUNnecmtkunAoQ3CnjmMkzNU/gtxG8guhi+Fk2U/kOpIKjIMKnXGp4IJCgQJrXSgMsWYimYG4TGjz/UzbGEBTw== - -"@types/prop-types@*": - version "15.7.8" - resolved "https://registry.yarnpkg.com/@types/prop-types/-/prop-types-15.7.8.tgz#805eae6e8f41bd19e88917d2ea200dc992f405d3" - integrity sha512-kMpQpfZKSCBqltAJwskgePRaYRFukDkm1oItcAbC3gNELR20XIBcN9VRgg4+m8DKsTfkWeA4m4Imp4DDuWy7FQ== - -"@types/qs@*": - version "6.9.8" - resolved "https://registry.yarnpkg.com/@types/qs/-/qs-6.9.8.tgz#f2a7de3c107b89b441e071d5472e6b726b4adf45" - integrity sha512-u95svzDlTysU5xecFNTgfFG5RUWu1A9P0VzgpcIiGZA9iraHOdSzcxMxQ55DyeRaGCSxQi7LxXDI4rzq/MYfdg== - -"@types/range-parser@*": - version "1.2.5" - resolved "https://registry.yarnpkg.com/@types/range-parser/-/range-parser-1.2.5.tgz#38bd1733ae299620771bd414837ade2e57757498" - integrity sha512-xrO9OoVPqFuYyR/loIHjnbvvyRZREYKLjxV4+dY6v3FQR3stQ9ZxIGkaclF7YhI9hfjpuTbu14hZEy94qKLtOA== - -"@types/react-router-config@*", "@types/react-router-config@^5.0.6": - version "5.0.8" - resolved "https://registry.yarnpkg.com/@types/react-router-config/-/react-router-config-5.0.8.tgz#dd00654de4d79927570a4a8807c4a728feed59f3" - integrity sha512-zBzYZsr05V9xRG96oQ/xBXHy5+fDCX5wL7bboM0FFoOYQp9Gxmz8uvuKSkLesNWHlICl+W1l64F7fmp/KsOkuw== - dependencies: - "@types/history" "^4.7.11" - "@types/react" "*" - "@types/react-router" "^5.1.0" - -"@types/react-router-dom@*": - version "5.3.3" - resolved "https://registry.yarnpkg.com/@types/react-router-dom/-/react-router-dom-5.3.3.tgz#e9d6b4a66fcdbd651a5f106c2656a30088cc1e83" - integrity sha512-kpqnYK4wcdm5UaWI3fLcELopqLrHgLqNsdpHauzlQktfkHL3npOSwtj1Uz9oKBAzs7lFtVkV8j83voAz2D8fhw== - dependencies: - "@types/history" "^4.7.11" - "@types/react" "*" - "@types/react-router" "*" - -"@types/react-router@*", "@types/react-router@^5.1.0": - version "5.1.20" - resolved "https://registry.yarnpkg.com/@types/react-router/-/react-router-5.1.20.tgz#88eccaa122a82405ef3efbcaaa5dcdd9f021387c" - integrity sha512-jGjmu/ZqS7FjSH6owMcD5qpq19+1RS9DeVRqfl1FeBMxTDQAGwlMWOcs52NDoXaNKyG3d1cYQFMs9rCrb88o9Q== - dependencies: - "@types/history" "^4.7.11" - "@types/react" "*" - -"@types/react@*": - version "18.2.27" - resolved "https://registry.yarnpkg.com/@types/react/-/react-18.2.27.tgz#746e52b06f3ccd5d7a724fd53769b70792601440" - integrity sha512-Wfv7B7FZiR2r3MIqbAlXoY1+tXm4bOqfz4oRr+nyXdBqapDBZ0l/IGcSlAfvxIHEEJjkPU0MYAc/BlFPOcrgLw== - dependencies: - "@types/prop-types" "*" - "@types/scheduler" "*" - csstype "^3.0.2" - -"@types/retry@0.12.0": - version "0.12.0" - resolved "https://registry.yarnpkg.com/@types/retry/-/retry-0.12.0.tgz#2b35eccfcee7d38cd72ad99232fbd58bffb3c84d" - integrity sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA== - -"@types/sax@^1.2.1": - version "1.2.5" - resolved "https://registry.yarnpkg.com/@types/sax/-/sax-1.2.5.tgz#4392799e1770d24b6dc8d0c66c8882f8e1c38b3d" - integrity sha512-9jWta97bBVC027/MShr3gLab8gPhKy4l6qpb+UJLF5pDm3501NvA7uvqVCW+REFtx00oTi6Cq9JzLwgq6evVgw== - dependencies: - "@types/node" "*" - -"@types/scheduler@*": - version "0.16.4" - resolved "https://registry.yarnpkg.com/@types/scheduler/-/scheduler-0.16.4.tgz#fedc3e5b15c26dc18faae96bf1317487cb3658cf" - integrity sha512-2L9ifAGl7wmXwP4v3pN4p2FLhD0O1qsJpvKmNin5VA8+UvNVb447UDaAEV6UdrkA+m/Xs58U1RFps44x6TFsVQ== - -"@types/send@*": - version "0.17.2" - resolved "https://registry.yarnpkg.com/@types/send/-/send-0.17.2.tgz#af78a4495e3c2b79bfbdac3955fdd50e03cc98f2" - integrity sha512-aAG6yRf6r0wQ29bkS+x97BIs64ZLxeE/ARwyS6wrldMm3C1MdKwCcnnEwMC1slI8wuxJOpiUH9MioC0A0i+GJw== - dependencies: - "@types/mime" "^1" - "@types/node" "*" - -"@types/serve-index@^1.9.1": - version "1.9.2" - resolved "https://registry.yarnpkg.com/@types/serve-index/-/serve-index-1.9.2.tgz#cb26e775678a8526b73a5d980a147518740aaecd" - integrity sha512-asaEIoc6J+DbBKXtO7p2shWUpKacZOoMBEGBgPG91P8xhO53ohzHWGCs4ScZo5pQMf5ukQzVT9fhX1WzpHihig== - dependencies: - "@types/express" "*" - -"@types/serve-static@*", "@types/serve-static@^1.13.10": - version "1.15.3" - resolved "https://registry.yarnpkg.com/@types/serve-static/-/serve-static-1.15.3.tgz#2cfacfd1fd4520bbc3e292cca432d5e8e2e3ee61" - integrity sha512-yVRvFsEMrv7s0lGhzrggJjNOSmZCdgCjw9xWrPr/kNNLp6FaDfMC1KaYl3TSJ0c58bECwNBMoQrZJ8hA8E1eFg== - dependencies: - "@types/http-errors" "*" - "@types/mime" "*" - "@types/node" "*" - -"@types/sockjs@^0.3.33": - version "0.3.34" - resolved "https://registry.yarnpkg.com/@types/sockjs/-/sockjs-0.3.34.tgz#43e10e549b36d2ba2589278f00f81b5d7ccda167" - integrity sha512-R+n7qBFnm/6jinlteC9DBL5dGiDGjWAvjo4viUanpnc/dG1y7uDoacXPIQ/PQEg1fI912SMHIa014ZjRpvDw4g== - dependencies: - "@types/node" "*" - -"@types/unist@^2", "@types/unist@^2.0.0", "@types/unist@^2.0.2", "@types/unist@^2.0.3": - version "2.0.8" - resolved "https://registry.yarnpkg.com/@types/unist/-/unist-2.0.8.tgz#bb197b9639aa1a04cf464a617fe800cccd92ad5c" - integrity sha512-d0XxK3YTObnWVp6rZuev3c49+j4Lo8g4L1ZRm9z5L0xpoZycUPshHgczK5gsUMaZOstjVYYi09p5gYvUtfChYw== - -"@types/ws@^8.5.5": - version "8.5.6" - resolved "https://registry.yarnpkg.com/@types/ws/-/ws-8.5.6.tgz#e9ad51f0ab79b9110c50916c9fcbddc36d373065" - integrity sha512-8B5EO9jLVCy+B58PLHvLDuOD8DRVMgQzq8d55SjLCOn9kqGyqOvy27exVaTio1q1nX5zLu8/6N0n2ThSxOM6tg== - dependencies: - "@types/node" "*" - -"@types/yargs-parser@*": - version "21.0.1" - resolved "https://registry.yarnpkg.com/@types/yargs-parser/-/yargs-parser-21.0.1.tgz#07773d7160494d56aa882d7531aac7319ea67c3b" - integrity sha512-axdPBuLuEJt0c4yI5OZssC19K2Mq1uKdrfZBzuxLvaztgqUtFYZUNw7lETExPYJR9jdEoIg4mb7RQKRQzOkeGQ== - -"@types/yargs@^17.0.8": - version "17.0.28" - resolved "https://registry.yarnpkg.com/@types/yargs/-/yargs-17.0.28.tgz#d106e4301fbacde3d1796ab27374dd16588ec851" - integrity sha512-N3e3fkS86hNhtk6BEnc0rj3zcehaxx8QWhCROJkqpl5Zaoi7nAic3jH8q94jVD3zu5LGk+PUB6KAiDmimYOEQw== - dependencies: - "@types/yargs-parser" "*" - -"@webassemblyjs/ast@1.11.6", "@webassemblyjs/ast@^1.11.5": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/ast/-/ast-1.11.6.tgz#db046555d3c413f8966ca50a95176a0e2c642e24" - integrity sha512-IN1xI7PwOvLPgjcf180gC1bqn3q/QaOCwYUahIOhbYUu8KA/3tw2RT/T0Gidi1l7Hhj5D/INhJxiICObqpMu4Q== - dependencies: - "@webassemblyjs/helper-numbers" "1.11.6" - "@webassemblyjs/helper-wasm-bytecode" "1.11.6" - -"@webassemblyjs/floating-point-hex-parser@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.11.6.tgz#dacbcb95aff135c8260f77fa3b4c5fea600a6431" - integrity sha512-ejAj9hfRJ2XMsNHk/v6Fu2dGS+i4UaXBXGemOfQ/JfQ6mdQg/WXtwleQRLLS4OvfDhv8rYnVwH27YJLMyYsxhw== - -"@webassemblyjs/helper-api-error@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/helper-api-error/-/helper-api-error-1.11.6.tgz#6132f68c4acd59dcd141c44b18cbebbd9f2fa768" - integrity sha512-o0YkoP4pVu4rN8aTJgAyj9hC2Sv5UlkzCHhxqWj8butaLvnpdc2jOwh4ewE6CX0txSfLn/UYaV/pheS2Txg//Q== - -"@webassemblyjs/helper-buffer@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/helper-buffer/-/helper-buffer-1.11.6.tgz#b66d73c43e296fd5e88006f18524feb0f2c7c093" - integrity sha512-z3nFzdcp1mb8nEOFFk8DrYLpHvhKC3grJD2ardfKOzmbmJvEf/tPIqCY+sNcwZIY8ZD7IkB2l7/pqhUhqm7hLA== - -"@webassemblyjs/helper-numbers@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/helper-numbers/-/helper-numbers-1.11.6.tgz#cbce5e7e0c1bd32cf4905ae444ef64cea919f1b5" - integrity sha512-vUIhZ8LZoIWHBohiEObxVm6hwP034jwmc9kuq5GdHZH0wiLVLIPcMCdpJzG4C11cHoQ25TFIQj9kaVADVX7N3g== - dependencies: - "@webassemblyjs/floating-point-hex-parser" "1.11.6" - "@webassemblyjs/helper-api-error" "1.11.6" - "@xtuc/long" "4.2.2" - -"@webassemblyjs/helper-wasm-bytecode@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.11.6.tgz#bb2ebdb3b83aa26d9baad4c46d4315283acd51e9" - integrity sha512-sFFHKwcmBprO9e7Icf0+gddyWYDViL8bpPjJJl0WHxCdETktXdmtWLGVzoHbqUcY4Be1LkNfwTmXOJUFZYSJdA== - -"@webassemblyjs/helper-wasm-section@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.11.6.tgz#ff97f3863c55ee7f580fd5c41a381e9def4aa577" - integrity sha512-LPpZbSOwTpEC2cgn4hTydySy1Ke+XEu+ETXuoyvuyezHO3Kjdu90KK95Sh9xTbmjrCsUwvWwCOQQNta37VrS9g== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@webassemblyjs/helper-buffer" "1.11.6" - "@webassemblyjs/helper-wasm-bytecode" "1.11.6" - "@webassemblyjs/wasm-gen" "1.11.6" - -"@webassemblyjs/ieee754@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/ieee754/-/ieee754-1.11.6.tgz#bb665c91d0b14fffceb0e38298c329af043c6e3a" - integrity sha512-LM4p2csPNvbij6U1f19v6WR56QZ8JcHg3QIJTlSwzFcmx6WSORicYj6I63f9yU1kEUtrpG+kjkiIAkevHpDXrg== - dependencies: - "@xtuc/ieee754" "^1.2.0" - -"@webassemblyjs/leb128@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/leb128/-/leb128-1.11.6.tgz#70e60e5e82f9ac81118bc25381a0b283893240d7" - integrity sha512-m7a0FhE67DQXgouf1tbN5XQcdWoNgaAuoULHIfGFIEVKA6tu/edls6XnIlkmS6FrXAquJRPni3ZZKjw6FSPjPQ== - dependencies: - "@xtuc/long" "4.2.2" - -"@webassemblyjs/utf8@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/utf8/-/utf8-1.11.6.tgz#90f8bc34c561595fe156603be7253cdbcd0fab5a" - integrity sha512-vtXf2wTQ3+up9Zsg8sa2yWiQpzSsMyXj0qViVP6xKGCUT8p8YJ6HqI7l5eCnWx1T/FYdsv07HQs2wTFbbof/RA== - -"@webassemblyjs/wasm-edit@^1.11.5": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/wasm-edit/-/wasm-edit-1.11.6.tgz#c72fa8220524c9b416249f3d94c2958dfe70ceab" - integrity sha512-Ybn2I6fnfIGuCR+Faaz7YcvtBKxvoLV3Lebn1tM4o/IAJzmi9AWYIPWpyBfU8cC+JxAO57bk4+zdsTjJR+VTOw== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@webassemblyjs/helper-buffer" "1.11.6" - "@webassemblyjs/helper-wasm-bytecode" "1.11.6" - "@webassemblyjs/helper-wasm-section" "1.11.6" - "@webassemblyjs/wasm-gen" "1.11.6" - "@webassemblyjs/wasm-opt" "1.11.6" - "@webassemblyjs/wasm-parser" "1.11.6" - "@webassemblyjs/wast-printer" "1.11.6" - -"@webassemblyjs/wasm-gen@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/wasm-gen/-/wasm-gen-1.11.6.tgz#fb5283e0e8b4551cc4e9c3c0d7184a65faf7c268" - integrity sha512-3XOqkZP/y6B4F0PBAXvI1/bky7GryoogUtfwExeP/v7Nzwo1QLcq5oQmpKlftZLbT+ERUOAZVQjuNVak6UXjPA== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@webassemblyjs/helper-wasm-bytecode" "1.11.6" - "@webassemblyjs/ieee754" "1.11.6" - "@webassemblyjs/leb128" "1.11.6" - "@webassemblyjs/utf8" "1.11.6" - -"@webassemblyjs/wasm-opt@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/wasm-opt/-/wasm-opt-1.11.6.tgz#d9a22d651248422ca498b09aa3232a81041487c2" - integrity sha512-cOrKuLRE7PCe6AsOVl7WasYf3wbSo4CeOk6PkrjS7g57MFfVUF9u6ysQBBODX0LdgSvQqRiGz3CXvIDKcPNy4g== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@webassemblyjs/helper-buffer" "1.11.6" - "@webassemblyjs/wasm-gen" "1.11.6" - "@webassemblyjs/wasm-parser" "1.11.6" - -"@webassemblyjs/wasm-parser@1.11.6", "@webassemblyjs/wasm-parser@^1.11.5": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/wasm-parser/-/wasm-parser-1.11.6.tgz#bb85378c527df824004812bbdb784eea539174a1" - integrity sha512-6ZwPeGzMJM3Dqp3hCsLgESxBGtT/OeCvCZ4TA1JUPYgmhAx38tTPR9JaKy0S5H3evQpO/h2uWs2j6Yc/fjkpTQ== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@webassemblyjs/helper-api-error" "1.11.6" - "@webassemblyjs/helper-wasm-bytecode" "1.11.6" - "@webassemblyjs/ieee754" "1.11.6" - "@webassemblyjs/leb128" "1.11.6" - "@webassemblyjs/utf8" "1.11.6" - -"@webassemblyjs/wast-printer@1.11.6": - version "1.11.6" - resolved "https://registry.yarnpkg.com/@webassemblyjs/wast-printer/-/wast-printer-1.11.6.tgz#a7bf8dd7e362aeb1668ff43f35cb849f188eff20" - integrity sha512-JM7AhRcE+yW2GWYaKeHL5vt4xqee5N2WcezptmgyhNS+ScggqcT1OtXykhAb13Sn5Yas0j2uv9tHgrjwvzAP4A== - dependencies: - "@webassemblyjs/ast" "1.11.6" - "@xtuc/long" "4.2.2" - -"@xtuc/ieee754@^1.2.0": - version "1.2.0" - resolved "https://registry.yarnpkg.com/@xtuc/ieee754/-/ieee754-1.2.0.tgz#eef014a3145ae477a1cbc00cd1e552336dceb790" - integrity sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA== - -"@xtuc/long@4.2.2": - version "4.2.2" - resolved "https://registry.yarnpkg.com/@xtuc/long/-/long-4.2.2.tgz#d291c6a4e97989b5c61d9acf396ae4fe133a718d" - integrity sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ== - -accepts@~1.3.4, accepts@~1.3.5, accepts@~1.3.8: - version "1.3.8" - resolved "https://registry.yarnpkg.com/accepts/-/accepts-1.3.8.tgz#0bf0be125b67014adcb0b0921e62db7bffe16b2e" - integrity sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw== - dependencies: - mime-types "~2.1.34" - negotiator "0.6.3" - -acorn-import-assertions@^1.9.0: - version "1.9.0" - resolved "https://registry.yarnpkg.com/acorn-import-assertions/-/acorn-import-assertions-1.9.0.tgz#507276249d684797c84e0734ef84860334cfb1ac" - integrity sha512-cmMwop9x+8KFhxvKrKfPYmN6/pKTYYHBqLa0DfvVZcKMJWNyWLnaqND7dx/qn66R7ewM1UX5XMaDVP5wlVTaVA== - -acorn-walk@^8.0.0: - version "8.2.0" - resolved "https://registry.yarnpkg.com/acorn-walk/-/acorn-walk-8.2.0.tgz#741210f2e2426454508853a2f44d0ab83b7f69c1" - integrity sha512-k+iyHEuPgSw6SbuDpGQM+06HQUa04DZ3o+F6CSzXMvvI5KMvnaEqXe+YVe555R9nn6GPt404fos4wcgpw12SDA== - -acorn@^8.0.4, acorn@^8.7.1, acorn@^8.8.2: - version "8.10.0" - resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.10.0.tgz#8be5b3907a67221a81ab23c7889c4c5526b62ec5" - integrity sha512-F0SAmZ8iUtS//m8DmCTA0jlh6TDKkHQyK6xc6V4KDTyZKA9dnvX9/3sRTVQrWm79glUAZbnmmNcdYwUIHWVybw== - -address@^1.0.1, address@^1.1.2: - version "1.2.2" - resolved "https://registry.yarnpkg.com/address/-/address-1.2.2.tgz#2b5248dac5485a6390532c6a517fda2e3faac89e" - integrity sha512-4B/qKCfeE/ODUaAUpSwfzazo5x29WD4r3vXiWsB7I2mSDAihwEqKO+g8GELZUQSSAo5e1XTYh3ZVfLyxBc12nA== - -aggregate-error@^3.0.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/aggregate-error/-/aggregate-error-3.1.0.tgz#92670ff50f5359bdb7a3e0d40d0ec30c5737687a" - integrity sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA== - dependencies: - clean-stack "^2.0.0" - indent-string "^4.0.0" - -ajv-formats@^2.1.1: - version "2.1.1" - resolved "https://registry.yarnpkg.com/ajv-formats/-/ajv-formats-2.1.1.tgz#6e669400659eb74973bbf2e33327180a0996b520" - integrity sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA== - dependencies: - ajv "^8.0.0" - -ajv-keywords@^3.4.1, ajv-keywords@^3.5.2: - version "3.5.2" - resolved "https://registry.yarnpkg.com/ajv-keywords/-/ajv-keywords-3.5.2.tgz#31f29da5ab6e00d1c2d329acf7b5929614d5014d" - integrity sha512-5p6WTN0DdTGVQk6VjcEju19IgaHudalcfabD7yhDGeA6bcQnmL+CpveLJq/3hvfwd1aof6L386Ougkx6RfyMIQ== - -ajv-keywords@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/ajv-keywords/-/ajv-keywords-5.1.0.tgz#69d4d385a4733cdbeab44964a1170a88f87f0e16" - integrity sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw== - dependencies: - fast-deep-equal "^3.1.3" - -ajv@^6.12.2, ajv@^6.12.4, ajv@^6.12.5: - version "6.12.6" - resolved "https://registry.yarnpkg.com/ajv/-/ajv-6.12.6.tgz#baf5a62e802b07d977034586f8c3baf5adf26df4" - integrity sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g== - dependencies: - fast-deep-equal "^3.1.1" - fast-json-stable-stringify "^2.0.0" - json-schema-traverse "^0.4.1" - uri-js "^4.2.2" - -ajv@^8.0.0, ajv@^8.9.0: - version "8.12.0" - resolved "https://registry.yarnpkg.com/ajv/-/ajv-8.12.0.tgz#d1a0527323e22f53562c567c00991577dfbe19d1" - integrity sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA== - dependencies: - fast-deep-equal "^3.1.1" - json-schema-traverse "^1.0.0" - require-from-string "^2.0.2" - uri-js "^4.2.2" - -algoliasearch-helper@^3.10.0: - version "3.14.2" - resolved "https://registry.yarnpkg.com/algoliasearch-helper/-/algoliasearch-helper-3.14.2.tgz#c34cfe6cefcfecd65c60bcb8bf9b68134472d28c" - integrity sha512-FjDSrjvQvJT/SKMW74nPgFpsoPUwZCzGbCqbp8HhBFfSk/OvNFxzCaCmuO0p7AWeLy1gD+muFwQEkBwcl5H4pg== - dependencies: - "@algolia/events" "^4.0.1" - -algoliasearch@^4.13.1, algoliasearch@^4.19.1: - version "4.20.0" - resolved "https://registry.yarnpkg.com/algoliasearch/-/algoliasearch-4.20.0.tgz#700c2cb66e14f8a288460036c7b2a554d0d93cf4" - integrity sha512-y+UHEjnOItoNy0bYO+WWmLWBlPwDjKHW6mNHrPi0NkuhpQOOEbrkwQH/wgKFDLh7qlKjzoKeiRtlpewDPDG23g== - dependencies: - "@algolia/cache-browser-local-storage" "4.20.0" - "@algolia/cache-common" "4.20.0" - "@algolia/cache-in-memory" "4.20.0" - "@algolia/client-account" "4.20.0" - "@algolia/client-analytics" "4.20.0" - "@algolia/client-common" "4.20.0" - "@algolia/client-personalization" "4.20.0" - "@algolia/client-search" "4.20.0" - "@algolia/logger-common" "4.20.0" - "@algolia/logger-console" "4.20.0" - "@algolia/requester-browser-xhr" "4.20.0" - "@algolia/requester-common" "4.20.0" - "@algolia/requester-node-http" "4.20.0" - "@algolia/transporter" "4.20.0" - -ansi-align@^3.0.0, ansi-align@^3.0.1: - version "3.0.1" - resolved "https://registry.yarnpkg.com/ansi-align/-/ansi-align-3.0.1.tgz#0cdf12e111ace773a86e9a1fad1225c43cb19a59" - integrity sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w== - dependencies: - string-width "^4.1.0" - -ansi-html-community@^0.0.8: - version "0.0.8" - resolved "https://registry.yarnpkg.com/ansi-html-community/-/ansi-html-community-0.0.8.tgz#69fbc4d6ccbe383f9736934ae34c3f8290f1bf41" - integrity sha512-1APHAyr3+PCamwNw3bXCPp4HFLONZt/yIH0sZp0/469KWNTEy+qN5jQ3GVX6DMZ1UXAi34yVwtTeaG/HpBuuzw== - -ansi-regex@^5.0.1: - version "5.0.1" - resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-5.0.1.tgz#082cb2c89c9fe8659a311a53bd6a4dc5301db304" - integrity sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ== - -ansi-regex@^6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-6.0.1.tgz#3183e38fae9a65d7cb5e53945cd5897d0260a06a" - integrity sha512-n5M855fKb2SsfMIiFFoVrABHJC8QtHwVx+mHWP3QcEqBHYienj5dHSgjbxtC0WEZXYt4wcD6zrQElDPhFuZgfA== - -ansi-styles@^3.2.1: - version "3.2.1" - resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-3.2.1.tgz#41fbb20243e50b12be0f04b8dedbf07520ce841d" - integrity sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA== - dependencies: - color-convert "^1.9.0" - -ansi-styles@^4.0.0, ansi-styles@^4.1.0: - version "4.3.0" - resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-4.3.0.tgz#edd803628ae71c04c85ae7a0906edad34b648937" - integrity sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg== - dependencies: - color-convert "^2.0.1" - -ansi-styles@^6.1.0: - version "6.2.1" - resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-6.2.1.tgz#0e62320cf99c21afff3b3012192546aacbfb05c5" - integrity sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug== - -anymatch@~3.1.2: - version "3.1.3" - resolved "https://registry.yarnpkg.com/anymatch/-/anymatch-3.1.3.tgz#790c58b19ba1720a84205b57c618d5ad8524973e" - integrity sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw== - dependencies: - normalize-path "^3.0.0" - picomatch "^2.0.4" - -arg@^5.0.0: - version "5.0.2" - resolved "https://registry.yarnpkg.com/arg/-/arg-5.0.2.tgz#c81433cc427c92c4dcf4865142dbca6f15acd59c" - integrity sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg== - -argparse@^1.0.7: - version "1.0.10" - resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.10.tgz#bcd6791ea5ae09725e17e5ad988134cd40b3d911" - integrity sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg== - dependencies: - sprintf-js "~1.0.2" - -argparse@^2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/argparse/-/argparse-2.0.1.tgz#246f50f3ca78a3240f6c997e8a9bd1eac49e4b38" - integrity sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q== - -array-flatten@1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/array-flatten/-/array-flatten-1.1.1.tgz#9a5f699051b1e7073328f2a008968b64ea2955d2" - integrity sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg== - -array-flatten@^2.1.2: - version "2.1.2" - resolved "https://registry.yarnpkg.com/array-flatten/-/array-flatten-2.1.2.tgz#24ef80a28c1a893617e2149b0c6d0d788293b099" - integrity sha512-hNfzcOV8W4NdualtqBFPyVO+54DSJuZGY9qT4pRroB6S9e3iiido2ISIC5h9R2sPJ8H3FHCIiEnsv1lPXO3KtQ== - -array-union@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/array-union/-/array-union-2.1.0.tgz#b798420adbeb1de828d84acd8a2e23d3efe85e8d" - integrity sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw== - -asap@~2.0.3: - version "2.0.6" - resolved "https://registry.yarnpkg.com/asap/-/asap-2.0.6.tgz#e50347611d7e690943208bbdafebcbc2fb866d46" - integrity sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA== - -at-least-node@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/at-least-node/-/at-least-node-1.0.0.tgz#602cd4b46e844ad4effc92a8011a3c46e0238dc2" - integrity sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg== - -autoprefixer@^10.4.12, autoprefixer@^10.4.7: - version "10.4.16" - resolved "https://registry.yarnpkg.com/autoprefixer/-/autoprefixer-10.4.16.tgz#fad1411024d8670880bdece3970aa72e3572feb8" - integrity sha512-7vd3UC6xKp0HLfua5IjZlcXvGAGy7cBAXTg2lyQ/8WpNhd6SiZ8Be+xm3FyBSYJx5GKcpRCzBh7RH4/0dnY+uQ== - dependencies: - browserslist "^4.21.10" - caniuse-lite "^1.0.30001538" - fraction.js "^4.3.6" - normalize-range "^0.1.2" - picocolors "^1.0.0" - postcss-value-parser "^4.2.0" - -axios@^0.25.0: - version "0.25.0" - resolved "https://registry.yarnpkg.com/axios/-/axios-0.25.0.tgz#349cfbb31331a9b4453190791760a8d35b093e0a" - integrity sha512-cD8FOb0tRH3uuEe6+evtAbgJtfxr7ly3fQjYcMcuPlgkwVS9xboaVIpcDV+cYQe+yGykgwZCs1pzjntcGa6l5g== - dependencies: - follow-redirects "^1.14.7" - -babel-loader@^8.2.5: - version "8.3.0" - resolved "https://registry.yarnpkg.com/babel-loader/-/babel-loader-8.3.0.tgz#124936e841ba4fe8176786d6ff28add1f134d6a8" - integrity sha512-H8SvsMF+m9t15HNLMipppzkC+Y2Yq+v3SonZyU70RBL/h1gxPkH08Ot8pEE9Z4Kd+czyWJClmFS8qzIP9OZ04Q== - dependencies: - find-cache-dir "^3.3.1" - loader-utils "^2.0.0" - make-dir "^3.1.0" - schema-utils "^2.6.5" - -babel-plugin-apply-mdx-type-prop@1.6.22: - version "1.6.22" - resolved "https://registry.yarnpkg.com/babel-plugin-apply-mdx-type-prop/-/babel-plugin-apply-mdx-type-prop-1.6.22.tgz#d216e8fd0de91de3f1478ef3231e05446bc8705b" - integrity sha512-VefL+8o+F/DfK24lPZMtJctrCVOfgbqLAGZSkxwhazQv4VxPg3Za/i40fu22KR2m8eEda+IfSOlPLUSIiLcnCQ== - dependencies: - "@babel/helper-plugin-utils" "7.10.4" - "@mdx-js/util" "1.6.22" - -babel-plugin-dynamic-import-node@^2.3.3: - version "2.3.3" - resolved "https://registry.yarnpkg.com/babel-plugin-dynamic-import-node/-/babel-plugin-dynamic-import-node-2.3.3.tgz#84fda19c976ec5c6defef57f9427b3def66e17a3" - integrity sha512-jZVI+s9Zg3IqA/kdi0i6UDCybUI3aSBLnglhYbSSjKlV7yF1F/5LWv8MakQmvYpnbJDS6fcBL2KzHSxNCMtWSQ== - dependencies: - object.assign "^4.1.0" - -babel-plugin-extract-import-names@1.6.22: - version "1.6.22" - resolved "https://registry.yarnpkg.com/babel-plugin-extract-import-names/-/babel-plugin-extract-import-names-1.6.22.tgz#de5f9a28eb12f3eb2578bf74472204e66d1a13dc" - integrity sha512-yJ9BsJaISua7d8zNT7oRG1ZLBJCIdZ4PZqmH8qa9N5AK01ifk3fnkc98AXhtzE7UkfCsEumvoQWgoYLhOnJ7jQ== - dependencies: - "@babel/helper-plugin-utils" "7.10.4" - -babel-plugin-polyfill-corejs2@^0.4.5: - version "0.4.5" - resolved "https://registry.yarnpkg.com/babel-plugin-polyfill-corejs2/-/babel-plugin-polyfill-corejs2-0.4.5.tgz#8097b4cb4af5b64a1d11332b6fb72ef5e64a054c" - integrity sha512-19hwUH5FKl49JEsvyTcoHakh6BE0wgXLLptIyKZ3PijHc/Ci521wygORCUCCred+E/twuqRyAkE02BAWPmsHOg== - dependencies: - "@babel/compat-data" "^7.22.6" - "@babel/helper-define-polyfill-provider" "^0.4.2" - semver "^6.3.1" - -babel-plugin-polyfill-corejs3@^0.8.3: - version "0.8.4" - resolved "https://registry.yarnpkg.com/babel-plugin-polyfill-corejs3/-/babel-plugin-polyfill-corejs3-0.8.4.tgz#1fac2b1dcef6274e72b3c72977ed8325cb330591" - integrity sha512-9l//BZZsPR+5XjyJMPtZSK4jv0BsTO1zDac2GC6ygx9WLGlcsnRd1Co0B2zT5fF5Ic6BZy+9m3HNZ3QcOeDKfg== - dependencies: - "@babel/helper-define-polyfill-provider" "^0.4.2" - core-js-compat "^3.32.2" - -babel-plugin-polyfill-regenerator@^0.5.2: - version "0.5.2" - resolved "https://registry.yarnpkg.com/babel-plugin-polyfill-regenerator/-/babel-plugin-polyfill-regenerator-0.5.2.tgz#80d0f3e1098c080c8b5a65f41e9427af692dc326" - integrity sha512-tAlOptU0Xj34V1Y2PNTL4Y0FOJMDB6bZmoW39FeCQIhigGLkqu3Fj6uiXpxIf6Ij274ENdYx64y6Au+ZKlb1IA== - dependencies: - "@babel/helper-define-polyfill-provider" "^0.4.2" - -bail@^1.0.0: - version "1.0.5" - resolved "https://registry.yarnpkg.com/bail/-/bail-1.0.5.tgz#b6fa133404a392cbc1f8c4bf63f5953351e7a776" - integrity sha512-xFbRxM1tahm08yHBP16MMjVUAvDaBMD38zsM9EMAUN61omwLmKlOpB/Zku5QkjZ8TZ4vn53pj+t518cH0S03RQ== - -balanced-match@^1.0.0: - version "1.0.2" - resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.2.tgz#e83e3a7e3f300b34cb9d87f615fa0cbf357690ee" - integrity sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw== - -base16@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/base16/-/base16-1.0.0.tgz#e297f60d7ec1014a7a971a39ebc8a98c0b681e70" - integrity sha512-pNdYkNPiJUnEhnfXV56+sQy8+AaPcG3POZAUnwr4EeqCUZFz4u2PePbo3e5Gj4ziYPCWGUZT9RHisvJKnwFuBQ== - -batch@0.6.1: - version "0.6.1" - resolved "https://registry.yarnpkg.com/batch/-/batch-0.6.1.tgz#dc34314f4e679318093fc760272525f94bf25c16" - integrity sha512-x+VAiMRL6UPkx+kudNvxTl6hB2XNNCG2r+7wixVfIYwu/2HKRXimwQyaumLjMveWvT2Hkd/cAJw+QBMfJ/EKVw== - -big.js@^5.2.2: - version "5.2.2" - resolved "https://registry.yarnpkg.com/big.js/-/big.js-5.2.2.tgz#65f0af382f578bcdc742bd9c281e9cb2d7768328" - integrity sha512-vyL2OymJxmarO8gxMr0mhChsO9QGwhynfuu4+MHTAW6czfq9humCB7rKpUjDd9YUiDPU4mzpyupFSvOClAwbmQ== - -binary-extensions@^2.0.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/binary-extensions/-/binary-extensions-2.2.0.tgz#75f502eeaf9ffde42fc98829645be4ea76bd9e2d" - integrity sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA== - -body-parser@1.20.1: - version "1.20.1" - resolved "https://registry.yarnpkg.com/body-parser/-/body-parser-1.20.1.tgz#b1812a8912c195cd371a3ee5e66faa2338a5c668" - integrity sha512-jWi7abTbYwajOytWCQc37VulmWiRae5RyTpaCyDcS5/lMdtwSz5lOpDE67srw/HYe35f1z3fDQw+3txg7gNtWw== - dependencies: - bytes "3.1.2" - content-type "~1.0.4" - debug "2.6.9" - depd "2.0.0" - destroy "1.2.0" - http-errors "2.0.0" - iconv-lite "0.4.24" - on-finished "2.4.1" - qs "6.11.0" - raw-body "2.5.1" - type-is "~1.6.18" - unpipe "1.0.0" - -bonjour-service@^1.0.11: - version "1.1.1" - resolved "https://registry.yarnpkg.com/bonjour-service/-/bonjour-service-1.1.1.tgz#960948fa0e0153f5d26743ab15baf8e33752c135" - integrity sha512-Z/5lQRMOG9k7W+FkeGTNjh7htqn/2LMnfOvBZ8pynNZCM9MwkQkI3zeI4oz09uWdcgmgHugVvBqxGg4VQJ5PCg== - dependencies: - array-flatten "^2.1.2" - dns-equal "^1.0.0" - fast-deep-equal "^3.1.3" - multicast-dns "^7.2.5" - -boolbase@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/boolbase/-/boolbase-1.0.0.tgz#68dff5fbe60c51eb37725ea9e3ed310dcc1e776e" - integrity sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww== - -boxen@^5.0.0: - version "5.1.2" - resolved "https://registry.yarnpkg.com/boxen/-/boxen-5.1.2.tgz#788cb686fc83c1f486dfa8a40c68fc2b831d2b50" - integrity sha512-9gYgQKXx+1nP8mP7CzFyaUARhg7D3n1dF/FnErWmu9l6JvGpNUN278h0aSb+QjoiKSWG+iZ3uHrcqk0qrY9RQQ== - dependencies: - ansi-align "^3.0.0" - camelcase "^6.2.0" - chalk "^4.1.0" - cli-boxes "^2.2.1" - string-width "^4.2.2" - type-fest "^0.20.2" - widest-line "^3.1.0" - wrap-ansi "^7.0.0" - -boxen@^6.2.1: - version "6.2.1" - resolved "https://registry.yarnpkg.com/boxen/-/boxen-6.2.1.tgz#b098a2278b2cd2845deef2dff2efc38d329b434d" - integrity sha512-H4PEsJXfFI/Pt8sjDWbHlQPx4zL/bvSQjcilJmaulGt5mLDorHOHpmdXAJcBcmru7PhYSp/cDMWRko4ZUMFkSw== - dependencies: - ansi-align "^3.0.1" - camelcase "^6.2.0" - chalk "^4.1.2" - cli-boxes "^3.0.0" - string-width "^5.0.1" - type-fest "^2.5.0" - widest-line "^4.0.1" - wrap-ansi "^8.0.1" - -brace-expansion@^1.1.7: - version "1.1.11" - resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-1.1.11.tgz#3c7fcbf529d87226f3d2f52b966ff5271eb441dd" - integrity sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA== - dependencies: - balanced-match "^1.0.0" - concat-map "0.0.1" - -braces@^3.0.2, braces@~3.0.2: - version "3.0.2" - resolved "https://registry.yarnpkg.com/braces/-/braces-3.0.2.tgz#3454e1a462ee8d599e236df336cd9ea4f8afe107" - integrity sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A== - dependencies: - fill-range "^7.0.1" - -browserslist@^4.0.0, browserslist@^4.14.5, browserslist@^4.18.1, browserslist@^4.21.10, browserslist@^4.21.4, browserslist@^4.21.9, browserslist@^4.22.1: - version "4.22.1" - resolved "https://registry.yarnpkg.com/browserslist/-/browserslist-4.22.1.tgz#ba91958d1a59b87dab6fed8dfbcb3da5e2e9c619" - integrity sha512-FEVc202+2iuClEhZhrWy6ZiAcRLvNMyYcxZ8raemul1DYVOVdFsbqckWLdsixQZCpJlwe77Z3UTalE7jsjnKfQ== - dependencies: - caniuse-lite "^1.0.30001541" - electron-to-chromium "^1.4.535" - node-releases "^2.0.13" - update-browserslist-db "^1.0.13" - -buffer-from@^1.0.0: - version "1.1.2" - resolved "https://registry.yarnpkg.com/buffer-from/-/buffer-from-1.1.2.tgz#2b146a6fd72e80b4f55d255f35ed59a3a9a41bd5" - integrity sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ== - -bytes@3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/bytes/-/bytes-3.0.0.tgz#d32815404d689699f85a4ea4fa8755dd13a96048" - integrity sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw== - -bytes@3.1.2: - version "3.1.2" - resolved "https://registry.yarnpkg.com/bytes/-/bytes-3.1.2.tgz#8b0beeb98605adf1b128fa4386403c009e0221a5" - integrity sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg== - -cacheable-request@^6.0.0: - version "6.1.0" - resolved "https://registry.yarnpkg.com/cacheable-request/-/cacheable-request-6.1.0.tgz#20ffb8bd162ba4be11e9567d823db651052ca912" - integrity sha512-Oj3cAGPCqOZX7Rz64Uny2GYAZNliQSqfbePrgAQ1wKAihYmCUnraBtJtKcGR4xz7wF+LoJC+ssFZvv5BgF9Igg== - dependencies: - clone-response "^1.0.2" - get-stream "^5.1.0" - http-cache-semantics "^4.0.0" - keyv "^3.0.0" - lowercase-keys "^2.0.0" - normalize-url "^4.1.0" - responselike "^1.0.2" - -call-bind@^1.0.0, call-bind@^1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/call-bind/-/call-bind-1.0.2.tgz#b1d4e89e688119c3c9a903ad30abb2f6a919be3c" - integrity sha512-7O+FbCihrB5WGbFYesctwmTKae6rOiIzmz1icreWJ+0aA7LJfuqhEso2T9ncpcFtzMQtzXf2QGGueWJGTYsqrA== - dependencies: - function-bind "^1.1.1" - get-intrinsic "^1.0.2" - -callsites@^3.0.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/callsites/-/callsites-3.1.0.tgz#b3630abd8943432f54b3f0519238e33cd7df2f73" - integrity sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ== - -camel-case@^4.1.2: - version "4.1.2" - resolved "https://registry.yarnpkg.com/camel-case/-/camel-case-4.1.2.tgz#9728072a954f805228225a6deea6b38461e1bd5a" - integrity sha512-gxGWBrTT1JuMx6R+o5PTXMmUnhnVzLQ9SNutD4YqKtI6ap897t3tKECYla6gCWEkplXnlNybEkZg9GEGxKFCgw== - dependencies: - pascal-case "^3.1.2" - tslib "^2.0.3" - -camelcase-css@2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/camelcase-css/-/camelcase-css-2.0.1.tgz#ee978f6947914cc30c6b44741b6ed1df7f043fd5" - integrity sha512-QOSvevhslijgYwRx6Rv7zKdMF8lbRmx+uQGx2+vDc+KI/eBnsy9kit5aj23AgGu3pa4t9AgwbnXWqS+iOY+2aA== - -camelcase@^6.2.0: - version "6.3.0" - resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-6.3.0.tgz#5685b95eb209ac9c0c177467778c9c84df58ba9a" - integrity sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA== - -caniuse-api@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/caniuse-api/-/caniuse-api-3.0.0.tgz#5e4d90e2274961d46291997df599e3ed008ee4c0" - integrity sha512-bsTwuIg/BZZK/vreVTYYbSWoe2F+71P7K5QGEX+pT250DZbfU1MQ5prOKpPR+LL6uWKK3KMwMCAS74QB3Um1uw== - dependencies: - browserslist "^4.0.0" - caniuse-lite "^1.0.0" - lodash.memoize "^4.1.2" - lodash.uniq "^4.5.0" - -caniuse-lite@^1.0.0, caniuse-lite@^1.0.30001538, caniuse-lite@^1.0.30001541: - version "1.0.30001547" - resolved "https://registry.yarnpkg.com/caniuse-lite/-/caniuse-lite-1.0.30001547.tgz#d4f92efc488aab3c7f92c738d3977c2a3180472b" - integrity sha512-W7CrtIModMAxobGhz8iXmDfuJiiKg1WADMO/9x7/CLNin5cpSbuBjooyoIUVB5eyCc36QuTVlkVa1iB2S5+/eA== - -ccount@^1.0.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/ccount/-/ccount-1.1.0.tgz#246687debb6014735131be8abab2d93898f8d043" - integrity sha512-vlNK021QdI7PNeiUh/lKkC/mNHHfV0m/Ad5JoI0TYtlBnJAslM/JIkm/tGC88bkLIwO6OQ5uV6ztS6kVAtCDlg== - -chalk@^2.4.2: - version "2.4.2" - resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.4.2.tgz#cd42541677a54333cf541a49108c1432b44c9424" - integrity sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ== - dependencies: - ansi-styles "^3.2.1" - escape-string-regexp "^1.0.5" - supports-color "^5.3.0" - -chalk@^4.0.0, chalk@^4.1.0, chalk@^4.1.2: - version "4.1.2" - resolved "https://registry.yarnpkg.com/chalk/-/chalk-4.1.2.tgz#aac4e2b7734a740867aeb16bf02aad556a1e7a01" - integrity sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA== - dependencies: - ansi-styles "^4.1.0" - supports-color "^7.1.0" - -character-entities-legacy@^1.0.0: - version "1.1.4" - resolved "https://registry.yarnpkg.com/character-entities-legacy/-/character-entities-legacy-1.1.4.tgz#94bc1845dce70a5bb9d2ecc748725661293d8fc1" - integrity sha512-3Xnr+7ZFS1uxeiUDvV02wQ+QDbc55o97tIV5zHScSPJpcLm/r0DFPcoY3tYRp+VZukxuMeKgXYmsXQHO05zQeA== - -character-entities@^1.0.0: - version "1.2.4" - resolved "https://registry.yarnpkg.com/character-entities/-/character-entities-1.2.4.tgz#e12c3939b7eaf4e5b15e7ad4c5e28e1d48c5b16b" - integrity sha512-iBMyeEHxfVnIakwOuDXpVkc54HijNgCyQB2w0VfGQThle6NXn50zU6V/u+LDhxHcDUPojn6Kpga3PTAD8W1bQw== - -character-reference-invalid@^1.0.0: - version "1.1.4" - resolved "https://registry.yarnpkg.com/character-reference-invalid/-/character-reference-invalid-1.1.4.tgz#083329cda0eae272ab3dbbf37e9a382c13af1560" - integrity sha512-mKKUkUbhPpQlCOfIuZkvSEgktjPFIsZKRRbC6KWVEMvlzblj3i3asQv5ODsrwt0N3pHAEvjP8KTQPHkp0+6jOg== - -cheerio-select@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/cheerio-select/-/cheerio-select-2.1.0.tgz#4d8673286b8126ca2a8e42740d5e3c4884ae21b4" - integrity sha512-9v9kG0LvzrlcungtnJtpGNxY+fzECQKhK4EGJX2vByejiMX84MFNQw4UxPJl3bFbTMw+Dfs37XaIkCwTZfLh4g== - dependencies: - boolbase "^1.0.0" - css-select "^5.1.0" - css-what "^6.1.0" - domelementtype "^2.3.0" - domhandler "^5.0.3" - domutils "^3.0.1" - -cheerio@^1.0.0-rc.12: - version "1.0.0-rc.12" - resolved "https://registry.yarnpkg.com/cheerio/-/cheerio-1.0.0-rc.12.tgz#788bf7466506b1c6bf5fae51d24a2c4d62e47683" - integrity sha512-VqR8m68vM46BNnuZ5NtnGBKIE/DfN0cRIzg9n40EIq9NOv90ayxLBXA8fXC5gquFRGJSTRqBq25Jt2ECLR431Q== - dependencies: - cheerio-select "^2.1.0" - dom-serializer "^2.0.0" - domhandler "^5.0.3" - domutils "^3.0.1" - htmlparser2 "^8.0.1" - parse5 "^7.0.0" - parse5-htmlparser2-tree-adapter "^7.0.0" - -chokidar@^3.4.2, chokidar@^3.5.3: - version "3.5.3" - resolved "https://registry.yarnpkg.com/chokidar/-/chokidar-3.5.3.tgz#1cf37c8707b932bd1af1ae22c0432e2acd1903bd" - integrity sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw== - dependencies: - anymatch "~3.1.2" - braces "~3.0.2" - glob-parent "~5.1.2" - is-binary-path "~2.1.0" - is-glob "~4.0.1" - normalize-path "~3.0.0" - readdirp "~3.6.0" - optionalDependencies: - fsevents "~2.3.2" - -chrome-trace-event@^1.0.2: - version "1.0.3" - resolved "https://registry.yarnpkg.com/chrome-trace-event/-/chrome-trace-event-1.0.3.tgz#1015eced4741e15d06664a957dbbf50d041e26ac" - integrity sha512-p3KULyQg4S7NIHixdwbGX+nFHkoBiA4YQmyWtjb8XngSKV124nJmRysgAeujbUVb15vh+RvFUfCPqU7rXk+hZg== - -ci-info@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-2.0.0.tgz#67a9e964be31a51e15e5010d58e6f12834002f46" - integrity sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ== - -ci-info@^3.2.0: - version "3.9.0" - resolved "https://registry.yarnpkg.com/ci-info/-/ci-info-3.9.0.tgz#4279a62028a7b1f262f3473fc9605f5e218c59b4" - integrity sha512-NIxF55hv4nSqQswkAeiOi1r83xy8JldOFDTWiug55KBu9Jnblncd2U6ViHmYgHf01TPZS77NJBhBMKdWj9HQMQ== - -clean-css@^5.2.2, clean-css@^5.3.0: - version "5.3.2" - resolved "https://registry.yarnpkg.com/clean-css/-/clean-css-5.3.2.tgz#70ecc7d4d4114921f5d298349ff86a31a9975224" - integrity sha512-JVJbM+f3d3Q704rF4bqQ5UUyTtuJ0JRKNbTKVEeujCCBoMdkEi+V+e8oktO9qGQNSvHrFTM6JZRXrUvGR1czww== - dependencies: - source-map "~0.6.0" - -clean-stack@^2.0.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/clean-stack/-/clean-stack-2.2.0.tgz#ee8472dbb129e727b31e8a10a427dee9dfe4008b" - integrity sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A== - -cli-boxes@^2.2.1: - version "2.2.1" - resolved "https://registry.yarnpkg.com/cli-boxes/-/cli-boxes-2.2.1.tgz#ddd5035d25094fce220e9cab40a45840a440318f" - integrity sha512-y4coMcylgSCdVinjiDBuR8PCC2bLjyGTwEmPb9NHR/QaNU6EUOXcTY/s6VjGMD6ENSEaeQYHCY0GNGS5jfMwPw== - -cli-boxes@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/cli-boxes/-/cli-boxes-3.0.0.tgz#71a10c716feeba005e4504f36329ef0b17cf3145" - integrity sha512-/lzGpEWL/8PfI0BmBOPRwp0c/wFNX1RdUML3jK/RcSBA9T8mZDdQpqYBKtCFTOfQbwPqWEOpjqW+Fnayc0969g== - -cli-table3@^0.6.2: - version "0.6.3" - resolved "https://registry.yarnpkg.com/cli-table3/-/cli-table3-0.6.3.tgz#61ab765aac156b52f222954ffc607a6f01dbeeb2" - integrity sha512-w5Jac5SykAeZJKntOxJCrm63Eg5/4dhMWIcuTbo9rpE+brgaSZo0RuNJZeOyMgsUdhDeojvgyQLmjI+K50ZGyg== - dependencies: - string-width "^4.2.0" - optionalDependencies: - "@colors/colors" "1.5.0" - -clone-deep@^4.0.1: - version "4.0.1" - resolved "https://registry.yarnpkg.com/clone-deep/-/clone-deep-4.0.1.tgz#c19fd9bdbbf85942b4fd979c84dcf7d5f07c2387" - integrity sha512-neHB9xuzh/wk0dIHweyAXv2aPGZIVk3pLMe+/RNzINf17fe0OG96QroktYAUm7SM1PBnzTabaLboqqxDyMU+SQ== - dependencies: - is-plain-object "^2.0.4" - kind-of "^6.0.2" - shallow-clone "^3.0.0" - -clone-response@^1.0.2: - version "1.0.3" - resolved "https://registry.yarnpkg.com/clone-response/-/clone-response-1.0.3.tgz#af2032aa47816399cf5f0a1d0db902f517abb8c3" - integrity sha512-ROoL94jJH2dUVML2Y/5PEDNaSHgeOdSDicUyS7izcF63G6sTc/FTjLub4b8Il9S8S0beOfYt0TaA5qvFK+w0wA== - dependencies: - mimic-response "^1.0.0" - -clsx@^1.2.1: - version "1.2.1" - resolved "https://registry.yarnpkg.com/clsx/-/clsx-1.2.1.tgz#0ddc4a20a549b59c93a4116bb26f5294ca17dc12" - integrity sha512-EcR6r5a8bj6pu3ycsa/E/cKVGuTgZJZdsyUYHOksG/UHIiKfjxzRxYJpyVBwYaQeOvghal9fcc4PidlgzugAQg== - -collapse-white-space@^1.0.2: - version "1.0.6" - resolved "https://registry.yarnpkg.com/collapse-white-space/-/collapse-white-space-1.0.6.tgz#e63629c0016665792060dbbeb79c42239d2c5287" - integrity sha512-jEovNnrhMuqyCcjfEJA56v0Xq8SkIoPKDyaHahwo3POf4qcSXqMYuwNcOTzp74vTsR9Tn08z4MxWqAhcekogkQ== - -color-convert@^1.9.0: - version "1.9.3" - resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-1.9.3.tgz#bb71850690e1f136567de629d2d5471deda4c1e8" - integrity sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg== - dependencies: - color-name "1.1.3" - -color-convert@^2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-2.0.1.tgz#72d3a68d598c9bdb3af2ad1e84f21d896abd4de3" - integrity sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ== - dependencies: - color-name "~1.1.4" - -color-name@1.1.3: - version "1.1.3" - resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.3.tgz#a7d0558bd89c42f795dd42328f740831ca53bc25" - integrity sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw== - -color-name@~1.1.4: - version "1.1.4" - resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.4.tgz#c2a09a87acbde69543de6f63fa3995c826c536a2" - integrity sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA== - -colord@^2.9.1: - version "2.9.3" - resolved "https://registry.yarnpkg.com/colord/-/colord-2.9.3.tgz#4f8ce919de456f1d5c1c368c307fe20f3e59fb43" - integrity sha512-jeC1axXpnb0/2nn/Y1LPuLdgXBLH7aDcHu4KEKfqw3CUhX7ZpfBSlPKyqXE6btIgEzfWtrX3/tyBCaCvXvMkOw== - -colorette@^2.0.10: - version "2.0.20" - resolved "https://registry.yarnpkg.com/colorette/-/colorette-2.0.20.tgz#9eb793e6833067f7235902fcd3b09917a000a95a" - integrity sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w== - -combine-promises@^1.1.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/combine-promises/-/combine-promises-1.2.0.tgz#5f2e68451862acf85761ded4d9e2af7769c2ca6a" - integrity sha512-VcQB1ziGD0NXrhKxiwyNbCDmRzs/OShMs2GqW2DlU2A/Sd0nQxE1oWDAE5O0ygSx5mgQOn9eIFh7yKPgFRVkPQ== - -comma-separated-tokens@^1.0.0: - version "1.0.8" - resolved "https://registry.yarnpkg.com/comma-separated-tokens/-/comma-separated-tokens-1.0.8.tgz#632b80b6117867a158f1080ad498b2fbe7e3f5ea" - integrity sha512-GHuDRO12Sypu2cV70d1dkA2EUmXHgntrzbpvOB+Qy+49ypNfGgFQIC2fhhXbnyrJRynDCAARsT7Ou0M6hirpfw== - -commander@7, commander@^7.2.0: - version "7.2.0" - resolved "https://registry.yarnpkg.com/commander/-/commander-7.2.0.tgz#a36cb57d0b501ce108e4d20559a150a391d97ab7" - integrity sha512-QrWXB+ZQSVPmIWIhtEO9H+gwHaMGYiF5ChvoJ+K9ZGHG/sVsa6yiesAD1GC/x46sET00Xlwo1u49RVVVzvcSkw== - -commander@^2.20.0: - version "2.20.3" - resolved "https://registry.yarnpkg.com/commander/-/commander-2.20.3.tgz#fd485e84c03eb4881c20722ba48035e8531aeb33" - integrity sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ== - -commander@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/commander/-/commander-5.1.0.tgz#46abbd1652f8e059bddaef99bbdcb2ad9cf179ae" - integrity sha512-P0CysNDQ7rtVw4QIQtm+MRxV66vKFSvlsQvGYXZWR3qFU0jlMKHZZZgw8e+8DSah4UDKMqnknRDQz+xuQXQ/Zg== - -commander@^8.0.0, commander@^8.3.0: - version "8.3.0" - resolved "https://registry.yarnpkg.com/commander/-/commander-8.3.0.tgz#4837ea1b2da67b9c616a67afbb0fafee567bca66" - integrity sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww== - -commondir@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/commondir/-/commondir-1.0.1.tgz#ddd800da0c66127393cca5950ea968a3aaf1253b" - integrity sha512-W9pAhw0ja1Edb5GVdIF1mjZw/ASI0AlShXM83UUGe2DVr5TdAPEA1OA8m/g8zWp9x6On7gqufY+FatDbC3MDQg== - -compressible@~2.0.16: - version "2.0.18" - resolved "https://registry.yarnpkg.com/compressible/-/compressible-2.0.18.tgz#af53cca6b070d4c3c0750fbd77286a6d7cc46fba" - integrity sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg== - dependencies: - mime-db ">= 1.43.0 < 2" - -compression@^1.7.4: - version "1.7.4" - resolved "https://registry.yarnpkg.com/compression/-/compression-1.7.4.tgz#95523eff170ca57c29a0ca41e6fe131f41e5bb8f" - integrity sha512-jaSIDzP9pZVS4ZfQ+TzvtiWhdpFhE2RDHz8QJkpX9SIpLq88VueF5jJw6t+6CUQcAoA6t+x89MLrWAqpfDE8iQ== - dependencies: - accepts "~1.3.5" - bytes "3.0.0" - compressible "~2.0.16" - debug "2.6.9" - on-headers "~1.0.2" - safe-buffer "5.1.2" - vary "~1.1.2" - -concat-map@0.0.1: - version "0.0.1" - resolved "https://registry.yarnpkg.com/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b" - integrity sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg== - -configstore@^5.0.1: - version "5.0.1" - resolved "https://registry.yarnpkg.com/configstore/-/configstore-5.0.1.tgz#d365021b5df4b98cdd187d6a3b0e3f6a7cc5ed96" - integrity sha512-aMKprgk5YhBNyH25hj8wGt2+D52Sw1DRRIzqBwLp2Ya9mFmY8KPvvtvmna8SxVR9JMZ4kzMD68N22vlaRpkeFA== - dependencies: - dot-prop "^5.2.0" - graceful-fs "^4.1.2" - make-dir "^3.0.0" - unique-string "^2.0.0" - write-file-atomic "^3.0.0" - xdg-basedir "^4.0.0" - -connect-history-api-fallback@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/connect-history-api-fallback/-/connect-history-api-fallback-2.0.0.tgz#647264845251a0daf25b97ce87834cace0f5f1c8" - integrity sha512-U73+6lQFmfiNPrYbXqr6kZ1i1wiRqXnp2nhMsINseWXO8lDau0LGEffJ8kQi4EjLZympVgRdvqjAgiZ1tgzDDA== - -consola@^2.15.3: - version "2.15.3" - resolved "https://registry.yarnpkg.com/consola/-/consola-2.15.3.tgz#2e11f98d6a4be71ff72e0bdf07bd23e12cb61550" - integrity sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw== - -content-disposition@0.5.2: - version "0.5.2" - resolved "https://registry.yarnpkg.com/content-disposition/-/content-disposition-0.5.2.tgz#0cf68bb9ddf5f2be7961c3a85178cb85dba78cb4" - integrity sha512-kRGRZw3bLlFISDBgwTSA1TMBFN6J6GWDeubmDE3AF+3+yXL8hTWv8r5rkLbqYXY4RjPk/EzHnClI3zQf1cFmHA== - -content-disposition@0.5.4: - version "0.5.4" - resolved "https://registry.yarnpkg.com/content-disposition/-/content-disposition-0.5.4.tgz#8b82b4efac82512a02bb0b1dcec9d2c5e8eb5bfe" - integrity sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ== - dependencies: - safe-buffer "5.2.1" - -content-type@~1.0.4: - version "1.0.5" - resolved "https://registry.yarnpkg.com/content-type/-/content-type-1.0.5.tgz#8b773162656d1d1086784c8f23a54ce6d73d7918" - integrity sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA== - -convert-source-map@^1.7.0: - version "1.9.0" - resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-1.9.0.tgz#7faae62353fb4213366d0ca98358d22e8368b05f" - integrity sha512-ASFBup0Mz1uyiIjANan1jzLQami9z1PoYSZCiiYW2FczPbenXc45FZdBZLzOT+r6+iciuEModtmCti+hjaAk0A== - -convert-source-map@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-2.0.0.tgz#4b560f649fc4e918dd0ab75cf4961e8bc882d82a" - integrity sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg== - -cookie-signature@1.0.6: - version "1.0.6" - resolved "https://registry.yarnpkg.com/cookie-signature/-/cookie-signature-1.0.6.tgz#e303a882b342cc3ee8ca513a79999734dab3ae2c" - integrity sha512-QADzlaHc8icV8I7vbaJXJwod9HWYp8uCqf1xa4OfNu1T7JVxQIrUgOWtHdNDtPiywmFbiS12VjotIXLrKM3orQ== - -cookie@0.5.0: - version "0.5.0" - resolved "https://registry.yarnpkg.com/cookie/-/cookie-0.5.0.tgz#d1f5d71adec6558c58f389987c366aa47e994f8b" - integrity sha512-YZ3GUyn/o8gfKJlnlX7g7xq4gyO6OSuhGPKaaGssGB2qgDUS0gPgtTvoyZLTt9Ab6dC4hfc9dV5arkvc/OCmrw== - -copy-text-to-clipboard@^3.0.1: - version "3.2.0" - resolved "https://registry.yarnpkg.com/copy-text-to-clipboard/-/copy-text-to-clipboard-3.2.0.tgz#0202b2d9bdae30a49a53f898626dcc3b49ad960b" - integrity sha512-RnJFp1XR/LOBDckxTib5Qjr/PMfkatD0MUCQgdpqS8MdKiNUzBjAQBEN6oUy+jW7LI93BBG3DtMB2KOOKpGs2Q== - -copy-webpack-plugin@^11.0.0: - version "11.0.0" - resolved "https://registry.yarnpkg.com/copy-webpack-plugin/-/copy-webpack-plugin-11.0.0.tgz#96d4dbdb5f73d02dd72d0528d1958721ab72e04a" - integrity sha512-fX2MWpamkW0hZxMEg0+mYnA40LTosOSa5TqZ9GYIBzyJa9C3QUaMPSE2xAi/buNr8u89SfD9wHSQVBzrRa/SOQ== - dependencies: - fast-glob "^3.2.11" - glob-parent "^6.0.1" - globby "^13.1.1" - normalize-path "^3.0.0" - schema-utils "^4.0.0" - serialize-javascript "^6.0.0" - -core-js-compat@^3.31.0, core-js-compat@^3.32.2: - version "3.33.0" - resolved "https://registry.yarnpkg.com/core-js-compat/-/core-js-compat-3.33.0.tgz#24aa230b228406450b2277b7c8bfebae932df966" - integrity sha512-0w4LcLXsVEuNkIqwjjf9rjCoPhK8uqA4tMRh4Ge26vfLtUutshn+aRJU21I9LCJlh2QQHfisNToLjw1XEJLTWw== - dependencies: - browserslist "^4.22.1" - -core-js-pure@^3.30.2: - version "3.33.0" - resolved "https://registry.yarnpkg.com/core-js-pure/-/core-js-pure-3.33.0.tgz#938a28754b4d82017a7a8cbd2727b1abecc63591" - integrity sha512-FKSIDtJnds/YFIEaZ4HszRX7hkxGpNKM7FC9aJ9WLJbSd3lD4vOltFuVIBLR8asSx9frkTSqL0dw90SKQxgKrg== - -core-js@^3.23.3: - version "3.33.0" - resolved "https://registry.yarnpkg.com/core-js/-/core-js-3.33.0.tgz#70366dbf737134761edb017990cf5ce6c6369c40" - integrity sha512-HoZr92+ZjFEKar5HS6MC776gYslNOKHt75mEBKWKnPeFDpZ6nH5OeF3S6HFT1mUAUZKrzkez05VboaX8myjSuw== - -core-util-is@~1.0.0: - version "1.0.3" - resolved "https://registry.yarnpkg.com/core-util-is/-/core-util-is-1.0.3.tgz#a6042d3634c2b27e9328f837b965fac83808db85" - integrity sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ== - -cose-base@^1.0.0: - version "1.0.3" - resolved "https://registry.yarnpkg.com/cose-base/-/cose-base-1.0.3.tgz#650334b41b869578a543358b80cda7e0abe0a60a" - integrity sha512-s9whTXInMSgAp/NVXVNuVxVKzGH2qck3aQlVHxDCdAEPgtMKwc4Wq6/QKhgdEdgbLSi9rBTAcPoRa6JpiG4ksg== - dependencies: - layout-base "^1.0.0" - -cose-base@^2.2.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/cose-base/-/cose-base-2.2.0.tgz#1c395c35b6e10bb83f9769ca8b817d614add5c01" - integrity sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g== - dependencies: - layout-base "^2.0.0" - -cosmiconfig@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-6.0.0.tgz#da4fee853c52f6b1e6935f41c1a2fc50bd4a9982" - integrity sha512-xb3ZL6+L8b9JLLCx3ZdoZy4+2ECphCMo2PwqgP1tlfVq6M6YReyzBJtvWWtbDSpNr9hn96pkCiZqUcFEc+54Qg== - dependencies: - "@types/parse-json" "^4.0.0" - import-fresh "^3.1.0" - parse-json "^5.0.0" - path-type "^4.0.0" - yaml "^1.7.2" - -cosmiconfig@^7.0.1: - version "7.1.0" - resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-7.1.0.tgz#1443b9afa596b670082ea46cbd8f6a62b84635f6" - integrity sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA== - dependencies: - "@types/parse-json" "^4.0.0" - import-fresh "^3.2.1" - parse-json "^5.0.0" - path-type "^4.0.0" - yaml "^1.10.0" - -cosmiconfig@^8.2.0: - version "8.3.6" - resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-8.3.6.tgz#060a2b871d66dba6c8538ea1118ba1ac16f5fae3" - integrity sha512-kcZ6+W5QzcJ3P1Mt+83OUv/oHFqZHIx8DuxG6eZ5RGMERoLqp4BuGjhHLYGK+Kf5XVkQvqBSmAy/nGWN3qDgEA== - dependencies: - import-fresh "^3.3.0" - js-yaml "^4.1.0" - parse-json "^5.2.0" - path-type "^4.0.0" - -cross-fetch@^3.1.5: - version "3.1.8" - resolved "https://registry.yarnpkg.com/cross-fetch/-/cross-fetch-3.1.8.tgz#0327eba65fd68a7d119f8fb2bf9334a1a7956f82" - integrity sha512-cvA+JwZoU0Xq+h6WkMvAUqPEYy92Obet6UdKLfW60qn99ftItKjB5T+BkyWOFWe2pUyfQ+IJHmpOTznqk1M6Kg== - dependencies: - node-fetch "^2.6.12" - -cross-spawn@^7.0.3: - version "7.0.3" - resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6" - integrity sha512-iRDPJKUPVEND7dHPO8rkbOnPpyDygcDFtWjpeWNCgy8WP2rXcxXL8TskReQl6OrB2G7+UJrags1q15Fudc7G6w== - dependencies: - path-key "^3.1.0" - shebang-command "^2.0.0" - which "^2.0.1" - -crypto-random-string@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/crypto-random-string/-/crypto-random-string-2.0.0.tgz#ef2a7a966ec11083388369baa02ebead229b30d5" - integrity sha512-v1plID3y9r/lPhviJ1wrXpLeyUIGAZ2SHNYTEapm7/8A9nLPoyvVp3RK/EPFqn5kEznyWgYZNsRtYYIWbuG8KA== - -css-declaration-sorter@^6.3.1: - version "6.4.1" - resolved "https://registry.yarnpkg.com/css-declaration-sorter/-/css-declaration-sorter-6.4.1.tgz#28beac7c20bad7f1775be3a7129d7eae409a3a71" - integrity sha512-rtdthzxKuyq6IzqX6jEcIzQF/YqccluefyCYheovBOLhFT/drQA9zj/UbRAa9J7C0o6EG6u3E6g+vKkay7/k3g== - -css-loader@^6.7.1: - version "6.8.1" - resolved "https://registry.yarnpkg.com/css-loader/-/css-loader-6.8.1.tgz#0f8f52699f60f5e679eab4ec0fcd68b8e8a50a88" - integrity sha512-xDAXtEVGlD0gJ07iclwWVkLoZOpEvAWaSyf6W18S2pOC//K8+qUDIx8IIT3D+HjnmkJPQeesOPv5aiUaJsCM2g== - dependencies: - icss-utils "^5.1.0" - postcss "^8.4.21" - postcss-modules-extract-imports "^3.0.0" - postcss-modules-local-by-default "^4.0.3" - postcss-modules-scope "^3.0.0" - postcss-modules-values "^4.0.0" - postcss-value-parser "^4.2.0" - semver "^7.3.8" - -css-minimizer-webpack-plugin@^4.0.0: - version "4.2.2" - resolved "https://registry.yarnpkg.com/css-minimizer-webpack-plugin/-/css-minimizer-webpack-plugin-4.2.2.tgz#79f6199eb5adf1ff7ba57f105e3752d15211eb35" - integrity sha512-s3Of/4jKfw1Hj9CxEO1E5oXhQAxlayuHO2y/ML+C6I9sQ7FdzfEV6QgMLN3vI+qFsjJGIAFLKtQK7t8BOXAIyA== - dependencies: - cssnano "^5.1.8" - jest-worker "^29.1.2" - postcss "^8.4.17" - schema-utils "^4.0.0" - serialize-javascript "^6.0.0" - source-map "^0.6.1" - -css-select@^4.1.3: - version "4.3.0" - resolved "https://registry.yarnpkg.com/css-select/-/css-select-4.3.0.tgz#db7129b2846662fd8628cfc496abb2b59e41529b" - integrity sha512-wPpOYtnsVontu2mODhA19JrqWxNsfdatRKd64kmpRbQgh1KtItko5sTnEpPdpSaJszTOhEMlF/RPz28qj4HqhQ== - dependencies: - boolbase "^1.0.0" - css-what "^6.0.1" - domhandler "^4.3.1" - domutils "^2.8.0" - nth-check "^2.0.1" - -css-select@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/css-select/-/css-select-5.1.0.tgz#b8ebd6554c3637ccc76688804ad3f6a6fdaea8a6" - integrity sha512-nwoRF1rvRRnnCqqY7updORDsuqKzqYJ28+oSMaJMMgOauh3fvwHqMS7EZpIPqK8GL+g9mKxF1vP/ZjSeNjEVHg== - dependencies: - boolbase "^1.0.0" - css-what "^6.1.0" - domhandler "^5.0.2" - domutils "^3.0.1" - nth-check "^2.0.1" - -css-tree@^1.1.2, css-tree@^1.1.3: - version "1.1.3" - resolved "https://registry.yarnpkg.com/css-tree/-/css-tree-1.1.3.tgz#eb4870fb6fd7707327ec95c2ff2ab09b5e8db91d" - integrity sha512-tRpdppF7TRazZrjJ6v3stzv93qxRcSsFmW6cX0Zm2NVKpxE1WV1HblnghVv9TreireHkqI/VDEsfolRF1p6y7Q== - dependencies: - mdn-data "2.0.14" - source-map "^0.6.1" - -css-what@^6.0.1, css-what@^6.1.0: - version "6.1.0" - resolved "https://registry.yarnpkg.com/css-what/-/css-what-6.1.0.tgz#fb5effcf76f1ddea2c81bdfaa4de44e79bac70f4" - integrity sha512-HTUrgRJ7r4dsZKU6GjmpfRK1O76h97Z8MfS1G0FozR+oF2kG6Vfe8JE6zwrkbxigziPHinCJ+gCPjA9EaBDtRw== - -cssesc@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/cssesc/-/cssesc-3.0.0.tgz#37741919903b868565e1c09ea747445cd18983ee" - integrity sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg== - -cssnano-preset-advanced@^5.3.8: - version "5.3.10" - resolved "https://registry.yarnpkg.com/cssnano-preset-advanced/-/cssnano-preset-advanced-5.3.10.tgz#25558a1fbf3a871fb6429ce71e41be7f5aca6eef" - integrity sha512-fnYJyCS9jgMU+cmHO1rPSPf9axbQyD7iUhLO5Df6O4G+fKIOMps+ZbU0PdGFejFBBZ3Pftf18fn1eG7MAPUSWQ== - dependencies: - autoprefixer "^10.4.12" - cssnano-preset-default "^5.2.14" - postcss-discard-unused "^5.1.0" - postcss-merge-idents "^5.1.1" - postcss-reduce-idents "^5.2.0" - postcss-zindex "^5.1.0" - -cssnano-preset-default@^5.2.14: - version "5.2.14" - resolved "https://registry.yarnpkg.com/cssnano-preset-default/-/cssnano-preset-default-5.2.14.tgz#309def4f7b7e16d71ab2438052093330d9ab45d8" - integrity sha512-t0SFesj/ZV2OTylqQVOrFgEh5uanxbO6ZAdeCrNsUQ6fVuXwYTxJPNAGvGTxHbD68ldIJNec7PyYZDBrfDQ+6A== - dependencies: - css-declaration-sorter "^6.3.1" - cssnano-utils "^3.1.0" - postcss-calc "^8.2.3" - postcss-colormin "^5.3.1" - postcss-convert-values "^5.1.3" - postcss-discard-comments "^5.1.2" - postcss-discard-duplicates "^5.1.0" - postcss-discard-empty "^5.1.1" - postcss-discard-overridden "^5.1.0" - postcss-merge-longhand "^5.1.7" - postcss-merge-rules "^5.1.4" - postcss-minify-font-values "^5.1.0" - postcss-minify-gradients "^5.1.1" - postcss-minify-params "^5.1.4" - postcss-minify-selectors "^5.2.1" - postcss-normalize-charset "^5.1.0" - postcss-normalize-display-values "^5.1.0" - postcss-normalize-positions "^5.1.1" - postcss-normalize-repeat-style "^5.1.1" - postcss-normalize-string "^5.1.0" - postcss-normalize-timing-functions "^5.1.0" - postcss-normalize-unicode "^5.1.1" - postcss-normalize-url "^5.1.0" - postcss-normalize-whitespace "^5.1.1" - postcss-ordered-values "^5.1.3" - postcss-reduce-initial "^5.1.2" - postcss-reduce-transforms "^5.1.0" - postcss-svgo "^5.1.0" - postcss-unique-selectors "^5.1.1" - -cssnano-utils@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/cssnano-utils/-/cssnano-utils-3.1.0.tgz#95684d08c91511edfc70d2636338ca37ef3a6861" - integrity sha512-JQNR19/YZhz4psLX/rQ9M83e3z2Wf/HdJbryzte4a3NSuafyp9w/I4U+hx5C2S9g41qlstH7DEWnZaaj83OuEA== - -cssnano@^5.1.12, cssnano@^5.1.8: - version "5.1.15" - resolved "https://registry.yarnpkg.com/cssnano/-/cssnano-5.1.15.tgz#ded66b5480d5127fcb44dac12ea5a983755136bf" - integrity sha512-j+BKgDcLDQA+eDifLx0EO4XSA56b7uut3BQFH+wbSaSTuGLuiyTa/wbRYthUXX8LC9mLg+WWKe8h+qJuwTAbHw== - dependencies: - cssnano-preset-default "^5.2.14" - lilconfig "^2.0.3" - yaml "^1.10.2" - -csso@^4.2.0: - version "4.2.0" - resolved "https://registry.yarnpkg.com/csso/-/csso-4.2.0.tgz#ea3a561346e8dc9f546d6febedd50187cf389529" - integrity sha512-wvlcdIbf6pwKEk7vHj8/Bkc0B4ylXZruLvOgs9doS5eOsOpuodOV2zJChSpkp+pRpYQLQMeF04nr3Z68Sta9jA== - dependencies: - css-tree "^1.1.2" - -csstype@^3.0.2: - version "3.1.2" - resolved "https://registry.yarnpkg.com/csstype/-/csstype-3.1.2.tgz#1d4bf9d572f11c14031f0436e1c10bc1f571f50b" - integrity sha512-I7K1Uu0MBPzaFKg4nI5Q7Vs2t+3gWWW648spaF+Rg7pI9ds18Ugn+lvg4SHczUdKlHI5LWBXyqfS8+DufyBsgQ== - -cytoscape-cose-bilkent@^4.1.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/cytoscape-cose-bilkent/-/cytoscape-cose-bilkent-4.1.0.tgz#762fa121df9930ffeb51a495d87917c570ac209b" - integrity sha512-wgQlVIUJF13Quxiv5e1gstZ08rnZj2XaLHGoFMYXz7SkNfCDOOteKBE6SYRfA9WxxI/iBc3ajfDoc6hb/MRAHQ== - dependencies: - cose-base "^1.0.0" - -cytoscape-fcose@^2.1.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/cytoscape-fcose/-/cytoscape-fcose-2.2.0.tgz#e4d6f6490df4fab58ae9cea9e5c3ab8d7472f471" - integrity sha512-ki1/VuRIHFCzxWNrsshHYPs6L7TvLu3DL+TyIGEsRcvVERmxokbf5Gdk7mFxZnTdiGtnA4cfSmjZJMviqSuZrQ== - dependencies: - cose-base "^2.2.0" - -cytoscape@^3.23.0: - version "3.27.0" - resolved "https://registry.yarnpkg.com/cytoscape/-/cytoscape-3.27.0.tgz#5141cd694570807c91075b609181bce102e0bb88" - integrity sha512-pPZJilfX9BxESwujODz5pydeGi+FBrXq1rcaB1mfhFXXFJ9GjE6CNndAk+8jPzoXGD+16LtSS4xlYEIUiW4Abg== - dependencies: - heap "^0.2.6" - lodash "^4.17.21" - -"d3-array@2 - 3", "d3-array@2.10.0 - 3", "d3-array@2.5.0 - 3", d3-array@3, d3-array@^3.2.0: - version "3.2.4" - resolved "https://registry.yarnpkg.com/d3-array/-/d3-array-3.2.4.tgz#15fec33b237f97ac5d7c986dc77da273a8ed0bb5" - integrity sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg== - dependencies: - internmap "1 - 2" - -d3-axis@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-axis/-/d3-axis-3.0.0.tgz#c42a4a13e8131d637b745fc2973824cfeaf93322" - integrity sha512-IH5tgjV4jE/GhHkRV0HiVYPDtvfjHQlQfJHs0usq7M30XcSBvOotpmH1IgkcXsO/5gEQZD43B//fc7SRT5S+xw== - -d3-brush@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-brush/-/d3-brush-3.0.0.tgz#6f767c4ed8dcb79de7ede3e1c0f89e63ef64d31c" - integrity sha512-ALnjWlVYkXsVIGlOsuWH1+3udkYFI48Ljihfnh8FZPF2QS9o+PzGLBslO0PjzVoHLZ2KCVgAM8NVkXPJB2aNnQ== - dependencies: - d3-dispatch "1 - 3" - d3-drag "2 - 3" - d3-interpolate "1 - 3" - d3-selection "3" - d3-transition "3" - -d3-chord@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-chord/-/d3-chord-3.0.1.tgz#d156d61f485fce8327e6abf339cb41d8cbba6966" - integrity sha512-VE5S6TNa+j8msksl7HwjxMHDM2yNK3XCkusIlpX5kwauBfXuyLAtNg9jCp/iHH61tgI4sb6R/EIMWCqEIdjT/g== - dependencies: - d3-path "1 - 3" - -"d3-color@1 - 3", d3-color@3: - version "3.1.0" - resolved "https://registry.yarnpkg.com/d3-color/-/d3-color-3.1.0.tgz#395b2833dfac71507f12ac2f7af23bf819de24e2" - integrity sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA== - -d3-contour@4: - version "4.0.2" - resolved "https://registry.yarnpkg.com/d3-contour/-/d3-contour-4.0.2.tgz#bb92063bc8c5663acb2422f99c73cbb6c6ae3bcc" - integrity sha512-4EzFTRIikzs47RGmdxbeUvLWtGedDUNkTcmzoeyg4sP/dvCexO47AaQL7VKy/gul85TOxw+IBgA8US2xwbToNA== - dependencies: - d3-array "^3.2.0" - -d3-delaunay@6: - version "6.0.4" - resolved "https://registry.yarnpkg.com/d3-delaunay/-/d3-delaunay-6.0.4.tgz#98169038733a0a5babbeda55054f795bb9e4a58b" - integrity sha512-mdjtIZ1XLAM8bm/hx3WwjfHt6Sggek7qH043O8KEjDXN40xi3vx/6pYSVTwLjEgiXQTbvaouWKynLBiUZ6SK6A== - dependencies: - delaunator "5" - -"d3-dispatch@1 - 3", d3-dispatch@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-dispatch/-/d3-dispatch-3.0.1.tgz#5fc75284e9c2375c36c839411a0cf550cbfc4d5e" - integrity sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg== - -"d3-drag@2 - 3", d3-drag@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-drag/-/d3-drag-3.0.0.tgz#994aae9cd23c719f53b5e10e3a0a6108c69607ba" - integrity sha512-pWbUJLdETVA8lQNJecMxoXfH6x+mO2UQo8rSmZ+QqxcbyA3hfeprFgIT//HW2nlHChWeIIMwS2Fq+gEARkhTkg== - dependencies: - d3-dispatch "1 - 3" - d3-selection "3" - -"d3-dsv@1 - 3", d3-dsv@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-dsv/-/d3-dsv-3.0.1.tgz#c63af978f4d6a0d084a52a673922be2160789b73" - integrity sha512-UG6OvdI5afDIFP9w4G0mNq50dSOsXHJaRE8arAS5o9ApWnIElp8GZw1Dun8vP8OyHOZ/QJUKUJwxiiCCnUwm+Q== - dependencies: - commander "7" - iconv-lite "0.6" - rw "1" - -"d3-ease@1 - 3", d3-ease@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-ease/-/d3-ease-3.0.1.tgz#9658ac38a2140d59d346160f1f6c30fda0bd12f4" - integrity sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w== - -d3-fetch@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-fetch/-/d3-fetch-3.0.1.tgz#83141bff9856a0edb5e38de89cdcfe63d0a60a22" - integrity sha512-kpkQIM20n3oLVBKGg6oHrUchHM3xODkTzjMoj7aWQFq5QEM+R6E4WkzT5+tojDY7yjez8KgCBRoj4aEr99Fdqw== - dependencies: - d3-dsv "1 - 3" - -d3-force@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-force/-/d3-force-3.0.0.tgz#3e2ba1a61e70888fe3d9194e30d6d14eece155c4" - integrity sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg== - dependencies: - d3-dispatch "1 - 3" - d3-quadtree "1 - 3" - d3-timer "1 - 3" - -"d3-format@1 - 3", d3-format@3: - version "3.1.0" - resolved "https://registry.yarnpkg.com/d3-format/-/d3-format-3.1.0.tgz#9260e23a28ea5cb109e93b21a06e24e2ebd55641" - integrity sha512-YyUI6AEuY/Wpt8KWLgZHsIU86atmikuoOmCfommt0LYHiQSPjvX2AcFc38PX0CBpr2RCyZhjex+NS/LPOv6YqA== - -d3-geo@3: - version "3.1.0" - resolved "https://registry.yarnpkg.com/d3-geo/-/d3-geo-3.1.0.tgz#74fd54e1f4cebd5185ac2039217a98d39b0a4c0e" - integrity sha512-JEo5HxXDdDYXCaWdwLRt79y7giK8SbhZJbFWXqbRTolCHFI5jRqteLzCsq51NKbUoX0PjBVSohxrx+NoOUujYA== - dependencies: - d3-array "2.5.0 - 3" - -d3-hierarchy@3: - version "3.1.2" - resolved "https://registry.yarnpkg.com/d3-hierarchy/-/d3-hierarchy-3.1.2.tgz#b01cd42c1eed3d46db77a5966cf726f8c09160c6" - integrity sha512-FX/9frcub54beBdugHjDCdikxThEqjnR93Qt7PvQTOHxyiNCAlvMrHhclk3cD5VeAaq9fxmfRp+CnWw9rEMBuA== - -"d3-interpolate@1 - 3", "d3-interpolate@1.2.0 - 3", d3-interpolate@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-interpolate/-/d3-interpolate-3.0.1.tgz#3c47aa5b32c5b3dfb56ef3fd4342078a632b400d" - integrity sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g== - dependencies: - d3-color "1 - 3" - -"d3-path@1 - 3", d3-path@3, d3-path@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/d3-path/-/d3-path-3.1.0.tgz#22df939032fb5a71ae8b1800d61ddb7851c42526" - integrity sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ== - -d3-polygon@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-polygon/-/d3-polygon-3.0.1.tgz#0b45d3dd1c48a29c8e057e6135693ec80bf16398" - integrity sha512-3vbA7vXYwfe1SYhED++fPUQlWSYTTGmFmQiany/gdbiWgU/iEyQzyymwL9SkJjFFuCS4902BSzewVGsHHmHtXg== - -"d3-quadtree@1 - 3", d3-quadtree@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-quadtree/-/d3-quadtree-3.0.1.tgz#6dca3e8be2b393c9a9d514dabbd80a92deef1a4f" - integrity sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw== - -d3-random@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-random/-/d3-random-3.0.1.tgz#d4926378d333d9c0bfd1e6fa0194d30aebaa20f4" - integrity sha512-FXMe9GfxTxqd5D6jFsQ+DJ8BJS4E/fT5mqqdjovykEB2oFbTMDVdg1MGFxfQW+FBOGoB++k8swBrgwSHT1cUXQ== - -d3-scale-chromatic@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-scale-chromatic/-/d3-scale-chromatic-3.0.0.tgz#15b4ceb8ca2bb0dcb6d1a641ee03d59c3b62376a" - integrity sha512-Lx9thtxAKrO2Pq6OO2Ua474opeziKr279P/TKZsMAhYyNDD3EnCffdbgeSYN5O7m2ByQsxtuP2CSDczNUIZ22g== - dependencies: - d3-color "1 - 3" - d3-interpolate "1 - 3" - -d3-scale@4: - version "4.0.2" - resolved "https://registry.yarnpkg.com/d3-scale/-/d3-scale-4.0.2.tgz#82b38e8e8ff7080764f8dcec77bd4be393689396" - integrity sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ== - dependencies: - d3-array "2.10.0 - 3" - d3-format "1 - 3" - d3-interpolate "1.2.0 - 3" - d3-time "2.1.1 - 3" - d3-time-format "2 - 4" - -"d3-selection@2 - 3", d3-selection@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-selection/-/d3-selection-3.0.0.tgz#c25338207efa72cc5b9bd1458a1a41901f1e1b31" - integrity sha512-fmTRWbNMmsmWq6xJV8D19U/gw/bwrHfNXxrIN+HfZgnzqTHp9jOmKMhsTUjXOJnZOdZY9Q28y4yebKzqDKlxlQ== - -d3-shape@3: - version "3.2.0" - resolved "https://registry.yarnpkg.com/d3-shape/-/d3-shape-3.2.0.tgz#a1a839cbd9ba45f28674c69d7f855bcf91dfc6a5" - integrity sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA== - dependencies: - d3-path "^3.1.0" - -"d3-time-format@2 - 4", d3-time-format@4: - version "4.1.0" - resolved "https://registry.yarnpkg.com/d3-time-format/-/d3-time-format-4.1.0.tgz#7ab5257a5041d11ecb4fe70a5c7d16a195bb408a" - integrity sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg== - dependencies: - d3-time "1 - 3" - -"d3-time@1 - 3", "d3-time@2.1.1 - 3", d3-time@3: - version "3.1.0" - resolved "https://registry.yarnpkg.com/d3-time/-/d3-time-3.1.0.tgz#9310db56e992e3c0175e1ef385e545e48a9bb5c7" - integrity sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q== - dependencies: - d3-array "2 - 3" - -"d3-timer@1 - 3", d3-timer@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-timer/-/d3-timer-3.0.1.tgz#6284d2a2708285b1abb7e201eda4380af35e63b0" - integrity sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA== - -"d3-transition@2 - 3", d3-transition@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/d3-transition/-/d3-transition-3.0.1.tgz#6869fdde1448868077fdd5989200cb61b2a1645f" - integrity sha512-ApKvfjsSR6tg06xrL434C0WydLr7JewBB3V+/39RMHsaXTOG0zmt/OAXeng5M5LBm0ojmxJrpomQVZ1aPvBL4w== - dependencies: - d3-color "1 - 3" - d3-dispatch "1 - 3" - d3-ease "1 - 3" - d3-interpolate "1 - 3" - d3-timer "1 - 3" - -d3-zoom@3: - version "3.0.0" - resolved "https://registry.yarnpkg.com/d3-zoom/-/d3-zoom-3.0.0.tgz#d13f4165c73217ffeaa54295cd6969b3e7aee8f3" - integrity sha512-b8AmV3kfQaqWAuacbPuNbL6vahnOJflOhexLzMMNLga62+/nh0JzvJ0aO/5a5MVgUFGS7Hu1P9P03o3fJkDCyw== - dependencies: - d3-dispatch "1 - 3" - d3-drag "2 - 3" - d3-interpolate "1 - 3" - d3-selection "2 - 3" - d3-transition "2 - 3" - -d3@^7.4.0, d3@^7.8.2: - version "7.8.5" - resolved "https://registry.yarnpkg.com/d3/-/d3-7.8.5.tgz#fde4b760d4486cdb6f0cc8e2cbff318af844635c" - integrity sha512-JgoahDG51ncUfJu6wX/1vWQEqOflgXyl4MaHqlcSruTez7yhaRKR9i8VjjcQGeS2en/jnFivXuaIMnseMMt0XA== - dependencies: - d3-array "3" - d3-axis "3" - d3-brush "3" - d3-chord "3" - d3-color "3" - d3-contour "4" - d3-delaunay "6" - d3-dispatch "3" - d3-drag "3" - d3-dsv "3" - d3-ease "3" - d3-fetch "3" - d3-force "3" - d3-format "3" - d3-geo "3" - d3-hierarchy "3" - d3-interpolate "3" - d3-path "3" - d3-polygon "3" - d3-quadtree "3" - d3-random "3" - d3-scale "4" - d3-scale-chromatic "3" - d3-selection "3" - d3-shape "3" - d3-time "3" - d3-time-format "4" - d3-timer "3" - d3-transition "3" - d3-zoom "3" - -dagre-d3-es@7.0.9: - version "7.0.9" - resolved "https://registry.yarnpkg.com/dagre-d3-es/-/dagre-d3-es-7.0.9.tgz#aca12fccd9d09955a4430029ba72ee6934542a8d" - integrity sha512-rYR4QfVmy+sR44IBDvVtcAmOReGBvRCWDpO2QjYwqgh9yijw6eSHBqaPG/LIOEy7aBsniLvtMW6pg19qJhq60w== - dependencies: - d3 "^7.8.2" - lodash-es "^4.17.21" - -dayjs@^1.11.7: - version "1.11.10" - resolved "https://registry.yarnpkg.com/dayjs/-/dayjs-1.11.10.tgz#68acea85317a6e164457d6d6947564029a6a16a0" - integrity sha512-vjAczensTgRcqDERK0SR2XMwsF/tSvnvlv6VcF2GIhg6Sx4yOIt/irsr1RDJsKiIyBzJDpCoXiWWq28MqH2cnQ== - -debug@2.6.9, debug@^2.6.0: - version "2.6.9" - resolved "https://registry.yarnpkg.com/debug/-/debug-2.6.9.tgz#5d128515df134ff327e90a4c93f4e077a536341f" - integrity sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA== - dependencies: - ms "2.0.0" - -debug@4, debug@^4.0.0, debug@^4.1.0, debug@^4.1.1: - version "4.3.4" - resolved "https://registry.yarnpkg.com/debug/-/debug-4.3.4.tgz#1319f6579357f2338d3337d2cdd4914bb5dcc865" - integrity sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ== - dependencies: - ms "2.1.2" - -decompress-response@^3.3.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/decompress-response/-/decompress-response-3.3.0.tgz#80a4dd323748384bfa248083622aedec982adff3" - integrity sha512-BzRPQuY1ip+qDonAOz42gRm/pg9F768C+npV/4JOsxRC2sq+Rlk+Q4ZCAsOhnIaMrgarILY+RMUIvMmmX1qAEA== - dependencies: - mimic-response "^1.0.0" - -deep-extend@^0.6.0: - version "0.6.0" - resolved "https://registry.yarnpkg.com/deep-extend/-/deep-extend-0.6.0.tgz#c4fa7c95404a17a9c3e8ca7e1537312b736330ac" - integrity sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA== - -deepmerge@^4.2.2: - version "4.3.1" - resolved "https://registry.yarnpkg.com/deepmerge/-/deepmerge-4.3.1.tgz#44b5f2147cd3b00d4b56137685966f26fd25dd4a" - integrity sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A== - -default-gateway@^6.0.3: - version "6.0.3" - resolved "https://registry.yarnpkg.com/default-gateway/-/default-gateway-6.0.3.tgz#819494c888053bdb743edbf343d6cdf7f2943a71" - integrity sha512-fwSOJsbbNzZ/CUFpqFBqYfYNLj1NbMPm8MMCIzHjC83iSJRBEGmDUxU+WP661BaBQImeC2yHwXtz+P/O9o+XEg== - dependencies: - execa "^5.0.0" - -defer-to-connect@^1.0.1: - version "1.1.3" - resolved "https://registry.yarnpkg.com/defer-to-connect/-/defer-to-connect-1.1.3.tgz#331ae050c08dcf789f8c83a7b81f0ed94f4ac591" - integrity sha512-0ISdNousHvZT2EiFlZeZAHBUvSxmKswVCEf8hW7KWgG4a8MVEu/3Vb6uWYozkjylyCxe0JBIiRB1jV45S70WVQ== - -define-data-property@^1.0.1: - version "1.1.0" - resolved "https://registry.yarnpkg.com/define-data-property/-/define-data-property-1.1.0.tgz#0db13540704e1d8d479a0656cf781267531b9451" - integrity sha512-UzGwzcjyv3OtAvolTj1GoyNYzfFR+iqbGjcnBEENZVCpM4/Ng1yhGNvS3lR/xDS74Tb2wGG9WzNSNIOS9UVb2g== - dependencies: - get-intrinsic "^1.2.1" - gopd "^1.0.1" - has-property-descriptors "^1.0.0" - -define-lazy-prop@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/define-lazy-prop/-/define-lazy-prop-2.0.0.tgz#3f7ae421129bcaaac9bc74905c98a0009ec9ee7f" - integrity sha512-Ds09qNh8yw3khSjiJjiUInaGX9xlqZDY7JVryGxdxV7NPeuqQfplOpQ66yJFZut3jLa5zOwkXw1g9EI2uKh4Og== - -define-properties@^1.1.4: - version "1.2.1" - resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.2.1.tgz#10781cc616eb951a80a034bafcaa7377f6af2b6c" - integrity sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg== - dependencies: - define-data-property "^1.0.1" - has-property-descriptors "^1.0.0" - object-keys "^1.1.1" - -del@^6.1.1: - version "6.1.1" - resolved "https://registry.yarnpkg.com/del/-/del-6.1.1.tgz#3b70314f1ec0aa325c6b14eb36b95786671edb7a" - integrity sha512-ua8BhapfP0JUJKC/zV9yHHDW/rDoDxP4Zhn3AkA6/xT6gY7jYXJiaeyBZznYVujhZZET+UgcbZiQ7sN3WqcImg== - dependencies: - globby "^11.0.1" - graceful-fs "^4.2.4" - is-glob "^4.0.1" - is-path-cwd "^2.2.0" - is-path-inside "^3.0.2" - p-map "^4.0.0" - rimraf "^3.0.2" - slash "^3.0.0" - -delaunator@5: - version "5.0.0" - resolved "https://registry.yarnpkg.com/delaunator/-/delaunator-5.0.0.tgz#60f052b28bd91c9b4566850ebf7756efe821d81b" - integrity sha512-AyLvtyJdbv/U1GkiS6gUUzclRoAY4Gs75qkMygJJhU75LW4DNuSF2RMzpxs9jw9Oz1BobHjTdkG3zdP55VxAqw== - dependencies: - robust-predicates "^3.0.0" - -depd@2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/depd/-/depd-2.0.0.tgz#b696163cc757560d09cf22cc8fad1571b79e76df" - integrity sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw== - -depd@~1.1.2: - version "1.1.2" - resolved "https://registry.yarnpkg.com/depd/-/depd-1.1.2.tgz#9bcd52e14c097763e749b274c4346ed2e560b5a9" - integrity sha512-7emPTl6Dpo6JRXOXjLRxck+FlLRX5847cLKEn00PLAgc3g2hTZZgr+e4c2v6QpSmLeFP3n5yUo7ft6avBK/5jQ== - -destroy@1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/destroy/-/destroy-1.2.0.tgz#4803735509ad8be552934c67df614f94e66fa015" - integrity sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg== - -detab@2.0.4: - version "2.0.4" - resolved "https://registry.yarnpkg.com/detab/-/detab-2.0.4.tgz#b927892069aff405fbb9a186fe97a44a92a94b43" - integrity sha512-8zdsQA5bIkoRECvCrNKPla84lyoR7DSAyf7p0YgXzBO9PDJx8KntPUay7NS6yp+KdxdVtiE5SpHKtbp2ZQyA9g== - dependencies: - repeat-string "^1.5.4" - -detect-node@^2.0.4: - version "2.1.0" - resolved "https://registry.yarnpkg.com/detect-node/-/detect-node-2.1.0.tgz#c9c70775a49c3d03bc2c06d9a73be550f978f8b1" - integrity sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g== - -detect-port-alt@^1.1.6: - version "1.1.6" - resolved "https://registry.yarnpkg.com/detect-port-alt/-/detect-port-alt-1.1.6.tgz#24707deabe932d4a3cf621302027c2b266568275" - integrity sha512-5tQykt+LqfJFBEYaDITx7S7cR7mJ/zQmLXZ2qt5w04ainYZw6tBf9dBunMjVeVOdYVRUzUOE4HkY5J7+uttb5Q== - dependencies: - address "^1.0.1" - debug "^2.6.0" - -detect-port@^1.3.0: - version "1.5.1" - resolved "https://registry.yarnpkg.com/detect-port/-/detect-port-1.5.1.tgz#451ca9b6eaf20451acb0799b8ab40dff7718727b" - integrity sha512-aBzdj76lueB6uUst5iAs7+0H/oOjqI5D16XUWxlWMIMROhcM0rfsNVk93zTngq1dDNpoXRr++Sus7ETAExppAQ== - dependencies: - address "^1.0.1" - debug "4" - -dir-glob@^3.0.1: - version "3.0.1" - resolved "https://registry.yarnpkg.com/dir-glob/-/dir-glob-3.0.1.tgz#56dbf73d992a4a93ba1584f4534063fd2e41717f" - integrity sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA== - dependencies: - path-type "^4.0.0" - -dns-equal@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/dns-equal/-/dns-equal-1.0.0.tgz#b39e7f1da6eb0a75ba9c17324b34753c47e0654d" - integrity sha512-z+paD6YUQsk+AbGCEM4PrOXSss5gd66QfcVBFTKR/HpFL9jCqikS94HYwKww6fQyO7IxrIIyUu+g0Ka9tUS2Cg== - -dns-packet@^5.2.2: - version "5.6.1" - resolved "https://registry.yarnpkg.com/dns-packet/-/dns-packet-5.6.1.tgz#ae888ad425a9d1478a0674256ab866de1012cf2f" - integrity sha512-l4gcSouhcgIKRvyy99RNVOgxXiicE+2jZoNmaNmZ6JXiGajBOJAesk1OBlJuM5k2c+eudGdLxDqXuPCKIj6kpw== - dependencies: - "@leichtgewicht/ip-codec" "^2.0.1" - -dom-converter@^0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/dom-converter/-/dom-converter-0.2.0.tgz#6721a9daee2e293682955b6afe416771627bb768" - integrity sha512-gd3ypIPfOMr9h5jIKq8E3sHOTCjeirnl0WK5ZdS1AW0Odt0b1PaWaHdJ4Qk4klv+YB9aJBS7mESXjFoDQPu6DA== - dependencies: - utila "~0.4" - -dom-serializer@^1.0.1: - version "1.4.1" - resolved "https://registry.yarnpkg.com/dom-serializer/-/dom-serializer-1.4.1.tgz#de5d41b1aea290215dc45a6dae8adcf1d32e2d30" - integrity sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag== - dependencies: - domelementtype "^2.0.1" - domhandler "^4.2.0" - entities "^2.0.0" - -dom-serializer@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/dom-serializer/-/dom-serializer-2.0.0.tgz#e41b802e1eedf9f6cae183ce5e622d789d7d8e53" - integrity sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg== - dependencies: - domelementtype "^2.3.0" - domhandler "^5.0.2" - entities "^4.2.0" - -domelementtype@^2.0.1, domelementtype@^2.2.0, domelementtype@^2.3.0: - version "2.3.0" - resolved "https://registry.yarnpkg.com/domelementtype/-/domelementtype-2.3.0.tgz#5c45e8e869952626331d7aab326d01daf65d589d" - integrity sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw== - -domhandler@^4.0.0, domhandler@^4.2.0, domhandler@^4.3.1: - version "4.3.1" - resolved "https://registry.yarnpkg.com/domhandler/-/domhandler-4.3.1.tgz#8d792033416f59d68bc03a5aa7b018c1ca89279c" - integrity sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ== - dependencies: - domelementtype "^2.2.0" - -domhandler@^5.0.2, domhandler@^5.0.3: - version "5.0.3" - resolved "https://registry.yarnpkg.com/domhandler/-/domhandler-5.0.3.tgz#cc385f7f751f1d1fc650c21374804254538c7d31" - integrity sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w== - dependencies: - domelementtype "^2.3.0" - -dompurify@2.4.3: - version "2.4.3" - resolved "https://registry.yarnpkg.com/dompurify/-/dompurify-2.4.3.tgz#f4133af0e6a50297fc8874e2eaedc13a3c308c03" - integrity sha512-q6QaLcakcRjebxjg8/+NP+h0rPfatOgOzc46Fst9VAA3jF2ApfKBNKMzdP4DYTqtUMXSCd5pRS/8Po/OmoCHZQ== - -domutils@^2.5.2, domutils@^2.8.0: - version "2.8.0" - resolved "https://registry.yarnpkg.com/domutils/-/domutils-2.8.0.tgz#4437def5db6e2d1f5d6ee859bd95ca7d02048135" - integrity sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A== - dependencies: - dom-serializer "^1.0.1" - domelementtype "^2.2.0" - domhandler "^4.2.0" - -domutils@^3.0.1: - version "3.1.0" - resolved "https://registry.yarnpkg.com/domutils/-/domutils-3.1.0.tgz#c47f551278d3dc4b0b1ab8cbb42d751a6f0d824e" - integrity sha512-H78uMmQtI2AhgDJjWeQmHwJJ2bLPD3GMmO7Zja/ZZh84wkm+4ut+IUnUdRa8uCGX88DiVx1j6FRe1XfxEgjEZA== - dependencies: - dom-serializer "^2.0.0" - domelementtype "^2.3.0" - domhandler "^5.0.3" - -dot-case@^3.0.4: - version "3.0.4" - resolved "https://registry.yarnpkg.com/dot-case/-/dot-case-3.0.4.tgz#9b2b670d00a431667a8a75ba29cd1b98809ce751" - integrity sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w== - dependencies: - no-case "^3.0.4" - tslib "^2.0.3" - -dot-prop@^5.2.0: - version "5.3.0" - resolved "https://registry.yarnpkg.com/dot-prop/-/dot-prop-5.3.0.tgz#90ccce708cd9cd82cc4dc8c3ddd9abdd55b20e88" - integrity sha512-QM8q3zDe58hqUqjraQOmzZ1LIH9SWQJTlEKCH4kJ2oQvLZk7RbQXvtDM2XEq3fwkV9CCvvH4LA0AV+ogFsBM2Q== - dependencies: - is-obj "^2.0.0" - -duplexer3@^0.1.4: - version "0.1.5" - resolved "https://registry.yarnpkg.com/duplexer3/-/duplexer3-0.1.5.tgz#0b5e4d7bad5de8901ea4440624c8e1d20099217e" - integrity sha512-1A8za6ws41LQgv9HrE/66jyC5yuSjQ3L/KOpFtoBilsAK2iA2wuS5rTt1OCzIvtS2V7nVmedsUU+DGRcjBmOYA== - -duplexer@^0.1.2: - version "0.1.2" - resolved "https://registry.yarnpkg.com/duplexer/-/duplexer-0.1.2.tgz#3abe43aef3835f8ae077d136ddce0f276b0400e6" - integrity sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg== - -eastasianwidth@^0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/eastasianwidth/-/eastasianwidth-0.2.0.tgz#696ce2ec0aa0e6ea93a397ffcf24aa7840c827cb" - integrity sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA== - -ee-first@1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/ee-first/-/ee-first-1.1.1.tgz#590c61156b0ae2f4f0255732a158b266bc56b21d" - integrity sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow== - -electron-to-chromium@^1.4.535: - version "1.4.549" - resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.4.549.tgz#ab223f5d85c55a9def358db163bc8cacba72df69" - integrity sha512-gpXfJslSi4hYDkA0mTLEpYKRv9siAgSUgZ+UWyk+J5Cttpd1ThCVwdclzIwQSclz3hYn049+M2fgrP1WpvF8xg== - -elkjs@^0.8.2: - version "0.8.2" - resolved "https://registry.yarnpkg.com/elkjs/-/elkjs-0.8.2.tgz#c37763c5a3e24e042e318455e0147c912a7c248e" - integrity sha512-L6uRgvZTH+4OF5NE/MBbzQx/WYpru1xCBE9respNj6qznEewGUIfhzmm7horWWxbNO2M0WckQypGctR8lH79xQ== - -emoji-regex@^8.0.0: - version "8.0.0" - resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-8.0.0.tgz#e818fd69ce5ccfcb404594f842963bf53164cc37" - integrity sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A== - -emoji-regex@^9.2.2: - version "9.2.2" - resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-9.2.2.tgz#840c8803b0d8047f4ff0cf963176b32d4ef3ed72" - integrity sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg== - -emojis-list@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/emojis-list/-/emojis-list-3.0.0.tgz#5570662046ad29e2e916e71aae260abdff4f6a78" - integrity sha512-/kyM18EfinwXZbno9FyUGeFh87KC8HRQBQGildHZbEuRyWFOmv1U10o9BBp8XVZDVNNuQKyIGIu5ZYAAXJ0V2Q== - -emoticon@^3.2.0: - version "3.2.0" - resolved "https://registry.yarnpkg.com/emoticon/-/emoticon-3.2.0.tgz#c008ca7d7620fac742fe1bf4af8ff8fed154ae7f" - integrity sha512-SNujglcLTTg+lDAcApPNgEdudaqQFiAbJCqzjNxJkvN9vAwCGi0uu8IUVvx+f16h+V44KCY6Y2yboroc9pilHg== - -encodeurl@~1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/encodeurl/-/encodeurl-1.0.2.tgz#ad3ff4c86ec2d029322f5a02c3a9a606c95b3f59" - integrity sha512-TPJXq8JqFaVYm2CWmPvnP2Iyo4ZSM7/QKcSmuMLDObfpH5fi7RUGmd/rTDf+rut/saiDiQEeVTNgAmJEdAOx0w== - -end-of-stream@^1.1.0: - version "1.4.4" - resolved "https://registry.yarnpkg.com/end-of-stream/-/end-of-stream-1.4.4.tgz#5ae64a5f45057baf3626ec14da0ca5e4b2431eb0" - integrity sha512-+uw1inIHVPQoaVuHzRyXd21icM+cnt4CzD5rW+NC1wjOUSTOs+Te7FOv7AhN7vS9x/oIyhLP5PR1H+phQAHu5Q== - dependencies: - once "^1.4.0" - -enhanced-resolve@^5.15.0: - version "5.15.0" - resolved "https://registry.yarnpkg.com/enhanced-resolve/-/enhanced-resolve-5.15.0.tgz#1af946c7d93603eb88e9896cee4904dc012e9c35" - integrity sha512-LXYT42KJ7lpIKECr2mAXIaMldcNCh/7E0KBKOu4KSfkHmP+mZmSs+8V5gBAqisWBy0OO4W5Oyys0GO1Y8KtdKg== - dependencies: - graceful-fs "^4.2.4" - tapable "^2.2.0" - -entities@^2.0.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/entities/-/entities-2.2.0.tgz#098dc90ebb83d8dffa089d55256b351d34c4da55" - integrity sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A== - -entities@^4.2.0, entities@^4.4.0: - version "4.5.0" - resolved "https://registry.yarnpkg.com/entities/-/entities-4.5.0.tgz#5d268ea5e7113ec74c4d033b79ea5a35a488fb48" - integrity sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw== - -error-ex@^1.3.1: - version "1.3.2" - resolved "https://registry.yarnpkg.com/error-ex/-/error-ex-1.3.2.tgz#b4ac40648107fdcdcfae242f428bea8a14d4f1bf" - integrity sha512-7dFHNmqeFSEt2ZBsCriorKnn3Z2pj+fd9kmI6QoWw4//DL+icEBfc0U7qJCisqrTsKTjw4fNFy2pW9OqStD84g== - dependencies: - is-arrayish "^0.2.1" - -es-module-lexer@^1.2.1: - version "1.3.1" - resolved "https://registry.yarnpkg.com/es-module-lexer/-/es-module-lexer-1.3.1.tgz#c1b0dd5ada807a3b3155315911f364dc4e909db1" - integrity sha512-JUFAyicQV9mXc3YRxPnDlrfBKpqt6hUYzz9/boprUJHs4e4KVr3XwOF70doO6gwXUor6EWZJAyWAfKki84t20Q== - -escalade@^3.1.1: - version "3.1.1" - resolved "https://registry.yarnpkg.com/escalade/-/escalade-3.1.1.tgz#d8cfdc7000965c5a0174b4a82eaa5c0552742e40" - integrity sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw== - -escape-goat@^2.0.0: - version "2.1.1" - resolved "https://registry.yarnpkg.com/escape-goat/-/escape-goat-2.1.1.tgz#1b2dc77003676c457ec760b2dc68edb648188675" - integrity sha512-8/uIhbG12Csjy2JEW7D9pHbreaVaS/OpN3ycnyvElTdwM5n6GY6W6e2IPemfvGZeUMqZ9A/3GqIZMgKnBhAw/Q== - -escape-html@^1.0.3, escape-html@~1.0.3: - version "1.0.3" - resolved "https://registry.yarnpkg.com/escape-html/-/escape-html-1.0.3.tgz#0258eae4d3d0c0974de1c169188ef0051d1d1988" - integrity sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow== - -escape-string-regexp@^1.0.5: - version "1.0.5" - resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4" - integrity sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg== - -escape-string-regexp@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz#14ba83a5d373e3d311e5afca29cf5bfad965bf34" - integrity sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA== - -eslint-scope@5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/eslint-scope/-/eslint-scope-5.1.1.tgz#e786e59a66cb92b3f6c1fb0d508aab174848f48c" - integrity sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw== - dependencies: - esrecurse "^4.3.0" - estraverse "^4.1.1" - -esprima@^4.0.0: - version "4.0.1" - resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71" - integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A== - -esrecurse@^4.3.0: - version "4.3.0" - resolved "https://registry.yarnpkg.com/esrecurse/-/esrecurse-4.3.0.tgz#7ad7964d679abb28bee72cec63758b1c5d2c9921" - integrity sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag== - dependencies: - estraverse "^5.2.0" - -estraverse@^4.1.1: - version "4.3.0" - resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-4.3.0.tgz#398ad3f3c5a24948be7725e83d11a7de28cdbd1d" - integrity sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw== - -estraverse@^5.2.0: - version "5.3.0" - resolved "https://registry.yarnpkg.com/estraverse/-/estraverse-5.3.0.tgz#2eea5290702f26ab8fe5370370ff86c965d21123" - integrity sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA== - -esutils@^2.0.2: - version "2.0.3" - resolved "https://registry.yarnpkg.com/esutils/-/esutils-2.0.3.tgz#74d2eb4de0b8da1293711910d50775b9b710ef64" - integrity sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g== - -eta@^2.0.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/eta/-/eta-2.2.0.tgz#eb8b5f8c4e8b6306561a455e62cd7492fe3a9b8a" - integrity sha512-UVQ72Rqjy/ZKQalzV5dCCJP80GrmPrMxh6NlNf+erV6ObL0ZFkhCstWRawS85z3smdr3d2wXPsZEY7rDPfGd2g== - -etag@~1.8.1: - version "1.8.1" - resolved "https://registry.yarnpkg.com/etag/-/etag-1.8.1.tgz#41ae2eeb65efa62268aebfea83ac7d79299b0887" - integrity sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg== - -eval@^0.1.8: - version "0.1.8" - resolved "https://registry.yarnpkg.com/eval/-/eval-0.1.8.tgz#2b903473b8cc1d1989b83a1e7923f883eb357f85" - integrity sha512-EzV94NYKoO09GLXGjXj9JIlXijVck4ONSr5wiCWDvhsvj5jxSrzTmRU/9C1DyB6uToszLs8aifA6NQ7lEQdvFw== - dependencies: - "@types/node" "*" - require-like ">= 0.1.1" - -eventemitter3@^4.0.0: - version "4.0.7" - resolved "https://registry.yarnpkg.com/eventemitter3/-/eventemitter3-4.0.7.tgz#2de9b68f6528d5644ef5c59526a1b4a07306169f" - integrity sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw== - -events@^3.2.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/events/-/events-3.3.0.tgz#31a95ad0a924e2d2c419a813aeb2c4e878ea7400" - integrity sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q== - -execa@^5.0.0: - version "5.1.1" - resolved "https://registry.yarnpkg.com/execa/-/execa-5.1.1.tgz#f80ad9cbf4298f7bd1d4c9555c21e93741c411dd" - integrity sha512-8uSpZZocAZRBAPIEINJj3Lo9HyGitllczc27Eh5YYojjMFMn8yHMDMaUHE2Jqfq05D/wucwI4JGURyXt1vchyg== - dependencies: - cross-spawn "^7.0.3" - get-stream "^6.0.0" - human-signals "^2.1.0" - is-stream "^2.0.0" - merge-stream "^2.0.0" - npm-run-path "^4.0.1" - onetime "^5.1.2" - signal-exit "^3.0.3" - strip-final-newline "^2.0.0" - -express@^4.17.3: - version "4.18.2" - resolved "https://registry.yarnpkg.com/express/-/express-4.18.2.tgz#3fabe08296e930c796c19e3c516979386ba9fd59" - integrity sha512-5/PsL6iGPdfQ/lKM1UuielYgv3BUoJfz1aUwU9vHZ+J7gyvwdQXFEBIEIaxeGf0GIcreATNyBExtalisDbuMqQ== - dependencies: - accepts "~1.3.8" - array-flatten "1.1.1" - body-parser "1.20.1" - content-disposition "0.5.4" - content-type "~1.0.4" - cookie "0.5.0" - cookie-signature "1.0.6" - debug "2.6.9" - depd "2.0.0" - encodeurl "~1.0.2" - escape-html "~1.0.3" - etag "~1.8.1" - finalhandler "1.2.0" - fresh "0.5.2" - http-errors "2.0.0" - merge-descriptors "1.0.1" - methods "~1.1.2" - on-finished "2.4.1" - parseurl "~1.3.3" - path-to-regexp "0.1.7" - proxy-addr "~2.0.7" - qs "6.11.0" - range-parser "~1.2.1" - safe-buffer "5.2.1" - send "0.18.0" - serve-static "1.15.0" - setprototypeof "1.2.0" - statuses "2.0.1" - type-is "~1.6.18" - utils-merge "1.0.1" - vary "~1.1.2" - -extend-shallow@^2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/extend-shallow/-/extend-shallow-2.0.1.tgz#51af7d614ad9a9f610ea1bafbb989d6b1c56890f" - integrity sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug== - dependencies: - is-extendable "^0.1.0" - -extend@^3.0.0: - version "3.0.2" - resolved "https://registry.yarnpkg.com/extend/-/extend-3.0.2.tgz#f8b1136b4071fbd8eb140aff858b1019ec2915fa" - integrity sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g== - -fast-deep-equal@^3.1.1, fast-deep-equal@^3.1.3: - version "3.1.3" - resolved "https://registry.yarnpkg.com/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz#3a7d56b559d6cbc3eb512325244e619a65c6c525" - integrity sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q== - -fast-glob@^3.2.11, fast-glob@^3.2.9, fast-glob@^3.3.0: - version "3.3.1" - resolved "https://registry.yarnpkg.com/fast-glob/-/fast-glob-3.3.1.tgz#784b4e897340f3dbbef17413b3f11acf03c874c4" - integrity sha512-kNFPyjhh5cKjrUltxs+wFx+ZkbRaxxmZ+X0ZU31SOsxCEtP9VPgtq2teZw1DebupL5GmDaNQ6yKMMVcM41iqDg== - dependencies: - "@nodelib/fs.stat" "^2.0.2" - "@nodelib/fs.walk" "^1.2.3" - glob-parent "^5.1.2" - merge2 "^1.3.0" - micromatch "^4.0.4" - -fast-json-stable-stringify@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz#874bf69c6f404c2b5d99c481341399fd55892633" - integrity sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw== - -fast-url-parser@1.1.3: - version "1.1.3" - resolved "https://registry.yarnpkg.com/fast-url-parser/-/fast-url-parser-1.1.3.tgz#f4af3ea9f34d8a271cf58ad2b3759f431f0b318d" - integrity sha512-5jOCVXADYNuRkKFzNJ0dCCewsZiYo0dz8QNYljkOpFC6r2U4OBmKtvm/Tsuh4w1YYdDqDb31a8TVhBJ2OJKdqQ== - dependencies: - punycode "^1.3.2" - -fastq@^1.6.0: - version "1.15.0" - resolved "https://registry.yarnpkg.com/fastq/-/fastq-1.15.0.tgz#d04d07c6a2a68fe4599fea8d2e103a937fae6b3a" - integrity sha512-wBrocU2LCXXa+lWBt8RoIRD89Fi8OdABODa/kEnyeyjS5aZO5/GNvI5sEINADqP/h8M29UHTHUb53sUu5Ihqdw== - dependencies: - reusify "^1.0.4" - -faye-websocket@^0.11.3: - version "0.11.4" - resolved "https://registry.yarnpkg.com/faye-websocket/-/faye-websocket-0.11.4.tgz#7f0d9275cfdd86a1c963dc8b65fcc451edcbb1da" - integrity sha512-CzbClwlXAuiRQAlUyfqPgvPoNKTckTPGfwZV4ZdAhVcP2lh9KUxJg2b5GkE7XbjKQ3YJnQ9z6D9ntLAlB+tP8g== - dependencies: - websocket-driver ">=0.5.1" - -fbemitter@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/fbemitter/-/fbemitter-3.0.0.tgz#00b2a1af5411254aab416cd75f9e6289bee4bff3" - integrity sha512-KWKaceCwKQU0+HPoop6gn4eOHk50bBv/VxjJtGMfwmJt3D29JpN4H4eisCtIPA+a8GVBam+ldMMpMjJUvpDyHw== - dependencies: - fbjs "^3.0.0" - -fbjs-css-vars@^1.0.0: - version "1.0.2" - resolved "https://registry.yarnpkg.com/fbjs-css-vars/-/fbjs-css-vars-1.0.2.tgz#216551136ae02fe255932c3ec8775f18e2c078b8" - integrity sha512-b2XGFAFdWZWg0phtAWLHCk836A1Xann+I+Dgd3Gk64MHKZO44FfoD1KxyvbSh0qZsIoXQGGlVztIY+oitJPpRQ== - -fbjs@^3.0.0, fbjs@^3.0.1: - version "3.0.5" - resolved "https://registry.yarnpkg.com/fbjs/-/fbjs-3.0.5.tgz#aa0edb7d5caa6340011790bd9249dbef8a81128d" - integrity sha512-ztsSx77JBtkuMrEypfhgc3cI0+0h+svqeie7xHbh1k/IKdcydnvadp/mUaGgjAOXQmQSxsqgaRhS3q9fy+1kxg== - dependencies: - cross-fetch "^3.1.5" - fbjs-css-vars "^1.0.0" - loose-envify "^1.0.0" - object-assign "^4.1.0" - promise "^7.1.1" - setimmediate "^1.0.5" - ua-parser-js "^1.0.35" - -feed@^4.2.2: - version "4.2.2" - resolved "https://registry.yarnpkg.com/feed/-/feed-4.2.2.tgz#865783ef6ed12579e2c44bbef3c9113bc4956a7e" - integrity sha512-u5/sxGfiMfZNtJ3OvQpXcvotFpYkL0n9u9mM2vkui2nGo8b4wvDkJ8gAkYqbA8QpGyFCv3RK0Z+Iv+9veCS9bQ== - dependencies: - xml-js "^1.6.11" - -file-loader@^6.2.0: - version "6.2.0" - resolved "https://registry.yarnpkg.com/file-loader/-/file-loader-6.2.0.tgz#baef7cf8e1840df325e4390b4484879480eebe4d" - integrity sha512-qo3glqyTa61Ytg4u73GultjHGjdRyig3tG6lPtyX/jOEJvHif9uB0/OCI2Kif6ctF3caQTW2G5gym21oAsI4pw== - dependencies: - loader-utils "^2.0.0" - schema-utils "^3.0.0" - -filesize@^8.0.6: - version "8.0.7" - resolved "https://registry.yarnpkg.com/filesize/-/filesize-8.0.7.tgz#695e70d80f4e47012c132d57a059e80c6b580bd8" - integrity sha512-pjmC+bkIF8XI7fWaH8KxHcZL3DPybs1roSKP4rKDvy20tAWwIObE4+JIseG2byfGKhud5ZnM4YSGKBz7Sh0ndQ== - -fill-range@^7.0.1: - version "7.0.1" - resolved "https://registry.yarnpkg.com/fill-range/-/fill-range-7.0.1.tgz#1919a6a7c75fe38b2c7c77e5198535da9acdda40" - integrity sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ== - dependencies: - to-regex-range "^5.0.1" - -finalhandler@1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/finalhandler/-/finalhandler-1.2.0.tgz#7d23fe5731b207b4640e4fcd00aec1f9207a7b32" - integrity sha512-5uXcUVftlQMFnWC9qu/svkWv3GTd2PfUhK/3PLkYNAe7FbqJMt3515HaxE6eRL74GdsriiwujiawdaB1BpEISg== - dependencies: - debug "2.6.9" - encodeurl "~1.0.2" - escape-html "~1.0.3" - on-finished "2.4.1" - parseurl "~1.3.3" - statuses "2.0.1" - unpipe "~1.0.0" - -find-cache-dir@^3.3.1: - version "3.3.2" - resolved "https://registry.yarnpkg.com/find-cache-dir/-/find-cache-dir-3.3.2.tgz#b30c5b6eff0730731aea9bbd9dbecbd80256d64b" - integrity sha512-wXZV5emFEjrridIgED11OoUKLxiYjAcqot/NJdAkOhlJ+vGzwhOAfcG5OX1jP+S0PcjEn8bdMJv+g2jwQ3Onig== - dependencies: - commondir "^1.0.1" - make-dir "^3.0.2" - pkg-dir "^4.1.0" - -find-up@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/find-up/-/find-up-3.0.0.tgz#49169f1d7993430646da61ecc5ae355c21c97b73" - integrity sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg== - dependencies: - locate-path "^3.0.0" - -find-up@^4.0.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/find-up/-/find-up-4.1.0.tgz#97afe7d6cdc0bc5928584b7c8d7b16e8a9aa5d19" - integrity sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw== - dependencies: - locate-path "^5.0.0" - path-exists "^4.0.0" - -find-up@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/find-up/-/find-up-5.0.0.tgz#4c92819ecb7083561e4f4a240a86be5198f536fc" - integrity sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng== - dependencies: - locate-path "^6.0.0" - path-exists "^4.0.0" - -flux@^4.0.1: - version "4.0.4" - resolved "https://registry.yarnpkg.com/flux/-/flux-4.0.4.tgz#9661182ea81d161ee1a6a6af10d20485ef2ac572" - integrity sha512-NCj3XlayA2UsapRpM7va6wU1+9rE5FIL7qoMcmxWHRzbp0yujihMBm9BBHZ1MDIk5h5o2Bl6eGiCe8rYELAmYw== - dependencies: - fbemitter "^3.0.0" - fbjs "^3.0.1" - -follow-redirects@^1.0.0, follow-redirects@^1.14.7: - version "1.15.3" - resolved "https://registry.yarnpkg.com/follow-redirects/-/follow-redirects-1.15.3.tgz#fe2f3ef2690afce7e82ed0b44db08165b207123a" - integrity sha512-1VzOtuEM8pC9SFU1E+8KfTjZyMztRsgEfwQl44z8A25uy13jSzTj6dyK2Df52iV0vgHCfBwLhDWevLn95w5v6Q== - -fork-ts-checker-webpack-plugin@^6.5.0: - version "6.5.3" - resolved "https://registry.yarnpkg.com/fork-ts-checker-webpack-plugin/-/fork-ts-checker-webpack-plugin-6.5.3.tgz#eda2eff6e22476a2688d10661688c47f611b37f3" - integrity sha512-SbH/l9ikmMWycd5puHJKTkZJKddF4iRLyW3DeZ08HTI7NGyLS38MXd/KGgeWumQO7YNQbW2u/NtPT2YowbPaGQ== - dependencies: - "@babel/code-frame" "^7.8.3" - "@types/json-schema" "^7.0.5" - chalk "^4.1.0" - chokidar "^3.4.2" - cosmiconfig "^6.0.0" - deepmerge "^4.2.2" - fs-extra "^9.0.0" - glob "^7.1.6" - memfs "^3.1.2" - minimatch "^3.0.4" - schema-utils "2.7.0" - semver "^7.3.2" - tapable "^1.0.0" - -forwarded@0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/forwarded/-/forwarded-0.2.0.tgz#2269936428aad4c15c7ebe9779a84bf0b2a81811" - integrity sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow== - -fraction.js@^4.3.6: - version "4.3.6" - resolved "https://registry.yarnpkg.com/fraction.js/-/fraction.js-4.3.6.tgz#e9e3acec6c9a28cf7bc36cbe35eea4ceb2c5c92d" - integrity sha512-n2aZ9tNfYDwaHhvFTkhFErqOMIb8uyzSQ+vGJBjZyanAKZVbGUQ1sngfk9FdkBw7G26O7AgNjLcecLffD1c7eg== - -fresh@0.5.2: - version "0.5.2" - resolved "https://registry.yarnpkg.com/fresh/-/fresh-0.5.2.tgz#3d8cadd90d976569fa835ab1f8e4b23a105605a7" - integrity sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q== - -fs-extra@^10.1.0: - version "10.1.0" - resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-10.1.0.tgz#02873cfbc4084dde127eaa5f9905eef2325d1abf" - integrity sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ== - dependencies: - graceful-fs "^4.2.0" - jsonfile "^6.0.1" - universalify "^2.0.0" - -fs-extra@^9.0.0: - version "9.1.0" - resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-9.1.0.tgz#5954460c764a8da2094ba3554bf839e6b9a7c86d" - integrity sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ== - dependencies: - at-least-node "^1.0.0" - graceful-fs "^4.2.0" - jsonfile "^6.0.1" - universalify "^2.0.0" - -fs-monkey@^1.0.4: - version "1.0.5" - resolved "https://registry.yarnpkg.com/fs-monkey/-/fs-monkey-1.0.5.tgz#fe450175f0db0d7ea758102e1d84096acb925788" - integrity sha512-8uMbBjrhzW76TYgEV27Y5E//W2f/lTFmx78P2w19FZSxarhI/798APGQyuGCwmkNxgwGRhrLfvWyLBvNtuOmew== - -fs.realpath@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f" - integrity sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw== - -fsevents@~2.3.2: - version "2.3.3" - resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.3.3.tgz#cac6407785d03675a2a5e1a5305c697b347d90d6" - integrity sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw== - -function-bind@^1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.1.tgz#a56899d3ea3c9bab874bb9773b7c5ede92f4895d" - integrity sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A== - -gensync@^1.0.0-beta.1, gensync@^1.0.0-beta.2: - version "1.0.0-beta.2" - resolved "https://registry.yarnpkg.com/gensync/-/gensync-1.0.0-beta.2.tgz#32a6ee76c3d7f52d46b2b1ae5d93fea8580a25e0" - integrity sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg== - -get-intrinsic@^1.0.2, get-intrinsic@^1.1.1, get-intrinsic@^1.1.3, get-intrinsic@^1.2.1: - version "1.2.1" - resolved "https://registry.yarnpkg.com/get-intrinsic/-/get-intrinsic-1.2.1.tgz#d295644fed4505fc9cde952c37ee12b477a83d82" - integrity sha512-2DcsyfABl+gVHEfCOaTrWgyt+tb6MSEGmKq+kI5HwLbIYgjgmMcV8KQ41uaKz1xxUcn9tJtgFbQUEVcEbd0FYw== - dependencies: - function-bind "^1.1.1" - has "^1.0.3" - has-proto "^1.0.1" - has-symbols "^1.0.3" - -get-own-enumerable-property-symbols@^3.0.0: - version "3.0.2" - resolved "https://registry.yarnpkg.com/get-own-enumerable-property-symbols/-/get-own-enumerable-property-symbols-3.0.2.tgz#b5fde77f22cbe35f390b4e089922c50bce6ef664" - integrity sha512-I0UBV/XOz1XkIJHEUDMZAbzCThU/H8DxmSfmdGcKPnVhu2VfFqr34jr9777IyaTYvxjedWhqVIilEDsCdP5G6g== - -get-stream@^4.1.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-4.1.0.tgz#c1b255575f3dc21d59bfc79cd3d2b46b1c3a54b5" - integrity sha512-GMat4EJ5161kIy2HevLlr4luNjBgvmj413KaQA7jt4V8B4RDsfpHk7WQ9GVqfYyyx8OS/L66Kox+rJRNklLK7w== - dependencies: - pump "^3.0.0" - -get-stream@^5.1.0: - version "5.2.0" - resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-5.2.0.tgz#4966a1795ee5ace65e706c4b7beb71257d6e22d3" - integrity sha512-nBF+F1rAZVCu/p7rjzgA+Yb4lfYXrpl7a6VmJrU8wF9I1CKvP/QwPNZHnOlwbTkY6dvtFIzFMSyQXbLoTQPRpA== - dependencies: - pump "^3.0.0" - -get-stream@^6.0.0: - version "6.0.1" - resolved "https://registry.yarnpkg.com/get-stream/-/get-stream-6.0.1.tgz#a262d8eef67aced57c2852ad6167526a43cbf7b7" - integrity sha512-ts6Wi+2j3jQjqi70w5AlN8DFnkSwC+MqmxEzdEALB2qXZYV3X/b1CTfgPLGJNMeAWxdPfU8FO1ms3NUfaHCPYg== - -github-slugger@^1.4.0: - version "1.5.0" - resolved "https://registry.yarnpkg.com/github-slugger/-/github-slugger-1.5.0.tgz#17891bbc73232051474d68bd867a34625c955f7d" - integrity sha512-wIh+gKBI9Nshz2o46B0B3f5k/W+WI9ZAv6y5Dn5WJ5SK1t0TnDimB4WE5rmTD05ZAIn8HALCZVmCsvj0w0v0lw== - -glob-parent@^5.1.2, glob-parent@~5.1.2: - version "5.1.2" - resolved "https://registry.yarnpkg.com/glob-parent/-/glob-parent-5.1.2.tgz#869832c58034fe68a4093c17dc15e8340d8401c4" - integrity sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow== - dependencies: - is-glob "^4.0.1" - -glob-parent@^6.0.1: - version "6.0.2" - resolved "https://registry.yarnpkg.com/glob-parent/-/glob-parent-6.0.2.tgz#6d237d99083950c79290f24c7642a3de9a28f9e3" - integrity sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A== - dependencies: - is-glob "^4.0.3" - -glob-to-regexp@^0.4.1: - version "0.4.1" - resolved "https://registry.yarnpkg.com/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz#c75297087c851b9a578bd217dd59a92f59fe546e" - integrity sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw== - -glob@^7.0.0, glob@^7.1.3, glob@^7.1.6: - version "7.2.3" - resolved "https://registry.yarnpkg.com/glob/-/glob-7.2.3.tgz#b8df0fb802bbfa8e89bd1d938b4e16578ed44f2b" - integrity sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q== - dependencies: - fs.realpath "^1.0.0" - inflight "^1.0.4" - inherits "2" - minimatch "^3.1.1" - once "^1.3.0" - path-is-absolute "^1.0.0" - -global-dirs@^3.0.0: - version "3.0.1" - resolved "https://registry.yarnpkg.com/global-dirs/-/global-dirs-3.0.1.tgz#0c488971f066baceda21447aecb1a8b911d22485" - integrity sha512-NBcGGFbBA9s1VzD41QXDG+3++t9Mn5t1FpLdhESY6oKY4gYTFpX4wO3sqGUa0Srjtbfj3szX0RnemmrVRUdULA== - dependencies: - ini "2.0.0" - -global-modules@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/global-modules/-/global-modules-2.0.0.tgz#997605ad2345f27f51539bea26574421215c7780" - integrity sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A== - dependencies: - global-prefix "^3.0.0" - -global-prefix@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/global-prefix/-/global-prefix-3.0.0.tgz#fc85f73064df69f50421f47f883fe5b913ba9b97" - integrity sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg== - dependencies: - ini "^1.3.5" - kind-of "^6.0.2" - which "^1.3.1" - -globals@^11.1.0: - version "11.12.0" - resolved "https://registry.yarnpkg.com/globals/-/globals-11.12.0.tgz#ab8795338868a0babd8525758018c2a7eb95c42e" - integrity sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA== - -globby@^11.0.1, globby@^11.0.4, globby@^11.1.0: - version "11.1.0" - resolved "https://registry.yarnpkg.com/globby/-/globby-11.1.0.tgz#bd4be98bb042f83d796f7e3811991fbe82a0d34b" - integrity sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g== - dependencies: - array-union "^2.1.0" - dir-glob "^3.0.1" - fast-glob "^3.2.9" - ignore "^5.2.0" - merge2 "^1.4.1" - slash "^3.0.0" - -globby@^13.1.1: - version "13.2.2" - resolved "https://registry.yarnpkg.com/globby/-/globby-13.2.2.tgz#63b90b1bf68619c2135475cbd4e71e66aa090592" - integrity sha512-Y1zNGV+pzQdh7H39l9zgB4PJqjRNqydvdYCDG4HFXM4XuvSaQQlEc91IU1yALL8gUTDomgBAfz3XJdmUS+oo0w== - dependencies: - dir-glob "^3.0.1" - fast-glob "^3.3.0" - ignore "^5.2.4" - merge2 "^1.4.1" - slash "^4.0.0" - -gopd@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/gopd/-/gopd-1.0.1.tgz#29ff76de69dac7489b7c0918a5788e56477c332c" - integrity sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA== - dependencies: - get-intrinsic "^1.1.3" - -got@^9.6.0: - version "9.6.0" - resolved "https://registry.yarnpkg.com/got/-/got-9.6.0.tgz#edf45e7d67f99545705de1f7bbeeeb121765ed85" - integrity sha512-R7eWptXuGYxwijs0eV+v3o6+XH1IqVK8dJOEecQfTmkncw9AV4dcw/Dhxi8MdlqPthxxpZyizMzyg8RTmEsG+Q== - dependencies: - "@sindresorhus/is" "^0.14.0" - "@szmarczak/http-timer" "^1.1.2" - cacheable-request "^6.0.0" - decompress-response "^3.3.0" - duplexer3 "^0.1.4" - get-stream "^4.1.0" - lowercase-keys "^1.0.1" - mimic-response "^1.0.1" - p-cancelable "^1.0.0" - to-readable-stream "^1.0.0" - url-parse-lax "^3.0.0" - -graceful-fs@^4.1.2, graceful-fs@^4.1.6, graceful-fs@^4.2.0, graceful-fs@^4.2.4, graceful-fs@^4.2.6, graceful-fs@^4.2.9: - version "4.2.11" - resolved "https://registry.yarnpkg.com/graceful-fs/-/graceful-fs-4.2.11.tgz#4183e4e8bf08bb6e05bbb2f7d2e0c8f712ca40e3" - integrity sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ== - -gray-matter@^4.0.3: - version "4.0.3" - resolved "https://registry.yarnpkg.com/gray-matter/-/gray-matter-4.0.3.tgz#e893c064825de73ea1f5f7d88c7a9f7274288798" - integrity sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q== - dependencies: - js-yaml "^3.13.1" - kind-of "^6.0.2" - section-matter "^1.0.0" - strip-bom-string "^1.0.0" - -gzip-size@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/gzip-size/-/gzip-size-6.0.0.tgz#065367fd50c239c0671cbcbad5be3e2eeb10e462" - integrity sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q== - dependencies: - duplexer "^0.1.2" - -handle-thing@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/handle-thing/-/handle-thing-2.0.1.tgz#857f79ce359580c340d43081cc648970d0bb234e" - integrity sha512-9Qn4yBxelxoh2Ow62nP+Ka/kMnOXRi8BXnRaUwezLNhqelnN49xKz4F/dPP8OYLxLxq6JDtZb2i9XznUQbNPTg== - -has-flag@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-3.0.0.tgz#b5d454dc2199ae225699f3467e5a07f3b955bafd" - integrity sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw== - -has-flag@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-4.0.0.tgz#944771fd9c81c81265c4d6941860da06bb59479b" - integrity sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ== - -has-property-descriptors@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/has-property-descriptors/-/has-property-descriptors-1.0.0.tgz#610708600606d36961ed04c196193b6a607fa861" - integrity sha512-62DVLZGoiEBDHQyqG4w9xCuZ7eJEwNmJRWw2VY84Oedb7WFcA27fiEVe8oUQx9hAUJ4ekurquucTGwsyO1XGdQ== - dependencies: - get-intrinsic "^1.1.1" - -has-proto@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/has-proto/-/has-proto-1.0.1.tgz#1885c1305538958aff469fef37937c22795408e0" - integrity sha512-7qE+iP+O+bgF9clE5+UoBFzE65mlBiVj3tKCrlNQ0Ogwm0BjpT/gK4SlLYDMybDh5I3TCTKnPPa0oMG7JDYrhg== - -has-symbols@^1.0.3: - version "1.0.3" - resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.3.tgz#bb7b2c4349251dce87b125f7bdf874aa7c8b39f8" - integrity sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A== - -has-yarn@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/has-yarn/-/has-yarn-2.1.0.tgz#137e11354a7b5bf11aa5cb649cf0c6f3ff2b2e77" - integrity sha512-UqBRqi4ju7T+TqGNdqAO0PaSVGsDGJUBQvk9eUWNGRY1CFGDzYhLWoM7JQEemnlvVcv/YEmc2wNW8BC24EnUsw== - -has@^1.0.3: - version "1.0.4" - resolved "https://registry.yarnpkg.com/has/-/has-1.0.4.tgz#2eb2860e000011dae4f1406a86fe80e530fb2ec6" - integrity sha512-qdSAmqLF6209RFj4VVItywPMbm3vWylknmB3nvNiUIs72xAimcM8nVYxYr7ncvZq5qzk9MKIZR8ijqD/1QuYjQ== - -hast-to-hyperscript@^9.0.0: - version "9.0.1" - resolved "https://registry.yarnpkg.com/hast-to-hyperscript/-/hast-to-hyperscript-9.0.1.tgz#9b67fd188e4c81e8ad66f803855334173920218d" - integrity sha512-zQgLKqF+O2F72S1aa4y2ivxzSlko3MAvxkwG8ehGmNiqd98BIN3JM1rAJPmplEyLmGLO2QZYJtIneOSZ2YbJuA== - dependencies: - "@types/unist" "^2.0.3" - comma-separated-tokens "^1.0.0" - property-information "^5.3.0" - space-separated-tokens "^1.0.0" - style-to-object "^0.3.0" - unist-util-is "^4.0.0" - web-namespaces "^1.0.0" - -hast-util-from-parse5@^6.0.0: - version "6.0.1" - resolved "https://registry.yarnpkg.com/hast-util-from-parse5/-/hast-util-from-parse5-6.0.1.tgz#554e34abdeea25ac76f5bd950a1f0180e0b3bc2a" - integrity sha512-jeJUWiN5pSxW12Rh01smtVkZgZr33wBokLzKLwinYOUfSzm1Nl/c3GUGebDyOKjdsRgMvoVbV0VpAcpjF4NrJA== - dependencies: - "@types/parse5" "^5.0.0" - hastscript "^6.0.0" - property-information "^5.0.0" - vfile "^4.0.0" - vfile-location "^3.2.0" - web-namespaces "^1.0.0" - -hast-util-is-element@^1.0.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/hast-util-is-element/-/hast-util-is-element-1.1.0.tgz#3b3ed5159a2707c6137b48637fbfe068e175a425" - integrity sha512-oUmNua0bFbdrD/ELDSSEadRVtWZOf3iF6Lbv81naqsIV99RnSCieTbWuWCY8BAeEfKJTKl0gRdokv+dELutHGQ== - -hast-util-parse-selector@^2.0.0: - version "2.2.5" - resolved "https://registry.yarnpkg.com/hast-util-parse-selector/-/hast-util-parse-selector-2.2.5.tgz#d57c23f4da16ae3c63b3b6ca4616683313499c3a" - integrity sha512-7j6mrk/qqkSehsM92wQjdIgWM2/BW61u/53G6xmC8i1OmEdKLHbk419QKQUjz6LglWsfqoiHmyMRkP1BGjecNQ== - -hast-util-raw@6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/hast-util-raw/-/hast-util-raw-6.0.1.tgz#973b15930b7529a7b66984c98148b46526885977" - integrity sha512-ZMuiYA+UF7BXBtsTBNcLBF5HzXzkyE6MLzJnL605LKE8GJylNjGc4jjxazAHUtcwT5/CEt6afRKViYB4X66dig== - dependencies: - "@types/hast" "^2.0.0" - hast-util-from-parse5 "^6.0.0" - hast-util-to-parse5 "^6.0.0" - html-void-elements "^1.0.0" - parse5 "^6.0.0" - unist-util-position "^3.0.0" - vfile "^4.0.0" - web-namespaces "^1.0.0" - xtend "^4.0.0" - zwitch "^1.0.0" - -hast-util-to-parse5@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/hast-util-to-parse5/-/hast-util-to-parse5-6.0.0.tgz#1ec44650b631d72952066cea9b1445df699f8479" - integrity sha512-Lu5m6Lgm/fWuz8eWnrKezHtVY83JeRGaNQ2kn9aJgqaxvVkFCZQBEhgodZUDUvoodgyROHDb3r5IxAEdl6suJQ== - dependencies: - hast-to-hyperscript "^9.0.0" - property-information "^5.0.0" - web-namespaces "^1.0.0" - xtend "^4.0.0" - zwitch "^1.0.0" - -hast-util-to-text@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/hast-util-to-text/-/hast-util-to-text-2.0.1.tgz#04f2e065642a0edb08341976084aa217624a0f8b" - integrity sha512-8nsgCARfs6VkwH2jJU9b8LNTuR4700na+0h3PqCaEk4MAnMDeu5P0tP8mjk9LLNGxIeQRLbiDbZVw6rku+pYsQ== - dependencies: - hast-util-is-element "^1.0.0" - repeat-string "^1.0.0" - unist-util-find-after "^3.0.0" - -hastscript@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/hastscript/-/hastscript-6.0.0.tgz#e8768d7eac56c3fdeac8a92830d58e811e5bf640" - integrity sha512-nDM6bvd7lIqDUiYEiu5Sl/+6ReP0BMk/2f4U/Rooccxkj0P5nm+acM5PrGJ/t5I8qPGiqZSE6hVAwZEdZIvP4w== - dependencies: - "@types/hast" "^2.0.0" - comma-separated-tokens "^1.0.0" - hast-util-parse-selector "^2.0.0" - property-information "^5.0.0" - space-separated-tokens "^1.0.0" - -he@^1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/he/-/he-1.2.0.tgz#84ae65fa7eafb165fddb61566ae14baf05664f0f" - integrity sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw== - -heap@^0.2.6: - version "0.2.7" - resolved "https://registry.yarnpkg.com/heap/-/heap-0.2.7.tgz#1e6adf711d3f27ce35a81fe3b7bd576c2260a8fc" - integrity sha512-2bsegYkkHO+h/9MGbn6KWcE45cHZgPANo5LXF7EvWdT0yT2EguSVO1nDgU5c8+ZOPwp2vMNa7YFsJhVcDR9Sdg== - -history@^4.9.0: - version "4.10.1" - resolved "https://registry.yarnpkg.com/history/-/history-4.10.1.tgz#33371a65e3a83b267434e2b3f3b1b4c58aad4cf3" - integrity sha512-36nwAD620w12kuzPAsyINPWJqlNbij+hpK1k9XRloDtym8mxzGYl2c17LnV6IAGB2Dmg4tEa7G7DlawS0+qjew== - dependencies: - "@babel/runtime" "^7.1.2" - loose-envify "^1.2.0" - resolve-pathname "^3.0.0" - tiny-invariant "^1.0.2" - tiny-warning "^1.0.0" - value-equal "^1.0.1" - -hoist-non-react-statics@^3.1.0: - version "3.3.2" - resolved "https://registry.yarnpkg.com/hoist-non-react-statics/-/hoist-non-react-statics-3.3.2.tgz#ece0acaf71d62c2969c2ec59feff42a4b1a85b45" - integrity sha512-/gGivxi8JPKWNm/W0jSmzcMPpfpPLc3dY/6GxhX2hQ9iGj3aDfklV4ET7NjKpSinLpJ5vafa9iiGIEZg10SfBw== - dependencies: - react-is "^16.7.0" - -hpack.js@^2.1.6: - version "2.1.6" - resolved "https://registry.yarnpkg.com/hpack.js/-/hpack.js-2.1.6.tgz#87774c0949e513f42e84575b3c45681fade2a0b2" - integrity sha512-zJxVehUdMGIKsRaNt7apO2Gqp0BdqW5yaiGHXXmbpvxgBYVZnAql+BJb4RO5ad2MgpbZKn5G6nMnegrH1FcNYQ== - dependencies: - inherits "^2.0.1" - obuf "^1.0.0" - readable-stream "^2.0.1" - wbuf "^1.1.0" - -html-entities@^2.3.2: - version "2.4.0" - resolved "https://registry.yarnpkg.com/html-entities/-/html-entities-2.4.0.tgz#edd0cee70402584c8c76cc2c0556db09d1f45061" - integrity sha512-igBTJcNNNhvZFRtm8uA6xMY6xYleeDwn3PeBCkDz7tHttv4F2hsDI2aPgNERWzvRcNYHNT3ymRaQzllmXj4YsQ== - -html-minifier-terser@^6.0.2, html-minifier-terser@^6.1.0: - version "6.1.0" - resolved "https://registry.yarnpkg.com/html-minifier-terser/-/html-minifier-terser-6.1.0.tgz#bfc818934cc07918f6b3669f5774ecdfd48f32ab" - integrity sha512-YXxSlJBZTP7RS3tWnQw74ooKa6L9b9i9QYXY21eUEvhZ3u9XLfv6OnFsQq6RxkhHygsaUMvYsZRV5rU/OVNZxw== - dependencies: - camel-case "^4.1.2" - clean-css "^5.2.2" - commander "^8.3.0" - he "^1.2.0" - param-case "^3.0.4" - relateurl "^0.2.7" - terser "^5.10.0" - -html-tags@^3.2.0: - version "3.3.1" - resolved "https://registry.yarnpkg.com/html-tags/-/html-tags-3.3.1.tgz#a04026a18c882e4bba8a01a3d39cfe465d40b5ce" - integrity sha512-ztqyC3kLto0e9WbNp0aeP+M3kTt+nbaIveGmUxAtZa+8iFgKLUOD4YKM5j+f3QD89bra7UeumolZHKuOXnTmeQ== - -html-void-elements@^1.0.0: - version "1.0.5" - resolved "https://registry.yarnpkg.com/html-void-elements/-/html-void-elements-1.0.5.tgz#ce9159494e86d95e45795b166c2021c2cfca4483" - integrity sha512-uE/TxKuyNIcx44cIWnjr/rfIATDH7ZaOMmstu0CwhFG1Dunhlp4OC6/NMbhiwoq5BpW0ubi303qnEk/PZj614w== - -html-webpack-plugin@^5.5.0: - version "5.5.3" - resolved "https://registry.yarnpkg.com/html-webpack-plugin/-/html-webpack-plugin-5.5.3.tgz#72270f4a78e222b5825b296e5e3e1328ad525a3e" - integrity sha512-6YrDKTuqaP/TquFH7h4srYWsZx+x6k6+FbsTm0ziCwGHDP78Unr1r9F/H4+sGmMbX08GQcJ+K64x55b+7VM/jg== - dependencies: - "@types/html-minifier-terser" "^6.0.0" - html-minifier-terser "^6.0.2" - lodash "^4.17.21" - pretty-error "^4.0.0" - tapable "^2.0.0" - -htmlparser2@^6.1.0: - version "6.1.0" - resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-6.1.0.tgz#c4d762b6c3371a05dbe65e94ae43a9f845fb8fb7" - integrity sha512-gyyPk6rgonLFEDGoeRgQNaEUvdJ4ktTmmUh/h2t7s+M8oPpIPxgNACWa+6ESR57kXstwqPiCut0V8NRpcwgU7A== - dependencies: - domelementtype "^2.0.1" - domhandler "^4.0.0" - domutils "^2.5.2" - entities "^2.0.0" - -htmlparser2@^8.0.1: - version "8.0.2" - resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-8.0.2.tgz#f002151705b383e62433b5cf466f5b716edaec21" - integrity sha512-GYdjWKDkbRLkZ5geuHs5NY1puJ+PXwP7+fHPRz06Eirsb9ugf6d8kkXav6ADhcODhFFPMIXyxkxSuMf3D6NCFA== - dependencies: - domelementtype "^2.3.0" - domhandler "^5.0.3" - domutils "^3.0.1" - entities "^4.4.0" - -http-cache-semantics@^4.0.0: - version "4.1.1" - resolved "https://registry.yarnpkg.com/http-cache-semantics/-/http-cache-semantics-4.1.1.tgz#abe02fcb2985460bf0323be664436ec3476a6d5a" - integrity sha512-er295DKPVsV82j5kw1Gjt+ADA/XYHsajl82cGNQG2eyoPkvgUhX+nDIyelzhIWbbsXP39EHcI6l5tYs2FYqYXQ== - -http-deceiver@^1.2.7: - version "1.2.7" - resolved "https://registry.yarnpkg.com/http-deceiver/-/http-deceiver-1.2.7.tgz#fa7168944ab9a519d337cb0bec7284dc3e723d87" - integrity sha512-LmpOGxTfbpgtGVxJrj5k7asXHCgNZp5nLfp+hWc8QQRqtb7fUy6kRY3BO1h9ddF6yIPYUARgxGOwB42DnxIaNw== - -http-errors@2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/http-errors/-/http-errors-2.0.0.tgz#b7774a1486ef73cf7667ac9ae0858c012c57b9d3" - integrity sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ== - dependencies: - depd "2.0.0" - inherits "2.0.4" - setprototypeof "1.2.0" - statuses "2.0.1" - toidentifier "1.0.1" - -http-errors@~1.6.2: - version "1.6.3" - resolved "https://registry.yarnpkg.com/http-errors/-/http-errors-1.6.3.tgz#8b55680bb4be283a0b5bf4ea2e38580be1d9320d" - integrity sha512-lks+lVC8dgGyh97jxvxeYTWQFvh4uw4yC12gVl63Cg30sjPX4wuGcdkICVXDAESr6OJGjqGA8Iz5mkeN6zlD7A== - dependencies: - depd "~1.1.2" - inherits "2.0.3" - setprototypeof "1.1.0" - statuses ">= 1.4.0 < 2" - -http-parser-js@>=0.5.1: - version "0.5.8" - resolved "https://registry.yarnpkg.com/http-parser-js/-/http-parser-js-0.5.8.tgz#af23090d9ac4e24573de6f6aecc9d84a48bf20e3" - integrity sha512-SGeBX54F94Wgu5RH3X5jsDtf4eHyRogWX1XGT3b4HuW3tQPM4AaBzoUji/4AAJNXCEOWZ5O0DgZmJw1947gD5Q== - -http-proxy-middleware@^2.0.3: - version "2.0.6" - resolved "https://registry.yarnpkg.com/http-proxy-middleware/-/http-proxy-middleware-2.0.6.tgz#e1a4dd6979572c7ab5a4e4b55095d1f32a74963f" - integrity sha512-ya/UeJ6HVBYxrgYotAZo1KvPWlgB48kUJLDePFeneHsVujFaW5WNj2NgWCAE//B1Dl02BIfYlpNgBy8Kf8Rjmw== - dependencies: - "@types/http-proxy" "^1.17.8" - http-proxy "^1.18.1" - is-glob "^4.0.1" - is-plain-obj "^3.0.0" - micromatch "^4.0.2" - -http-proxy@^1.18.1: - version "1.18.1" - resolved "https://registry.yarnpkg.com/http-proxy/-/http-proxy-1.18.1.tgz#401541f0534884bbf95260334e72f88ee3976549" - integrity sha512-7mz/721AbnJwIVbnaSv1Cz3Am0ZLT/UBwkC92VlxhXv/k/BBQfM2fXElQNC27BVGr0uwUpplYPQM9LnaBMR5NQ== - dependencies: - eventemitter3 "^4.0.0" - follow-redirects "^1.0.0" - requires-port "^1.0.0" - -human-signals@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/human-signals/-/human-signals-2.1.0.tgz#dc91fcba42e4d06e4abaed33b3e7a3c02f514ea0" - integrity sha512-B4FFZ6q/T2jhhksgkbEW3HBvWIfDW85snkQgawt07S7J5QXTk6BkNV+0yAeZrM5QpMAdYlocGoljn0sJ/WQkFw== - -iconv-lite@0.4.24: - version "0.4.24" - resolved "https://registry.yarnpkg.com/iconv-lite/-/iconv-lite-0.4.24.tgz#2022b4b25fbddc21d2f524974a474aafe733908b" - integrity sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA== - dependencies: - safer-buffer ">= 2.1.2 < 3" - -iconv-lite@0.6: - version "0.6.3" - resolved "https://registry.yarnpkg.com/iconv-lite/-/iconv-lite-0.6.3.tgz#a52f80bf38da1952eb5c681790719871a1a72501" - integrity sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw== - dependencies: - safer-buffer ">= 2.1.2 < 3.0.0" - -icss-utils@^5.0.0, icss-utils@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/icss-utils/-/icss-utils-5.1.0.tgz#c6be6858abd013d768e98366ae47e25d5887b1ae" - integrity sha512-soFhflCVWLfRNOPU3iv5Z9VUdT44xFRbzjLsEzSr5AQmgqPMTHdU3PMT1Cf1ssx8fLNJDA1juftYl+PUcv3MqA== - -ignore@^5.2.0, ignore@^5.2.4: - version "5.2.4" - resolved "https://registry.yarnpkg.com/ignore/-/ignore-5.2.4.tgz#a291c0c6178ff1b960befe47fcdec301674a6324" - integrity sha512-MAb38BcSbH0eHNBxn7ql2NH/kX33OkB3lZ1BNdh7ENeRChHTYsTvWrMubiIAMNS2llXEEgZ1MUOBtXChP3kaFQ== - -image-size@^1.0.1: - version "1.0.2" - resolved "https://registry.yarnpkg.com/image-size/-/image-size-1.0.2.tgz#d778b6d0ab75b2737c1556dd631652eb963bc486" - integrity sha512-xfOoWjceHntRb3qFCrh5ZFORYH8XCdYpASltMhZ/Q0KZiOwjdE/Yl2QCiWdwD+lygV5bMCvauzgu5PxBX/Yerg== - dependencies: - queue "6.0.2" - -immer@^9.0.7: - version "9.0.21" - resolved "https://registry.yarnpkg.com/immer/-/immer-9.0.21.tgz#1e025ea31a40f24fb064f1fef23e931496330176" - integrity sha512-bc4NBHqOqSfRW7POMkHd51LvClaeMXpm8dx0e8oE2GORbq5aRK7Bxl4FyzVLdGtLmvLKL7BTDBG5ACQm4HWjTA== - -import-fresh@^3.1.0, import-fresh@^3.2.1, import-fresh@^3.3.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/import-fresh/-/import-fresh-3.3.0.tgz#37162c25fcb9ebaa2e6e53d5b4d88ce17d9e0c2b" - integrity sha512-veYYhQa+D1QBKznvhUHxb8faxlrwUnxseDAbAp457E0wLNio2bOSKnjYDhMj+YiAq61xrMGhQk9iXVk5FzgQMw== - dependencies: - parent-module "^1.0.0" - resolve-from "^4.0.0" - -import-lazy@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/import-lazy/-/import-lazy-2.1.0.tgz#05698e3d45c88e8d7e9d92cb0584e77f096f3e43" - integrity sha512-m7ZEHgtw69qOGw+jwxXkHlrlIPdTGkyh66zXZ1ajZbxkDBNjSY/LGbmjc7h0s2ELsUDTAhFr55TrPSSqJGPG0A== - -imurmurhash@^0.1.4: - version "0.1.4" - resolved "https://registry.yarnpkg.com/imurmurhash/-/imurmurhash-0.1.4.tgz#9218b9b2b928a238b13dc4fb6b6d576f231453ea" - integrity sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA== - -indent-string@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/indent-string/-/indent-string-4.0.0.tgz#624f8f4497d619b2d9768531d58f4122854d7251" - integrity sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg== - -infima@0.2.0-alpha.43: - version "0.2.0-alpha.43" - resolved "https://registry.yarnpkg.com/infima/-/infima-0.2.0-alpha.43.tgz#f7aa1d7b30b6c08afef441c726bac6150228cbe0" - integrity sha512-2uw57LvUqW0rK/SWYnd/2rRfxNA5DDNOh33jxF7fy46VWoNhGxiUQyVZHbBMjQ33mQem0cjdDVwgWVAmlRfgyQ== - -inflight@^1.0.4: - version "1.0.6" - resolved "https://registry.yarnpkg.com/inflight/-/inflight-1.0.6.tgz#49bd6331d7d02d0c09bc910a1075ba8165b56df9" - integrity sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA== - dependencies: - once "^1.3.0" - wrappy "1" - -inherits@2, inherits@2.0.4, inherits@^2.0.0, inherits@^2.0.1, inherits@^2.0.3, inherits@~2.0.3: - version "2.0.4" - resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c" - integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ== - -inherits@2.0.3: - version "2.0.3" - resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.3.tgz#633c2c83e3da42a502f52466022480f4208261de" - integrity sha512-x00IRNXNy63jwGkJmzPigoySHbaqpNuzKbBOmzK+g2OdZpQ9w+sxCN+VSB3ja7IAge2OP2qpfxTjeNcyjmW1uw== - -ini@2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/ini/-/ini-2.0.0.tgz#e5fd556ecdd5726be978fa1001862eacb0a94bc5" - integrity sha512-7PnF4oN3CvZF23ADhA5wRaYEQpJ8qygSkbtTXWBeXWXmEVRXK+1ITciHWwHhsjv1TmW0MgacIv6hEi5pX5NQdA== - -ini@^1.3.5, ini@~1.3.0: - version "1.3.8" - resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c" - integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew== - -inline-style-parser@0.1.1: - version "0.1.1" - resolved "https://registry.yarnpkg.com/inline-style-parser/-/inline-style-parser-0.1.1.tgz#ec8a3b429274e9c0a1f1c4ffa9453a7fef72cea1" - integrity sha512-7NXolsK4CAS5+xvdj5OMMbI962hU/wvwoxk+LWR9Ek9bVtyuuYScDN6eS0rUm6TxApFpw7CX1o4uJzcd4AyD3Q== - -"internmap@1 - 2": - version "2.0.3" - resolved "https://registry.yarnpkg.com/internmap/-/internmap-2.0.3.tgz#6685f23755e43c524e251d29cbc97248e3061009" - integrity sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg== - -interpret@^1.0.0: - version "1.4.0" - resolved "https://registry.yarnpkg.com/interpret/-/interpret-1.4.0.tgz#665ab8bc4da27a774a40584e812e3e0fa45b1a1e" - integrity sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA== - -invariant@^2.2.4: - version "2.2.4" - resolved "https://registry.yarnpkg.com/invariant/-/invariant-2.2.4.tgz#610f3c92c9359ce1db616e538008d23ff35158e6" - integrity sha512-phJfQVBuaJM5raOpJjSfkiD6BpbCE4Ns//LaXl6wGYtUBY83nWS6Rf9tXm2e8VaK60JEjYldbPif/A2B1C2gNA== - dependencies: - loose-envify "^1.0.0" - -ipaddr.js@1.9.1: - version "1.9.1" - resolved "https://registry.yarnpkg.com/ipaddr.js/-/ipaddr.js-1.9.1.tgz#bff38543eeb8984825079ff3a2a8e6cbd46781b3" - integrity sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g== - -ipaddr.js@^2.0.1: - version "2.1.0" - resolved "https://registry.yarnpkg.com/ipaddr.js/-/ipaddr.js-2.1.0.tgz#2119bc447ff8c257753b196fc5f1ce08a4cdf39f" - integrity sha512-LlbxQ7xKzfBusov6UMi4MFpEg0m+mAm9xyNGEduwXMEDuf4WfzB/RZwMVYEd7IKGvh4IUkEXYxtAVu9T3OelJQ== - -is-alphabetical@1.0.4, is-alphabetical@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-alphabetical/-/is-alphabetical-1.0.4.tgz#9e7d6b94916be22153745d184c298cbf986a686d" - integrity sha512-DwzsA04LQ10FHTZuL0/grVDk4rFoVH1pjAToYwBrHSxcrBIGQuXrQMtD5U1b0U2XVgKZCTLLP8u2Qxqhy3l2Vg== - -is-alphanumerical@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-alphanumerical/-/is-alphanumerical-1.0.4.tgz#7eb9a2431f855f6b1ef1a78e326df515696c4dbf" - integrity sha512-UzoZUr+XfVz3t3v4KyGEniVL9BDRoQtY7tOyrRybkVNjDFWyo1yhXNGrrBTQxp3ib9BLAWs7k2YKBQsFRkZG9A== - dependencies: - is-alphabetical "^1.0.0" - is-decimal "^1.0.0" - -is-arrayish@^0.2.1: - version "0.2.1" - resolved "https://registry.yarnpkg.com/is-arrayish/-/is-arrayish-0.2.1.tgz#77c99840527aa8ecb1a8ba697b80645a7a926a9d" - integrity sha512-zz06S8t0ozoDXMG+ube26zeCTNXcKIPJZJi8hBrF4idCLms4CG9QtK7qBl1boi5ODzFpjswb5JPmHCbMpjaYzg== - -is-binary-path@~2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/is-binary-path/-/is-binary-path-2.1.0.tgz#ea1f7f3b80f064236e83470f86c09c254fb45b09" - integrity sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw== - dependencies: - binary-extensions "^2.0.0" - -is-buffer@^2.0.0: - version "2.0.5" - resolved "https://registry.yarnpkg.com/is-buffer/-/is-buffer-2.0.5.tgz#ebc252e400d22ff8d77fa09888821a24a658c191" - integrity sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ== - -is-ci@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/is-ci/-/is-ci-2.0.0.tgz#6bc6334181810e04b5c22b3d589fdca55026404c" - integrity sha512-YfJT7rkpQB0updsdHLGWrvhBJfcfzNNawYDNIyQXJz0IViGf75O8EBPKSdvw2rF+LGCsX4FZ8tcr3b19LcZq4w== - dependencies: - ci-info "^2.0.0" - -is-core-module@^2.13.0: - version "2.13.0" - resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.13.0.tgz#bb52aa6e2cbd49a30c2ba68c42bf3435ba6072db" - integrity sha512-Z7dk6Qo8pOCp3l4tsX2C5ZVas4V+UxwQodwZhLopL91TX8UyyHEXafPcyoeeWuLrwzHcr3igO78wNLwHJHsMCQ== - dependencies: - has "^1.0.3" - -is-decimal@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-decimal/-/is-decimal-1.0.4.tgz#65a3a5958a1c5b63a706e1b333d7cd9f630d3fa5" - integrity sha512-RGdriMmQQvZ2aqaQq3awNA6dCGtKpiDFcOzrTWrDAT2MiWrKQVPmxLGHl7Y2nNu6led0kEyoX0enY0qXYsv9zw== - -is-docker@^2.0.0, is-docker@^2.1.1: - version "2.2.1" - resolved "https://registry.yarnpkg.com/is-docker/-/is-docker-2.2.1.tgz#33eeabe23cfe86f14bde4408a02c0cfb853acdaa" - integrity sha512-F+i2BKsFrH66iaUFc0woD8sLy8getkwTwtOBjvs56Cx4CgJDeKQeqfz8wAYiSb8JOprWhHH5p77PbmYCvvUuXQ== - -is-extendable@^0.1.0: - version "0.1.1" - resolved "https://registry.yarnpkg.com/is-extendable/-/is-extendable-0.1.1.tgz#62b110e289a471418e3ec36a617d472e301dfc89" - integrity sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw== - -is-extglob@^2.1.1: - version "2.1.1" - resolved "https://registry.yarnpkg.com/is-extglob/-/is-extglob-2.1.1.tgz#a88c02535791f02ed37c76a1b9ea9773c833f8c2" - integrity sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ== - -is-fullwidth-code-point@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz#f116f8064fe90b3f7844a38997c0b75051269f1d" - integrity sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg== - -is-glob@^4.0.1, is-glob@^4.0.3, is-glob@~4.0.1: - version "4.0.3" - resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-4.0.3.tgz#64f61e42cbbb2eec2071a9dac0b28ba1e65d5084" - integrity sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg== - dependencies: - is-extglob "^2.1.1" - -is-hexadecimal@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-hexadecimal/-/is-hexadecimal-1.0.4.tgz#cc35c97588da4bd49a8eedd6bc4082d44dcb23a7" - integrity sha512-gyPJuv83bHMpocVYoqof5VDiZveEoGoFL8m3BXNb2VW8Xs+rz9kqO8LOQ5DH6EsuvilT1ApazU0pyl+ytbPtlw== - -is-installed-globally@^0.4.0: - version "0.4.0" - resolved "https://registry.yarnpkg.com/is-installed-globally/-/is-installed-globally-0.4.0.tgz#9a0fd407949c30f86eb6959ef1b7994ed0b7b520" - integrity sha512-iwGqO3J21aaSkC7jWnHP/difazwS7SFeIqxv6wEtLU8Y5KlzFTjyqcSIT0d8s4+dDhKytsk9PJZ2BkS5eZwQRQ== - dependencies: - global-dirs "^3.0.0" - is-path-inside "^3.0.2" - -is-npm@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/is-npm/-/is-npm-5.0.0.tgz#43e8d65cc56e1b67f8d47262cf667099193f45a8" - integrity sha512-WW/rQLOazUq+ST/bCAVBp/2oMERWLsR7OrKyt052dNDk4DHcDE0/7QSXITlmi+VBcV13DfIbysG3tZJm5RfdBA== - -is-number@^7.0.0: - version "7.0.0" - resolved "https://registry.yarnpkg.com/is-number/-/is-number-7.0.0.tgz#7535345b896734d5f80c4d06c50955527a14f12b" - integrity sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng== - -is-obj@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/is-obj/-/is-obj-1.0.1.tgz#3e4729ac1f5fde025cd7d83a896dab9f4f67db0f" - integrity sha512-l4RyHgRqGN4Y3+9JHVrNqO+tN0rV5My76uW5/nuO4K1b6vw5G8d/cmFjP9tRfEsdhZNt0IFdZuK/c2Vr4Nb+Qg== - -is-obj@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/is-obj/-/is-obj-2.0.0.tgz#473fb05d973705e3fd9620545018ca8e22ef4982" - integrity sha512-drqDG3cbczxxEJRoOXcOjtdp1J/lyp1mNn0xaznRs8+muBhgQcrnbspox5X5fOw0HnMnbfDzvnEMEtqDEJEo8w== - -is-path-cwd@^2.2.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/is-path-cwd/-/is-path-cwd-2.2.0.tgz#67d43b82664a7b5191fd9119127eb300048a9fdb" - integrity sha512-w942bTcih8fdJPJmQHFzkS76NEP8Kzzvmw92cXsazb8intwLqPibPPdXf4ANdKV3rYMuuQYGIWtvz9JilB3NFQ== - -is-path-inside@^3.0.2: - version "3.0.3" - resolved "https://registry.yarnpkg.com/is-path-inside/-/is-path-inside-3.0.3.tgz#d231362e53a07ff2b0e0ea7fed049161ffd16283" - integrity sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ== - -is-plain-obj@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/is-plain-obj/-/is-plain-obj-2.1.0.tgz#45e42e37fccf1f40da8e5f76ee21515840c09287" - integrity sha512-YWnfyRwxL/+SsrWYfOpUtz5b3YD+nyfkHvjbcanzk8zgyO4ASD67uVMRt8k5bM4lLMDnXfriRhOpemw+NfT1eA== - -is-plain-obj@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/is-plain-obj/-/is-plain-obj-3.0.0.tgz#af6f2ea14ac5a646183a5bbdb5baabbc156ad9d7" - integrity sha512-gwsOE28k+23GP1B6vFl1oVh/WOzmawBrKwo5Ev6wMKzPkaXaCDIQKzLnvsA42DRlbVTWorkgTKIviAKCWkfUwA== - -is-plain-object@^2.0.4: - version "2.0.4" - resolved "https://registry.yarnpkg.com/is-plain-object/-/is-plain-object-2.0.4.tgz#2c163b3fafb1b606d9d17928f05c2a1c38e07677" - integrity sha512-h5PpgXkWitc38BBMYawTYMWJHFZJVnBquFE57xFpjB8pJFiF6gZ+bU+WyI/yqXiFR5mdLsgYNaPe8uao6Uv9Og== - dependencies: - isobject "^3.0.1" - -is-plain-object@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/is-plain-object/-/is-plain-object-5.0.0.tgz#4427f50ab3429e9025ea7d52e9043a9ef4159344" - integrity sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q== - -is-regexp@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/is-regexp/-/is-regexp-1.0.0.tgz#fd2d883545c46bac5a633e7b9a09e87fa2cb5069" - integrity sha512-7zjFAPO4/gwyQAAgRRmqeEeyIICSdmCqa3tsVHMdBzaXXRiqopZL4Cyghg/XulGWrtABTpbnYYzzIRffLkP4oA== - -is-root@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/is-root/-/is-root-2.1.0.tgz#809e18129cf1129644302a4f8544035d51984a9c" - integrity sha512-AGOriNp96vNBd3HtU+RzFEc75FfR5ymiYv8E553I71SCeXBiMsVDUtdio1OEFvrPyLIQ9tVR5RxXIFe5PUFjMg== - -is-stream@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/is-stream/-/is-stream-2.0.1.tgz#fac1e3d53b97ad5a9d0ae9cef2389f5810a5c077" - integrity sha512-hFoiJiTl63nn+kstHGBtewWSKnQLpyb155KHheA1l39uvtO9nWIop1p3udqPcUd/xbF1VLMO4n7OI6p7RbngDg== - -is-typedarray@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/is-typedarray/-/is-typedarray-1.0.0.tgz#e479c80858df0c1b11ddda6940f96011fcda4a9a" - integrity sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA== - -is-whitespace-character@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-whitespace-character/-/is-whitespace-character-1.0.4.tgz#0858edd94a95594c7c9dd0b5c174ec6e45ee4aa7" - integrity sha512-SDweEzfIZM0SJV0EUga669UTKlmL0Pq8Lno0QDQsPnvECB3IM2aP0gdx5TrU0A01MAPfViaZiI2V1QMZLaKK5w== - -is-word-character@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/is-word-character/-/is-word-character-1.0.4.tgz#ce0e73216f98599060592f62ff31354ddbeb0230" - integrity sha512-5SMO8RVennx3nZrqtKwCGyyetPE9VDba5ugvKLaD4KopPG5kR4mQ7tNt/r7feL5yt5h3lpuBbIUmCOG2eSzXHA== - -is-wsl@^2.2.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/is-wsl/-/is-wsl-2.2.0.tgz#74a4c76e77ca9fd3f932f290c17ea326cd157271" - integrity sha512-fKzAra0rGJUUBwGBgNkHZuToZcn+TtXHpeCgmkMJMMYx1sQDYaCSyjJBSCa2nH1DGm7s3n1oBnohoVTBaN7Lww== - dependencies: - is-docker "^2.0.0" - -is-yarn-global@^0.3.0: - version "0.3.0" - resolved "https://registry.yarnpkg.com/is-yarn-global/-/is-yarn-global-0.3.0.tgz#d502d3382590ea3004893746754c89139973e232" - integrity sha512-VjSeb/lHmkoyd8ryPVIKvOCn4D1koMqY+vqyjjUfc3xyKtP4dYOxM44sZrnqQSzSds3xyOrUTLTC9LVCVgLngw== - -isarray@0.0.1: - version "0.0.1" - resolved "https://registry.yarnpkg.com/isarray/-/isarray-0.0.1.tgz#8a18acfca9a8f4177e09abfc6038939b05d1eedf" - integrity sha512-D2S+3GLxWH+uhrNEcoh/fnmYeP8E8/zHl644d/jdA0g2uyXvy3sb0qxotE+ne0LtccHknQzWwZEzhak7oJ0COQ== - -isarray@~1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/isarray/-/isarray-1.0.0.tgz#bb935d48582cba168c06834957a54a3e07124f11" - integrity sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ== - -isexe@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/isexe/-/isexe-2.0.0.tgz#e8fbf374dc556ff8947a10dcb0572d633f2cfa10" - integrity sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw== - -isobject@^3.0.1: - version "3.0.1" - resolved "https://registry.yarnpkg.com/isobject/-/isobject-3.0.1.tgz#4e431e92b11a9731636aa1f9c8d1ccbcfdab78df" - integrity sha512-WhB9zCku7EGTj/HQQRz5aUQEUeoQZH2bWcltRErOpymJ4boYE6wL9Tbr23krRPSZ+C5zqNSrSw+Cc7sZZ4b7vg== - -jest-util@^29.7.0: - version "29.7.0" - resolved "https://registry.yarnpkg.com/jest-util/-/jest-util-29.7.0.tgz#23c2b62bfb22be82b44de98055802ff3710fc0bc" - integrity sha512-z6EbKajIpqGKU56y5KBUgy1dt1ihhQJgWzUlZHArA/+X2ad7Cb5iF+AK1EWVL/Bo7Rz9uurpqw6SiBCefUbCGA== - dependencies: - "@jest/types" "^29.6.3" - "@types/node" "*" - chalk "^4.0.0" - ci-info "^3.2.0" - graceful-fs "^4.2.9" - picomatch "^2.2.3" - -jest-worker@^27.4.5: - version "27.5.1" - resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-27.5.1.tgz#8d146f0900e8973b106b6f73cc1e9a8cb86f8db0" - integrity sha512-7vuh85V5cdDofPyxn58nrPjBktZo0u9x1g8WtjQol+jZDaE+fhN+cIvTj11GndBnMnyfrUOG1sZQxCdjKh+DKg== - dependencies: - "@types/node" "*" - merge-stream "^2.0.0" - supports-color "^8.0.0" - -jest-worker@^29.1.2: - version "29.7.0" - resolved "https://registry.yarnpkg.com/jest-worker/-/jest-worker-29.7.0.tgz#acad073acbbaeb7262bd5389e1bcf43e10058d4a" - integrity sha512-eIz2msL/EzL9UFTFFx7jBTkeZfku0yUAyZZZmJ93H2TYEiroIx2PQjEXcwYtYl8zXCxb+PAmA2hLIt/6ZEkPHw== - dependencies: - "@types/node" "*" - jest-util "^29.7.0" - merge-stream "^2.0.0" - supports-color "^8.0.0" - -jiti@^1.18.2: - version "1.20.0" - resolved "https://registry.yarnpkg.com/jiti/-/jiti-1.20.0.tgz#2d823b5852ee8963585c8dd8b7992ffc1ae83b42" - integrity sha512-3TV69ZbrvV6U5DfQimop50jE9Dl6J8O1ja1dvBbMba/sZ3YBEQqJ2VZRoQPVnhlzjNtU1vaXRZVrVjU4qtm8yA== - -joi@^17.6.0: - version "17.11.0" - resolved "https://registry.yarnpkg.com/joi/-/joi-17.11.0.tgz#aa9da753578ec7720e6f0ca2c7046996ed04fc1a" - integrity sha512-NgB+lZLNoqISVy1rZocE9PZI36bL/77ie924Ri43yEvi9GUUMPeyVIr8KdFTMUlby1p0PBYMk9spIxEUQYqrJQ== - dependencies: - "@hapi/hoek" "^9.0.0" - "@hapi/topo" "^5.0.0" - "@sideway/address" "^4.1.3" - "@sideway/formula" "^3.0.1" - "@sideway/pinpoint" "^2.0.0" - -"js-tokens@^3.0.0 || ^4.0.0", js-tokens@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499" - integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ== - -js-yaml@^3.13.1: - version "3.14.1" - resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.14.1.tgz#dae812fdb3825fa306609a8717383c50c36a0537" - integrity sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g== - dependencies: - argparse "^1.0.7" - esprima "^4.0.0" - -js-yaml@^4.1.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-4.1.0.tgz#c1fb65f8f5017901cdd2c951864ba18458a10602" - integrity sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA== - dependencies: - argparse "^2.0.1" - -jsesc@^2.5.1: - version "2.5.2" - resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-2.5.2.tgz#80564d2e483dacf6e8ef209650a67df3f0c283a4" - integrity sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA== - -jsesc@~0.5.0: - version "0.5.0" - resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-0.5.0.tgz#e7dee66e35d6fc16f710fe91d5cf69f70f08911d" - integrity sha512-uZz5UnB7u4T9LvwmFqXii7pZSouaRPorGs5who1Ip7VO0wxanFvBL7GkM6dTHlgX+jhBApRetaWpnDabOeTcnA== - -json-buffer@3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.0.tgz#5b1f397afc75d677bde8bcfc0e47e1f9a3d9a898" - integrity sha512-CuUqjv0FUZIdXkHPI8MezCnFCdaTAacej1TZYulLoAg1h/PhwkdXFN4V/gzY4g+fMBCOV2xF+rp7t2XD2ns/NQ== - -json-parse-even-better-errors@^2.3.0, json-parse-even-better-errors@^2.3.1: - version "2.3.1" - resolved "https://registry.yarnpkg.com/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz#7c47805a94319928e05777405dc12e1f7a4ee02d" - integrity sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w== - -json-schema-traverse@^0.4.1: - version "0.4.1" - resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz#69f6a87d9513ab8bb8fe63bdb0979c448e684660" - integrity sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg== - -json-schema-traverse@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz#ae7bcb3656ab77a73ba5c49bf654f38e6b6860e2" - integrity sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug== - -json5@^2.1.2, json5@^2.2.3: - version "2.2.3" - resolved "https://registry.yarnpkg.com/json5/-/json5-2.2.3.tgz#78cd6f1a19bdc12b73db5ad0c61efd66c1e29283" - integrity sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg== - -jsonfile@^6.0.1: - version "6.1.0" - resolved "https://registry.yarnpkg.com/jsonfile/-/jsonfile-6.1.0.tgz#bc55b2634793c679ec6403094eb13698a6ec0aae" - integrity sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ== - dependencies: - universalify "^2.0.0" - optionalDependencies: - graceful-fs "^4.1.6" - -katex@^0.13.0: - version "0.13.24" - resolved "https://registry.yarnpkg.com/katex/-/katex-0.13.24.tgz#fe55455eb455698cb24b911a353d16a3c855d905" - integrity sha512-jZxYuKCma3VS5UuxOx/rFV1QyGSl3Uy/i0kTJF3HgQ5xMinCQVF8Zd4bMY/9aI9b9A2pjIBOsjSSm68ykTAr8w== - dependencies: - commander "^8.0.0" - -keyv@^3.0.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/keyv/-/keyv-3.1.0.tgz#ecc228486f69991e49e9476485a5be1e8fc5c4d9" - integrity sha512-9ykJ/46SN/9KPM/sichzQ7OvXyGDYKGTaDlKMGCAlg2UK8KRy4jb0d8sFc+0Tt0YYnThq8X2RZgCg74RPxgcVA== - dependencies: - json-buffer "3.0.0" - -khroma@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/khroma/-/khroma-2.1.0.tgz#45f2ce94ce231a437cf5b63c2e886e6eb42bbbb1" - integrity sha512-Ls993zuzfayK269Svk9hzpeGUKob/sIgZzyHYdjQoAdQetRKpOLj+k/QQQ/6Qi0Yz65mlROrfd+Ev+1+7dz9Kw== - -kind-of@^6.0.0, kind-of@^6.0.2: - version "6.0.3" - resolved "https://registry.yarnpkg.com/kind-of/-/kind-of-6.0.3.tgz#07c05034a6c349fa06e24fa35aa76db4580ce4dd" - integrity sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw== - -kleur@^3.0.3: - version "3.0.3" - resolved "https://registry.yarnpkg.com/kleur/-/kleur-3.0.3.tgz#a79c9ecc86ee1ce3fa6206d1216c501f147fc07e" - integrity sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w== - -latest-version@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/latest-version/-/latest-version-5.1.0.tgz#119dfe908fe38d15dfa43ecd13fa12ec8832face" - integrity sha512-weT+r0kTkRQdCdYCNtkMwWXQTMEswKrFBkm4ckQOMVhhqhIMI1UT2hMj+1iigIhgSZm5gTmrRXBNoGUgaTY1xA== - dependencies: - package-json "^6.3.0" - -launch-editor@^2.6.0: - version "2.6.1" - resolved "https://registry.yarnpkg.com/launch-editor/-/launch-editor-2.6.1.tgz#f259c9ef95cbc9425620bbbd14b468fcdb4ffe3c" - integrity sha512-eB/uXmFVpY4zezmGp5XtU21kwo7GBbKB+EQ+UZeWtGb9yAM5xt/Evk+lYH3eRNAtId+ej4u7TYPFZ07w4s7rRw== - dependencies: - picocolors "^1.0.0" - shell-quote "^1.8.1" - -layout-base@^1.0.0: - version "1.0.2" - resolved "https://registry.yarnpkg.com/layout-base/-/layout-base-1.0.2.tgz#1291e296883c322a9dd4c5dd82063721b53e26e2" - integrity sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg== - -layout-base@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/layout-base/-/layout-base-2.0.1.tgz#d0337913586c90f9c2c075292069f5c2da5dd285" - integrity sha512-dp3s92+uNI1hWIpPGH3jK2kxE2lMjdXdr+DH8ynZHpd6PUlH6x6cbuXnoMmiNumznqaNO31xu9e79F0uuZ0JFg== - -leven@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/leven/-/leven-3.1.0.tgz#77891de834064cccba82ae7842bb6b14a13ed7f2" - integrity sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A== - -lilconfig@^2.0.3: - version "2.1.0" - resolved "https://registry.yarnpkg.com/lilconfig/-/lilconfig-2.1.0.tgz#78e23ac89ebb7e1bfbf25b18043de756548e7f52" - integrity sha512-utWOt/GHzuUxnLKxB6dk81RoOeoNeHgbrXiuGk4yyF5qlRz+iIVWu56E2fqGHFrXz0QNUhLB/8nKqvRH66JKGQ== - -lines-and-columns@^1.1.6: - version "1.2.4" - resolved "https://registry.yarnpkg.com/lines-and-columns/-/lines-and-columns-1.2.4.tgz#eca284f75d2965079309dc0ad9255abb2ebc1632" - integrity sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg== - -loader-runner@^4.2.0: - version "4.3.0" - resolved "https://registry.yarnpkg.com/loader-runner/-/loader-runner-4.3.0.tgz#c1b4a163b99f614830353b16755e7149ac2314e1" - integrity sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg== - -loader-utils@^2.0.0: - version "2.0.4" - resolved "https://registry.yarnpkg.com/loader-utils/-/loader-utils-2.0.4.tgz#8b5cb38b5c34a9a018ee1fc0e6a066d1dfcc528c" - integrity sha512-xXqpXoINfFhgua9xiqD8fPFHgkoq1mmmpE92WlDbm9rNRd/EbRb+Gqf908T2DMfuHjjJlksiK2RbHVOdD/MqSw== - dependencies: - big.js "^5.2.2" - emojis-list "^3.0.0" - json5 "^2.1.2" - -loader-utils@^3.2.0: - version "3.2.1" - resolved "https://registry.yarnpkg.com/loader-utils/-/loader-utils-3.2.1.tgz#4fb104b599daafd82ef3e1a41fb9265f87e1f576" - integrity sha512-ZvFw1KWS3GVyYBYb7qkmRM/WwL2TQQBxgCK62rlvm4WpVQ23Nb4tYjApUlfjrEGvOs7KHEsmyUn75OHZrJMWPw== - -locate-path@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-3.0.0.tgz#dbec3b3ab759758071b58fe59fc41871af21400e" - integrity sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A== - dependencies: - p-locate "^3.0.0" - path-exists "^3.0.0" - -locate-path@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-5.0.0.tgz#1afba396afd676a6d42504d0a67a3a7eb9f62aa0" - integrity sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g== - dependencies: - p-locate "^4.1.0" - -locate-path@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-6.0.0.tgz#55321eb309febbc59c4801d931a72452a681d286" - integrity sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw== - dependencies: - p-locate "^5.0.0" - -lodash-es@^4.17.21: - version "4.17.21" - resolved "https://registry.yarnpkg.com/lodash-es/-/lodash-es-4.17.21.tgz#43e626c46e6591b7750beb2b50117390c609e3ee" - integrity sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw== - -lodash.curry@^4.0.1: - version "4.1.1" - resolved "https://registry.yarnpkg.com/lodash.curry/-/lodash.curry-4.1.1.tgz#248e36072ede906501d75966200a86dab8b23170" - integrity sha512-/u14pXGviLaweY5JI0IUzgzF2J6Ne8INyzAZjImcryjgkZ+ebruBxy2/JaOOkTqScddcYtakjhSaeemV8lR0tA== - -lodash.debounce@^4.0.8: - version "4.0.8" - resolved "https://registry.yarnpkg.com/lodash.debounce/-/lodash.debounce-4.0.8.tgz#82d79bff30a67c4005ffd5e2515300ad9ca4d7af" - integrity sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow== - -lodash.escape@^4.0.1: - version "4.0.1" - resolved "https://registry.yarnpkg.com/lodash.escape/-/lodash.escape-4.0.1.tgz#c9044690c21e04294beaa517712fded1fa88de98" - integrity sha512-nXEOnb/jK9g0DYMr1/Xvq6l5xMD7GDG55+GSYIYmS0G4tBk/hURD4JR9WCavs04t33WmJx9kCyp9vJ+mr4BOUw== - -lodash.flatten@^4.4.0: - version "4.4.0" - resolved "https://registry.yarnpkg.com/lodash.flatten/-/lodash.flatten-4.4.0.tgz#f31c22225a9632d2bbf8e4addbef240aa765a61f" - integrity sha512-C5N2Z3DgnnKr0LOpv/hKCgKdb7ZZwafIrsesve6lmzvZIRZRGaZ/l6Q8+2W7NaT+ZwO3fFlSCzCzrDCFdJfZ4g== - -lodash.flow@^3.3.0: - version "3.5.0" - resolved "https://registry.yarnpkg.com/lodash.flow/-/lodash.flow-3.5.0.tgz#87bf40292b8cf83e4e8ce1a3ae4209e20071675a" - integrity sha512-ff3BX/tSioo+XojX4MOsOMhJw0nZoUEF011LX8g8d3gvjVbxd89cCio4BCXronjxcTUIJUoqKEUA+n4CqvvRPw== - -lodash.invokemap@^4.6.0: - version "4.6.0" - resolved "https://registry.yarnpkg.com/lodash.invokemap/-/lodash.invokemap-4.6.0.tgz#1748cda5d8b0ef8369c4eb3ec54c21feba1f2d62" - integrity sha512-CfkycNtMqgUlfjfdh2BhKO/ZXrP8ePOX5lEU/g0R3ItJcnuxWDwokMGKx1hWcfOikmyOVx6X9IwWnDGlgKl61w== - -lodash.memoize@^4.1.2: - version "4.1.2" - resolved "https://registry.yarnpkg.com/lodash.memoize/-/lodash.memoize-4.1.2.tgz#bcc6c49a42a2840ed997f323eada5ecd182e0bfe" - integrity sha512-t7j+NzmgnQzTAYXcsHYLgimltOV1MXHtlOWf6GjL9Kj8GK5FInw5JotxvbOs+IvV1/Dzo04/fCGfLVs7aXb4Ag== - -lodash.pullall@^4.2.0: - version "4.2.0" - resolved "https://registry.yarnpkg.com/lodash.pullall/-/lodash.pullall-4.2.0.tgz#9d98b8518b7c965b0fae4099bd9fb7df8bbf38ba" - integrity sha512-VhqxBKH0ZxPpLhiu68YD1KnHmbhQJQctcipvmFnqIBDYzcIHzf3Zpu0tpeOKtR4x76p9yohc506eGdOjTmyIBg== - -lodash.uniq@4.5.0, lodash.uniq@^4.5.0: - version "4.5.0" - resolved "https://registry.yarnpkg.com/lodash.uniq/-/lodash.uniq-4.5.0.tgz#d0225373aeb652adc1bc82e4945339a842754773" - integrity sha512-xfBaXQd9ryd9dlSDvnvI0lvxfLJlYAZzXomUYzLKtUeOQvOP5piqAWuGtrhWeqaXK9hhoM/iyJc5AV+XfsX3HQ== - -lodash.uniqby@^4.7.0: - version "4.7.0" - resolved "https://registry.yarnpkg.com/lodash.uniqby/-/lodash.uniqby-4.7.0.tgz#d99c07a669e9e6d24e1362dfe266c67616af1302" - integrity sha512-e/zcLx6CSbmaEgFHCA7BnoQKyCtKMxnuWrJygbwPs/AIn+IMKl66L8/s+wBUn5LRw2pZx3bUHibiV1b6aTWIww== - -lodash@^4.17.19, lodash@^4.17.20, lodash@^4.17.21: - version "4.17.21" - resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.21.tgz#679591c564c3bffaae8454cf0b3df370c3d6911c" - integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg== - -loose-envify@^1.0.0, loose-envify@^1.1.0, loose-envify@^1.2.0, loose-envify@^1.3.1, loose-envify@^1.4.0: - version "1.4.0" - resolved "https://registry.yarnpkg.com/loose-envify/-/loose-envify-1.4.0.tgz#71ee51fa7be4caec1a63839f7e682d8132d30caf" - integrity sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q== - dependencies: - js-tokens "^3.0.0 || ^4.0.0" - -lower-case@^2.0.2: - version "2.0.2" - resolved "https://registry.yarnpkg.com/lower-case/-/lower-case-2.0.2.tgz#6fa237c63dbdc4a82ca0fd882e4722dc5e634e28" - integrity sha512-7fm3l3NAF9WfN6W3JOmf5drwpVqX78JtoGJ3A6W0a6ZnldM41w2fV5D490psKFTpMds8TJse/eHLFFsNHHjHgg== - dependencies: - tslib "^2.0.3" - -lowercase-keys@^1.0.0, lowercase-keys@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-1.0.1.tgz#6f9e30b47084d971a7c820ff15a6c5167b74c26f" - integrity sha512-G2Lj61tXDnVFFOi8VZds+SoQjtQC3dgokKdDG2mTm1tx4m50NUHBOZSBwQQHyy0V12A0JTG4icfZQH+xPyh8VA== - -lowercase-keys@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-2.0.0.tgz#2603e78b7b4b0006cbca2fbcc8a3202558ac9479" - integrity sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA== - -lru-cache@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-5.1.1.tgz#1da27e6710271947695daf6848e847f01d84b920" - integrity sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w== - dependencies: - yallist "^3.0.2" - -lru-cache@^6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/lru-cache/-/lru-cache-6.0.0.tgz#6d6fe6570ebd96aaf90fcad1dafa3b2566db3a94" - integrity sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA== - dependencies: - yallist "^4.0.0" - -make-dir@^3.0.0, make-dir@^3.0.2, make-dir@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/make-dir/-/make-dir-3.1.0.tgz#415e967046b3a7f1d185277d84aa58203726a13f" - integrity sha512-g3FeP20LNwhALb/6Cz6Dd4F2ngze0jz7tbzrD2wAV+o9FeNHe4rL+yK2md0J/fiSf1sa1ADhXqi5+oVwOM/eGw== - dependencies: - semver "^6.0.0" - -markdown-escapes@^1.0.0: - version "1.0.4" - resolved "https://registry.yarnpkg.com/markdown-escapes/-/markdown-escapes-1.0.4.tgz#c95415ef451499d7602b91095f3c8e8975f78535" - integrity sha512-8z4efJYk43E0upd0NbVXwgSTQs6cT3T06etieCMEg7dRbzCbxUCK/GHlX8mhHRDcp+OLlHkPKsvqQTCvsRl2cg== - -mdast-squeeze-paragraphs@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/mdast-squeeze-paragraphs/-/mdast-squeeze-paragraphs-4.0.0.tgz#7c4c114679c3bee27ef10b58e2e015be79f1ef97" - integrity sha512-zxdPn69hkQ1rm4J+2Cs2j6wDEv7O17TfXTJ33tl/+JPIoEmtV9t2ZzBM5LPHE8QlHsmVD8t3vPKCyY3oH+H8MQ== - dependencies: - unist-util-remove "^2.0.0" - -mdast-util-definitions@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/mdast-util-definitions/-/mdast-util-definitions-4.0.0.tgz#c5c1a84db799173b4dcf7643cda999e440c24db2" - integrity sha512-k8AJ6aNnUkB7IE+5azR9h81O5EQ/cTDXtWdMq9Kk5KcEW/8ritU5CeLg/9HhOC++nALHBlaogJ5jz0Ybk3kPMQ== - dependencies: - unist-util-visit "^2.0.0" - -mdast-util-from-markdown@^0.8.0: - version "0.8.5" - resolved "https://registry.yarnpkg.com/mdast-util-from-markdown/-/mdast-util-from-markdown-0.8.5.tgz#d1ef2ca42bc377ecb0463a987910dae89bd9a28c" - integrity sha512-2hkTXtYYnr+NubD/g6KGBS/0mFmBcifAsI0yIWRiRo0PjVs6SSOSOdtzbp6kSGnShDN6G5aWZpKQ2lWRy27mWQ== - dependencies: - "@types/mdast" "^3.0.0" - mdast-util-to-string "^2.0.0" - micromark "~2.11.0" - parse-entities "^2.0.0" - unist-util-stringify-position "^2.0.0" - -mdast-util-to-hast@10.0.1: - version "10.0.1" - resolved "https://registry.yarnpkg.com/mdast-util-to-hast/-/mdast-util-to-hast-10.0.1.tgz#0cfc82089494c52d46eb0e3edb7a4eb2aea021eb" - integrity sha512-BW3LM9SEMnjf4HXXVApZMt8gLQWVNXc3jryK0nJu/rOXPOnlkUjmdkDlmxMirpbU9ILncGFIwLH/ubnWBbcdgA== - dependencies: - "@types/mdast" "^3.0.0" - "@types/unist" "^2.0.0" - mdast-util-definitions "^4.0.0" - mdurl "^1.0.0" - unist-builder "^2.0.0" - unist-util-generated "^1.0.0" - unist-util-position "^3.0.0" - unist-util-visit "^2.0.0" - -mdast-util-to-hast@^10.2.0: - version "10.2.0" - resolved "https://registry.yarnpkg.com/mdast-util-to-hast/-/mdast-util-to-hast-10.2.0.tgz#61875526a017d8857b71abc9333942700b2d3604" - integrity sha512-JoPBfJ3gBnHZ18icCwHR50orC9kNH81tiR1gs01D8Q5YpV6adHNO9nKNuFBCJQ941/32PT1a63UF/DitmS3amQ== - dependencies: - "@types/mdast" "^3.0.0" - "@types/unist" "^2.0.0" - mdast-util-definitions "^4.0.0" - mdurl "^1.0.0" - unist-builder "^2.0.0" - unist-util-generated "^1.0.0" - unist-util-position "^3.0.0" - unist-util-visit "^2.0.0" - -mdast-util-to-string@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/mdast-util-to-string/-/mdast-util-to-string-2.0.0.tgz#b8cfe6a713e1091cb5b728fc48885a4767f8b97b" - integrity sha512-AW4DRS3QbBayY/jJmD8437V1Gombjf8RSOUCMFBuo5iHi58AGEgVCKQ+ezHkZZDpAQS75hcBMpLqjpJTjtUL7w== - -mdn-data@2.0.14: - version "2.0.14" - resolved "https://registry.yarnpkg.com/mdn-data/-/mdn-data-2.0.14.tgz#7113fc4281917d63ce29b43446f701e68c25ba50" - integrity sha512-dn6wd0uw5GsdswPFfsgMp5NSB0/aDe6fK94YJV/AJDYXL6HVLWBsxeq7js7Ad+mU2K9LAlwpk6kN2D5mwCPVow== - -mdurl@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/mdurl/-/mdurl-1.0.1.tgz#fe85b2ec75a59037f2adfec100fd6c601761152e" - integrity sha512-/sKlQJCBYVY9Ers9hqzKou4H6V5UWc/M59TH2dvkt+84itfnq7uFOMLpOiOS4ujvHP4etln18fmIxA5R5fll0g== - -media-typer@0.3.0: - version "0.3.0" - resolved "https://registry.yarnpkg.com/media-typer/-/media-typer-0.3.0.tgz#8710d7af0aa626f8fffa1ce00168545263255748" - integrity sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ== - -memfs@^3.1.2, memfs@^3.4.3: - version "3.6.0" - resolved "https://registry.yarnpkg.com/memfs/-/memfs-3.6.0.tgz#d7a2110f86f79dd950a8b6df6d57bc984aa185f6" - integrity sha512-EGowvkkgbMcIChjMTMkESFDbZeSh8xZ7kNSF0hAiAN4Jh6jgHCRS0Ga/+C8y6Au+oqpezRHCfPsmJ2+DwAgiwQ== - dependencies: - fs-monkey "^1.0.4" - -merge-descriptors@1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/merge-descriptors/-/merge-descriptors-1.0.1.tgz#b00aaa556dd8b44568150ec9d1b953f3f90cbb61" - integrity sha512-cCi6g3/Zr1iqQi6ySbseM1Xvooa98N0w31jzUYrXPX2xqObmFGHJ0tQ5u74H3mVh7wLouTseZyYIq39g8cNp1w== - -merge-stream@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/merge-stream/-/merge-stream-2.0.0.tgz#52823629a14dd00c9770fb6ad47dc6310f2c1f60" - integrity sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w== - -merge2@^1.3.0, merge2@^1.4.1: - version "1.4.1" - resolved "https://registry.yarnpkg.com/merge2/-/merge2-1.4.1.tgz#4368892f885e907455a6fd7dc55c0c9d404990ae" - integrity sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg== - -mermaid@^9.2.2: - version "9.4.3" - resolved "https://registry.yarnpkg.com/mermaid/-/mermaid-9.4.3.tgz#62cf210c246b74972ea98c19837519b6f03427f2" - integrity sha512-TLkQEtqhRSuEHSE34lh5bCa94KATCyluAXmFnNI2PRZwOpXFeqiJWwZl+d2CcemE1RS6QbbueSSq9QIg8Uxcyw== - dependencies: - "@braintree/sanitize-url" "^6.0.0" - cytoscape "^3.23.0" - cytoscape-cose-bilkent "^4.1.0" - cytoscape-fcose "^2.1.0" - d3 "^7.4.0" - dagre-d3-es "7.0.9" - dayjs "^1.11.7" - dompurify "2.4.3" - elkjs "^0.8.2" - khroma "^2.0.0" - lodash-es "^4.17.21" - non-layered-tidy-tree-layout "^2.0.2" - stylis "^4.1.2" - ts-dedent "^2.2.0" - uuid "^9.0.0" - web-worker "^1.2.0" - -methods@~1.1.2: - version "1.1.2" - resolved "https://registry.yarnpkg.com/methods/-/methods-1.1.2.tgz#5529a4d67654134edcc5266656835b0f851afcee" - integrity sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w== - -micromark@~2.11.0: - version "2.11.4" - resolved "https://registry.yarnpkg.com/micromark/-/micromark-2.11.4.tgz#d13436138eea826383e822449c9a5c50ee44665a" - integrity sha512-+WoovN/ppKolQOFIAajxi7Lu9kInbPxFuTBVEavFcL8eAfVstoc5MocPmqBeAdBOJV00uaVjegzH4+MA0DN/uA== - dependencies: - debug "^4.0.0" - parse-entities "^2.0.0" - -micromatch@^4.0.2, micromatch@^4.0.4, micromatch@^4.0.5: - version "4.0.5" - resolved "https://registry.yarnpkg.com/micromatch/-/micromatch-4.0.5.tgz#bc8999a7cbbf77cdc89f132f6e467051b49090c6" - integrity sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA== - dependencies: - braces "^3.0.2" - picomatch "^2.3.1" - -mime-db@1.52.0, "mime-db@>= 1.43.0 < 2": - version "1.52.0" - resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.52.0.tgz#bbabcdc02859f4987301c856e3387ce5ec43bf70" - integrity sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg== - -mime-db@~1.33.0: - version "1.33.0" - resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.33.0.tgz#a3492050a5cb9b63450541e39d9788d2272783db" - integrity sha512-BHJ/EKruNIqJf/QahvxwQZXKygOQ256myeN/Ew+THcAa5q+PjyTTMMeNQC4DZw5AwfvelsUrA6B67NKMqXDbzQ== - -mime-types@2.1.18: - version "2.1.18" - resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.18.tgz#6f323f60a83d11146f831ff11fd66e2fe5503bb8" - integrity sha512-lc/aahn+t4/SWV/qcmumYjymLsWfN3ELhpmVuUFjgsORruuZPVSwAQryq+HHGvO/SI2KVX26bx+En+zhM8g8hQ== - dependencies: - mime-db "~1.33.0" - -mime-types@^2.1.27, mime-types@^2.1.31, mime-types@~2.1.17, mime-types@~2.1.24, mime-types@~2.1.34: - version "2.1.35" - resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.35.tgz#381a871b62a734450660ae3deee44813f70d959a" - integrity sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw== - dependencies: - mime-db "1.52.0" - -mime@1.6.0: - version "1.6.0" - resolved "https://registry.yarnpkg.com/mime/-/mime-1.6.0.tgz#32cd9e5c64553bd58d19a568af452acff04981b1" - integrity sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg== - -mimic-fn@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/mimic-fn/-/mimic-fn-2.1.0.tgz#7ed2c2ccccaf84d3ffcb7a69b57711fc2083401b" - integrity sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg== - -mimic-response@^1.0.0, mimic-response@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/mimic-response/-/mimic-response-1.0.1.tgz#4923538878eef42063cb8a3e3b0798781487ab1b" - integrity sha512-j5EctnkH7amfV/q5Hgmoal1g2QHFJRraOtmx0JpIqkxhBhI/lJSl1nMpQ45hVarwNETOoWEimndZ4QK0RHxuxQ== - -mini-css-extract-plugin@^2.6.1: - version "2.7.6" - resolved "https://registry.yarnpkg.com/mini-css-extract-plugin/-/mini-css-extract-plugin-2.7.6.tgz#282a3d38863fddcd2e0c220aaed5b90bc156564d" - integrity sha512-Qk7HcgaPkGG6eD77mLvZS1nmxlao3j+9PkrT9Uc7HAE1id3F41+DdBRYRYkbyfNRGzm8/YWtzhw7nVPmwhqTQw== - dependencies: - schema-utils "^4.0.0" - -minimalistic-assert@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz#2e194de044626d4a10e7f7fbc00ce73e83e4d5c7" - integrity sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A== - -minimatch@3.1.2, minimatch@^3.0.4, minimatch@^3.0.5, minimatch@^3.1.1: - version "3.1.2" - resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.1.2.tgz#19cd194bfd3e428f049a70817c038d89ab4be35b" - integrity sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw== - dependencies: - brace-expansion "^1.1.7" - -minimist@^1.2.0, minimist@^1.2.5: - version "1.2.8" - resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c" - integrity sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA== - -mrmime@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/mrmime/-/mrmime-1.0.1.tgz#5f90c825fad4bdd41dc914eff5d1a8cfdaf24f27" - integrity sha512-hzzEagAgDyoU1Q6yg5uI+AorQgdvMCur3FcKf7NhMKWsaYg+RnbTyHRa/9IlLF9rf455MOCtcqqrQQ83pPP7Uw== - -ms@2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/ms/-/ms-2.0.0.tgz#5608aeadfc00be6c2901df5f9861788de0d597c8" - integrity sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A== - -ms@2.1.2: - version "2.1.2" - resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.2.tgz#d09d1f357b443f493382a8eb3ccd183872ae6009" - integrity sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w== - -ms@2.1.3: - version "2.1.3" - resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.3.tgz#574c8138ce1d2b5861f0b44579dbadd60c6615b2" - integrity sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA== - -multicast-dns@^7.2.5: - version "7.2.5" - resolved "https://registry.yarnpkg.com/multicast-dns/-/multicast-dns-7.2.5.tgz#77eb46057f4d7adbd16d9290fa7299f6fa64cced" - integrity sha512-2eznPJP8z2BFLX50tf0LuODrpINqP1RVIm/CObbTcBRITQgmC/TjcREF1NeTBzIcR5XO/ukWo+YHOjBbFwIupg== - dependencies: - dns-packet "^5.2.2" - thunky "^1.0.2" - -nanoid@^3.3.6: - version "3.3.6" - resolved "https://registry.yarnpkg.com/nanoid/-/nanoid-3.3.6.tgz#443380c856d6e9f9824267d960b4236ad583ea4c" - integrity sha512-BGcqMMJuToF7i1rt+2PWSNVnWIkGCU78jBG3RxO/bZlnZPK2Cmi2QaffxGO/2RvWi9sL+FAiRiXMgsyxQ1DIDA== - -negotiator@0.6.3: - version "0.6.3" - resolved "https://registry.yarnpkg.com/negotiator/-/negotiator-0.6.3.tgz#58e323a72fedc0d6f9cd4d31fe49f51479590ccd" - integrity sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg== - -neo-async@^2.6.2: - version "2.6.2" - resolved "https://registry.yarnpkg.com/neo-async/-/neo-async-2.6.2.tgz#b4aafb93e3aeb2d8174ca53cf163ab7d7308305f" - integrity sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw== - -no-case@^3.0.4: - version "3.0.4" - resolved "https://registry.yarnpkg.com/no-case/-/no-case-3.0.4.tgz#d361fd5c9800f558551a8369fc0dcd4662b6124d" - integrity sha512-fgAN3jGAh+RoxUGZHTSOLJIqUc2wmoBwGR4tbpNAKmmovFoWq0OdRkb0VkldReO2a2iBT/OEulG9XSUc10r3zg== - dependencies: - lower-case "^2.0.2" - tslib "^2.0.3" - -node-emoji@^1.10.0: - version "1.11.0" - resolved "https://registry.yarnpkg.com/node-emoji/-/node-emoji-1.11.0.tgz#69a0150e6946e2f115e9d7ea4df7971e2628301c" - integrity sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A== - dependencies: - lodash "^4.17.21" - -node-fetch@^2.6.12: - version "2.7.0" - resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d" - integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A== - dependencies: - whatwg-url "^5.0.0" - -node-forge@^1: - version "1.3.1" - resolved "https://registry.yarnpkg.com/node-forge/-/node-forge-1.3.1.tgz#be8da2af243b2417d5f646a770663a92b7e9ded3" - integrity sha512-dPEtOeMvF9VMcYV/1Wb8CPoVAXtp6MKMlcbAt4ddqmGqUJ6fQZFXkNZNkNlfevtNkGtaSoXf/vNNNSvgrdXwtA== - -node-releases@^2.0.13: - version "2.0.13" - resolved "https://registry.yarnpkg.com/node-releases/-/node-releases-2.0.13.tgz#d5ed1627c23e3461e819b02e57b75e4899b1c81d" - integrity sha512-uYr7J37ae/ORWdZeQ1xxMJe3NtdmqMC/JZK+geofDrkLUApKRHPd18/TxtBOJ4A0/+uUIliorNrfYV6s1b02eQ== - -non-layered-tidy-tree-layout@^2.0.2: - version "2.0.2" - resolved "https://registry.yarnpkg.com/non-layered-tidy-tree-layout/-/non-layered-tidy-tree-layout-2.0.2.tgz#57d35d13c356643fc296a55fb11ac15e74da7804" - integrity sha512-gkXMxRzUH+PB0ax9dUN0yYF0S25BqeAYqhgMaLUFmpXLEk7Fcu8f4emJuOAY0V8kjDICxROIKsTAKsV/v355xw== - -normalize-path@^3.0.0, normalize-path@~3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/normalize-path/-/normalize-path-3.0.0.tgz#0dcd69ff23a1c9b11fd0978316644a0388216a65" - integrity sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA== - -normalize-range@^0.1.2: - version "0.1.2" - resolved "https://registry.yarnpkg.com/normalize-range/-/normalize-range-0.1.2.tgz#2d10c06bdfd312ea9777695a4d28439456b75942" - integrity sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA== - -normalize-url@^4.1.0: - version "4.5.1" - resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-4.5.1.tgz#0dd90cf1288ee1d1313b87081c9a5932ee48518a" - integrity sha512-9UZCFRHQdNrfTpGg8+1INIg93B6zE0aXMVFkw1WFwvO4SlZywU6aLg5Of0Ap/PgcbSw4LNxvMWXMeugwMCX0AA== - -normalize-url@^6.0.1: - version "6.1.0" - resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-6.1.0.tgz#40d0885b535deffe3f3147bec877d05fe4c5668a" - integrity sha512-DlL+XwOy3NxAQ8xuC0okPgK46iuVNAK01YN7RueYBqqFeGsBjV9XmCAzAdgt+667bCl5kPh9EqKKDwnaPG1I7A== - -npm-run-path@^4.0.1: - version "4.0.1" - resolved "https://registry.yarnpkg.com/npm-run-path/-/npm-run-path-4.0.1.tgz#b7ecd1e5ed53da8e37a55e1c2269e0b97ed748ea" - integrity sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw== - dependencies: - path-key "^3.0.0" - -nprogress@^0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/nprogress/-/nprogress-0.2.0.tgz#cb8f34c53213d895723fcbab907e9422adbcafb1" - integrity sha512-I19aIingLgR1fmhftnbWWO3dXc0hSxqHQHQb3H8m+K3TnEn/iSeTZZOyvKXWqQESMwuUVnatlCnZdLBZZt2VSA== - -nth-check@^2.0.1: - version "2.1.1" - resolved "https://registry.yarnpkg.com/nth-check/-/nth-check-2.1.1.tgz#c9eab428effce36cd6b92c924bdb000ef1f1ed1d" - integrity sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w== - dependencies: - boolbase "^1.0.0" - -object-assign@^4.1.0, object-assign@^4.1.1: - version "4.1.1" - resolved "https://registry.yarnpkg.com/object-assign/-/object-assign-4.1.1.tgz#2109adc7965887cfc05cbbd442cac8bfbb360863" - integrity sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg== - -object-inspect@^1.9.0: - version "1.12.3" - resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.12.3.tgz#ba62dffd67ee256c8c086dfae69e016cd1f198b9" - integrity sha512-geUvdk7c+eizMNUDkRpW1wJwgfOiOeHbxBR/hLXK1aT6zmVSO0jsQcs7fj6MGw89jC/cjGfLcNOrtMYtGqm81g== - -object-keys@^1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/object-keys/-/object-keys-1.1.1.tgz#1c47f272df277f3b1daf061677d9c82e2322c60e" - integrity sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA== - -object.assign@^4.1.0: - version "4.1.4" - resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.4.tgz#9673c7c7c351ab8c4d0b516f4343ebf4dfb7799f" - integrity sha512-1mxKf0e58bvyjSCtKYY4sRe9itRk3PJpquJOjeIkz885CczcI4IvJJDLPS72oowuSh+pBxUFROpX+TU++hxhZQ== - dependencies: - call-bind "^1.0.2" - define-properties "^1.1.4" - has-symbols "^1.0.3" - object-keys "^1.1.1" - -obuf@^1.0.0, obuf@^1.1.2: - version "1.1.2" - resolved "https://registry.yarnpkg.com/obuf/-/obuf-1.1.2.tgz#09bea3343d41859ebd446292d11c9d4db619084e" - integrity sha512-PX1wu0AmAdPqOL1mWhqmlOd8kOIZQwGZw6rh7uby9fTc5lhaOWFLX3I6R1hrF9k3zUY40e6igsLGkDXK92LJNg== - -on-finished@2.4.1: - version "2.4.1" - resolved "https://registry.yarnpkg.com/on-finished/-/on-finished-2.4.1.tgz#58c8c44116e54845ad57f14ab10b03533184ac3f" - integrity sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg== - dependencies: - ee-first "1.1.1" - -on-headers@~1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/on-headers/-/on-headers-1.0.2.tgz#772b0ae6aaa525c399e489adfad90c403eb3c28f" - integrity sha512-pZAE+FJLoyITytdqK0U5s+FIpjN0JP3OzFi/u8Rx+EV5/W+JTWGXG8xFzevE7AjBfDqHv/8vL8qQsIhHnqRkrA== - -once@^1.3.0, once@^1.3.1, once@^1.4.0: - version "1.4.0" - resolved "https://registry.yarnpkg.com/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1" - integrity sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w== - dependencies: - wrappy "1" - -onetime@^5.1.2: - version "5.1.2" - resolved "https://registry.yarnpkg.com/onetime/-/onetime-5.1.2.tgz#d0e96ebb56b07476df1dd9c4806e5237985ca45e" - integrity sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg== - dependencies: - mimic-fn "^2.1.0" - -open@^8.0.9, open@^8.4.0: - version "8.4.2" - resolved "https://registry.yarnpkg.com/open/-/open-8.4.2.tgz#5b5ffe2a8f793dcd2aad73e550cb87b59cb084f9" - integrity sha512-7x81NCL719oNbsq/3mh+hVrAWmFuEYUqrq/Iw3kUzH8ReypT9QQ0BLoJS7/G9k6N81XjW4qHWtjWwe/9eLy1EQ== - dependencies: - define-lazy-prop "^2.0.0" - is-docker "^2.1.1" - is-wsl "^2.2.0" - -opener@^1.5.2: - version "1.5.2" - resolved "https://registry.yarnpkg.com/opener/-/opener-1.5.2.tgz#5d37e1f35077b9dcac4301372271afdeb2a13598" - integrity sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A== - -p-cancelable@^1.0.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/p-cancelable/-/p-cancelable-1.1.0.tgz#d078d15a3af409220c886f1d9a0ca2e441ab26cc" - integrity sha512-s73XxOZ4zpt1edZYZzvhqFa6uvQc1vwUa0K0BdtIZgQMAJj9IbebH+JkgKZc9h+B05PKHLOTl4ajG1BmNrVZlw== - -p-limit@^2.0.0, p-limit@^2.2.0: - version "2.3.0" - resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-2.3.0.tgz#3dd33c647a214fdfffd835933eb086da0dc21db1" - integrity sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w== - dependencies: - p-try "^2.0.0" - -p-limit@^3.0.2: - version "3.1.0" - resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-3.1.0.tgz#e1daccbe78d0d1388ca18c64fea38e3e57e3706b" - integrity sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ== - dependencies: - yocto-queue "^0.1.0" - -p-locate@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-3.0.0.tgz#322d69a05c0264b25997d9f40cd8a891ab0064a4" - integrity sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ== - dependencies: - p-limit "^2.0.0" - -p-locate@^4.1.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-4.1.0.tgz#a3428bb7088b3a60292f66919278b7c297ad4f07" - integrity sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A== - dependencies: - p-limit "^2.2.0" - -p-locate@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-5.0.0.tgz#83c8315c6785005e3bd021839411c9e110e6d834" - integrity sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw== - dependencies: - p-limit "^3.0.2" - -p-map@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/p-map/-/p-map-4.0.0.tgz#bb2f95a5eda2ec168ec9274e06a747c3e2904d2b" - integrity sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ== - dependencies: - aggregate-error "^3.0.0" - -p-retry@^4.5.0: - version "4.6.2" - resolved "https://registry.yarnpkg.com/p-retry/-/p-retry-4.6.2.tgz#9baae7184057edd4e17231cee04264106e092a16" - integrity sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ== - dependencies: - "@types/retry" "0.12.0" - retry "^0.13.1" - -p-try@^2.0.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6" - integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ== - -package-json@^6.3.0: - version "6.5.0" - resolved "https://registry.yarnpkg.com/package-json/-/package-json-6.5.0.tgz#6feedaca35e75725876d0b0e64974697fed145b0" - integrity sha512-k3bdm2n25tkyxcjSKzB5x8kfVxlMdgsbPr0GkZcwHsLpba6cBjqCt1KlcChKEvxHIcTB1FVMuwoijZ26xex5MQ== - dependencies: - got "^9.6.0" - registry-auth-token "^4.0.0" - registry-url "^5.0.0" - semver "^6.2.0" - -param-case@^3.0.4: - version "3.0.4" - resolved "https://registry.yarnpkg.com/param-case/-/param-case-3.0.4.tgz#7d17fe4aa12bde34d4a77d91acfb6219caad01c5" - integrity sha512-RXlj7zCYokReqWpOPH9oYivUzLYZ5vAPIfEmCTNViosC78F8F0H9y7T7gG2M39ymgutxF5gcFEsyZQSph9Bp3A== - dependencies: - dot-case "^3.0.4" - tslib "^2.0.3" - -parent-module@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/parent-module/-/parent-module-1.0.1.tgz#691d2709e78c79fae3a156622452d00762caaaa2" - integrity sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g== - dependencies: - callsites "^3.0.0" - -parse-entities@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/parse-entities/-/parse-entities-2.0.0.tgz#53c6eb5b9314a1f4ec99fa0fdf7ce01ecda0cbe8" - integrity sha512-kkywGpCcRYhqQIchaWqZ875wzpS/bMKhz5HnN3p7wveJTkTtyAB/AlnS0f8DFSqYW1T82t6yEAkEcB+A1I3MbQ== - dependencies: - character-entities "^1.0.0" - character-entities-legacy "^1.0.0" - character-reference-invalid "^1.0.0" - is-alphanumerical "^1.0.0" - is-decimal "^1.0.0" - is-hexadecimal "^1.0.0" - -parse-json@^5.0.0, parse-json@^5.2.0: - version "5.2.0" - resolved "https://registry.yarnpkg.com/parse-json/-/parse-json-5.2.0.tgz#c76fc66dee54231c962b22bcc8a72cf2f99753cd" - integrity sha512-ayCKvm/phCGxOkYRSCM82iDwct8/EonSEgCSxWxD7ve6jHggsFl4fZVQBPRNgQoKiuV/odhFrGzQXZwbifC8Rg== - dependencies: - "@babel/code-frame" "^7.0.0" - error-ex "^1.3.1" - json-parse-even-better-errors "^2.3.0" - lines-and-columns "^1.1.6" - -parse-numeric-range@^1.3.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/parse-numeric-range/-/parse-numeric-range-1.3.0.tgz#7c63b61190d61e4d53a1197f0c83c47bb670ffa3" - integrity sha512-twN+njEipszzlMJd4ONUYgSfZPDxgHhT9Ahed5uTigpQn90FggW4SA/AIPq/6a149fTbE9qBEcSwE3FAEp6wQQ== - -parse5-htmlparser2-tree-adapter@^7.0.0: - version "7.0.0" - resolved "https://registry.yarnpkg.com/parse5-htmlparser2-tree-adapter/-/parse5-htmlparser2-tree-adapter-7.0.0.tgz#23c2cc233bcf09bb7beba8b8a69d46b08c62c2f1" - integrity sha512-B77tOZrqqfUfnVcOrUvfdLbz4pu4RopLD/4vmu3HUPswwTA8OH0EMW9BlWR2B0RCoiZRAHEUu7IxeP1Pd1UU+g== - dependencies: - domhandler "^5.0.2" - parse5 "^7.0.0" - -parse5@^6.0.0: - version "6.0.1" - resolved "https://registry.yarnpkg.com/parse5/-/parse5-6.0.1.tgz#e1a1c085c569b3dc08321184f19a39cc27f7c30b" - integrity sha512-Ofn/CTFzRGTTxwpNEs9PP93gXShHcTq255nzRYSKe8AkVpZY7e1fpmTfOyoIvjP5HG7Z2ZM7VS9PPhQGW2pOpw== - -parse5@^7.0.0: - version "7.1.2" - resolved "https://registry.yarnpkg.com/parse5/-/parse5-7.1.2.tgz#0736bebbfd77793823240a23b7fc5e010b7f8e32" - integrity sha512-Czj1WaSVpaoj0wbhMzLmWD69anp2WH7FXMB9n1Sy8/ZFF9jolSQVMu1Ij5WIyGmcBmhk7EOndpO4mIpihVqAXw== - dependencies: - entities "^4.4.0" - -parseurl@~1.3.2, parseurl@~1.3.3: - version "1.3.3" - resolved "https://registry.yarnpkg.com/parseurl/-/parseurl-1.3.3.tgz#9da19e7bee8d12dff0513ed5b76957793bc2e8d4" - integrity sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ== - -pascal-case@^3.1.2: - version "3.1.2" - resolved "https://registry.yarnpkg.com/pascal-case/-/pascal-case-3.1.2.tgz#b48e0ef2b98e205e7c1dae747d0b1508237660eb" - integrity sha512-uWlGT3YSnK9x3BQJaOdcZwrnV6hPpd8jFH1/ucpiLRPh/2zCVJKS19E4GvYHvaCcACn3foXZ0cLB9Wrx1KGe5g== - dependencies: - no-case "^3.0.4" - tslib "^2.0.3" - -path-exists@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/path-exists/-/path-exists-3.0.0.tgz#ce0ebeaa5f78cb18925ea7d810d7b59b010fd515" - integrity sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ== - -path-exists@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/path-exists/-/path-exists-4.0.0.tgz#513bdbe2d3b95d7762e8c1137efa195c6c61b5b3" - integrity sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w== - -path-is-absolute@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f" - integrity sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg== - -path-is-inside@1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/path-is-inside/-/path-is-inside-1.0.2.tgz#365417dede44430d1c11af61027facf074bdfc53" - integrity sha512-DUWJr3+ULp4zXmol/SZkFf3JGsS9/SIv+Y3Rt93/UjPpDpklB5f1er4O3POIbUuUJ3FXgqte2Q7SrU6zAqwk8w== - -path-key@^3.0.0, path-key@^3.1.0: - version "3.1.1" - resolved "https://registry.yarnpkg.com/path-key/-/path-key-3.1.1.tgz#581f6ade658cbba65a0d3380de7753295054f375" - integrity sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q== - -path-parse@^1.0.7: - version "1.0.7" - resolved "https://registry.yarnpkg.com/path-parse/-/path-parse-1.0.7.tgz#fbc114b60ca42b30d9daf5858e4bd68bbedb6735" - integrity sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw== - -path-to-regexp@0.1.7: - version "0.1.7" - resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-0.1.7.tgz#df604178005f522f15eb4490e7247a1bfaa67f8c" - integrity sha512-5DFkuoqlv1uYQKxy8omFBeJPQcdoE07Kv2sferDCrAq1ohOU+MSDswDIbnx3YAM60qIOnYa53wBhXW0EbMonrQ== - -path-to-regexp@2.2.1: - version "2.2.1" - resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-2.2.1.tgz#90b617025a16381a879bc82a38d4e8bdeb2bcf45" - integrity sha512-gu9bD6Ta5bwGrrU8muHzVOBFFREpp2iRkVfhBJahwJ6p6Xw20SjT0MxLnwkjOibQmGSYhiUnf2FLe7k+jcFmGQ== - -path-to-regexp@^1.7.0: - version "1.8.0" - resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-1.8.0.tgz#887b3ba9d84393e87a0a0b9f4cb756198b53548a" - integrity sha512-n43JRhlUKUAlibEJhPeir1ncUID16QnEjNpwzNdO3Lm4ywrBpBZ5oLD0I6br9evr1Y9JTqwRtAh7JLoOzAQdVA== - dependencies: - isarray "0.0.1" - -path-type@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/path-type/-/path-type-4.0.0.tgz#84ed01c0a7ba380afe09d90a8c180dcd9d03043b" - integrity sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw== - -picocolors@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/picocolors/-/picocolors-1.0.0.tgz#cb5bdc74ff3f51892236eaf79d68bc44564ab81c" - integrity sha512-1fygroTLlHu66zi26VoTDv8yRgm0Fccecssto+MhsZ0D/DGW2sm8E8AjW7NU5VVTRt5GxbeZ5qBuJr+HyLYkjQ== - -picomatch@^2.0.4, picomatch@^2.2.1, picomatch@^2.2.3, picomatch@^2.3.1: - version "2.3.1" - resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.3.1.tgz#3ba3833733646d9d3e4995946c1365a67fb07a42" - integrity sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA== - -pkg-dir@^4.1.0: - version "4.2.0" - resolved "https://registry.yarnpkg.com/pkg-dir/-/pkg-dir-4.2.0.tgz#f099133df7ede422e81d1d8448270eeb3e4261f3" - integrity sha512-HRDzbaKjC+AOWVXxAU/x54COGeIv9eb+6CkDSQoNTt4XyWoIJvuPsXizxu/Fr23EiekbtZwmh1IcIG/l/a10GQ== - dependencies: - find-up "^4.0.0" - -pkg-up@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/pkg-up/-/pkg-up-3.1.0.tgz#100ec235cc150e4fd42519412596a28512a0def5" - integrity sha512-nDywThFk1i4BQK4twPQ6TA4RT8bDY96yeuCVBWL3ePARCiEKDRSrNGbFIgUJpLp+XeIR65v8ra7WuJOFUBtkMA== - dependencies: - find-up "^3.0.0" - -postcss-calc@^8.2.3: - version "8.2.4" - resolved "https://registry.yarnpkg.com/postcss-calc/-/postcss-calc-8.2.4.tgz#77b9c29bfcbe8a07ff6693dc87050828889739a5" - integrity sha512-SmWMSJmB8MRnnULldx0lQIyhSNvuDl9HfrZkaqqE/WHAhToYsAvDq+yAsA/kIyINDszOp3Rh0GFoNuH5Ypsm3Q== - dependencies: - postcss-selector-parser "^6.0.9" - postcss-value-parser "^4.2.0" - -postcss-colormin@^5.3.1: - version "5.3.1" - resolved "https://registry.yarnpkg.com/postcss-colormin/-/postcss-colormin-5.3.1.tgz#86c27c26ed6ba00d96c79e08f3ffb418d1d1988f" - integrity sha512-UsWQG0AqTFQmpBegeLLc1+c3jIqBNB0zlDGRWR+dQ3pRKJL1oeMzyqmH3o2PIfn9MBdNrVPWhDbT769LxCTLJQ== - dependencies: - browserslist "^4.21.4" - caniuse-api "^3.0.0" - colord "^2.9.1" - postcss-value-parser "^4.2.0" - -postcss-convert-values@^5.1.3: - version "5.1.3" - resolved "https://registry.yarnpkg.com/postcss-convert-values/-/postcss-convert-values-5.1.3.tgz#04998bb9ba6b65aa31035d669a6af342c5f9d393" - integrity sha512-82pC1xkJZtcJEfiLw6UXnXVXScgtBrjlO5CBmuDQc+dlb88ZYheFsjTn40+zBVi3DkfF7iezO0nJUPLcJK3pvA== - dependencies: - browserslist "^4.21.4" - postcss-value-parser "^4.2.0" - -postcss-discard-comments@^5.1.2: - version "5.1.2" - resolved "https://registry.yarnpkg.com/postcss-discard-comments/-/postcss-discard-comments-5.1.2.tgz#8df5e81d2925af2780075840c1526f0660e53696" - integrity sha512-+L8208OVbHVF2UQf1iDmRcbdjJkuBF6IS29yBDSiWUIzpYaAhtNl6JYnYm12FnkeCwQqF5LeklOu6rAqgfBZqQ== - -postcss-discard-duplicates@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-discard-duplicates/-/postcss-discard-duplicates-5.1.0.tgz#9eb4fe8456706a4eebd6d3b7b777d07bad03e848" - integrity sha512-zmX3IoSI2aoenxHV6C7plngHWWhUOV3sP1T8y2ifzxzbtnuhk1EdPwm0S1bIUNaJ2eNbWeGLEwzw8huPD67aQw== - -postcss-discard-empty@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-discard-empty/-/postcss-discard-empty-5.1.1.tgz#e57762343ff7f503fe53fca553d18d7f0c369c6c" - integrity sha512-zPz4WljiSuLWsI0ir4Mcnr4qQQ5e1Ukc3i7UfE2XcrwKK2LIPIqE5jxMRxO6GbI3cv//ztXDsXwEWT3BHOGh3A== - -postcss-discard-overridden@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-discard-overridden/-/postcss-discard-overridden-5.1.0.tgz#7e8c5b53325747e9d90131bb88635282fb4a276e" - integrity sha512-21nOL7RqWR1kasIVdKs8HNqQJhFxLsyRfAnUDm4Fe4t4mCWL9OJiHvlHPjcd8zc5Myu89b/7wZDnOSjFgeWRtw== - -postcss-discard-unused@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-discard-unused/-/postcss-discard-unused-5.1.0.tgz#8974e9b143d887677304e558c1166d3762501142" - integrity sha512-KwLWymI9hbwXmJa0dkrzpRbSJEh0vVUd7r8t0yOGPcfKzyJJxFM8kLyC5Ev9avji6nY95pOp1W6HqIrfT+0VGw== - dependencies: - postcss-selector-parser "^6.0.5" - -postcss-loader@^7.0.0: - version "7.3.3" - resolved "https://registry.yarnpkg.com/postcss-loader/-/postcss-loader-7.3.3.tgz#6da03e71a918ef49df1bb4be4c80401df8e249dd" - integrity sha512-YgO/yhtevGO/vJePCQmTxiaEwER94LABZN0ZMT4A0vsak9TpO+RvKRs7EmJ8peIlB9xfXCsS7M8LjqncsUZ5HA== - dependencies: - cosmiconfig "^8.2.0" - jiti "^1.18.2" - semver "^7.3.8" - -postcss-merge-idents@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-merge-idents/-/postcss-merge-idents-5.1.1.tgz#7753817c2e0b75d0853b56f78a89771e15ca04a1" - integrity sha512-pCijL1TREiCoog5nQp7wUe+TUonA2tC2sQ54UGeMmryK3UFGIYKqDyjnqd6RcuI4znFn9hWSLNN8xKE/vWcUQw== - dependencies: - cssnano-utils "^3.1.0" - postcss-value-parser "^4.2.0" - -postcss-merge-longhand@^5.1.7: - version "5.1.7" - resolved "https://registry.yarnpkg.com/postcss-merge-longhand/-/postcss-merge-longhand-5.1.7.tgz#24a1bdf402d9ef0e70f568f39bdc0344d568fb16" - integrity sha512-YCI9gZB+PLNskrK0BB3/2OzPnGhPkBEwmwhfYk1ilBHYVAZB7/tkTHFBAnCrvBBOmeYyMYw3DMjT55SyxMBzjQ== - dependencies: - postcss-value-parser "^4.2.0" - stylehacks "^5.1.1" - -postcss-merge-rules@^5.1.4: - version "5.1.4" - resolved "https://registry.yarnpkg.com/postcss-merge-rules/-/postcss-merge-rules-5.1.4.tgz#2f26fa5cacb75b1402e213789f6766ae5e40313c" - integrity sha512-0R2IuYpgU93y9lhVbO/OylTtKMVcHb67zjWIfCiKR9rWL3GUk1677LAqD/BcHizukdZEjT8Ru3oHRoAYoJy44g== - dependencies: - browserslist "^4.21.4" - caniuse-api "^3.0.0" - cssnano-utils "^3.1.0" - postcss-selector-parser "^6.0.5" - -postcss-minify-font-values@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-minify-font-values/-/postcss-minify-font-values-5.1.0.tgz#f1df0014a726083d260d3bd85d7385fb89d1f01b" - integrity sha512-el3mYTgx13ZAPPirSVsHqFzl+BBBDrXvbySvPGFnQcTI4iNslrPaFq4muTkLZmKlGk4gyFAYUBMH30+HurREyA== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-minify-gradients@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-minify-gradients/-/postcss-minify-gradients-5.1.1.tgz#f1fe1b4f498134a5068240c2f25d46fcd236ba2c" - integrity sha512-VGvXMTpCEo4qHTNSa9A0a3D+dxGFZCYwR6Jokk+/3oB6flu2/PnPXAh2x7x52EkY5xlIHLm+Le8tJxe/7TNhzw== - dependencies: - colord "^2.9.1" - cssnano-utils "^3.1.0" - postcss-value-parser "^4.2.0" - -postcss-minify-params@^5.1.4: - version "5.1.4" - resolved "https://registry.yarnpkg.com/postcss-minify-params/-/postcss-minify-params-5.1.4.tgz#c06a6c787128b3208b38c9364cfc40c8aa5d7352" - integrity sha512-+mePA3MgdmVmv6g+30rn57USjOGSAyuxUmkfiWpzalZ8aiBkdPYjXWtHuwJGm1v5Ojy0Z0LaSYhHaLJQB0P8Jw== - dependencies: - browserslist "^4.21.4" - cssnano-utils "^3.1.0" - postcss-value-parser "^4.2.0" - -postcss-minify-selectors@^5.2.1: - version "5.2.1" - resolved "https://registry.yarnpkg.com/postcss-minify-selectors/-/postcss-minify-selectors-5.2.1.tgz#d4e7e6b46147b8117ea9325a915a801d5fe656c6" - integrity sha512-nPJu7OjZJTsVUmPdm2TcaiohIwxP+v8ha9NehQ2ye9szv4orirRU3SDdtUmKH+10nzn0bAyOXZ0UEr7OpvLehg== - dependencies: - postcss-selector-parser "^6.0.5" - -postcss-modules-extract-imports@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/postcss-modules-extract-imports/-/postcss-modules-extract-imports-3.0.0.tgz#cda1f047c0ae80c97dbe28c3e76a43b88025741d" - integrity sha512-bdHleFnP3kZ4NYDhuGlVK+CMrQ/pqUm8bx/oGL93K6gVwiclvX5x0n76fYMKuIGKzlABOy13zsvqjb0f92TEXw== - -postcss-modules-local-by-default@^4.0.3: - version "4.0.3" - resolved "https://registry.yarnpkg.com/postcss-modules-local-by-default/-/postcss-modules-local-by-default-4.0.3.tgz#b08eb4f083050708998ba2c6061b50c2870ca524" - integrity sha512-2/u2zraspoACtrbFRnTijMiQtb4GW4BvatjaG/bCjYQo8kLTdevCUlwuBHx2sCnSyrI3x3qj4ZK1j5LQBgzmwA== - dependencies: - icss-utils "^5.0.0" - postcss-selector-parser "^6.0.2" - postcss-value-parser "^4.1.0" - -postcss-modules-scope@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/postcss-modules-scope/-/postcss-modules-scope-3.0.0.tgz#9ef3151456d3bbfa120ca44898dfca6f2fa01f06" - integrity sha512-hncihwFA2yPath8oZ15PZqvWGkWf+XUfQgUGamS4LqoP1anQLOsOJw0vr7J7IwLpoY9fatA2qiGUGmuZL0Iqlg== - dependencies: - postcss-selector-parser "^6.0.4" - -postcss-modules-values@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/postcss-modules-values/-/postcss-modules-values-4.0.0.tgz#d7c5e7e68c3bb3c9b27cbf48ca0bb3ffb4602c9c" - integrity sha512-RDxHkAiEGI78gS2ofyvCsu7iycRv7oqw5xMWn9iMoR0N/7mf9D50ecQqUo5BZ9Zh2vH4bCUR/ktCqbB9m8vJjQ== - dependencies: - icss-utils "^5.0.0" - -postcss-normalize-charset@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-normalize-charset/-/postcss-normalize-charset-5.1.0.tgz#9302de0b29094b52c259e9b2cf8dc0879879f0ed" - integrity sha512-mSgUJ+pd/ldRGVx26p2wz9dNZ7ji6Pn8VWBajMXFf8jk7vUoSrZ2lt/wZR7DtlZYKesmZI680qjr2CeFF2fbUg== - -postcss-normalize-display-values@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-normalize-display-values/-/postcss-normalize-display-values-5.1.0.tgz#72abbae58081960e9edd7200fcf21ab8325c3da8" - integrity sha512-WP4KIM4o2dazQXWmFaqMmcvsKmhdINFblgSeRgn8BJ6vxaMyaJkwAzpPpuvSIoG/rmX3M+IrRZEz2H0glrQNEA== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-normalize-positions@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-normalize-positions/-/postcss-normalize-positions-5.1.1.tgz#ef97279d894087b59325b45c47f1e863daefbb92" - integrity sha512-6UpCb0G4eofTCQLFVuI3EVNZzBNPiIKcA1AKVka+31fTVySphr3VUgAIULBhxZkKgwLImhzMR2Bw1ORK+37INg== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-normalize-repeat-style@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-normalize-repeat-style/-/postcss-normalize-repeat-style-5.1.1.tgz#e9eb96805204f4766df66fd09ed2e13545420fb2" - integrity sha512-mFpLspGWkQtBcWIRFLmewo8aC3ImN2i/J3v8YCFUwDnPu3Xz4rLohDO26lGjwNsQxB3YF0KKRwspGzE2JEuS0g== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-normalize-string@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-normalize-string/-/postcss-normalize-string-5.1.0.tgz#411961169e07308c82c1f8c55f3e8a337757e228" - integrity sha512-oYiIJOf4T9T1N4i+abeIc7Vgm/xPCGih4bZz5Nm0/ARVJ7K6xrDlLwvwqOydvyL3RHNf8qZk6vo3aatiw/go3w== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-normalize-timing-functions@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-normalize-timing-functions/-/postcss-normalize-timing-functions-5.1.0.tgz#d5614410f8f0b2388e9f240aa6011ba6f52dafbb" - integrity sha512-DOEkzJ4SAXv5xkHl0Wa9cZLF3WCBhF3o1SKVxKQAa+0pYKlueTpCgvkFAHfk+Y64ezX9+nITGrDZeVGgITJXjg== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-normalize-unicode@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-normalize-unicode/-/postcss-normalize-unicode-5.1.1.tgz#f67297fca3fea7f17e0d2caa40769afc487aa030" - integrity sha512-qnCL5jzkNUmKVhZoENp1mJiGNPcsJCs1aaRmURmeJGES23Z/ajaln+EPTD+rBeNkSryI+2WTdW+lwcVdOikrpA== - dependencies: - browserslist "^4.21.4" - postcss-value-parser "^4.2.0" - -postcss-normalize-url@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-normalize-url/-/postcss-normalize-url-5.1.0.tgz#ed9d88ca82e21abef99f743457d3729a042adcdc" - integrity sha512-5upGeDO+PVthOxSmds43ZeMeZfKH+/DKgGRD7TElkkyS46JXAUhMzIKiCa7BabPeIy3AQcTkXwVVN7DbqsiCew== - dependencies: - normalize-url "^6.0.1" - postcss-value-parser "^4.2.0" - -postcss-normalize-whitespace@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-normalize-whitespace/-/postcss-normalize-whitespace-5.1.1.tgz#08a1a0d1ffa17a7cc6efe1e6c9da969cc4493cfa" - integrity sha512-83ZJ4t3NUDETIHTa3uEg6asWjSBYL5EdkVB0sDncx9ERzOKBVJIUeDO9RyA9Zwtig8El1d79HBp0JEi8wvGQnA== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-ordered-values@^5.1.3: - version "5.1.3" - resolved "https://registry.yarnpkg.com/postcss-ordered-values/-/postcss-ordered-values-5.1.3.tgz#b6fd2bd10f937b23d86bc829c69e7732ce76ea38" - integrity sha512-9UO79VUhPwEkzbb3RNpqqghc6lcYej1aveQteWY+4POIwlqkYE21HKWaLDF6lWNuqCobEAyTovVhtI32Rbv2RQ== - dependencies: - cssnano-utils "^3.1.0" - postcss-value-parser "^4.2.0" - -postcss-reduce-idents@^5.2.0: - version "5.2.0" - resolved "https://registry.yarnpkg.com/postcss-reduce-idents/-/postcss-reduce-idents-5.2.0.tgz#c89c11336c432ac4b28792f24778859a67dfba95" - integrity sha512-BTrLjICoSB6gxbc58D5mdBK8OhXRDqud/zodYfdSi52qvDHdMwk+9kB9xsM8yJThH/sZU5A6QVSmMmaN001gIg== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-reduce-initial@^5.1.2: - version "5.1.2" - resolved "https://registry.yarnpkg.com/postcss-reduce-initial/-/postcss-reduce-initial-5.1.2.tgz#798cd77b3e033eae7105c18c9d371d989e1382d6" - integrity sha512-dE/y2XRaqAi6OvjzD22pjTUQ8eOfc6m/natGHgKFBK9DxFmIm69YmaRVQrGgFlEfc1HePIurY0TmDeROK05rIg== - dependencies: - browserslist "^4.21.4" - caniuse-api "^3.0.0" - -postcss-reduce-transforms@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-reduce-transforms/-/postcss-reduce-transforms-5.1.0.tgz#333b70e7758b802f3dd0ddfe98bb1ccfef96b6e9" - integrity sha512-2fbdbmgir5AvpW9RLtdONx1QoYG2/EtqpNQbFASDlixBbAYuTcJ0dECwlqNqH7VbaUnEnh8SrxOe2sRIn24XyQ== - dependencies: - postcss-value-parser "^4.2.0" - -postcss-selector-parser@^6.0.2, postcss-selector-parser@^6.0.4, postcss-selector-parser@^6.0.5, postcss-selector-parser@^6.0.9: - version "6.0.13" - resolved "https://registry.yarnpkg.com/postcss-selector-parser/-/postcss-selector-parser-6.0.13.tgz#d05d8d76b1e8e173257ef9d60b706a8e5e99bf1b" - integrity sha512-EaV1Gl4mUEV4ddhDnv/xtj7sxwrwxdetHdWUGnT4VJQf+4d05v6lHYZr8N573k5Z0BViss7BDhfWtKS3+sfAqQ== - dependencies: - cssesc "^3.0.0" - util-deprecate "^1.0.2" - -postcss-sort-media-queries@^4.2.1: - version "4.4.1" - resolved "https://registry.yarnpkg.com/postcss-sort-media-queries/-/postcss-sort-media-queries-4.4.1.tgz#04a5a78db3921eb78f28a1a781a2e68e65258128" - integrity sha512-QDESFzDDGKgpiIh4GYXsSy6sek2yAwQx1JASl5AxBtU1Lq2JfKBljIPNdil989NcSKRQX1ToiaKphImtBuhXWw== - dependencies: - sort-css-media-queries "2.1.0" - -postcss-svgo@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-svgo/-/postcss-svgo-5.1.0.tgz#0a317400ced789f233a28826e77523f15857d80d" - integrity sha512-D75KsH1zm5ZrHyxPakAxJWtkyXew5qwS70v56exwvw542d9CRtTo78K0WeFxZB4G7JXKKMbEZtZayTGdIky/eA== - dependencies: - postcss-value-parser "^4.2.0" - svgo "^2.7.0" - -postcss-unique-selectors@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/postcss-unique-selectors/-/postcss-unique-selectors-5.1.1.tgz#a9f273d1eacd09e9aa6088f4b0507b18b1b541b6" - integrity sha512-5JiODlELrz8L2HwxfPnhOWZYWDxVHWL83ufOv84NrcgipI7TaeRsatAhK4Tr2/ZiYldpK/wBvw5BD3qfaK96GA== - dependencies: - postcss-selector-parser "^6.0.5" - -postcss-value-parser@^4.1.0, postcss-value-parser@^4.2.0: - version "4.2.0" - resolved "https://registry.yarnpkg.com/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz#723c09920836ba6d3e5af019f92bc0971c02e514" - integrity sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ== - -postcss-zindex@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/postcss-zindex/-/postcss-zindex-5.1.0.tgz#4a5c7e5ff1050bd4c01d95b1847dfdcc58a496ff" - integrity sha512-fgFMf0OtVSBR1va1JNHYgMxYk73yhn/qb4uQDq1DLGYolz8gHCyr/sesEuGUaYs58E3ZJRcpoGuPVoB7Meiq9A== - -postcss@^8.3.11, postcss@^8.4.14, postcss@^8.4.17, postcss@^8.4.21: - version "8.4.31" - resolved "https://registry.yarnpkg.com/postcss/-/postcss-8.4.31.tgz#92b451050a9f914da6755af352bdc0192508656d" - integrity sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ== - dependencies: - nanoid "^3.3.6" - picocolors "^1.0.0" - source-map-js "^1.0.2" - -prepend-http@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/prepend-http/-/prepend-http-2.0.0.tgz#e92434bfa5ea8c19f41cdfd401d741a3c819d897" - integrity sha512-ravE6m9Atw9Z/jjttRUZ+clIXogdghyZAuWJ3qEzjT+jI/dL1ifAqhZeC5VHzQp1MSt1+jxKkFNemj/iO7tVUA== - -pretty-error@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/pretty-error/-/pretty-error-4.0.0.tgz#90a703f46dd7234adb46d0f84823e9d1cb8f10d6" - integrity sha512-AoJ5YMAcXKYxKhuJGdcvse+Voc6v1RgnsR3nWcYU7q4t6z0Q6T86sv5Zq8VIRbOWWFpvdGE83LtdSMNd+6Y0xw== - dependencies: - lodash "^4.17.20" - renderkid "^3.0.0" - -pretty-time@^1.1.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/pretty-time/-/pretty-time-1.1.0.tgz#ffb7429afabb8535c346a34e41873adf3d74dd0e" - integrity sha512-28iF6xPQrP8Oa6uxE6a1biz+lWeTOAPKggvjB8HAs6nVMKZwf5bG++632Dx614hIWgUPkgivRfG+a8uAXGTIbA== - -prism-react-renderer@^1.3.5: - version "1.3.5" - resolved "https://registry.yarnpkg.com/prism-react-renderer/-/prism-react-renderer-1.3.5.tgz#786bb69aa6f73c32ba1ee813fbe17a0115435085" - integrity sha512-IJ+MSwBWKG+SM3b2SUfdrhC+gu01QkV2KmRQgREThBfSQRoufqRfxfHUxpG1WcaFjP+kojcFyO9Qqtpgt3qLCg== - -prismjs@^1.28.0: - version "1.29.0" - resolved "https://registry.yarnpkg.com/prismjs/-/prismjs-1.29.0.tgz#f113555a8fa9b57c35e637bba27509dcf802dd12" - integrity sha512-Kx/1w86q/epKcmte75LNrEoT+lX8pBpavuAbvJWRXar7Hz8jrtF+e3vY751p0R8H9HdArwaCTNDDzHg/ScJK1Q== - -process-nextick-args@~2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2" - integrity sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag== - -promise@^7.1.1: - version "7.3.1" - resolved "https://registry.yarnpkg.com/promise/-/promise-7.3.1.tgz#064b72602b18f90f29192b8b1bc418ffd1ebd3bf" - integrity sha512-nolQXZ/4L+bP/UGlkfaIujX9BKxGwmQ9OT4mOt5yvy8iK1h3wqTEJCijzGANTCCl9nWjY41juyAn2K3Q1hLLTg== - dependencies: - asap "~2.0.3" - -prompts@^2.4.2: - version "2.4.2" - resolved "https://registry.yarnpkg.com/prompts/-/prompts-2.4.2.tgz#7b57e73b3a48029ad10ebd44f74b01722a4cb069" - integrity sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q== - dependencies: - kleur "^3.0.3" - sisteransi "^1.0.5" - -prop-types@^15.6.2, prop-types@^15.7.2: - version "15.8.1" - resolved "https://registry.yarnpkg.com/prop-types/-/prop-types-15.8.1.tgz#67d87bf1a694f48435cf332c24af10214a3140b5" - integrity sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg== - dependencies: - loose-envify "^1.4.0" - object-assign "^4.1.1" - react-is "^16.13.1" - -property-information@^5.0.0, property-information@^5.3.0: - version "5.6.0" - resolved "https://registry.yarnpkg.com/property-information/-/property-information-5.6.0.tgz#61675545fb23002f245c6540ec46077d4da3ed69" - integrity sha512-YUHSPk+A30YPv+0Qf8i9Mbfe/C0hdPXk1s1jPVToV8pk8BQtpw10ct89Eo7OWkutrwqvT0eicAxlOg3dOAu8JA== - dependencies: - xtend "^4.0.0" - -proxy-addr@~2.0.7: - version "2.0.7" - resolved "https://registry.yarnpkg.com/proxy-addr/-/proxy-addr-2.0.7.tgz#f19fe69ceab311eeb94b42e70e8c2070f9ba1025" - integrity sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg== - dependencies: - forwarded "0.2.0" - ipaddr.js "1.9.1" - -pump@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/pump/-/pump-3.0.0.tgz#b4a2116815bde2f4e1ea602354e8c75565107a64" - integrity sha512-LwZy+p3SFs1Pytd/jYct4wpv49HiYCqd9Rlc5ZVdk0V+8Yzv6jR5Blk3TRmPL1ft69TxP0IMZGJ+WPFU2BFhww== - dependencies: - end-of-stream "^1.1.0" - once "^1.3.1" - -punycode@^1.3.2: - version "1.4.1" - resolved "https://registry.yarnpkg.com/punycode/-/punycode-1.4.1.tgz#c0d5a63b2718800ad8e1eb0fa5269c84dd41845e" - integrity sha512-jmYNElW7yvO7TV33CjSmvSiE2yco3bV2czu/OzDKdMNVZQWfxCblURLhf+47syQRBntjfLdd/H0egrzIG+oaFQ== - -punycode@^2.1.0: - version "2.3.0" - resolved "https://registry.yarnpkg.com/punycode/-/punycode-2.3.0.tgz#f67fa67c94da8f4d0cfff981aee4118064199b8f" - integrity sha512-rRV+zQD8tVFys26lAGR9WUuS4iUAngJScM+ZRSKtvl5tKeZ2t5bvdNFdNHBW9FWR4guGHlgmsZ1G7BSm2wTbuA== - -pupa@^2.1.1: - version "2.1.1" - resolved "https://registry.yarnpkg.com/pupa/-/pupa-2.1.1.tgz#f5e8fd4afc2c5d97828faa523549ed8744a20d62" - integrity sha512-l1jNAspIBSFqbT+y+5FosojNpVpF94nlI+wDUpqP9enwOTfHx9f0gh5nB96vl+6yTpsJsypeNrwfzPrKuHB41A== - dependencies: - escape-goat "^2.0.0" - -pure-color@^1.2.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/pure-color/-/pure-color-1.3.0.tgz#1fe064fb0ac851f0de61320a8bf796836422f33e" - integrity sha512-QFADYnsVoBMw1srW7OVKEYjG+MbIa49s54w1MA1EDY6r2r/sTcKKYqRX1f4GYvnXP7eN/Pe9HFcX+hwzmrXRHA== - -qs@6.11.0: - version "6.11.0" - resolved "https://registry.yarnpkg.com/qs/-/qs-6.11.0.tgz#fd0d963446f7a65e1367e01abd85429453f0c37a" - integrity sha512-MvjoMCJwEarSbUYk5O+nmoSzSutSsTwF85zcHPQ9OrlFoZOYIjaqBAJIqIXjptyD5vThxGq52Xu/MaJzRkIk4Q== - dependencies: - side-channel "^1.0.4" - -queue-microtask@^1.2.2: - version "1.2.3" - resolved "https://registry.yarnpkg.com/queue-microtask/-/queue-microtask-1.2.3.tgz#4929228bbc724dfac43e0efb058caf7b6cfb6243" - integrity sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A== - -queue@6.0.2: - version "6.0.2" - resolved "https://registry.yarnpkg.com/queue/-/queue-6.0.2.tgz#b91525283e2315c7553d2efa18d83e76432fed65" - integrity sha512-iHZWu+q3IdFZFX36ro/lKBkSvfkztY5Y7HMiPlOUjhupPcG2JMfst2KKEpu5XndviX/3UhFbRngUPNKtgvtZiA== - dependencies: - inherits "~2.0.3" - -randombytes@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/randombytes/-/randombytes-2.1.0.tgz#df6f84372f0270dc65cdf6291349ab7a473d4f2a" - integrity sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ== - dependencies: - safe-buffer "^5.1.0" - -range-parser@1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/range-parser/-/range-parser-1.2.0.tgz#f49be6b487894ddc40dcc94a322f611092e00d5e" - integrity sha512-kA5WQoNVo4t9lNx2kQNFCxKeBl5IbbSNBl1M/tLkw9WCn+hxNBAW5Qh8gdhs63CJnhjJ2zQWFoqPJP2sK1AV5A== - -range-parser@^1.2.1, range-parser@~1.2.1: - version "1.2.1" - resolved "https://registry.yarnpkg.com/range-parser/-/range-parser-1.2.1.tgz#3cf37023d199e1c24d1a55b84800c2f3e6468031" - integrity sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg== - -raw-body@2.5.1: - version "2.5.1" - resolved "https://registry.yarnpkg.com/raw-body/-/raw-body-2.5.1.tgz#fe1b1628b181b700215e5fd42389f98b71392857" - integrity sha512-qqJBtEyVgS0ZmPGdCFPWJ3FreoqvG4MVQln/kCgF7Olq95IbOp0/BWyMwbdtn4VTvkM8Y7khCQ2Xgk/tcrCXig== - dependencies: - bytes "3.1.2" - http-errors "2.0.0" - iconv-lite "0.4.24" - unpipe "1.0.0" - -rc@1.2.8, rc@^1.2.8: - version "1.2.8" - resolved "https://registry.yarnpkg.com/rc/-/rc-1.2.8.tgz#cd924bf5200a075b83c188cd6b9e211b7fc0d3ed" - integrity sha512-y3bGgqKj3QBdxLbLkomlohkvsA8gdAiUQlSBJnBhfn+BPxg4bc62d8TcBW15wavDfgexCgccckhcZvywyQYPOw== - dependencies: - deep-extend "^0.6.0" - ini "~1.3.0" - minimist "^1.2.0" - strip-json-comments "~2.0.1" - -react-base16-styling@^0.6.0: - version "0.6.0" - resolved "https://registry.yarnpkg.com/react-base16-styling/-/react-base16-styling-0.6.0.tgz#ef2156d66cf4139695c8a167886cb69ea660792c" - integrity sha512-yvh/7CArceR/jNATXOKDlvTnPKPmGZz7zsenQ3jUwLzHkNUR0CvY3yGYJbWJ/nnxsL8Sgmt5cO3/SILVuPO6TQ== - dependencies: - base16 "^1.0.0" - lodash.curry "^4.0.1" - lodash.flow "^3.3.0" - pure-color "^1.2.0" - -react-dev-utils@^12.0.1: - version "12.0.1" - resolved "https://registry.yarnpkg.com/react-dev-utils/-/react-dev-utils-12.0.1.tgz#ba92edb4a1f379bd46ccd6bcd4e7bc398df33e73" - integrity sha512-84Ivxmr17KjUupyqzFode6xKhjwuEJDROWKJy/BthkL7Wn6NJ8h4WE6k/exAv6ImS+0oZLRRW5j/aINMHyeGeQ== - dependencies: - "@babel/code-frame" "^7.16.0" - address "^1.1.2" - browserslist "^4.18.1" - chalk "^4.1.2" - cross-spawn "^7.0.3" - detect-port-alt "^1.1.6" - escape-string-regexp "^4.0.0" - filesize "^8.0.6" - find-up "^5.0.0" - fork-ts-checker-webpack-plugin "^6.5.0" - global-modules "^2.0.0" - globby "^11.0.4" - gzip-size "^6.0.0" - immer "^9.0.7" - is-root "^2.1.0" - loader-utils "^3.2.0" - open "^8.4.0" - pkg-up "^3.1.0" - prompts "^2.4.2" - react-error-overlay "^6.0.11" - recursive-readdir "^2.2.2" - shell-quote "^1.7.3" - strip-ansi "^6.0.1" - text-table "^0.2.0" - -react-dom@^17.0.2: - version "17.0.2" - resolved "https://registry.yarnpkg.com/react-dom/-/react-dom-17.0.2.tgz#ecffb6845e3ad8dbfcdc498f0d0a939736502c23" - integrity sha512-s4h96KtLDUQlsENhMn1ar8t2bEa+q/YAtj8pPPdIjPDGBDIVNsrD9aXNWqspUe6AzKCIG0C1HZZLqLV7qpOBGA== - dependencies: - loose-envify "^1.1.0" - object-assign "^4.1.1" - scheduler "^0.20.2" - -react-error-overlay@^6.0.11: - version "6.0.11" - resolved "https://registry.yarnpkg.com/react-error-overlay/-/react-error-overlay-6.0.11.tgz#92835de5841c5cf08ba00ddd2d677b6d17ff9adb" - integrity sha512-/6UZ2qgEyH2aqzYZgQPxEnz33NJ2gNsnHA2o5+o4wW9bLM/JYQitNP9xPhsXwC08hMMovfGe/8retsdDsczPRg== - -react-fast-compare@^3.2.0: - version "3.2.2" - resolved "https://registry.yarnpkg.com/react-fast-compare/-/react-fast-compare-3.2.2.tgz#929a97a532304ce9fee4bcae44234f1ce2c21d49" - integrity sha512-nsO+KSNgo1SbJqJEYRE9ERzo7YtYbou/OqjSQKxV7jcKox7+usiUVZOAC+XnDOABXggQTno0Y1CpVnuWEc1boQ== - -react-helmet-async@*, react-helmet-async@^1.3.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/react-helmet-async/-/react-helmet-async-1.3.0.tgz#7bd5bf8c5c69ea9f02f6083f14ce33ef545c222e" - integrity sha512-9jZ57/dAn9t3q6hneQS0wukqC2ENOBgMNVEhb/ZG9ZSxUetzVIw4iAmEU38IaVg3QGYauQPhSeUTuIUtFglWpg== - dependencies: - "@babel/runtime" "^7.12.5" - invariant "^2.2.4" - prop-types "^15.7.2" - react-fast-compare "^3.2.0" - shallowequal "^1.1.0" - -react-is@^16.13.1, react-is@^16.6.0, react-is@^16.7.0: - version "16.13.1" - resolved "https://registry.yarnpkg.com/react-is/-/react-is-16.13.1.tgz#789729a4dc36de2999dc156dd6c1d9c18cea56a4" - integrity sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ== - -react-is@^17.0.0: - version "17.0.2" - resolved "https://registry.yarnpkg.com/react-is/-/react-is-17.0.2.tgz#e691d4a8e9c789365655539ab372762b0efb54f0" - integrity sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w== - -react-json-view@^1.21.3: - version "1.21.3" - resolved "https://registry.yarnpkg.com/react-json-view/-/react-json-view-1.21.3.tgz#f184209ee8f1bf374fb0c41b0813cff54549c475" - integrity sha512-13p8IREj9/x/Ye4WI/JpjhoIwuzEgUAtgJZNBJckfzJt1qyh24BdTm6UQNGnyTq9dapQdrqvquZTo3dz1X6Cjw== - dependencies: - flux "^4.0.1" - react-base16-styling "^0.6.0" - react-lifecycles-compat "^3.0.4" - react-textarea-autosize "^8.3.2" - -react-lifecycles-compat@^3.0.4: - version "3.0.4" - resolved "https://registry.yarnpkg.com/react-lifecycles-compat/-/react-lifecycles-compat-3.0.4.tgz#4f1a273afdfc8f3488a8c516bfda78f872352362" - integrity sha512-fBASbA6LnOU9dOU2eW7aQ8xmYBSXUIWr+UmF9b1efZBazGNO+rcXT/icdKnYm2pTwcRylVUYwW7H1PHfLekVzA== - -react-loadable-ssr-addon-v5-slorber@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/react-loadable-ssr-addon-v5-slorber/-/react-loadable-ssr-addon-v5-slorber-1.0.1.tgz#2cdc91e8a744ffdf9e3556caabeb6e4278689883" - integrity sha512-lq3Lyw1lGku8zUEJPDxsNm1AfYHBrO9Y1+olAYwpUJ2IGFBskM0DMKok97A6LWUpHm+o7IvQBOWu9MLenp9Z+A== - dependencies: - "@babel/runtime" "^7.10.3" - -react-markdown@6.0.0: - version "6.0.0" - resolved "https://registry.yarnpkg.com/react-markdown/-/react-markdown-6.0.0.tgz#e63cd32d095e864384d524986c44c34c919de517" - integrity sha512-MC+zljUJeoLb4RbDm/wRbfoQFEZGz4TDOt/wb4dEehdaJWxLMn/T2IgwhQy0VYhuPEd2fhd7iOayE8lmENU0FA== - dependencies: - "@types/hast" "^2.0.0" - "@types/unist" "^2.0.3" - comma-separated-tokens "^1.0.0" - prop-types "^15.7.2" - property-information "^5.0.0" - react-is "^17.0.0" - remark-parse "^9.0.0" - remark-rehype "^8.0.0" - space-separated-tokens "^1.1.0" - style-to-object "^0.3.0" - unified "^9.0.0" - unist-util-visit "^2.0.0" - -react-router-config@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/react-router-config/-/react-router-config-5.1.1.tgz#0f4263d1a80c6b2dc7b9c1902c9526478194a988" - integrity sha512-DuanZjaD8mQp1ppHjgnnUnyOlqYXZVjnov/JzFhjLEwd3Z4dYjMSnqrEzzGThH47vpCOqPPwJM2FtthLeJ8Pbg== - dependencies: - "@babel/runtime" "^7.1.2" - -react-router-dom@^5.3.3: - version "5.3.4" - resolved "https://registry.yarnpkg.com/react-router-dom/-/react-router-dom-5.3.4.tgz#2ed62ffd88cae6db134445f4a0c0ae8b91d2e5e6" - integrity sha512-m4EqFMHv/Ih4kpcBCONHbkT68KoAeHN4p3lAGoNryfHi0dMy0kCzEZakiKRsvg5wHZ/JLrLW8o8KomWiz/qbYQ== - dependencies: - "@babel/runtime" "^7.12.13" - history "^4.9.0" - loose-envify "^1.3.1" - prop-types "^15.6.2" - react-router "5.3.4" - tiny-invariant "^1.0.2" - tiny-warning "^1.0.0" - -react-router@5.3.4, react-router@^5.3.3: - version "5.3.4" - resolved "https://registry.yarnpkg.com/react-router/-/react-router-5.3.4.tgz#8ca252d70fcc37841e31473c7a151cf777887bb5" - integrity sha512-Ys9K+ppnJah3QuaRiLxk+jDWOR1MekYQrlytiXxC1RyfbdsZkS5pvKAzCCr031xHixZwpnsYNT5xysdFHQaYsA== - dependencies: - "@babel/runtime" "^7.12.13" - history "^4.9.0" - hoist-non-react-statics "^3.1.0" - loose-envify "^1.3.1" - path-to-regexp "^1.7.0" - prop-types "^15.6.2" - react-is "^16.6.0" - tiny-invariant "^1.0.2" - tiny-warning "^1.0.0" - -react-textarea-autosize@^8.3.2: - version "8.5.3" - resolved "https://registry.yarnpkg.com/react-textarea-autosize/-/react-textarea-autosize-8.5.3.tgz#d1e9fe760178413891484847d3378706052dd409" - integrity sha512-XT1024o2pqCuZSuBt9FwHlaDeNtVrtCXu0Rnz88t1jUGheCLa3PhjE1GH8Ctm2axEtvdCl5SUHYschyQ0L5QHQ== - dependencies: - "@babel/runtime" "^7.20.13" - use-composed-ref "^1.3.0" - use-latest "^1.2.1" - -react@^17.0.2: - version "17.0.2" - resolved "https://registry.yarnpkg.com/react/-/react-17.0.2.tgz#d0b5cc516d29eb3eee383f75b62864cfb6800037" - integrity sha512-gnhPt75i/dq/z3/6q/0asP78D0u592D5L1pd7M8P+dck6Fu/jJeL6iVVK23fptSUZj8Vjf++7wXA8UNclGQcbA== - dependencies: - loose-envify "^1.1.0" - object-assign "^4.1.1" - -readable-stream@^2.0.1: - version "2.3.8" - resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.3.8.tgz#91125e8042bba1b9887f49345f6277027ce8be9b" - integrity sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA== - dependencies: - core-util-is "~1.0.0" - inherits "~2.0.3" - isarray "~1.0.0" - process-nextick-args "~2.0.0" - safe-buffer "~5.1.1" - string_decoder "~1.1.1" - util-deprecate "~1.0.1" - -readable-stream@^3.0.6: - version "3.6.2" - resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-3.6.2.tgz#56a9b36ea965c00c5a93ef31eb111a0f11056967" - integrity sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA== - dependencies: - inherits "^2.0.3" - string_decoder "^1.1.1" - util-deprecate "^1.0.1" - -readdirp@~3.6.0: - version "3.6.0" - resolved "https://registry.yarnpkg.com/readdirp/-/readdirp-3.6.0.tgz#74a370bd857116e245b29cc97340cd431a02a6c7" - integrity sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA== - dependencies: - picomatch "^2.2.1" - -reading-time@^1.5.0: - version "1.5.0" - resolved "https://registry.yarnpkg.com/reading-time/-/reading-time-1.5.0.tgz#d2a7f1b6057cb2e169beaf87113cc3411b5bc5bb" - integrity sha512-onYyVhBNr4CmAxFsKS7bz+uTLRakypIe4R+5A824vBSkQy/hB3fZepoVEf8OVAxzLvK+H/jm9TzpI3ETSm64Kg== - -rechoir@^0.6.2: - version "0.6.2" - resolved "https://registry.yarnpkg.com/rechoir/-/rechoir-0.6.2.tgz#85204b54dba82d5742e28c96756ef43af50e3384" - integrity sha512-HFM8rkZ+i3zrV+4LQjwQ0W+ez98pApMGM3HUrN04j3CqzPOzl9nmP15Y8YXNm8QHGv/eacOVEjqhmWpkRV0NAw== - dependencies: - resolve "^1.1.6" - -recursive-readdir@^2.2.2: - version "2.2.3" - resolved "https://registry.yarnpkg.com/recursive-readdir/-/recursive-readdir-2.2.3.tgz#e726f328c0d69153bcabd5c322d3195252379372" - integrity sha512-8HrF5ZsXk5FAH9dgsx3BlUer73nIhuj+9OrQwEbLTPOBzGkL1lsFCR01am+v+0m2Cmbs1nP12hLDl5FA7EszKA== - dependencies: - minimatch "^3.0.5" - -regenerate-unicode-properties@^10.1.0: - version "10.1.1" - resolved "https://registry.yarnpkg.com/regenerate-unicode-properties/-/regenerate-unicode-properties-10.1.1.tgz#6b0e05489d9076b04c436f318d9b067bba459480" - integrity sha512-X007RyZLsCJVVrjgEFVpLUTZwyOZk3oiL75ZcuYjlIWd6rNJtOjkBwQc5AsRrpbKVkxN6sklw/k/9m2jJYOf8Q== - dependencies: - regenerate "^1.4.2" - -regenerate@^1.4.2: - version "1.4.2" - resolved "https://registry.yarnpkg.com/regenerate/-/regenerate-1.4.2.tgz#b9346d8827e8f5a32f7ba29637d398b69014848a" - integrity sha512-zrceR/XhGYU/d/opr2EKO7aRHUeiBI8qjtfHqADTwZd6Szfy16la6kqD0MIUs5z5hx6AaKa+PixpPrR289+I0A== - -regenerator-runtime@^0.14.0: - version "0.14.0" - resolved "https://registry.yarnpkg.com/regenerator-runtime/-/regenerator-runtime-0.14.0.tgz#5e19d68eb12d486f797e15a3c6a918f7cec5eb45" - integrity sha512-srw17NI0TUWHuGa5CFGGmhfNIeja30WMBfbslPNhf6JrqQlLN5gcrvig1oqPxiVaXb0oW0XRKtH6Nngs5lKCIA== - -regenerator-transform@^0.15.2: - version "0.15.2" - resolved "https://registry.yarnpkg.com/regenerator-transform/-/regenerator-transform-0.15.2.tgz#5bbae58b522098ebdf09bca2f83838929001c7a4" - integrity sha512-hfMp2BoF0qOk3uc5V20ALGDS2ddjQaLrdl7xrGXvAIow7qeWRM2VA2HuCHkUKk9slq3VwEwLNK3DFBqDfPGYtg== - dependencies: - "@babel/runtime" "^7.8.4" - -regexpu-core@^5.3.1: - version "5.3.2" - resolved "https://registry.yarnpkg.com/regexpu-core/-/regexpu-core-5.3.2.tgz#11a2b06884f3527aec3e93dbbf4a3b958a95546b" - integrity sha512-RAM5FlZz+Lhmo7db9L298p2vHP5ZywrVXmVXpmAD9GuL5MPH6t9ROw1iA/wfHkQ76Qe7AaPF0nGuim96/IrQMQ== - dependencies: - "@babel/regjsgen" "^0.8.0" - regenerate "^1.4.2" - regenerate-unicode-properties "^10.1.0" - regjsparser "^0.9.1" - unicode-match-property-ecmascript "^2.0.0" - unicode-match-property-value-ecmascript "^2.1.0" - -registry-auth-token@^4.0.0: - version "4.2.2" - resolved "https://registry.yarnpkg.com/registry-auth-token/-/registry-auth-token-4.2.2.tgz#f02d49c3668884612ca031419491a13539e21fac" - integrity sha512-PC5ZysNb42zpFME6D/XlIgtNGdTl8bBOCw90xQLVMpzuuubJKYDWFAEuUNc+Cn8Z8724tg2SDhDRrkVEsqfDMg== - dependencies: - rc "1.2.8" - -registry-url@^5.0.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/registry-url/-/registry-url-5.1.0.tgz#e98334b50d5434b81136b44ec638d9c2009c5009" - integrity sha512-8acYXXTI0AkQv6RAOjE3vOaIXZkT9wo4LOFbBKYQEEnnMNBpKqdUrI6S4NT0KPIo/WVvJ5tE/X5LF/TQUf0ekw== - dependencies: - rc "^1.2.8" - -regjsparser@^0.9.1: - version "0.9.1" - resolved "https://registry.yarnpkg.com/regjsparser/-/regjsparser-0.9.1.tgz#272d05aa10c7c1f67095b1ff0addae8442fc5709" - integrity sha512-dQUtn90WanSNl+7mQKcXAgZxvUe7Z0SqXlgzv0za4LwiUhyzBC58yQO3liFoUgu8GiJVInAhJjkj1N0EtQ5nkQ== - dependencies: - jsesc "~0.5.0" - -rehype-katex@5: - version "5.0.0" - resolved "https://registry.yarnpkg.com/rehype-katex/-/rehype-katex-5.0.0.tgz#b556f24fde918f28ba1cb642ea71c7e82f3373d7" - integrity sha512-ksSuEKCql/IiIadOHiKRMjypva9BLhuwQNascMqaoGLDVd0k2NlE2wMvgZ3rpItzRKCd6vs8s7MFbb8pcR0AEg== - dependencies: - "@types/katex" "^0.11.0" - hast-util-to-text "^2.0.0" - katex "^0.13.0" - rehype-parse "^7.0.0" - unified "^9.0.0" - unist-util-visit "^2.0.0" - -rehype-parse@^7.0.0: - version "7.0.1" - resolved "https://registry.yarnpkg.com/rehype-parse/-/rehype-parse-7.0.1.tgz#58900f6702b56767814afc2a9efa2d42b1c90c57" - integrity sha512-fOiR9a9xH+Le19i4fGzIEowAbwG7idy2Jzs4mOrFWBSJ0sNUgy0ev871dwWnbOo371SjgjG4pwzrbgSVrKxecw== - dependencies: - hast-util-from-parse5 "^6.0.0" - parse5 "^6.0.0" - -relateurl@^0.2.7: - version "0.2.7" - resolved "https://registry.yarnpkg.com/relateurl/-/relateurl-0.2.7.tgz#54dbf377e51440aca90a4cd274600d3ff2d888a9" - integrity sha512-G08Dxvm4iDN3MLM0EsP62EDV9IuhXPR6blNz6Utcp7zyV3tr4HVNINt6MpaRWbxoOHT3Q7YN2P+jaHX8vUbgog== - -remark-emoji@^2.2.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/remark-emoji/-/remark-emoji-2.2.0.tgz#1c702090a1525da5b80e15a8f963ef2c8236cac7" - integrity sha512-P3cj9s5ggsUvWw5fS2uzCHJMGuXYRb0NnZqYlNecewXt8QBU9n5vW3DUUKOhepS8F9CwdMx9B8a3i7pqFWAI5w== - dependencies: - emoticon "^3.2.0" - node-emoji "^1.10.0" - unist-util-visit "^2.0.3" - -remark-footnotes@2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/remark-footnotes/-/remark-footnotes-2.0.0.tgz#9001c4c2ffebba55695d2dd80ffb8b82f7e6303f" - integrity sha512-3Clt8ZMH75Ayjp9q4CorNeyjwIxHFcTkaektplKGl2A1jNGEUey8cKL0ZC5vJwfcD5GFGsNLImLG/NGzWIzoMQ== - -remark-math@3: - version "3.0.1" - resolved "https://registry.yarnpkg.com/remark-math/-/remark-math-3.0.1.tgz#85a02a15b15cad34b89a27244d4887b3a95185bb" - integrity sha512-epT77R/HK0x7NqrWHdSV75uNLwn8g9qTyMqCRCDujL0vj/6T6+yhdrR7mjELWtkse+Fw02kijAaBuVcHBor1+Q== - -remark-mdx@1.6.22: - version "1.6.22" - resolved "https://registry.yarnpkg.com/remark-mdx/-/remark-mdx-1.6.22.tgz#06a8dab07dcfdd57f3373af7f86bd0e992108bbd" - integrity sha512-phMHBJgeV76uyFkH4rvzCftLfKCr2RZuF+/gmVcaKrpsihyzmhXjA0BEMDaPTXG5y8qZOKPVo83NAOX01LPnOQ== - dependencies: - "@babel/core" "7.12.9" - "@babel/helper-plugin-utils" "7.10.4" - "@babel/plugin-proposal-object-rest-spread" "7.12.1" - "@babel/plugin-syntax-jsx" "7.12.1" - "@mdx-js/util" "1.6.22" - is-alphabetical "1.0.4" - remark-parse "8.0.3" - unified "9.2.0" - -remark-parse@8.0.3: - version "8.0.3" - resolved "https://registry.yarnpkg.com/remark-parse/-/remark-parse-8.0.3.tgz#9c62aa3b35b79a486454c690472906075f40c7e1" - integrity sha512-E1K9+QLGgggHxCQtLt++uXltxEprmWzNfg+MxpfHsZlrddKzZ/hZyWHDbK3/Ap8HJQqYJRXP+jHczdL6q6i85Q== - dependencies: - ccount "^1.0.0" - collapse-white-space "^1.0.2" - is-alphabetical "^1.0.0" - is-decimal "^1.0.0" - is-whitespace-character "^1.0.0" - is-word-character "^1.0.0" - markdown-escapes "^1.0.0" - parse-entities "^2.0.0" - repeat-string "^1.5.4" - state-toggle "^1.0.0" - trim "0.0.1" - trim-trailing-lines "^1.0.0" - unherit "^1.0.4" - unist-util-remove-position "^2.0.0" - vfile-location "^3.0.0" - xtend "^4.0.1" - -remark-parse@^9.0.0: - version "9.0.0" - resolved "https://registry.yarnpkg.com/remark-parse/-/remark-parse-9.0.0.tgz#4d20a299665880e4f4af5d90b7c7b8a935853640" - integrity sha512-geKatMwSzEXKHuzBNU1z676sGcDcFoChMK38TgdHJNAYfFtsfHDQG7MoJAjs6sgYMqyLduCYWDIWZIxiPeafEw== - dependencies: - mdast-util-from-markdown "^0.8.0" - -remark-rehype@^8.0.0: - version "8.1.0" - resolved "https://registry.yarnpkg.com/remark-rehype/-/remark-rehype-8.1.0.tgz#610509a043484c1e697437fa5eb3fd992617c945" - integrity sha512-EbCu9kHgAxKmW1yEYjx3QafMyGY3q8noUbNUI5xyKbaFP89wbhDrKxyIQNukNYthzjNHZu6J7hwFg7hRm1svYA== - dependencies: - mdast-util-to-hast "^10.2.0" - -remark-squeeze-paragraphs@4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/remark-squeeze-paragraphs/-/remark-squeeze-paragraphs-4.0.0.tgz#76eb0e085295131c84748c8e43810159c5653ead" - integrity sha512-8qRqmL9F4nuLPIgl92XUuxI3pFxize+F1H0e/W3llTk0UsjJaj01+RrirkMw7P21RKe4X6goQhYRSvNWX+70Rw== - dependencies: - mdast-squeeze-paragraphs "^4.0.0" - -renderkid@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/renderkid/-/renderkid-3.0.0.tgz#5fd823e4d6951d37358ecc9a58b1f06836b6268a" - integrity sha512-q/7VIQA8lmM1hF+jn+sFSPWGlMkSAeNYcPLmDQx2zzuiDfaLrOmumR8iaUKlenFgh0XRPIUeSPlH3A+AW3Z5pg== - dependencies: - css-select "^4.1.3" - dom-converter "^0.2.0" - htmlparser2 "^6.1.0" - lodash "^4.17.21" - strip-ansi "^6.0.1" - -repeat-string@^1.0.0, repeat-string@^1.5.4: - version "1.6.1" - resolved "https://registry.yarnpkg.com/repeat-string/-/repeat-string-1.6.1.tgz#8dcae470e1c88abc2d600fff4a776286da75e637" - integrity sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w== - -require-from-string@^2.0.2: - version "2.0.2" - resolved "https://registry.yarnpkg.com/require-from-string/-/require-from-string-2.0.2.tgz#89a7fdd938261267318eafe14f9c32e598c36909" - integrity sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw== - -"require-like@>= 0.1.1": - version "0.1.2" - resolved "https://registry.yarnpkg.com/require-like/-/require-like-0.1.2.tgz#ad6f30c13becd797010c468afa775c0c0a6b47fa" - integrity sha512-oyrU88skkMtDdauHDuKVrgR+zuItqr6/c//FXzvmxRGMexSDc6hNvJInGW3LL46n+8b50RykrvwSUIIQH2LQ5A== - -requires-port@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/requires-port/-/requires-port-1.0.0.tgz#925d2601d39ac485e091cf0da5c6e694dc3dcaff" - integrity sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ== - -resolve-from@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/resolve-from/-/resolve-from-4.0.0.tgz#4abcd852ad32dd7baabfe9b40e00a36db5f392e6" - integrity sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g== - -resolve-pathname@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/resolve-pathname/-/resolve-pathname-3.0.0.tgz#99d02224d3cf263689becbb393bc560313025dcd" - integrity sha512-C7rARubxI8bXFNB/hqcp/4iUeIXJhJZvFPFPiSPRnhU5UPxzMFIl+2E6yY6c4k9giDJAhtV+enfA+G89N6Csng== - -resolve@^1.1.6, resolve@^1.14.2, resolve@^1.3.2: - version "1.22.6" - resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.22.6.tgz#dd209739eca3aef739c626fea1b4f3c506195362" - integrity sha512-njhxM7mV12JfufShqGy3Rz8j11RPdLy4xi15UurGJeoHLfJpVXKdh3ueuOqbYUcDZnffr6X739JBo5LzyahEsw== - dependencies: - is-core-module "^2.13.0" - path-parse "^1.0.7" - supports-preserve-symlinks-flag "^1.0.0" - -responselike@^1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/responselike/-/responselike-1.0.2.tgz#918720ef3b631c5642be068f15ade5a46f4ba1e7" - integrity sha512-/Fpe5guzJk1gPqdJLJR5u7eG/gNY4nImjbRDaVWVMRhne55TCmj2i9Q+54PBRfatRC8v/rIiv9BN0pMd9OV5EQ== - dependencies: - lowercase-keys "^1.0.0" - -retry@^0.13.1: - version "0.13.1" - resolved "https://registry.yarnpkg.com/retry/-/retry-0.13.1.tgz#185b1587acf67919d63b357349e03537b2484658" - integrity sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg== - -reusify@^1.0.4: - version "1.0.4" - resolved "https://registry.yarnpkg.com/reusify/-/reusify-1.0.4.tgz#90da382b1e126efc02146e90845a88db12925d76" - integrity sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw== - -rimraf@^3.0.2: - version "3.0.2" - resolved "https://registry.yarnpkg.com/rimraf/-/rimraf-3.0.2.tgz#f1a5402ba6220ad52cc1282bac1ae3aa49fd061a" - integrity sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA== - dependencies: - glob "^7.1.3" - -robust-predicates@^3.0.0: - version "3.0.2" - resolved "https://registry.yarnpkg.com/robust-predicates/-/robust-predicates-3.0.2.tgz#d5b28528c4824d20fc48df1928d41d9efa1ad771" - integrity sha512-IXgzBWvWQwE6PrDI05OvmXUIruQTcoMDzRsOd5CDvHCVLcLHMTSYvOK5Cm46kWqlV3yAbuSpBZdJ5oP5OUoStg== - -rtl-detect@^1.0.4: - version "1.0.4" - resolved "https://registry.yarnpkg.com/rtl-detect/-/rtl-detect-1.0.4.tgz#40ae0ea7302a150b96bc75af7d749607392ecac6" - integrity sha512-EBR4I2VDSSYr7PkBmFy04uhycIpDKp+21p/jARYXlCSjQksTBQcJ0HFUPOO79EPPH5JS6VAhiIQbycf0O3JAxQ== - -rtlcss@^3.5.0: - version "3.5.0" - resolved "https://registry.yarnpkg.com/rtlcss/-/rtlcss-3.5.0.tgz#c9eb91269827a102bac7ae3115dd5d049de636c3" - integrity sha512-wzgMaMFHQTnyi9YOwsx9LjOxYXJPzS8sYnFaKm6R5ysvTkwzHiB0vxnbHwchHQT65PTdBjDG21/kQBWI7q9O7A== - dependencies: - find-up "^5.0.0" - picocolors "^1.0.0" - postcss "^8.3.11" - strip-json-comments "^3.1.1" - -run-parallel@^1.1.9: - version "1.2.0" - resolved "https://registry.yarnpkg.com/run-parallel/-/run-parallel-1.2.0.tgz#66d1368da7bdf921eb9d95bd1a9229e7f21a43ee" - integrity sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA== - dependencies: - queue-microtask "^1.2.2" - -rw@1: - version "1.3.3" - resolved "https://registry.yarnpkg.com/rw/-/rw-1.3.3.tgz#3f862dfa91ab766b14885ef4d01124bfda074fb4" - integrity sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ== - -rxjs@^7.5.4: - version "7.8.1" - resolved "https://registry.yarnpkg.com/rxjs/-/rxjs-7.8.1.tgz#6f6f3d99ea8044291efd92e7c7fcf562c4057543" - integrity sha512-AA3TVj+0A2iuIoQkWEK/tqFjBq2j+6PO6Y0zJcvzLAFhEFIO3HL0vls9hWLncZbAAbK0mar7oZ4V079I/qPMxg== - dependencies: - tslib "^2.1.0" - -safe-buffer@5.1.2, safe-buffer@~5.1.0, safe-buffer@~5.1.1: - version "5.1.2" - resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d" - integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g== - -safe-buffer@5.2.1, safe-buffer@>=5.1.0, safe-buffer@^5.1.0, safe-buffer@~5.2.0: - version "5.2.1" - resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.2.1.tgz#1eaf9fa9bdb1fdd4ec75f58f9cdb4e6b7827eec6" - integrity sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ== - -"safer-buffer@>= 2.1.2 < 3", "safer-buffer@>= 2.1.2 < 3.0.0": - version "2.1.2" - resolved "https://registry.yarnpkg.com/safer-buffer/-/safer-buffer-2.1.2.tgz#44fa161b0187b9549dd84bb91802f9bd8385cd6a" - integrity sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg== - -sax@^1.2.4: - version "1.3.0" - resolved "https://registry.yarnpkg.com/sax/-/sax-1.3.0.tgz#a5dbe77db3be05c9d1ee7785dbd3ea9de51593d0" - integrity sha512-0s+oAmw9zLl1V1cS9BtZN7JAd0cW5e0QH4W3LWEK6a4LaLEA2OTpGYWDY+6XasBLtz6wkm3u1xRw95mRuJ59WA== - -scheduler@^0.20.2: - version "0.20.2" - resolved "https://registry.yarnpkg.com/scheduler/-/scheduler-0.20.2.tgz#4baee39436e34aa93b4874bddcbf0fe8b8b50e91" - integrity sha512-2eWfGgAqqWFGqtdMmcL5zCMK1U8KlXv8SQFGglL3CEtd0aDVDWgeF/YoCmvln55m5zSk3J/20hTaSBeSObsQDQ== - dependencies: - loose-envify "^1.1.0" - object-assign "^4.1.1" - -schema-utils@2.7.0: - version "2.7.0" - resolved "https://registry.yarnpkg.com/schema-utils/-/schema-utils-2.7.0.tgz#17151f76d8eae67fbbf77960c33c676ad9f4efc7" - integrity sha512-0ilKFI6QQF5nxDZLFn2dMjvc4hjg/Wkg7rHd3jK6/A4a1Hl9VFdQWvgB1UMGoU94pad1P/8N7fMcEnLnSiju8A== - dependencies: - "@types/json-schema" "^7.0.4" - ajv "^6.12.2" - ajv-keywords "^3.4.1" - -schema-utils@^2.6.5: - version "2.7.1" - resolved "https://registry.yarnpkg.com/schema-utils/-/schema-utils-2.7.1.tgz#1ca4f32d1b24c590c203b8e7a50bf0ea4cd394d7" - integrity sha512-SHiNtMOUGWBQJwzISiVYKu82GiV4QYGePp3odlY1tuKO7gPtphAT5R/py0fA6xtbgLL/RvtJZnU9b8s0F1q0Xg== - dependencies: - "@types/json-schema" "^7.0.5" - ajv "^6.12.4" - ajv-keywords "^3.5.2" - -schema-utils@^3.0.0, schema-utils@^3.1.1, schema-utils@^3.2.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/schema-utils/-/schema-utils-3.3.0.tgz#f50a88877c3c01652a15b622ae9e9795df7a60fe" - integrity sha512-pN/yOAvcC+5rQ5nERGuwrjLlYvLTbCibnZ1I7B1LaiAz9BRBlE9GMgE/eqV30P7aJQUf7Ddimy/RsbYO/GrVGg== - dependencies: - "@types/json-schema" "^7.0.8" - ajv "^6.12.5" - ajv-keywords "^3.5.2" - -schema-utils@^4.0.0: - version "4.2.0" - resolved "https://registry.yarnpkg.com/schema-utils/-/schema-utils-4.2.0.tgz#70d7c93e153a273a805801882ebd3bff20d89c8b" - integrity sha512-L0jRsrPpjdckP3oPug3/VxNKt2trR8TcabrM6FOAAlvC/9Phcmm+cuAgTlxBqdBR1WJx7Naj9WHw+aOmheSVbw== - dependencies: - "@types/json-schema" "^7.0.9" - ajv "^8.9.0" - ajv-formats "^2.1.1" - ajv-keywords "^5.1.0" - -section-matter@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/section-matter/-/section-matter-1.0.0.tgz#e9041953506780ec01d59f292a19c7b850b84167" - integrity sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA== - dependencies: - extend-shallow "^2.0.1" - kind-of "^6.0.0" - -select-hose@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/select-hose/-/select-hose-2.0.0.tgz#625d8658f865af43ec962bfc376a37359a4994ca" - integrity sha512-mEugaLK+YfkijB4fx0e6kImuJdCIt2LxCRcbEYPqRGCs4F2ogyfZU5IAZRdjCP8JPq2AtdNoC/Dux63d9Kiryg== - -selfsigned@^2.1.1: - version "2.1.1" - resolved "https://registry.yarnpkg.com/selfsigned/-/selfsigned-2.1.1.tgz#18a7613d714c0cd3385c48af0075abf3f266af61" - integrity sha512-GSL3aowiF7wa/WtSFwnUrludWFoNhftq8bUkH9pkzjpN2XSPOAYEgg6e0sS9s0rZwgJzJiQRPU18A6clnoW5wQ== - dependencies: - node-forge "^1" - -semver-diff@^3.1.1: - version "3.1.1" - resolved "https://registry.yarnpkg.com/semver-diff/-/semver-diff-3.1.1.tgz#05f77ce59f325e00e2706afd67bb506ddb1ca32b" - integrity sha512-GX0Ix/CJcHyB8c4ykpHGIAvLyOwOobtM/8d+TQkAd81/bEjgPHrfba41Vpesr7jX/t8Uh+R3EX9eAS5be+jQYg== - dependencies: - semver "^6.3.0" - -semver@^5.4.1: - version "5.7.2" - resolved "https://registry.yarnpkg.com/semver/-/semver-5.7.2.tgz#48d55db737c3287cd4835e17fa13feace1c41ef8" - integrity sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g== - -semver@^6.0.0, semver@^6.2.0, semver@^6.3.0, semver@^6.3.1: - version "6.3.1" - resolved "https://registry.yarnpkg.com/semver/-/semver-6.3.1.tgz#556d2ef8689146e46dcea4bfdd095f3434dffcb4" - integrity sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA== - -semver@^7.3.2, semver@^7.3.4, semver@^7.3.7, semver@^7.3.8: - version "7.5.4" - resolved "https://registry.yarnpkg.com/semver/-/semver-7.5.4.tgz#483986ec4ed38e1c6c48c34894a9182dbff68a6e" - integrity sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA== - dependencies: - lru-cache "^6.0.0" - -send@0.18.0: - version "0.18.0" - resolved "https://registry.yarnpkg.com/send/-/send-0.18.0.tgz#670167cc654b05f5aa4a767f9113bb371bc706be" - integrity sha512-qqWzuOjSFOuqPjFe4NOsMLafToQQwBSOEpS+FwEt3A2V3vKubTquT3vmLTQpFgMXp8AlFWFuP1qKaJZOtPpVXg== - dependencies: - debug "2.6.9" - depd "2.0.0" - destroy "1.2.0" - encodeurl "~1.0.2" - escape-html "~1.0.3" - etag "~1.8.1" - fresh "0.5.2" - http-errors "2.0.0" - mime "1.6.0" - ms "2.1.3" - on-finished "2.4.1" - range-parser "~1.2.1" - statuses "2.0.1" - -serialize-javascript@^6.0.0, serialize-javascript@^6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/serialize-javascript/-/serialize-javascript-6.0.1.tgz#b206efb27c3da0b0ab6b52f48d170b7996458e5c" - integrity sha512-owoXEFjWRllis8/M1Q+Cw5k8ZH40e3zhp/ovX+Xr/vi1qj6QesbyXXViFbpNvWvPNAD62SutwEXavefrLJWj7w== - dependencies: - randombytes "^2.1.0" - -serve-handler@^6.1.3: - version "6.1.5" - resolved "https://registry.yarnpkg.com/serve-handler/-/serve-handler-6.1.5.tgz#a4a0964f5c55c7e37a02a633232b6f0d6f068375" - integrity sha512-ijPFle6Hwe8zfmBxJdE+5fta53fdIY0lHISJvuikXB3VYFafRjMRpOffSPvCYsbKyBA7pvy9oYr/BT1O3EArlg== - dependencies: - bytes "3.0.0" - content-disposition "0.5.2" - fast-url-parser "1.1.3" - mime-types "2.1.18" - minimatch "3.1.2" - path-is-inside "1.0.2" - path-to-regexp "2.2.1" - range-parser "1.2.0" - -serve-index@^1.9.1: - version "1.9.1" - resolved "https://registry.yarnpkg.com/serve-index/-/serve-index-1.9.1.tgz#d3768d69b1e7d82e5ce050fff5b453bea12a9239" - integrity sha512-pXHfKNP4qujrtteMrSBb0rc8HJ9Ms/GrXwcUtUtD5s4ewDJI8bT3Cz2zTVRMKtri49pLx2e0Ya8ziP5Ya2pZZw== - dependencies: - accepts "~1.3.4" - batch "0.6.1" - debug "2.6.9" - escape-html "~1.0.3" - http-errors "~1.6.2" - mime-types "~2.1.17" - parseurl "~1.3.2" - -serve-static@1.15.0: - version "1.15.0" - resolved "https://registry.yarnpkg.com/serve-static/-/serve-static-1.15.0.tgz#faaef08cffe0a1a62f60cad0c4e513cff0ac9540" - integrity sha512-XGuRDNjXUijsUL0vl6nSD7cwURuzEgglbOaFuZM9g3kwDXOWVTck0jLzjPzGD+TazWbboZYu52/9/XPdUgne9g== - dependencies: - encodeurl "~1.0.2" - escape-html "~1.0.3" - parseurl "~1.3.3" - send "0.18.0" - -setimmediate@^1.0.5: - version "1.0.5" - resolved "https://registry.yarnpkg.com/setimmediate/-/setimmediate-1.0.5.tgz#290cbb232e306942d7d7ea9b83732ab7856f8285" - integrity sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA== - -setprototypeof@1.1.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/setprototypeof/-/setprototypeof-1.1.0.tgz#d0bd85536887b6fe7c0d818cb962d9d91c54e656" - integrity sha512-BvE/TwpZX4FXExxOxZyRGQQv651MSwmWKZGqvmPcRIjDqWub67kTKuIMx43cZZrS/cBBzwBcNDWoFxt2XEFIpQ== - -setprototypeof@1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/setprototypeof/-/setprototypeof-1.2.0.tgz#66c9a24a73f9fc28cbe66b09fed3d33dcaf1b424" - integrity sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw== - -shallow-clone@^3.0.0: - version "3.0.1" - resolved "https://registry.yarnpkg.com/shallow-clone/-/shallow-clone-3.0.1.tgz#8f2981ad92531f55035b01fb230769a40e02efa3" - integrity sha512-/6KqX+GVUdqPuPPd2LxDDxzX6CAbjJehAAOKlNpqqUpAqPM6HeL8f+o3a+JsyGjn2lv0WY8UsTgUJjU9Ok55NA== - dependencies: - kind-of "^6.0.2" - -shallowequal@^1.1.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/shallowequal/-/shallowequal-1.1.0.tgz#188d521de95b9087404fd4dcb68b13df0ae4e7f8" - integrity sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ== - -shebang-command@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/shebang-command/-/shebang-command-2.0.0.tgz#ccd0af4f8835fbdc265b82461aaf0c36663f34ea" - integrity sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA== - dependencies: - shebang-regex "^3.0.0" - -shebang-regex@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/shebang-regex/-/shebang-regex-3.0.0.tgz#ae16f1644d873ecad843b0307b143362d4c42172" - integrity sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A== - -shell-quote@^1.7.3, shell-quote@^1.8.1: - version "1.8.1" - resolved "https://registry.yarnpkg.com/shell-quote/-/shell-quote-1.8.1.tgz#6dbf4db75515ad5bac63b4f1894c3a154c766680" - integrity sha512-6j1W9l1iAs/4xYBI1SYOVZyFcCis9b4KCLQ8fgAGG07QvzaRLVVRQvAy85yNmmZSjYjg4MWh4gNvlPujU/5LpA== - -shelljs@^0.8.5: - version "0.8.5" - resolved "https://registry.yarnpkg.com/shelljs/-/shelljs-0.8.5.tgz#de055408d8361bed66c669d2f000538ced8ee20c" - integrity sha512-TiwcRcrkhHvbrZbnRcFYMLl30Dfov3HKqzp5tO5b4pt6G/SezKcYhmDg15zXVBswHmctSAQKznqNW2LO5tTDow== - dependencies: - glob "^7.0.0" - interpret "^1.0.0" - rechoir "^0.6.2" - -side-channel@^1.0.4: - version "1.0.4" - resolved "https://registry.yarnpkg.com/side-channel/-/side-channel-1.0.4.tgz#efce5c8fdc104ee751b25c58d4290011fa5ea2cf" - integrity sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw== - dependencies: - call-bind "^1.0.0" - get-intrinsic "^1.0.2" - object-inspect "^1.9.0" - -signal-exit@^3.0.2, signal-exit@^3.0.3: - version "3.0.7" - resolved "https://registry.yarnpkg.com/signal-exit/-/signal-exit-3.0.7.tgz#a9a1767f8af84155114eaabd73f99273c8f59ad9" - integrity sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ== - -sirv@^2.0.3: - version "2.0.3" - resolved "https://registry.yarnpkg.com/sirv/-/sirv-2.0.3.tgz#ca5868b87205a74bef62a469ed0296abceccd446" - integrity sha512-O9jm9BsID1P+0HOi81VpXPoDxYP374pkOLzACAoyUQ/3OUVndNpsz6wMnY2z+yOxzbllCKZrM+9QrWsv4THnyA== - dependencies: - "@polka/url" "^1.0.0-next.20" - mrmime "^1.0.0" - totalist "^3.0.0" - -sisteransi@^1.0.5: - version "1.0.5" - resolved "https://registry.yarnpkg.com/sisteransi/-/sisteransi-1.0.5.tgz#134d681297756437cc05ca01370d3a7a571075ed" - integrity sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg== - -sitemap@^7.1.1: - version "7.1.1" - resolved "https://registry.yarnpkg.com/sitemap/-/sitemap-7.1.1.tgz#eeed9ad6d95499161a3eadc60f8c6dce4bea2bef" - integrity sha512-mK3aFtjz4VdJN0igpIJrinf3EO8U8mxOPsTBzSsy06UtjZQJ3YY3o3Xa7zSc5nMqcMrRwlChHZ18Kxg0caiPBg== - dependencies: - "@types/node" "^17.0.5" - "@types/sax" "^1.2.1" - arg "^5.0.0" - sax "^1.2.4" - -slash@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/slash/-/slash-3.0.0.tgz#6539be870c165adbd5240220dbe361f1bc4d4634" - integrity sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q== - -slash@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/slash/-/slash-4.0.0.tgz#2422372176c4c6c5addb5e2ada885af984b396a7" - integrity sha512-3dOsAHXXUkQTpOYcoAxLIorMTp4gIQr5IW3iVb7A7lFIp0VHhnynm9izx6TssdrIcVIESAlVjtnO2K8bg+Coew== - -sockjs@^0.3.24: - version "0.3.24" - resolved "https://registry.yarnpkg.com/sockjs/-/sockjs-0.3.24.tgz#c9bc8995f33a111bea0395ec30aa3206bdb5ccce" - integrity sha512-GJgLTZ7vYb/JtPSSZ10hsOYIvEYsjbNU+zPdIHcUaWVNUEPivzxku31865sSSud0Da0W4lEeOPlmw93zLQchuQ== - dependencies: - faye-websocket "^0.11.3" - uuid "^8.3.2" - websocket-driver "^0.7.4" - -sort-css-media-queries@2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/sort-css-media-queries/-/sort-css-media-queries-2.1.0.tgz#7c85e06f79826baabb232f5560e9745d7a78c4ce" - integrity sha512-IeWvo8NkNiY2vVYdPa27MCQiR0MN0M80johAYFVxWWXQ44KU84WNxjslwBHmc/7ZL2ccwkM7/e6S5aiKZXm7jA== - -source-map-js@^1.0.2: - version "1.0.2" - resolved "https://registry.yarnpkg.com/source-map-js/-/source-map-js-1.0.2.tgz#adbc361d9c62df380125e7f161f71c826f1e490c" - integrity sha512-R0XvVJ9WusLiqTCEiGCmICCMplcCkIwwR11mOSD9CR5u+IXYdiseeEuXCVAjS54zqwkLcPNnmU4OeJ6tUrWhDw== - -source-map-support@~0.5.20: - version "0.5.21" - resolved "https://registry.yarnpkg.com/source-map-support/-/source-map-support-0.5.21.tgz#04fe7c7f9e1ed2d662233c28cb2b35b9f63f6e4f" - integrity sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w== - dependencies: - buffer-from "^1.0.0" - source-map "^0.6.0" - -source-map@^0.5.0: - version "0.5.7" - resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.5.7.tgz#8a039d2d1021d22d1ea14c80d8ea468ba2ef3fcc" - integrity sha512-LbrmJOMUSdEVxIKvdcJzQC+nQhe8FUZQTXQy6+I75skNgn3OoQ0DZA8YnFa7gp8tqtL3KPf1kmo0R5DoApeSGQ== - -source-map@^0.6.0, source-map@^0.6.1, source-map@~0.6.0: - version "0.6.1" - resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.6.1.tgz#74722af32e9614e9c287a8d0bbde48b5e2f1a263" - integrity sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g== - -space-separated-tokens@^1.0.0, space-separated-tokens@^1.1.0: - version "1.1.5" - resolved "https://registry.yarnpkg.com/space-separated-tokens/-/space-separated-tokens-1.1.5.tgz#85f32c3d10d9682007e917414ddc5c26d1aa6899" - integrity sha512-q/JSVd1Lptzhf5bkYm4ob4iWPjx0KiRe3sRFBNrVqbJkFaBm5vbbowy1mymoPNLRa52+oadOhJ+K49wsSeSjTA== - -spdy-transport@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/spdy-transport/-/spdy-transport-3.0.0.tgz#00d4863a6400ad75df93361a1608605e5dcdcf31" - integrity sha512-hsLVFE5SjA6TCisWeJXFKniGGOpBgMLmerfO2aCyCU5s7nJ/rpAepqmFifv/GCbSbueEeAJJnmSQ2rKC/g8Fcw== - dependencies: - debug "^4.1.0" - detect-node "^2.0.4" - hpack.js "^2.1.6" - obuf "^1.1.2" - readable-stream "^3.0.6" - wbuf "^1.7.3" - -spdy@^4.0.2: - version "4.0.2" - resolved "https://registry.yarnpkg.com/spdy/-/spdy-4.0.2.tgz#b74f466203a3eda452c02492b91fb9e84a27677b" - integrity sha512-r46gZQZQV+Kl9oItvl1JZZqJKGr+oEkB08A6BzkiR7593/7IbtuncXHd2YoYeTsG4157ZssMu9KYvUHLcjcDoA== - dependencies: - debug "^4.1.0" - handle-thing "^2.0.0" - http-deceiver "^1.2.7" - select-hose "^2.0.0" - spdy-transport "^3.0.0" - -sprintf-js@~1.0.2: - version "1.0.3" - resolved "https://registry.yarnpkg.com/sprintf-js/-/sprintf-js-1.0.3.tgz#04e6926f662895354f3dd015203633b857297e2c" - integrity sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g== - -stable@^0.1.8: - version "0.1.8" - resolved "https://registry.yarnpkg.com/stable/-/stable-0.1.8.tgz#836eb3c8382fe2936feaf544631017ce7d47a3cf" - integrity sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w== - -state-toggle@^1.0.0: - version "1.0.3" - resolved "https://registry.yarnpkg.com/state-toggle/-/state-toggle-1.0.3.tgz#e123b16a88e143139b09c6852221bc9815917dfe" - integrity sha512-d/5Z4/2iiCnHw6Xzghyhb+GcmF89bxwgXG60wjIiZaxnymbyOmI8Hk4VqHXiVVp6u2ysaskFfXg3ekCj4WNftQ== - -statuses@2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/statuses/-/statuses-2.0.1.tgz#55cb000ccf1d48728bd23c685a063998cf1a1b63" - integrity sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ== - -"statuses@>= 1.4.0 < 2": - version "1.5.0" - resolved "https://registry.yarnpkg.com/statuses/-/statuses-1.5.0.tgz#161c7dac177659fd9811f43771fa99381478628c" - integrity sha512-OpZ3zP+jT1PI7I8nemJX4AKmAX070ZkYPVWV/AaKTJl+tXCTGyVdC1a4SL8RUQYEwk/f34ZX8UTykN68FwrqAA== - -std-env@^3.0.1: - version "3.4.3" - resolved "https://registry.yarnpkg.com/std-env/-/std-env-3.4.3.tgz#326f11db518db751c83fd58574f449b7c3060910" - integrity sha512-f9aPhy8fYBuMN+sNfakZV18U39PbalgjXG3lLB9WkaYTxijru61wb57V9wxxNthXM5Sd88ETBWi29qLAsHO52Q== - -string-width@^4.0.0, string-width@^4.1.0, string-width@^4.2.0, string-width@^4.2.2: - version "4.2.3" - resolved "https://registry.yarnpkg.com/string-width/-/string-width-4.2.3.tgz#269c7117d27b05ad2e536830a8ec895ef9c6d010" - integrity sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g== - dependencies: - emoji-regex "^8.0.0" - is-fullwidth-code-point "^3.0.0" - strip-ansi "^6.0.1" - -string-width@^5.0.1: - version "5.1.2" - resolved "https://registry.yarnpkg.com/string-width/-/string-width-5.1.2.tgz#14f8daec6d81e7221d2a357e668cab73bdbca794" - integrity sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA== - dependencies: - eastasianwidth "^0.2.0" - emoji-regex "^9.2.2" - strip-ansi "^7.0.1" - -string_decoder@^1.1.1: - version "1.3.0" - resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.3.0.tgz#42f114594a46cf1a8e30b0a84f56c78c3edac21e" - integrity sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA== - dependencies: - safe-buffer "~5.2.0" - -string_decoder@~1.1.1: - version "1.1.1" - resolved "https://registry.yarnpkg.com/string_decoder/-/string_decoder-1.1.1.tgz#9cf1611ba62685d7030ae9e4ba34149c3af03fc8" - integrity sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg== - dependencies: - safe-buffer "~5.1.0" - -stringify-object@^3.3.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/stringify-object/-/stringify-object-3.3.0.tgz#703065aefca19300d3ce88af4f5b3956d7556629" - integrity sha512-rHqiFh1elqCQ9WPLIC8I0Q/g/wj5J1eMkyoiD6eoQApWHP0FtlK7rqnhmabL5VUY9JQCcqwwvlOaSuutekgyrw== - dependencies: - get-own-enumerable-property-symbols "^3.0.0" - is-obj "^1.0.1" - is-regexp "^1.0.0" - -strip-ansi@^6.0.0, strip-ansi@^6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-6.0.1.tgz#9e26c63d30f53443e9489495b2105d37b67a85d9" - integrity sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A== - dependencies: - ansi-regex "^5.0.1" - -strip-ansi@^7.0.1: - version "7.1.0" - resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-7.1.0.tgz#d5b6568ca689d8561370b0707685d22434faff45" - integrity sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ== - dependencies: - ansi-regex "^6.0.1" - -strip-bom-string@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/strip-bom-string/-/strip-bom-string-1.0.0.tgz#e5211e9224369fbb81d633a2f00044dc8cedad92" - integrity sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g== - -strip-final-newline@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/strip-final-newline/-/strip-final-newline-2.0.0.tgz#89b852fb2fcbe936f6f4b3187afb0a12c1ab58ad" - integrity sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA== - -strip-json-comments@^3.1.1: - version "3.1.1" - resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-3.1.1.tgz#31f1281b3832630434831c310c01cccda8cbe006" - integrity sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig== - -strip-json-comments@~2.0.1: - version "2.0.1" - resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-2.0.1.tgz#3c531942e908c2697c0ec344858c286c7ca0a60a" - integrity sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ== - -style-to-object@0.3.0, style-to-object@^0.3.0: - version "0.3.0" - resolved "https://registry.yarnpkg.com/style-to-object/-/style-to-object-0.3.0.tgz#b1b790d205991cc783801967214979ee19a76e46" - integrity sha512-CzFnRRXhzWIdItT3OmF8SQfWyahHhjq3HwcMNCNLn+N7klOOqPjMeG/4JSu77D7ypZdGvSzvkrbyeTMizz2VrA== - dependencies: - inline-style-parser "0.1.1" - -stylehacks@^5.1.1: - version "5.1.1" - resolved "https://registry.yarnpkg.com/stylehacks/-/stylehacks-5.1.1.tgz#7934a34eb59d7152149fa69d6e9e56f2fc34bcc9" - integrity sha512-sBpcd5Hx7G6seo7b1LkpttvTz7ikD0LlH5RmdcBNb6fFR0Fl7LQwHDFr300q4cwUqi+IYrFGmsIHieMBfnN/Bw== - dependencies: - browserslist "^4.21.4" - postcss-selector-parser "^6.0.4" - -stylis@^4.1.2: - version "4.3.0" - resolved "https://registry.yarnpkg.com/stylis/-/stylis-4.3.0.tgz#abe305a669fc3d8777e10eefcfc73ad861c5588c" - integrity sha512-E87pIogpwUsUwXw7dNyU4QDjdgVMy52m+XEOPEKUn161cCzWjjhPSQhByfd1CcNvrOLnXQ6OnnZDwnJrz/Z4YQ== - -supports-color@^5.3.0: - version "5.5.0" - resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-5.5.0.tgz#e2e69a44ac8772f78a1ec0b35b689df6530efc8f" - integrity sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow== - dependencies: - has-flag "^3.0.0" - -supports-color@^7.1.0: - version "7.2.0" - resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-7.2.0.tgz#1b7dcdcb32b8138801b3e478ba6a51caa89648da" - integrity sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw== - dependencies: - has-flag "^4.0.0" - -supports-color@^8.0.0: - version "8.1.1" - resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-8.1.1.tgz#cd6fc17e28500cff56c1b86c0a7fd4a54a73005c" - integrity sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q== - dependencies: - has-flag "^4.0.0" - -supports-preserve-symlinks-flag@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz#6eda4bd344a3c94aea376d4cc31bc77311039e09" - integrity sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w== - -svg-parser@^2.0.4: - version "2.0.4" - resolved "https://registry.yarnpkg.com/svg-parser/-/svg-parser-2.0.4.tgz#fdc2e29e13951736140b76cb122c8ee6630eb6b5" - integrity sha512-e4hG1hRwoOdRb37cIMSgzNsxyzKfayW6VOflrwvR+/bzrkyxY/31WkbgnQpgtrNp1SdpJvpUAGTa/ZoiPNDuRQ== - -svgo@^2.7.0, svgo@^2.8.0: - version "2.8.0" - resolved "https://registry.yarnpkg.com/svgo/-/svgo-2.8.0.tgz#4ff80cce6710dc2795f0c7c74101e6764cfccd24" - integrity sha512-+N/Q9kV1+F+UeWYoSiULYo4xYSDQlTgb+ayMobAXPwMnLvop7oxKMo9OzIrX5x3eS4L4f2UHhc9axXwY8DpChg== - dependencies: - "@trysound/sax" "0.2.0" - commander "^7.2.0" - css-select "^4.1.3" - css-tree "^1.1.3" - csso "^4.2.0" - picocolors "^1.0.0" - stable "^0.1.8" - -tapable@^1.0.0: - version "1.1.3" - resolved "https://registry.yarnpkg.com/tapable/-/tapable-1.1.3.tgz#a1fccc06b58db61fd7a45da2da44f5f3a3e67ba2" - integrity sha512-4WK/bYZmj8xLr+HUCODHGF1ZFzsYffasLUgEiMBY4fgtltdO6B4WJtlSbPaDTLpYTcGVwM2qLnFTICEcNxs3kA== - -tapable@^2.0.0, tapable@^2.1.1, tapable@^2.2.0: - version "2.2.1" - resolved "https://registry.yarnpkg.com/tapable/-/tapable-2.2.1.tgz#1967a73ef4060a82f12ab96af86d52fdb76eeca0" - integrity sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ== - -terser-webpack-plugin@^5.3.3, terser-webpack-plugin@^5.3.7: - version "5.3.9" - resolved "https://registry.yarnpkg.com/terser-webpack-plugin/-/terser-webpack-plugin-5.3.9.tgz#832536999c51b46d468067f9e37662a3b96adfe1" - integrity sha512-ZuXsqE07EcggTWQjXUj+Aot/OMcD0bMKGgF63f7UxYcu5/AJF53aIpK1YoP5xR9l6s/Hy2b+t1AM0bLNPRuhwA== - dependencies: - "@jridgewell/trace-mapping" "^0.3.17" - jest-worker "^27.4.5" - schema-utils "^3.1.1" - serialize-javascript "^6.0.1" - terser "^5.16.8" - -terser@^5.10.0, terser@^5.16.8: - version "5.21.0" - resolved "https://registry.yarnpkg.com/terser/-/terser-5.21.0.tgz#d2b27e92b5e56650bc83b6defa00a110f0b124b2" - integrity sha512-WtnFKrxu9kaoXuiZFSGrcAvvBqAdmKx0SFNmVNYdJamMu9yyN3I/QF0FbH4QcqJQ+y1CJnzxGIKH0cSj+FGYRw== - dependencies: - "@jridgewell/source-map" "^0.3.3" - acorn "^8.8.2" - commander "^2.20.0" - source-map-support "~0.5.20" - -text-table@^0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/text-table/-/text-table-0.2.0.tgz#7f5ee823ae805207c00af2df4a84ec3fcfa570b4" - integrity sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw== - -thunky@^1.0.2: - version "1.1.0" - resolved "https://registry.yarnpkg.com/thunky/-/thunky-1.1.0.tgz#5abaf714a9405db0504732bbccd2cedd9ef9537d" - integrity sha512-eHY7nBftgThBqOyHGVN+l8gF0BucP09fMo0oO/Lb0w1OF80dJv+lDVpXG60WMQvkcxAkNybKsrEIE3ZtKGmPrA== - -tiny-invariant@^1.0.2: - version "1.3.1" - resolved "https://registry.yarnpkg.com/tiny-invariant/-/tiny-invariant-1.3.1.tgz#8560808c916ef02ecfd55e66090df23a4b7aa642" - integrity sha512-AD5ih2NlSssTCwsMznbvwMZpJ1cbhkGd2uueNxzv2jDlEeZdU04JQfRnggJQ8DrcVBGjAsCKwFBbDlVNtEMlzw== - -tiny-warning@^1.0.0: - version "1.0.3" - resolved "https://registry.yarnpkg.com/tiny-warning/-/tiny-warning-1.0.3.tgz#94a30db453df4c643d0fd566060d60a875d84754" - integrity sha512-lBN9zLN/oAf68o3zNXYrdCt1kP8WsiGW8Oo2ka41b2IM5JL/S1CTyX1rW0mb/zSuJun0ZUrDxx4sqvYS2FWzPA== - -to-fast-properties@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/to-fast-properties/-/to-fast-properties-2.0.0.tgz#dc5e698cbd079265bc73e0377681a4e4e83f616e" - integrity sha512-/OaKK0xYrs3DmxRYqL/yDc+FxFUVYhDlXMhRmv3z915w2HF1tnN1omB354j8VUGO/hbRzyD6Y3sA7v7GS/ceog== - -to-readable-stream@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/to-readable-stream/-/to-readable-stream-1.0.0.tgz#ce0aa0c2f3df6adf852efb404a783e77c0475771" - integrity sha512-Iq25XBt6zD5npPhlLVXGFN3/gyR2/qODcKNNyTMd4vbm39HUaOiAM4PMq0eMVC/Tkxz+Zjdsc55g9yyz+Yq00Q== - -to-regex-range@^5.0.1: - version "5.0.1" - resolved "https://registry.yarnpkg.com/to-regex-range/-/to-regex-range-5.0.1.tgz#1648c44aae7c8d988a326018ed72f5b4dd0392e4" - integrity sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ== - dependencies: - is-number "^7.0.0" - -toidentifier@1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/toidentifier/-/toidentifier-1.0.1.tgz#3be34321a88a820ed1bd80dfaa33e479fbb8dd35" - integrity sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA== - -totalist@^3.0.0: - version "3.0.1" - resolved "https://registry.yarnpkg.com/totalist/-/totalist-3.0.1.tgz#ba3a3d600c915b1a97872348f79c127475f6acf8" - integrity sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ== - -tr46@~0.0.3: - version "0.0.3" - resolved "https://registry.yarnpkg.com/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a" - integrity sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw== - -trim-trailing-lines@^1.0.0: - version "1.1.4" - resolved "https://registry.yarnpkg.com/trim-trailing-lines/-/trim-trailing-lines-1.1.4.tgz#bd4abbec7cc880462f10b2c8b5ce1d8d1ec7c2c0" - integrity sha512-rjUWSqnfTNrjbB9NQWfPMH/xRK1deHeGsHoVfpxJ++XeYXE0d6B1En37AHfw3jtfTU7dzMzZL2jjpe8Qb5gLIQ== - -trim@0.0.1: - version "0.0.1" - resolved "https://registry.yarnpkg.com/trim/-/trim-0.0.1.tgz#5858547f6b290757ee95cccc666fb50084c460dd" - integrity sha512-YzQV+TZg4AxpKxaTHK3c3D+kRDCGVEE7LemdlQZoQXn0iennk10RsIoY6ikzAqJTc9Xjl9C1/waHom/J86ziAQ== - -trough@^1.0.0: - version "1.0.5" - resolved "https://registry.yarnpkg.com/trough/-/trough-1.0.5.tgz#b8b639cefad7d0bb2abd37d433ff8293efa5f406" - integrity sha512-rvuRbTarPXmMb79SmzEp8aqXNKcK+y0XaB298IXueQ8I2PsrATcPBCSPyK/dDNa2iWOhKlfNnOjdAOTBU/nkFA== - -ts-dedent@^2.2.0: - version "2.2.0" - resolved "https://registry.yarnpkg.com/ts-dedent/-/ts-dedent-2.2.0.tgz#39e4bd297cd036292ae2394eb3412be63f563bb5" - integrity sha512-q5W7tVM71e2xjHZTlgfTDoPF/SmqKG5hddq9SzR49CH2hayqRKJtQ4mtRlSxKaJlR/+9rEM+mnBHf7I2/BQcpQ== - -tslib@^2.0.3, tslib@^2.1.0, tslib@^2.4.0: - version "2.6.2" - resolved "https://registry.yarnpkg.com/tslib/-/tslib-2.6.2.tgz#703ac29425e7b37cd6fd456e92404d46d1f3e4ae" - integrity sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q== - -type-fest@^0.20.2: - version "0.20.2" - resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.20.2.tgz#1bf207f4b28f91583666cb5fbd327887301cd5f4" - integrity sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ== - -type-fest@^2.5.0: - version "2.19.0" - resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-2.19.0.tgz#88068015bb33036a598b952e55e9311a60fd3a9b" - integrity sha512-RAH822pAdBgcNMAfWnCBU3CFZcfZ/i1eZjwFU/dsLKumyuuP3niueg2UAukXYF0E2AAoc82ZSSf9J0WQBinzHA== - -type-is@~1.6.18: - version "1.6.18" - resolved "https://registry.yarnpkg.com/type-is/-/type-is-1.6.18.tgz#4e552cd05df09467dcbc4ef739de89f2cf37c131" - integrity sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g== - dependencies: - media-typer "0.3.0" - mime-types "~2.1.24" - -typedarray-to-buffer@^3.1.5: - version "3.1.5" - resolved "https://registry.yarnpkg.com/typedarray-to-buffer/-/typedarray-to-buffer-3.1.5.tgz#a97ee7a9ff42691b9f783ff1bc5112fe3fca9080" - integrity sha512-zdu8XMNEDepKKR+XYOXAVPtWui0ly0NtohUscw+UmaHiAWT8hrV1rr//H6V+0DvJ3OQ19S979M0laLfX8rm82Q== - dependencies: - is-typedarray "^1.0.0" - -typescript@^4.7.4: - version "4.9.5" - resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.9.5.tgz#095979f9bcc0d09da324d58d03ce8f8374cbe65a" - integrity sha512-1FXk9E2Hm+QzZQ7z+McJiHL4NW1F2EzMu9Nq9i3zAaGqibafqYwCVU6WyWAuyQRRzOlxou8xZSyXLEN8oKj24g== - -ua-parser-js@^1.0.35: - version "1.0.36" - resolved "https://registry.yarnpkg.com/ua-parser-js/-/ua-parser-js-1.0.36.tgz#a9ab6b9bd3a8efb90bb0816674b412717b7c428c" - integrity sha512-znuyCIXzl8ciS3+y3fHJI/2OhQIXbXw9MWC/o3qwyR+RGppjZHrM27CGFSKCJXi2Kctiz537iOu2KnXs1lMQhw== - -undici-types@~5.25.1: - version "5.25.3" - resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-5.25.3.tgz#e044115914c85f0bcbb229f346ab739f064998c3" - integrity sha512-Ga1jfYwRn7+cP9v8auvEXN1rX3sWqlayd4HP7OKk4mZWylEmu3KzXDUGrQUN6Ol7qo1gPvB2e5gX6udnyEPgdA== - -unherit@^1.0.4: - version "1.1.3" - resolved "https://registry.yarnpkg.com/unherit/-/unherit-1.1.3.tgz#6c9b503f2b41b262330c80e91c8614abdaa69c22" - integrity sha512-Ft16BJcnapDKp0+J/rqFC3Rrk6Y/Ng4nzsC028k2jdDII/rdZ7Wd3pPT/6+vIIxRagwRc9K0IUX0Ra4fKvw+WQ== - dependencies: - inherits "^2.0.0" - xtend "^4.0.0" - -unicode-canonical-property-names-ecmascript@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/unicode-canonical-property-names-ecmascript/-/unicode-canonical-property-names-ecmascript-2.0.0.tgz#301acdc525631670d39f6146e0e77ff6bbdebddc" - integrity sha512-yY5PpDlfVIU5+y/BSCxAJRBIS1Zc2dDG3Ujq+sR0U+JjUevW2JhocOF+soROYDSaAezOzOKuyyixhD6mBknSmQ== - -unicode-match-property-ecmascript@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/unicode-match-property-ecmascript/-/unicode-match-property-ecmascript-2.0.0.tgz#54fd16e0ecb167cf04cf1f756bdcc92eba7976c3" - integrity sha512-5kaZCrbp5mmbz5ulBkDkbY0SsPOjKqVS35VpL9ulMPfSl0J0Xsm+9Evphv9CoIZFwre7aJoa94AY6seMKGVN5Q== - dependencies: - unicode-canonical-property-names-ecmascript "^2.0.0" - unicode-property-aliases-ecmascript "^2.0.0" - -unicode-match-property-value-ecmascript@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/unicode-match-property-value-ecmascript/-/unicode-match-property-value-ecmascript-2.1.0.tgz#cb5fffdcd16a05124f5a4b0bf7c3770208acbbe0" - integrity sha512-qxkjQt6qjg/mYscYMC0XKRn3Rh0wFPlfxB0xkt9CfyTvpX1Ra0+rAmdX2QyAobptSEvuy4RtpPRui6XkV+8wjA== - -unicode-property-aliases-ecmascript@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/unicode-property-aliases-ecmascript/-/unicode-property-aliases-ecmascript-2.1.0.tgz#43d41e3be698bd493ef911077c9b131f827e8ccd" - integrity sha512-6t3foTQI9qne+OZoVQB/8x8rk2k1eVy1gRXhV3oFQ5T6R1dqQ1xtin3XqSlx3+ATBkliTaR/hHyJBm+LVPNM8w== - -unified@9.2.0: - version "9.2.0" - resolved "https://registry.yarnpkg.com/unified/-/unified-9.2.0.tgz#67a62c627c40589edebbf60f53edfd4d822027f8" - integrity sha512-vx2Z0vY+a3YoTj8+pttM3tiJHCwY5UFbYdiWrwBEbHmK8pvsPj2rtAX2BFfgXen8T39CJWblWRDT4L5WGXtDdg== - dependencies: - bail "^1.0.0" - extend "^3.0.0" - is-buffer "^2.0.0" - is-plain-obj "^2.0.0" - trough "^1.0.0" - vfile "^4.0.0" - -unified@^9.0.0, unified@^9.2.2: - version "9.2.2" - resolved "https://registry.yarnpkg.com/unified/-/unified-9.2.2.tgz#67649a1abfc3ab85d2969502902775eb03146975" - integrity sha512-Sg7j110mtefBD+qunSLO1lqOEKdrwBFBrR6Qd8f4uwkhWNlbkaqwHse6e7QvD3AP/MNoJdEDLaf8OxYyoWgorQ== - dependencies: - bail "^1.0.0" - extend "^3.0.0" - is-buffer "^2.0.0" - is-plain-obj "^2.0.0" - trough "^1.0.0" - vfile "^4.0.0" - -unique-string@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/unique-string/-/unique-string-2.0.0.tgz#39c6451f81afb2749de2b233e3f7c5e8843bd89d" - integrity sha512-uNaeirEPvpZWSgzwsPGtU2zVSTrn/8L5q/IexZmH0eH6SA73CmAA5U4GwORTxQAZs95TAXLNqeLoPPNO5gZfWg== - dependencies: - crypto-random-string "^2.0.0" - -unist-builder@2.0.3, unist-builder@^2.0.0: - version "2.0.3" - resolved "https://registry.yarnpkg.com/unist-builder/-/unist-builder-2.0.3.tgz#77648711b5d86af0942f334397a33c5e91516436" - integrity sha512-f98yt5pnlMWlzP539tPc4grGMsFaQQlP/vM396b00jngsiINumNmsY8rkXjfoi1c6QaM8nQ3vaGDuoKWbe/1Uw== - -unist-util-find-after@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/unist-util-find-after/-/unist-util-find-after-3.0.0.tgz#5c65fcebf64d4f8f496db46fa8fd0fbf354b43e6" - integrity sha512-ojlBqfsBftYXExNu3+hHLfJQ/X1jYY/9vdm4yZWjIbf0VuWF6CRufci1ZyoD/wV2TYMKxXUoNuoqwy+CkgzAiQ== - dependencies: - unist-util-is "^4.0.0" - -unist-util-generated@^1.0.0: - version "1.1.6" - resolved "https://registry.yarnpkg.com/unist-util-generated/-/unist-util-generated-1.1.6.tgz#5ab51f689e2992a472beb1b35f2ce7ff2f324d4b" - integrity sha512-cln2Mm1/CZzN5ttGK7vkoGw+RZ8VcUH6BtGbq98DDtRGquAAOXig1mrBQYelOwMXYS8rK+vZDyyojSjp7JX+Lg== - -unist-util-is@^4.0.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/unist-util-is/-/unist-util-is-4.1.0.tgz#976e5f462a7a5de73d94b706bac1b90671b57797" - integrity sha512-ZOQSsnce92GrxSqlnEEseX0gi7GH9zTJZ0p9dtu87WRb/37mMPO2Ilx1s/t9vBHrFhbgweUwb+t7cIn5dxPhZg== - -unist-util-position@^3.0.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/unist-util-position/-/unist-util-position-3.1.0.tgz#1c42ee6301f8d52f47d14f62bbdb796571fa2d47" - integrity sha512-w+PkwCbYSFw8vpgWD0v7zRCl1FpY3fjDSQ3/N/wNd9Ffa4gPi8+4keqt99N3XW6F99t/mUzp2xAhNmfKWp95QA== - -unist-util-remove-position@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/unist-util-remove-position/-/unist-util-remove-position-2.0.1.tgz#5d19ca79fdba712301999b2b73553ca8f3b352cc" - integrity sha512-fDZsLYIe2uT+oGFnuZmy73K6ZxOPG/Qcm+w7jbEjaFcJgbQ6cqjs/eSPzXhsmGpAsWPkqZM9pYjww5QTn3LHMA== - dependencies: - unist-util-visit "^2.0.0" - -unist-util-remove@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/unist-util-remove/-/unist-util-remove-2.1.0.tgz#b0b4738aa7ee445c402fda9328d604a02d010588" - integrity sha512-J8NYPyBm4baYLdCbjmf1bhPu45Cr1MWTm77qd9istEkzWpnN6O9tMsEbB2JhNnBCqGENRqEWomQ+He6au0B27Q== - dependencies: - unist-util-is "^4.0.0" - -unist-util-stringify-position@^2.0.0: - version "2.0.3" - resolved "https://registry.yarnpkg.com/unist-util-stringify-position/-/unist-util-stringify-position-2.0.3.tgz#cce3bfa1cdf85ba7375d1d5b17bdc4cada9bd9da" - integrity sha512-3faScn5I+hy9VleOq/qNbAd6pAx7iH5jYBMS9I1HgQVijz/4mv5Bvw5iw1sC/90CODiKo81G/ps8AJrISn687g== - dependencies: - "@types/unist" "^2.0.2" - -unist-util-visit-parents@^3.0.0: - version "3.1.1" - resolved "https://registry.yarnpkg.com/unist-util-visit-parents/-/unist-util-visit-parents-3.1.1.tgz#65a6ce698f78a6b0f56aa0e88f13801886cdaef6" - integrity sha512-1KROIZWo6bcMrZEwiH2UrXDyalAa0uqzWCxCJj6lPOvTve2WkfgCytoDTPaMnodXh1WrXOq0haVYHj99ynJlsg== - dependencies: - "@types/unist" "^2.0.0" - unist-util-is "^4.0.0" - -unist-util-visit@2.0.3, unist-util-visit@^2.0.0, unist-util-visit@^2.0.3: - version "2.0.3" - resolved "https://registry.yarnpkg.com/unist-util-visit/-/unist-util-visit-2.0.3.tgz#c3703893146df47203bb8a9795af47d7b971208c" - integrity sha512-iJ4/RczbJMkD0712mGktuGpm/U4By4FfDonL7N/9tATGIF4imikjOuagyMY53tnZq3NP6BcmlrHhEKAfGWjh7Q== - dependencies: - "@types/unist" "^2.0.0" - unist-util-is "^4.0.0" - unist-util-visit-parents "^3.0.0" - -universalify@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/universalify/-/universalify-2.0.0.tgz#75a4984efedc4b08975c5aeb73f530d02df25717" - integrity sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ== - -unpipe@1.0.0, unpipe@~1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/unpipe/-/unpipe-1.0.0.tgz#b2bf4ee8514aae6165b4817829d21b2ef49904ec" - integrity sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ== - -update-browserslist-db@^1.0.13: - version "1.0.13" - resolved "https://registry.yarnpkg.com/update-browserslist-db/-/update-browserslist-db-1.0.13.tgz#3c5e4f5c083661bd38ef64b6328c26ed6c8248c4" - integrity sha512-xebP81SNcPuNpPP3uzeW1NYXxI3rxyJzF3pD6sH4jE7o/IX+WtSpwnVU+qIsDPyk0d3hmFQ7mjqc6AtV604hbg== - dependencies: - escalade "^3.1.1" - picocolors "^1.0.0" - -update-notifier@^5.1.0: - version "5.1.0" - resolved "https://registry.yarnpkg.com/update-notifier/-/update-notifier-5.1.0.tgz#4ab0d7c7f36a231dd7316cf7729313f0214d9ad9" - integrity sha512-ItnICHbeMh9GqUy31hFPrD1kcuZ3rpxDZbf4KUDavXwS0bW5m7SLbDQpGX3UYr072cbrF5hFUs3r5tUsPwjfHw== - dependencies: - boxen "^5.0.0" - chalk "^4.1.0" - configstore "^5.0.1" - has-yarn "^2.1.0" - import-lazy "^2.1.0" - is-ci "^2.0.0" - is-installed-globally "^0.4.0" - is-npm "^5.0.0" - is-yarn-global "^0.3.0" - latest-version "^5.1.0" - pupa "^2.1.1" - semver "^7.3.4" - semver-diff "^3.1.1" - xdg-basedir "^4.0.0" - -uri-js@^4.2.2: - version "4.4.1" - resolved "https://registry.yarnpkg.com/uri-js/-/uri-js-4.4.1.tgz#9b1a52595225859e55f669d928f88c6c57f2a77e" - integrity sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg== - dependencies: - punycode "^2.1.0" - -url-loader@^4.1.1: - version "4.1.1" - resolved "https://registry.yarnpkg.com/url-loader/-/url-loader-4.1.1.tgz#28505e905cae158cf07c92ca622d7f237e70a4e2" - integrity sha512-3BTV812+AVHHOJQO8O5MkWgZ5aosP7GnROJwvzLS9hWDj00lZ6Z0wNak423Lp9PBZN05N+Jk/N5Si8jRAlGyWA== - dependencies: - loader-utils "^2.0.0" - mime-types "^2.1.27" - schema-utils "^3.0.0" - -url-parse-lax@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/url-parse-lax/-/url-parse-lax-3.0.0.tgz#16b5cafc07dbe3676c1b1999177823d6503acb0c" - integrity sha512-NjFKA0DidqPa5ciFcSrXnAltTtzz84ogy+NebPvfEgAck0+TNg4UJ4IN+fB7zRZfbgUf0syOo9MDxFkDSMuFaQ== - dependencies: - prepend-http "^2.0.0" - -use-composed-ref@^1.3.0: - version "1.3.0" - resolved "https://registry.yarnpkg.com/use-composed-ref/-/use-composed-ref-1.3.0.tgz#3d8104db34b7b264030a9d916c5e94fbe280dbda" - integrity sha512-GLMG0Jc/jiKov/3Ulid1wbv3r54K9HlMW29IWcDFPEqFkSO2nS0MuefWgMJpeHQ9YJeXDL3ZUF+P3jdXlZX/cQ== - -use-isomorphic-layout-effect@^1.1.1: - version "1.1.2" - resolved "https://registry.yarnpkg.com/use-isomorphic-layout-effect/-/use-isomorphic-layout-effect-1.1.2.tgz#497cefb13d863d687b08477d9e5a164ad8c1a6fb" - integrity sha512-49L8yCO3iGT/ZF9QttjwLF/ZD9Iwto5LnH5LmEdk/6cFmXddqi2ulF0edxTwjj+7mqvpVVGQWvbXZdn32wRSHA== - -use-latest@^1.2.1: - version "1.2.1" - resolved "https://registry.yarnpkg.com/use-latest/-/use-latest-1.2.1.tgz#d13dfb4b08c28e3e33991546a2cee53e14038cf2" - integrity sha512-xA+AVm/Wlg3e2P/JiItTziwS7FK92LWrDB0p+hgXloIMuVCeJJ8v6f0eeHyPZaJrM+usM1FkFfbNCrJGs8A/zw== - dependencies: - use-isomorphic-layout-effect "^1.1.1" - -use-sync-external-store@^1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/use-sync-external-store/-/use-sync-external-store-1.2.0.tgz#7dbefd6ef3fe4e767a0cf5d7287aacfb5846928a" - integrity sha512-eEgnFxGQ1Ife9bzYs6VLi8/4X6CObHMw9Qr9tPY43iKwsPw8xE8+EFsf/2cFZ5S3esXgpWgtSCtLNS41F+sKPA== - -util-deprecate@^1.0.1, util-deprecate@^1.0.2, util-deprecate@~1.0.1: - version "1.0.2" - resolved "https://registry.yarnpkg.com/util-deprecate/-/util-deprecate-1.0.2.tgz#450d4dc9fa70de732762fbd2d4a28981419a0ccf" - integrity sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw== - -utila@~0.4: - version "0.4.0" - resolved "https://registry.yarnpkg.com/utila/-/utila-0.4.0.tgz#8a16a05d445657a3aea5eecc5b12a4fa5379772c" - integrity sha512-Z0DbgELS9/L/75wZbro8xAnT50pBVFQZ+hUEueGDU5FN51YSCYM+jdxsfCiHjwNP/4LCDD0i/graKpeBnOXKRA== - -utility-types@^3.10.0: - version "3.10.0" - resolved "https://registry.yarnpkg.com/utility-types/-/utility-types-3.10.0.tgz#ea4148f9a741015f05ed74fd615e1d20e6bed82b" - integrity sha512-O11mqxmi7wMKCo6HKFt5AhO4BwY3VV68YU07tgxfz8zJTIxr4BpsezN49Ffwy9j3ZpwwJp4fkRwjRzq3uWE6Rg== - -utils-merge@1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/utils-merge/-/utils-merge-1.0.1.tgz#9f95710f50a267947b2ccc124741c1028427e713" - integrity sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA== - -uuid@^8.3.2: - version "8.3.2" - resolved "https://registry.yarnpkg.com/uuid/-/uuid-8.3.2.tgz#80d5b5ced271bb9af6c445f21a1a04c606cefbe2" - integrity sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg== - -uuid@^9.0.0: - version "9.0.1" - resolved "https://registry.yarnpkg.com/uuid/-/uuid-9.0.1.tgz#e188d4c8853cc722220392c424cd637f32293f30" - integrity sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA== - -value-equal@^1.0.1: - version "1.0.1" - resolved "https://registry.yarnpkg.com/value-equal/-/value-equal-1.0.1.tgz#1e0b794c734c5c0cade179c437d356d931a34d6c" - integrity sha512-NOJ6JZCAWr0zlxZt+xqCHNTEKOsrks2HQd4MqhP1qy4z1SkbEP467eNx6TgDKXMvUOb+OENfJCZwM+16n7fRfw== - -vary@~1.1.2: - version "1.1.2" - resolved "https://registry.yarnpkg.com/vary/-/vary-1.1.2.tgz#2299f02c6ded30d4a5961b0b9f74524a18f634fc" - integrity sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg== - -vfile-location@^3.0.0, vfile-location@^3.2.0: - version "3.2.0" - resolved "https://registry.yarnpkg.com/vfile-location/-/vfile-location-3.2.0.tgz#d8e41fbcbd406063669ebf6c33d56ae8721d0f3c" - integrity sha512-aLEIZKv/oxuCDZ8lkJGhuhztf/BW4M+iHdCwglA/eWc+vtuRFJj8EtgceYFX4LRjOhCAAiNHsKGssC6onJ+jbA== - -vfile-message@^2.0.0: - version "2.0.4" - resolved "https://registry.yarnpkg.com/vfile-message/-/vfile-message-2.0.4.tgz#5b43b88171d409eae58477d13f23dd41d52c371a" - integrity sha512-DjssxRGkMvifUOJre00juHoP9DPWuzjxKuMDrhNbk2TdaYYBNMStsNhEOt3idrtI12VQYM/1+iM0KOzXi4pxwQ== - dependencies: - "@types/unist" "^2.0.0" - unist-util-stringify-position "^2.0.0" - -vfile@^4.0.0: - version "4.2.1" - resolved "https://registry.yarnpkg.com/vfile/-/vfile-4.2.1.tgz#03f1dce28fc625c625bc6514350fbdb00fa9e624" - integrity sha512-O6AE4OskCG5S1emQ/4gl8zK586RqA3srz3nfK/Viy0UPToBc5Trp9BVFb1u0CjsKrAWwnpr4ifM/KBXPWwJbCA== - dependencies: - "@types/unist" "^2.0.0" - is-buffer "^2.0.0" - unist-util-stringify-position "^2.0.0" - vfile-message "^2.0.0" - -wait-on@^6.0.1: - version "6.0.1" - resolved "https://registry.yarnpkg.com/wait-on/-/wait-on-6.0.1.tgz#16bbc4d1e4ebdd41c5b4e63a2e16dbd1f4e5601e" - integrity sha512-zht+KASY3usTY5u2LgaNqn/Cd8MukxLGjdcZxT2ns5QzDmTFc4XoWBgC+C/na+sMRZTuVygQoMYwdcVjHnYIVw== - dependencies: - axios "^0.25.0" - joi "^17.6.0" - lodash "^4.17.21" - minimist "^1.2.5" - rxjs "^7.5.4" - -watchpack@^2.4.0: - version "2.4.0" - resolved "https://registry.yarnpkg.com/watchpack/-/watchpack-2.4.0.tgz#fa33032374962c78113f93c7f2fb4c54c9862a5d" - integrity sha512-Lcvm7MGST/4fup+ifyKi2hjyIAwcdI4HRgtvTpIUxBRhB+RFtUh8XtDOxUfctVCnhVi+QQj49i91OyvzkJl6cg== - dependencies: - glob-to-regexp "^0.4.1" - graceful-fs "^4.1.2" - -wbuf@^1.1.0, wbuf@^1.7.3: - version "1.7.3" - resolved "https://registry.yarnpkg.com/wbuf/-/wbuf-1.7.3.tgz#c1d8d149316d3ea852848895cb6a0bfe887b87df" - integrity sha512-O84QOnr0icsbFGLS0O3bI5FswxzRr8/gHwWkDlQFskhSPryQXvrTMxjxGP4+iWYoauLoBvfDpkrOauZ+0iZpDA== - dependencies: - minimalistic-assert "^1.0.0" - -web-namespaces@^1.0.0: - version "1.1.4" - resolved "https://registry.yarnpkg.com/web-namespaces/-/web-namespaces-1.1.4.tgz#bc98a3de60dadd7faefc403d1076d529f5e030ec" - integrity sha512-wYxSGajtmoP4WxfejAPIr4l0fVh+jeMXZb08wNc0tMg6xsfZXj3cECqIK0G7ZAqUq0PP8WlMDtaOGVBTAWztNw== - -web-worker@^1.2.0: - version "1.2.0" - resolved "https://registry.yarnpkg.com/web-worker/-/web-worker-1.2.0.tgz#5d85a04a7fbc1e7db58f66595d7a3ac7c9c180da" - integrity sha512-PgF341avzqyx60neE9DD+XS26MMNMoUQRz9NOZwW32nPQrF6p77f1htcnjBSEV8BGMKZ16choqUG4hyI0Hx7mA== - -webidl-conversions@^3.0.0: - version "3.0.1" - resolved "https://registry.yarnpkg.com/webidl-conversions/-/webidl-conversions-3.0.1.tgz#24534275e2a7bc6be7bc86611cc16ae0a5654871" - integrity sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ== - -webpack-bundle-analyzer@^4.5.0: - version "4.9.1" - resolved "https://registry.yarnpkg.com/webpack-bundle-analyzer/-/webpack-bundle-analyzer-4.9.1.tgz#d00bbf3f17500c10985084f22f1a2bf45cb2f09d" - integrity sha512-jnd6EoYrf9yMxCyYDPj8eutJvtjQNp8PHmni/e/ulydHBWhT5J3menXt3HEkScsu9YqMAcG4CfFjs3rj5pVU1w== - dependencies: - "@discoveryjs/json-ext" "0.5.7" - acorn "^8.0.4" - acorn-walk "^8.0.0" - commander "^7.2.0" - escape-string-regexp "^4.0.0" - gzip-size "^6.0.0" - is-plain-object "^5.0.0" - lodash.debounce "^4.0.8" - lodash.escape "^4.0.1" - lodash.flatten "^4.4.0" - lodash.invokemap "^4.6.0" - lodash.pullall "^4.2.0" - lodash.uniqby "^4.7.0" - opener "^1.5.2" - picocolors "^1.0.0" - sirv "^2.0.3" - ws "^7.3.1" - -webpack-dev-middleware@^5.3.1: - version "5.3.3" - resolved "https://registry.yarnpkg.com/webpack-dev-middleware/-/webpack-dev-middleware-5.3.3.tgz#efae67c2793908e7311f1d9b06f2a08dcc97e51f" - integrity sha512-hj5CYrY0bZLB+eTO+x/j67Pkrquiy7kWepMHmUMoPsmcUaeEnQJqFzHJOyxgWlq746/wUuA64p9ta34Kyb01pA== - dependencies: - colorette "^2.0.10" - memfs "^3.4.3" - mime-types "^2.1.31" - range-parser "^1.2.1" - schema-utils "^4.0.0" - -webpack-dev-server@^4.9.3: - version "4.15.1" - resolved "https://registry.yarnpkg.com/webpack-dev-server/-/webpack-dev-server-4.15.1.tgz#8944b29c12760b3a45bdaa70799b17cb91b03df7" - integrity sha512-5hbAst3h3C3L8w6W4P96L5vaV0PxSmJhxZvWKYIdgxOQm8pNZ5dEOmmSLBVpP85ReeyRt6AS1QJNyo/oFFPeVA== - dependencies: - "@types/bonjour" "^3.5.9" - "@types/connect-history-api-fallback" "^1.3.5" - "@types/express" "^4.17.13" - "@types/serve-index" "^1.9.1" - "@types/serve-static" "^1.13.10" - "@types/sockjs" "^0.3.33" - "@types/ws" "^8.5.5" - ansi-html-community "^0.0.8" - bonjour-service "^1.0.11" - chokidar "^3.5.3" - colorette "^2.0.10" - compression "^1.7.4" - connect-history-api-fallback "^2.0.0" - default-gateway "^6.0.3" - express "^4.17.3" - graceful-fs "^4.2.6" - html-entities "^2.3.2" - http-proxy-middleware "^2.0.3" - ipaddr.js "^2.0.1" - launch-editor "^2.6.0" - open "^8.0.9" - p-retry "^4.5.0" - rimraf "^3.0.2" - schema-utils "^4.0.0" - selfsigned "^2.1.1" - serve-index "^1.9.1" - sockjs "^0.3.24" - spdy "^4.0.2" - webpack-dev-middleware "^5.3.1" - ws "^8.13.0" - -webpack-merge@^5.8.0: - version "5.9.0" - resolved "https://registry.yarnpkg.com/webpack-merge/-/webpack-merge-5.9.0.tgz#dc160a1c4cf512ceca515cc231669e9ddb133826" - integrity sha512-6NbRQw4+Sy50vYNTw7EyOn41OZItPiXB8GNv3INSoe3PSFaHJEz3SHTrYVaRm2LilNGnFUzh0FAwqPEmU/CwDg== - dependencies: - clone-deep "^4.0.1" - wildcard "^2.0.0" - -webpack-sources@^3.2.2, webpack-sources@^3.2.3: - version "3.2.3" - resolved "https://registry.yarnpkg.com/webpack-sources/-/webpack-sources-3.2.3.tgz#2d4daab8451fd4b240cc27055ff6a0c2ccea0cde" - integrity sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w== - -webpack@^5.73.0: - version "5.88.2" - resolved "https://registry.yarnpkg.com/webpack/-/webpack-5.88.2.tgz#f62b4b842f1c6ff580f3fcb2ed4f0b579f4c210e" - integrity sha512-JmcgNZ1iKj+aiR0OvTYtWQqJwq37Pf683dY9bVORwVbUrDhLhdn/PlO2sHsFHPkj7sHNQF3JwaAkp49V+Sq1tQ== - dependencies: - "@types/eslint-scope" "^3.7.3" - "@types/estree" "^1.0.0" - "@webassemblyjs/ast" "^1.11.5" - "@webassemblyjs/wasm-edit" "^1.11.5" - "@webassemblyjs/wasm-parser" "^1.11.5" - acorn "^8.7.1" - acorn-import-assertions "^1.9.0" - browserslist "^4.14.5" - chrome-trace-event "^1.0.2" - enhanced-resolve "^5.15.0" - es-module-lexer "^1.2.1" - eslint-scope "5.1.1" - events "^3.2.0" - glob-to-regexp "^0.4.1" - graceful-fs "^4.2.9" - json-parse-even-better-errors "^2.3.1" - loader-runner "^4.2.0" - mime-types "^2.1.27" - neo-async "^2.6.2" - schema-utils "^3.2.0" - tapable "^2.1.1" - terser-webpack-plugin "^5.3.7" - watchpack "^2.4.0" - webpack-sources "^3.2.3" - -webpackbar@^5.0.2: - version "5.0.2" - resolved "https://registry.yarnpkg.com/webpackbar/-/webpackbar-5.0.2.tgz#d3dd466211c73852741dfc842b7556dcbc2b0570" - integrity sha512-BmFJo7veBDgQzfWXl/wwYXr/VFus0614qZ8i9znqcl9fnEdiVkdbi0TedLQ6xAK92HZHDJ0QmyQ0fmuZPAgCYQ== - dependencies: - chalk "^4.1.0" - consola "^2.15.3" - pretty-time "^1.1.0" - std-env "^3.0.1" - -websocket-driver@>=0.5.1, websocket-driver@^0.7.4: - version "0.7.4" - resolved "https://registry.yarnpkg.com/websocket-driver/-/websocket-driver-0.7.4.tgz#89ad5295bbf64b480abcba31e4953aca706f5760" - integrity sha512-b17KeDIQVjvb0ssuSDF2cYXSg2iztliJ4B9WdsuB6J952qCPKmnVq4DyW5motImXHDC1cBT/1UezrJVsKw5zjg== - dependencies: - http-parser-js ">=0.5.1" - safe-buffer ">=5.1.0" - websocket-extensions ">=0.1.1" - -websocket-extensions@>=0.1.1: - version "0.1.4" - resolved "https://registry.yarnpkg.com/websocket-extensions/-/websocket-extensions-0.1.4.tgz#7f8473bc839dfd87608adb95d7eb075211578a42" - integrity sha512-OqedPIGOfsDlo31UNwYbCFMSaO9m9G/0faIHj5/dZFDMFqPTcx6UwqyOy3COEaEOg/9VsGIpdqn62W5KhoKSpg== - -whatwg-url@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/whatwg-url/-/whatwg-url-5.0.0.tgz#966454e8765462e37644d3626f6742ce8b70965d" - integrity sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw== - dependencies: - tr46 "~0.0.3" - webidl-conversions "^3.0.0" - -which@^1.3.1: - version "1.3.1" - resolved "https://registry.yarnpkg.com/which/-/which-1.3.1.tgz#a45043d54f5805316da8d62f9f50918d3da70b0a" - integrity sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ== - dependencies: - isexe "^2.0.0" - -which@^2.0.1: - version "2.0.2" - resolved "https://registry.yarnpkg.com/which/-/which-2.0.2.tgz#7c6a8dd0a636a0327e10b59c9286eee93f3f51b1" - integrity sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA== - dependencies: - isexe "^2.0.0" - -widest-line@^3.1.0: - version "3.1.0" - resolved "https://registry.yarnpkg.com/widest-line/-/widest-line-3.1.0.tgz#8292333bbf66cb45ff0de1603b136b7ae1496eca" - integrity sha512-NsmoXalsWVDMGupxZ5R08ka9flZjjiLvHVAWYOKtiKM8ujtZWr9cRffak+uSE48+Ob8ObalXpwyeUiyDD6QFgg== - dependencies: - string-width "^4.0.0" - -widest-line@^4.0.1: - version "4.0.1" - resolved "https://registry.yarnpkg.com/widest-line/-/widest-line-4.0.1.tgz#a0fc673aaba1ea6f0a0d35b3c2795c9a9cc2ebf2" - integrity sha512-o0cyEG0e8GPzT4iGHphIOh0cJOV8fivsXxddQasHPHfoZf1ZexrfeA21w2NaEN1RHE+fXlfISmOE8R9N3u3Qig== - dependencies: - string-width "^5.0.1" - -wildcard@^2.0.0: - version "2.0.1" - resolved "https://registry.yarnpkg.com/wildcard/-/wildcard-2.0.1.tgz#5ab10d02487198954836b6349f74fff961e10f67" - integrity sha512-CC1bOL87PIWSBhDcTrdeLo6eGT7mCFtrg0uIJtqJUFyK+eJnzl8A1niH56uu7KMa5XFrtiV+AQuHO3n7DsHnLQ== - -wrap-ansi@^7.0.0: - version "7.0.0" - resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-7.0.0.tgz#67e145cff510a6a6984bdf1152911d69d2eb9e43" - integrity sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q== - dependencies: - ansi-styles "^4.0.0" - string-width "^4.1.0" - strip-ansi "^6.0.0" - -wrap-ansi@^8.0.1: - version "8.1.0" - resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-8.1.0.tgz#56dc22368ee570face1b49819975d9b9a5ead214" - integrity sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ== - dependencies: - ansi-styles "^6.1.0" - string-width "^5.0.1" - strip-ansi "^7.0.1" - -wrappy@1: - version "1.0.2" - resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f" - integrity sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ== - -write-file-atomic@^3.0.0: - version "3.0.3" - resolved "https://registry.yarnpkg.com/write-file-atomic/-/write-file-atomic-3.0.3.tgz#56bd5c5a5c70481cd19c571bd39ab965a5de56e8" - integrity sha512-AvHcyZ5JnSfq3ioSyjrBkH9yW4m7Ayk8/9My/DD9onKeu/94fwrMocemO2QAJFAlnnDN+ZDS+ZjAR5ua1/PV/Q== - dependencies: - imurmurhash "^0.1.4" - is-typedarray "^1.0.0" - signal-exit "^3.0.2" - typedarray-to-buffer "^3.1.5" - -ws@^7.3.1: - version "7.5.9" - resolved "https://registry.yarnpkg.com/ws/-/ws-7.5.9.tgz#54fa7db29f4c7cec68b1ddd3a89de099942bb591" - integrity sha512-F+P9Jil7UiSKSkppIiD94dN07AwvFixvLIj1Og1Rl9GGMuNipJnV9JzjD6XuqmAeiswGvUmNLjr5cFuXwNS77Q== - -ws@^8.13.0: - version "8.14.2" - resolved "https://registry.yarnpkg.com/ws/-/ws-8.14.2.tgz#6c249a806eb2db7a20d26d51e7709eab7b2e6c7f" - integrity sha512-wEBG1ftX4jcglPxgFCMJmZ2PLtSbJ2Peg6TmpJFTbe9GZYOQCDPdMYu/Tm0/bGZkw8paZnJY45J4K2PZrLYq8g== - -xdg-basedir@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/xdg-basedir/-/xdg-basedir-4.0.0.tgz#4bc8d9984403696225ef83a1573cbbcb4e79db13" - integrity sha512-PSNhEJDejZYV7h50BohL09Er9VaIefr2LMAf3OEmpCkjOi34eYyQYAXUTjEQtZJTKcF0E2UKTh+osDLsgNim9Q== - -xml-js@^1.6.11: - version "1.6.11" - resolved "https://registry.yarnpkg.com/xml-js/-/xml-js-1.6.11.tgz#927d2f6947f7f1c19a316dd8eea3614e8b18f8e9" - integrity sha512-7rVi2KMfwfWFl+GpPg6m80IVMWXLRjO+PxTq7V2CDhoGak0wzYzFgUY2m4XJ47OGdXd8eLE8EmwfAmdjw7lC1g== - dependencies: - sax "^1.2.4" - -xtend@^4.0.0, xtend@^4.0.1: - version "4.0.2" - resolved "https://registry.yarnpkg.com/xtend/-/xtend-4.0.2.tgz#bb72779f5fa465186b1f438f674fa347fdb5db54" - integrity sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ== - -yallist@^3.0.2: - version "3.1.1" - resolved "https://registry.yarnpkg.com/yallist/-/yallist-3.1.1.tgz#dbb7daf9bfd8bac9ab45ebf602b8cbad0d5d08fd" - integrity sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g== - -yallist@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/yallist/-/yallist-4.0.0.tgz#9bb92790d9c0effec63be73519e11a35019a3a72" - integrity sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A== - -yaml@^1.10.0, yaml@^1.10.2, yaml@^1.7.2: - version "1.10.2" - resolved "https://registry.yarnpkg.com/yaml/-/yaml-1.10.2.tgz#2301c5ffbf12b467de8da2333a459e29e7920e4b" - integrity sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg== - -yocto-queue@^0.1.0: - version "0.1.0" - resolved "https://registry.yarnpkg.com/yocto-queue/-/yocto-queue-0.1.0.tgz#0294eb3dee05028d31ee1a5fa2c556a6aaf10a1b" - integrity sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q== - -zwitch@^1.0.0: - version "1.0.5" - resolved "https://registry.yarnpkg.com/zwitch/-/zwitch-1.0.5.tgz#d11d7381ffed16b742f6af7b3f223d5cd9fe9920" - integrity sha512-V50KMwwzqJV0NpZIZFwfOD5/lyny3WlSzRiXgA0G7VUnRlqttta1L6UQIHzd6EuBY/cHGfwTIck7w1yH6Q5zUw== From 9734455acd0d6e0cba44477f889ec8165e7f3003 Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 12:57:35 -0400 Subject: [PATCH 04/56] fix: make earthly more parallel (#5747) If you have FROM +dependency, its a good idea to prefetch above it with BUILD +later-target commands --- barretenberg/cpp/Earthfile | 5 ++++- boxes/Earthfile | 2 +- noir/Earthfile | 7 ++++--- yarn-project/Earthfile | 8 ++++++++ 4 files changed, 17 insertions(+), 5 deletions(-) diff --git a/barretenberg/cpp/Earthfile b/barretenberg/cpp/Earthfile index 3d1dbc3aece..1d72f8838c6 100644 --- a/barretenberg/cpp/Earthfile +++ b/barretenberg/cpp/Earthfile @@ -187,6 +187,7 @@ bench-binaries: # Runs on the bench image, sent from the builder runner bench-ultra-honk: + BUILD +wasmtime # prefetch FROM +source COPY --dir +bench-binaries/* . # install SRS needed for proving @@ -198,6 +199,7 @@ bench-ultra-honk: RUN cd wasm && wasmtime run --env HARDWARE_CONCURRENCY=16 -Wthreads=y -Sthreads=y --dir=".." ./bin/ultra_honk_bench --benchmark_filter="construct_proof_ultrahonk_power_of_2/20$" bench-client-ivc: + BUILD +wasmtime # prefetch FROM +source COPY --dir +bench-binaries/* . # install SRS needed for proving @@ -232,9 +234,10 @@ test-clang-format: RUN ./format.sh check test: + BUILD +test-clang-format + BUILD ./srs_db/+build # prefetch FROM +source COPY --dir +test-binaries/build build - BUILD +test-clang-format FROM +preset-release-assert-test COPY --dir ./srs_db/+build/. srs_db RUN cd build && GTEST_COLOR=1 ctest -j$(nproc) --output-on-failure diff --git a/boxes/Earthfile b/boxes/Earthfile index e96e5e681c8..35ebe466c69 100644 --- a/boxes/Earthfile +++ b/boxes/Earthfile @@ -15,4 +15,4 @@ build: ENV AZTEC_CLI=/usr/src/yarn-project/cli/aztec-cli-dest RUN yarn && yarn build RUN npx -y playwright@1.42 install --with-deps - ENTRYPOINT ["/bin/sh", "-c"] \ No newline at end of file + ENTRYPOINT ["/bin/sh", "-c"] diff --git a/noir/Earthfile b/noir/Earthfile index 099db3102f2..9e1f7610b82 100644 --- a/noir/Earthfile +++ b/noir/Earthfile @@ -26,13 +26,14 @@ nargo: SAVE IMAGE aztecprotocol/nargo packages: + BUILD ../barretenberg/ts/+build # prefetch FROM node:20 RUN curl https://sh.rustup.rs -sSf | bash -s -- -y RUN echo 'source $HOME/.cargo/env' >> $HOME/.bashrc RUN apt update && apt install -y jq libc++1 - # `noir-repo` is nested inside of `noir` so we copy `bb.js` as such to account + # `noir-repo` is nested inside of `noir` so we copy `bb.js` as such to account # for the extra nested folder specified in portalled package paths COPY ../barretenberg/ts/+build/build /usr/src/../barretenberg/ts @@ -105,8 +106,8 @@ build: # FROM scratch # COPY --from=builder /usr/src/noir/README.md /usr/src/noir/README.md -# TODO -# test: +# TODO +# test: # FROM rust:bullseye # ARG COMMIT_HASH # ENV COMMIT_HASH=${COMMIT_HASH} diff --git a/yarn-project/Earthfile b/yarn-project/Earthfile index 7659858058d..6825755a732 100644 --- a/yarn-project/Earthfile +++ b/yarn-project/Earthfile @@ -29,6 +29,11 @@ deps: RUN ln -s /usr/src/yarn-project/node_modules /usr/src/node_modules build: + # Prefetch targets to not wait for +deps. + BUILD ../barretenberg/cpp/+preset-release + BUILD ../noir/+nargo + BUILD ../noir-projects/+build + BUILD ../l1-contracts/+build FROM +deps RUN apt update && apt install -y jq curl perl && rm -rf /var/lib/apt/lists/* && apt-get clean @@ -82,6 +87,9 @@ all: # for use with yarn-project/end-to-end and its e2e_mode=cache option export-end-to-end: + # Prefetch targets to build in parallel. + BUILD +end-to-end + BUILD +aztec ARG EARTHLY_GIT_HASH # pushes the foundry image to local docker images FROM ../foundry/+build From d4cb4108900f1fb6307de17be9ee3516d6023609 Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 17:46:43 -0400 Subject: [PATCH 05/56] chore: don't strip bb wasm (#5743) Side step of https://github.com/AztecProtocol/aztec-packages/issues/5647. This just keeps the debug data for threaded wasm, as the one we expect to use. --- barretenberg/cpp/Earthfile | 3 ++- barretenberg/cpp/scripts/strip-wasm.sh | 3 ++- barretenberg/ts/scripts/build_wasm.sh | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/barretenberg/cpp/Earthfile b/barretenberg/cpp/Earthfile index 1d72f8838c6..3355211a656 100644 --- a/barretenberg/cpp/Earthfile +++ b/barretenberg/cpp/Earthfile @@ -117,7 +117,8 @@ preset-wasm-threads: FROM +source COPY +get-wasi-sdk-threads/wasi-sdk src/wasi-sdk RUN cmake --preset wasm-threads -Bbuild && cmake --build build --target barretenberg.wasm - RUN src/wasi-sdk/bin/llvm-strip ./build/bin/barretenberg.wasm + # TODO(https://github.com/AztecProtocol/barretenberg/issues/941) We currently do not strip barretenberg threaded wasm, for stack traces. + # RUN src/wasi-sdk/bin/llvm-strip ./build/bin/barretenberg.wasm SAVE ARTIFACT build/bin preset-gcc: diff --git a/barretenberg/cpp/scripts/strip-wasm.sh b/barretenberg/cpp/scripts/strip-wasm.sh index 5f43b82cc89..18e3cf78d02 100755 --- a/barretenberg/cpp/scripts/strip-wasm.sh +++ b/barretenberg/cpp/scripts/strip-wasm.sh @@ -1,3 +1,4 @@ #!/bin/sh ./src/wasi-sdk-20.0/bin/llvm-strip ./build-wasm/bin/barretenberg.wasm -./src/wasi-sdk-20.0/bin/llvm-strip ./build-wasm-threads/bin/barretenberg.wasm +# TODO(https://github.com/AztecProtocol/barretenberg/issues/941) We currently do not strip barretenberg threaded wasm, for stack traces. +# ./src/wasi-sdk-20.0/bin/llvm-strip ./build-wasm-threads/bin/barretenberg.wasm diff --git a/barretenberg/ts/scripts/build_wasm.sh b/barretenberg/ts/scripts/build_wasm.sh index 6c108f6770a..77a9fa8a314 100755 --- a/barretenberg/ts/scripts/build_wasm.sh +++ b/barretenberg/ts/scripts/build_wasm.sh @@ -18,4 +18,4 @@ fi mkdir -p ./dest/node/barretenberg_wasm mkdir -p ./dest/node-cjs/barretenberg_wasm cp ../cpp/build-wasm-threads/bin/barretenberg.wasm ./dest/node/barretenberg_wasm/barretenberg-threads.wasm -cp ../cpp/build-wasm-threads/bin/barretenberg.wasm ./dest/node-cjs/barretenberg_wasm/barretenberg-threads.wasm \ No newline at end of file +cp ../cpp/build-wasm-threads/bin/barretenberg.wasm ./dest/node-cjs/barretenberg_wasm/barretenberg-threads.wasm From bebed32272e0974de21b5c7d21344d3cf1597a24 Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 18:25:37 -0400 Subject: [PATCH 06/56] feat(ci): turn on new CI as mandatory (#5761) --- .circleci/config.yml | 280 +----------------- .github/workflows/ci.yml | 32 +- .github/workflows/setup-runner.yml | 3 +- .github/workflows/start-spot.yml | 30 ++ .vscode/settings.json | 3 +- barretenberg/cpp/Earthfile | 5 + scripts/attach_ebs_cache.sh | 24 +- yarn-project/end-to-end/Earthfile | 20 +- ...s => flakey_e2e_account_init_fees.test.ts} | 0 ...test.ts => flakey_e2e_p2p_network.test.ts} | 0 10 files changed, 79 insertions(+), 318 deletions(-) create mode 100644 .github/workflows/start-spot.yml rename yarn-project/end-to-end/src/{e2e_account_init_fees.test.ts => flakey_e2e_account_init_fees.test.ts} (100%) rename yarn-project/end-to-end/src/{e2e_p2p_network.test.ts => flakey_e2e_p2p_network.test.ts} (100%) diff --git a/.circleci/config.yml b/.circleci/config.yml index 29418495446..4492449fa57 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -181,108 +181,6 @@ jobs: command: | barretenberg/cpp/scripts/ci/upload_doxygen_to_s3.sh - barretenberg-stdlib-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/run_tests 1 stdlib-tests - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-dsl-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/run_tests 1 dsl_tests - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/bb-tests.sh - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-avm-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/avm-tests.sh - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-bench: - machine: - # NOTE: we usually use alpine build image when making spot images, but - # we are not able to upload to S3 with it - image: default - resource_class: medium - steps: - - *checkout - - *setup_env - - run: - name: "Benchmark" - command: cond_spot_run_build barretenberg-bench 32 - aztec_manifest_key: barretenberg-bench - - run: - name: "Upload" - command: | - barretenberg/cpp/scripts/ci/upload_benchmarks_to_s3.sh - - barretenberg-proof-system-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/run_tests 1 stdlib_circuit_builders_tests - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-stdlib-plonk-recursion-ultra-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/run_tests 3 stdlib_plonk_recursion_tests --gtest_filter=-*turbo* - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - - barretenberg-stdlib-honk-recursion-ultra-tests: - docker: - - image: aztecprotocol/alpine-build-image - resource_class: small - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_test barretenberg-x86_64-linux-clang-assert 32 ./scripts/run_tests 3 stdlib_honk_recursion_tests - aztec_manifest_key: barretenberg-x86_64-linux-clang-assert - bb-js: machine: image: default @@ -629,136 +527,10 @@ jobs: command: build end-to-end aztec_manifest_key: end-to-end - e2e-tests: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_container end-to-end 64 ./src/e2e* - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - e2e-sandbox-example: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/e2e_sandbox_example.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - uniswap-trade-on-l1-from-l2: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/uniswap_trade_on_l1_from_l2.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - integration-l1-publisher: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/integration_l1_publisher.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - e2e-persistence: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=composed/e2e_persistence.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - e2e-browser: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/e2e_aztec_js_browser.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - pxe: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/pxe.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - cli-docs-sandbox: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/cli_docs_sandbox.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - e2e-docs-examples: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=composed/docs_examples.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - guides-writing-an-account-contract: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=guides/writing_an_account_contract.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - guides-dapp-testing: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=guides/dapp_testing.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - guides-sample-dapp: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=sample-dapp - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test - - guides-up-quick-start: - steps: - - *checkout - - *setup_env - - run: - name: "Test" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose.yml TEST=guides/up_quick_start.test.ts - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test + # For old e2e tests see yarn-project/end-to-end/Earthfile + # Semantics are similar to Dockerfile + # NOTE: Unlike other e2e, these will be re-enabled here as currently the logs functionality is not in the new earthfile setup # bench-publish-rollup: # steps: # - *checkout @@ -1024,17 +796,6 @@ workflows: - barretenberg-x86_64-linux-clang-fuzzing: *defaults - barretenberg-wasm-linux-clang: *defaults - barretenberg-x86_64-linux-clang-sol: *defaults - - barretenberg-bench: - requires: - - barretenberg-x86_64-linux-clang - <<: *defaults - - barretenberg-proof-system-tests: *bb_test - - barretenberg-dsl-tests: *bb_test - - barretenberg-tests: *bb_test - - barretenberg-avm-tests: *bb_test - - barretenberg-stdlib-tests: *bb_test - - barretenberg-stdlib-plonk-recursion-ultra-tests: *bb_test - - barretenberg-stdlib-honk-recursion-ultra-tests: *bb_test - barretenberg-acir-tests-bb: *bb_acir_tests - barretenberg-acir-tests-bb-sol: requires: @@ -1113,19 +874,6 @@ workflows: - aztec-package - cli <<: *defaults - - e2e-tests: *e2e_test - - cli-docs-sandbox: *e2e_test - - e2e-docs-examples: *e2e_test - - e2e-browser: *e2e_test - - e2e-persistence: *e2e_test - - e2e-sandbox-example: *e2e_test - - integration-l1-publisher: *e2e_test - - pxe: *e2e_test - - uniswap-trade-on-l1-from-l2: *e2e_test - - guides-writing-an-account-contract: *e2e_test - - guides-dapp-testing: *e2e_test - - guides-sample-dapp: *e2e_test - - guides-up-quick-start: *e2e_test # Everything that must complete before deployment. - end: @@ -1136,37 +884,17 @@ workflows: - barretenberg-x86_64-linux-clang-fuzzing - barretenberg-wasm-linux-clang - barretenberg-x86_64-linux-clang-sol - - barretenberg-bench - - barretenberg-proof-system-tests - - barretenberg-dsl-tests - - barretenberg-tests - - barretenberg-avm-tests - - barretenberg-stdlib-tests - - barretenberg-stdlib-plonk-recursion-ultra-tests - - barretenberg-stdlib-honk-recursion-ultra-tests - barretenberg-acir-tests-bb - barretenberg-acir-tests-bb-sol - barretenberg-docs - build-docs - mainnet-fork - - e2e-tests - - cli-docs-sandbox - - e2e-docs-examples - - e2e-browser - - e2e-persistence - - e2e-sandbox-example - - integration-l1-publisher - - pxe - - uniswap-trade-on-l1-from-l2 - - guides-writing-an-account-contract - - guides-dapp-testing - - guides-sample-dapp - - guides-up-quick-start - boxes-vanilla - boxes-react - noir-packages-tests - yarn-project-test - prover-client-test + - e2e-join <<: *defaults # Benchmark jobs. diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index f1d67fb668b..68c34bf6a12 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -40,8 +40,6 @@ jobs: - uses: ./.github/ci-setup-action with: dockerhub_password: "${{ secrets.DOCKERHUB_PASSWORD }}" - concurrency_token: "${{ secrets.AZTEC_GITHUB_TOKEN }}" - # must be globally unique for build x runner concurrency_key: build-${{ github.actor }}-x86 # prepare images locally, tagged by commit hash - name: "Build E2E Image" @@ -66,7 +64,6 @@ jobs: - uses: ./.github/ci-setup-action with: dockerhub_password: "${{ secrets.DOCKERHUB_PASSWORD }}" - concurrency_token: "${{ secrets.AZTEC_GITHUB_TOKEN }}" # must be globally unique for build x runner concurrency_key: e2e-${{ github.actor }}-x86-${{ matrix.test }} - name: Test @@ -77,7 +74,7 @@ jobs: # - name: Upload logs # run: BRANCH=${{ github.ref_name }} PULL_REQUEST=${{ github.event.number }} scripts/ci/upload_logs_to_s3 ./yarn-project/end-to-end/log - # barretenberg (prover) native tests + # barretenberg (prover) native and AVM (public VM) tests # only ran on x86 for resource reasons (memory intensive) bb-native-tests: needs: setup @@ -90,13 +87,13 @@ jobs: - uses: ./.github/ci-setup-action with: dockerhub_password: "${{ secrets.DOCKERHUB_PASSWORD }}" - concurrency_token: "${{ secrets.AZTEC_GITHUB_TOKEN }}" # must be globally unique for build x runner concurrency_key: bb-native-tests-${{ github.actor }}-x86 - name: "Native Prover Tests" working-directory: ./barretenberg/cpp/ timeout-minutes: 25 - run: earthly --no-output +test + # limit our parallelism to half our cores + run: earthly --no-output +test --hardware_concurrency=64 # push benchmarking binaries to dockerhub registry bb-bench-binaries: @@ -107,8 +104,6 @@ jobs: - uses: ./.github/ci-setup-action with: dockerhub_password: "${{ secrets.DOCKERHUB_PASSWORD }}" - concurrency_token: "${{ secrets.AZTEC_GITHUB_TOKEN }}" - # must be globally unique for build x runner concurrency_key: bb-bench-binaries-${{ github.actor }}-x86 - name: Build and Push Binaries if: ${{ github.event.inputs.just_start_spot != 'true' }} @@ -137,9 +132,6 @@ jobs: - uses: ./.github/ci-setup-action with: dockerhub_password: "${{ secrets.DOCKERHUB_PASSWORD }}" - concurrency_token: "${{ secrets.AZTEC_GITHUB_TOKEN }}" - # must be globally unique for build x runner - # technically not needed as we only make one GA runner, but a backup concurrency_key: bb-bench-${{ github.actor }}-bench-x86 # Use bench_mode=cache to read the pushed build above - name: Client IVC Bench @@ -151,21 +143,3 @@ jobs: working-directory: ./barretenberg/cpp/ timeout-minutes: 15 run: earthly --no-output +bench-ultra-honk --bench_mode=cache - - # # Post actions, deploy and summarize logs - # aztec-bench-summary: - # runs-on: ${{ github.actor }} - # # IMPORTANT security flaw if we don't need 'check-run-condition' - # needs: e2e-x86 - # concurrency: - # group: aztec-bench-summary-${{ github.ref_name == 'master' && github.run_id || github.ref_name }}-x86 - # cancel-in-progress: true - # steps: - # - name: Checkout - # uses: actions/checkout@v4 - # with: - # ref: ${{ github.event.pull_request.head.sha }} - - # - name: "Assemble benchmark summary from uploaded logs" - # command: ./scripts/ci/assemble_e2e_benchmark_earthly.sh - diff --git a/.github/workflows/setup-runner.yml b/.github/workflows/setup-runner.yml index 9f544f4f367..928ce594b4f 100644 --- a/.github/workflows/setup-runner.yml +++ b/.github/workflows/setup-runner.yml @@ -54,7 +54,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Start EC2 runner - uses: AztecProtocol/ec2-action-builder@v0.6 + uses: AztecProtocol/ec2-action-builder@v0.8 with: github_token: ${{ secrets.GH_SELF_HOSTED_RUNNER_TOKEN }} aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }} @@ -69,6 +69,7 @@ jobs: ec2_instance_type: ${{ inputs.ec2_instance_type }} ec2_ami_id: ${{ inputs.ec2_ami_id }} ec2_instance_ttl: ${{ inputs.ec2_instance_ttl }} + ec2_key_name: "build-instance" ec2_instance_tags: '[{"Key": "Keep-Alive", "Value": "true"}]' setup: diff --git a/.github/workflows/start-spot.yml b/.github/workflows/start-spot.yml new file mode 100644 index 00000000000..2cbc0e8415d --- /dev/null +++ b/.github/workflows/start-spot.yml @@ -0,0 +1,30 @@ +# Useful if the spot runners are in a bad state +name: Stop Personal Spot +on: + workflow_dispatch: {} +jobs: + stop-build-x86: + uses: ./.github/workflows/setup-runner.yml + with: + runner_label: ${{ github.actor }}-x86 + subaction: stop + # not used: + ebs_cache_size_gb: 256 + runner_concurrency: 50 + ec2_instance_type: m6a.32xlarge + ec2_ami_id: ami-0d8a9b0419ddb331a + ec2_instance_ttl: 40 + secrets: inherit + + stop-bench: + uses: ./.github/workflows/setup-runner.yml + with: + runner_label: ${{ github.actor }}-bench-x86 + subaction: stop + # not used: + ebs_cache_size_gb: 64 + runner_concurrency: 1 + ec2_instance_type: m6a.4xlarge + ec2_ami_id: ami-0d8a9b0419ddb331a + ec2_instance_ttl: 15 + secrets: inherit \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index 8661488d112..ea41bbe2bc2 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -165,5 +165,6 @@ "**/target/**": true, "**/l1-contracts/lib/**": true, "**/barretenberg/cpp/build*/**": true - } + }, + "cmake.sourceDirectory": "/mnt/user-data/adam/aztec-packages/barretenberg/cpp" } diff --git a/barretenberg/cpp/Earthfile b/barretenberg/cpp/Earthfile index 3355211a656..346d1be3d07 100644 --- a/barretenberg/cpp/Earthfile +++ b/barretenberg/cpp/Earthfile @@ -235,10 +235,15 @@ test-clang-format: RUN ./format.sh check test: + ARG hardware_concurrency="" BUILD +test-clang-format BUILD ./srs_db/+build # prefetch FROM +source COPY --dir +test-binaries/build build FROM +preset-release-assert-test COPY --dir ./srs_db/+build/. srs_db + # limit hardware concurrency, if provided + IF [ "$HARDWARE_CONCURRENCY" != "" ] + ENV HARDWARE_CONCURRENCY=$hardware_concurrency + END RUN cd build && GTEST_COLOR=1 ctest -j$(nproc) --output-on-failure diff --git a/scripts/attach_ebs_cache.sh b/scripts/attach_ebs_cache.sh index 7eaa988afc2..d30812b9f9b 100755 --- a/scripts/attach_ebs_cache.sh +++ b/scripts/attach_ebs_cache.sh @@ -8,7 +8,28 @@ AVAILABILITY_ZONE="us-east-2a" VOLUME_TYPE="gp2" INSTANCE_ID=$(curl http://169.254.169.254/latest/meta-data/instance-id) -# TODO also mount various other aspects of docker image metadata +# Check if someone else is doing this +if [ -f /run/.ebs-cache-mounted ] ; then + MAX_WAIT_TIME=300 # Maximum wait time in seconds + WAIT_INTERVAL=10 # Interval between checks in seconds + elapsed_time=0 + # Check for existing mount, assume we can continue if existing + while ! mount | grep -q "/var/lib/docker type ext4"; do + echo "Someone already marked as mounting, waiting for them..." + if [ $elapsed_time -ge $MAX_WAIT_TIME ]; then + echo "Cache mount did not become available within $MAX_WAIT_TIME seconds... race condition?" + exit 1 + fi + + sleep $WAIT_INTERVAL + elapsed_time=$((elapsed_time + WAIT_INTERVAL)) + done + echo "Detected existing mount, continuing..." + exit 0 +fi + +# Mark to prevent race conditions +touch /run/.ebs-cache-mounted # Check for existing mount, assume we can continue if existing if mount | grep -q "/var/lib/docker/volumes type ext4"; then @@ -57,7 +78,6 @@ while [ "$(aws ec2 describe-volumes \ --volume-ids $VOLUME_ID \ --query "Volumes[0].State" \ --output text)" != "available" ]; do - sleep 1 if [ $elapsed_time -ge $MAX_WAIT_TIME ]; then echo "Volume $VOLUME_ID did not become available within $MAX_WAIT_TIME seconds." exit 1 diff --git a/yarn-project/end-to-end/Earthfile b/yarn-project/end-to-end/Earthfile index 1a77fbc2683..f75127fe1f2 100644 --- a/yarn-project/end-to-end/Earthfile +++ b/yarn-project/end-to-end/Earthfile @@ -132,14 +132,16 @@ guides-dapp-testing: # ARG e2e_mode=local # DO +E2E_TEST --test=guides/up_quick_start.test.ts --e2e_mode=$e2e_mode -bench-publish-rollup: - ARG e2e_mode=local - DO +E2E_TEST --test=benchmarks/bench_publish_rollup.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --compose_file=./scripts/docker-compose-no-sandbox.yml +# TODO hanging +# bench-publish-rollup: +# ARG e2e_mode=local +# DO +E2E_TEST --test=benchmarks/bench_publish_rollup.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --compose_file=./scripts/docker-compose-no-sandbox.yml -bench-process-history: - ARG e2e_mode=local - DO +E2E_TEST --test=benchmarks/bench_process_history.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --compose_file=./scripts/docker-compose-no-sandbox.yml +# TODO hanging +# bench-process-history: +# ARG e2e_mode=local +# DO +E2E_TEST --test=benchmarks/bench_process_history.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --compose_file=./scripts/docker-compose-no-sandbox.yml -bench-tx-size: - ARG e2e_mode=local - DO +E2E_TEST --test=benchmarks/bench_tx_size_fees.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --enable_gas=1 --compose_file=./scripts/docker-compose-no-sandbox.yml +# bench-tx-size: +# ARG e2e_mode=local +# DO +E2E_TEST --test=benchmarks/bench_tx_size_fees.test.ts --debug="aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees" --e2e_mode=$e2e_mode --enable_gas=1 --compose_file=./scripts/docker-compose-no-sandbox.yml diff --git a/yarn-project/end-to-end/src/e2e_account_init_fees.test.ts b/yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_account_init_fees.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts diff --git a/yarn-project/end-to-end/src/e2e_p2p_network.test.ts b/yarn-project/end-to-end/src/flakey_e2e_p2p_network.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_p2p_network.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_p2p_network.test.ts From d9bb2c7fc561a7b1c7dfb516a5afc107cc8bdbbd Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 18:31:45 -0400 Subject: [PATCH 07/56] fix(ci): don't fail if can't prune hotfix --- .github/workflows/setup-runner.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/setup-runner.yml b/.github/workflows/setup-runner.yml index 928ce594b4f..6eb50ef922b 100644 --- a/.github/workflows/setup-runner.yml +++ b/.github/workflows/setup-runner.yml @@ -108,7 +108,7 @@ jobs: - name: Run Docker Prune # helps to not overuse space - run: docker system prune -f + run: docker system prune -f || true - name: Run Earthly Bootstrap run: earthly bootstrap From 9a9eab6b6b4e087ef1c15172c974353f90815b8b Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 18:51:24 -0400 Subject: [PATCH 08/56] fix(ci): speculative deploy fix fix a path --- .circleci/config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index 4492449fa57..5b7245c3e60 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -629,7 +629,7 @@ jobs: command: | should_deploy || exit 0 deploy_terraform_services iac/mainnet-fork mainnet-fork mainnet-fork aws_efs_file_system.aztec_mainnet_fork_data_store - ./iac/scripts/wait_for_fork + ./iac/mainnet-fork/scripts/wait_for_fork - run: name: "Release canary to NPM: bb.js" command: | From f06f64c451333d36eb05951202d69ee85cca8851 Mon Sep 17 00:00:00 2001 From: Maxim Vezenov Date: Tue, 16 Apr 2024 01:59:00 +0100 Subject: [PATCH 09/56] feat(acir)!: BrilligCall opcode (#5709) This starts work towards https://github.com/noir-lang/noir/issues/3907 but is only the breaking serialization change. Codegen and evaluation will come in a follow-up. This PR is purely additive and does not remove the current way we do Brillig gen during ACIR gen. Codegen for normal Brillig functions is working in my follow-up, however, removing the existing Brillig opcode will most likely have to come once we settle on how to [handle the brillig std lib](https://github.com/noir-lang/acvm/issues/471) as we are currently generating code such as calculating a quotient during ACIR gen. --------- Co-authored-by: Tom French <15848336+TomAFrench@users.noreply.github.com> --- .../dsl/acir_format/serde/acir.hpp | 140 +++++++++++++++++- .../noir-repo/acvm-repo/acir/codegen/acir.cpp | 114 +++++++++++++- .../acvm-repo/acir/src/circuit/brillig.rs | 8 + .../acvm-repo/acir/src/circuit/mod.rs | 7 +- .../acvm-repo/acir/src/circuit/opcodes.rs | 27 +++- .../acir/tests/test_program_serialization.rs | 130 ++++++++-------- .../acvm/src/compiler/transformers/mod.rs | 15 ++ noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs | 3 + .../acvm-repo/acvm_js/test/shared/addition.ts | 10 +- .../test/shared/complex_foreign_call.ts | 14 +- .../test/shared/fixed_base_scalar_mul.ts | 6 +- .../acvm_js/test/shared/foreign_call.ts | 8 +- .../acvm_js/test/shared/memory_op.ts | 8 +- .../acvm_js/test/shared/nested_acir_call.ts | 14 +- .../acvm-repo/acvm_js/test/shared/pedersen.ts | 4 +- .../acvm_js/test/shared/schnorr_verify.ts | 24 +-- .../backend_interface/src/smart_contract.rs | 2 +- .../tooling/nargo_cli/src/cli/info_cmd.rs | 7 +- yarn-project/circuits.js/src/constants.gen.ts | 2 +- 19 files changed, 426 insertions(+), 117 deletions(-) diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp index 3e01fd1f155..c32172a9319 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp @@ -1123,6 +1123,17 @@ struct Opcode { static MemoryInit bincodeDeserialize(std::vector); }; + struct BrilligCall { + uint32_t id; + std::vector inputs; + std::vector outputs; + std::optional predicate; + + friend bool operator==(const BrilligCall&, const BrilligCall&); + std::vector bincodeSerialize() const; + static BrilligCall bincodeDeserialize(std::vector); + }; + struct Call { uint32_t id; std::vector inputs; @@ -1134,7 +1145,7 @@ struct Opcode { static Call bincodeDeserialize(std::vector); }; - std::variant value; + std::variant value; friend bool operator==(const Opcode&, const Opcode&); std::vector bincodeSerialize() const; @@ -1213,8 +1224,17 @@ struct Circuit { static Circuit bincodeDeserialize(std::vector); }; +struct BrilligBytecode { + std::vector bytecode; + + friend bool operator==(const BrilligBytecode&, const BrilligBytecode&); + std::vector bincodeSerialize() const; + static BrilligBytecode bincodeDeserialize(std::vector); +}; + struct Program { std::vector functions; + std::vector unconstrained_functions; friend bool operator==(const Program&, const Program&); std::vector bincodeSerialize() const; @@ -4878,6 +4898,56 @@ Program::Brillig serde::Deserializable::deserialize(Deserializ namespace Program { +inline bool operator==(const BrilligBytecode& lhs, const BrilligBytecode& rhs) +{ + if (!(lhs.bytecode == rhs.bytecode)) { + return false; + } + return true; +} + +inline std::vector BrilligBytecode::bincodeSerialize() const +{ + auto serializer = serde::BincodeSerializer(); + serde::Serializable::serialize(*this, serializer); + return std::move(serializer).bytes(); +} + +inline BrilligBytecode BrilligBytecode::bincodeDeserialize(std::vector input) +{ + auto deserializer = serde::BincodeDeserializer(input); + auto value = serde::Deserializable::deserialize(deserializer); + if (deserializer.get_buffer_offset() < input.size()) { + throw_or_abort("Some input bytes were not read"); + } + return value; +} + +} // end of namespace Program + +template <> +template +void serde::Serializable::serialize(const Program::BrilligBytecode& obj, + Serializer& serializer) +{ + serializer.increase_container_depth(); + serde::Serializable::serialize(obj.bytecode, serializer); + serializer.decrease_container_depth(); +} + +template <> +template +Program::BrilligBytecode serde::Deserializable::deserialize(Deserializer& deserializer) +{ + deserializer.increase_container_depth(); + Program::BrilligBytecode obj; + obj.bytecode = serde::Deserializable::deserialize(deserializer); + deserializer.decrease_container_depth(); + return obj; +} + +namespace Program { + inline bool operator==(const BrilligInputs& lhs, const BrilligInputs& rhs) { if (!(lhs.value == rhs.value)) { @@ -7417,6 +7487,68 @@ Program::Opcode::MemoryInit serde::Deserializable:: namespace Program { +inline bool operator==(const Opcode::BrilligCall& lhs, const Opcode::BrilligCall& rhs) +{ + if (!(lhs.id == rhs.id)) { + return false; + } + if (!(lhs.inputs == rhs.inputs)) { + return false; + } + if (!(lhs.outputs == rhs.outputs)) { + return false; + } + if (!(lhs.predicate == rhs.predicate)) { + return false; + } + return true; +} + +inline std::vector Opcode::BrilligCall::bincodeSerialize() const +{ + auto serializer = serde::BincodeSerializer(); + serde::Serializable::serialize(*this, serializer); + return std::move(serializer).bytes(); +} + +inline Opcode::BrilligCall Opcode::BrilligCall::bincodeDeserialize(std::vector input) +{ + auto deserializer = serde::BincodeDeserializer(input); + auto value = serde::Deserializable::deserialize(deserializer); + if (deserializer.get_buffer_offset() < input.size()) { + throw_or_abort("Some input bytes were not read"); + } + return value; +} + +} // end of namespace Program + +template <> +template +void serde::Serializable::serialize(const Program::Opcode::BrilligCall& obj, + Serializer& serializer) +{ + serde::Serializable::serialize(obj.id, serializer); + serde::Serializable::serialize(obj.inputs, serializer); + serde::Serializable::serialize(obj.outputs, serializer); + serde::Serializable::serialize(obj.predicate, serializer); +} + +template <> +template +Program::Opcode::BrilligCall serde::Deserializable::deserialize( + Deserializer& deserializer) +{ + Program::Opcode::BrilligCall obj; + obj.id = serde::Deserializable::deserialize(deserializer); + obj.inputs = serde::Deserializable::deserialize(deserializer); + obj.outputs = serde::Deserializable::deserialize(deserializer); + obj.predicate = serde::Deserializable::deserialize(deserializer); + return obj; +} + +namespace Program { + inline bool operator==(const Opcode::Call& lhs, const Opcode::Call& rhs) { if (!(lhs.id == rhs.id)) { @@ -7630,6 +7762,9 @@ inline bool operator==(const Program& lhs, const Program& rhs) if (!(lhs.functions == rhs.functions)) { return false; } + if (!(lhs.unconstrained_functions == rhs.unconstrained_functions)) { + return false; + } return true; } @@ -7658,6 +7793,7 @@ void serde::Serializable::serialize(const Program::Program& ob { serializer.increase_container_depth(); serde::Serializable::serialize(obj.functions, serializer); + serde::Serializable::serialize(obj.unconstrained_functions, serializer); serializer.decrease_container_depth(); } @@ -7668,6 +7804,8 @@ Program::Program serde::Deserializable::deserialize(Deserializ deserializer.increase_container_depth(); Program::Program obj; obj.functions = serde::Deserializable::deserialize(deserializer); + obj.unconstrained_functions = + serde::Deserializable::deserialize(deserializer); deserializer.decrease_container_depth(); return obj; } diff --git a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp index 7cd9fbefba0..c5dd097110c 100644 --- a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp +++ b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp @@ -1061,6 +1061,17 @@ namespace Program { static MemoryInit bincodeDeserialize(std::vector); }; + struct BrilligCall { + uint32_t id; + std::vector inputs; + std::vector outputs; + std::optional predicate; + + friend bool operator==(const BrilligCall&, const BrilligCall&); + std::vector bincodeSerialize() const; + static BrilligCall bincodeDeserialize(std::vector); + }; + struct Call { uint32_t id; std::vector inputs; @@ -1072,7 +1083,7 @@ namespace Program { static Call bincodeDeserialize(std::vector); }; - std::variant value; + std::variant value; friend bool operator==(const Opcode&, const Opcode&); std::vector bincodeSerialize() const; @@ -1151,8 +1162,17 @@ namespace Program { static Circuit bincodeDeserialize(std::vector); }; + struct BrilligBytecode { + std::vector bytecode; + + friend bool operator==(const BrilligBytecode&, const BrilligBytecode&); + std::vector bincodeSerialize() const; + static BrilligBytecode bincodeDeserialize(std::vector); + }; + struct Program { std::vector functions; + std::vector unconstrained_functions; friend bool operator==(const Program&, const Program&); std::vector bincodeSerialize() const; @@ -4071,6 +4091,48 @@ Program::Brillig serde::Deserializable::deserialize(Deserializ return obj; } +namespace Program { + + inline bool operator==(const BrilligBytecode &lhs, const BrilligBytecode &rhs) { + if (!(lhs.bytecode == rhs.bytecode)) { return false; } + return true; + } + + inline std::vector BrilligBytecode::bincodeSerialize() const { + auto serializer = serde::BincodeSerializer(); + serde::Serializable::serialize(*this, serializer); + return std::move(serializer).bytes(); + } + + inline BrilligBytecode BrilligBytecode::bincodeDeserialize(std::vector input) { + auto deserializer = serde::BincodeDeserializer(input); + auto value = serde::Deserializable::deserialize(deserializer); + if (deserializer.get_buffer_offset() < input.size()) { + throw serde::deserialization_error("Some input bytes were not read"); + } + return value; + } + +} // end of namespace Program + +template <> +template +void serde::Serializable::serialize(const Program::BrilligBytecode &obj, Serializer &serializer) { + serializer.increase_container_depth(); + serde::Serializable::serialize(obj.bytecode, serializer); + serializer.decrease_container_depth(); +} + +template <> +template +Program::BrilligBytecode serde::Deserializable::deserialize(Deserializer &deserializer) { + deserializer.increase_container_depth(); + Program::BrilligBytecode obj; + obj.bytecode = serde::Deserializable::deserialize(deserializer); + deserializer.decrease_container_depth(); + return obj; +} + namespace Program { inline bool operator==(const BrilligInputs &lhs, const BrilligInputs &rhs) { @@ -6118,6 +6180,53 @@ Program::Opcode::MemoryInit serde::Deserializable:: return obj; } +namespace Program { + + inline bool operator==(const Opcode::BrilligCall &lhs, const Opcode::BrilligCall &rhs) { + if (!(lhs.id == rhs.id)) { return false; } + if (!(lhs.inputs == rhs.inputs)) { return false; } + if (!(lhs.outputs == rhs.outputs)) { return false; } + if (!(lhs.predicate == rhs.predicate)) { return false; } + return true; + } + + inline std::vector Opcode::BrilligCall::bincodeSerialize() const { + auto serializer = serde::BincodeSerializer(); + serde::Serializable::serialize(*this, serializer); + return std::move(serializer).bytes(); + } + + inline Opcode::BrilligCall Opcode::BrilligCall::bincodeDeserialize(std::vector input) { + auto deserializer = serde::BincodeDeserializer(input); + auto value = serde::Deserializable::deserialize(deserializer); + if (deserializer.get_buffer_offset() < input.size()) { + throw serde::deserialization_error("Some input bytes were not read"); + } + return value; + } + +} // end of namespace Program + +template <> +template +void serde::Serializable::serialize(const Program::Opcode::BrilligCall &obj, Serializer &serializer) { + serde::Serializable::serialize(obj.id, serializer); + serde::Serializable::serialize(obj.inputs, serializer); + serde::Serializable::serialize(obj.outputs, serializer); + serde::Serializable::serialize(obj.predicate, serializer); +} + +template <> +template +Program::Opcode::BrilligCall serde::Deserializable::deserialize(Deserializer &deserializer) { + Program::Opcode::BrilligCall obj; + obj.id = serde::Deserializable::deserialize(deserializer); + obj.inputs = serde::Deserializable::deserialize(deserializer); + obj.outputs = serde::Deserializable::deserialize(deserializer); + obj.predicate = serde::Deserializable::deserialize(deserializer); + return obj; +} + namespace Program { inline bool operator==(const Opcode::Call &lhs, const Opcode::Call &rhs) { @@ -6290,6 +6399,7 @@ namespace Program { inline bool operator==(const Program &lhs, const Program &rhs) { if (!(lhs.functions == rhs.functions)) { return false; } + if (!(lhs.unconstrained_functions == rhs.unconstrained_functions)) { return false; } return true; } @@ -6315,6 +6425,7 @@ template void serde::Serializable::serialize(const Program::Program &obj, Serializer &serializer) { serializer.increase_container_depth(); serde::Serializable::serialize(obj.functions, serializer); + serde::Serializable::serialize(obj.unconstrained_functions, serializer); serializer.decrease_container_depth(); } @@ -6324,6 +6435,7 @@ Program::Program serde::Deserializable::deserialize(Deserializ deserializer.increase_container_depth(); Program::Program obj; obj.functions = serde::Deserializable::deserialize(deserializer); + obj.unconstrained_functions = serde::Deserializable::deserialize(deserializer); deserializer.decrease_container_depth(); return obj; } diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/brillig.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/brillig.rs index f394a46ff82..e75d335d52b 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/brillig.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/brillig.rs @@ -29,3 +29,11 @@ pub struct Brillig { /// Predicate of the Brillig execution - indicates if it should be skipped pub predicate: Option, } + +/// This is purely a wrapper struct around a list of Brillig opcode's which represents +/// a full Brillig function to be executed by the Brillig VM. +/// This is stored separately on a program and accessed through a [BrilligPointer]. +#[derive(Clone, PartialEq, Eq, Serialize, Deserialize, Default)] +pub struct BrilligBytecode { + pub bytecode: Vec, +} diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs index cb846bdaffa..27d8a392c81 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs @@ -15,6 +15,8 @@ use serde::{de::Error as DeserializationError, Deserialize, Deserializer, Serial use std::collections::BTreeSet; +use self::brillig::BrilligBytecode; + /// Specifies the maximum width of the expressions which will be constrained. /// /// Unbounded Expressions are useful if you are eventually going to pass the ACIR @@ -37,6 +39,7 @@ pub enum ExpressionWidth { #[derive(Clone, PartialEq, Eq, Serialize, Deserialize, Default)] pub struct Program { pub functions: Vec, + pub unconstrained_functions: Vec, } #[derive(Clone, PartialEq, Eq, Serialize, Deserialize, Default)] @@ -384,7 +387,7 @@ mod tests { assert_messages: Default::default(), recursive: false, }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: Vec::new() }; fn read_write(program: Program) -> (Program, Program) { let bytes = Program::serialize_program(&program); @@ -417,7 +420,7 @@ mod tests { assert_messages: Default::default(), recursive: false, }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: Vec::new() }; let json = serde_json::to_string_pretty(&program).unwrap(); diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes.rs index d8204132b3e..b0b8e286e0c 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes.rs @@ -1,4 +1,7 @@ -use super::{brillig::Brillig, directives::Directive}; +use super::{ + brillig::{Brillig, BrilligInputs, BrilligOutputs}, + directives::Directive, +}; use crate::native_types::{Expression, Witness}; use serde::{Deserialize, Serialize}; @@ -29,6 +32,18 @@ pub enum Opcode { block_id: BlockId, init: Vec, }, + /// Calls to unconstrained functions + BrilligCall { + /// Id for the function being called. It is the responsibility of the executor + /// to fetch the appropriate Brillig bytecode from this id. + id: u32, + /// Inputs to the function call + inputs: Vec, + /// Outputs to the function call + outputs: Vec, + /// Predicate of the Brillig execution - indicates if it should be skipped + predicate: Option, + }, /// Calls to functions represented as a separate circuit. A call opcode allows us /// to build a call stack when executing the outer-most circuit. Call { @@ -99,6 +114,16 @@ impl std::fmt::Display for Opcode { write!(f, "INIT ")?; write!(f, "(id: {}, len: {}) ", block_id.0, init.len()) } + // We keep the display for a BrilligCall and circuit Call separate as they + // are distinct in their functionality and we should maintain this separation for debugging. + Opcode::BrilligCall { id, inputs, outputs, predicate } => { + write!(f, "BRILLIG CALL func {}: ", id)?; + if let Some(pred) = predicate { + writeln!(f, "PREDICATE = {pred}")?; + } + write!(f, "inputs: {:?}, ", inputs)?; + write!(f, "outputs: {:?}", outputs) + } Opcode::Call { id, inputs, outputs, predicate } => { write!(f, "CALL func {}: ", id)?; if let Some(pred) = predicate { diff --git a/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs b/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs index 8b9160ccf6a..3f392be9fe9 100644 --- a/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs +++ b/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs @@ -41,17 +41,17 @@ fn addition_circuit() { return_values: PublicInputs([Witness(3)].into()), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 75, 14, 128, 32, 12, 68, 249, 120, 160, 150, - 182, 208, 238, 188, 138, 68, 184, 255, 17, 212, 200, 130, 196, 165, 188, 164, 153, 174, 94, - 38, 227, 221, 203, 118, 159, 119, 95, 226, 200, 125, 36, 252, 3, 253, 66, 87, 152, 92, 4, - 153, 185, 149, 212, 144, 240, 128, 100, 85, 5, 88, 106, 86, 84, 20, 149, 51, 41, 81, 83, - 214, 98, 213, 10, 24, 50, 53, 236, 98, 212, 135, 44, 174, 235, 5, 143, 35, 12, 151, 159, - 126, 55, 109, 28, 231, 145, 47, 245, 105, 191, 143, 133, 1, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 65, 14, 128, 32, 12, 4, 65, 124, 80, 75, 91, + 104, 111, 126, 69, 34, 252, 255, 9, 106, 228, 64, 162, 55, 153, 164, 217, 158, 38, 155, + 245, 238, 97, 189, 206, 187, 55, 161, 231, 214, 19, 254, 129, 126, 162, 107, 25, 92, 4, + 137, 185, 230, 88, 145, 112, 135, 104, 69, 5, 88, 74, 82, 84, 20, 149, 35, 42, 81, 85, 214, + 108, 197, 50, 24, 50, 85, 108, 98, 212, 186, 44, 204, 235, 5, 183, 99, 233, 46, 63, 252, + 110, 216, 56, 184, 15, 78, 146, 74, 173, 20, 141, 1, 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -72,14 +72,14 @@ fn fixed_base_scalar_mul_circuit() { return_values: PublicInputs(BTreeSet::from_iter(vec![Witness(3), Witness(4)])), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 77, 138, 81, 10, 0, 48, 8, 66, 87, 219, 190, 118, 233, - 29, 61, 43, 3, 5, 121, 34, 207, 86, 231, 162, 198, 157, 124, 228, 71, 157, 220, 232, 161, - 227, 226, 206, 214, 95, 221, 74, 0, 116, 58, 13, 182, 105, 0, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 138, 81, 10, 0, 48, 8, 66, 87, 219, 190, 118, 233, + 29, 61, 35, 3, 19, 228, 137, 60, 91, 149, 139, 26, 119, 242, 145, 31, 117, 114, 163, 135, + 142, 139, 219, 91, 127, 117, 71, 2, 117, 84, 50, 98, 113, 0, 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -100,14 +100,14 @@ fn pedersen_circuit() { return_values: PublicInputs(BTreeSet::from_iter(vec![Witness(2), Witness(3)])), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 93, 74, 7, 6, 0, 0, 8, 108, 209, 255, 63, 156, 54, 233, - 56, 55, 17, 26, 18, 196, 241, 169, 250, 178, 141, 167, 32, 159, 254, 234, 238, 255, 87, - 112, 52, 63, 63, 101, 105, 0, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 93, 74, 9, 10, 0, 0, 4, 115, 149, 255, 127, 88, 8, 133, + 213, 218, 137, 80, 144, 32, 182, 79, 213, 151, 173, 61, 5, 121, 245, 91, 103, 255, 191, 3, + 7, 16, 26, 112, 158, 113, 0, 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -142,27 +142,27 @@ fn schnorr_verify_circuit() { return_values: PublicInputs(BTreeSet::from([output])), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 77, 210, 7, 78, 2, 1, 20, 69, 81, 236, 189, 247, 222, - 123, 239, 93, 177, 33, 34, 238, 194, 253, 47, 193, 200, 147, 67, 194, 36, 147, 163, 33, 33, - 228, 191, 219, 82, 168, 63, 63, 181, 183, 197, 223, 177, 147, 191, 181, 183, 149, 69, 159, - 183, 213, 222, 238, 218, 219, 206, 14, 118, 178, 139, 141, 183, 135, 189, 236, 99, 63, 7, - 56, 200, 33, 14, 115, 132, 163, 28, 227, 56, 39, 56, 201, 41, 78, 115, 134, 179, 156, 227, - 60, 23, 184, 200, 37, 46, 115, 133, 171, 92, 227, 58, 55, 184, 201, 45, 110, 115, 135, 187, - 220, 227, 62, 15, 120, 200, 35, 30, 243, 132, 167, 60, 227, 57, 47, 120, 201, 43, 94, 243, - 134, 183, 188, 227, 61, 31, 248, 200, 39, 22, 249, 204, 151, 166, 29, 243, 188, 250, 255, - 141, 239, 44, 241, 131, 101, 126, 178, 194, 47, 86, 249, 237, 123, 171, 76, 127, 105, 47, - 189, 165, 181, 116, 150, 198, 26, 125, 245, 248, 45, 233, 41, 45, 165, 163, 52, 148, 126, - 210, 78, 186, 73, 51, 233, 37, 173, 164, 147, 52, 146, 62, 210, 70, 186, 72, 19, 233, 33, - 45, 164, 131, 52, 144, 253, 151, 11, 245, 221, 179, 121, 246, 206, 214, 217, 57, 27, 103, - 223, 109, 187, 238, 218, 115, 223, 142, 135, 246, 59, 182, 219, 169, 189, 206, 237, 116, - 105, 159, 107, 187, 220, 218, 227, 222, 14, 143, 238, 95, 116, 247, 23, 119, 126, 115, 223, - 146, 187, 150, 221, 179, 226, 142, 141, 155, 53, 238, 86, 104, 186, 231, 255, 243, 7, 100, - 141, 232, 192, 233, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 135, 74, 66, 1, 24, 134, 97, 219, 123, 239, + 189, 247, 222, 187, 108, 153, 153, 221, 69, 247, 127, 9, 145, 31, 62, 130, 29, 56, 60, 133, + 32, 242, 127, 111, 75, 161, 254, 252, 212, 222, 22, 127, 199, 78, 254, 214, 222, 86, 22, + 125, 222, 86, 123, 187, 107, 111, 59, 59, 216, 201, 46, 54, 222, 30, 246, 178, 143, 253, + 28, 224, 32, 135, 56, 204, 17, 142, 114, 140, 227, 156, 224, 36, 167, 56, 205, 25, 206, + 114, 142, 243, 92, 224, 34, 151, 184, 204, 21, 174, 114, 141, 235, 220, 224, 38, 183, 184, + 205, 29, 238, 114, 143, 251, 60, 224, 33, 143, 120, 204, 19, 158, 242, 140, 231, 188, 224, + 37, 175, 120, 205, 27, 222, 242, 142, 247, 124, 224, 35, 159, 88, 228, 51, 95, 154, 118, + 204, 243, 234, 255, 55, 190, 179, 196, 15, 150, 249, 201, 10, 191, 88, 229, 183, 239, 173, + 50, 253, 165, 189, 244, 150, 214, 210, 89, 26, 107, 244, 213, 227, 183, 164, 167, 180, 148, + 142, 210, 80, 250, 73, 59, 233, 38, 205, 164, 151, 180, 146, 78, 210, 72, 250, 72, 27, 233, + 34, 77, 164, 135, 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, 207, 230, 217, 59, 91, 103, + 231, 108, 156, 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, 58, + 183, 211, 165, 125, 174, 237, 114, 107, 143, 123, 59, 60, 186, 127, 209, 221, 95, 220, 249, + 205, 125, 75, 238, 90, 118, 207, 138, 59, 54, 110, 214, 184, 91, 161, 233, 158, 255, 158, + 63, 46, 139, 64, 203, 241, 3, 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -206,16 +206,17 @@ fn simple_brillig_foreign_call() { private_parameters: BTreeSet::from([Witness(1), Witness(2)]), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 61, 10, 192, 48, 8, 133, 53, 133, 82, 186, - 245, 38, 233, 13, 122, 153, 14, 93, 58, 132, 144, 227, 135, 252, 41, 56, 36, 46, 201, 7, - 162, 168, 200, 123, 34, 52, 142, 28, 72, 245, 38, 106, 9, 247, 30, 202, 118, 142, 27, 215, - 221, 178, 82, 175, 33, 15, 133, 189, 163, 159, 57, 197, 252, 251, 195, 235, 188, 230, 186, - 16, 65, 255, 12, 239, 92, 131, 89, 149, 198, 77, 3, 10, 9, 119, 8, 198, 242, 152, 1, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 61, 10, 192, 32, 12, 133, 19, 11, 165, 116, + 235, 77, 236, 13, 122, 153, 14, 93, 58, 136, 120, 124, 241, 47, 129, 12, 42, 130, 126, 16, + 18, 146, 16, 222, 11, 66, 225, 136, 129, 84, 111, 162, 150, 112, 239, 161, 172, 231, 184, + 113, 221, 45, 45, 245, 42, 242, 144, 216, 43, 250, 153, 83, 204, 191, 223, 189, 198, 246, + 92, 39, 60, 244, 63, 195, 59, 87, 99, 150, 165, 113, 83, 193, 0, 1, 19, 247, 29, 5, 160, 1, + 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -306,20 +307,20 @@ fn complex_brillig_foreign_call() { private_parameters: BTreeSet::from([Witness(1), Witness(2), Witness(3)]), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 84, 93, 10, 131, 48, 12, 78, 218, 233, 100, 111, - 187, 193, 96, 59, 64, 231, 9, 188, 139, 248, 166, 232, 163, 167, 23, 11, 126, 197, 24, 250, - 34, 86, 208, 64, 72, 218, 252, 125, 36, 105, 153, 22, 42, 60, 51, 116, 235, 217, 64, 103, - 156, 37, 5, 191, 10, 210, 29, 163, 63, 167, 203, 229, 206, 194, 104, 110, 128, 209, 158, - 128, 49, 236, 195, 69, 231, 157, 114, 46, 73, 251, 103, 35, 239, 231, 225, 57, 243, 156, - 227, 252, 132, 44, 112, 79, 176, 125, 84, 223, 73, 248, 145, 152, 69, 149, 4, 107, 233, - 114, 90, 119, 145, 85, 237, 151, 192, 89, 247, 221, 208, 54, 163, 85, 174, 26, 234, 87, - 232, 63, 101, 103, 21, 55, 169, 216, 73, 72, 249, 5, 197, 234, 132, 123, 179, 35, 247, 155, - 214, 246, 102, 20, 73, 204, 72, 168, 123, 191, 161, 25, 66, 136, 159, 187, 53, 5, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 84, 75, 10, 132, 48, 12, 77, 218, 209, 145, 217, + 205, 13, 6, 198, 3, 84, 79, 224, 93, 196, 157, 162, 75, 79, 47, 22, 124, 197, 16, 186, 17, + 43, 104, 32, 36, 109, 126, 143, 36, 45, 211, 70, 133, 103, 134, 110, 61, 27, 232, 140, 179, + 164, 224, 215, 64, 186, 115, 84, 113, 186, 92, 238, 42, 140, 230, 1, 24, 237, 5, 24, 195, + 62, 220, 116, 222, 41, 231, 146, 180, 127, 54, 242, 126, 94, 158, 51, 207, 57, 206, 111, + 200, 2, 247, 4, 219, 79, 245, 157, 132, 31, 137, 89, 52, 73, 176, 214, 46, 167, 125, 23, + 89, 213, 254, 8, 156, 237, 56, 76, 125, 55, 91, 229, 170, 161, 254, 133, 94, 42, 59, 171, + 184, 69, 197, 46, 66, 202, 47, 40, 86, 39, 220, 155, 3, 185, 191, 180, 183, 55, 163, 72, + 98, 70, 66, 221, 251, 40, 173, 255, 35, 68, 62, 61, 5, 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -348,16 +349,16 @@ fn memory_op_circuit() { return_values: PublicInputs([Witness(4)].into()), ..Circuit::default() }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 81, 201, 13, 0, 32, 8, 147, 195, 125, 112, 3, 247, - 159, 74, 141, 60, 106, 226, 79, 120, 216, 132, 180, 124, 154, 82, 168, 108, 212, 57, 2, - 122, 129, 157, 201, 181, 150, 59, 186, 179, 189, 161, 101, 251, 82, 176, 175, 196, 121, 89, - 118, 185, 246, 91, 185, 26, 125, 187, 64, 80, 134, 29, 195, 31, 79, 24, 2, 250, 167, 252, - 27, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 81, 57, 14, 0, 32, 8, 147, 195, 255, 224, 15, 252, + 255, 171, 212, 200, 208, 129, 77, 24, 108, 66, 90, 150, 166, 20, 106, 23, 125, 143, 128, + 62, 96, 103, 114, 173, 45, 198, 116, 182, 55, 140, 106, 95, 74, 246, 149, 60, 47, 171, 46, + 215, 126, 43, 87, 179, 111, 23, 8, 202, 176, 99, 248, 240, 9, 11, 137, 33, 212, 110, 35, 3, + 0, 0, ]; assert_eq!(bytes, expected_serialization) @@ -450,20 +451,21 @@ fn nested_acir_call_circuit() { ..Circuit::default() }; - let program = Program { functions: vec![main, nested_call, inner_call] }; + let program = + Program { functions: vec![main, nested_call, inner_call], unconstrained_functions: vec![] }; let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 205, 146, 97, 10, 195, 32, 12, 133, 163, 66, 207, 147, - 24, 173, 241, 223, 174, 50, 153, 189, 255, 17, 214, 177, 148, 89, 17, 250, 99, 14, 246, - 224, 97, 144, 16, 146, 143, 231, 224, 45, 167, 126, 105, 217, 109, 118, 91, 248, 200, 168, - 225, 248, 191, 106, 114, 208, 233, 104, 188, 233, 139, 223, 137, 108, 51, 139, 113, 13, - 161, 38, 95, 137, 233, 142, 62, 23, 137, 24, 98, 89, 133, 132, 162, 196, 135, 23, 230, 42, - 65, 82, 46, 57, 97, 166, 192, 149, 182, 152, 121, 211, 97, 110, 222, 94, 8, 13, 132, 182, - 54, 48, 144, 235, 8, 254, 10, 22, 76, 132, 101, 231, 237, 229, 23, 189, 213, 54, 119, 15, - 83, 212, 199, 172, 175, 79, 113, 51, 48, 198, 253, 207, 84, 13, 204, 141, 224, 21, 176, - 147, 158, 66, 231, 43, 145, 6, 4, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 205, 146, 65, 10, 3, 33, 12, 69, 163, 46, 230, 58, 137, + 209, 49, 238, 122, 149, 74, 157, 251, 31, 161, 83, 154, 161, 86, 132, 89, 212, 194, 124, + 248, 24, 36, 132, 228, 241, 29, 188, 229, 212, 47, 45, 187, 205, 110, 11, 31, 25, 53, 28, + 255, 103, 77, 14, 58, 29, 141, 55, 125, 241, 55, 145, 109, 102, 49, 174, 33, 212, 228, 43, + 49, 221, 209, 231, 34, 17, 67, 44, 171, 144, 80, 148, 248, 240, 194, 92, 37, 72, 202, 37, + 39, 204, 20, 184, 210, 22, 51, 111, 58, 204, 205, 219, 11, 161, 129, 208, 214, 6, 6, 114, + 29, 193, 127, 193, 130, 137, 176, 236, 188, 189, 252, 162, 183, 218, 230, 238, 97, 138, + 250, 152, 245, 245, 87, 220, 12, 140, 113, 95, 153, 170, 129, 185, 17, 60, 3, 54, 212, 19, + 104, 145, 195, 151, 14, 4, 0, 0, ]; assert_eq!(bytes, expected_serialization); } diff --git a/noir/noir-repo/acvm-repo/acvm/src/compiler/transformers/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/compiler/transformers/mod.rs index 003cd4279a1..d13fac1672a 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/compiler/transformers/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/compiler/transformers/mod.rs @@ -142,6 +142,21 @@ pub(super) fn transform_internal( new_acir_opcode_positions.push(acir_opcode_positions[index]); transformed_opcodes.push(opcode); } + Opcode::BrilligCall { ref outputs, .. } => { + for output in outputs { + match output { + BrilligOutputs::Simple(w) => transformer.mark_solvable(*w), + BrilligOutputs::Array(v) => { + for witness in v { + transformer.mark_solvable(*witness); + } + } + } + } + + new_acir_opcode_positions.push(acir_opcode_positions[index]); + transformed_opcodes.push(opcode); + } Opcode::Call { ref outputs, .. } => { for witness in outputs { transformer.mark_solvable(*witness); diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs index bb98eda2689..fd00b16cb35 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs @@ -324,6 +324,9 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { Ok(Some(foreign_call)) => return self.wait_for_foreign_call(foreign_call), res => res.map(|_| ()), }, + Opcode::BrilligCall { .. } => { + todo!("implement brillig pointer handling"); + } Opcode::Call { .. } => match self.solve_call_opcode() { Ok(Some(input_values)) => return self.wait_for_acir_call(input_values), res => res.map(|_| ()), diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/addition.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/addition.ts index b56a4286878..820a415acf3 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/addition.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/addition.ts @@ -2,11 +2,11 @@ import { WitnessMap } from '@noir-lang/acvm_js'; // See `addition_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 75, 14, 128, 32, 12, 68, 249, 120, 160, 150, 182, 208, 238, 188, 138, 68, - 184, 255, 17, 212, 200, 130, 196, 165, 188, 164, 153, 174, 94, 38, 227, 221, 203, 118, 159, 119, 95, 226, 200, 125, - 36, 252, 3, 253, 66, 87, 152, 92, 4, 153, 185, 149, 212, 144, 240, 128, 100, 85, 5, 88, 106, 86, 84, 20, 149, 51, 41, - 81, 83, 214, 98, 213, 10, 24, 50, 53, 236, 98, 212, 135, 44, 174, 235, 5, 143, 35, 12, 151, 159, 126, 55, 109, 28, - 231, 145, 47, 245, 105, 191, 143, 133, 1, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 65, 14, 128, 32, 12, 4, 65, 124, 80, 75, 91, 104, 111, 126, 69, 34, 252, + 255, 9, 106, 228, 64, 162, 55, 153, 164, 217, 158, 38, 155, 245, 238, 97, 189, 206, 187, 55, 161, 231, 214, 19, 254, + 129, 126, 162, 107, 25, 92, 4, 137, 185, 230, 88, 145, 112, 135, 104, 69, 5, 88, 74, 82, 84, 20, 149, 35, 42, 81, 85, + 214, 108, 197, 50, 24, 50, 85, 108, 98, 212, 186, 44, 204, 235, 5, 183, 99, 233, 46, 63, 252, 110, 216, 56, 184, 15, + 78, 146, 74, 173, 20, 141, 1, 0, 0, ]); export const initialWitnessMap: WitnessMap = new Map([ diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/complex_foreign_call.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/complex_foreign_call.ts index e074cf1ad38..722bae8e015 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/complex_foreign_call.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/complex_foreign_call.ts @@ -2,13 +2,13 @@ import { WitnessMap } from '@noir-lang/acvm_js'; // See `complex_brillig_foreign_call` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 84, 93, 10, 131, 48, 12, 78, 218, 233, 100, 111, 187, 193, 96, 59, 64, 231, 9, - 188, 139, 248, 166, 232, 163, 167, 23, 11, 126, 197, 24, 250, 34, 86, 208, 64, 72, 218, 252, 125, 36, 105, 153, 22, - 42, 60, 51, 116, 235, 217, 64, 103, 156, 37, 5, 191, 10, 210, 29, 163, 63, 167, 203, 229, 206, 194, 104, 110, 128, - 209, 158, 128, 49, 236, 195, 69, 231, 157, 114, 46, 73, 251, 103, 35, 239, 231, 225, 57, 243, 156, 227, 252, 132, 44, - 112, 79, 176, 125, 84, 223, 73, 248, 145, 152, 69, 149, 4, 107, 233, 114, 90, 119, 145, 85, 237, 151, 192, 89, 247, - 221, 208, 54, 163, 85, 174, 26, 234, 87, 232, 63, 101, 103, 21, 55, 169, 216, 73, 72, 249, 5, 197, 234, 132, 123, 179, - 35, 247, 155, 214, 246, 102, 20, 73, 204, 72, 168, 123, 191, 161, 25, 66, 136, 159, 187, 53, 5, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 84, 75, 10, 132, 48, 12, 77, 218, 209, 145, 217, 205, 13, 6, 198, 3, 84, 79, + 224, 93, 196, 157, 162, 75, 79, 47, 22, 124, 197, 16, 186, 17, 43, 104, 32, 36, 109, 126, 143, 36, 45, 211, 70, 133, + 103, 134, 110, 61, 27, 232, 140, 179, 164, 224, 215, 64, 186, 115, 84, 113, 186, 92, 238, 42, 140, 230, 1, 24, 237, 5, + 24, 195, 62, 220, 116, 222, 41, 231, 146, 180, 127, 54, 242, 126, 94, 158, 51, 207, 57, 206, 111, 200, 2, 247, 4, 219, + 79, 245, 157, 132, 31, 137, 89, 52, 73, 176, 214, 46, 167, 125, 23, 89, 213, 254, 8, 156, 237, 56, 76, 125, 55, 91, + 229, 170, 161, 254, 133, 94, 42, 59, 171, 184, 69, 197, 46, 66, 202, 47, 40, 86, 39, 220, 155, 3, 185, 191, 180, 183, + 55, 163, 72, 98, 70, 66, 221, 251, 40, 173, 255, 35, 68, 62, 61, 5, 0, 0, ]); export const initialWitnessMap: WitnessMap = new Map([ [1, '0x0000000000000000000000000000000000000000000000000000000000000001'], diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/fixed_base_scalar_mul.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/fixed_base_scalar_mul.ts index 5aef521f231..97b5041121a 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/fixed_base_scalar_mul.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/fixed_base_scalar_mul.ts @@ -1,8 +1,8 @@ // See `fixed_base_scalar_mul_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 77, 138, 81, 10, 0, 48, 8, 66, 87, 219, 190, 118, 233, 29, 61, 43, 3, 5, 121, 34, - 207, 86, 231, 162, 198, 157, 124, 228, 71, 157, 220, 232, 161, 227, 226, 206, 214, 95, 221, 74, 0, 116, 58, 13, 182, - 105, 0, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 138, 81, 10, 0, 48, 8, 66, 87, 219, 190, 118, 233, 29, 61, 35, 3, 19, 228, 137, + 60, 91, 149, 139, 26, 119, 242, 145, 31, 117, 114, 163, 135, 142, 139, 219, 91, 127, 117, 71, 2, 117, 84, 50, 98, 113, + 0, 0, 0, ]); export const initialWitnessMap = new Map([ [1, '0x0000000000000000000000000000000000000000000000000000000000000001'], diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/foreign_call.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/foreign_call.ts index eb14cb2e9f1..0e3d77f62a9 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/foreign_call.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/foreign_call.ts @@ -2,10 +2,10 @@ import { WitnessMap } from '@noir-lang/acvm_js'; // See `simple_brillig_foreign_call` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 61, 10, 192, 48, 8, 133, 53, 133, 82, 186, 245, 38, 233, 13, 122, 153, - 14, 93, 58, 132, 144, 227, 135, 252, 41, 56, 36, 46, 201, 7, 162, 168, 200, 123, 34, 52, 142, 28, 72, 245, 38, 106, 9, - 247, 30, 202, 118, 142, 27, 215, 221, 178, 82, 175, 33, 15, 133, 189, 163, 159, 57, 197, 252, 251, 195, 235, 188, 230, - 186, 16, 65, 255, 12, 239, 92, 131, 89, 149, 198, 77, 3, 10, 9, 119, 8, 198, 242, 152, 1, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 173, 144, 61, 10, 192, 32, 12, 133, 19, 11, 165, 116, 235, 77, 236, 13, 122, 153, + 14, 93, 58, 136, 120, 124, 241, 47, 129, 12, 42, 130, 126, 16, 18, 146, 16, 222, 11, 66, 225, 136, 129, 84, 111, 162, + 150, 112, 239, 161, 172, 231, 184, 113, 221, 45, 45, 245, 42, 242, 144, 216, 43, 250, 153, 83, 204, 191, 223, 189, + 198, 246, 92, 39, 60, 244, 63, 195, 59, 87, 99, 150, 165, 113, 83, 193, 0, 1, 19, 247, 29, 5, 160, 1, 0, 0, ]); export const initialWitnessMap: WitnessMap = new Map([ [1, '0x0000000000000000000000000000000000000000000000000000000000000005'], diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/memory_op.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/memory_op.ts index 1d0e06b3c8a..a69ae443259 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/memory_op.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/memory_op.ts @@ -1,9 +1,9 @@ // See `memory_op_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 81, 201, 13, 0, 32, 8, 147, 195, 125, 112, 3, 247, 159, 74, 141, 60, 106, 226, - 79, 120, 216, 132, 180, 124, 154, 82, 168, 108, 212, 57, 2, 122, 129, 157, 201, 181, 150, 59, 186, 179, 189, 161, 101, - 251, 82, 176, 175, 196, 121, 89, 118, 185, 246, 91, 185, 26, 125, 187, 64, 80, 134, 29, 195, 31, 79, 24, 2, 250, 167, - 252, 27, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 213, 81, 57, 14, 0, 32, 8, 147, 195, 255, 224, 15, 252, 255, 171, 212, 200, 208, + 129, 77, 24, 108, 66, 90, 150, 166, 20, 106, 23, 125, 143, 128, 62, 96, 103, 114, 173, 45, 198, 116, 182, 55, 140, + 106, 95, 74, 246, 149, 60, 47, 171, 46, 215, 126, 43, 87, 179, 111, 23, 8, 202, 176, 99, 248, 240, 9, 11, 137, 33, + 212, 110, 35, 3, 0, 0, ]); export const initialWitnessMap = new Map([ diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/nested_acir_call.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/nested_acir_call.ts index 1b745ab6a79..4b73d01bb01 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/nested_acir_call.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/nested_acir_call.ts @@ -2,13 +2,13 @@ import { WitnessMap, StackItem, WitnessStack } from '@noir-lang/acvm_js'; // See `nested_acir_call_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 205, 146, 97, 10, 195, 32, 12, 133, 163, 66, 207, 147, 24, 173, 241, 223, 174, 50, - 153, 189, 255, 17, 214, 177, 148, 89, 17, 250, 99, 14, 246, 224, 97, 144, 16, 146, 143, 231, 224, 45, 167, 126, 105, - 217, 109, 118, 91, 248, 200, 168, 225, 248, 191, 106, 114, 208, 233, 104, 188, 233, 139, 223, 137, 108, 51, 139, 113, - 13, 161, 38, 95, 137, 233, 142, 62, 23, 137, 24, 98, 89, 133, 132, 162, 196, 135, 23, 230, 42, 65, 82, 46, 57, 97, - 166, 192, 149, 182, 152, 121, 211, 97, 110, 222, 94, 8, 13, 132, 182, 54, 48, 144, 235, 8, 254, 10, 22, 76, 132, 101, - 231, 237, 229, 23, 189, 213, 54, 119, 15, 83, 212, 199, 172, 175, 79, 113, 51, 48, 198, 253, 207, 84, 13, 204, 141, - 224, 21, 176, 147, 158, 66, 231, 43, 145, 6, 4, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 205, 146, 65, 10, 3, 33, 12, 69, 163, 46, 230, 58, 137, 209, 49, 238, 122, 149, 74, + 157, 251, 31, 161, 83, 154, 161, 86, 132, 89, 212, 194, 124, 248, 24, 36, 132, 228, 241, 29, 188, 229, 212, 47, 45, + 187, 205, 110, 11, 31, 25, 53, 28, 255, 103, 77, 14, 58, 29, 141, 55, 125, 241, 55, 145, 109, 102, 49, 174, 33, 212, + 228, 43, 49, 221, 209, 231, 34, 17, 67, 44, 171, 144, 80, 148, 248, 240, 194, 92, 37, 72, 202, 37, 39, 204, 20, 184, + 210, 22, 51, 111, 58, 204, 205, 219, 11, 161, 129, 208, 214, 6, 6, 114, 29, 193, 127, 193, 130, 137, 176, 236, 188, + 189, 252, 162, 183, 218, 230, 238, 97, 138, 250, 152, 245, 245, 87, 220, 12, 140, 113, 95, 153, 170, 129, 185, 17, 60, + 3, 54, 212, 19, 104, 145, 195, 151, 14, 4, 0, 0, ]); export const initialWitnessMap: WitnessMap = new Map([ diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/pedersen.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/pedersen.ts index 00d207053d8..e8ddc893d87 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/pedersen.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/pedersen.ts @@ -1,7 +1,7 @@ // See `pedersen_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 93, 74, 7, 6, 0, 0, 8, 108, 209, 255, 63, 156, 54, 233, 56, 55, 17, 26, 18, 196, - 241, 169, 250, 178, 141, 167, 32, 159, 254, 234, 238, 255, 87, 112, 52, 63, 63, 101, 105, 0, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 93, 74, 9, 10, 0, 0, 4, 115, 149, 255, 127, 88, 8, 133, 213, 218, 137, 80, 144, 32, + 182, 79, 213, 151, 173, 61, 5, 121, 245, 91, 103, 255, 191, 3, 7, 16, 26, 112, 158, 113, 0, 0, 0, ]); export const initialWitnessMap = new Map([[1, '0x0000000000000000000000000000000000000000000000000000000000000001']]); diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts index 14c32c615c8..0aef82bc8e9 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts @@ -1,17 +1,17 @@ // See `schnorr_verify_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 77, 210, 7, 78, 2, 1, 20, 69, 81, 236, 189, 247, 222, 123, 239, 93, 177, 33, 34, - 238, 194, 253, 47, 193, 200, 147, 67, 194, 36, 147, 163, 33, 33, 228, 191, 219, 82, 168, 63, 63, 181, 183, 197, 223, - 177, 147, 191, 181, 183, 149, 69, 159, 183, 213, 222, 238, 218, 219, 206, 14, 118, 178, 139, 141, 183, 135, 189, 236, - 99, 63, 7, 56, 200, 33, 14, 115, 132, 163, 28, 227, 56, 39, 56, 201, 41, 78, 115, 134, 179, 156, 227, 60, 23, 184, - 200, 37, 46, 115, 133, 171, 92, 227, 58, 55, 184, 201, 45, 110, 115, 135, 187, 220, 227, 62, 15, 120, 200, 35, 30, - 243, 132, 167, 60, 227, 57, 47, 120, 201, 43, 94, 243, 134, 183, 188, 227, 61, 31, 248, 200, 39, 22, 249, 204, 151, - 166, 29, 243, 188, 250, 255, 141, 239, 44, 241, 131, 101, 126, 178, 194, 47, 86, 249, 237, 123, 171, 76, 127, 105, 47, - 189, 165, 181, 116, 150, 198, 26, 125, 245, 248, 45, 233, 41, 45, 165, 163, 52, 148, 126, 210, 78, 186, 73, 51, 233, - 37, 173, 164, 147, 52, 146, 62, 210, 70, 186, 72, 19, 233, 33, 45, 164, 131, 52, 144, 253, 151, 11, 245, 221, 179, - 121, 246, 206, 214, 217, 57, 27, 103, 223, 109, 187, 238, 218, 115, 223, 142, 135, 246, 59, 182, 219, 169, 189, 206, - 237, 116, 105, 159, 107, 187, 220, 218, 227, 222, 14, 143, 238, 95, 116, 247, 23, 119, 126, 115, 223, 146, 187, 150, - 221, 179, 226, 142, 141, 155, 53, 238, 86, 104, 186, 231, 255, 243, 7, 100, 141, 232, 192, 233, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 135, 74, 66, 1, 24, 134, 97, 219, 123, 239, 189, 247, 222, 187, 108, 153, + 153, 221, 69, 247, 127, 9, 145, 31, 62, 130, 29, 56, 60, 133, 32, 242, 127, 111, 75, 161, 254, 252, 212, 222, 22, 127, + 199, 78, 254, 214, 222, 86, 22, 125, 222, 86, 123, 187, 107, 111, 59, 59, 216, 201, 46, 54, 222, 30, 246, 178, 143, + 253, 28, 224, 32, 135, 56, 204, 17, 142, 114, 140, 227, 156, 224, 36, 167, 56, 205, 25, 206, 114, 142, 243, 92, 224, + 34, 151, 184, 204, 21, 174, 114, 141, 235, 220, 224, 38, 183, 184, 205, 29, 238, 114, 143, 251, 60, 224, 33, 143, 120, + 204, 19, 158, 242, 140, 231, 188, 224, 37, 175, 120, 205, 27, 222, 242, 142, 247, 124, 224, 35, 159, 88, 228, 51, 95, + 154, 118, 204, 243, 234, 255, 55, 190, 179, 196, 15, 150, 249, 201, 10, 191, 88, 229, 183, 239, 173, 50, 253, 165, + 189, 244, 150, 214, 210, 89, 26, 107, 244, 213, 227, 183, 164, 167, 180, 148, 142, 210, 80, 250, 73, 59, 233, 38, 205, + 164, 151, 180, 146, 78, 210, 72, 250, 72, 27, 233, 34, 77, 164, 135, 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, + 207, 230, 217, 59, 91, 103, 231, 108, 156, 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, + 58, 183, 211, 165, 125, 174, 237, 114, 107, 143, 123, 59, 60, 186, 127, 209, 221, 95, 220, 249, 205, 125, 75, 238, 90, + 118, 207, 138, 59, 54, 110, 214, 184, 91, 161, 233, 158, 255, 158, 63, 46, 139, 64, 203, 241, 3, 0, 0, ]); export const initialWitnessMap = new Map([ diff --git a/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs b/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs index f6beeeb09d9..e2e5471a671 100644 --- a/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs +++ b/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs @@ -59,7 +59,7 @@ mod tests { assert_messages: Default::default(), recursive: false, }; - let program = Program { functions: vec![circuit] }; + let program = Program { functions: vec![circuit], unconstrained_functions: Vec::new() }; let contract = get_mock_backend()?.eth_contract(&program)?; diff --git a/noir/noir-repo/tooling/nargo_cli/src/cli/info_cmd.rs b/noir/noir-repo/tooling/nargo_cli/src/cli/info_cmd.rs index 72784013e17..e9609687ffb 100644 --- a/noir/noir-repo/tooling/nargo_cli/src/cli/info_cmd.rs +++ b/noir/noir-repo/tooling/nargo_cli/src/cli/info_cmd.rs @@ -289,8 +289,11 @@ fn count_opcodes_and_gates_in_program( Ok(FunctionInfo { name: compiled_program.names[i].clone(), acir_opcodes: function.opcodes.len(), - circuit_size: backend - .get_exact_circuit_size(&Program { functions: vec![function] })?, + // Unconstrained functions do not matter to a backend circuit count so we pass nothing here + circuit_size: backend.get_exact_circuit_size(&Program { + functions: vec![function], + unconstrained_functions: Vec::new(), + })?, }) }) .collect::>()?; diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index 253c792aab9..34818ffb7d8 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,7 +68,7 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x1df42e0457430b8d294d920181cc72ae0e3c5f8afd8d62d461bd26773cfdf3c1n; +export const DEPLOYER_CONTRACT_ADDRESS = 0x1d144e236f9df5ca2e46d274585f322f16502b33a91cd24bce24c93b73dde3c5n; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; From 37daac6a4547d70d06714e1cd727eddbe297cf64 Mon Sep 17 00:00:00 2001 From: ludamad Date: Mon, 15 Apr 2024 21:06:01 -0400 Subject: [PATCH 10/56] fix(ci): 192 core spot runner (#5767) The cpp parts really churn. Buy time for better solution with compute --- .github/workflows/ci.yml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 68c34bf6a12..a6a94add225 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -24,7 +24,7 @@ jobs: ebs_cache_size_gb: 256 runner_concurrency: 50 subaction: ${{ github.event.inputs.runner_action || 'start' }} - ec2_instance_type: m6a.32xlarge + ec2_instance_type: m6a.48xlarge ec2_ami_id: ami-04d8422a9ba4de80f ec2_instance_ttl: 40 # refreshed by jobs secrets: inherit @@ -143,3 +143,9 @@ jobs: working-directory: ./barretenberg/cpp/ timeout-minutes: 15 run: earthly --no-output +bench-ultra-honk --bench_mode=cache + + merge-check: + runs-on: ${{ github.actor }}-x86 + needs: [e2e, bb-native-tests, bb-bench] + steps: + - run: echo Pull request merging now allowed. From c0b7e3b43bddc5ed02e6fbd8d48da250d846e7c5 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 16 Apr 2024 02:08:37 +0000 Subject: [PATCH 11/56] git subrepo push --branch=master barretenberg subrepo: subdir: "barretenberg" merged: "b2e6d246e" upstream: origin: "https://github.com/AztecProtocol/barretenberg" branch: "master" commit: "b2e6d246e" git-subrepo: version: "0.4.6" origin: "???" commit: "???" [skip ci] --- barretenberg/.gitrepo | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/barretenberg/.gitrepo b/barretenberg/.gitrepo index 063f1708538..27488d86f2f 100644 --- a/barretenberg/.gitrepo +++ b/barretenberg/.gitrepo @@ -6,7 +6,7 @@ [subrepo] remote = https://github.com/AztecProtocol/barretenberg branch = master - commit = eca2641c091cb50d32b41acb02e0826d3c71ca96 - parent = 66fc89f417d0582865acdb04a75258a4a449c8b6 + commit = b2e6d246e25276e190c3ae8f6895d31f843d498a + parent = 37daac6a4547d70d06714e1cd727eddbe297cf64 method = merge cmdver = 0.4.6 From fb2b298066bbf0fa15e5a39fa7e48cb288e50182 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 16 Apr 2024 02:09:03 +0000 Subject: [PATCH 12/56] chore: replace relative paths to noir-protocol-circuits --- noir-projects/aztec-nr/aztec/Nargo.toml | 2 +- noir-projects/aztec-nr/tests/Nargo.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/noir-projects/aztec-nr/aztec/Nargo.toml b/noir-projects/aztec-nr/aztec/Nargo.toml index 7a1f1af5863..e1b87c53e5c 100644 --- a/noir-projects/aztec-nr/aztec/Nargo.toml +++ b/noir-projects/aztec-nr/aztec/Nargo.toml @@ -5,4 +5,4 @@ compiler_version = ">=0.18.0" type = "lib" [dependencies] -protocol_types = { path = "../../noir-protocol-circuits/crates/types" } +protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.34.0", directory="noir-projects/noir-protocol-circuits/crates/types" } diff --git a/noir-projects/aztec-nr/tests/Nargo.toml b/noir-projects/aztec-nr/tests/Nargo.toml index 13404b37324..163d817692b 100644 --- a/noir-projects/aztec-nr/tests/Nargo.toml +++ b/noir-projects/aztec-nr/tests/Nargo.toml @@ -6,4 +6,4 @@ type = "lib" [dependencies] aztec = { path = "../aztec" } -protocol_types = { path = "../../noir-protocol-circuits/crates/types" } +protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.34.0", directory="noir-projects/noir-protocol-circuits/crates/types" } From c3a9085ed3e0e7cc97d7b36a24bbc71fb5846786 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 16 Apr 2024 02:09:03 +0000 Subject: [PATCH 13/56] git_subrepo.sh: Fix parent in .gitrepo file. [skip ci] --- noir-projects/aztec-nr/.gitrepo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/noir-projects/aztec-nr/.gitrepo b/noir-projects/aztec-nr/.gitrepo index 387fc564aa0..412bce0480f 100644 --- a/noir-projects/aztec-nr/.gitrepo +++ b/noir-projects/aztec-nr/.gitrepo @@ -9,4 +9,4 @@ commit = b127ade0fd8ca26319751e1c597a24761dc3c6a0 method = merge cmdver = 0.4.6 - parent = aefe3b36f3b1e3f0d936942a7dd4ab140f6d26b0 + parent = 37ad569ecd212103d58d911ee94be20702a9596c From 48389d3fd554f506973837b36dd9c693e59683a9 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Tue, 16 Apr 2024 02:09:07 +0000 Subject: [PATCH 14/56] git subrepo push --branch=master noir-projects/aztec-nr subrepo: subdir: "noir-projects/aztec-nr" merged: "28ec9ab7a" upstream: origin: "https://github.com/AztecProtocol/aztec-nr" branch: "master" commit: "28ec9ab7a" git-subrepo: version: "0.4.6" origin: "???" commit: "???" [skip ci] --- noir-projects/aztec-nr/.gitrepo | 4 ++-- noir-projects/aztec-nr/aztec/Nargo.toml | 2 +- noir-projects/aztec-nr/tests/Nargo.toml | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/noir-projects/aztec-nr/.gitrepo b/noir-projects/aztec-nr/.gitrepo index 412bce0480f..8e79a269c16 100644 --- a/noir-projects/aztec-nr/.gitrepo +++ b/noir-projects/aztec-nr/.gitrepo @@ -6,7 +6,7 @@ [subrepo] remote = https://github.com/AztecProtocol/aztec-nr branch = master - commit = b127ade0fd8ca26319751e1c597a24761dc3c6a0 + commit = 28ec9ab7a3430095c0b615ef097362c9860dac3e method = merge cmdver = 0.4.6 - parent = 37ad569ecd212103d58d911ee94be20702a9596c + parent = a51c725ab39fc2fe436e1be0d19c37866c7caa2e diff --git a/noir-projects/aztec-nr/aztec/Nargo.toml b/noir-projects/aztec-nr/aztec/Nargo.toml index e1b87c53e5c..7a1f1af5863 100644 --- a/noir-projects/aztec-nr/aztec/Nargo.toml +++ b/noir-projects/aztec-nr/aztec/Nargo.toml @@ -5,4 +5,4 @@ compiler_version = ">=0.18.0" type = "lib" [dependencies] -protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.34.0", directory="noir-projects/noir-protocol-circuits/crates/types" } +protocol_types = { path = "../../noir-protocol-circuits/crates/types" } diff --git a/noir-projects/aztec-nr/tests/Nargo.toml b/noir-projects/aztec-nr/tests/Nargo.toml index 163d817692b..13404b37324 100644 --- a/noir-projects/aztec-nr/tests/Nargo.toml +++ b/noir-projects/aztec-nr/tests/Nargo.toml @@ -6,4 +6,4 @@ type = "lib" [dependencies] aztec = { path = "../aztec" } -protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.34.0", directory="noir-projects/noir-protocol-circuits/crates/types" } +protocol_types = { path = "../../noir-protocol-circuits/crates/types" } From af49a290722c3430ad26a458cfb489b8b4ea7604 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jan=20Bene=C5=A1?= Date: Tue, 16 Apr 2024 08:09:52 +0200 Subject: [PATCH 15/56] feat: impl of missing functionality in new key store (#5750) --- .../noir_js_backend_barretenberg/package.json | 2 +- .../circuit-types/src/keys/new_key_store.ts | 24 +++++++++- .../key-store/src/new_test_key_store.test.ts | 12 +++++ .../key-store/src/new_test_key_store.ts | 47 ++++++++++++++++++- 4 files changed, 82 insertions(+), 3 deletions(-) diff --git a/noir/noir-repo/tooling/noir_js_backend_barretenberg/package.json b/noir/noir-repo/tooling/noir_js_backend_barretenberg/package.json index fefd2f6f8d9..438e91ff302 100644 --- a/noir/noir-repo/tooling/noir_js_backend_barretenberg/package.json +++ b/noir/noir-repo/tooling/noir_js_backend_barretenberg/package.json @@ -57,4 +57,4 @@ "ts-node": "^10.9.1", "typescript": "5.4.2" } -} \ No newline at end of file +} diff --git a/yarn-project/circuit-types/src/keys/new_key_store.ts b/yarn-project/circuit-types/src/keys/new_key_store.ts index 10eddd49561..8f586feb9c3 100644 --- a/yarn-project/circuit-types/src/keys/new_key_store.ts +++ b/yarn-project/circuit-types/src/keys/new_key_store.ts @@ -1,4 +1,10 @@ -import { type AztecAddress, type Fr, type PartialAddress, type PublicKey } from '@aztec/circuits.js'; +import { + type AztecAddress, + type Fr, + type GrumpkinPrivateKey, + type PartialAddress, + type PublicKey, +} from '@aztec/circuits.js'; /** * Represents a secure storage for managing keys. @@ -18,6 +24,12 @@ export interface NewKeyStore { */ addAccount(sk: Fr, partialAddress: PartialAddress): Promise; + /** + * Retrieves addresses of accounts stored in the key store. + * @returns A Promise that resolves to an array of account addresses. + */ + getAccounts(): Promise; + /** * Gets the master nullifier public key for a given account. * @throws If the account does not exist in the key store. @@ -76,4 +88,14 @@ export interface NewKeyStore { * @returns A Promise that resolves to the application outgoing viewing secret key. */ getAppOutgoingViewingSecretKey(account: AztecAddress, app: AztecAddress): Promise; + + /** + * Retrieves the master nullifier secret key (nsk_m) corresponding to the specified master nullifier public key + * (Npk_m). + * @throws If the provided public key is not associated with any of the registered accounts. + * @param masterNullifierPublicKey - The master nullifier public key to get secret key for. + * @returns A Promise that resolves to the master nullifier secret key. + * @dev Used when feeding the master nullifier secret key to the kernel circuit for nullifier keys verification. + */ + getMasterNullifierSecretKeyForPublicKey(masterNullifierPublicKey: PublicKey): Promise; } diff --git a/yarn-project/key-store/src/new_test_key_store.test.ts b/yarn-project/key-store/src/new_test_key_store.test.ts index 7e56a873ac8..c67347242a8 100644 --- a/yarn-project/key-store/src/new_test_key_store.test.ts +++ b/yarn-project/key-store/src/new_test_key_store.test.ts @@ -55,5 +55,17 @@ describe('NewTestKeyStore', () => { expect(appOutgoingViewingSecretKey.toString()).toMatchInlineSnapshot( `"0x2639b26510f9d30b7e173d301b263b246b7a576186be1f44cd7c86bc06773f8a"`, ); + + // Returned accounts are as expected + const accounts = await keyStore.getAccounts(); + expect(accounts.toString()).toMatchInlineSnapshot( + `"0x0ba7834252d19c4f09d29303c269f303f40ae3d2043f921ed0bf8c0709926d4e"`, + ); + + // Manages to find master nullifer secret key for pub key + const masterNullifierSecretKey = await keyStore.getMasterNullifierSecretKeyForPublicKey(masterNullifierPublicKey); + expect(masterNullifierSecretKey.toString()).toMatchInlineSnapshot( + `"0x0fde74d5e504c73b58aad420dd72590fc6004571411e7f77c45378714195a52b"`, + ); }); }); diff --git a/yarn-project/key-store/src/new_test_key_store.ts b/yarn-project/key-store/src/new_test_key_store.ts index c5ff22030e7..23d2028c495 100644 --- a/yarn-project/key-store/src/new_test_key_store.ts +++ b/yarn-project/key-store/src/new_test_key_store.ts @@ -1,5 +1,13 @@ import { type NewKeyStore, type PublicKey } from '@aztec/circuit-types'; -import { AztecAddress, Fr, GeneratorIndex, GrumpkinScalar, type PartialAddress, Point } from '@aztec/circuits.js'; +import { + AztecAddress, + Fr, + GeneratorIndex, + type GrumpkinPrivateKey, + GrumpkinScalar, + type PartialAddress, + Point, +} from '@aztec/circuits.js'; import { type Grumpkin } from '@aztec/circuits.js/barretenberg'; import { poseidon2Hash, sha512ToGrumpkinScalar } from '@aztec/foundation/crypto'; import { type AztecKVStore, type AztecMap } from '@aztec/kv-store'; @@ -75,6 +83,17 @@ export class NewTestKeyStore implements NewKeyStore { return Promise.resolve(accountAddress); } + /** + * Retrieves addresses of accounts stored in the key store. + * @returns A Promise that resolves to an array of account addresses. + */ + public getAccounts(): Promise { + const allMapKeys = Array.from(this.#keys.keys()); + // We return account addresses based on the map keys that end with '-nsk_m' + const accounts = allMapKeys.filter(key => key.endsWith('-nsk_m')).map(key => key.split('-')[0]); + return Promise.resolve(accounts.map(account => AztecAddress.fromString(account))); + } + /** * Gets the master nullifier public key for a given account. * @throws If the account does not exist in the key store. @@ -197,4 +216,30 @@ export class NewTestKeyStore implements NewKeyStore { ]), ); } + + /** + * Retrieves the master nullifier secret key (nsk_m) corresponding to the specified master nullifier public key + * (Npk_m). + * @throws If the provided public key is not associated with any of the registered accounts. + * @param masterNullifierPublicKey - The master nullifier public key to get secret key for. + * @returns A Promise that resolves to the master nullifier secret key. + * @dev Used when feeding the master nullifier secret key to the kernel circuit for nullifier keys verification. + */ + public getMasterNullifierSecretKeyForPublicKey(masterNullifierPublicKey: PublicKey): Promise { + // We iterate over the map keys to find the account address that corresponds to the provided public key + for (const [key, value] of this.#keys.entries()) { + if (value.equals(masterNullifierPublicKey.toBuffer())) { + // We extract the account address from the map key + const accountAddress = key.split('-')[0]; + // We fetch the secret key and return it + const masterNullifierSecretKeyBuffer = this.#keys.get(`${accountAddress.toString()}-nsk_m`); + if (!masterNullifierSecretKeyBuffer) { + throw new Error(`Could not find master nullifier secret key for account ${accountAddress.toString()}`); + } + return Promise.resolve(GrumpkinScalar.fromBuffer(masterNullifierSecretKeyBuffer)); + } + } + + throw new Error(`Could not find master nullifier secret key for public key ${masterNullifierPublicKey.toString()}`); + } } From f84957584ff76c22c069903f7648735a0be91d7f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Rodr=C3=ADguez?= Date: Tue, 16 Apr 2024 09:55:44 +0200 Subject: [PATCH 16/56] feat!: trap with revert data (#5732) This PR adds revert data for user-defined messages in the TRAP opcode. Not all messages are returned as revert data, since compiler intrinsic messages are spammed all over SSA and codegening revert data for all those makes brillig function size blow up and impacts performance in a hard way due to deserializing load. This is currently only for static assert messages, since dynamic ones are implemented as an oracle and probably need a rework to be able to return them as revert data. --------- Co-authored-by: Maxim Vezenov --- avm-transpiler/src/transpile.rs | 122 +++++++++++++----- .../dsl/acir_format/serde/acir.hpp | 16 ++- .../developers/debugging/aztecnr-errors.md | 2 +- .../src/core/libraries/ConstantsGen.sol | 2 +- .../crates/types/src/constants.nr | 2 +- .../noir-repo/acvm-repo/acir/codegen/acir.cpp | 9 ++ .../acvm-repo/acvm/src/pwg/brillig.rs | 28 +++- noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs | 4 +- noir/noir-repo/acvm-repo/acvm/tests/solver.rs | 4 +- .../acvm-repo/acvm_js/src/execute.rs | 10 +- .../acvm-repo/brillig/src/opcodes.rs | 7 +- .../noir-repo/acvm-repo/brillig_vm/src/lib.rs | 37 +++++- .../src/brillig/brillig_gen/brillig_block.rs | 39 +++--- .../noirc_evaluator/src/brillig/brillig_ir.rs | 2 +- .../brillig_ir/codegen_control_flow.rs | 44 +++++++ .../src/brillig/brillig_ir/debug_show.rs | 12 +- .../src/brillig/brillig_ir/instructions.rs | 29 +---- .../noirc_evaluator/src/ssa/acir_gen/mod.rs | 11 +- .../noirc_evaluator/src/ssa/ir/instruction.rs | 21 ++- .../noirc_evaluator/src/ssa/ir/printer.rs | 10 +- .../src/ssa/opt/defunctionalize.rs | 17 +-- .../noirc_evaluator/src/ssa/ssa_gen/mod.rs | 10 +- noir/noir-repo/tooling/nargo/src/errors.rs | 4 +- .../tooling/nargo/src/ops/execute.rs | 10 +- yarn-project/circuits.js/src/constants.gen.ts | 2 +- .../src/e2e_dapp_subscription.test.ts | 2 +- .../reading_constants.test.ts | 4 +- 27 files changed, 336 insertions(+), 124 deletions(-) diff --git a/avm-transpiler/src/transpile.rs b/avm-transpiler/src/transpile.rs index 8eca95879ae..91345424a3c 100644 --- a/avm-transpiler/src/transpile.rs +++ b/avm-transpiler/src/transpile.rs @@ -70,7 +70,11 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { lhs, rhs, } => { - assert!(is_integral_bit_size(*bit_size), "BinaryIntOp bit size should be integral: {:?}", brillig_instr); + assert!( + is_integral_bit_size(*bit_size), + "BinaryIntOp bit size should be integral: {:?}", + brillig_instr + ); let avm_opcode = match op { BinaryIntOp::Add => AvmOpcode::ADD, BinaryIntOp::Sub => AvmOpcode::SUB, @@ -102,20 +106,27 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { ], }); } - BrilligOpcode::CalldataCopy { destination_address, size, offset } => { + BrilligOpcode::CalldataCopy { + destination_address, + size, + offset, + } => { avm_instrs.push(AvmInstruction { opcode: AvmOpcode::CALLDATACOPY, indirect: Some(ALL_DIRECT), operands: vec![ AvmOperand::U32 { value: *offset as u32, // cdOffset (calldata offset) - }, AvmOperand::U32 { + }, + AvmOperand::U32 { value: *size as u32, - }, AvmOperand::U32 { + }, + AvmOperand::U32 { value: destination_address.to_usize() as u32, // dstOffset - }], - ..Default::default() - }); + }, + ], + ..Default::default() + }); } BrilligOpcode::Jump { location } => { let avm_loc = brillig_pcs_to_avm_pcs[*location]; @@ -146,14 +157,22 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { ..Default::default() }); } - BrilligOpcode::Const { destination, value, bit_size } => { + BrilligOpcode::Const { + destination, + value, + bit_size, + } => { handle_const(&mut avm_instrs, destination, value, bit_size); } BrilligOpcode::Mov { destination, source, } => { - avm_instrs.push(generate_mov_instruction(Some(ALL_DIRECT), source.to_usize() as u32, destination.to_usize() as u32)); + avm_instrs.push(generate_mov_instruction( + Some(ALL_DIRECT), + source.to_usize() as u32, + destination.to_usize() as u32, + )); } BrilligOpcode::ConditionalMov { source_a, @@ -165,10 +184,18 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { opcode: AvmOpcode::CMOV, indirect: Some(ALL_DIRECT), operands: vec![ - AvmOperand::U32 { value: source_a.to_usize() as u32 }, - AvmOperand::U32 { value: source_b.to_usize() as u32 }, - AvmOperand::U32 { value: condition.to_usize() as u32 }, - AvmOperand::U32 { value: destination.to_usize() as u32 }, + AvmOperand::U32 { + value: source_a.to_usize() as u32, + }, + AvmOperand::U32 { + value: source_b.to_usize() as u32, + }, + AvmOperand::U32 { + value: condition.to_usize() as u32, + }, + AvmOperand::U32 { + value: destination.to_usize() as u32, + }, ], ..Default::default() }); @@ -177,13 +204,21 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { destination, source_pointer, } => { - avm_instrs.push(generate_mov_instruction(Some(ZEROTH_OPERAND_INDIRECT), source_pointer.to_usize() as u32, destination.to_usize() as u32)); + avm_instrs.push(generate_mov_instruction( + Some(ZEROTH_OPERAND_INDIRECT), + source_pointer.to_usize() as u32, + destination.to_usize() as u32, + )); } BrilligOpcode::Store { destination_pointer, source, } => { - avm_instrs.push(generate_mov_instruction(Some(FIRST_OPERAND_INDIRECT), source.to_usize() as u32, destination_pointer.to_usize() as u32)); + avm_instrs.push(generate_mov_instruction( + Some(FIRST_OPERAND_INDIRECT), + source.to_usize() as u32, + destination_pointer.to_usize() as u32, + )); } BrilligOpcode::Call { location } => { let avm_loc = brillig_pcs_to_avm_pcs[*location]; @@ -199,38 +234,65 @@ pub fn brillig_to_avm(brillig: &Brillig) -> Vec { opcode: AvmOpcode::INTERNALRETURN, ..Default::default() }), - BrilligOpcode::Stop { return_data_offset, return_data_size } => { + BrilligOpcode::Stop { + return_data_offset, + return_data_size, + } => { avm_instrs.push(AvmInstruction { opcode: AvmOpcode::RETURN, indirect: Some(ALL_DIRECT), operands: vec![ - AvmOperand::U32 { value: *return_data_offset as u32 }, - AvmOperand::U32 { value: *return_data_size as u32 }, + AvmOperand::U32 { + value: *return_data_offset as u32, + }, + AvmOperand::U32 { + value: *return_data_size as u32, + }, ], ..Default::default() }); } - BrilligOpcode::Trap { /*return_data_offset, return_data_size*/ } => { - // TODO(https://github.com/noir-lang/noir/issues/3113): Trap should support return data + BrilligOpcode::Trap { + revert_data_offset, + revert_data_size, + } => { avm_instrs.push(AvmInstruction { opcode: AvmOpcode::REVERT, indirect: Some(ALL_DIRECT), operands: vec![ - //AvmOperand::U32 { value: *return_data_offset as u32}, - //AvmOperand::U32 { value: *return_data_size as u32}, - AvmOperand::U32 { value: 0 }, - AvmOperand::U32 { value: 0 }, + AvmOperand::U32 { + value: *revert_data_offset as u32, + }, + AvmOperand::U32 { + value: *revert_data_size as u32, + }, ], ..Default::default() }); - }, - BrilligOpcode::Cast { destination, source, bit_size } => { - avm_instrs.push(generate_cast_instruction(source.to_usize() as u32, destination.to_usize() as u32, tag_from_bit_size(*bit_size))); } - BrilligOpcode::ForeignCall { function, destinations, inputs, destination_value_types:_, input_value_types:_ } => { + BrilligOpcode::Cast { + destination, + source, + bit_size, + } => { + avm_instrs.push(generate_cast_instruction( + source.to_usize() as u32, + destination.to_usize() as u32, + tag_from_bit_size(*bit_size), + )); + } + BrilligOpcode::ForeignCall { + function, + destinations, + inputs, + destination_value_types: _, + input_value_types: _, + } => { handle_foreign_call(&mut avm_instrs, function, destinations, inputs); - }, - BrilligOpcode::BlackBox(operation) => handle_black_box_function(&mut avm_instrs, operation), + } + BrilligOpcode::BlackBox(operation) => { + handle_black_box_function(&mut avm_instrs, operation) + } _ => panic!( "Transpiler doesn't know how to process {:?} brillig instruction", brillig_instr diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp index c32172a9319..1711c1ed8f7 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp @@ -966,6 +966,9 @@ struct BrilligOpcode { }; struct Trap { + uint64_t revert_data_offset; + uint64_t revert_data_size; + friend bool operator==(const Trap&, const Trap&); std::vector bincodeSerialize() const; static Trap bincodeDeserialize(std::vector); @@ -6060,6 +6063,12 @@ namespace Program { inline bool operator==(const BrilligOpcode::Trap& lhs, const BrilligOpcode::Trap& rhs) { + if (!(lhs.revert_data_offset == rhs.revert_data_offset)) { + return false; + } + if (!(lhs.revert_data_size == rhs.revert_data_size)) { + return false; + } return true; } @@ -6086,7 +6095,10 @@ template <> template void serde::Serializable::serialize(const Program::BrilligOpcode::Trap& obj, Serializer& serializer) -{} +{ + serde::Serializable::serialize(obj.revert_data_offset, serializer); + serde::Serializable::serialize(obj.revert_data_size, serializer); +} template <> template @@ -6094,6 +6106,8 @@ Program::BrilligOpcode::Trap serde::Deserializable Deserializer& deserializer) { Program::BrilligOpcode::Trap obj; + obj.revert_data_offset = serde::Deserializable::deserialize(deserializer); + obj.revert_data_size = serde::Deserializable::deserialize(deserializer); return obj; } diff --git a/docs/docs/developers/debugging/aztecnr-errors.md b/docs/docs/developers/debugging/aztecnr-errors.md index 5d5fd8053a9..67b6496612d 100644 --- a/docs/docs/developers/debugging/aztecnr-errors.md +++ b/docs/docs/developers/debugging/aztecnr-errors.md @@ -67,7 +67,7 @@ This error occurs when your contract is trying to get a secret via the `get_secr This error might occur when you register an account only as a recipient and not as an account. To address the error, register the account by calling `server.registerAccount(...)`. -#### `Failed to solve brillig function, reason: explicit trap hit in brillig 'self._is_some` +#### `Failed to solve brillig function 'self._is_some` You may encounter this error when trying to send a transaction that is using an invalid contract. The contract may compile without errors and you only encounter this when sending the transaction. diff --git a/l1-contracts/src/core/libraries/ConstantsGen.sol b/l1-contracts/src/core/libraries/ConstantsGen.sol index ecc56722a51..b23000adb51 100644 --- a/l1-contracts/src/core/libraries/ConstantsGen.sol +++ b/l1-contracts/src/core/libraries/ConstantsGen.sol @@ -83,7 +83,7 @@ library Constants { uint256 internal constant DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; uint256 internal constant DEPLOYER_CONTRACT_ADDRESS = - 0x1df42e0457430b8d294d920181cc72ae0e3c5f8afd8d62d461bd26773cfdf3c1; + 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4; uint256 internal constant L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; uint256 internal constant MAX_NOTE_FIELDS_LENGTH = 20; uint256 internal constant GET_NOTE_ORACLE_RETURN_LENGTH = 23; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr index 63b35b38f27..a97ddbf9121 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr @@ -118,7 +118,7 @@ global REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af8166354 // CONTRACT INSTANCE CONSTANTS // sha224sum 'struct ContractInstanceDeployed' global DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; -global DEPLOYER_CONTRACT_ADDRESS = 0x1df42e0457430b8d294d920181cc72ae0e3c5f8afd8d62d461bd26773cfdf3c1; +global DEPLOYER_CONTRACT_ADDRESS = 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4; // NOIR CONSTANTS - constants used only in yarn-packages/noir-contracts // Some are defined here because Noir doesn't yet support globals referencing other globals yet. diff --git a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp index c5dd097110c..9e1011b2109 100644 --- a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp +++ b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp @@ -922,6 +922,9 @@ namespace Program { }; struct Trap { + uint64_t revert_data_offset; + uint64_t revert_data_size; + friend bool operator==(const Trap&, const Trap&); std::vector bincodeSerialize() const; static Trap bincodeDeserialize(std::vector); @@ -5014,6 +5017,8 @@ Program::BrilligOpcode::BlackBox serde::Deserializable template void serde::Serializable::serialize(const Program::BrilligOpcode::Trap &obj, Serializer &serializer) { + serde::Serializable::serialize(obj.revert_data_offset, serializer); + serde::Serializable::serialize(obj.revert_data_size, serializer); } template <> template Program::BrilligOpcode::Trap serde::Deserializable::deserialize(Deserializer &deserializer) { Program::BrilligOpcode::Trap obj; + obj.revert_data_offset = serde::Deserializable::deserialize(deserializer); + obj.revert_data_size = serde::Deserializable::deserialize(deserializer); return obj; } diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs index 81e752d5656..9982fa890c2 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs @@ -11,7 +11,7 @@ use acir::{ FieldElement, }; use acvm_blackbox_solver::BlackBoxFunctionSolver; -use brillig_vm::{MemoryValue, VMStatus, VM}; +use brillig_vm::{FailureReason, MemoryValue, VMStatus, VM}; use crate::{pwg::OpcodeNotSolvable, OpcodeResolutionError}; @@ -159,7 +159,31 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { match vm_status { VMStatus::Finished { .. } => Ok(BrilligSolverStatus::Finished), VMStatus::InProgress => Ok(BrilligSolverStatus::InProgress), - VMStatus::Failure { message, call_stack } => { + VMStatus::Failure { reason, call_stack } => { + let message = match reason { + FailureReason::RuntimeError { message } => Some(message), + FailureReason::Trap { revert_data_offset, revert_data_size } => { + // Since noir can only revert with strings currently, we can parse return data as a string + if revert_data_size == 0 { + None + } else { + let memory = self.vm.get_memory(); + let bytes = memory + [revert_data_offset..(revert_data_offset + revert_data_size)] + .iter() + .map(|memory_value| { + memory_value + .try_into() + .expect("Assert message character is not a byte") + }) + .collect(); + Some( + String::from_utf8(bytes) + .expect("Assert message is not valid UTF-8"), + ) + } + } + }; Err(OpcodeResolutionError::BrilligFunctionFailed { message, call_stack: call_stack diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs index fd00b16cb35..e7c009f87fa 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs @@ -122,8 +122,8 @@ pub enum OpcodeResolutionError { IndexOutOfBounds { opcode_location: ErrorLocation, index: u32, array_size: u32 }, #[error("Failed to solve blackbox function: {0}, reason: {1}")] BlackBoxFunctionFailed(BlackBoxFunc, String), - #[error("Failed to solve brillig function, reason: {message}")] - BrilligFunctionFailed { message: String, call_stack: Vec }, + #[error("Failed to solve brillig function{}", .message.as_ref().map(|m| format!(", reason: {}", m)).unwrap_or_default())] + BrilligFunctionFailed { message: Option, call_stack: Vec }, #[error("Attempted to call `main` with a `Call` opcode")] AcirMainCallAttempted { opcode_location: ErrorLocation }, #[error("{results_size:?} result values were provided for {outputs_size:?} call output witnesses, most likely due to bad ACIR codegen")] diff --git a/noir/noir-repo/acvm-repo/acvm/tests/solver.rs b/noir/noir-repo/acvm-repo/acvm/tests/solver.rs index a708db5b030..ec7a6467ff5 100644 --- a/noir/noir-repo/acvm-repo/acvm/tests/solver.rs +++ b/noir/noir-repo/acvm-repo/acvm/tests/solver.rs @@ -549,7 +549,7 @@ fn unsatisfied_opcode_resolved_brillig() { let jmp_if_opcode = BrilligOpcode::JumpIf { condition: MemoryAddress::from(2), location: location_of_stop }; - let trap_opcode = BrilligOpcode::Trap; + let trap_opcode = BrilligOpcode::Trap { revert_data_offset: 0, revert_data_size: 0 }; let stop_opcode = BrilligOpcode::Stop { return_data_offset: 0, return_data_size: 0 }; let brillig_opcode = Opcode::Brillig(Brillig { @@ -597,7 +597,7 @@ fn unsatisfied_opcode_resolved_brillig() { assert_eq!( solver_status, ACVMStatus::Failure(OpcodeResolutionError::BrilligFunctionFailed { - message: "explicit trap hit in brillig".to_string(), + message: None, call_stack: vec![OpcodeLocation::Brillig { acir_index: 0, brillig_index: 3 }] }), "The first opcode is not satisfiable, expected an error indicating this" diff --git a/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs b/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs index c97b8ea1a66..8bc56295992 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs +++ b/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs @@ -231,7 +231,7 @@ impl<'a, B: BlackBoxFunctionSolver> ProgramExecutor<'a, B> { unreachable!("Execution should not stop while in `InProgress` state.") } ACVMStatus::Failure(error) => { - let (assert_message, call_stack) = match &error { + let (assert_message, call_stack): (Option<&str>, _) = match &error { OpcodeResolutionError::UnsatisfiedConstrain { opcode_location: ErrorLocation::Resolved(opcode_location), } @@ -242,12 +242,16 @@ impl<'a, B: BlackBoxFunctionSolver> ProgramExecutor<'a, B> { circuit.get_assert_message(*opcode_location), Some(vec![*opcode_location]), ), - OpcodeResolutionError::BrilligFunctionFailed { call_stack, .. } => { + OpcodeResolutionError::BrilligFunctionFailed { + call_stack, + message, + } => { + let revert_message = message.as_ref().map(String::as_str); let failing_opcode = call_stack .last() .expect("Brillig error call stacks cannot be empty"); ( - circuit.get_assert_message(*failing_opcode), + revert_message.or(circuit.get_assert_message(*failing_opcode)), Some(call_stack.clone()), ) } diff --git a/noir/noir-repo/acvm-repo/brillig/src/opcodes.rs b/noir/noir-repo/acvm-repo/brillig/src/opcodes.rs index d1345351986..468fd88db45 100644 --- a/noir/noir-repo/acvm-repo/brillig/src/opcodes.rs +++ b/noir/noir-repo/acvm-repo/brillig/src/opcodes.rs @@ -177,8 +177,11 @@ pub enum BrilligOpcode { source: MemoryAddress, }, BlackBox(BlackBoxOp), - /// Used to denote execution failure - Trap, + /// Used to denote execution failure, returning data after the offset + Trap { + revert_data_offset: usize, + revert_data_size: usize, + }, /// Stop execution, returning data after the offset Stop { return_data_offset: usize, diff --git a/noir/noir-repo/acvm-repo/brillig_vm/src/lib.rs b/noir/noir-repo/acvm-repo/brillig_vm/src/lib.rs index 26d5da67576..d83870dc410 100644 --- a/noir/noir-repo/acvm-repo/brillig_vm/src/lib.rs +++ b/noir/noir-repo/acvm-repo/brillig_vm/src/lib.rs @@ -32,6 +32,12 @@ mod memory; /// The error call stack contains the opcode indexes of the call stack at the time of failure, plus the index of the opcode that failed. pub type ErrorCallStack = Vec; +#[derive(Debug, PartialEq, Eq, Clone)] +pub enum FailureReason { + Trap { revert_data_offset: usize, revert_data_size: usize }, + RuntimeError { message: String }, +} + #[derive(Debug, PartialEq, Eq, Clone)] pub enum VMStatus { Finished { @@ -40,7 +46,7 @@ pub enum VMStatus { }, InProgress, Failure { - message: String, + reason: FailureReason, call_stack: ErrorCallStack, }, /// The VM process is not solvable as a [foreign call][Opcode::ForeignCall] has been @@ -138,13 +144,28 @@ impl<'a, B: BlackBoxFunctionSolver> VM<'a, B> { self.status(VMStatus::InProgress); } + fn get_error_stack(&self) -> Vec { + let mut error_stack: Vec<_> = self.call_stack.clone(); + error_stack.push(self.program_counter); + error_stack + } + /// Sets the current status of the VM to `fail`. /// Indicating that the VM encountered a `Trap` Opcode /// or an invalid state. + fn trap(&mut self, revert_data_offset: usize, revert_data_size: usize) -> VMStatus { + self.status(VMStatus::Failure { + call_stack: self.get_error_stack(), + reason: FailureReason::Trap { revert_data_offset, revert_data_size }, + }); + self.status.clone() + } + fn fail(&mut self, message: String) -> VMStatus { - let mut error_stack: Vec<_> = self.call_stack.clone(); - error_stack.push(self.program_counter); - self.status(VMStatus::Failure { call_stack: error_stack, message }); + self.status(VMStatus::Failure { + call_stack: self.get_error_stack(), + reason: FailureReason::RuntimeError { message }, + }); self.status.clone() } @@ -281,7 +302,9 @@ impl<'a, B: BlackBoxFunctionSolver> VM<'a, B> { } self.increment_program_counter() } - Opcode::Trap => self.fail("explicit trap hit in brillig".to_string()), + Opcode::Trap { revert_data_offset, revert_data_size } => { + self.trap(*revert_data_offset, *revert_data_size) + } Opcode::Stop { return_data_offset, return_data_size } => { self.finish(*return_data_offset, *return_data_size) } @@ -684,7 +707,7 @@ mod tests { let jump_opcode = Opcode::Jump { location: 3 }; - let trap_opcode = Opcode::Trap; + let trap_opcode = Opcode::Trap { revert_data_offset: 0, revert_data_size: 0 }; let not_equal_cmp_opcode = Opcode::BinaryFieldOp { op: BinaryFieldOp::Equals, @@ -731,7 +754,7 @@ mod tests { assert_eq!( status, VMStatus::Failure { - message: "explicit trap hit in brillig".to_string(), + reason: FailureReason::Trap { revert_data_offset: 0, revert_data_size: 0 }, call_stack: vec![2] } ); diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs index cf2501ab1c0..369d8e78cda 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs @@ -5,7 +5,7 @@ use crate::brillig::brillig_ir::{ BrilligBinaryOp, BrilligContext, BRILLIG_MEMORY_ADDRESSING_BIT_SIZE, }; use crate::ssa::ir::dfg::CallStack; -use crate::ssa::ir::instruction::ConstrainError; +use crate::ssa::ir::instruction::{ConstrainError, UserDefinedConstrainError}; use crate::ssa::ir::{ basic_block::{BasicBlock, BasicBlockId}, dfg::DataFlowGraph, @@ -248,10 +248,15 @@ impl<'block> BrilligBlock<'block> { self.convert_ssa_binary(binary, dfg, result_var); } Instruction::Constrain(lhs, rhs, assert_message) => { - let assert_message = if let Some(error) = assert_message { + let (has_revert_data, static_assert_message) = if let Some(error) = assert_message { match error.as_ref() { - ConstrainError::Static(string) => Some(string.clone()), - ConstrainError::Dynamic(call_instruction) => { + ConstrainError::Intrinsic(string) => (false, Some(string.clone())), + ConstrainError::UserDefined(UserDefinedConstrainError::Static(string)) => { + (true, Some(string.clone())) + } + ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic( + call_instruction, + )) => { let Instruction::Call { func, arguments } = call_instruction else { unreachable!("expected a call instruction") }; @@ -264,11 +269,11 @@ impl<'block> BrilligBlock<'block> { // Dynamic assert messages are handled in the generated function call. // We then don't need to attach one to the constrain instruction. - None + (false, None) } } } else { - None + (false, None) }; let condition = SingleAddrVariable { @@ -281,8 +286,12 @@ impl<'block> BrilligBlock<'block> { dfg, condition, ); - - self.brillig_context.constrain_instruction(condition, assert_message); + if has_revert_data { + self.brillig_context + .codegen_constrain_with_revert_data(condition, static_assert_message); + } else { + self.brillig_context.codegen_constrain(condition, static_assert_message); + } self.brillig_context.deallocate_single_addr(condition); } Instruction::Allocate => { @@ -670,7 +679,7 @@ impl<'block> BrilligBlock<'block> { BrilligBinaryOp::LessThanEquals, ); - self.brillig_context.constrain_instruction(condition, assert_message.clone()); + self.brillig_context.codegen_constrain(condition, assert_message.clone()); self.brillig_context.deallocate_single_addr(condition); self.brillig_context.deallocate_single_addr(left); self.brillig_context.deallocate_single_addr(right); @@ -802,7 +811,7 @@ impl<'block> BrilligBlock<'block> { ); self.brillig_context - .constrain_instruction(condition, Some("Array index out of bounds".to_owned())); + .codegen_constrain(condition, Some("Array index out of bounds".to_owned())); if should_deallocate_size { self.brillig_context.deallocate_single_addr(size_as_register); @@ -1503,10 +1512,8 @@ impl<'block> BrilligBlock<'block> { condition, BrilligBinaryOp::LessThanEquals, ); - self.brillig_context.constrain_instruction( - condition, - Some("attempt to add with overflow".to_string()), - ); + self.brillig_context + .codegen_constrain(condition, Some("attempt to add with overflow".to_string())); self.brillig_context.deallocate_single_addr(condition); } (BrilligBinaryOp::Sub, false) => { @@ -1519,7 +1526,7 @@ impl<'block> BrilligBlock<'block> { condition, BrilligBinaryOp::LessThanEquals, ); - self.brillig_context.constrain_instruction( + self.brillig_context.codegen_constrain( condition, Some("attempt to subtract with overflow".to_string()), ); @@ -1549,7 +1556,7 @@ impl<'block> BrilligBlock<'block> { BrilligBinaryOp::UnsignedDiv, ); ctx.binary_instruction(division, left, condition, BrilligBinaryOp::Equals); - ctx.constrain_instruction( + ctx.codegen_constrain( condition, Some("attempt to multiply with overflow".to_string()), ); diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs index e5c731be679..fdb03abe59f 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs @@ -262,7 +262,7 @@ pub(crate) mod tests { // uses unresolved jumps which requires a block to be constructed in SSA and // we don't need this for Brillig IR tests context.push_opcode(BrilligOpcode::JumpIf { condition: r_equality, location: 8 }); - context.push_opcode(BrilligOpcode::Trap); + context.push_opcode(BrilligOpcode::Trap { revert_data_offset: 0, revert_data_size: 0 }); context.stop_instruction(); diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/codegen_control_flow.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/codegen_control_flow.rs index 116eaa5103f..f8f39f03df4 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/codegen_control_flow.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/codegen_control_flow.rs @@ -138,4 +138,48 @@ impl BrilligContext { self.enter_section(end_section); } + + /// Emits brillig bytecode to jump to a trap condition if `condition` + /// is false. The trap will include the given message as revert data. + pub(crate) fn codegen_constrain_with_revert_data( + &mut self, + condition: SingleAddrVariable, + assert_message: Option, + ) { + assert!(condition.bit_size == 1); + + self.codegen_if_not(condition.address, |ctx| { + let (revert_data_offset, revert_data_size) = + if let Some(assert_message) = assert_message { + let bytes = assert_message.as_bytes(); + for (i, byte) in bytes.iter().enumerate() { + ctx.const_instruction( + SingleAddrVariable::new(MemoryAddress(i), 8), + (*byte as usize).into(), + ); + } + (0, bytes.len()) + } else { + (0, 0) + }; + ctx.trap_instruction(revert_data_offset, revert_data_size); + }); + } + + /// Emits brillig bytecode to jump to a trap condition if `condition` + /// is false. + pub(crate) fn codegen_constrain( + &mut self, + condition: SingleAddrVariable, + assert_message: Option, + ) { + assert!(condition.bit_size == 1); + + self.codegen_if_not(condition.address, |ctx| { + ctx.trap_instruction(0, 0); + if let Some(assert_message) = assert_message { + ctx.obj.add_assert_message_to_last_opcode(assert_message); + } + }); + } } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/debug_show.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/debug_show.rs index 4ca1144b6a4..41a6d1873e4 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/debug_show.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/debug_show.rs @@ -113,10 +113,14 @@ impl DebugShow { DebugShow { enable_debug_trace } } - /// Emits brillig bytecode to jump to a trap condition if `condition` - /// is false. - pub(crate) fn constrain_instruction(&self, condition: MemoryAddress) { - debug_println!(self.enable_debug_trace, " ASSERT {} != 0", condition); + /// Emits a `trap` instruction. + pub(crate) fn trap_instruction(&self, revert_data_offset: usize, revert_data_size: usize) { + debug_println!( + self.enable_debug_trace, + " TRAP {}..{}", + revert_data_offset, + revert_data_offset + revert_data_size + ); } /// Emits a `mov` instruction. diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/instructions.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/instructions.rs index f305eb81b01..901ccc58036 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/instructions.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/instructions.rs @@ -215,29 +215,6 @@ impl BrilligContext { ); } - /// Emits brillig bytecode to jump to a trap condition if `condition` - /// is false. - pub(crate) fn constrain_instruction( - &mut self, - condition: SingleAddrVariable, - assert_message: Option, - ) { - self.debug_show.constrain_instruction(condition.address); - - assert!(condition.bit_size == 1); - - let (next_section, next_label) = self.reserve_next_section_label(); - self.add_unresolved_jump( - BrilligOpcode::JumpIf { condition: condition.address, location: 0 }, - next_label, - ); - self.push_opcode(BrilligOpcode::Trap); - if let Some(assert_message) = assert_message { - self.obj.add_assert_message_to_last_opcode(assert_message); - } - self.enter_section(next_section); - } - /// Adds a unresolved `Jump` to the bytecode. fn add_unresolved_jump( &mut self, @@ -488,6 +465,12 @@ impl BrilligContext { offset, }); } + + pub(super) fn trap_instruction(&mut self, revert_data_offset: usize, revert_data_size: usize) { + self.debug_show.trap_instruction(revert_data_offset, revert_data_size); + + self.push_opcode(BrilligOpcode::Trap { revert_data_offset, revert_data_size }); + } } /// Type to encapsulate the binary operation types in Brillig diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs index 9f2cec5c949..76cc8acf878 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs @@ -7,7 +7,7 @@ use std::fmt::Debug; use self::acir_ir::acir_variable::{AcirContext, AcirType, AcirVar}; use super::function_builder::data_bus::DataBus; use super::ir::dfg::CallStack; -use super::ir::instruction::ConstrainError; +use super::ir::instruction::{ConstrainError, UserDefinedConstrainError}; use super::{ ir::{ dfg::DataFlowGraph, @@ -472,8 +472,13 @@ impl Context { let assert_message = if let Some(error) = assert_message { match error.as_ref() { - ConstrainError::Static(string) => Some(string.clone()), - ConstrainError::Dynamic(call_instruction) => { + ConstrainError::Intrinsic(string) + | ConstrainError::UserDefined(UserDefinedConstrainError::Static(string)) => { + Some(string.clone()) + } + ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic( + call_instruction, + )) => { self.convert_ssa_call(call_instruction, dfg, ssa, brillig, &[])?; None } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/instruction.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/instruction.rs index 641d971af3c..04f33d528cd 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/instruction.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/instruction.rs @@ -347,9 +347,11 @@ impl Instruction { let lhs = f(*lhs); let rhs = f(*rhs); let assert_message = assert_message.as_ref().map(|error| match error.as_ref() { - ConstrainError::Dynamic(call_instr) => { + ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic(call_instr)) => { let new_instr = call_instr.map_values(f); - Box::new(ConstrainError::Dynamic(new_instr)) + Box::new(ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic( + new_instr, + ))) } _ => error.clone(), }); @@ -411,7 +413,10 @@ impl Instruction { f(*lhs); f(*rhs); if let Some(error) = assert_error.as_ref() { - if let ConstrainError::Dynamic(call_instr) = error.as_ref() { + if let ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic( + call_instr, + )) = error.as_ref() + { call_instr.for_each_value(f); } } @@ -597,6 +602,14 @@ impl Instruction { #[derive(Debug, PartialEq, Eq, Hash, Clone)] pub(crate) enum ConstrainError { // These are errors which have been hardcoded during SSA gen + Intrinsic(String), + // These are errors issued by the user + UserDefined(UserDefinedConstrainError), +} + +#[derive(Debug, PartialEq, Eq, Hash, Clone)] +pub(crate) enum UserDefinedConstrainError { + // These are errors which come from static strings specified by a Noir program Static(String), // These are errors which come from runtime expressions specified by a Noir program // We store an `Instruction` as we want this Instruction to be atomic in SSA with @@ -606,7 +619,7 @@ pub(crate) enum ConstrainError { impl From for ConstrainError { fn from(value: String) -> Self { - ConstrainError::Static(value) + ConstrainError::Intrinsic(value) } } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/printer.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/printer.rs index fc13ab7307a..d17d2989341 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/printer.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ir/printer.rs @@ -9,7 +9,10 @@ use iter_extended::vecmap; use super::{ basic_block::BasicBlockId, function::Function, - instruction::{ConstrainError, Instruction, InstructionId, TerminatorInstruction}, + instruction::{ + ConstrainError, Instruction, InstructionId, TerminatorInstruction, + UserDefinedConstrainError, + }, value::ValueId, }; @@ -201,10 +204,11 @@ fn display_constrain_error( f: &mut Formatter, ) -> Result { match error { - ConstrainError::Static(assert_message_string) => { + ConstrainError::Intrinsic(assert_message_string) + | ConstrainError::UserDefined(UserDefinedConstrainError::Static(assert_message_string)) => { writeln!(f, "{assert_message_string:?}") } - ConstrainError::Dynamic(assert_message_call) => { + ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic(assert_message_call)) => { display_instruction_inner(function, assert_message_call, f) } } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/opt/defunctionalize.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/opt/defunctionalize.rs index ca6527eb0ec..aa0368cc2dd 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/opt/defunctionalize.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/opt/defunctionalize.rs @@ -14,7 +14,7 @@ use crate::ssa::{ ir::{ basic_block::BasicBlockId, function::{Function, FunctionId, Signature}, - instruction::{BinaryOp, ConstrainError, Instruction}, + instruction::{BinaryOp, ConstrainError, Instruction, UserDefinedConstrainError}, types::{NumericType, Type}, value::{Value, ValueId}, }, @@ -93,10 +93,9 @@ impl DefunctionalizationContext { // Constrain instruction potentially hold a call instruction themselves // thus we need to account for them. Instruction::Constrain(_, _, Some(constrain_error)) => { - if let ConstrainError::Dynamic(Instruction::Call { - func: target_func_id, - arguments, - }) = constrain_error.as_ref() + if let ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic( + Instruction::Call { func: target_func_id, arguments }, + )) = constrain_error.as_ref() { (*target_func_id, arguments) } else { @@ -138,9 +137,11 @@ impl DefunctionalizationContext { if let Instruction::Constrain(lhs, rhs, constrain_error_call) = instruction { let new_error_call = if let Some(error) = constrain_error_call { match error.as_ref() { - ConstrainError::Dynamic(_) => { - Some(Box::new(ConstrainError::Dynamic(new_instruction))) - } + ConstrainError::UserDefined( + UserDefinedConstrainError::Dynamic(_), + ) => Some(Box::new(ConstrainError::UserDefined( + UserDefinedConstrainError::Dynamic(new_instruction), + ))), _ => None, } } else { diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs index 3fe52f7f0e5..59ce4e4f754 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs @@ -29,7 +29,9 @@ use super::{ function_builder::data_bus::DataBus, ir::{ function::RuntimeType, - instruction::{BinaryOp, ConstrainError, Instruction, TerminatorInstruction}, + instruction::{ + BinaryOp, ConstrainError, Instruction, TerminatorInstruction, UserDefinedConstrainError, + }, types::Type, value::ValueId, }, @@ -707,7 +709,9 @@ impl<'a> FunctionContext<'a> { if let ast::Expression::Literal(ast::Literal::Str(assert_message)) = assert_message_expr.as_ref() { - return Ok(Some(Box::new(ConstrainError::Static(assert_message.to_string())))); + return Ok(Some(Box::new(ConstrainError::UserDefined( + UserDefinedConstrainError::Static(assert_message.to_string()), + )))); } let ast::Expression::Call(call) = assert_message_expr.as_ref() else { @@ -733,7 +737,7 @@ impl<'a> FunctionContext<'a> { } let instr = Instruction::Call { func, arguments }; - Ok(Some(Box::new(ConstrainError::Dynamic(instr)))) + Ok(Some(Box::new(ConstrainError::UserDefined(UserDefinedConstrainError::Dynamic(instr))))) } fn codegen_assign(&mut self, assign: &ast::Assign) -> Result { diff --git a/noir/noir-repo/tooling/nargo/src/errors.rs b/noir/noir-repo/tooling/nargo/src/errors.rs index ff238d79a46..f1e77d47a73 100644 --- a/noir/noir-repo/tooling/nargo/src/errors.rs +++ b/noir/noir-repo/tooling/nargo/src/errors.rs @@ -67,7 +67,9 @@ impl NargoError { | OpcodeResolutionError::UnsatisfiedConstrain { .. } | OpcodeResolutionError::AcirMainCallAttempted { .. } | OpcodeResolutionError::AcirCallOutputsMismatch { .. } => None, - OpcodeResolutionError::BrilligFunctionFailed { message, .. } => Some(message), + OpcodeResolutionError::BrilligFunctionFailed { message, .. } => { + message.as_ref().map(|s| s.as_str()) + } OpcodeResolutionError::BlackBoxFunctionFailed(_, reason) => Some(reason), }, } diff --git a/noir/noir-repo/tooling/nargo/src/ops/execute.rs b/noir/noir-repo/tooling/nargo/src/ops/execute.rs index 6d328d65119..5ee0c6a3891 100644 --- a/noir/noir-repo/tooling/nargo/src/ops/execute.rs +++ b/noir/noir-repo/tooling/nargo/src/ops/execute.rs @@ -70,14 +70,20 @@ impl<'a, B: BlackBoxFunctionSolver, F: ForeignCallExecutor> ProgramExecutor<'a, return Err(NargoError::ExecutionError(match call_stack { Some(call_stack) => { // First check whether we have a runtime assertion message that should be resolved on an ACVM failure - // If we do not have a runtime assertion message, we should check whether the circuit has any hardcoded - // messages associated with a specific `OpcodeLocation`. + // If we do not have a runtime assertion message, we check wether the error is a brillig error with a user-defined message, + // and finally we should check whether the circuit has any hardcoded messages associated with a specific `OpcodeLocation`. // Otherwise return the provided opcode resolution error. if let Some(assert_message) = assert_message { ExecutionError::AssertionFailed( assert_message.to_owned(), call_stack, ) + } else if let OpcodeResolutionError::BrilligFunctionFailed { + message: Some(message), + .. + } = &error + { + ExecutionError::AssertionFailed(message.to_owned(), call_stack) } else if let Some(assert_message) = circuit.get_assert_message( *call_stack.last().expect("Call stacks should not be empty"), ) { diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index 34818ffb7d8..e6961279974 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,7 +68,7 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x1d144e236f9df5ca2e46d274585f322f16502b33a91cd24bce24c93b73dde3c5n; +export const DEPLOYER_CONTRACT_ADDRESS = 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4n; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; diff --git a/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts b/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts index 93095f383b8..19cc2a9031a 100644 --- a/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts +++ b/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts @@ -219,7 +219,7 @@ describe('e2e_dapp_subscription', () => { // subscribe again. This will overwrite the subscription await subscribe(new PrivateFeePaymentMethod(bananaCoin.address, bananaFPC.address, aliceWallet), MAX_FEE, 0); await expect(dappIncrement()).rejects.toThrow( - "Failed to solve brillig function, reason: explicit trap hit in brillig '(context.block_number()) as u64 < expiry_block_number as u64'", + "Failed to solve brillig function '(context.block_number()) as u64 < expiry_block_number as u64'", ); }); diff --git a/yarn-project/end-to-end/src/e2e_token_contract/reading_constants.test.ts b/yarn-project/end-to-end/src/e2e_token_contract/reading_constants.test.ts index dfdacb8ab2a..b7a5089217f 100644 --- a/yarn-project/end-to-end/src/e2e_token_contract/reading_constants.test.ts +++ b/yarn-project/end-to-end/src/e2e_token_contract/reading_constants.test.ts @@ -87,7 +87,7 @@ describe('e2e_token_contract reading constants', () => { await reader.methods.check_symbol_public(t.asset.address, TOKEN_SYMBOL).send().wait(); await expect(reader.methods.check_symbol_public(t.asset.address, 'WRONG_SYMBOL').simulate()).rejects.toThrow( - "Failed to solve brillig function, reason: explicit trap hit in brillig 'symbol.is_eq(_what)'", + "Failed to solve brillig function 'symbol.is_eq(_what)'", ); }); @@ -109,7 +109,7 @@ describe('e2e_token_contract reading constants', () => { await reader.methods.check_decimals_public(t.asset.address, TOKEN_DECIMALS).send().wait(); await expect(reader.methods.check_decimals_public(t.asset.address, 99).simulate()).rejects.toThrow( - "Failed to solve brillig function, reason: explicit trap hit in brillig 'ret == what'", + "Failed to solve brillig function 'ret == what'", ); }); }); From b2d9b9d5f1764b159e081b3cc9806ee83fdf341f Mon Sep 17 00:00:00 2001 From: Innokentii Sennovskii Date: Tue, 16 Apr 2024 11:59:55 +0100 Subject: [PATCH 17/56] feat: Changing finite field arithmetic in wasm to 29 bits for multiplications (#5435) Now when we compile for wasm we use 9 29-bit limbs to perform all multiplications. In wasmtime this results in -10% for multiplication benchmark and -35% in squaring. This makes a -7% impact on wasm client_ivc. Other changes: 1. Most of the changes are just additions to tests to handle the new montgomery form, because we have a lot of hardcoded internal representations. If we get a new one, we should rewrite those to use non-montgomery form. Also we need to recompute all parameters. 2. Added squarings to univariate and used in some relations 3. Added a script to run wasmer instead of wasmtime on the benchmark (but you need to change arguments slightly to add "--") 4. For some reason wasm build has become really slow (especially on relations and protogalaxy). 5. Added docs ![image](https://github.com/AztecProtocol/aztec-packages/assets/4798775/d5135995-c318-406d-a65a-587bdd3baae1) --- .../cpp/scripts/benchmark_wasm_remote.sh | 2 +- .../scripts/benchmark_wasm_remote_wasmer.sh | 30 + .../benchmark/basics_bench/basics.bench.cpp | 61 ++ .../src/barretenberg/ecc/curves/bn254/fq.hpp | 43 + .../barretenberg/ecc/curves/bn254/fq.test.cpp | 26 +- .../barretenberg/ecc/curves/bn254/fq12.hpp | 18 + .../ecc/curves/bn254/fq12.test.cpp | 202 ++++- .../src/barretenberg/ecc/curves/bn254/fq2.hpp | 27 + .../ecc/curves/bn254/fq2.test.cpp | 39 + .../src/barretenberg/ecc/curves/bn254/fq6.hpp | 32 + .../ecc/curves/bn254/fq6.test.cpp | 40 + .../src/barretenberg/ecc/curves/bn254/fr.hpp | 43 + .../barretenberg/ecc/curves/bn254/fr.test.cpp | 14 +- .../src/barretenberg/ecc/curves/bn254/g1.hpp | 8 + .../src/barretenberg/ecc/curves/bn254/g2.hpp | 11 + .../ecc/curves/grumpkin/grumpkin.hpp | 12 +- .../ecc/curves/secp256k1/secp256k1.hpp | 84 ++ .../ecc/curves/secp256k1/secp256k1.test.cpp | 9 +- .../ecc/curves/secp256r1/secp256r1.hpp | 86 +- .../ecc/curves/secp256r1/secp256r1.test.cpp | 8 +- .../ecc/fields/field_declarations.hpp | 84 ++ .../src/barretenberg/ecc/fields/field_docs.md | 190 +++++ .../barretenberg/ecc/fields/field_impl.hpp | 11 +- .../ecc/fields/field_impl_generic.hpp | 791 ++++++++++-------- .../barretenberg/numeric/uint256/uint256.hpp | 19 + .../numeric/uint256/uint256_impl.hpp | 210 +++++ .../barretenberg/polynomials/univariate.hpp | 20 + .../relations/auxiliary_relation.hpp | 4 +- .../delta_range_constraint_relation.hpp | 25 +- .../relations/ecc_op_queue_relation.hpp | 27 +- .../relations/ecc_vm/ecc_msm_relation.cpp | 4 +- .../ecc_vm/ecc_point_table_relation.cpp | 6 +- .../ecc_vm/ecc_transcript_relation.cpp | 20 +- .../relations/ecc_vm/ecc_wnaf_relation.cpp | 2 +- .../relations/elliptic_relation.hpp | 4 +- .../relations/poseidon2_external_relation.hpp | 16 +- .../relations/poseidon2_internal_relation.hpp | 4 +- 37 files changed, 1813 insertions(+), 419 deletions(-) create mode 100755 barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh create mode 100644 barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md diff --git a/barretenberg/cpp/scripts/benchmark_wasm_remote.sh b/barretenberg/cpp/scripts/benchmark_wasm_remote.sh index 62213556579..bdd91606db5 100755 --- a/barretenberg/cpp/scripts/benchmark_wasm_remote.sh +++ b/barretenberg/cpp/scripts/benchmark_wasm_remote.sh @@ -16,7 +16,7 @@ cd $(dirname $0)/.. # Configure and build. cmake --preset wasm-threads -cmake --build --preset wasm-threads --target $BENCHMARK +cmake --build --preset wasm-threads --parallel --target $BENCHMARK source scripts/_benchmark_remote_lock.sh diff --git a/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh b/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh new file mode 100755 index 00000000000..8df56fe2593 --- /dev/null +++ b/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh @@ -0,0 +1,30 @@ +#!/usr/bin/env bash +# This script automates the process of benchmarking WASM on a remote EC2 instance. +# Prerequisites: +# 1. Define the following environment variables: +# - BB_SSH_KEY: SSH key for EC2 instance, e.g., '-i key.pem' +# - BB_SSH_INSTANCE: EC2 instance URL +# - BB_SSH_CPP_PATH: Path to barretenberg/cpp in a cloned repository on the EC2 instance +set -eu + +BENCHMARK=${1:-goblin_bench} +COMMAND=${2:-./$BENCHMARK} +HARDWARE_CONCURRENCY=${HARDWARE_CONCURRENCY:-16} + +# Move above script dir. +cd $(dirname $0)/.. + +# Configure and build. +cmake --preset wasm-threads +cmake --build --preset wasm-threads --parallel --target $BENCHMARK + +source scripts/_benchmark_remote_lock.sh + +cd build-wasm-threads +# ensure folder structure +ssh $BB_SSH_KEY $BB_SSH_INSTANCE "mkdir -p $BB_SSH_CPP_PATH/build-wasm-threads" +# copy build wasm threads +scp $BB_SSH_KEY ./bin/$BENCHMARK $BB_SSH_INSTANCE:$BB_SSH_CPP_PATH/build-wasm-threads +# run wasm benchmarking +ssh $BB_SSH_KEY $BB_SSH_INSTANCE \ + "cd $BB_SSH_CPP_PATH/build-wasm-threads ; /home/ubuntu/.wasmer/bin/wasmer run --dir=$BB_SSH_CPP_PATH --enable-threads --env HARDWARE_CONCURRENCY=$HARDWARE_CONCURRENCY $COMMAND" diff --git a/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp b/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp index 03614693396..6bd76603106 100644 --- a/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp +++ b/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp @@ -364,6 +364,65 @@ void sequential_copy(State& state) } } } + +/** + * @brief Evaluate how much uint256_t multiplication costs (in cache) + * + * @param state + */ +void uint_multiplication(State& state) +{ + numeric::RNG& engine = numeric::get_debug_randomness(); + std::vector copy_vector(2); + for (size_t j = 0; j < 2; j++) { + copy_vector.emplace_back(engine.get_random_uint256()); + copy_vector.emplace_back(engine.get_random_uint256()); + copy_vector[0] += (1 - copy_vector[0].get_bit(0)); + copy_vector[1] += (1 - copy_vector[1].get_bit(0)); + } + + for (auto _ : state) { + state.PauseTiming(); + size_t num_cycles = 1 << static_cast(state.range(0)); + state.ResumeTiming(); + for (size_t i = 0; i < num_cycles; i++) { + copy_vector[i & 1] *= copy_vector[1 - (i & 1)]; + } + } +} + +/** + * @brief Evaluate how much uint256_t extended multiplication costs (in cache) + * + * @param state + */ +void uint_extended_multiplication(State& state) +{ + numeric::RNG& engine = numeric::get_debug_randomness(); + std::vector copy_vector(2); + for (size_t j = 0; j < 2; j++) { + copy_vector.emplace_back(engine.get_random_uint256()); + copy_vector.emplace_back(engine.get_random_uint256()); + copy_vector[0] += (1 - copy_vector[0].get_bit(0)); + copy_vector[1] += (1 - copy_vector[1].get_bit(0)); + } + + for (auto _ : state) { + state.PauseTiming(); + size_t num_cycles = 1 << static_cast(state.range(0)); + state.ResumeTiming(); + for (size_t i = 0; i < num_cycles; i++) { + auto [r0, r1] = copy_vector[i & 1].mul_extended(copy_vector[1 - (i & 1)]); + state.PauseTiming(); + copy_vector[i & 1] += r0; + copy_vector[1 - (i & 1)] += r1; + copy_vector[0] += (1 - copy_vector[0].get_bit(0)); + copy_vector[1] += (1 - copy_vector[1].get_bit(0)); + state.ResumeTiming(); + } + } +} + } // namespace BENCHMARK(parallel_for_field_element_addition)->Unit(kMicrosecond)->DenseRange(0, MAX_REPETITION_LOG); @@ -380,4 +439,6 @@ BENCHMARK(projective_point_doubling)->Unit(kMicrosecond)->DenseRange(12, 22); BENCHMARK(scalar_multiplication)->Unit(kMicrosecond)->DenseRange(12, 18); BENCHMARK(cycle_waste)->Unit(kMicrosecond)->DenseRange(20, 30); BENCHMARK(sequential_copy)->Unit(kMicrosecond)->DenseRange(20, 25); +BENCHMARK(uint_multiplication)->Unit(kMicrosecond)->DenseRange(12, 27); +BENCHMARK(uint_extended_multiplication)->Unit(kMicrosecond)->DenseRange(12, 27); BENCHMARK_MAIN(); \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp index ffda71bbd47..dce9f2634e9 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp @@ -24,11 +24,36 @@ class Bn254FqParams { static constexpr uint64_t cube_root_2 = 0xaa303344d4741444UL; static constexpr uint64_t cube_root_3 = 0x2c3b3f0d26594943UL; + static constexpr uint64_t modulus_wasm_0 = 0x187cfd47; + static constexpr uint64_t modulus_wasm_1 = 0x10460b6; + static constexpr uint64_t modulus_wasm_2 = 0x1c72a34f; + static constexpr uint64_t modulus_wasm_3 = 0x2d522d0; + static constexpr uint64_t modulus_wasm_4 = 0x1585d978; + static constexpr uint64_t modulus_wasm_5 = 0x2db40c0; + static constexpr uint64_t modulus_wasm_6 = 0xa6e141; + static constexpr uint64_t modulus_wasm_7 = 0xe5c2634; + static constexpr uint64_t modulus_wasm_8 = 0x30644e; + + static constexpr uint64_t r_squared_wasm_0 = 0xe1a2a074659bac10UL; + static constexpr uint64_t r_squared_wasm_1 = 0x639855865406005aUL; + static constexpr uint64_t r_squared_wasm_2 = 0xff54c5802d3e2632UL; + static constexpr uint64_t r_squared_wasm_3 = 0x2a11a68c34ea65a6UL; + + static constexpr uint64_t cube_root_wasm_0 = 0x62b1a3a46a337995UL; + static constexpr uint64_t cube_root_wasm_1 = 0xadc97d2722e2726eUL; + static constexpr uint64_t cube_root_wasm_2 = 0x64ee82ede2db85faUL; + static constexpr uint64_t cube_root_wasm_3 = 0x0c0afea1488a03bbUL; + static constexpr uint64_t primitive_root_0 = 0UL; static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; + static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; + static constexpr uint64_t endo_g1_lo = 0x7a7bd9d4391eb18d; static constexpr uint64_t endo_g1_mid = 0x4ccef014a773d2cfUL; static constexpr uint64_t endo_g1_hi = 0x0000000000000002UL; @@ -57,6 +82,24 @@ class Bn254FqParams { 0x2a1f6744ce179d8eULL, 0x3829df06681f7cbdULL, 0x463456c802275bedULL, 0x543ece899c2f3b1cULL, 0x180a96573d3d9f8ULL, 0xf8b21270ddbb927ULL, 0x1d9598e8a7e39857ULL, 0x2ba010aa41eb7786ULL, }; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0xeb8a8ec140766463ULL, 0xfded87957d76333dULL, + 0x4c710c8092f2ff5eULL, 0x9af4916ba86fcb7fULL, + 0xe9781656bdec97a0ULL, 0xfbdb0f2afaec667aULL, + 0x4a5e94161069329bULL, 0x98e2190125e5febcULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0xf2b1f20626a3da49ULL, 0x56c12d76cb13587fULL, + 0x5251d378d7f4a143ULL, 0x4de2797ae4d5ea06ULL, + 0x49731f7cf1b732c9ULL, 0xad825aed9626b0ffULL, + 0xa91300efa307f9c3ULL, 0xa4a3a6f1afe94286ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0xf905ef8d84d5fea4ULL, 0x93b7a45b84f1507eULL, + 0xe6b99ee0068dfab5ULL, 0x39bb9964882aa4ecULL, + 0x8cbd93e909c74f23ULL, 0x276f48b709e2a0fcULL, + 0x7a71433b8b7f4b33ULL, 0xcd733dc00d1bf56aULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x2958a27c02b7cd5fULL, 0x06bc8a3277c371abULL, + 0x1484c05bce00b620ULL, 0x224cf685243dfa96ULL, + 0x30152cae7a7b3f0bULL, 0x0d791464ef86e357ULL, + 0x1b414a8e45c427ccULL, 0x290980b79c016c41ULL }; + // used in msgpack schema serialization static constexpr char schema_name[] = "fq"; static constexpr bool has_high_2adicity = false; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp index e65527e6424..343156b5c18 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp @@ -88,13 +88,16 @@ TEST(fq, RandomElement) TEST(fq, MulCheckAgainstConstants) { // test against some randomly generated test data - constexpr fq a{ 0x2523b6fa3956f038, 0x158aa08ecdd9ec1d, 0xf48216a4c74738d4, 0x2514cc93d6f0a1bf }; - constexpr fq a_copy{ 0x2523b6fa3956f038, 0x158aa08ecdd9ec1d, 0xf48216a4c74738d4, 0x2514cc93d6f0a1bf }; - constexpr fq b{ 0xb68aee5e4c8fc17c, 0xc5193de7f401d5e8, 0xb8777d4dde671db3, 0xe513e75c087b0bb }; - constexpr fq b_copy = { 0xb68aee5e4c8fc17c, 0xc5193de7f401d5e8, 0xb8777d4dde671db3, 0xe513e75c087b0bb }; - constexpr fq const_expected{ 0x7ed4174114b521c4, 0x58f5bd1d4279fdc2, 0x6a73ac09ee843d41, 0x687a76ae9b3425c }; + constexpr fq a = uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; + constexpr fq a_copy = + uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; + constexpr fq b = uint256_t{ 0x744fc10aec23e56aUL, 0x5dea4788a3b936a6UL, 0xa0a89f4a8af01df1UL, 0x72ae28836807df3UL }; + constexpr fq b_copy = + uint256_t{ 0x744fc10aec23e56aUL, 0x5dea4788a3b936a6UL, 0xa0a89f4a8af01df1UL, 0x72ae28836807df3UL }; + + constexpr fq const_expected = + uint256_t{ 0x6c0a789c0028fd09UL, 0xca9520d84c684efaUL, 0xcbf3f7b023a852b4UL, 0x1b2e4dac41400621UL }; constexpr fq const_result = a * b; - static_assert(const_result == const_expected); static_assert(a == a_copy); static_assert(b == b_copy); @@ -111,7 +114,10 @@ TEST(fq, MulShortIntegers) { constexpr fq a{ 0xa, 0, 0, 0 }; constexpr fq b{ 0xb, 0, 0, 0 }; - constexpr fq const_expected = { 0x65991a6dc2f3a183, 0xe3ba1f83394a2d08, 0x8401df65a169db3f, 0x1727099643607bba }; + constexpr uint256_t a_original(a); + constexpr uint256_t b_original(b); + constexpr uint256_t prod_expected = (uint512_t(a_original) * uint512_t(b_original) % uint512_t(fq::modulus)).lo; + constexpr fq const_expected = prod_expected; constexpr fq const_result = a * b; static_assert(const_result == const_expected); @@ -141,8 +147,10 @@ TEST(fq, MulSqrConsistency) TEST(fq, SqrCheckAgainstConstants) { - constexpr fq a{ 0x329596aa978981e8, 0x8542e6e254c2a5d0, 0xc5b687d82eadb178, 0x2d242aaf48f56b8a }; - constexpr fq expected{ 0xbf4fb34e120b8b12, 0xf64d70efbf848328, 0xefbb6a533f2e7d89, 0x1de50f941425e4aa }; + constexpr fq a = uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; + + constexpr fq expected = + uint256_t{ 0x41081a42fdaa7e23UL, 0x44d1140f756ed419UL, 0x53716b0a6f253e63UL, 0xb1a0b04044d75fUL }; constexpr fq result = a.sqr(); static_assert(result == expected); diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp index 1fddd927768..af41374d5c8 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp @@ -6,6 +6,8 @@ namespace bb { struct Bn254Fq12Params { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 frobenius_coefficients_1{ { 0xaf9ba69633144907UL, 0xca6b1d7387afb78aUL, 0x11bded5ef08a2087UL, 0x02f34d751a1f3a7cUL }, { 0xa222ae234c492d72UL, 0xd00f02a4565de15bUL, 0xdc2ff3a253dfc926UL, 0x10a75716b3899551UL } @@ -20,6 +22,22 @@ struct Bn254Fq12Params { { 0x365316184e46d97dUL, 0x0af7129ed4c96d9fUL, 0x659da72fca1009b5UL, 0x08116d8983a20d23UL }, { 0xb1df4af7c39c1939UL, 0x3d9f02878a73bf7fUL, 0x9b2220928caf0ae0UL, 0x26684515eff054a6UL } }; +#else + static constexpr fq2 frobenius_coefficients_1{ + { 0xb75446af8a0c2399UL, 0xb5e243df8d8526c8UL, 0x7f6d66278fc2b89bUL, 0x2e05603062b5af58UL }, + { 0xaeefbf6e3bc6cc33UL, 0x7f50c04b4ed87762UL, 0x9a8b7572eb6a58d4UL, 0x9b83e6c410c870UL } + }; + + static constexpr fq2 frobenius_coefficients_2{ + { 0xd96ee8726e4983b2UL, 0xe9b7ed6a458f581eUL, 0x5361c2c89ea5d262UL, 0x24594fd198a79c6eUL }, + { 0UL, 0UL, 0UL, 0UL } + }; + + static constexpr fq2 frobenius_coefficients_3{ + { 0x9dc006978e6a3d3dUL, 0x695b3f038ef4bf24UL, 0x1a238968ba7a7ccdUL, 0x103828f20e49839cUL }, + { 0x5cbbb0bd4f4e6b31UL, 0xe83ce8be1b5b282bUL, 0x646d437ef03fbae3UL, 0x133cf9860031f0c0UL } + }; +#endif }; using fq12 = field12; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp index c6dc81000b6..d9e55827100 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp @@ -185,6 +185,8 @@ TEST(fq12, SubCheckAgainstConstants) TEST(fq12, MulCheckAgainstConstants) { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0xd43e9f8be859502b, 0x26a42a1a95cee1ef, 0x3d63c085c1892b32, 0x2e5beaf431211a76 }, { 0x5f32ad7cee215ff5, 0xce967fda9424120e, 0x10ea4e52628bac33, 0x51b85ee9671b7f3 } }, { { 0x95f8e84e0ff94a83, 0x6c6fb2cf3c73b30a, 0x28e8e13841f714a8, 0x2a3412f681e31b4d }, @@ -221,12 +223,56 @@ TEST(fq12, MulCheckAgainstConstants) { 0xeaf256aa7a6b49b5, 0xeaa1b56258e3194e, 0xde3b531fd4fe961b, 0x26a0b5c35ce4be53 } }, { { 0x1f7661fa7dd7d68c, 0x71c1360fdb272200, 0x3fdb8fcc1dbfd160, 0x1ba330295e24399b }, { 0x5c93a291c6579918, 0x6536baab9e09bc80, 0x93ad9959edff4c64, 0x138af9a14abfeb1e } } } }; +#else + fq12 a = { { { { 0x7c0386cfac84570eUL, 0x135ac6487c86816dUL, 0x130fe55503fd0b4dUL, 0x1fbc2d0fc05289e4UL }, + { 0x31f40b593ab506cbUL, 0xc4bbb9e4b2ce224UL, 0xf458f928ccf17d61UL, 0x1243d27a2aa21de4UL } }, + { { 0x67ae435929fa99e3UL, 0x93501c918a76046dUL, 0xaca4ccc8963e432eUL, 0x2bee18b27c27853eUL }, + { 0xd0c6730507d0d015UL, 0xd41cfd656c0a9059UL, 0xb292659d53fa0444UL, 0x2e8f0ac98edef6fdUL } }, + { { 0x700740aa0efd0e50UL, 0x2c5e9c0660931b42UL, 0x188425137ce80beUL, 0x15a745139a2d95a4UL }, + { 0xc270eebcc77b120eUL, 0x8dd2034c9f5e661dUL, 0xd0cacb8be3443ebbUL, 0x2206cf8406979618UL } } }, + { { { 0x14beeea0c29cf256UL, 0xec331baf4a9d8e57UL, 0x84c18cf8f3dfd61cUL, 0x172f849c8867a6a3UL }, + { 0x49c8f77c0173904UL, 0xa7ec5eadf91525UL, 0xb6af342102d7f350UL, 0x1931766a4a4de218UL } }, + { { 0x1d05943f42ce34b6UL, 0x2ec4bdddbaed0295UL, 0xf29903765d9d2a7UL, 0x180626982a98bb32UL }, + { 0x16cef1562b3f9cbfUL, 0x564982ca86391192UL, 0x338241cef0f07d6eUL, 0x2eceb2ea88b46fcdUL } }, + { { 0x16d7e01a042c1c8dUL, 0x6ccf62b19f1db7abUL, 0xdf7b7fb19a040d7bUL, 0x17278879d86f5ffaUL }, + { 0xb80f047affe4ba5aUL, 0xd4768f74c5e34883UL, 0x413437ff1a222a7UL, 0x1c9f79ff1e326bd6UL } } } }; + fq12 b = { { { { 0x8b6d20fcb2e4cfe1UL, 0xd90b5af04637d61UL, 0xe5213491fb1c8ddUL, 0x22c31d57c6199047UL }, + { 0x5d5e4792797a849fUL, 0xef0fb5048682755eUL, 0x4262903127b8490UL, 0x1c5a05774b7b87c2UL } }, + { { 0x6afefb11e053997dUL, 0xa9425cc6d3438879UL, 0xc589bf0a479257f6UL, 0x2f265a3f46125967UL }, + { 0x16d32bf792576ea5UL, 0x838faa5f1ec28d7dUL, 0xf78fe731049b021dUL, 0x2b0eaaf50224c689UL } }, + { { 0x37aff72139bcccfcUL, 0xb3d22b3397a55baeUL, 0xf3efabf7233a8667UL, 0x3dbff83c87691bcUL }, + { 0x25f36df6da3ba93dUL, 0x2939ccbc8f01881dUL, 0x10a81e15af7aed31UL, 0x2e518a473abafad5UL } } }, + { { { 0xad5021ea46c06b79UL, 0xb7b76193fc41efe1UL, 0xa69eed0eb6ec2c57UL, 0x2c89ae19e58186bUL }, + { 0xae75112332f4de13UL, 0x374e8d70552ca0d8UL, 0x68e87f702af0ecf1UL, 0x95ede632701dd39UL } }, + { { 0x6de7a94aa7bc5726UL, 0x7874ee4c3c04b1cUL, 0x9a6e5d3e5875115dUL, 0x651f42a42021fb7UL }, + { 0x555a79f9e6ea299bUL, 0xd504f95c1ecbea79UL, 0xe97d114d516cef0bUL, 0x2d27cfdd54e9f124UL } }, + { { 0x8b3ae5f063f26da4UL, 0xf797224bfa14f904UL, 0xcdcd9c93aa02adfbUL, 0x25d073040d79eb5dUL }, + { 0xf84a169b376e11UL, 0xac1f29c1236def7cUL, 0xc84235bd3c78d593UL, 0x11668081e4c22e74UL } } } }; + fq12 expected = { + { { { 0xe1692f3291c79addUL, 0x75a0f3f9cb5b780fUL, 0x94fc10049567941cUL, 0x2cbd84240c99322dUL }, + { 0xec0b5c231d51cf6eUL, 0xaf66fb345ef4b557UL, 0x684bd6749e20d417UL, 0x6acb8ccf83a8a5aUL } }, + { { 0x4b5bfec7495191d9UL, 0xaaf3b2fb8c9417b3UL, 0x9e8cc0788452ef36UL, 0x150f0c9b2bd490d9UL }, + { 0xd38c4d68e8d61244UL, 0x7854bc167c3f883UL, 0xe422e992b4fd0935UL, 0x2e2ee820869b7371UL } }, + { { 0x9458ec7554a72a3eUL, 0x611f6d973e483feaUL, 0x3f8ea4f8370c8826UL, 0x189afef00f4165e6UL }, + { 0x8a57858c6746a623UL, 0x5c2f5d8907db836eUL, 0x18aa628b09f8cc39UL, 0x301cdc8e2edb165bUL } } }, + { { { 0xe339df6c6902f315UL, 0xbcf4e508382eec7UL, 0x1a86782e58331768UL, 0x15a3a1d93ce727deUL }, + { 0x9d3911edc9a69069UL, 0xacf7dd9e1ee36b27UL, 0xd3c0532725cf9a45UL, 0x1c7c570ac4e21c68UL } }, + { { 0x434490153d5b55f1UL, 0x3e3b2fb04143f767UL, 0x8960b1eb0cea5302UL, 0x2ebbac70edefc529UL }, + { 0x7f1d271429347ab1UL, 0x88934417e9466212UL, 0xc7939527fa312259UL, 0x1a4b0f339ebf2668UL } }, + { { 0xb48265b482310282UL, 0x910d43c20ce40215UL, 0x5cd12ae9ce1f579UL, 0xd588117ef09f079UL }, + { 0xc0edc126a51743acUL, 0x8cc656a2dbe2116cUL, 0xd1efe6afadd96829UL, 0x2cab86c6c9a9e1ddUL } } } + }; +#endif + fq12 result = a * b; EXPECT_EQ(result, expected); } TEST(fq12, SparseMulCheckAgainstConstants) { + fq12::ell_coeffs ell; + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x8860ba0c4eea41a8, 0x71b65207984d47d2, 0x67e55696f8982ba9, 0x18236f03bcec9b00 }, { 0xa69e0f0ce60f64fd, 0x1cf52f3b2335b9b3, 0x45e8ec475fcb1d71, 0x1627ac08d10cebd9 } }, { { 0xc7343ce2fb7b4829, 0xff667dd3e618123b, 0xd03970bcf60881b4, 0x188e0b7acdd0b801 }, @@ -239,7 +285,6 @@ TEST(fq12, SparseMulCheckAgainstConstants) { 0x5752f0197b67dfa3, 0xb4ff7a53c23b98fd, 0x95dec4882eb275cd, 0x6815e3c55e10152 } }, { { 0x64f434f52a58b19b, 0xcdab64e3ae898031, 0x5d10a474f28b9462, 0x85452691edf6f18 }, { 0x2bb46c10f494b711, 0x66a853baee9e6a00, 0x3b3e0fd932afa021, 0x1ae752d1bbdef131 } } } }; - fq12::ell_coeffs ell; ell.o = { { 0xe49c67a74aaf8c22, 0xc5cc428c85da5d5a, 0xc946262e0c99d3d9, 0x2307b236a862e3e9 }, { 0x1659aef76f0397ef, 0x32d0c2d00f81d8a5, 0x7e87867d5f0c5ccd, 0x247307a3fd6fece7 } }; ell.vv = { { 0x6e6f2db65bdf07bd, 0xc26fa997848fb1e4, 0x13ec10cb6a0cd0ae, 0xf86d8967480301c }, @@ -258,6 +303,41 @@ TEST(fq12, SparseMulCheckAgainstConstants) { 0xee892e54b68159d6, 0xe0421cb20d103d69, 0xfe0591fdca60e2e3, 0x1650989fd73116b9 } }, { { 0x475dec6d5f2e2a75, 0xf25390f14ed7106, 0x61a4b571cb15d2fe, 0x1ad83abac0d5bdd7 }, { 0x8f730272c4cfee79, 0x60833c047d98a040, 0xbd1da3dc3fe5ad4a, 0x11bcc8faf5176d94 } } } }; +#else + fq12 a = { { { { 0x862f0c332df55dd7UL, 0x5635026deafe1c0aUL, 0x2ff6bd2d7c7147b2UL, 0x2e8d47bc6baafd9bUL }, + { 0x89fa385ceb16c5beUL, 0x55921370b07e22bbUL, 0xa8b9b8f0e450d905UL, 0x1f7936d1d0e6b8e0UL } }, + { { 0x247edaf1e79930b0UL, 0x74b911663be59ea5UL, 0x8229bc36a8fab0c6UL, 0xb7c882ba6fcfd9eUL }, + { 0x9b0f501da1aba3f8UL, 0xb9eada8afbf600cbUL, 0xaae6ba9ad6dcdf6cUL, 0x2e7c7f0141a21168UL } }, + { { 0x69f468a007750941UL, 0x8717631d88d69af9UL, 0x92ebf135aa3ae0fbUL, 0x2fde53f8ed2d4e89UL }, + { 0xaa3fdf0219928031UL, 0xb9f6c209fa53b22fUL, 0x42f0094eee6a0282UL, 0x1265a0c64610dd82UL } } }, + { { { 0xafba8564aac749c5UL, 0xa3fc62e90dcf2998UL, 0xe76f032508e46ceUL, 0x512a45304405419UL }, + { 0xaed59d4a84fadccfUL, 0xa8545ab127e7b2e7UL, 0xa22a72b116b8cd30UL, 0x2ed2f79741896fa7UL } }, + { { 0xe4e3c9f195fc922UL, 0x1e369406a0dd4156UL, 0x5cd5b95268031c47UL, 0x10e1a470d68ccc24UL }, + { 0xf9dbd2d40b07ff44UL, 0x41e9a032a5abf575UL, 0xda977a2bd0495840UL, 0xe9a8dbf3759a9abUL } }, + { { 0x71e3e23310a540fdUL, 0xbfe5879ec6f7116aUL, 0x883320dc9ebd285UL, 0x1894c4e575f5c23bUL }, + { 0x7864349a324a1069UL, 0xc57263b5e43ecca4UL, 0x2a6d5a07bc5d25f5UL, 0x2641249687928362UL } } } }; + ell.o = { { 0x2ca05edbe2b6c2dfUL, 0x1ce7be80591278acUL, 0x998e825bf09b8ad0UL, 0x7f33a82d0e71979UL }, + { 0x2828bcc994bb3f38UL, 0x25f65c6025901765UL, 0x896a468fbd6b50e0UL, 0x4f999ba91569906UL } }; + ell.vv = { { 0x74a03de706ff12daUL, 0x62e709427d845309UL, 0x4a5f604c328ca230UL, 0xcf00251c415c1e1UL }, + { 0x9ed8dd9107199bcfUL, 0xc8687b1778022dc1UL, 0xc85d46f0f0503eb5UL, 0x74aa6da92bf7c52UL } }; + ell.vw = { { 0x40dd44ad118c702eUL, 0x8e54bb7dba2b064dUL, 0x2f70e0e61191e016UL, 0x15da2c76976d740eUL }, + { 0xa0f9565f3904fdb9UL, 0xf365bb919669dda8UL, 0x9d115033fcfce745UL, 0x1d5b9ac7270a74d2UL } }; + fq12 expected = { + { { { 0x82285526713a81afUL, 0xb9bdafcf85cffdd7UL, 0x81e818f8dda89057UL, 0x538df3884fe91cdUL }, + { 0x2334d3765086fcc4UL, 0x5241e1cb445f8d0cUL, 0x9d67bfc7f3580b66UL, 0x16935cb50949401aUL } }, + { { 0x79e51946415c1d86UL, 0x2dc112e62e072e35UL, 0x31cc85fadec9dac7UL, 0x21cafde5a92abf84UL }, + { 0xc499133572cc7b01UL, 0xf1d5b744396dc992UL, 0x5a07a594d45537e2UL, 0x5308670f9c3d1f9UL } }, + { { 0xbc1249df0a659895UL, 0x35a160c6d314cba0UL, 0xc6feb7b32ad48754UL, 0x17c6a9d4f6fcaafdUL }, + { 0xb9be974900458414UL, 0x1746303c5d7e6930UL, 0x91409abda635eb5cUL, 0x2b3c8b47d060a389UL } } }, + { { { 0xdc1dee7128fefe88UL, 0x378772d011ad83b3UL, 0xc1532ed19f546d80UL, 0x1955fc12038a7e9UL }, + { 0x6da079dfafc00254UL, 0xc86f97e68cba4484UL, 0x5dcaeaac906d378aUL, 0x121934a4af2b7682UL } }, + { { 0x86a09145e69d83d6UL, 0xfe70b95e33cefbc7UL, 0x76b0cc3628b7342eUL, 0x172e1bbf4c53ebafUL }, + { 0x875e2156f95560deUL, 0xbf2fc24debce9984UL, 0xac4e6fbe3709875dUL, 0x2496c9b2956c14f7UL } }, + { { 0xed94402785787ce9UL, 0xd50f0e3aae1fad67UL, 0xf7420d1ac923818aUL, 0x245e21b7266c1826UL }, + { 0x58fa495d4c9eed13UL, 0x8dd7ec5036305400UL, 0xb8417cb06c26dd46UL, 0x2349c06ef5cbd0ccUL } } } + }; +#endif + a.self_sparse_mul(ell); fq12 result = a; EXPECT_EQ(result, expected); @@ -265,6 +345,7 @@ TEST(fq12, SparseMulCheckAgainstConstants) TEST(fq12, SqrCheckAgainstConstants) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0xef9d68a7df0715fd, 0xfda8aff4030523cf, 0xd09b1482069c0972, 0x252195422f351b07 }, { 0x3192057a31dec453, 0xe1c2dd8879191e47, 0xe90a8a00c9b29c5b, 0x1db75f06dff5dd5e } }, { { 0xdb01b2dbb451df8f, 0x42d8923147ae4171, 0xd1264f3077ab1733, 0x2fbabfe2fbc0c62f }, @@ -289,6 +370,35 @@ TEST(fq12, SqrCheckAgainstConstants) { 0x19ea0ed62e5093c2, 0xcf288a69b5a24352, 0xa9bdc89dd4491b7d, 0x447edc7b33f3d1c } }, { { 0xceb417494bece8e, 0x7f3d84971a20d351, 0x31679ed74c101d91, 0x1bb2c06842073c0c }, { 0x6db2993066e5fd73, 0x2c08c9fd6c3b5483, 0x3b32d43ab22d6cea, 0x3df72d32906f5f0 } } } }; +#else + fq12 a = { { { { 0x509ff2d7952b00f8UL, 0x80f400de95f97cc0UL, 0xcbdc0724af60e599UL, 0x1acb4d80c9fc5d10UL }, + { 0xbbd649942a91be1bUL, 0xf9c0c84462b1c06aUL, 0x735c138d99b9fc89UL, 0x1f7a0e55480cc8c4UL } }, + { { 0x184564b253194647UL, 0x2665e8d5000a721UL, 0xd31174f546b93313UL, 0x1b327c76331660ecUL }, + { 0xcf1585c76f7e33faUL, 0xd42af737f2d68572UL, 0x3b4f1daaf9248cf2UL, 0x28102c8df7cb8188UL } }, + { { 0xfd34a1893271a08dUL, 0xa8bb3e8ddf935064UL, 0xaf2e701ff4238744UL, 0x112cb808f50649edUL }, + { 0xfa6a796e73099831UL, 0xc33d172135fc08f1UL, 0xffc1f0839ae21c08UL, 0xd5487b930349686UL } } }, + { { { 0xa138da16197ba208UL, 0x131b351230ea78f4UL, 0x67d421144983327fUL, 0x301ad90db1293961UL }, + { 0x2aaf49d5664bf971UL, 0x41de301d76480c2UL, 0xf1b7cd92f25da91eUL, 0x266ad04894fb98a1UL } }, + { { 0x5430ab66ae7c441eUL, 0x56b0046a411a6a05UL, 0x769a94899a38a9a8UL, 0x47009b2bb1105a4UL }, + { 0x90e78ec3428acf7fUL, 0x494d36f303578d13UL, 0xf860c04788d78bd4UL, 0xbff46fe73771bc5UL } }, + { { 0x4deef8f7b5691d29UL, 0x4ca2a905e4dc7c9UL, 0xd346bb2f908bf92dUL, 0x4e7f53251024a06UL }, + { 0x506c4af6c096a839UL, 0xb66ec8f49dcd25d7UL, 0x1d956454caa9c224UL, 0x80fd62496656a00UL } } } }; + fq12 expected = { + { { { 0x444065edd96c27eUL, 0x441edd1fb7593b4dUL, 0xebca21f0aba5b86aUL, 0x1a0f7150178bce4UL }, + { 0xd6944c6d8a9a1326UL, 0xebe3e1c083a9070aUL, 0x90085ed26d41b187UL, 0x270dbc63380d166fUL } }, + { { 0x6ff64bb4265979c2UL, 0x934f9a7229efd61bUL, 0xf2633f5fc77c71cdUL, 0x794a11250897c9UL }, + { 0x4c16eb3426ead093UL, 0xc6b10f92e5172d17UL, 0x722cc34bab735deeUL, 0x2ef62e8e932612a9UL } }, + { { 0xe5eb6b4fe61af24bUL, 0xf4ad92e89647ddbeUL, 0xf07438f58235164fUL, 0x2ddf71d5540c3861UL }, + { 0x1f892a5ed0dbc0bfUL, 0xdea7e0ca077a8f66UL, 0x561aba1a7909c0acUL, 0x2296a5f0bb3fca3UL } } }, + { { { 0xb33c0e27dc05cf5eUL, 0x9b5ac27c7f9f3fafUL, 0xb34ce34b0ddc0e33UL, 0x8d34950d591462UL }, + { 0x6633d2139211d6feUL, 0x1c194cb263ca6182UL, 0x280ced1e54e99b63UL, 0x78892452fa76a9eUL } }, + { { 0x8ffaebac35d5999eUL, 0x8e3226d773c7cac4UL, 0x180b0a89641fbc37UL, 0xd165c35b4cefb88UL }, + { 0xc500c29819187db2UL, 0xb60e7813e364d528UL, 0xc718884d8620befeUL, 0x28351c10a5846341UL } }, + { { 0x631e54f75f1002c2UL, 0x409714a9ec1a2c33UL, 0x374ef41466eb7b9bUL, 0xf4a88f46b6a3e97UL }, + { 0x3e120ddf2bc5b3d2UL, 0x52166a8ab686fb53UL, 0xf5b9fbe942aaec8aUL, 0x1b25bd7f5e7b7db3UL } } } + }; +#endif + fq12 result = a.sqr(); EXPECT_EQ(result, expected); } @@ -311,6 +421,7 @@ TEST(fq12, UnitaryInverse) TEST(fq12, FrobeniusMapThree) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x9a56f1e63b1f0db8, 0xd629a6c847f6cedd, 0x4a179c053a91458b, 0xa84c02b0b6d7470 }, { 0xffa3e17eab3609a1, 0x6a97b9cf5c3fe152, 0x8996248da177be9f, 0x113bd2d7f24591d } }, { { 0x572c4fd8a85cc3b, 0x48197102a98815e8, 0x3a1d00190e8ee460, 0x8c0a0ce9c093781 }, @@ -335,12 +446,42 @@ TEST(fq12, FrobeniusMapThree) { 0x373dde8dfb6dceb3, 0xa0feac44ec583fb4, 0x257146bc7ad7d5c2, 0x1ee0a5c45a91938b } }, { { 0xf8c975188dd668a5, 0xfa38a6144e0c5451, 0x8ebdddc91016c224, 0x13fe7e09fe48aefb }, { 0x2ce375ffd1c12d33, 0xc2099e064cd9724d, 0x9c54b742a4d8bd59, 0x1c79d60ac5202c8c } } } }; +#else + fq12 a = { { { { 0xe21af43e50f3c756UL, 0x382c59a08c2f1c63UL, 0xf111de6049209f49UL, 0x2e3e2eb02684cd0eUL }, + { 0xf47c2fd566c13420UL, 0x52f739eb87fc2a5fUL, 0x32c491b42ef7d3edUL, 0x2277a5afe48b23b1UL } }, + { { 0x81b5e33f164894fdUL, 0xda70b7e26c9c83eUL, 0xaa0ea6914a55d235UL, 0x261e91951b2ecf56UL }, + { 0x8777f8c814c07822UL, 0xb1d30aee8bbb4fdbUL, 0xd68096f26bc12a63UL, 0x226bdb647a45d0b3UL } }, + { { 0xe196e3bdeadc85f8UL, 0xfc4ead6ed1903f55UL, 0x35fbc522dfecf6e5UL, 0x2ea7141ed2d4f68aUL }, + { 0x5018998ba882e541UL, 0x1f2f49ebb929119UL, 0x10bf13b591b51304UL, 0x2715b1dab0519809UL } } }, + { { { 0x41dfb519bce7a2a2UL, 0x57e69632d7d5db93UL, 0x63059436226719c0UL, 0x1382e9227bb12da2UL }, + { 0x78a2f4b9c37bba73UL, 0x9f5fa1370c59e023UL, 0x36960dd11dca7d4eUL, 0x1bb2293869e6eeaaUL } }, + { { 0xa7bb52bda67d2ce5UL, 0xd12b03267bae96bUL, 0x45ead6d4c0922699UL, 0x357633e5fd4e57bUL }, + { 0xf6caeb876f66196eUL, 0x5c88f8b1ea233a64UL, 0x6d24d190eef310f6UL, 0x2fa0d06ea9b6d35dUL } }, + { { 0x4bed4d1891ba154fUL, 0x2bf8026dae838260UL, 0xdcbd5388441e5626UL, 0xee0668e4e2fb0f6UL }, + { 0x8723a4e98854ba0bUL, 0x4d22e9a149ea8618UL, 0x5dda9a16aa96fb0aUL, 0x2fef151f315f190UL } } } }; + fq12 expected = { + { { { 0xe21af43e50f3c756UL, 0x382c59a08c2f1c63UL, 0xf111de6049209f49UL, 0x2e3e2eb02684cd0eUL }, + { 0x47a45c4171bbc927UL, 0x448a30a5e075a02dUL, 0x858bb40252898470UL, 0xdeca8c2fca67c78UL } }, + { { 0xd358397e360f2515UL, 0xfd6900b5784eb831UL, 0x64b0f2a74cb5b985UL, 0x303bdfa5683f19d3UL }, + { 0xee96f5c48ada25b8UL, 0xb17d89d5ee0965adUL, 0x5d90f2b14f0a7867UL, 0x11089d3bd9d1812fUL } }, + { { 0x8b4a37515d2483f4UL, 0xe2f2f3d7704a8333UL, 0x82a719484b992a0cUL, 0x8358f71dd30b350UL }, + { 0xff959db32aa39cd3UL, 0xb246a2f8b40c4889UL, 0xb9d5613c61fc64c3UL, 0x127acef64f2e0dfbUL } } }, + { { { 0xc2603367444cbf36UL, 0x4cebd20389e5d4eeUL, 0xcb3f9abc665e6992UL, 0x1290194e45a92b01UL }, + { 0x7c9e4c6727aa44d7UL, 0x7e9de180a367babUL, 0x500cb6ac8f91a2a0UL, 0x1f7ac11ce8c52bb3UL } }, + { { 0x3796fd3f2e8f6cddUL, 0xb93f0f07868dcf79UL, 0x69a0645a73c08c82UL, 0x665f5d67055274UL }, + { 0x3530dff683f60cd4UL, 0x49b935416224237eUL, 0x47e3654d3cdfd104UL, 0x143e9791ba51ee22UL } }, + { { 0xb8785e8bc743805UL, 0x9582592773c34113UL, 0x7ba82edd6f46c7deUL, 0xab7c56a5990bd53UL }, + { 0x6224e65eff5bd762UL, 0x9a1a4290432e0bb7UL, 0x94f2017f7fff74a3UL, 0x282d3d44ce884ea4UL } } } + }; +#endif + fq12 result = a.frobenius_map_three(); EXPECT_EQ(result, expected); } TEST(fq12, FrobeniusMapTwo) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x52c2cc6e77bfe9bb, 0xd03d98cc3fd6d95, 0xfaeb6d6577aa9a30, 0x1ea38b81330e34df }, { 0x1f55d493000a14f3, 0x1db7ec50e2f5a356, 0xf3cfcc74b91481ae, 0x256fe76342b33dbb } }, { { 0xf3e95f622620a0f9, 0xe297badf08d73c22, 0x4df25d06ae059cfb, 0x16db699bc5bbddcb }, @@ -365,12 +506,42 @@ TEST(fq12, FrobeniusMapTwo) { 0x2461a96edf6a6749, 0xe0c7f9244e8d0ed1, 0xb55df0a79cb9ac2c, 0xa357103af082354 } }, { { 0xe1148c424a589341, 0x40ab0d25fb7fd0d1, 0x7909a54a9569db90, 0x99bde98bbc4352f }, { 0xfaa4fdcf224e38ee, 0x42b25f170bf5f577, 0xc13bf097c75be619, 0xbcb9923cbd60387 } } } }; +#else + fq12 a = { { { { 0xa5ce9c060e396dd4UL, 0xca5ede3c56c9dfa1UL, 0xf7283a6cd7385eb1UL, 0xc9b4f2cc9e618bcUL }, + { 0x47ad703bb58adfb8UL, 0x82db8c7a94096d86UL, 0x3273057afe6fecfdUL, 0x249591a339c0b395UL } }, + { { 0xf743b6ee14c147f7UL, 0x72621d5bfc3ca617UL, 0xf1978b242a1f7200UL, 0x58c9abd859356f7UL }, + { 0x9fc148e808531ae4UL, 0x7e33428ce1e43d80UL, 0x8246ca0b17d04b6cUL, 0x13266ecc9ef22872UL } }, + { { 0xef813b9466e4f00dUL, 0x41be0a62083cce0UL, 0xb4bbcf52f290d43cUL, 0x255bcc4ea029409dUL }, + { 0xdef7a848a4ded44eUL, 0xcd9fc4819661004fUL, 0x28353ecc041c3066UL, 0x27a6a7890b897c1cUL } } }, + { { { 0x569b1e1b9916eab7UL, 0x77f844752482d618UL, 0xc8d2dfa5b90c75a1UL, 0x2b91d0892e6f3036UL }, + { 0xd83a28cd569274d7UL, 0xacd31b4648059115UL, 0x2d291841a5f79fffUL, 0x8853bfca3cd9a50UL } }, + { { 0xe904f05380da0bc2UL, 0xc9a74003c930b32fUL, 0x5a9981596b16c136UL, 0x2eea5b92180eb16eUL }, + { 0x18aea6c3fe1e03d1UL, 0xb8ac570097aafb8UL, 0x5e73d309f353e4f3UL, 0xc1004ae4756f68dUL } }, + { { 0x370079d737c6ed86UL, 0x298c4ec1f2b51e25UL, 0xdfc6f1416cbf760bUL, 0x2d5c11050cbe98d1UL }, + { 0x1462ea1f533b22a9UL, 0xb5262fc0a622613eUL, 0x6685b2cda9398a5cUL, 0x2fc6212886ea733aUL } } } }; + fq12 expected = { + { { { 0xa5ce9c060e396dd4UL, 0xca5ede3c56c9dfa1UL, 0xf7283a6cd7385eb1UL, 0xc9b4f2cc9e618bcUL }, + { 0x47ad703bb58adfb8UL, 0x82db8c7a94096d86UL, 0x3273057afe6fecfdUL, 0x249591a339c0b395UL } }, + { { 0x9828994245688eeaUL, 0xe5a280f898969f11UL, 0xb4b0ecd3af49dcc6UL, 0x21670b00576e3cafUL }, + { 0xd343da039e48db0eUL, 0xb3b4e737ecb54579UL, 0x1608becbcac11801UL, 0x8a492bd585ba0e3UL } }, + { { 0x249b9eedf5fd4d00UL, 0x61c05dafd482a437UL, 0x3e9c9f9aeb106d88UL, 0x9073e4985688fa5UL }, + { 0x264823249f36c1a0UL, 0xa7ad4a28f1311aeeUL, 0xa802735777a625bUL, 0x182813dd5fc55593UL } } }, + { { { 0x91e56d561fc65bf4UL, 0x91c74e7a38170c9bUL, 0xf8da19ddb4129b39UL, 0x4a864abc1999de1UL }, + { 0xf9dbb5cb6765f02eUL, 0x484221af215c12f1UL, 0x9dae4490f9df3878UL, 0x22d6e5b80da4cc69UL } }, + { { 0x531b9bc357a2f185UL, 0xcdda2a8d9f41175dUL, 0x5db6c45d166a9726UL, 0x179f2e0c922eebbUL }, + { 0x2371e552da5ef976UL, 0x8bf6a5215ef71ad5UL, 0x59dc72ac8e2d736aUL, 0x245449c499daa99cUL } }, + { { 0xb9ce3fc038247876UL, 0x88592556fd4f5aecUL, 0xcf53070ba4335fd6UL, 0x1121fc66315ce4f4UL }, + { 0xafbbe5445e5c30cfUL, 0x31c1f8e7a3a22522UL, 0x1d4c2afb60f35899UL, 0x26b4ff5552650fd4UL } } } + }; +#endif fq12 result = a.frobenius_map_two(); EXPECT_EQ(result, expected); } TEST(fq12, FrobeniusMapOne) { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x6c9edca7f0d6f6e, 0x7bb482de96b01e0, 0xb04fc4b2b2ea7e6, 0x4d9efc00ceb8323 }, { 0xb55c2222935ee583, 0x9c114ab89499b4da, 0x771cb5cabe1f458a, 0x1c3f0ac5303a5935 } }, { { 0x524feabf94af29ea, 0x95573536ab8b6ced, 0x524e16790930912c, 0x280d5af94a3424d0 }, @@ -395,6 +566,35 @@ TEST(fq12, FrobeniusMapOne) { 0x6602e7e93a714d67, 0x7398f14acf72c7e0, 0x8028d203d5e4928, 0x7d1fad57418b580 } }, { { 0xcba1922169de670, 0xcd20689212638b5e, 0x8dbbc53af7639bbb, 0x57a19a043d38c39 }, { 0x2b2d3090bfb1118b, 0xa752e789e316e0c7, 0xc1c4d33385bc3e10, 0x2610936b5468ba45 } } } }; +#else + fq12 a = { { { { 0x24dc150b5836f5ebUL, 0x30e4c608f40adc59UL, 0x37aeb841e150f3a8UL, 0xa110ca8f9db83e4UL }, + { 0x713a6ab73312e162UL, 0xdb0fd8d93b365d68UL, 0xedf1d282a8d07abeUL, 0x20d3d49231cde3bfUL } }, + { { 0x2eaf1da09933840aUL, 0x47c1d410d5df0b52UL, 0x919bba97feef2c11UL, 0x177b677e677a55cdUL }, + { 0xf888f6cf22cba791UL, 0xf820cd3640d260ebUL, 0x32742ec8e28152aeUL, 0x36fc6b21931e9e2UL } }, + { { 0x779044381bcbd101UL, 0x3f5ba296ae5db8faUL, 0xc2dbbc1691c8456aUL, 0x12d18799d91da0dUL }, + { 0xd089a63726293a6aUL, 0x77cd64002c1c4bcaUL, 0xd76a11cb5f5c0da6UL, 0x21add603f21af96eUL } } }, + { { { 0x8dcabcf31424c06fUL, 0x16bac862dc9fed95UL, 0xc1ae831f305040e5UL, 0x1e6200dce1120d3dUL }, + { 0xd1f5ad6845446895UL, 0x74526d8ca424b736UL, 0x849b3d172cc8381fUL, 0x12e88895f9e2a0d4UL } }, + { { 0x85cc8318ddbe2910UL, 0x961fb2e5108e0e4fUL, 0x781905321776e776UL, 0x2e8093940b560716UL }, + { 0x8b2ce4303baba4d9UL, 0x866a756e2161f73eUL, 0x1b230d82dbc3d550UL, 0x210f44fb356348c0UL } }, + { { 0xc57933e5530111baUL, 0xe45d80ed27b8a6b4UL, 0x7feeb0f2e09ca2cbUL, 0x1fdb773784242816UL }, + { 0xb5580ae30b1f6bf0UL, 0x51e1fbe74aad988dUL, 0x1a4e45b3185c094bUL, 0x1d0f5f64f6aa211aUL } } } }; + fq12 expected = { + { { { 0x24dc150b5836f5ebUL, 0x30e4c608f40adc59UL, 0x37aeb841e150f3a8UL, 0xa110ca8f9db83e4UL }, + { 0xcae6215fa56a1be5UL, 0xbc7191b82d3b6d24UL, 0xca5e7333d8b0dd9eUL, 0xf9079e0af63bc69UL } }, + { { 0x2691a685eb8b9e52UL, 0xc66888725d4805e4UL, 0xfc9cca7897e98f66UL, 0xbba94db29fe53ddUL }, + { 0x9f81e7019e774940UL, 0x36c0b8a5a6682687UL, 0x430a3924d0194d94UL, 0x2e938f15bd7f14a6UL } }, + { { 0x74e35b32ad2905fUL, 0x35afc43add46aeedUL, 0xb0309a03e6a3fe42UL, 0x3f0424b1202b900UL }, + { 0x1d98151eed9dceaeUL, 0x13f07d5ab22bb4fUL, 0xe14df7a387f2a2cfUL, 0x1ba0ba8d43259443UL } } }, + { { { 0x4d7742f9a326103fUL, 0x4f500f51726e60e7UL, 0xcce27ad8fe9043c1UL, 0x45db038f7fc875bUL }, + { 0x675053d4c95fe601UL, 0x8dc76ffbc91ef3feUL, 0x4b7246a3829a5be1UL, 0x2a53c42803e89a45UL } }, + { { 0xef087aab854dca2UL, 0x6de4ca5802af8bfaUL, 0xcc29efb20b2d894dUL, 0x2fef6cff0a2d4495UL }, + { 0x93ba40b513b8ba7dUL, 0x7d971482e420074aUL, 0x66c0477724426b3aUL, 0x849d2701d1e8f30UL } }, + { { 0xe2e17ffe4a45d62bUL, 0xdd88d28e131c0c19UL, 0x8e87d63b67ef6e60UL, 0x1e1648afd6dca6b4UL }, + { 0x867863dcd1ed7571UL, 0x1eb989092fbf511aUL, 0x38c3979e11e620f1UL, 0x846c4328f3ea4a5UL } } } + }; +#endif + fq12 result = a.frobenius_map_one(); EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp index ec4148ad2d1..fce8cc53521 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp @@ -5,6 +5,7 @@ namespace bb { struct Bn254Fq2Params { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq twist_coeff_b_0{ 0x3bf938e377b802a8UL, 0x020b1b273633535dUL, 0x26b7edf049755260UL, 0x2514c6324384a86dUL }; @@ -29,6 +30,32 @@ struct Bn254Fq2Params { static constexpr fq twist_cube_root_1{ 0xad607f911cfe17a8UL, 0xb6bb78aa154154c4UL, 0xb53dd351736b20dbUL, 0x1d8ed57c5cc33d41UL }; +#else + static constexpr fq twist_coeff_b_0{ + 0xdc19fa4aab489658UL, 0xd416744fbbf6e69UL, 0x8f7734ed0a8a033aUL, 0x19316b8353ee09bbUL + }; + static constexpr fq twist_coeff_b_1{ + 0x1cfd999a3b9fece0UL, 0xbe166fb279c1a7c7UL, 0xe93a1ba45580154cUL, 0x283739c94d11a9baUL + }; + static constexpr fq twist_mul_by_q_x_0{ + 0xecdea09b24a59190UL, 0x17db8ffeae2fe1c2UL, 0xbb09c97c6dabac4dUL, 0x2492b3d41d289af3UL + }; + static constexpr fq twist_mul_by_q_x_1{ + 0xf1663598f1142ef1UL, 0x77ec057e0bf56062UL, 0xdd0baaecb677a631UL, 0x135e4e31d284d463UL + }; + static constexpr fq twist_mul_by_q_y_0{ + 0xf46e7f60db1f0678UL, 0x31fc2eba5bcc5c3eUL, 0xedb3adc3086a2411UL, 0x1d46bd0f837817bcUL + }; + static constexpr fq twist_mul_by_q_y_1{ + 0x6b3fbdf579a647d5UL, 0xcc568fb62ff64974UL, 0xc1bfbf4ac4348ac6UL, 0x15871d4d3940b4d3UL + }; + static constexpr fq twist_cube_root_0{ + 0x49d0cc74381383d0UL, 0x9611849fe4bbe3d6UL, 0xd1a231d73067c92aUL, 0x445c312767932c2UL + }; + static constexpr fq twist_cube_root_1{ + 0x35a58c718e7c28bbUL, 0x98d42c77e7b8901aUL, 0xf9c53da2d0ca8c84UL, 0x1a68dd04e1b8c51dUL + }; +#endif }; using fq2 = field2; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp index 168b1c95ea7..0a0223b938d 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp @@ -51,46 +51,85 @@ TEST(fq2, RandomElement) TEST(fq2, MulCheckAgainstConstants) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0xd673ba38b8c4bc86, 0x860cd1cb9e2f0c85, 0x3185f9f9166177b7, 0xd043f963ced2529 }, { 0xd4d2fad9a3de5d98, 0x260f72ca434ef415, 0xca5c20c435accb2d, 0x122a54f828a07ffe } }; fq2 b = { { 0x37710e0986ad0fab, 0xd9b1f41ba9d3bd92, 0xf71f600e90104795, 0x24e1f6018a4d85c6 }, { 0x5e65448f225b0f60, 0x7783aecd5d7bfa84, 0xc7a76eed72d68723, 0xc8f427c031af99a } }; fq2 expected = { { 0x1652ca66b00ad519, 0x6619a315656ea7c7, 0x1d8491b044e9a08f, 0xcbe6d11bff2e56b }, { 0x9694fb422eff4e79, 0xebdbcf03e8539a17, 0xc4787fb63b8d10e8, 0x1a5cc397aae8811f } }; +#else + fq2 a = { { 0xed72e66054afa688UL, 0x58ee4e882533c50UL, 0x6e3d116ec0243404UL, 0x1d657f309417a3d8UL }, + { 0xc8d8ca2255efd3acUL, 0xa7dd5a778489041bUL, 0xa7c0d3f8a3894141UL, 0x96f1a285bc7de4UL } }; + fq2 b = { { 0x4b149f0c89ea36b8UL, 0x21c85d36fccb509UL, 0x9c6578b5dde8a9f5UL, 0x12d7656c2d09b4f5UL }, + { 0xeba4312d877a01c8UL, 0x346a85206bf0fc21UL, 0x326baffa4ec62182UL, 0xec5dbe959d2320bUL } }; + fq2 expected = { { 0xe954ec1f3d72b8e8UL, 0x7290e216a46a478UL, 0xee10085491294f00UL, 0x14ab2ea0f4cfac15UL }, + { 0xd4761ac17f9cfd69UL, 0x6be1ccd51ae4cf91UL, 0x51bb55a8d80b3ee6UL, 0x14ef3d5468c48133UL } }; +#endif + fq2 result = a * b; EXPECT_EQ(result, expected); } TEST(fq2, SqrCheckAgainstConstants) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x26402fd760069ee8, 0x17828cf3bf7dd3e3, 0x4e7449f7b1149987, 0x102f6467805d7298 }, { 0xa2a31bf895eaf6f8, 0xf0c88d415c372b16, 0xa65ccca8b7806691, 0x1b51e4526673451f } }; fq2 expected = { { 0xb51c9049894c45f3, 0xf8ef65c0244dfc90, 0x42c37c0f7d09aacb, 0x64ddfb845b2901f }, { 0x9e176fa8cdca97b1, 0xd04ae89dab7da31e, 0x637b83e950322d50, 0x155cccfadafc70b4 } }; +#else + fq2 a = { { 0x6ec082078bf1f83aUL, 0x54374c9db4892e0UL, 0x9b6685d51385bd3bUL, 0x22017c733fbe1168UL }, + { 0x1a19a57784951002UL, 0x71f829f22ee524e6UL, 0xd5f4ae41d4f49ba9UL, 0x32f0638f8eb6105UL } }; + fq2 expected = { { 0xb30fd8d5c794c944UL, 0xbfe70dbee7f867e1UL, 0x772e6b159b2ff808UL, 0x82abd3d318b8341UL }, + { 0x79264bd9e27d1c3eUL, 0xc0493fc1b97b501aUL, 0x5b0cad2ef132d4fbUL, 0x61d55130ed75444UL } }; +#endif + fq2 result = a.sqr(); EXPECT_EQ(result, expected); } TEST(fq2, AddCheckAgainstConstants) { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x517c157ce1664f30, 0x114ba401b0996437, 0x11b9ae2d856012e8, 0xcc19341ea7cf685 }, { 0x17c6020dde15fdc0, 0x310bc25961b2f002, 0xa766e7e94a865c0d, 0x20176bc8e6b82863 } }; fq2 b = { { 0xffad1c8ac38be684, 0x2a953b27cb1f541d, 0xfc12b9dfe76a0f12, 0x434c570deb975a6 }, { 0x87430d4b17897ace, 0x33ab4d0e55e8932a, 0xe4465ff65990dd31, 0x83db0b3c55f9e9f } }; fq2 expected = { { 0x51293207a4f235b4, 0x3be0df297bb8b855, 0xdcc680d6cca21fa, 0x10f658b2c9366c2c }, { 0x9f090f58f59f788e, 0x64b70f67b79b832c, 0x8bad47dfa417393e, 0x28551c7cac17c703 } }; +#else + fq2 a = { { 0x4e7e4ee568e1fbc8UL, 0x6d692baacf9e3280UL, 0x74b397fc9ff79a15UL, 0x150ff4a64611cf54UL }, + { 0xa14c3dc007ef12dUL, 0xb3da8d3ea50862adUL, 0xce474530b12f41f8UL, 0xab309b05df2e908UL } }; + fq2 b = { { 0x7d62792ac082d5f2UL, 0x23a48fd69306eea5UL, 0x11b6b08fea3f318aUL, 0x25d0113614cb748cUL }, + { 0xbbbeecf0b6be675dUL, 0x7fe28cf3b2d9708eUL, 0xef3aa23aaa94ec52UL, 0x15c08e3a45fbb32bUL } }; + fq2 expected = { { 0x8fc03bf950e7d473UL, 0xf98c50effa335698UL, 0xce1a02d608b57341UL, 0xa7bb76979aba3b6UL }, + { 0xc5d3b0ccb73d588aUL, 0x33bd1a3257e1d33bUL, 0xbd81e76b5bc42e4bUL, 0x207397eaa3ee9c34UL } }; +#endif fq2 result = a + b; EXPECT_EQ(result, expected); } TEST(fq2, SubCheckAgainstConstants) { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x3212c3a7d7886da5, 0xcea893f4addae4aa, 0x5c8bfca7a7ed01be, 0x1a8e9dfecd598ef1 }, { 0x4a8d9e6443fda462, 0x93248a3fde6374e7, 0xf4a6c52f75c0fc2e, 0x270aaabb4ae43370 } }; fq2 b = { { 0x875cef17b3b46751, 0xbba7211cb92b554b, 0xa4790f1657f85606, 0x74e61182f5b5068 }, { 0x8a84fff282dfd5a3, 0x77986fd41c21a7a3, 0xdc7072908fe375a9, 0x2e98a18c7d570269 } }; fq2 expected = { { 0xaab5d49023d40654, 0x130172d7f4af8f5e, 0xb812ed914ff4abb8, 0x13403ce69dfe3e88 }, { 0xfc292a88999acc06, 0xb30d84fd2ab397d0, 0xd0869855675edee2, 0x28d657a1aebed130 } }; +#else + fq2 a = { { 0x442f277690c0e2e9UL, 0xc57a6aedcbce21e5UL, 0x542af3d6640959a2UL, 0x1b2a8a38b6e63b66UL }, + { 0x72861e4d5b7fd051UL, 0x98eddfc89951d51eUL, 0x9501d71c127de4aeUL, 0x2789ae315eadca0bUL } }; + fq2 b = { { 0xfb1bb29b1498f504UL, 0x16de795183a37f3bUL, 0xade0cbf0f9055f61UL, 0x283ae93a66a38c6dUL }, + { 0x44cf93a2fd55060eUL, 0x31e37d7946df37e4UL, 0xf4a626aecf465a37UL, 0x27530019470f8857UL } }; + fq2 expected = { { 0x853400f254a4eb2cUL, 0x461d5c2db09c6d36UL, 0x5e9a6d9bec85529fUL, 0x2353ef7131744f22UL }, + { 0x2db68aaa5e2aca43UL, 0x670a624f52729d3aUL, 0xa05bb06d43378a77UL, 0x36ae18179e41b3UL } }; +#endif + fq2 result = a - b; EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp index 360b5d140d6..ca86ae26203 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp @@ -6,6 +6,8 @@ namespace bb { struct Bn254Fq6Params { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 frobenius_coeffs_c1_1{ { 0xb5773b104563ab30UL, 0x347f91c8a9aa6454UL, 0x7a007127242e0991UL, 0x1956bcd8118214ecUL }, { 0x6e849f1ea0aa4757UL, 0xaa1c7b6d89f89141UL, 0xb6e713cdfae0ca3aUL, 0x26694fbb4e82ebc3UL } @@ -35,6 +37,36 @@ struct Bn254Fq6Params { { 0x448a93a57b6762dfUL, 0xbfd62df528fdeadfUL, 0xd858f5d00e9bd47aUL, 0x06b03d4d3476ec58UL }, { 0x2b19daf4bcc936d1UL, 0xa1a54e7a56f4299fUL, 0xb533eee05adeaef1UL, 0x170c812b84dda0b2UL } }; +#else + static constexpr fq2 frobenius_coeffs_c1_1{ + { 0xecdea09b24a59190UL, 0x17db8ffeae2fe1c2UL, 0xbb09c97c6dabac4dUL, 0x2492b3d41d289af3UL }, + { 0xf1663598f1142ef1UL, 0x77ec057e0bf56062UL, 0xdd0baaecb677a631UL, 0x135e4e31d284d463UL } + }; + + static constexpr fq2 frobenius_coeffs_c1_2{ + { 0x8aeb638758ccb791UL, 0xee27476838ae0f5bUL, 0x5fc8441d09282bUL, 0x169119a8426a57f9UL }, { 0UL, 0UL, 0UL, 0UL } + }; + + static constexpr fq2 frobenius_coeffs_c1_3{ + { 0x4738e103136caecdUL, 0xf491475bc376b8c3UL, 0x1f4034a3a97cbee8UL, 0xcad5f8fef61ccd7UL }, + { 0x2f41c395e6e485d6UL, 0x997230c70242aa46UL, 0xeae16f2184887ab5UL, 0x266696f73bcfc9b2UL } + }; + + static constexpr fq2 frobenius_coeffs_c2_1{ + { 0x227346b0b081f85eUL, 0x6e51a67130492bb5UL, 0x7e20162e52b19e16UL, 0x1677516f2343bb4bUL }, + { 0x18b280852f616a78UL, 0x25433712bde06eceUL, 0xb00a58256b9a0e66UL, 0x6f9f8e111971bbdUL } + }; + + static constexpr fq2 frobenius_coeffs_c2_2{ + { 0x62b1a3a46a337995UL, 0xadc97d2722e2726eUL, 0x64ee82ede2db85faUL, 0xc0afea1488a03bbUL }, + { 0UL, 0UL, 0UL, 0UL } + }; + + static constexpr fq2 frobenius_coeffs_c2_3{ + { 0xa0d044540af866c4UL, 0x9cc0145f7df631b3UL, 0x29dda327cd752de1UL, 0x14766fdb0a170a74UL }, + { 0xdd532940e9d402f7UL, 0x541490c5bfda559eUL, 0xd9c9c659c541b0b8UL, 0xbaf8cb569cbb3e4UL } + }; +#endif // non residue = 9 + i \in Fq2 static inline constexpr fq2 mul_by_non_residue(const fq2& a) diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp index 370abd9a6e7..cc0c7e45abb 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp @@ -92,6 +92,7 @@ TEST(fq6, AddCheckAgainstConstants) { 0xf2431be14b4df482, 0xc9bb05cb691445b8, 0xf02ed57856eb46bb, 0x16dbf34bb8373fd5 } }, { { 0x8d683ec33bd2d09f, 0xbb76c48d1ad7befe, 0xfc20598f07f9868f, 0x2251f84b9cb740d7 }, { 0x91137730616d416f, 0x7892e5f10d06fc71, 0x7115b23cadf2176, 0x243b593fe662d53 } } }; + fq6 result = a + b; EXPECT_EQ(result, expected); } @@ -122,6 +123,7 @@ TEST(fq6, SubCheckAgainstConstants) TEST(fq6, MulCheckAgainstConstants) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq6 a{ { { 0xa7e3494fc528b8c8, 0xc8c8906c9682e43f, 0xc6e76fc21152721c, 0x12a4c3ee3ff10dbd }, { 0x887ce62a3ae2a578, 0x70caee28e1942bac, 0xc1a58242c34ff94f, 0x0b154d910b492542 } }, { { 0x8c885006cc08667a, 0xee0b6c4a0dbb9592, 0xa755229d6272b51e, 0x2629b93f67eb8dd6 }, @@ -140,12 +142,35 @@ TEST(fq6, MulCheckAgainstConstants) { 0x4b2fbc422420f06a, 0x3a8e5b388fdedd1f, 0x06006b4471134540, 0x0d4fee4f7966d63d } }, { { 0x4ffcbaa876979a1c, 0x32b7c1ef7d251306, 0x1b4e0712f969804e, 0x200592dfe71b710f }, { 0xe3eb378754bfb1ac, 0x6b517c1cae53d784, 0xd1b29c0eb1e4d46f, 0x08b42f13fdd14172 } } }; +#else + fq6 a{ { { 0x2ae298e67f3b39acUL, 0xff010ec1eb070956UL, 0x392ab3b4183e1f35UL, 0xfe4d0656fce35c4UL }, + { 0x6ab8f0a770e9c20fUL, 0xf4d3db225768ebb4UL, 0x2a7e605adf75bf5eUL, 0xfeb8cfd40c94734UL } }, + { { 0xb1dc529e5cd81351UL, 0xf5ca210e8455ea86UL, 0xeacd84d9a8b502b9UL, 0xb6b7eb4ff9916c1UL }, + { 0xdb94de41ad3b48d0UL, 0x5953eb9473583fe8UL, 0xa603759c9ad36f81UL, 0x229e55e6aa957e6UL } }, + { { 0x3c0c61a8882bdd6cUL, 0xd8fe0e66857b4d54UL, 0xb39ce4d438c3eb07UL, 0x2c6333d09ff65713UL }, + { 0x79d7e64184f4cbb1UL, 0x46523cfdd9722bd8UL, 0xdb3fdb38faf61435UL, 0xe8198361076a5a5UL } } }; + fq6 b{ { { 0x1ac3b1e7ec8a731cUL, 0xbb7de52d99e73d29UL, 0x4caac2356d446d23UL, 0x929876b197c1767UL }, + { 0x46e1737df8be5c58UL, 0x3d2d14ad3aa1890cUL, 0x659c80230fad0fa0UL, 0xd47f2fbefb5fbabUL } }, + { { 0x8b4d2a252c11fd02UL, 0x415b985e57d8c07aUL, 0x864441c79f72d7b5UL, 0x143306f7ce4da3aeUL }, + { 0xd76ea5fe36f41c42UL, 0xc546a55497cb7e0aUL, 0x6027b6dc6f841d13UL, 0x2d7f5a564d5981b5UL } }, + { { 0xf8fced7f8d6ce98UL, 0x46d85360675c5f7bUL, 0x663867cd6a61f912UL, 0x1c3fbd1c4728ce2fUL }, + { 0xd7681e6bff8abe8bUL, 0x951b03f1bffa2c2fUL, 0x66fd7a89c9ec33b2UL, 0xc425d325d08a85fUL } } }; + fq6 expected{ { { 0xccc2041ef7e674a1UL, 0xf2f0e47f82792d77UL, 0xb4b9f006110451c9UL, 0xdae59051f5a8c62UL }, + { 0x9482d60673539368UL, 0x42c40af4541687e4UL, 0x67c6919c35403c12UL, 0xb8254cf01cba09eUL } }, + { { 0x3b942b02bf094a1UL, 0xff838144f8716d23UL, 0x8530532ec620bef1UL, 0x25d5c85a56786593UL }, + { 0x84f3278dc0362308UL, 0x95c01286b84d4f7fUL, 0xfd8b3ada165de51aUL, 0x26db5658234dc652UL } }, + { { 0x10ebd72f10b27cadUL, 0xe95a8002134cc334UL, 0x4b2b2a668d93ca18UL, 0x877ec906a5bfe77UL }, + { 0x50c434785d85431dUL, 0x74a86ebec041fbdaUL, 0x9cc22545b513d419UL, 0x24905a4154300d89UL } } }; +#endif + fq6 result = a * b; EXPECT_EQ(result, expected); } TEST(fq6, SqrCheckAgainstConstants) { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq6 a{ { { 0xe337aaa063afce6, 0xff4b5477485eb20, 0xef6dcf13b3855ef8, 0x14554c38da988ece }, { 0x6a70e65e71431416, 0xd21f95045c45f422, 0x2a17b6c6ff517884, 0x1b01ad6487a3ff16 } }, { { 0xea39618e9f05e1f, 0x63e9b0f7803072a6, 0xebe5538a2c75c89, 0x5312aad2ac95dcf }, @@ -158,6 +183,21 @@ TEST(fq6, SqrCheckAgainstConstants) { 0xd48ac80d8e6e52b5, 0x1791b8c4145bc2d3, 0x35c456444cdcf9be, 0x1eddd29d77366c08 } }, { { 0x56f1f8acbaed1118, 0xdd74b8bb2e47de74, 0x97525aa49c65f0fd, 0x15bbf236e098fa0f }, { 0xad97a94142524aeb, 0x42a508523527268b, 0x4c9c5f213de06ca8, 0x73fa6bc31efa2f2 } } }; +#else + fq6 a{ { { 0xb8c83817c906c025UL, 0x4d043f8c42f61ad5UL, 0x91a65831dd1a6241UL, 0x15918b45e38cb7bfUL }, + { 0x4ff37e49c815b109UL, 0x345a8ce3993010ecUL, 0x5a237c150983263UL, 0x298c76f000344000UL } }, + { { 0x20111ed8b494cc0bUL, 0xb6b1df3bccb8f51aUL, 0xaed9d5f0d4678813UL, 0x14f86a4cb596d964UL }, + { 0x69bc7d9504b28c8fUL, 0xe0d8603ce6221c7bUL, 0x23ca4fa0d532663fUL, 0x1a80d9d5b362f1a2UL } }, + { { 0x25eb400748a0cf37UL, 0x89d64fd9d5bf6d15UL, 0x5d26ffdaa12d840cUL, 0x2569403a2168757UL }, + { 0xcdec65e163c03266UL, 0xd10e3957cf3b72b0UL, 0xec521e4d37493492UL, 0x129d95f2098a2ca4UL } } }; + fq6 expected{ { { 0x3c4bcc8dcefcaceeUL, 0x34ab9174317f1e3aUL, 0x1ef0e16468a08463UL, 0x15d11e13ea53477bUL }, + { 0xa863e40cfbb3daa5UL, 0xce21a9ece91fa28dUL, 0x18f8b8d5131d5b16UL, 0x217cae35f576c1cUL } }, + { { 0xc9c6c70ba08b73c0UL, 0xcad2cccbf550a886UL, 0xfc81330087d97569UL, 0x887ec11880851c1UL }, + { 0xdece0fe8e4068d14UL, 0x1c1ac52662948771UL, 0x524556477d845073UL, 0x13e432b54eecfdc4UL } }, + { { 0x94776c5786cc491eUL, 0x6583437212c2bad1UL, 0xd5e7849877ab4a9dUL, 0x1201fc93c2687faaUL }, + { 0xc272f7cce8556844UL, 0xf69b6001031da740UL, 0xb24acd4db6083391UL, 0x26639dbab92ddda2UL } } }; +#endif + fq6 result = a.sqr(); EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp index cf43e95d569..fcf2bc16a55 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp @@ -63,6 +63,49 @@ class Bn254FrParams { 0x463456c802275bedULL, 0x543ece899c2f3b1cULL, 0x180a96573d3d9f8ULL, 0xf8b21270ddbb927ULL, 0x1d9598e8a7e39857ULL, 0x2ba010aa41eb7786ULL, 0x39aa886bdbf356b5ULL, 0x47b5002d75fb35e5ULL, }; + + static constexpr uint64_t modulus_wasm_0 = 0x10000001; + static constexpr uint64_t modulus_wasm_1 = 0x1f0fac9f; + static constexpr uint64_t modulus_wasm_2 = 0xe5c2450; + static constexpr uint64_t modulus_wasm_3 = 0x7d090f3; + static constexpr uint64_t modulus_wasm_4 = 0x1585d283; + static constexpr uint64_t modulus_wasm_5 = 0x2db40c0; + static constexpr uint64_t modulus_wasm_6 = 0xa6e141; + static constexpr uint64_t modulus_wasm_7 = 0xe5c2634; + static constexpr uint64_t modulus_wasm_8 = 0x30644e; + + static constexpr uint64_t r_squared_wasm_0 = 0x38c2e14b45b69bd4UL; + static constexpr uint64_t r_squared_wasm_1 = 0x0ffedb1885883377UL; + static constexpr uint64_t r_squared_wasm_2 = 0x7840f9f0abc6e54dUL; + static constexpr uint64_t r_squared_wasm_3 = 0x0a054a3e848b0f05UL; + + static constexpr uint64_t cube_root_wasm_0 = 0x7334a1ce7065364dUL; + static constexpr uint64_t cube_root_wasm_1 = 0xae21578e4a14d22aUL; + static constexpr uint64_t cube_root_wasm_2 = 0xcea2148a96b51265UL; + static constexpr uint64_t cube_root_wasm_3 = 0x0038f7edf614a198UL; + + static constexpr uint64_t primitive_root_wasm_0 = 0x2faf11711a27b370UL; + static constexpr uint64_t primitive_root_wasm_1 = 0xc23fe9fced28f1b8UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x43a0fc9bbe2af541UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x05d90b5719653a4fUL; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0xab46711cdffffcb2ULL, 0xdb1b52736ffffc09ULL, + 0x0af033c9fffffb60ULL, 0xf6e31f8c9ffffab6ULL, + 0x26b800e32ffffa0dULL, 0x568ce239bffff964ULL, + 0x427fcdfc5ffff8baULL, 0x7254af52effff811ULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0x2476607dbd2dfff1ULL, 0x9a3208a561c2b00bULL, + 0x0fedb0cd06576026ULL, 0x5d7570ac31329faeULL, + 0xd33118d3d5c74fc9ULL, 0x48ecc0fb7a5bffe3ULL, + 0x967480daa5373f6cULL, 0x0c30290249cbef86ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0xe6b99ee0068dfc25ULL, 0x39bb9964882aa6a5ULL, + 0x8cbd93e909c75126ULL, 0x276f48b709e2a349ULL, + 0x7a71433b8b7f4dc9ULL, 0xcd733dc00d1bf84aULL, + 0x6824f28e0d374a6dULL, 0xbb26ed128ed3f4eeULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x1484c05bce00b620ULL, 0x224cf685243dfa96ULL, + 0x30152cae7a7b3f0bULL, 0x0d791464ef86e357ULL, + 0x1b414a8e45c427ccULL, 0x290980b79c016c41ULL, + 0x066d686e110d108dULL, 0x14359e97674a5502ULL }; + // used in msgpack schema serialization static constexpr char schema_name[] = "fr"; static constexpr bool has_high_2adicity = true; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp index 2b2fa35fb75..7d2d89edd04 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp @@ -56,9 +56,12 @@ TEST(fr, RandomElement) TEST(fr, Mul) { - fr a{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; - fr b{ 0x7aade4892631231c, 0x8e7515681fe70144, 0x98edb76e689b6fd8, 0x5d0886b15fc835fa }; - fr expected{ 0xab961ef46b4756b6, 0xbc6b636fc29678c8, 0xd247391ed6b5bd16, 0x12e8538b3bde6784 }; + auto a_uint = uint256_t{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; + auto b_uint = uint256_t{ 0x7aade4892631231c, 0x8e7515681fe70144, 0x98edb76e689b6fd8, 0x5d0886b15fc835fa }; + + fr a = a_uint; + fr b = b_uint; + fr expected = (uint512_t(a_uint) * uint512_t(b_uint) % uint512_t(fr::modulus)).lo; fr result; result = a * b; EXPECT_EQ((result == expected), true); @@ -66,8 +69,9 @@ TEST(fr, Mul) TEST(fr, Sqr) { - fr a{ 0x95f946723a1fc34f, 0x641ec0482fc40bb9, 0xb8d645bc49dd513d, 0x1c1bffd317599dbc }; - fr expected{ 0xc787f7d9e2c72714, 0xcf21cf53d8f65f67, 0x8db109903dac0008, 0x26ab4dd65f46be5f }; + auto a_uint = uint256_t{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; + fr a = a_uint; + fr expected = (uint512_t(a_uint) * uint512_t(a_uint) % uint512_t(fr::modulus)).lo; fr result; result = a.sqr(); EXPECT_EQ((result == expected), true); diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp index ef5240fad94..28cd3036eba 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp @@ -11,9 +11,17 @@ struct Bn254G1Params { static constexpr bool small_elements = true; static constexpr bool has_a = false; static constexpr fq one_x = fq::one(); +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq one_y{ 0xa6ba871b8b1e1b3aUL, 0x14f1d651eb8e167bUL, 0xccdd46def0f28c58UL, 0x1c14ef83340fbe5eUL }; +#else + static constexpr fq one_y{ 0x9d0709d62af99842UL, 0xf7214c0419c29186UL, 0xa603f5090339546dUL, 0x1b906c52ac7a88eaUL }; +#endif static constexpr fq a{ 0UL, 0UL, 0UL, 0UL }; +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq b{ 0x7a17caa950ad28d7UL, 0x1f6ac17ae15521b9UL, 0x334bea4e696bd284UL, 0x2a1f6744ce179d8eUL }; +#else + static constexpr fq b{ 0xeb8a8ec140766463UL, 0xf2b1f20626a3da49UL, 0xf905ef8d84d5fea4UL, 0x2958a27c02b7cd5fUL }; +#endif }; using g1 = group; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp index 37c84d4517d..78ede0cdc98 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp @@ -11,10 +11,21 @@ struct Bn254G2Params { static constexpr bool small_elements = false; static constexpr bool has_a = false; +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 one_x{ { 0x8e83b5d102bc2026, 0xdceb1935497b0172, 0xfbb8264797811adf, 0x19573841af96503b }, { 0xafb4737da84c6140, 0x6043dd5a5802d8c4, 0x09e950fc52a02f86, 0x14fef0833aea7b6b } }; static constexpr fq2 one_y{ { 0x619dfa9d886be9f6, 0xfe7fd297f59e9b78, 0xff9e1a62231b7dfe, 0x28fd7eebae9e4206 }, { 0x64095b56c71856ee, 0xdc57f922327d3cbb, 0x55f935be33351076, 0x0da4a0e693fd6482 } }; +#else + static constexpr fq2 one_x{ + { 0xe6df8b2cfb43050UL, 0x254c7d92a843857eUL, 0xf2006d8ad80dd622UL, 0x24a22107dfb004e3UL }, + { 0xe8e7528c0b334b65UL, 0x56e941e8b293cf69UL, 0xe1169545c074740bUL, 0x2ac61491edca4b42UL } + }; + static constexpr fq2 one_y{ + { 0xdc508d48384e8843UL, 0xd55415a8afd31226UL, 0x834bf204bacb6e00UL, 0x51b9758138c5c79UL }, + { 0x64067e0b46a5f641UL, 0x37726529a3a77875UL, 0x4454445bd915f391UL, 0x10d5ac894edeed3UL } + }; +#endif static constexpr fq2 a = fq2::zero(); static constexpr fq2 b = fq2::twist_coeff_b(); }; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp index fd6e1c36268..fc81216686a 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp @@ -16,15 +16,25 @@ struct G1Params { static constexpr bool can_hash_to_curve = true; static constexpr bool small_elements = true; static constexpr bool has_a = false; - // have checked in grumpkin.test_b that b is Montgomery form of -17 +// have checked in grumpkin.test_b that b is Montgomery form of -17 +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr bb::fr b{ 0xdd7056026000005a, 0x223fa97acb319311, 0xcc388229877910c0, 0x34394632b724eaa }; +#else + static constexpr bb::fr b{ 0x2646d52420000b3eUL, 0xf78d5ec872bf8119UL, 0x166fb9c3ec1f6749UL, 0x7a9ef7fabe69506UL }; +#endif static constexpr bb::fr a{ 0UL, 0UL, 0UL, 0UL }; // generator point = (x, y) = (1, sqrt(-16)), sqrt(-16) = 4i static constexpr bb::fr one_x = bb::fr::one(); +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr bb::fr one_y{ 0x11b2dff1448c41d8UL, 0x23d3446f21c77dc3UL, 0xaa7b8cf435dfafbbUL, 0x14b34cf69dc25d68UL }; +#else + static constexpr bb::fr one_y{ + 0xc3e285a561883af3UL, 0x6fc5c2360a850101UL, 0xf35e144228647aa9UL, 0x2151a2fe48c68af6UL + }; +#endif }; using g1 = bb::group; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp index 1d78dd1b3d1..81b575ad67b 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp @@ -43,6 +43,48 @@ struct FqParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; + + static constexpr uint64_t modulus_wasm_0 = 0x1ffffc2f; + static constexpr uint64_t modulus_wasm_1 = 0x1ffffff7; + static constexpr uint64_t modulus_wasm_2 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_3 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_4 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_6 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_7 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_8 = 0xffffff; + + static constexpr uint64_t r_squared_wasm_0 = 0x001e88003a428400UL; + static constexpr uint64_t r_squared_wasm_1 = 0x0000000000000400UL; + static constexpr uint64_t r_squared_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t r_squared_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t cube_root_wasm_0 = 0x1486c3a0d03162ffUL; + static constexpr uint64_t cube_root_wasm_1 = 0x7fbc2c63897015ebUL; + static constexpr uint64_t cube_root_wasm_2 = 0x1d312f1a05c720a0UL; + static constexpr uint64_t cube_root_wasm_3 = 0x4946d5d79767aa7fUL; + + static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0x0000006000016e60ULL, 0x000000800001e880ULL, + 0x000000a0000262a0ULL, 0x000000c00002dcc0ULL, + 0x000000e0000356e0ULL, 0x000001000003d100ULL, + 0x0000012000044b20ULL, 0x000001400004c540ULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL }; }; using fq = field; @@ -99,6 +141,48 @@ struct FrParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; + + static constexpr uint64_t modulus_wasm_0 = 0x10364141; + static constexpr uint64_t modulus_wasm_1 = 0x1e92f466; + static constexpr uint64_t modulus_wasm_2 = 0x12280eef; + static constexpr uint64_t modulus_wasm_3 = 0x1db9cd5e; + static constexpr uint64_t modulus_wasm_4 = 0x1fffebaa; + static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_6 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_7 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_8 = 0xffffff; + + static constexpr uint64_t r_squared_wasm_0 = 0x63e601a3c9f6ab4bUL; + static constexpr uint64_t r_squared_wasm_1 = 0xa2b6456d46702f57UL; + static constexpr uint64_t r_squared_wasm_2 = 0x5fd7916f341f1cefUL; + static constexpr uint64_t r_squared_wasm_3 = 0x9c7356071a6f179aUL; + + static constexpr uint64_t cube_root_wasm_0 = 0x9185b639102f0736UL; + static constexpr uint64_t cube_root_wasm_1 = 0x47a854ad9ffc4748UL; + static constexpr uint64_t cube_root_wasm_2 = 0x752cc0ca4d2fb232UL; + static constexpr uint64_t cube_root_wasm_3 = 0x650802f0ab1ac72eUL; + + static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0x1c84e7fdde173760ULL, 0x22391663d74f0f40ULL, + 0x27ed44c9d086e720ULL, 0x2da1732fc9bebf00ULL, + 0x3355a195c2f696e0ULL, 0x3909cffbbc2e6ec0ULL, + 0x3ebdfe61b56646a0ULL, 0x44722cc7ae9e1e80ULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0x52b5efd2729bdaa8ULL, 0xfcda52fc8987d330ULL, + 0xa6feb626a073cbb8ULL, 0x51231950b75fc440ULL, + 0xfb477c7ace4bbcc8ULL, 0xa56bdfa4e537b550ULL, + 0x4f9042cefc23add8ULL, 0xf9b4a5f9130fa660ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0x00000000000000cbULL, 0x00000000000000f3ULL, + 0x000000000000011cULL, 0x0000000000000145ULL, + 0x000000000000016dULL, 0x0000000000000196ULL, + 0x00000000000001bfULL, 0x00000000000001e7ULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL, + 0x0000000000000000ULL, 0x0000000000000000ULL }; }; using fr = field; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp index 82902e1c3f8..60d0f24af2a 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp @@ -70,7 +70,11 @@ TEST(secp256k1, TestToMontgomeryForm) uint256_t a_raw = get_fq_element(); secp256k1::fq montgomery_result(a_raw); - uint512_t R = uint512_t(0, 1); +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) + constexpr uint512_t R = uint512_t(0, 1); +#else + constexpr uint512_t R = (uint512_t(1) << (29 * 9)) % uint512_t(test_fq_mod); +#endif uint512_t aR = uint512_t(a_raw) * R; uint256_t expected = (aR % uint512_t(test_fq_mod)).lo; @@ -442,6 +446,9 @@ TEST(secp256k1, GetEndomorphismScalars) expected.self_from_montgomery_form(); EXPECT_EQ(k, expected); + if (k != expected) { + break; + } } } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp index 3835bfce10f..69e8e89b477 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp @@ -8,7 +8,7 @@ namespace bb::secp256r1 { struct FqParams { static constexpr uint64_t modulus_0 = 0xFFFFFFFFFFFFFFFFULL; static constexpr uint64_t modulus_1 = 0x00000000FFFFFFFFULL; - static constexpr uint64_t modulus_2 = 0X0000000000000000ULL; + static constexpr uint64_t modulus_2 = 0x0000000000000000ULL; static constexpr uint64_t modulus_3 = 0xFFFFFFFF00000001ULL; static constexpr uint64_t r_squared_0 = 3ULL; @@ -42,6 +42,48 @@ struct FqParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; + + static constexpr uint64_t modulus_wasm_0 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_1 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_2 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_3 = 0x1ff; + static constexpr uint64_t modulus_wasm_4 = 0x0; + static constexpr uint64_t modulus_wasm_5 = 0x0; + static constexpr uint64_t modulus_wasm_6 = 0x40000; + static constexpr uint64_t modulus_wasm_7 = 0x1fe00000; + static constexpr uint64_t modulus_wasm_8 = 0xffffff; + + static constexpr uint64_t r_squared_wasm_0 = 0x0000000000000c00UL; + static constexpr uint64_t r_squared_wasm_1 = 0xffffeffffffffc00UL; + static constexpr uint64_t r_squared_wasm_2 = 0xfffffffffffffbffUL; + static constexpr uint64_t r_squared_wasm_3 = 0x000013fffffff7ffUL; + + static constexpr uint64_t cube_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0x0000000000000060ULL, 0x0000000000000080ULL, + 0x00000000000000a0ULL, 0x00000000000000c0ULL, + 0x00000000000000e0ULL, 0x0000000000000100ULL, + 0x0000000000000120ULL, 0x0000000000000140ULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0xffffffa000000000ULL, 0xffffff8000000000ULL, + 0xffffff6000000000ULL, 0xffffff4000000000ULL, + 0xffffff2000000000ULL, 0xffffff0000000000ULL, + 0xfffffee000000000ULL, 0xfffffec000000000ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0xffffffffffffffffULL, 0xffffffffffffffffULL, + 0xffffffffffffffffULL, 0xffffffffffffffffULL, + 0xffffffffffffffffULL, 0xffffffffffffffffULL, + 0xffffffffffffffffULL, 0xffffffffffffffffULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000005fffffff9fULL, 0x0000007fffffff7fULL, + 0x0000009fffffff5fULL, 0x000000bfffffff3fULL, + 0x000000dfffffff1fULL, 0x000000fffffffeffULL, + 0x0000011ffffffedfULL, 0x0000013ffffffebfULL }; }; using fq = field; @@ -83,6 +125,48 @@ struct FrParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; + + static constexpr uint64_t modulus_wasm_0 = 0x1c632551; + static constexpr uint64_t modulus_wasm_1 = 0x1dce5617; + static constexpr uint64_t modulus_wasm_2 = 0x5e7a13c; + static constexpr uint64_t modulus_wasm_3 = 0xdf55b4e; + static constexpr uint64_t modulus_wasm_4 = 0x1ffffbce; + static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; + static constexpr uint64_t modulus_wasm_6 = 0x3ffff; + static constexpr uint64_t modulus_wasm_7 = 0x1fe00000; + static constexpr uint64_t modulus_wasm_8 = 0xffffff; + + static constexpr uint64_t r_squared_wasm_0 = 0x45e9cfeeb48d9ef5UL; + static constexpr uint64_t r_squared_wasm_1 = 0x1f11fc5bb2d31a99UL; + static constexpr uint64_t r_squared_wasm_2 = 0x16c8e4adafb16586UL; + static constexpr uint64_t r_squared_wasm_3 = 0x84b6556a65587f06UL; + + static constexpr uint64_t cube_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t cube_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; + static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; + + static constexpr uint64_t coset_generators_wasm_0[8] = { 0xbd6e9563293f5920ULL, 0x46353d039cdaaf00ULL, + 0xcefbe4a4107604e0ULL, 0x57c28c4484115ac0ULL, + 0xe08933e4f7acb0a0ULL, 0x694fdb856b480680ULL, + 0xf2168325dee35c60ULL, 0x7add2ac6527eb240ULL }; + static constexpr uint64_t coset_generators_wasm_1[8] = { 0xb5e4a80dcb554baaULL, 0x19055258e8617b0cULL, + 0x7c25fca4056daa6dULL, 0xdf46a6ef2279d9cfULL, + 0x4267513a3f860930ULL, 0xa587fb855c923892ULL, + 0x08a8a5d0799e67f3ULL, 0x6bc9501b96aa9755ULL }; + static constexpr uint64_t coset_generators_wasm_2[8] = { 0x000000000000003aULL, 0x0000000000000043ULL, + 0x000000000000004bULL, 0x0000000000000053ULL, + 0x000000000000005cULL, 0x0000000000000064ULL, + 0x000000000000006dULL, 0x0000000000000075ULL }; + static constexpr uint64_t coset_generators_wasm_3[8] = { 0x000000dfffffff20ULL, 0x000000ffffffff00ULL, + 0x0000011ffffffee0ULL, 0x0000013ffffffec0ULL, + 0x0000015ffffffea0ULL, 0x0000017ffffffe80ULL, + 0x0000019ffffffe60ULL, 0x000001bffffffe40ULL }; }; using fr = field; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp index 3e993586242..0b2befbb745 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp @@ -70,7 +70,11 @@ TEST(secp256r1, TestToMontgomeryForm) uint256_t a_raw = get_fq_element(); secp256r1::fq montgomery_result(a_raw); - uint512_t R = uint512_t(0, 1); +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) + constexpr uint512_t R = uint512_t(0, 1); +#else + constexpr uint512_t R = (uint512_t(1) << (29 * 9)) % uint512_t(test_fq_mod); +#endif uint512_t aR = uint512_t(a_raw) * R; uint256_t expected = (aR % uint512_t(test_fq_mod)).lo; @@ -434,6 +438,7 @@ TEST(secp256r1, check_compression_constructor) std::cout << "Affine element: " << el << std::endl; }**/ +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) TEST(secp256r1, MontgomeryMulBigBug) { secp256r1::fr a; @@ -445,3 +450,4 @@ TEST(secp256r1, MontgomeryMulBigBug) secp256r1::fr expected(uint256_t{ 0x57abc6aa0349c084, 0x65b21b232a4cb7a5, 0x5ba781948b0fcd6e, 0xd6e9e0644bda12f7 }); EXPECT_EQ((a_sqr == expected), true); } +#endif \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp index 87a10938677..18a7480a3d0 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp @@ -21,6 +21,11 @@ #endif namespace bb { +/** + * @brief General class for prime fields see \ref field_docs["field documentation"] for general implementation reference + * + * @tparam Params_ + */ template struct alignas(32) field { public: using View = field; @@ -30,6 +35,11 @@ template struct alignas(32) field { using out_buf = uint8_t*; using vec_out_buf = uint8_t**; +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) +#define WASM_NUM_LIMBS 9 +#define WASM_LIMB_BITS 29 +#endif + // We don't initialize data in the default constructor since we'd lose a lot of time on huge array initializations. // Other alternatives have been noted, such as casting to get around constructors where they matter, // however it is felt that sanitizer tools (e.g. MSAN) can detect garbage well, whereas doing @@ -159,14 +169,34 @@ template struct alignas(32) field { static constexpr uint256_t modulus = uint256_t{ Params::modulus_0, Params::modulus_1, Params::modulus_2, Params::modulus_3 }; +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) + static constexpr uint256_t r_squared_uint{ + Params_::r_squared_0, Params_::r_squared_1, Params_::r_squared_2, Params_::r_squared_3 + }; +#else + static constexpr uint256_t r_squared_uint{ + Params_::r_squared_wasm_0, Params_::r_squared_wasm_1, Params_::r_squared_wasm_2, Params_::r_squared_wasm_3 + }; + static constexpr std::array wasm_modulus = { Params::modulus_wasm_0, Params::modulus_wasm_1, + Params::modulus_wasm_2, Params::modulus_wasm_3, + Params::modulus_wasm_4, Params::modulus_wasm_5, + Params::modulus_wasm_6, Params::modulus_wasm_7, + Params::modulus_wasm_8 }; +#endif static constexpr field cube_root_of_unity() { // endomorphism i.e. lambda * [P] = (beta * x, y) if constexpr (Params::cube_root_0 != 0) { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) constexpr field result{ Params::cube_root_0, Params::cube_root_1, Params::cube_root_2, Params::cube_root_3 }; +#else + constexpr field result{ + Params::cube_root_wasm_0, Params::cube_root_wasm_1, Params::cube_root_wasm_2, Params::cube_root_wasm_3 + }; +#endif return result; } else { constexpr field two_inv = field(2).invert(); @@ -182,35 +212,65 @@ template struct alignas(32) field { static constexpr field external_coset_generator() { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[7], Params::coset_generators_1[7], Params::coset_generators_2[7], Params::coset_generators_3[7], }; +#else + const field result{ + Params::coset_generators_wasm_0[7], + Params::coset_generators_wasm_1[7], + Params::coset_generators_wasm_2[7], + Params::coset_generators_wasm_3[7], + }; +#endif + return result; } static constexpr field tag_coset_generator() { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[6], Params::coset_generators_1[6], Params::coset_generators_2[6], Params::coset_generators_3[6], }; +#else + const field result{ + Params::coset_generators_wasm_0[6], + Params::coset_generators_wasm_1[6], + Params::coset_generators_wasm_2[6], + Params::coset_generators_wasm_3[6], + }; +#endif + return result; } static constexpr field coset_generator(const size_t idx) { ASSERT(idx < 7); +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[idx], Params::coset_generators_1[idx], Params::coset_generators_2[idx], Params::coset_generators_3[idx], }; +#else + const field result{ + Params::coset_generators_wasm_0[idx], + Params::coset_generators_wasm_1[idx], + Params::coset_generators_wasm_2[idx], + Params::coset_generators_wasm_3[idx], + }; +#endif + return result; } @@ -247,6 +307,7 @@ template struct alignas(32) field { BB_INLINE constexpr field pow(const uint256_t& exponent) const noexcept; BB_INLINE constexpr field pow(uint64_t exponent) const noexcept; + static_assert(Params::modulus_0 != 1); static constexpr uint256_t modulus_minus_two = uint256_t(Params::modulus_0 - 2ULL, Params::modulus_1, Params::modulus_2, Params::modulus_3); constexpr field invert() const noexcept; @@ -520,6 +581,29 @@ template struct alignas(32) field { {} }; +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) + BB_INLINE static constexpr void wasm_madd(uint64_t& left_limb, + const std::array& right_limbs, + uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8); + BB_INLINE static constexpr void wasm_reduce(uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8); + BB_INLINE static constexpr std::array wasm_convert(const uint64_t* data); +#endif BB_INLINE static constexpr std::pair mul_wide(uint64_t a, uint64_t b) noexcept; BB_INLINE static constexpr uint64_t mac( diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md b/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md new file mode 100644 index 00000000000..76f1bc30643 --- /dev/null +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md @@ -0,0 +1,190 @@ +Prime field documentation {#field_docs} +=== +Barretenberg has its own implementation of finite field arithmetic. The implementation targets 254 (bn254, grumpkin) and 256-bit (secp256k1, secp256r1) fields. Internally the field is representate as a little-endian C-array of 4 uint64_t limbs. + +## Field arithmetic +### Introduction to Montgomery form {#field_docs_montgomery_explainer} +We use Montgomery reduction to speed up field multiplication. For an original element \f$ a ∈ F_p\f$ the element is represented internally as $$ a⋅R\ mod\ p$$ where \f$R = 2^d\ mod\ p\f$. The chosen \f$d\f$ depends on the build configuration: +1. \f$d=29⋅9=261\f$ for builds that don't support the uint128_t type, for example, for WASM build +2. \f$d=64⋅4=256\f$ for standard builds (x86_64). + +The goal of using Montgomery form is to avoid heavy division modulo \f$p\f$. To compute a representative of element $$c = a⋅b\ mod\ p$$ we compute $$c⋅R = (a⋅R)⋅(b⋅R) / R\ mod\ p$$, but we use an efficient division trick to avoid straight modular division. Let's look into the standard 4⋅64 case: +1. First, we compute the value $$c_r=c⋅R⋅R = aR⋅bR$$ in integers and get a value with 8 64-bit limbs +2. Then we take the lowest limb of \f$c_r\f$ (\f$c_r[0]\f$) and multiply it by a special value $$r_{inv} = -1 ⋅ p^{-1}\ mod\ 2^{64}$$ As a result we get $$k = r_{inv}⋅ c_r[0]\ mod\ 2^{64}$$ +3. Next we update \f$c_r\f$ in integers by adding a value \f$k⋅p\f$: $$c_r += k⋅p$$ You might notice that the value of \f$c_r\ mod\ p\f$ hasn't changed, since we've added a multiple of the modulus. A the same time, if we look at the expression modulo \f$2^{64}\f$: $$c_r + k⋅p = c_r + c_r⋅r_{inv}⋅p = c_r + c_r⋅ (-1)⋅p^{-1}⋅p = c_r - c_r = 0\ mod\ 2^{64}$$ The result is equivalent modulo \f$p\f$, but we zeroed out the lowest limb +4. We perform the same operation for \f$c_r[1]\f$, but instead of adding \f$k⋅p\f$, we add \f$2^{64}⋅k⋅p\f$. In the implementation, instead of adding \f$k⋅ p\f$ to limbs of \f$c_r\f$ starting with zero, we just start with limb 1. This ensures that \f$c_r[1]=0\f$. We then perform the same operation for 2 more limbs. +5. At this stage we are left with a version of \f$c_r\f$ where the first 4 limbs of the total 8 limbs are zero. So if we treat the 4 high limbs as a separate integer \f$c_{r.high}\f$, $$c_r = c_{r.high}⋅2^{256}=c_{r.high}⋅R\ mod\ p \Rightarrow c_{r.high} = c\cdot R\ mod\ p$$ and we can get the evaluation simply by taking the 4 high limbs of \f$c_r\f$. +6. The previous step has reduced the intermediate value of \f$cR\f$ to range \f$[0,2p)\f$, so we must check if it is more than \f$p\f$ and subtract the modulus once if it overflows. + +Why does this work? Originally both \f$aR\f$ and \f$bR\f$ are less than the modulus \f$p\f$ in integers, so $$aR\cdot bR <= (p-1)^2$$ During each of the \f$k\cdot p\f$ addition rounds we can add at most \f$(2^{64}-1)p\f$ to corresponding digits, so at most we add \f$(2^{256}-1)p\f$ and the total is $$aR\cdot bR + k_{0,1,2,3}p \le (p-1)^2+(2^{256}-1)p < 2\cdot 2^{256}p \Rightarrow c_{r.high} = \frac{aR\cdot bR + k_{0,1,2,3}p}{2^{256}} < 2p$$. + +For bn254 scalar and base fields we can do even better by employing a simple trick. The moduli of both fields are 254 bits, while 4 64-bit limbs allow 256 bits of storage. We relax the internal representation to use values in range \f$[0,2p)\f$. The addition, negation and subtraction operation logic doesn't change, we simply replace the modulus \f$p\f$ with \f$2p\f$, but the mutliplication becomes more efficient. The multiplicands are in range \f$[0,2p)\f$, but we add multiples of modulus \f$p\f$ to reduce limbs, not \f$2p\f$. If we revisit the \f$c_r\f$ formula: +$$aR\cdot bR + k_{0,1,2,3}p \le (2p-1)^2+(2^{256}-1)p = 2^{256}p+4p^2-5p+1 \Rightarrow$$ $$\Rightarrow c_{r.high} = \frac{aR\cdot bR + k_{0,1,2,3}p}{2^{256}} \le \frac{2^{256}p+4p^2-5p+1}{2^{256}}=p +\frac{4p^2 - 5p +1}{2^{256}}, 4p < 2^{256} \Rightarrow$$ $$\Rightarrow p +\frac{4p^2 - 5p +1}{2^{256}} < 2p$$ So we ended in the same range and we don't have to perform additional reductions. + +**N.B.** In the code we refer to this form as coarse + + + + +### Converting to and from Montgomery form +Obviously we want to avoid using standard form division when converting between forms, so we use Montgomery form to convert to Montgomery form. If we look at a value \f$a\ mod\ p\f$ we can notice that this is the Montgomery form of \f$a\cdot R^{-1}\ mod\ p\f$, so if we want to get \f$aR\f$ from it, we need to multiply it by the Montgomery form of \f$R\ mod\ p\f$, which is \f$R\cdot R\ mod\ p\f$. So using Montgomery multiplication we compute + +$$a \cdot R^2 / R = a\cdot R\ mod\ p$$ + +To convert from Montgomery form into standard form we multiply the element in Montgomery form by 1: + +$$ aR \cdot 1 / R = a\ mod\ p$$ + +## Architecture details {#field_docs_architecture_details} +You could say that for each multiplication or squaring primitive there are 3 implementations: +1. Generic 64-bit implementation when uint128_t type is available (there is efficient multiplication of 64-bit values) +2. Assembly 64-bit implementation (Intel ADX and no Intel ADX versions) +3. Implementation targeting WASM + +The generic implementation has 2 purposes: +1. Building barretenberg on platforms we haven't targetted in the past (new ARM-based Macs, for example) +2. Compile-time computation of constant expressions, since we can't use the assembly implementation for those. + +The assembly implementation for x86_64 is optimised. There are 2 versions: +1. General x86_64 implementation that uses 64-bit registers. The squaring operation is equivalent to multiplication for simplicity and because the original squaring implementation was quite buggy. +2. Implementation using Intel ADX. It allows simultaneous use of two addition-with carry operations (adox and adcx) on two separate CPU gates (units of execution that can work simultaneously on the same core), which almost halves the time spent adding up the results of uint64_t multiplication. + +Implementation for WASM: + +We use 9 29-bit limbs for computation (storage stays the same) and we change the Montgomery form. The reason for a different architecture is that WASM doesn't have: +1. 128-bit result 64*64 bit multiplication +2. 64-bit addition with carry + +In the past we implemented a version with 32-bit limbs, but as a result, when we accumulated limb products we always had to split 64-bit results of 32-bit multiplication back into 32-bit chunks. Had we not, the addition of 2 64-bit products would have lost the carry flag and the result would be incorrect. There were 2 issues with this: +1. This spawned in a lot of masking operations +2. We didn't use more efficient algorithms for squaring, because multiplication by 2 of intermediate products would once again overflow. + +Switching to 9 29-bit limbs increased the number of multiplications from 136 to 171. However, since the product of 2 limbs is 58 bits, we can safely accumulate 64 of those before we have to reduce. This allowed us to get rid of a lot of intermediate masking operations, shifts and additions, so the resulting computation turned out to be more efficient. + +## Interaction of field object with other objects +Most of the time field is used with uint64_t or uint256_t in our codebase, but there is general logic of how we generate field elements from integers: +1. Converting from signed int takes the sign into account. It takes the absolute value, converts it to montgomery and then negates the result if the original value was negative +2. Unsigned integers ( <= 64 bits) are just converted to montgomery +3. uint256_t and uint512_t: + 1. Truncate to 256 bits + 2. Subtract the modulus until the value is within field + 3. Convert to montgomery + +Conversion from field elements exists only to unsigned integers and bools. The value is converted from montgomery and appropriate number of lowest bits is used to initialize the value. + +**N.B.** Functions for converting from uint256_t and back are not bijective, since values \f$ \ge p\f$ will be reduced. + +## Field parameters + +The field template is instantiated with field parameter classes, for example, class bb::Bn254FqParams. Each such class contains at least the modulus (in 64-bit and 29-bit form), r_inv (used to efficient reductions) and 2 versions of r_squared used for converting to Montgomery form (64-bit and WASM/29-bit version). r_squared and other parameters (such as cube_root, primitive_root and coset_generators) are defined for wasm separately, because the values represent an element already in Montgomery form. + +## Helpful python snippets + +Parse field parameters out of a parameter class (doesn't check and reconstitute endomorphism parameters, but checks correctness of everything else) +```python +import re +def parse_field_params(s): + def parse_number(line): + """Expects a string without whitespaces""" + line=line.replace('U','').replace('L','') # Clear away all postfixes + if line.find('0x')!=-1: # We have to parse hex + value= int(line,16) + else: + value = int(line) + return value + + def recover_single_value(name): + nonlocal s + index=s.find(name) + if index==-1: + raise ValueError("Couldn't find value with name "+name) + eq_position=s[index:].find('=') + line_end=s[index:].find(';') + return parse_number(s[index+eq_position+1:index+line_end]) + + def recover_single_value_if_present(name): + nonlocal s + index=s.find(name) + if index==-1: + return None + eq_position=s[index:].find('=') + line_end=s[index:].find(';') + return parse_number(s[index+eq_position+1:index+line_end]) + + def recover_array(name): + nonlocal s + index = s.find(name) + number_of_elements=int(re.findall(r'(?<='+name+r'\[)\d+',s)[0]) + start_index=s[index:].find('{') + end_index=s[index:].find('}') + all_values=s[index+start_index+1:index+end_index] + result=[parse_number(x) for (i,x) in enumerate(all_values.split(',')) if i>(i*64))&((1<<64)-1))for i in range(4)])+"})") +``` \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp index 42d7e1583ee..1c556fa43de 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp @@ -290,7 +290,8 @@ template constexpr bool field::operator!=(const field& other) const template constexpr field field::to_montgomery_form() const noexcept { BB_OP_COUNT_TRACK_NAME("fr::to_montgomery_form"); - constexpr field r_squared{ T::r_squared_0, T::r_squared_1, T::r_squared_2, T::r_squared_3 }; + constexpr field r_squared = + field{ r_squared_uint.data[0], r_squared_uint.data[1], r_squared_uint.data[2], r_squared_uint.data[3] }; field result = *this; // TODO(@zac-williamson): are these reductions needed? @@ -315,7 +316,9 @@ template constexpr field field::from_montgomery_form() const noe template constexpr void field::self_to_montgomery_form() noexcept { BB_OP_COUNT_TRACK_NAME("fr::self_to_montgomery_form"); - constexpr field r_squared{ T::r_squared_0, T::r_squared_1, T::r_squared_2, T::r_squared_3 }; + constexpr field r_squared = + field{ r_squared_uint.data[0], r_squared_uint.data[1], r_squared_uint.data[2], r_squared_uint.data[3] }; + self_reduce_once(); self_reduce_once(); self_reduce_once(); @@ -582,7 +585,11 @@ template constexpr bool field::is_zero() const noexcept template constexpr field field::get_root_of_unity(size_t subgroup_size) noexcept { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) field r{ T::primitive_root_0, T::primitive_root_1, T::primitive_root_2, T::primitive_root_3 }; +#else + field r{ T::primitive_root_wasm_0, T::primitive_root_wasm_1, T::primitive_root_wasm_2, T::primitive_root_wasm_3 }; +#endif for (size_t i = primitive_root_log_size(); i > subgroup_size; --i) { r.self_sqr(); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp index f1bed6aa602..cb3b152d33e 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp @@ -276,6 +276,13 @@ template constexpr field field::subtract(const field& other) con return { r0, r1, r2, r3 }; } +/** + * @brief + * + * @tparam T + * @param other + * @return constexpr field + */ template constexpr field field::subtract_coarse(const field& other) const noexcept { if constexpr (modulus.data[3] >= 0x4000000000000000ULL) { @@ -295,6 +302,13 @@ template constexpr field field::subtract_coarse(const field& oth return { r0, r1, r2, r3 }; } + +/** + * @brief Mongtomery multiplication for moduli > 2²⁵⁴ + * + * @details Explanation of Montgomery form can be found in \ref field_docs_montgomery_explainer and the difference + * between WASM and generic versions is explained in \ref field_docs_architecture_details + */ template constexpr field field::montgomery_mul_big(const field& other) const noexcept { #if defined(__SIZEOF_INT128__) && !defined(__wasm__) @@ -336,84 +350,187 @@ template constexpr field field::montgomery_mul_big(const field& r3 += (modulus.data[3] & borrow) + carry; return { r0, r1, r2, r3 }; #else - uint64_t c = 0; - uint64_t t0 = 0; - uint64_t t1 = 0; - uint64_t t2 = 0; - uint64_t t3 = 0; - uint64_t t4 = 0; - uint64_t t5 = 0; - uint64_t t6 = 0; - uint64_t t7 = 0; - uint64_t t8 = 0; - uint64_t t9 = 0; - uint64_t k = 0; - constexpr uint64_t wasm_modulus[8]{ - modulus.data[0] & 0xffffffffULL, modulus.data[0] >> 32ULL, modulus.data[1] & 0xffffffffULL, - modulus.data[1] >> 32ULL, modulus.data[2] & 0xffffffffULL, modulus.data[2] >> 32ULL, - modulus.data[3] & 0xffffffffULL, modulus.data[3] >> 32ULL, - }; - constexpr uint64_t wasm_rinv = T::r_inv & 0xffffffffULL; + // Convert 4 64-bit limbs to 9 29-bit limbs + auto left = wasm_convert(data); + auto right = wasm_convert(other.data); + constexpr uint64_t mask = 0x1fffffff; + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + uint64_t temp_9 = 0; + uint64_t temp_10 = 0; + uint64_t temp_11 = 0; + uint64_t temp_12 = 0; + uint64_t temp_13 = 0; + uint64_t temp_14 = 0; + uint64_t temp_15 = 0; + uint64_t temp_16 = 0; + uint64_t temp_17 = 0; + + // Multiply-add 0th limb of the left argument by all 9 limbs of the right arguemnt + wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + // Instantly reduce + wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + // Continue for other limbs + wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + + // After all multiplications and additions, convert relaxed form to strict (all limbs are 29 bits) + temp_10 += temp_9 >> WASM_LIMB_BITS; + temp_9 &= mask; + temp_11 += temp_10 >> WASM_LIMB_BITS; + temp_10 &= mask; + temp_12 += temp_11 >> WASM_LIMB_BITS; + temp_11 &= mask; + temp_13 += temp_12 >> WASM_LIMB_BITS; + temp_12 &= mask; + temp_14 += temp_13 >> WASM_LIMB_BITS; + temp_13 &= mask; + temp_15 += temp_14 >> WASM_LIMB_BITS; + temp_14 &= mask; + temp_16 += temp_15 >> WASM_LIMB_BITS; + temp_15 &= mask; + temp_17 += temp_16 >> WASM_LIMB_BITS; + temp_16 &= mask; + + uint64_t r_temp_0; + uint64_t r_temp_1; + uint64_t r_temp_2; + uint64_t r_temp_3; + uint64_t r_temp_4; + uint64_t r_temp_5; + uint64_t r_temp_6; + uint64_t r_temp_7; + uint64_t r_temp_8; + // Subtract modulus from result + r_temp_0 = temp_9 - wasm_modulus[0]; + r_temp_1 = temp_10 - wasm_modulus[1] - ((r_temp_0) >> 63); + r_temp_2 = temp_11 - wasm_modulus[2] - ((r_temp_1) >> 63); + r_temp_3 = temp_12 - wasm_modulus[3] - ((r_temp_2) >> 63); + r_temp_4 = temp_13 - wasm_modulus[4] - ((r_temp_3) >> 63); + r_temp_5 = temp_14 - wasm_modulus[5] - ((r_temp_4) >> 63); + r_temp_6 = temp_15 - wasm_modulus[6] - ((r_temp_5) >> 63); + r_temp_7 = temp_16 - wasm_modulus[7] - ((r_temp_6) >> 63); + r_temp_8 = temp_17 - wasm_modulus[8] - ((r_temp_7) >> 63); + + // Depending on whether the subtraction underflowed, choose original value or the result of subtraction + uint64_t new_mask = 0 - (r_temp_8 >> 63); + uint64_t inverse_mask = (~new_mask) & mask; + temp_9 = (temp_9 & new_mask) | (r_temp_0 & inverse_mask); + temp_10 = (temp_10 & new_mask) | (r_temp_1 & inverse_mask); + temp_11 = (temp_11 & new_mask) | (r_temp_2 & inverse_mask); + temp_12 = (temp_12 & new_mask) | (r_temp_3 & inverse_mask); + temp_13 = (temp_13 & new_mask) | (r_temp_4 & inverse_mask); + temp_14 = (temp_14 & new_mask) | (r_temp_5 & inverse_mask); + temp_15 = (temp_15 & new_mask) | (r_temp_6 & inverse_mask); + temp_16 = (temp_16 & new_mask) | (r_temp_7 & inverse_mask); + temp_17 = (temp_17 & new_mask) | (r_temp_8 & inverse_mask); + + // Convert back to 4 64-bit limbs + return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), + (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), + (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), + (temp_15 >> 18) | (temp_16 << 11) | (temp_17 << 40) }; - const uint64_t left[8]{ - data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, - data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, - }; - const uint64_t right[8]{ - other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, - other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, - }; +#endif +} - for (size_t i = 0; i < 8; ++i) { - c = 0; - mac(t0, left[i], right[0], c, t0, c); - mac(t1, left[i], right[1], c, t1, c); - mac(t2, left[i], right[2], c, t2, c); - mac(t3, left[i], right[3], c, t3, c); - mac(t4, left[i], right[4], c, t4, c); - mac(t5, left[i], right[5], c, t5, c); - mac(t6, left[i], right[6], c, t6, c); - mac(t7, left[i], right[7], c, t7, c); - uint64_t end_mul = t8 + c; - t8 = end_mul & 0xffffffffU; - t9 = end_mul >> 32; +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) - c = 0; - k = (t0 * wasm_rinv) & 0xffffffffU; - c = mac_discard_lo(t0, k, wasm_modulus[0]); - mac(t1, k, wasm_modulus[1], c, t0, c); - mac(t2, k, wasm_modulus[2], c, t1, c); - mac(t3, k, wasm_modulus[3], c, t2, c); - mac(t4, k, wasm_modulus[4], c, t3, c); - mac(t5, k, wasm_modulus[5], c, t4, c); - mac(t6, k, wasm_modulus[6], c, t5, c); - mac(t7, k, wasm_modulus[7], c, t6, c); - uint64_t end_reduce = c + t8; - t7 = end_reduce & 0xffffffffU; - c = end_reduce >> 32; - t8 = t9 + c; - } - uint64_t v0 = t0 + (t1 << 32); - uint64_t v1 = t2 + (t3 << 32); - uint64_t v2 = t4 + (t5 << 32); - uint64_t v3 = t6 + (t7 << 32); - uint64_t v4 = t8; - uint64_t borrow = 0; - uint64_t r0 = sbb(v0, modulus.data[0], borrow, borrow); - uint64_t r1 = sbb(v1, modulus.data[1], borrow, borrow); - uint64_t r2 = sbb(v2, modulus.data[2], borrow, borrow); - uint64_t r3 = sbb(v3, modulus.data[3], borrow, borrow); - borrow = borrow ^ (0ULL - v4); - r0 += (modulus.data[0] & borrow); - uint64_t carry = r0 < (modulus.data[0] & borrow); - r1 = addc(r1, modulus.data[1] & borrow, carry, carry); - r2 = addc(r2, modulus.data[2] & borrow, carry, carry); - r3 += (modulus.data[3] & borrow) + carry; - return { r0, r1, r2, r3 }; -#endif +/** + * @brief Multiply left limb by a sequence of 9 limbs and put into result variables + * + */ +template +constexpr void field::wasm_madd(uint64_t& left_limb, + const std::array& right_limbs, + uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8) +{ + result_0 += left_limb * right_limbs[0]; + result_1 += left_limb * right_limbs[1]; + result_2 += left_limb * right_limbs[2]; + result_3 += left_limb * right_limbs[3]; + result_4 += left_limb * right_limbs[4]; + result_5 += left_limb * right_limbs[5]; + result_6 += left_limb * right_limbs[6]; + result_7 += left_limb * right_limbs[7]; + result_8 += left_limb * right_limbs[8]; } +/** + * @brief Perform 29-bit montgomery reduction on 1 limb (result_0 should be zero modulo 2**29 after this) + * + */ +template +constexpr void field::wasm_reduce(uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8) +{ + constexpr uint64_t mask = 0x1fffffff; + constexpr uint64_t r_inv = T::r_inv & mask; + uint64_t k = (result_0 * r_inv) & mask; + result_0 += k * wasm_modulus[0]; + result_1 += k * wasm_modulus[1] + (result_0 >> WASM_LIMB_BITS); + result_2 += k * wasm_modulus[2]; + result_3 += k * wasm_modulus[3]; + result_4 += k * wasm_modulus[4]; + result_5 += k * wasm_modulus[5]; + result_6 += k * wasm_modulus[6]; + result_7 += k * wasm_modulus[7]; + result_8 += k * wasm_modulus[8]; +} +/** + * @brief Convert 4 64-bit limbs into 9 29-bit limbs + * + */ +template constexpr std::array field::wasm_convert(const uint64_t* data) +{ + return { data[0] & 0x1fffffff, + (data[0] >> WASM_LIMB_BITS) & 0x1fffffff, + ((data[0] >> 58) & 0x3f) | ((data[1] & 0x7fffff) << 6), + (data[1] >> 23) & 0x1fffffff, + ((data[1] >> 52) & 0xfff) | ((data[2] & 0x1ffff) << 12), + (data[2] >> 17) & 0x1fffffff, + ((data[2] >> 46) & 0x3ffff) | ((data[3] & 0x7ff) << 18), + (data[3] >> 11) & 0x1fffffff, + (data[3] >> 40) & 0x1fffffff }; +} +#endif template constexpr field field::montgomery_mul(const field& other) const noexcept { if constexpr (modulus.data[3] >= 0x4000000000000000ULL) { @@ -466,178 +583,71 @@ template constexpr field field::montgomery_mul(const field& othe t3 = c + a; return { t0, t1, t2, t3 }; #else - constexpr uint64_t wasm_modulus[8]{ - modulus.data[0] & 0xffffffffULL, modulus.data[0] >> 32ULL, modulus.data[1] & 0xffffffffULL, - modulus.data[1] >> 32ULL, modulus.data[2] & 0xffffffffULL, modulus.data[2] >> 32ULL, - modulus.data[3] & 0xffffffffULL, modulus.data[3] >> 32ULL, - }; - constexpr uint64_t wasm_rinv = T::r_inv & 0xffffffffULL; - const uint64_t left[8]{ - data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, - data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, - }; - const uint64_t right[8]{ - other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, - other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, - }; - - auto [t0, c] = mul_wide(left[0], right[0]); - uint64_t k = (t0 * wasm_rinv) & 0xffffffffULL; - uint64_t a = mac_discard_lo(t0, k, wasm_modulus[0]); - - uint64_t t1 = mac_mini(a, left[0], right[1], a); - mac(t1, k, wasm_modulus[1], c, t0, c); - uint64_t t2 = mac_mini(a, left[0], right[2], a); - mac(t2, k, wasm_modulus[2], c, t1, c); - uint64_t t3 = mac_mini(a, left[0], right[3], a); - mac(t3, k, wasm_modulus[3], c, t2, c); - uint64_t t4 = mac_mini(a, left[0], right[4], a); - mac(t4, k, wasm_modulus[4], c, t3, c); - uint64_t t5 = mac_mini(a, left[0], right[5], a); - mac(t5, k, wasm_modulus[5], c, t4, c); - uint64_t t6 = mac_mini(a, left[0], right[6], a); - mac(t6, k, wasm_modulus[6], c, t5, c); - uint64_t t7 = mac_mini(a, left[0], right[7], a); - mac(t7, k, wasm_modulus[7], c, t6, c); - t7 = c + a; - - for (size_t i = 1; i < 8; ++i) { - mac_mini(t0, left[i], right[0], t0, a); - k = (t0 * wasm_rinv) & 0xffffffffULL; - c = mac_discard_lo(t0, k, wasm_modulus[0]); - mac(t1, left[i], right[1], a, t1, a); - mac(t1, k, wasm_modulus[1], c, t0, c); - mac(t2, left[i], right[2], a, t2, a); - mac(t2, k, wasm_modulus[2], c, t1, c); - mac(t3, left[i], right[3], a, t3, a); - mac(t3, k, wasm_modulus[3], c, t2, c); - mac(t4, left[i], right[4], a, t4, a); - mac(t4, k, wasm_modulus[4], c, t3, c); - mac(t5, left[i], right[5], a, t5, a); - mac(t5, k, wasm_modulus[5], c, t4, c); - mac(t6, left[i], right[6], a, t6, a); - mac(t6, k, wasm_modulus[6], c, t5, c); - mac(t7, left[i], right[7], a, t7, a); - mac(t7, k, wasm_modulus[7], c, t6, c); - t7 = c + a; - } - - // mac_mini(t0, left[2], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[2], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[2], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[2], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[2], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[2], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[2], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[2], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - // mac_mini(t0, left[3], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[3], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[3], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[3], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[3], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[3], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[3], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[3], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - // mac_mini(t0, left[4], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[4], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[4], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[4], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[4], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[4], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[4], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[4], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - // mac_mini(t0, left[5], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[5], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[5], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[5], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[5], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[5], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[5], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[5], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - // mac_mini(t0, left[6], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[6], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[6], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[6], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[6], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[6], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[6], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[6], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - // mac_mini(t0, left[7], right[0], t0, a); - // k = (t0 * wasm_rinv) & 0xffffffffULL; - // c = mac_discard_lo(t0, k, wasm_modulus[0]); - // mac(t1, left[7], right[1], a, t1, a); - // mac(t1, k, wasm_modulus[1], c, t0, c); - // mac(t2, left[7], right[2], a, t2, a); - // mac(t2, k, wasm_modulus[2], c, t1, c); - // mac(t3, left[7], right[3], a, t3, a); - // mac(t3, k, wasm_modulus[3], c, t2, c); - // mac(t4, left[7], right[4], a, t4, a); - // mac(t4, k, wasm_modulus[4], c, t3, c); - // mac(t5, left[7], right[5], a, t5, a); - // mac(t5, k, wasm_modulus[5], c, t4, c); - // mac(t6, left[7], right[6], a, t6, a); - // mac(t6, k, wasm_modulus[6], c, t5, c); - // mac(t7, left[7], right[7], a, t7, a); - // mac(t7, k, wasm_modulus[7], c, t6, c); - // t7 = c + a; - - return { t0 + (t1 << 32), t2 + (t3 << 32), t4 + (t5 << 32), t6 + (t7 << 32) }; + // Convert 4 64-bit limbs to 9 29-bit ones + auto left = wasm_convert(data); + auto right = wasm_convert(other.data); + constexpr uint64_t mask = 0x1fffffff; + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + uint64_t temp_9 = 0; + uint64_t temp_10 = 0; + uint64_t temp_11 = 0; + uint64_t temp_12 = 0; + uint64_t temp_13 = 0; + uint64_t temp_14 = 0; + uint64_t temp_15 = 0; + uint64_t temp_16 = 0; + + // Perform a series of multiplications and reductions (we multiply 1 limb of left argument by the whole right + // argument and then reduce) + wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + + // Convert result to unrelaxed form (all limbs are 29 bits) + temp_10 += temp_9 >> WASM_LIMB_BITS; + temp_9 &= mask; + temp_11 += temp_10 >> WASM_LIMB_BITS; + temp_10 &= mask; + temp_12 += temp_11 >> WASM_LIMB_BITS; + temp_11 &= mask; + temp_13 += temp_12 >> WASM_LIMB_BITS; + temp_12 &= mask; + temp_14 += temp_13 >> WASM_LIMB_BITS; + temp_13 &= mask; + temp_15 += temp_14 >> WASM_LIMB_BITS; + temp_14 &= mask; + temp_16 += temp_15 >> WASM_LIMB_BITS; + temp_15 &= mask; + + // Convert back to 4 64-bit limbs form + return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), + (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), + (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), + (temp_15 >> 18) | (temp_16 << 11) }; #endif } @@ -695,9 +705,135 @@ template constexpr field field::montgomery_square() const noexce t3 = carry_lo + round_carry; return { t0, t1, t2, t3 }; #else - // We use ‘montgomery_mul' instead of 'square_accumulate'. The number of additions and comparisons in - // 'square_accumulate' makes it slower in this particular case. - return montgomery_mul(*this); + // Convert from 4 64-bit limbs to 9 29-bit ones + auto left = wasm_convert(data); + constexpr uint64_t mask = 0x1fffffff; + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + uint64_t temp_9 = 0; + uint64_t temp_10 = 0; + uint64_t temp_11 = 0; + uint64_t temp_12 = 0; + uint64_t temp_13 = 0; + uint64_t temp_14 = 0; + uint64_t temp_15 = 0; + uint64_t temp_16 = 0; + uint64_t acc; + // Perform multiplications, but accumulated results for limb k=i+j so that we can double them at the same time + temp_0 += left[0] * left[0]; + acc = 0; + acc += left[0] * left[1]; + temp_1 += (acc << 1); + acc = 0; + acc += left[0] * left[2]; + temp_2 += left[1] * left[1]; + temp_2 += (acc << 1); + acc = 0; + acc += left[0] * left[3]; + acc += left[1] * left[2]; + temp_3 += (acc << 1); + acc = 0; + acc += left[0] * left[4]; + acc += left[1] * left[3]; + temp_4 += left[2] * left[2]; + temp_4 += (acc << 1); + acc = 0; + acc += left[0] * left[5]; + acc += left[1] * left[4]; + acc += left[2] * left[3]; + temp_5 += (acc << 1); + acc = 0; + acc += left[0] * left[6]; + acc += left[1] * left[5]; + acc += left[2] * left[4]; + temp_6 += left[3] * left[3]; + temp_6 += (acc << 1); + acc = 0; + acc += left[0] * left[7]; + acc += left[1] * left[6]; + acc += left[2] * left[5]; + acc += left[3] * left[4]; + temp_7 += (acc << 1); + acc = 0; + acc += left[0] * left[8]; + acc += left[1] * left[7]; + acc += left[2] * left[6]; + acc += left[3] * left[5]; + temp_8 += left[4] * left[4]; + temp_8 += (acc << 1); + acc = 0; + acc += left[1] * left[8]; + acc += left[2] * left[7]; + acc += left[3] * left[6]; + acc += left[4] * left[5]; + temp_9 += (acc << 1); + acc = 0; + acc += left[2] * left[8]; + acc += left[3] * left[7]; + acc += left[4] * left[6]; + temp_10 += left[5] * left[5]; + temp_10 += (acc << 1); + acc = 0; + acc += left[3] * left[8]; + acc += left[4] * left[7]; + acc += left[5] * left[6]; + temp_11 += (acc << 1); + acc = 0; + acc += left[4] * left[8]; + acc += left[5] * left[7]; + temp_12 += left[6] * left[6]; + temp_12 += (acc << 1); + acc = 0; + acc += left[5] * left[8]; + acc += left[6] * left[7]; + temp_13 += (acc << 1); + acc = 0; + acc += left[6] * left[8]; + temp_14 += left[7] * left[7]; + temp_14 += (acc << 1); + acc = 0; + acc += left[7] * left[8]; + temp_15 += (acc << 1); + temp_16 += left[8] * left[8]; + + // Perform reductions + wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + + // Convert to unrelaxed 29-bit form + temp_10 += temp_9 >> WASM_LIMB_BITS; + temp_9 &= mask; + temp_11 += temp_10 >> WASM_LIMB_BITS; + temp_10 &= mask; + temp_12 += temp_11 >> WASM_LIMB_BITS; + temp_11 &= mask; + temp_13 += temp_12 >> WASM_LIMB_BITS; + temp_12 &= mask; + temp_14 += temp_13 >> WASM_LIMB_BITS; + temp_13 &= mask; + temp_15 += temp_14 >> WASM_LIMB_BITS; + temp_14 &= mask; + temp_16 += temp_15 >> WASM_LIMB_BITS; + temp_15 &= mask; + // Convert to 4 64-bit form + return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), + (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), + (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), + (temp_15 >> 18) | (temp_16 << 11) }; #endif } @@ -726,93 +862,82 @@ template constexpr struct field::wide_array field::mul_512(const return { r0, r1, r2, r3, r4, r5, r6, carry_2 }; #else - const uint64_t left[8]{ - data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, - data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, - }; - - const uint64_t right[8]{ - other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, - other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, - }; - - uint64_t carry_2 = 0; - auto [r0, carry] = mul_wide(left[0], right[0]); - uint64_t r1 = mac_mini(carry, left[0], right[1], carry); - uint64_t r2 = mac_mini(carry, left[0], right[2], carry); - uint64_t r3 = mac_mini(carry, left[0], right[3], carry); - uint64_t r4 = mac_mini(carry, left[0], right[4], carry); - uint64_t r5 = mac_mini(carry, left[0], right[5], carry); - uint64_t r6 = mac_mini(carry, left[0], right[6], carry); - uint64_t r7 = mac_mini(carry, left[0], right[7], carry_2); - - r1 = mac_mini(r1, left[1], right[0], carry); - r2 = mac(r2, left[1], right[1], carry, carry); - r3 = mac(r3, left[1], right[2], carry, carry); - r4 = mac(r4, left[1], right[3], carry, carry); - r5 = mac(r5, left[1], right[4], carry, carry); - r6 = mac(r6, left[1], right[5], carry, carry); - r7 = mac(r7, left[1], right[6], carry, carry); - uint64_t r8 = mac(carry_2, left[1], right[7], carry, carry_2); - - r2 = mac_mini(r2, left[2], right[0], carry); - r3 = mac(r3, left[2], right[1], carry, carry); - r4 = mac(r4, left[2], right[2], carry, carry); - r5 = mac(r5, left[2], right[3], carry, carry); - r6 = mac(r6, left[2], right[4], carry, carry); - r7 = mac(r7, left[2], right[5], carry, carry); - r8 = mac(r8, left[2], right[6], carry, carry); - uint64_t r9 = mac(carry_2, left[2], right[7], carry, carry_2); - - r3 = mac_mini(r3, left[3], right[0], carry); - r4 = mac(r4, left[3], right[1], carry, carry); - r5 = mac(r5, left[3], right[2], carry, carry); - r6 = mac(r6, left[3], right[3], carry, carry); - r7 = mac(r7, left[3], right[4], carry, carry); - r8 = mac(r8, left[3], right[5], carry, carry); - r9 = mac(r9, left[3], right[6], carry, carry); - uint64_t r10 = mac(carry_2, left[3], right[7], carry, carry_2); - - r4 = mac_mini(r4, left[4], right[0], carry); - r5 = mac(r5, left[4], right[1], carry, carry); - r6 = mac(r6, left[4], right[2], carry, carry); - r7 = mac(r7, left[4], right[3], carry, carry); - r8 = mac(r8, left[4], right[4], carry, carry); - r9 = mac(r9, left[4], right[5], carry, carry); - r10 = mac(r10, left[4], right[6], carry, carry); - uint64_t r11 = mac(carry_2, left[4], right[7], carry, carry_2); - - r5 = mac_mini(r5, left[5], right[0], carry); - r6 = mac(r6, left[5], right[1], carry, carry); - r7 = mac(r7, left[5], right[2], carry, carry); - r8 = mac(r8, left[5], right[3], carry, carry); - r9 = mac(r9, left[5], right[4], carry, carry); - r10 = mac(r10, left[5], right[5], carry, carry); - r11 = mac(r11, left[5], right[6], carry, carry); - uint64_t r12 = mac(carry_2, left[5], right[7], carry, carry_2); - - r6 = mac_mini(r6, left[6], right[0], carry); - r7 = mac(r7, left[6], right[1], carry, carry); - r8 = mac(r8, left[6], right[2], carry, carry); - r9 = mac(r9, left[6], right[3], carry, carry); - r10 = mac(r10, left[6], right[4], carry, carry); - r11 = mac(r11, left[6], right[5], carry, carry); - r12 = mac(r12, left[6], right[6], carry, carry); - uint64_t r13 = mac(carry_2, left[6], right[7], carry, carry_2); - - r7 = mac_mini(r7, left[7], right[0], carry); - r8 = mac(r8, left[7], right[1], carry, carry); - r9 = mac(r9, left[7], right[2], carry, carry); - r10 = mac(r10, left[7], right[3], carry, carry); - r11 = mac(r11, left[7], right[4], carry, carry); - r12 = mac(r12, left[7], right[5], carry, carry); - r13 = mac(r13, left[7], right[6], carry, carry); - uint64_t r14 = mac(carry_2, left[7], right[7], carry, carry_2); - - return { - r0 + (r1 << 32), r2 + (r3 << 32), r4 + (r5 << 32), r6 + (r7 << 32), - r8 + (r9 << 32), r10 + (r11 << 32), r12 + (r13 << 32), r14 + (carry_2 << 32), - }; + // Convert from 4 64-bit limbs to 9 29-bit limbs + auto left = wasm_convert(data); + auto right = wasm_convert(other.data); + constexpr uint64_t mask = 0x1fffffff; + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + uint64_t temp_9 = 0; + uint64_t temp_10 = 0; + uint64_t temp_11 = 0; + uint64_t temp_12 = 0; + uint64_t temp_13 = 0; + uint64_t temp_14 = 0; + uint64_t temp_15 = 0; + uint64_t temp_16 = 0; + + // Multiply-add all limbs + wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + + // Convert to unrelaxed 29-bit form + temp_1 += temp_0 >> WASM_LIMB_BITS; + temp_0 &= mask; + temp_2 += temp_1 >> WASM_LIMB_BITS; + temp_1 &= mask; + temp_3 += temp_2 >> WASM_LIMB_BITS; + temp_2 &= mask; + temp_4 += temp_3 >> WASM_LIMB_BITS; + temp_3 &= mask; + temp_5 += temp_4 >> WASM_LIMB_BITS; + temp_4 &= mask; + temp_6 += temp_5 >> WASM_LIMB_BITS; + temp_5 &= mask; + temp_7 += temp_6 >> WASM_LIMB_BITS; + temp_6 &= mask; + temp_8 += temp_7 >> WASM_LIMB_BITS; + temp_7 &= mask; + temp_9 += temp_8 >> WASM_LIMB_BITS; + temp_8 &= mask; + temp_10 += temp_9 >> WASM_LIMB_BITS; + temp_9 &= mask; + temp_11 += temp_10 >> WASM_LIMB_BITS; + temp_10 &= mask; + temp_12 += temp_11 >> WASM_LIMB_BITS; + temp_11 &= mask; + temp_13 += temp_12 >> WASM_LIMB_BITS; + temp_12 &= mask; + temp_14 += temp_13 >> WASM_LIMB_BITS; + temp_13 &= mask; + temp_15 += temp_14 >> WASM_LIMB_BITS; + temp_14 &= mask; + temp_16 += temp_15 >> WASM_LIMB_BITS; + temp_15 &= mask; + + // Convert to 8 64-bit limbs + return { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), + (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), + (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), + (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40), + (temp_8 >> 24) | (temp_9 << 5) | (temp_10 << 34) | (temp_11 << 63), + (temp_11 >> 1) | (temp_12 << 28) | (temp_13 << 57), + (temp_13 >> 7) | (temp_14 << 22) | (temp_15 << 51), + (temp_15 >> 13) | (temp_16 << 16) }; #endif } diff --git a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp index fe9e759adaa..0a9b705e22d 100644 --- a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp +++ b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp @@ -23,7 +23,12 @@ namespace bb::numeric { class alignas(32) uint256_t { + public: +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) +#define WASM_NUM_LIMBS 9 +#define WASM_LIMB_BITS 29 +#endif constexpr uint256_t(const uint64_t a = 0) noexcept : data{ a, 0, 0, 0 } {} @@ -208,6 +213,20 @@ class alignas(32) uint256_t { uint64_t b, uint64_t c, uint64_t carry_in); +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) + static constexpr void wasm_madd(const uint64_t& left_limb, + const uint64_t* right_limbs, + uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8); + [[nodiscard]] static constexpr std::array wasm_convert(const uint64_t* data); +#endif }; inline std::ostream& operator<<(std::ostream& os, uint256_t const& a) diff --git a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp index ee51adc763a..29be0dfa01c 100644 --- a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp +++ b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp @@ -73,7 +73,52 @@ constexpr uint64_t uint256_t::mac_discard_hi(const uint64_t a, { return (b * c + a + carry_in); } +#if defined(__wasm__) || !defined(__SIZEOF_INT128__) +/** + * @brief Multiply one limb by 9 limbs and add to resulting limbs + * + */ +constexpr void uint256_t::wasm_madd(const uint64_t& left_limb, + const uint64_t* right_limbs, + uint64_t& result_0, + uint64_t& result_1, + uint64_t& result_2, + uint64_t& result_3, + uint64_t& result_4, + uint64_t& result_5, + uint64_t& result_6, + uint64_t& result_7, + uint64_t& result_8) +{ + result_0 += left_limb * right_limbs[0]; + result_1 += left_limb * right_limbs[1]; + result_2 += left_limb * right_limbs[2]; + result_3 += left_limb * right_limbs[3]; + result_4 += left_limb * right_limbs[4]; + result_5 += left_limb * right_limbs[5]; + result_6 += left_limb * right_limbs[6]; + result_7 += left_limb * right_limbs[7]; + result_8 += left_limb * right_limbs[8]; +} + +/** + * @brief Convert from 4 64-bit limbs to 9 29-bit limbs + * + */ +constexpr std::array uint256_t::wasm_convert(const uint64_t* data) +{ + return { data[0] & 0x1fffffff, + (data[0] >> 29) & 0x1fffffff, + ((data[0] >> 58) & 0x3f) | ((data[1] & 0x7fffff) << 6), + (data[1] >> 23) & 0x1fffffff, + ((data[1] >> 52) & 0xfff) | ((data[2] & 0x1ffff) << 12), + (data[2] >> 17) & 0x1fffffff, + ((data[2] >> 46) & 0x3ffff) | ((data[3] & 0x7ff) << 18), + (data[3] >> 11) & 0x1fffffff, + (data[3] >> 40) & 0x1fffffff }; +} +#endif constexpr std::pair uint256_t::divmod(const uint256_t& b) const { if (*this == 0 || b == 0) { @@ -122,8 +167,13 @@ constexpr std::pair uint256_t::divmod(const uint256_t& b) return { quotient, remainder }; } +/** + * @brief Compute the result of multiplication modulu 2**512 + * + */ constexpr std::pair uint256_t::mul_extended(const uint256_t& other) const { +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const auto [r0, t0] = mul_wide(data[0], other.data[0]); const auto [q0, t1] = mac(t0, data[0], other.data[1], 0); const auto [q1, t2] = mac(t1, data[0], other.data[2], 0); @@ -147,6 +197,84 @@ constexpr std::pair uint256_t::mul_extended(const uint256_ uint256_t lo(r0, r1, r2, r3); uint256_t hi(r4, r5, r6, r7); return { lo, hi }; +#else + // Convert 4 64-bit limbs to 9 29-bit limbs + const auto left = wasm_convert(data); + const auto right = wasm_convert(other.data); + constexpr uint64_t mask = 0x1fffffff; + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + uint64_t temp_9 = 0; + uint64_t temp_10 = 0; + uint64_t temp_11 = 0; + uint64_t temp_12 = 0; + uint64_t temp_13 = 0; + uint64_t temp_14 = 0; + uint64_t temp_15 = 0; + uint64_t temp_16 = 0; + + // Multiply and addd all limbs + wasm_madd(left[0], &right[0], temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + wasm_madd(left[1], &right[0], temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); + wasm_madd(left[2], &right[0], temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); + wasm_madd(left[3], &right[0], temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); + wasm_madd(left[4], &right[0], temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); + wasm_madd(left[5], &right[0], temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); + wasm_madd(left[6], &right[0], temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); + wasm_madd(left[7], &right[0], temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); + wasm_madd(left[8], &right[0], temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); + + // Convert from relaxed form into strict 29-bit form (except for temp_16) + temp_1 += temp_0 >> WASM_LIMB_BITS; + temp_0 &= mask; + temp_2 += temp_1 >> WASM_LIMB_BITS; + temp_1 &= mask; + temp_3 += temp_2 >> WASM_LIMB_BITS; + temp_2 &= mask; + temp_4 += temp_3 >> WASM_LIMB_BITS; + temp_3 &= mask; + temp_5 += temp_4 >> WASM_LIMB_BITS; + temp_4 &= mask; + temp_6 += temp_5 >> WASM_LIMB_BITS; + temp_5 &= mask; + temp_7 += temp_6 >> WASM_LIMB_BITS; + temp_6 &= mask; + temp_8 += temp_7 >> WASM_LIMB_BITS; + temp_7 &= mask; + temp_9 += temp_8 >> WASM_LIMB_BITS; + temp_8 &= mask; + temp_10 += temp_9 >> WASM_LIMB_BITS; + temp_9 &= mask; + temp_11 += temp_10 >> WASM_LIMB_BITS; + temp_10 &= mask; + temp_12 += temp_11 >> WASM_LIMB_BITS; + temp_11 &= mask; + temp_13 += temp_12 >> WASM_LIMB_BITS; + temp_12 &= mask; + temp_14 += temp_13 >> WASM_LIMB_BITS; + temp_13 &= mask; + temp_15 += temp_14 >> WASM_LIMB_BITS; + temp_14 &= mask; + temp_16 += temp_15 >> WASM_LIMB_BITS; + temp_15 &= mask; + + // Convert to 2 4-64-bit limb uint256_t objects + return { { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), + (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), + (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), + (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40) }, + { (temp_8 >> 24) | (temp_9 << 5) | (temp_10 << 34) | (temp_11 << 63), + (temp_11 >> 1) | (temp_12 << 28) | (temp_13 << 57), + (temp_13 >> 7) | (temp_14 << 22) | (temp_15 << 51), + (temp_15 >> 13) | (temp_16 << 16) } }; +#endif } /** @@ -227,6 +355,8 @@ constexpr uint256_t uint256_t::operator-() const constexpr uint256_t uint256_t::operator*(const uint256_t& other) const { + +#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const auto [r0, t0] = mac(0, data[0], other.data[0], 0ULL); const auto [q0, t1] = mac(0, data[0], other.data[1], t0); const auto [q1, t2] = mac(0, data[0], other.data[2], t1); @@ -242,6 +372,86 @@ constexpr uint256_t uint256_t::operator*(const uint256_t& other) const const auto r3 = mac_discard_hi(q5, data[3], other.data[0], 0ULL); return { r0, r1, r2, r3 }; +#else + // Convert 4 64-bit limbs to 9 29-bit limbs + const auto left = wasm_convert(data); + const auto right = wasm_convert(other.data); + uint64_t temp_0 = 0; + uint64_t temp_1 = 0; + uint64_t temp_2 = 0; + uint64_t temp_3 = 0; + uint64_t temp_4 = 0; + uint64_t temp_5 = 0; + uint64_t temp_6 = 0; + uint64_t temp_7 = 0; + uint64_t temp_8 = 0; + + // Multiply and add the product of left limb 0 by all right limbs + wasm_madd(left[0], &right[0], temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); + // Multiply left limb 1 by limbs 0-7 ((1,8) doesn't need to be computed, because it overflows) + temp_1 += left[1] * right[0]; + temp_2 += left[1] * right[1]; + temp_3 += left[1] * right[2]; + temp_4 += left[1] * right[3]; + temp_5 += left[1] * right[4]; + temp_6 += left[1] * right[5]; + temp_7 += left[1] * right[6]; + temp_8 += left[1] * right[7]; + // Left limb 2 by right 0-6, etc + temp_2 += left[2] * right[0]; + temp_3 += left[2] * right[1]; + temp_4 += left[2] * right[2]; + temp_5 += left[2] * right[3]; + temp_6 += left[2] * right[4]; + temp_7 += left[2] * right[5]; + temp_8 += left[2] * right[6]; + temp_3 += left[3] * right[0]; + temp_4 += left[3] * right[1]; + temp_5 += left[3] * right[2]; + temp_6 += left[3] * right[3]; + temp_7 += left[3] * right[4]; + temp_8 += left[3] * right[5]; + temp_4 += left[4] * right[0]; + temp_5 += left[4] * right[1]; + temp_6 += left[4] * right[2]; + temp_7 += left[4] * right[3]; + temp_8 += left[4] * right[4]; + temp_5 += left[5] * right[0]; + temp_6 += left[5] * right[1]; + temp_7 += left[5] * right[2]; + temp_8 += left[5] * right[3]; + temp_6 += left[6] * right[0]; + temp_7 += left[6] * right[1]; + temp_8 += left[6] * right[2]; + temp_7 += left[7] * right[0]; + temp_8 += left[7] * right[1]; + temp_8 += left[8] * right[0]; + + // Convert from relaxed form to strict 29-bit form + constexpr uint64_t mask = 0x1fffffff; + temp_1 += temp_0 >> WASM_LIMB_BITS; + temp_0 &= mask; + temp_2 += temp_1 >> WASM_LIMB_BITS; + temp_1 &= mask; + temp_3 += temp_2 >> WASM_LIMB_BITS; + temp_2 &= mask; + temp_4 += temp_3 >> WASM_LIMB_BITS; + temp_3 &= mask; + temp_5 += temp_4 >> WASM_LIMB_BITS; + temp_4 &= mask; + temp_6 += temp_5 >> WASM_LIMB_BITS; + temp_5 &= mask; + temp_7 += temp_6 >> WASM_LIMB_BITS; + temp_6 &= mask; + temp_8 += temp_7 >> WASM_LIMB_BITS; + temp_7 &= mask; + + // Convert back to 4 64-bit limbs + return { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), + (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), + (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), + (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40) }; +#endif } constexpr uint256_t uint256_t::operator/(const uint256_t& other) const diff --git a/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp b/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp index aedc1353787..d63af5db8e7 100644 --- a/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp +++ b/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp @@ -119,6 +119,13 @@ template class Univariate } return *this; } + Univariate& self_sqr() + { + for (size_t i = 0; i < LENGTH; ++i) { + evaluations[i].self_sqr(); + } + return *this; + } Univariate operator+(const Univariate& other) const { Univariate res(*this); @@ -148,6 +155,13 @@ template class Univariate return res; } + Univariate sqr() const + { + Univariate res(*this); + res.self_sqr(); + return res; + } + // Operations between Univariate and scalar Univariate& operator+=(const Fr& scalar) { @@ -485,6 +499,12 @@ template class Univariate res *= other; return res; } + Univariate sqr() const + { + Univariate res(*this); + res = res.sqr(); + return res; + } Univariate operator*(const Univariate& other) const { diff --git a/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp index 144ebdf9808..0b18b94596a 100644 --- a/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp @@ -245,7 +245,7 @@ template class AuxiliaryRelationImpl { auto index_delta = w_1_shift - w_1; auto record_delta = w_4_shift - w_4; - auto index_is_monotonically_increasing = index_delta * index_delta - index_delta; // deg 2 + auto index_is_monotonically_increasing = index_delta.sqr() - index_delta; // deg 2 auto adjacent_values_match_if_adjacent_indices_match = (-index_delta + FF(1)) * record_delta; // deg 2 @@ -296,7 +296,7 @@ template class AuxiliaryRelationImpl { // do with an arithmetic gate because of the `eta` factors. We need to check that the *next* gate's access // type is correct, to cover this edge case // deg 2 or 4 - auto next_gate_access_type_is_boolean = next_gate_access_type * next_gate_access_type - next_gate_access_type; + auto next_gate_access_type_is_boolean = next_gate_access_type.sqr() - next_gate_access_type; auto q_arith_by_aux_and_scaling = q_arith * q_aux_by_scaling; // Putting it all together... diff --git a/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp index dee7759db07..e26ad519633 100644 --- a/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp @@ -46,7 +46,6 @@ template class DeltaRangeConstraintRelationImpl { static const FF minus_one = FF(-1); static const FF minus_two = FF(-2); - static const FF minus_three = FF(-3); // Compute wire differences auto delta_1 = w_2 - w_1; @@ -55,37 +54,29 @@ template class DeltaRangeConstraintRelationImpl { auto delta_4 = w_1_shift - w_4; // Contribution (1) - auto tmp_1 = delta_1; - tmp_1 *= (delta_1 + minus_one); - tmp_1 *= (delta_1 + minus_two); - tmp_1 *= (delta_1 + minus_three); + auto tmp_1 = (delta_1 + minus_one).sqr() + minus_one; + tmp_1 *= (delta_1 + minus_two).sqr() + minus_one; tmp_1 *= q_delta_range; tmp_1 *= scaling_factor; std::get<0>(accumulators) += tmp_1; // Contribution (2) - auto tmp_2 = delta_2; - tmp_2 *= (delta_2 + minus_one); - tmp_2 *= (delta_2 + minus_two); - tmp_2 *= (delta_2 + minus_three); + auto tmp_2 = (delta_2 + minus_one).sqr() + minus_one; + tmp_2 *= (delta_2 + minus_two).sqr() + minus_one; tmp_2 *= q_delta_range; tmp_2 *= scaling_factor; std::get<1>(accumulators) += tmp_2; // Contribution (3) - auto tmp_3 = delta_3; - tmp_3 *= (delta_3 + minus_one); - tmp_3 *= (delta_3 + minus_two); - tmp_3 *= (delta_3 + minus_three); + auto tmp_3 = (delta_3 + minus_one).sqr() + minus_one; + tmp_3 *= (delta_3 + minus_two).sqr() + minus_one; tmp_3 *= q_delta_range; tmp_3 *= scaling_factor; std::get<2>(accumulators) += tmp_3; // Contribution (4) - auto tmp_4 = delta_4; - tmp_4 *= (delta_4 + minus_one); - tmp_4 *= (delta_4 + minus_two); - tmp_4 *= (delta_4 + minus_three); + auto tmp_4 = (delta_4 + minus_one).sqr() + minus_one; + tmp_4 *= (delta_4 + minus_two).sqr() + minus_one; tmp_4 *= q_delta_range; tmp_4 *= scaling_factor; std::get<3>(accumulators) += tmp_4; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp index faf2f0da162..11194edba10 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp @@ -57,50 +57,43 @@ template class EccOpQueueRelationImpl { auto lagrange_ecc_op = View(in.lagrange_ecc_op); // If lagrange_ecc_op is the indicator for ecc_op_gates, this is the indicator for the complement - auto complement_ecc_op = -lagrange_ecc_op + FF(1); + auto lagrange_by_scaling = lagrange_ecc_op * scaling_factor; + auto complement_ecc_op_by_scaling = -lagrange_by_scaling + scaling_factor; // Contribution (1) auto tmp = op_wire_1 - w_1; - tmp *= lagrange_ecc_op; - tmp *= scaling_factor; + tmp *= lagrange_by_scaling; std::get<0>(accumulators) += tmp; // Contribution (2) tmp = op_wire_2 - w_2; - tmp *= lagrange_ecc_op; - tmp *= scaling_factor; + tmp *= lagrange_by_scaling; std::get<1>(accumulators) += tmp; // Contribution (3) tmp = op_wire_3 - w_3; - tmp *= lagrange_ecc_op; - tmp *= scaling_factor; + tmp *= lagrange_by_scaling; std::get<2>(accumulators) += tmp; // Contribution (4) tmp = op_wire_4 - w_4; - tmp *= lagrange_ecc_op; - tmp *= scaling_factor; + tmp *= lagrange_by_scaling; std::get<3>(accumulators) += tmp; // Contribution (5) - tmp = op_wire_1 * complement_ecc_op; - tmp *= scaling_factor; + tmp = op_wire_1 * complement_ecc_op_by_scaling; std::get<4>(accumulators) += tmp; // Contribution (6) - tmp = op_wire_2 * complement_ecc_op; - tmp *= scaling_factor; + tmp = op_wire_2 * complement_ecc_op_by_scaling; std::get<5>(accumulators) += tmp; // Contribution (7) - tmp = op_wire_3 * complement_ecc_op; - tmp *= scaling_factor; + tmp = op_wire_3 * complement_ecc_op_by_scaling; std::get<6>(accumulators) += tmp; // Contribution (8) - tmp = op_wire_4 * complement_ecc_op; - tmp *= scaling_factor; + tmp = op_wire_4 * complement_ecc_op_by_scaling; std::get<7>(accumulators) += tmp; }; }; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp index b71b5a6e4a0..51dc6851d75 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp @@ -182,7 +182,7 @@ void ECCVMMSMRelationImpl::accumulate(ContainerOverSubrelations& accumulator relation += selector * (lambda * (xb - xa - 1) - (yb - ya)) + lambda; collision_relation += selector * (xb - xa); // x3 = L.L + (-xb - xa) * q + (1 - q) xa - auto x_out = lambda * lambda + (-xb - xa - xa) * selector + xa; + auto x_out = lambda.sqr() + (-xb - xa - xa) * selector + xa; // y3 = L . (xa - x3) - ya * q + (1 - q) ya auto y_out = lambda * (xa - x_out) + (-ya - ya) * selector + ya; @@ -219,7 +219,7 @@ void ECCVMMSMRelationImpl::accumulate(ContainerOverSubrelations& accumulator auto dbl = [&](auto& x, auto& y, auto& lambda, auto& relation) { auto two_x = x + x; relation += lambda * (y + y) - (two_x + x) * x; - auto x_out = lambda * lambda - two_x; + auto x_out = lambda.sqr() - two_x; auto y_out = lambda * (x - x_out) - y; return std::array{ x_out, y_out }; }; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp index 0efec02d548..dfc1edfb9c3 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp @@ -122,9 +122,9 @@ void ECCVMPointTableRelationImpl::accumulate(ContainerOverSubrelations& accu auto two_x = Tx + Tx; auto three_x = two_x + Tx; auto three_xx = Tx * three_x; - auto nine_xxxx = three_xx * three_xx; + auto nine_xxxx = three_xx.sqr(); auto two_y = Ty + Ty; - auto four_yy = two_y * two_y; + auto four_yy = two_y.sqr(); auto x_double_check = (Dx + two_x) * four_yy - nine_xxxx; auto y_double_check = (Ty + Dy) * two_y + three_xx * (Dx - Tx); std::get<0>(accumulator) += precompute_point_transition * x_double_check * scaling_factor; @@ -164,7 +164,7 @@ void ECCVMPointTableRelationImpl::accumulate(ContainerOverSubrelations& accu const auto& y3 = Ty; const auto lambda_numerator = y2 - y1; const auto lambda_denominator = x2 - x1; - auto x_add_check = (x3 + x2 + x1) * lambda_denominator * lambda_denominator - lambda_numerator * lambda_numerator; + auto x_add_check = (x3 + x2 + x1) * lambda_denominator.sqr() - lambda_numerator.sqr(); auto y_add_check = (y3 + y1) * lambda_denominator + (x3 - x1) * lambda_numerator; std::get<4>(accumulator) += (-lagrange_first + 1) * (-precompute_point_transition + 1) * x_add_check * scaling_factor; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp index 4e7a4cdbdb6..b2d0f2cedbd 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp @@ -152,7 +152,7 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu auto y1 = transcript_accumulator_y; auto x2 = transcript_msm_x; auto y2 = transcript_msm_y; - auto tmpx = (x3 + x2 + x1) * (x2 - x1) * (x2 - x1) - (y2 - y1) * (y2 - y1); + auto tmpx = (x3 + x2 + x1) * (x2 - x1).sqr() - (y2 - y1).sqr(); auto tmpy = (y3 + y1) * (x2 - x1) - (y2 - y1) * (x1 - x3); std::get<7>(accumulator) += tmpx * add_msm_into_accumulator * scaling_factor; // degree 5 std::get<8>(accumulator) += tmpy * add_msm_into_accumulator * scaling_factor; // degree 4 @@ -177,7 +177,7 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu x2 = transcript_Px; y2 = transcript_Py; auto add_into_accumulator = q_add * (-is_accumulator_empty + 1); - tmpx = (x3 + x2 + x1) * (x2 - x1) * (x2 - x1) - (y2 - y1) * (y2 - y1); + tmpx = (x3 + x2 + x1) * (x2 - x1).sqr() - (y2 - y1).sqr(); tmpy = (y3 + y1) * (x2 - x1) - (y2 - y1) * (x1 - x3); std::get<11>(accumulator) += tmpx * add_into_accumulator * scaling_factor; // degree 5 std::get<12>(accumulator) += tmpy * add_into_accumulator * scaling_factor; // degree 4 @@ -214,14 +214,14 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu std::get<22>(accumulator) += q_eq * is_accumulator_empty * scaling_factor; // validate selectors are boolean (put somewhere else? these are low degree) - std::get<23>(accumulator) += q_eq * (q_eq - 1) * scaling_factor; - std::get<24>(accumulator) += q_add * (q_add - 1) * scaling_factor; - std::get<25>(accumulator) += q_mul * (q_mul - 1) * scaling_factor; - std::get<26>(accumulator) += q_reset_accumulator * (q_reset_accumulator - 1) * scaling_factor; - std::get<27>(accumulator) += msm_transition * (msm_transition - 1) * scaling_factor; - std::get<28>(accumulator) += is_accumulator_empty * (is_accumulator_empty - 1) * scaling_factor; - std::get<29>(accumulator) += z1_zero * (z1_zero - 1) * scaling_factor; - std::get<30>(accumulator) += z2_zero * (z2_zero - 1) * scaling_factor; + std::get<23>(accumulator) += (q_eq.sqr() - q_eq) * scaling_factor; + std::get<24>(accumulator) += (q_add.sqr() - q_add) * scaling_factor; + std::get<25>(accumulator) += (q_mul.sqr() - q_mul) * scaling_factor; + std::get<26>(accumulator) += (q_reset_accumulator.sqr() - q_reset_accumulator) * scaling_factor; + std::get<27>(accumulator) += (msm_transition.sqr() - msm_transition) * scaling_factor; + std::get<28>(accumulator) += (is_accumulator_empty.sqr() - is_accumulator_empty) * scaling_factor; + std::get<29>(accumulator) += (z1_zero.sqr() - z1_zero) * scaling_factor; + std::get<30>(accumulator) += (z2_zero.sqr() - z2_zero) * scaling_factor; /** * @brief Initial condition check on 1st row. diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp index 3c7e7ca8433..111b5ebb253 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp @@ -64,7 +64,7 @@ void ECCVMWnafRelationImpl::accumulate(ContainerOverSubrelations& accumulato }; const auto range_constraint_slice_to_2_bits = [&scaling_factor](const View& s, auto& acc) { - acc += s * (s - 1) * (s - 2) * (s - 3) * scaling_factor; + acc += ((s - 1).sqr() - 1) * ((s - 2).sqr() - 1) * scaling_factor; }; const auto convert_to_wnaf = [](const View& s0, const View& s1) { diff --git a/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp index f6201145fba..b05740fc7b0 100644 --- a/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp @@ -63,8 +63,8 @@ template class EllipticRelationImpl { // Contribution (1) point addition, x-coordinate check // q_elliptic * (x3 + x2 + x1)(x2 - x1)(x2 - x1) - y2^2 - y1^2 + 2(y2y1)*q_sign = 0 auto x_diff = (x_2 - x_1); - auto y2_sqr = (y_2 * y_2); - auto y1_sqr = (y_1 * y_1); + auto y2_sqr = y_2.sqr(); + auto y1_sqr = y_1.sqr(); auto y1y2 = y_1 * y_2 * q_sign; auto x_add_identity = (x_3 + x_2 + x_1) * x_diff * x_diff - y2_sqr - y1_sqr + y1y2 + y1y2; diff --git a/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp index 274b644db9c..89fb3e10593 100644 --- a/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp @@ -66,17 +66,17 @@ template class Poseidon2ExternalRelationImpl { auto s4 = w_4 + q_4; // apply s-box round - auto u1 = s1 * s1; - u1 *= u1; + auto u1 = s1.sqr(); + u1 = u1.sqr(); u1 *= s1; - auto u2 = s2 * s2; - u2 *= u2; + auto u2 = s2.sqr(); + u2 = u2.sqr(); u2 *= s2; - auto u3 = s3 * s3; - u3 *= u3; + auto u3 = s3.sqr(); + u3 = u3.sqr(); u3 *= s3; - auto u4 = s4 * s4; - u4 *= u4; + auto u4 = s4.sqr(); + u4 = u4.sqr(); u4 *= s4; // matrix mul v = M_E * u with 14 additions diff --git a/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp index db4d4b02576..fa065567bce 100644 --- a/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp @@ -57,8 +57,8 @@ template class Poseidon2InternalRelationImpl { auto s1 = w_l + q_l; // apply s-box round - auto u1 = s1 * s1; - u1 *= u1; + auto u1 = s1.sqr(); + u1 = u1.sqr(); u1 *= s1; auto u2 = w_r; auto u3 = w_o; From e5f3ece131b16aeede897f0a9bb3ecc23cb4d9dc Mon Sep 17 00:00:00 2001 From: ludamad Date: Tue, 16 Apr 2024 07:44:28 -0400 Subject: [PATCH 18/56] fix: e2e getStack, disable failing e2e (#5768) Some of these were failing. Barring a fix, marking flakey --- .github/ci-setup-action/action.yml | 2 +- .github/workflows/ci.yml | 1 - yarn-project/circuit-types/src/simulation_error.ts | 6 ++++-- .../contract_class_registration.test.ts | 0 .../deploy_method.test.ts | 0 .../deploy_test.ts | 0 .../legacy.test.ts | 0 .../private_initialization.test.ts | 0 .../regressions.test.ts | 0 ...test.ts => flakey_e2e_inclusion_proofs_contract.test.ts} | 0 10 files changed, 5 insertions(+), 4 deletions(-) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/contract_class_registration.test.ts (100%) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/deploy_method.test.ts (100%) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/deploy_test.ts (100%) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/legacy.test.ts (100%) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/private_initialization.test.ts (100%) rename yarn-project/end-to-end/src/{e2e_deploy_contract => flakey_e2e_deploy_contract}/regressions.test.ts (100%) rename yarn-project/end-to-end/src/{e2e_inclusion_proofs_contract.test.ts => flakey_e2e_inclusion_proofs_contract.test.ts} (100%) diff --git a/.github/ci-setup-action/action.yml b/.github/ci-setup-action/action.yml index 4eba68046b3..e96dfd29a7c 100644 --- a/.github/ci-setup-action/action.yml +++ b/.github/ci-setup-action/action.yml @@ -64,5 +64,5 @@ runs: echo "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}" > "/run/${{ inputs.concurrency_key }}.lock" echo "/run/${{ inputs.concurrency_key }}.lock acquired." post: | - rm "/run/${{ inputs.concurrency_key }}.lock" + rm "/run/${{ inputs.concurrency_key }}.lock" || true echo "/run/${{ inputs.concurrency_key }}.lock removed." diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index a6a94add225..6c16a8dafbc 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -46,7 +46,6 @@ jobs: timeout-minutes: 40 run: earthly ./yarn-project+export-end-to-end # We base our e2e list used in e2e-x86 off the targets in ./yarn-project/end-to-end - # (Note ARM uses just 2 tests as a smoketest) - name: Create list of end-to-end jobs id: e2e_list run: echo "list=$(earthly ls ./yarn-project/end-to-end | grep -v '+base' | sed 's/+//' | jq -R . | jq -cs .)" >> $GITHUB_OUTPUT diff --git a/yarn-project/circuit-types/src/simulation_error.ts b/yarn-project/circuit-types/src/simulation_error.ts index 69e1b98166f..aa0ccd1dfa6 100644 --- a/yarn-project/circuit-types/src/simulation_error.ts +++ b/yarn-project/circuit-types/src/simulation_error.ts @@ -72,6 +72,8 @@ export class SimulationError extends Error { options?: ErrorOptions, ) { super(originalMessage, options); + const getMessage = () => this.getMessage(); + const getStack = () => this.getStack(); Object.defineProperties(this, { message: { configurable: false, @@ -82,7 +84,7 @@ export class SimulationError extends Error { * @returns The message. */ get() { - return this.getMessage(); + return getMessage(); }, }, stack: { @@ -93,7 +95,7 @@ export class SimulationError extends Error { * @returns The stack. */ get() { - return this.getStack(); + return getStack(); }, }, }); diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/contract_class_registration.test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/contract_class_registration.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/contract_class_registration.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/contract_class_registration.test.ts diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/deploy_method.test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/deploy_method.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/deploy_method.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/deploy_method.test.ts diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/deploy_test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/deploy_test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/deploy_test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/deploy_test.ts diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/legacy.test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/legacy.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/legacy.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/legacy.test.ts diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/private_initialization.test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/private_initialization.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/private_initialization.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/private_initialization.test.ts diff --git a/yarn-project/end-to-end/src/e2e_deploy_contract/regressions.test.ts b/yarn-project/end-to-end/src/flakey_e2e_deploy_contract/regressions.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_deploy_contract/regressions.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_deploy_contract/regressions.test.ts diff --git a/yarn-project/end-to-end/src/e2e_inclusion_proofs_contract.test.ts b/yarn-project/end-to-end/src/flakey_e2e_inclusion_proofs_contract.test.ts similarity index 100% rename from yarn-project/end-to-end/src/e2e_inclusion_proofs_contract.test.ts rename to yarn-project/end-to-end/src/flakey_e2e_inclusion_proofs_contract.test.ts From d37cbb95cfbb773242bda568f8a7a0b066edc437 Mon Sep 17 00:00:00 2001 From: ludamad Date: Tue, 16 Apr 2024 08:04:33 -0400 Subject: [PATCH 19/56] fix(ci,noir-projects): bring apt-get higher in cache (#5775) --- .github/workflows/ci.yml | 2 +- noir-projects/Earthfile | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6c16a8dafbc..72b97bb2e1d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -24,7 +24,7 @@ jobs: ebs_cache_size_gb: 256 runner_concurrency: 50 subaction: ${{ github.event.inputs.runner_action || 'start' }} - ec2_instance_type: m6a.48xlarge + ec2_instance_type: m6a.32xlarge ec2_ami_id: ami-04d8422a9ba4de80f ec2_instance_ttl: 40 # refreshed by jobs secrets: inherit diff --git a/noir-projects/Earthfile b/noir-projects/Earthfile index c5decbbbeab..ccdfe81acf1 100644 --- a/noir-projects/Earthfile +++ b/noir-projects/Earthfile @@ -1,5 +1,6 @@ VERSION 0.8 FROM ubuntu:lunar +RUN apt-get update && apt-get install -y parallel # Install nargo COPY ../noir/+nargo/nargo /usr/bin/nargo @@ -17,7 +18,6 @@ source: build: FROM +source - RUN apt-get update && apt-get install -y parallel RUN cd noir-contracts && NARGO=nargo TRANSPILER=avm-transpiler ./bootstrap.sh RUN cd noir-protocol-circuits && NARGO=nargo ./bootstrap.sh SAVE ARTIFACT aztec-nr From 4f55d1023b07df6bf4fc83b6ecb0024426585d0a Mon Sep 17 00:00:00 2001 From: Santiago Palladino Date: Tue, 16 Apr 2024 09:05:21 -0300 Subject: [PATCH 20/56] feat: Wire AVM gas used to public kernel (#5740) Starts wiring gas settings and usage across application and kernel circuits, tracking L2 gas used in the AVM first. This required the following changes to structs: - `PublicCircuitPublicInputs` now includes a `gas_left` to report how much was left at the end of their execution, as a means to report how much was used. - `CallContext` now includes a `gas_left` to inform the app circuit (private or public) how much gas it has available for execution. - `TxRequest` and `TxExecutionRequest` include a `GasSettings` so the user can specify their gas limits and max fees when creating a new tx. Other changes: - Renamed `GasUsed` struct to just `Gas` since it's used for tracking gas used and for tracking gas left depending on the context. - `FeePaymentMethod.getFunctionCalls` now accepts a `GasSettings` instead of a flat MaxFee, though the max fee can be calculated from the gas settings. --- .../circuits/private-function.md | 5 +- .../circuits/private-kernel-initial.mdx | 19 ++++ .../circuits/private-kernel-inner.mdx | 18 ++++ .../src/core/libraries/ConstantsGen.sol | 16 ++-- .../context/inputs/public_context_inputs.nr | 4 +- .../aztec/src/context/private_context.nr | 8 +- .../aztec/src/context/public_context.nr | 3 +- .../contracts/gas_token_contract/src/lib.nr | 1 + .../src/private_kernel_init.nr | 2 +- .../crates/public-kernel-lib/src/common.nr | 58 ++++++++++++ .../src/public_kernel_app_logic.nr | 32 ++++++- .../src/public_kernel_setup.nr | 31 ++++++- .../crates/types/src/abis.nr | 2 +- .../combined_accumulated_data.nr | 6 +- .../private_accumulated_data.nr | 4 +- .../private_accumulated_data_builder.nr | 6 +- .../public_accumulated_data.nr | 6 +- .../public_accumulated_data_builder.nr | 6 +- .../crates/types/src/abis/call_context.nr | 7 +- .../crates/types/src/abis/gas.nr | 58 ++++++++++++ .../crates/types/src/abis/gas_settings.nr | 21 ++++- .../crates/types/src/abis/gas_used.nr | 49 ---------- .../types/src/abis/private_call_stack_item.nr | 2 +- .../src/abis/private_circuit_public_inputs.nr | 2 +- .../types/src/abis/public_call_stack_item.nr | 4 +- .../src/abis/public_circuit_public_inputs.nr | 10 +- .../crates/types/src/constants.nr | 16 ++-- .../crates/types/src/tests/fixture_builder.nr | 8 +- .../src/tests/private_call_data_builder.nr | 12 ++- .../private_circuit_public_inputs_builder.nr | 14 +-- .../src/tests/public_call_data_builder.nr | 8 +- .../public_circuit_public_inputs_builder.nr | 11 ++- .../types/src/transaction/tx_request.nr | 29 ++++-- .../contract/contract_function_interaction.ts | 9 +- .../src/entrypoint/default_entrypoint.ts | 3 +- .../default_multi_call_entrypoint.ts | 3 +- .../aztec.js/src/entrypoint/payload.ts | 8 +- .../aztec.js/src/fee/fee_payment_method.ts | 7 +- .../src/fee/native_fee_payment_method.ts | 11 +-- .../src/fee/private_fee_payment_method.ts | 7 +- .../src/fee/public_fee_payment_method.ts | 8 +- yarn-project/circuit-types/src/mocks.ts | 2 + .../circuit-types/src/tx_execution_request.ts | 10 +- yarn-project/circuits.js/src/constants.gen.ts | 16 ++-- .../private_call_stack_item.test.ts.snap | 4 +- ...private_circuit_public_inputs.test.ts.snap | 4 +- .../public_call_stack_item.test.ts.snap | 6 +- .../public_circuit_public_inputs.test.ts.snap | 4 +- .../__snapshots__/tx_request.test.ts.snap | 2 +- .../circuits.js/src/structs/call_context.ts | 9 ++ yarn-project/circuits.js/src/structs/gas.ts | 67 +++++++++++++ .../circuits.js/src/structs/gas_fees.ts | 5 + .../circuits.js/src/structs/gas_settings.ts | 84 ++++++++++++++++- .../circuits.js/src/structs/gas_used.ts | 36 ------- yarn-project/circuits.js/src/structs/index.ts | 2 +- .../kernel/combined_accumulated_data.ts | 8 +- .../structs/kernel/combined_constant_data.ts | 2 +- .../kernel/private_accumulated_data.ts | 8 +- .../structs/kernel/public_accumulated_data.ts | 8 +- .../structs/public_circuit_public_inputs.ts | 11 ++- .../src/structs/tx_request.test.ts | 7 ++ .../circuits.js/src/structs/tx_request.ts | 32 ++++--- .../circuits.js/src/tests/factories.ts | 93 +++++++------------ .../src/benchmarks/bench_tx_size_fees.test.ts | 10 +- .../src/e2e_dapp_subscription.test.ts | 19 ++-- yarn-project/end-to-end/src/e2e_fees.test.ts | 53 +++++------ .../src/flakey_e2e_account_init_fees.test.ts | 15 +-- .../entrypoints/src/account_entrypoint.ts | 3 +- .../entrypoints/src/dapp_entrypoint.ts | 3 +- yarn-project/foundation/src/fields/fields.ts | 1 + .../src/__snapshots__/index.test.ts.snap | 32 +++---- .../nested-call-private-kernel-init.hex | 2 +- .../nested-call-private-kernel-inner.hex | 2 +- .../nested-call-private-kernel-ordering.hex | 2 +- .../noir-protocol-circuits-types/src/index.ts | 2 +- .../src/type_conversion.ts | 27 +++--- .../src/pxe_service/test/pxe_test_suite.ts | 2 + .../global_variable_builder/global_builder.ts | 2 +- .../src/avm/avm_execution_environment.ts | 10 +- .../simulator/src/avm/avm_machine_state.ts | 18 +++- .../simulator/src/avm/fixtures/index.ts | 4 +- .../src/avm/opcodes/external_calls.test.ts | 2 +- .../src/client/client_execution_context.ts | 7 +- .../src/client/private_execution.test.ts | 30 +++--- .../simulator/src/client/simulator.ts | 7 +- yarn-project/simulator/src/mocks/fixtures.ts | 5 +- .../src/public/abstract_phase_manager.ts | 2 + .../simulator/src/public/avm_executor.test.ts | 2 + .../simulator/src/public/execution.ts | 4 + yarn-project/simulator/src/public/executor.ts | 12 +-- .../simulator/src/public/index.test.ts | 22 +++-- .../src/public/public_execution_context.ts | 7 +- .../src/public/public_processor.test.ts | 2 +- .../src/public/transitional_adaptors.ts | 18 ++-- .../simulator/src/simulator/acvm_wasm.ts | 10 +- 95 files changed, 851 insertions(+), 440 deletions(-) create mode 100644 noir-projects/noir-protocol-circuits/crates/types/src/abis/gas.nr delete mode 100644 noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_used.nr create mode 100644 yarn-project/circuits.js/src/structs/gas.ts delete mode 100644 yarn-project/circuits.js/src/structs/gas_used.ts diff --git a/docs/docs/protocol-specs/circuits/private-function.md b/docs/docs/protocol-specs/circuits/private-function.md index fe8138e8134..6b603c08401 100644 --- a/docs/docs/protocol-specs/circuits/private-function.md +++ b/docs/docs/protocol-specs/circuits/private-function.md @@ -74,7 +74,10 @@ After generating a proof for a private function circuit, that proof (and associa | `portal_contract_address` | `AztecAddress` | Address of the portal contract to the storage contract. | | `is_delegate_call` | `bool` | A flag indicating whether the call is a [delegate call](../calls/delegate-calls.md). | | `is_static_call` | `bool` | A flag indicating whether the call is a [static call](../calls/static-calls.md). | -| `gas_settings` | [`GasSettings`](#gassettings) | Limits and max fees per each gas dimension. | +| `gas_settings` | [`GasSettings`](#gassettings) | User-defined limits and max fees per each gas dimension for the transaction. | +| `gas_left.da_gas` | `u32` | How much DA gas is available for this call. | +| `gas_left.l1_gas` | `u32` | How much L1 gas is available for this call. | +| `gas_left.l2_gas` | `u32` | How much L2 gas is available for this call. | | `transaction_fee` | `field` | Accumulated transaction fee, only set during teardown phase. | ### `GasSettings` diff --git a/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx b/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx index 9ca35a93df1..9770bd2de90 100644 --- a/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx +++ b/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx @@ -351,9 +351,11 @@ class TransactionRequest { function_data: FunctionData args_hash: field tx_context: TransactionContext + gas_settings: GasSettings } TransactionRequest *-- FunctionData: function_data TransactionRequest *-- TransactionContext: tx_context +TransactionRequest *-- GasSettings: gas_settings TransactionRequest ..> ConstantData: tx_context @@ -428,6 +430,19 @@ class FunctionData { function_type: private|public } +class GasSettings { + da.gas_limit: u32 + da.teardown_gas_limit: u32 + da.max_fee_per_gas: Fr + l1.gas_limit: u32 + l1.teardown_gas_limit: u32 + l1.max_fee_per_gas: Fr + l2.gas_limit: u32 + l2.teardown_gas_limit: u32 + l2.max_fee_per_gas: Fr + inclusion_fee: Fr +} + class PrivateFunctionPublicInputs { call_context: CallContext args_hash: field @@ -478,6 +493,9 @@ class CallContext { portal_contract_address: AztecAddress is_delegate_call: bool is_static_call: bool + gas_left: Gas + gas_settings: GasSettings + transaction_fee: field } CallContext ..> CallerContext : call_context @@ -702,6 +720,7 @@ Data that represents the caller's intent. | `function_data` | [`FunctionData`](#functiondata) | Data of the function being called. | | `args_hash` | `field` | Hash of the function arguments. | | `tx_context` | [`TransactionContext`](#transactioncontext) | Information about the transaction. | +| `gas_settings` | [`GasSettings`](#gassettings) | User-defined gas limits and max fees. | ### `PrivateCall` diff --git a/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx b/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx index ca4e5af9cce..acc3c2495a0 100644 --- a/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx +++ b/docs/docs/protocol-specs/circuits/private-kernel-inner.mdx @@ -147,9 +147,11 @@ class TransactionRequest { function_data: FunctionData args_hash: field tx_context: TransactionContext + gas_settings: GasSettings } TransactionRequest *-- FunctionData: function_data TransactionRequest *-- TransactionContext: tx_context +TransactionRequest *-- GasSettings: gas_settings TransactionRequest ..> ConstantData: tx_context @@ -224,6 +226,19 @@ class FunctionData { function_type: private|public } +class GasSettings { + da.gas_limit: u32 + da.teardown_gas_limit: u32 + da.max_fee_per_gas: Fr + l1.gas_limit: u32 + l1.teardown_gas_limit: u32 + l1.max_fee_per_gas: Fr + l2.gas_limit: u32 + l2.teardown_gas_limit: u32 + l2.max_fee_per_gas: Fr + inclusion_fee: Fr +} + class PrivateFunctionPublicInputs { call_context: CallContext args_hash: field @@ -276,6 +291,9 @@ class CallContext { portal_contract_address: AztecAddress is_delegate_call: bool is_static_call: bool + gas_left: Gas + gas_settings: GasSettings + transaction_fee: field } CallContext ..> CallerContext : call_context diff --git a/l1-contracts/src/core/libraries/ConstantsGen.sol b/l1-contracts/src/core/libraries/ConstantsGen.sol index b23000adb51..fe139215971 100644 --- a/l1-contracts/src/core/libraries/ConstantsGen.sol +++ b/l1-contracts/src/core/libraries/ConstantsGen.sol @@ -83,18 +83,18 @@ library Constants { uint256 internal constant DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; uint256 internal constant DEPLOYER_CONTRACT_ADDRESS = - 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4; + 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74; uint256 internal constant L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; uint256 internal constant MAX_NOTE_FIELDS_LENGTH = 20; uint256 internal constant GET_NOTE_ORACLE_RETURN_LENGTH = 23; uint256 internal constant MAX_NOTES_PER_PAGE = 10; uint256 internal constant VIEW_NOTE_ORACLE_RETURN_LENGTH = 212; uint256 internal constant AZTEC_ADDRESS_LENGTH = 1; - uint256 internal constant CALL_CONTEXT_LENGTH = 18; + uint256 internal constant CALL_CONTEXT_LENGTH = 21; uint256 internal constant GAS_SETTINGS_LENGTH = 10; uint256 internal constant DIMENSION_GAS_SETTINGS_LENGTH = 3; uint256 internal constant GAS_FEES_LENGTH = 3; - uint256 internal constant GAS_USED_LENGTH = 3; + uint256 internal constant GAS_LENGTH = 3; uint256 internal constant CONTENT_COMMITMENT_LENGTH = 4; uint256 internal constant CONTRACT_INSTANCE_LENGTH = 6; uint256 internal constant CONTRACT_STORAGE_READ_LENGTH = 2; @@ -110,13 +110,13 @@ library Constants { uint256 internal constant NULLIFIER_KEY_VALIDATION_REQUEST_LENGTH = 4; uint256 internal constant NULLIFIER_KEY_VALIDATION_REQUEST_CONTEXT_LENGTH = 5; uint256 internal constant PARTIAL_STATE_REFERENCE_LENGTH = 6; - uint256 internal constant PRIVATE_CALL_STACK_ITEM_LENGTH = 221; - uint256 internal constant PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 218; - uint256 internal constant PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH = 209; + uint256 internal constant PRIVATE_CALL_STACK_ITEM_LENGTH = 224; + uint256 internal constant PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 221; + uint256 internal constant PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH = 215; uint256 internal constant STATE_REFERENCE_LENGTH = 8; uint256 internal constant TX_CONTEXT_DATA_LENGTH = 4; - uint256 internal constant TX_REQUEST_LENGTH = 8; - uint256 internal constant ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH = 22; + uint256 internal constant TX_REQUEST_LENGTH = 18; + uint256 internal constant ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH = 25; uint256 internal constant GET_NOTES_ORACLE_RETURN_LENGTH = 674; uint256 internal constant NOTE_HASHES_NUM_BYTES_PER_BASE_ROLLUP = 2048; uint256 internal constant NULLIFIERS_NUM_BYTES_PER_BASE_ROLLUP = 2048; diff --git a/noir-projects/aztec-nr/aztec/src/context/inputs/public_context_inputs.nr b/noir-projects/aztec-nr/aztec/src/context/inputs/public_context_inputs.nr index 856d57a8085..fb2f1d27f42 100644 --- a/noir-projects/aztec-nr/aztec/src/context/inputs/public_context_inputs.nr +++ b/noir-projects/aztec-nr/aztec/src/context/inputs/public_context_inputs.nr @@ -1,6 +1,6 @@ use crate::context::globals::public_global_variables::PublicGlobalVariables; -use dep::protocol_types::{abis::call_context::CallContext, header::Header, traits::Empty}; +use dep::protocol_types::{abis::call_context::CallContext, abis::gas::Gas, header::Header, traits::Empty}; // PublicContextInputs are expected to be provided to each public function // docs:start:public-context-inputs @@ -23,4 +23,4 @@ impl Empty for PublicContextInputs { start_side_effect_counter: 0 as u32, } } -} \ No newline at end of file +} diff --git a/noir-projects/aztec-nr/aztec/src/context/private_context.nr b/noir-projects/aztec-nr/aztec/src/context/private_context.nr index 48e4824521f..32234d84f69 100644 --- a/noir-projects/aztec-nr/aztec/src/context/private_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/private_context.nr @@ -10,8 +10,9 @@ use crate::{ }; use dep::protocol_types::{ abis::{ - call_context::CallContext, function_data::FunctionData, function_selector::FunctionSelector, - max_block_number::MaxBlockNumber, nullifier_key_validation_request::NullifierKeyValidationRequest, + gas::Gas, call_context::CallContext, function_data::FunctionData, + function_selector::FunctionSelector, max_block_number::MaxBlockNumber, + nullifier_key_validation_request::NullifierKeyValidationRequest, private_call_stack_item::PrivateCallStackItem, private_circuit_public_inputs::PrivateCircuitPublicInputs, public_call_stack_item::PublicCallStackItem, @@ -494,7 +495,8 @@ impl PrivateContext { unencrypted_log_preimages_length: 0, historical_header: Header::empty(), prover_address: AztecAddress::zero(), - revert_code: 0 + revert_code: 0, + gas_left: Gas::empty() }, is_execution_request: true }; diff --git a/noir-projects/aztec-nr/aztec/src/context/public_context.nr b/noir-projects/aztec-nr/aztec/src/context/public_context.nr index af98dc9d169..a1257223850 100644 --- a/noir-projects/aztec-nr/aztec/src/context/public_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/public_context.nr @@ -154,7 +154,8 @@ impl PublicContext { unencrypted_log_preimages_length, historical_header: self.inputs.historical_header, prover_address: self.prover_address, - revert_code: 0 + revert_code: 0, + gas_left: self.inputs.call_context.gas_left }; pub_circuit_pub_inputs } diff --git a/noir-projects/noir-contracts/contracts/gas_token_contract/src/lib.nr b/noir-projects/noir-contracts/contracts/gas_token_contract/src/lib.nr index 9e9786bd2ed..dc2a42daf39 100644 --- a/noir-projects/noir-contracts/contracts/gas_token_contract/src/lib.nr +++ b/noir-projects/noir-contracts/contracts/gas_token_contract/src/lib.nr @@ -3,6 +3,7 @@ use dep::aztec::context::PublicContext; use dep::aztec::protocol_types::hash::sha256_to_field; pub fn calculate_fee(_context: PublicContext) -> U128 { + // TODO(palla/gas-in-circuits): Use the transaction_fee injected into the context U128::from_integer(1) } diff --git a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_init.nr b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_init.nr index 84e68d19d10..0c225152de1 100644 --- a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_init.nr +++ b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_init.nr @@ -22,7 +22,7 @@ impl PrivateKernelInitCircuitPrivateInputs { public_inputs.constants = CombinedConstantData { historical_header: self.private_call.call_stack_item.public_inputs.historical_header, tx_context: self.tx_request.tx_context, - gas_settings: GasSettings::empty(), // TODO(palla/gas-in-circuits) + gas_settings: self.tx_request.gas_settings, }; public_inputs.min_revertible_side_effect_counter = self.private_call.call_stack_item.public_inputs.min_revertible_side_effect_counter; } diff --git a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr index 1008e0c0f49..006b531e94d 100644 --- a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr +++ b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr @@ -94,6 +94,10 @@ pub fn initialize_end_values( ) { initialize_emitted_end_values(previous_kernel, circuit_outputs); + // Copy gas-used as-is. Gas used in this iteration will be deducted later in update_(non)_revertible_gas_used. + circuit_outputs.end.gas_used = previous_kernel.public_inputs.end.gas_used; + circuit_outputs.end_non_revertible.gas_used = previous_kernel.public_inputs.end_non_revertible.gas_used; + if circuit_outputs.revert_code == 0 { let start = previous_kernel.public_inputs.end; circuit_outputs.end.public_call_stack = array_to_bounded_vec(start.public_call_stack); @@ -169,6 +173,60 @@ pub fn update_validation_requests(public_call: PublicCallData, circuit_outputs: propagate_valid_public_data_reads(public_call, circuit_outputs); } +pub fn update_revertible_gas_used(public_call: PublicCallData, circuit_outputs: &mut PublicKernelCircuitPublicInputsBuilder) { + let tx_gas_limits = circuit_outputs.constants.gas_settings.get_gas_limits(); + let call_gas_left = public_call.call_stack_item.public_inputs.gas_left; + let accum_end_non_revertible_gas_used = circuit_outputs.end_non_revertible.gas_used; + + // dep::types::debug_log::debug_log_format( + // "Updating revertible gas: limit.da={0} limit.l1={1} limit.l2={2} left.da={3} left.l1={4} left.l2={5} used.da={6} used.l1={7} used.l2={8}", + // [ + // tx_gas_limits.da_gas as Field, + // tx_gas_limits.l1_gas as Field, + // tx_gas_limits.l2_gas as Field, + // call_gas_left.da_gas as Field, + // call_gas_left.l1_gas as Field, + // call_gas_left.l2_gas as Field, + // accum_end_non_revertible_gas_used.da_gas as Field, + // accum_end_non_revertible_gas_used.l1_gas as Field, + // accum_end_non_revertible_gas_used.l2_gas as Field + // ] + // ); + + circuit_outputs.end.gas_used = tx_gas_limits + .sub(call_gas_left) + .sub(accum_end_non_revertible_gas_used); +} + +pub fn update_non_revertible_gas_used(public_call: PublicCallData, circuit_outputs: &mut PublicKernelCircuitPublicInputsBuilder) { + let tx_gas_limits = circuit_outputs.constants.gas_settings.get_gas_limits(); + let call_gas_left = public_call.call_stack_item.public_inputs.gas_left; + let accum_end_gas_used = circuit_outputs.end.gas_used; + + // dep::types::debug_log::debug_log_format( + // "Updating non-revertible gas: limit.da={0} limit.l1={1} limit.l2={2} left.da={3} left.l1={4} left.l2={5} used.da={6} used.l1={7} used.l2={8}", + // [ + // tx_gas_limits.da_gas as Field, + // tx_gas_limits.l1_gas as Field, + // tx_gas_limits.l2_gas as Field, + // call_gas_left.da_gas as Field, + // call_gas_left.l1_gas as Field, + // call_gas_left.l2_gas as Field, + // accum_end_gas_used.da_gas as Field, + // accum_end_gas_used.l1_gas as Field, + // accum_end_gas_used.l2_gas as Field + // ] + // ); + + // println( + // f"Updating non-revertible gas: tx_gas_limits={tx_gas_limits} call_gas_left={call_gas_left} accum_end_gas_used={accum_end_gas_used}" + // ); + + circuit_outputs.end_non_revertible.gas_used = tx_gas_limits + .sub(call_gas_left) + .sub(accum_end_gas_used); +} + pub fn update_public_end_non_revertible_values( public_call: PublicCallData, circuit_outputs: &mut PublicKernelCircuitPublicInputsBuilder diff --git a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_app_logic.nr b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_app_logic.nr index 05dea2c0e60..d8be35f0b39 100644 --- a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_app_logic.nr +++ b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_app_logic.nr @@ -35,6 +35,8 @@ impl PublicKernelAppLogicCircuitPrivateInputs { common::update_validation_requests(self.public_call, &mut public_inputs); + common::update_revertible_gas_used(self.public_call, &mut public_inputs); + if public_inputs.revert_code == 0 { // Pops the item from the call stack and validates it against the current execution. let call_request = public_inputs.end.public_call_stack.pop(); @@ -75,9 +77,9 @@ mod tests { }; use dep::types::{ abis::{ - kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs, public_data_read::PublicDataRead, - public_data_update_request::PublicDataUpdateRequest, read_request::ReadRequest, - side_effect::{SideEffect, SideEffectLinkedToNoteHash} + gas::Gas, kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs, + public_data_read::PublicDataRead, public_data_update_request::PublicDataUpdateRequest, + read_request::ReadRequest, side_effect::{SideEffect, SideEffectLinkedToNoteHash} }, address::{AztecAddress, EthAddress}, contract_class_id::ContractClassId, hash::{compute_l2_to_l1_hash, compute_logs_hash, silo_note_hash, silo_nullifier}, @@ -448,4 +450,28 @@ mod tests { assert_eq(request_context.counter, request_1.counter); assert_eq(request_context.contract_address, storage_contract_address); } + + #[test] + fn updates_revertible_gas_used() { + let mut builder = PublicKernelAppLogicCircuitPrivateInputsBuilder::new(); + + // Transaction gas limit is 1k + builder.previous_kernel.gas_settings.da.gas_limit = 1000; + builder.previous_kernel.gas_settings.l1.gas_limit = 1000; + builder.previous_kernel.gas_settings.l2.gas_limit = 1000; + + // Revertible has already used 300 + builder.previous_kernel.gas_used = Gas::new(300, 300, 300); + + // This call starts with 700 gas left + builder.public_call.public_inputs.call_context.gas_left = Gas::new(700, 700, 700); + + // And uses 200, ending with 500 left + builder.public_call.public_inputs.gas_left = Gas::new(500, 500, 500); + + // So the updated gas used by revertible must go up by 200, and non-revertible must stay the same + let output = builder.execute(); + assert_eq(output.end.gas_used, Gas::new(500, 500, 500)); + assert_eq(output.end_non_revertible.gas_used, Gas::new(0, 0, 0)); + } } diff --git a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_setup.nr b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_setup.nr index 761bc370cf4..b3491928e08 100644 --- a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_setup.nr +++ b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_setup.nr @@ -39,6 +39,8 @@ impl PublicKernelSetupCircuitPrivateInputs { // validate the inputs unique to having a previous private kernel self.validate_inputs(); + common::update_non_revertible_gas_used(self.public_call, &mut public_inputs); + // Pops the item from the call stack and validates it against the current execution. let call_request = public_inputs.end_non_revertible.public_call_stack.pop(); common::validate_call_against_request(self.public_call, call_request); @@ -68,7 +70,7 @@ mod tests { }; use dep::types::{ abis::{ - call_request::CallRequest, function_selector::FunctionSelector, + call_request::CallRequest, function_selector::FunctionSelector, gas::Gas, kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs, max_block_number::MaxBlockNumber, public_data_read::PublicDataRead, public_data_update_request::PublicDataUpdateRequest, public_call_data::PublicCallData, read_request::ReadRequest @@ -496,4 +498,31 @@ mod tests { builder.failed(); } + + #[test] + fn updates_non_revertible_gas_used() { + let mut builder = PublicKernelSetupCircuitPrivateInputsBuilder::new(); + + // Transaction gas limit is 1k + builder.previous_kernel.gas_settings.da.gas_limit = 1000; + builder.previous_kernel.gas_settings.l1.gas_limit = 1000; + builder.previous_kernel.gas_settings.l2.gas_limit = 1000; + + // Revertible has already used 100 + builder.previous_revertible.gas_used = Gas::new(100, 100, 100); + + // And non-revertible has used another 200 + builder.previous_kernel.gas_used = Gas::new(200, 200, 200); + + // So this call starts with 700 gas left + builder.public_call.public_inputs.call_context.gas_left = Gas::new(700, 700, 700); + + // And uses 300, ending with 400 left + builder.public_call.public_inputs.gas_left = Gas::new(400, 400, 400); + + // So the updated gas used by non-revertible must go up by 300, and revertible must stay the same + let output = builder.execute(); + assert_eq(output.end_non_revertible.gas_used, Gas::new(500, 500, 500)); + assert_eq(output.end.gas_used, Gas::new(100, 100, 100)); + } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis.nr index d4576c369db..23762fd5bf3 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis.nr @@ -41,4 +41,4 @@ mod private_circuit_public_inputs; mod gas_fees; mod gas_settings; -mod gas_used; +mod gas; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr index da9ad715af6..93f148a675a 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr @@ -2,7 +2,7 @@ use crate::{ abis::{ accumulated_data::public_accumulated_data::PublicAccumulatedData, public_data_update_request::PublicDataUpdateRequest, - side_effect::{SideEffect, SideEffectLinkedToNoteHash}, gas_used::GasUsed + side_effect::{SideEffect, SideEffectLinkedToNoteHash}, gas::Gas }, constants::{ MAX_NEW_NOTE_HASHES_PER_TX, MAX_NEW_NULLIFIERS_PER_TX, MAX_NEW_L2_TO_L1_MSGS_PER_TX, @@ -26,7 +26,7 @@ struct CombinedAccumulatedData { public_data_update_requests: [PublicDataUpdateRequest; MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX], - gas_used: GasUsed, + gas_used: Gas, } impl CombinedAccumulatedData { @@ -59,7 +59,7 @@ impl Empty for CombinedAccumulatedData { encrypted_log_preimages_length: 0, unencrypted_log_preimages_length: 0, public_data_update_requests: [PublicDataUpdateRequest::empty(); MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX], - gas_used: GasUsed::empty() + gas_used: Gas::empty() } } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data.nr index 2d3304491dd..708f52a5785 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data.nr @@ -1,4 +1,4 @@ -use crate::{abis::{call_request::CallRequest, gas_used::GasUsed, side_effect::{SideEffect, SideEffectLinkedToNoteHash}}}; +use crate::{abis::{call_request::CallRequest, gas::Gas, side_effect::{SideEffect, SideEffectLinkedToNoteHash}}}; use crate::constants::{ MAX_NEW_NOTE_HASHES_PER_TX, MAX_NEW_NULLIFIERS_PER_TX, MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, MAX_NEW_L2_TO_L1_MSGS_PER_TX @@ -20,5 +20,5 @@ struct PrivateAccumulatedData { private_call_stack: [CallRequest; MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX], public_call_stack: [CallRequest; MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX], - gas_used: GasUsed, + gas_used: Gas, } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data_builder.nr index 078888372fc..f4952927111 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/private_accumulated_data_builder.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - gas_used::GasUsed, + gas::Gas, accumulated_data::{ combined_accumulated_data::CombinedAccumulatedData, private_accumulated_data::PrivateAccumulatedData, public_accumulated_data::PublicAccumulatedData, @@ -33,7 +33,7 @@ struct PrivateAccumulatedDataBuilder { private_call_stack: BoundedVec, public_call_stack: BoundedVec, - gas_used: GasUsed + gas_used: Gas } impl PrivateAccumulatedDataBuilder { @@ -204,7 +204,7 @@ impl Empty for PrivateAccumulatedDataBuilder { unencrypted_log_preimages_length: 0, private_call_stack: BoundedVec::new(), public_call_stack: BoundedVec::new(), - gas_used: GasUsed::empty(), + gas_used: Gas::empty(), } } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data.nr index e1e472a0e2f..813d86ec94b 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - call_request::CallRequest, public_data_update_request::PublicDataUpdateRequest, gas_used::GasUsed, + call_request::CallRequest, public_data_update_request::PublicDataUpdateRequest, gas::Gas, side_effect::{SideEffect, SideEffectLinkedToNoteHash} }, constants::{ @@ -27,7 +27,7 @@ struct PublicAccumulatedData { public_call_stack: [CallRequest; MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX], - gas_used: GasUsed, + gas_used: Gas, } impl Empty for PublicAccumulatedData { @@ -42,7 +42,7 @@ impl Empty for PublicAccumulatedData { unencrypted_log_preimages_length: 0, public_data_update_requests: [PublicDataUpdateRequest::empty(); MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX], public_call_stack: [CallRequest::empty(); MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX], - gas_used: GasUsed::empty(), + gas_used: Gas::empty(), } } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data_builder.nr index 66cc145413f..02bb488ff27 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/public_accumulated_data_builder.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - gas_used::GasUsed, accumulated_data::public_accumulated_data::PublicAccumulatedData, + gas::Gas, accumulated_data::public_accumulated_data::PublicAccumulatedData, call_request::CallRequest, public_data_update_request::PublicDataUpdateRequest, side_effect::{SideEffect, SideEffectLinkedToNoteHash} }, @@ -28,7 +28,7 @@ struct PublicAccumulatedDataBuilder { public_call_stack: BoundedVec, - gas_used: GasUsed, + gas_used: Gas, } impl PublicAccumulatedDataBuilder { @@ -60,7 +60,7 @@ impl Empty for PublicAccumulatedDataBuilder { unencrypted_log_preimages_length: 0, public_data_update_requests: BoundedVec::new(), public_call_stack: BoundedVec::new(), - gas_used: GasUsed::empty(), + gas_used: Gas::empty(), } } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/call_context.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/call_context.nr index ab2c27b2b70..870e4b80df5 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/call_context.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/call_context.nr @@ -2,7 +2,7 @@ use crate::{ abis::function_selector::FunctionSelector, address::{EthAddress, AztecAddress}, constants::{CALL_CONTEXT_LENGTH, GENERATOR_INDEX__CALL_CONTEXT}, hash::pedersen_hash, traits::{Deserialize, Hash, Serialize, Empty}, abis::side_effect::Ordered, - abis::gas_settings::GasSettings, utils::reader::Reader + abis::{gas_settings::GasSettings, gas::Gas}, utils::reader::Reader }; // docs:start:call-context @@ -10,8 +10,8 @@ struct CallContext { msg_sender : AztecAddress, storage_contract_address : AztecAddress, portal_contract_address : EthAddress, - function_selector : FunctionSelector, + gas_left: Gas, is_delegate_call : bool, is_static_call : bool, @@ -53,6 +53,7 @@ impl Serialize for CallContext { serialized.push(self.storage_contract_address.to_field()); serialized.push(self.portal_contract_address.to_field()); serialized.push(self.function_selector.to_field()); + serialized.extend_from_array(self.gas_left.serialize()); serialized.push(self.is_delegate_call as Field); serialized.push(self.is_static_call as Field); serialized.push(self.side_effect_counter as Field); @@ -71,6 +72,7 @@ impl Deserialize for CallContext { storage_contract_address: AztecAddress::from_field(reader.read()), portal_contract_address: EthAddress::from_field(reader.read()), function_selector: FunctionSelector::from_field(reader.read()), + gas_left: reader.read_struct(Gas::deserialize), is_delegate_call: reader.read() as bool, is_static_call: reader.read() as bool, side_effect_counter: reader.read() as u32, @@ -87,6 +89,7 @@ impl Empty for CallContext { storage_contract_address: AztecAddress::empty(), portal_contract_address: EthAddress::empty(), function_selector: FunctionSelector::empty(), + gas_left: Gas::empty(), is_delegate_call: false, is_static_call: false, side_effect_counter: 0, diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas.nr new file mode 100644 index 00000000000..d4c6297b98b --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas.nr @@ -0,0 +1,58 @@ +use crate::{ + abis::function_selector::FunctionSelector, address::{EthAddress, AztecAddress}, + constants::GAS_LENGTH, hash::pedersen_hash, traits::{Deserialize, Hash, Serialize, Empty}, + abis::side_effect::Ordered, utils::reader::Reader +}; + +struct Gas { + da_gas: u32, + l1_gas: u32, + l2_gas: u32, +} + +impl Gas { + pub fn new(da_gas: u32, l1_gas: u32, l2_gas: u32) -> Self { + Self { da_gas, l1_gas, l2_gas } + } + + fn add(self, other: Gas) -> Self { + Gas::new( + self.da_gas + other.da_gas, + self.l1_gas + other.l1_gas, + self.l2_gas + other.l2_gas + ) + } + + fn sub(self, other: Gas) -> Self { + Gas::new( + self.da_gas - other.da_gas, + self.l1_gas - other.l1_gas, + self.l2_gas - other.l2_gas + ) + } +} + +impl Serialize for Gas { + fn serialize(self) -> [Field; GAS_LENGTH] { + [self.da_gas as Field, self.l1_gas as Field, self.l2_gas as Field] + } +} + +impl Deserialize for Gas { + fn deserialize(serialized: [Field; GAS_LENGTH]) -> Gas { + Gas::new(serialized[0] as u32, serialized[1] as u32, serialized[2] as u32) + } +} + +impl Eq for Gas { + fn eq(self, other : Gas) -> bool { + (self.da_gas == other.da_gas) & (self.l1_gas == other.l1_gas) & (self.l2_gas == other.l2_gas) + } +} + +impl Empty for Gas { + fn empty() -> Self { + Gas::new(0, 0, 0) + } +} + diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_settings.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_settings.nr index d2fcb6c451c..f50b22528d9 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_settings.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_settings.nr @@ -1,5 +1,5 @@ use crate::{ - abis::function_selector::FunctionSelector, address::{EthAddress, AztecAddress}, + abis::function_selector::FunctionSelector, address::{EthAddress, AztecAddress}, abis::gas::Gas, constants::{GAS_SETTINGS_LENGTH, DIMENSION_GAS_SETTINGS_LENGTH}, hash::pedersen_hash, traits::{Deserialize, Hash, Serialize, Empty}, abis::side_effect::Ordered, utils::reader::Reader }; @@ -20,6 +20,16 @@ impl GasSettings { ) -> Self { Self { da, l1, l2, inclusion_fee } } + + fn get_gas_limits(self) -> Gas { + Gas { da_gas: self.da.gas_limit, l1_gas: self.l1.gas_limit, l2_gas: self.l2.gas_limit } + } +} + +impl Eq for GasSettings { + fn eq(self, other: Self) -> bool { + (self.da == other.da) & (self.l1 == other.l1) & (self.l2 == other.l2) & (self.inclusion_fee == other.inclusion_fee) + } } impl Empty for GasSettings { @@ -65,11 +75,18 @@ struct DimensionGasSettings { } impl DimensionGasSettings { - fn new(gas_limit: u32, teardown_gas_limit: u32, max_fee_per_gas: Field) -> Self { + pub fn new(gas_limit: u32, teardown_gas_limit: u32, max_fee_per_gas: Field) -> Self { Self { gas_limit, teardown_gas_limit, max_fee_per_gas } } } +impl Eq for DimensionGasSettings { + fn eq(self, other: Self) -> bool { + (self.gas_limit == other.gas_limit) & (self.teardown_gas_limit == other.teardown_gas_limit) & (self.max_fee_per_gas == other.max_fee_per_gas) + } + +} + impl Serialize for DimensionGasSettings { fn serialize(self) -> [Field; DIMENSION_GAS_SETTINGS_LENGTH] { [ diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_used.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_used.nr deleted file mode 100644 index 9ac8a02520f..00000000000 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/gas_used.nr +++ /dev/null @@ -1,49 +0,0 @@ -use crate::{ - abis::function_selector::FunctionSelector, address::{EthAddress, AztecAddress}, - constants::GAS_USED_LENGTH, hash::pedersen_hash, traits::{Deserialize, Hash, Serialize, Empty}, - abis::side_effect::Ordered, utils::reader::Reader -}; - -struct GasUsed { - da_gas: Field, - l1_gas: Field, - l2_gas: Field, -} - -impl GasUsed { - fn new(da_gas: Field, l1_gas: Field, l2_gas: Field) -> Self { - Self { da_gas, l1_gas, l2_gas } - } - - fn add(self, other: GasUsed) -> Self { - GasUsed::new( - self.da_gas + other.da_gas, - self.l1_gas + other.l1_gas, - self.l2_gas + other.l2_gas - ) - } -} - -impl Serialize for GasUsed { - fn serialize(self) -> [Field; GAS_USED_LENGTH] { - [self.da_gas, self.l1_gas, self.l2_gas] - } -} - -impl Deserialize for GasUsed { - fn deserialize(serialized: [Field; GAS_USED_LENGTH]) -> GasUsed { - GasUsed::new(serialized[0], serialized[1], serialized[2]) - } -} - -impl Eq for GasUsed { - fn eq(self, other : GasUsed) -> bool { - (self.da_gas == other.da_gas) & (self.l1_gas == other.l1_gas) & (self.l2_gas == other.l2_gas) - } -} - -impl Empty for GasUsed { - fn empty() -> Self { - GasUsed::new(0, 0, 0) - } -} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_call_stack_item.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_call_stack_item.nr index e74c6fd8e0d..df4227c518c 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_call_stack_item.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_call_stack_item.nr @@ -85,6 +85,6 @@ fn empty_hash() { let hash = item.hash(); // Value from private_call_stack_item.test.ts "computes empty item hash" test - let test_data_empty_hash = 0x229caf5ebf8961d7cbfdf2f7a5db62810d130b598900a0be1137394a43371bc6; + let test_data_empty_hash = 0x243b1b69ea529d158803cc7a16b52293c5e5f2a1859337e3f69e4b20f55c6fb6; assert_eq(hash, test_data_empty_hash); } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_circuit_public_inputs.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_circuit_public_inputs.nr index b985d0b236a..637e8ac2e99 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_circuit_public_inputs.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/private_circuit_public_inputs.nr @@ -212,6 +212,6 @@ fn empty_hash() { let hash = inputs.hash(); // Value from private_circuit_public_inputs.test.ts "computes empty item hash" test - let test_data_empty_hash = 0x13ba2af75e4afaa4e52dd1afa083e87706cdbab1a33442025dc3a9bbb546d207; + let test_data_empty_hash = 0x02e09d8c4897d560bd4caf05ab45fa22e1d4a251bf5b5e0448310a7f40f7a0b8; assert_eq(hash, test_data_empty_hash); } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_call_stack_item.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_call_stack_item.nr index 76f1c28c495..1a5f9dd9be8 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_call_stack_item.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_call_stack_item.nr @@ -69,7 +69,7 @@ mod tests { let call_stack_item = PublicCallStackItem { contract_address, public_inputs, is_execution_request: true, function_data }; // Value from public_call_stack_item.test.ts "Computes a callstack item request hash" test - let test_data_call_stack_item_request_hash = 0x151bc9ee42eb63112fb2a350dcaa33c4c4b81cc37ded8773e785f47029f35983; + let test_data_call_stack_item_request_hash = 0x12c634ebadf4209e2def6cac0753f151422faf11237dc4f136bc17a84c8c2d76; assert_eq(call_stack_item.hash(), test_data_call_stack_item_request_hash); } @@ -87,7 +87,7 @@ mod tests { let call_stack_item = PublicCallStackItem { contract_address, public_inputs, is_execution_request: false, function_data }; // Value from public_call_stack_item.test.ts "Computes a callstack item hash" test - let test_data_call_stack_item_hash = 0x1a7b9d0cd965f512a3b3ed70333198a2a69bd4f9e70be68379c54e68a7b07a4c; + let test_data_call_stack_item_hash = 0x0864975afc9bec7eb7ec5b5608bbef648ec9afead1bbe986d0af148e3c944b9b; assert_eq(call_stack_item.hash(), test_data_call_stack_item_hash); } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_circuit_public_inputs.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_circuit_public_inputs.nr index 3a6182880db..7e96d95c411 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_circuit_public_inputs.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/public_circuit_public_inputs.nr @@ -1,7 +1,7 @@ use crate::{ abis::{ call_context::CallContext, read_request::ReadRequest, - side_effect::{SideEffect, SideEffectLinkedToNoteHash} + side_effect::{SideEffect, SideEffectLinkedToNoteHash}, gas::Gas }, address::AztecAddress, constants::{ @@ -49,6 +49,9 @@ struct PublicCircuitPublicInputs{ prover_address: AztecAddress, revert_code: u8, + + // gas left after execution is completed + gas_left: Gas, } impl Eq for PublicCircuitPublicInputs { @@ -95,6 +98,7 @@ impl Serialize for PublicCircuitPublicInput fields.extend_from_array(self.historical_header.serialize()); fields.push(self.prover_address.to_field()); fields.push(self.revert_code as Field); + fields.extend_from_array(self.gas_left.serialize()); fields.storage } } @@ -122,6 +126,7 @@ impl Deserialize for PublicCircuitPublicInp historical_header: reader.read_struct(Header::deserialize), prover_address: reader.read_struct(AztecAddress::deserialize), revert_code: reader.read() as u8, + gas_left: reader.read_struct(Gas::deserialize), }; reader.finish(); @@ -156,6 +161,7 @@ impl Empty for PublicCircuitPublicInputs { historical_header: Header::empty(), prover_address: AztecAddress::zero(), revert_code: 0 as u8, + gas_left: Gas::empty(), } } } @@ -174,6 +180,6 @@ fn empty_hash() { let hash = inputs.hash(); // Value from public_circuit_public_inputs.test.ts "computes empty item hash" test - let test_data_empty_hash = 0x2745ec62624afeb19b86af3d440db1f8c3432e1d17a074c75cb8f44999fd3fae; + let test_data_empty_hash = 0x00147d3d2cde08ee1046bf73cb6664c2bdf11b43c5dca0e72f4137f354bdad25; assert_eq(hash, test_data_empty_hash); } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr index a97ddbf9121..96f1a6dcdd2 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr @@ -118,7 +118,7 @@ global REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af8166354 // CONTRACT INSTANCE CONSTANTS // sha224sum 'struct ContractInstanceDeployed' global DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; -global DEPLOYER_CONTRACT_ADDRESS = 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4; +global DEPLOYER_CONTRACT_ADDRESS = 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74; // NOIR CONSTANTS - constants used only in yarn-packages/noir-contracts // Some are defined here because Noir doesn't yet support globals referencing other globals yet. @@ -136,11 +136,11 @@ global VIEW_NOTE_ORACLE_RETURN_LENGTH: u64 = 212; // LENGTH OF STRUCTS SERIALIZED TO FIELDS global AZTEC_ADDRESS_LENGTH = 1; -global CALL_CONTEXT_LENGTH: u64 = 18; // 8 + GAS_SETTINGS_LENGTH +global CALL_CONTEXT_LENGTH: u64 = 21; // 8 + GAS_SETTINGS_LENGTH + GAS_LENGTH global GAS_SETTINGS_LENGTH: u64 = 10; // 1 + 3 * DIMENSION_GAS_SETTINGS_LENGTH global DIMENSION_GAS_SETTINGS_LENGTH: u64 = 3; global GAS_FEES_LENGTH: u64 = 3; -global GAS_USED_LENGTH: u64 = 3; +global GAS_LENGTH: u64 = 3; global CONTENT_COMMITMENT_LENGTH: u64 = 4; global CONTRACT_INSTANCE_LENGTH: u64 = 6; global CONTRACT_STORAGE_READ_LENGTH: u64 = 2; @@ -156,18 +156,18 @@ global MAX_BLOCK_NUMBER_LENGTH: u64 = 2; // 1 for the option flag, 1 for the val global NULLIFIER_KEY_VALIDATION_REQUEST_LENGTH = 4; global NULLIFIER_KEY_VALIDATION_REQUEST_CONTEXT_LENGTH = 5; global PARTIAL_STATE_REFERENCE_LENGTH: u64 = 6; -global PRIVATE_CALL_STACK_ITEM_LENGTH: u64 = 221; +global PRIVATE_CALL_STACK_ITEM_LENGTH: u64 = 224; // Change this ONLY if you have changed the PrivateCircuitPublicInputs structure. // In other words, if the structure/size of the public inputs of a function call changes then we should change this // constant as well PRIVATE_CALL_STACK_ITEM_LENGTH -global PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH: u64 = 218; +global PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH: u64 = 221; // Change this ONLY if you have changed the PublicCircuitPublicInputs structure. -global PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH: u64 = 209; +global PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH: u64 = 215; global STATE_REFERENCE_LENGTH: u64 = 8; // 2 for snap + 8 for partial global TX_CONTEXT_DATA_LENGTH: u64 = 4; -global TX_REQUEST_LENGTH: u64 = 8; // 2 + TX_CONTEXT_DATA_LENGTH + FUNCTION_DATA_LENGTH +global TX_REQUEST_LENGTH: u64 = 18; // 2 + TX_CONTEXT_DATA_LENGTH + FUNCTION_DATA_LENGTH + GAS_SETTINGS_LENGTH -global ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH: Field = 22; // 2 + FUNCTION_DATA_LENGTH + CALL_CONTEXT_LENGTH +global ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH: Field = 25; // 2 + FUNCTION_DATA_LENGTH + CALL_CONTEXT_LENGTH global GET_NOTES_ORACLE_RETURN_LENGTH: u64 = 674; global NOTE_HASHES_NUM_BYTES_PER_BASE_ROLLUP: Field = 2048; global NULLIFIERS_NUM_BYTES_PER_BASE_ROLLUP: Field = 2048; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr index bf56794334d..9c6a861edde 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - gas_used::GasUsed, gas_settings::GasSettings, call_context::CallContext, + gas::Gas, gas_settings::GasSettings, call_context::CallContext, call_request::{CallerContext, CallRequest}, accumulated_data::{ CombinedAccumulatedData, PrivateAccumulatedData, PrivateAccumulatedDataBuilder, @@ -47,7 +47,7 @@ struct FixtureBuilder { public_data_update_requests: BoundedVec, private_call_stack: BoundedVec, public_call_stack: BoundedVec, - gas_used: GasUsed, + gas_used: Gas, // Validation requests. max_block_number: MaxBlockNumber, @@ -101,7 +101,7 @@ impl FixtureBuilder { revert_code: 0, min_revertible_side_effect_counter: 0, counter: 0, - gas_used: GasUsed::empty(), + gas_used: Gas::empty(), gas_settings: GasSettings::empty() } } @@ -420,7 +420,7 @@ impl Empty for FixtureBuilder { min_revertible_side_effect_counter: 0, counter: 0, gas_settings: GasSettings::empty(), - gas_used: GasUsed::empty(), + gas_used: Gas::empty(), } } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_call_data_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_call_data_builder.nr index 7ed7b0de818..6063bef7866 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_call_data_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_call_data_builder.nr @@ -1,7 +1,8 @@ use crate::{ abis::{ - call_request::{CallerContext, CallRequest}, private_call_stack_item::PrivateCallStackItem, - function_data::FunctionData, max_block_number::MaxBlockNumber, + gas_settings::GasSettings, call_request::{CallerContext, CallRequest}, + private_call_stack_item::PrivateCallStackItem, function_data::FunctionData, + max_block_number::MaxBlockNumber, membership_witness::{FunctionLeafMembershipWitness, NoteHashReadRequestMembershipWitness}, private_circuit_public_inputs::PrivateCircuitPublicInputs, private_kernel::private_call_data::PrivateCallData @@ -38,6 +39,7 @@ struct PrivateCallDataBuilder { note_hash_read_request_membership_witnesses: BoundedVec, portal_contract_address: EthAddress, acir_hash: Field, + gas_settings: GasSettings, } impl PrivateCallDataBuilder { @@ -64,7 +66,8 @@ impl PrivateCallDataBuilder { contract_class_public_bytecode_commitment: contract_data.public_bytecode_commitment, note_hash_read_request_membership_witnesses: BoundedVec::new(), portal_contract_address: public_inputs.call_context.portal_contract_address, - acir_hash: contract_function.acir_hash + acir_hash: contract_function.acir_hash, + gas_settings: public_inputs.call_context.gas_settings } } @@ -87,7 +90,8 @@ impl PrivateCallDataBuilder { origin: self.contract_address, args_hash: self.public_inputs.args_hash, tx_context, - function_data: self.function_data + function_data: self.function_data, + gas_settings: self.gas_settings } } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_circuit_public_inputs_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_circuit_public_inputs_builder.nr index 56d4175f62c..5858a61e8a2 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_circuit_public_inputs_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/private_circuit_public_inputs_builder.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - call_context::CallContext, gas_settings::{GasSettings, DimensionGasSettings}, + call_context::CallContext, gas_settings::{GasSettings, DimensionGasSettings}, gas::Gas, max_block_number::MaxBlockNumber, nullifier_key_validation_request::NullifierKeyValidationRequest, private_circuit_public_inputs::PrivateCircuitPublicInputs, read_request::ReadRequest, side_effect::{SideEffect, SideEffectLinkedToNoteHash} @@ -14,7 +14,7 @@ use crate::{ MAX_NULLIFIER_KEY_VALIDATION_REQUESTS_PER_CALL, MAX_NEW_NOTE_HASHES_PER_CALL, MAX_NEW_NULLIFIERS_PER_CALL, MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL, MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL, MAX_NEW_L2_TO_L1_MSGS_PER_CALL - }, +}, traits::Empty }; @@ -73,12 +73,8 @@ impl PrivateCircuitPublicInputsBuilder { is_delegate_call: false, is_static_call: false, side_effect_counter: 0, - gas_settings: GasSettings { - da: DimensionGasSettings::new(0, 0, 0), - l1: DimensionGasSettings::new(0, 0, 0), - l2: DimensionGasSettings::new(0, 0, 0), - inclusion_fee: 0 - }, + gas_left: Gas::empty(), + gas_settings: GasSettings::empty(), transaction_fee: 0 }; public_inputs.call_context = call_context; @@ -143,4 +139,4 @@ impl Empty for PrivateCircuitPublicInputsBuilder { version: 0, } } -} \ No newline at end of file +} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_call_data_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_call_data_builder.nr index 7338a726363..5efc84e71df 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_call_data_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_call_data_builder.nr @@ -1,8 +1,9 @@ use crate::{ abis::{ - gas_settings::GasSettings, call_context::CallContext, call_request::{CallerContext, CallRequest}, - function_data::FunctionData, public_call_data::PublicCallData, - public_call_stack_item::PublicCallStackItem, public_circuit_public_inputs::PublicCircuitPublicInputs + gas_settings::GasSettings, gas::Gas, call_context::CallContext, + call_request::{CallerContext, CallRequest}, function_data::FunctionData, + public_call_data::PublicCallData, public_call_stack_item::PublicCallStackItem, + public_circuit_public_inputs::PublicCircuitPublicInputs }, address::{AztecAddress, EthAddress}, contrakt::{storage_read::StorageRead, storage_update_request::StorageUpdateRequest}, mocked::Proof, @@ -45,6 +46,7 @@ impl PublicCallDataBuilder { side_effect_counter: 0, // needed? gas_settings: GasSettings::empty(), transaction_fee: 0, + gas_left: Gas::empty(), }; PublicCallDataBuilder { diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_circuit_public_inputs_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_circuit_public_inputs_builder.nr index 2898875fce6..c719774093e 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_circuit_public_inputs_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/public_circuit_public_inputs_builder.nr @@ -1,6 +1,6 @@ use crate::{ abis::{ - call_context::CallContext, public_circuit_public_inputs::PublicCircuitPublicInputs, + gas::Gas, call_context::CallContext, public_circuit_public_inputs::PublicCircuitPublicInputs, read_request::ReadRequest, side_effect::{SideEffect, SideEffectLinkedToNoteHash} }, address::AztecAddress, @@ -14,7 +14,7 @@ use crate::{ MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL, MAX_PUBLIC_DATA_READS_PER_CALL, MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_CALL }, -traits::Empty, + traits::Empty }; struct PublicCircuitPublicInputsBuilder { @@ -36,6 +36,7 @@ struct PublicCircuitPublicInputsBuilder { historical_header: Header, prover_address: AztecAddress, revert_code: u8, + gas_left: Gas, } impl PublicCircuitPublicInputsBuilder { @@ -65,7 +66,8 @@ impl PublicCircuitPublicInputsBuilder { unencrypted_log_preimages_length: self.unencrypted_log_preimages_length, historical_header: self.historical_header, prover_address: self.prover_address, - revert_code: self.revert_code + revert_code: self.revert_code, + gas_left: self.gas_left } } } @@ -91,6 +93,7 @@ impl Empty for PublicCircuitPublicInputsBuilder { historical_header: Header::empty(), prover_address: AztecAddress::zero(), revert_code: 0 as u8, + gas_left: Gas::empty(), } } -} \ No newline at end of file +} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/transaction/tx_request.nr b/noir-projects/noir-protocol-circuits/crates/types/src/transaction/tx_request.nr index 74be0805af5..59b1299d7e0 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/transaction/tx_request.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/transaction/tx_request.nr @@ -1,7 +1,8 @@ use crate::{ - address::AztecAddress, abis::function_data::FunctionData, + address::AztecAddress, abis::function_data::FunctionData, abis::gas_settings::GasSettings, constants::{GENERATOR_INDEX__TX_REQUEST, TX_REQUEST_LENGTH}, hash::pedersen_hash, - traits::{Hash, Serialize, Deserialize, Empty}, transaction::tx_context::TxContext, utils::reader::Reader + traits::{Hash, Serialize, Deserialize, Empty}, transaction::tx_context::TxContext, + utils::reader::Reader }; struct TxRequest { @@ -9,6 +10,7 @@ struct TxRequest { args_hash: Field, tx_context: TxContext, function_data: FunctionData, + gas_settings: GasSettings, } impl Empty for TxRequest { @@ -17,7 +19,8 @@ impl Empty for TxRequest { origin: AztecAddress::empty(), args_hash: 0, tx_context: TxContext::empty(), - function_data: FunctionData::empty() + function_data: FunctionData::empty(), + gas_settings: GasSettings::empty(), } } } @@ -27,7 +30,8 @@ impl Eq for TxRequest { (self.origin == other.origin) & (self.args_hash == other.args_hash) & (self.tx_context == other.tx_context) & - (self.function_data == other.function_data) + (self.function_data == other.function_data) & + (self.gas_settings == other.gas_settings) } } @@ -46,6 +50,7 @@ impl Serialize for TxRequest { fields.extend_from_array(self.function_data.serialize()); fields.push(self.args_hash); fields.extend_from_array(self.tx_context.serialize()); + fields.extend_from_array(self.gas_settings.serialize()); assert_eq(fields.len(), TX_REQUEST_LENGTH); @@ -62,6 +67,7 @@ impl Deserialize for TxRequest { args_hash: reader.read(), tx_context: reader.read_struct(TxContext::deserialize), function_data: reader.read_struct(FunctionData::deserialize), + gas_settings: reader.read_struct(GasSettings::deserialize), }; reader.finish(); @@ -71,7 +77,10 @@ impl Deserialize for TxRequest { mod tests { use crate::{ - abis::{function_selector::FunctionSelector, function_data::FunctionData}, + abis::{ + function_selector::FunctionSelector, function_data::FunctionData, + gas_settings::{GasSettings, DimensionGasSettings} + }, address::{AztecAddress, EthAddress}, contract_class_id::ContractClassId, grumpkin_point::GrumpkinPoint, transaction::{tx_request::TxRequest, tx_context::TxContext} }; @@ -90,10 +99,16 @@ mod tests { origin: AztecAddress::from_field(1), args_hash: 3, tx_context: TxContext { is_fee_payment_tx: false, is_rebate_payment_tx: false, chain_id: 0, version: 0 }, - function_data: FunctionData { selector: FunctionSelector::from_u32(2), is_private: true } + function_data: FunctionData { selector: FunctionSelector::from_u32(2), is_private: true }, + gas_settings: GasSettings { + da: DimensionGasSettings { gas_limit: 2, teardown_gas_limit: 1, max_fee_per_gas: 3 }, + l1: DimensionGasSettings { gas_limit: 2, teardown_gas_limit: 1, max_fee_per_gas: 3 }, + l2: DimensionGasSettings { gas_limit: 2, teardown_gas_limit: 1, max_fee_per_gas: 3 }, + inclusion_fee: 10 + } }; // Value from tx_request.test.ts "compute hash" test - let test_data_tx_request_hash = 0x20af6f595c396494f1177fa196d17e98d55a2416b28c262b76e78a36d6c01daa; + let test_data_tx_request_hash = 0x03b678e327818eb368f9eac21839ee67a98968318f0dcd76c89d3fcf66af7257; assert(tx_request.hash() == test_data_tx_request_hash); } } diff --git a/yarn-project/aztec.js/src/contract/contract_function_interaction.ts b/yarn-project/aztec.js/src/contract/contract_function_interaction.ts index 897bd6ba1b9..5f8033124db 100644 --- a/yarn-project/aztec.js/src/contract/contract_function_interaction.ts +++ b/yarn-project/aztec.js/src/contract/contract_function_interaction.ts @@ -1,5 +1,5 @@ import { type FunctionCall, PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; -import { type AztecAddress, FunctionData, TxContext } from '@aztec/circuits.js'; +import { type AztecAddress, FunctionData, GasSettings, TxContext } from '@aztec/circuits.js'; import { type FunctionAbi, FunctionType, encodeArguments } from '@aztec/foundation/abi'; import { type Wallet } from '../account/wallet.js'; @@ -13,10 +13,10 @@ export { SendMethodOptions }; * Disregarded for simulation of public functions */ export type SimulateMethodOptions = { - /** - * The sender's Aztec address. - */ + /** The sender's Aztec address. */ from?: AztecAddress; + /** Gas settings for the simulation. */ + gasSettings?: GasSettings; }; /** @@ -101,6 +101,7 @@ export class ContractFunctionInteraction extends BaseContractInteraction { txContext: TxContext.empty(nodeInfo.chainId, nodeInfo.protocolVersion), packedArguments: [packedArgs], authWitnesses: [], + gasSettings: options.gasSettings ?? GasSettings.simulation(), }); const simulatedTx = await this.pxe.simulateTx(txRequest, false, options.from ?? this.wallet.getAddress()); return simulatedTx.privateReturnValues?.[0]; diff --git a/yarn-project/aztec.js/src/entrypoint/default_entrypoint.ts b/yarn-project/aztec.js/src/entrypoint/default_entrypoint.ts index 18bc21b369c..1596a1c6c02 100644 --- a/yarn-project/aztec.js/src/entrypoint/default_entrypoint.ts +++ b/yarn-project/aztec.js/src/entrypoint/default_entrypoint.ts @@ -1,5 +1,5 @@ import { PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; -import { TxContext } from '@aztec/circuits.js'; +import { GasSettings, TxContext } from '@aztec/circuits.js'; import { type EntrypointInterface, type ExecutionRequestInit } from './entrypoint.js'; @@ -27,6 +27,7 @@ export class DefaultEntrypoint implements EntrypointInterface { txContext, [...packedArguments, entrypointPackedValues], authWitnesses, + exec.fee?.gasSettings ?? GasSettings.default(), ), ); } diff --git a/yarn-project/aztec.js/src/entrypoint/default_multi_call_entrypoint.ts b/yarn-project/aztec.js/src/entrypoint/default_multi_call_entrypoint.ts index 39501247b81..968960c4671 100644 --- a/yarn-project/aztec.js/src/entrypoint/default_multi_call_entrypoint.ts +++ b/yarn-project/aztec.js/src/entrypoint/default_multi_call_entrypoint.ts @@ -1,6 +1,6 @@ import { type EntrypointInterface, EntrypointPayload, type ExecutionRequestInit } from '@aztec/aztec.js/entrypoint'; import { PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; -import { type AztecAddress, FunctionData, TxContext } from '@aztec/circuits.js'; +import { type AztecAddress, FunctionData, GasSettings, TxContext } from '@aztec/circuits.js'; import { type FunctionAbi, encodeArguments } from '@aztec/foundation/abi'; import { getCanonicalMultiCallEntrypointAddress } from '@aztec/protocol-contracts/multi-call-entrypoint'; @@ -27,6 +27,7 @@ export class DefaultMultiCallEntrypoint implements EntrypointInterface { txContext: TxContext.empty(this.chainId, this.version), packedArguments: [...payload.packedArguments, ...packedArguments, entrypointPackedArgs], authWitnesses, + gasSettings: executions.fee?.gasSettings ?? GasSettings.default(), }); return Promise.resolve(txRequest); diff --git a/yarn-project/aztec.js/src/entrypoint/payload.ts b/yarn-project/aztec.js/src/entrypoint/payload.ts index acebdc4544f..c4bfb965aaa 100644 --- a/yarn-project/aztec.js/src/entrypoint/payload.ts +++ b/yarn-project/aztec.js/src/entrypoint/payload.ts @@ -1,5 +1,5 @@ import { type FunctionCall, PackedValues, emptyFunctionCall } from '@aztec/circuit-types'; -import { Fr, GeneratorIndex } from '@aztec/circuits.js'; +import { Fr, type GasSettings, GeneratorIndex } from '@aztec/circuits.js'; import { padArrayEnd } from '@aztec/foundation/collection'; import { pedersenHash } from '@aztec/foundation/crypto'; import { type Tuple } from '@aztec/foundation/serialize'; @@ -12,8 +12,8 @@ import { type FeePaymentMethod } from '../fee/fee_payment_method.js'; export type FeeOptions = { /** The fee payment method to use */ paymentMethod: FeePaymentMethod; - /** The fee limit to pay */ - maxFee: bigint | number | Fr; + /** The gas settings */ + gasSettings: GasSettings; }; // These must match the values defined in: @@ -137,7 +137,7 @@ export class EntrypointPayload { * @returns The execution payload */ static async fromFeeOptions(feeOpts?: FeeOptions) { - const calls = feeOpts ? await feeOpts.paymentMethod.getFunctionCalls(new Fr(feeOpts.maxFee)) : []; + const calls = feeOpts ? await feeOpts.paymentMethod.getFunctionCalls(feeOpts?.gasSettings) : []; const paddedCalls = padArrayEnd(calls, emptyFunctionCall(), FEE_MAX_CALLS); return new EntrypointPayload(paddedCalls, GeneratorIndex.FEE_PAYLOAD); } diff --git a/yarn-project/aztec.js/src/fee/fee_payment_method.ts b/yarn-project/aztec.js/src/fee/fee_payment_method.ts index cc67345b2c0..62c4f0a353e 100644 --- a/yarn-project/aztec.js/src/fee/fee_payment_method.ts +++ b/yarn-project/aztec.js/src/fee/fee_payment_method.ts @@ -1,6 +1,6 @@ import { type FunctionCall } from '@aztec/circuit-types'; +import { type GasSettings } from '@aztec/circuits.js'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; -import { type Fr } from '@aztec/foundation/fields'; /** * Holds information about how the fee for a transaction is to be paid. @@ -17,9 +17,8 @@ export interface FeePaymentMethod { /** * Creates a function call to pay the fee in the given asset. - * TODO(fees) replace maxFee with gas limits - * @param maxFee - The maximum fee to be paid in the given asset. + * @param gasSettings - The gas limits and max fees. * @returns The function call to pay the fee. */ - getFunctionCalls(maxFee: Fr): Promise; + getFunctionCalls(gasSettings: GasSettings): Promise; } diff --git a/yarn-project/aztec.js/src/fee/native_fee_payment_method.ts b/yarn-project/aztec.js/src/fee/native_fee_payment_method.ts index f1b77c2037c..af5a9ac3b31 100644 --- a/yarn-project/aztec.js/src/fee/native_fee_payment_method.ts +++ b/yarn-project/aztec.js/src/fee/native_fee_payment_method.ts @@ -1,7 +1,6 @@ import { type FunctionCall } from '@aztec/circuit-types'; -import { type AztecAddress, FunctionData } from '@aztec/circuits.js'; +import { type AztecAddress, FunctionData, type GasSettings } from '@aztec/circuits.js'; import { FunctionSelector } from '@aztec/foundation/abi'; -import { type Fr } from '@aztec/foundation/fields'; import { getCanonicalGasTokenAddress } from '@aztec/protocol-contracts/gas-token'; import { type Wallet } from '../account/wallet.js'; @@ -47,16 +46,16 @@ export class NativeFeePaymentMethod implements FeePaymentMethod { } /** - * Creates a function call to pay the fee in gas token.. - * @param feeLimit - The maximum fee to be paid in gas token. + * Creates a function call to pay the fee in gas token. + * @param gasSettings - The gas settings. * @returns A function call */ - getFunctionCalls(feeLimit: Fr): Promise { + getFunctionCalls(gasSettings: GasSettings): Promise { return Promise.resolve([ { to: this.#gasTokenAddress, functionData: new FunctionData(FunctionSelector.fromSignature('pay_fee(Field)'), false), - args: [feeLimit], + args: [gasSettings.getFeeLimit()], }, ]); } diff --git a/yarn-project/aztec.js/src/fee/private_fee_payment_method.ts b/yarn-project/aztec.js/src/fee/private_fee_payment_method.ts index ce4e3ae1242..e6abb694172 100644 --- a/yarn-project/aztec.js/src/fee/private_fee_payment_method.ts +++ b/yarn-project/aztec.js/src/fee/private_fee_payment_method.ts @@ -1,5 +1,5 @@ import { type FunctionCall } from '@aztec/circuit-types'; -import { FunctionData } from '@aztec/circuits.js'; +import { FunctionData, type GasSettings } from '@aztec/circuits.js'; import { computeMessageSecretHash } from '@aztec/circuits.js/hash'; import { FunctionSelector } from '@aztec/foundation/abi'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; @@ -53,11 +53,12 @@ export class PrivateFeePaymentMethod implements FeePaymentMethod { /** * Creates a function call to pay the fee in the given asset. - * @param maxFee - The maximum fee to be paid in the given asset. + * @param gasSettings - The gas settings. * @returns The function call to pay the fee. */ - async getFunctionCalls(maxFee: Fr): Promise { + async getFunctionCalls(gasSettings: GasSettings): Promise { const nonce = Fr.random(); + const maxFee = gasSettings.getFeeLimit(); const messageHash = computeAuthWitMessageHash( this.paymentContract, this.wallet.getChainId(), diff --git a/yarn-project/aztec.js/src/fee/public_fee_payment_method.ts b/yarn-project/aztec.js/src/fee/public_fee_payment_method.ts index 9dbd4b416d6..33b2430ebee 100644 --- a/yarn-project/aztec.js/src/fee/public_fee_payment_method.ts +++ b/yarn-project/aztec.js/src/fee/public_fee_payment_method.ts @@ -1,5 +1,5 @@ import { type FunctionCall } from '@aztec/circuit-types'; -import { FunctionData } from '@aztec/circuits.js'; +import { FunctionData, type GasSettings } from '@aztec/circuits.js'; import { FunctionSelector } from '@aztec/foundation/abi'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { Fr } from '@aztec/foundation/fields'; @@ -46,12 +46,12 @@ export class PublicFeePaymentMethod implements FeePaymentMethod { /** * Creates a function call to pay the fee in the given asset. - * @param maxFee - The maximum fee to be paid in the given asset. + * @param gasSettings - The gas settings. * @returns The function call to pay the fee. */ - getFunctionCalls(maxFee: Fr): Promise { + getFunctionCalls(gasSettings: GasSettings): Promise { const nonce = Fr.random(); - + const maxFee = gasSettings.getFeeLimit(); const messageHash = computeAuthWitMessageHash( this.paymentContract, this.wallet.getChainId(), diff --git a/yarn-project/circuit-types/src/mocks.ts b/yarn-project/circuit-types/src/mocks.ts index 3f6c48c134f..f0b3c805ad9 100644 --- a/yarn-project/circuit-types/src/mocks.ts +++ b/yarn-project/circuit-types/src/mocks.ts @@ -1,6 +1,7 @@ import { AztecAddress, CallRequest, + GasSettings, MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, PartialPrivateTailPublicInputsForPublic, PrivateKernelTailCircuitPublicInputs, @@ -50,6 +51,7 @@ export const mockTx = ( const isForPublic = totalPublicCallRequests > 0; const data = PrivateKernelTailCircuitPublicInputs.empty(); const firstNullifier = new SideEffectLinkedToNoteHash(new Fr(seed + 1), new Fr(seed + 2), Fr.ZERO); + data.constants.gasSettings = GasSettings.default(); if (isForPublic) { data.forRollup = undefined; diff --git a/yarn-project/circuit-types/src/tx_execution_request.ts b/yarn-project/circuit-types/src/tx_execution_request.ts index eba0eda27d8..9169dfe0cee 100644 --- a/yarn-project/circuit-types/src/tx_execution_request.ts +++ b/yarn-project/circuit-types/src/tx_execution_request.ts @@ -1,4 +1,4 @@ -import { AztecAddress, Fr, FunctionData, TxContext, TxRequest, Vector } from '@aztec/circuits.js'; +import { AztecAddress, Fr, FunctionData, GasSettings, TxContext, TxRequest, Vector } from '@aztec/circuits.js'; import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; import { type FieldsOf } from '@aztec/foundation/types'; @@ -38,10 +38,13 @@ export class TxExecutionRequest { * These witnesses are not expected to be stored in the local witnesses database of the PXE. */ public authWitnesses: AuthWitness[], + + /** Gas choices for this transaction. */ + public gasSettings: GasSettings, ) {} toTxRequest(): TxRequest { - return new TxRequest(this.origin, this.functionData, this.argsHash, this.txContext); + return new TxRequest(this.origin, this.functionData, this.argsHash, this.txContext, this.gasSettings); } static getFields(fields: FieldsOf) { @@ -52,6 +55,7 @@ export class TxExecutionRequest { fields.txContext, fields.packedArguments, fields.authWitnesses, + fields.gasSettings, ] as const; } @@ -71,6 +75,7 @@ export class TxExecutionRequest { this.txContext, new Vector(this.packedArguments), new Vector(this.authWitnesses), + this.gasSettings, ); } @@ -96,6 +101,7 @@ export class TxExecutionRequest { reader.readObject(TxContext), reader.readVector(PackedValues), reader.readVector(AuthWitness), + reader.readObject(GasSettings), ); } diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index e6961279974..da04d5fd12c 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,18 +68,18 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x1b02447505c1781a416a5f44bc5be922f0d2f709e0996877f673a86bd49f79f4n; +export const DEPLOYER_CONTRACT_ADDRESS = 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74n; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; export const MAX_NOTES_PER_PAGE = 10; export const VIEW_NOTE_ORACLE_RETURN_LENGTH = 212; export const AZTEC_ADDRESS_LENGTH = 1; -export const CALL_CONTEXT_LENGTH = 18; +export const CALL_CONTEXT_LENGTH = 21; export const GAS_SETTINGS_LENGTH = 10; export const DIMENSION_GAS_SETTINGS_LENGTH = 3; export const GAS_FEES_LENGTH = 3; -export const GAS_USED_LENGTH = 3; +export const GAS_LENGTH = 3; export const CONTENT_COMMITMENT_LENGTH = 4; export const CONTRACT_INSTANCE_LENGTH = 6; export const CONTRACT_STORAGE_READ_LENGTH = 2; @@ -95,13 +95,13 @@ export const MAX_BLOCK_NUMBER_LENGTH = 2; export const NULLIFIER_KEY_VALIDATION_REQUEST_LENGTH = 4; export const NULLIFIER_KEY_VALIDATION_REQUEST_CONTEXT_LENGTH = 5; export const PARTIAL_STATE_REFERENCE_LENGTH = 6; -export const PRIVATE_CALL_STACK_ITEM_LENGTH = 221; -export const PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 218; -export const PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH = 209; +export const PRIVATE_CALL_STACK_ITEM_LENGTH = 224; +export const PRIVATE_CIRCUIT_PUBLIC_INPUTS_LENGTH = 221; +export const PUBLIC_CIRCUIT_PUBLIC_INPUTS_LENGTH = 215; export const STATE_REFERENCE_LENGTH = 8; export const TX_CONTEXT_DATA_LENGTH = 4; -export const TX_REQUEST_LENGTH = 8; -export const ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH = 22; +export const TX_REQUEST_LENGTH = 18; +export const ENQUEUE_PUBLIC_FUNCTION_CALL_RETURN_LENGTH = 25; export const GET_NOTES_ORACLE_RETURN_LENGTH = 674; export const NOTE_HASHES_NUM_BYTES_PER_BASE_ROLLUP = 2048; export const NULLIFIERS_NUM_BYTES_PER_BASE_ROLLUP = 2048; diff --git a/yarn-project/circuits.js/src/structs/__snapshots__/private_call_stack_item.test.ts.snap b/yarn-project/circuits.js/src/structs/__snapshots__/private_call_stack_item.test.ts.snap index d623cd91468..f718c7fb3b1 100644 --- a/yarn-project/circuits.js/src/structs/__snapshots__/private_call_stack_item.test.ts.snap +++ b/yarn-project/circuits.js/src/structs/__snapshots__/private_call_stack_item.test.ts.snap @@ -1,5 +1,5 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`PrivateCallStackItem computes empty item hash 1`] = `Fr<0x229caf5ebf8961d7cbfdf2f7a5db62810d130b598900a0be1137394a43371bc6>`; +exports[`PrivateCallStackItem computes empty item hash 1`] = `Fr<0x243b1b69ea529d158803cc7a16b52293c5e5f2a1859337e3f69e4b20f55c6fb6>`; -exports[`PrivateCallStackItem computes hash 1`] = `Fr<0x20ca153bfa0c8bcabe989feb102b81c4c78e08004ee2fdc2f09b93b635e1595a>`; +exports[`PrivateCallStackItem computes hash 1`] = `Fr<0x230cf9e8515b74f4dd60fcf3a32c59d1efd2a704966a72838f1d88b86bcecfc0>`; diff --git a/yarn-project/circuits.js/src/structs/__snapshots__/private_circuit_public_inputs.test.ts.snap b/yarn-project/circuits.js/src/structs/__snapshots__/private_circuit_public_inputs.test.ts.snap index c965dd0e9b3..72e4d887dfe 100644 --- a/yarn-project/circuits.js/src/structs/__snapshots__/private_circuit_public_inputs.test.ts.snap +++ b/yarn-project/circuits.js/src/structs/__snapshots__/private_circuit_public_inputs.test.ts.snap @@ -1,5 +1,5 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`PrivateCircuitPublicInputs computes empty inputs hash 1`] = `Fr<0x13ba2af75e4afaa4e52dd1afa083e87706cdbab1a33442025dc3a9bbb546d207>`; +exports[`PrivateCircuitPublicInputs computes empty inputs hash 1`] = `Fr<0x02e09d8c4897d560bd4caf05ab45fa22e1d4a251bf5b5e0448310a7f40f7a0b8>`; -exports[`PrivateCircuitPublicInputs hash matches snapshot 1`] = `Fr<0x0f250912b993f2334ad0aeb39e1051f7db753a7302d00b063834fac578e36f1c>`; +exports[`PrivateCircuitPublicInputs hash matches snapshot 1`] = `Fr<0x1b87232023a3accb0f63ffaa41068972b98185c62bf1542cebd77c8bedfd5313>`; diff --git a/yarn-project/circuits.js/src/structs/__snapshots__/public_call_stack_item.test.ts.snap b/yarn-project/circuits.js/src/structs/__snapshots__/public_call_stack_item.test.ts.snap index 589fe9bb59e..6b17402df69 100644 --- a/yarn-project/circuits.js/src/structs/__snapshots__/public_call_stack_item.test.ts.snap +++ b/yarn-project/circuits.js/src/structs/__snapshots__/public_call_stack_item.test.ts.snap @@ -1,7 +1,7 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`PublicCallStackItem Computes a callstack item hash 1`] = `"0x1a7b9d0cd965f512a3b3ed70333198a2a69bd4f9e70be68379c54e68a7b07a4c"`; +exports[`PublicCallStackItem Computes a callstack item hash 1`] = `"0x0864975afc9bec7eb7ec5b5608bbef648ec9afead1bbe986d0af148e3c944b9b"`; -exports[`PublicCallStackItem Computes a callstack item request hash 1`] = `"0x151bc9ee42eb63112fb2a350dcaa33c4c4b81cc37ded8773e785f47029f35983"`; +exports[`PublicCallStackItem Computes a callstack item request hash 1`] = `"0x12c634ebadf4209e2def6cac0753f151422faf11237dc4f136bc17a84c8c2d76"`; -exports[`PublicCallStackItem computes hash 1`] = `Fr<0x107c825cf4cf15d2618c5828eced84edc7dd29c277ff1f6171c6354237174b7a>`; +exports[`PublicCallStackItem computes hash 1`] = `Fr<0x1fcf20622dc0bed7c461128afb302fd60a54628a1a5daf2e157bbacf413342a2>`; diff --git a/yarn-project/circuits.js/src/structs/__snapshots__/public_circuit_public_inputs.test.ts.snap b/yarn-project/circuits.js/src/structs/__snapshots__/public_circuit_public_inputs.test.ts.snap index 962240da268..d3cb2b628a1 100644 --- a/yarn-project/circuits.js/src/structs/__snapshots__/public_circuit_public_inputs.test.ts.snap +++ b/yarn-project/circuits.js/src/structs/__snapshots__/public_circuit_public_inputs.test.ts.snap @@ -1,5 +1,5 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`PublicCircuitPublicInputs computes empty item hash 1`] = `Fr<0x2745ec62624afeb19b86af3d440db1f8c3432e1d17a074c75cb8f44999fd3fae>`; +exports[`PublicCircuitPublicInputs computes empty item hash 1`] = `Fr<0x00147d3d2cde08ee1046bf73cb6664c2bdf11b43c5dca0e72f4137f354bdad25>`; -exports[`PublicCircuitPublicInputs hash matches snapshot 1`] = `Fr<0x0082fbb87371d9f98bb2d7c0b6e8f5e12f21f67085b5bd42931596f3d2e5eb9b>`; +exports[`PublicCircuitPublicInputs hash matches snapshot 1`] = `Fr<0x010f05c698115df7a51edde4b5580dde0fa0598492ab4f22faf82b02db0a9230>`; diff --git a/yarn-project/circuits.js/src/structs/__snapshots__/tx_request.test.ts.snap b/yarn-project/circuits.js/src/structs/__snapshots__/tx_request.test.ts.snap index 06f830fd9cb..7bf6df6c4a4 100644 --- a/yarn-project/circuits.js/src/structs/__snapshots__/tx_request.test.ts.snap +++ b/yarn-project/circuits.js/src/structs/__snapshots__/tx_request.test.ts.snap @@ -1,3 +1,3 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`TxRequest compute hash 1`] = `"0x20af6f595c396494f1177fa196d17e98d55a2416b28c262b76e78a36d6c01daa"`; +exports[`TxRequest compute hash 1`] = `"0x03b678e327818eb368f9eac21839ee67a98968318f0dcd76c89d3fcf66af7257"`; diff --git a/yarn-project/circuits.js/src/structs/call_context.ts b/yarn-project/circuits.js/src/structs/call_context.ts index 8a332675988..b542a46b1e0 100644 --- a/yarn-project/circuits.js/src/structs/call_context.ts +++ b/yarn-project/circuits.js/src/structs/call_context.ts @@ -6,6 +6,7 @@ import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from import { type FieldsOf } from '@aztec/foundation/types'; import { CALL_CONTEXT_LENGTH } from '../constants.gen.js'; +import { Gas } from './gas.js'; import { GasSettings } from './gas_settings.js'; /** @@ -31,6 +32,8 @@ export class CallContext { * Function selector of the function being called. */ public functionSelector: FunctionSelector, + /** How much gas is available for execution of this function. */ + public gasLeft: Gas, /** * Determines whether the call is a delegate call (see Ethereum's delegate call opcode for more information). */ @@ -61,6 +64,7 @@ export class CallContext { AztecAddress.ZERO, EthAddress.ZERO, FunctionSelector.empty(), + Gas.empty(), false, false, 0, @@ -75,6 +79,7 @@ export class CallContext { this.storageContractAddress.isZero() && this.portalContractAddress.isZero() && this.functionSelector.isEmpty() && + this.gasLeft.isEmpty() && Fr.ZERO && this.gasSettings.isEmpty() && this.transactionFee.isZero() @@ -91,6 +96,7 @@ export class CallContext { fields.storageContractAddress, fields.portalContractAddress, fields.functionSelector, + fields.gasLeft, fields.isDelegateCall, fields.isStaticCall, fields.sideEffectCounter, @@ -129,6 +135,7 @@ export class CallContext { reader.readObject(AztecAddress), reader.readObject(EthAddress), reader.readObject(FunctionSelector), + reader.readObject(Gas), reader.readBoolean(), reader.readBoolean(), reader.readNumber(), @@ -144,6 +151,7 @@ export class CallContext { reader.readObject(AztecAddress), reader.readObject(EthAddress), reader.readObject(FunctionSelector), + reader.readObject(Gas), reader.readBoolean(), reader.readBoolean(), reader.readU32(), @@ -158,6 +166,7 @@ export class CallContext { callContext.storageContractAddress.equals(this.storageContractAddress) && callContext.portalContractAddress.equals(this.portalContractAddress) && callContext.functionSelector.equals(this.functionSelector) && + callContext.gasLeft.equals(this.gasLeft) && callContext.isDelegateCall === this.isDelegateCall && callContext.isStaticCall === this.isStaticCall && callContext.sideEffectCounter === this.sideEffectCounter && diff --git a/yarn-project/circuits.js/src/structs/gas.ts b/yarn-project/circuits.js/src/structs/gas.ts new file mode 100644 index 00000000000..5924282216a --- /dev/null +++ b/yarn-project/circuits.js/src/structs/gas.ts @@ -0,0 +1,67 @@ +import { type Fr } from '@aztec/foundation/fields'; +import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from '@aztec/foundation/serialize'; +import { type FieldsOf } from '@aztec/foundation/types'; + +import { inspect } from 'util'; + +import { type UInt32 } from './shared.js'; + +/** Gas amounts in each dimension. */ +export class Gas { + constructor(public readonly daGas: UInt32, public readonly l1Gas: UInt32, public readonly l2Gas: UInt32) {} + + equals(other: Gas) { + return this.daGas === other.daGas && this.l1Gas === other.l1Gas && this.l2Gas === other.l2Gas; + } + + static from(fields: FieldsOf) { + return new Gas(fields.daGas, fields.l1Gas, fields.l2Gas); + } + + static empty() { + return new Gas(0, 0, 0); + } + + /** Returns large enough gas amounts for testing purposes. */ + static test() { + return new Gas(1e9, 1e9, 1e9); + } + + isEmpty() { + return this.daGas === 0 && this.l1Gas === 0 && this.l2Gas === 0; + } + + static fromBuffer(buffer: Buffer | BufferReader): Gas { + const reader = BufferReader.asReader(buffer); + return new Gas(reader.readNumber(), reader.readNumber(), reader.readNumber()); + } + + toBuffer() { + return serializeToBuffer(this.daGas, this.l1Gas, this.l2Gas); + } + + [inspect.custom]() { + return `Gas { daGas=${this.daGas} l1Gas=${this.l1Gas} l2Gas=${this.l2Gas} }`; + } + + add(other: Gas) { + return new Gas(this.daGas + other.daGas, this.l1Gas + other.l1Gas, this.l2Gas + other.l2Gas); + } + + sub(other: Gas) { + return new Gas(this.daGas - other.daGas, this.l1Gas - other.l1Gas, this.l2Gas - other.l2Gas); + } + + mul(scalar: number) { + return new Gas(Math.ceil(this.daGas * scalar), Math.ceil(this.l1Gas * scalar), Math.ceil(this.l2Gas * scalar)); + } + + toFields() { + return serializeToFields(this.daGas, this.l1Gas, this.l2Gas); + } + + static fromFields(fields: Fr[] | FieldReader) { + const reader = FieldReader.asReader(fields); + return new Gas(reader.readU32(), reader.readU32(), reader.readU32()); + } +} diff --git a/yarn-project/circuits.js/src/structs/gas_fees.ts b/yarn-project/circuits.js/src/structs/gas_fees.ts index 89a7f9ff7b2..ee5489d47b2 100644 --- a/yarn-project/circuits.js/src/structs/gas_fees.ts +++ b/yarn-project/circuits.js/src/structs/gas_fees.ts @@ -20,6 +20,11 @@ export class GasFees { return new GasFees(Fr.ZERO, Fr.ZERO, Fr.ZERO); } + /** Fixed gas fee values used until we define how gas fees in the protocol are computed. */ + static default() { + return new GasFees(Fr.ONE, Fr.ONE, Fr.ONE); + } + isEmpty() { return this.feePerDaGas.isZero() && this.feePerL1Gas.isZero() && this.feePerL2Gas.isZero(); } diff --git a/yarn-project/circuits.js/src/structs/gas_settings.ts b/yarn-project/circuits.js/src/structs/gas_settings.ts index 68cbc3fad42..80a57f0c19b 100644 --- a/yarn-project/circuits.js/src/structs/gas_settings.ts +++ b/yarn-project/circuits.js/src/structs/gas_settings.ts @@ -3,6 +3,7 @@ import { BufferReader, FieldReader, serializeToBuffer, serializeToFields } from import { type FieldsOf } from '@aztec/foundation/types'; import { GAS_SETTINGS_LENGTH } from '../constants.gen.js'; +import { Gas } from './gas.js'; import { type UInt32 } from './shared.js'; /** Gas usage and fees limits set by the transaction sender for different dimensions and phases. */ @@ -14,6 +15,28 @@ export class GasSettings { public readonly inclusionFee: Fr, ) {} + static new(args: { + da: FieldsOf; + l1: FieldsOf; + l2: FieldsOf; + inclusionFee: Fr; + }) { + return new GasSettings( + DimensionGasSettings.from(args.da), + DimensionGasSettings.from(args.l1), + DimensionGasSettings.from(args.l2), + args.inclusionFee, + ); + } + + /** Returns the maximum fee to be paid according to gas limits and max fees set. */ + getFeeLimit() { + return [this.da, this.l1, this.l2] + .reduce((acc, dimension) => acc.add(dimension.getFeeLimit()), Fr.ZERO) + .add(this.inclusionFee); + } + + /** Zero-value gas settings. */ static empty() { return new GasSettings( DimensionGasSettings.empty(), @@ -23,6 +46,26 @@ export class GasSettings { ); } + /** Default gas settings to use when user has not provided them. */ + static default() { + return new GasSettings( + DimensionGasSettings.default(), + DimensionGasSettings.default(), + DimensionGasSettings.default(), + Fr.ONE, + ); + } + + /** Gas settings to use for simulating a contract call. */ + static simulation() { + return new GasSettings( + DimensionGasSettings.simulation(), + DimensionGasSettings.simulation(), + DimensionGasSettings.simulation(), + Fr.ONE, + ); + } + isEmpty() { return this.da.isEmpty() && this.l1.isEmpty() && this.l2.isEmpty() && this.inclusionFee.isZero(); } @@ -73,6 +116,25 @@ export class GasSettings { static getFields(fields: FieldsOf) { return [fields.da, fields.l1, fields.l2, fields.inclusionFee] as const; } + + /** Returns total gas limits. */ + getLimits(): Gas { + return new Gas(this.da.gasLimit, this.l1.gasLimit, this.l2.gasLimit); + } + + /** Returns how much gas is available for execution of setup and app phases (ie total limit minus teardown). */ + getInitialAvailable(): Gas { + return new Gas( + this.da.gasLimit - this.da.teardownGasLimit, + this.l1.gasLimit - this.l1.teardownGasLimit, + this.l2.gasLimit - this.l2.teardownGasLimit, + ); + } + + /** Returns how much gas is available for execution of teardown phase. */ + getTeardownLimits(): Gas { + return new Gas(this.da.teardownGasLimit, this.l1.teardownGasLimit, this.l2.teardownGasLimit); + } } /** Gas usage and fees limits set by the transaction sender for different phases on a specific dimension. */ @@ -81,7 +143,23 @@ export class DimensionGasSettings { public readonly gasLimit: UInt32, public readonly teardownGasLimit: UInt32, public readonly maxFeePerGas: Fr, - ) {} + ) { + if (teardownGasLimit > gasLimit) { + throw new Error(`Teardown gas limit ${teardownGasLimit} is greater than gas limit ${gasLimit}`); + } + } + + static default() { + return new DimensionGasSettings(1e9, 1e8, Fr.ONE); + } + + static simulation() { + return new DimensionGasSettings(1e9, 1e8, Fr.ONE); + } + + getFeeLimit() { + return this.maxFeePerGas.mul(new Fr(this.gasLimit + this.teardownGasLimit)); + } static empty() { return new DimensionGasSettings(0, 0, Fr.ZERO); @@ -120,4 +198,8 @@ export class DimensionGasSettings { static getFields(fields: FieldsOf) { return [fields.gasLimit, fields.teardownGasLimit, fields.maxFeePerGas] as const; } + + static from(fields: FieldsOf) { + return new DimensionGasSettings(fields.gasLimit, fields.teardownGasLimit, fields.maxFeePerGas); + } } diff --git a/yarn-project/circuits.js/src/structs/gas_used.ts b/yarn-project/circuits.js/src/structs/gas_used.ts deleted file mode 100644 index 46100b22915..00000000000 --- a/yarn-project/circuits.js/src/structs/gas_used.ts +++ /dev/null @@ -1,36 +0,0 @@ -import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; -import { type FieldsOf } from '@aztec/foundation/types'; - -import { inspect } from 'util'; - -import { type UInt32 } from './shared.js'; - -/** Gas in each dimension used so far in the context of the current transaction or phase. */ -export class GasUsed { - constructor(public readonly daGas: UInt32, public readonly l1Gas: UInt32, public readonly l2Gas: UInt32) {} - - static from(fields: FieldsOf) { - return new GasUsed(fields.daGas, fields.l1Gas, fields.l2Gas); - } - - static empty() { - return new GasUsed(0, 0, 0); - } - - isEmpty() { - return this.daGas === 0 && this.l1Gas === 0 && this.l2Gas === 0; - } - - static fromBuffer(buffer: Buffer | BufferReader): GasUsed { - const reader = BufferReader.asReader(buffer); - return new GasUsed(reader.readNumber(), reader.readNumber(), reader.readNumber()); - } - - toBuffer() { - return serializeToBuffer(this.daGas, this.l1Gas, this.l2Gas); - } - - [inspect.custom]() { - return `GasUsed { daGas=${this.daGas} l1Gas=${this.l1Gas} l2Gas=${this.l2Gas} }`; - } -} diff --git a/yarn-project/circuits.js/src/structs/index.ts b/yarn-project/circuits.js/src/structs/index.ts index e2c688921c5..da3ec5a2c96 100644 --- a/yarn-project/circuits.js/src/structs/index.ts +++ b/yarn-project/circuits.js/src/structs/index.ts @@ -9,7 +9,7 @@ export * from './contract_storage_update_request.js'; export * from './function_data.js'; export * from './gas_fees.js'; export * from './gas_settings.js'; -export * from './gas_used.js'; +export * from './gas.js'; export * from './global_variables.js'; export * from './header.js'; export * from './kernel/combined_accumulated_data.js'; diff --git a/yarn-project/circuits.js/src/structs/kernel/combined_accumulated_data.ts b/yarn-project/circuits.js/src/structs/kernel/combined_accumulated_data.ts index 8599e3e0de8..3c4d58cf3ed 100644 --- a/yarn-project/circuits.js/src/structs/kernel/combined_accumulated_data.ts +++ b/yarn-project/circuits.js/src/structs/kernel/combined_accumulated_data.ts @@ -9,7 +9,7 @@ import { MAX_NEW_NULLIFIERS_PER_TX, MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, } from '../../constants.gen.js'; -import { GasUsed } from '../gas_used.js'; +import { Gas } from '../gas.js'; import { PublicDataUpdateRequest } from '../public_data_update_request.js'; /** @@ -53,7 +53,7 @@ export class CombinedAccumulatedData { public publicDataUpdateRequests: Tuple, /** Gas used during this transaction */ - public gasUsed: GasUsed, + public gasUsed: Gas, ) {} toBuffer() { @@ -90,7 +90,7 @@ export class CombinedAccumulatedData { Fr.fromBuffer(reader), Fr.fromBuffer(reader), reader.readArray(MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, PublicDataUpdateRequest), - reader.readObject(GasUsed), + reader.readObject(Gas), ); } @@ -113,7 +113,7 @@ export class CombinedAccumulatedData { Fr.zero(), Fr.zero(), makeTuple(MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, PublicDataUpdateRequest.empty), - GasUsed.empty(), + Gas.empty(), ); } } diff --git a/yarn-project/circuits.js/src/structs/kernel/combined_constant_data.ts b/yarn-project/circuits.js/src/structs/kernel/combined_constant_data.ts index 4baa7593deb..6534f7c90a0 100644 --- a/yarn-project/circuits.js/src/structs/kernel/combined_constant_data.ts +++ b/yarn-project/circuits.js/src/structs/kernel/combined_constant_data.ts @@ -24,7 +24,7 @@ export class CombinedConstantData { public txContext: TxContext, /** Gas limits and max prices for this transaction as set by the sender. */ - public readonly gasSettings: GasSettings, + public gasSettings: GasSettings, ) {} toBuffer() { diff --git a/yarn-project/circuits.js/src/structs/kernel/private_accumulated_data.ts b/yarn-project/circuits.js/src/structs/kernel/private_accumulated_data.ts index 688aa74558c..909f1afe796 100644 --- a/yarn-project/circuits.js/src/structs/kernel/private_accumulated_data.ts +++ b/yarn-project/circuits.js/src/structs/kernel/private_accumulated_data.ts @@ -11,7 +11,7 @@ import { MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, } from '../../constants.gen.js'; import { CallRequest } from '../call_request.js'; -import { GasUsed } from '../gas_used.js'; +import { Gas } from '../gas.js'; import { SideEffect, SideEffectLinkedToNoteHash } from '../side_effects.js'; /** @@ -61,7 +61,7 @@ export class PrivateAccumulatedData { public publicCallStack: Tuple, /** Gas used so far by this transaction. */ - public gasUsed: GasUsed, + public gasUsed: Gas, ) {} toBuffer() { @@ -100,7 +100,7 @@ export class PrivateAccumulatedData { Fr.fromBuffer(reader), reader.readArray(MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, CallRequest), reader.readArray(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, CallRequest), - reader.readObject(GasUsed), + reader.readObject(Gas), ); } @@ -124,7 +124,7 @@ export class PrivateAccumulatedData { Fr.zero(), makeTuple(MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, CallRequest.empty), makeTuple(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, CallRequest.empty), - GasUsed.empty(), + Gas.empty(), ); } } diff --git a/yarn-project/circuits.js/src/structs/kernel/public_accumulated_data.ts b/yarn-project/circuits.js/src/structs/kernel/public_accumulated_data.ts index 82c924c2d58..21d94842d5a 100644 --- a/yarn-project/circuits.js/src/structs/kernel/public_accumulated_data.ts +++ b/yarn-project/circuits.js/src/structs/kernel/public_accumulated_data.ts @@ -13,7 +13,7 @@ import { MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, } from '../../constants.gen.js'; import { CallRequest } from '../call_request.js'; -import { GasUsed } from '../gas_used.js'; +import { Gas } from '../gas.js'; import { PublicDataUpdateRequest } from '../public_data_update_request.js'; import { SideEffect, SideEffectLinkedToNoteHash } from '../side_effects.js'; @@ -59,7 +59,7 @@ export class PublicAccumulatedData { public publicCallStack: Tuple, /** Gas used so far by the transaction. */ - public gasUsed: GasUsed, + public gasUsed: Gas, ) {} toBuffer() { @@ -129,7 +129,7 @@ export class PublicAccumulatedData { Fr.fromBuffer(reader), reader.readArray(MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, PublicDataUpdateRequest), reader.readArray(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, CallRequest), - reader.readObject(GasUsed), + reader.readObject(Gas), ); } @@ -153,7 +153,7 @@ export class PublicAccumulatedData { Fr.zero(), makeTuple(MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, PublicDataUpdateRequest.empty), makeTuple(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, CallRequest.empty), - GasUsed.empty(), + Gas.empty(), ); } } diff --git a/yarn-project/circuits.js/src/structs/public_circuit_public_inputs.ts b/yarn-project/circuits.js/src/structs/public_circuit_public_inputs.ts index c294816a6eb..9c2c5c65a4f 100644 --- a/yarn-project/circuits.js/src/structs/public_circuit_public_inputs.ts +++ b/yarn-project/circuits.js/src/structs/public_circuit_public_inputs.ts @@ -27,6 +27,7 @@ import { import { CallContext } from './call_context.js'; import { ContractStorageRead } from './contract_storage_read.js'; import { ContractStorageUpdateRequest } from './contract_storage_update_request.js'; +import { Gas } from './gas.js'; import { Header } from './header.js'; import { L2ToL1Message } from './l2_to_l1_message.js'; import { ReadRequest } from './read_request.js'; @@ -119,6 +120,9 @@ export class PublicCircuitPublicInputs { * Flag indicating if the call was reverted. */ public revertCode: RevertCode, + + /** How much gas was left after execution. */ + public gasLeft: Gas, ) {} /** @@ -154,6 +158,7 @@ export class PublicCircuitPublicInputs { Header.empty(), AztecAddress.ZERO, RevertCode.OK, + Gas.empty(), ); } @@ -180,7 +185,8 @@ export class PublicCircuitPublicInputs { this.unencryptedLogPreimagesLength.isZero() && this.historicalHeader.isEmpty() && this.proverAddress.isZero() && - this.revertCode.isOK() + this.revertCode.isOK() && + this.gasLeft.isEmpty() ); } @@ -209,6 +215,7 @@ export class PublicCircuitPublicInputs { fields.historicalHeader, fields.proverAddress, fields.revertCode, + fields.gasLeft, ] as const; } @@ -256,6 +263,7 @@ export class PublicCircuitPublicInputs { reader.readObject(Header), reader.readObject(AztecAddress), reader.readObject(RevertCode), + reader.readObject(Gas), ); } @@ -281,6 +289,7 @@ export class PublicCircuitPublicInputs { Header.fromFields(reader), AztecAddress.fromFields(reader), RevertCode.fromFields(reader), + Gas.fromFields(reader), ); } diff --git a/yarn-project/circuits.js/src/structs/tx_request.test.ts b/yarn-project/circuits.js/src/structs/tx_request.test.ts index d353bb36b24..ee364557c5f 100644 --- a/yarn-project/circuits.js/src/structs/tx_request.test.ts +++ b/yarn-project/circuits.js/src/structs/tx_request.test.ts @@ -7,6 +7,7 @@ import { setupCustomSnapshotSerializers, updateInlineTestData } from '@aztec/fou import { TX_REQUEST_LENGTH } from '../constants.gen.js'; import { makeTxRequest } from '../tests/factories.js'; import { FunctionData } from './function_data.js'; +import { GasSettings } from './gas_settings.js'; import { TxContext } from './tx_context.js'; import { TxRequest } from './tx_request.js'; @@ -36,6 +37,12 @@ describe('TxRequest', () => { functionData: new FunctionData(FunctionSelector.fromField(new Fr(2n)), true), argsHash: new Fr(3), txContext: new TxContext(false, false, Fr.ZERO, Fr.ZERO), + gasSettings: GasSettings.new({ + da: { gasLimit: 2, teardownGasLimit: 1, maxFeePerGas: new Fr(3) }, + l1: { gasLimit: 2, teardownGasLimit: 1, maxFeePerGas: new Fr(3) }, + l2: { gasLimit: 2, teardownGasLimit: 1, maxFeePerGas: new Fr(3) }, + inclusionFee: new Fr(10), + }), }); const hash = txRequest.hash().toString(); diff --git a/yarn-project/circuits.js/src/structs/tx_request.ts b/yarn-project/circuits.js/src/structs/tx_request.ts index 6a3812692a7..8b2337e665d 100644 --- a/yarn-project/circuits.js/src/structs/tx_request.ts +++ b/yarn-project/circuits.js/src/structs/tx_request.ts @@ -6,6 +6,7 @@ import { type FieldsOf } from '@aztec/foundation/types'; import { GeneratorIndex, TX_REQUEST_LENGTH } from '../constants.gen.js'; import { FunctionData } from './function_data.js'; +import { GasSettings } from './gas_settings.js'; import { TxContext } from './tx_context.js'; /** @@ -13,26 +14,20 @@ import { TxContext } from './tx_context.js'; */ export class TxRequest { constructor( - /** - * Sender. - */ + /** Sender. */ public origin: AztecAddress, - /** - * Function data representing the function to call. - */ + /** Function data representing the function to call. */ public functionData: FunctionData, - /** - * Pedersen hash of function arguments. - */ + /** Pedersen hash of function arguments. */ public argsHash: Fr, - /** - * Transaction context. - */ + /** Transaction context. */ public txContext: TxContext, + /** Gas limits and max fees per dimension. */ + public gasSettings: GasSettings, ) {} static getFields(fields: FieldsOf) { - return [fields.origin, fields.functionData, fields.argsHash, fields.txContext] as const; + return [fields.origin, fields.functionData, fields.argsHash, fields.txContext, fields.gasSettings] as const; } static from(fields: FieldsOf): TxRequest { @@ -67,6 +62,7 @@ export class TxRequest { reader.readObject(FunctionData), Fr.fromBuffer(reader), reader.readObject(TxContext), + reader.readObject(GasSettings), ); } @@ -75,10 +71,16 @@ export class TxRequest { } static empty() { - return new TxRequest(AztecAddress.ZERO, FunctionData.empty(), Fr.zero(), TxContext.empty()); + return new TxRequest(AztecAddress.ZERO, FunctionData.empty(), Fr.zero(), TxContext.empty(), GasSettings.empty()); } isEmpty() { - return this.origin.isZero() && this.functionData.isEmpty() && this.argsHash.isZero() && this.txContext.isEmpty(); + return ( + this.origin.isZero() && + this.functionData.isEmpty() && + this.argsHash.isZero() && + this.txContext.isEmpty() && + this.gasSettings.isEmpty() + ); } } diff --git a/yarn-project/circuits.js/src/tests/factories.ts b/yarn-project/circuits.js/src/tests/factories.ts index b7a27ac83b2..1a1c2473d6e 100644 --- a/yarn-project/circuits.js/src/tests/factories.ts +++ b/yarn-project/circuits.js/src/tests/factories.ts @@ -1,8 +1,7 @@ -import { makeHalfFullTuple, makeTuple, range } from '@aztec/foundation/array'; +import { type FieldsOf, makeHalfFullTuple, makeTuple, range } from '@aztec/foundation/array'; import { AztecAddress } from '@aztec/foundation/aztec-address'; import { toBufferBE } from '@aztec/foundation/bigint-buffer'; import { EthAddress } from '@aztec/foundation/eth-address'; -import { numToUInt32BE } from '@aztec/foundation/serialize'; import { type ContractClassPublic, type ExecutablePrivateFunctionWithMembershipProof, @@ -128,9 +127,9 @@ import { packBytecode, } from '../index.js'; import { ContentCommitment, NUM_BYTES_PER_SHA256 } from '../structs/content_commitment.js'; +import { Gas } from '../structs/gas.js'; import { GasFees } from '../structs/gas_fees.js'; -import { DimensionGasSettings, GasSettings } from '../structs/gas_settings.js'; -import { GasUsed } from '../structs/gas_used.js'; +import { GasSettings } from '../structs/gas_settings.js'; import { GlobalVariables } from '../structs/global_variables.js'; import { Header } from '../structs/header.js'; import { KernelCircuitPublicInputs } from '../structs/kernel/kernel_circuit_public_inputs.js'; @@ -174,20 +173,14 @@ export function makeTxContext(seed: number): TxContext { * @returns A constant data object. */ export function makeConstantData(seed = 1): CombinedConstantData { - return new CombinedConstantData(makeHeader(seed, undefined), makeTxContext(seed + 4), makeGasSettings(seed + 5)); + return new CombinedConstantData(makeHeader(seed, undefined), makeTxContext(seed + 4), makeGasSettings()); } -export function makeGasSettings(seed = 1) { - return new GasSettings( - makeDimensionGasSettings(seed), - makeDimensionGasSettings(seed + 1), - makeDimensionGasSettings(seed + 2), - fr(seed + 3), - ); -} - -export function makeDimensionGasSettings(seed = 1) { - return new DimensionGasSettings(seed, seed + 1, fr(seed + 2)); +/** + * Creates a default instance of gas settings. No seed value is used to ensure we allocate a sensible amount of gas for testing. + */ +export function makeGasSettings() { + return GasSettings.default(); } /** @@ -318,12 +311,12 @@ export function makeCombinedAccumulatedData(seed = 1, full = false): CombinedAcc seed + 0xd00, PublicDataUpdateRequest.empty, ), - makeGasUsed(seed + 0xe00), + makeGas(seed + 0xe00), ); } -export function makeGasUsed(seed = 1) { - return new GasUsed(seed, seed + 1, seed + 2); +export function makeGas(seed = 1) { + return new Gas(seed, seed + 1, seed + 2); } /** @@ -354,7 +347,7 @@ export function makePublicAccumulatedData(seed = 1, full = false): PublicAccumul PublicDataUpdateRequest.empty, ), tupleGenerator(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, makeCallRequest, seed + 0x500, CallRequest.empty), - makeGasUsed(seed + 0x600), + makeGas(seed + 0x600), ); } @@ -381,7 +374,7 @@ export function makePrivateAccumulatedData(seed = 1, full = false) { fr(seed + 0xa00), // unencrypted_log_preimages_length tupleGenerator(MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, makeCallRequest, seed + 0x400, CallRequest.empty), tupleGenerator(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, makeCallRequest, seed + 0x500, CallRequest.empty), - makeGasUsed(seed + 0x600), + makeGas(seed + 0x600), ); } @@ -405,18 +398,21 @@ export function makeAggregationObject(seed = 1): AggregationObject { * @param storageContractAddress - The storage contract address set on the call context. * @returns A call context. */ -export function makeCallContext(seed = 0, storageContractAddress = makeAztecAddress(seed + 1)): CallContext { - return new CallContext( - makeAztecAddress(seed), - storageContractAddress, - makeEthAddress(seed + 2), - makeSelector(seed + 3), - false, - false, - 0, - makeGasSettings(seed + 4), - fr(seed + 5), - ); +export function makeCallContext(seed = 0, overrides: Partial> = {}): CallContext { + const gasSettings = makeGasSettings(); + return CallContext.from({ + msgSender: makeAztecAddress(seed), + storageContractAddress: makeAztecAddress(seed + 1), + portalContractAddress: makeEthAddress(seed + 2), + functionSelector: makeSelector(seed + 3), + gasLeft: gasSettings.getLimits(), + isStaticCall: false, + isDelegateCall: false, + sideEffectCounter: 0, + gasSettings, + transactionFee: fr(seed + 6), + ...overrides, + }); } /** @@ -433,7 +429,7 @@ export function makePublicCircuitPublicInputs( const tupleGenerator = full ? makeTuple : makeHalfFullTuple; return new PublicCircuitPublicInputs( - makeCallContext(seed, storageContractAddress), + makeCallContext(seed, { storageContractAddress: storageContractAddress ?? makeAztecAddress(seed) }), fr(seed + 0x100), fr(seed + 0x200), tupleGenerator(MAX_NULLIFIER_READ_REQUESTS_PER_CALL, makeReadRequest, seed + 0x400, ReadRequest.empty), @@ -461,6 +457,7 @@ export function makePublicCircuitPublicInputs( makeHeader(seed + 0xa00, undefined), makeAztecAddress(seed + 0xb01), RevertCode.OK, + makeGas(seed + 0xc00), ); } @@ -550,18 +547,9 @@ export function makeKernelCircuitPublicInputs(seed = 1, fullAccumulatedData = tr * @returns Public call request. */ export function makePublicCallRequest(seed = 1): PublicCallRequest { - const childCallContext = makeCallContext(seed + 0x2, makeAztecAddress(seed)); - const parentCallContext = CallContext.from({ - msgSender: makeAztecAddress(seed + 0x3), - storageContractAddress: childCallContext.msgSender, - portalContractAddress: makeEthAddress(seed + 2), - functionSelector: makeSelector(seed + 3), - isStaticCall: false, - isDelegateCall: false, - sideEffectCounter: 0, - gasSettings: makeGasSettings(seed + 4), - transactionFee: fr(seed + 5), - }); + const childCallContext = makeCallContext(seed + 0x2, { storageContractAddress: makeAztecAddress(seed) }); + const parentCallContext = makeCallContext(seed + 0x3, { storageContractAddress: childCallContext.msgSender }); + return new PublicCallRequest( makeAztecAddress(seed), new FunctionData(makeSelector(seed + 0x1), false), @@ -846,6 +834,7 @@ export function makeTxRequest(seed = 1): TxRequest { functionData: new FunctionData(makeSelector(seed + 0x100), true), argsHash: fr(seed + 0x200), txContext: makeTxContext(seed + 0x400), + gasSettings: makeGasSettings(), }); } @@ -897,17 +886,7 @@ export function makePrivateCallStackItem(seed = 1): PrivateCallStackItem { export function makePrivateCircuitPublicInputs(seed = 0): PrivateCircuitPublicInputs { return PrivateCircuitPublicInputs.from({ maxBlockNumber: new MaxBlockNumber(true, new Fr(seed + 0x31415)), - callContext: new CallContext( - makeAztecAddress(seed + 1), - makeAztecAddress(seed + 2), - new EthAddress(numToUInt32BE(seed + 3, /* eth address is 20 bytes */ 20)), - makeSelector(seed + 4), - true, - true, - 0, - makeGasSettings(seed + 4), - fr(seed + 5), - ), + callContext: makeCallContext(seed, { isDelegateCall: true, isStaticCall: true }), argsHash: fr(seed + 0x100), returnsHash: fr(seed + 0x200), minRevertibleSideEffectCounter: fr(0), diff --git a/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts b/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts index 493fc893375..2d4009042a0 100644 --- a/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts +++ b/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts @@ -8,6 +8,7 @@ import { PublicFeePaymentMethod, TxStatus, } from '@aztec/aztec.js'; +import { GasSettings } from '@aztec/circuits.js'; import { FPCContract, GasTokenContract, TokenContract } from '@aztec/noir-contracts.js'; import { getCanonicalGasTokenAddress } from '@aztec/protocol-contracts/gas-token'; @@ -69,14 +70,7 @@ describe('benchmarks/tx_size_fees', () => { const paymentMethod = await createPaymentMethod(); const tx = await token.methods .transfer(aliceWallet.getAddress(), bobAddress, 1n, 0) - .send({ - fee: paymentMethod - ? { - maxFee: 3n, - paymentMethod, - } - : undefined, - }) + .send({ fee: paymentMethod ? { gasSettings: GasSettings.empty(), paymentMethod } : undefined }) .wait(); expect(tx.status).toEqual(TxStatus.MINED); diff --git a/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts b/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts index 19cc2a9031a..a5398f9506b 100644 --- a/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts +++ b/yarn-project/end-to-end/src/e2e_dapp_subscription.test.ts @@ -11,6 +11,7 @@ import { PublicFeePaymentMethod, SentTx, } from '@aztec/aztec.js'; +import { GasSettings } from '@aztec/circuits.js'; import { DefaultDappEntrypoint } from '@aztec/entrypoints/dapp'; import { AppSubscriptionContract, @@ -52,13 +53,22 @@ describe('e2e_dapp_subscription', () => { const PRIVATELY_MINTED_BANANAS = 600n; const FEE_AMOUNT = 1n; - const REFUND = 2n; // intentionally overpay the gas fee. This is the expected refund. + const REFUND = 29n; // intentionally overpay the gas fee. This is the expected refund. const MAX_FEE = FEE_AMOUNT + REFUND; + const GAS_SETTINGS = GasSettings.new({ + da: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l1: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l2: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + inclusionFee: new Fr(6), + }); + beforeAll(async () => { process.env.PXE_URL = ''; process.env.ENABLE_GAS ??= '1'; + expect(GAS_SETTINGS.getFeeLimit().toBigInt()).toEqual(MAX_FEE); + let wallets: AccountWalletWithPrivateKey[]; let aztecNode: AztecNode; let deployL1ContractsValues: DeployL1Contracts; @@ -243,12 +253,7 @@ describe('e2e_dapp_subscription', () => { return subscriptionContract .withWallet(aliceWallet) .methods.subscribe(aliceAddress, nonce, (await pxe.getBlockNumber()) + blockDelta, txCount) - .send({ - fee: { - maxFee, - paymentMethod, - }, - }) + .send({ fee: { gasSettings: GAS_SETTINGS, paymentMethod } }) .wait(); } diff --git a/yarn-project/end-to-end/src/e2e_fees.test.ts b/yarn-project/end-to-end/src/e2e_fees.test.ts index 010b5a0da44..2c196ef9396 100644 --- a/yarn-project/end-to-end/src/e2e_fees.test.ts +++ b/yarn-project/end-to-end/src/e2e_fees.test.ts @@ -16,7 +16,7 @@ import { computeAuthWitMessageHash, computeMessageSecretHash, } from '@aztec/aztec.js'; -import { FunctionData } from '@aztec/circuits.js'; +import { FunctionData, GasSettings } from '@aztec/circuits.js'; import { type ContractArtifact, decodeFunctionSignature } from '@aztec/foundation/abi'; import { TokenContract as BananaCoin, @@ -53,6 +53,13 @@ describe('e2e_fees', () => { let bananaPublicBalances: BalancesFn; let bananaPrivateBalances: BalancesFn; + const gasSettings = GasSettings.new({ + da: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l1: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l2: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + inclusionFee: new Fr(6), + }); + beforeAll(async () => { const { wallets: _wallets, aztecNode, deployL1ContractsValues, logger, pxe } = await setup(3, {}, {}, true); wallets = _wallets; @@ -106,8 +113,6 @@ describe('e2e_fees', () => { const OutrageousPublicAmountAliceDoesNotHave = 10000n; const PublicMintedAlicePublicBananas = 1000n; const FeeAmount = 1n; - const RefundAmount = 2n; - const MaxFee = FeeAmount + RefundAmount; const [initialAlicePrivateBananas, initialFPCPrivateBananas] = await bananaPrivateBalances( aliceAddress, @@ -130,7 +135,7 @@ describe('e2e_fees', () => { .transfer_public(aliceAddress, sequencerAddress, OutrageousPublicAmountAliceDoesNotHave, 0) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PublicFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -160,7 +165,7 @@ describe('e2e_fees', () => { .send({ skipPublicSimulation: true, fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PublicFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -213,10 +218,12 @@ describe('e2e_fees', () => { beforeEach(async () => { FeeAmount = 1n; - RefundAmount = 2n; - MaxFee = FeeAmount + RefundAmount; + MaxFee = 30n; + RefundAmount = MaxFee - FeeAmount; RefundSecret = Fr.random(); + expect(gasSettings.getFeeLimit().toBigInt()).toEqual(MaxFee); + [ [InitialAlicePrivateBananas, InitialBobPrivateBananas, InitialFPCPrivateBananas], [InitialAlicePublicBananas, InitialFPCPublicBananas], @@ -261,7 +268,7 @@ describe('e2e_fees', () => { .transfer(aliceAddress, bobAddress, transferAmount, 0n) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -324,7 +331,7 @@ describe('e2e_fees', () => { .privately_mint_private_note(newlyMintedBananas) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -390,7 +397,7 @@ describe('e2e_fees', () => { .shield(aliceAddress, shieldedBananas, shieldSecretHash, 0n) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -462,7 +469,7 @@ describe('e2e_fees', () => { ]) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -516,7 +523,7 @@ describe('e2e_fees', () => { // we need to skip public simulation otherwise the PXE refuses to accept the TX skipPublicSimulation: true, fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bankruptFPC.address, @@ -532,10 +539,6 @@ describe('e2e_fees', () => { it('fails transaction that error in setup', async () => { const OutrageousPublicAmountAliceDoesNotHave = 10000n; - // const PublicMintedAlicePublicBananas = 1000n; - const FeeAmount = 1n; - const RefundAmount = 2n; - const MaxFee = FeeAmount + RefundAmount; // simulation throws an error when setup fails await expect( @@ -543,7 +546,7 @@ describe('e2e_fees', () => { .transfer_public(aliceAddress, sequencerAddress, OutrageousPublicAmountAliceDoesNotHave, 0) .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new BuggedSetupFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -557,7 +560,7 @@ describe('e2e_fees', () => { .send({ skipPublicSimulation: true, fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new BuggedSetupFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -570,11 +573,7 @@ describe('e2e_fees', () => { * We trigger an error in teardown by having the FPC authorize a transfer of its entire balance to Alice * as part of app logic. This will cause the FPC to not have enough funds to pay the refund back to Alice. */ - const PublicMintedAlicePublicBananas = 1000n; - const FeeAmount = 1n; - const RefundAmount = 2n; - const MaxFee = FeeAmount + RefundAmount; const [initialAlicePrivateBananas, initialFPCPrivateBananas] = await bananaPrivateBalances( aliceAddress, @@ -597,7 +596,7 @@ describe('e2e_fees', () => { .mint_public(aliceAddress, 1n) // random operation .send({ fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new BuggedTeardownFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -611,7 +610,7 @@ describe('e2e_fees', () => { .send({ skipPublicSimulation: true, fee: { - maxFee: MaxFee, + gasSettings, paymentMethod: new BuggedTeardownFeePaymentMethod(bananaCoin.address, bananaFPC.address, wallets[0]), }, }) @@ -672,7 +671,8 @@ describe('e2e_fees', () => { }); class BuggedSetupFeePaymentMethod extends PublicFeePaymentMethod { - getFunctionCalls(maxFee: Fr): Promise { + getFunctionCalls(gasSettings: GasSettings): Promise { + const maxFee = gasSettings.getFeeLimit(); const nonce = Fr.random(); const messageHash = computeAuthWitMessageHash( this.paymentContract, @@ -705,9 +705,10 @@ class BuggedSetupFeePaymentMethod extends PublicFeePaymentMethod { } class BuggedTeardownFeePaymentMethod extends PublicFeePaymentMethod { - async getFunctionCalls(maxFee: Fr): Promise { + async getFunctionCalls(gasSettings: GasSettings): Promise { // authorize the FPC to take the max fee from Alice const nonce = Fr.random(); + const maxFee = gasSettings.getFeeLimit(); const messageHash1 = computeAuthWitMessageHash( this.paymentContract, this.wallet.getChainId(), diff --git a/yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts b/yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts index 94f7321a0ae..1cb3ab1ba33 100644 --- a/yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts +++ b/yarn-project/end-to-end/src/flakey_e2e_account_init_fees.test.ts @@ -15,7 +15,7 @@ import { computeMessageSecretHash, generatePublicKey, } from '@aztec/aztec.js'; -import { type AztecAddress, CompleteAddress, Fq } from '@aztec/circuits.js'; +import { type AztecAddress, CompleteAddress, DimensionGasSettings, Fq, GasSettings } from '@aztec/circuits.js'; import { TokenContract as BananaCoin, FPCContract, @@ -70,6 +70,7 @@ describe('e2e_fees_account_init', () => { let fpcsInitialGas: bigint; let fpcsInitialPublicBananas: bigint; + let gasSettings: GasSettings; let maxFee: bigint; let actualFee: bigint; @@ -123,7 +124,9 @@ describe('e2e_fees_account_init', () => { afterAll(() => ctx.teardown()); beforeEach(() => { - maxFee = 3n; + const individualGasSettings = new DimensionGasSettings(2, 1, Fr.ONE); + gasSettings = new GasSettings(individualGasSettings, individualGasSettings, individualGasSettings, new Fr(5)); + maxFee = 3n * 3n + 5n; actualFee = 1n; bobsPrivateEncryptionKey = Fq.random(); bobsPrivateSigningKey = Fq.random(); @@ -143,7 +146,7 @@ describe('e2e_fees_account_init', () => { await bobsAccountManager .deploy({ fee: { - maxFee, + gasSettings, paymentMethod: await NativeFeePaymentMethod.create(await bobsAccountManager.getWallet()), }, }) @@ -188,7 +191,7 @@ describe('e2e_fees_account_init', () => { const tx = await bobsAccountManager .deploy({ fee: { - maxFee, + gasSettings, paymentMethod: new PrivateFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -246,7 +249,7 @@ describe('e2e_fees_account_init', () => { .deploy({ skipPublicDeployment: false, fee: { - maxFee, + gasSettings, paymentMethod: new PublicFeePaymentMethod( bananaCoin.address, bananaFPC.address, @@ -301,7 +304,7 @@ describe('e2e_fees_account_init', () => { skipInitialization: false, universalDeploy: true, fee: { - maxFee, + gasSettings, paymentMethod: await NativeFeePaymentMethod.create(alice), }, }) diff --git a/yarn-project/entrypoints/src/account_entrypoint.ts b/yarn-project/entrypoints/src/account_entrypoint.ts index 84a78f8b1a9..fccd4800177 100644 --- a/yarn-project/entrypoints/src/account_entrypoint.ts +++ b/yarn-project/entrypoints/src/account_entrypoint.ts @@ -1,7 +1,7 @@ import { type AuthWitnessProvider } from '@aztec/aztec.js/account'; import { type EntrypointInterface, EntrypointPayload, type ExecutionRequestInit } from '@aztec/aztec.js/entrypoint'; import { PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; -import { type AztecAddress, FunctionData, TxContext } from '@aztec/circuits.js'; +import { type AztecAddress, FunctionData, GasSettings, TxContext } from '@aztec/circuits.js'; import { type FunctionAbi, encodeArguments } from '@aztec/foundation/abi'; import { DEFAULT_CHAIN_ID, DEFAULT_VERSION } from './constants.js'; @@ -36,6 +36,7 @@ export class DefaultAccountEntrypoint implements EntrypointInterface { txContext: TxContext.empty(this.chainId, this.version), packedArguments: [...appPayload.packedArguments, ...feePayload.packedArguments, entrypointPackedArgs], authWitnesses: [appAuthWitness, feeAuthWitness], + gasSettings: exec.fee?.gasSettings ?? GasSettings.default(), }); return txRequest; diff --git a/yarn-project/entrypoints/src/dapp_entrypoint.ts b/yarn-project/entrypoints/src/dapp_entrypoint.ts index a65e501d1ab..55381e04cc0 100644 --- a/yarn-project/entrypoints/src/dapp_entrypoint.ts +++ b/yarn-project/entrypoints/src/dapp_entrypoint.ts @@ -2,7 +2,7 @@ import { computeInnerAuthWitHash, computeOuterAuthWitHash } from '@aztec/aztec.j import { type AuthWitnessProvider } from '@aztec/aztec.js/account'; import { type EntrypointInterface, EntrypointPayload, type ExecutionRequestInit } from '@aztec/aztec.js/entrypoint'; import { PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; -import { type AztecAddress, Fr, FunctionData, TxContext } from '@aztec/circuits.js'; +import { type AztecAddress, Fr, FunctionData, GasSettings, TxContext } from '@aztec/circuits.js'; import { type FunctionAbi, encodeArguments } from '@aztec/foundation/abi'; import { DEFAULT_CHAIN_ID, DEFAULT_VERSION } from './constants.js'; @@ -50,6 +50,7 @@ export class DefaultDappEntrypoint implements EntrypointInterface { txContext: TxContext.empty(this.chainId, this.version), packedArguments: [...payload.packedArguments, entrypointPackedArgs], authWitnesses: [authWitness], + gasSettings: exec.fee?.gasSettings ?? GasSettings.default(), }); return txRequest; diff --git a/yarn-project/foundation/src/fields/fields.ts b/yarn-project/foundation/src/fields/fields.ts index c9b3c88fe96..8aaa9345874 100644 --- a/yarn-project/foundation/src/fields/fields.ts +++ b/yarn-project/foundation/src/fields/fields.ts @@ -188,6 +188,7 @@ export interface Fr { */ export class Fr extends BaseField { static ZERO = new Fr(0n); + static ONE = new Fr(1n); static MODULUS = 0x30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001n; constructor(value: number | bigint | boolean | Fr | Buffer) { diff --git a/yarn-project/noir-protocol-circuits-types/src/__snapshots__/index.test.ts.snap b/yarn-project/noir-protocol-circuits-types/src/__snapshots__/index.test.ts.snap index 67fdd01c872..7c722a43ea3 100644 --- a/yarn-project/noir-protocol-circuits-types/src/__snapshots__/index.test.ts.snap +++ b/yarn-project/noir-protocol-circuits-types/src/__snapshots__/index.test.ts.snap @@ -56,7 +56,7 @@ PrivateKernelCircuitPublicInputs { "inHash": Buffer<0x00089a9d421a82c4a25f7acbebe69e638d5b064fa8a60e018793dcb0be53752c>, "outHash": Buffer<0x0007638bb56b6dda2b64b8f76841114ac3a87a1820030e2e16772c4d294879c3>, "txTreeHeight": Fr<0x0000000000000000000000000000000000000000000000000000000000000001>, - "txsEffectsHash": Buffer<0x001b4dbaea2f9d80e6cb122cdaee2739150556b9e0c0a90709f6d5cbce342c1a>, + "txsEffectsHash": Buffer<0x009f88379d44d0a51bbcabe282c4a95d4d557f32ee6504222f98fac65c836ef8>, }, "globalVariables": { "blockNumber": "0x0000000000000000000000000000000000000000000000000000000000000003", @@ -64,16 +64,16 @@ PrivateKernelCircuitPublicInputs { "coinbase": "0x0000000000000000000000000000000000000000", "feeRecipient": "0x0000000000000000000000000000000000000000000000000000000000000000", "gasFees": { - "feePerDaGas": "0x0000000000000000000000000000000000000000000000000000000000000000", - "feePerL1Gas": "0x0000000000000000000000000000000000000000000000000000000000000000", - "feePerL2Gas": "0x0000000000000000000000000000000000000000000000000000000000000000", + "feePerDaGas": "0x0000000000000000000000000000000000000000000000000000000000000001", + "feePerL1Gas": "0x0000000000000000000000000000000000000000000000000000000000000001", + "feePerL2Gas": "0x0000000000000000000000000000000000000000000000000000000000000001", }, - "timestamp": "0x0000000000000000000000000000000000000000000000000000000066171575", + "timestamp": "0x000000000000000000000000000000000000000000000000000000006619ac6e", "version": "0x0000000000000000000000000000000000000000000000000000000000000001", }, "lastArchive": AppendOnlyTreeSnapshot { "nextAvailableLeafIndex": 3, - "root": Fr<0x1ba288b53571e664cfa3bfefb89ab6191de95673e41d1fb22e62b09b855d67f7>, + "root": Fr<0x0d73b8dcb63644da3ce1cc4b72ce47a9011e4ee6fcadddd072669e8874520e88>, }, "state": StateReference { "l1ToL2MessageTree": AppendOnlyTreeSnapshot { @@ -83,11 +83,11 @@ PrivateKernelCircuitPublicInputs { "partial": PartialStateReference { "noteHashTree": AppendOnlyTreeSnapshot { "nextAvailableLeafIndex": 384, - "root": Fr<0x2f1cfd44c9cba4e480325d4fd884081ed1c4dd05261d6ca155a74c412a52cc1b>, + "root": Fr<0x0c8f36d51e7c4d4764693616ce61b40443e51e4b0671e653a283778f3f38ef63>, }, "nullifierTree": AppendOnlyTreeSnapshot { "nextAvailableLeafIndex": 512, - "root": Fr<0x304ac7a8f67dbec9f24638c7a0b6a41908a73d0ab95af4a8e0508930a7b5c7e9>, + "root": Fr<0x27c729d136d77fc9ee9ae8826e430102e8179b0352860a27897475deb4789d4d>, }, "publicDataTree": AppendOnlyTreeSnapshot { "nextAvailableLeafIndex": 256, @@ -106,7 +106,7 @@ PrivateKernelCircuitPublicInputs { "end": PrivateAccumulatedData { "encryptedLogPreimagesLength": Fr<0x000000000000000000000000000000000000000000000000000000000000000c>, "encryptedLogsHash": Fr<0x00f33ae280239814c4dfaaafc16fc138a8d3eae52bb962af6576cbb61c2af246>, - "gasUsed": GasUsed { + "gasUsed": Gas { "daGas": 0, "l1Gas": 0, "l2Gas": 0, @@ -377,7 +377,7 @@ PrivateKernelCircuitPublicInputs { SideEffectLinkedToNoteHash { "counter": Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, "noteHash": Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, - "value": Fr<0x21d1d4076140e83671eecc82ab096e1cd02e4473ecfe72a9aa0b6f4f385a1431>, + "value": Fr<0x1880aed672696b500b0b9aecfd6dc4514db66fe4f2b7e1eced3890792361e5de>, }, SideEffectLinkedToNoteHash { "counter": Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, @@ -1779,8 +1779,8 @@ PrivateKernelTailCircuitPublicInputs { "forRollup": PartialPrivateTailPublicInputsForRollup { "end": CombinedAccumulatedData { "encryptedLogPreimagesLength": Fr<0x000000000000000000000000000000000000000000000000000000000000013c>, - "encryptedLogsHash": Fr<0x00d9390f71f6e9a79785314dbe71198e95418c404086825f7b33a1cecd7e0a16>, - "gasUsed": GasUsed { + "encryptedLogsHash": Fr<0x006b84c144df926035cff13e0fb09ba4d9a3ee630a19e337070937cebe54a142>, + "gasUsed": Gas { "daGas": 0, "l1Gas": 0, "l2Gas": 0, @@ -1790,7 +1790,7 @@ PrivateKernelTailCircuitPublicInputs { Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, ], "newNoteHashes": [ - Fr<0x14e797216d66e4e470a0f73e890ef6607f43bdb4897f1f2cddcfa3ad8744f092>, + Fr<0x19bf43108e47e7de12dfc5b64b4c654948d5f3fab57fb5f8656c755f77a7abdd>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, @@ -1856,9 +1856,9 @@ PrivateKernelTailCircuitPublicInputs { Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, ], "newNullifiers": [ - Fr<0x2984d86a49ea3553c56bad2dbb7151399a5ef4281892e2b881ea7701ee178c43>, - Fr<0x2f3714e42ab151d853ce688205234d6f7531a931255da3c015d0066839bd8baf>, - Fr<0x00980df506642279a35f8211f10abbb31491b7dcdcc194aa9da7f7d484703269>, + Fr<0x04c7ecd5d2f178611681297a008901bfe783c6a31e23f58f1610e2e5ae4c3ce3>, + Fr<0x2c391fb5b3309c990b808765e989268195f732146a90adbcbdb14a1ed8f5265f>, + Fr<0x1c2ce60b74b4f12fe8f7ca2070458aaf50cffeb38ada523fd775a2c13183311c>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, Fr<0x0000000000000000000000000000000000000000000000000000000000000000>, diff --git a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-init.hex b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-init.hex index 82267eac885..4edb9086806 100644 --- a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-init.hex +++ b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-init.hex @@ -1 +1 @@ -12f3878234dbd892f874b0b1e7ecfa981192df2082674a462f2030cd42940c3d37889ba101058ad91eb9f5e062fd8d238f47fa206ecdba2dd667fde55fe75cc6b41d0a481f00000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000112f3878234dbd892f874b0b1e7ecfa981192df2082674a462f2030cd42940c3d37889ba101000000000000000000000000000000000000000000000000000000000000000012f3878234dbd892f874b0b1e7ecfa981192df2082674a462f2030cd42940c3d000000000000000000000000000000000000000037889ba100000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000058ad91eb9f5e062fd8d238f47fa206ecdba2dd667fde55fe75cc6b41d0a481f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000005016ee1170a01e7f9340076e89ad1dfd299c888cd2d1af0a33161a83f8f2064000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000500e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b800e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b80000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f800000000016642d9ccd8346c403aa4c3fa451178b22534a27035cdaa6ec34ae53b29c50cb000000000bcfa3e9f1a8922ee92c6dc964d6595907c1804a86753774322b468f69d4f278000000800572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000105016ee1170a01e7f9340076e89ad1dfd299c888cd2d1af0a33161a83f8f206412f3878234dbd892f874b0b1e7ecfa981192df2082674a462f2030cd42940c3d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f28729113b48351481d85220366c267713c6bf17ab3437fd04d59b6c6dc1bc98f1dae27cc7fe2af345f160253be3875d449a7e9ba6bd68747d87d4e7054b8111527b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed19ffad41d477b4d4077d3edfe7eaf592f3b332d915dc68b41f2f1f370ebed632000000000000000000000000000000000000000000000000000000000000000027b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed21dbfd1d029bf447152fcf89e355c334610d1632436ba170f738107266a715500bcd1f91cf7bdd471d0a30c58c4706f3fdab3807a954b8f5b5e3bfec87d001bb06e62084ee7b602fe9abc15632dda3269f56fb0c6e12519a2eb2ec897091919d03c9e2e67178ac638746f068907e6677b4cc7a9592ef234ab6ab518f17efffa000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file +1542e706b7d400b46fa10f5a5d1f25970d34feff6e9e23a55422f6e4c5ae84b637889ba1011751bdf6c6325cac78c13a6518b58a1d538f2ee71dc34d3822258669a89ca2c300000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001542e706b7d400b46fa10f5a5d1f25970d34feff6e9e23a55422f6e4c5ae84b637889ba10100000000000000000000000000000000000000000000000000000000000000001542e706b7d400b46fa10f5a5d1f25970d34feff6e9e23a55422f6e4c5ae84b6000000000000000000000000000000000000000037889ba1000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001751bdf6c6325cac78c13a6518b58a1d538f2ee71dc34d3822258669a89ca2c3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000f34fe96f4f0474d57f53c2abc41d0524a12d21d02f413ff1da1b704638d3cd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000500e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b800e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b80000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f800000000016642d9ccd8346c403aa4c3fa451178b22534a27035cdaa6ec34ae53b29c50cb000000000bcfa3e9f1a8922ee92c6dc964d6595907c1804a86753774322b468f69d4f278000000800572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000000400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a6900000000000000000000000000000000000000000000000000000000000000010f34fe96f4f0474d57f53c2abc41d0524a12d21d02f413ff1da1b704638d3cd01542e706b7d400b46fa10f5a5d1f25970d34feff6e9e23a55422f6e4c5ae84b600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f27a6bc6f7d8adc5027a61509e26a35f7de8d2f48c8f5511588460e1715c7be551dae27cc7fe2af345f160253be3875d449a7e9ba6bd68747d87d4e7054b8111527b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed19ffad41d477b4d4077d3edfe7eaf592f3b332d915dc68b41f2f1f370ebed632000000000000000000000000000000000000000000000000000000000000000027b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed21dbfd1d029bf447152fcf89e355c334610d1632436ba170f738107266a715500bcd1f91cf7bdd471d0a30c58c4706f3fdab3807a954b8f5b5e3bfec87d001bb06e62084ee7b602fe9abc15632dda3269f56fb0c6e12519a2eb2ec897091919d03c9e2e67178ac638746f068907e6677b4cc7a9592ef234ab6ab518f17efffa000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file diff --git a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-inner.hex b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-inner.hex index 34510a76e1b..733be30a064 100644 --- a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-inner.hex +++ b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-inner.hex @@ -1 +1 @@ -0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000001000000bd300000bd400000bd500000bd600000bd700000bd800000bd900000bda00000bdb00000bdc00000bdd00000bde00000bdf00000be000000be100000be200000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000021d1d4076140e83671eecc82ab096e1cd02e4473ecfe72a9aa0b6f4f385a14310000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c00000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000008160676423f42e941d3690819833afecb0168c3ccde3e22656def19177297942a2a9134b767b685adbef84868a5b3883643838e479838406e6e6f35f77fad416100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001ba288b53571e664cfa3bfefb89ab6191de95673e41d1fb22e62b09b855d67f7000000030000000000000000000000000000000000000000000000000000000000000001001b4dbaea2f9d80e6cb122cdaee2739150556b9e0c0a90709f6d5cbce342c1a00089a9d421a82c4a25f7acbebe69e638d5b064fa8a60e018793dcb0be53752c0007638bb56b6dda2b64b8f76841114ac3a87a1820030e2e16772c4d294879c31864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f80000000302f1cfd44c9cba4e480325d4fd884081ed1c4dd05261d6ca155a74c412a52cc1b00000180304ac7a8f67dbec9f24638c7a0b6a41908a73d0ab95af4a8e0508930a7b5c7e9000002000572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000001000000000000000000000000000000000000000000000000000000000000007a690000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000661715750000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f000000001beef249a9a8a9cf54420d99e988b97d29ed03f795b42c12bf3eff8ae366fdde2ac527c2b45a8c7039889bdea861709348fe021ff609b3c08527b4ffc4388952211dad326c6282e200184455c579d625cc17f01278e0811db2b9515085b1cc6f06b646bebd48b22cab44919afa5822d87cdeb6eb3c81410c944a0c91948e84c80906bca1012a9134b767b685adbef84868a5b3883643838e479838406e6e6f35f77fad416106b646bebd48b22cab44919afa5822d87cdeb6eb3c81410c944a0c91948e84c800000000000000000000000000000000000000000906bca1000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002898402da2fa95f47c47763fe5b171ff3155bd31e5af88d9823bccb26b6701542451ab56341b4067780469e41818b47f8fd45f4bd186f22ba4b4a1bb5d45a42d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000300e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b800e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b8000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000041ba288b53571e664cfa3bfefb89ab6191de95673e41d1fb22e62b09b855d67f7000000030000000000000000000000000000000000000000000000000000000000000001001b4dbaea2f9d80e6cb122cdaee2739150556b9e0c0a90709f6d5cbce342c1a00089a9d421a82c4a25f7acbebe69e638d5b064fa8a60e018793dcb0be53752c0007638bb56b6dda2b64b8f76841114ac3a87a1820030e2e16772c4d294879c31864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f80000000302f1cfd44c9cba4e480325d4fd884081ed1c4dd05261d6ca155a74c412a52cc1b00000180304ac7a8f67dbec9f24638c7a0b6a41908a73d0ab95af4a8e0508930a7b5c7e9000002000572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000001000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000066171575000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a6900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f1e2f8a2c647f01b125bd299928e4cb2027e20922fa89a973a6bc1913790d84e81eda71eb7011cc398d393d8a083a784961615c243559c964511a6f6a18a12d9427b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed0669ad6620a19c0ff5f912c2970e504ddc8cdf586eafe27ab44345840c9dca8200000000000000000000000000000000000000000000000000000000000000002452a14c748981acff167dba9088770b6c2c2dc34677295a1974f2c247236ba11e904e4d0a67667f8faaa89198f5e89684e213bc99a83c3b20888d5854d3dd320bcd1f91cf7bdd471d0a30c58c4706f3fdab3807a954b8f5b5e3bfec87d001bb06e62084ee7b602fe9abc15632dda3269f56fb0c6e12519a2eb2ec897091919d03c9e2e67178ac638746f068907e6677b4cc7a9592ef234ab6ab518f17efffa000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file +0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000001000000bd300000bd400000bd500000bd600000bd700000bd800000bd900000bda00000bdb00000bdc00000bdd00000bde00000bdf00000be000000be100000be20000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001880aed672696b500b0b9aecfd6dc4514db66fe4f2b7e1eced3890792361e5de0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000082ed55d9a77c69f79c676dd08389c15a7cef535cbeb79c0bc0e2b2281bf5a4ee625d9fa771a71f0bdf81ef098310c1a85781ba9f1d6a48a86c31a8e32f007b44900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000d73b8dcb63644da3ce1cc4b72ce47a9011e4ee6fcadddd072669e8874520e88000000030000000000000000000000000000000000000000000000000000000000000001009f88379d44d0a51bbcabe282c4a95d4d557f32ee6504222f98fac65c836ef800089a9d421a82c4a25f7acbebe69e638d5b064fa8a60e018793dcb0be53752c0007638bb56b6dda2b64b8f76841114ac3a87a1820030e2e16772c4d294879c31864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f80000000300c8f36d51e7c4d4764693616ce61b40443e51e4b0671e653a283778f3f38ef630000018027c729d136d77fc9ee9ae8826e430102e8179b0352860a27897475deb4789d4d000002000572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000001000000000000000000000000000000000000000000000000000000000000007a6900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000006619ac6e0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f0000000027c5fe4e30f75253cf4da921a648af377a2a2488c7a8dafc4dada7a36744dead2476fe960a5df72a0a135ecfa44f16c4340253a6f0aeb08f3baa54e97fa4f811126bf8c85bf3ad7f0dc949a9f8dfeadcdf19c4f1e8d2de07f3322ea27b9d752b0b48a6b62ea408a1d3c4d2c00b439d8926a87ef37a7c6c4f37df06ef2346eead0906bca10125d9fa771a71f0bdf81ef098310c1a85781ba9f1d6a48a86c31a8e32f007b4490b48a6b62ea408a1d3c4d2c00b439d8926a87ef37a7c6c4f37df06ef2346eead00000000000000000000000000000000000000000906bca1000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002898402da2fa95f47c47763fe5b171ff3155bd31e5af88d9823bccb26b6701542451ab56341b4067780469e41818b47f8fd45f4bd186f22ba4b4a1bb5d45a42d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000300e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b800e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b8000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000040d73b8dcb63644da3ce1cc4b72ce47a9011e4ee6fcadddd072669e8874520e88000000030000000000000000000000000000000000000000000000000000000000000001009f88379d44d0a51bbcabe282c4a95d4d557f32ee6504222f98fac65c836ef800089a9d421a82c4a25f7acbebe69e638d5b064fa8a60e018793dcb0be53752c0007638bb56b6dda2b64b8f76841114ac3a87a1820030e2e16772c4d294879c31864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f80000000300c8f36d51e7c4d4764693616ce61b40443e51e4b0671e653a283778f3f38ef630000018027c729d136d77fc9ee9ae8826e430102e8179b0352860a27897475deb4789d4d000002000572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b000001000000000000000000000000000000000000000000000000000000000000007a6900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000006619ac6e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000007a6900000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f1ff0a9b7a099d594bd0e354559eaf907024832a34103de4f6c7251392bdc4db12e83474780e15780013d0979caacfa35001c8b9105480f1ad1e448b46edb1f5b27b1d0839a5b23baf12a8d195b18ac288fcf401afb2f70b8a4b529ede5fa9fed18de29b683be958b594c2aeed5ee41e2f5afdb1ee459a090cb2f49ab6edc73ed00000000000000000000000000000000000000000000000000000000000000002452a14c748981acff167dba9088770b6c2c2dc34677295a1974f2c247236ba11e904e4d0a67667f8faaa89198f5e89684e213bc99a83c3b20888d5854d3dd320bcd1f91cf7bdd471d0a30c58c4706f3fdab3807a954b8f5b5e3bfec87d001bb06e62084ee7b602fe9abc15632dda3269f56fb0c6e12519a2eb2ec897091919d03c9e2e67178ac638746f068907e6677b4cc7a9592ef234ab6ab518f17efffa000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file diff --git a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-ordering.hex b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-ordering.hex index 397f119d315..ff5d1cbadd9 100644 --- a/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-ordering.hex +++ b/yarn-project/noir-protocol-circuits-types/src/fixtures/nested-call-private-kernel-ordering.hex @@ -1 +1 @@ -0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000001000000bd300000bd400000bd500000bd600000bd700000bd800000bd900000bda00000bdb00000bdc00000bdd00000bde00000bdf00000be000000be100000be200000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000b264fb6b25be47ab08630d45172a9b9c20b526ed449e50267897acb9bd133c900000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002984d86a49ea3553c56bad2dbb7151399a5ef4281892e2b881ea7701ee178c43000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002f3714e42ab151d853ce688205234d6f7531a931255da3c015d0066839bd8baf0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100980df506642279a35f8211f10abbb31491b7dcdcc194aa9da7f7d484703269000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000d9390f71f6e9a79785314dbe71198e95418c404086825f7b33a1cecd7e0a16008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c000000000000000000000000000000000000000000000000000000000000013c000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f800000000016642d9ccd8346c403aa4c3fa451178b22534a27035cdaa6ec34ae53b29c50cb000000000bcfa3e9f1a8922ee92c6dc964d6595907c1804a86753774322b468f69d4f278000000800572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b0000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f0000000024431ecc52557993d7dbc26bc50a81d3e1f65d0de62f434a390faeefca99497f28f03d33c64c1433a818180461a535dcc7206c8b07982cd13f1af7fa229f9f5a0834251ce8bc0db519e416c0a8868385c8761f7ca5a6ad00cb254db5b68c36630b264fb6b25be47ab08630d45172a9b9c20b526ed449e50267897acb9bd133c90000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f000000100000001100000012000000130000001400000015000000160000001700000018000000190000001a0000001b0000001c0000001d0000001e0000001f000000200000002100000022000000230000002400000025000000260000002700000028000000290000002a0000002b0000002c0000002d0000002e0000002f000000300000003100000032000000330000003400000035000000360000003700000038000000390000003a0000003b0000003c0000003d0000003e0000003f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002984d86a49ea3553c56bad2dbb7151399a5ef4281892e2b881ea7701ee178c43000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002f3714e42ab151d853ce688205234d6f7531a931255da3c015d0066839bd8baf0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100980df506642279a35f8211f10abbb31491b7dcdcc194aa9da7f7d48470326900000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f000000100000001100000012000000130000001400000015000000160000001700000018000000190000001a0000001b0000001c0000001d0000001e0000001f000000200000002100000022000000230000002400000025000000260000002700000028000000290000002a0000002b0000002c0000002d0000002e0000002f000000300000003100000032000000330000003400000035000000360000003700000038000000390000003a0000003b0000003c0000003d0000003e0000003f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000800000000000000080000000000000008000000000000000800000000000000080000000000000008000000000000000800000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file +0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000001000000bd300000bd400000bd500000bd600000bd700000bd800000bd900000bda00000bdb00000bdc00000bdd00000bde00000bdf00000be000000be100000be200000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000dc196678c850931f1af7b0e5d9c8c9b07c7ac59feec028e8a45f17f8df257d2000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c7ecd5d2f178611681297a008901bfe783c6a31e23f58f1610e2e5ae4c3ce3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c391fb5b3309c990b808765e989268195f732146a90adbcbdb14a1ed8f5265f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000011c2ce60b74b4f12fe8f7ca2070458aaf50cffeb38ada523fd775a2c13183311c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006b84c144df926035cff13e0fb09ba4d9a3ee630a19e337070937cebe54a142008d4d695766a616808caa331119da14269ac3271c251dec3a11df896131ba2c000000000000000000000000000000000000000000000000000000000000013c000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001864fcdaa80ff2719154fa7c8a9050662972707168d69eac9db6fd3110829f800000000016642d9ccd8346c403aa4c3fa451178b22534a27035cdaa6ec34ae53b29c50cb000000000bcfa3e9f1a8922ee92c6dc964d6595907c1804a86753774322b468f69d4f278000000800572c8db882674dd026b8877fbba1b700a4407da3ae9ce5fa43215a28163362b0000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007a69000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000800000000740000000f00000003515f3109623eb3c25aa5b16a1a79fd558bac7a7ce62c4560a8c537c77ce80dd339128d1d37b6582ee9e6df9567efb64313471dfa18f520f9ce53161b50dbf7731bc5f900000003515f322bc4cce83a486a92c92fd59bd84e0f92595baa639fc2ed86b00ffa0dfded2a092a669a3bdb7a273a015eda494457cc7ed5236f26cee330c290d45a33b9daa94800000003515f332729426c008c085a81bd34d8ef12dd31e80130339ef99d50013a89e4558eee6d0fa4ffe2ee7b7b62eb92608b2251ac31396a718f9b34978888789042b790a30100000003515f342be6b6824a913eb7a57b03cb1ee7bfb4de02f2f65fe8a4e97baa7766ddb353a82a8a25c49dc63778cd9fe96173f12a2bc77f3682f4c4448f98f1df82c75234a100000003515f351f85760d6ab567465aadc2f180af9eae3800e6958fec96aef53fd8a7b195d7c000c6267a0dd5cfc22b3fe804f53e266069c0e36f51885baec1e7e67650c62e170000000c515f41524954484d455449430d9d0f8ece2aa12012fa21e6e5c859e97bd5704e5c122064a66051294bc5e04213f61f54a0ebdf6fee4d4a6ecf693478191de0c2899bcd8e86a636c8d3eff43400000003515f43224a99d02c86336737c8dd5b746c40d2be6aead8393889a76a18d664029096e90f7fe81adcc92a74350eada9622ac453f49ebac24a066a1f83b394df54dfa0130000000c515f46495845445f42415345060e8a013ed289c2f9fd7473b04f6594b138ddb4b4cf6b901622a14088f04b8d2c83ff74fce56e3d5573b99c7b26d85d5046ce0c6559506acb7a675e7713eb3a00000007515f4c4f4749430721a91cb8da4b917e054f72147e1760cfe0ef3d45090ac0f4961d84ec1996961a25e787b26bd8b50b1a99450f77a424a83513c2b33af268cd253b0587ff50c700000003515f4d05dbd8623b8652511e1eb38d38887a69eceb082f807514f09e127237c5213b401b9325b48c6c225968002318095f89d0ef9cf629b2b7f0172e03bc39aacf6ed800000007515f52414e474504b57a3805e41df328f5ca9aefa40fad5917391543b7b65c6476e60b8f72e9ad07c92f3b3e11c8feae96dedc4b14a6226ef3201244f37cfc1ee5b96781f48d2b000000075349474d415f3125001d1954a18571eaa007144c5a567bb0d2be4def08a8be918b8c05e3b27d312c59ed41e09e144eab5de77ca89a2fd783be702a47c951d3112e3de02ce6e47c000000075349474d415f3223994e6a23618e60fa01c449a7ab88378709197e186d48d604bfb6931ffb15ad11c5ec7a0700570f80088fd5198ab5d5c227f2ad2a455a6edeec024156bb7beb000000075349474d415f3300cda5845f23468a13275d18bddae27c6bb189cf9aa95b6a03a0cb6688c7e8d829639b45cf8607c525cc400b55ebf90205f2f378626dc3406cc59b2d1b474fba000000075349474d415f342d299e7928496ea2d37f10b43afd6a80c90a33b483090d18069ffa275eedb2fc2f82121e8de43dc036d99b478b6227ceef34248939987a19011f065d8b5cef5c0000000010000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f0000000005e0566380cae864789402b085109bc5cc887555db8a6d1993ae821535ce56100795bfddf7dcb8a2c422133c34fbdc6175c8c44fb63e165904520f4284f478bc0c359b7060c5240c5ddcb1d8b2b129bfb487b4cf2198eb1c12c3bf7da937efb30dc196678c850931f1af7b0e5d9c8c9b07c7ac59feec028e8a45f17f8df257d20000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f000000100000001100000012000000130000001400000015000000160000001700000018000000190000001a0000001b0000001c0000001d0000001e0000001f000000200000002100000022000000230000002400000025000000260000002700000028000000290000002a0000002b0000002c0000002d0000002e0000002f000000300000003100000032000000330000003400000035000000360000003700000038000000390000003a0000003b0000003c0000003d0000003e0000003f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004c7ecd5d2f178611681297a008901bfe783c6a31e23f58f1610e2e5ae4c3ce3000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002c391fb5b3309c990b808765e989268195f732146a90adbcbdb14a1ed8f5265f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000011c2ce60b74b4f12fe8f7ca2070458aaf50cffeb38ada523fd775a2c13183311c00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000002000000030000000400000005000000060000000700000008000000090000000a0000000b0000000c0000000d0000000e0000000f000000100000001100000012000000130000001400000015000000160000001700000018000000190000001a0000001b0000001c0000001d0000001e0000001f000000200000002100000022000000230000002400000025000000260000002700000028000000290000002a0000002b0000002c0000002d0000002e0000002f000000300000003100000032000000330000003400000035000000360000003700000038000000390000003a0000003b0000003c0000003d0000003e0000003f0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000800000000000000080000000000000008000000000000000800000000000000080000000000000008000000000000000800000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000 \ No newline at end of file diff --git a/yarn-project/noir-protocol-circuits-types/src/index.ts b/yarn-project/noir-protocol-circuits-types/src/index.ts index 568a5071356..cc31ec2dde7 100644 --- a/yarn-project/noir-protocol-circuits-types/src/index.ts +++ b/yarn-project/noir-protocol-circuits-types/src/index.ts @@ -629,7 +629,7 @@ async function executePrivateKernelTailToPublicWithACVM( return decodedInputs.return_value as PublicPublicPreviousReturnType; } -const foreignCallHandler = (name: string, args: ForeignCallInput[]) => { +export const foreignCallHandler = (name: string, args: ForeignCallInput[]) => { const log = createDebugLogger('aztec:noir-protocol-circuits:oracle'); if (name === 'debugLog') { diff --git a/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts b/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts index 67ed202f436..0dbf841e51e 100644 --- a/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts +++ b/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts @@ -21,9 +21,9 @@ import { Fr, FunctionData, FunctionSelector, + Gas, GasFees, GasSettings, - GasUsed, GlobalVariables, type GrumpkinPrivateKey, GrumpkinScalar, @@ -117,8 +117,8 @@ import { type FunctionLeafMembershipWitness as FunctionLeafMembershipWitnessNoir, type FunctionSelector as FunctionSelectorNoir, type GasFees as GasFeesNoir, + type Gas as GasNoir, type GasSettings as GasSettingsNoir, - type GasUsed as GasUsedNoir, type GrumpkinPrivateKey as GrumpkinPrivateKeyNoir, type L2ToL1Message as L2ToL1MessageNoir, type MaxBlockNumber as MaxBlockNumberNoir, @@ -410,6 +410,7 @@ export function mapTxRequestToNoir(txRequest: TxRequest): TxRequestNoir { args_hash: mapFieldToNoir(txRequest.argsHash), tx_context: mapTxContextToNoir(txRequest.txContext), function_data: mapFunctionDataToNoir(txRequest.functionData), + gas_settings: mapGasSettingsToNoir(txRequest.gasSettings), }; } @@ -424,6 +425,7 @@ export function mapCallContextFromNoir(callContext: CallContextNoir): CallContex mapAztecAddressFromNoir(callContext.storage_contract_address), mapEthAddressFromNoir(callContext.portal_contract_address), mapFunctionSelectorFromNoir(callContext.function_selector), + mapGasFromNoir(callContext.gas_left), callContext.is_delegate_call, callContext.is_static_call, mapNumberFromNoir(callContext.side_effect_counter), @@ -443,6 +445,7 @@ export function mapCallContextToNoir(callContext: CallContext): CallContextNoir storage_contract_address: mapAztecAddressToNoir(callContext.storageContractAddress), portal_contract_address: mapEthAddressToNoir(callContext.portalContractAddress), function_selector: mapFunctionSelectorToNoir(callContext.functionSelector), + gas_left: mapGasToNoir(callContext.gasLeft), is_delegate_call: callContext.isDelegateCall, is_static_call: callContext.isStaticCall, side_effect_counter: mapNumberToNoir(callContext.sideEffectCounter), @@ -1022,7 +1025,7 @@ export function mapPrivateAccumulatedDataFromNoir( MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, mapCallRequestFromNoir, ), - mapGasUsedFromNoir(privateAccumulatedData.gas_used), + mapGasFromNoir(privateAccumulatedData.gas_used), ); } @@ -1037,7 +1040,7 @@ export function mapPrivateAccumulatedDataToNoir(data: PrivateAccumulatedData): P unencrypted_log_preimages_length: mapFieldToNoir(data.unencryptedLogPreimagesLength), private_call_stack: mapTuple(data.privateCallStack, mapCallRequestToNoir), public_call_stack: mapTuple(data.publicCallStack, mapCallRequestToNoir), - gas_used: mapGasUsedToNoir(data.gasUsed), + gas_used: mapGasToNoir(data.gasUsed), }; } @@ -1062,7 +1065,7 @@ export function mapPublicAccumulatedDataFromNoir( MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, mapCallRequestFromNoir, ), - mapGasUsedFromNoir(publicAccumulatedData.gas_used), + mapGasFromNoir(publicAccumulatedData.gas_used), ); } @@ -1082,19 +1085,19 @@ export function mapPublicAccumulatedDataToNoir( mapPublicDataUpdateRequestToNoir, ), public_call_stack: mapTuple(publicAccumulatedData.publicCallStack, mapCallRequestToNoir), - gas_used: mapGasUsedToNoir(publicAccumulatedData.gasUsed), + gas_used: mapGasToNoir(publicAccumulatedData.gasUsed), }; } -export function mapGasUsedFromNoir(gasUsed: GasUsedNoir): GasUsed { - return GasUsed.from({ +export function mapGasFromNoir(gasUsed: GasNoir): Gas { + return Gas.from({ daGas: mapNumberFromNoir(gasUsed.da_gas), l1Gas: mapNumberFromNoir(gasUsed.l1_gas), l2Gas: mapNumberFromNoir(gasUsed.l2_gas), }); } -export function mapGasUsedToNoir(gasUsed: GasUsed): GasUsedNoir { +export function mapGasToNoir(gasUsed: Gas): GasNoir { return { da_gas: mapNumberToNoir(gasUsed.daGas), l1_gas: mapNumberToNoir(gasUsed.l1Gas), @@ -1150,7 +1153,7 @@ export function mapCombinedAccumulatedDataFromNoir( MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, mapPublicDataUpdateRequestFromNoir, ), - mapGasUsedFromNoir(combinedAccumulatedData.gas_used), + mapGasFromNoir(combinedAccumulatedData.gas_used), ); } @@ -1169,7 +1172,7 @@ export function mapCombinedAccumulatedDataToNoir( combinedAccumulatedData.publicDataUpdateRequests, mapPublicDataUpdateRequestToNoir, ), - gas_used: mapGasUsedToNoir(combinedAccumulatedData.gasUsed), + gas_used: mapGasToNoir(combinedAccumulatedData.gasUsed), }; } @@ -1530,9 +1533,9 @@ export function mapPublicCircuitPublicInputsToNoir( unencrypted_logs_hash: mapFieldToNoir(publicInputs.unencryptedLogsHash), unencrypted_log_preimages_length: mapFieldToNoir(publicInputs.unencryptedLogPreimagesLength), historical_header: mapHeaderToNoir(publicInputs.historicalHeader), - prover_address: mapAztecAddressToNoir(publicInputs.proverAddress), revert_code: mapRevertCodeToNoir(publicInputs.revertCode), + gas_left: mapGasToNoir(publicInputs.gasLeft), }; } /** diff --git a/yarn-project/pxe/src/pxe_service/test/pxe_test_suite.ts b/yarn-project/pxe/src/pxe_service/test/pxe_test_suite.ts index 314995a4fd5..39c3e395ca4 100644 --- a/yarn-project/pxe/src/pxe_service/test/pxe_test_suite.ts +++ b/yarn-project/pxe/src/pxe_service/test/pxe_test_suite.ts @@ -10,6 +10,7 @@ import { CompleteAddress, Fr, FunctionData, + GasSettings, INITIAL_L2_BLOCK_NUM, Point, TxContext, @@ -133,6 +134,7 @@ export const pxeTestSuite = (testName: string, pxeSetup: () => Promise) => txContext: TxContext.empty(), packedArguments: [], authWitnesses: [], + gasSettings: GasSettings.default(), }); await expect(async () => await pxe.proveTx(txExecutionRequest, false)).rejects.toThrow( diff --git a/yarn-project/sequencer-client/src/global_variable_builder/global_builder.ts b/yarn-project/sequencer-client/src/global_variable_builder/global_builder.ts index 33766cfa2c1..3ec8a8eb64c 100644 --- a/yarn-project/sequencer-client/src/global_variable_builder/global_builder.ts +++ b/yarn-project/sequencer-client/src/global_variable_builder/global_builder.ts @@ -90,7 +90,7 @@ export class SimpleTestGlobalVariableBuilder implements GlobalVariableBuilder { `Built global variables for block ${blockNumber}: (${chainId}, ${version}, ${blockNumber}, ${lastTimestamp}, ${coinbase}, ${feeRecipient})`, ); - const gasFees = GasFees.empty(); // TODO(palla/gas-in-circuits) + const gasFees = GasFees.default(); return new GlobalVariables(chainId, version, blockNumber, lastTimestamp, coinbase, feeRecipient, gasFees); } } diff --git a/yarn-project/simulator/src/avm/avm_execution_environment.ts b/yarn-project/simulator/src/avm/avm_execution_environment.ts index c21fb948a98..a3dbb81f660 100644 --- a/yarn-project/simulator/src/avm/avm_execution_environment.ts +++ b/yarn-project/simulator/src/avm/avm_execution_environment.ts @@ -1,4 +1,4 @@ -import { FunctionSelector, type GlobalVariables, type Header } from '@aztec/circuits.js'; +import { FunctionSelector, type GasSettings, type GlobalVariables, type Header } from '@aztec/circuits.js'; import { computeVarArgsHash } from '@aztec/circuits.js/hash'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { type EthAddress } from '@aztec/foundation/eth-address'; @@ -35,6 +35,8 @@ export class AvmExecutionEnvironment { public readonly isStaticCall: boolean, public readonly isDelegateCall: boolean, public readonly calldata: Fr[], + public readonly gasSettings: GasSettings, + public readonly transactionFee: Fr, // Function selector is temporary since eventually public contract bytecode will be one blob // containing all functions, and function selector will become an application-level mechanism @@ -67,6 +69,8 @@ export class AvmExecutionEnvironment { this.isStaticCall, this.isDelegateCall, calldata, + this.gasSettings, + this.transactionFee, temporaryFunctionSelector, ); } @@ -91,6 +95,8 @@ export class AvmExecutionEnvironment { /*isStaticCall=*/ true, this.isDelegateCall, calldata, + this.gasSettings, + this.transactionFee, temporaryFunctionSelector, ); } @@ -115,6 +121,8 @@ export class AvmExecutionEnvironment { this.isStaticCall, /*isDelegateCall=*/ true, calldata, + this.gasSettings, + this.transactionFee, temporaryFunctionSelector, ); } diff --git a/yarn-project/simulator/src/avm/avm_machine_state.ts b/yarn-project/simulator/src/avm/avm_machine_state.ts index 178ca1adcf2..4c5c58fcc6a 100644 --- a/yarn-project/simulator/src/avm/avm_machine_state.ts +++ b/yarn-project/simulator/src/avm/avm_machine_state.ts @@ -44,10 +44,20 @@ export class AvmMachineState { /** Output data must NOT be modified once it is set */ private output: Fr[] = []; - constructor(l1GasLeft: number, l2GasLeft: number, daGasLeft: number) { - this.l1GasLeft = l1GasLeft; - this.l2GasLeft = l2GasLeft; - this.daGasLeft = daGasLeft; + constructor(gasLeft: Gas); + constructor(l1GasLeft: number, l2GasLeft: number, daGasLeft: number); + constructor(gasLeftOrL1GasLeft: Gas | number, l2GasLeft?: number, daGasLeft?: number) { + if (typeof gasLeftOrL1GasLeft === 'object') { + ({ l1Gas: this.l1GasLeft, l2Gas: this.l2GasLeft, daGas: this.daGasLeft } = gasLeftOrL1GasLeft); + } else { + this.l1GasLeft = gasLeftOrL1GasLeft; + this.l2GasLeft = l2GasLeft!; + this.daGasLeft = daGasLeft!; + } + } + + public get gasLeft(): Gas { + return { l1Gas: this.l1GasLeft, l2Gas: this.l2GasLeft, daGas: this.daGasLeft }; } public static fromState(state: InitialAvmMachineState): AvmMachineState { diff --git a/yarn-project/simulator/src/avm/fixtures/index.ts b/yarn-project/simulator/src/avm/fixtures/index.ts index f73e82f2fac..c3f775c484d 100644 --- a/yarn-project/simulator/src/avm/fixtures/index.ts +++ b/yarn-project/simulator/src/avm/fixtures/index.ts @@ -1,5 +1,5 @@ import { SiblingPath } from '@aztec/circuit-types'; -import { GasFees, GlobalVariables, Header, L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/circuits.js'; +import { GasFees, GasSettings, GlobalVariables, Header, L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/circuits.js'; import { FunctionSelector } from '@aztec/foundation/abi'; import { AztecAddress } from '@aztec/foundation/aztec-address'; import { EthAddress } from '@aztec/foundation/eth-address'; @@ -73,6 +73,8 @@ export function initExecutionEnvironment(overrides?: Partial { it('Should refuse to execute a call if not enough gas', async () => { const gasOffset = 0; - const l1Gas = 1e12; // We request more gas than what we have + const l1Gas = 1e9; // We request more gas than what we have const l2Gas = 2e6; const daGas = 3e6; const addrOffset = 3; diff --git a/yarn-project/simulator/src/client/client_execution_context.ts b/yarn-project/simulator/src/client/client_execution_context.ts index 522966631ad..56141cf9c7e 100644 --- a/yarn-project/simulator/src/client/client_execution_context.ts +++ b/yarn-project/simulator/src/client/client_execution_context.ts @@ -14,7 +14,6 @@ import { CallContext, FunctionData, FunctionSelector, - GasSettings, type Header, NoteHashReadRequestMembershipWitness, PublicCallRequest, @@ -484,17 +483,17 @@ export class ClientExecutionContext extends ViewDataOracle { isStaticCall = false, ) { const portalContractAddress = await this.db.getPortalContractAddress(targetContractAddress); - const transactionFee = Fr.ZERO; // TODO(palla/gas-in-circuits) return new CallContext( isDelegateCall ? this.callContext.msgSender : this.contractAddress, isDelegateCall ? this.contractAddress : targetContractAddress, portalContractAddress, FunctionSelector.fromNameAndParameters(targetArtifact.name, targetArtifact.parameters), + this.callContext.gasLeft, // TODO(palla/gas): We should deduct DA and L1 gas used for the derived context isDelegateCall, isStaticCall, startSideEffectCounter, - GasSettings.empty(), // TODO(palla/gas-in-circuits) - transactionFee, + this.callContext.gasSettings, + this.callContext.transactionFee, ); } diff --git a/yarn-project/simulator/src/client/private_execution.test.ts b/yarn-project/simulator/src/client/private_execution.test.ts index df4257032b7..b3bdc01968b 100644 --- a/yarn-project/simulator/src/client/private_execution.test.ts +++ b/yarn-project/simulator/src/client/private_execution.test.ts @@ -116,6 +116,7 @@ describe('Private Execution test suite', () => { txContext: TxContext.from({ ...txContextFields, ...txContext }), packedArguments: [packedArguments], authWitnesses: [], + gasSettings: GasSettings.default(), }); return acirSimulator.run(txRequest, artifact, contractAddress, portalContractAddress, msgSender); @@ -796,7 +797,8 @@ describe('Private Execution test suite', () => { const functionData = FunctionData.fromAbi(childContractArtifact); const transactionFee = new Fr(0); - const gasSettings = GasSettings.empty(); + const gasSettings = GasSettings.default(); + const gasLeft = gasSettings.getInitialAvailable(); const publicCallRequest = PublicCallRequest.from({ contractAddress: childAddress, @@ -807,6 +809,7 @@ describe('Private Execution test suite', () => { storageContractAddress: childAddress, portalContractAddress: childPortalContractAddress, functionSelector: childSelector, + gasLeft, isDelegateCall: false, isStaticCall: false, sideEffectCounter: 1, @@ -818,6 +821,7 @@ describe('Private Execution test suite', () => { storageContractAddress: parentAddress, portalContractAddress: EthAddress.ZERO, functionSelector: FunctionSelector.fromNameAndParameters(parentArtifact.name, parentArtifact.parameters), + gasLeft, isDelegateCall: false, isStaticCall: false, sideEffectCounter: 1, @@ -995,7 +999,7 @@ describe('Private Execution test suite', () => { const artifact = getFunctionArtifact(PendingNoteHashesContractArtifact, 'test_bad_get_then_insert_flat'); const args = [amountToTransfer, owner]; - await expect( + await expect(() => runSimulator({ args: args, artifact: artifact, @@ -1029,7 +1033,9 @@ describe('Private Execution test suite', () => { const args = [2n, true]; oracle.getNotes.mockResolvedValue([]); - await expect(runSimulator({ artifact, args })).rejects.toThrow(`Assertion failed: Cannot return zero notes`); + await expect(() => runSimulator({ artifact, args })).rejects.toThrow( + `Assertion failed: Cannot return zero notes`, + ); }); }); @@ -1081,7 +1087,7 @@ describe('Private Execution test suite', () => { let args: any[]; let artifact: FunctionArtifact; - beforeAll(() => { + beforeEach(() => { chainId = Fr.random(); version = Fr.random(); args = [chainId, version]; @@ -1090,15 +1096,15 @@ describe('Private Execution test suite', () => { oracle.getFunctionArtifact.mockImplementation(() => Promise.resolve(artifact)); }); - it('Private global vars are correctly set', () => { + it('Private global vars are correctly set', async () => { // Chain id and version set in tx context is the same as the ones we pass via args so this should not throw - expect(() => runSimulator({ artifact, msgSender: owner, args, txContext: { chainId, version } })).not.toThrow(); + await runSimulator({ artifact, msgSender: owner, args, txContext: { chainId, version } }); }); it('Throws when chainId is incorrectly set', async () => { // We set the chainId in the tx context to a different value than the one we pass via args so the simulator should throw const unexpectedChainId = Fr.random(); - await expect( + await expect(() => runSimulator({ artifact, msgSender: owner, args, txContext: { chainId: unexpectedChainId, version } }), ).rejects.toThrow('Invalid chain id'); }); @@ -1106,7 +1112,7 @@ describe('Private Execution test suite', () => { it('Throws when version is incorrectly set', async () => { // We set the version in the tx context to a different value than the one we pass via args so the simulator should throw const unexpectedVersion = Fr.random(); - await expect( + await expect(() => runSimulator({ artifact, msgSender: owner, args, txContext: { chainId, version: unexpectedVersion } }), ).rejects.toThrow('Invalid version'); }); @@ -1115,7 +1121,7 @@ describe('Private Execution test suite', () => { describe('Historical header in private context', () => { let artifact: FunctionArtifact; - beforeAll(() => { + beforeEach(() => { artifact = getFunctionArtifact(TestContractArtifact, 'assert_header_private'); oracle.getFunctionArtifact.mockImplementation(() => Promise.resolve(artifact)); @@ -1125,17 +1131,17 @@ describe('Private Execution test suite', () => { oracle.getHeader.mockResolvedValue(header); }); - it('Header is correctly set', () => { + it('Header is correctly set', async () => { const args = [header.hash()]; - expect(() => runSimulator({ artifact, msgSender: owner, args })).not.toThrow(); + await runSimulator({ artifact, msgSender: owner, args }); }); it('Throws when header is not as expected', async () => { const unexpectedHeaderHash = Fr.random(); const args = [unexpectedHeaderHash]; - await expect(runSimulator({ artifact, msgSender: owner, args })).rejects.toThrow('Invalid header hash'); + await expect(() => runSimulator({ artifact, msgSender: owner, args })).rejects.toThrow('Invalid header hash'); }); }); }); diff --git a/yarn-project/simulator/src/client/simulator.ts b/yarn-project/simulator/src/client/simulator.ts index 64c963cff81..25bd77e8688 100644 --- a/yarn-project/simulator/src/client/simulator.ts +++ b/yarn-project/simulator/src/client/simulator.ts @@ -1,5 +1,5 @@ import { type AztecNode, type FunctionCall, type Note, type TxExecutionRequest } from '@aztec/circuit-types'; -import { CallContext, FunctionData, GasSettings } from '@aztec/circuits.js'; +import { CallContext, FunctionData } from '@aztec/circuits.js'; import { Grumpkin } from '@aztec/circuits.js/barretenberg'; import { type ArrayType, @@ -89,16 +89,17 @@ export class AcirSimulator { // reserve the first side effect for the tx hash (inserted by the private kernel) const startSideEffectCounter = 1; - const transactionFee = Fr.ZERO; // TODO(palla/gas-in-circuits) + const transactionFee = Fr.ZERO; const callContext = new CallContext( msgSender, contractAddress, portalContractAddress, FunctionSelector.fromNameAndParameters(entryPointArtifact.name, entryPointArtifact.parameters), + request.gasSettings.getInitialAvailable(), false, false, startSideEffectCounter, - GasSettings.empty(), // TODO(palla/gas-in-circuits) + request.gasSettings, transactionFee, ); const context = new ClientExecutionContext( diff --git a/yarn-project/simulator/src/mocks/fixtures.ts b/yarn-project/simulator/src/mocks/fixtures.ts index cdcfba83666..df43be16805 100644 --- a/yarn-project/simulator/src/mocks/fixtures.ts +++ b/yarn-project/simulator/src/mocks/fixtures.ts @@ -8,6 +8,7 @@ import { EthAddress, Fr, FunctionData, + Gas, GasSettings, MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, type PrivateKernelTailCircuitPublicInputs, @@ -71,10 +72,11 @@ export class PublicExecutionResultBuilder { tx.to, EthAddress.ZERO, tx.functionData.selector, + Gas.test(), false, false, 0, - GasSettings.empty(), + GasSettings.default(), Fr.ZERO, ), contractAddress: tx.to, @@ -130,6 +132,7 @@ export class PublicExecutionResultBuilder { endSideEffectCounter: Fr.ZERO, reverted: this._reverted, revertReason: this._revertReason, + gasLeft: this._execution.callContext.gasLeft.mul(0.9), }; } } diff --git a/yarn-project/simulator/src/public/abstract_phase_manager.ts b/yarn-project/simulator/src/public/abstract_phase_manager.ts index 092adbbc620..1ccbf3669cc 100644 --- a/yarn-project/simulator/src/public/abstract_phase_manager.ts +++ b/yarn-project/simulator/src/public/abstract_phase_manager.ts @@ -11,6 +11,7 @@ import { ContractStorageRead, ContractStorageUpdateRequest, Fr, + Gas, type GlobalVariables, type Header, type KernelCircuitPublicInputs, @@ -413,6 +414,7 @@ export abstract class AbstractPhaseManager { historicalHeader: this.historicalHeader, // TODO(@just-mitch): need better mapping from simulator to revert code. revertCode: result.reverted ? RevertCode.REVERTED : RevertCode.OK, + gasLeft: Gas.from(result.gasLeft), }); } diff --git a/yarn-project/simulator/src/public/avm_executor.test.ts b/yarn-project/simulator/src/public/avm_executor.test.ts index ef274232afd..d0c0fc234dc 100644 --- a/yarn-project/simulator/src/public/avm_executor.test.ts +++ b/yarn-project/simulator/src/public/avm_executor.test.ts @@ -4,6 +4,7 @@ import { EthAddress, FunctionData, FunctionSelector, + Gas, GasSettings, type Header, } from '@aztec/circuits.js'; @@ -30,6 +31,7 @@ describe('AVM WitGen and Proof Generation', () => { storageContractAddress: AztecAddress.random(), portalContractAddress: EthAddress.random(), functionSelector: FunctionSelector.empty(), + gasLeft: Gas.test(), isDelegateCall: false, isStaticCall: false, sideEffectCounter: 0, diff --git a/yarn-project/simulator/src/public/execution.ts b/yarn-project/simulator/src/public/execution.ts index 96ac9e84e97..74d33ec15c6 100644 --- a/yarn-project/simulator/src/public/execution.ts +++ b/yarn-project/simulator/src/public/execution.ts @@ -14,6 +14,8 @@ import { } from '@aztec/circuits.js'; import { computePublicDataTreeLeafSlot, computePublicDataTreeValue } from '@aztec/circuits.js/hash'; +import { type Gas } from '../avm/avm_gas.js'; + /** * The public function execution result. */ @@ -55,6 +57,8 @@ export interface PublicExecutionResult { * The revert reason if the execution reverted. */ revertReason: SimulationError | undefined; + /** How much gas was left after this public execution. */ + gasLeft: Gas; } /** diff --git a/yarn-project/simulator/src/public/executor.ts b/yarn-project/simulator/src/public/executor.ts index c805b4496a8..0acbc9d8be0 100644 --- a/yarn-project/simulator/src/public/executor.ts +++ b/yarn-project/simulator/src/public/executor.ts @@ -1,5 +1,5 @@ import { UnencryptedFunctionL2Logs } from '@aztec/circuit-types'; -import { Fr, type GlobalVariables, type Header, PublicCircuitPublicInputs } from '@aztec/circuits.js'; +import { Fr, Gas, type GlobalVariables, type Header, PublicCircuitPublicInputs } from '@aztec/circuits.js'; import { createDebugLogger } from '@aztec/foundation/log'; import { spawn } from 'child_process'; @@ -66,9 +66,7 @@ async function executePublicFunctionAvm(executionContext: PublicExecutionContext executionContext.globalVariables, ); - // TODO(@spalladino) Load initial gas from the public execution request - const machineState = new AvmMachineState(1e7, 1e7, 1e7); - + const machineState = new AvmMachineState(executionContext.execution.callContext.gasLeft); const context = new AvmContext(worldStateJournal, executionEnv, machineState); const simulator = new AvmSimulator(context); @@ -79,8 +77,7 @@ async function executePublicFunctionAvm(executionContext: PublicExecutionContext `[AVM] ${address.toString()}:${selector} returned, reverted: ${result.reverted}, reason: ${result.revertReason}.`, ); - // TODO(@spalladino) Read gas left from machineState and return it - return await convertAvmResults(executionContext, newWorldState, result); + return await convertAvmResults(executionContext, newWorldState, result, machineState); } async function executePublicFunctionAcvm( @@ -154,6 +151,7 @@ async function executePublicFunctionAcvm( unencryptedLogs: UnencryptedFunctionL2Logs.empty(), reverted, revertReason, + gasLeft: Gas.empty(), }; } @@ -195,6 +193,7 @@ async function executePublicFunctionAcvm( const nestedExecutions = context.getNestedExecutions(); const unencryptedLogs = context.getUnencryptedLogs(); + const gasLeft = context.execution.callContext.gasLeft; // No gas metering for ACVM return { execution, @@ -212,6 +211,7 @@ async function executePublicFunctionAcvm( unencryptedLogs, reverted: false, revertReason: undefined, + gasLeft, }; } diff --git a/yarn-project/simulator/src/public/index.test.ts b/yarn-project/simulator/src/public/index.test.ts index d309a73f5e6..5f97336dcbf 100644 --- a/yarn-project/simulator/src/public/index.test.ts +++ b/yarn-project/simulator/src/public/index.test.ts @@ -3,6 +3,7 @@ import { AppendOnlyTreeSnapshot, CallContext, FunctionData, + Gas, GasFees, GasSettings, GlobalVariables, @@ -47,6 +48,9 @@ describe('ACIR public execution simulator', () => { let executor: PublicExecutor; let header: Header; + const gasLeft = new Gas(1e9, 1e9, 1e9); + const globalVariables = GlobalVariables.empty(); + beforeEach(() => { publicState = mock(); publicContracts = mock(); @@ -89,6 +93,7 @@ describe('ACIR public execution simulator', () => { CallContext.from({ storageContractAddress, msgSender: AztecAddress.random(), + gasLeft, portalContractAddress: EthAddress.random(), functionSelector: FunctionSelector.empty(), isDelegateCall: false, @@ -132,7 +137,8 @@ describe('ACIR public execution simulator', () => { .mockResolvedValueOnce(previousTotalSupply); // reading total supply const execution: PublicExecution = { contractAddress, functionData, args, callContext }; - const result = await executor.simulate(execution, GlobalVariables.empty()); + const result = await executor.simulate(execution, globalVariables); + expect(result.revertReason).toBeUndefined(); const recipientBalanceStorageSlot = computeSlotForMapping(new Fr(6n), recipient); const totalSupplyStorageSlot = new Fr(4n); @@ -210,7 +216,7 @@ describe('ACIR public execution simulator', () => { const recipientBalance = new Fr(20n); mockStore(senderBalance, recipientBalance); - const result = await executor.simulate(execution, GlobalVariables.empty()); + const result = await executor.simulate(execution, globalVariables); const expectedRecipientBalance = new Fr(160n); const expectedSenderBalance = new Fr(60n); @@ -236,7 +242,7 @@ describe('ACIR public execution simulator', () => { const recipientBalance = new Fr(20n); mockStore(senderBalance, recipientBalance); - const { reverted, revertReason } = await executor.simulate(execution, GlobalVariables.empty()); + const { reverted, revertReason } = await executor.simulate(execution, globalVariables); expect(reverted).toBe(true); expect(revertReason?.message).toMatch('Assertion failed: attempt to subtract with underflow'); }); @@ -325,7 +331,7 @@ describe('ACIR public execution simulator', () => { publicState.storageRead.mockResolvedValue(amount); const execution: PublicExecution = { contractAddress, functionData, args, callContext }; - const result = await executor.simulate(execution, GlobalVariables.empty()); + const result = await executor.simulate(execution, globalVariables); // Assert the note hash was created expect(result.newNoteHashes.length).toEqual(1); @@ -349,7 +355,7 @@ describe('ACIR public execution simulator', () => { publicContracts.getBytecode.mockResolvedValue(createL2ToL1MessagePublicArtifact.bytecode); const execution: PublicExecution = { contractAddress, functionData, args, callContext }; - const result = await executor.simulate(execution, GlobalVariables.empty()); + const result = await executor.simulate(execution, globalVariables); // Assert the l2 to l1 message was created expect(result.newL2ToL1Messages.length).toEqual(1); @@ -371,7 +377,7 @@ describe('ACIR public execution simulator', () => { publicContracts.getBytecode.mockResolvedValue(createNullifierPublicArtifact.bytecode); const execution: PublicExecution = { contractAddress, functionData, args, callContext }; - const result = await executor.simulate(execution, GlobalVariables.empty()); + const result = await executor.simulate(execution, globalVariables); // Assert the l2 to l1 message was created expect(result.newNullifiers.length).toEqual(1); @@ -702,7 +708,7 @@ describe('ACIR public execution simulator', () => { const execution: PublicExecution = { contractAddress, functionData, args, callContext }; executor = new PublicExecutor(publicState, publicContracts, commitmentsDb, header); - expect(() => executor.simulate(execution, GlobalVariables.empty())).not.toThrow(); + expect(() => executor.simulate(execution, globalVariables)).not.toThrow(); }); it('Throws when header is not as expected', async () => { @@ -712,7 +718,7 @@ describe('ACIR public execution simulator', () => { const execution: PublicExecution = { contractAddress, functionData, args, callContext }; executor = new PublicExecutor(publicState, publicContracts, commitmentsDb, header); - const { revertReason, reverted } = await executor.simulate(execution, GlobalVariables.empty()); + const { revertReason, reverted } = await executor.simulate(execution, globalVariables); expect(reverted).toBe(true); expect(revertReason?.message).toMatch(`Invalid header hash`); }); diff --git a/yarn-project/simulator/src/public/public_execution_context.ts b/yarn-project/simulator/src/public/public_execution_context.ts index 20e41a12db6..bd37f1547ae 100644 --- a/yarn-project/simulator/src/public/public_execution_context.ts +++ b/yarn-project/simulator/src/public/public_execution_context.ts @@ -3,7 +3,6 @@ import { CallContext, FunctionData, type FunctionSelector, - GasSettings, type GlobalVariables, type Header, } from '@aztec/circuits.js'; @@ -206,16 +205,18 @@ export class PublicExecutionContext extends TypedOracle { const portalAddress = (await this.contractsDb.getPortalContractAddress(targetContractAddress)) ?? EthAddress.ZERO; const functionData = new FunctionData(functionSelector, /*isPrivate=*/ false); + const { transactionFee, gasSettings, gasLeft } = this.execution.callContext; const callContext = CallContext.from({ msgSender: isDelegateCall ? this.execution.callContext.msgSender : this.execution.contractAddress, storageContractAddress: isDelegateCall ? this.execution.contractAddress : targetContractAddress, portalContractAddress: portalAddress, functionSelector, + gasLeft, // Propagate the same gas left as when we started since ACVM public functions don't have any metering isDelegateCall, isStaticCall, sideEffectCounter, - transactionFee: Fr.ZERO, // TODO(palla/gas-in-circuits) - gasSettings: GasSettings.empty(), // TODO(palla/gas-in-circuits) + gasSettings, + transactionFee, }); const nestedExecution: PublicExecution = { diff --git a/yarn-project/simulator/src/public/public_processor.test.ts b/yarn-project/simulator/src/public/public_processor.test.ts index 2904b08319e..4d540b0a890 100644 --- a/yarn-project/simulator/src/public/public_processor.test.ts +++ b/yarn-project/simulator/src/public/public_processor.test.ts @@ -181,9 +181,9 @@ describe('public_processor', () => { const [processed, failed] = await processor.process([tx], 1, prover); + expect(failed.map(f => f.error)).toEqual([]); expect(processed).toHaveLength(1); expect(processed).toEqual([expectedTxByHash(tx)]); - expect(failed).toHaveLength(0); expect(publicExecutor.simulate).toHaveBeenCalledTimes(2); expect(publicWorldStateDB.commit).toHaveBeenCalledTimes(1); expect(publicWorldStateDB.rollbackToCommit).toHaveBeenCalledTimes(0); diff --git a/yarn-project/simulator/src/public/transitional_adaptors.ts b/yarn-project/simulator/src/public/transitional_adaptors.ts index 567852b124e..00519f933a6 100644 --- a/yarn-project/simulator/src/public/transitional_adaptors.ts +++ b/yarn-project/simulator/src/public/transitional_adaptors.ts @@ -5,7 +5,7 @@ import { ContractStorageRead, ContractStorageUpdateRequest, FunctionData, - GasSettings, + Gas, type GlobalVariables, type Header, L2ToL1Message, @@ -17,6 +17,7 @@ import { Fr } from '@aztec/foundation/fields'; import { type AvmContext } from '../avm/avm_context.js'; import { AvmExecutionEnvironment } from '../avm/avm_execution_environment.js'; +import { type AvmMachineState } from '../avm/avm_machine_state.js'; import { AvmContractCallResults } from '../avm/avm_message_call_result.js'; import { type JournalData } from '../avm/journal/journal.js'; import { Mov } from '../avm/opcodes/memory.js'; @@ -43,15 +44,17 @@ export function createAvmExecutionEnvironment( current.callContext.msgSender, // TODO: origin is not available current.callContext.msgSender, current.callContext.portalContractAddress, - /*feePerL1Gas=*/ Fr.zero(), - /*feePerL2Gas=*/ Fr.zero(), - /*feePerDaGas=*/ Fr.zero(), + globalVariables.gasFees.feePerL1Gas, + globalVariables.gasFees.feePerL2Gas, + globalVariables.gasFees.feePerDaGas, /*contractCallDepth=*/ Fr.zero(), header, globalVariables, current.callContext.isStaticCall, current.callContext.isDelegateCall, current.args, + current.callContext.gasSettings, + current.callContext.transactionFee, current.functionData.selector, ); } @@ -63,11 +66,12 @@ export function createPublicExecutionContext(avmContext: AvmContext, calldata: F storageContractAddress: avmContext.environment.storageAddress, portalContractAddress: avmContext.environment.portal, functionSelector: avmContext.environment.temporaryFunctionSelector, + gasLeft: Gas.from(avmContext.machineState.gasLeft), isDelegateCall: avmContext.environment.isDelegateCall, isStaticCall: avmContext.environment.isStaticCall, sideEffectCounter: sideEffectCounter, - gasSettings: GasSettings.empty(), // TODO(palla/gas-in-circuits) - transactionFee: Fr.ZERO, // TODO(palla/gas-in-circuits) + gasSettings: avmContext.environment.gasSettings, + transactionFee: avmContext.environment.transactionFee, }); const functionData = new FunctionData(avmContext.environment.temporaryFunctionSelector, /*isPrivate=*/ false); const execution: PublicExecution = { @@ -104,6 +108,7 @@ export async function convertAvmResults( executionContext: PublicExecutionContext, newWorldState: JournalData, result: AvmContractCallResults, + endMachineState: AvmMachineState, ): Promise { const execution = executionContext.execution; @@ -165,6 +170,7 @@ export async function convertAvmResults( unencryptedLogs, reverted: result.reverted, revertReason: result.revertReason ? createSimulationError(result.revertReason) : undefined, + gasLeft: endMachineState.gasLeft, }; } diff --git a/yarn-project/simulator/src/simulator/acvm_wasm.ts b/yarn-project/simulator/src/simulator/acvm_wasm.ts index 16e83ddda1b..d7883842778 100644 --- a/yarn-project/simulator/src/simulator/acvm_wasm.ts +++ b/yarn-project/simulator/src/simulator/acvm_wasm.ts @@ -1,3 +1,4 @@ +import { foreignCallHandler } from '@aztec/noir-protocol-circuits-types'; import { type NoirCompiledCircuit } from '@aztec/types/noir'; import { @@ -26,9 +27,12 @@ export class WASMSimulator implements SimulationProvider { const decodedBytecode = Buffer.from(compiledCircuit.bytecode, 'base64'); // // Execute the circuit - const _witnessMap = await executeCircuitWithBlackBoxSolver(await getSolver(), decodedBytecode, input, () => { - throw Error('unexpected oracle during execution'); - }); + const _witnessMap = await executeCircuitWithBlackBoxSolver( + await getSolver(), + decodedBytecode, + input, + foreignCallHandler, // handle calls to debug_log + ); return _witnessMap; } From a3ac5ff251270f7a14d56e9b7846655dce716a44 Mon Sep 17 00:00:00 2001 From: Santiago Palladino Date: Tue, 16 Apr 2024 09:28:24 -0300 Subject: [PATCH 21/56] chore: Temporarily skip failing e2e fees test --- yarn-project/end-to-end/src/e2e_fees.test.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/yarn-project/end-to-end/src/e2e_fees.test.ts b/yarn-project/end-to-end/src/e2e_fees.test.ts index 2c196ef9396..8db6d025114 100644 --- a/yarn-project/end-to-end/src/e2e_fees.test.ts +++ b/yarn-project/end-to-end/src/e2e_fees.test.ts @@ -193,7 +193,7 @@ describe('e2e_fees', () => { // Can't do presently because all logs are "revertible" so we lose notes that get broadcasted during unshielding. }); - describe('private fees payments', () => { + describe.skip('private fees payments', () => { let InitialAlicePrivateBananas: bigint; let InitialAlicePublicBananas: bigint; let InitialAliceGas: bigint; From 2cf11ac76805b8d648a4b32d7cd6446eb31b9a35 Mon Sep 17 00:00:00 2001 From: Facundo Date: Tue, 16 Apr 2024 13:55:42 +0100 Subject: [PATCH 22/56] feat(avm-simulator): plumb noir assertion messages (#5774) Enable recovering Noir assertion messages in the avm simulator. We had discussed propagating (re-throwing) nested call assertions to callers, to match the current Public behaviour, but I'm not doing it here so that I don't clash with David's work on nested calls. Moreover, the behaviour of reverting if a nested call reverts is currently happening (see `call_public` in AvmContext in noir). The only difference is really that the messsage propagated is different: in current public you get the assertion message from the nested call (I think but I should double check) and in the AVM simulator you'd get "Nested (static) call failed!". We can discuss if we want to change this. --- .../contracts/avm_test_contract/src/main.nr | 8 +++++--- .../simulator/src/avm/avm_machine_state.ts | 13 ++++++++++++- .../simulator/src/avm/avm_simulator.test.ts | 16 ++++++++++++++-- .../src/avm/opcodes/external_calls.test.ts | 9 ++++----- 4 files changed, 35 insertions(+), 11 deletions(-) diff --git a/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr index 918ee1abb27..2989e32a9f6 100644 --- a/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr @@ -185,7 +185,7 @@ contract AvmTest { #[aztec(public-vm)] fn test_get_contract_instance() { let ci = get_contract_instance_avm(context.this_address()); - assert(ci.is_some()); + assert(ci.is_some(), "Contract instance not found!"); } /************************************************************************ @@ -258,7 +258,9 @@ contract AvmTest { #[aztec(public-vm)] fn check_selector() { - assert(context.selector() == FunctionSelector::from_signature("check_selector()")); + assert( + context.selector() == FunctionSelector::from_signature("check_selector()"), "Unexpected selector!" + ); } #[aztec(public-vm)] @@ -299,7 +301,7 @@ contract AvmTest { #[aztec(public-vm)] fn assert_nullifier_exists(nullifier: Field) { - assert(context.nullifier_exists(nullifier, context.this_address())); + assert(context.nullifier_exists(nullifier, context.this_address()), "Nullifier doesn't exist!"); } // Use the standard context interface to emit a new nullifier diff --git a/yarn-project/simulator/src/avm/avm_machine_state.ts b/yarn-project/simulator/src/avm/avm_machine_state.ts index 4c5c58fcc6a..8ebfa6b1e47 100644 --- a/yarn-project/simulator/src/avm/avm_machine_state.ts +++ b/yarn-project/simulator/src/avm/avm_machine_state.ts @@ -138,6 +138,17 @@ export class AvmMachineState { if (!this.halted) { throw new Error('Execution results are not ready! Execution is ongoing.'); } - return new AvmContractCallResults(this.reverted, this.output); + let revertReason = undefined; + if (this.reverted && this.output.length > 0) { + try { + // Try to interpret the output as a text string. + revertReason = new Error( + 'Reverted with output: ' + String.fromCharCode(...this.output.map(fr => fr.toNumber())), + ); + } catch (e) { + revertReason = new Error('Reverted with non-string output'); + } + } + return new AvmContractCallResults(this.reverted, this.output, revertReason); } } diff --git a/yarn-project/simulator/src/avm/avm_simulator.test.ts b/yarn-project/simulator/src/avm/avm_simulator.test.ts index d6026089f1c..58d451ab0b6 100644 --- a/yarn-project/simulator/src/avm/avm_simulator.test.ts +++ b/yarn-project/simulator/src/avm/avm_simulator.test.ts @@ -106,6 +106,18 @@ describe('AVM simulator: transpiled Noir contracts', () => { expect(results.output).toEqual([new Fr(4), new Fr(6)]); }); + it('Assertion message', async () => { + const calldata: Fr[] = [new Fr(20)]; + const context = initContext({ env: initExecutionEnvironment({ calldata }) }); + + const bytecode = getAvmTestContractBytecode('assert_nullifier_exists'); + const results = await new AvmSimulator(context).executeBytecode(bytecode); + + expect(results.reverted).toBe(true); + expect(results.revertReason?.message).toEqual("Reverted with output: Nullifier doesn't exist!"); + expect(results.output).toEqual([..."Nullifier doesn't exist!"].flatMap(c => new Fr(c.charCodeAt(0)))); + }); + describe.each([ ['set_opcode_u8', 8n], ['set_opcode_u32', 1n << 30n], @@ -454,6 +466,7 @@ describe('AVM simulator: transpiled Noir contracts', () => { const results = await new AvmSimulator(context).executeBytecode(bytecode); expect(results.reverted).toBe(true); + expect(results.revertReason?.message).toMatch(/Attempted to emit duplicate nullifier/); // Only the first nullifier should be in the trace, second one failed to add expect(context.persistableState.flush().newNullifiers).toEqual([ expect.objectContaining({ @@ -899,8 +912,7 @@ describe('AVM simulator: transpiled Noir contracts', () => { const results = await new AvmSimulator(context).executeBytecode(callBytecode); expect(results.reverted).toBe(true); // The outer call should revert. - // TODO(fcarreiro): revertReason lost in translation between results. - // expect(results.revertReason).toEqual(/StaticCallStorageAlterError/); + expect(results.revertReason?.message).toMatch(/Nested static call failed/); }); }); }); diff --git a/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts b/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts index e4dde5c335a..c9acf97b61e 100644 --- a/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts +++ b/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts @@ -304,11 +304,9 @@ describe('External Calls', () => { }); it('Should return data and revert from the revert opcode', async () => { - const returnData = [new Fr(1n), new Fr(2n), new Fr(3n)]; + const returnData = [...'assert message'].flatMap(c => new Field(c.charCodeAt(0))); - context.machineState.memory.set(0, new Field(1n)); - context.machineState.memory.set(1, new Field(2n)); - context.machineState.memory.set(2, new Field(3n)); + context.machineState.memory.setSlice(0, returnData); const instruction = new Revert(/*indirect=*/ 0, /*returnOffset=*/ 0, returnData.length); await instruction.execute(context); @@ -316,7 +314,8 @@ describe('External Calls', () => { expect(context.machineState.halted).toBe(true); expect(context.machineState.getResults()).toEqual({ reverted: true, - output: returnData, + revertReason: new Error('Reverted with output: assert message'), + output: returnData.map(f => f.toFr()), }); }); }); From d85267b7f1c34bf93087f3a48690ddfd8a9cf05d Mon Sep 17 00:00:00 2001 From: spypsy Date: Tue, 16 Apr 2024 14:01:33 +0100 Subject: [PATCH 23/56] fix(ci): wait_for_fork env var (#5780) --- iac/mainnet-fork/scripts/wait_for_fork | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/iac/mainnet-fork/scripts/wait_for_fork b/iac/mainnet-fork/scripts/wait_for_fork index ddafc00cc2e..7bd317fd28b 100755 --- a/iac/mainnet-fork/scripts/wait_for_fork +++ b/iac/mainnet-fork/scripts/wait_for_fork @@ -6,7 +6,7 @@ set -e # This script waits on a healthy status from the fork - a valid response to the chainid request # We retry every 20 seconds, and wait for a total of 5 minutes (15 times) -export ETHEREUM_HOST="https://$DEPLOY_TAG-mainnet-fork.aztec.network:8545/$API_KEY" +export ETHEREUM_HOST="https://$DEPLOY_TAG-mainnet-fork.aztec.network:8545/$FORK_API_KEY" curl -H "Content-Type: application/json" -X POST --data '{"method":"eth_chainId","params":[],"id":33,"jsonrpc":"2.0"}' \ --connect-timeout 30 \ From bcfee97da99c654f8641ab8099bbbe5d58e2a5c7 Mon Sep 17 00:00:00 2001 From: ludamad Date: Tue, 16 Apr 2024 10:02:12 -0400 Subject: [PATCH 24/56] fix: "feat: Changing finite field arithmetic in wasm to 29 bits for multiplications" (#5779) This caused a +10 minutes in WASM compilation seemingly, will investigate --- .../cpp/scripts/benchmark_wasm_remote.sh | 2 +- .../scripts/benchmark_wasm_remote_wasmer.sh | 30 - .../benchmark/basics_bench/basics.bench.cpp | 61 -- .../src/barretenberg/ecc/curves/bn254/fq.hpp | 43 - .../barretenberg/ecc/curves/bn254/fq.test.cpp | 26 +- .../barretenberg/ecc/curves/bn254/fq12.hpp | 18 - .../ecc/curves/bn254/fq12.test.cpp | 202 +---- .../src/barretenberg/ecc/curves/bn254/fq2.hpp | 27 - .../ecc/curves/bn254/fq2.test.cpp | 39 - .../src/barretenberg/ecc/curves/bn254/fq6.hpp | 32 - .../ecc/curves/bn254/fq6.test.cpp | 40 - .../src/barretenberg/ecc/curves/bn254/fr.hpp | 43 - .../barretenberg/ecc/curves/bn254/fr.test.cpp | 14 +- .../src/barretenberg/ecc/curves/bn254/g1.hpp | 8 - .../src/barretenberg/ecc/curves/bn254/g2.hpp | 11 - .../ecc/curves/grumpkin/grumpkin.hpp | 12 +- .../ecc/curves/secp256k1/secp256k1.hpp | 84 -- .../ecc/curves/secp256k1/secp256k1.test.cpp | 9 +- .../ecc/curves/secp256r1/secp256r1.hpp | 86 +- .../ecc/curves/secp256r1/secp256r1.test.cpp | 8 +- .../ecc/fields/field_declarations.hpp | 84 -- .../src/barretenberg/ecc/fields/field_docs.md | 190 ----- .../barretenberg/ecc/fields/field_impl.hpp | 11 +- .../ecc/fields/field_impl_generic.hpp | 791 ++++++++---------- .../barretenberg/numeric/uint256/uint256.hpp | 19 - .../numeric/uint256/uint256_impl.hpp | 210 ----- .../barretenberg/polynomials/univariate.hpp | 20 - .../relations/auxiliary_relation.hpp | 4 +- .../delta_range_constraint_relation.hpp | 25 +- .../relations/ecc_op_queue_relation.hpp | 27 +- .../relations/ecc_vm/ecc_msm_relation.cpp | 4 +- .../ecc_vm/ecc_point_table_relation.cpp | 6 +- .../ecc_vm/ecc_transcript_relation.cpp | 20 +- .../relations/ecc_vm/ecc_wnaf_relation.cpp | 2 +- .../relations/elliptic_relation.hpp | 4 +- .../relations/poseidon2_external_relation.hpp | 16 +- .../relations/poseidon2_internal_relation.hpp | 4 +- 37 files changed, 419 insertions(+), 1813 deletions(-) delete mode 100755 barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh delete mode 100644 barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md diff --git a/barretenberg/cpp/scripts/benchmark_wasm_remote.sh b/barretenberg/cpp/scripts/benchmark_wasm_remote.sh index bdd91606db5..62213556579 100755 --- a/barretenberg/cpp/scripts/benchmark_wasm_remote.sh +++ b/barretenberg/cpp/scripts/benchmark_wasm_remote.sh @@ -16,7 +16,7 @@ cd $(dirname $0)/.. # Configure and build. cmake --preset wasm-threads -cmake --build --preset wasm-threads --parallel --target $BENCHMARK +cmake --build --preset wasm-threads --target $BENCHMARK source scripts/_benchmark_remote_lock.sh diff --git a/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh b/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh deleted file mode 100755 index 8df56fe2593..00000000000 --- a/barretenberg/cpp/scripts/benchmark_wasm_remote_wasmer.sh +++ /dev/null @@ -1,30 +0,0 @@ -#!/usr/bin/env bash -# This script automates the process of benchmarking WASM on a remote EC2 instance. -# Prerequisites: -# 1. Define the following environment variables: -# - BB_SSH_KEY: SSH key for EC2 instance, e.g., '-i key.pem' -# - BB_SSH_INSTANCE: EC2 instance URL -# - BB_SSH_CPP_PATH: Path to barretenberg/cpp in a cloned repository on the EC2 instance -set -eu - -BENCHMARK=${1:-goblin_bench} -COMMAND=${2:-./$BENCHMARK} -HARDWARE_CONCURRENCY=${HARDWARE_CONCURRENCY:-16} - -# Move above script dir. -cd $(dirname $0)/.. - -# Configure and build. -cmake --preset wasm-threads -cmake --build --preset wasm-threads --parallel --target $BENCHMARK - -source scripts/_benchmark_remote_lock.sh - -cd build-wasm-threads -# ensure folder structure -ssh $BB_SSH_KEY $BB_SSH_INSTANCE "mkdir -p $BB_SSH_CPP_PATH/build-wasm-threads" -# copy build wasm threads -scp $BB_SSH_KEY ./bin/$BENCHMARK $BB_SSH_INSTANCE:$BB_SSH_CPP_PATH/build-wasm-threads -# run wasm benchmarking -ssh $BB_SSH_KEY $BB_SSH_INSTANCE \ - "cd $BB_SSH_CPP_PATH/build-wasm-threads ; /home/ubuntu/.wasmer/bin/wasmer run --dir=$BB_SSH_CPP_PATH --enable-threads --env HARDWARE_CONCURRENCY=$HARDWARE_CONCURRENCY $COMMAND" diff --git a/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp b/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp index 6bd76603106..03614693396 100644 --- a/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp +++ b/barretenberg/cpp/src/barretenberg/benchmark/basics_bench/basics.bench.cpp @@ -364,65 +364,6 @@ void sequential_copy(State& state) } } } - -/** - * @brief Evaluate how much uint256_t multiplication costs (in cache) - * - * @param state - */ -void uint_multiplication(State& state) -{ - numeric::RNG& engine = numeric::get_debug_randomness(); - std::vector copy_vector(2); - for (size_t j = 0; j < 2; j++) { - copy_vector.emplace_back(engine.get_random_uint256()); - copy_vector.emplace_back(engine.get_random_uint256()); - copy_vector[0] += (1 - copy_vector[0].get_bit(0)); - copy_vector[1] += (1 - copy_vector[1].get_bit(0)); - } - - for (auto _ : state) { - state.PauseTiming(); - size_t num_cycles = 1 << static_cast(state.range(0)); - state.ResumeTiming(); - for (size_t i = 0; i < num_cycles; i++) { - copy_vector[i & 1] *= copy_vector[1 - (i & 1)]; - } - } -} - -/** - * @brief Evaluate how much uint256_t extended multiplication costs (in cache) - * - * @param state - */ -void uint_extended_multiplication(State& state) -{ - numeric::RNG& engine = numeric::get_debug_randomness(); - std::vector copy_vector(2); - for (size_t j = 0; j < 2; j++) { - copy_vector.emplace_back(engine.get_random_uint256()); - copy_vector.emplace_back(engine.get_random_uint256()); - copy_vector[0] += (1 - copy_vector[0].get_bit(0)); - copy_vector[1] += (1 - copy_vector[1].get_bit(0)); - } - - for (auto _ : state) { - state.PauseTiming(); - size_t num_cycles = 1 << static_cast(state.range(0)); - state.ResumeTiming(); - for (size_t i = 0; i < num_cycles; i++) { - auto [r0, r1] = copy_vector[i & 1].mul_extended(copy_vector[1 - (i & 1)]); - state.PauseTiming(); - copy_vector[i & 1] += r0; - copy_vector[1 - (i & 1)] += r1; - copy_vector[0] += (1 - copy_vector[0].get_bit(0)); - copy_vector[1] += (1 - copy_vector[1].get_bit(0)); - state.ResumeTiming(); - } - } -} - } // namespace BENCHMARK(parallel_for_field_element_addition)->Unit(kMicrosecond)->DenseRange(0, MAX_REPETITION_LOG); @@ -439,6 +380,4 @@ BENCHMARK(projective_point_doubling)->Unit(kMicrosecond)->DenseRange(12, 22); BENCHMARK(scalar_multiplication)->Unit(kMicrosecond)->DenseRange(12, 18); BENCHMARK(cycle_waste)->Unit(kMicrosecond)->DenseRange(20, 30); BENCHMARK(sequential_copy)->Unit(kMicrosecond)->DenseRange(20, 25); -BENCHMARK(uint_multiplication)->Unit(kMicrosecond)->DenseRange(12, 27); -BENCHMARK(uint_extended_multiplication)->Unit(kMicrosecond)->DenseRange(12, 27); BENCHMARK_MAIN(); \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp index dce9f2634e9..ffda71bbd47 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.hpp @@ -24,36 +24,11 @@ class Bn254FqParams { static constexpr uint64_t cube_root_2 = 0xaa303344d4741444UL; static constexpr uint64_t cube_root_3 = 0x2c3b3f0d26594943UL; - static constexpr uint64_t modulus_wasm_0 = 0x187cfd47; - static constexpr uint64_t modulus_wasm_1 = 0x10460b6; - static constexpr uint64_t modulus_wasm_2 = 0x1c72a34f; - static constexpr uint64_t modulus_wasm_3 = 0x2d522d0; - static constexpr uint64_t modulus_wasm_4 = 0x1585d978; - static constexpr uint64_t modulus_wasm_5 = 0x2db40c0; - static constexpr uint64_t modulus_wasm_6 = 0xa6e141; - static constexpr uint64_t modulus_wasm_7 = 0xe5c2634; - static constexpr uint64_t modulus_wasm_8 = 0x30644e; - - static constexpr uint64_t r_squared_wasm_0 = 0xe1a2a074659bac10UL; - static constexpr uint64_t r_squared_wasm_1 = 0x639855865406005aUL; - static constexpr uint64_t r_squared_wasm_2 = 0xff54c5802d3e2632UL; - static constexpr uint64_t r_squared_wasm_3 = 0x2a11a68c34ea65a6UL; - - static constexpr uint64_t cube_root_wasm_0 = 0x62b1a3a46a337995UL; - static constexpr uint64_t cube_root_wasm_1 = 0xadc97d2722e2726eUL; - static constexpr uint64_t cube_root_wasm_2 = 0x64ee82ede2db85faUL; - static constexpr uint64_t cube_root_wasm_3 = 0x0c0afea1488a03bbUL; - static constexpr uint64_t primitive_root_0 = 0UL; static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; - static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; - static constexpr uint64_t endo_g1_lo = 0x7a7bd9d4391eb18d; static constexpr uint64_t endo_g1_mid = 0x4ccef014a773d2cfUL; static constexpr uint64_t endo_g1_hi = 0x0000000000000002UL; @@ -82,24 +57,6 @@ class Bn254FqParams { 0x2a1f6744ce179d8eULL, 0x3829df06681f7cbdULL, 0x463456c802275bedULL, 0x543ece899c2f3b1cULL, 0x180a96573d3d9f8ULL, 0xf8b21270ddbb927ULL, 0x1d9598e8a7e39857ULL, 0x2ba010aa41eb7786ULL, }; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0xeb8a8ec140766463ULL, 0xfded87957d76333dULL, - 0x4c710c8092f2ff5eULL, 0x9af4916ba86fcb7fULL, - 0xe9781656bdec97a0ULL, 0xfbdb0f2afaec667aULL, - 0x4a5e94161069329bULL, 0x98e2190125e5febcULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0xf2b1f20626a3da49ULL, 0x56c12d76cb13587fULL, - 0x5251d378d7f4a143ULL, 0x4de2797ae4d5ea06ULL, - 0x49731f7cf1b732c9ULL, 0xad825aed9626b0ffULL, - 0xa91300efa307f9c3ULL, 0xa4a3a6f1afe94286ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0xf905ef8d84d5fea4ULL, 0x93b7a45b84f1507eULL, - 0xe6b99ee0068dfab5ULL, 0x39bb9964882aa4ecULL, - 0x8cbd93e909c74f23ULL, 0x276f48b709e2a0fcULL, - 0x7a71433b8b7f4b33ULL, 0xcd733dc00d1bf56aULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x2958a27c02b7cd5fULL, 0x06bc8a3277c371abULL, - 0x1484c05bce00b620ULL, 0x224cf685243dfa96ULL, - 0x30152cae7a7b3f0bULL, 0x0d791464ef86e357ULL, - 0x1b414a8e45c427ccULL, 0x290980b79c016c41ULL }; - // used in msgpack schema serialization static constexpr char schema_name[] = "fq"; static constexpr bool has_high_2adicity = false; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp index 343156b5c18..e65527e6424 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq.test.cpp @@ -88,16 +88,13 @@ TEST(fq, RandomElement) TEST(fq, MulCheckAgainstConstants) { // test against some randomly generated test data - constexpr fq a = uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; - constexpr fq a_copy = - uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; - constexpr fq b = uint256_t{ 0x744fc10aec23e56aUL, 0x5dea4788a3b936a6UL, 0xa0a89f4a8af01df1UL, 0x72ae28836807df3UL }; - constexpr fq b_copy = - uint256_t{ 0x744fc10aec23e56aUL, 0x5dea4788a3b936a6UL, 0xa0a89f4a8af01df1UL, 0x72ae28836807df3UL }; - - constexpr fq const_expected = - uint256_t{ 0x6c0a789c0028fd09UL, 0xca9520d84c684efaUL, 0xcbf3f7b023a852b4UL, 0x1b2e4dac41400621UL }; + constexpr fq a{ 0x2523b6fa3956f038, 0x158aa08ecdd9ec1d, 0xf48216a4c74738d4, 0x2514cc93d6f0a1bf }; + constexpr fq a_copy{ 0x2523b6fa3956f038, 0x158aa08ecdd9ec1d, 0xf48216a4c74738d4, 0x2514cc93d6f0a1bf }; + constexpr fq b{ 0xb68aee5e4c8fc17c, 0xc5193de7f401d5e8, 0xb8777d4dde671db3, 0xe513e75c087b0bb }; + constexpr fq b_copy = { 0xb68aee5e4c8fc17c, 0xc5193de7f401d5e8, 0xb8777d4dde671db3, 0xe513e75c087b0bb }; + constexpr fq const_expected{ 0x7ed4174114b521c4, 0x58f5bd1d4279fdc2, 0x6a73ac09ee843d41, 0x687a76ae9b3425c }; constexpr fq const_result = a * b; + static_assert(const_result == const_expected); static_assert(a == a_copy); static_assert(b == b_copy); @@ -114,10 +111,7 @@ TEST(fq, MulShortIntegers) { constexpr fq a{ 0xa, 0, 0, 0 }; constexpr fq b{ 0xb, 0, 0, 0 }; - constexpr uint256_t a_original(a); - constexpr uint256_t b_original(b); - constexpr uint256_t prod_expected = (uint512_t(a_original) * uint512_t(b_original) % uint512_t(fq::modulus)).lo; - constexpr fq const_expected = prod_expected; + constexpr fq const_expected = { 0x65991a6dc2f3a183, 0xe3ba1f83394a2d08, 0x8401df65a169db3f, 0x1727099643607bba }; constexpr fq const_result = a * b; static_assert(const_result == const_expected); @@ -147,10 +141,8 @@ TEST(fq, MulSqrConsistency) TEST(fq, SqrCheckAgainstConstants) { - constexpr fq a = uint256_t{ 0xa9b879029c49e60eUL, 0x2517b72250caa7b3UL, 0x6b86c81105dae2d1UL, 0x3a81735d5aec0c3UL }; - - constexpr fq expected = - uint256_t{ 0x41081a42fdaa7e23UL, 0x44d1140f756ed419UL, 0x53716b0a6f253e63UL, 0xb1a0b04044d75fUL }; + constexpr fq a{ 0x329596aa978981e8, 0x8542e6e254c2a5d0, 0xc5b687d82eadb178, 0x2d242aaf48f56b8a }; + constexpr fq expected{ 0xbf4fb34e120b8b12, 0xf64d70efbf848328, 0xefbb6a533f2e7d89, 0x1de50f941425e4aa }; constexpr fq result = a.sqr(); static_assert(result == expected); diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp index af41374d5c8..1fddd927768 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.hpp @@ -6,8 +6,6 @@ namespace bb { struct Bn254Fq12Params { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 frobenius_coefficients_1{ { 0xaf9ba69633144907UL, 0xca6b1d7387afb78aUL, 0x11bded5ef08a2087UL, 0x02f34d751a1f3a7cUL }, { 0xa222ae234c492d72UL, 0xd00f02a4565de15bUL, 0xdc2ff3a253dfc926UL, 0x10a75716b3899551UL } @@ -22,22 +20,6 @@ struct Bn254Fq12Params { { 0x365316184e46d97dUL, 0x0af7129ed4c96d9fUL, 0x659da72fca1009b5UL, 0x08116d8983a20d23UL }, { 0xb1df4af7c39c1939UL, 0x3d9f02878a73bf7fUL, 0x9b2220928caf0ae0UL, 0x26684515eff054a6UL } }; -#else - static constexpr fq2 frobenius_coefficients_1{ - { 0xb75446af8a0c2399UL, 0xb5e243df8d8526c8UL, 0x7f6d66278fc2b89bUL, 0x2e05603062b5af58UL }, - { 0xaeefbf6e3bc6cc33UL, 0x7f50c04b4ed87762UL, 0x9a8b7572eb6a58d4UL, 0x9b83e6c410c870UL } - }; - - static constexpr fq2 frobenius_coefficients_2{ - { 0xd96ee8726e4983b2UL, 0xe9b7ed6a458f581eUL, 0x5361c2c89ea5d262UL, 0x24594fd198a79c6eUL }, - { 0UL, 0UL, 0UL, 0UL } - }; - - static constexpr fq2 frobenius_coefficients_3{ - { 0x9dc006978e6a3d3dUL, 0x695b3f038ef4bf24UL, 0x1a238968ba7a7ccdUL, 0x103828f20e49839cUL }, - { 0x5cbbb0bd4f4e6b31UL, 0xe83ce8be1b5b282bUL, 0x646d437ef03fbae3UL, 0x133cf9860031f0c0UL } - }; -#endif }; using fq12 = field12; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp index d9e55827100..c6dc81000b6 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq12.test.cpp @@ -185,8 +185,6 @@ TEST(fq12, SubCheckAgainstConstants) TEST(fq12, MulCheckAgainstConstants) { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0xd43e9f8be859502b, 0x26a42a1a95cee1ef, 0x3d63c085c1892b32, 0x2e5beaf431211a76 }, { 0x5f32ad7cee215ff5, 0xce967fda9424120e, 0x10ea4e52628bac33, 0x51b85ee9671b7f3 } }, { { 0x95f8e84e0ff94a83, 0x6c6fb2cf3c73b30a, 0x28e8e13841f714a8, 0x2a3412f681e31b4d }, @@ -223,56 +221,12 @@ TEST(fq12, MulCheckAgainstConstants) { 0xeaf256aa7a6b49b5, 0xeaa1b56258e3194e, 0xde3b531fd4fe961b, 0x26a0b5c35ce4be53 } }, { { 0x1f7661fa7dd7d68c, 0x71c1360fdb272200, 0x3fdb8fcc1dbfd160, 0x1ba330295e24399b }, { 0x5c93a291c6579918, 0x6536baab9e09bc80, 0x93ad9959edff4c64, 0x138af9a14abfeb1e } } } }; -#else - fq12 a = { { { { 0x7c0386cfac84570eUL, 0x135ac6487c86816dUL, 0x130fe55503fd0b4dUL, 0x1fbc2d0fc05289e4UL }, - { 0x31f40b593ab506cbUL, 0xc4bbb9e4b2ce224UL, 0xf458f928ccf17d61UL, 0x1243d27a2aa21de4UL } }, - { { 0x67ae435929fa99e3UL, 0x93501c918a76046dUL, 0xaca4ccc8963e432eUL, 0x2bee18b27c27853eUL }, - { 0xd0c6730507d0d015UL, 0xd41cfd656c0a9059UL, 0xb292659d53fa0444UL, 0x2e8f0ac98edef6fdUL } }, - { { 0x700740aa0efd0e50UL, 0x2c5e9c0660931b42UL, 0x188425137ce80beUL, 0x15a745139a2d95a4UL }, - { 0xc270eebcc77b120eUL, 0x8dd2034c9f5e661dUL, 0xd0cacb8be3443ebbUL, 0x2206cf8406979618UL } } }, - { { { 0x14beeea0c29cf256UL, 0xec331baf4a9d8e57UL, 0x84c18cf8f3dfd61cUL, 0x172f849c8867a6a3UL }, - { 0x49c8f77c0173904UL, 0xa7ec5eadf91525UL, 0xb6af342102d7f350UL, 0x1931766a4a4de218UL } }, - { { 0x1d05943f42ce34b6UL, 0x2ec4bdddbaed0295UL, 0xf29903765d9d2a7UL, 0x180626982a98bb32UL }, - { 0x16cef1562b3f9cbfUL, 0x564982ca86391192UL, 0x338241cef0f07d6eUL, 0x2eceb2ea88b46fcdUL } }, - { { 0x16d7e01a042c1c8dUL, 0x6ccf62b19f1db7abUL, 0xdf7b7fb19a040d7bUL, 0x17278879d86f5ffaUL }, - { 0xb80f047affe4ba5aUL, 0xd4768f74c5e34883UL, 0x413437ff1a222a7UL, 0x1c9f79ff1e326bd6UL } } } }; - fq12 b = { { { { 0x8b6d20fcb2e4cfe1UL, 0xd90b5af04637d61UL, 0xe5213491fb1c8ddUL, 0x22c31d57c6199047UL }, - { 0x5d5e4792797a849fUL, 0xef0fb5048682755eUL, 0x4262903127b8490UL, 0x1c5a05774b7b87c2UL } }, - { { 0x6afefb11e053997dUL, 0xa9425cc6d3438879UL, 0xc589bf0a479257f6UL, 0x2f265a3f46125967UL }, - { 0x16d32bf792576ea5UL, 0x838faa5f1ec28d7dUL, 0xf78fe731049b021dUL, 0x2b0eaaf50224c689UL } }, - { { 0x37aff72139bcccfcUL, 0xb3d22b3397a55baeUL, 0xf3efabf7233a8667UL, 0x3dbff83c87691bcUL }, - { 0x25f36df6da3ba93dUL, 0x2939ccbc8f01881dUL, 0x10a81e15af7aed31UL, 0x2e518a473abafad5UL } } }, - { { { 0xad5021ea46c06b79UL, 0xb7b76193fc41efe1UL, 0xa69eed0eb6ec2c57UL, 0x2c89ae19e58186bUL }, - { 0xae75112332f4de13UL, 0x374e8d70552ca0d8UL, 0x68e87f702af0ecf1UL, 0x95ede632701dd39UL } }, - { { 0x6de7a94aa7bc5726UL, 0x7874ee4c3c04b1cUL, 0x9a6e5d3e5875115dUL, 0x651f42a42021fb7UL }, - { 0x555a79f9e6ea299bUL, 0xd504f95c1ecbea79UL, 0xe97d114d516cef0bUL, 0x2d27cfdd54e9f124UL } }, - { { 0x8b3ae5f063f26da4UL, 0xf797224bfa14f904UL, 0xcdcd9c93aa02adfbUL, 0x25d073040d79eb5dUL }, - { 0xf84a169b376e11UL, 0xac1f29c1236def7cUL, 0xc84235bd3c78d593UL, 0x11668081e4c22e74UL } } } }; - fq12 expected = { - { { { 0xe1692f3291c79addUL, 0x75a0f3f9cb5b780fUL, 0x94fc10049567941cUL, 0x2cbd84240c99322dUL }, - { 0xec0b5c231d51cf6eUL, 0xaf66fb345ef4b557UL, 0x684bd6749e20d417UL, 0x6acb8ccf83a8a5aUL } }, - { { 0x4b5bfec7495191d9UL, 0xaaf3b2fb8c9417b3UL, 0x9e8cc0788452ef36UL, 0x150f0c9b2bd490d9UL }, - { 0xd38c4d68e8d61244UL, 0x7854bc167c3f883UL, 0xe422e992b4fd0935UL, 0x2e2ee820869b7371UL } }, - { { 0x9458ec7554a72a3eUL, 0x611f6d973e483feaUL, 0x3f8ea4f8370c8826UL, 0x189afef00f4165e6UL }, - { 0x8a57858c6746a623UL, 0x5c2f5d8907db836eUL, 0x18aa628b09f8cc39UL, 0x301cdc8e2edb165bUL } } }, - { { { 0xe339df6c6902f315UL, 0xbcf4e508382eec7UL, 0x1a86782e58331768UL, 0x15a3a1d93ce727deUL }, - { 0x9d3911edc9a69069UL, 0xacf7dd9e1ee36b27UL, 0xd3c0532725cf9a45UL, 0x1c7c570ac4e21c68UL } }, - { { 0x434490153d5b55f1UL, 0x3e3b2fb04143f767UL, 0x8960b1eb0cea5302UL, 0x2ebbac70edefc529UL }, - { 0x7f1d271429347ab1UL, 0x88934417e9466212UL, 0xc7939527fa312259UL, 0x1a4b0f339ebf2668UL } }, - { { 0xb48265b482310282UL, 0x910d43c20ce40215UL, 0x5cd12ae9ce1f579UL, 0xd588117ef09f079UL }, - { 0xc0edc126a51743acUL, 0x8cc656a2dbe2116cUL, 0xd1efe6afadd96829UL, 0x2cab86c6c9a9e1ddUL } } } - }; -#endif - fq12 result = a * b; EXPECT_EQ(result, expected); } TEST(fq12, SparseMulCheckAgainstConstants) { - fq12::ell_coeffs ell; - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x8860ba0c4eea41a8, 0x71b65207984d47d2, 0x67e55696f8982ba9, 0x18236f03bcec9b00 }, { 0xa69e0f0ce60f64fd, 0x1cf52f3b2335b9b3, 0x45e8ec475fcb1d71, 0x1627ac08d10cebd9 } }, { { 0xc7343ce2fb7b4829, 0xff667dd3e618123b, 0xd03970bcf60881b4, 0x188e0b7acdd0b801 }, @@ -285,6 +239,7 @@ TEST(fq12, SparseMulCheckAgainstConstants) { 0x5752f0197b67dfa3, 0xb4ff7a53c23b98fd, 0x95dec4882eb275cd, 0x6815e3c55e10152 } }, { { 0x64f434f52a58b19b, 0xcdab64e3ae898031, 0x5d10a474f28b9462, 0x85452691edf6f18 }, { 0x2bb46c10f494b711, 0x66a853baee9e6a00, 0x3b3e0fd932afa021, 0x1ae752d1bbdef131 } } } }; + fq12::ell_coeffs ell; ell.o = { { 0xe49c67a74aaf8c22, 0xc5cc428c85da5d5a, 0xc946262e0c99d3d9, 0x2307b236a862e3e9 }, { 0x1659aef76f0397ef, 0x32d0c2d00f81d8a5, 0x7e87867d5f0c5ccd, 0x247307a3fd6fece7 } }; ell.vv = { { 0x6e6f2db65bdf07bd, 0xc26fa997848fb1e4, 0x13ec10cb6a0cd0ae, 0xf86d8967480301c }, @@ -303,41 +258,6 @@ TEST(fq12, SparseMulCheckAgainstConstants) { 0xee892e54b68159d6, 0xe0421cb20d103d69, 0xfe0591fdca60e2e3, 0x1650989fd73116b9 } }, { { 0x475dec6d5f2e2a75, 0xf25390f14ed7106, 0x61a4b571cb15d2fe, 0x1ad83abac0d5bdd7 }, { 0x8f730272c4cfee79, 0x60833c047d98a040, 0xbd1da3dc3fe5ad4a, 0x11bcc8faf5176d94 } } } }; -#else - fq12 a = { { { { 0x862f0c332df55dd7UL, 0x5635026deafe1c0aUL, 0x2ff6bd2d7c7147b2UL, 0x2e8d47bc6baafd9bUL }, - { 0x89fa385ceb16c5beUL, 0x55921370b07e22bbUL, 0xa8b9b8f0e450d905UL, 0x1f7936d1d0e6b8e0UL } }, - { { 0x247edaf1e79930b0UL, 0x74b911663be59ea5UL, 0x8229bc36a8fab0c6UL, 0xb7c882ba6fcfd9eUL }, - { 0x9b0f501da1aba3f8UL, 0xb9eada8afbf600cbUL, 0xaae6ba9ad6dcdf6cUL, 0x2e7c7f0141a21168UL } }, - { { 0x69f468a007750941UL, 0x8717631d88d69af9UL, 0x92ebf135aa3ae0fbUL, 0x2fde53f8ed2d4e89UL }, - { 0xaa3fdf0219928031UL, 0xb9f6c209fa53b22fUL, 0x42f0094eee6a0282UL, 0x1265a0c64610dd82UL } } }, - { { { 0xafba8564aac749c5UL, 0xa3fc62e90dcf2998UL, 0xe76f032508e46ceUL, 0x512a45304405419UL }, - { 0xaed59d4a84fadccfUL, 0xa8545ab127e7b2e7UL, 0xa22a72b116b8cd30UL, 0x2ed2f79741896fa7UL } }, - { { 0xe4e3c9f195fc922UL, 0x1e369406a0dd4156UL, 0x5cd5b95268031c47UL, 0x10e1a470d68ccc24UL }, - { 0xf9dbd2d40b07ff44UL, 0x41e9a032a5abf575UL, 0xda977a2bd0495840UL, 0xe9a8dbf3759a9abUL } }, - { { 0x71e3e23310a540fdUL, 0xbfe5879ec6f7116aUL, 0x883320dc9ebd285UL, 0x1894c4e575f5c23bUL }, - { 0x7864349a324a1069UL, 0xc57263b5e43ecca4UL, 0x2a6d5a07bc5d25f5UL, 0x2641249687928362UL } } } }; - ell.o = { { 0x2ca05edbe2b6c2dfUL, 0x1ce7be80591278acUL, 0x998e825bf09b8ad0UL, 0x7f33a82d0e71979UL }, - { 0x2828bcc994bb3f38UL, 0x25f65c6025901765UL, 0x896a468fbd6b50e0UL, 0x4f999ba91569906UL } }; - ell.vv = { { 0x74a03de706ff12daUL, 0x62e709427d845309UL, 0x4a5f604c328ca230UL, 0xcf00251c415c1e1UL }, - { 0x9ed8dd9107199bcfUL, 0xc8687b1778022dc1UL, 0xc85d46f0f0503eb5UL, 0x74aa6da92bf7c52UL } }; - ell.vw = { { 0x40dd44ad118c702eUL, 0x8e54bb7dba2b064dUL, 0x2f70e0e61191e016UL, 0x15da2c76976d740eUL }, - { 0xa0f9565f3904fdb9UL, 0xf365bb919669dda8UL, 0x9d115033fcfce745UL, 0x1d5b9ac7270a74d2UL } }; - fq12 expected = { - { { { 0x82285526713a81afUL, 0xb9bdafcf85cffdd7UL, 0x81e818f8dda89057UL, 0x538df3884fe91cdUL }, - { 0x2334d3765086fcc4UL, 0x5241e1cb445f8d0cUL, 0x9d67bfc7f3580b66UL, 0x16935cb50949401aUL } }, - { { 0x79e51946415c1d86UL, 0x2dc112e62e072e35UL, 0x31cc85fadec9dac7UL, 0x21cafde5a92abf84UL }, - { 0xc499133572cc7b01UL, 0xf1d5b744396dc992UL, 0x5a07a594d45537e2UL, 0x5308670f9c3d1f9UL } }, - { { 0xbc1249df0a659895UL, 0x35a160c6d314cba0UL, 0xc6feb7b32ad48754UL, 0x17c6a9d4f6fcaafdUL }, - { 0xb9be974900458414UL, 0x1746303c5d7e6930UL, 0x91409abda635eb5cUL, 0x2b3c8b47d060a389UL } } }, - { { { 0xdc1dee7128fefe88UL, 0x378772d011ad83b3UL, 0xc1532ed19f546d80UL, 0x1955fc12038a7e9UL }, - { 0x6da079dfafc00254UL, 0xc86f97e68cba4484UL, 0x5dcaeaac906d378aUL, 0x121934a4af2b7682UL } }, - { { 0x86a09145e69d83d6UL, 0xfe70b95e33cefbc7UL, 0x76b0cc3628b7342eUL, 0x172e1bbf4c53ebafUL }, - { 0x875e2156f95560deUL, 0xbf2fc24debce9984UL, 0xac4e6fbe3709875dUL, 0x2496c9b2956c14f7UL } }, - { { 0xed94402785787ce9UL, 0xd50f0e3aae1fad67UL, 0xf7420d1ac923818aUL, 0x245e21b7266c1826UL }, - { 0x58fa495d4c9eed13UL, 0x8dd7ec5036305400UL, 0xb8417cb06c26dd46UL, 0x2349c06ef5cbd0ccUL } } } - }; -#endif - a.self_sparse_mul(ell); fq12 result = a; EXPECT_EQ(result, expected); @@ -345,7 +265,6 @@ TEST(fq12, SparseMulCheckAgainstConstants) TEST(fq12, SqrCheckAgainstConstants) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0xef9d68a7df0715fd, 0xfda8aff4030523cf, 0xd09b1482069c0972, 0x252195422f351b07 }, { 0x3192057a31dec453, 0xe1c2dd8879191e47, 0xe90a8a00c9b29c5b, 0x1db75f06dff5dd5e } }, { { 0xdb01b2dbb451df8f, 0x42d8923147ae4171, 0xd1264f3077ab1733, 0x2fbabfe2fbc0c62f }, @@ -370,35 +289,6 @@ TEST(fq12, SqrCheckAgainstConstants) { 0x19ea0ed62e5093c2, 0xcf288a69b5a24352, 0xa9bdc89dd4491b7d, 0x447edc7b33f3d1c } }, { { 0xceb417494bece8e, 0x7f3d84971a20d351, 0x31679ed74c101d91, 0x1bb2c06842073c0c }, { 0x6db2993066e5fd73, 0x2c08c9fd6c3b5483, 0x3b32d43ab22d6cea, 0x3df72d32906f5f0 } } } }; -#else - fq12 a = { { { { 0x509ff2d7952b00f8UL, 0x80f400de95f97cc0UL, 0xcbdc0724af60e599UL, 0x1acb4d80c9fc5d10UL }, - { 0xbbd649942a91be1bUL, 0xf9c0c84462b1c06aUL, 0x735c138d99b9fc89UL, 0x1f7a0e55480cc8c4UL } }, - { { 0x184564b253194647UL, 0x2665e8d5000a721UL, 0xd31174f546b93313UL, 0x1b327c76331660ecUL }, - { 0xcf1585c76f7e33faUL, 0xd42af737f2d68572UL, 0x3b4f1daaf9248cf2UL, 0x28102c8df7cb8188UL } }, - { { 0xfd34a1893271a08dUL, 0xa8bb3e8ddf935064UL, 0xaf2e701ff4238744UL, 0x112cb808f50649edUL }, - { 0xfa6a796e73099831UL, 0xc33d172135fc08f1UL, 0xffc1f0839ae21c08UL, 0xd5487b930349686UL } } }, - { { { 0xa138da16197ba208UL, 0x131b351230ea78f4UL, 0x67d421144983327fUL, 0x301ad90db1293961UL }, - { 0x2aaf49d5664bf971UL, 0x41de301d76480c2UL, 0xf1b7cd92f25da91eUL, 0x266ad04894fb98a1UL } }, - { { 0x5430ab66ae7c441eUL, 0x56b0046a411a6a05UL, 0x769a94899a38a9a8UL, 0x47009b2bb1105a4UL }, - { 0x90e78ec3428acf7fUL, 0x494d36f303578d13UL, 0xf860c04788d78bd4UL, 0xbff46fe73771bc5UL } }, - { { 0x4deef8f7b5691d29UL, 0x4ca2a905e4dc7c9UL, 0xd346bb2f908bf92dUL, 0x4e7f53251024a06UL }, - { 0x506c4af6c096a839UL, 0xb66ec8f49dcd25d7UL, 0x1d956454caa9c224UL, 0x80fd62496656a00UL } } } }; - fq12 expected = { - { { { 0x444065edd96c27eUL, 0x441edd1fb7593b4dUL, 0xebca21f0aba5b86aUL, 0x1a0f7150178bce4UL }, - { 0xd6944c6d8a9a1326UL, 0xebe3e1c083a9070aUL, 0x90085ed26d41b187UL, 0x270dbc63380d166fUL } }, - { { 0x6ff64bb4265979c2UL, 0x934f9a7229efd61bUL, 0xf2633f5fc77c71cdUL, 0x794a11250897c9UL }, - { 0x4c16eb3426ead093UL, 0xc6b10f92e5172d17UL, 0x722cc34bab735deeUL, 0x2ef62e8e932612a9UL } }, - { { 0xe5eb6b4fe61af24bUL, 0xf4ad92e89647ddbeUL, 0xf07438f58235164fUL, 0x2ddf71d5540c3861UL }, - { 0x1f892a5ed0dbc0bfUL, 0xdea7e0ca077a8f66UL, 0x561aba1a7909c0acUL, 0x2296a5f0bb3fca3UL } } }, - { { { 0xb33c0e27dc05cf5eUL, 0x9b5ac27c7f9f3fafUL, 0xb34ce34b0ddc0e33UL, 0x8d34950d591462UL }, - { 0x6633d2139211d6feUL, 0x1c194cb263ca6182UL, 0x280ced1e54e99b63UL, 0x78892452fa76a9eUL } }, - { { 0x8ffaebac35d5999eUL, 0x8e3226d773c7cac4UL, 0x180b0a89641fbc37UL, 0xd165c35b4cefb88UL }, - { 0xc500c29819187db2UL, 0xb60e7813e364d528UL, 0xc718884d8620befeUL, 0x28351c10a5846341UL } }, - { { 0x631e54f75f1002c2UL, 0x409714a9ec1a2c33UL, 0x374ef41466eb7b9bUL, 0xf4a88f46b6a3e97UL }, - { 0x3e120ddf2bc5b3d2UL, 0x52166a8ab686fb53UL, 0xf5b9fbe942aaec8aUL, 0x1b25bd7f5e7b7db3UL } } } - }; -#endif - fq12 result = a.sqr(); EXPECT_EQ(result, expected); } @@ -421,7 +311,6 @@ TEST(fq12, UnitaryInverse) TEST(fq12, FrobeniusMapThree) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x9a56f1e63b1f0db8, 0xd629a6c847f6cedd, 0x4a179c053a91458b, 0xa84c02b0b6d7470 }, { 0xffa3e17eab3609a1, 0x6a97b9cf5c3fe152, 0x8996248da177be9f, 0x113bd2d7f24591d } }, { { 0x572c4fd8a85cc3b, 0x48197102a98815e8, 0x3a1d00190e8ee460, 0x8c0a0ce9c093781 }, @@ -446,42 +335,12 @@ TEST(fq12, FrobeniusMapThree) { 0x373dde8dfb6dceb3, 0xa0feac44ec583fb4, 0x257146bc7ad7d5c2, 0x1ee0a5c45a91938b } }, { { 0xf8c975188dd668a5, 0xfa38a6144e0c5451, 0x8ebdddc91016c224, 0x13fe7e09fe48aefb }, { 0x2ce375ffd1c12d33, 0xc2099e064cd9724d, 0x9c54b742a4d8bd59, 0x1c79d60ac5202c8c } } } }; -#else - fq12 a = { { { { 0xe21af43e50f3c756UL, 0x382c59a08c2f1c63UL, 0xf111de6049209f49UL, 0x2e3e2eb02684cd0eUL }, - { 0xf47c2fd566c13420UL, 0x52f739eb87fc2a5fUL, 0x32c491b42ef7d3edUL, 0x2277a5afe48b23b1UL } }, - { { 0x81b5e33f164894fdUL, 0xda70b7e26c9c83eUL, 0xaa0ea6914a55d235UL, 0x261e91951b2ecf56UL }, - { 0x8777f8c814c07822UL, 0xb1d30aee8bbb4fdbUL, 0xd68096f26bc12a63UL, 0x226bdb647a45d0b3UL } }, - { { 0xe196e3bdeadc85f8UL, 0xfc4ead6ed1903f55UL, 0x35fbc522dfecf6e5UL, 0x2ea7141ed2d4f68aUL }, - { 0x5018998ba882e541UL, 0x1f2f49ebb929119UL, 0x10bf13b591b51304UL, 0x2715b1dab0519809UL } } }, - { { { 0x41dfb519bce7a2a2UL, 0x57e69632d7d5db93UL, 0x63059436226719c0UL, 0x1382e9227bb12da2UL }, - { 0x78a2f4b9c37bba73UL, 0x9f5fa1370c59e023UL, 0x36960dd11dca7d4eUL, 0x1bb2293869e6eeaaUL } }, - { { 0xa7bb52bda67d2ce5UL, 0xd12b03267bae96bUL, 0x45ead6d4c0922699UL, 0x357633e5fd4e57bUL }, - { 0xf6caeb876f66196eUL, 0x5c88f8b1ea233a64UL, 0x6d24d190eef310f6UL, 0x2fa0d06ea9b6d35dUL } }, - { { 0x4bed4d1891ba154fUL, 0x2bf8026dae838260UL, 0xdcbd5388441e5626UL, 0xee0668e4e2fb0f6UL }, - { 0x8723a4e98854ba0bUL, 0x4d22e9a149ea8618UL, 0x5dda9a16aa96fb0aUL, 0x2fef151f315f190UL } } } }; - fq12 expected = { - { { { 0xe21af43e50f3c756UL, 0x382c59a08c2f1c63UL, 0xf111de6049209f49UL, 0x2e3e2eb02684cd0eUL }, - { 0x47a45c4171bbc927UL, 0x448a30a5e075a02dUL, 0x858bb40252898470UL, 0xdeca8c2fca67c78UL } }, - { { 0xd358397e360f2515UL, 0xfd6900b5784eb831UL, 0x64b0f2a74cb5b985UL, 0x303bdfa5683f19d3UL }, - { 0xee96f5c48ada25b8UL, 0xb17d89d5ee0965adUL, 0x5d90f2b14f0a7867UL, 0x11089d3bd9d1812fUL } }, - { { 0x8b4a37515d2483f4UL, 0xe2f2f3d7704a8333UL, 0x82a719484b992a0cUL, 0x8358f71dd30b350UL }, - { 0xff959db32aa39cd3UL, 0xb246a2f8b40c4889UL, 0xb9d5613c61fc64c3UL, 0x127acef64f2e0dfbUL } } }, - { { { 0xc2603367444cbf36UL, 0x4cebd20389e5d4eeUL, 0xcb3f9abc665e6992UL, 0x1290194e45a92b01UL }, - { 0x7c9e4c6727aa44d7UL, 0x7e9de180a367babUL, 0x500cb6ac8f91a2a0UL, 0x1f7ac11ce8c52bb3UL } }, - { { 0x3796fd3f2e8f6cddUL, 0xb93f0f07868dcf79UL, 0x69a0645a73c08c82UL, 0x665f5d67055274UL }, - { 0x3530dff683f60cd4UL, 0x49b935416224237eUL, 0x47e3654d3cdfd104UL, 0x143e9791ba51ee22UL } }, - { { 0xb8785e8bc743805UL, 0x9582592773c34113UL, 0x7ba82edd6f46c7deUL, 0xab7c56a5990bd53UL }, - { 0x6224e65eff5bd762UL, 0x9a1a4290432e0bb7UL, 0x94f2017f7fff74a3UL, 0x282d3d44ce884ea4UL } } } - }; -#endif - fq12 result = a.frobenius_map_three(); EXPECT_EQ(result, expected); } TEST(fq12, FrobeniusMapTwo) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x52c2cc6e77bfe9bb, 0xd03d98cc3fd6d95, 0xfaeb6d6577aa9a30, 0x1ea38b81330e34df }, { 0x1f55d493000a14f3, 0x1db7ec50e2f5a356, 0xf3cfcc74b91481ae, 0x256fe76342b33dbb } }, { { 0xf3e95f622620a0f9, 0xe297badf08d73c22, 0x4df25d06ae059cfb, 0x16db699bc5bbddcb }, @@ -506,42 +365,12 @@ TEST(fq12, FrobeniusMapTwo) { 0x2461a96edf6a6749, 0xe0c7f9244e8d0ed1, 0xb55df0a79cb9ac2c, 0xa357103af082354 } }, { { 0xe1148c424a589341, 0x40ab0d25fb7fd0d1, 0x7909a54a9569db90, 0x99bde98bbc4352f }, { 0xfaa4fdcf224e38ee, 0x42b25f170bf5f577, 0xc13bf097c75be619, 0xbcb9923cbd60387 } } } }; -#else - fq12 a = { { { { 0xa5ce9c060e396dd4UL, 0xca5ede3c56c9dfa1UL, 0xf7283a6cd7385eb1UL, 0xc9b4f2cc9e618bcUL }, - { 0x47ad703bb58adfb8UL, 0x82db8c7a94096d86UL, 0x3273057afe6fecfdUL, 0x249591a339c0b395UL } }, - { { 0xf743b6ee14c147f7UL, 0x72621d5bfc3ca617UL, 0xf1978b242a1f7200UL, 0x58c9abd859356f7UL }, - { 0x9fc148e808531ae4UL, 0x7e33428ce1e43d80UL, 0x8246ca0b17d04b6cUL, 0x13266ecc9ef22872UL } }, - { { 0xef813b9466e4f00dUL, 0x41be0a62083cce0UL, 0xb4bbcf52f290d43cUL, 0x255bcc4ea029409dUL }, - { 0xdef7a848a4ded44eUL, 0xcd9fc4819661004fUL, 0x28353ecc041c3066UL, 0x27a6a7890b897c1cUL } } }, - { { { 0x569b1e1b9916eab7UL, 0x77f844752482d618UL, 0xc8d2dfa5b90c75a1UL, 0x2b91d0892e6f3036UL }, - { 0xd83a28cd569274d7UL, 0xacd31b4648059115UL, 0x2d291841a5f79fffUL, 0x8853bfca3cd9a50UL } }, - { { 0xe904f05380da0bc2UL, 0xc9a74003c930b32fUL, 0x5a9981596b16c136UL, 0x2eea5b92180eb16eUL }, - { 0x18aea6c3fe1e03d1UL, 0xb8ac570097aafb8UL, 0x5e73d309f353e4f3UL, 0xc1004ae4756f68dUL } }, - { { 0x370079d737c6ed86UL, 0x298c4ec1f2b51e25UL, 0xdfc6f1416cbf760bUL, 0x2d5c11050cbe98d1UL }, - { 0x1462ea1f533b22a9UL, 0xb5262fc0a622613eUL, 0x6685b2cda9398a5cUL, 0x2fc6212886ea733aUL } } } }; - fq12 expected = { - { { { 0xa5ce9c060e396dd4UL, 0xca5ede3c56c9dfa1UL, 0xf7283a6cd7385eb1UL, 0xc9b4f2cc9e618bcUL }, - { 0x47ad703bb58adfb8UL, 0x82db8c7a94096d86UL, 0x3273057afe6fecfdUL, 0x249591a339c0b395UL } }, - { { 0x9828994245688eeaUL, 0xe5a280f898969f11UL, 0xb4b0ecd3af49dcc6UL, 0x21670b00576e3cafUL }, - { 0xd343da039e48db0eUL, 0xb3b4e737ecb54579UL, 0x1608becbcac11801UL, 0x8a492bd585ba0e3UL } }, - { { 0x249b9eedf5fd4d00UL, 0x61c05dafd482a437UL, 0x3e9c9f9aeb106d88UL, 0x9073e4985688fa5UL }, - { 0x264823249f36c1a0UL, 0xa7ad4a28f1311aeeUL, 0xa802735777a625bUL, 0x182813dd5fc55593UL } } }, - { { { 0x91e56d561fc65bf4UL, 0x91c74e7a38170c9bUL, 0xf8da19ddb4129b39UL, 0x4a864abc1999de1UL }, - { 0xf9dbb5cb6765f02eUL, 0x484221af215c12f1UL, 0x9dae4490f9df3878UL, 0x22d6e5b80da4cc69UL } }, - { { 0x531b9bc357a2f185UL, 0xcdda2a8d9f41175dUL, 0x5db6c45d166a9726UL, 0x179f2e0c922eebbUL }, - { 0x2371e552da5ef976UL, 0x8bf6a5215ef71ad5UL, 0x59dc72ac8e2d736aUL, 0x245449c499daa99cUL } }, - { { 0xb9ce3fc038247876UL, 0x88592556fd4f5aecUL, 0xcf53070ba4335fd6UL, 0x1121fc66315ce4f4UL }, - { 0xafbbe5445e5c30cfUL, 0x31c1f8e7a3a22522UL, 0x1d4c2afb60f35899UL, 0x26b4ff5552650fd4UL } } } - }; -#endif fq12 result = a.frobenius_map_two(); EXPECT_EQ(result, expected); } TEST(fq12, FrobeniusMapOne) { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq12 a = { { { { 0x6c9edca7f0d6f6e, 0x7bb482de96b01e0, 0xb04fc4b2b2ea7e6, 0x4d9efc00ceb8323 }, { 0xb55c2222935ee583, 0x9c114ab89499b4da, 0x771cb5cabe1f458a, 0x1c3f0ac5303a5935 } }, { { 0x524feabf94af29ea, 0x95573536ab8b6ced, 0x524e16790930912c, 0x280d5af94a3424d0 }, @@ -566,35 +395,6 @@ TEST(fq12, FrobeniusMapOne) { 0x6602e7e93a714d67, 0x7398f14acf72c7e0, 0x8028d203d5e4928, 0x7d1fad57418b580 } }, { { 0xcba1922169de670, 0xcd20689212638b5e, 0x8dbbc53af7639bbb, 0x57a19a043d38c39 }, { 0x2b2d3090bfb1118b, 0xa752e789e316e0c7, 0xc1c4d33385bc3e10, 0x2610936b5468ba45 } } } }; -#else - fq12 a = { { { { 0x24dc150b5836f5ebUL, 0x30e4c608f40adc59UL, 0x37aeb841e150f3a8UL, 0xa110ca8f9db83e4UL }, - { 0x713a6ab73312e162UL, 0xdb0fd8d93b365d68UL, 0xedf1d282a8d07abeUL, 0x20d3d49231cde3bfUL } }, - { { 0x2eaf1da09933840aUL, 0x47c1d410d5df0b52UL, 0x919bba97feef2c11UL, 0x177b677e677a55cdUL }, - { 0xf888f6cf22cba791UL, 0xf820cd3640d260ebUL, 0x32742ec8e28152aeUL, 0x36fc6b21931e9e2UL } }, - { { 0x779044381bcbd101UL, 0x3f5ba296ae5db8faUL, 0xc2dbbc1691c8456aUL, 0x12d18799d91da0dUL }, - { 0xd089a63726293a6aUL, 0x77cd64002c1c4bcaUL, 0xd76a11cb5f5c0da6UL, 0x21add603f21af96eUL } } }, - { { { 0x8dcabcf31424c06fUL, 0x16bac862dc9fed95UL, 0xc1ae831f305040e5UL, 0x1e6200dce1120d3dUL }, - { 0xd1f5ad6845446895UL, 0x74526d8ca424b736UL, 0x849b3d172cc8381fUL, 0x12e88895f9e2a0d4UL } }, - { { 0x85cc8318ddbe2910UL, 0x961fb2e5108e0e4fUL, 0x781905321776e776UL, 0x2e8093940b560716UL }, - { 0x8b2ce4303baba4d9UL, 0x866a756e2161f73eUL, 0x1b230d82dbc3d550UL, 0x210f44fb356348c0UL } }, - { { 0xc57933e5530111baUL, 0xe45d80ed27b8a6b4UL, 0x7feeb0f2e09ca2cbUL, 0x1fdb773784242816UL }, - { 0xb5580ae30b1f6bf0UL, 0x51e1fbe74aad988dUL, 0x1a4e45b3185c094bUL, 0x1d0f5f64f6aa211aUL } } } }; - fq12 expected = { - { { { 0x24dc150b5836f5ebUL, 0x30e4c608f40adc59UL, 0x37aeb841e150f3a8UL, 0xa110ca8f9db83e4UL }, - { 0xcae6215fa56a1be5UL, 0xbc7191b82d3b6d24UL, 0xca5e7333d8b0dd9eUL, 0xf9079e0af63bc69UL } }, - { { 0x2691a685eb8b9e52UL, 0xc66888725d4805e4UL, 0xfc9cca7897e98f66UL, 0xbba94db29fe53ddUL }, - { 0x9f81e7019e774940UL, 0x36c0b8a5a6682687UL, 0x430a3924d0194d94UL, 0x2e938f15bd7f14a6UL } }, - { { 0x74e35b32ad2905fUL, 0x35afc43add46aeedUL, 0xb0309a03e6a3fe42UL, 0x3f0424b1202b900UL }, - { 0x1d98151eed9dceaeUL, 0x13f07d5ab22bb4fUL, 0xe14df7a387f2a2cfUL, 0x1ba0ba8d43259443UL } } }, - { { { 0x4d7742f9a326103fUL, 0x4f500f51726e60e7UL, 0xcce27ad8fe9043c1UL, 0x45db038f7fc875bUL }, - { 0x675053d4c95fe601UL, 0x8dc76ffbc91ef3feUL, 0x4b7246a3829a5be1UL, 0x2a53c42803e89a45UL } }, - { { 0xef087aab854dca2UL, 0x6de4ca5802af8bfaUL, 0xcc29efb20b2d894dUL, 0x2fef6cff0a2d4495UL }, - { 0x93ba40b513b8ba7dUL, 0x7d971482e420074aUL, 0x66c0477724426b3aUL, 0x849d2701d1e8f30UL } }, - { { 0xe2e17ffe4a45d62bUL, 0xdd88d28e131c0c19UL, 0x8e87d63b67ef6e60UL, 0x1e1648afd6dca6b4UL }, - { 0x867863dcd1ed7571UL, 0x1eb989092fbf511aUL, 0x38c3979e11e620f1UL, 0x846c4328f3ea4a5UL } } } - }; -#endif - fq12 result = a.frobenius_map_one(); EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp index fce8cc53521..ec4148ad2d1 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.hpp @@ -5,7 +5,6 @@ namespace bb { struct Bn254Fq2Params { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq twist_coeff_b_0{ 0x3bf938e377b802a8UL, 0x020b1b273633535dUL, 0x26b7edf049755260UL, 0x2514c6324384a86dUL }; @@ -30,32 +29,6 @@ struct Bn254Fq2Params { static constexpr fq twist_cube_root_1{ 0xad607f911cfe17a8UL, 0xb6bb78aa154154c4UL, 0xb53dd351736b20dbUL, 0x1d8ed57c5cc33d41UL }; -#else - static constexpr fq twist_coeff_b_0{ - 0xdc19fa4aab489658UL, 0xd416744fbbf6e69UL, 0x8f7734ed0a8a033aUL, 0x19316b8353ee09bbUL - }; - static constexpr fq twist_coeff_b_1{ - 0x1cfd999a3b9fece0UL, 0xbe166fb279c1a7c7UL, 0xe93a1ba45580154cUL, 0x283739c94d11a9baUL - }; - static constexpr fq twist_mul_by_q_x_0{ - 0xecdea09b24a59190UL, 0x17db8ffeae2fe1c2UL, 0xbb09c97c6dabac4dUL, 0x2492b3d41d289af3UL - }; - static constexpr fq twist_mul_by_q_x_1{ - 0xf1663598f1142ef1UL, 0x77ec057e0bf56062UL, 0xdd0baaecb677a631UL, 0x135e4e31d284d463UL - }; - static constexpr fq twist_mul_by_q_y_0{ - 0xf46e7f60db1f0678UL, 0x31fc2eba5bcc5c3eUL, 0xedb3adc3086a2411UL, 0x1d46bd0f837817bcUL - }; - static constexpr fq twist_mul_by_q_y_1{ - 0x6b3fbdf579a647d5UL, 0xcc568fb62ff64974UL, 0xc1bfbf4ac4348ac6UL, 0x15871d4d3940b4d3UL - }; - static constexpr fq twist_cube_root_0{ - 0x49d0cc74381383d0UL, 0x9611849fe4bbe3d6UL, 0xd1a231d73067c92aUL, 0x445c312767932c2UL - }; - static constexpr fq twist_cube_root_1{ - 0x35a58c718e7c28bbUL, 0x98d42c77e7b8901aUL, 0xf9c53da2d0ca8c84UL, 0x1a68dd04e1b8c51dUL - }; -#endif }; using fq2 = field2; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp index 0a0223b938d..168b1c95ea7 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq2.test.cpp @@ -51,85 +51,46 @@ TEST(fq2, RandomElement) TEST(fq2, MulCheckAgainstConstants) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0xd673ba38b8c4bc86, 0x860cd1cb9e2f0c85, 0x3185f9f9166177b7, 0xd043f963ced2529 }, { 0xd4d2fad9a3de5d98, 0x260f72ca434ef415, 0xca5c20c435accb2d, 0x122a54f828a07ffe } }; fq2 b = { { 0x37710e0986ad0fab, 0xd9b1f41ba9d3bd92, 0xf71f600e90104795, 0x24e1f6018a4d85c6 }, { 0x5e65448f225b0f60, 0x7783aecd5d7bfa84, 0xc7a76eed72d68723, 0xc8f427c031af99a } }; fq2 expected = { { 0x1652ca66b00ad519, 0x6619a315656ea7c7, 0x1d8491b044e9a08f, 0xcbe6d11bff2e56b }, { 0x9694fb422eff4e79, 0xebdbcf03e8539a17, 0xc4787fb63b8d10e8, 0x1a5cc397aae8811f } }; -#else - fq2 a = { { 0xed72e66054afa688UL, 0x58ee4e882533c50UL, 0x6e3d116ec0243404UL, 0x1d657f309417a3d8UL }, - { 0xc8d8ca2255efd3acUL, 0xa7dd5a778489041bUL, 0xa7c0d3f8a3894141UL, 0x96f1a285bc7de4UL } }; - fq2 b = { { 0x4b149f0c89ea36b8UL, 0x21c85d36fccb509UL, 0x9c6578b5dde8a9f5UL, 0x12d7656c2d09b4f5UL }, - { 0xeba4312d877a01c8UL, 0x346a85206bf0fc21UL, 0x326baffa4ec62182UL, 0xec5dbe959d2320bUL } }; - fq2 expected = { { 0xe954ec1f3d72b8e8UL, 0x7290e216a46a478UL, 0xee10085491294f00UL, 0x14ab2ea0f4cfac15UL }, - { 0xd4761ac17f9cfd69UL, 0x6be1ccd51ae4cf91UL, 0x51bb55a8d80b3ee6UL, 0x14ef3d5468c48133UL } }; -#endif - fq2 result = a * b; EXPECT_EQ(result, expected); } TEST(fq2, SqrCheckAgainstConstants) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x26402fd760069ee8, 0x17828cf3bf7dd3e3, 0x4e7449f7b1149987, 0x102f6467805d7298 }, { 0xa2a31bf895eaf6f8, 0xf0c88d415c372b16, 0xa65ccca8b7806691, 0x1b51e4526673451f } }; fq2 expected = { { 0xb51c9049894c45f3, 0xf8ef65c0244dfc90, 0x42c37c0f7d09aacb, 0x64ddfb845b2901f }, { 0x9e176fa8cdca97b1, 0xd04ae89dab7da31e, 0x637b83e950322d50, 0x155cccfadafc70b4 } }; -#else - fq2 a = { { 0x6ec082078bf1f83aUL, 0x54374c9db4892e0UL, 0x9b6685d51385bd3bUL, 0x22017c733fbe1168UL }, - { 0x1a19a57784951002UL, 0x71f829f22ee524e6UL, 0xd5f4ae41d4f49ba9UL, 0x32f0638f8eb6105UL } }; - fq2 expected = { { 0xb30fd8d5c794c944UL, 0xbfe70dbee7f867e1UL, 0x772e6b159b2ff808UL, 0x82abd3d318b8341UL }, - { 0x79264bd9e27d1c3eUL, 0xc0493fc1b97b501aUL, 0x5b0cad2ef132d4fbUL, 0x61d55130ed75444UL } }; -#endif - fq2 result = a.sqr(); EXPECT_EQ(result, expected); } TEST(fq2, AddCheckAgainstConstants) { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x517c157ce1664f30, 0x114ba401b0996437, 0x11b9ae2d856012e8, 0xcc19341ea7cf685 }, { 0x17c6020dde15fdc0, 0x310bc25961b2f002, 0xa766e7e94a865c0d, 0x20176bc8e6b82863 } }; fq2 b = { { 0xffad1c8ac38be684, 0x2a953b27cb1f541d, 0xfc12b9dfe76a0f12, 0x434c570deb975a6 }, { 0x87430d4b17897ace, 0x33ab4d0e55e8932a, 0xe4465ff65990dd31, 0x83db0b3c55f9e9f } }; fq2 expected = { { 0x51293207a4f235b4, 0x3be0df297bb8b855, 0xdcc680d6cca21fa, 0x10f658b2c9366c2c }, { 0x9f090f58f59f788e, 0x64b70f67b79b832c, 0x8bad47dfa417393e, 0x28551c7cac17c703 } }; -#else - fq2 a = { { 0x4e7e4ee568e1fbc8UL, 0x6d692baacf9e3280UL, 0x74b397fc9ff79a15UL, 0x150ff4a64611cf54UL }, - { 0xa14c3dc007ef12dUL, 0xb3da8d3ea50862adUL, 0xce474530b12f41f8UL, 0xab309b05df2e908UL } }; - fq2 b = { { 0x7d62792ac082d5f2UL, 0x23a48fd69306eea5UL, 0x11b6b08fea3f318aUL, 0x25d0113614cb748cUL }, - { 0xbbbeecf0b6be675dUL, 0x7fe28cf3b2d9708eUL, 0xef3aa23aaa94ec52UL, 0x15c08e3a45fbb32bUL } }; - fq2 expected = { { 0x8fc03bf950e7d473UL, 0xf98c50effa335698UL, 0xce1a02d608b57341UL, 0xa7bb76979aba3b6UL }, - { 0xc5d3b0ccb73d588aUL, 0x33bd1a3257e1d33bUL, 0xbd81e76b5bc42e4bUL, 0x207397eaa3ee9c34UL } }; -#endif fq2 result = a + b; EXPECT_EQ(result, expected); } TEST(fq2, SubCheckAgainstConstants) { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq2 a = { { 0x3212c3a7d7886da5, 0xcea893f4addae4aa, 0x5c8bfca7a7ed01be, 0x1a8e9dfecd598ef1 }, { 0x4a8d9e6443fda462, 0x93248a3fde6374e7, 0xf4a6c52f75c0fc2e, 0x270aaabb4ae43370 } }; fq2 b = { { 0x875cef17b3b46751, 0xbba7211cb92b554b, 0xa4790f1657f85606, 0x74e61182f5b5068 }, { 0x8a84fff282dfd5a3, 0x77986fd41c21a7a3, 0xdc7072908fe375a9, 0x2e98a18c7d570269 } }; fq2 expected = { { 0xaab5d49023d40654, 0x130172d7f4af8f5e, 0xb812ed914ff4abb8, 0x13403ce69dfe3e88 }, { 0xfc292a88999acc06, 0xb30d84fd2ab397d0, 0xd0869855675edee2, 0x28d657a1aebed130 } }; -#else - fq2 a = { { 0x442f277690c0e2e9UL, 0xc57a6aedcbce21e5UL, 0x542af3d6640959a2UL, 0x1b2a8a38b6e63b66UL }, - { 0x72861e4d5b7fd051UL, 0x98eddfc89951d51eUL, 0x9501d71c127de4aeUL, 0x2789ae315eadca0bUL } }; - fq2 b = { { 0xfb1bb29b1498f504UL, 0x16de795183a37f3bUL, 0xade0cbf0f9055f61UL, 0x283ae93a66a38c6dUL }, - { 0x44cf93a2fd55060eUL, 0x31e37d7946df37e4UL, 0xf4a626aecf465a37UL, 0x27530019470f8857UL } }; - fq2 expected = { { 0x853400f254a4eb2cUL, 0x461d5c2db09c6d36UL, 0x5e9a6d9bec85529fUL, 0x2353ef7131744f22UL }, - { 0x2db68aaa5e2aca43UL, 0x670a624f52729d3aUL, 0xa05bb06d43378a77UL, 0x36ae18179e41b3UL } }; -#endif - fq2 result = a - b; EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp index ca86ae26203..360b5d140d6 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.hpp @@ -6,8 +6,6 @@ namespace bb { struct Bn254Fq6Params { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 frobenius_coeffs_c1_1{ { 0xb5773b104563ab30UL, 0x347f91c8a9aa6454UL, 0x7a007127242e0991UL, 0x1956bcd8118214ecUL }, { 0x6e849f1ea0aa4757UL, 0xaa1c7b6d89f89141UL, 0xb6e713cdfae0ca3aUL, 0x26694fbb4e82ebc3UL } @@ -37,36 +35,6 @@ struct Bn254Fq6Params { { 0x448a93a57b6762dfUL, 0xbfd62df528fdeadfUL, 0xd858f5d00e9bd47aUL, 0x06b03d4d3476ec58UL }, { 0x2b19daf4bcc936d1UL, 0xa1a54e7a56f4299fUL, 0xb533eee05adeaef1UL, 0x170c812b84dda0b2UL } }; -#else - static constexpr fq2 frobenius_coeffs_c1_1{ - { 0xecdea09b24a59190UL, 0x17db8ffeae2fe1c2UL, 0xbb09c97c6dabac4dUL, 0x2492b3d41d289af3UL }, - { 0xf1663598f1142ef1UL, 0x77ec057e0bf56062UL, 0xdd0baaecb677a631UL, 0x135e4e31d284d463UL } - }; - - static constexpr fq2 frobenius_coeffs_c1_2{ - { 0x8aeb638758ccb791UL, 0xee27476838ae0f5bUL, 0x5fc8441d09282bUL, 0x169119a8426a57f9UL }, { 0UL, 0UL, 0UL, 0UL } - }; - - static constexpr fq2 frobenius_coeffs_c1_3{ - { 0x4738e103136caecdUL, 0xf491475bc376b8c3UL, 0x1f4034a3a97cbee8UL, 0xcad5f8fef61ccd7UL }, - { 0x2f41c395e6e485d6UL, 0x997230c70242aa46UL, 0xeae16f2184887ab5UL, 0x266696f73bcfc9b2UL } - }; - - static constexpr fq2 frobenius_coeffs_c2_1{ - { 0x227346b0b081f85eUL, 0x6e51a67130492bb5UL, 0x7e20162e52b19e16UL, 0x1677516f2343bb4bUL }, - { 0x18b280852f616a78UL, 0x25433712bde06eceUL, 0xb00a58256b9a0e66UL, 0x6f9f8e111971bbdUL } - }; - - static constexpr fq2 frobenius_coeffs_c2_2{ - { 0x62b1a3a46a337995UL, 0xadc97d2722e2726eUL, 0x64ee82ede2db85faUL, 0xc0afea1488a03bbUL }, - { 0UL, 0UL, 0UL, 0UL } - }; - - static constexpr fq2 frobenius_coeffs_c2_3{ - { 0xa0d044540af866c4UL, 0x9cc0145f7df631b3UL, 0x29dda327cd752de1UL, 0x14766fdb0a170a74UL }, - { 0xdd532940e9d402f7UL, 0x541490c5bfda559eUL, 0xd9c9c659c541b0b8UL, 0xbaf8cb569cbb3e4UL } - }; -#endif // non residue = 9 + i \in Fq2 static inline constexpr fq2 mul_by_non_residue(const fq2& a) diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp index cc0c7e45abb..370abd9a6e7 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fq6.test.cpp @@ -92,7 +92,6 @@ TEST(fq6, AddCheckAgainstConstants) { 0xf2431be14b4df482, 0xc9bb05cb691445b8, 0xf02ed57856eb46bb, 0x16dbf34bb8373fd5 } }, { { 0x8d683ec33bd2d09f, 0xbb76c48d1ad7befe, 0xfc20598f07f9868f, 0x2251f84b9cb740d7 }, { 0x91137730616d416f, 0x7892e5f10d06fc71, 0x7115b23cadf2176, 0x243b593fe662d53 } } }; - fq6 result = a + b; EXPECT_EQ(result, expected); } @@ -123,7 +122,6 @@ TEST(fq6, SubCheckAgainstConstants) TEST(fq6, MulCheckAgainstConstants) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq6 a{ { { 0xa7e3494fc528b8c8, 0xc8c8906c9682e43f, 0xc6e76fc21152721c, 0x12a4c3ee3ff10dbd }, { 0x887ce62a3ae2a578, 0x70caee28e1942bac, 0xc1a58242c34ff94f, 0x0b154d910b492542 } }, { { 0x8c885006cc08667a, 0xee0b6c4a0dbb9592, 0xa755229d6272b51e, 0x2629b93f67eb8dd6 }, @@ -142,35 +140,12 @@ TEST(fq6, MulCheckAgainstConstants) { 0x4b2fbc422420f06a, 0x3a8e5b388fdedd1f, 0x06006b4471134540, 0x0d4fee4f7966d63d } }, { { 0x4ffcbaa876979a1c, 0x32b7c1ef7d251306, 0x1b4e0712f969804e, 0x200592dfe71b710f }, { 0xe3eb378754bfb1ac, 0x6b517c1cae53d784, 0xd1b29c0eb1e4d46f, 0x08b42f13fdd14172 } } }; -#else - fq6 a{ { { 0x2ae298e67f3b39acUL, 0xff010ec1eb070956UL, 0x392ab3b4183e1f35UL, 0xfe4d0656fce35c4UL }, - { 0x6ab8f0a770e9c20fUL, 0xf4d3db225768ebb4UL, 0x2a7e605adf75bf5eUL, 0xfeb8cfd40c94734UL } }, - { { 0xb1dc529e5cd81351UL, 0xf5ca210e8455ea86UL, 0xeacd84d9a8b502b9UL, 0xb6b7eb4ff9916c1UL }, - { 0xdb94de41ad3b48d0UL, 0x5953eb9473583fe8UL, 0xa603759c9ad36f81UL, 0x229e55e6aa957e6UL } }, - { { 0x3c0c61a8882bdd6cUL, 0xd8fe0e66857b4d54UL, 0xb39ce4d438c3eb07UL, 0x2c6333d09ff65713UL }, - { 0x79d7e64184f4cbb1UL, 0x46523cfdd9722bd8UL, 0xdb3fdb38faf61435UL, 0xe8198361076a5a5UL } } }; - fq6 b{ { { 0x1ac3b1e7ec8a731cUL, 0xbb7de52d99e73d29UL, 0x4caac2356d446d23UL, 0x929876b197c1767UL }, - { 0x46e1737df8be5c58UL, 0x3d2d14ad3aa1890cUL, 0x659c80230fad0fa0UL, 0xd47f2fbefb5fbabUL } }, - { { 0x8b4d2a252c11fd02UL, 0x415b985e57d8c07aUL, 0x864441c79f72d7b5UL, 0x143306f7ce4da3aeUL }, - { 0xd76ea5fe36f41c42UL, 0xc546a55497cb7e0aUL, 0x6027b6dc6f841d13UL, 0x2d7f5a564d5981b5UL } }, - { { 0xf8fced7f8d6ce98UL, 0x46d85360675c5f7bUL, 0x663867cd6a61f912UL, 0x1c3fbd1c4728ce2fUL }, - { 0xd7681e6bff8abe8bUL, 0x951b03f1bffa2c2fUL, 0x66fd7a89c9ec33b2UL, 0xc425d325d08a85fUL } } }; - fq6 expected{ { { 0xccc2041ef7e674a1UL, 0xf2f0e47f82792d77UL, 0xb4b9f006110451c9UL, 0xdae59051f5a8c62UL }, - { 0x9482d60673539368UL, 0x42c40af4541687e4UL, 0x67c6919c35403c12UL, 0xb8254cf01cba09eUL } }, - { { 0x3b942b02bf094a1UL, 0xff838144f8716d23UL, 0x8530532ec620bef1UL, 0x25d5c85a56786593UL }, - { 0x84f3278dc0362308UL, 0x95c01286b84d4f7fUL, 0xfd8b3ada165de51aUL, 0x26db5658234dc652UL } }, - { { 0x10ebd72f10b27cadUL, 0xe95a8002134cc334UL, 0x4b2b2a668d93ca18UL, 0x877ec906a5bfe77UL }, - { 0x50c434785d85431dUL, 0x74a86ebec041fbdaUL, 0x9cc22545b513d419UL, 0x24905a4154300d89UL } } }; -#endif - fq6 result = a * b; EXPECT_EQ(result, expected); } TEST(fq6, SqrCheckAgainstConstants) { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) fq6 a{ { { 0xe337aaa063afce6, 0xff4b5477485eb20, 0xef6dcf13b3855ef8, 0x14554c38da988ece }, { 0x6a70e65e71431416, 0xd21f95045c45f422, 0x2a17b6c6ff517884, 0x1b01ad6487a3ff16 } }, { { 0xea39618e9f05e1f, 0x63e9b0f7803072a6, 0xebe5538a2c75c89, 0x5312aad2ac95dcf }, @@ -183,21 +158,6 @@ TEST(fq6, SqrCheckAgainstConstants) { 0xd48ac80d8e6e52b5, 0x1791b8c4145bc2d3, 0x35c456444cdcf9be, 0x1eddd29d77366c08 } }, { { 0x56f1f8acbaed1118, 0xdd74b8bb2e47de74, 0x97525aa49c65f0fd, 0x15bbf236e098fa0f }, { 0xad97a94142524aeb, 0x42a508523527268b, 0x4c9c5f213de06ca8, 0x73fa6bc31efa2f2 } } }; -#else - fq6 a{ { { 0xb8c83817c906c025UL, 0x4d043f8c42f61ad5UL, 0x91a65831dd1a6241UL, 0x15918b45e38cb7bfUL }, - { 0x4ff37e49c815b109UL, 0x345a8ce3993010ecUL, 0x5a237c150983263UL, 0x298c76f000344000UL } }, - { { 0x20111ed8b494cc0bUL, 0xb6b1df3bccb8f51aUL, 0xaed9d5f0d4678813UL, 0x14f86a4cb596d964UL }, - { 0x69bc7d9504b28c8fUL, 0xe0d8603ce6221c7bUL, 0x23ca4fa0d532663fUL, 0x1a80d9d5b362f1a2UL } }, - { { 0x25eb400748a0cf37UL, 0x89d64fd9d5bf6d15UL, 0x5d26ffdaa12d840cUL, 0x2569403a2168757UL }, - { 0xcdec65e163c03266UL, 0xd10e3957cf3b72b0UL, 0xec521e4d37493492UL, 0x129d95f2098a2ca4UL } } }; - fq6 expected{ { { 0x3c4bcc8dcefcaceeUL, 0x34ab9174317f1e3aUL, 0x1ef0e16468a08463UL, 0x15d11e13ea53477bUL }, - { 0xa863e40cfbb3daa5UL, 0xce21a9ece91fa28dUL, 0x18f8b8d5131d5b16UL, 0x217cae35f576c1cUL } }, - { { 0xc9c6c70ba08b73c0UL, 0xcad2cccbf550a886UL, 0xfc81330087d97569UL, 0x887ec11880851c1UL }, - { 0xdece0fe8e4068d14UL, 0x1c1ac52662948771UL, 0x524556477d845073UL, 0x13e432b54eecfdc4UL } }, - { { 0x94776c5786cc491eUL, 0x6583437212c2bad1UL, 0xd5e7849877ab4a9dUL, 0x1201fc93c2687faaUL }, - { 0xc272f7cce8556844UL, 0xf69b6001031da740UL, 0xb24acd4db6083391UL, 0x26639dbab92ddda2UL } } }; -#endif - fq6 result = a.sqr(); EXPECT_EQ(result, expected); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp index fcf2bc16a55..cf43e95d569 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.hpp @@ -63,49 +63,6 @@ class Bn254FrParams { 0x463456c802275bedULL, 0x543ece899c2f3b1cULL, 0x180a96573d3d9f8ULL, 0xf8b21270ddbb927ULL, 0x1d9598e8a7e39857ULL, 0x2ba010aa41eb7786ULL, 0x39aa886bdbf356b5ULL, 0x47b5002d75fb35e5ULL, }; - - static constexpr uint64_t modulus_wasm_0 = 0x10000001; - static constexpr uint64_t modulus_wasm_1 = 0x1f0fac9f; - static constexpr uint64_t modulus_wasm_2 = 0xe5c2450; - static constexpr uint64_t modulus_wasm_3 = 0x7d090f3; - static constexpr uint64_t modulus_wasm_4 = 0x1585d283; - static constexpr uint64_t modulus_wasm_5 = 0x2db40c0; - static constexpr uint64_t modulus_wasm_6 = 0xa6e141; - static constexpr uint64_t modulus_wasm_7 = 0xe5c2634; - static constexpr uint64_t modulus_wasm_8 = 0x30644e; - - static constexpr uint64_t r_squared_wasm_0 = 0x38c2e14b45b69bd4UL; - static constexpr uint64_t r_squared_wasm_1 = 0x0ffedb1885883377UL; - static constexpr uint64_t r_squared_wasm_2 = 0x7840f9f0abc6e54dUL; - static constexpr uint64_t r_squared_wasm_3 = 0x0a054a3e848b0f05UL; - - static constexpr uint64_t cube_root_wasm_0 = 0x7334a1ce7065364dUL; - static constexpr uint64_t cube_root_wasm_1 = 0xae21578e4a14d22aUL; - static constexpr uint64_t cube_root_wasm_2 = 0xcea2148a96b51265UL; - static constexpr uint64_t cube_root_wasm_3 = 0x0038f7edf614a198UL; - - static constexpr uint64_t primitive_root_wasm_0 = 0x2faf11711a27b370UL; - static constexpr uint64_t primitive_root_wasm_1 = 0xc23fe9fced28f1b8UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x43a0fc9bbe2af541UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x05d90b5719653a4fUL; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0xab46711cdffffcb2ULL, 0xdb1b52736ffffc09ULL, - 0x0af033c9fffffb60ULL, 0xf6e31f8c9ffffab6ULL, - 0x26b800e32ffffa0dULL, 0x568ce239bffff964ULL, - 0x427fcdfc5ffff8baULL, 0x7254af52effff811ULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0x2476607dbd2dfff1ULL, 0x9a3208a561c2b00bULL, - 0x0fedb0cd06576026ULL, 0x5d7570ac31329faeULL, - 0xd33118d3d5c74fc9ULL, 0x48ecc0fb7a5bffe3ULL, - 0x967480daa5373f6cULL, 0x0c30290249cbef86ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0xe6b99ee0068dfc25ULL, 0x39bb9964882aa6a5ULL, - 0x8cbd93e909c75126ULL, 0x276f48b709e2a349ULL, - 0x7a71433b8b7f4dc9ULL, 0xcd733dc00d1bf84aULL, - 0x6824f28e0d374a6dULL, 0xbb26ed128ed3f4eeULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x1484c05bce00b620ULL, 0x224cf685243dfa96ULL, - 0x30152cae7a7b3f0bULL, 0x0d791464ef86e357ULL, - 0x1b414a8e45c427ccULL, 0x290980b79c016c41ULL, - 0x066d686e110d108dULL, 0x14359e97674a5502ULL }; - // used in msgpack schema serialization static constexpr char schema_name[] = "fr"; static constexpr bool has_high_2adicity = true; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp index 7d2d89edd04..2b2fa35fb75 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/fr.test.cpp @@ -56,12 +56,9 @@ TEST(fr, RandomElement) TEST(fr, Mul) { - auto a_uint = uint256_t{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; - auto b_uint = uint256_t{ 0x7aade4892631231c, 0x8e7515681fe70144, 0x98edb76e689b6fd8, 0x5d0886b15fc835fa }; - - fr a = a_uint; - fr b = b_uint; - fr expected = (uint512_t(a_uint) * uint512_t(b_uint) % uint512_t(fr::modulus)).lo; + fr a{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; + fr b{ 0x7aade4892631231c, 0x8e7515681fe70144, 0x98edb76e689b6fd8, 0x5d0886b15fc835fa }; + fr expected{ 0xab961ef46b4756b6, 0xbc6b636fc29678c8, 0xd247391ed6b5bd16, 0x12e8538b3bde6784 }; fr result; result = a * b; EXPECT_EQ((result == expected), true); @@ -69,9 +66,8 @@ TEST(fr, Mul) TEST(fr, Sqr) { - auto a_uint = uint256_t{ 0x192f9ddc938ea63, 0x1db93d61007ec4fe, 0xc89284ec31fa49c0, 0x2478d0ff12b04f0f }; - fr a = a_uint; - fr expected = (uint512_t(a_uint) * uint512_t(a_uint) % uint512_t(fr::modulus)).lo; + fr a{ 0x95f946723a1fc34f, 0x641ec0482fc40bb9, 0xb8d645bc49dd513d, 0x1c1bffd317599dbc }; + fr expected{ 0xc787f7d9e2c72714, 0xcf21cf53d8f65f67, 0x8db109903dac0008, 0x26ab4dd65f46be5f }; fr result; result = a.sqr(); EXPECT_EQ((result == expected), true); diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp index 28cd3036eba..ef5240fad94 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g1.hpp @@ -11,17 +11,9 @@ struct Bn254G1Params { static constexpr bool small_elements = true; static constexpr bool has_a = false; static constexpr fq one_x = fq::one(); -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq one_y{ 0xa6ba871b8b1e1b3aUL, 0x14f1d651eb8e167bUL, 0xccdd46def0f28c58UL, 0x1c14ef83340fbe5eUL }; -#else - static constexpr fq one_y{ 0x9d0709d62af99842UL, 0xf7214c0419c29186UL, 0xa603f5090339546dUL, 0x1b906c52ac7a88eaUL }; -#endif static constexpr fq a{ 0UL, 0UL, 0UL, 0UL }; -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq b{ 0x7a17caa950ad28d7UL, 0x1f6ac17ae15521b9UL, 0x334bea4e696bd284UL, 0x2a1f6744ce179d8eUL }; -#else - static constexpr fq b{ 0xeb8a8ec140766463UL, 0xf2b1f20626a3da49UL, 0xf905ef8d84d5fea4UL, 0x2958a27c02b7cd5fUL }; -#endif }; using g1 = group; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp index 78ede0cdc98..37c84d4517d 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/bn254/g2.hpp @@ -11,21 +11,10 @@ struct Bn254G2Params { static constexpr bool small_elements = false; static constexpr bool has_a = false; -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr fq2 one_x{ { 0x8e83b5d102bc2026, 0xdceb1935497b0172, 0xfbb8264797811adf, 0x19573841af96503b }, { 0xafb4737da84c6140, 0x6043dd5a5802d8c4, 0x09e950fc52a02f86, 0x14fef0833aea7b6b } }; static constexpr fq2 one_y{ { 0x619dfa9d886be9f6, 0xfe7fd297f59e9b78, 0xff9e1a62231b7dfe, 0x28fd7eebae9e4206 }, { 0x64095b56c71856ee, 0xdc57f922327d3cbb, 0x55f935be33351076, 0x0da4a0e693fd6482 } }; -#else - static constexpr fq2 one_x{ - { 0xe6df8b2cfb43050UL, 0x254c7d92a843857eUL, 0xf2006d8ad80dd622UL, 0x24a22107dfb004e3UL }, - { 0xe8e7528c0b334b65UL, 0x56e941e8b293cf69UL, 0xe1169545c074740bUL, 0x2ac61491edca4b42UL } - }; - static constexpr fq2 one_y{ - { 0xdc508d48384e8843UL, 0xd55415a8afd31226UL, 0x834bf204bacb6e00UL, 0x51b9758138c5c79UL }, - { 0x64067e0b46a5f641UL, 0x37726529a3a77875UL, 0x4454445bd915f391UL, 0x10d5ac894edeed3UL } - }; -#endif static constexpr fq2 a = fq2::zero(); static constexpr fq2 b = fq2::twist_coeff_b(); }; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp index fc81216686a..fd6e1c36268 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/grumpkin/grumpkin.hpp @@ -16,25 +16,15 @@ struct G1Params { static constexpr bool can_hash_to_curve = true; static constexpr bool small_elements = true; static constexpr bool has_a = false; -// have checked in grumpkin.test_b that b is Montgomery form of -17 -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) + // have checked in grumpkin.test_b that b is Montgomery form of -17 static constexpr bb::fr b{ 0xdd7056026000005a, 0x223fa97acb319311, 0xcc388229877910c0, 0x34394632b724eaa }; -#else - static constexpr bb::fr b{ 0x2646d52420000b3eUL, 0xf78d5ec872bf8119UL, 0x166fb9c3ec1f6749UL, 0x7a9ef7fabe69506UL }; -#endif static constexpr bb::fr a{ 0UL, 0UL, 0UL, 0UL }; // generator point = (x, y) = (1, sqrt(-16)), sqrt(-16) = 4i static constexpr bb::fr one_x = bb::fr::one(); -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) static constexpr bb::fr one_y{ 0x11b2dff1448c41d8UL, 0x23d3446f21c77dc3UL, 0xaa7b8cf435dfafbbUL, 0x14b34cf69dc25d68UL }; -#else - static constexpr bb::fr one_y{ - 0xc3e285a561883af3UL, 0x6fc5c2360a850101UL, 0xf35e144228647aa9UL, 0x2151a2fe48c68af6UL - }; -#endif }; using g1 = bb::group; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp index 81b575ad67b..1d78dd1b3d1 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.hpp @@ -43,48 +43,6 @@ struct FqParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; - - static constexpr uint64_t modulus_wasm_0 = 0x1ffffc2f; - static constexpr uint64_t modulus_wasm_1 = 0x1ffffff7; - static constexpr uint64_t modulus_wasm_2 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_3 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_4 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_6 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_7 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_8 = 0xffffff; - - static constexpr uint64_t r_squared_wasm_0 = 0x001e88003a428400UL; - static constexpr uint64_t r_squared_wasm_1 = 0x0000000000000400UL; - static constexpr uint64_t r_squared_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t r_squared_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t cube_root_wasm_0 = 0x1486c3a0d03162ffUL; - static constexpr uint64_t cube_root_wasm_1 = 0x7fbc2c63897015ebUL; - static constexpr uint64_t cube_root_wasm_2 = 0x1d312f1a05c720a0UL; - static constexpr uint64_t cube_root_wasm_3 = 0x4946d5d79767aa7fUL; - - static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0x0000006000016e60ULL, 0x000000800001e880ULL, - 0x000000a0000262a0ULL, 0x000000c00002dcc0ULL, - 0x000000e0000356e0ULL, 0x000001000003d100ULL, - 0x0000012000044b20ULL, 0x000001400004c540ULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL }; }; using fq = field; @@ -141,48 +99,6 @@ struct FrParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; - - static constexpr uint64_t modulus_wasm_0 = 0x10364141; - static constexpr uint64_t modulus_wasm_1 = 0x1e92f466; - static constexpr uint64_t modulus_wasm_2 = 0x12280eef; - static constexpr uint64_t modulus_wasm_3 = 0x1db9cd5e; - static constexpr uint64_t modulus_wasm_4 = 0x1fffebaa; - static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_6 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_7 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_8 = 0xffffff; - - static constexpr uint64_t r_squared_wasm_0 = 0x63e601a3c9f6ab4bUL; - static constexpr uint64_t r_squared_wasm_1 = 0xa2b6456d46702f57UL; - static constexpr uint64_t r_squared_wasm_2 = 0x5fd7916f341f1cefUL; - static constexpr uint64_t r_squared_wasm_3 = 0x9c7356071a6f179aUL; - - static constexpr uint64_t cube_root_wasm_0 = 0x9185b639102f0736UL; - static constexpr uint64_t cube_root_wasm_1 = 0x47a854ad9ffc4748UL; - static constexpr uint64_t cube_root_wasm_2 = 0x752cc0ca4d2fb232UL; - static constexpr uint64_t cube_root_wasm_3 = 0x650802f0ab1ac72eUL; - - static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0x1c84e7fdde173760ULL, 0x22391663d74f0f40ULL, - 0x27ed44c9d086e720ULL, 0x2da1732fc9bebf00ULL, - 0x3355a195c2f696e0ULL, 0x3909cffbbc2e6ec0ULL, - 0x3ebdfe61b56646a0ULL, 0x44722cc7ae9e1e80ULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0x52b5efd2729bdaa8ULL, 0xfcda52fc8987d330ULL, - 0xa6feb626a073cbb8ULL, 0x51231950b75fc440ULL, - 0xfb477c7ace4bbcc8ULL, 0xa56bdfa4e537b550ULL, - 0x4f9042cefc23add8ULL, 0xf9b4a5f9130fa660ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0x00000000000000cbULL, 0x00000000000000f3ULL, - 0x000000000000011cULL, 0x0000000000000145ULL, - 0x000000000000016dULL, 0x0000000000000196ULL, - 0x00000000000001bfULL, 0x00000000000001e7ULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL, - 0x0000000000000000ULL, 0x0000000000000000ULL }; }; using fr = field; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp index 60d0f24af2a..82902e1c3f8 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256k1/secp256k1.test.cpp @@ -70,11 +70,7 @@ TEST(secp256k1, TestToMontgomeryForm) uint256_t a_raw = get_fq_element(); secp256k1::fq montgomery_result(a_raw); -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) - constexpr uint512_t R = uint512_t(0, 1); -#else - constexpr uint512_t R = (uint512_t(1) << (29 * 9)) % uint512_t(test_fq_mod); -#endif + uint512_t R = uint512_t(0, 1); uint512_t aR = uint512_t(a_raw) * R; uint256_t expected = (aR % uint512_t(test_fq_mod)).lo; @@ -446,9 +442,6 @@ TEST(secp256k1, GetEndomorphismScalars) expected.self_from_montgomery_form(); EXPECT_EQ(k, expected); - if (k != expected) { - break; - } } } diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp index 69e8e89b477..3835bfce10f 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.hpp @@ -8,7 +8,7 @@ namespace bb::secp256r1 { struct FqParams { static constexpr uint64_t modulus_0 = 0xFFFFFFFFFFFFFFFFULL; static constexpr uint64_t modulus_1 = 0x00000000FFFFFFFFULL; - static constexpr uint64_t modulus_2 = 0x0000000000000000ULL; + static constexpr uint64_t modulus_2 = 0X0000000000000000ULL; static constexpr uint64_t modulus_3 = 0xFFFFFFFF00000001ULL; static constexpr uint64_t r_squared_0 = 3ULL; @@ -42,48 +42,6 @@ struct FqParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; - - static constexpr uint64_t modulus_wasm_0 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_1 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_2 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_3 = 0x1ff; - static constexpr uint64_t modulus_wasm_4 = 0x0; - static constexpr uint64_t modulus_wasm_5 = 0x0; - static constexpr uint64_t modulus_wasm_6 = 0x40000; - static constexpr uint64_t modulus_wasm_7 = 0x1fe00000; - static constexpr uint64_t modulus_wasm_8 = 0xffffff; - - static constexpr uint64_t r_squared_wasm_0 = 0x0000000000000c00UL; - static constexpr uint64_t r_squared_wasm_1 = 0xffffeffffffffc00UL; - static constexpr uint64_t r_squared_wasm_2 = 0xfffffffffffffbffUL; - static constexpr uint64_t r_squared_wasm_3 = 0x000013fffffff7ffUL; - - static constexpr uint64_t cube_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0x0000000000000060ULL, 0x0000000000000080ULL, - 0x00000000000000a0ULL, 0x00000000000000c0ULL, - 0x00000000000000e0ULL, 0x0000000000000100ULL, - 0x0000000000000120ULL, 0x0000000000000140ULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0xffffffa000000000ULL, 0xffffff8000000000ULL, - 0xffffff6000000000ULL, 0xffffff4000000000ULL, - 0xffffff2000000000ULL, 0xffffff0000000000ULL, - 0xfffffee000000000ULL, 0xfffffec000000000ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0xffffffffffffffffULL, 0xffffffffffffffffULL, - 0xffffffffffffffffULL, 0xffffffffffffffffULL, - 0xffffffffffffffffULL, 0xffffffffffffffffULL, - 0xffffffffffffffffULL, 0xffffffffffffffffULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x0000005fffffff9fULL, 0x0000007fffffff7fULL, - 0x0000009fffffff5fULL, 0x000000bfffffff3fULL, - 0x000000dfffffff1fULL, 0x000000fffffffeffULL, - 0x0000011ffffffedfULL, 0x0000013ffffffebfULL }; }; using fq = field; @@ -125,48 +83,6 @@ struct FrParams { static constexpr uint64_t primitive_root_1 = 0UL; static constexpr uint64_t primitive_root_2 = 0UL; static constexpr uint64_t primitive_root_3 = 0UL; - - static constexpr uint64_t modulus_wasm_0 = 0x1c632551; - static constexpr uint64_t modulus_wasm_1 = 0x1dce5617; - static constexpr uint64_t modulus_wasm_2 = 0x5e7a13c; - static constexpr uint64_t modulus_wasm_3 = 0xdf55b4e; - static constexpr uint64_t modulus_wasm_4 = 0x1ffffbce; - static constexpr uint64_t modulus_wasm_5 = 0x1fffffff; - static constexpr uint64_t modulus_wasm_6 = 0x3ffff; - static constexpr uint64_t modulus_wasm_7 = 0x1fe00000; - static constexpr uint64_t modulus_wasm_8 = 0xffffff; - - static constexpr uint64_t r_squared_wasm_0 = 0x45e9cfeeb48d9ef5UL; - static constexpr uint64_t r_squared_wasm_1 = 0x1f11fc5bb2d31a99UL; - static constexpr uint64_t r_squared_wasm_2 = 0x16c8e4adafb16586UL; - static constexpr uint64_t r_squared_wasm_3 = 0x84b6556a65587f06UL; - - static constexpr uint64_t cube_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t cube_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t primitive_root_wasm_0 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_1 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_2 = 0x0000000000000000UL; - static constexpr uint64_t primitive_root_wasm_3 = 0x0000000000000000UL; - - static constexpr uint64_t coset_generators_wasm_0[8] = { 0xbd6e9563293f5920ULL, 0x46353d039cdaaf00ULL, - 0xcefbe4a4107604e0ULL, 0x57c28c4484115ac0ULL, - 0xe08933e4f7acb0a0ULL, 0x694fdb856b480680ULL, - 0xf2168325dee35c60ULL, 0x7add2ac6527eb240ULL }; - static constexpr uint64_t coset_generators_wasm_1[8] = { 0xb5e4a80dcb554baaULL, 0x19055258e8617b0cULL, - 0x7c25fca4056daa6dULL, 0xdf46a6ef2279d9cfULL, - 0x4267513a3f860930ULL, 0xa587fb855c923892ULL, - 0x08a8a5d0799e67f3ULL, 0x6bc9501b96aa9755ULL }; - static constexpr uint64_t coset_generators_wasm_2[8] = { 0x000000000000003aULL, 0x0000000000000043ULL, - 0x000000000000004bULL, 0x0000000000000053ULL, - 0x000000000000005cULL, 0x0000000000000064ULL, - 0x000000000000006dULL, 0x0000000000000075ULL }; - static constexpr uint64_t coset_generators_wasm_3[8] = { 0x000000dfffffff20ULL, 0x000000ffffffff00ULL, - 0x0000011ffffffee0ULL, 0x0000013ffffffec0ULL, - 0x0000015ffffffea0ULL, 0x0000017ffffffe80ULL, - 0x0000019ffffffe60ULL, 0x000001bffffffe40ULL }; }; using fr = field; diff --git a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp index 0b2befbb745..3e993586242 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/ecc/curves/secp256r1/secp256r1.test.cpp @@ -70,11 +70,7 @@ TEST(secp256r1, TestToMontgomeryForm) uint256_t a_raw = get_fq_element(); secp256r1::fq montgomery_result(a_raw); -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) - constexpr uint512_t R = uint512_t(0, 1); -#else - constexpr uint512_t R = (uint512_t(1) << (29 * 9)) % uint512_t(test_fq_mod); -#endif + uint512_t R = uint512_t(0, 1); uint512_t aR = uint512_t(a_raw) * R; uint256_t expected = (aR % uint512_t(test_fq_mod)).lo; @@ -438,7 +434,6 @@ TEST(secp256r1, check_compression_constructor) std::cout << "Affine element: " << el << std::endl; }**/ -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) TEST(secp256r1, MontgomeryMulBigBug) { secp256r1::fr a; @@ -450,4 +445,3 @@ TEST(secp256r1, MontgomeryMulBigBug) secp256r1::fr expected(uint256_t{ 0x57abc6aa0349c084, 0x65b21b232a4cb7a5, 0x5ba781948b0fcd6e, 0xd6e9e0644bda12f7 }); EXPECT_EQ((a_sqr == expected), true); } -#endif \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp index 18a7480a3d0..87a10938677 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_declarations.hpp @@ -21,11 +21,6 @@ #endif namespace bb { -/** - * @brief General class for prime fields see \ref field_docs["field documentation"] for general implementation reference - * - * @tparam Params_ - */ template struct alignas(32) field { public: using View = field; @@ -35,11 +30,6 @@ template struct alignas(32) field { using out_buf = uint8_t*; using vec_out_buf = uint8_t**; -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) -#define WASM_NUM_LIMBS 9 -#define WASM_LIMB_BITS 29 -#endif - // We don't initialize data in the default constructor since we'd lose a lot of time on huge array initializations. // Other alternatives have been noted, such as casting to get around constructors where they matter, // however it is felt that sanitizer tools (e.g. MSAN) can detect garbage well, whereas doing @@ -169,34 +159,14 @@ template struct alignas(32) field { static constexpr uint256_t modulus = uint256_t{ Params::modulus_0, Params::modulus_1, Params::modulus_2, Params::modulus_3 }; -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) - static constexpr uint256_t r_squared_uint{ - Params_::r_squared_0, Params_::r_squared_1, Params_::r_squared_2, Params_::r_squared_3 - }; -#else - static constexpr uint256_t r_squared_uint{ - Params_::r_squared_wasm_0, Params_::r_squared_wasm_1, Params_::r_squared_wasm_2, Params_::r_squared_wasm_3 - }; - static constexpr std::array wasm_modulus = { Params::modulus_wasm_0, Params::modulus_wasm_1, - Params::modulus_wasm_2, Params::modulus_wasm_3, - Params::modulus_wasm_4, Params::modulus_wasm_5, - Params::modulus_wasm_6, Params::modulus_wasm_7, - Params::modulus_wasm_8 }; -#endif static constexpr field cube_root_of_unity() { // endomorphism i.e. lambda * [P] = (beta * x, y) if constexpr (Params::cube_root_0 != 0) { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) constexpr field result{ Params::cube_root_0, Params::cube_root_1, Params::cube_root_2, Params::cube_root_3 }; -#else - constexpr field result{ - Params::cube_root_wasm_0, Params::cube_root_wasm_1, Params::cube_root_wasm_2, Params::cube_root_wasm_3 - }; -#endif return result; } else { constexpr field two_inv = field(2).invert(); @@ -212,65 +182,35 @@ template struct alignas(32) field { static constexpr field external_coset_generator() { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[7], Params::coset_generators_1[7], Params::coset_generators_2[7], Params::coset_generators_3[7], }; -#else - const field result{ - Params::coset_generators_wasm_0[7], - Params::coset_generators_wasm_1[7], - Params::coset_generators_wasm_2[7], - Params::coset_generators_wasm_3[7], - }; -#endif - return result; } static constexpr field tag_coset_generator() { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[6], Params::coset_generators_1[6], Params::coset_generators_2[6], Params::coset_generators_3[6], }; -#else - const field result{ - Params::coset_generators_wasm_0[6], - Params::coset_generators_wasm_1[6], - Params::coset_generators_wasm_2[6], - Params::coset_generators_wasm_3[6], - }; -#endif - return result; } static constexpr field coset_generator(const size_t idx) { ASSERT(idx < 7); -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const field result{ Params::coset_generators_0[idx], Params::coset_generators_1[idx], Params::coset_generators_2[idx], Params::coset_generators_3[idx], }; -#else - const field result{ - Params::coset_generators_wasm_0[idx], - Params::coset_generators_wasm_1[idx], - Params::coset_generators_wasm_2[idx], - Params::coset_generators_wasm_3[idx], - }; -#endif - return result; } @@ -307,7 +247,6 @@ template struct alignas(32) field { BB_INLINE constexpr field pow(const uint256_t& exponent) const noexcept; BB_INLINE constexpr field pow(uint64_t exponent) const noexcept; - static_assert(Params::modulus_0 != 1); static constexpr uint256_t modulus_minus_two = uint256_t(Params::modulus_0 - 2ULL, Params::modulus_1, Params::modulus_2, Params::modulus_3); constexpr field invert() const noexcept; @@ -581,29 +520,6 @@ template struct alignas(32) field { {} }; -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) - BB_INLINE static constexpr void wasm_madd(uint64_t& left_limb, - const std::array& right_limbs, - uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8); - BB_INLINE static constexpr void wasm_reduce(uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8); - BB_INLINE static constexpr std::array wasm_convert(const uint64_t* data); -#endif BB_INLINE static constexpr std::pair mul_wide(uint64_t a, uint64_t b) noexcept; BB_INLINE static constexpr uint64_t mac( diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md b/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md deleted file mode 100644 index 76f1bc30643..00000000000 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_docs.md +++ /dev/null @@ -1,190 +0,0 @@ -Prime field documentation {#field_docs} -=== -Barretenberg has its own implementation of finite field arithmetic. The implementation targets 254 (bn254, grumpkin) and 256-bit (secp256k1, secp256r1) fields. Internally the field is representate as a little-endian C-array of 4 uint64_t limbs. - -## Field arithmetic -### Introduction to Montgomery form {#field_docs_montgomery_explainer} -We use Montgomery reduction to speed up field multiplication. For an original element \f$ a ∈ F_p\f$ the element is represented internally as $$ a⋅R\ mod\ p$$ where \f$R = 2^d\ mod\ p\f$. The chosen \f$d\f$ depends on the build configuration: -1. \f$d=29⋅9=261\f$ for builds that don't support the uint128_t type, for example, for WASM build -2. \f$d=64⋅4=256\f$ for standard builds (x86_64). - -The goal of using Montgomery form is to avoid heavy division modulo \f$p\f$. To compute a representative of element $$c = a⋅b\ mod\ p$$ we compute $$c⋅R = (a⋅R)⋅(b⋅R) / R\ mod\ p$$, but we use an efficient division trick to avoid straight modular division. Let's look into the standard 4⋅64 case: -1. First, we compute the value $$c_r=c⋅R⋅R = aR⋅bR$$ in integers and get a value with 8 64-bit limbs -2. Then we take the lowest limb of \f$c_r\f$ (\f$c_r[0]\f$) and multiply it by a special value $$r_{inv} = -1 ⋅ p^{-1}\ mod\ 2^{64}$$ As a result we get $$k = r_{inv}⋅ c_r[0]\ mod\ 2^{64}$$ -3. Next we update \f$c_r\f$ in integers by adding a value \f$k⋅p\f$: $$c_r += k⋅p$$ You might notice that the value of \f$c_r\ mod\ p\f$ hasn't changed, since we've added a multiple of the modulus. A the same time, if we look at the expression modulo \f$2^{64}\f$: $$c_r + k⋅p = c_r + c_r⋅r_{inv}⋅p = c_r + c_r⋅ (-1)⋅p^{-1}⋅p = c_r - c_r = 0\ mod\ 2^{64}$$ The result is equivalent modulo \f$p\f$, but we zeroed out the lowest limb -4. We perform the same operation for \f$c_r[1]\f$, but instead of adding \f$k⋅p\f$, we add \f$2^{64}⋅k⋅p\f$. In the implementation, instead of adding \f$k⋅ p\f$ to limbs of \f$c_r\f$ starting with zero, we just start with limb 1. This ensures that \f$c_r[1]=0\f$. We then perform the same operation for 2 more limbs. -5. At this stage we are left with a version of \f$c_r\f$ where the first 4 limbs of the total 8 limbs are zero. So if we treat the 4 high limbs as a separate integer \f$c_{r.high}\f$, $$c_r = c_{r.high}⋅2^{256}=c_{r.high}⋅R\ mod\ p \Rightarrow c_{r.high} = c\cdot R\ mod\ p$$ and we can get the evaluation simply by taking the 4 high limbs of \f$c_r\f$. -6. The previous step has reduced the intermediate value of \f$cR\f$ to range \f$[0,2p)\f$, so we must check if it is more than \f$p\f$ and subtract the modulus once if it overflows. - -Why does this work? Originally both \f$aR\f$ and \f$bR\f$ are less than the modulus \f$p\f$ in integers, so $$aR\cdot bR <= (p-1)^2$$ During each of the \f$k\cdot p\f$ addition rounds we can add at most \f$(2^{64}-1)p\f$ to corresponding digits, so at most we add \f$(2^{256}-1)p\f$ and the total is $$aR\cdot bR + k_{0,1,2,3}p \le (p-1)^2+(2^{256}-1)p < 2\cdot 2^{256}p \Rightarrow c_{r.high} = \frac{aR\cdot bR + k_{0,1,2,3}p}{2^{256}} < 2p$$. - -For bn254 scalar and base fields we can do even better by employing a simple trick. The moduli of both fields are 254 bits, while 4 64-bit limbs allow 256 bits of storage. We relax the internal representation to use values in range \f$[0,2p)\f$. The addition, negation and subtraction operation logic doesn't change, we simply replace the modulus \f$p\f$ with \f$2p\f$, but the mutliplication becomes more efficient. The multiplicands are in range \f$[0,2p)\f$, but we add multiples of modulus \f$p\f$ to reduce limbs, not \f$2p\f$. If we revisit the \f$c_r\f$ formula: -$$aR\cdot bR + k_{0,1,2,3}p \le (2p-1)^2+(2^{256}-1)p = 2^{256}p+4p^2-5p+1 \Rightarrow$$ $$\Rightarrow c_{r.high} = \frac{aR\cdot bR + k_{0,1,2,3}p}{2^{256}} \le \frac{2^{256}p+4p^2-5p+1}{2^{256}}=p +\frac{4p^2 - 5p +1}{2^{256}}, 4p < 2^{256} \Rightarrow$$ $$\Rightarrow p +\frac{4p^2 - 5p +1}{2^{256}} < 2p$$ So we ended in the same range and we don't have to perform additional reductions. - -**N.B.** In the code we refer to this form as coarse - - - - -### Converting to and from Montgomery form -Obviously we want to avoid using standard form division when converting between forms, so we use Montgomery form to convert to Montgomery form. If we look at a value \f$a\ mod\ p\f$ we can notice that this is the Montgomery form of \f$a\cdot R^{-1}\ mod\ p\f$, so if we want to get \f$aR\f$ from it, we need to multiply it by the Montgomery form of \f$R\ mod\ p\f$, which is \f$R\cdot R\ mod\ p\f$. So using Montgomery multiplication we compute - -$$a \cdot R^2 / R = a\cdot R\ mod\ p$$ - -To convert from Montgomery form into standard form we multiply the element in Montgomery form by 1: - -$$ aR \cdot 1 / R = a\ mod\ p$$ - -## Architecture details {#field_docs_architecture_details} -You could say that for each multiplication or squaring primitive there are 3 implementations: -1. Generic 64-bit implementation when uint128_t type is available (there is efficient multiplication of 64-bit values) -2. Assembly 64-bit implementation (Intel ADX and no Intel ADX versions) -3. Implementation targeting WASM - -The generic implementation has 2 purposes: -1. Building barretenberg on platforms we haven't targetted in the past (new ARM-based Macs, for example) -2. Compile-time computation of constant expressions, since we can't use the assembly implementation for those. - -The assembly implementation for x86_64 is optimised. There are 2 versions: -1. General x86_64 implementation that uses 64-bit registers. The squaring operation is equivalent to multiplication for simplicity and because the original squaring implementation was quite buggy. -2. Implementation using Intel ADX. It allows simultaneous use of two addition-with carry operations (adox and adcx) on two separate CPU gates (units of execution that can work simultaneously on the same core), which almost halves the time spent adding up the results of uint64_t multiplication. - -Implementation for WASM: - -We use 9 29-bit limbs for computation (storage stays the same) and we change the Montgomery form. The reason for a different architecture is that WASM doesn't have: -1. 128-bit result 64*64 bit multiplication -2. 64-bit addition with carry - -In the past we implemented a version with 32-bit limbs, but as a result, when we accumulated limb products we always had to split 64-bit results of 32-bit multiplication back into 32-bit chunks. Had we not, the addition of 2 64-bit products would have lost the carry flag and the result would be incorrect. There were 2 issues with this: -1. This spawned in a lot of masking operations -2. We didn't use more efficient algorithms for squaring, because multiplication by 2 of intermediate products would once again overflow. - -Switching to 9 29-bit limbs increased the number of multiplications from 136 to 171. However, since the product of 2 limbs is 58 bits, we can safely accumulate 64 of those before we have to reduce. This allowed us to get rid of a lot of intermediate masking operations, shifts and additions, so the resulting computation turned out to be more efficient. - -## Interaction of field object with other objects -Most of the time field is used with uint64_t or uint256_t in our codebase, but there is general logic of how we generate field elements from integers: -1. Converting from signed int takes the sign into account. It takes the absolute value, converts it to montgomery and then negates the result if the original value was negative -2. Unsigned integers ( <= 64 bits) are just converted to montgomery -3. uint256_t and uint512_t: - 1. Truncate to 256 bits - 2. Subtract the modulus until the value is within field - 3. Convert to montgomery - -Conversion from field elements exists only to unsigned integers and bools. The value is converted from montgomery and appropriate number of lowest bits is used to initialize the value. - -**N.B.** Functions for converting from uint256_t and back are not bijective, since values \f$ \ge p\f$ will be reduced. - -## Field parameters - -The field template is instantiated with field parameter classes, for example, class bb::Bn254FqParams. Each such class contains at least the modulus (in 64-bit and 29-bit form), r_inv (used to efficient reductions) and 2 versions of r_squared used for converting to Montgomery form (64-bit and WASM/29-bit version). r_squared and other parameters (such as cube_root, primitive_root and coset_generators) are defined for wasm separately, because the values represent an element already in Montgomery form. - -## Helpful python snippets - -Parse field parameters out of a parameter class (doesn't check and reconstitute endomorphism parameters, but checks correctness of everything else) -```python -import re -def parse_field_params(s): - def parse_number(line): - """Expects a string without whitespaces""" - line=line.replace('U','').replace('L','') # Clear away all postfixes - if line.find('0x')!=-1: # We have to parse hex - value= int(line,16) - else: - value = int(line) - return value - - def recover_single_value(name): - nonlocal s - index=s.find(name) - if index==-1: - raise ValueError("Couldn't find value with name "+name) - eq_position=s[index:].find('=') - line_end=s[index:].find(';') - return parse_number(s[index+eq_position+1:index+line_end]) - - def recover_single_value_if_present(name): - nonlocal s - index=s.find(name) - if index==-1: - return None - eq_position=s[index:].find('=') - line_end=s[index:].find(';') - return parse_number(s[index+eq_position+1:index+line_end]) - - def recover_array(name): - nonlocal s - index = s.find(name) - number_of_elements=int(re.findall(r'(?<='+name+r'\[)\d+',s)[0]) - start_index=s[index:].find('{') - end_index=s[index:].find('}') - all_values=s[index+start_index+1:index+end_index] - result=[parse_number(x) for (i,x) in enumerate(all_values.split(',')) if i>(i*64))&((1<<64)-1))for i in range(4)])+"})") -``` \ No newline at end of file diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp index 1c556fa43de..42d7e1583ee 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl.hpp @@ -290,8 +290,7 @@ template constexpr bool field::operator!=(const field& other) const template constexpr field field::to_montgomery_form() const noexcept { BB_OP_COUNT_TRACK_NAME("fr::to_montgomery_form"); - constexpr field r_squared = - field{ r_squared_uint.data[0], r_squared_uint.data[1], r_squared_uint.data[2], r_squared_uint.data[3] }; + constexpr field r_squared{ T::r_squared_0, T::r_squared_1, T::r_squared_2, T::r_squared_3 }; field result = *this; // TODO(@zac-williamson): are these reductions needed? @@ -316,9 +315,7 @@ template constexpr field field::from_montgomery_form() const noe template constexpr void field::self_to_montgomery_form() noexcept { BB_OP_COUNT_TRACK_NAME("fr::self_to_montgomery_form"); - constexpr field r_squared = - field{ r_squared_uint.data[0], r_squared_uint.data[1], r_squared_uint.data[2], r_squared_uint.data[3] }; - + constexpr field r_squared{ T::r_squared_0, T::r_squared_1, T::r_squared_2, T::r_squared_3 }; self_reduce_once(); self_reduce_once(); self_reduce_once(); @@ -585,11 +582,7 @@ template constexpr bool field::is_zero() const noexcept template constexpr field field::get_root_of_unity(size_t subgroup_size) noexcept { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) field r{ T::primitive_root_0, T::primitive_root_1, T::primitive_root_2, T::primitive_root_3 }; -#else - field r{ T::primitive_root_wasm_0, T::primitive_root_wasm_1, T::primitive_root_wasm_2, T::primitive_root_wasm_3 }; -#endif for (size_t i = primitive_root_log_size(); i > subgroup_size; --i) { r.self_sqr(); } diff --git a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp index cb3b152d33e..f1bed6aa602 100644 --- a/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp +++ b/barretenberg/cpp/src/barretenberg/ecc/fields/field_impl_generic.hpp @@ -276,13 +276,6 @@ template constexpr field field::subtract(const field& other) con return { r0, r1, r2, r3 }; } -/** - * @brief - * - * @tparam T - * @param other - * @return constexpr field - */ template constexpr field field::subtract_coarse(const field& other) const noexcept { if constexpr (modulus.data[3] >= 0x4000000000000000ULL) { @@ -302,13 +295,6 @@ template constexpr field field::subtract_coarse(const field& oth return { r0, r1, r2, r3 }; } - -/** - * @brief Mongtomery multiplication for moduli > 2²⁵⁴ - * - * @details Explanation of Montgomery form can be found in \ref field_docs_montgomery_explainer and the difference - * between WASM and generic versions is explained in \ref field_docs_architecture_details - */ template constexpr field field::montgomery_mul_big(const field& other) const noexcept { #if defined(__SIZEOF_INT128__) && !defined(__wasm__) @@ -350,187 +336,84 @@ template constexpr field field::montgomery_mul_big(const field& r3 += (modulus.data[3] & borrow) + carry; return { r0, r1, r2, r3 }; #else + uint64_t c = 0; + uint64_t t0 = 0; + uint64_t t1 = 0; + uint64_t t2 = 0; + uint64_t t3 = 0; + uint64_t t4 = 0; + uint64_t t5 = 0; + uint64_t t6 = 0; + uint64_t t7 = 0; + uint64_t t8 = 0; + uint64_t t9 = 0; + uint64_t k = 0; - // Convert 4 64-bit limbs to 9 29-bit limbs - auto left = wasm_convert(data); - auto right = wasm_convert(other.data); - constexpr uint64_t mask = 0x1fffffff; - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - uint64_t temp_9 = 0; - uint64_t temp_10 = 0; - uint64_t temp_11 = 0; - uint64_t temp_12 = 0; - uint64_t temp_13 = 0; - uint64_t temp_14 = 0; - uint64_t temp_15 = 0; - uint64_t temp_16 = 0; - uint64_t temp_17 = 0; - - // Multiply-add 0th limb of the left argument by all 9 limbs of the right arguemnt - wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - // Instantly reduce - wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - // Continue for other limbs - wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - - // After all multiplications and additions, convert relaxed form to strict (all limbs are 29 bits) - temp_10 += temp_9 >> WASM_LIMB_BITS; - temp_9 &= mask; - temp_11 += temp_10 >> WASM_LIMB_BITS; - temp_10 &= mask; - temp_12 += temp_11 >> WASM_LIMB_BITS; - temp_11 &= mask; - temp_13 += temp_12 >> WASM_LIMB_BITS; - temp_12 &= mask; - temp_14 += temp_13 >> WASM_LIMB_BITS; - temp_13 &= mask; - temp_15 += temp_14 >> WASM_LIMB_BITS; - temp_14 &= mask; - temp_16 += temp_15 >> WASM_LIMB_BITS; - temp_15 &= mask; - temp_17 += temp_16 >> WASM_LIMB_BITS; - temp_16 &= mask; - - uint64_t r_temp_0; - uint64_t r_temp_1; - uint64_t r_temp_2; - uint64_t r_temp_3; - uint64_t r_temp_4; - uint64_t r_temp_5; - uint64_t r_temp_6; - uint64_t r_temp_7; - uint64_t r_temp_8; - // Subtract modulus from result - r_temp_0 = temp_9 - wasm_modulus[0]; - r_temp_1 = temp_10 - wasm_modulus[1] - ((r_temp_0) >> 63); - r_temp_2 = temp_11 - wasm_modulus[2] - ((r_temp_1) >> 63); - r_temp_3 = temp_12 - wasm_modulus[3] - ((r_temp_2) >> 63); - r_temp_4 = temp_13 - wasm_modulus[4] - ((r_temp_3) >> 63); - r_temp_5 = temp_14 - wasm_modulus[5] - ((r_temp_4) >> 63); - r_temp_6 = temp_15 - wasm_modulus[6] - ((r_temp_5) >> 63); - r_temp_7 = temp_16 - wasm_modulus[7] - ((r_temp_6) >> 63); - r_temp_8 = temp_17 - wasm_modulus[8] - ((r_temp_7) >> 63); - - // Depending on whether the subtraction underflowed, choose original value or the result of subtraction - uint64_t new_mask = 0 - (r_temp_8 >> 63); - uint64_t inverse_mask = (~new_mask) & mask; - temp_9 = (temp_9 & new_mask) | (r_temp_0 & inverse_mask); - temp_10 = (temp_10 & new_mask) | (r_temp_1 & inverse_mask); - temp_11 = (temp_11 & new_mask) | (r_temp_2 & inverse_mask); - temp_12 = (temp_12 & new_mask) | (r_temp_3 & inverse_mask); - temp_13 = (temp_13 & new_mask) | (r_temp_4 & inverse_mask); - temp_14 = (temp_14 & new_mask) | (r_temp_5 & inverse_mask); - temp_15 = (temp_15 & new_mask) | (r_temp_6 & inverse_mask); - temp_16 = (temp_16 & new_mask) | (r_temp_7 & inverse_mask); - temp_17 = (temp_17 & new_mask) | (r_temp_8 & inverse_mask); - - // Convert back to 4 64-bit limbs - return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), - (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), - (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), - (temp_15 >> 18) | (temp_16 << 11) | (temp_17 << 40) }; + constexpr uint64_t wasm_modulus[8]{ + modulus.data[0] & 0xffffffffULL, modulus.data[0] >> 32ULL, modulus.data[1] & 0xffffffffULL, + modulus.data[1] >> 32ULL, modulus.data[2] & 0xffffffffULL, modulus.data[2] >> 32ULL, + modulus.data[3] & 0xffffffffULL, modulus.data[3] >> 32ULL, + }; + constexpr uint64_t wasm_rinv = T::r_inv & 0xffffffffULL; -#endif -} + const uint64_t left[8]{ + data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, + data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, + }; + const uint64_t right[8]{ + other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, + other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, + }; -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) + for (size_t i = 0; i < 8; ++i) { + c = 0; + mac(t0, left[i], right[0], c, t0, c); + mac(t1, left[i], right[1], c, t1, c); + mac(t2, left[i], right[2], c, t2, c); + mac(t3, left[i], right[3], c, t3, c); + mac(t4, left[i], right[4], c, t4, c); + mac(t5, left[i], right[5], c, t5, c); + mac(t6, left[i], right[6], c, t6, c); + mac(t7, left[i], right[7], c, t7, c); + uint64_t end_mul = t8 + c; + t8 = end_mul & 0xffffffffU; + t9 = end_mul >> 32; -/** - * @brief Multiply left limb by a sequence of 9 limbs and put into result variables - * - */ -template -constexpr void field::wasm_madd(uint64_t& left_limb, - const std::array& right_limbs, - uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8) -{ - result_0 += left_limb * right_limbs[0]; - result_1 += left_limb * right_limbs[1]; - result_2 += left_limb * right_limbs[2]; - result_3 += left_limb * right_limbs[3]; - result_4 += left_limb * right_limbs[4]; - result_5 += left_limb * right_limbs[5]; - result_6 += left_limb * right_limbs[6]; - result_7 += left_limb * right_limbs[7]; - result_8 += left_limb * right_limbs[8]; + c = 0; + k = (t0 * wasm_rinv) & 0xffffffffU; + c = mac_discard_lo(t0, k, wasm_modulus[0]); + mac(t1, k, wasm_modulus[1], c, t0, c); + mac(t2, k, wasm_modulus[2], c, t1, c); + mac(t3, k, wasm_modulus[3], c, t2, c); + mac(t4, k, wasm_modulus[4], c, t3, c); + mac(t5, k, wasm_modulus[5], c, t4, c); + mac(t6, k, wasm_modulus[6], c, t5, c); + mac(t7, k, wasm_modulus[7], c, t6, c); + uint64_t end_reduce = c + t8; + t7 = end_reduce & 0xffffffffU; + c = end_reduce >> 32; + t8 = t9 + c; + } + uint64_t v0 = t0 + (t1 << 32); + uint64_t v1 = t2 + (t3 << 32); + uint64_t v2 = t4 + (t5 << 32); + uint64_t v3 = t6 + (t7 << 32); + uint64_t v4 = t8; + uint64_t borrow = 0; + uint64_t r0 = sbb(v0, modulus.data[0], borrow, borrow); + uint64_t r1 = sbb(v1, modulus.data[1], borrow, borrow); + uint64_t r2 = sbb(v2, modulus.data[2], borrow, borrow); + uint64_t r3 = sbb(v3, modulus.data[3], borrow, borrow); + borrow = borrow ^ (0ULL - v4); + r0 += (modulus.data[0] & borrow); + uint64_t carry = r0 < (modulus.data[0] & borrow); + r1 = addc(r1, modulus.data[1] & borrow, carry, carry); + r2 = addc(r2, modulus.data[2] & borrow, carry, carry); + r3 += (modulus.data[3] & borrow) + carry; + return { r0, r1, r2, r3 }; +#endif } -/** - * @brief Perform 29-bit montgomery reduction on 1 limb (result_0 should be zero modulo 2**29 after this) - * - */ -template -constexpr void field::wasm_reduce(uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8) -{ - constexpr uint64_t mask = 0x1fffffff; - constexpr uint64_t r_inv = T::r_inv & mask; - uint64_t k = (result_0 * r_inv) & mask; - result_0 += k * wasm_modulus[0]; - result_1 += k * wasm_modulus[1] + (result_0 >> WASM_LIMB_BITS); - result_2 += k * wasm_modulus[2]; - result_3 += k * wasm_modulus[3]; - result_4 += k * wasm_modulus[4]; - result_5 += k * wasm_modulus[5]; - result_6 += k * wasm_modulus[6]; - result_7 += k * wasm_modulus[7]; - result_8 += k * wasm_modulus[8]; -} -/** - * @brief Convert 4 64-bit limbs into 9 29-bit limbs - * - */ -template constexpr std::array field::wasm_convert(const uint64_t* data) -{ - return { data[0] & 0x1fffffff, - (data[0] >> WASM_LIMB_BITS) & 0x1fffffff, - ((data[0] >> 58) & 0x3f) | ((data[1] & 0x7fffff) << 6), - (data[1] >> 23) & 0x1fffffff, - ((data[1] >> 52) & 0xfff) | ((data[2] & 0x1ffff) << 12), - (data[2] >> 17) & 0x1fffffff, - ((data[2] >> 46) & 0x3ffff) | ((data[3] & 0x7ff) << 18), - (data[3] >> 11) & 0x1fffffff, - (data[3] >> 40) & 0x1fffffff }; -} -#endif template constexpr field field::montgomery_mul(const field& other) const noexcept { if constexpr (modulus.data[3] >= 0x4000000000000000ULL) { @@ -583,71 +466,178 @@ template constexpr field field::montgomery_mul(const field& othe t3 = c + a; return { t0, t1, t2, t3 }; #else + constexpr uint64_t wasm_modulus[8]{ + modulus.data[0] & 0xffffffffULL, modulus.data[0] >> 32ULL, modulus.data[1] & 0xffffffffULL, + modulus.data[1] >> 32ULL, modulus.data[2] & 0xffffffffULL, modulus.data[2] >> 32ULL, + modulus.data[3] & 0xffffffffULL, modulus.data[3] >> 32ULL, + }; + constexpr uint64_t wasm_rinv = T::r_inv & 0xffffffffULL; - // Convert 4 64-bit limbs to 9 29-bit ones - auto left = wasm_convert(data); - auto right = wasm_convert(other.data); - constexpr uint64_t mask = 0x1fffffff; - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - uint64_t temp_9 = 0; - uint64_t temp_10 = 0; - uint64_t temp_11 = 0; - uint64_t temp_12 = 0; - uint64_t temp_13 = 0; - uint64_t temp_14 = 0; - uint64_t temp_15 = 0; - uint64_t temp_16 = 0; - - // Perform a series of multiplications and reductions (we multiply 1 limb of left argument by the whole right - // argument and then reduce) - wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - - // Convert result to unrelaxed form (all limbs are 29 bits) - temp_10 += temp_9 >> WASM_LIMB_BITS; - temp_9 &= mask; - temp_11 += temp_10 >> WASM_LIMB_BITS; - temp_10 &= mask; - temp_12 += temp_11 >> WASM_LIMB_BITS; - temp_11 &= mask; - temp_13 += temp_12 >> WASM_LIMB_BITS; - temp_12 &= mask; - temp_14 += temp_13 >> WASM_LIMB_BITS; - temp_13 &= mask; - temp_15 += temp_14 >> WASM_LIMB_BITS; - temp_14 &= mask; - temp_16 += temp_15 >> WASM_LIMB_BITS; - temp_15 &= mask; - - // Convert back to 4 64-bit limbs form - return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), - (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), - (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), - (temp_15 >> 18) | (temp_16 << 11) }; + const uint64_t left[8]{ + data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, + data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, + }; + const uint64_t right[8]{ + other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, + other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, + }; + + auto [t0, c] = mul_wide(left[0], right[0]); + uint64_t k = (t0 * wasm_rinv) & 0xffffffffULL; + uint64_t a = mac_discard_lo(t0, k, wasm_modulus[0]); + + uint64_t t1 = mac_mini(a, left[0], right[1], a); + mac(t1, k, wasm_modulus[1], c, t0, c); + uint64_t t2 = mac_mini(a, left[0], right[2], a); + mac(t2, k, wasm_modulus[2], c, t1, c); + uint64_t t3 = mac_mini(a, left[0], right[3], a); + mac(t3, k, wasm_modulus[3], c, t2, c); + uint64_t t4 = mac_mini(a, left[0], right[4], a); + mac(t4, k, wasm_modulus[4], c, t3, c); + uint64_t t5 = mac_mini(a, left[0], right[5], a); + mac(t5, k, wasm_modulus[5], c, t4, c); + uint64_t t6 = mac_mini(a, left[0], right[6], a); + mac(t6, k, wasm_modulus[6], c, t5, c); + uint64_t t7 = mac_mini(a, left[0], right[7], a); + mac(t7, k, wasm_modulus[7], c, t6, c); + t7 = c + a; + + for (size_t i = 1; i < 8; ++i) { + mac_mini(t0, left[i], right[0], t0, a); + k = (t0 * wasm_rinv) & 0xffffffffULL; + c = mac_discard_lo(t0, k, wasm_modulus[0]); + mac(t1, left[i], right[1], a, t1, a); + mac(t1, k, wasm_modulus[1], c, t0, c); + mac(t2, left[i], right[2], a, t2, a); + mac(t2, k, wasm_modulus[2], c, t1, c); + mac(t3, left[i], right[3], a, t3, a); + mac(t3, k, wasm_modulus[3], c, t2, c); + mac(t4, left[i], right[4], a, t4, a); + mac(t4, k, wasm_modulus[4], c, t3, c); + mac(t5, left[i], right[5], a, t5, a); + mac(t5, k, wasm_modulus[5], c, t4, c); + mac(t6, left[i], right[6], a, t6, a); + mac(t6, k, wasm_modulus[6], c, t5, c); + mac(t7, left[i], right[7], a, t7, a); + mac(t7, k, wasm_modulus[7], c, t6, c); + t7 = c + a; + } + + // mac_mini(t0, left[2], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[2], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[2], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[2], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[2], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[2], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[2], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[2], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + // mac_mini(t0, left[3], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[3], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[3], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[3], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[3], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[3], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[3], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[3], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + // mac_mini(t0, left[4], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[4], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[4], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[4], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[4], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[4], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[4], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[4], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + // mac_mini(t0, left[5], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[5], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[5], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[5], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[5], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[5], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[5], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[5], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + // mac_mini(t0, left[6], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[6], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[6], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[6], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[6], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[6], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[6], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[6], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + // mac_mini(t0, left[7], right[0], t0, a); + // k = (t0 * wasm_rinv) & 0xffffffffULL; + // c = mac_discard_lo(t0, k, wasm_modulus[0]); + // mac(t1, left[7], right[1], a, t1, a); + // mac(t1, k, wasm_modulus[1], c, t0, c); + // mac(t2, left[7], right[2], a, t2, a); + // mac(t2, k, wasm_modulus[2], c, t1, c); + // mac(t3, left[7], right[3], a, t3, a); + // mac(t3, k, wasm_modulus[3], c, t2, c); + // mac(t4, left[7], right[4], a, t4, a); + // mac(t4, k, wasm_modulus[4], c, t3, c); + // mac(t5, left[7], right[5], a, t5, a); + // mac(t5, k, wasm_modulus[5], c, t4, c); + // mac(t6, left[7], right[6], a, t6, a); + // mac(t6, k, wasm_modulus[6], c, t5, c); + // mac(t7, left[7], right[7], a, t7, a); + // mac(t7, k, wasm_modulus[7], c, t6, c); + // t7 = c + a; + + return { t0 + (t1 << 32), t2 + (t3 << 32), t4 + (t5 << 32), t6 + (t7 << 32) }; #endif } @@ -705,135 +695,9 @@ template constexpr field field::montgomery_square() const noexce t3 = carry_lo + round_carry; return { t0, t1, t2, t3 }; #else - // Convert from 4 64-bit limbs to 9 29-bit ones - auto left = wasm_convert(data); - constexpr uint64_t mask = 0x1fffffff; - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - uint64_t temp_9 = 0; - uint64_t temp_10 = 0; - uint64_t temp_11 = 0; - uint64_t temp_12 = 0; - uint64_t temp_13 = 0; - uint64_t temp_14 = 0; - uint64_t temp_15 = 0; - uint64_t temp_16 = 0; - uint64_t acc; - // Perform multiplications, but accumulated results for limb k=i+j so that we can double them at the same time - temp_0 += left[0] * left[0]; - acc = 0; - acc += left[0] * left[1]; - temp_1 += (acc << 1); - acc = 0; - acc += left[0] * left[2]; - temp_2 += left[1] * left[1]; - temp_2 += (acc << 1); - acc = 0; - acc += left[0] * left[3]; - acc += left[1] * left[2]; - temp_3 += (acc << 1); - acc = 0; - acc += left[0] * left[4]; - acc += left[1] * left[3]; - temp_4 += left[2] * left[2]; - temp_4 += (acc << 1); - acc = 0; - acc += left[0] * left[5]; - acc += left[1] * left[4]; - acc += left[2] * left[3]; - temp_5 += (acc << 1); - acc = 0; - acc += left[0] * left[6]; - acc += left[1] * left[5]; - acc += left[2] * left[4]; - temp_6 += left[3] * left[3]; - temp_6 += (acc << 1); - acc = 0; - acc += left[0] * left[7]; - acc += left[1] * left[6]; - acc += left[2] * left[5]; - acc += left[3] * left[4]; - temp_7 += (acc << 1); - acc = 0; - acc += left[0] * left[8]; - acc += left[1] * left[7]; - acc += left[2] * left[6]; - acc += left[3] * left[5]; - temp_8 += left[4] * left[4]; - temp_8 += (acc << 1); - acc = 0; - acc += left[1] * left[8]; - acc += left[2] * left[7]; - acc += left[3] * left[6]; - acc += left[4] * left[5]; - temp_9 += (acc << 1); - acc = 0; - acc += left[2] * left[8]; - acc += left[3] * left[7]; - acc += left[4] * left[6]; - temp_10 += left[5] * left[5]; - temp_10 += (acc << 1); - acc = 0; - acc += left[3] * left[8]; - acc += left[4] * left[7]; - acc += left[5] * left[6]; - temp_11 += (acc << 1); - acc = 0; - acc += left[4] * left[8]; - acc += left[5] * left[7]; - temp_12 += left[6] * left[6]; - temp_12 += (acc << 1); - acc = 0; - acc += left[5] * left[8]; - acc += left[6] * left[7]; - temp_13 += (acc << 1); - acc = 0; - acc += left[6] * left[8]; - temp_14 += left[7] * left[7]; - temp_14 += (acc << 1); - acc = 0; - acc += left[7] * left[8]; - temp_15 += (acc << 1); - temp_16 += left[8] * left[8]; - - // Perform reductions - wasm_reduce(temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - wasm_reduce(temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_reduce(temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_reduce(temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_reduce(temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_reduce(temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_reduce(temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_reduce(temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_reduce(temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - - // Convert to unrelaxed 29-bit form - temp_10 += temp_9 >> WASM_LIMB_BITS; - temp_9 &= mask; - temp_11 += temp_10 >> WASM_LIMB_BITS; - temp_10 &= mask; - temp_12 += temp_11 >> WASM_LIMB_BITS; - temp_11 &= mask; - temp_13 += temp_12 >> WASM_LIMB_BITS; - temp_12 &= mask; - temp_14 += temp_13 >> WASM_LIMB_BITS; - temp_13 &= mask; - temp_15 += temp_14 >> WASM_LIMB_BITS; - temp_14 &= mask; - temp_16 += temp_15 >> WASM_LIMB_BITS; - temp_15 &= mask; - // Convert to 4 64-bit form - return { (temp_9 << 0) | (temp_10 << 29) | (temp_11 << 58), - (temp_11 >> 6) | (temp_12 << 23) | (temp_13 << 52), - (temp_13 >> 12) | (temp_14 << 17) | (temp_15 << 46), - (temp_15 >> 18) | (temp_16 << 11) }; + // We use ‘montgomery_mul' instead of 'square_accumulate'. The number of additions and comparisons in + // 'square_accumulate' makes it slower in this particular case. + return montgomery_mul(*this); #endif } @@ -862,82 +726,93 @@ template constexpr struct field::wide_array field::mul_512(const return { r0, r1, r2, r3, r4, r5, r6, carry_2 }; #else - // Convert from 4 64-bit limbs to 9 29-bit limbs - auto left = wasm_convert(data); - auto right = wasm_convert(other.data); - constexpr uint64_t mask = 0x1fffffff; - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - uint64_t temp_9 = 0; - uint64_t temp_10 = 0; - uint64_t temp_11 = 0; - uint64_t temp_12 = 0; - uint64_t temp_13 = 0; - uint64_t temp_14 = 0; - uint64_t temp_15 = 0; - uint64_t temp_16 = 0; - - // Multiply-add all limbs - wasm_madd(left[0], right, temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - wasm_madd(left[1], right, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_madd(left[2], right, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_madd(left[3], right, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_madd(left[4], right, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_madd(left[5], right, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_madd(left[6], right, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_madd(left[7], right, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_madd(left[8], right, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - - // Convert to unrelaxed 29-bit form - temp_1 += temp_0 >> WASM_LIMB_BITS; - temp_0 &= mask; - temp_2 += temp_1 >> WASM_LIMB_BITS; - temp_1 &= mask; - temp_3 += temp_2 >> WASM_LIMB_BITS; - temp_2 &= mask; - temp_4 += temp_3 >> WASM_LIMB_BITS; - temp_3 &= mask; - temp_5 += temp_4 >> WASM_LIMB_BITS; - temp_4 &= mask; - temp_6 += temp_5 >> WASM_LIMB_BITS; - temp_5 &= mask; - temp_7 += temp_6 >> WASM_LIMB_BITS; - temp_6 &= mask; - temp_8 += temp_7 >> WASM_LIMB_BITS; - temp_7 &= mask; - temp_9 += temp_8 >> WASM_LIMB_BITS; - temp_8 &= mask; - temp_10 += temp_9 >> WASM_LIMB_BITS; - temp_9 &= mask; - temp_11 += temp_10 >> WASM_LIMB_BITS; - temp_10 &= mask; - temp_12 += temp_11 >> WASM_LIMB_BITS; - temp_11 &= mask; - temp_13 += temp_12 >> WASM_LIMB_BITS; - temp_12 &= mask; - temp_14 += temp_13 >> WASM_LIMB_BITS; - temp_13 &= mask; - temp_15 += temp_14 >> WASM_LIMB_BITS; - temp_14 &= mask; - temp_16 += temp_15 >> WASM_LIMB_BITS; - temp_15 &= mask; - - // Convert to 8 64-bit limbs - return { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), - (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), - (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), - (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40), - (temp_8 >> 24) | (temp_9 << 5) | (temp_10 << 34) | (temp_11 << 63), - (temp_11 >> 1) | (temp_12 << 28) | (temp_13 << 57), - (temp_13 >> 7) | (temp_14 << 22) | (temp_15 << 51), - (temp_15 >> 13) | (temp_16 << 16) }; + const uint64_t left[8]{ + data[0] & 0xffffffffULL, data[0] >> 32, data[1] & 0xffffffffULL, data[1] >> 32, + data[2] & 0xffffffffULL, data[2] >> 32, data[3] & 0xffffffffULL, data[3] >> 32, + }; + + const uint64_t right[8]{ + other.data[0] & 0xffffffffULL, other.data[0] >> 32, other.data[1] & 0xffffffffULL, other.data[1] >> 32, + other.data[2] & 0xffffffffULL, other.data[2] >> 32, other.data[3] & 0xffffffffULL, other.data[3] >> 32, + }; + + uint64_t carry_2 = 0; + auto [r0, carry] = mul_wide(left[0], right[0]); + uint64_t r1 = mac_mini(carry, left[0], right[1], carry); + uint64_t r2 = mac_mini(carry, left[0], right[2], carry); + uint64_t r3 = mac_mini(carry, left[0], right[3], carry); + uint64_t r4 = mac_mini(carry, left[0], right[4], carry); + uint64_t r5 = mac_mini(carry, left[0], right[5], carry); + uint64_t r6 = mac_mini(carry, left[0], right[6], carry); + uint64_t r7 = mac_mini(carry, left[0], right[7], carry_2); + + r1 = mac_mini(r1, left[1], right[0], carry); + r2 = mac(r2, left[1], right[1], carry, carry); + r3 = mac(r3, left[1], right[2], carry, carry); + r4 = mac(r4, left[1], right[3], carry, carry); + r5 = mac(r5, left[1], right[4], carry, carry); + r6 = mac(r6, left[1], right[5], carry, carry); + r7 = mac(r7, left[1], right[6], carry, carry); + uint64_t r8 = mac(carry_2, left[1], right[7], carry, carry_2); + + r2 = mac_mini(r2, left[2], right[0], carry); + r3 = mac(r3, left[2], right[1], carry, carry); + r4 = mac(r4, left[2], right[2], carry, carry); + r5 = mac(r5, left[2], right[3], carry, carry); + r6 = mac(r6, left[2], right[4], carry, carry); + r7 = mac(r7, left[2], right[5], carry, carry); + r8 = mac(r8, left[2], right[6], carry, carry); + uint64_t r9 = mac(carry_2, left[2], right[7], carry, carry_2); + + r3 = mac_mini(r3, left[3], right[0], carry); + r4 = mac(r4, left[3], right[1], carry, carry); + r5 = mac(r5, left[3], right[2], carry, carry); + r6 = mac(r6, left[3], right[3], carry, carry); + r7 = mac(r7, left[3], right[4], carry, carry); + r8 = mac(r8, left[3], right[5], carry, carry); + r9 = mac(r9, left[3], right[6], carry, carry); + uint64_t r10 = mac(carry_2, left[3], right[7], carry, carry_2); + + r4 = mac_mini(r4, left[4], right[0], carry); + r5 = mac(r5, left[4], right[1], carry, carry); + r6 = mac(r6, left[4], right[2], carry, carry); + r7 = mac(r7, left[4], right[3], carry, carry); + r8 = mac(r8, left[4], right[4], carry, carry); + r9 = mac(r9, left[4], right[5], carry, carry); + r10 = mac(r10, left[4], right[6], carry, carry); + uint64_t r11 = mac(carry_2, left[4], right[7], carry, carry_2); + + r5 = mac_mini(r5, left[5], right[0], carry); + r6 = mac(r6, left[5], right[1], carry, carry); + r7 = mac(r7, left[5], right[2], carry, carry); + r8 = mac(r8, left[5], right[3], carry, carry); + r9 = mac(r9, left[5], right[4], carry, carry); + r10 = mac(r10, left[5], right[5], carry, carry); + r11 = mac(r11, left[5], right[6], carry, carry); + uint64_t r12 = mac(carry_2, left[5], right[7], carry, carry_2); + + r6 = mac_mini(r6, left[6], right[0], carry); + r7 = mac(r7, left[6], right[1], carry, carry); + r8 = mac(r8, left[6], right[2], carry, carry); + r9 = mac(r9, left[6], right[3], carry, carry); + r10 = mac(r10, left[6], right[4], carry, carry); + r11 = mac(r11, left[6], right[5], carry, carry); + r12 = mac(r12, left[6], right[6], carry, carry); + uint64_t r13 = mac(carry_2, left[6], right[7], carry, carry_2); + + r7 = mac_mini(r7, left[7], right[0], carry); + r8 = mac(r8, left[7], right[1], carry, carry); + r9 = mac(r9, left[7], right[2], carry, carry); + r10 = mac(r10, left[7], right[3], carry, carry); + r11 = mac(r11, left[7], right[4], carry, carry); + r12 = mac(r12, left[7], right[5], carry, carry); + r13 = mac(r13, left[7], right[6], carry, carry); + uint64_t r14 = mac(carry_2, left[7], right[7], carry, carry_2); + + return { + r0 + (r1 << 32), r2 + (r3 << 32), r4 + (r5 << 32), r6 + (r7 << 32), + r8 + (r9 << 32), r10 + (r11 << 32), r12 + (r13 << 32), r14 + (carry_2 << 32), + }; #endif } diff --git a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp index 0a9b705e22d..fe9e759adaa 100644 --- a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp +++ b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256.hpp @@ -23,12 +23,7 @@ namespace bb::numeric { class alignas(32) uint256_t { - public: -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) -#define WASM_NUM_LIMBS 9 -#define WASM_LIMB_BITS 29 -#endif constexpr uint256_t(const uint64_t a = 0) noexcept : data{ a, 0, 0, 0 } {} @@ -213,20 +208,6 @@ class alignas(32) uint256_t { uint64_t b, uint64_t c, uint64_t carry_in); -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) - static constexpr void wasm_madd(const uint64_t& left_limb, - const uint64_t* right_limbs, - uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8); - [[nodiscard]] static constexpr std::array wasm_convert(const uint64_t* data); -#endif }; inline std::ostream& operator<<(std::ostream& os, uint256_t const& a) diff --git a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp index 29be0dfa01c..ee51adc763a 100644 --- a/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp +++ b/barretenberg/cpp/src/barretenberg/numeric/uint256/uint256_impl.hpp @@ -73,52 +73,7 @@ constexpr uint64_t uint256_t::mac_discard_hi(const uint64_t a, { return (b * c + a + carry_in); } -#if defined(__wasm__) || !defined(__SIZEOF_INT128__) -/** - * @brief Multiply one limb by 9 limbs and add to resulting limbs - * - */ -constexpr void uint256_t::wasm_madd(const uint64_t& left_limb, - const uint64_t* right_limbs, - uint64_t& result_0, - uint64_t& result_1, - uint64_t& result_2, - uint64_t& result_3, - uint64_t& result_4, - uint64_t& result_5, - uint64_t& result_6, - uint64_t& result_7, - uint64_t& result_8) -{ - result_0 += left_limb * right_limbs[0]; - result_1 += left_limb * right_limbs[1]; - result_2 += left_limb * right_limbs[2]; - result_3 += left_limb * right_limbs[3]; - result_4 += left_limb * right_limbs[4]; - result_5 += left_limb * right_limbs[5]; - result_6 += left_limb * right_limbs[6]; - result_7 += left_limb * right_limbs[7]; - result_8 += left_limb * right_limbs[8]; -} - -/** - * @brief Convert from 4 64-bit limbs to 9 29-bit limbs - * - */ -constexpr std::array uint256_t::wasm_convert(const uint64_t* data) -{ - return { data[0] & 0x1fffffff, - (data[0] >> 29) & 0x1fffffff, - ((data[0] >> 58) & 0x3f) | ((data[1] & 0x7fffff) << 6), - (data[1] >> 23) & 0x1fffffff, - ((data[1] >> 52) & 0xfff) | ((data[2] & 0x1ffff) << 12), - (data[2] >> 17) & 0x1fffffff, - ((data[2] >> 46) & 0x3ffff) | ((data[3] & 0x7ff) << 18), - (data[3] >> 11) & 0x1fffffff, - (data[3] >> 40) & 0x1fffffff }; -} -#endif constexpr std::pair uint256_t::divmod(const uint256_t& b) const { if (*this == 0 || b == 0) { @@ -167,13 +122,8 @@ constexpr std::pair uint256_t::divmod(const uint256_t& b) return { quotient, remainder }; } -/** - * @brief Compute the result of multiplication modulu 2**512 - * - */ constexpr std::pair uint256_t::mul_extended(const uint256_t& other) const { -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const auto [r0, t0] = mul_wide(data[0], other.data[0]); const auto [q0, t1] = mac(t0, data[0], other.data[1], 0); const auto [q1, t2] = mac(t1, data[0], other.data[2], 0); @@ -197,84 +147,6 @@ constexpr std::pair uint256_t::mul_extended(const uint256_ uint256_t lo(r0, r1, r2, r3); uint256_t hi(r4, r5, r6, r7); return { lo, hi }; -#else - // Convert 4 64-bit limbs to 9 29-bit limbs - const auto left = wasm_convert(data); - const auto right = wasm_convert(other.data); - constexpr uint64_t mask = 0x1fffffff; - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - uint64_t temp_9 = 0; - uint64_t temp_10 = 0; - uint64_t temp_11 = 0; - uint64_t temp_12 = 0; - uint64_t temp_13 = 0; - uint64_t temp_14 = 0; - uint64_t temp_15 = 0; - uint64_t temp_16 = 0; - - // Multiply and addd all limbs - wasm_madd(left[0], &right[0], temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - wasm_madd(left[1], &right[0], temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9); - wasm_madd(left[2], &right[0], temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10); - wasm_madd(left[3], &right[0], temp_3, temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11); - wasm_madd(left[4], &right[0], temp_4, temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12); - wasm_madd(left[5], &right[0], temp_5, temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13); - wasm_madd(left[6], &right[0], temp_6, temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14); - wasm_madd(left[7], &right[0], temp_7, temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15); - wasm_madd(left[8], &right[0], temp_8, temp_9, temp_10, temp_11, temp_12, temp_13, temp_14, temp_15, temp_16); - - // Convert from relaxed form into strict 29-bit form (except for temp_16) - temp_1 += temp_0 >> WASM_LIMB_BITS; - temp_0 &= mask; - temp_2 += temp_1 >> WASM_LIMB_BITS; - temp_1 &= mask; - temp_3 += temp_2 >> WASM_LIMB_BITS; - temp_2 &= mask; - temp_4 += temp_3 >> WASM_LIMB_BITS; - temp_3 &= mask; - temp_5 += temp_4 >> WASM_LIMB_BITS; - temp_4 &= mask; - temp_6 += temp_5 >> WASM_LIMB_BITS; - temp_5 &= mask; - temp_7 += temp_6 >> WASM_LIMB_BITS; - temp_6 &= mask; - temp_8 += temp_7 >> WASM_LIMB_BITS; - temp_7 &= mask; - temp_9 += temp_8 >> WASM_LIMB_BITS; - temp_8 &= mask; - temp_10 += temp_9 >> WASM_LIMB_BITS; - temp_9 &= mask; - temp_11 += temp_10 >> WASM_LIMB_BITS; - temp_10 &= mask; - temp_12 += temp_11 >> WASM_LIMB_BITS; - temp_11 &= mask; - temp_13 += temp_12 >> WASM_LIMB_BITS; - temp_12 &= mask; - temp_14 += temp_13 >> WASM_LIMB_BITS; - temp_13 &= mask; - temp_15 += temp_14 >> WASM_LIMB_BITS; - temp_14 &= mask; - temp_16 += temp_15 >> WASM_LIMB_BITS; - temp_15 &= mask; - - // Convert to 2 4-64-bit limb uint256_t objects - return { { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), - (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), - (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), - (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40) }, - { (temp_8 >> 24) | (temp_9 << 5) | (temp_10 << 34) | (temp_11 << 63), - (temp_11 >> 1) | (temp_12 << 28) | (temp_13 << 57), - (temp_13 >> 7) | (temp_14 << 22) | (temp_15 << 51), - (temp_15 >> 13) | (temp_16 << 16) } }; -#endif } /** @@ -355,8 +227,6 @@ constexpr uint256_t uint256_t::operator-() const constexpr uint256_t uint256_t::operator*(const uint256_t& other) const { - -#if defined(__SIZEOF_INT128__) && !defined(__wasm__) const auto [r0, t0] = mac(0, data[0], other.data[0], 0ULL); const auto [q0, t1] = mac(0, data[0], other.data[1], t0); const auto [q1, t2] = mac(0, data[0], other.data[2], t1); @@ -372,86 +242,6 @@ constexpr uint256_t uint256_t::operator*(const uint256_t& other) const const auto r3 = mac_discard_hi(q5, data[3], other.data[0], 0ULL); return { r0, r1, r2, r3 }; -#else - // Convert 4 64-bit limbs to 9 29-bit limbs - const auto left = wasm_convert(data); - const auto right = wasm_convert(other.data); - uint64_t temp_0 = 0; - uint64_t temp_1 = 0; - uint64_t temp_2 = 0; - uint64_t temp_3 = 0; - uint64_t temp_4 = 0; - uint64_t temp_5 = 0; - uint64_t temp_6 = 0; - uint64_t temp_7 = 0; - uint64_t temp_8 = 0; - - // Multiply and add the product of left limb 0 by all right limbs - wasm_madd(left[0], &right[0], temp_0, temp_1, temp_2, temp_3, temp_4, temp_5, temp_6, temp_7, temp_8); - // Multiply left limb 1 by limbs 0-7 ((1,8) doesn't need to be computed, because it overflows) - temp_1 += left[1] * right[0]; - temp_2 += left[1] * right[1]; - temp_3 += left[1] * right[2]; - temp_4 += left[1] * right[3]; - temp_5 += left[1] * right[4]; - temp_6 += left[1] * right[5]; - temp_7 += left[1] * right[6]; - temp_8 += left[1] * right[7]; - // Left limb 2 by right 0-6, etc - temp_2 += left[2] * right[0]; - temp_3 += left[2] * right[1]; - temp_4 += left[2] * right[2]; - temp_5 += left[2] * right[3]; - temp_6 += left[2] * right[4]; - temp_7 += left[2] * right[5]; - temp_8 += left[2] * right[6]; - temp_3 += left[3] * right[0]; - temp_4 += left[3] * right[1]; - temp_5 += left[3] * right[2]; - temp_6 += left[3] * right[3]; - temp_7 += left[3] * right[4]; - temp_8 += left[3] * right[5]; - temp_4 += left[4] * right[0]; - temp_5 += left[4] * right[1]; - temp_6 += left[4] * right[2]; - temp_7 += left[4] * right[3]; - temp_8 += left[4] * right[4]; - temp_5 += left[5] * right[0]; - temp_6 += left[5] * right[1]; - temp_7 += left[5] * right[2]; - temp_8 += left[5] * right[3]; - temp_6 += left[6] * right[0]; - temp_7 += left[6] * right[1]; - temp_8 += left[6] * right[2]; - temp_7 += left[7] * right[0]; - temp_8 += left[7] * right[1]; - temp_8 += left[8] * right[0]; - - // Convert from relaxed form to strict 29-bit form - constexpr uint64_t mask = 0x1fffffff; - temp_1 += temp_0 >> WASM_LIMB_BITS; - temp_0 &= mask; - temp_2 += temp_1 >> WASM_LIMB_BITS; - temp_1 &= mask; - temp_3 += temp_2 >> WASM_LIMB_BITS; - temp_2 &= mask; - temp_4 += temp_3 >> WASM_LIMB_BITS; - temp_3 &= mask; - temp_5 += temp_4 >> WASM_LIMB_BITS; - temp_4 &= mask; - temp_6 += temp_5 >> WASM_LIMB_BITS; - temp_5 &= mask; - temp_7 += temp_6 >> WASM_LIMB_BITS; - temp_6 &= mask; - temp_8 += temp_7 >> WASM_LIMB_BITS; - temp_7 &= mask; - - // Convert back to 4 64-bit limbs - return { (temp_0 << 0) | (temp_1 << 29) | (temp_2 << 58), - (temp_2 >> 6) | (temp_3 << 23) | (temp_4 << 52), - (temp_4 >> 12) | (temp_5 << 17) | (temp_6 << 46), - (temp_6 >> 18) | (temp_7 << 11) | (temp_8 << 40) }; -#endif } constexpr uint256_t uint256_t::operator/(const uint256_t& other) const diff --git a/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp b/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp index d63af5db8e7..aedc1353787 100644 --- a/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp +++ b/barretenberg/cpp/src/barretenberg/polynomials/univariate.hpp @@ -119,13 +119,6 @@ template class Univariate } return *this; } - Univariate& self_sqr() - { - for (size_t i = 0; i < LENGTH; ++i) { - evaluations[i].self_sqr(); - } - return *this; - } Univariate operator+(const Univariate& other) const { Univariate res(*this); @@ -155,13 +148,6 @@ template class Univariate return res; } - Univariate sqr() const - { - Univariate res(*this); - res.self_sqr(); - return res; - } - // Operations between Univariate and scalar Univariate& operator+=(const Fr& scalar) { @@ -499,12 +485,6 @@ template class Univariate res *= other; return res; } - Univariate sqr() const - { - Univariate res(*this); - res = res.sqr(); - return res; - } Univariate operator*(const Univariate& other) const { diff --git a/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp index 0b18b94596a..144ebdf9808 100644 --- a/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/auxiliary_relation.hpp @@ -245,7 +245,7 @@ template class AuxiliaryRelationImpl { auto index_delta = w_1_shift - w_1; auto record_delta = w_4_shift - w_4; - auto index_is_monotonically_increasing = index_delta.sqr() - index_delta; // deg 2 + auto index_is_monotonically_increasing = index_delta * index_delta - index_delta; // deg 2 auto adjacent_values_match_if_adjacent_indices_match = (-index_delta + FF(1)) * record_delta; // deg 2 @@ -296,7 +296,7 @@ template class AuxiliaryRelationImpl { // do with an arithmetic gate because of the `eta` factors. We need to check that the *next* gate's access // type is correct, to cover this edge case // deg 2 or 4 - auto next_gate_access_type_is_boolean = next_gate_access_type.sqr() - next_gate_access_type; + auto next_gate_access_type_is_boolean = next_gate_access_type * next_gate_access_type - next_gate_access_type; auto q_arith_by_aux_and_scaling = q_arith * q_aux_by_scaling; // Putting it all together... diff --git a/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp index e26ad519633..dee7759db07 100644 --- a/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/delta_range_constraint_relation.hpp @@ -46,6 +46,7 @@ template class DeltaRangeConstraintRelationImpl { static const FF minus_one = FF(-1); static const FF minus_two = FF(-2); + static const FF minus_three = FF(-3); // Compute wire differences auto delta_1 = w_2 - w_1; @@ -54,29 +55,37 @@ template class DeltaRangeConstraintRelationImpl { auto delta_4 = w_1_shift - w_4; // Contribution (1) - auto tmp_1 = (delta_1 + minus_one).sqr() + minus_one; - tmp_1 *= (delta_1 + minus_two).sqr() + minus_one; + auto tmp_1 = delta_1; + tmp_1 *= (delta_1 + minus_one); + tmp_1 *= (delta_1 + minus_two); + tmp_1 *= (delta_1 + minus_three); tmp_1 *= q_delta_range; tmp_1 *= scaling_factor; std::get<0>(accumulators) += tmp_1; // Contribution (2) - auto tmp_2 = (delta_2 + minus_one).sqr() + minus_one; - tmp_2 *= (delta_2 + minus_two).sqr() + minus_one; + auto tmp_2 = delta_2; + tmp_2 *= (delta_2 + minus_one); + tmp_2 *= (delta_2 + minus_two); + tmp_2 *= (delta_2 + minus_three); tmp_2 *= q_delta_range; tmp_2 *= scaling_factor; std::get<1>(accumulators) += tmp_2; // Contribution (3) - auto tmp_3 = (delta_3 + minus_one).sqr() + minus_one; - tmp_3 *= (delta_3 + minus_two).sqr() + minus_one; + auto tmp_3 = delta_3; + tmp_3 *= (delta_3 + minus_one); + tmp_3 *= (delta_3 + minus_two); + tmp_3 *= (delta_3 + minus_three); tmp_3 *= q_delta_range; tmp_3 *= scaling_factor; std::get<2>(accumulators) += tmp_3; // Contribution (4) - auto tmp_4 = (delta_4 + minus_one).sqr() + minus_one; - tmp_4 *= (delta_4 + minus_two).sqr() + minus_one; + auto tmp_4 = delta_4; + tmp_4 *= (delta_4 + minus_one); + tmp_4 *= (delta_4 + minus_two); + tmp_4 *= (delta_4 + minus_three); tmp_4 *= q_delta_range; tmp_4 *= scaling_factor; std::get<3>(accumulators) += tmp_4; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp index 11194edba10..faf2f0da162 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_op_queue_relation.hpp @@ -57,43 +57,50 @@ template class EccOpQueueRelationImpl { auto lagrange_ecc_op = View(in.lagrange_ecc_op); // If lagrange_ecc_op is the indicator for ecc_op_gates, this is the indicator for the complement - auto lagrange_by_scaling = lagrange_ecc_op * scaling_factor; - auto complement_ecc_op_by_scaling = -lagrange_by_scaling + scaling_factor; + auto complement_ecc_op = -lagrange_ecc_op + FF(1); // Contribution (1) auto tmp = op_wire_1 - w_1; - tmp *= lagrange_by_scaling; + tmp *= lagrange_ecc_op; + tmp *= scaling_factor; std::get<0>(accumulators) += tmp; // Contribution (2) tmp = op_wire_2 - w_2; - tmp *= lagrange_by_scaling; + tmp *= lagrange_ecc_op; + tmp *= scaling_factor; std::get<1>(accumulators) += tmp; // Contribution (3) tmp = op_wire_3 - w_3; - tmp *= lagrange_by_scaling; + tmp *= lagrange_ecc_op; + tmp *= scaling_factor; std::get<2>(accumulators) += tmp; // Contribution (4) tmp = op_wire_4 - w_4; - tmp *= lagrange_by_scaling; + tmp *= lagrange_ecc_op; + tmp *= scaling_factor; std::get<3>(accumulators) += tmp; // Contribution (5) - tmp = op_wire_1 * complement_ecc_op_by_scaling; + tmp = op_wire_1 * complement_ecc_op; + tmp *= scaling_factor; std::get<4>(accumulators) += tmp; // Contribution (6) - tmp = op_wire_2 * complement_ecc_op_by_scaling; + tmp = op_wire_2 * complement_ecc_op; + tmp *= scaling_factor; std::get<5>(accumulators) += tmp; // Contribution (7) - tmp = op_wire_3 * complement_ecc_op_by_scaling; + tmp = op_wire_3 * complement_ecc_op; + tmp *= scaling_factor; std::get<6>(accumulators) += tmp; // Contribution (8) - tmp = op_wire_4 * complement_ecc_op_by_scaling; + tmp = op_wire_4 * complement_ecc_op; + tmp *= scaling_factor; std::get<7>(accumulators) += tmp; }; }; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp index 51dc6851d75..b71b5a6e4a0 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_msm_relation.cpp @@ -182,7 +182,7 @@ void ECCVMMSMRelationImpl::accumulate(ContainerOverSubrelations& accumulator relation += selector * (lambda * (xb - xa - 1) - (yb - ya)) + lambda; collision_relation += selector * (xb - xa); // x3 = L.L + (-xb - xa) * q + (1 - q) xa - auto x_out = lambda.sqr() + (-xb - xa - xa) * selector + xa; + auto x_out = lambda * lambda + (-xb - xa - xa) * selector + xa; // y3 = L . (xa - x3) - ya * q + (1 - q) ya auto y_out = lambda * (xa - x_out) + (-ya - ya) * selector + ya; @@ -219,7 +219,7 @@ void ECCVMMSMRelationImpl::accumulate(ContainerOverSubrelations& accumulator auto dbl = [&](auto& x, auto& y, auto& lambda, auto& relation) { auto two_x = x + x; relation += lambda * (y + y) - (two_x + x) * x; - auto x_out = lambda.sqr() - two_x; + auto x_out = lambda * lambda - two_x; auto y_out = lambda * (x - x_out) - y; return std::array{ x_out, y_out }; }; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp index dfc1edfb9c3..0efec02d548 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_point_table_relation.cpp @@ -122,9 +122,9 @@ void ECCVMPointTableRelationImpl::accumulate(ContainerOverSubrelations& accu auto two_x = Tx + Tx; auto three_x = two_x + Tx; auto three_xx = Tx * three_x; - auto nine_xxxx = three_xx.sqr(); + auto nine_xxxx = three_xx * three_xx; auto two_y = Ty + Ty; - auto four_yy = two_y.sqr(); + auto four_yy = two_y * two_y; auto x_double_check = (Dx + two_x) * four_yy - nine_xxxx; auto y_double_check = (Ty + Dy) * two_y + three_xx * (Dx - Tx); std::get<0>(accumulator) += precompute_point_transition * x_double_check * scaling_factor; @@ -164,7 +164,7 @@ void ECCVMPointTableRelationImpl::accumulate(ContainerOverSubrelations& accu const auto& y3 = Ty; const auto lambda_numerator = y2 - y1; const auto lambda_denominator = x2 - x1; - auto x_add_check = (x3 + x2 + x1) * lambda_denominator.sqr() - lambda_numerator.sqr(); + auto x_add_check = (x3 + x2 + x1) * lambda_denominator * lambda_denominator - lambda_numerator * lambda_numerator; auto y_add_check = (y3 + y1) * lambda_denominator + (x3 - x1) * lambda_numerator; std::get<4>(accumulator) += (-lagrange_first + 1) * (-precompute_point_transition + 1) * x_add_check * scaling_factor; diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp index b2d0f2cedbd..4e7a4cdbdb6 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_transcript_relation.cpp @@ -152,7 +152,7 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu auto y1 = transcript_accumulator_y; auto x2 = transcript_msm_x; auto y2 = transcript_msm_y; - auto tmpx = (x3 + x2 + x1) * (x2 - x1).sqr() - (y2 - y1).sqr(); + auto tmpx = (x3 + x2 + x1) * (x2 - x1) * (x2 - x1) - (y2 - y1) * (y2 - y1); auto tmpy = (y3 + y1) * (x2 - x1) - (y2 - y1) * (x1 - x3); std::get<7>(accumulator) += tmpx * add_msm_into_accumulator * scaling_factor; // degree 5 std::get<8>(accumulator) += tmpy * add_msm_into_accumulator * scaling_factor; // degree 4 @@ -177,7 +177,7 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu x2 = transcript_Px; y2 = transcript_Py; auto add_into_accumulator = q_add * (-is_accumulator_empty + 1); - tmpx = (x3 + x2 + x1) * (x2 - x1).sqr() - (y2 - y1).sqr(); + tmpx = (x3 + x2 + x1) * (x2 - x1) * (x2 - x1) - (y2 - y1) * (y2 - y1); tmpy = (y3 + y1) * (x2 - x1) - (y2 - y1) * (x1 - x3); std::get<11>(accumulator) += tmpx * add_into_accumulator * scaling_factor; // degree 5 std::get<12>(accumulator) += tmpy * add_into_accumulator * scaling_factor; // degree 4 @@ -214,14 +214,14 @@ void ECCVMTranscriptRelationImpl::accumulate(ContainerOverSubrelations& accu std::get<22>(accumulator) += q_eq * is_accumulator_empty * scaling_factor; // validate selectors are boolean (put somewhere else? these are low degree) - std::get<23>(accumulator) += (q_eq.sqr() - q_eq) * scaling_factor; - std::get<24>(accumulator) += (q_add.sqr() - q_add) * scaling_factor; - std::get<25>(accumulator) += (q_mul.sqr() - q_mul) * scaling_factor; - std::get<26>(accumulator) += (q_reset_accumulator.sqr() - q_reset_accumulator) * scaling_factor; - std::get<27>(accumulator) += (msm_transition.sqr() - msm_transition) * scaling_factor; - std::get<28>(accumulator) += (is_accumulator_empty.sqr() - is_accumulator_empty) * scaling_factor; - std::get<29>(accumulator) += (z1_zero.sqr() - z1_zero) * scaling_factor; - std::get<30>(accumulator) += (z2_zero.sqr() - z2_zero) * scaling_factor; + std::get<23>(accumulator) += q_eq * (q_eq - 1) * scaling_factor; + std::get<24>(accumulator) += q_add * (q_add - 1) * scaling_factor; + std::get<25>(accumulator) += q_mul * (q_mul - 1) * scaling_factor; + std::get<26>(accumulator) += q_reset_accumulator * (q_reset_accumulator - 1) * scaling_factor; + std::get<27>(accumulator) += msm_transition * (msm_transition - 1) * scaling_factor; + std::get<28>(accumulator) += is_accumulator_empty * (is_accumulator_empty - 1) * scaling_factor; + std::get<29>(accumulator) += z1_zero * (z1_zero - 1) * scaling_factor; + std::get<30>(accumulator) += z2_zero * (z2_zero - 1) * scaling_factor; /** * @brief Initial condition check on 1st row. diff --git a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp index 111b5ebb253..3c7e7ca8433 100644 --- a/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp +++ b/barretenberg/cpp/src/barretenberg/relations/ecc_vm/ecc_wnaf_relation.cpp @@ -64,7 +64,7 @@ void ECCVMWnafRelationImpl::accumulate(ContainerOverSubrelations& accumulato }; const auto range_constraint_slice_to_2_bits = [&scaling_factor](const View& s, auto& acc) { - acc += ((s - 1).sqr() - 1) * ((s - 2).sqr() - 1) * scaling_factor; + acc += s * (s - 1) * (s - 2) * (s - 3) * scaling_factor; }; const auto convert_to_wnaf = [](const View& s0, const View& s1) { diff --git a/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp index b05740fc7b0..f6201145fba 100644 --- a/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/elliptic_relation.hpp @@ -63,8 +63,8 @@ template class EllipticRelationImpl { // Contribution (1) point addition, x-coordinate check // q_elliptic * (x3 + x2 + x1)(x2 - x1)(x2 - x1) - y2^2 - y1^2 + 2(y2y1)*q_sign = 0 auto x_diff = (x_2 - x_1); - auto y2_sqr = y_2.sqr(); - auto y1_sqr = y_1.sqr(); + auto y2_sqr = (y_2 * y_2); + auto y1_sqr = (y_1 * y_1); auto y1y2 = y_1 * y_2 * q_sign; auto x_add_identity = (x_3 + x_2 + x_1) * x_diff * x_diff - y2_sqr - y1_sqr + y1y2 + y1y2; diff --git a/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp index 89fb3e10593..274b644db9c 100644 --- a/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/poseidon2_external_relation.hpp @@ -66,17 +66,17 @@ template class Poseidon2ExternalRelationImpl { auto s4 = w_4 + q_4; // apply s-box round - auto u1 = s1.sqr(); - u1 = u1.sqr(); + auto u1 = s1 * s1; + u1 *= u1; u1 *= s1; - auto u2 = s2.sqr(); - u2 = u2.sqr(); + auto u2 = s2 * s2; + u2 *= u2; u2 *= s2; - auto u3 = s3.sqr(); - u3 = u3.sqr(); + auto u3 = s3 * s3; + u3 *= u3; u3 *= s3; - auto u4 = s4.sqr(); - u4 = u4.sqr(); + auto u4 = s4 * s4; + u4 *= u4; u4 *= s4; // matrix mul v = M_E * u with 14 additions diff --git a/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp b/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp index fa065567bce..db4d4b02576 100644 --- a/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp +++ b/barretenberg/cpp/src/barretenberg/relations/poseidon2_internal_relation.hpp @@ -57,8 +57,8 @@ template class Poseidon2InternalRelationImpl { auto s1 = w_l + q_l; // apply s-box round - auto u1 = s1.sqr(); - u1 = u1.sqr(); + auto u1 = s1 * s1; + u1 *= u1; u1 *= s1; auto u2 = w_r; auto u3 = w_o; From 29071423ba65774039e4e5c1f7ca67123a18f738 Mon Sep 17 00:00:00 2001 From: Jean M <132435771+jeanmon@users.noreply.github.com> Date: Tue, 16 Apr 2024 16:08:33 +0200 Subject: [PATCH 25/56] chore(avm): Range checks negative tests (#5770) --- .../vm/tests/avm_inter_table.test.cpp | 304 +++++++++++++++--- 1 file changed, 263 insertions(+), 41 deletions(-) diff --git a/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp b/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp index caf1b185534..cd92aad3226 100644 --- a/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp +++ b/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp @@ -33,46 +33,6 @@ class AvmInterTableTests : public ::testing::Test { * relation being tested. ******************************************************************************/ -// Error tag propagation from memory trace back to the main trace. -TEST_F(AvmInterTableTests, tagErrNotCopiedInMain) -{ - // Equality operation on U128 and second operand is of type U16. - trace_builder.op_set(0, 32, 18, AvmMemoryTag::U128); - trace_builder.op_set(0, 32, 76, AvmMemoryTag::U16); - trace_builder.op_eq(0, 18, 76, 65, AvmMemoryTag::U128); - trace_builder.halt(); - auto trace = trace_builder.finalize(); - - // Find the row with equality operation and mutate the error tag. - auto row = std::ranges::find_if(trace.begin(), trace.end(), [](Row r) { return r.avm_main_sel_op_eq == 1; }); - ASSERT_EQ(row->avm_main_tag_err, FF(1)); // Sanity check that the error tag is set. - row->avm_main_tag_err = 0; - row->avm_main_alu_sel = 1; // We have to activate ALU trace if no error tag is present. - auto const clk = row->avm_main_clk; - - // Create a valid ALU entry for this equality operation. - auto& alu_row = trace.at(1); - alu_row.avm_alu_clk = clk; - alu_row.avm_alu_alu_sel = 1; - alu_row.avm_alu_ia = 32; - alu_row.avm_alu_ib = 32; - alu_row.avm_alu_ic = 1; - alu_row.avm_alu_op_eq = 1; - alu_row.avm_alu_in_tag = static_cast(AvmMemoryTag::U128); - alu_row.avm_alu_u128_tag = 1; - - // Adjust the output of the computation as it would have been performed without tag check. - row->avm_main_ic = 1; - // Find the memory row pertaining to write operation from Ic. - auto mem_row = std::ranges::find_if(trace.begin(), trace.end(), [clk](Row r) { - return r.avm_mem_clk == clk && r.avm_mem_sub_clk == AvmMemTraceBuilder::SUB_CLK_STORE_C; - }); - - // Adjust the output in the memory trace. - mem_row->avm_mem_val = 1; - EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "INCL_MAIN_TAG_ERR"); -} - /****************************************************************************** * MAIN <-------> ALU ******************************************************************************/ @@ -173,7 +133,230 @@ TEST_F(AvmPermMainAluNegativeTests, removeAluSelector) } /****************************************************************************** - * MAIN <-------> ALU + * REGISTER RANGE CHECKS (MAIN <-------> ALU) + ******************************************************************************/ +class AvmRangeCheckNegativeTests : public AvmInterTableTests { + protected: + std::vector trace; + size_t main_idx; + size_t mem_idx; + size_t alu_idx; + + void genTraceAdd(uint128_t const& a, uint128_t const& b, uint128_t const& c, AvmMemoryTag tag) + { + trace_builder.op_set(0, a, 0, tag); + trace_builder.op_set(0, b, 1, tag); + trace_builder.op_add(0, 0, 1, 2, tag); // 7 + 8 = 15 + trace_builder.return_op(0, 0, 0); + trace = trace_builder.finalize(); + + // Find the row with addition operation and retrieve clk. + auto row = + std::ranges::find_if(trace.begin(), trace.end(), [](Row r) { return r.avm_main_sel_op_add == FF(1); }); + + ASSERT_TRUE(row != trace.end()); + ASSERT_EQ(row->avm_main_ia, FF(uint256_t::from_uint128(a))); + ASSERT_EQ(row->avm_main_ib, FF(uint256_t::from_uint128(b))); + ASSERT_EQ(row->avm_main_ic, FF(uint256_t::from_uint128(c))); + auto clk = row->avm_main_clk; + + // Find the corresponding Alu trace row + auto alu_row = std::ranges::find_if(trace.begin(), trace.end(), [clk](Row r) { return r.avm_alu_clk == clk; }); + ASSERT_TRUE(alu_row != trace.end()); + + // Find memory trace entry related to storing output (intermediate register Ic) in memory. + auto mem_row = std::ranges::find_if(trace.begin(), trace.end(), [clk](Row r) { + return r.avm_mem_clk == clk && r.avm_mem_op_c == FF(1) && r.avm_mem_rw == FF(1); + }); + ASSERT_TRUE(mem_row != trace.end()); + + main_idx = static_cast(row - trace.begin()); + alu_idx = static_cast(alu_row - trace.begin()); + mem_idx = static_cast(mem_row - trace.begin()); + }; +}; + +// Out-of-range value in register u8_r0 +TEST_F(AvmRangeCheckNegativeTests, additionU8Reg0) +{ + genTraceAdd(7, 8, 15, AvmMemoryTag::U8); + + // We mutate the result 15 to 15 - 2^254 mod p + // The value 15 - 2^254 mod p is set in register u8_r0 and 2^246 in u8_r1 + // Therefore, u8_r0 + 2^8 * u8_r1 mod p = 15 + // All constraints except range checks on u8_r0, u8_r1 are satisfied. + + FF const fake_c = FF(15).add(-FF(2).pow(254)); + auto& row = trace.at(main_idx); + auto& mem_row = trace.at(mem_idx); + auto& alu_row = trace.at(alu_idx); + + row.avm_main_ic = fake_c; + mem_row.avm_mem_val = fake_c; + alu_row.avm_alu_ic = fake_c; + + ASSERT_EQ(alu_row.avm_alu_u8_r0, 15); + ASSERT_EQ(alu_row.avm_alu_u8_r1, 0); + + alu_row.avm_alu_u8_r0 = fake_c; + alu_row.avm_alu_u8_r1 = FF(2).pow(246); + + // We first try to validate without any range check counters adjustment. + auto trace_same_cnt = trace; + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace_same_cnt)), "LOOKUP_U8_0"); + + // Decrement the counter for former lookup values 15 resp. 0 for u8_r0 resp. u8_r1. + trace.at(15 + 1).lookup_u8_0_counts -= FF(1); + trace.at(1).lookup_u8_1_counts -= FF(1); + + // One cannot add the new values in counters as they are out of range. + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U8_0"); +} + +// Out-of-range value in register u8_r1 +TEST_F(AvmRangeCheckNegativeTests, additionU8Reg1) +{ + genTraceAdd(19, 20, 39, AvmMemoryTag::U8); + auto& row = trace.at(main_idx); + auto& mem_row = trace.at(mem_idx); + auto& alu_row = trace.at(alu_idx); + + // a + b = u8_r0 + 2^8 * u8_r1 (mod p) + // We recall that p-1 is a multiple of a large power of two. + // We select a maximal u8_r1 such that u8_r0 is still of type U8. + // Namely, we pick (p-1)/2^8 so that we can replace c (i.e., u8_r0) with 40 as + // 39 = 40 + p - 1 (mod p) + uint256_t const r1 = (uint256_t(FF::modulus) - 1) / 256; + FF const fake_c = FF(40); + + row.avm_main_ic = fake_c; + mem_row.avm_mem_val = fake_c; + alu_row.avm_alu_ic = fake_c; + + ASSERT_EQ(alu_row.avm_alu_u8_r0, 39); + ASSERT_EQ(alu_row.avm_alu_u8_r1, 0); + + alu_row.avm_alu_u8_r0 = fake_c; + alu_row.avm_alu_u8_r1 = FF(r1); + + // We adjust counter to pass range check lookup for u8_r0 + trace.at(39 + 1).lookup_u8_0_counts -= FF(1); + trace.at(40 + 1).lookup_u8_0_counts += FF(1); + + auto trace_same_cnt = trace; + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace_same_cnt)), "LOOKUP_U8_1"); + + // Second attempt by decreasing counter for u8_r1 range check lookup + trace.at(1).lookup_u8_1_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U8_1"); +} + +// Out-of-range value in register u16_r0 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg0) +{ + genTraceAdd(1200, 2000, 3200, AvmMemoryTag::U16); + auto& row = trace.at(main_idx); + auto& mem_row = trace.at(mem_idx); + auto& alu_row = trace.at(alu_idx); + + // a + b = u8_r0 + 2^8 * u8_r1 + 2^16 * u16_r0 (mod p) + // We recall that p-1 is a multiple of a large power of two. + // We select a maximal u16_r0 such that u8_r0 is still of type U16. + // Namely, we pick (p-1)/2^16 so that we can replace c with 3201 as + // 3201 = 3200 + p - 1 (mod p) + uint256_t const u16_r0 = (uint256_t(FF::modulus) - 1) / 65536; + FF const fake_c = FF(3201); + + row.avm_main_ic = fake_c; + mem_row.avm_mem_val = fake_c; + alu_row.avm_alu_ic = fake_c; + + ASSERT_EQ(alu_row.avm_alu_u8_r0, FF(128)); // 3200 % 256 = 128 + ASSERT_EQ(alu_row.avm_alu_u8_r1, FF(12)); // 3200/256 = 12 + ASSERT_EQ(alu_row.avm_alu_u16_r0, 0); + + alu_row.avm_alu_u8_r0 = FF(129); // 3201 % 256 = 129 + // alu_row.avm_alu_u8_r1 = FF(r1); // Does not change 3201/256 = 12 + alu_row.avm_alu_u16_r0 = FF(u16_r0); + + // We adjust counter to pass range check lookup for u8_r0 + trace.at(128 + 1).lookup_u8_0_counts -= FF(1); + trace.at(129 + 1).lookup_u8_0_counts += FF(1); + + auto trace_same_cnt = trace; + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace_same_cnt)), "LOOKUP_U16_0"); + + // Second attempt by decreasing counter for u16_r0 range check lookup + trace.at(1).lookup_u16_0_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_0"); +} + +// Out-of-range value in registers u16_r7, .... u16_r14 +// These registers are not involved for the arithmetic +// relations of the addition but the range checks are currently +// enabled. +TEST_F(AvmRangeCheckNegativeTests, additionU16RegHigh) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); + auto trace_original = trace; + + auto& alu_row = trace.at(alu_idx); + alu_row.avm_alu_u16_r7 = FF(235655); + + auto trace_same_cnt = trace; + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace_same_cnt)), "LOOKUP_U16_7"); + + // Second attempt by decreasing counter for u16_r0 range check lookup + trace.at(1).lookup_u16_7_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_7"); + + // Subsequent range checks are attempted only after counter decrease. + + // U16_R8 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r8 = FF(235655); + trace.at(1).lookup_u16_8_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_8"); + + // U16_R9 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r9 = FF(235655); + trace.at(1).lookup_u16_9_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_9"); + + // U16_R10 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r10 = FF(235655); + trace.at(1).lookup_u16_10_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_10"); + + // U16_R11 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r11 = FF(235655); + trace.at(1).lookup_u16_11_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_11"); + + // U16_R12 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r12 = FF(235655); + trace.at(1).lookup_u16_12_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_12"); + + // U16_R13 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r13 = FF(235655); + trace.at(1).lookup_u16_13_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_13"); + + // U16_R14 + trace = trace_original; + trace.at(alu_idx).avm_alu_u16_r14 = FF(235655); + trace.at(1).lookup_u16_14_counts -= FF(1); + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_14"); +} + +/****************************************************************************** + * MAIN <-------> MEM ******************************************************************************/ class AvmPermMainMemNegativeTests : public AvmInterTableTests { protected: @@ -231,6 +414,45 @@ class AvmPermMainMemNegativeTests : public AvmInterTableTests { mem_idx_c = static_cast(mem_row_c - trace.begin()); } }; +// Error tag propagation from memory trace back to the main trace. +TEST_F(AvmPermMainMemNegativeTests, tagErrNotCopiedInMain) +{ + // Equality operation on U128 and second operand is of type U16. + trace_builder.op_set(0, 32, 18, AvmMemoryTag::U128); + trace_builder.op_set(0, 32, 76, AvmMemoryTag::U16); + trace_builder.op_eq(0, 18, 76, 65, AvmMemoryTag::U128); + trace_builder.halt(); + auto trace = trace_builder.finalize(); + + // Find the row with equality operation and mutate the error tag. + auto row = std::ranges::find_if(trace.begin(), trace.end(), [](Row r) { return r.avm_main_sel_op_eq == 1; }); + ASSERT_EQ(row->avm_main_tag_err, FF(1)); // Sanity check that the error tag is set. + row->avm_main_tag_err = 0; + row->avm_main_alu_sel = 1; // We have to activate ALU trace if no error tag is present. + auto const clk = row->avm_main_clk; + + // Create a valid ALU entry for this equality operation. + auto& alu_row = trace.at(1); + alu_row.avm_alu_clk = clk; + alu_row.avm_alu_alu_sel = 1; + alu_row.avm_alu_ia = 32; + alu_row.avm_alu_ib = 32; + alu_row.avm_alu_ic = 1; + alu_row.avm_alu_op_eq = 1; + alu_row.avm_alu_in_tag = static_cast(AvmMemoryTag::U128); + alu_row.avm_alu_u128_tag = 1; + + // Adjust the output of the computation as it would have been performed without tag check. + row->avm_main_ic = 1; + // Find the memory row pertaining to write operation from Ic. + auto mem_row = std::ranges::find_if(trace.begin(), trace.end(), [clk](Row r) { + return r.avm_mem_clk == clk && r.avm_mem_sub_clk == AvmMemTraceBuilder::SUB_CLK_STORE_C; + }); + + // Adjust the output in the memory trace. + mem_row->avm_mem_val = 1; + EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "INCL_MAIN_TAG_ERR"); +} TEST_F(AvmPermMainMemNegativeTests, wrongValueIaInMem) { From f50b180379ac90d782aba3472708f8cef122c25b Mon Sep 17 00:00:00 2001 From: Tom French <15848336+TomAFrench@users.noreply.github.com> Date: Tue, 16 Apr 2024 15:15:22 +0100 Subject: [PATCH 26/56] feat!: Use fixed size arrays in black box functions where sizes are known (#5620) This PR enforces the sizes of inputs/outputs of blackbox functions to remove some runtime checks and allocations. --------- Co-authored-by: guipublic Co-authored-by: vezenovm --- avm-transpiler/Cargo.lock | 10 ++ .../dsl/acir_format/acir_format.test.cpp | 4 +- .../dsl/acir_format/blake2s_constraint.hpp | 2 +- .../dsl/acir_format/blake3_constraint.hpp | 2 +- .../dsl/acir_format/ecdsa_secp256k1.cpp | 65 ++------ .../dsl/acir_format/ecdsa_secp256k1.hpp | 56 ++++++- .../dsl/acir_format/ecdsa_secp256k1.test.cpp | 18 +-- .../dsl/acir_format/ecdsa_secp256r1.cpp | 22 +-- .../dsl/acir_format/ecdsa_secp256r1.hpp | 8 +- .../dsl/acir_format/ecdsa_secp256r1.test.cpp | 18 +-- .../dsl/acir_format/keccak_constraint.hpp | 6 +- .../dsl/acir_format/schnorr_verify.cpp | 2 +- .../dsl/acir_format/schnorr_verify.hpp | 2 +- .../dsl/acir_format/serde/acir.hpp | 36 ++--- .../dsl/acir_format/sha256_constraint.hpp | 8 +- .../acir_format/sha256_constraint.test.cpp | 12 +- noir/noir-repo/Cargo.lock | 10 ++ noir/noir-repo/acvm-repo/acir/Cargo.toml | 1 + .../noir-repo/acvm-repo/acir/codegen/acir.cpp | 36 ++--- .../acvm-repo/acir/src/circuit/mod.rs | 83 ++++------ .../opcodes/black_box_function_call.rs | 143 +++++++++++++++--- .../acir/tests/test_program_serialization.rs | 41 ++--- .../acvm-repo/acvm/src/pwg/blackbox/hash.rs | 68 +++------ .../acvm-repo/acvm/src/pwg/blackbox/mod.rs | 53 ++----- .../acvm/src/pwg/blackbox/signature/ecdsa.rs | 73 ++------- .../acvm/src/pwg/blackbox/signature/mod.rs | 15 ++ .../src/pwg/blackbox/signature/schnorr.rs | 7 +- .../acvm_js/test/shared/schnorr_verify.ts | 24 +-- .../src/curve_specific_solver.rs | 4 +- .../bn254_blackbox_solver/src/lib.rs | 2 +- .../acvm-repo/brillig_vm/src/black_box.rs | 3 +- .../ssa/acir_gen/acir_ir/generated_acir.rs | 92 ++++++++--- noir/noir-repo/tooling/lsp/src/solver.rs | 2 +- 33 files changed, 497 insertions(+), 431 deletions(-) diff --git a/avm-transpiler/Cargo.lock b/avm-transpiler/Cargo.lock index ff3702060f5..b99f5b35be6 100644 --- a/avm-transpiler/Cargo.lock +++ b/avm-transpiler/Cargo.lock @@ -12,6 +12,7 @@ dependencies = [ "brillig", "flate2", "serde", + "serde-big-array", "thiserror", ] @@ -1494,6 +1495,15 @@ dependencies = [ "serde_derive", ] +[[package]] +name = "serde-big-array" +version = "0.5.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "11fc7cc2c76d73e0f27ee52abbd64eec84d46f370c88371120433196934e4b7f" +dependencies = [ + "serde", +] + [[package]] name = "serde_derive" version = "1.0.196" diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp index 5d2fae4d988..49af9f200d4 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp @@ -196,7 +196,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifyPass) }); } - std::vector signature(64); + std::array signature; for (uint32_t i = 0, value = 12; i < 64; i++, value++) { signature[i] = value; range_constraints.push_back(RangeConstraint{ @@ -289,7 +289,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifySmallRange) }); } - std::vector signature(64); + std::array signature; for (uint32_t i = 0, value = 12; i < 64; i++, value++) { signature[i] = value; range_constraints.push_back(RangeConstraint{ diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake2s_constraint.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake2s_constraint.hpp index a4bf7983e47..cf55b5fb7e7 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake2s_constraint.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake2s_constraint.hpp @@ -17,7 +17,7 @@ struct Blake2sInput { struct Blake2sConstraint { std::vector inputs; - std::vector result; + std::array result; // For serialization, update with any new fields MSGPACK_FIELDS(inputs, result); diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake3_constraint.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake3_constraint.hpp index 2fe421fb16c..c2d1ecafde7 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake3_constraint.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/blake3_constraint.hpp @@ -17,7 +17,7 @@ struct Blake3Input { struct Blake3Constraint { std::vector inputs; - std::vector result; + std::array result; // For serialization, update with any new fields MSGPACK_FIELDS(inputs, result); diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.cpp index 863c4f7b067..c402c94a954 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.cpp @@ -5,44 +5,6 @@ namespace acir_format { using namespace bb::plonk; -template -crypto::ecdsa_signature ecdsa_convert_signature(Builder& builder, std::vector signature) -{ - - crypto::ecdsa_signature signature_cr; - - // Get the witness assignment for each witness index - // Write the witness assignment to the byte_array - - for (unsigned int i = 0; i < 32; i++) { - auto witness_index = signature[i]; - - std::vector fr_bytes(sizeof(fr)); - - fr value = builder.get_variable(witness_index); - - fr::serialize_to_buffer(value, &fr_bytes[0]); - - signature_cr.r[i] = fr_bytes.back(); - } - - for (unsigned int i = 32; i < 64; i++) { - auto witness_index = signature[i]; - - std::vector fr_bytes(sizeof(fr)); - - fr value = builder.get_variable(witness_index); - - fr::serialize_to_buffer(value, &fr_bytes[0]); - - signature_cr.s[i - 32] = fr_bytes.back(); - } - - signature_cr.v = 27; - - return signature_cr; -} - template secp256k1_ct::g1_ct ecdsa_convert_inputs(Builder* ctx, const secp256k1::g1::affine_element& input) { @@ -63,9 +25,9 @@ secp256k1_ct::g1_ct ecdsa_convert_inputs(Builder* ctx, const secp256k1::g1::affi // vector of bytes here, assumes that the witness indices point to a field element which can be represented // with just a byte. // notice that this function truncates each field_element to a byte -template -bb::stdlib::byte_array ecdsa_vector_of_bytes_to_byte_array(Builder& builder, - std::vector vector_of_bytes) +template +bb::stdlib::byte_array ecdsa_array_of_bytes_to_byte_array(Builder& builder, + std::array vector_of_bytes) { using byte_array_ct = bb::stdlib::byte_array; using field_ct = bb::stdlib::field_t; @@ -106,9 +68,9 @@ void create_ecdsa_k1_verify_constraints(Builder& builder, auto new_sig = ecdsa_convert_signature(builder, input.signature); - byte_array_ct message = ecdsa_vector_of_bytes_to_byte_array(builder, input.hashed_message); - auto pub_key_x_byte_arr = ecdsa_vector_of_bytes_to_byte_array(builder, input.pub_x_indices); - auto pub_key_y_byte_arr = ecdsa_vector_of_bytes_to_byte_array(builder, input.pub_y_indices); + byte_array_ct message = ecdsa_array_of_bytes_to_byte_array(builder, input.hashed_message); + auto pub_key_x_byte_arr = ecdsa_array_of_bytes_to_byte_array(builder, input.pub_x_indices); + auto pub_key_y_byte_arr = ecdsa_array_of_bytes_to_byte_array(builder, input.pub_y_indices); auto pub_key_x_fq = typename secp256k1_ct::fq_ct(pub_key_x_byte_arr); auto pub_key_y_fq = typename secp256k1_ct::fq_ct(pub_key_y_byte_arr); @@ -153,11 +115,10 @@ void create_ecdsa_k1_verify_constraints(Builder& builder, template void dummy_ecdsa_constraint(Builder& builder, EcdsaSecp256k1Constraint const& input) { - std::vector pub_x_indices_; - std::vector pub_y_indices_; - std::vector signature_; - std::vector message_indices_; - signature_.resize(64); + std::array pub_x_indices_; + std::array pub_y_indices_; + std::array signature_; + std::array message_indices_; // Create a valid signature with a valid public key crypto::ecdsa_key_pair account; @@ -179,9 +140,9 @@ template void dummy_ecdsa_constraint(Builder& builder, EcdsaS uint32_t y_wit = builder.add_variable(pub_y_value.slice(248 - i * 8, 256 - i * 8)); uint32_t r_wit = builder.add_variable(signature.r[i]); uint32_t s_wit = builder.add_variable(signature.s[i]); - message_indices_.emplace_back(m_wit); - pub_x_indices_.emplace_back(x_wit); - pub_y_indices_.emplace_back(y_wit); + message_indices_[i] = m_wit; + pub_x_indices_[i] = x_wit; + pub_y_indices_[i] = y_wit; signature_[i] = r_wit; signature_[i + 32] = s_wit; } diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.hpp index 7dd69f6af90..d5eb6e2df85 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.hpp @@ -8,19 +8,19 @@ namespace acir_format { struct EcdsaSecp256k1Constraint { // This is the byte representation of the hashed message. - std::vector hashed_message; + std::array hashed_message; // This is the computed signature // - std::vector signature; + std::array signature; // This is the supposed public key which signed the // message, giving rise to the signature. // Since Fr does not have enough bits to represent // the prime field in secp256k1, a byte array is used. // Can also use low and hi where lo=128 bits - std::vector pub_x_indices; - std::vector pub_y_indices; + std::array pub_x_indices; + std::array pub_y_indices; // This is the result of verifying the signature uint32_t result; @@ -37,11 +37,51 @@ void create_ecdsa_k1_verify_constraints(Builder& builder, template void dummy_ecdsa_constraint(Builder& builder, EcdsaSecp256k1Constraint const& input); -template -crypto::ecdsa_signature ecdsa_convert_signature(Builder& builder, std::vector signature); witness_ct ecdsa_index_to_witness(Builder& builder, uint32_t index); +template +bb::stdlib::byte_array ecdsa_array_of_bytes_to_byte_array(Builder& builder, + std::array vector_of_bytes); + +// We have the implementation of this template in the header as this method is used +// by other ecdsa constraints over different curves (e.g. secp256r1). +// gcc needs to be able to see the implementation order to generate code for +// all Builder specializations (e.g. bb::Goblin::Builder vs. bb::UltraCircuitBuilder) template -bb::stdlib::byte_array ecdsa_vector_of_bytes_to_byte_array(Builder& builder, - std::vector vector_of_bytes); +crypto::ecdsa_signature ecdsa_convert_signature(Builder& builder, std::array signature) +{ + + crypto::ecdsa_signature signature_cr; + + // Get the witness assignment for each witness index + // Write the witness assignment to the byte_array + + for (unsigned int i = 0; i < 32; i++) { + auto witness_index = signature[i]; + + std::vector fr_bytes(sizeof(fr)); + + fr value = builder.get_variable(witness_index); + + fr::serialize_to_buffer(value, &fr_bytes[0]); + + signature_cr.r[i] = fr_bytes.back(); + } + + for (unsigned int i = 32; i < 64; i++) { + auto witness_index = signature[i]; + + std::vector fr_bytes(sizeof(fr)); + + fr value = builder.get_variable(witness_index); + + fr::serialize_to_buffer(value, &fr_bytes[0]); + + signature_cr.s[i - 32] = fr_bytes.back(); + } + + signature_cr.v = 27; + + return signature_cr; +} } // namespace acir_format diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp index 1986460b53c..3e686b4f11c 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp @@ -37,35 +37,35 @@ size_t generate_ecdsa_constraint(EcdsaSecp256k1Constraint& ecdsa_constraint, Wit uint256_t pub_x_value = account.public_key.x; uint256_t pub_y_value = account.public_key.y; - std::vector message_in; - std::vector pub_x_indices_in; - std::vector pub_y_indices_in; - std::vector signature_in; + std::array message_in; + std::array pub_x_indices_in; + std::array pub_y_indices_in; + std::array signature_in; size_t offset = 0; for (size_t i = 0; i < hashed_message.size(); ++i) { - message_in.emplace_back(i + offset); + message_in[i] = static_cast(i + offset); const auto byte = static_cast(hashed_message[i]); witness_values.emplace_back(byte); } offset += message_in.size(); for (size_t i = 0; i < 32; ++i) { - pub_x_indices_in.emplace_back(i + offset); + pub_x_indices_in[i] = static_cast(i + offset); witness_values.emplace_back(pub_x_value.slice(248 - i * 8, 256 - i * 8)); } offset += pub_x_indices_in.size(); for (size_t i = 0; i < 32; ++i) { - pub_y_indices_in.emplace_back(i + offset); + pub_y_indices_in[i] = static_cast(i + offset); witness_values.emplace_back(pub_y_value.slice(248 - i * 8, 256 - i * 8)); } offset += pub_y_indices_in.size(); for (size_t i = 0; i < 32; ++i) { - signature_in.emplace_back(i + offset); + signature_in[i] = static_cast(i + offset); witness_values.emplace_back(signature.r[i]); } offset += signature.r.size(); for (size_t i = 0; i < 32; ++i) { - signature_in.emplace_back(i + offset); + signature_in[i + 32] = static_cast(i + offset); witness_values.emplace_back(signature.s[i]); } offset += signature.s.size(); diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.cpp index 7ac18687808..9554c269d5f 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.cpp @@ -33,6 +33,7 @@ void create_ecdsa_r1_verify_constraints(Builder& builder, using secp256r1_ct = bb::stdlib::secp256r1; using bool_ct = bb::stdlib::bool_t; using field_ct = bb::stdlib::field_t; + using byte_array_ct = bb::stdlib::byte_array; if (has_valid_witness_assignments == false) { dummy_ecdsa_constraint(builder, input); @@ -40,9 +41,9 @@ void create_ecdsa_r1_verify_constraints(Builder& builder, auto new_sig = ecdsa_convert_signature(builder, input.signature); - auto message = ecdsa_vector_of_bytes_to_byte_array(builder, input.hashed_message); - auto pub_key_x_byte_arr = ecdsa_vector_of_bytes_to_byte_array(builder, input.pub_x_indices); - auto pub_key_y_byte_arr = ecdsa_vector_of_bytes_to_byte_array(builder, input.pub_y_indices); + byte_array_ct message = ecdsa_array_of_bytes_to_byte_array(builder, input.hashed_message); + auto pub_key_x_byte_arr = ecdsa_array_of_bytes_to_byte_array(builder, input.pub_x_indices); + auto pub_key_y_byte_arr = ecdsa_array_of_bytes_to_byte_array(builder, input.pub_y_indices); auto pub_key_x_fq = typename secp256r1_ct::fq_ct(pub_key_x_byte_arr); auto pub_key_y_fq = typename secp256r1_ct::fq_ct(pub_key_y_byte_arr); @@ -87,11 +88,10 @@ void create_ecdsa_r1_verify_constraints(Builder& builder, template void dummy_ecdsa_constraint(Builder& builder, EcdsaSecp256r1Constraint const& input) { - std::vector pub_x_indices_; - std::vector pub_y_indices_; - std::vector signature_; - std::vector message_indices_; - signature_.resize(64); + std::array pub_x_indices_; + std::array pub_y_indices_; + std::array signature_; + std::array message_indices_; // Create a valid signature with a valid public key std::string message_string = "Instructions unclear, ask again later."; @@ -121,9 +121,9 @@ template void dummy_ecdsa_constraint(Builder& builder, EcdsaS uint32_t y_wit = builder.add_variable(pub_y_value.slice(248 - i * 8, 256 - i * 8)); uint32_t r_wit = builder.add_variable(signature.r[i]); uint32_t s_wit = builder.add_variable(signature.s[i]); - message_indices_.emplace_back(m_wit); - pub_x_indices_.emplace_back(x_wit); - pub_y_indices_.emplace_back(y_wit); + message_indices_[i] = m_wit; + pub_x_indices_[i] = x_wit; + pub_y_indices_[i] = y_wit; signature_[i] = r_wit; signature_[i + 32] = s_wit; } diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.hpp index 1f5972ba609..701a0e23c41 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.hpp @@ -6,22 +6,22 @@ namespace acir_format { struct EcdsaSecp256r1Constraint { // This is the byte representation of the hashed message. - std::vector hashed_message; + std::array hashed_message; // This is the supposed public key which signed the // message, giving rise to the signature. // Since Fr does not have enough bits to represent // the prime field in secp256r1, a byte array is used. // Can also use low and hi where lo=128 bits - std::vector pub_x_indices; - std::vector pub_y_indices; + std::array pub_x_indices; + std::array pub_y_indices; // This is the result of verifying the signature uint32_t result; // This is the computed signature // - std::vector signature; + std::array signature; friend bool operator==(EcdsaSecp256r1Constraint const& lhs, EcdsaSecp256r1Constraint const& rhs) = default; }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp index 462172d3c4e..885bbe44f87 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp @@ -22,35 +22,35 @@ size_t generate_r1_constraints(EcdsaSecp256r1Constraint& ecdsa_r1_constraint, ecdsa_signature signature) { - std::vector message_in; - std::vector pub_x_indices_in; - std::vector pub_y_indices_in; - std::vector signature_in; + std::array message_in; + std::array pub_x_indices_in; + std::array pub_y_indices_in; + std::array signature_in; size_t offset = 0; for (size_t i = 0; i < hashed_message.size(); ++i) { - message_in.emplace_back(i + offset); + message_in[i] = static_cast(i + offset); const auto byte = static_cast(hashed_message[i]); witness_values.emplace_back(byte); } offset += message_in.size(); for (size_t i = 0; i < 32; ++i) { - pub_x_indices_in.emplace_back(i + offset); + pub_x_indices_in[i] = static_cast(i + offset); witness_values.emplace_back(pub_x_value.slice(248 - i * 8, 256 - i * 8)); } offset += pub_x_indices_in.size(); for (size_t i = 0; i < 32; ++i) { - pub_y_indices_in.emplace_back(i + offset); + pub_y_indices_in[i] = static_cast(i + offset); witness_values.emplace_back(pub_y_value.slice(248 - i * 8, 256 - i * 8)); } offset += pub_y_indices_in.size(); for (size_t i = 0; i < 32; ++i) { - signature_in.emplace_back(i + offset); + signature_in[i] = static_cast(i + offset); witness_values.emplace_back(signature.r[i]); } offset += signature.r.size(); for (size_t i = 0; i < 32; ++i) { - signature_in.emplace_back(i + offset); + signature_in[i + 32] = static_cast(i + offset); witness_values.emplace_back(signature.s[i]); } offset += signature.s.size(); diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/keccak_constraint.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/keccak_constraint.hpp index 6ce3ccdc5f2..14139cba419 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/keccak_constraint.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/keccak_constraint.hpp @@ -16,8 +16,8 @@ struct HashInput { }; struct Keccakf1600 { - std::vector state; - std::vector result; + std::array state; + std::array result; // For serialization, update with any new fields MSGPACK_FIELDS(state, result); @@ -26,7 +26,7 @@ struct Keccakf1600 { struct KeccakConstraint { std::vector inputs; - std::vector result; + std::array result; uint32_t var_message_size; // For serialization, update with any new fields diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.cpp index b4d7f4737d5..bcb6e026490 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.cpp @@ -7,7 +7,7 @@ namespace acir_format { using namespace bb::stdlib; template -crypto::schnorr_signature convert_signature(Builder& builder, std::vector signature) +crypto::schnorr_signature convert_signature(Builder& builder, std::array signature) { crypto::schnorr_signature signature_cr; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.hpp index a22c2abb567..a7dbc2b0344 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/schnorr_verify.hpp @@ -20,7 +20,7 @@ struct SchnorrConstraint { // This is the computed signature // - std::vector signature; + std::array signature; friend bool operator==(SchnorrConstraint const& lhs, SchnorrConstraint const& rhs) = default; }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp index 1711c1ed8f7..5fd06543467 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/serde/acir.hpp @@ -54,7 +54,7 @@ struct BlackBoxFuncCall { struct SHA256 { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const SHA256&, const SHA256&); std::vector bincodeSerialize() const; @@ -63,7 +63,7 @@ struct BlackBoxFuncCall { struct Blake2s { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const Blake2s&, const Blake2s&); std::vector bincodeSerialize() const; @@ -72,7 +72,7 @@ struct BlackBoxFuncCall { struct Blake3 { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const Blake3&, const Blake3&); std::vector bincodeSerialize() const; @@ -82,7 +82,7 @@ struct BlackBoxFuncCall { struct SchnorrVerify { Program::FunctionInput public_key_x; Program::FunctionInput public_key_y; - std::vector signature; + std::array signature; std::vector message; Program::Witness output; @@ -112,10 +112,10 @@ struct BlackBoxFuncCall { }; struct EcdsaSecp256k1 { - std::vector public_key_x; - std::vector public_key_y; - std::vector signature; - std::vector hashed_message; + std::array public_key_x; + std::array public_key_y; + std::array signature; + std::array hashed_message; Program::Witness output; friend bool operator==(const EcdsaSecp256k1&, const EcdsaSecp256k1&); @@ -124,10 +124,10 @@ struct BlackBoxFuncCall { }; struct EcdsaSecp256r1 { - std::vector public_key_x; - std::vector public_key_y; - std::vector signature; - std::vector hashed_message; + std::array public_key_x; + std::array public_key_y; + std::array signature; + std::array hashed_message; Program::Witness output; friend bool operator==(const EcdsaSecp256r1&, const EcdsaSecp256r1&); @@ -160,7 +160,7 @@ struct BlackBoxFuncCall { struct Keccak256 { std::vector inputs; Program::FunctionInput var_message_size; - std::vector outputs; + std::array outputs; friend bool operator==(const Keccak256&, const Keccak256&); std::vector bincodeSerialize() const; @@ -168,8 +168,8 @@ struct BlackBoxFuncCall { }; struct Keccakf1600 { - std::vector inputs; - std::vector outputs; + std::array inputs; + std::array outputs; friend bool operator==(const Keccakf1600&, const Keccakf1600&); std::vector bincodeSerialize() const; @@ -257,9 +257,9 @@ struct BlackBoxFuncCall { }; struct Sha256Compression { - std::vector inputs; - std::vector hash_values; - std::vector outputs; + std::array inputs; + std::array hash_values; + std::array outputs; friend bool operator==(const Sha256Compression&, const Sha256Compression&); std::vector bincodeSerialize() const; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.hpp index 0c36058393a..560f8e915d2 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.hpp @@ -17,7 +17,7 @@ struct Sha256Input { struct Sha256Constraint { std::vector inputs; - std::vector result; + std::array result; friend bool operator==(Sha256Constraint const& lhs, Sha256Constraint const& rhs) = default; // for serialization, update with any new fields @@ -25,9 +25,9 @@ struct Sha256Constraint { }; struct Sha256Compression { - std::vector inputs; - std::vector hash_values; - std::vector result; + std::array inputs; + std::array hash_values; + std::array result; friend bool operator==(Sha256Compression const& lhs, Sha256Compression const& rhs) = default; // for serialization, update with any new fields diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp index 8e770aa4f40..14283314ddb 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp @@ -17,13 +17,13 @@ class Sha256Tests : public ::testing::Test { TEST_F(Sha256Tests, TestSha256Compression) { - std::vector inputs; - for (uint32_t i = 1; i < 17; ++i) { - inputs.push_back({ .witness = i, .num_bits = 32 }); + std::array inputs; + for (size_t i = 0; i < 16; ++i) { + inputs[i] = { .witness = static_cast(i + 1), .num_bits = 32 }; } - std::vector hash_values; - for (uint32_t i = 17; i < 25; ++i) { - hash_values.push_back({ .witness = i, .num_bits = 32 }); + std::array hash_values; + for (size_t i = 0; i < 8; ++i) { + hash_values[i] = { .witness = static_cast(i + 17), .num_bits = 32 }; } Sha256Compression sha256_compression{ .inputs = inputs, diff --git a/noir/noir-repo/Cargo.lock b/noir/noir-repo/Cargo.lock index e62f966b8fd..ee7d1d7d024 100644 --- a/noir/noir-repo/Cargo.lock +++ b/noir/noir-repo/Cargo.lock @@ -13,6 +13,7 @@ dependencies = [ "flate2", "fxhash", "serde", + "serde-big-array", "serde-generate", "serde-reflection", "serde_json", @@ -4297,6 +4298,15 @@ dependencies = [ "serde_derive", ] +[[package]] +name = "serde-big-array" +version = "0.5.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "11fc7cc2c76d73e0f27ee52abbd64eec84d46f370c88371120433196934e4b7f" +dependencies = [ + "serde", +] + [[package]] name = "serde-generate" version = "0.25.1" diff --git a/noir/noir-repo/acvm-repo/acir/Cargo.toml b/noir/noir-repo/acvm-repo/acir/Cargo.toml index 99095ad3f61..4fae9ea20ff 100644 --- a/noir/noir-repo/acvm-repo/acir/Cargo.toml +++ b/noir/noir-repo/acvm-repo/acir/Cargo.toml @@ -20,6 +20,7 @@ thiserror.workspace = true flate2.workspace = true bincode.workspace = true base64.workspace = true +serde-big-array = "0.5.1" [dev-dependencies] serde_json = "1.0" diff --git a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp index 9e1011b2109..6c7bd347e5d 100644 --- a/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp +++ b/noir/noir-repo/acvm-repo/acir/codegen/acir.cpp @@ -54,7 +54,7 @@ namespace Program { struct SHA256 { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const SHA256&, const SHA256&); std::vector bincodeSerialize() const; @@ -63,7 +63,7 @@ namespace Program { struct Blake2s { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const Blake2s&, const Blake2s&); std::vector bincodeSerialize() const; @@ -72,7 +72,7 @@ namespace Program { struct Blake3 { std::vector inputs; - std::vector outputs; + std::array outputs; friend bool operator==(const Blake3&, const Blake3&); std::vector bincodeSerialize() const; @@ -82,7 +82,7 @@ namespace Program { struct SchnorrVerify { Program::FunctionInput public_key_x; Program::FunctionInput public_key_y; - std::vector signature; + std::array signature; std::vector message; Program::Witness output; @@ -112,10 +112,10 @@ namespace Program { }; struct EcdsaSecp256k1 { - std::vector public_key_x; - std::vector public_key_y; - std::vector signature; - std::vector hashed_message; + std::array public_key_x; + std::array public_key_y; + std::array signature; + std::array hashed_message; Program::Witness output; friend bool operator==(const EcdsaSecp256k1&, const EcdsaSecp256k1&); @@ -124,10 +124,10 @@ namespace Program { }; struct EcdsaSecp256r1 { - std::vector public_key_x; - std::vector public_key_y; - std::vector signature; - std::vector hashed_message; + std::array public_key_x; + std::array public_key_y; + std::array signature; + std::array hashed_message; Program::Witness output; friend bool operator==(const EcdsaSecp256r1&, const EcdsaSecp256r1&); @@ -160,7 +160,7 @@ namespace Program { struct Keccak256 { std::vector inputs; Program::FunctionInput var_message_size; - std::vector outputs; + std::array outputs; friend bool operator==(const Keccak256&, const Keccak256&); std::vector bincodeSerialize() const; @@ -168,8 +168,8 @@ namespace Program { }; struct Keccakf1600 { - std::vector inputs; - std::vector outputs; + std::array inputs; + std::array outputs; friend bool operator==(const Keccakf1600&, const Keccakf1600&); std::vector bincodeSerialize() const; @@ -257,9 +257,9 @@ namespace Program { }; struct Sha256Compression { - std::vector inputs; - std::vector hash_values; - std::vector outputs; + std::array inputs; + std::array hash_values; + std::array outputs; friend bool operator==(const Sha256Compression&, const Sha256Compression&); std::vector bincodeSerialize() const; diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs index 27d8a392c81..0c79cfdb815 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs @@ -317,61 +317,31 @@ mod tests { }) } fn keccakf1600_opcode() -> Opcode { - Opcode::BlackBoxFuncCall(BlackBoxFuncCall::Keccakf1600 { - inputs: vec![ - FunctionInput { witness: Witness(1), num_bits: 64 }, - FunctionInput { witness: Witness(2), num_bits: 64 }, - FunctionInput { witness: Witness(3), num_bits: 64 }, - FunctionInput { witness: Witness(4), num_bits: 64 }, - FunctionInput { witness: Witness(5), num_bits: 64 }, - FunctionInput { witness: Witness(6), num_bits: 64 }, - FunctionInput { witness: Witness(7), num_bits: 64 }, - FunctionInput { witness: Witness(8), num_bits: 64 }, - FunctionInput { witness: Witness(9), num_bits: 64 }, - FunctionInput { witness: Witness(10), num_bits: 64 }, - FunctionInput { witness: Witness(11), num_bits: 64 }, - FunctionInput { witness: Witness(12), num_bits: 64 }, - FunctionInput { witness: Witness(13), num_bits: 64 }, - FunctionInput { witness: Witness(14), num_bits: 64 }, - FunctionInput { witness: Witness(15), num_bits: 64 }, - FunctionInput { witness: Witness(16), num_bits: 64 }, - FunctionInput { witness: Witness(17), num_bits: 64 }, - FunctionInput { witness: Witness(18), num_bits: 64 }, - FunctionInput { witness: Witness(19), num_bits: 64 }, - FunctionInput { witness: Witness(20), num_bits: 64 }, - FunctionInput { witness: Witness(21), num_bits: 64 }, - FunctionInput { witness: Witness(22), num_bits: 64 }, - FunctionInput { witness: Witness(23), num_bits: 64 }, - FunctionInput { witness: Witness(24), num_bits: 64 }, - FunctionInput { witness: Witness(25), num_bits: 64 }, - ], - outputs: vec![ - Witness(26), - Witness(27), - Witness(28), - Witness(29), - Witness(30), - Witness(31), - Witness(32), - Witness(33), - Witness(34), - Witness(35), - Witness(36), - Witness(37), - Witness(38), - Witness(39), - Witness(40), - Witness(41), - Witness(42), - Witness(43), - Witness(44), - Witness(45), - Witness(46), - Witness(47), - Witness(48), - Witness(49), - Witness(50), - ], + let inputs: Box<[FunctionInput; 25]> = Box::new(std::array::from_fn(|i| FunctionInput { + witness: Witness(i as u32 + 1), + num_bits: 8, + })); + let outputs: Box<[Witness; 25]> = Box::new(std::array::from_fn(|i| Witness(i as u32 + 26))); + + Opcode::BlackBoxFuncCall(BlackBoxFuncCall::Keccakf1600 { inputs, outputs }) + } + fn schnorr_verify_opcode() -> Opcode { + let public_key_x = + FunctionInput { witness: Witness(1), num_bits: FieldElement::max_num_bits() }; + let public_key_y = + FunctionInput { witness: Witness(2), num_bits: FieldElement::max_num_bits() }; + let signature: Box<[FunctionInput; 64]> = Box::new(std::array::from_fn(|i| { + FunctionInput { witness: Witness(i as u32 + 3), num_bits: 8 } + })); + let message: Vec = vec![FunctionInput { witness: Witness(67), num_bits: 8 }]; + let output = Witness(68); + + Opcode::BlackBoxFuncCall(BlackBoxFuncCall::SchnorrVerify { + public_key_x, + public_key_y, + signature, + message, + output, }) } @@ -380,7 +350,7 @@ mod tests { let circuit = Circuit { current_witness_index: 5, expression_width: ExpressionWidth::Unbounded, - opcodes: vec![and_opcode(), range_opcode()], + opcodes: vec![and_opcode(), range_opcode(), schnorr_verify_opcode()], private_parameters: BTreeSet::new(), public_parameters: PublicInputs(BTreeSet::from_iter(vec![Witness(2), Witness(12)])), return_values: PublicInputs(BTreeSet::from_iter(vec![Witness(4), Witness(12)])), @@ -413,6 +383,7 @@ mod tests { range_opcode(), and_opcode(), keccakf1600_opcode(), + schnorr_verify_opcode(), ], private_parameters: BTreeSet::new(), public_parameters: PublicInputs(BTreeSet::from_iter(vec![Witness(2)])), diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes/black_box_function_call.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes/black_box_function_call.rs index d9089578739..405cd0cef00 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes/black_box_function_call.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/opcodes/black_box_function_call.rs @@ -1,6 +1,6 @@ use crate::native_types::Witness; use crate::BlackBoxFunc; -use serde::{Deserialize, Serialize}; +use serde::{Deserialize, Deserializer, Serialize, Serializer}; // Note: Some functions will not use all of the witness // So we need to supply how many bits of the witness is needed @@ -27,20 +27,24 @@ pub enum BlackBoxFuncCall { }, SHA256 { inputs: Vec, - outputs: Vec, + outputs: Box<[Witness; 32]>, }, Blake2s { inputs: Vec, - outputs: Vec, + outputs: Box<[Witness; 32]>, }, Blake3 { inputs: Vec, - outputs: Vec, + outputs: Box<[Witness; 32]>, }, SchnorrVerify { public_key_x: FunctionInput, public_key_y: FunctionInput, - signature: Vec, + #[serde( + serialize_with = "serialize_big_array", + deserialize_with = "deserialize_big_array_into_box" + )] + signature: Box<[FunctionInput; 64]>, message: Vec, output: Witness, }, @@ -55,17 +59,25 @@ pub enum BlackBoxFuncCall { output: Witness, }, EcdsaSecp256k1 { - public_key_x: Vec, - public_key_y: Vec, - signature: Vec, - hashed_message: Vec, + public_key_x: Box<[FunctionInput; 32]>, + public_key_y: Box<[FunctionInput; 32]>, + #[serde( + serialize_with = "serialize_big_array", + deserialize_with = "deserialize_big_array_into_box" + )] + signature: Box<[FunctionInput; 64]>, + hashed_message: Box<[FunctionInput; 32]>, output: Witness, }, EcdsaSecp256r1 { - public_key_x: Vec, - public_key_y: Vec, - signature: Vec, - hashed_message: Vec, + public_key_x: Box<[FunctionInput; 32]>, + public_key_y: Box<[FunctionInput; 32]>, + #[serde( + serialize_with = "serialize_big_array", + deserialize_with = "deserialize_big_array_into_box" + )] + signature: Box<[FunctionInput; 64]>, + hashed_message: Box<[FunctionInput; 32]>, output: Witness, }, FixedBaseScalarMul { @@ -87,11 +99,11 @@ pub enum BlackBoxFuncCall { /// is more than the number of bytes in the input, /// then an error is returned. var_message_size: FunctionInput, - outputs: Vec, + outputs: Box<[Witness; 32]>, }, Keccakf1600 { - inputs: Vec, - outputs: Vec, + inputs: Box<[FunctionInput; 25]>, + outputs: Box<[Witness; 25]>, }, RecursiveAggregation { verification_key: Vec, @@ -154,11 +166,11 @@ pub enum BlackBoxFuncCall { /// * `outputs` - result of the input compressed into 256 bits Sha256Compression { /// 512 bits of the input message, represented by 16 u32s - inputs: Vec, + inputs: Box<[FunctionInput; 16]>, /// Vector of 8 u32s used to compress the input - hash_values: Vec, + hash_values: Box<[FunctionInput; 8]>, /// Output of the compression, represented by 8 u32s - outputs: Vec, + outputs: Box<[Witness; 8]>, }, } @@ -201,13 +213,15 @@ impl BlackBoxFuncCall { BlackBoxFuncCall::SHA256 { inputs, .. } | BlackBoxFuncCall::Blake2s { inputs, .. } | BlackBoxFuncCall::Blake3 { inputs, .. } - | BlackBoxFuncCall::Keccakf1600 { inputs, .. } | BlackBoxFuncCall::PedersenCommitment { inputs, .. } | BlackBoxFuncCall::PedersenHash { inputs, .. } | BlackBoxFuncCall::BigIntFromLeBytes { inputs, .. } | BlackBoxFuncCall::Poseidon2Permutation { inputs, .. } => inputs.to_vec(), + + BlackBoxFuncCall::Keccakf1600 { inputs, .. } => inputs.to_vec(), + BlackBoxFuncCall::Sha256Compression { inputs, hash_values, .. } => { - inputs.iter().chain(hash_values).copied().collect() + inputs.iter().chain(hash_values.as_ref()).copied().collect() } BlackBoxFuncCall::AND { lhs, rhs, .. } | BlackBoxFuncCall::XOR { lhs, rhs, .. } => { vec![*lhs, *rhs] @@ -300,10 +314,14 @@ impl BlackBoxFuncCall { BlackBoxFuncCall::SHA256 { outputs, .. } | BlackBoxFuncCall::Blake2s { outputs, .. } | BlackBoxFuncCall::Blake3 { outputs, .. } - | BlackBoxFuncCall::Keccakf1600 { outputs, .. } - | BlackBoxFuncCall::Keccak256 { outputs, .. } - | BlackBoxFuncCall::Poseidon2Permutation { outputs, .. } - | BlackBoxFuncCall::Sha256Compression { outputs, .. } => outputs.to_vec(), + | BlackBoxFuncCall::Keccak256 { outputs, .. } => outputs.to_vec(), + + BlackBoxFuncCall::Keccakf1600 { outputs, .. } => outputs.to_vec(), + + BlackBoxFuncCall::Sha256Compression { outputs, .. } => outputs.to_vec(), + + BlackBoxFuncCall::Poseidon2Permutation { outputs, .. } => outputs.to_vec(), + BlackBoxFuncCall::AND { output, .. } | BlackBoxFuncCall::XOR { output, .. } | BlackBoxFuncCall::SchnorrVerify { output, .. } @@ -422,3 +440,78 @@ impl std::fmt::Debug for BlackBoxFuncCall { std::fmt::Display::fmt(self, f) } } + +fn serialize_big_array(big_array: &[FunctionInput; 64], s: S) -> Result +where + S: Serializer, +{ + use serde_big_array::BigArray; + + (*big_array).serialize(s) +} + +fn deserialize_big_array_into_box<'de, D>( + deserializer: D, +) -> Result, D::Error> +where + D: Deserializer<'de>, +{ + use serde_big_array::BigArray; + + let big_array: [FunctionInput; 64] = BigArray::deserialize(deserializer)?; + Ok(Box::new(big_array)) +} + +#[cfg(test)] +mod tests { + + use crate::{circuit::Opcode, native_types::Witness}; + use acir_field::FieldElement; + + use super::{BlackBoxFuncCall, FunctionInput}; + + fn keccakf1600_opcode() -> Opcode { + let inputs: Box<[FunctionInput; 25]> = Box::new(std::array::from_fn(|i| FunctionInput { + witness: Witness(i as u32 + 1), + num_bits: 8, + })); + let outputs: Box<[Witness; 25]> = Box::new(std::array::from_fn(|i| Witness(i as u32 + 26))); + + Opcode::BlackBoxFuncCall(BlackBoxFuncCall::Keccakf1600 { inputs, outputs }) + } + fn schnorr_verify_opcode() -> Opcode { + let public_key_x = + FunctionInput { witness: Witness(1), num_bits: FieldElement::max_num_bits() }; + let public_key_y = + FunctionInput { witness: Witness(2), num_bits: FieldElement::max_num_bits() }; + let signature: Box<[FunctionInput; 64]> = Box::new(std::array::from_fn(|i| { + FunctionInput { witness: Witness(i as u32 + 3), num_bits: 8 } + })); + let message: Vec = vec![FunctionInput { witness: Witness(67), num_bits: 8 }]; + let output = Witness(68); + + Opcode::BlackBoxFuncCall(BlackBoxFuncCall::SchnorrVerify { + public_key_x, + public_key_y, + signature, + message, + output, + }) + } + + #[test] + fn keccakf1600_serialization_roundtrip() { + let opcode = keccakf1600_opcode(); + let buf = bincode::serialize(&opcode).unwrap(); + let recovered_opcode = bincode::deserialize(&buf).unwrap(); + assert_eq!(opcode, recovered_opcode); + } + + #[test] + fn schnorr_serialization_roundtrip() { + let opcode = schnorr_verify_opcode(); + let buf = bincode::serialize(&opcode).unwrap(); + let recovered_opcode = bincode::deserialize(&buf).unwrap(); + assert_eq!(opcode, recovered_opcode); + } +} diff --git a/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs b/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs index 3f392be9fe9..fb924a7437d 100644 --- a/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs +++ b/noir/noir-repo/acvm-repo/acir/tests/test_program_serialization.rs @@ -119,8 +119,11 @@ fn schnorr_verify_circuit() { FunctionInput { witness: Witness(1), num_bits: FieldElement::max_num_bits() }; let public_key_y = FunctionInput { witness: Witness(2), num_bits: FieldElement::max_num_bits() }; - let signature = - (3..(3 + 64)).map(|i| FunctionInput { witness: Witness(i), num_bits: 8 }).collect(); + let signature: [FunctionInput; 64] = (3..(3 + 64)) + .map(|i| FunctionInput { witness: Witness(i), num_bits: 8 }) + .collect::>() + .try_into() + .unwrap(); let message = ((3 + 64)..(3 + 64 + 10)) .map(|i| FunctionInput { witness: Witness(i), num_bits: 8 }) .collect(); @@ -130,7 +133,7 @@ fn schnorr_verify_circuit() { let schnorr = Opcode::BlackBoxFuncCall(BlackBoxFuncCall::SchnorrVerify { public_key_x, public_key_y, - signature, + signature: Box::new(signature), message, output, }); @@ -147,22 +150,22 @@ fn schnorr_verify_circuit() { let bytes = Program::serialize_program(&program); let expected_serialization: Vec = vec![ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 135, 74, 66, 1, 24, 134, 97, 219, 123, 239, - 189, 247, 222, 187, 108, 153, 153, 221, 69, 247, 127, 9, 145, 31, 62, 130, 29, 56, 60, 133, - 32, 242, 127, 111, 75, 161, 254, 252, 212, 222, 22, 127, 199, 78, 254, 214, 222, 86, 22, - 125, 222, 86, 123, 187, 107, 111, 59, 59, 216, 201, 46, 54, 222, 30, 246, 178, 143, 253, - 28, 224, 32, 135, 56, 204, 17, 142, 114, 140, 227, 156, 224, 36, 167, 56, 205, 25, 206, - 114, 142, 243, 92, 224, 34, 151, 184, 204, 21, 174, 114, 141, 235, 220, 224, 38, 183, 184, - 205, 29, 238, 114, 143, 251, 60, 224, 33, 143, 120, 204, 19, 158, 242, 140, 231, 188, 224, - 37, 175, 120, 205, 27, 222, 242, 142, 247, 124, 224, 35, 159, 88, 228, 51, 95, 154, 118, - 204, 243, 234, 255, 55, 190, 179, 196, 15, 150, 249, 201, 10, 191, 88, 229, 183, 239, 173, - 50, 253, 165, 189, 244, 150, 214, 210, 89, 26, 107, 244, 213, 227, 183, 164, 167, 180, 148, - 142, 210, 80, 250, 73, 59, 233, 38, 205, 164, 151, 180, 146, 78, 210, 72, 250, 72, 27, 233, - 34, 77, 164, 135, 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, 207, 230, 217, 59, 91, 103, - 231, 108, 156, 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, 58, - 183, 211, 165, 125, 174, 237, 114, 107, 143, 123, 59, 60, 186, 127, 209, 221, 95, 220, 249, - 205, 125, 75, 238, 90, 118, 207, 138, 59, 54, 110, 214, 184, 91, 161, 233, 158, 255, 158, - 63, 46, 139, 64, 203, 241, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 85, 78, 67, 81, 24, 133, 209, 226, 238, 238, + 238, 238, 238, 165, 148, 82, 102, 193, 252, 135, 64, 232, 78, 87, 147, 114, 147, 147, 5, + 47, 132, 252, 251, 107, 41, 212, 191, 159, 218, 107, 241, 115, 236, 228, 111, 237, 181, + 178, 173, 246, 186, 107, 175, 157, 29, 236, 100, 23, 27, 175, 135, 189, 236, 99, 63, 7, 56, + 200, 33, 14, 115, 132, 163, 28, 227, 56, 39, 56, 201, 41, 78, 115, 134, 179, 156, 227, 60, + 23, 184, 200, 37, 46, 115, 133, 171, 92, 227, 58, 55, 184, 201, 45, 110, 115, 135, 187, + 220, 227, 62, 15, 120, 200, 35, 30, 243, 132, 167, 60, 227, 57, 47, 120, 201, 43, 94, 243, + 134, 183, 188, 227, 61, 31, 248, 200, 39, 62, 243, 133, 175, 77, 59, 230, 123, 243, 123, + 145, 239, 44, 241, 131, 101, 126, 178, 194, 47, 86, 249, 237, 239, 86, 153, 238, 210, 92, + 122, 75, 107, 233, 44, 141, 53, 250, 234, 241, 191, 164, 167, 180, 148, 142, 210, 80, 250, + 73, 59, 233, 38, 205, 164, 151, 180, 146, 78, 210, 72, 250, 72, 27, 233, 34, 77, 164, 135, + 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, 207, 230, 217, 59, 91, 103, 231, 108, 156, + 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, 58, 183, 211, 165, + 125, 174, 237, 114, 107, 143, 123, 59, 60, 186, 255, 179, 187, 191, 186, 115, 209, 125, 75, + 238, 90, 118, 207, 138, 59, 54, 110, 214, 184, 91, 161, 233, 158, 255, 190, 63, 165, 188, + 93, 151, 233, 3, 0, 0, ]; assert_eq!(bytes, expected_serialization) diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/hash.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/hash.rs index 24c835a636a..caa09ea8973 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/hash.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/hash.rs @@ -1,7 +1,7 @@ use acir::{ circuit::opcodes::FunctionInput, native_types::{Witness, WitnessMap}, - BlackBoxFunc, FieldElement, + FieldElement, }; use acvm_blackbox_solver::{sha256compression, BlackBoxFunctionSolver, BlackBoxResolutionError}; @@ -14,22 +14,13 @@ pub(super) fn solve_generic_256_hash_opcode( initial_witness: &mut WitnessMap, inputs: &[FunctionInput], var_message_size: Option<&FunctionInput>, - outputs: &[Witness], + outputs: &[Witness; 32], hash_function: fn(data: &[u8]) -> Result<[u8; 32], BlackBoxResolutionError>, - black_box_func: BlackBoxFunc, ) -> Result<(), OpcodeResolutionError> { let message_input = get_hash_input(initial_witness, inputs, var_message_size)?; let digest: [u8; 32] = hash_function(&message_input)?; - let outputs: [Witness; 32] = outputs.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - black_box_func, - format!("Expected 32 outputs but encountered {}", outputs.len()), - ) - })?; - write_digest_to_outputs(initial_witness, outputs, digest)?; - - Ok(()) + write_digest_to_outputs(initial_witness, outputs, digest) } /// Reads the hash function input from a [`WitnessMap`]. @@ -73,7 +64,7 @@ fn get_hash_input( /// Writes a `digest` to the [`WitnessMap`] at witness indices `outputs`. fn write_digest_to_outputs( initial_witness: &mut WitnessMap, - outputs: [Witness; 32], + outputs: &[Witness; 32], digest: [u8; 32], ) -> Result<(), OpcodeResolutionError> { for (output_witness, value) in outputs.iter().zip(digest.into_iter()) { @@ -87,44 +78,29 @@ fn write_digest_to_outputs( Ok(()) } +fn to_u32_array( + initial_witness: &WitnessMap, + inputs: &[FunctionInput; N], +) -> Result<[u32; N], OpcodeResolutionError> { + let mut result = [0; N]; + for (it, input) in result.iter_mut().zip(inputs) { + let witness_value = witness_to_value(initial_witness, input.witness)?; + *it = witness_value.to_u128() as u32; + } + Ok(result) +} + pub(crate) fn solve_sha_256_permutation_opcode( initial_witness: &mut WitnessMap, - inputs: &[FunctionInput], - hash_values: &[FunctionInput], - outputs: &[Witness], - black_box_func: BlackBoxFunc, + inputs: &[FunctionInput; 16], + hash_values: &[FunctionInput; 8], + outputs: &[Witness; 8], ) -> Result<(), OpcodeResolutionError> { - let mut message = [0; 16]; - if inputs.len() != 16 { - return Err(OpcodeResolutionError::BlackBoxFunctionFailed( - black_box_func, - format!("Expected 16 inputs but encountered {}", &message.len()), - )); - } - for (i, input) in inputs.iter().enumerate() { - let value = witness_to_value(initial_witness, input.witness)?; - message[i] = value.to_u128() as u32; - } - - if hash_values.len() != 8 { - return Err(OpcodeResolutionError::BlackBoxFunctionFailed( - black_box_func, - format!("Expected 8 values but encountered {}", hash_values.len()), - )); - } - let mut state = [0; 8]; - for (i, hash) in hash_values.iter().enumerate() { - let value = witness_to_value(initial_witness, hash.witness)?; - state[i] = value.to_u128() as u32; - } + let message = to_u32_array(initial_witness, inputs)?; + let mut state = to_u32_array(initial_witness, hash_values)?; sha256compression(&mut state, &message); - let outputs: [Witness; 8] = outputs.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - black_box_func, - format!("Expected 8 outputs but encountered {}", outputs.len()), - ) - })?; + for (output_witness, value) in outputs.iter().zip(state.into_iter()) { insert_value(output_witness, FieldElement::from(value as u128), initial_witness)?; } diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/mod.rs index e7ed402a8eb..26d1a3c8f86 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/mod.rs @@ -71,30 +71,16 @@ pub(crate) fn solve( BlackBoxFuncCall::AND { lhs, rhs, output } => and(initial_witness, lhs, rhs, output), BlackBoxFuncCall::XOR { lhs, rhs, output } => xor(initial_witness, lhs, rhs, output), BlackBoxFuncCall::RANGE { input } => solve_range_opcode(initial_witness, input), - BlackBoxFuncCall::SHA256 { inputs, outputs } => solve_generic_256_hash_opcode( - initial_witness, - inputs, - None, - outputs, - sha256, - bb_func.get_black_box_func(), - ), - BlackBoxFuncCall::Blake2s { inputs, outputs } => solve_generic_256_hash_opcode( - initial_witness, - inputs, - None, - outputs, - blake2s, - bb_func.get_black_box_func(), - ), - BlackBoxFuncCall::Blake3 { inputs, outputs } => solve_generic_256_hash_opcode( - initial_witness, - inputs, - None, - outputs, - blake3, - bb_func.get_black_box_func(), - ), + BlackBoxFuncCall::SHA256 { inputs, outputs } => { + solve_generic_256_hash_opcode(initial_witness, inputs, None, outputs, sha256) + } + BlackBoxFuncCall::Blake2s { inputs, outputs } => { + solve_generic_256_hash_opcode(initial_witness, inputs, None, outputs, blake2s) + } + BlackBoxFuncCall::Blake3 { inputs, outputs } => { + solve_generic_256_hash_opcode(initial_witness, inputs, None, outputs, blake3) + } + BlackBoxFuncCall::Keccak256 { inputs, var_message_size, outputs } => { solve_generic_256_hash_opcode( initial_witness, @@ -102,18 +88,17 @@ pub(crate) fn solve( Some(var_message_size), outputs, keccak256, - bb_func.get_black_box_func(), ) } BlackBoxFuncCall::Keccakf1600 { inputs, outputs } => { let mut state = [0; 25]; - for (i, input) in inputs.iter().enumerate() { + for (it, input) in state.iter_mut().zip(inputs.as_ref()) { let witness = input.witness; let num_bits = input.num_bits as usize; assert_eq!(num_bits, 64); let witness_assignment = witness_to_value(initial_witness, witness)?; let lane = witness_assignment.try_to_u64(); - state[i] = lane.unwrap(); + *it = lane.unwrap(); } let output_state = keccakf1600(state)?; for (output_witness, value) in outputs.iter().zip(output_state.into_iter()) { @@ -132,7 +117,7 @@ pub(crate) fn solve( initial_witness, *public_key_x, *public_key_y, - signature, + signature.as_ref(), message, *output, ), @@ -153,7 +138,7 @@ pub(crate) fn solve( public_key_x, public_key_y, signature, - message, + message.as_ref(), *output, ), BlackBoxFuncCall::EcdsaSecp256r1 { @@ -167,7 +152,7 @@ pub(crate) fn solve( public_key_x, public_key_y, signature, - message, + message.as_ref(), *output, ), BlackBoxFuncCall::FixedBaseScalarMul { low, high, outputs } => { @@ -199,13 +184,7 @@ pub(crate) fn solve( bigint_solver.bigint_to_bytes(*input, outputs, initial_witness) } BlackBoxFuncCall::Sha256Compression { inputs, hash_values, outputs } => { - solve_sha_256_permutation_opcode( - initial_witness, - inputs, - hash_values, - outputs, - bb_func.get_black_box_func(), - ) + solve_sha_256_permutation_opcode(initial_witness, inputs, hash_values, outputs) } BlackBoxFuncCall::Poseidon2Permutation { inputs, outputs, len } => { solve_poseidon2_permutation_opcode(backend, initial_witness, inputs, outputs, *len) diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/ecdsa.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/ecdsa.rs index 8f0df8378ad..b113c801251 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/ecdsa.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/ecdsa.rs @@ -7,85 +7,42 @@ use acvm_blackbox_solver::{ecdsa_secp256k1_verify, ecdsa_secp256r1_verify}; use crate::{pwg::insert_value, OpcodeResolutionError}; -use super::to_u8_vec; +use super::{to_u8_array, to_u8_vec}; pub(crate) fn secp256k1_prehashed( initial_witness: &mut WitnessMap, - public_key_x_inputs: &[FunctionInput], - public_key_y_inputs: &[FunctionInput], - signature_inputs: &[FunctionInput], + public_key_x_inputs: &[FunctionInput; 32], + public_key_y_inputs: &[FunctionInput; 32], + signature_inputs: &[FunctionInput; 64], hashed_message_inputs: &[FunctionInput], output: Witness, ) -> Result<(), OpcodeResolutionError> { let hashed_message = to_u8_vec(initial_witness, hashed_message_inputs)?; - // These errors should never be emitted in practice as they would imply malformed ACIR generation. - let pub_key_x: [u8; 32] = - to_u8_vec(initial_witness, public_key_x_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256k1, - format!("expected pubkey_x size 32 but received {}", public_key_x_inputs.len()), - ) - })?; - - let pub_key_y: [u8; 32] = - to_u8_vec(initial_witness, public_key_y_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256k1, - format!("expected pubkey_y size 32 but received {}", public_key_y_inputs.len()), - ) - })?; - - let signature: [u8; 64] = - to_u8_vec(initial_witness, signature_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256k1, - format!("expected signature size 64 but received {}", signature_inputs.len()), - ) - })?; + let pub_key_x: [u8; 32] = to_u8_array(initial_witness, public_key_x_inputs)?; + let pub_key_y: [u8; 32] = to_u8_array(initial_witness, public_key_y_inputs)?; + let signature: [u8; 64] = to_u8_array(initial_witness, signature_inputs)?; let is_valid = ecdsa_secp256k1_verify(&hashed_message, &pub_key_x, &pub_key_y, &signature)?; - insert_value(&output, FieldElement::from(is_valid), initial_witness)?; - Ok(()) + insert_value(&output, FieldElement::from(is_valid), initial_witness) } pub(crate) fn secp256r1_prehashed( initial_witness: &mut WitnessMap, - public_key_x_inputs: &[FunctionInput], - public_key_y_inputs: &[FunctionInput], - signature_inputs: &[FunctionInput], + public_key_x_inputs: &[FunctionInput; 32], + public_key_y_inputs: &[FunctionInput; 32], + signature_inputs: &[FunctionInput; 64], hashed_message_inputs: &[FunctionInput], output: Witness, ) -> Result<(), OpcodeResolutionError> { let hashed_message = to_u8_vec(initial_witness, hashed_message_inputs)?; - let pub_key_x: [u8; 32] = - to_u8_vec(initial_witness, public_key_x_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256r1, - format!("expected pubkey_x size 32 but received {}", public_key_x_inputs.len()), - ) - })?; - - let pub_key_y: [u8; 32] = - to_u8_vec(initial_witness, public_key_y_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256r1, - format!("expected pubkey_y size 32 but received {}", public_key_y_inputs.len()), - ) - })?; - - let signature: [u8; 64] = - to_u8_vec(initial_witness, signature_inputs)?.try_into().map_err(|_| { - OpcodeResolutionError::BlackBoxFunctionFailed( - acir::BlackBoxFunc::EcdsaSecp256r1, - format!("expected signature size 64 but received {}", signature_inputs.len()), - ) - })?; + let pub_key_x: [u8; 32] = to_u8_array(initial_witness, public_key_x_inputs)?; + let pub_key_y: [u8; 32] = to_u8_array(initial_witness, public_key_y_inputs)?; + let signature: [u8; 64] = to_u8_array(initial_witness, signature_inputs)?; let is_valid = ecdsa_secp256r1_verify(&hashed_message, &pub_key_x, &pub_key_y, &signature)?; - insert_value(&output, FieldElement::from(is_valid), initial_witness)?; - Ok(()) + insert_value(&output, FieldElement::from(is_valid), initial_witness) } diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/mod.rs index 0e28a63ff68..bd223ecd0c9 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/mod.rs @@ -2,6 +2,21 @@ use acir::{circuit::opcodes::FunctionInput, native_types::WitnessMap}; use crate::pwg::{witness_to_value, OpcodeResolutionError}; +fn to_u8_array( + initial_witness: &WitnessMap, + inputs: &[FunctionInput; N], +) -> Result<[u8; N], OpcodeResolutionError> { + let mut result = [0; N]; + for (it, input) in result.iter_mut().zip(inputs) { + let witness_value_bytes = witness_to_value(initial_witness, input.witness)?.to_be_bytes(); + let byte = witness_value_bytes + .last() + .expect("Field element must be represented by non-zero amount of bytes"); + *it = *byte; + } + Ok(result) +} + fn to_u8_vec( initial_witness: &WitnessMap, inputs: &[FunctionInput], diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/schnorr.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/schnorr.rs index 7f5381cee91..3d0216fa217 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/schnorr.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/signature/schnorr.rs @@ -1,4 +1,4 @@ -use super::to_u8_vec; +use super::{to_u8_array, to_u8_vec}; use crate::{ pwg::{insert_value, witness_to_value, OpcodeResolutionError}, BlackBoxFunctionSolver, @@ -15,15 +15,14 @@ pub(crate) fn schnorr_verify( initial_witness: &mut WitnessMap, public_key_x: FunctionInput, public_key_y: FunctionInput, - signature: &[FunctionInput], + signature: &[FunctionInput; 64], message: &[FunctionInput], output: Witness, ) -> Result<(), OpcodeResolutionError> { let public_key_x: &FieldElement = witness_to_value(initial_witness, public_key_x.witness)?; let public_key_y: &FieldElement = witness_to_value(initial_witness, public_key_y.witness)?; - let signature = to_u8_vec(initial_witness, signature)?; - + let signature = to_u8_array(initial_witness, signature)?; let message = to_u8_vec(initial_witness, message)?; let valid_signature = diff --git a/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts b/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts index 0aef82bc8e9..a207aa12b2c 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts +++ b/noir/noir-repo/acvm-repo/acvm_js/test/shared/schnorr_verify.ts @@ -1,17 +1,17 @@ // See `schnorr_verify_circuit` integration test in `acir/tests/test_program_serialization.rs`. export const bytecode = Uint8Array.from([ - 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 135, 74, 66, 1, 24, 134, 97, 219, 123, 239, 189, 247, 222, 187, 108, 153, - 153, 221, 69, 247, 127, 9, 145, 31, 62, 130, 29, 56, 60, 133, 32, 242, 127, 111, 75, 161, 254, 252, 212, 222, 22, 127, - 199, 78, 254, 214, 222, 86, 22, 125, 222, 86, 123, 187, 107, 111, 59, 59, 216, 201, 46, 54, 222, 30, 246, 178, 143, - 253, 28, 224, 32, 135, 56, 204, 17, 142, 114, 140, 227, 156, 224, 36, 167, 56, 205, 25, 206, 114, 142, 243, 92, 224, - 34, 151, 184, 204, 21, 174, 114, 141, 235, 220, 224, 38, 183, 184, 205, 29, 238, 114, 143, 251, 60, 224, 33, 143, 120, - 204, 19, 158, 242, 140, 231, 188, 224, 37, 175, 120, 205, 27, 222, 242, 142, 247, 124, 224, 35, 159, 88, 228, 51, 95, - 154, 118, 204, 243, 234, 255, 55, 190, 179, 196, 15, 150, 249, 201, 10, 191, 88, 229, 183, 239, 173, 50, 253, 165, - 189, 244, 150, 214, 210, 89, 26, 107, 244, 213, 227, 183, 164, 167, 180, 148, 142, 210, 80, 250, 73, 59, 233, 38, 205, - 164, 151, 180, 146, 78, 210, 72, 250, 72, 27, 233, 34, 77, 164, 135, 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, - 207, 230, 217, 59, 91, 103, 231, 108, 156, 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, - 58, 183, 211, 165, 125, 174, 237, 114, 107, 143, 123, 59, 60, 186, 127, 209, 221, 95, 220, 249, 205, 125, 75, 238, 90, - 118, 207, 138, 59, 54, 110, 214, 184, 91, 161, 233, 158, 255, 158, 63, 46, 139, 64, 203, 241, 3, 0, 0, + 31, 139, 8, 0, 0, 0, 0, 0, 0, 255, 85, 210, 85, 78, 67, 81, 24, 133, 209, 226, 238, 238, 238, 238, 238, 165, 148, 82, + 102, 193, 252, 135, 64, 232, 78, 87, 147, 114, 147, 147, 5, 47, 132, 252, 251, 107, 41, 212, 191, 159, 218, 107, 241, + 115, 236, 228, 111, 237, 181, 178, 173, 246, 186, 107, 175, 157, 29, 236, 100, 23, 27, 175, 135, 189, 236, 99, 63, 7, + 56, 200, 33, 14, 115, 132, 163, 28, 227, 56, 39, 56, 201, 41, 78, 115, 134, 179, 156, 227, 60, 23, 184, 200, 37, 46, + 115, 133, 171, 92, 227, 58, 55, 184, 201, 45, 110, 115, 135, 187, 220, 227, 62, 15, 120, 200, 35, 30, 243, 132, 167, + 60, 227, 57, 47, 120, 201, 43, 94, 243, 134, 183, 188, 227, 61, 31, 248, 200, 39, 62, 243, 133, 175, 77, 59, 230, 123, + 243, 123, 145, 239, 44, 241, 131, 101, 126, 178, 194, 47, 86, 249, 237, 239, 86, 153, 238, 210, 92, 122, 75, 107, 233, + 44, 141, 53, 250, 234, 241, 191, 164, 167, 180, 148, 142, 210, 80, 250, 73, 59, 233, 38, 205, 164, 151, 180, 146, 78, + 210, 72, 250, 72, 27, 233, 34, 77, 164, 135, 180, 144, 14, 210, 64, 246, 95, 46, 212, 119, 207, 230, 217, 59, 91, 103, + 231, 108, 156, 125, 183, 237, 186, 107, 207, 125, 59, 30, 218, 239, 216, 110, 167, 246, 58, 183, 211, 165, 125, 174, + 237, 114, 107, 143, 123, 59, 60, 186, 255, 179, 187, 191, 186, 115, 209, 125, 75, 238, 90, 118, 207, 138, 59, 54, 110, + 214, 184, 91, 161, 233, 158, 255, 190, 63, 165, 188, 93, 151, 233, 3, 0, 0, ]); export const initialWitnessMap = new Map([ diff --git a/noir/noir-repo/acvm-repo/blackbox_solver/src/curve_specific_solver.rs b/noir/noir-repo/acvm-repo/blackbox_solver/src/curve_specific_solver.rs index f0ab4561229..fab67467d9a 100644 --- a/noir/noir-repo/acvm-repo/blackbox_solver/src/curve_specific_solver.rs +++ b/noir/noir-repo/acvm-repo/blackbox_solver/src/curve_specific_solver.rs @@ -11,7 +11,7 @@ pub trait BlackBoxFunctionSolver { &self, public_key_x: &FieldElement, public_key_y: &FieldElement, - signature: &[u8], + signature: &[u8; 64], message: &[u8], ) -> Result; fn pedersen_commitment( @@ -59,7 +59,7 @@ impl BlackBoxFunctionSolver for StubbedBlackBoxSolver { &self, _public_key_x: &FieldElement, _public_key_y: &FieldElement, - _signature: &[u8], + _signature: &[u8; 64], _message: &[u8], ) -> Result { Err(Self::fail(BlackBoxFunc::SchnorrVerify)) diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs index 231594170e3..f7c303888e8 100644 --- a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs @@ -52,7 +52,7 @@ impl BlackBoxFunctionSolver for Bn254BlackBoxSolver { &self, public_key_x: &FieldElement, public_key_y: &FieldElement, - signature: &[u8], + signature: &[u8; 64], message: &[u8], ) -> Result { let pub_key_bytes: Vec = diff --git a/noir/noir-repo/acvm-repo/brillig_vm/src/black_box.rs b/noir/noir-repo/acvm-repo/brillig_vm/src/black_box.rs index 73981fb0625..2857e27f1af 100644 --- a/noir/noir-repo/acvm-repo/brillig_vm/src/black_box.rs +++ b/noir/noir-repo/acvm-repo/brillig_vm/src/black_box.rs @@ -127,7 +127,8 @@ pub(crate) fn evaluate_black_box( let public_key_x = memory.read(*public_key_x).try_into().unwrap(); let public_key_y = memory.read(*public_key_y).try_into().unwrap(); let message: Vec = to_u8_vec(read_heap_vector(memory, message)); - let signature: Vec = to_u8_vec(read_heap_vector(memory, signature)); + let signature: [u8; 64] = + to_u8_vec(read_heap_vector(memory, signature)).try_into().unwrap(); let verified = solver.schnorr_verify(&public_key_x, &public_key_y, &signature, &message)?; memory.write(*result, verified.into()); diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs index ba4e03bff95..e16eb2172be 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs @@ -167,17 +167,27 @@ impl GeneratedAcir { BlackBoxFuncCall::XOR { lhs: inputs[0][0], rhs: inputs[1][0], output: outputs[0] } } BlackBoxFunc::RANGE => BlackBoxFuncCall::RANGE { input: inputs[0][0] }, - BlackBoxFunc::SHA256 => BlackBoxFuncCall::SHA256 { inputs: inputs[0].clone(), outputs }, - BlackBoxFunc::Blake2s => { - BlackBoxFuncCall::Blake2s { inputs: inputs[0].clone(), outputs } - } - BlackBoxFunc::Blake3 => BlackBoxFuncCall::Blake3 { inputs: inputs[0].clone(), outputs }, + BlackBoxFunc::SHA256 => BlackBoxFuncCall::SHA256 { + inputs: inputs[0].clone(), + outputs: outputs.try_into().expect("Compiler should generate correct size outputs"), + }, + BlackBoxFunc::Blake2s => BlackBoxFuncCall::Blake2s { + inputs: inputs[0].clone(), + outputs: outputs.try_into().expect("Compiler should generate correct size outputs"), + }, + BlackBoxFunc::Blake3 => BlackBoxFuncCall::Blake3 { + inputs: inputs[0].clone(), + outputs: outputs.try_into().expect("Compiler should generate correct size outputs"), + }, BlackBoxFunc::SchnorrVerify => { BlackBoxFuncCall::SchnorrVerify { public_key_x: inputs[0][0], public_key_y: inputs[1][0], // Schnorr signature is an r & s, 32 bytes each - signature: inputs[2].clone(), + signature: inputs[2] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), message: inputs[3].clone(), output: outputs[0], } @@ -195,24 +205,48 @@ impl GeneratedAcir { BlackBoxFunc::EcdsaSecp256k1 => { BlackBoxFuncCall::EcdsaSecp256k1 { // 32 bytes for each public key co-ordinate - public_key_x: inputs[0].clone(), - public_key_y: inputs[1].clone(), + public_key_x: inputs[0] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + public_key_y: inputs[1] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), // (r,s) are both 32 bytes each, so signature // takes up 64 bytes - signature: inputs[2].clone(), - hashed_message: inputs[3].clone(), + signature: inputs[2] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + hashed_message: inputs[3] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), output: outputs[0], } } BlackBoxFunc::EcdsaSecp256r1 => { BlackBoxFuncCall::EcdsaSecp256r1 { // 32 bytes for each public key co-ordinate - public_key_x: inputs[0].clone(), - public_key_y: inputs[1].clone(), + public_key_x: inputs[0] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + public_key_y: inputs[1] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), // (r,s) are both 32 bytes each, so signature // takes up 64 bytes - signature: inputs[2].clone(), - hashed_message: inputs[3].clone(), + signature: inputs[2] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + hashed_message: inputs[3] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), output: outputs[0], } } @@ -240,11 +274,21 @@ impl GeneratedAcir { } }; - BlackBoxFuncCall::Keccak256 { inputs: inputs[0].clone(), var_message_size, outputs } - } - BlackBoxFunc::Keccakf1600 => { - BlackBoxFuncCall::Keccakf1600 { inputs: inputs[0].clone(), outputs } + BlackBoxFuncCall::Keccak256 { + inputs: inputs[0].clone(), + var_message_size, + outputs: outputs + .try_into() + .expect("Compiler should generate correct size outputs"), + } } + BlackBoxFunc::Keccakf1600 => BlackBoxFuncCall::Keccakf1600 { + inputs: inputs[0] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + outputs: outputs.try_into().expect("Compiler should generate correct size outputs"), + }, BlackBoxFunc::RecursiveAggregation => BlackBoxFuncCall::RecursiveAggregation { verification_key: inputs[0].clone(), proof: inputs[1].clone(), @@ -286,9 +330,15 @@ impl GeneratedAcir { len: constant_inputs[0].to_u128() as u32, }, BlackBoxFunc::Sha256Compression => BlackBoxFuncCall::Sha256Compression { - inputs: inputs[0].clone(), - hash_values: inputs[1].clone(), - outputs, + inputs: inputs[0] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + hash_values: inputs[1] + .clone() + .try_into() + .expect("Compiler should generate correct size inputs"), + outputs: outputs.try_into().expect("Compiler should generate correct size outputs"), }, }; diff --git a/noir/noir-repo/tooling/lsp/src/solver.rs b/noir/noir-repo/tooling/lsp/src/solver.rs index d0acbf1aec5..0fea9b16b54 100644 --- a/noir/noir-repo/tooling/lsp/src/solver.rs +++ b/noir/noir-repo/tooling/lsp/src/solver.rs @@ -10,7 +10,7 @@ impl BlackBoxFunctionSolver for WrapperSolver { &self, public_key_x: &acvm::FieldElement, public_key_y: &acvm::FieldElement, - signature: &[u8], + signature: &[u8; 64], message: &[u8], ) -> Result { self.0.schnorr_verify(public_key_x, public_key_y, signature, message) From 91b8110ab44979fe37fcc57824bdee845295ccb7 Mon Sep 17 00:00:00 2001 From: Facundo Date: Tue, 16 Apr 2024 15:28:30 +0100 Subject: [PATCH 27/56] chore(aztec-nr): minor public interface changes (#5776) The purpose of this PR is to minimize the possible change surface on public interfaces, so that moving to the AVM simulator is easier. * Removed `get_header()` from PublicContext(Interface). It's currently unused, and the AVM does not support it as is. It CAN be added to the AvmContext if needed. However, as we are not using it now, and the AVM form is not clear (HEADERMEMBER? or whole header?) then it's better to discourage its use. * Moved `push_*_read_request` from PublicContextInterface to the PublicContext iself, as PRIVATE methods: These methods are currently unused, and IIUC, will not be used in the AVM. The only use case for these in current public would be to push read request in `PublicContext::nullifier_exists`. * Remove unused `createCommitment` oracle. --- .../aztec-nr/aztec/src/context/avm_context.nr | 12 -------- .../aztec-nr/aztec/src/context/interface.nr | 3 -- .../aztec/src/context/private_context.nr | 12 ++++---- .../aztec/src/context/public_context.nr | 30 +++++++++---------- .../aztec/src/oracle/create_commitment.nr | 6 ---- 5 files changed, 20 insertions(+), 43 deletions(-) delete mode 100644 noir-projects/aztec-nr/aztec/src/oracle/create_commitment.nr diff --git a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr index f318253d9ce..3a8dd4bb9bf 100644 --- a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr @@ -122,14 +122,6 @@ impl PublicContextInterface for AvmContext { nullifier_exists(unsiloed_nullifier, address.to_field()) == 1 } - fn push_nullifier_read_request(&mut self, nullifier: Field) { - assert(false, "'push_nullifier_read_request' not implemented!"); - } - - fn push_nullifier_non_existent_read_request(&mut self, nullifier: Field) { - assert(false, "'push_nullifier_non_existent_read_request' not implemented!"); - } - fn accumulate_encrypted_logs(&mut self, log: [Field; N]) { assert(false, "'accumulate_encrypted_logs' not implemented!"); } @@ -222,10 +214,6 @@ impl ContextInterface for AvmContext { fn selector(self) -> FunctionSelector { FunctionSelector::from_field(self.inputs.selector) } - fn get_header(self) -> Header { - assert(false, "'get_header' not implemented!"); - Header::empty() - } fn get_args_hash(self) -> Field { self.inputs.args_hash } diff --git a/noir-projects/aztec-nr/aztec/src/context/interface.nr b/noir-projects/aztec-nr/aztec/src/context/interface.nr index 7af943c3a4a..ef64964368c 100644 --- a/noir-projects/aztec-nr/aztec/src/context/interface.nr +++ b/noir-projects/aztec-nr/aztec/src/context/interface.nr @@ -13,7 +13,6 @@ trait ContextInterface { fn version(self) -> Field; fn selector(self) -> FunctionSelector; fn get_args_hash(self) -> Field; - fn get_header(self) -> Header; } // TEMPORARY: This trait is to promote sharing of the current public context @@ -27,8 +26,6 @@ trait PublicContextInterface { fn fee_per_da_gas(self) -> Field; fn fee_per_l1_gas(self) -> Field; fn fee_per_l2_gas(self) -> Field; - fn push_nullifier_read_request(&mut self, nullifier: Field); - fn push_nullifier_non_existent_read_request(&mut self, nullifier: Field); fn message_portal(&mut self, recipient: EthAddress, content: Field); fn consume_l1_to_l2_message(&mut self, content: Field, secret: Field, sender: EthAddress); fn accumulate_encrypted_logs(&mut self, log: [Field; N]); diff --git a/noir-projects/aztec-nr/aztec/src/context/private_context.nr b/noir-projects/aztec-nr/aztec/src/context/private_context.nr index 32234d84f69..b70680db040 100644 --- a/noir-projects/aztec-nr/aztec/src/context/private_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/private_context.nr @@ -100,12 +100,6 @@ impl ContextInterface for PrivateContext { self.args_hash } - // Returns the header of a block whose state is used during private execution (not the block the transaction is - // included in). - fn get_header(self) -> Header { - self.historical_header - } - fn push_new_note_hash(&mut self, note_hash: Field) { let side_effect = SideEffect { value: note_hash, counter: self.side_effect_counter }; self.new_note_hashes.push(side_effect); @@ -149,6 +143,12 @@ impl PrivateContext { } } + // Returns the header of a block whose state is used during private execution (not the block the transaction is + // included in). + fn get_header(self) -> Header { + self.historical_header + } + // Returns the header of an arbitrary block whose block number is less than or equal to the block number // of historical header. pub fn get_header_at(self, block_number: u32) -> Header { diff --git a/noir-projects/aztec-nr/aztec/src/context/public_context.nr b/noir-projects/aztec-nr/aztec/src/context/public_context.nr index a1257223850..1c61e53712e 100644 --- a/noir-projects/aztec-nr/aztec/src/context/public_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/public_context.nr @@ -130,6 +130,20 @@ impl PublicContext { self.return_hash = returns_hasher.hash(); } + // Keep private or ask the AVM team if you want to change it. + fn push_nullifier_read_request(&mut self, nullifier: Field) { + let request = ReadRequest { value: nullifier, counter: self.side_effect_counter }; + self.nullifier_read_requests.push(request); + self.side_effect_counter = self.side_effect_counter + 1; + } + + // Keep private or ask the AVM team if you want to change it. + fn push_nullifier_non_existent_read_request(&mut self, nullifier: Field) { + let request = ReadRequest { value: nullifier, counter: self.side_effect_counter }; + self.nullifier_non_existent_read_requests.push(request); + self.side_effect_counter = self.side_effect_counter + 1; + } + pub fn finish(self) -> PublicCircuitPublicInputs { // TODO(https://github.com/AztecProtocol/aztec-packages/issues/1165) let unencrypted_logs_hash = 0; @@ -190,10 +204,6 @@ impl ContextInterface for PublicContext { self.args_hash } - fn get_header(self) -> Header { - self.historical_header - } - fn push_new_note_hash(&mut self, note_hash: Field) { let side_effect = SideEffect { value: note_hash, counter: self.side_effect_counter }; self.new_note_hashes.push(side_effect); @@ -246,18 +256,6 @@ impl PublicContextInterface for PublicContext { nullifier_exists_oracle(siloed_nullifier) == 1 } - fn push_nullifier_read_request(&mut self, nullifier: Field) { - let request = ReadRequest { value: nullifier, counter: self.side_effect_counter }; - self.nullifier_read_requests.push(request); - self.side_effect_counter = self.side_effect_counter + 1; - } - - fn push_nullifier_non_existent_read_request(&mut self, nullifier: Field) { - let request = ReadRequest { value: nullifier, counter: self.side_effect_counter }; - self.nullifier_non_existent_read_requests.push(request); - self.side_effect_counter = self.side_effect_counter + 1; - } - fn message_portal(&mut self, recipient: EthAddress, content: Field) { let message = L2ToL1Message { recipient, content }; self.new_l2_to_l1_msgs.push(message); diff --git a/noir-projects/aztec-nr/aztec/src/oracle/create_commitment.nr b/noir-projects/aztec-nr/aztec/src/oracle/create_commitment.nr deleted file mode 100644 index 62c848c1d71..00000000000 --- a/noir-projects/aztec-nr/aztec/src/oracle/create_commitment.nr +++ /dev/null @@ -1,6 +0,0 @@ -#[oracle(createCommitment)] -fn create_commitment_oracle(_commitment: Field) -> Field {} - -unconstrained pub fn create_commitment(commitment: Field) { - assert(create_commitment_oracle(commitment) == 0); -} From 95eadd67a72a286f07876f80586e6d57605d0af5 Mon Sep 17 00:00:00 2001 From: Facundo Date: Tue, 16 Apr 2024 15:37:44 +0100 Subject: [PATCH 28/56] feat(avm): take sizeOffset in CALL (#5763) CC @Thunkar. --- avm-transpiler/src/transpile.rs | 38 ++++++++++++------- .../public-vm/gen/_instruction-set.mdx | 6 +-- .../InstructionSet/InstructionSet.js | 7 ++-- .../aztec-nr/aztec/src/context/avm_context.nr | 16 ++++---- .../src/avm/opcodes/external_calls.test.ts | 22 +++++++---- .../src/avm/opcodes/external_calls.ts | 13 ++++--- 6 files changed, 61 insertions(+), 41 deletions(-) diff --git a/avm-transpiler/src/transpile.rs b/avm-transpiler/src/transpile.rs index 91345424a3c..581438c2ccb 100644 --- a/avm-transpiler/src/transpile.rs +++ b/avm-transpiler/src/transpile.rs @@ -2,7 +2,7 @@ use acvm::acir::brillig::Opcode as BrilligOpcode; use acvm::acir::circuit::brillig::Brillig; use acvm::brillig_vm::brillig::{ - BinaryFieldOp, BinaryIntOp, BlackBoxOp, HeapArray, MemoryAddress, ValueOrArray, + BinaryFieldOp, BinaryIntOp, BlackBoxOp, HeapArray, HeapVector, MemoryAddress, ValueOrArray, }; use acvm::FieldElement; @@ -380,16 +380,16 @@ fn handle_external_call( inputs: &Vec, opcode: AvmOpcode, ) { - if destinations.len() != 2 || inputs.len() != 4 { + if destinations.len() != 2 || inputs.len() != 5 { panic!( - "Transpiler expects ForeignCall (Static)Call to have 2 destinations and 4 inputs, got {} and {}. + "Transpiler expects ForeignCall (Static)Call to have 2 destinations and 5 inputs, got {} and {}. Make sure your call instructions's input/return arrays have static length (`[Field; ]`)!", destinations.len(), inputs.len() ); } - let gas_offset_maybe = inputs[0]; - let gas_offset = match gas_offset_maybe { + let gas = inputs[0]; + let gas_offset = match gas { ValueOrArray::HeapArray(HeapArray { pointer, size }) => { assert!(size == 3, "Call instruction's gas input should be a HeapArray of size 3 (`[l1Gas, l2Gas, daGas]`)"); pointer.0 as u32 @@ -401,13 +401,16 @@ fn handle_external_call( ValueOrArray::MemoryAddress(offset) => offset.to_usize() as u32, _ => panic!("Call instruction's target address input should be a basic MemoryAddress",), }; - let args_offset_maybe = inputs[2]; - let (args_offset, args_size) = match args_offset_maybe { - ValueOrArray::HeapArray(HeapArray { pointer, size }) => (pointer.0 as u32, size as u32), - ValueOrArray::HeapVector(_) => panic!("Call instruction's args must be a HeapArray, not a HeapVector. Make sure you are explicitly defining its size (`[arg0, arg1, ... argN]`)!"), - _ => panic!("Call instruction's args input should be a HeapArray input"), + // The args are a slice, and this is represented as a (Field, HeapVector). + // The field is the length (memory address) and the HeapVector has the data and length again. + // This is an ACIR internal representation detail that leaks to the SSA. + // Observe that below, we use `inputs[3]` and therefore skip the length field. + let args = inputs[3]; + let (args_offset, args_size_offset) = match args { + ValueOrArray::HeapVector(HeapVector { pointer, size }) => (pointer.0 as u32, size.0 as u32), + _ => panic!("Call instruction's args input should be a HeapVector input"), }; - let temporary_function_selector_offset = match &inputs[3] { + let temporary_function_selector_offset = match &inputs[4] { ValueOrArray::MemoryAddress(offset) => offset.to_usize() as u32, _ => panic!( "Call instruction's temporary function selector input should be a basic MemoryAddress", @@ -426,14 +429,23 @@ fn handle_external_call( }; avm_instrs.push(AvmInstruction { opcode: opcode, - indirect: Some(0b01101), // (left to right) selector direct, ret offset INDIRECT, args offset INDIRECT, address offset direct, gas offset INDIRECT + // (left to right) + // * selector direct + // * ret offset INDIRECT + // * arg size offset direct + // * args offset INDIRECT + // * address offset direct + // * gas offset INDIRECT + indirect: Some(0b010101), operands: vec![ AvmOperand::U32 { value: gas_offset }, AvmOperand::U32 { value: address_offset, }, AvmOperand::U32 { value: args_offset }, - AvmOperand::U32 { value: args_size }, + AvmOperand::U32 { + value: args_size_offset, + }, AvmOperand::U32 { value: ret_offset }, AvmOperand::U32 { value: ret_size }, AvmOperand::U32 { diff --git a/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx b/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx index 43dfced8b9a..0467dcd11df 100644 --- a/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx +++ b/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx @@ -1700,7 +1700,7 @@ Call into another contract - **gasOffset**: offset to three words containing `{l1GasLeft, l2GasLeft, daGasLeft}`: amount of gas to provide to the callee - **addrOffset**: address of the contract to call - **argsOffset**: memory offset to args (will become the callee's calldata) - - **argsSize**: number of words to pass via callee's calldata + - **argsSizeOffset**: memory offset for the number of words to pass via callee's calldata - **retOffset**: destination memory offset specifying where to store the data returned from the callee - **retSize**: number of words to copy from data returned by callee - **successOffset**: destination memory offset specifying where to store the call's success (0: failure, 1: success) @@ -1748,7 +1748,7 @@ Call into another contract, disallowing World State and Accrued Substate modific - **gasOffset**: offset to three words containing `{l1GasLeft, l2GasLeft, daGasLeft}`: amount of gas to provide to the callee - **addrOffset**: address of the contract to call - **argsOffset**: memory offset to args (will become the callee's calldata) - - **argsSize**: number of words to pass via callee's calldata + - **argsSizeOffset**: memory offset for the number of words to pass via callee's calldata - **retOffset**: destination memory offset specifying where to store the data returned from the callee - **retSize**: number of words to copy from data returned by callee - **successOffset**: destination memory offset specifying where to store the call's success (0: failure, 1: success) @@ -1793,7 +1793,7 @@ Call into another contract, but keep the caller's `sender` and `storageAddress` - **gasOffset**: offset to three words containing `{l1GasLeft, l2GasLeft, daGasLeft}`: amount of gas to provide to the callee - **addrOffset**: address of the contract to call - **argsOffset**: memory offset to args (will become the callee's calldata) - - **argsSize**: number of words to pass via callee's calldata + - **argsSizeOffset**: memory offset for the number of words to pass via callee's calldata - **retOffset**: destination memory offset specifying where to store the data returned from the callee - **retSize**: number of words to copy from data returned by callee - **successOffset**: destination memory offset specifying where to store the call's success (0: failure, 1: success) diff --git a/docs/src/preprocess/InstructionSet/InstructionSet.js b/docs/src/preprocess/InstructionSet/InstructionSet.js index 936a15b0c23..c6c3721963d 100644 --- a/docs/src/preprocess/InstructionSet/InstructionSet.js +++ b/docs/src/preprocess/InstructionSet/InstructionSet.js @@ -38,10 +38,9 @@ const CALL_INSTRUCTION_ARGS = [ description: "memory offset to args (will become the callee's calldata)", }, { - name: "argsSize", - description: "number of words to pass via callee's calldata", - mode: "immediate", - type: "u32", + name: "argsSizeOffset", + description: + "memory offset for the number of words to pass via callee's calldata", }, { name: "retOffset", diff --git a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr index 3a8dd4bb9bf..504dec77522 100644 --- a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr @@ -63,7 +63,7 @@ impl AvmContext { call( gas_for_call(gas), contract_address, - args, + args.as_slice(), temporary_function_selector ) } @@ -78,7 +78,7 @@ impl AvmContext { call_static( gas_for_call(gas), contract_address, - args, + args.as_slice(), temporary_function_selector ) } @@ -149,7 +149,7 @@ impl PublicContextInterface for AvmContext { let results = call( gas_for_call(gas_opts), contract_address, - args, + args.as_slice(), temporary_function_selector.to_field() ); let data_to_return: [Field; RETURNS_COUNT] = results.0; @@ -169,7 +169,7 @@ impl PublicContextInterface for AvmContext { let (data_to_return, success): ([Field; RETURNS_COUNT], u8) = call_static( gas_for_call(gas_opts), contract_address, - args, + args.as_slice(), temporary_function_selector.to_field() ); @@ -296,20 +296,20 @@ fn l1_to_l2_msg_exists(msg_hash: Field, msg_leaf_index: Field) -> u8 {} fn send_l2_to_l1_msg(recipient: EthAddress, content: Field) {} #[oracle(avmOpcodeCall)] -fn call( +fn call( gas: [Field; 3], // gas allocation: [l1_gas, l2_gas, da_gas] address: AztecAddress, - args: [Field; ARGS_COUNT], + args: [Field], // TODO(5110): consider passing in calldata directly temporary_function_selector: Field ) -> ([Field; RET_SIZE], u8) {} // ^ return data ^ success #[oracle(avmOpcodeStaticCall)] -fn call_static( +fn call_static( gas: [Field; 3], // gas allocation: [l1_gas, l2_gas, da_gas] address: AztecAddress, - args: [Field; ARGS_COUNT], + args: [Field], // TODO(5110): consider passing in calldata directly temporary_function_selector: Field ) -> ([Field; RET_SIZE], u8) {} diff --git a/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts b/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts index c9acf97b61e..29c6626fa8d 100644 --- a/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts +++ b/yarn-project/simulator/src/avm/opcodes/external_calls.test.ts @@ -6,7 +6,7 @@ import { mock } from 'jest-mock-extended'; import { type CommitmentsDB, type PublicContractsDB, type PublicStateDB } from '../../index.js'; import { markBytecodeAsAvm } from '../../public/transitional_adaptors.js'; import { type AvmContext } from '../avm_context.js'; -import { Field, Uint8 } from '../avm_memory_types.js'; +import { Field, Uint8, Uint32 } from '../avm_memory_types.js'; import { adjustCalldataIndex, initContext } from '../fixtures/index.js'; import { HostStorage } from '../journal/host_storage.js'; import { AvmPersistableStateManager } from '../journal/journal.js'; @@ -36,7 +36,7 @@ describe('External Calls', () => { ...Buffer.from('12345678', 'hex'), // gasOffset ...Buffer.from('a2345678', 'hex'), // addrOffset ...Buffer.from('b2345678', 'hex'), // argsOffset - ...Buffer.from('c2345678', 'hex'), // argsSize + ...Buffer.from('c2345678', 'hex'), // argsSizeOffset ...Buffer.from('d2345678', 'hex'), // retOffset ...Buffer.from('e2345678', 'hex'), // retSize ...Buffer.from('f2345678', 'hex'), // successOffset @@ -47,7 +47,7 @@ describe('External Calls', () => { /*gasOffset=*/ 0x12345678, /*addrOffset=*/ 0xa2345678, /*argsOffset=*/ 0xb2345678, - /*argsSize=*/ 0xc2345678, + /*argsSizeOffset=*/ 0xc2345678, /*retOffset=*/ 0xd2345678, /*retSize=*/ 0xe2345678, /*successOffset=*/ 0xf2345678, @@ -68,6 +68,7 @@ describe('External Calls', () => { const argsOffset = 4; const args = [new Field(1n), new Field(2n), new Field(3n)]; const argsSize = args.length; + const argsSizeOffset = 20; const retOffset = 8; const retSize = 2; const successOffset = 7; @@ -93,6 +94,7 @@ describe('External Calls', () => { context.machineState.memory.set(1, new Field(l2Gas)); context.machineState.memory.set(2, new Field(daGas)); context.machineState.memory.set(3, new Field(addr)); + context.machineState.memory.set(argsSizeOffset, new Uint32(argsSize)); context.machineState.memory.setSlice(4, args); jest .spyOn(context.persistableState.hostStorage.contractsDb, 'getBytecode') @@ -103,7 +105,7 @@ describe('External Calls', () => { gasOffset, addrOffset, argsOffset, - argsSize, + argsSizeOffset, retOffset, retSize, successOffset, @@ -145,6 +147,7 @@ describe('External Calls', () => { const argsOffset = 4; const args = [new Field(1n), new Field(2n), new Field(3n)]; const argsSize = args.length; + const argsSizeOffset = 20; const retOffset = 8; const retSize = 2; const successOffset = 7; @@ -153,6 +156,7 @@ describe('External Calls', () => { context.machineState.memory.set(1, new Field(l2Gas)); context.machineState.memory.set(2, new Field(daGas)); context.machineState.memory.set(3, new Field(addr)); + context.machineState.memory.set(argsSizeOffset, new Uint32(argsSize)); context.machineState.memory.setSlice(4, args); jest @@ -164,7 +168,7 @@ describe('External Calls', () => { gasOffset, addrOffset, argsOffset, - argsSize, + argsSizeOffset, retOffset, retSize, successOffset, @@ -183,7 +187,7 @@ describe('External Calls', () => { ...Buffer.from('12345678', 'hex'), // gasOffset ...Buffer.from('a2345678', 'hex'), // addrOffset ...Buffer.from('b2345678', 'hex'), // argsOffset - ...Buffer.from('c2345678', 'hex'), // argsSize + ...Buffer.from('c2345678', 'hex'), // argsSizeOffset ...Buffer.from('d2345678', 'hex'), // retOffset ...Buffer.from('e2345678', 'hex'), // retSize ...Buffer.from('f2345678', 'hex'), // successOffset @@ -194,7 +198,7 @@ describe('External Calls', () => { /*gasOffset=*/ 0x12345678, /*addrOffset=*/ 0xa2345678, /*argsOffset=*/ 0xb2345678, - /*argsSize=*/ 0xc2345678, + /*argsSizeOffset=*/ 0xc2345678, /*retOffset=*/ 0xd2345678, /*retSize=*/ 0xe2345678, /*successOffset=*/ 0xf2345678, @@ -214,12 +218,14 @@ describe('External Calls', () => { const args = [new Field(1n), new Field(2n), new Field(3n)]; const argsSize = args.length; + const argsSizeOffset = 20; const retOffset = 8; const retSize = 2; const successOffset = 7; context.machineState.memory.set(0, gas); context.machineState.memory.set(1, addr); + context.machineState.memory.set(argsSizeOffset, new Uint32(argsSize)); context.machineState.memory.setSlice(2, args); const otherContextInstructions: Instruction[] = [ @@ -243,7 +249,7 @@ describe('External Calls', () => { gasOffset, addrOffset, argsOffset, - argsSize, + argsSizeOffset, retOffset, retSize, successOffset, diff --git a/yarn-project/simulator/src/avm/opcodes/external_calls.ts b/yarn-project/simulator/src/avm/opcodes/external_calls.ts index 2d25634055a..fd54c6dbfe6 100644 --- a/yarn-project/simulator/src/avm/opcodes/external_calls.ts +++ b/yarn-project/simulator/src/avm/opcodes/external_calls.ts @@ -36,7 +36,7 @@ abstract class ExternalCall extends Instruction { private gasOffset: number /* Unused due to no formal gas implementation at this moment */, private addrOffset: number, private argsOffset: number, - private argsSize: number, + private argsSizeOffset: number, private retOffset: number, private retSize: number, private successOffset: number, @@ -50,20 +50,23 @@ abstract class ExternalCall extends Instruction { public async execute(context: AvmContext) { const memory = context.machineState.memory.track(this.type); - const [gasOffset, addrOffset, argsOffset, retOffset, successOffset] = Addressing.fromWire(this.indirect).resolve( - [this.gasOffset, this.addrOffset, this.argsOffset, this.retOffset, this.successOffset], + const [gasOffset, addrOffset, argsOffset, argsSizeOffset, retOffset, successOffset] = Addressing.fromWire( + this.indirect, + ).resolve( + [this.gasOffset, this.addrOffset, this.argsOffset, this.argsSizeOffset, this.retOffset, this.successOffset], memory, ); const callAddress = memory.getAs(addrOffset); - const calldata = memory.getSlice(argsOffset, this.argsSize).map(f => f.toFr()); + const calldataSize = memory.get(argsSizeOffset).toNumber(); + const calldata = memory.getSlice(argsOffset, calldataSize).map(f => f.toFr()); const l1Gas = memory.get(gasOffset).toNumber(); const l2Gas = memory.getAs(gasOffset + 1).toNumber(); const daGas = memory.getAs(gasOffset + 2).toNumber(); const functionSelector = memory.getAs(this.temporaryFunctionSelectorOffset).toFr(); const allocatedGas = { l1Gas, l2Gas, daGas }; - const memoryOperations = { reads: this.argsSize + 5, writes: 1 + this.retSize, indirect: this.indirect }; + const memoryOperations = { reads: calldataSize + 6, writes: 1 + this.retSize, indirect: this.indirect }; const totalGas = sumGas(this.gasCost(memoryOperations), allocatedGas); context.machineState.consumeGas(totalGas); From 8ebbe57953e35f81ca010cdd686fb43ddf0f20b2 Mon Sep 17 00:00:00 2001 From: Jean M <132435771+jeanmon@users.noreply.github.com> Date: Tue, 16 Apr 2024 17:28:30 +0200 Subject: [PATCH 29/56] chore(avm): Split the negative test on range check for high 16-bit registers (#5785) --- .../vm/tests/avm_inter_table.test.cpp | 55 +++++++++++++------ 1 file changed, 39 insertions(+), 16 deletions(-) diff --git a/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp b/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp index cd92aad3226..0e7fdce2205 100644 --- a/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp +++ b/barretenberg/cpp/src/barretenberg/vm/tests/avm_inter_table.test.cpp @@ -295,7 +295,9 @@ TEST_F(AvmRangeCheckNegativeTests, additionU16Reg0) // These registers are not involved for the arithmetic // relations of the addition but the range checks are currently // enabled. -TEST_F(AvmRangeCheckNegativeTests, additionU16RegHigh) + +// U16_R7 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg7) { genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); auto trace_original = trace; @@ -309,47 +311,68 @@ TEST_F(AvmRangeCheckNegativeTests, additionU16RegHigh) // Second attempt by decreasing counter for u16_r0 range check lookup trace.at(1).lookup_u16_7_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_7"); +} - // Subsequent range checks are attempted only after counter decrease. +// Subsequent range checks are attempted only after counter decrease. - // U16_R8 - trace = trace_original; +// U16_R8 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg8) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r8 = FF(235655); trace.at(1).lookup_u16_8_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_8"); +} - // U16_R9 - trace = trace_original; +// U16_R9 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg9) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r9 = FF(235655); trace.at(1).lookup_u16_9_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_9"); +} - // U16_R10 - trace = trace_original; +// U16_R10 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg10) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r10 = FF(235655); trace.at(1).lookup_u16_10_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_10"); +} - // U16_R11 - trace = trace_original; +// U16_R11 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg11) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r11 = FF(235655); trace.at(1).lookup_u16_11_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_11"); +} - // U16_R12 - trace = trace_original; +// U16_R12 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg12) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r12 = FF(235655); trace.at(1).lookup_u16_12_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_12"); +} - // U16_R13 - trace = trace_original; +// U16_R13 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg13) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r13 = FF(235655); trace.at(1).lookup_u16_13_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_13"); +} - // U16_R14 - trace = trace_original; +// U16_R14 +TEST_F(AvmRangeCheckNegativeTests, additionU16Reg14) +{ + genTraceAdd(4500, 45, 4545, AvmMemoryTag::U16); trace.at(alu_idx).avm_alu_u16_r14 = FF(235655); trace.at(1).lookup_u16_14_counts -= FF(1); EXPECT_THROW_WITH_MESSAGE(validate_trace_check_circuit(std::move(trace)), "LOOKUP_U16_14"); From 785591e0527beef7adf0f7a791618afff9df3705 Mon Sep 17 00:00:00 2001 From: PhilWindle <60546371+PhilWindle@users.noreply.github.com> Date: Tue, 16 Apr 2024 16:40:29 +0100 Subject: [PATCH 30/56] fix: Take a deep copy of circuit inputs for proving (#5777) This PR ensures we take a copy of the circuit inputs during simulation for use in proving. --- .circleci/config.yml | 94 +++++++++---------- .../structs/kernel/public_call_data.test.ts | 10 ++ .../src/structs/kernel/public_call_data.ts | 26 +++-- ...blic_kernel_circuit_private_inputs.test.ts | 17 ++++ .../public_kernel_circuit_private_inputs.ts | 17 +++- ...kernel_tail_circuit_private_inputs.test.ts | 17 ++++ ...blic_kernel_tail_circuit_private_inputs.ts | 24 ++++- .../non_existent_read_request_hints.ts | 7 +- .../src/public/abstract_phase_manager.ts | 7 +- .../src/public/tail_phase_manager.ts | 4 +- 10 files changed, 158 insertions(+), 65 deletions(-) create mode 100644 yarn-project/circuits.js/src/structs/kernel/public_call_data.test.ts create mode 100644 yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.test.ts create mode 100644 yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.test.ts diff --git a/.circleci/config.yml b/.circleci/config.yml index 5b7245c3e60..6b4c8af64ae 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -531,35 +531,35 @@ jobs: # Semantics are similar to Dockerfile # NOTE: Unlike other e2e, these will be re-enabled here as currently the logs functionality is not in the new earthfile setup - # bench-publish-rollup: - # steps: - # - *checkout - # - *setup_env - # - run: - # name: "Benchmark" - # command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_publish_rollup.test.ts DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees - # aztec_manifest_key: end-to-end - # <<: *defaults_e2e_test - - # bench-process-history: - # steps: - # - *checkout - # - *setup_env - # - run: - # name: "Benchmark" - # command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_process_history.test.ts DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees - # aztec_manifest_key: end-to-end - # <<: *defaults_e2e_test - - # bench-tx-size: - # steps: - # - *checkout - # - *setup_env - # - run: - # name: "Benchmark" - # command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees - # aztec_manifest_key: end-to-end - # <<: *defaults_e2e_test + bench-publish-rollup: + steps: + - *checkout + - *setup_env + - run: + name: "Benchmark" + command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_publish_rollup.test.ts DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees + aztec_manifest_key: end-to-end + <<: *defaults_e2e_test + + bench-process-history: + steps: + - *checkout + - *setup_env + - run: + name: "Benchmark" + command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_process_history.test.ts DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees + aztec_manifest_key: end-to-end + <<: *defaults_e2e_test + + bench-tx-size: + steps: + - *checkout + - *setup_env + - run: + name: "Benchmark" + command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees + aztec_manifest_key: end-to-end + <<: *defaults_e2e_test build-docs: machine: @@ -597,15 +597,15 @@ jobs: name: "Noop" command: echo Noop - # bench-summary: - # machine: - # image: default - # steps: - # - *checkout - # - *setup_env - # - run: - # name: "Assemble benchmark summary from uploaded logs" - # command: ./scripts/ci/assemble_e2e_benchmark.sh + bench-summary: + machine: + image: default + steps: + - *checkout + - *setup_env + - run: + name: "Assemble benchmark summary from uploaded logs" + command: ./scripts/ci/assemble_e2e_benchmark.sh # Deploy & release jobs. deploy-and-release: @@ -898,15 +898,15 @@ workflows: <<: *defaults # Benchmark jobs. - # - bench-publish-rollup: *e2e_test - # - bench-process-history: *e2e_test - # - bench-tx-size: *e2e_test - # - bench-summary: - # requires: - # - bench-publish-rollup - # - bench-process-history - # - bench-tx-size - # <<: *defaults + - bench-publish-rollup: *e2e_test + - bench-process-history: *e2e_test + - bench-tx-size: *e2e_test + - bench-summary: + requires: + - bench-publish-rollup + - bench-process-history + - bench-tx-size + <<: *defaults # Production releases. - deploy-and-release: *defaults_deploy diff --git a/yarn-project/circuits.js/src/structs/kernel/public_call_data.test.ts b/yarn-project/circuits.js/src/structs/kernel/public_call_data.test.ts new file mode 100644 index 00000000000..cafa167f31e --- /dev/null +++ b/yarn-project/circuits.js/src/structs/kernel/public_call_data.test.ts @@ -0,0 +1,10 @@ +import { makePublicCallData } from '../../tests/factories.js'; +import { PublicCallData } from './public_call_data.js'; + +describe('PublicCallData', () => { + it('PublicCallData after serialization and deserialization is equal to the original', () => { + const original = makePublicCallData(123, true); + const serialized = PublicCallData.fromBuffer(original.toBuffer()); + expect(original).toEqual(serialized); + }); +}); diff --git a/yarn-project/circuits.js/src/structs/kernel/public_call_data.ts b/yarn-project/circuits.js/src/structs/kernel/public_call_data.ts index 5d53b9a49a7..249bd3fa1a8 100644 --- a/yarn-project/circuits.js/src/structs/kernel/public_call_data.ts +++ b/yarn-project/circuits.js/src/structs/kernel/public_call_data.ts @@ -1,10 +1,10 @@ -import { type Fr } from '@aztec/foundation/fields'; -import { type Tuple, serializeToBuffer } from '@aztec/foundation/serialize'; +import { Fr } from '@aztec/foundation/fields'; +import { BufferReader, type Tuple, serializeToBuffer } from '@aztec/foundation/serialize'; -import { type MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL } from '../../constants.gen.js'; -import { type CallRequest } from '../call_request.js'; -import { type Proof } from '../proof.js'; -import { type PublicCallStackItem } from '../public_call_stack_item.js'; +import { MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL } from '../../constants.gen.js'; +import { CallRequest } from '../call_request.js'; +import { Proof } from '../proof.js'; +import { PublicCallStackItem } from '../public_call_stack_item.js'; /** * Public calldata assembled from the kernel execution result and proof. @@ -42,4 +42,18 @@ export class PublicCallData { this.bytecodeHash, ); } + + static fromBuffer(buffer: BufferReader | Buffer) { + const reader = BufferReader.asReader(buffer); + return new PublicCallData( + reader.readObject(PublicCallStackItem), + reader.readArray( + MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL, + CallRequest, + ), + reader.readObject(Proof), + reader.readObject(Fr), + reader.readObject(Fr), + ); + } } diff --git a/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.test.ts b/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.test.ts new file mode 100644 index 00000000000..0240c1b081c --- /dev/null +++ b/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.test.ts @@ -0,0 +1,17 @@ +import { makePublicKernelCircuitPrivateInputs } from '../../tests/factories.js'; +import { PublicKernelCircuitPrivateInputs } from './public_kernel_circuit_private_inputs.js'; + +describe('PublicKernelCircuitPrivateInputs', () => { + it('PublicKernelCircuitPrivateInputs after serialization and deserialization is equal to the original', () => { + const original = makePublicKernelCircuitPrivateInputs(123); + const serialized = PublicKernelCircuitPrivateInputs.fromBuffer(original.toBuffer()); + expect(original).toEqual(serialized); + }); + + it('PublicKernelCircuitPrivateInputs after clone is equal to the original', () => { + const original = makePublicKernelCircuitPrivateInputs(123); + const serialized = original.clone(); + expect(original).toEqual(serialized); + expect(original).not.toBe(serialized); + }); +}); diff --git a/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.ts b/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.ts index 86530dc0f4d..63f377cd63c 100644 --- a/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.ts +++ b/yarn-project/circuits.js/src/structs/kernel/public_kernel_circuit_private_inputs.ts @@ -1,7 +1,7 @@ -import { serializeToBuffer } from '@aztec/foundation/serialize'; +import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; -import { type PublicCallData } from './public_call_data.js'; -import { type PublicKernelData } from './public_kernel_data.js'; +import { PublicCallData } from './public_call_data.js'; +import { PublicKernelData } from './public_kernel_data.js'; /** * Inputs to the public kernel circuit. @@ -21,4 +21,15 @@ export class PublicKernelCircuitPrivateInputs { toBuffer() { return serializeToBuffer(this.previousKernel, this.publicCall); } + + static fromBuffer(buffer: BufferReader | Buffer) { + const reader = BufferReader.asReader(buffer); + const previousKernel = reader.readObject(PublicKernelData); + const publicCall = reader.readObject(PublicCallData); + return new PublicKernelCircuitPrivateInputs(previousKernel, publicCall); + } + + clone() { + return PublicKernelCircuitPrivateInputs.fromBuffer(this.toBuffer()); + } } diff --git a/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.test.ts b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.test.ts new file mode 100644 index 00000000000..e53f3f2df21 --- /dev/null +++ b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.test.ts @@ -0,0 +1,17 @@ +import { makePublicKernelTailCircuitPrivateInputs } from '../../tests/factories.js'; +import { PublicKernelTailCircuitPrivateInputs } from './public_kernel_tail_circuit_private_inputs.js'; + +describe('PublicKernelTailCircuitPrivateInputs', () => { + it('PublicKernelTailCircuitPrivateInputs after serialization and deserialization is equal to the original', () => { + const original = makePublicKernelTailCircuitPrivateInputs(123); + const serialized = PublicKernelTailCircuitPrivateInputs.fromBuffer(original.toBuffer()); + expect(original).toEqual(serialized); + }); + + it('PublicKernelTailCircuitPrivateInputs after clone is equal to the original', () => { + const original = makePublicKernelTailCircuitPrivateInputs(123); + const serialized = original.clone(); + expect(original).toEqual(serialized); + expect(original).not.toBe(serialized); + }); +}); diff --git a/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts index 073c0598861..be3037d4565 100644 --- a/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts +++ b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts @@ -1,8 +1,11 @@ -import { serializeToBuffer } from '@aztec/foundation/serialize'; +import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; -import { type NullifierNonExistentReadRequestHints } from '../non_existent_read_request_hints.js'; -import { type NullifierReadRequestHints } from '../read_request_hints.js'; -import { type PublicKernelData } from './public_kernel_data.js'; +import { + type NullifierNonExistentReadRequestHints, + nullifierNonExistentReadRequestHintsFromBuffer, +} from '../non_existent_read_request_hints.js'; +import { type NullifierReadRequestHints, nullifierReadRequestHintsFromBuffer } from '../read_request_hints.js'; +import { PublicKernelData } from './public_kernel_data.js'; /** * Inputs to the public kernel circuit. @@ -30,4 +33,17 @@ export class PublicKernelTailCircuitPrivateInputs { this.nullifierNonExistentReadRequestHints, ); } + + static fromBuffer(buffer: Buffer | BufferReader) { + const reader = BufferReader.asReader(buffer); + return new PublicKernelTailCircuitPrivateInputs( + reader.readObject(PublicKernelData), + nullifierReadRequestHintsFromBuffer(reader), + nullifierNonExistentReadRequestHintsFromBuffer(reader), + ); + } + + clone() { + return PublicKernelTailCircuitPrivateInputs.fromBuffer(this.toBuffer()); + } } diff --git a/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts b/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts index a459be8be34..9659c63d0c3 100644 --- a/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts +++ b/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts @@ -84,7 +84,12 @@ export class NonExistentReadRequestHints< } toBuffer() { - return serializeToBuffer(this.nonMembershipHints, this.nextPendingValueIndices); + return serializeToBuffer( + this.nonMembershipHints, + this.nextPendingValueIndices, + this.sortedPendingValues, + this.sortedPendingValueHints, + ); } } diff --git a/yarn-project/simulator/src/public/abstract_phase_manager.ts b/yarn-project/simulator/src/public/abstract_phase_manager.ts index 1ccbf3669cc..cb56906ea2a 100644 --- a/yarn-project/simulator/src/public/abstract_phase_manager.ts +++ b/yarn-project/simulator/src/public/abstract_phase_manager.ts @@ -339,14 +339,15 @@ export abstract class AbstractPhaseManager { ): Promise<[PublicKernelCircuitPrivateInputs, PublicKernelCircuitPublicInputs]> { const previousKernel = this.getPreviousKernelData(previousOutput, previousProof); + // We take a deep copy (clone) of these inputs to be passed to the prover const inputs = new PublicKernelCircuitPrivateInputs(previousKernel, callData); switch (this.phase) { case PublicKernelPhase.SETUP: - return [inputs, await this.publicKernel.publicKernelCircuitSetup(inputs)]; + return [inputs.clone(), await this.publicKernel.publicKernelCircuitSetup(inputs)]; case PublicKernelPhase.APP_LOGIC: - return [inputs, await this.publicKernel.publicKernelCircuitAppLogic(inputs)]; + return [inputs.clone(), await this.publicKernel.publicKernelCircuitAppLogic(inputs)]; case PublicKernelPhase.TEARDOWN: - return [inputs, await this.publicKernel.publicKernelCircuitTeardown(inputs)]; + return [inputs.clone(), await this.publicKernel.publicKernelCircuitTeardown(inputs)]; default: throw new Error(`No public kernel circuit for inputs`); } diff --git a/yarn-project/simulator/src/public/tail_phase_manager.ts b/yarn-project/simulator/src/public/tail_phase_manager.ts index 0cc78be521f..44ebe1dd2d3 100644 --- a/yarn-project/simulator/src/public/tail_phase_manager.ts +++ b/yarn-project/simulator/src/public/tail_phase_manager.ts @@ -101,12 +101,14 @@ export class TailPhaseManager extends AbstractPhaseManager { endNonRevertibleData.newNullifiers, end.newNullifiers, ); + + // We take a deep copy (clone) of these to pass to the prover const inputs = new PublicKernelTailCircuitPrivateInputs( previousKernel, nullifierReadRequestHints, nullifierNonExistentReadRequestHints, ); - return [inputs, await this.publicKernel.publicKernelCircuitTail(inputs)]; + return [inputs.clone(), await this.publicKernel.publicKernelCircuitTail(inputs)]; } private sortNoteHashes(noteHashes: Tuple): Tuple { From 102e8b89e91c324f945ab94357508c25eba4fa92 Mon Sep 17 00:00:00 2001 From: Santiago Palladino Date: Tue, 16 Apr 2024 13:13:03 -0300 Subject: [PATCH 31/56] chore: Re-enable e2e fees tests (#5784) Fixes and re-enables e2e fees tests. --- yarn-project/end-to-end/src/e2e_fees.test.ts | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/yarn-project/end-to-end/src/e2e_fees.test.ts b/yarn-project/end-to-end/src/e2e_fees.test.ts index 8db6d025114..5367463c6c7 100644 --- a/yarn-project/end-to-end/src/e2e_fees.test.ts +++ b/yarn-project/end-to-end/src/e2e_fees.test.ts @@ -46,6 +46,7 @@ describe('e2e_fees', () => { let gasTokenContract: GasTokenContract; let bananaCoin: BananaCoin; let bananaFPC: FPCContract; + let logger: DebugLogger; let gasBridgeTestHarness: IGasBridgingTestHarness; @@ -61,8 +62,9 @@ describe('e2e_fees', () => { }); beforeAll(async () => { - const { wallets: _wallets, aztecNode, deployL1ContractsValues, logger, pxe } = await setup(3, {}, {}, true); - wallets = _wallets; + const ctx = await setup(3, {}, {}, true); + const { aztecNode, deployL1ContractsValues, pxe } = ctx; + ({ wallets, logger } = ctx); logFunctionSignatures(BananaCoin.artifact, logger); logFunctionSignatures(FPCContract.artifact, logger); @@ -193,12 +195,14 @@ describe('e2e_fees', () => { // Can't do presently because all logs are "revertible" so we lose notes that get broadcasted during unshielding. }); - describe.skip('private fees payments', () => { + describe('private fees payments', () => { let InitialAlicePrivateBananas: bigint; let InitialAlicePublicBananas: bigint; let InitialAliceGas: bigint; let InitialBobPrivateBananas: bigint; + // eslint-disable-next-line @typescript-eslint/no-unused-vars + let InitialBobPublicBananas: bigint; let InitialFPCPrivateBananas: bigint; let InitialFPCPublicBananas: bigint; @@ -212,8 +216,9 @@ describe('e2e_fees', () => { let RefundSecret: Fr; beforeAll(async () => { - // fund Alice - await mintPrivate(100n, aliceAddress); + // Fund Alice private and publicly + await mintPrivate(1000n, aliceAddress); + await bananaCoin.methods.mint_public(aliceAddress, 1000n).send().wait(); }); beforeEach(async () => { @@ -226,11 +231,11 @@ describe('e2e_fees', () => { [ [InitialAlicePrivateBananas, InitialBobPrivateBananas, InitialFPCPrivateBananas], - [InitialAlicePublicBananas, InitialFPCPublicBananas], + [InitialAlicePublicBananas, InitialBobPublicBananas, InitialFPCPublicBananas], [InitialAliceGas, InitialFPCGas, InitialSequencerGas], ] = await Promise.all([ bananaPrivateBalances(aliceAddress, bobAddress, bananaFPC.address), - bananaPublicBalances(aliceAddress, bananaFPC.address), + bananaPublicBalances(aliceAddress, bobAddress, bananaFPC.address), gasBalances(aliceAddress, bananaFPC.address, sequencerAddress), ]); }); From 152fb900ae5e9a918de19d1635e31e95a12b3f37 Mon Sep 17 00:00:00 2001 From: Aztec Bot <49558828+AztecBot@users.noreply.github.com> Date: Tue, 16 Apr 2024 12:30:32 -0400 Subject: [PATCH 32/56] chore(master): Release 0.35.0 (#5650) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit :robot: I have created a release *beep* *boop* ---
aztec-package: 0.35.0 ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.34.0...aztec-package-v0.35.0) (2024-04-16) ### ⚠ BREAKING CHANGES * pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ### Features * Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151))
barretenberg.js: 0.35.0 ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.34.0...barretenberg.js-v0.35.0) (2024-04-16) ### Features * Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) ### Miscellaneous * Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) * TS hash wrappers cleanup ([#5691](https://github.com/AztecProtocol/aztec-packages/issues/5691)) ([7f8b09f](https://github.com/AztecProtocol/aztec-packages/commit/7f8b09fca6370b140870041a49692383a4db6551))
aztec-cli: 0.35.0 ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.34.0...aztec-cli-v0.35.0) (2024-04-16) ### ⚠ BREAKING CHANGES * pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ### Features * Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151))
aztec-packages: 0.35.0 ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.34.0...aztec-packages-v0.35.0) (2024-04-16) ### ⚠ BREAKING CHANGES * Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) * trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) * **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) * rename request_max_block_number ([#5675](https://github.com/AztecProtocol/aztec-packages/issues/5675)) * pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ### Features * **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) ([f06f64c](https://github.com/AztecProtocol/aztec-packages/commit/f06f64c451333d36eb05951202d69ee85cca8851)) * Add serialisation methods ([#5749](https://github.com/AztecProtocol/aztec-packages/issues/5749)) ([20d290c](https://github.com/AztecProtocol/aztec-packages/commit/20d290c38fe4589b4bdafc6c529d6fd903d596e4)) * App siloing in new key store ([#5721](https://github.com/AztecProtocol/aztec-packages/issues/5721)) ([ae37d32](https://github.com/AztecProtocol/aztec-packages/commit/ae37d32ce58417eaa5345f2b77f92f1dfe6709d1)), closes [#5635](https://github.com/AztecProtocol/aztec-packages/issues/5635) * **avm-simulator:** Plumb noir assertion messages ([#5774](https://github.com/AztecProtocol/aztec-packages/issues/5774)) ([2cf11ac](https://github.com/AztecProtocol/aztec-packages/commit/2cf11ac76805b8d648a4b32d7cd6446eb31b9a35)) * **avm:** CMOV opcode ([#5575](https://github.com/AztecProtocol/aztec-packages/issues/5575)) ([19dbe46](https://github.com/AztecProtocol/aztec-packages/commit/19dbe46bce95221bf2e68c9361618998a6bdc64f)), closes [#5557](https://github.com/AztecProtocol/aztec-packages/issues/5557) * **avm:** Enable contract testing with bb binary ([#5584](https://github.com/AztecProtocol/aztec-packages/issues/5584)) ([d007d79](https://github.com/AztecProtocol/aztec-packages/commit/d007d79c7014261d9c663e28c948600d92e85759)) * **avm:** Enable range check on the ALU registers ([#5696](https://github.com/AztecProtocol/aztec-packages/issues/5696)) ([202fc1b](https://github.com/AztecProtocol/aztec-packages/commit/202fc1b750e83f91c32b128b981db1c5c92ef3f2)) * **avm:** Keccak as blackbox function ([#5722](https://github.com/AztecProtocol/aztec-packages/issues/5722)) ([6ea677a](https://github.com/AztecProtocol/aztec-packages/commit/6ea677aa97e6a597f5c6b580e655143ffeddbccf)) * **avm:** Poseidon2_permutation as black box ([#5707](https://github.com/AztecProtocol/aztec-packages/issues/5707)) ([5526b36](https://github.com/AztecProtocol/aztec-packages/commit/5526b36721a57b143ff8d0f381f94be275ccf59c)) * **avm:** Sha256 as blackbox function ([#5727](https://github.com/AztecProtocol/aztec-packages/issues/5727)) ([cac9cba](https://github.com/AztecProtocol/aztec-packages/commit/cac9cba8974a4923bce9e8f4627e2654bfab4f81)) * **avm:** Take sizeOffset in CALL ([#5763](https://github.com/AztecProtocol/aztec-packages/issues/5763)) ([95eadd6](https://github.com/AztecProtocol/aztec-packages/commit/95eadd67a72a286f07876f80586e6d57605d0af5)) * Brillig heterogeneous memory cells ([#5608](https://github.com/AztecProtocol/aztec-packages/issues/5608)) ([3287aa2](https://github.com/AztecProtocol/aztec-packages/commit/3287aa29c1e85dd89d5ae9f73bffa9406cc47d08)) * Change public nullifiers api ([#5660](https://github.com/AztecProtocol/aztec-packages/issues/5660)) ([986e7f9](https://github.com/AztecProtocol/aztec-packages/commit/986e7f924e9af6461e3e88de29f22cf2a8f45c4e)) * Changing finite field arithmetic in wasm to 29 bits for multiplications ([#5435](https://github.com/AztecProtocol/aztec-packages/issues/5435)) ([b2d9b9d](https://github.com/AztecProtocol/aztec-packages/commit/b2d9b9d5f1764b159e081b3cc9806ee83fdf341f)) * **ci:** Turn on new CI as mandatory ([#5761](https://github.com/AztecProtocol/aztec-packages/issues/5761)) ([bebed32](https://github.com/AztecProtocol/aztec-packages/commit/bebed32272e0974de21b5c7d21344d3cf1597a24)) * **docs:** Merge yellow paper into docs protocol specs section ([#5668](https://github.com/AztecProtocol/aztec-packages/issues/5668)) ([66dc509](https://github.com/AztecProtocol/aztec-packages/commit/66dc5091b2aff53580e1a313e1001369ffc87e6b)) * E2e token contract can run in 2m with snapshots and test separation. ([#5526](https://github.com/AztecProtocol/aztec-packages/issues/5526)) ([b0037dd](https://github.com/AztecProtocol/aztec-packages/commit/b0037dd051bd0312abe79d686cd93231cfe63d56)) * Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) * Get last mock oracles params (https://github.com/noir-lang/noir/pull/4789) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) * Impl of missing functionality in new key store ([#5750](https://github.com/AztecProtocol/aztec-packages/issues/5750)) ([af49a29](https://github.com/AztecProtocol/aztec-packages/commit/af49a290722c3430ad26a458cfb489b8b4ea7604)) * LT/LTE for AVM ([#5559](https://github.com/AztecProtocol/aztec-packages/issues/5559)) ([350abeb](https://github.com/AztecProtocol/aztec-packages/commit/350abeb4c88d7e7878abc32e9263c558633f0df9)) * New key store ([#5653](https://github.com/AztecProtocol/aztec-packages/issues/5653)) ([3e44a58](https://github.com/AztecProtocol/aztec-packages/commit/3e44a580a3769d7e65124294500ccedab9cdfce4)), closes [#5607](https://github.com/AztecProtocol/aztec-packages/issues/5607) * Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151)) * Poseidon separator ([#5717](https://github.com/AztecProtocol/aztec-packages/issues/5717)) ([d5256d2](https://github.com/AztecProtocol/aztec-packages/commit/d5256d29f3bc7d2094ba760c5a528dd61475bb40)) * Proving the rollup circuits ([#5599](https://github.com/AztecProtocol/aztec-packages/issues/5599)) ([145cbcd](https://github.com/AztecProtocol/aztec-packages/commit/145cbcda61fd73f4e135348b31c59c774cfae965)) * Public Kernel proving orchestration ([#5748](https://github.com/AztecProtocol/aztec-packages/issues/5748)) ([2ae0ee5](https://github.com/AztecProtocol/aztec-packages/commit/2ae0ee537b37c444f59b8255bd856f4da2ef818f)) * Rename request_max_block_number ([#5675](https://github.com/AztecProtocol/aztec-packages/issues/5675)) ([c695fcd](https://github.com/AztecProtocol/aztec-packages/commit/c695fcd91041a4ba9fd1d38b170993612c5e2ad1)) * Separate nullfier_inclusion checks for private/public/avm ([#5657](https://github.com/AztecProtocol/aztec-packages/issues/5657)) ([e4d2df6](https://github.com/AztecProtocol/aztec-packages/commit/e4d2df6b0b5592fe847e3c47020455ac8003d84d)) * Sequencer validates setup/teardown function selectors ([#5649](https://github.com/AztecProtocol/aztec-packages/issues/5649)) ([8f8ad56](https://github.com/AztecProtocol/aztec-packages/commit/8f8ad56471617d611317b96f04cf13f2edc2b493)), closes [#5401](https://github.com/AztecProtocol/aztec-packages/issues/5401) * Shared mutable storage ([#5490](https://github.com/AztecProtocol/aztec-packages/issues/5490)) ([c4e41a9](https://github.com/AztecProtocol/aztec-packages/commit/c4e41a9809e0a6de87a95c78ba3b71aff81da64a)) * **simulator:** Fetch return values at circuit execution ([#5642](https://github.com/AztecProtocol/aztec-packages/issues/5642)) ([413a4e0](https://github.com/AztecProtocol/aztec-packages/commit/413a4e0e4e22c0dcf86a2d3de6b75c98ae1d67d4)) * Split `backend_barretenburg` into prover and verifier classes (https://github.com/noir-lang/noir/pull/4769) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) * Sync from aztec-packages (https://github.com/noir-lang/noir/pull/4764) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Sync from aztec-packages (https://github.com/noir-lang/noir/pull/4787) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) * Trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) ([f849575](https://github.com/AztecProtocol/aztec-packages/commit/f84957584ff76c22c069903f7648735a0be91d7f)) * Unroll loops iteratively (https://github.com/noir-lang/noir/pull/4779) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Update circuits structs with gas info ([#5677](https://github.com/AztecProtocol/aztec-packages/issues/5677)) ([3db6dd1](https://github.com/AztecProtocol/aztec-packages/commit/3db6dd1a213d5f6de8a5e79511ecce9f072b3d41)) * Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) ([f50b180](https://github.com/AztecProtocol/aztec-packages/commit/f50b180379ac90d782aba3472708f8cef122c25b)) * Variable length returns ([#5633](https://github.com/AztecProtocol/aztec-packages/issues/5633)) ([b4a6f17](https://github.com/AztecProtocol/aztec-packages/commit/b4a6f174e2b88f5e4fed128752fc0c30d919084d)) * Wire AVM gas used to public kernel ([#5740](https://github.com/AztecProtocol/aztec-packages/issues/5740)) ([4f55d10](https://github.com/AztecProtocol/aztec-packages/commit/4f55d1023b07df6bf4fc83b6ecb0024426585d0a)) ### Bug Fixes * "feat: Changing finite field arithmetic in wasm to 29 bits for multiplications" ([#5779](https://github.com/AztecProtocol/aztec-packages/issues/5779)) ([bcfee97](https://github.com/AztecProtocol/aztec-packages/commit/bcfee97da99c654f8641ab8099bbbe5d58e2a5c7)) * Anvil start retry in case something bad. Fix colors. ([#5673](https://github.com/AztecProtocol/aztec-packages/issues/5673)) ([0b6b6f6](https://github.com/AztecProtocol/aztec-packages/commit/0b6b6f64ab5984cc8dbaeb1b80136ce1c8a1e3b7)) * ArrayGet and Set are not pure (https://github.com/noir-lang/noir/pull/4783) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) * Avoid get row in databus ([#5742](https://github.com/AztecProtocol/aztec-packages/issues/5742)) ([d67b6c8](https://github.com/AztecProtocol/aztec-packages/commit/d67b6c8bb703d856c0d95d4d47cc6de93467e9ab)) * Avoid huge unrolling in hash_args ([#5703](https://github.com/AztecProtocol/aztec-packages/issues/5703)) ([10d9ad9](https://github.com/AztecProtocol/aztec-packages/commit/10d9ad99200a5897417ff5669763ead4e38d87fa)) * **ci,noir-projects:** Bring apt-get higher in cache ([#5775](https://github.com/AztecProtocol/aztec-packages/issues/5775)) ([d37cbb9](https://github.com/AztecProtocol/aztec-packages/commit/d37cbb95cfbb773242bda568f8a7a0b066edc437)) * **ci:** 192 core spot runner ([#5767](https://github.com/AztecProtocol/aztec-packages/issues/5767)) ([37daac6](https://github.com/AztecProtocol/aztec-packages/commit/37daac6a4547d70d06714e1cd727eddbe297cf64)) * **ci:** Bigger cache disk, cache+prune docker images, disable ClientIvcTests.Full ([#5729](https://github.com/AztecProtocol/aztec-packages/issues/5729)) ([5dcbd75](https://github.com/AztecProtocol/aztec-packages/commit/5dcbd75c0795640d48592efbd750cd22b5e5ddd5)) * **ci:** Builder types ([#5711](https://github.com/AztecProtocol/aztec-packages/issues/5711)) ([b16f169](https://github.com/AztecProtocol/aztec-packages/commit/b16f16967ac3d99fc6a23c92dec7e7dd8535adf7)) * **ci:** Cache size not honoured ([#5738](https://github.com/AztecProtocol/aztec-packages/issues/5738)) ([d4ff340](https://github.com/AztecProtocol/aztec-packages/commit/d4ff340745456df31f1554588c3c41d9fa2f1fa6)) * **ci:** Don't fail if can't prune ([d9bb2c7](https://github.com/AztecProtocol/aztec-packages/commit/d9bb2c7fc561a7b1c7dfb516a5afc107cc8bdbbd)) * **ci:** Error in spot ([#5745](https://github.com/AztecProtocol/aztec-packages/issues/5745)) ([4d754aa](https://github.com/AztecProtocol/aztec-packages/commit/4d754aa9a76a9673ea50819e4d9a7e2e04944829)) * **ci:** Fix arm e2e references, spot shutdown ([#5741](https://github.com/AztecProtocol/aztec-packages/issues/5741)) ([1c4667c](https://github.com/AztecProtocol/aztec-packages/commit/1c4667cc58a2eda323ae51f85cfc4223d3eb143d)) * **ci:** Hotfix arm ([1ddb1c7](https://github.com/AztecProtocol/aztec-packages/commit/1ddb1c7136225d874d9d135d354ff601695cc590)) * **ci:** Hotfix just one ARM task ([10f27ae](https://github.com/AztecProtocol/aztec-packages/commit/10f27ae0aa856d1eebede71169a93a23313fe617)) * **ci:** Speculative deploy fix ([9a9eab6](https://github.com/AztecProtocol/aztec-packages/commit/9a9eab6b6b4e087ef1c15172c974353f90815b8b)) * **ci:** Wait for mainnet fork deployment ([#5735](https://github.com/AztecProtocol/aztec-packages/issues/5735)) ([8f3794d](https://github.com/AztecProtocol/aztec-packages/commit/8f3794dad170dba616c505d85bc1731fb6177ce0)) * **ci:** Wait_for_fork env var ([#5780](https://github.com/AztecProtocol/aztec-packages/issues/5780)) ([d85267b](https://github.com/AztecProtocol/aztec-packages/commit/d85267b7f1c34bf93087f3a48690ddfd8a9cf05d)) * Correct ICE panic messages in brillig `convert_black_box_call` (https://github.com/noir-lang/noir/pull/4761) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Disable flakey vanilla recursion test ([#5672](https://github.com/AztecProtocol/aztec-packages/issues/5672)) ([f84f7b6](https://github.com/AztecProtocol/aztec-packages/commit/f84f7b68f6c8072480127a065def1c4453e55877)) * Don't run e2e tests against wrong anvil ([#5686](https://github.com/AztecProtocol/aztec-packages/issues/5686)) ([9ff45f6](https://github.com/AztecProtocol/aztec-packages/commit/9ff45f69af562db4cec69c6231659476667f1cf9)) * Dont error in bench summary ([#5693](https://github.com/AztecProtocol/aztec-packages/issues/5693)) ([470b0f3](https://github.com/AztecProtocol/aztec-packages/commit/470b0f36138f34fcff1da869f7fd54f2d50c1480)) * E2e getStack, disable failing e2e ([#5768](https://github.com/AztecProtocol/aztec-packages/issues/5768)) ([e5f3ece](https://github.com/AztecProtocol/aztec-packages/commit/e5f3ece131b16aeede897f0a9bb3ecc23cb4d9dc)) * GA concurrency ([#5713](https://github.com/AztecProtocol/aztec-packages/issues/5713)) ([eac2585](https://github.com/AztecProtocol/aztec-packages/commit/eac25853cc8ca14254010076106b6a9555ef5d17)) * Generate_aztecnr_reference.js not getting generics or multi-line params ([#5679](https://github.com/AztecProtocol/aztec-packages/issues/5679)) ([a22bc3d](https://github.com/AztecProtocol/aztec-packages/commit/a22bc3d4004b050449569bf66fe7431ccd04a16c)) * Hotfix submodule cache ([92b92b3](https://github.com/AztecProtocol/aztec-packages/commit/92b92b32c46f7c4d332a372c0e1039040c762eff)) * Hotfix underspec'd machine ([#5710](https://github.com/AztecProtocol/aztec-packages/issues/5710)) ([059e38e](https://github.com/AztecProtocol/aztec-packages/commit/059e38e3d319b84259bb1bf36fca6ed71425eb98)) * **hotfix:** CI ignore git safe.directory checks ([#5659](https://github.com/AztecProtocol/aztec-packages/issues/5659)) ([9fc3fe3](https://github.com/AztecProtocol/aztec-packages/commit/9fc3fe3e5aa74e593eabb2fd1f358476f039e595)) * Less earthly cache ([#5690](https://github.com/AztecProtocol/aztec-packages/issues/5690)) ([8190dc7](https://github.com/AztecProtocol/aztec-packages/commit/8190dc7826d480f44107456984f7f192358ba8da)) * Make earthly more parallel ([#5747](https://github.com/AztecProtocol/aztec-packages/issues/5747)) ([9734455](https://github.com/AztecProtocol/aztec-packages/commit/9734455acd0d6e0cba44477f889ec8165e7f3003)) * Primary_message typo in errors.rs ([#5646](https://github.com/AztecProtocol/aztec-packages/issues/5646)) ([1dfbe7b](https://github.com/AztecProtocol/aztec-packages/commit/1dfbe7bc3bf3c455d8fb6c8b5fe6a96c1edf7af9)) * Pull noir ([#5699](https://github.com/AztecProtocol/aztec-packages/issues/5699)) ([bf35464](https://github.com/AztecProtocol/aztec-packages/commit/bf3546444272f36a3e3905246c49f2e5f65cff6e)) * REDO dont error in bench summary ([#5695](https://github.com/AztecProtocol/aztec-packages/issues/5695)) ([8c1a7b9](https://github.com/AztecProtocol/aztec-packages/commit/8c1a7b976bcc63af63ddcc8cf4f89b338f17bdf8)) * Running e2e tests as part of build, requires forcing ip4 (not ip6) when connecting to anvil ([#5744](https://github.com/AztecProtocol/aztec-packages/issues/5744)) ([66fc89f](https://github.com/AztecProtocol/aztec-packages/commit/66fc89f417d0582865acdb04a75258a4a449c8b6)) * Simplify ECCVM prover constructor and add a TODO ([#5681](https://github.com/AztecProtocol/aztec-packages/issues/5681)) ([8c151ea](https://github.com/AztecProtocol/aztec-packages/commit/8c151eab1492dda901a1d6b691c9ca68960fd9e6)) * Spot refcount ([#5746](https://github.com/AztecProtocol/aztec-packages/issues/5746)) ([9e18444](https://github.com/AztecProtocol/aztec-packages/commit/9e184448f218ab06247d8cbbadf755ad384bd40a)) * Take a deep copy of circuit inputs for proving ([#5777](https://github.com/AztecProtocol/aztec-packages/issues/5777)) ([785591e](https://github.com/AztecProtocol/aztec-packages/commit/785591e0527beef7adf0f7a791618afff9df3705)) * Temporarily disable the bench tests ([#5755](https://github.com/AztecProtocol/aztec-packages/issues/5755)) ([1d52ac5](https://github.com/AztecProtocol/aztec-packages/commit/1d52ac5c15524648094c23cf67ea0cfb921fe186)) * Update commit for noir-gates-diff (https://github.com/noir-lang/noir/pull/4773) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Use entrypoint instead of pay_init_fee ([#5623](https://github.com/AztecProtocol/aztec-packages/issues/5623)) ([62ac765](https://github.com/AztecProtocol/aztec-packages/commit/62ac765d192d499b7c8a8b1b4583c17fb95d00ac)) * Watch less files. ([#5651](https://github.com/AztecProtocol/aztec-packages/issues/5651)) ([57a1d69](https://github.com/AztecProtocol/aztec-packages/commit/57a1d69f3fcade6f4536d007baad28e878242d59)) ### Miscellaneous * Add missing aztec-address tests ([#5674](https://github.com/AztecProtocol/aztec-packages/issues/5674)) ([58aefba](https://github.com/AztecProtocol/aztec-packages/commit/58aefbad0144b41619fa36a3714fa2a440945c74)) * **avm:** Add a boolean to toggle proving in AVM unit tests ([#5667](https://github.com/AztecProtocol/aztec-packages/issues/5667)) ([ec122c9](https://github.com/AztecProtocol/aztec-packages/commit/ec122c9b9c1c63c72158c6956d8fdb2398faf96b)), closes [#5663](https://github.com/AztecProtocol/aztec-packages/issues/5663) * **avm:** Hashing tests cleanup ([#5733](https://github.com/AztecProtocol/aztec-packages/issues/5733)) ([53d0102](https://github.com/AztecProtocol/aztec-packages/commit/53d010232600b736ac0f5116a3b7804f2d412dd0)) * **avm:** Range checks negative tests ([#5770](https://github.com/AztecProtocol/aztec-packages/issues/5770)) ([2907142](https://github.com/AztecProtocol/aztec-packages/commit/29071423ba65774039e4e5c1f7ca67123a18f738)) * **avm:** Split the negative test on range check for high 16-bit registers ([#5785](https://github.com/AztecProtocol/aztec-packages/issues/5785)) ([8ebbe57](https://github.com/AztecProtocol/aztec-packages/commit/8ebbe57953e35f81ca010cdd686fb43ddf0f20b2)) * **avm:** Split up AVM test contract as it was growing too large ([#5702](https://github.com/AztecProtocol/aztec-packages/issues/5702)) ([5b8e812](https://github.com/AztecProtocol/aztec-packages/commit/5b8e812802457b429d173a5c4793ffa04faec1fa)) * **aztec-nr:** Minor public interface changes ([#5776](https://github.com/AztecProtocol/aztec-packages/issues/5776)) ([91b8110](https://github.com/AztecProtocol/aztec-packages/commit/91b8110ab44979fe37fcc57824bdee845295ccb7)) * **ci:** Break e2e-deploy into multiple test suites ([#5704](https://github.com/AztecProtocol/aztec-packages/issues/5704)) ([2522294](https://github.com/AztecProtocol/aztec-packages/commit/2522294d96e064b4531e05ae1b21eb4fa8f90125)) * **ci:** Earthly in spot with persistent cache ([#5644](https://github.com/AztecProtocol/aztec-packages/issues/5644)) ([a39c2f6](https://github.com/AztecProtocol/aztec-packages/commit/a39c2f64565665260dbf8640478691dd5d47cee5)) * **ci:** Hotfix AMI's, workflow to stop personal spot runners ([#5712](https://github.com/AztecProtocol/aztec-packages/issues/5712)) ([5f18139](https://github.com/AztecProtocol/aztec-packages/commit/5f1813947e05cc56553c8606a254f26d39ca6093)) * **ci:** Only run ARM on master ([#5705](https://github.com/AztecProtocol/aztec-packages/issues/5705)) ([f77c142](https://github.com/AztecProtocol/aztec-packages/commit/f77c142b1634442434aa4631317186523d456a69)) * **ci:** Use 128 cores for x86 and add timeouts ([#5665](https://github.com/AztecProtocol/aztec-packages/issues/5665)) ([0c5dc0a](https://github.com/AztecProtocol/aztec-packages/commit/0c5dc0a8d90c52c46f9802ec5fb93561d0551b6a)) * Compute_note_hash_and_nullifier - improve error message ([#5671](https://github.com/AztecProtocol/aztec-packages/issues/5671)) ([8942d69](https://github.com/AztecProtocol/aztec-packages/commit/8942d69ab59f9ca7b33b72c91fb960c02afd66b0)) * Create placeholder version of 0.26.0 docs (https://github.com/noir-lang/noir/pull/4782) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * **doc:** Fix broken docs links (https://github.com/noir-lang/noir/pull/4606) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * **docs:** Fix link in the Data Types page (https://github.com/noir-lang/noir/pull/4527) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) * Fix master after merge issue related to validate_trace renaming ([#5676](https://github.com/AztecProtocol/aztec-packages/issues/5676)) ([44e0d8a](https://github.com/AztecProtocol/aztec-packages/commit/44e0d8abd2104a9969d5750736e77fe9a8d4d621)) * Fix max-block-number and auth e2e tests ([#5694](https://github.com/AztecProtocol/aztec-packages/issues/5694)) ([f1bf314](https://github.com/AztecProtocol/aztec-packages/commit/f1bf31431df68655fa5364c0504c2323ad660c22)) * Op queue ([#5648](https://github.com/AztecProtocol/aztec-packages/issues/5648)) ([822c7e6](https://github.com/AztecProtocol/aztec-packages/commit/822c7e63e91cb30219a79513c05d84ee4f03d8fe)) * **public:** Remove getNullifierMembershipWitness ([#5715](https://github.com/AztecProtocol/aztec-packages/issues/5715)) ([3be402c](https://github.com/AztecProtocol/aztec-packages/commit/3be402cca4fc1451a2b4c7560c346843eb8439cd)) * Re-enable e2e fees tests ([#5784](https://github.com/AztecProtocol/aztec-packages/issues/5784)) ([102e8b8](https://github.com/AztecProtocol/aztec-packages/commit/102e8b89e91c324f945ab94357508c25eba4fa92)) * Release Noir(0.27.0) (https://github.com/noir-lang/noir/pull/4632) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Remove the old Value struct from the oracle docs (https://github.com/noir-lang/noir/pull/4738) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) * Replace relative paths to noir-protocol-circuits ([fb2b298](https://github.com/AztecProtocol/aztec-packages/commit/fb2b298066bbf0fa15e5a39fa7e48cb288e50182)) * Replace relative paths to noir-protocol-circuits ([e20920d](https://github.com/AztecProtocol/aztec-packages/commit/e20920d3b2f2acf4682eecc94a04e46fc50a8767)) * Replace relative paths to noir-protocol-circuits ([6351dc5](https://github.com/AztecProtocol/aztec-packages/commit/6351dc52fe63200293aaf1749330a8f572356163)) * Replace relative paths to noir-protocol-circuits ([fee13bf](https://github.com/AztecProtocol/aztec-packages/commit/fee13bf5869a03a84a05bb3166d0f5493c7056fd)) * Replacing unsafe::zeroed() ([#5685](https://github.com/AztecProtocol/aztec-packages/issues/5685)) ([ea3884e](https://github.com/AztecProtocol/aztec-packages/commit/ea3884ec49e8a37d66b212551e1b78ab47a93e37)) * Small logging changes ([#5654](https://github.com/AztecProtocol/aztec-packages/issues/5654)) ([25cc70d](https://github.com/AztecProtocol/aztec-packages/commit/25cc70de04342f89665883012b86f1c54c916c44)) * Temporarily skip failing e2e fees test ([a3ac5ff](https://github.com/AztecProtocol/aztec-packages/commit/a3ac5ff251270f7a14d56e9b7846655dce716a44)) * Testing that nargo fmt is idempotent (https://github.com/noir-lang/noir/pull/4765) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) * TS hash wrappers cleanup ([#5691](https://github.com/AztecProtocol/aztec-packages/issues/5691)) ([7f8b09f](https://github.com/AztecProtocol/aztec-packages/commit/7f8b09fca6370b140870041a49692383a4db6551)) * Turn ENABLE_GAS where it is needed ([#5730](https://github.com/AztecProtocol/aztec-packages/issues/5730)) ([30a2edd](https://github.com/AztecProtocol/aztec-packages/commit/30a2edd91cc46196c13fe421cdea2e03f30052fc)) * Update noir gates diff ([#5658](https://github.com/AztecProtocol/aztec-packages/issues/5658)) ([9816c1a](https://github.com/AztecProtocol/aztec-packages/commit/9816c1adead8d3455c091664744f064bb0433ee7)) * We can run 35 of our e2e tests just using jest. ([#5643](https://github.com/AztecProtocol/aztec-packages/issues/5643)) ([4fcaeae](https://github.com/AztecProtocol/aztec-packages/commit/4fcaeaea01acc42f87e6c6a5b0d229deaee2a063)) ### Documentation * Fix yp typo control-flow.md ([#5638](https://github.com/AztecProtocol/aztec-packages/issues/5638)) ([363d227](https://github.com/AztecProtocol/aztec-packages/commit/363d2275592f190d57501a25014bfe37ccad5e30))
barretenberg: 0.35.0 ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.34.0...barretenberg-v0.35.0) (2024-04-16) ### ⚠ BREAKING CHANGES * Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) * trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) * **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) ### Features * **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) ([f06f64c](https://github.com/AztecProtocol/aztec-packages/commit/f06f64c451333d36eb05951202d69ee85cca8851)) * **avm:** CMOV opcode ([#5575](https://github.com/AztecProtocol/aztec-packages/issues/5575)) ([19dbe46](https://github.com/AztecProtocol/aztec-packages/commit/19dbe46bce95221bf2e68c9361618998a6bdc64f)), closes [#5557](https://github.com/AztecProtocol/aztec-packages/issues/5557) * **avm:** Enable contract testing with bb binary ([#5584](https://github.com/AztecProtocol/aztec-packages/issues/5584)) ([d007d79](https://github.com/AztecProtocol/aztec-packages/commit/d007d79c7014261d9c663e28c948600d92e85759)) * **avm:** Enable range check on the ALU registers ([#5696](https://github.com/AztecProtocol/aztec-packages/issues/5696)) ([202fc1b](https://github.com/AztecProtocol/aztec-packages/commit/202fc1b750e83f91c32b128b981db1c5c92ef3f2)) * Changing finite field arithmetic in wasm to 29 bits for multiplications ([#5435](https://github.com/AztecProtocol/aztec-packages/issues/5435)) ([b2d9b9d](https://github.com/AztecProtocol/aztec-packages/commit/b2d9b9d5f1764b159e081b3cc9806ee83fdf341f)) * **ci:** Turn on new CI as mandatory ([#5761](https://github.com/AztecProtocol/aztec-packages/issues/5761)) ([bebed32](https://github.com/AztecProtocol/aztec-packages/commit/bebed32272e0974de21b5c7d21344d3cf1597a24)) * Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) * LT/LTE for AVM ([#5559](https://github.com/AztecProtocol/aztec-packages/issues/5559)) ([350abeb](https://github.com/AztecProtocol/aztec-packages/commit/350abeb4c88d7e7878abc32e9263c558633f0df9)) * Trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) ([f849575](https://github.com/AztecProtocol/aztec-packages/commit/f84957584ff76c22c069903f7648735a0be91d7f)) * Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) ([f50b180](https://github.com/AztecProtocol/aztec-packages/commit/f50b180379ac90d782aba3472708f8cef122c25b)) ### Bug Fixes * "feat: Changing finite field arithmetic in wasm to 29 bits for multiplications" ([#5779](https://github.com/AztecProtocol/aztec-packages/issues/5779)) ([bcfee97](https://github.com/AztecProtocol/aztec-packages/commit/bcfee97da99c654f8641ab8099bbbe5d58e2a5c7)) * Avoid get row in databus ([#5742](https://github.com/AztecProtocol/aztec-packages/issues/5742)) ([d67b6c8](https://github.com/AztecProtocol/aztec-packages/commit/d67b6c8bb703d856c0d95d4d47cc6de93467e9ab)) * **ci:** Bigger cache disk, cache+prune docker images, disable ClientIvcTests.Full ([#5729](https://github.com/AztecProtocol/aztec-packages/issues/5729)) ([5dcbd75](https://github.com/AztecProtocol/aztec-packages/commit/5dcbd75c0795640d48592efbd750cd22b5e5ddd5)) * Disable flakey vanilla recursion test ([#5672](https://github.com/AztecProtocol/aztec-packages/issues/5672)) ([f84f7b6](https://github.com/AztecProtocol/aztec-packages/commit/f84f7b68f6c8072480127a065def1c4453e55877)) * Less earthly cache ([#5690](https://github.com/AztecProtocol/aztec-packages/issues/5690)) ([8190dc7](https://github.com/AztecProtocol/aztec-packages/commit/8190dc7826d480f44107456984f7f192358ba8da)) * Make earthly more parallel ([#5747](https://github.com/AztecProtocol/aztec-packages/issues/5747)) ([9734455](https://github.com/AztecProtocol/aztec-packages/commit/9734455acd0d6e0cba44477f889ec8165e7f3003)) * Simplify ECCVM prover constructor and add a TODO ([#5681](https://github.com/AztecProtocol/aztec-packages/issues/5681)) ([8c151ea](https://github.com/AztecProtocol/aztec-packages/commit/8c151eab1492dda901a1d6b691c9ca68960fd9e6)) ### Miscellaneous * **avm:** Add a boolean to toggle proving in AVM unit tests ([#5667](https://github.com/AztecProtocol/aztec-packages/issues/5667)) ([ec122c9](https://github.com/AztecProtocol/aztec-packages/commit/ec122c9b9c1c63c72158c6956d8fdb2398faf96b)), closes [#5663](https://github.com/AztecProtocol/aztec-packages/issues/5663) * **avm:** Range checks negative tests ([#5770](https://github.com/AztecProtocol/aztec-packages/issues/5770)) ([2907142](https://github.com/AztecProtocol/aztec-packages/commit/29071423ba65774039e4e5c1f7ca67123a18f738)) * **avm:** Split the negative test on range check for high 16-bit registers ([#5785](https://github.com/AztecProtocol/aztec-packages/issues/5785)) ([8ebbe57](https://github.com/AztecProtocol/aztec-packages/commit/8ebbe57953e35f81ca010cdd686fb43ddf0f20b2)) * **ci:** Use 128 cores for x86 and add timeouts ([#5665](https://github.com/AztecProtocol/aztec-packages/issues/5665)) ([0c5dc0a](https://github.com/AztecProtocol/aztec-packages/commit/0c5dc0a8d90c52c46f9802ec5fb93561d0551b6a)) * Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) * Fix master after merge issue related to validate_trace renaming ([#5676](https://github.com/AztecProtocol/aztec-packages/issues/5676)) ([44e0d8a](https://github.com/AztecProtocol/aztec-packages/commit/44e0d8abd2104a9969d5750736e77fe9a8d4d621)) * Op queue ([#5648](https://github.com/AztecProtocol/aztec-packages/issues/5648)) ([822c7e6](https://github.com/AztecProtocol/aztec-packages/commit/822c7e63e91cb30219a79513c05d84ee4f03d8fe))
--- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --- .release-please-manifest.json | 10 +-- CHANGELOG.md | 144 ++++++++++++++++++++++++++++++++ barretenberg/CHANGELOG.md | 44 ++++++++++ barretenberg/cpp/CMakeLists.txt | 2 +- barretenberg/ts/CHANGELOG.md | 13 +++ barretenberg/ts/package.json | 2 +- yarn-project/aztec/CHANGELOG.md | 11 +++ yarn-project/aztec/package.json | 2 +- yarn-project/cli/CHANGELOG.md | 11 +++ yarn-project/cli/package.json | 2 +- 10 files changed, 232 insertions(+), 9 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index b1b5f363765..bb7ec3a2576 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,7 +1,7 @@ { - ".": "0.34.0", - "yarn-project/cli": "0.34.0", - "yarn-project/aztec": "0.34.0", - "barretenberg": "0.34.0", - "barretenberg/ts": "0.34.0" + ".": "0.35.0", + "yarn-project/cli": "0.35.0", + "yarn-project/aztec": "0.35.0", + "barretenberg": "0.35.0", + "barretenberg/ts": "0.35.0" } diff --git a/CHANGELOG.md b/CHANGELOG.md index 1932869d808..3783175fb53 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,149 @@ # Changelog +## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.34.0...aztec-packages-v0.35.0) (2024-04-16) + + +### ⚠ BREAKING CHANGES + +* Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) +* trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) +* **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) +* rename request_max_block_number ([#5675](https://github.com/AztecProtocol/aztec-packages/issues/5675)) +* pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) + +### Features + +* **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) ([f06f64c](https://github.com/AztecProtocol/aztec-packages/commit/f06f64c451333d36eb05951202d69ee85cca8851)) +* Add serialisation methods ([#5749](https://github.com/AztecProtocol/aztec-packages/issues/5749)) ([20d290c](https://github.com/AztecProtocol/aztec-packages/commit/20d290c38fe4589b4bdafc6c529d6fd903d596e4)) +* App siloing in new key store ([#5721](https://github.com/AztecProtocol/aztec-packages/issues/5721)) ([ae37d32](https://github.com/AztecProtocol/aztec-packages/commit/ae37d32ce58417eaa5345f2b77f92f1dfe6709d1)), closes [#5635](https://github.com/AztecProtocol/aztec-packages/issues/5635) +* **avm-simulator:** Plumb noir assertion messages ([#5774](https://github.com/AztecProtocol/aztec-packages/issues/5774)) ([2cf11ac](https://github.com/AztecProtocol/aztec-packages/commit/2cf11ac76805b8d648a4b32d7cd6446eb31b9a35)) +* **avm:** CMOV opcode ([#5575](https://github.com/AztecProtocol/aztec-packages/issues/5575)) ([19dbe46](https://github.com/AztecProtocol/aztec-packages/commit/19dbe46bce95221bf2e68c9361618998a6bdc64f)), closes [#5557](https://github.com/AztecProtocol/aztec-packages/issues/5557) +* **avm:** Enable contract testing with bb binary ([#5584](https://github.com/AztecProtocol/aztec-packages/issues/5584)) ([d007d79](https://github.com/AztecProtocol/aztec-packages/commit/d007d79c7014261d9c663e28c948600d92e85759)) +* **avm:** Enable range check on the ALU registers ([#5696](https://github.com/AztecProtocol/aztec-packages/issues/5696)) ([202fc1b](https://github.com/AztecProtocol/aztec-packages/commit/202fc1b750e83f91c32b128b981db1c5c92ef3f2)) +* **avm:** Keccak as blackbox function ([#5722](https://github.com/AztecProtocol/aztec-packages/issues/5722)) ([6ea677a](https://github.com/AztecProtocol/aztec-packages/commit/6ea677aa97e6a597f5c6b580e655143ffeddbccf)) +* **avm:** Poseidon2_permutation as black box ([#5707](https://github.com/AztecProtocol/aztec-packages/issues/5707)) ([5526b36](https://github.com/AztecProtocol/aztec-packages/commit/5526b36721a57b143ff8d0f381f94be275ccf59c)) +* **avm:** Sha256 as blackbox function ([#5727](https://github.com/AztecProtocol/aztec-packages/issues/5727)) ([cac9cba](https://github.com/AztecProtocol/aztec-packages/commit/cac9cba8974a4923bce9e8f4627e2654bfab4f81)) +* **avm:** Take sizeOffset in CALL ([#5763](https://github.com/AztecProtocol/aztec-packages/issues/5763)) ([95eadd6](https://github.com/AztecProtocol/aztec-packages/commit/95eadd67a72a286f07876f80586e6d57605d0af5)) +* Brillig heterogeneous memory cells ([#5608](https://github.com/AztecProtocol/aztec-packages/issues/5608)) ([3287aa2](https://github.com/AztecProtocol/aztec-packages/commit/3287aa29c1e85dd89d5ae9f73bffa9406cc47d08)) +* Change public nullifiers api ([#5660](https://github.com/AztecProtocol/aztec-packages/issues/5660)) ([986e7f9](https://github.com/AztecProtocol/aztec-packages/commit/986e7f924e9af6461e3e88de29f22cf2a8f45c4e)) +* Changing finite field arithmetic in wasm to 29 bits for multiplications ([#5435](https://github.com/AztecProtocol/aztec-packages/issues/5435)) ([b2d9b9d](https://github.com/AztecProtocol/aztec-packages/commit/b2d9b9d5f1764b159e081b3cc9806ee83fdf341f)) +* **ci:** Turn on new CI as mandatory ([#5761](https://github.com/AztecProtocol/aztec-packages/issues/5761)) ([bebed32](https://github.com/AztecProtocol/aztec-packages/commit/bebed32272e0974de21b5c7d21344d3cf1597a24)) +* **docs:** Merge yellow paper into docs protocol specs section ([#5668](https://github.com/AztecProtocol/aztec-packages/issues/5668)) ([66dc509](https://github.com/AztecProtocol/aztec-packages/commit/66dc5091b2aff53580e1a313e1001369ffc87e6b)) +* E2e token contract can run in 2m with snapshots and test separation. ([#5526](https://github.com/AztecProtocol/aztec-packages/issues/5526)) ([b0037dd](https://github.com/AztecProtocol/aztec-packages/commit/b0037dd051bd0312abe79d686cd93231cfe63d56)) +* Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) +* Get last mock oracles params (https://github.com/noir-lang/noir/pull/4789) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) +* Impl of missing functionality in new key store ([#5750](https://github.com/AztecProtocol/aztec-packages/issues/5750)) ([af49a29](https://github.com/AztecProtocol/aztec-packages/commit/af49a290722c3430ad26a458cfb489b8b4ea7604)) +* LT/LTE for AVM ([#5559](https://github.com/AztecProtocol/aztec-packages/issues/5559)) ([350abeb](https://github.com/AztecProtocol/aztec-packages/commit/350abeb4c88d7e7878abc32e9263c558633f0df9)) +* New key store ([#5653](https://github.com/AztecProtocol/aztec-packages/issues/5653)) ([3e44a58](https://github.com/AztecProtocol/aztec-packages/commit/3e44a580a3769d7e65124294500ccedab9cdfce4)), closes [#5607](https://github.com/AztecProtocol/aztec-packages/issues/5607) +* Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151)) +* Poseidon separator ([#5717](https://github.com/AztecProtocol/aztec-packages/issues/5717)) ([d5256d2](https://github.com/AztecProtocol/aztec-packages/commit/d5256d29f3bc7d2094ba760c5a528dd61475bb40)) +* Proving the rollup circuits ([#5599](https://github.com/AztecProtocol/aztec-packages/issues/5599)) ([145cbcd](https://github.com/AztecProtocol/aztec-packages/commit/145cbcda61fd73f4e135348b31c59c774cfae965)) +* Public Kernel proving orchestration ([#5748](https://github.com/AztecProtocol/aztec-packages/issues/5748)) ([2ae0ee5](https://github.com/AztecProtocol/aztec-packages/commit/2ae0ee537b37c444f59b8255bd856f4da2ef818f)) +* Rename request_max_block_number ([#5675](https://github.com/AztecProtocol/aztec-packages/issues/5675)) ([c695fcd](https://github.com/AztecProtocol/aztec-packages/commit/c695fcd91041a4ba9fd1d38b170993612c5e2ad1)) +* Separate nullfier_inclusion checks for private/public/avm ([#5657](https://github.com/AztecProtocol/aztec-packages/issues/5657)) ([e4d2df6](https://github.com/AztecProtocol/aztec-packages/commit/e4d2df6b0b5592fe847e3c47020455ac8003d84d)) +* Sequencer validates setup/teardown function selectors ([#5649](https://github.com/AztecProtocol/aztec-packages/issues/5649)) ([8f8ad56](https://github.com/AztecProtocol/aztec-packages/commit/8f8ad56471617d611317b96f04cf13f2edc2b493)), closes [#5401](https://github.com/AztecProtocol/aztec-packages/issues/5401) +* Shared mutable storage ([#5490](https://github.com/AztecProtocol/aztec-packages/issues/5490)) ([c4e41a9](https://github.com/AztecProtocol/aztec-packages/commit/c4e41a9809e0a6de87a95c78ba3b71aff81da64a)) +* **simulator:** Fetch return values at circuit execution ([#5642](https://github.com/AztecProtocol/aztec-packages/issues/5642)) ([413a4e0](https://github.com/AztecProtocol/aztec-packages/commit/413a4e0e4e22c0dcf86a2d3de6b75c98ae1d67d4)) +* Split `backend_barretenburg` into prover and verifier classes (https://github.com/noir-lang/noir/pull/4769) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) +* Sync from aztec-packages (https://github.com/noir-lang/noir/pull/4764) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Sync from aztec-packages (https://github.com/noir-lang/noir/pull/4787) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) +* Trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) ([f849575](https://github.com/AztecProtocol/aztec-packages/commit/f84957584ff76c22c069903f7648735a0be91d7f)) +* Unroll loops iteratively (https://github.com/noir-lang/noir/pull/4779) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Update circuits structs with gas info ([#5677](https://github.com/AztecProtocol/aztec-packages/issues/5677)) ([3db6dd1](https://github.com/AztecProtocol/aztec-packages/commit/3db6dd1a213d5f6de8a5e79511ecce9f072b3d41)) +* Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) ([f50b180](https://github.com/AztecProtocol/aztec-packages/commit/f50b180379ac90d782aba3472708f8cef122c25b)) +* Variable length returns ([#5633](https://github.com/AztecProtocol/aztec-packages/issues/5633)) ([b4a6f17](https://github.com/AztecProtocol/aztec-packages/commit/b4a6f174e2b88f5e4fed128752fc0c30d919084d)) +* Wire AVM gas used to public kernel ([#5740](https://github.com/AztecProtocol/aztec-packages/issues/5740)) ([4f55d10](https://github.com/AztecProtocol/aztec-packages/commit/4f55d1023b07df6bf4fc83b6ecb0024426585d0a)) + + +### Bug Fixes + +* "feat: Changing finite field arithmetic in wasm to 29 bits for multiplications" ([#5779](https://github.com/AztecProtocol/aztec-packages/issues/5779)) ([bcfee97](https://github.com/AztecProtocol/aztec-packages/commit/bcfee97da99c654f8641ab8099bbbe5d58e2a5c7)) +* Anvil start retry in case something bad. Fix colors. ([#5673](https://github.com/AztecProtocol/aztec-packages/issues/5673)) ([0b6b6f6](https://github.com/AztecProtocol/aztec-packages/commit/0b6b6f64ab5984cc8dbaeb1b80136ce1c8a1e3b7)) +* ArrayGet and Set are not pure (https://github.com/noir-lang/noir/pull/4783) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) +* Avoid get row in databus ([#5742](https://github.com/AztecProtocol/aztec-packages/issues/5742)) ([d67b6c8](https://github.com/AztecProtocol/aztec-packages/commit/d67b6c8bb703d856c0d95d4d47cc6de93467e9ab)) +* Avoid huge unrolling in hash_args ([#5703](https://github.com/AztecProtocol/aztec-packages/issues/5703)) ([10d9ad9](https://github.com/AztecProtocol/aztec-packages/commit/10d9ad99200a5897417ff5669763ead4e38d87fa)) +* **ci,noir-projects:** Bring apt-get higher in cache ([#5775](https://github.com/AztecProtocol/aztec-packages/issues/5775)) ([d37cbb9](https://github.com/AztecProtocol/aztec-packages/commit/d37cbb95cfbb773242bda568f8a7a0b066edc437)) +* **ci:** 192 core spot runner ([#5767](https://github.com/AztecProtocol/aztec-packages/issues/5767)) ([37daac6](https://github.com/AztecProtocol/aztec-packages/commit/37daac6a4547d70d06714e1cd727eddbe297cf64)) +* **ci:** Bigger cache disk, cache+prune docker images, disable ClientIvcTests.Full ([#5729](https://github.com/AztecProtocol/aztec-packages/issues/5729)) ([5dcbd75](https://github.com/AztecProtocol/aztec-packages/commit/5dcbd75c0795640d48592efbd750cd22b5e5ddd5)) +* **ci:** Builder types ([#5711](https://github.com/AztecProtocol/aztec-packages/issues/5711)) ([b16f169](https://github.com/AztecProtocol/aztec-packages/commit/b16f16967ac3d99fc6a23c92dec7e7dd8535adf7)) +* **ci:** Cache size not honoured ([#5738](https://github.com/AztecProtocol/aztec-packages/issues/5738)) ([d4ff340](https://github.com/AztecProtocol/aztec-packages/commit/d4ff340745456df31f1554588c3c41d9fa2f1fa6)) +* **ci:** Don't fail if can't prune ([d9bb2c7](https://github.com/AztecProtocol/aztec-packages/commit/d9bb2c7fc561a7b1c7dfb516a5afc107cc8bdbbd)) +* **ci:** Error in spot ([#5745](https://github.com/AztecProtocol/aztec-packages/issues/5745)) ([4d754aa](https://github.com/AztecProtocol/aztec-packages/commit/4d754aa9a76a9673ea50819e4d9a7e2e04944829)) +* **ci:** Fix arm e2e references, spot shutdown ([#5741](https://github.com/AztecProtocol/aztec-packages/issues/5741)) ([1c4667c](https://github.com/AztecProtocol/aztec-packages/commit/1c4667cc58a2eda323ae51f85cfc4223d3eb143d)) +* **ci:** Hotfix arm ([1ddb1c7](https://github.com/AztecProtocol/aztec-packages/commit/1ddb1c7136225d874d9d135d354ff601695cc590)) +* **ci:** Hotfix just one ARM task ([10f27ae](https://github.com/AztecProtocol/aztec-packages/commit/10f27ae0aa856d1eebede71169a93a23313fe617)) +* **ci:** Speculative deploy fix ([9a9eab6](https://github.com/AztecProtocol/aztec-packages/commit/9a9eab6b6b4e087ef1c15172c974353f90815b8b)) +* **ci:** Wait for mainnet fork deployment ([#5735](https://github.com/AztecProtocol/aztec-packages/issues/5735)) ([8f3794d](https://github.com/AztecProtocol/aztec-packages/commit/8f3794dad170dba616c505d85bc1731fb6177ce0)) +* **ci:** Wait_for_fork env var ([#5780](https://github.com/AztecProtocol/aztec-packages/issues/5780)) ([d85267b](https://github.com/AztecProtocol/aztec-packages/commit/d85267b7f1c34bf93087f3a48690ddfd8a9cf05d)) +* Correct ICE panic messages in brillig `convert_black_box_call` (https://github.com/noir-lang/noir/pull/4761) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Disable flakey vanilla recursion test ([#5672](https://github.com/AztecProtocol/aztec-packages/issues/5672)) ([f84f7b6](https://github.com/AztecProtocol/aztec-packages/commit/f84f7b68f6c8072480127a065def1c4453e55877)) +* Don't run e2e tests against wrong anvil ([#5686](https://github.com/AztecProtocol/aztec-packages/issues/5686)) ([9ff45f6](https://github.com/AztecProtocol/aztec-packages/commit/9ff45f69af562db4cec69c6231659476667f1cf9)) +* Dont error in bench summary ([#5693](https://github.com/AztecProtocol/aztec-packages/issues/5693)) ([470b0f3](https://github.com/AztecProtocol/aztec-packages/commit/470b0f36138f34fcff1da869f7fd54f2d50c1480)) +* E2e getStack, disable failing e2e ([#5768](https://github.com/AztecProtocol/aztec-packages/issues/5768)) ([e5f3ece](https://github.com/AztecProtocol/aztec-packages/commit/e5f3ece131b16aeede897f0a9bb3ecc23cb4d9dc)) +* GA concurrency ([#5713](https://github.com/AztecProtocol/aztec-packages/issues/5713)) ([eac2585](https://github.com/AztecProtocol/aztec-packages/commit/eac25853cc8ca14254010076106b6a9555ef5d17)) +* Generate_aztecnr_reference.js not getting generics or multi-line params ([#5679](https://github.com/AztecProtocol/aztec-packages/issues/5679)) ([a22bc3d](https://github.com/AztecProtocol/aztec-packages/commit/a22bc3d4004b050449569bf66fe7431ccd04a16c)) +* Hotfix submodule cache ([92b92b3](https://github.com/AztecProtocol/aztec-packages/commit/92b92b32c46f7c4d332a372c0e1039040c762eff)) +* Hotfix underspec'd machine ([#5710](https://github.com/AztecProtocol/aztec-packages/issues/5710)) ([059e38e](https://github.com/AztecProtocol/aztec-packages/commit/059e38e3d319b84259bb1bf36fca6ed71425eb98)) +* **hotfix:** CI ignore git safe.directory checks ([#5659](https://github.com/AztecProtocol/aztec-packages/issues/5659)) ([9fc3fe3](https://github.com/AztecProtocol/aztec-packages/commit/9fc3fe3e5aa74e593eabb2fd1f358476f039e595)) +* Less earthly cache ([#5690](https://github.com/AztecProtocol/aztec-packages/issues/5690)) ([8190dc7](https://github.com/AztecProtocol/aztec-packages/commit/8190dc7826d480f44107456984f7f192358ba8da)) +* Make earthly more parallel ([#5747](https://github.com/AztecProtocol/aztec-packages/issues/5747)) ([9734455](https://github.com/AztecProtocol/aztec-packages/commit/9734455acd0d6e0cba44477f889ec8165e7f3003)) +* Primary_message typo in errors.rs ([#5646](https://github.com/AztecProtocol/aztec-packages/issues/5646)) ([1dfbe7b](https://github.com/AztecProtocol/aztec-packages/commit/1dfbe7bc3bf3c455d8fb6c8b5fe6a96c1edf7af9)) +* Pull noir ([#5699](https://github.com/AztecProtocol/aztec-packages/issues/5699)) ([bf35464](https://github.com/AztecProtocol/aztec-packages/commit/bf3546444272f36a3e3905246c49f2e5f65cff6e)) +* REDO dont error in bench summary ([#5695](https://github.com/AztecProtocol/aztec-packages/issues/5695)) ([8c1a7b9](https://github.com/AztecProtocol/aztec-packages/commit/8c1a7b976bcc63af63ddcc8cf4f89b338f17bdf8)) +* Running e2e tests as part of build, requires forcing ip4 (not ip6) when connecting to anvil ([#5744](https://github.com/AztecProtocol/aztec-packages/issues/5744)) ([66fc89f](https://github.com/AztecProtocol/aztec-packages/commit/66fc89f417d0582865acdb04a75258a4a449c8b6)) +* Simplify ECCVM prover constructor and add a TODO ([#5681](https://github.com/AztecProtocol/aztec-packages/issues/5681)) ([8c151ea](https://github.com/AztecProtocol/aztec-packages/commit/8c151eab1492dda901a1d6b691c9ca68960fd9e6)) +* Spot refcount ([#5746](https://github.com/AztecProtocol/aztec-packages/issues/5746)) ([9e18444](https://github.com/AztecProtocol/aztec-packages/commit/9e184448f218ab06247d8cbbadf755ad384bd40a)) +* Take a deep copy of circuit inputs for proving ([#5777](https://github.com/AztecProtocol/aztec-packages/issues/5777)) ([785591e](https://github.com/AztecProtocol/aztec-packages/commit/785591e0527beef7adf0f7a791618afff9df3705)) +* Temporarily disable the bench tests ([#5755](https://github.com/AztecProtocol/aztec-packages/issues/5755)) ([1d52ac5](https://github.com/AztecProtocol/aztec-packages/commit/1d52ac5c15524648094c23cf67ea0cfb921fe186)) +* Update commit for noir-gates-diff (https://github.com/noir-lang/noir/pull/4773) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Use entrypoint instead of pay_init_fee ([#5623](https://github.com/AztecProtocol/aztec-packages/issues/5623)) ([62ac765](https://github.com/AztecProtocol/aztec-packages/commit/62ac765d192d499b7c8a8b1b4583c17fb95d00ac)) +* Watch less files. ([#5651](https://github.com/AztecProtocol/aztec-packages/issues/5651)) ([57a1d69](https://github.com/AztecProtocol/aztec-packages/commit/57a1d69f3fcade6f4536d007baad28e878242d59)) + + +### Miscellaneous + +* Add missing aztec-address tests ([#5674](https://github.com/AztecProtocol/aztec-packages/issues/5674)) ([58aefba](https://github.com/AztecProtocol/aztec-packages/commit/58aefbad0144b41619fa36a3714fa2a440945c74)) +* **avm:** Add a boolean to toggle proving in AVM unit tests ([#5667](https://github.com/AztecProtocol/aztec-packages/issues/5667)) ([ec122c9](https://github.com/AztecProtocol/aztec-packages/commit/ec122c9b9c1c63c72158c6956d8fdb2398faf96b)), closes [#5663](https://github.com/AztecProtocol/aztec-packages/issues/5663) +* **avm:** Hashing tests cleanup ([#5733](https://github.com/AztecProtocol/aztec-packages/issues/5733)) ([53d0102](https://github.com/AztecProtocol/aztec-packages/commit/53d010232600b736ac0f5116a3b7804f2d412dd0)) +* **avm:** Range checks negative tests ([#5770](https://github.com/AztecProtocol/aztec-packages/issues/5770)) ([2907142](https://github.com/AztecProtocol/aztec-packages/commit/29071423ba65774039e4e5c1f7ca67123a18f738)) +* **avm:** Split the negative test on range check for high 16-bit registers ([#5785](https://github.com/AztecProtocol/aztec-packages/issues/5785)) ([8ebbe57](https://github.com/AztecProtocol/aztec-packages/commit/8ebbe57953e35f81ca010cdd686fb43ddf0f20b2)) +* **avm:** Split up AVM test contract as it was growing too large ([#5702](https://github.com/AztecProtocol/aztec-packages/issues/5702)) ([5b8e812](https://github.com/AztecProtocol/aztec-packages/commit/5b8e812802457b429d173a5c4793ffa04faec1fa)) +* **aztec-nr:** Minor public interface changes ([#5776](https://github.com/AztecProtocol/aztec-packages/issues/5776)) ([91b8110](https://github.com/AztecProtocol/aztec-packages/commit/91b8110ab44979fe37fcc57824bdee845295ccb7)) +* **ci:** Break e2e-deploy into multiple test suites ([#5704](https://github.com/AztecProtocol/aztec-packages/issues/5704)) ([2522294](https://github.com/AztecProtocol/aztec-packages/commit/2522294d96e064b4531e05ae1b21eb4fa8f90125)) +* **ci:** Earthly in spot with persistent cache ([#5644](https://github.com/AztecProtocol/aztec-packages/issues/5644)) ([a39c2f6](https://github.com/AztecProtocol/aztec-packages/commit/a39c2f64565665260dbf8640478691dd5d47cee5)) +* **ci:** Hotfix AMI's, workflow to stop personal spot runners ([#5712](https://github.com/AztecProtocol/aztec-packages/issues/5712)) ([5f18139](https://github.com/AztecProtocol/aztec-packages/commit/5f1813947e05cc56553c8606a254f26d39ca6093)) +* **ci:** Only run ARM on master ([#5705](https://github.com/AztecProtocol/aztec-packages/issues/5705)) ([f77c142](https://github.com/AztecProtocol/aztec-packages/commit/f77c142b1634442434aa4631317186523d456a69)) +* **ci:** Use 128 cores for x86 and add timeouts ([#5665](https://github.com/AztecProtocol/aztec-packages/issues/5665)) ([0c5dc0a](https://github.com/AztecProtocol/aztec-packages/commit/0c5dc0a8d90c52c46f9802ec5fb93561d0551b6a)) +* Compute_note_hash_and_nullifier - improve error message ([#5671](https://github.com/AztecProtocol/aztec-packages/issues/5671)) ([8942d69](https://github.com/AztecProtocol/aztec-packages/commit/8942d69ab59f9ca7b33b72c91fb960c02afd66b0)) +* Create placeholder version of 0.26.0 docs (https://github.com/noir-lang/noir/pull/4782) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* **doc:** Fix broken docs links (https://github.com/noir-lang/noir/pull/4606) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* **docs:** Fix link in the Data Types page (https://github.com/noir-lang/noir/pull/4527) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) +* Fix master after merge issue related to validate_trace renaming ([#5676](https://github.com/AztecProtocol/aztec-packages/issues/5676)) ([44e0d8a](https://github.com/AztecProtocol/aztec-packages/commit/44e0d8abd2104a9969d5750736e77fe9a8d4d621)) +* Fix max-block-number and auth e2e tests ([#5694](https://github.com/AztecProtocol/aztec-packages/issues/5694)) ([f1bf314](https://github.com/AztecProtocol/aztec-packages/commit/f1bf31431df68655fa5364c0504c2323ad660c22)) +* Op queue ([#5648](https://github.com/AztecProtocol/aztec-packages/issues/5648)) ([822c7e6](https://github.com/AztecProtocol/aztec-packages/commit/822c7e63e91cb30219a79513c05d84ee4f03d8fe)) +* **public:** Remove getNullifierMembershipWitness ([#5715](https://github.com/AztecProtocol/aztec-packages/issues/5715)) ([3be402c](https://github.com/AztecProtocol/aztec-packages/commit/3be402cca4fc1451a2b4c7560c346843eb8439cd)) +* Re-enable e2e fees tests ([#5784](https://github.com/AztecProtocol/aztec-packages/issues/5784)) ([102e8b8](https://github.com/AztecProtocol/aztec-packages/commit/102e8b89e91c324f945ab94357508c25eba4fa92)) +* Release Noir(0.27.0) (https://github.com/noir-lang/noir/pull/4632) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Remove the old Value struct from the oracle docs (https://github.com/noir-lang/noir/pull/4738) ([1eb288e](https://github.com/AztecProtocol/aztec-packages/commit/1eb288e9adc8b803e75ed80317c3e0979d0dfdee)) +* Replace relative paths to noir-protocol-circuits ([fb2b298](https://github.com/AztecProtocol/aztec-packages/commit/fb2b298066bbf0fa15e5a39fa7e48cb288e50182)) +* Replace relative paths to noir-protocol-circuits ([e20920d](https://github.com/AztecProtocol/aztec-packages/commit/e20920d3b2f2acf4682eecc94a04e46fc50a8767)) +* Replace relative paths to noir-protocol-circuits ([6351dc5](https://github.com/AztecProtocol/aztec-packages/commit/6351dc52fe63200293aaf1749330a8f572356163)) +* Replace relative paths to noir-protocol-circuits ([fee13bf](https://github.com/AztecProtocol/aztec-packages/commit/fee13bf5869a03a84a05bb3166d0f5493c7056fd)) +* Replacing unsafe::zeroed() ([#5685](https://github.com/AztecProtocol/aztec-packages/issues/5685)) ([ea3884e](https://github.com/AztecProtocol/aztec-packages/commit/ea3884ec49e8a37d66b212551e1b78ab47a93e37)) +* Small logging changes ([#5654](https://github.com/AztecProtocol/aztec-packages/issues/5654)) ([25cc70d](https://github.com/AztecProtocol/aztec-packages/commit/25cc70de04342f89665883012b86f1c54c916c44)) +* Temporarily skip failing e2e fees test ([a3ac5ff](https://github.com/AztecProtocol/aztec-packages/commit/a3ac5ff251270f7a14d56e9b7846655dce716a44)) +* Testing that nargo fmt is idempotent (https://github.com/noir-lang/noir/pull/4765) ([825c455](https://github.com/AztecProtocol/aztec-packages/commit/825c455a62faeae5d148ce4f914efacb8f4c50fd)) +* TS hash wrappers cleanup ([#5691](https://github.com/AztecProtocol/aztec-packages/issues/5691)) ([7f8b09f](https://github.com/AztecProtocol/aztec-packages/commit/7f8b09fca6370b140870041a49692383a4db6551)) +* Turn ENABLE_GAS where it is needed ([#5730](https://github.com/AztecProtocol/aztec-packages/issues/5730)) ([30a2edd](https://github.com/AztecProtocol/aztec-packages/commit/30a2edd91cc46196c13fe421cdea2e03f30052fc)) +* Update noir gates diff ([#5658](https://github.com/AztecProtocol/aztec-packages/issues/5658)) ([9816c1a](https://github.com/AztecProtocol/aztec-packages/commit/9816c1adead8d3455c091664744f064bb0433ee7)) +* We can run 35 of our e2e tests just using jest. ([#5643](https://github.com/AztecProtocol/aztec-packages/issues/5643)) ([4fcaeae](https://github.com/AztecProtocol/aztec-packages/commit/4fcaeaea01acc42f87e6c6a5b0d229deaee2a063)) + + +### Documentation + +* Fix yp typo control-flow.md ([#5638](https://github.com/AztecProtocol/aztec-packages/issues/5638)) ([363d227](https://github.com/AztecProtocol/aztec-packages/commit/363d2275592f190d57501a25014bfe37ccad5e30)) + ## [0.34.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.33.0...aztec-packages-v0.34.0) (2024-04-10) diff --git a/barretenberg/CHANGELOG.md b/barretenberg/CHANGELOG.md index 1d86094065a..c98c4958cc7 100644 --- a/barretenberg/CHANGELOG.md +++ b/barretenberg/CHANGELOG.md @@ -1,5 +1,49 @@ # Changelog +## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.34.0...barretenberg-v0.35.0) (2024-04-16) + + +### ⚠ BREAKING CHANGES + +* Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) +* trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) +* **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) + +### Features + +* **acir:** BrilligCall opcode ([#5709](https://github.com/AztecProtocol/aztec-packages/issues/5709)) ([f06f64c](https://github.com/AztecProtocol/aztec-packages/commit/f06f64c451333d36eb05951202d69ee85cca8851)) +* **avm:** CMOV opcode ([#5575](https://github.com/AztecProtocol/aztec-packages/issues/5575)) ([19dbe46](https://github.com/AztecProtocol/aztec-packages/commit/19dbe46bce95221bf2e68c9361618998a6bdc64f)), closes [#5557](https://github.com/AztecProtocol/aztec-packages/issues/5557) +* **avm:** Enable contract testing with bb binary ([#5584](https://github.com/AztecProtocol/aztec-packages/issues/5584)) ([d007d79](https://github.com/AztecProtocol/aztec-packages/commit/d007d79c7014261d9c663e28c948600d92e85759)) +* **avm:** Enable range check on the ALU registers ([#5696](https://github.com/AztecProtocol/aztec-packages/issues/5696)) ([202fc1b](https://github.com/AztecProtocol/aztec-packages/commit/202fc1b750e83f91c32b128b981db1c5c92ef3f2)) +* Changing finite field arithmetic in wasm to 29 bits for multiplications ([#5435](https://github.com/AztecProtocol/aztec-packages/issues/5435)) ([b2d9b9d](https://github.com/AztecProtocol/aztec-packages/commit/b2d9b9d5f1764b159e081b3cc9806ee83fdf341f)) +* **ci:** Turn on new CI as mandatory ([#5761](https://github.com/AztecProtocol/aztec-packages/issues/5761)) ([bebed32](https://github.com/AztecProtocol/aztec-packages/commit/bebed32272e0974de21b5c7d21344d3cf1597a24)) +* Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) +* LT/LTE for AVM ([#5559](https://github.com/AztecProtocol/aztec-packages/issues/5559)) ([350abeb](https://github.com/AztecProtocol/aztec-packages/commit/350abeb4c88d7e7878abc32e9263c558633f0df9)) +* Trap with revert data ([#5732](https://github.com/AztecProtocol/aztec-packages/issues/5732)) ([f849575](https://github.com/AztecProtocol/aztec-packages/commit/f84957584ff76c22c069903f7648735a0be91d7f)) +* Use fixed size arrays in black box functions where sizes are known ([#5620](https://github.com/AztecProtocol/aztec-packages/issues/5620)) ([f50b180](https://github.com/AztecProtocol/aztec-packages/commit/f50b180379ac90d782aba3472708f8cef122c25b)) + + +### Bug Fixes + +* "feat: Changing finite field arithmetic in wasm to 29 bits for multiplications" ([#5779](https://github.com/AztecProtocol/aztec-packages/issues/5779)) ([bcfee97](https://github.com/AztecProtocol/aztec-packages/commit/bcfee97da99c654f8641ab8099bbbe5d58e2a5c7)) +* Avoid get row in databus ([#5742](https://github.com/AztecProtocol/aztec-packages/issues/5742)) ([d67b6c8](https://github.com/AztecProtocol/aztec-packages/commit/d67b6c8bb703d856c0d95d4d47cc6de93467e9ab)) +* **ci:** Bigger cache disk, cache+prune docker images, disable ClientIvcTests.Full ([#5729](https://github.com/AztecProtocol/aztec-packages/issues/5729)) ([5dcbd75](https://github.com/AztecProtocol/aztec-packages/commit/5dcbd75c0795640d48592efbd750cd22b5e5ddd5)) +* Disable flakey vanilla recursion test ([#5672](https://github.com/AztecProtocol/aztec-packages/issues/5672)) ([f84f7b6](https://github.com/AztecProtocol/aztec-packages/commit/f84f7b68f6c8072480127a065def1c4453e55877)) +* Less earthly cache ([#5690](https://github.com/AztecProtocol/aztec-packages/issues/5690)) ([8190dc7](https://github.com/AztecProtocol/aztec-packages/commit/8190dc7826d480f44107456984f7f192358ba8da)) +* Make earthly more parallel ([#5747](https://github.com/AztecProtocol/aztec-packages/issues/5747)) ([9734455](https://github.com/AztecProtocol/aztec-packages/commit/9734455acd0d6e0cba44477f889ec8165e7f3003)) +* Simplify ECCVM prover constructor and add a TODO ([#5681](https://github.com/AztecProtocol/aztec-packages/issues/5681)) ([8c151ea](https://github.com/AztecProtocol/aztec-packages/commit/8c151eab1492dda901a1d6b691c9ca68960fd9e6)) + + +### Miscellaneous + +* **avm:** Add a boolean to toggle proving in AVM unit tests ([#5667](https://github.com/AztecProtocol/aztec-packages/issues/5667)) ([ec122c9](https://github.com/AztecProtocol/aztec-packages/commit/ec122c9b9c1c63c72158c6956d8fdb2398faf96b)), closes [#5663](https://github.com/AztecProtocol/aztec-packages/issues/5663) +* **avm:** Range checks negative tests ([#5770](https://github.com/AztecProtocol/aztec-packages/issues/5770)) ([2907142](https://github.com/AztecProtocol/aztec-packages/commit/29071423ba65774039e4e5c1f7ca67123a18f738)) +* **avm:** Split the negative test on range check for high 16-bit registers ([#5785](https://github.com/AztecProtocol/aztec-packages/issues/5785)) ([8ebbe57](https://github.com/AztecProtocol/aztec-packages/commit/8ebbe57953e35f81ca010cdd686fb43ddf0f20b2)) +* **ci:** Use 128 cores for x86 and add timeouts ([#5665](https://github.com/AztecProtocol/aztec-packages/issues/5665)) ([0c5dc0a](https://github.com/AztecProtocol/aztec-packages/commit/0c5dc0a8d90c52c46f9802ec5fb93561d0551b6a)) +* Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) +* Fix master after merge issue related to validate_trace renaming ([#5676](https://github.com/AztecProtocol/aztec-packages/issues/5676)) ([44e0d8a](https://github.com/AztecProtocol/aztec-packages/commit/44e0d8abd2104a9969d5750736e77fe9a8d4d621)) +* Op queue ([#5648](https://github.com/AztecProtocol/aztec-packages/issues/5648)) ([822c7e6](https://github.com/AztecProtocol/aztec-packages/commit/822c7e63e91cb30219a79513c05d84ee4f03d8fe)) + ## [0.34.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.33.0...barretenberg-v0.34.0) (2024-04-10) diff --git a/barretenberg/cpp/CMakeLists.txt b/barretenberg/cpp/CMakeLists.txt index fec9ce4240e..1c8fc184e29 100644 --- a/barretenberg/cpp/CMakeLists.txt +++ b/barretenberg/cpp/CMakeLists.txt @@ -6,7 +6,7 @@ cmake_minimum_required(VERSION 3.24 FATAL_ERROR) project( Barretenberg DESCRIPTION "BN254 elliptic curve library, and PLONK SNARK prover" - VERSION 0.34.0 # x-release-please-version + VERSION 0.35.0 # x-release-please-version LANGUAGES CXX C ) # Insert version into `bb` config file diff --git a/barretenberg/ts/CHANGELOG.md b/barretenberg/ts/CHANGELOG.md index 389e21f2d53..ae7ed9d3aaf 100644 --- a/barretenberg/ts/CHANGELOG.md +++ b/barretenberg/ts/CHANGELOG.md @@ -1,5 +1,18 @@ # Changelog +## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.34.0...barretenberg.js-v0.35.0) (2024-04-16) + + +### Features + +* Export poseidon2_permutation and add to foundation/crypto ([#5706](https://github.com/AztecProtocol/aztec-packages/issues/5706)) ([6b91e27](https://github.com/AztecProtocol/aztec-packages/commit/6b91e2776de8fd5b1f489b5cfeee83c7e0996c2e)) + + +### Miscellaneous + +* Don't strip bb wasm ([#5743](https://github.com/AztecProtocol/aztec-packages/issues/5743)) ([d4cb410](https://github.com/AztecProtocol/aztec-packages/commit/d4cb4108900f1fb6307de17be9ee3516d6023609)) +* TS hash wrappers cleanup ([#5691](https://github.com/AztecProtocol/aztec-packages/issues/5691)) ([7f8b09f](https://github.com/AztecProtocol/aztec-packages/commit/7f8b09fca6370b140870041a49692383a4db6551)) + ## [0.34.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.33.0...barretenberg.js-v0.34.0) (2024-04-10) diff --git a/barretenberg/ts/package.json b/barretenberg/ts/package.json index bc9e3a43744..f1c488aa0c9 100644 --- a/barretenberg/ts/package.json +++ b/barretenberg/ts/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/bb.js", - "version": "0.34.0", + "version": "0.35.0", "homepage": "https://github.com/AztecProtocol/aztec-packages/tree/master/barretenberg/ts", "license": "MIT", "type": "module", diff --git a/yarn-project/aztec/CHANGELOG.md b/yarn-project/aztec/CHANGELOG.md index ff6cdcd4bf1..8bb9cbc676b 100644 --- a/yarn-project/aztec/CHANGELOG.md +++ b/yarn-project/aztec/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.34.0...aztec-package-v0.35.0) (2024-04-16) + + +### ⚠ BREAKING CHANGES + +* pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) + +### Features + +* Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151)) + ## [0.34.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.33.0...aztec-package-v0.34.0) (2024-04-10) diff --git a/yarn-project/aztec/package.json b/yarn-project/aztec/package.json index d0c984be9f3..8cd36bce53d 100644 --- a/yarn-project/aztec/package.json +++ b/yarn-project/aztec/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/aztec", - "version": "0.34.0", + "version": "0.35.0", "type": "module", "exports": { ".": "./dest/index.js" diff --git a/yarn-project/cli/CHANGELOG.md b/yarn-project/cli/CHANGELOG.md index 542908371cc..0cebdf56b34 100644 --- a/yarn-project/cli/CHANGELOG.md +++ b/yarn-project/cli/CHANGELOG.md @@ -1,5 +1,16 @@ # Changelog +## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.34.0...aztec-cli-v0.35.0) (2024-04-16) + + +### ⚠ BREAKING CHANGES + +* pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) + +### Features + +* Pay fee for account init ([#5601](https://github.com/AztecProtocol/aztec-packages/issues/5601)) ([aca804f](https://github.com/AztecProtocol/aztec-packages/commit/aca804f96ca9e74b6b553449333e195c0639b151)) + ## [0.34.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.33.0...aztec-cli-v0.34.0) (2024-04-10) diff --git a/yarn-project/cli/package.json b/yarn-project/cli/package.json index d24e93c8463..3475d9e4f24 100644 --- a/yarn-project/cli/package.json +++ b/yarn-project/cli/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/cli", - "version": "0.34.0", + "version": "0.35.0", "type": "module", "main": "./dest/index.js", "bin": { From 9a85c205f3a539494dc57fc7abb7c7700ad3a3df Mon Sep 17 00:00:00 2001 From: ludamad Date: Tue, 16 Apr 2024 12:58:22 -0400 Subject: [PATCH 33/56] fix: disable bench-tx-size until fixed (#5789) Seems there's more issues after recent fixes. --- .circleci/config.yml | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index 6b4c8af64ae..fd4aec7d778 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -551,15 +551,15 @@ jobs: aztec_manifest_key: end-to-end <<: *defaults_e2e_test - bench-tx-size: - steps: - - *checkout - - *setup_env - - run: - name: "Benchmark" - command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees - aztec_manifest_key: end-to-end - <<: *defaults_e2e_test + # bench-tx-size: + # steps: + # - *checkout + # - *setup_env + # - run: + # name: "Benchmark" + # command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees + # aztec_manifest_key: end-to-end + # <<: *defaults_e2e_test build-docs: machine: @@ -900,12 +900,12 @@ workflows: # Benchmark jobs. - bench-publish-rollup: *e2e_test - bench-process-history: *e2e_test - - bench-tx-size: *e2e_test + # - bench-tx-size: *e2e_test - bench-summary: requires: - bench-publish-rollup - bench-process-history - - bench-tx-size + # - bench-tx-size <<: *defaults # Production releases. From 6a0713e0c556046bd53f141670134c78899cae1b Mon Sep 17 00:00:00 2001 From: Aztec Bot <49558828+AztecBot@users.noreply.github.com> Date: Tue, 16 Apr 2024 13:01:16 -0400 Subject: [PATCH 34/56] chore(master): Release 0.35.1 (#5790) :robot: I have created a release *beep* *boop* ---
aztec-package: 0.35.1 ## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.35.0...aztec-package-v0.35.1) (2024-04-16) ### Miscellaneous * **aztec-package:** Synchronize aztec-packages versions
barretenberg.js: 0.35.1 ## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.35.0...barretenberg.js-v0.35.1) (2024-04-16) ### Miscellaneous * **barretenberg.js:** Synchronize aztec-packages versions
aztec-cli: 0.35.1 ## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.35.0...aztec-cli-v0.35.1) (2024-04-16) ### Miscellaneous * **aztec-cli:** Synchronize aztec-packages versions
aztec-packages: 0.35.1 ## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.35.0...aztec-packages-v0.35.1) (2024-04-16) ### Bug Fixes * Disable bench-tx-size until fixed ([#5789](https://github.com/AztecProtocol/aztec-packages/issues/5789)) ([9a85c20](https://github.com/AztecProtocol/aztec-packages/commit/9a85c205f3a539494dc57fc7abb7c7700ad3a3df))
barretenberg: 0.35.1 ## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.35.0...barretenberg-v0.35.1) (2024-04-16) ### Miscellaneous * **barretenberg:** Synchronize aztec-packages versions
--- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). --- .release-please-manifest.json | 10 +++++----- CHANGELOG.md | 7 +++++++ barretenberg/CHANGELOG.md | 7 +++++++ barretenberg/cpp/CMakeLists.txt | 2 +- barretenberg/ts/CHANGELOG.md | 7 +++++++ barretenberg/ts/package.json | 2 +- yarn-project/aztec/CHANGELOG.md | 7 +++++++ yarn-project/aztec/package.json | 2 +- yarn-project/cli/CHANGELOG.md | 7 +++++++ yarn-project/cli/package.json | 2 +- 10 files changed, 44 insertions(+), 9 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index bb7ec3a2576..2af8fe1250f 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,7 +1,7 @@ { - ".": "0.35.0", - "yarn-project/cli": "0.35.0", - "yarn-project/aztec": "0.35.0", - "barretenberg": "0.35.0", - "barretenberg/ts": "0.35.0" + ".": "0.35.1", + "yarn-project/cli": "0.35.1", + "yarn-project/aztec": "0.35.1", + "barretenberg": "0.35.1", + "barretenberg/ts": "0.35.1" } diff --git a/CHANGELOG.md b/CHANGELOG.md index 3783175fb53..18ca6ac8737 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.35.0...aztec-packages-v0.35.1) (2024-04-16) + + +### Bug Fixes + +* Disable bench-tx-size until fixed ([#5789](https://github.com/AztecProtocol/aztec-packages/issues/5789)) ([9a85c20](https://github.com/AztecProtocol/aztec-packages/commit/9a85c205f3a539494dc57fc7abb7c7700ad3a3df)) + ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-packages-v0.34.0...aztec-packages-v0.35.0) (2024-04-16) diff --git a/barretenberg/CHANGELOG.md b/barretenberg/CHANGELOG.md index c98c4958cc7..d37b74ee13c 100644 --- a/barretenberg/CHANGELOG.md +++ b/barretenberg/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.35.0...barretenberg-v0.35.1) (2024-04-16) + + +### Miscellaneous + +* **barretenberg:** Synchronize aztec-packages versions + ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg-v0.34.0...barretenberg-v0.35.0) (2024-04-16) diff --git a/barretenberg/cpp/CMakeLists.txt b/barretenberg/cpp/CMakeLists.txt index 1c8fc184e29..6a6f3170757 100644 --- a/barretenberg/cpp/CMakeLists.txt +++ b/barretenberg/cpp/CMakeLists.txt @@ -6,7 +6,7 @@ cmake_minimum_required(VERSION 3.24 FATAL_ERROR) project( Barretenberg DESCRIPTION "BN254 elliptic curve library, and PLONK SNARK prover" - VERSION 0.35.0 # x-release-please-version + VERSION 0.35.1 # x-release-please-version LANGUAGES CXX C ) # Insert version into `bb` config file diff --git a/barretenberg/ts/CHANGELOG.md b/barretenberg/ts/CHANGELOG.md index ae7ed9d3aaf..8592c453620 100644 --- a/barretenberg/ts/CHANGELOG.md +++ b/barretenberg/ts/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.35.0...barretenberg.js-v0.35.1) (2024-04-16) + + +### Miscellaneous + +* **barretenberg.js:** Synchronize aztec-packages versions + ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/barretenberg.js-v0.34.0...barretenberg.js-v0.35.0) (2024-04-16) diff --git a/barretenberg/ts/package.json b/barretenberg/ts/package.json index f1c488aa0c9..888182337d6 100644 --- a/barretenberg/ts/package.json +++ b/barretenberg/ts/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/bb.js", - "version": "0.35.0", + "version": "0.35.1", "homepage": "https://github.com/AztecProtocol/aztec-packages/tree/master/barretenberg/ts", "license": "MIT", "type": "module", diff --git a/yarn-project/aztec/CHANGELOG.md b/yarn-project/aztec/CHANGELOG.md index 8bb9cbc676b..054e57bc4f4 100644 --- a/yarn-project/aztec/CHANGELOG.md +++ b/yarn-project/aztec/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.35.0...aztec-package-v0.35.1) (2024-04-16) + + +### Miscellaneous + +* **aztec-package:** Synchronize aztec-packages versions + ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-package-v0.34.0...aztec-package-v0.35.0) (2024-04-16) diff --git a/yarn-project/aztec/package.json b/yarn-project/aztec/package.json index 8cd36bce53d..923d86a2938 100644 --- a/yarn-project/aztec/package.json +++ b/yarn-project/aztec/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/aztec", - "version": "0.35.0", + "version": "0.35.1", "type": "module", "exports": { ".": "./dest/index.js" diff --git a/yarn-project/cli/CHANGELOG.md b/yarn-project/cli/CHANGELOG.md index 0cebdf56b34..bdb8e7a5808 100644 --- a/yarn-project/cli/CHANGELOG.md +++ b/yarn-project/cli/CHANGELOG.md @@ -1,5 +1,12 @@ # Changelog +## [0.35.1](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.35.0...aztec-cli-v0.35.1) (2024-04-16) + + +### Miscellaneous + +* **aztec-cli:** Synchronize aztec-packages versions + ## [0.35.0](https://github.com/AztecProtocol/aztec-packages/compare/aztec-cli-v0.34.0...aztec-cli-v0.35.0) (2024-04-16) diff --git a/yarn-project/cli/package.json b/yarn-project/cli/package.json index 3475d9e4f24..e1a887fb1cb 100644 --- a/yarn-project/cli/package.json +++ b/yarn-project/cli/package.json @@ -1,6 +1,6 @@ { "name": "@aztec/cli", - "version": "0.35.0", + "version": "0.35.1", "type": "module", "main": "./dest/index.js", "bin": { From c8784d7994937bfae9d23f5d17eb914bae92d8dc Mon Sep 17 00:00:00 2001 From: Santiago Palladino Date: Tue, 16 Apr 2024 14:17:45 -0300 Subject: [PATCH 35/56] fix: Remove tx.origin (#5765) Fixes #5756 --- avm-transpiler/src/opcodes.rs | 4 +- avm-transpiler/src/transpile.rs | 1 - .../barretenberg/vm/avm_trace/avm_opcode.cpp | 2 - .../barretenberg/vm/avm_trace/avm_opcode.hpp | 1 - .../circuits/private-kernel-initial.mdx | 14 +- .../public-vm/_nested-context.md | 1 - .../protocol-specs/public-vm/avm-circuit.md | 1 - .../docs/protocol-specs/public-vm/context.mdx | 2 - .../public-vm/gen/_instruction-set.mdx | 188 ++++++++---------- .../InstructionSet/InstructionSet.js | 18 -- .../aztec-nr/aztec/src/context/avm_context.nr | 6 - .../contracts/avm_test_contract/src/main.nr | 5 - .../src/avm/avm_execution_environment.ts | 4 - yarn-project/simulator/src/avm/avm_gas.ts | 1 - .../simulator/src/avm/avm_simulator.test.ts | 5 - .../simulator/src/avm/fixtures/index.ts | 1 - .../avm/opcodes/environment_getters.test.ts | 3 - .../src/avm/opcodes/environment_getters.ts | 9 - .../serialization/bytecode_serialization.ts | 2 - .../instruction_serialization.ts | 3 +- .../src/public/transitional_adaptors.ts | 1 - 21 files changed, 91 insertions(+), 181 deletions(-) diff --git a/avm-transpiler/src/opcodes.rs b/avm-transpiler/src/opcodes.rs index 1ee44d1210c..ca41eba9674 100644 --- a/avm-transpiler/src/opcodes.rs +++ b/avm-transpiler/src/opcodes.rs @@ -1,5 +1,5 @@ /// All AVM opcodes -/// Keep updated with TS and docs protocol specs! +/// Keep updated with TS, cpp, and docs protocol specs! #[derive(PartialEq, Copy, Clone, Debug)] pub enum AvmOpcode { // Compute @@ -21,7 +21,6 @@ pub enum AvmOpcode { // Execution environment ADDRESS, STORAGEADDRESS, - ORIGIN, SENDER, PORTAL, FEEPERL1GAS, @@ -102,7 +101,6 @@ impl AvmOpcode { // Execution Environment AvmOpcode::ADDRESS => "ADDRESS", AvmOpcode::STORAGEADDRESS => "STORAGEADDRESS", - AvmOpcode::ORIGIN => "ORIGIN", AvmOpcode::SENDER => "SENDER", AvmOpcode::PORTAL => "PORTAL", AvmOpcode::FEEPERL1GAS => "FEEPERL1GAS", diff --git a/avm-transpiler/src/transpile.rs b/avm-transpiler/src/transpile.rs index 581438c2ccb..0de09a5793c 100644 --- a/avm-transpiler/src/transpile.rs +++ b/avm-transpiler/src/transpile.rs @@ -744,7 +744,6 @@ fn handle_getter_instruction( let opcode = match function { "avmOpcodeAddress" => AvmOpcode::ADDRESS, "avmOpcodeStorageAddress" => AvmOpcode::STORAGEADDRESS, - "avmOpcodeOrigin" => AvmOpcode::ORIGIN, "avmOpcodeSender" => AvmOpcode::SENDER, "avmOpcodePortal" => AvmOpcode::PORTAL, "avmOpcodeFeePerL1Gas" => AvmOpcode::FEEPERL1GAS, diff --git a/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.cpp b/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.cpp index 9ce4baf73dd..05caf1ace28 100644 --- a/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.cpp +++ b/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.cpp @@ -31,7 +31,6 @@ const std::unordered_map Bytecode::OPERANDS_NUM = { //// Execution Environment //{OpCode::ADDRESS, }, //{OpCode::STORAGEADDRESS, }, - //{OpCode::ORIGIN, }, //{OpCode::SENDER, }, //{OpCode::PORTAL, }, //{OpCode::FEEPERL1GAS, }, @@ -116,7 +115,6 @@ bool Bytecode::has_in_tag(OpCode const op_code) switch (op_code) { case OpCode::ADDRESS: case OpCode::STORAGEADDRESS: - case OpCode::ORIGIN: case OpCode::SENDER: case OpCode::PORTAL: case OpCode::FEEPERL1GAS: diff --git a/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.hpp b/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.hpp index 8f04ddcd2d3..98adf14ab29 100644 --- a/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.hpp +++ b/barretenberg/cpp/src/barretenberg/vm/avm_trace/avm_opcode.hpp @@ -40,7 +40,6 @@ enum class OpCode : uint8_t { // Execution Environment ADDRESS, STORAGEADDRESS, - ORIGIN, SENDER, PORTAL, FEEPERL1GAS, diff --git a/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx b/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx index 9770bd2de90..f1815a556e5 100644 --- a/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx +++ b/docs/docs/protocol-specs/circuits/private-kernel-initial.mdx @@ -714,13 +714,13 @@ TransientAccumulatedData --* PublicInputs: transient_accumulated_data Data that represents the caller's intent. -| Field | Type | Description | -| --------------- | ------------------------------------------- | -------------------------------------------- | -| `origin` | `AztecAddress` | The Aztec address of the transaction sender. | -| `function_data` | [`FunctionData`](#functiondata) | Data of the function being called. | -| `args_hash` | `field` | Hash of the function arguments. | -| `tx_context` | [`TransactionContext`](#transactioncontext) | Information about the transaction. | -| `gas_settings` | [`GasSettings`](#gassettings) | User-defined gas limits and max fees. | +| Field | Type | Description | +| --------------- | ------------------------------------------- | ------------------------------------- | +| `origin` | `AztecAddress` | Address of the entrypoint contract. | +| `function_data` | [`FunctionData`](#functiondata) | Data of the function being called. | +| `args_hash` | `field` | Hash of the function arguments. | +| `tx_context` | [`TransactionContext`](#transactioncontext) | Information about the transaction. | +| `gas_settings` | [`GasSettings`](#gassettings) | User-defined gas limits and max fees. | ### `PrivateCall` diff --git a/docs/docs/protocol-specs/public-vm/_nested-context.md b/docs/docs/protocol-specs/public-vm/_nested-context.md index 5de8badab2f..aa081d17a38 100644 --- a/docs/docs/protocol-specs/public-vm/_nested-context.md +++ b/docs/docs/protocol-specs/public-vm/_nested-context.md @@ -14,7 +14,6 @@ nestedContext = deriveContext(context, instr.args, isStaticCall, isDelegateCall) Nested context derivation is defined as follows: ```jsx nestedExecutionEnvironment = ExecutionEnvironment { - origin: context.origin, sender: isDelegateCall ? context.sender : context.address, address: M[addrOffset], storageAddress: isDelegateCall ? context.storageAddress : M[addrOffset], diff --git a/docs/docs/protocol-specs/public-vm/avm-circuit.md b/docs/docs/protocol-specs/public-vm/avm-circuit.md index 57eee866234..b5c3d1ab215 100644 --- a/docs/docs/protocol-specs/public-vm/avm-circuit.md +++ b/docs/docs/protocol-specs/public-vm/avm-circuit.md @@ -178,7 +178,6 @@ The VM circuit's I/O (`AvmPublicInputs`) is defined below: ``` AvmSessionInputs { // Initializes Execution Environment - origin: AztecAddress, feePerL1Gas: field, feePerL2Gas: field, feePerDaGas: field, diff --git a/docs/docs/protocol-specs/public-vm/context.mdx b/docs/docs/protocol-specs/public-vm/context.mdx index 5b17027b07f..7b2d8847c25 100644 --- a/docs/docs/protocol-specs/public-vm/context.mdx +++ b/docs/docs/protocol-specs/public-vm/context.mdx @@ -25,7 +25,6 @@ A context's **execution environment** remains constant throughout a contract cal | --- | --- | --- | | address | `AztecAddress` | | | storageAddress | `AztecAddress` | | -| origin | `AztecAddress` | | | sender | `AztecAddress` | | | portal | `EthAddress` | | | feePerL1Gas | `field` | | @@ -73,7 +72,6 @@ Given a [`PublicCallRequest`](../transactions/tx-object#public-call-request) and INITIAL_EXECUTION_ENVIRONMENT = ExecutionEnvironment { address: PublicCallRequest.contractAddress, storageAddress: PublicCallRequest.CallContext.storageContractAddress, - origin: TxRequest.origin, sender: PublicCallRequest.CallContext.msgSender, portal: PublicCallRequest.CallContext.portalContractAddress, feePerL1Gas: TxRequest.feePerL1Gas, diff --git a/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx b/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx index 0467dcd11df..d1f4fa379c3 100644 --- a/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx +++ b/docs/docs/protocol-specs/public-vm/gen/_instruction-set.mdx @@ -133,154 +133,147 @@ Click on an instruction name to jump to its section. } - 0x11 [`ORIGIN`](#isa-section-origin) - Get the transaction's origination address - { - `M[dstOffset] = context.environment.origin` - } - - - 0x12 [`SENDER`](#isa-section-sender) + 0x11 [`SENDER`](#isa-section-sender) Get the address of the sender (caller of the current context) { `M[dstOffset] = context.environment.sender` } - 0x13 [`PORTAL`](#isa-section-portal) + 0x12 [`PORTAL`](#isa-section-portal) Get the address of the l1 portal contract { `M[dstOffset] = context.environment.portal` } - 0x14 [`FEEPERL1GAS`](#isa-section-feeperl1gas) + 0x13 [`FEEPERL1GAS`](#isa-section-feeperl1gas) Get the fee to be paid per "L1 gas" - constant for entire transaction { `M[dstOffset] = context.environment.feePerL1Gas` } - 0x15 [`FEEPERL2GAS`](#isa-section-feeperl2gas) + 0x14 [`FEEPERL2GAS`](#isa-section-feeperl2gas) Get the fee to be paid per "L2 gas" - constant for entire transaction { `M[dstOffset] = context.environment.feePerL2Gas` } - 0x16 [`FEEPERDAGAS`](#isa-section-feeperdagas) + 0x15 [`FEEPERDAGAS`](#isa-section-feeperdagas) Get the fee to be paid per "DA gas" - constant for entire transaction { `M[dstOffset] = context.environment.feePerDaGas` } - 0x17 [`CONTRACTCALLDEPTH`](#isa-section-contractcalldepth) + 0x16 [`CONTRACTCALLDEPTH`](#isa-section-contractcalldepth) Get how many contract calls deep the current call context is { `M[dstOffset] = context.environment.contractCallDepth` } - 0x18 [`CHAINID`](#isa-section-chainid) + 0x17 [`CHAINID`](#isa-section-chainid) Get this rollup's L1 chain ID { `M[dstOffset] = context.environment.globals.chainId` } - 0x19 [`VERSION`](#isa-section-version) + 0x18 [`VERSION`](#isa-section-version) Get this rollup's L2 version ID { `M[dstOffset] = context.environment.globals.version` } - 0x1a [`BLOCKNUMBER`](#isa-section-blocknumber) + 0x19 [`BLOCKNUMBER`](#isa-section-blocknumber) Get this L2 block's number { `M[dstOffset] = context.environment.globals.blocknumber` } - 0x1b [`TIMESTAMP`](#isa-section-timestamp) + 0x1a [`TIMESTAMP`](#isa-section-timestamp) Get this L2 block's timestamp { `M[dstOffset] = context.environment.globals.timestamp` } - 0x1c [`COINBASE`](#isa-section-coinbase) + 0x1b [`COINBASE`](#isa-section-coinbase) Get the block's beneficiary address { `M[dstOffset] = context.environment.globals.coinbase` } - 0x1d [`BLOCKL1GASLIMIT`](#isa-section-blockl1gaslimit) + 0x1c [`BLOCKL1GASLIMIT`](#isa-section-blockl1gaslimit) Total amount of "L1 gas" that a block can consume { `M[dstOffset] = context.environment.globals.l1GasLimit` } - 0x1e [`BLOCKL2GASLIMIT`](#isa-section-blockl2gaslimit) + 0x1d [`BLOCKL2GASLIMIT`](#isa-section-blockl2gaslimit) Total amount of "L2 gas" that a block can consume { `M[dstOffset] = context.environment.globals.l2GasLimit` } - 0x1f [`BLOCKDAGASLIMIT`](#isa-section-blockdagaslimit) + 0x1e [`BLOCKDAGASLIMIT`](#isa-section-blockdagaslimit) Total amount of "DA gas" that a block can consume { `M[dstOffset] = context.environment.globals.daGasLimit` } - 0x20 [`CALLDATACOPY`](#isa-section-calldatacopy) + 0x1f [`CALLDATACOPY`](#isa-section-calldatacopy) Copy calldata into memory { `M[dstOffset:dstOffset+copySize] = context.environment.calldata[cdOffset:cdOffset+copySize]` } - 0x21 [`L1GASLEFT`](#isa-section-l1gasleft) + 0x20 [`L1GASLEFT`](#isa-section-l1gasleft) Remaining "L1 gas" for this call (after this instruction) { `M[dstOffset] = context.machineState.l1GasLeft` } - 0x22 [`L2GASLEFT`](#isa-section-l2gasleft) + 0x21 [`L2GASLEFT`](#isa-section-l2gasleft) Remaining "L2 gas" for this call (after this instruction) { `M[dstOffset] = context.MachineState.l2GasLeft` } - 0x23 [`DAGASLEFT`](#isa-section-dagasleft) + 0x22 [`DAGASLEFT`](#isa-section-dagasleft) Remaining "DA gas" for this call (after this instruction) { `M[dstOffset] = context.machineState.daGasLeft` } - 0x24 [`JUMP`](#isa-section-jump) + 0x23 [`JUMP`](#isa-section-jump) Jump to a location in the bytecode { `context.machineState.pc = loc` } - 0x25 [`JUMPI`](#isa-section-jumpi) + 0x24 [`JUMPI`](#isa-section-jumpi) Conditionally jump to a location in the bytecode { `context.machineState.pc = M[condOffset] > 0 ? loc : context.machineState.pc` } - 0x26 [`INTERNALCALL`](#isa-section-internalcall) + 0x25 [`INTERNALCALL`](#isa-section-internalcall) Make an internal call. Push the current PC to the internal call stack and jump to the target location. {`context.machineState.internalCallStack.push(context.machineState.pc) @@ -288,49 +281,49 @@ context.machineState.pc = loc`} - 0x27 [`INTERNALRETURN`](#isa-section-internalreturn) + 0x26 [`INTERNALRETURN`](#isa-section-internalreturn) Return from an internal call. Pop from the internal call stack and jump to the popped location. { `context.machineState.pc = context.machineState.internalCallStack.pop()` } - 0x28 [`SET`](#isa-section-set) + 0x27 [`SET`](#isa-section-set) Set a memory word from a constant in the bytecode { `M[dstOffset] = const` } - 0x29 [`MOV`](#isa-section-mov) + 0x28 [`MOV`](#isa-section-mov) Move a word from source memory location to destination { `M[dstOffset] = M[srcOffset]` } - 0x2a [`CMOV`](#isa-section-cmov) + 0x29 [`CMOV`](#isa-section-cmov) Move a word (conditionally chosen) from one memory location to another (`d = cond > 0 ? a : b`) { `M[dstOffset] = M[condOffset] > 0 ? M[aOffset] : M[bOffset]` } - 0x2b [`SLOAD`](#isa-section-sload) + 0x2a [`SLOAD`](#isa-section-sload) Load a word from this contract's persistent public storage. Zero is loaded for unwritten slots. {`M[dstOffset] = S[M[slotOffset]]`} - 0x2c [`SSTORE`](#isa-section-sstore) + 0x2b [`SSTORE`](#isa-section-sstore) Write a word to this contract's persistent public storage {`S[M[slotOffset]] = M[srcOffset]`} - 0x2d [`NOTEHASHEXISTS`](#isa-section-notehashexists) + 0x2c [`NOTEHASHEXISTS`](#isa-section-notehashexists) Check whether a note hash exists in the note hash tree (as of the start of the current block) {`exists = context.worldState.noteHashes.has({ @@ -341,7 +334,7 @@ M[existsOffset] = exists`} - 0x2e [`EMITNOTEHASH`](#isa-section-emitnotehash) + 0x2d [`EMITNOTEHASH`](#isa-section-emitnotehash) Emit a new note hash to be inserted into the note hash tree {`context.worldState.noteHashes.append( @@ -350,7 +343,7 @@ M[existsOffset] = exists`} - 0x2f [`NULLIFIEREXISTS`](#isa-section-nullifierexists) + 0x2e [`NULLIFIEREXISTS`](#isa-section-nullifierexists) Check whether a nullifier exists in the nullifier tree (including nullifiers from earlier in the current transaction or from earlier in the current block) {`exists = pendingNullifiers.has(M[addressOffset], M[nullifierOffset]) || context.worldState.nullifiers.has( @@ -360,7 +353,7 @@ M[existsOffset] = exists`} - 0x30 [`EMITNULLIFIER`](#isa-section-emitnullifier) + 0x2f [`EMITNULLIFIER`](#isa-section-emitnullifier) Emit a new nullifier to be inserted into the nullifier tree {`context.worldState.nullifiers.append( @@ -369,7 +362,7 @@ M[existsOffset] = exists`} - 0x31 [`L1TOL2MSGEXISTS`](#isa-section-l1tol2msgexists) + 0x30 [`L1TOL2MSGEXISTS`](#isa-section-l1tol2msgexists) Check if a message exists in the L1-to-L2 message tree {`exists = context.worldState.l1ToL2Messages.has({ @@ -379,7 +372,7 @@ M[existsOffset] = exists`} - 0x32 [`HEADERMEMBER`](#isa-section-headermember) + 0x31 [`HEADERMEMBER`](#isa-section-headermember) Check if a header exists in the [archive tree](../state/archive) and retrieve the specified member if so {`exists = context.worldState.header.has({ @@ -392,7 +385,7 @@ if exists: - 0x33 [`GETCONTRACTINSTANCE`](#isa-section-getcontractinstance) + 0x32 [`GETCONTRACTINSTANCE`](#isa-section-getcontractinstance) Copies contract instance data to memory {`M[dstOffset:dstOffset+CONTRACT_INSTANCE_SIZE+1] = [ @@ -407,7 +400,7 @@ if exists: - 0x34 [`EMITUNENCRYPTEDLOG`](#isa-section-emitunencryptedlog) + 0x33 [`EMITUNENCRYPTEDLOG`](#isa-section-emitunencryptedlog) Emit an unencrypted log {`context.accruedSubstate.unencryptedLogs.append( @@ -420,7 +413,7 @@ if exists: - 0x35 [`SENDL2TOL1MSG`](#isa-section-sendl2tol1msg) + 0x34 [`SENDL2TOL1MSG`](#isa-section-sendl2tol1msg) Send an L2-to-L1 message {`context.accruedSubstate.sentL2ToL1Messages.append( @@ -433,7 +426,7 @@ if exists: - 0x36 [`CALL`](#isa-section-call) + 0x35 [`CALL`](#isa-section-call) Call into another contract {`// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } @@ -448,7 +441,7 @@ updateContextAfterNestedCall(context, instr.args, nestedContext)`} - 0x37 [`STATICCALL`](#isa-section-staticcall) + 0x36 [`STATICCALL`](#isa-section-staticcall) Call into another contract, disallowing World State and Accrued Substate modifications {`// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } @@ -463,7 +456,7 @@ updateContextAfterNestedCall(context, instr.args, nestedContext)`} - 0x38 [`DELEGATECALL`](#isa-section-delegatecall) + 0x37 [`DELEGATECALL`](#isa-section-delegatecall) Call into another contract, but keep the caller's `sender` and `storageAddress` {`// instr.args are { gasOffset, addrOffset, argsOffset, retOffset, retSize } @@ -478,7 +471,7 @@ updateContextAfterNestedCall(context, instr.args, nestedContext)`} - 0x39 [`RETURN`](#isa-section-return) + 0x38 [`RETURN`](#isa-section-return) Halt execution within this context (without revert), optionally returning some data {`context.contractCallResults.output = M[retOffset:retOffset+retSize] @@ -486,7 +479,7 @@ halt`} - 0x3a [`REVERT`](#isa-section-revert) + 0x39 [`REVERT`](#isa-section-revert) Halt execution within this context as `reverted`, optionally returning some data {`context.contractCallResults.output = M[retOffset:retOffset+retSize] @@ -849,29 +842,12 @@ Get the _storage_ address of the currently executing context [![](/img/protocol-specs/public-vm/bit-formats/STORAGEADDRESS.png)](/img/protocol-specs/public-vm/bit-formats/STORAGEADDRESS.png) -### `ORIGIN` -Get the transaction's origination address - -[See in table.](#isa-table-origin) - -- **Opcode**: 0x11 -- **Category**: Execution Environment -- **Flags**: - - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. -- **Args**: - - **dstOffset**: memory offset specifying where to store operation's result -- **Expression**: `M[dstOffset] = context.environment.origin` -- **Tag updates**: `T[dstOffset] = u32` -- **Bit-size**: 56 - -[![](/img/protocol-specs/public-vm/bit-formats/ORIGIN.png)](/img/protocol-specs/public-vm/bit-formats/ORIGIN.png) - ### `SENDER` Get the address of the sender (caller of the current context) [See in table.](#isa-table-sender) -- **Opcode**: 0x12 +- **Opcode**: 0x11 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -888,7 +864,7 @@ Get the address of the l1 portal contract [See in table.](#isa-table-portal) -- **Opcode**: 0x13 +- **Opcode**: 0x12 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -905,7 +881,7 @@ Get the fee to be paid per "L1 gas" - constant for entire transaction [See in table.](#isa-table-feeperl1gas) -- **Opcode**: 0x14 +- **Opcode**: 0x13 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -922,7 +898,7 @@ Get the fee to be paid per "L2 gas" - constant for entire transaction [See in table.](#isa-table-feeperl2gas) -- **Opcode**: 0x15 +- **Opcode**: 0x14 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -939,7 +915,7 @@ Get the fee to be paid per "DA gas" - constant for entire transaction [See in table.](#isa-table-feeperdagas) -- **Opcode**: 0x16 +- **Opcode**: 0x15 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -956,7 +932,7 @@ Get how many contract calls deep the current call context is [See in table.](#isa-table-contractcalldepth) -- **Opcode**: 0x17 +- **Opcode**: 0x16 - **Category**: Execution Environment - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -974,7 +950,7 @@ Get this rollup's L1 chain ID [See in table.](#isa-table-chainid) -- **Opcode**: 0x18 +- **Opcode**: 0x17 - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -991,7 +967,7 @@ Get this rollup's L2 version ID [See in table.](#isa-table-version) -- **Opcode**: 0x19 +- **Opcode**: 0x18 - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1008,7 +984,7 @@ Get this L2 block's number [See in table.](#isa-table-blocknumber) -- **Opcode**: 0x1a +- **Opcode**: 0x19 - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1025,7 +1001,7 @@ Get this L2 block's timestamp [See in table.](#isa-table-timestamp) -- **Opcode**: 0x1b +- **Opcode**: 0x1a - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1042,7 +1018,7 @@ Get the block's beneficiary address [See in table.](#isa-table-coinbase) -- **Opcode**: 0x1c +- **Opcode**: 0x1b - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1059,7 +1035,7 @@ Total amount of "L1 gas" that a block can consume [See in table.](#isa-table-blockl1gaslimit) -- **Opcode**: 0x1d +- **Opcode**: 0x1c - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1076,7 +1052,7 @@ Total amount of "L2 gas" that a block can consume [See in table.](#isa-table-blockl2gaslimit) -- **Opcode**: 0x1e +- **Opcode**: 0x1d - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1093,7 +1069,7 @@ Total amount of "DA gas" that a block can consume [See in table.](#isa-table-blockdagaslimit) -- **Opcode**: 0x1f +- **Opcode**: 0x1e - **Category**: Execution Environment - Globals - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1110,7 +1086,7 @@ Copy calldata into memory [See in table.](#isa-table-calldatacopy) -- **Opcode**: 0x20 +- **Opcode**: 0x1f - **Category**: Execution Environment - Calldata - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1130,7 +1106,7 @@ Remaining "L1 gas" for this call (after this instruction) [See in table.](#isa-table-l1gasleft) -- **Opcode**: 0x21 +- **Opcode**: 0x20 - **Category**: Machine State - Gas - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1147,7 +1123,7 @@ Remaining "L2 gas" for this call (after this instruction) [See in table.](#isa-table-l2gasleft) -- **Opcode**: 0x22 +- **Opcode**: 0x21 - **Category**: Machine State - Gas - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1164,7 +1140,7 @@ Remaining "DA gas" for this call (after this instruction) [See in table.](#isa-table-dagasleft) -- **Opcode**: 0x23 +- **Opcode**: 0x22 - **Category**: Machine State - Gas - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1181,7 +1157,7 @@ Jump to a location in the bytecode [See in table.](#isa-table-jump) -- **Opcode**: 0x24 +- **Opcode**: 0x23 - **Category**: Machine State - Control Flow - **Args**: - **loc**: target location to jump to @@ -1196,7 +1172,7 @@ Conditionally jump to a location in the bytecode [See in table.](#isa-table-jumpi) -- **Opcode**: 0x25 +- **Opcode**: 0x24 - **Category**: Machine State - Control Flow - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1214,7 +1190,7 @@ Make an internal call. Push the current PC to the internal call stack and jump t [See in table.](#isa-table-internalcall) -- **Opcode**: 0x26 +- **Opcode**: 0x25 - **Category**: Machine State - Control Flow - **Args**: - **loc**: target location to jump/call to @@ -1232,7 +1208,7 @@ Return from an internal call. Pop from the internal call stack and jump to the p [See in table.](#isa-table-internalreturn) -- **Opcode**: 0x27 +- **Opcode**: 0x26 - **Category**: Machine State - Control Flow - **Expression**: `context.machineState.pc = context.machineState.internalCallStack.pop()` - **Bit-size**: 16 @@ -1244,7 +1220,7 @@ Set a memory word from a constant in the bytecode [See in table.](#isa-table-set) -- **Opcode**: 0x28 +- **Opcode**: 0x27 - **Category**: Machine State - Memory - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1264,7 +1240,7 @@ Move a word from source memory location to destination [See in table.](#isa-table-mov) -- **Opcode**: 0x29 +- **Opcode**: 0x28 - **Category**: Machine State - Memory - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1282,7 +1258,7 @@ Move a word (conditionally chosen) from one memory location to another (`d = con [See in table.](#isa-table-cmov) -- **Opcode**: 0x2a +- **Opcode**: 0x29 - **Category**: Machine State - Memory - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1303,7 +1279,7 @@ Load a word from this contract's persistent public storage. Zero is loaded for u [See in table.](#isa-table-sload) -- **Opcode**: 0x2b +- **Opcode**: 0x2a - **Category**: World State - Public Storage - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1348,7 +1324,7 @@ Write a word to this contract's persistent public storage [See in table.](#isa-table-sstore) -- **Opcode**: 0x2c +- **Opcode**: 0x2b - **Category**: World State - Public Storage - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1388,7 +1364,7 @@ Check whether a note hash exists in the note hash tree (as of the start of the c [See in table.](#isa-table-notehashexists) -- **Opcode**: 0x2d +- **Opcode**: 0x2c - **Category**: World State - Notes & Nullifiers - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1426,7 +1402,7 @@ Emit a new note hash to be inserted into the note hash tree [See in table.](#isa-table-emitnotehash) -- **Opcode**: 0x2e +- **Opcode**: 0x2d - **Category**: World State - Notes & Nullifiers - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1458,7 +1434,7 @@ Check whether a nullifier exists in the nullifier tree (including nullifiers fro [See in table.](#isa-table-nullifierexists) -- **Opcode**: 0x2f +- **Opcode**: 0x2e - **Category**: World State - Notes & Nullifiers - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1495,7 +1471,7 @@ Emit a new nullifier to be inserted into the nullifier tree [See in table.](#isa-table-emitnullifier) -- **Opcode**: 0x30 +- **Opcode**: 0x2f - **Category**: World State - Notes & Nullifiers - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1527,7 +1503,7 @@ Check if a message exists in the L1-to-L2 message tree [See in table.](#isa-table-l1tol2msgexists) -- **Opcode**: 0x31 +- **Opcode**: 0x30 - **Category**: World State - Messaging - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1566,7 +1542,7 @@ Check if a header exists in the [archive tree](../state/archive) and retrieve th [See in table.](#isa-table-headermember) -- **Opcode**: 0x32 +- **Opcode**: 0x31 - **Category**: World State - Archive Tree & Headers - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1609,7 +1585,7 @@ Copies contract instance data to memory [See in table.](#isa-table-getcontractinstance) -- **Opcode**: 0x33 +- **Opcode**: 0x32 - **Category**: Other - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1639,7 +1615,7 @@ Emit an unencrypted log [See in table.](#isa-table-emitunencryptedlog) -- **Opcode**: 0x34 +- **Opcode**: 0x33 - **Category**: Accrued Substate - Logging - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1666,7 +1642,7 @@ Send an L2-to-L1 message [See in table.](#isa-table-sendl2tol1msg) -- **Opcode**: 0x35 +- **Opcode**: 0x34 - **Category**: Accrued Substate - Messaging - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1692,7 +1668,7 @@ Call into another contract [See in table.](#isa-table-call) -- **Opcode**: 0x36 +- **Opcode**: 0x35 - **Category**: Control Flow - Contract Calls - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1740,7 +1716,7 @@ Call into another contract, disallowing World State and Accrued Substate modific [See in table.](#isa-table-staticcall) -- **Opcode**: 0x37 +- **Opcode**: 0x36 - **Category**: Control Flow - Contract Calls - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1785,7 +1761,7 @@ Call into another contract, but keep the caller's `sender` and `storageAddress` [See in table.](#isa-table-delegatecall) -- **Opcode**: 0x38 +- **Opcode**: 0x37 - **Category**: Control Flow - Contract Calls - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1830,7 +1806,7 @@ Halt execution within this context (without revert), optionally returning some d [See in table.](#isa-table-return) -- **Opcode**: 0x39 +- **Opcode**: 0x38 - **Category**: Control Flow - Contract Calls - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. @@ -1852,7 +1828,7 @@ Halt execution within this context as `reverted`, optionally returning some data [See in table.](#isa-table-revert) -- **Opcode**: 0x3a +- **Opcode**: 0x39 - **Category**: Control Flow - Contract Calls - **Flags**: - **indirect**: Toggles whether each memory-offset argument is an indirect offset. Rightmost bit corresponds to 0th offset arg, etc. Indirect offsets result in memory accesses like `M[M[offset]]` instead of the more standard `M[offset]`. diff --git a/docs/src/preprocess/InstructionSet/InstructionSet.js b/docs/src/preprocess/InstructionSet/InstructionSet.js index c6c3721963d..496b2a8128d 100644 --- a/docs/src/preprocess/InstructionSet/InstructionSet.js +++ b/docs/src/preprocess/InstructionSet/InstructionSet.js @@ -529,24 +529,6 @@ const INSTRUCTION_SET_RAW = [ "Tag checks": "", "Tag updates": "`T[dstOffset] = u32`", }, - { - id: "origin", - Name: "`ORIGIN`", - Category: "Execution Environment", - Flags: [{ name: "indirect", description: INDIRECT_FLAG_DESCRIPTION }], - Args: [ - { - name: "dstOffset", - description: - "memory offset specifying where to store operation's result", - }, - ], - Expression: "`M[dstOffset] = context.environment.origin`", - Summary: "Get the transaction's origination address", - Details: "", - "Tag checks": "", - "Tag updates": "`T[dstOffset] = u32`", - }, { id: "sender", Name: "`SENDER`", diff --git a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr index 504dec77522..0446511184d 100644 --- a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr @@ -20,9 +20,6 @@ impl AvmContext { AvmContext { inputs } } - pub fn origin(self) -> AztecAddress { - origin() - } pub fn storage_address(self) -> AztecAddress { storage_address() } @@ -235,9 +232,6 @@ fn address() -> AztecAddress {} #[oracle(avmOpcodeStorageAddress)] fn storage_address() -> AztecAddress {} -#[oracle(avmOpcodeOrigin)] -fn origin() -> AztecAddress {} - #[oracle(avmOpcodeSender)] fn sender() -> AztecAddress {} diff --git a/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr index 2989e32a9f6..0102de54324 100644 --- a/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/avm_test_contract/src/main.nr @@ -206,11 +206,6 @@ contract AvmTest { context.msg_sender() } - #[aztec(public-vm)] - fn get_origin() -> pub AztecAddress { - context.origin() - } - #[aztec(public-vm)] fn get_portal() -> pub EthAddress { context.this_portal_address() diff --git a/yarn-project/simulator/src/avm/avm_execution_environment.ts b/yarn-project/simulator/src/avm/avm_execution_environment.ts index a3dbb81f660..def966f15ed 100644 --- a/yarn-project/simulator/src/avm/avm_execution_environment.ts +++ b/yarn-project/simulator/src/avm/avm_execution_environment.ts @@ -23,7 +23,6 @@ export class AvmExecutionEnvironment { constructor( public readonly address: AztecAddress, public readonly storageAddress: AztecAddress, - public readonly origin: AztecAddress, public readonly sender: AztecAddress, public readonly portal: EthAddress, public readonly feePerL1Gas: Fr, @@ -57,7 +56,6 @@ export class AvmExecutionEnvironment { return new AvmExecutionEnvironment( targetAddress, /*storageAddress=*/ targetAddress, - this.origin, this.address, this.portal, this.feePerL1Gas, @@ -83,7 +81,6 @@ export class AvmExecutionEnvironment { return new AvmExecutionEnvironment( address, /*storageAddress=*/ address, - this.origin, this.sender, this.portal, this.feePerL1Gas, @@ -109,7 +106,6 @@ export class AvmExecutionEnvironment { return new AvmExecutionEnvironment( address, this.storageAddress, - this.origin, this.sender, this.portal, this.feePerL1Gas, diff --git a/yarn-project/simulator/src/avm/avm_gas.ts b/yarn-project/simulator/src/avm/avm_gas.ts index 5a80d70baf9..77ee6173996 100644 --- a/yarn-project/simulator/src/avm/avm_gas.ts +++ b/yarn-project/simulator/src/avm/avm_gas.ts @@ -78,7 +78,6 @@ export const GasCosts: Record = { // Execution environment [Opcode.ADDRESS]: TemporaryDefaultGasCost, [Opcode.STORAGEADDRESS]: TemporaryDefaultGasCost, - [Opcode.ORIGIN]: TemporaryDefaultGasCost, [Opcode.SENDER]: TemporaryDefaultGasCost, [Opcode.PORTAL]: TemporaryDefaultGasCost, [Opcode.FEEPERL1GAS]: TemporaryDefaultGasCost, diff --git a/yarn-project/simulator/src/avm/avm_simulator.test.ts b/yarn-project/simulator/src/avm/avm_simulator.test.ts index 58d451ab0b6..051c3432de3 100644 --- a/yarn-project/simulator/src/avm/avm_simulator.test.ts +++ b/yarn-project/simulator/src/avm/avm_simulator.test.ts @@ -201,11 +201,6 @@ describe('AVM simulator: transpiled Noir contracts', () => { await testEnvGetter('sender', sender, 'get_sender'); }); - it('origin', async () => { - const origin = AztecAddress.fromField(new Fr(1)); - await testEnvGetter('origin', origin, 'get_origin'); - }); - it('portal', async () => { const portal = EthAddress.fromField(new Fr(1)); await testEnvGetter('portal', portal, 'get_portal'); diff --git a/yarn-project/simulator/src/avm/fixtures/index.ts b/yarn-project/simulator/src/avm/fixtures/index.ts index c3f775c484d..c03fa818166 100644 --- a/yarn-project/simulator/src/avm/fixtures/index.ts +++ b/yarn-project/simulator/src/avm/fixtures/index.ts @@ -61,7 +61,6 @@ export function initExecutionEnvironment(overrides?: Partial [Cast.opcode, Cast], [Address.opcode, Address], [StorageAddress.opcode, StorageAddress], - [Origin.opcode, Origin], [Sender.opcode, Sender], [Portal.opcode, Portal], [FeePerL1Gas.opcode, FeePerL1Gas], diff --git a/yarn-project/simulator/src/avm/serialization/instruction_serialization.ts b/yarn-project/simulator/src/avm/serialization/instruction_serialization.ts index c2e092e1a5b..6f5bb70eb41 100644 --- a/yarn-project/simulator/src/avm/serialization/instruction_serialization.ts +++ b/yarn-project/simulator/src/avm/serialization/instruction_serialization.ts @@ -3,7 +3,7 @@ import { strict as assert } from 'assert'; import { BufferCursor } from './buffer_cursor.js'; /** - * All AVM opcodes. (Keep in sync with cpp counterpart code avm_opcode.hpp). + * All AVM opcodes. (Keep in sync with cpp counterpart code avm_opcode.hpp and rs in opcodes.rs). * Source: https://yp-aztec.netlify.app/docs/public-vm/instruction-set */ export enum Opcode { @@ -26,7 +26,6 @@ export enum Opcode { // Execution environment ADDRESS, STORAGEADDRESS, - ORIGIN, SENDER, PORTAL, FEEPERL1GAS, diff --git a/yarn-project/simulator/src/public/transitional_adaptors.ts b/yarn-project/simulator/src/public/transitional_adaptors.ts index 00519f933a6..81bd36011e6 100644 --- a/yarn-project/simulator/src/public/transitional_adaptors.ts +++ b/yarn-project/simulator/src/public/transitional_adaptors.ts @@ -41,7 +41,6 @@ export function createAvmExecutionEnvironment( return new AvmExecutionEnvironment( current.contractAddress, current.callContext.storageContractAddress, - current.callContext.msgSender, // TODO: origin is not available current.callContext.msgSender, current.callContext.portalContractAddress, globalVariables.gasFees.feePerL1Gas, From 3f24fc2cdb56eff6da6e47062d2a2a3dc0fa4bd2 Mon Sep 17 00:00:00 2001 From: guipublic <47281315+guipublic@users.noreply.github.com> Date: Tue, 16 Apr 2024 19:38:40 +0200 Subject: [PATCH 36/56] feat!: change backend width to 4 (#5374) This is a breaking change because it will change the acir opcode compiled by Noir. If they are not updated, proving and verification will fail. --------- Co-authored-by: Tom French <15848336+TomAFrench@users.noreply.github.com> --- barretenberg/cpp/src/barretenberg/bb/main.cpp | 2 +- .../dsl/acir_format/acir_format.cpp | 5 +- .../dsl/acir_format/acir_format.hpp | 6 +- .../dsl/acir_format/acir_format.test.cpp | 18 ++-- .../acir_format/acir_to_constraint_buf.hpp | 98 ++++++++++++++++++- .../acir_format/bigint_constraint.test.cpp | 15 ++- .../dsl/acir_format/block_constraint.test.cpp | 3 +- .../dsl/acir_format/ec_operations.test.cpp | 3 +- .../dsl/acir_format/ecdsa_secp256k1.test.cpp | 9 +- .../dsl/acir_format/ecdsa_secp256r1.test.cpp | 12 ++- .../acir_format/poseidon2_constraint.test.cpp | 3 +- .../acir_format/recursion_constraint.test.cpp | 6 +- .../acir_format/sha256_constraint.test.cpp | 3 +- .../backend_interface/src/proof_system.rs | 6 +- .../backend_interface/src/smart_contract.rs | 2 +- .../mock_backend/src/info_cmd.rs | 2 +- yarn-project/circuits.js/src/constants.gen.ts | 2 +- 17 files changed, 158 insertions(+), 37 deletions(-) diff --git a/barretenberg/cpp/src/barretenberg/bb/main.cpp b/barretenberg/cpp/src/barretenberg/bb/main.cpp index 8c1eed36e37..83c019a3401 100644 --- a/barretenberg/cpp/src/barretenberg/bb/main.cpp +++ b/barretenberg/cpp/src/barretenberg/bb/main.cpp @@ -492,7 +492,7 @@ void acvm_info(const std::string& output_path) const char* jsonData = R"({ "language": { "name" : "PLONK-CSAT", - "width" : 3 + "width" : 4 } })"; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.cpp index 3bafc86f92b..5ece3c031d4 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.cpp @@ -13,9 +13,12 @@ template void build_constraints(Builder& builder, AcirFormat const& constraint_system, bool has_valid_witness_assignments) { // Add arithmetic gates - for (const auto& constraint : constraint_system.constraints) { + for (const auto& constraint : constraint_system.poly_triple_constraints) { builder.create_poly_gate(constraint); } + for (const auto& constraint : constraint_system.quad_constraints) { + builder.create_big_mul_gate(constraint); + } // Add logic constraint for (const auto& constraint : constraint_system.logic_constraints) { diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.hpp index c91d98c6fcd..ec82362e2d8 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.hpp @@ -59,7 +59,9 @@ struct AcirFormat { // This could be a large vector so use slab allocator, we don't expect the blackbox implementations to be so large. std::vector, ContainerSlabAllocator>> - constraints; + poly_triple_constraints; + std::vector, ContainerSlabAllocator>> + quad_constraints; std::vector block_constraints; // For serialization, update with any new fields @@ -82,7 +84,7 @@ struct AcirFormat { fixed_base_scalar_mul_constraints, ec_add_constraints, recursion_constraints, - constraints, + poly_triple_constraints, block_constraints, bigint_from_le_bytes_constraints, bigint_to_le_bytes_constraints, diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp index 49af9f200d4..c7d44e31941 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_format.test.cpp @@ -53,7 +53,8 @@ TEST_F(AcirFormatTests, TestASingleConstraintNoPubInputs) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { constraint }, + .poly_triple_constraints = { constraint }, + .quad_constraints = {}, .block_constraints = {}, }; @@ -168,7 +169,8 @@ TEST_F(AcirFormatTests, TestLogicGateFromNoirCircuit) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { expr_a, expr_b, expr_c, expr_d }, + .poly_triple_constraints = { expr_a, expr_b, expr_c, expr_d }, + .quad_constraints = {}, .block_constraints = {} }; uint256_t inverse_of_five = fr(5).invert(); @@ -235,7 +237,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifyPass) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { poly_triple{ + .poly_triple_constraints = { poly_triple{ .a = schnorr_constraint.result, .b = schnorr_constraint.result, .c = schnorr_constraint.result, @@ -245,6 +247,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifyPass) .q_o = 1, .q_c = fr::neg_one(), } }, + .quad_constraints = {}, .block_constraints = {} }; std::string message_string = "tenletters"; @@ -329,7 +332,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifySmallRange) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { poly_triple{ + .poly_triple_constraints = { poly_triple{ .a = schnorr_constraint.result, .b = schnorr_constraint.result, .c = schnorr_constraint.result, @@ -339,6 +342,7 @@ TEST_F(AcirFormatTests, TestSchnorrVerifySmallRange) .q_o = 1, .q_c = fr::neg_one(), } }, + .quad_constraints = {}, .block_constraints = {}, }; @@ -442,7 +446,8 @@ TEST_F(AcirFormatTests, TestVarKeccak) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { dummy }, + .poly_triple_constraints = { dummy }, + .quad_constraints = {}, .block_constraints = {}, }; @@ -488,7 +493,8 @@ TEST_F(AcirFormatTests, TestKeccakPermutation) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {} }; WitnessVector witness{ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_to_constraint_buf.hpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_to_constraint_buf.hpp index 0034d4cae83..778363f3258 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_to_constraint_buf.hpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/acir_to_constraint_buf.hpp @@ -21,7 +21,7 @@ #include namespace acir_format { - +using mul_quad = mul_quad_; /** * @brief Construct a poly_tuple for a standard width-3 arithmetic gate from its acir representation * @@ -90,7 +90,16 @@ poly_triple serialize_arithmetic_gate(Program::Expression const& arg) pt.q_o = selector_value; c_set = true; } else { - throw_or_abort("Cannot assign linear term to a constraint of width 3"); + return poly_triple{ + .a = 0, + .b = 0, + .c = 0, + .q_m = 0, + .q_l = 0, + .q_r = 0, + .q_o = 0, + .q_c = 0, + }; } } @@ -98,10 +107,93 @@ poly_triple serialize_arithmetic_gate(Program::Expression const& arg) pt.q_c = uint256_t(arg.q_c); return pt; } +mul_quad serialize_mul_quad_gate(Program::Expression const& arg) +{ + // TODO(https://github.com/AztecProtocol/barretenberg/issues/816): The initialization of the witness indices a,b,c + // to 0 is implicitly assuming that (builder.zero_idx == 0) which is no longer the case. Now, witness idx 0 in + // general will correspond to some non-zero value and some witnesses which are not explicitly set below will be + // erroneously populated with this value. This does not cause failures however because the corresponding selector + // will indeed be 0 so the gate will be satisfied. Still, its a bad idea to have erroneous wire values + // even if they dont break the relation. They'll still add cost in commitments, for example. + mul_quad quad{ .a = 0, + .b = 0, + .c = 0, + .d = 0, + .mul_scaling = 0, + .a_scaling = 0, + .b_scaling = 0, + .c_scaling = 0, + .d_scaling = 0, + .const_scaling = 0 }; + + // Flags indicating whether each witness index for the present mul_quad has been set + bool a_set = false; + bool b_set = false; + bool c_set = false; + bool d_set = false; + ASSERT(arg.mul_terms.size() <= 1); // We can only accommodate 1 quadratic term + // Note: mul_terms are tuples of the form {selector_value, witness_idx_1, witness_idx_2} + if (!arg.mul_terms.empty()) { + const auto& mul_term = arg.mul_terms[0]; + quad.mul_scaling = uint256_t(std::get<0>(mul_term)); + quad.a = std::get<1>(mul_term).value; + quad.b = std::get<2>(mul_term).value; + a_set = true; + b_set = true; + } + // If necessary, set values for linears terms q_l * w_l, q_r * w_r and q_o * w_o + ASSERT(arg.linear_combinations.size() <= 4); // We can only accommodate 4 linear terms + for (const auto& linear_term : arg.linear_combinations) { + bb::fr selector_value(uint256_t(std::get<0>(linear_term))); + uint32_t witness_idx = std::get<1>(linear_term).value; + + // If the witness index has not yet been set or if the corresponding linear term is active, set the witness + // index and the corresponding selector value. + // TODO(https://github.com/AztecProtocol/barretenberg/issues/816): May need to adjust the quad.a == witness_idx + // check (and the others like it) since we initialize a,b,c with 0 but 0 is a valid witness index once the + // +1 offset is removed from noir. + if (!a_set || quad.a == witness_idx) { + quad.a = witness_idx; + quad.a_scaling = selector_value; + a_set = true; + } else if (!b_set || quad.b == witness_idx) { + quad.b = witness_idx; + quad.b_scaling = selector_value; + b_set = true; + } else if (!c_set || quad.c == witness_idx) { + quad.c = witness_idx; + quad.c_scaling = selector_value; + c_set = true; + } else if (!d_set || quad.d == witness_idx) { + quad.d = witness_idx; + quad.d_scaling = selector_value; + d_set = true; + } else { + throw_or_abort("Cannot assign linear term to a constraint of width 4"); + } + } + + // Set constant value q_c + quad.const_scaling = uint256_t(arg.q_c); + return quad; +} void handle_arithmetic(Program::Opcode::AssertZero const& arg, AcirFormat& af) { - af.constraints.push_back(serialize_arithmetic_gate(arg.value)); + if (arg.value.linear_combinations.size() <= 3) { + poly_triple pt = serialize_arithmetic_gate(arg.value); + // Even if the number of linear terms is less than 3, we might not be able to fit it into a width-3 arithmetic + // gate. This is the case if the linear terms are all disctinct witness from the multiplication term. In that + // case, the serialize_arithmetic_gate() function will return a poly_triple with all 0's, and we use a width-4 + // gate instead. We could probably always use a width-4 gate in fact. + if (pt == poly_triple{ 0, 0, 0, 0, 0, 0, 0, 0 }) { + af.quad_constraints.push_back(serialize_mul_quad_gate(arg.value)); + } else { + af.poly_triple_constraints.push_back(pt); + } + } else { + af.quad_constraints.push_back(serialize_mul_quad_gate(arg.value)); + } } void handle_blackbox_func_call(Program::Opcode::BlackBoxFuncCall const& arg, AcirFormat& af) diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/bigint_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/bigint_constraint.test.cpp index 90d61c52cd5..584f7ef62a5 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/bigint_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/bigint_constraint.test.cpp @@ -190,7 +190,8 @@ TEST_F(BigIntTests, TestBigIntConstraintMultiple) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; apply_constraints(constraint_system, contraints); @@ -257,7 +258,8 @@ TEST_F(BigIntTests, TestBigIntConstraintSimple) .bigint_from_le_bytes_constraints = { from_le_bytes_constraint_bigint1 }, .bigint_to_le_bytes_constraints = { result2_to_le_bytes }, .bigint_operations = { add_constraint }, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; @@ -309,7 +311,8 @@ TEST_F(BigIntTests, TestBigIntConstraintReuse) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; apply_constraints(constraint_system, contraints); @@ -365,7 +368,8 @@ TEST_F(BigIntTests, TestBigIntConstraintReuse2) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; apply_constraints(constraint_system, contraints); @@ -442,7 +446,8 @@ TEST_F(BigIntTests, TestBigIntDIV) .bigint_from_le_bytes_constraints = { from_le_bytes_constraint_bigint1, from_le_bytes_constraint_bigint2 }, .bigint_to_le_bytes_constraints = { result3_to_le_bytes }, .bigint_operations = { div_constraint }, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/block_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/block_constraint.test.cpp index 88d54261ea8..20f9e8072bb 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/block_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/block_constraint.test.cpp @@ -132,7 +132,8 @@ TEST_F(UltraPlonkRAM, TestBlockConstraint) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = { block }, }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ec_operations.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ec_operations.test.cpp index 479d42a2f3c..92c76e3d7a3 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ec_operations.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ec_operations.test.cpp @@ -72,7 +72,8 @@ TEST_F(EcOperations, TestECOperations) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp index 3e686b4f11c..0a11adb97be 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256k1.test.cpp @@ -112,7 +112,8 @@ TEST_F(ECDSASecp256k1, TestECDSAConstraintSucceed) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; @@ -160,7 +161,8 @@ TEST_F(ECDSASecp256k1, TestECDSACompilesForVerifier) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; @@ -203,7 +205,8 @@ TEST_F(ECDSASecp256k1, TestECDSAConstraintFail) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp index 885bbe44f87..6cf542bc2d6 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/ecdsa_secp256r1.test.cpp @@ -146,7 +146,8 @@ TEST(ECDSASecp256r1, test_hardcoded) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; @@ -196,7 +197,8 @@ TEST(ECDSASecp256r1, TestECDSAConstraintSucceed) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; @@ -244,7 +246,8 @@ TEST(ECDSASecp256r1, TestECDSACompilesForVerifier) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; auto builder = create_circuit(constraint_system); @@ -287,7 +290,8 @@ TEST(ECDSASecp256r1, TestECDSAConstraintFail) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {}, }; diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/poseidon2_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/poseidon2_constraint.test.cpp index 7ca36a78414..f509c262782 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/poseidon2_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/poseidon2_constraint.test.cpp @@ -52,7 +52,8 @@ TEST_F(Poseidon2Tests, TestPoseidon2Permutation) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {} }; WitnessVector witness{ diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/recursion_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/recursion_constraint.test.cpp index d35e15768fa..bbf7768abc9 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/recursion_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/recursion_constraint.test.cpp @@ -104,7 +104,8 @@ Builder create_inner_circuit() .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = { expr_a, expr_b, expr_c, expr_d }, + .poly_triple_constraints = { expr_a, expr_b, expr_c, expr_d }, + .quad_constraints = {}, .block_constraints = {} }; uint256_t inverse_of_five = fr(5).invert(); @@ -260,7 +261,8 @@ Builder create_outer_circuit(std::vector& inner_circuits) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {} }; auto outer_circuit = create_circuit(constraint_system, /*size_hint*/ 0, witness); diff --git a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp index 14283314ddb..6266253ee55 100644 --- a/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp +++ b/barretenberg/cpp/src/barretenberg/dsl/acir_format/sha256_constraint.test.cpp @@ -54,7 +54,8 @@ TEST_F(Sha256Tests, TestSha256Compression) .bigint_from_le_bytes_constraints = {}, .bigint_to_le_bytes_constraints = {}, .bigint_operations = {}, - .constraints = {}, + .poly_triple_constraints = {}, + .quad_constraints = {}, .block_constraints = {} }; WitnessVector witness{ 0, diff --git a/noir/noir-repo/tooling/backend_interface/src/proof_system.rs b/noir/noir-repo/tooling/backend_interface/src/proof_system.rs index 3b47a7ced3a..fa1f82a5722 100644 --- a/noir/noir-repo/tooling/backend_interface/src/proof_system.rs +++ b/noir/noir-repo/tooling/backend_interface/src/proof_system.rs @@ -39,16 +39,16 @@ impl Backend { InfoCommand { crs_path: self.crs_directory() }.run(binary_path) } - /// If we cannot get a valid backend, returns `ExpressionWidth::Bound { width: 3 }`` + /// If we cannot get a valid backend, returns `ExpressionWidth::Bound { width: 4 }`` /// The function also prints a message saying we could not find a backend pub fn get_backend_info_or_default(&self) -> ExpressionWidth { if let Ok(expression_width) = self.get_backend_info() { expression_width } else { warn!( - "No valid backend found, ExpressionWidth defaulting to Bounded with a width of 3" + "No valid backend found, ExpressionWidth defaulting to Bounded with a width of 4" ); - ExpressionWidth::Bounded { width: 3 } + ExpressionWidth::Bounded { width: 4 } } } diff --git a/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs b/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs index e2e5471a671..153ab52c83f 100644 --- a/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs +++ b/noir/noir-repo/tooling/backend_interface/src/smart_contract.rs @@ -51,7 +51,7 @@ mod tests { let circuit = Circuit { current_witness_index: 4, - expression_width: ExpressionWidth::Bounded { width: 3 }, + expression_width: ExpressionWidth::Bounded { width: 4 }, opcodes: vec![constraint], private_parameters: BTreeSet::from([Witness(1), Witness(2)]), public_parameters: PublicInputs::default(), diff --git a/noir/noir-repo/tooling/backend_interface/test-binaries/mock_backend/src/info_cmd.rs b/noir/noir-repo/tooling/backend_interface/test-binaries/mock_backend/src/info_cmd.rs index fd8cf602125..75a6d323e7b 100644 --- a/noir/noir-repo/tooling/backend_interface/test-binaries/mock_backend/src/info_cmd.rs +++ b/noir/noir-repo/tooling/backend_interface/test-binaries/mock_backend/src/info_cmd.rs @@ -5,7 +5,7 @@ use std::path::PathBuf; const INFO_RESPONSE: &str = r#"{ "language": { "name": "PLONK-CSAT", - "width": 3 + "width": 4 }, "opcodes_supported": ["arithmetic", "directive", "brillig", "memory_init", "memory_op"], "black_box_functions_supported": [ diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index da04d5fd12c..abea48aef02 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,7 +68,7 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74n; +export const DEPLOYER_CONTRACT_ADDRESS = 0x1d2c645a18ab4d81672dd779bf1ea4fa2c0b4a2f09bf59d3fb4ee408299d00b2n; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; From 0fafaef8eb92ba261c1aefe1daab2539caab0bea Mon Sep 17 00:00:00 2001 From: Santiago Palladino Date: Tue, 16 Apr 2024 15:11:30 -0300 Subject: [PATCH 37/56] chore: No implicit overrides (#5792) Enables the `noImplicitOverride` option in tsconfig and adds all missing override statements. --- .../account_manager/deploy_account_method.ts | 2 +- .../account_manager/deploy_account_sent_tx.ts | 2 +- .../aztec.js/src/contract/deploy_method.ts | 4 +-- .../aztec.js/src/contract/deploy_sent_tx.ts | 2 +- .../aztec.js/src/wallet/account_wallet.ts | 2 +- .../src/logs/l1_note_payload/note.ts | 2 +- yarn-project/end-to-end/src/e2e_fees.test.ts | 4 +-- .../foundation/src/abi/function_selector.ts | 8 ++--- .../foundation/src/aztec-address/index.ts | 12 +++---- .../src/snapshots/indexed_tree_snapshot.ts | 6 ++-- .../standard_indexed_tree.ts | 10 +++--- .../test/standard_indexed_tree_with_append.ts | 2 +- .../src/standard_tree/standard_tree.ts | 2 +- .../src/test/utils/pedersen_with_counter.ts | 2 +- .../src/contract-interface-gen/typescript.ts | 2 +- .../pxe/src/synchronizer/synchronizer.test.ts | 6 ++-- .../src/sequencer/sequencer.test.ts | 4 +-- .../simulator/src/avm/opcodes/arithmetic.ts | 4 +-- .../src/avm/opcodes/external_calls.ts | 2 +- .../simulator/src/avm/opcodes/memory.ts | 6 ++-- .../simulator/src/avm/opcodes/storage.ts | 2 +- .../src/client/client_execution_context.ts | 36 +++++++++++-------- .../simulator/src/client/view_data_oracle.ts | 35 +++++++++--------- .../src/public/app_logic_phase_manager.ts | 12 +++---- .../src/public/public_execution_context.ts | 22 ++++++------ .../src/public/setup_phase_manager.test.ts | 2 +- .../src/public/setup_phase_manager.ts | 12 +++---- .../src/public/tail_phase_manager.ts | 12 +++---- .../src/public/teardown_phase_manager.ts | 12 +++---- yarn-project/tsconfig.json | 3 +- 30 files changed, 121 insertions(+), 111 deletions(-) diff --git a/yarn-project/aztec.js/src/account_manager/deploy_account_method.ts b/yarn-project/aztec.js/src/account_manager/deploy_account_method.ts index 0534790e935..d9ea44b96d8 100644 --- a/yarn-project/aztec.js/src/account_manager/deploy_account_method.ts +++ b/yarn-project/aztec.js/src/account_manager/deploy_account_method.ts @@ -46,7 +46,7 @@ export class DeployAccountMethod extends DeployMethod { : feePaymentNameOrArtifact; } - protected async getInitializeFunctionCalls(options: DeployOptions): Promise { + protected override async getInitializeFunctionCalls(options: DeployOptions): Promise { const exec = await super.getInitializeFunctionCalls(options); if (options.fee && this.#feePaymentArtifact) { diff --git a/yarn-project/aztec.js/src/account_manager/deploy_account_sent_tx.ts b/yarn-project/aztec.js/src/account_manager/deploy_account_sent_tx.ts index ad299a68b5b..e205286e992 100644 --- a/yarn-project/aztec.js/src/account_manager/deploy_account_sent_tx.ts +++ b/yarn-project/aztec.js/src/account_manager/deploy_account_sent_tx.ts @@ -34,7 +34,7 @@ export class DeployAccountSentTx extends SentTx { * @param opts - Options for configuring the waiting for the tx to be mined. * @returns The transaction receipt with the wallet for the deployed account contract. */ - public async wait(opts: WaitOpts = DefaultWaitOpts): Promise { + public override async wait(opts: WaitOpts = DefaultWaitOpts): Promise { const receipt = await super.wait(opts); const wallet = await this.getWalletPromise; await waitForAccountSynch(this.pxe, wallet.getCompleteAddress(), opts); diff --git a/yarn-project/aztec.js/src/contract/deploy_method.ts b/yarn-project/aztec.js/src/contract/deploy_method.ts index 32007df8945..54ef3025e2b 100644 --- a/yarn-project/aztec.js/src/contract/deploy_method.ts +++ b/yarn-project/aztec.js/src/contract/deploy_method.ts @@ -189,7 +189,7 @@ export class DeployMethod extends Bas * @param options - An object containing various deployment options such as portalContract, contractAddressSalt, and from. * @returns A SentTx object that returns the receipt and the deployed contract instance. */ - public send(options: DeployOptions = {}): DeploySentTx { + public override send(options: DeployOptions = {}): DeploySentTx { const txHashPromise = super.send(options).getTxHash(); const instance = this.getInstance(options); this.log.debug( @@ -223,7 +223,7 @@ export class DeployMethod extends Bas * @param options - Deployment options. * @returns The proven tx. */ - public prove(options: DeployOptions): Promise { + public override prove(options: DeployOptions): Promise { return super.prove(options); } diff --git a/yarn-project/aztec.js/src/contract/deploy_sent_tx.ts b/yarn-project/aztec.js/src/contract/deploy_sent_tx.ts index d77150fbe7c..b645d3dc6d2 100644 --- a/yarn-project/aztec.js/src/contract/deploy_sent_tx.ts +++ b/yarn-project/aztec.js/src/contract/deploy_sent_tx.ts @@ -53,7 +53,7 @@ export class DeploySentTx extends SentTx * @param opts - Options for configuring the waiting for the tx to be mined. * @returns The transaction receipt with the deployed contract instance. */ - public async wait(opts?: DeployedWaitOpts): Promise> { + public override async wait(opts?: DeployedWaitOpts): Promise> { const receipt = await super.wait(opts); const contract = await this.getContractObject(opts?.wallet); return { ...receipt, contract }; diff --git a/yarn-project/aztec.js/src/wallet/account_wallet.ts b/yarn-project/aztec.js/src/wallet/account_wallet.ts index 40ac9986477..803d07010eb 100644 --- a/yarn-project/aztec.js/src/wallet/account_wallet.ts +++ b/yarn-project/aztec.js/src/wallet/account_wallet.ts @@ -196,7 +196,7 @@ export class AccountWallet extends BaseWallet { } /** Returns the address of the account that implements this wallet. */ - public getAddress() { + public override getAddress() { return this.getCompleteAddress().address; } diff --git a/yarn-project/circuit-types/src/logs/l1_note_payload/note.ts b/yarn-project/circuit-types/src/logs/l1_note_payload/note.ts index 9a56b904778..9562a277e48 100644 --- a/yarn-project/circuit-types/src/logs/l1_note_payload/note.ts +++ b/yarn-project/circuit-types/src/logs/l1_note_payload/note.ts @@ -39,7 +39,7 @@ export class Note extends Vector { * Returns a hex representation of the note. * @returns A hex string with the vector length as first element. */ - toString() { + override toString() { return '0x' + this.toBuffer().toString('hex'); } diff --git a/yarn-project/end-to-end/src/e2e_fees.test.ts b/yarn-project/end-to-end/src/e2e_fees.test.ts index 5367463c6c7..a13b7830b90 100644 --- a/yarn-project/end-to-end/src/e2e_fees.test.ts +++ b/yarn-project/end-to-end/src/e2e_fees.test.ts @@ -676,7 +676,7 @@ describe('e2e_fees', () => { }); class BuggedSetupFeePaymentMethod extends PublicFeePaymentMethod { - getFunctionCalls(gasSettings: GasSettings): Promise { + override getFunctionCalls(gasSettings: GasSettings): Promise { const maxFee = gasSettings.getFeeLimit(); const nonce = Fr.random(); const messageHash = computeAuthWitMessageHash( @@ -710,7 +710,7 @@ class BuggedSetupFeePaymentMethod extends PublicFeePaymentMethod { } class BuggedTeardownFeePaymentMethod extends PublicFeePaymentMethod { - async getFunctionCalls(gasSettings: GasSettings): Promise { + override async getFunctionCalls(gasSettings: GasSettings): Promise { // authorize the FPC to take the max fee from Alice const nonce = Fr.random(); const maxFee = gasSettings.getFeeLimit(); diff --git a/yarn-project/foundation/src/abi/function_selector.ts b/yarn-project/foundation/src/abi/function_selector.ts index 2002be8f596..d09669d7ce3 100644 --- a/yarn-project/foundation/src/abi/function_selector.ts +++ b/yarn-project/foundation/src/abi/function_selector.ts @@ -21,10 +21,10 @@ export class FunctionSelector extends Selector { * Checks if this function selector is equal to another. * @returns True if the function selectors are equal. */ - equals(fn: { name: string; parameters: ABIParameter[] }): boolean; - equals(otherName: string, otherParams: ABIParameter[]): boolean; - equals(other: FunctionSelector): boolean; - equals( + override equals(fn: { name: string; parameters: ABIParameter[] }): boolean; + override equals(otherName: string, otherParams: ABIParameter[]): boolean; + override equals(other: FunctionSelector): boolean; + override equals( other: FunctionSelector | string | { name: string; parameters: ABIParameter[] }, otherParams?: ABIParameter[], ): boolean { diff --git a/yarn-project/foundation/src/aztec-address/index.ts b/yarn-project/foundation/src/aztec-address/index.ts index e97fb1f1794..53229d1fda7 100644 --- a/yarn-project/foundation/src/aztec-address/index.ts +++ b/yarn-project/foundation/src/aztec-address/index.ts @@ -23,13 +23,13 @@ export class AztecAddress extends Fr { return `AztecAddress<${this.toString()}>`; } - static ZERO = new AztecAddress(Buffer.alloc(32)); + static override ZERO = new AztecAddress(Buffer.alloc(32)); - static zero(): AztecAddress { + static override zero(): AztecAddress { return AztecAddress.ZERO; } - static fromBuffer(buffer: Buffer | BufferReader) { + static override fromBuffer(buffer: Buffer | BufferReader) { return fromBuffer(buffer, AztecAddress); } @@ -46,16 +46,16 @@ export class AztecAddress extends Fr { return AztecAddress.fromField(new Fr(value)); } - static fromString(buf: string) { + static override fromString(buf: string) { const buffer = Buffer.from(buf.replace(/^0x/i, ''), 'hex'); return new AztecAddress(buffer); } - static random() { + static override random() { return new AztecAddress(super.random().toBuffer()); } - toJSON() { + override toJSON() { return { type: 'AztecAddress', value: this.toString(), diff --git a/yarn-project/merkle-tree/src/snapshots/indexed_tree_snapshot.ts b/yarn-project/merkle-tree/src/snapshots/indexed_tree_snapshot.ts index c39108239d9..1d70549450d 100644 --- a/yarn-project/merkle-tree/src/snapshots/indexed_tree_snapshot.ts +++ b/yarn-project/merkle-tree/src/snapshots/indexed_tree_snapshot.ts @@ -23,7 +23,7 @@ export class IndexedTreeSnapshotBuilder return new IndexedTreeSnapshotImpl(this.nodes, this.leaves, root, numLeaves, this.tree, this.leafPreimageBuilder); } - protected handleLeaf(index: bigint, node: Buffer) { + protected override handleLeaf(index: bigint, node: Buffer) { const leafPreimage = this.tree.getLatestLeafPreimageCopy(index, false); if (leafPreimage) { void this.leaves.set(snapshotLeafValue(node, index), leafPreimage.toBuffer()); @@ -44,7 +44,7 @@ class IndexedTreeSnapshotImpl extends BaseFullTreeSnapshot implements In super(db, historicRoot, numLeaves, tree, { fromBuffer: buf => buf }); } - getLeafValue(index: bigint): Buffer | undefined { + override getLeafValue(index: bigint): Buffer | undefined { const leafPreimage = this.getLatestLeafPreimageCopy(index); return leafPreimage?.toBuffer(); } @@ -99,7 +99,7 @@ class IndexedTreeSnapshotImpl extends BaseFullTreeSnapshot implements In return { index: BigInt(minIndex), alreadyPresent: false }; } - findLeafIndex(value: Buffer): bigint | undefined { + override findLeafIndex(value: Buffer): bigint | undefined { const index = this.tree.findLeafIndex(value, false); if (index !== undefined && index < this.getNumLeaves()) { return index; diff --git a/yarn-project/merkle-tree/src/standard_indexed_tree/standard_indexed_tree.ts b/yarn-project/merkle-tree/src/standard_indexed_tree/standard_indexed_tree.ts index 75fb3a14a63..06d6d91f6c8 100644 --- a/yarn-project/merkle-tree/src/standard_indexed_tree/standard_indexed_tree.ts +++ b/yarn-project/merkle-tree/src/standard_indexed_tree/standard_indexed_tree.ts @@ -92,7 +92,7 @@ export class StandardIndexedTree extends TreeBase implements IndexedTree * @returns Empty promise. * @remarks Use batchInsert method instead. */ - appendLeaves(_leaves: Buffer[]): Promise { + override appendLeaves(_leaves: Buffer[]): Promise { throw new Error('Not implemented'); } @@ -100,7 +100,7 @@ export class StandardIndexedTree extends TreeBase implements IndexedTree * Commits the changes to the database. * @returns Empty promise. */ - public async commit(): Promise { + public override async commit(): Promise { await super.commit(); await this.commitLeaves(); } @@ -109,7 +109,7 @@ export class StandardIndexedTree extends TreeBase implements IndexedTree * Rolls back the not-yet-committed changes. * @returns Empty promise. */ - public async rollback(): Promise { + public override async rollback(): Promise { await super.rollback(); this.clearCachedLeaves(); } @@ -120,7 +120,7 @@ export class StandardIndexedTree extends TreeBase implements IndexedTree * @param includeUncommitted - Indicates whether to include uncommitted leaves in the computation. * @returns The value of the leaf at the given index or undefined if the leaf is empty. */ - public getLeafValue(index: bigint, includeUncommitted: boolean): Buffer | undefined { + public override getLeafValue(index: bigint, includeUncommitted: boolean): Buffer | undefined { const preimage = this.getLatestLeafPreimageCopy(index, includeUncommitted); return preimage && preimage.toBuffer(); } @@ -262,7 +262,7 @@ export class StandardIndexedTree extends TreeBase implements IndexedTree * 1024 leaves for the first block, because there's only neat space for 1023 leaves after 0. By padding with 1023 * more leaves, we can then insert the first block of 1024 leaves into indices 1024:2047. */ - public async init(prefilledSize: number): Promise { + public override async init(prefilledSize: number): Promise { if (prefilledSize < 1) { throw new Error(`Prefilled size must be at least 1!`); } diff --git a/yarn-project/merkle-tree/src/standard_indexed_tree/test/standard_indexed_tree_with_append.ts b/yarn-project/merkle-tree/src/standard_indexed_tree/test/standard_indexed_tree_with_append.ts index a772f1fc5fb..0816f59edc5 100644 --- a/yarn-project/merkle-tree/src/standard_indexed_tree/test/standard_indexed_tree_with_append.ts +++ b/yarn-project/merkle-tree/src/standard_indexed_tree/test/standard_indexed_tree_with_append.ts @@ -12,7 +12,7 @@ export class StandardIndexedTreeWithAppend extends StandardIndexedTree { * @returns Empty promise. * @remarks This method is inefficient and is here mostly for testing. Use batchInsert instead. */ - public appendLeaves(leaves: Buffer[]): Promise { + public override appendLeaves(leaves: Buffer[]): Promise { for (const leaf of leaves) { this.appendLeaf(leaf); } diff --git a/yarn-project/merkle-tree/src/standard_tree/standard_tree.ts b/yarn-project/merkle-tree/src/standard_tree/standard_tree.ts index ceb210e7094..27ce349a484 100644 --- a/yarn-project/merkle-tree/src/standard_tree/standard_tree.ts +++ b/yarn-project/merkle-tree/src/standard_tree/standard_tree.ts @@ -18,7 +18,7 @@ export class StandardTree extends TreeBase imp * @param leaves - The leaves to append. * @returns Empty promise. */ - public appendLeaves(leaves: T[]): Promise { + public override appendLeaves(leaves: T[]): Promise { this.hasher.reset(); const timer = new Timer(); super.appendLeaves(leaves); diff --git a/yarn-project/merkle-tree/src/test/utils/pedersen_with_counter.ts b/yarn-project/merkle-tree/src/test/utils/pedersen_with_counter.ts index ff87702c817..f5ab9af885a 100644 --- a/yarn-project/merkle-tree/src/test/utils/pedersen_with_counter.ts +++ b/yarn-project/merkle-tree/src/test/utils/pedersen_with_counter.ts @@ -19,7 +19,7 @@ export class PedersenWithCounter extends Pedersen { * @deprecated Don't call pedersen directly in production code. Instead, create suitably-named functions for specific * purposes. */ - public hash(lhs: Uint8Array, rhs: Uint8Array): Buffer { + public override hash(lhs: Uint8Array, rhs: Uint8Array): Buffer { this.hashCounter++; return super.hash(lhs, rhs); } diff --git a/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts b/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts index da5e9cd6e8f..0ade1726ec8 100644 --- a/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts +++ b/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts @@ -312,7 +312,7 @@ export class ${input.name}Contract extends ContractBase { ${notesGetter} /** Type-safe wrappers for the public methods exposed by the contract. */ - public methods!: { + public override methods!: { ${methods.join('\n')} }; } diff --git a/yarn-project/pxe/src/synchronizer/synchronizer.test.ts b/yarn-project/pxe/src/synchronizer/synchronizer.test.ts index 81f079c6b7e..79fa9b9bd19 100644 --- a/yarn-project/pxe/src/synchronizer/synchronizer.test.ts +++ b/yarn-project/pxe/src/synchronizer/synchronizer.test.ts @@ -158,15 +158,15 @@ describe('Synchronizer', () => { }); class TestSynchronizer extends Synchronizer { - public work(limit = 1) { + public override work(limit = 1) { return super.work(limit); } - public initialSync(): Promise { + public override initialSync(): Promise { return super.initialSync(); } - public workNoteProcessorCatchUp(limit = 1): Promise { + public override workNoteProcessorCatchUp(limit = 1): Promise { return super.workNoteProcessorCatchUp(limit); } } diff --git a/yarn-project/sequencer-client/src/sequencer/sequencer.test.ts b/yarn-project/sequencer-client/src/sequencer/sequencer.test.ts index 72af68c53fc..38e0379fbab 100644 --- a/yarn-project/sequencer-client/src/sequencer/sequencer.test.ts +++ b/yarn-project/sequencer-client/src/sequencer/sequencer.test.ts @@ -270,11 +270,11 @@ describe('sequencer', () => { }); class TestSubject extends Sequencer { - public work() { + public override work() { return super.work(); } - public initialSync(): Promise { + public override initialSync(): Promise { return super.initialSync(); } } diff --git a/yarn-project/simulator/src/avm/opcodes/arithmetic.ts b/yarn-project/simulator/src/avm/opcodes/arithmetic.ts index 137b92ab878..e55ba9fb1e5 100644 --- a/yarn-project/simulator/src/avm/opcodes/arithmetic.ts +++ b/yarn-project/simulator/src/avm/opcodes/arithmetic.ts @@ -23,7 +23,7 @@ export abstract class ThreeOperandArithmeticInstruction extends ThreeOperandInst context.machineState.incrementPc(); } - protected gasCost(memoryOps: Partial) { + protected override gasCost(memoryOps: Partial) { const baseGasCost = getGasCostForTypeTag(this.inTag, getBaseGasCost(this.opcode)); const memoryGasCost = getMemoryGasCost(memoryOps); return sumGas(baseGasCost, memoryGasCost); @@ -102,7 +102,7 @@ export class FieldDiv extends Instruction { context.machineState.incrementPc(); } - protected gasCost(memoryOps: Partial) { + protected override gasCost(memoryOps: Partial) { const baseGasCost = getGasCostForTypeTag(TypeTag.FIELD, getBaseGasCost(this.opcode)); const memoryGasCost = getMemoryGasCost(memoryOps); return sumGas(baseGasCost, memoryGasCost); diff --git a/yarn-project/simulator/src/avm/opcodes/external_calls.ts b/yarn-project/simulator/src/avm/opcodes/external_calls.ts index fd54c6dbfe6..f3f982f792f 100644 --- a/yarn-project/simulator/src/avm/opcodes/external_calls.ts +++ b/yarn-project/simulator/src/avm/opcodes/external_calls.ts @@ -122,7 +122,7 @@ abstract class ExternalCall extends Instruction { context.machineState.incrementPc(); } - public abstract get type(): 'CALL' | 'STATICCALL'; + public abstract override get type(): 'CALL' | 'STATICCALL'; } export class Call extends ExternalCall { diff --git a/yarn-project/simulator/src/avm/opcodes/memory.ts b/yarn-project/simulator/src/avm/opcodes/memory.ts index 81eb5fd8ea7..770f4da5b3a 100644 --- a/yarn-project/simulator/src/avm/opcodes/memory.ts +++ b/yarn-project/simulator/src/avm/opcodes/memory.ts @@ -46,7 +46,7 @@ export class Set extends Instruction { } /** We need to use a custom serialize function because of the variable length of the value. */ - public serialize(): Buffer { + public override serialize(): Buffer { const format: OperandType[] = [ ...Set.wireFormatBeforeConst, getOperandTypeFromInTag(this.inTag), @@ -56,7 +56,7 @@ export class Set extends Instruction { } /** We need to use a custom deserialize function because of the variable length of the value. */ - public static deserialize(this: typeof Set, buf: BufferCursor | Buffer): Set { + public static override deserialize(this: typeof Set, buf: BufferCursor | Buffer): Set { if (buf instanceof Buffer) { buf = new BufferCursor(buf); } @@ -217,7 +217,7 @@ export class CalldataCopy extends Instruction { context.machineState.incrementPc(); } - protected gasCost(memoryOps: Partial = {}) { + protected override gasCost(memoryOps: Partial = {}) { const baseGasCost = mulGas(getBaseGasCost(this.opcode), this.copySize); const memoryGasCost = getMemoryGasCost(memoryOps); return sumGas(baseGasCost, memoryGasCost); diff --git a/yarn-project/simulator/src/avm/opcodes/storage.ts b/yarn-project/simulator/src/avm/opcodes/storage.ts index c72541c0572..62c3d180b0f 100644 --- a/yarn-project/simulator/src/avm/opcodes/storage.ts +++ b/yarn-project/simulator/src/avm/opcodes/storage.ts @@ -27,7 +27,7 @@ abstract class BaseStorageInstruction extends Instruction { super(); } - protected gasCost(memoryOps: Partial): Gas { + protected override gasCost(memoryOps: Partial): Gas { const baseGasCost = mulGas(getBaseGasCost(this.opcode), this.size); const memoryGasCost = getMemoryGasCost(memoryOps); return sumGas(baseGasCost, memoryGasCost); diff --git a/yarn-project/simulator/src/client/client_execution_context.ts b/yarn-project/simulator/src/client/client_execution_context.ts index 56141cf9c7e..0c045247407 100644 --- a/yarn-project/simulator/src/client/client_execution_context.ts +++ b/yarn-project/simulator/src/client/client_execution_context.ts @@ -64,21 +64,21 @@ export class ClientExecutionContext extends ViewDataOracle { private enqueuedPublicFunctionCalls: PublicCallRequest[] = []; constructor( - protected readonly contractAddress: AztecAddress, + contractAddress: AztecAddress, private readonly argsHash: Fr, private readonly txContext: TxContext, private readonly callContext: CallContext, /** Header of a block whose state is used during private execution (not the block the transaction is included in). */ protected readonly historicalHeader: Header, /** List of transient auth witnesses to be used during this simulation */ - protected readonly authWitnesses: AuthWitness[], + authWitnesses: AuthWitness[], private readonly packedValuesCache: PackedValuesCache, private readonly noteCache: ExecutionNoteCache, - protected readonly db: DBOracle, + db: DBOracle, private readonly curve: Grumpkin, private node: AztecNode, protected sideEffectCounter: number = 0, - protected log = createDebugLogger('aztec:simulator:client_execution_context'), + log = createDebugLogger('aztec:simulator:client_execution_context'), ) { super(contractAddress, authWitnesses, db, node, log); } @@ -174,7 +174,7 @@ export class ClientExecutionContext extends ViewDataOracle { * Pack the given arguments. * @param args - Arguments to pack */ - public packArguments(args: Fr[]): Promise { + public override packArguments(args: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(args)); } @@ -182,7 +182,7 @@ export class ClientExecutionContext extends ViewDataOracle { * Pack the given returns. * @param returns - Returns to pack */ - public packReturns(returns: Fr[]): Promise { + public override packReturns(returns: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(returns)); } @@ -190,7 +190,7 @@ export class ClientExecutionContext extends ViewDataOracle { * Unpack the given returns. * @param returnsHash - Returns hash to unpack */ - public unpackReturns(returnsHash: Fr): Promise { + public override unpackReturns(returnsHash: Fr): Promise { return Promise.resolve(this.packedValuesCache.unpack(returnsHash)); } @@ -214,7 +214,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param status - The status of notes to fetch. * @returns Array of note data. */ - public async getNotes( + public override async getNotes( storageSlot: Fr, numSelects: number, selectByIndexes: number[], @@ -281,7 +281,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param innerNoteHash - The inner note hash of the new note. * @returns */ - public notifyCreatedNote(storageSlot: Fr, noteTypeId: Fr, noteItems: Fr[], innerNoteHash: Fr) { + public override notifyCreatedNote(storageSlot: Fr, noteTypeId: Fr, noteItems: Fr[], innerNoteHash: Fr) { const note = new Note(noteItems); this.noteCache.addNewNote({ contractAddress: this.callContext.storageContractAddress, @@ -304,7 +304,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address). * @param innerNoteHash - The inner note hash of the new note. */ - public notifyNullifiedNote(innerNullifier: Fr, innerNoteHash: Fr) { + public override notifyNullifiedNote(innerNullifier: Fr, innerNoteHash: Fr) { this.noteCache.nullifyNote(this.callContext.storageContractAddress, innerNullifier, innerNoteHash); return Promise.resolve(); } @@ -317,7 +317,13 @@ export class ClientExecutionContext extends ViewDataOracle { * @param publicKey - The public key of the account that can decrypt the log. * @param log - The log contents. */ - public emitEncryptedLog(contractAddress: AztecAddress, storageSlot: Fr, noteTypeId: Fr, publicKey: Point, log: Fr[]) { + public override emitEncryptedLog( + contractAddress: AztecAddress, + storageSlot: Fr, + noteTypeId: Fr, + publicKey: Point, + log: Fr[], + ) { const note = new Note(log); const l1NotePayload = new L1NotePayload(note, contractAddress, storageSlot, noteTypeId); const taggedNote = new TaggedNote(l1NotePayload); @@ -329,7 +335,7 @@ export class ClientExecutionContext extends ViewDataOracle { * Emit an unencrypted log. * @param log - The unencrypted log to be emitted. */ - public emitUnencryptedLog(log: UnencryptedL2Log) { + public override emitUnencryptedLog(log: UnencryptedL2Log) { this.unencryptedLogs.push(log); const text = log.toHumanReadable(); this.log.verbose(`Emitted unencrypted log: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`); @@ -357,7 +363,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param isStaticCall - Whether the call is a delegate call. * @returns The execution result. */ - async callPrivateFunction( + override async callPrivateFunction( targetContractAddress: AztecAddress, functionSelector: FunctionSelector, argsHash: Fr, @@ -426,7 +432,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param isStaticCall - Whether the call is a static call. * @returns The public call stack item with the request information. */ - public async enqueuePublicFunctionCall( + public override async enqueuePublicFunctionCall( targetContractAddress: AztecAddress, functionSelector: FunctionSelector, argsHash: Fr, @@ -502,7 +508,7 @@ export class ClientExecutionContext extends ViewDataOracle { * @param startStorageSlot - The starting storage slot. * @param numberOfElements - Number of elements to read from the starting storage slot. */ - public async storageRead(startStorageSlot: Fr, numberOfElements: number): Promise { + public override async storageRead(startStorageSlot: Fr, numberOfElements: number): Promise { // TODO(#4320): This is a hack to work around not having directly access to the public data tree but // still having access to the witnesses const bn = await this.db.getBlockNumber(); diff --git a/yarn-project/simulator/src/client/view_data_oracle.ts b/yarn-project/simulator/src/client/view_data_oracle.ts index 13f0f929cb3..2a76c346474 100644 --- a/yarn-project/simulator/src/client/view_data_oracle.ts +++ b/yarn-project/simulator/src/client/view_data_oracle.ts @@ -38,7 +38,7 @@ export class ViewDataOracle extends TypedOracle { * Return the nullifier key pair of an account to use in a specific contract. * @param account - The account address of the nullifier key. */ - public getNullifierKeyPair(account: AztecAddress) { + public override getNullifierKeyPair(account: AztecAddress) { return this.db.getNullifierKeyPair(account, this.contractAddress); } @@ -49,7 +49,7 @@ export class ViewDataOracle extends TypedOracle { * @param leafValue - The leaf value * @returns The index and sibling path concatenated [index, sibling_path] */ - public async getMembershipWitness(blockNumber: number, treeId: MerkleTreeId, leafValue: Fr): Promise { + public override async getMembershipWitness(blockNumber: number, treeId: MerkleTreeId, leafValue: Fr): Promise { const index = await this.db.findLeafIndex(blockNumber, treeId, leafValue); if (!index) { throw new Error(`Leaf value: ${leafValue} not found in ${MerkleTreeId[treeId]}`); @@ -65,7 +65,7 @@ export class ViewDataOracle extends TypedOracle { * @param leafIndex - Index of the leaf to get sibling path for * @returns The sibling path. */ - public getSiblingPath(blockNumber: number, treeId: MerkleTreeId, leafIndex: Fr): Promise { + public override getSiblingPath(blockNumber: number, treeId: MerkleTreeId, leafIndex: Fr): Promise { return this.db.getSiblingPath(blockNumber, treeId, leafIndex.toBigInt()); } @@ -75,7 +75,7 @@ export class ViewDataOracle extends TypedOracle { * @param nullifier - Nullifier we try to find witness for. * @returns The nullifier membership witness (if found). */ - public async getNullifierMembershipWitness( + public override async getNullifierMembershipWitness( blockNumber: number, nullifier: Fr, ): Promise { @@ -91,7 +91,7 @@ export class ViewDataOracle extends TypedOracle { * list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier * we are trying to prove non-inclusion for. */ - public async getLowNullifierMembershipWitness( + public override async getLowNullifierMembershipWitness( blockNumber: number, nullifier: Fr, ): Promise { @@ -104,7 +104,10 @@ export class ViewDataOracle extends TypedOracle { * @param leafSlot - The slot of the public data tree to get the witness for. * @returns - The witness */ - public async getPublicDataTreeWitness(blockNumber: number, leafSlot: Fr): Promise { + public override async getPublicDataTreeWitness( + blockNumber: number, + leafSlot: Fr, + ): Promise { return await this.db.getPublicDataTreeWitness(blockNumber, leafSlot); } @@ -113,7 +116,7 @@ export class ViewDataOracle extends TypedOracle { * @param blockNumber - The number of a block of which to get the block header. * @returns Block extracted from a block with block number `blockNumber`. */ - public async getHeader(blockNumber: number): Promise
{ + public override async getHeader(blockNumber: number): Promise
{ const block = await this.db.getBlock(blockNumber); if (!block) { return undefined; @@ -126,7 +129,7 @@ export class ViewDataOracle extends TypedOracle { * @param address - Address to fetch the complete address for. * @returns A complete address associated with the input address. */ - public getCompleteAddress(address: AztecAddress): Promise { + public override getCompleteAddress(address: AztecAddress): Promise { return this.db.getCompleteAddress(address); } @@ -135,7 +138,7 @@ export class ViewDataOracle extends TypedOracle { * @param address - Address. * @returns A contract instance. */ - public getContractInstance(address: AztecAddress): Promise { + public override getContractInstance(address: AztecAddress): Promise { return this.db.getContractInstance(address); } @@ -145,7 +148,7 @@ export class ViewDataOracle extends TypedOracle { * @param messageHash - Hash of the message to authenticate. * @returns Authentication witness for the requested message hash. */ - public getAuthWitness(messageHash: Fr): Promise { + public override getAuthWitness(messageHash: Fr): Promise { return Promise.resolve( this.authWitnesses.find(w => w.requestHash.equals(messageHash))?.witness ?? this.db.getAuthWitness(messageHash), ); @@ -156,7 +159,7 @@ export class ViewDataOracle extends TypedOracle { * @returns The capsule values * @remarks A capsule is a "blob" of data that is passed to the contract through an oracle. */ - public popCapsule(): Promise { + public override popCapsule(): Promise { return this.db.popCapsule(); } @@ -181,7 +184,7 @@ export class ViewDataOracle extends TypedOracle { * @param status - The status of notes to fetch. * @returns Array of note data. */ - public async getNotes( + public override async getNotes( storageSlot: Fr, numSelects: number, selectByIndexes: number[], @@ -218,7 +221,7 @@ export class ViewDataOracle extends TypedOracle { * @param innerNullifier - The inner nullifier. * @returns A boolean indicating whether the nullifier exists in the tree or not. */ - public async checkNullifierExists(innerNullifier: Fr) { + public override async checkNullifierExists(innerNullifier: Fr) { const nullifier = siloNullifier(this.contractAddress, innerNullifier!); const index = await this.db.getNullifierIndex(nullifier); return index !== undefined; @@ -232,7 +235,7 @@ export class ViewDataOracle extends TypedOracle { * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages * @returns The l1 to l2 membership witness (index of message in the tree and sibling path). */ - public async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) { + public override async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) { return await this.db.getL1ToL2MembershipWitness(contractAddress, messageHash, secret); } @@ -242,7 +245,7 @@ export class ViewDataOracle extends TypedOracle { * @param contractAddress - The address of the contract whose portal address is to be fetched. * @returns The portal contract address. */ - public getPortalContractAddress(contractAddress: AztecAddress) { + public override getPortalContractAddress(contractAddress: AztecAddress) { return this.db.getPortalContractAddress(contractAddress); } @@ -251,7 +254,7 @@ export class ViewDataOracle extends TypedOracle { * @param startStorageSlot - The starting storage slot. * @param numberOfElements - Number of elements to read from the starting storage slot. */ - public async storageRead(startStorageSlot: Fr, numberOfElements: number) { + public override async storageRead(startStorageSlot: Fr, numberOfElements: number) { const values = []; for (let i = 0n; i < numberOfElements; i++) { const storageSlot = new Fr(startStorageSlot.value + i); diff --git a/yarn-project/simulator/src/public/app_logic_phase_manager.ts b/yarn-project/simulator/src/public/app_logic_phase_manager.ts index b3253260b83..d55c439a83c 100644 --- a/yarn-project/simulator/src/public/app_logic_phase_manager.ts +++ b/yarn-project/simulator/src/public/app_logic_phase_manager.ts @@ -17,14 +17,14 @@ import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simul */ export class AppLogicPhaseManager extends AbstractPhaseManager { constructor( - protected db: MerkleTreeOperations, - protected publicExecutor: PublicExecutor, - protected publicKernel: PublicKernelCircuitSimulator, - protected globalVariables: GlobalVariables, - protected historicalHeader: Header, + db: MerkleTreeOperations, + publicExecutor: PublicExecutor, + publicKernel: PublicKernelCircuitSimulator, + globalVariables: GlobalVariables, + historicalHeader: Header, protected publicContractsDB: ContractsDataSourcePublicDB, protected publicStateDB: PublicStateDB, - public phase: PublicKernelPhase = PublicKernelPhase.APP_LOGIC, + phase: PublicKernelPhase = PublicKernelPhase.APP_LOGIC, ) { super(db, publicExecutor, publicKernel, globalVariables, historicalHeader, phase); } diff --git a/yarn-project/simulator/src/public/public_execution_context.ts b/yarn-project/simulator/src/public/public_execution_context.ts index bd37f1547ae..e0b0922c934 100644 --- a/yarn-project/simulator/src/public/public_execution_context.ts +++ b/yarn-project/simulator/src/public/public_execution_context.ts @@ -93,7 +93,7 @@ export class PublicExecutionContext extends TypedOracle { * Pack the given arguments. * @param args - Arguments to pack */ - public packArguments(args: Fr[]): Promise { + public override packArguments(args: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(args)); } @@ -101,7 +101,7 @@ export class PublicExecutionContext extends TypedOracle { * Pack the given returns. * @param returns - Returns to pack */ - public packReturns(returns: Fr[]): Promise { + public override packReturns(returns: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(returns)); } @@ -109,7 +109,7 @@ export class PublicExecutionContext extends TypedOracle { * Unpack the given returns. * @param returnsHash - Returns hash to unpack */ - public unpackReturns(returnsHash: Fr): Promise { + public override unpackReturns(returnsHash: Fr): Promise { return Promise.resolve(this.packedValuesCache.unpack(returnsHash)); } @@ -121,7 +121,7 @@ export class PublicExecutionContext extends TypedOracle { * @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages * @returns The l1 to l2 membership witness (index of message in the tree and sibling path). */ - public async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) { + public override async getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr) { return await this.commitmentsDb.getL1ToL2MembershipWitness(contractAddress, messageHash, secret); } @@ -129,7 +129,7 @@ export class PublicExecutionContext extends TypedOracle { * Emit an unencrypted log. * @param log - The unencrypted log to be emitted. */ - public emitUnencryptedLog(log: UnencryptedL2Log) { + public override emitUnencryptedLog(log: UnencryptedL2Log) { // TODO(https://github.com/AztecProtocol/aztec-packages/issues/885) this.unencryptedLogs.push(log); this.log.verbose(`Emitted unencrypted log: "${log.toHumanReadable()}"`); @@ -141,7 +141,7 @@ export class PublicExecutionContext extends TypedOracle { * @param contractAddress - The address of the contract whose portal address is to be fetched. * @returns The portal contract address. */ - public async getPortalContractAddress(contractAddress: AztecAddress) { + public override async getPortalContractAddress(contractAddress: AztecAddress) { return (await this.contractsDb.getPortalContractAddress(contractAddress)) ?? EthAddress.ZERO; } @@ -150,7 +150,7 @@ export class PublicExecutionContext extends TypedOracle { * @param startStorageSlot - The starting storage slot. * @param numberOfElements - Number of elements to read from the starting storage slot. */ - public async storageRead(startStorageSlot: Fr, numberOfElements: number) { + public override async storageRead(startStorageSlot: Fr, numberOfElements: number) { const values = []; for (let i = 0; i < Number(numberOfElements); i++) { const storageSlot = new Fr(startStorageSlot.value + BigInt(i)); @@ -167,7 +167,7 @@ export class PublicExecutionContext extends TypedOracle { * @param startStorageSlot - The starting storage slot. * @param values - The values to be written. */ - public async storageWrite(startStorageSlot: Fr, values: Fr[]) { + public override async storageWrite(startStorageSlot: Fr, values: Fr[]) { const newValues = []; for (let i = 0; i < values.length; i++) { const storageSlot = new Fr(startStorageSlot.toBigInt() + BigInt(i)); @@ -188,7 +188,7 @@ export class PublicExecutionContext extends TypedOracle { * @param argsHash - The packed arguments to pass to the function. * @returns The return values of the public function. */ - public async callPublicFunction( + public override async callPublicFunction( targetContractAddress: AztecAddress, functionSelector: FunctionSelector, argsHash: Fr, @@ -256,12 +256,12 @@ export class PublicExecutionContext extends TypedOracle { return childExecutionResult.returnValues; } - public async checkNullifierExists(nullifier: Fr): Promise { + public override async checkNullifierExists(nullifier: Fr): Promise { const witness = await this.commitmentsDb.getNullifierMembershipWitnessAtLatestBlock(nullifier); return !!witness; } - public async getContractInstance(address: AztecAddress): Promise { + public override async getContractInstance(address: AztecAddress): Promise { // Note to AVM implementor: The wrapper of the oracle call get_contract_instance in aztec-nr // automatically checks that the returned instance is correct, by hashing it together back // into the address. However, in the AVM, we also need to prove the negative, otherwise a malicious diff --git a/yarn-project/simulator/src/public/setup_phase_manager.test.ts b/yarn-project/simulator/src/public/setup_phase_manager.test.ts index b90c2a0147d..c8be4e8a64c 100644 --- a/yarn-project/simulator/src/public/setup_phase_manager.test.ts +++ b/yarn-project/simulator/src/public/setup_phase_manager.test.ts @@ -12,7 +12,7 @@ import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simul import { SetupPhaseManager } from './setup_phase_manager.js'; class TestSetupPhaseManager extends SetupPhaseManager { - extractEnqueuedPublicCalls(tx: any) { + override extractEnqueuedPublicCalls(tx: any) { return super.extractEnqueuedPublicCalls(tx); } } diff --git a/yarn-project/simulator/src/public/setup_phase_manager.ts b/yarn-project/simulator/src/public/setup_phase_manager.ts index 591cc5814e2..9c21f610a16 100644 --- a/yarn-project/simulator/src/public/setup_phase_manager.ts +++ b/yarn-project/simulator/src/public/setup_phase_manager.ts @@ -17,14 +17,14 @@ import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simul */ export class SetupPhaseManager extends AbstractPhaseManager { constructor( - protected db: MerkleTreeOperations, - protected publicExecutor: PublicExecutor, - protected publicKernel: PublicKernelCircuitSimulator, - protected globalVariables: GlobalVariables, - protected historicalHeader: Header, + db: MerkleTreeOperations, + publicExecutor: PublicExecutor, + publicKernel: PublicKernelCircuitSimulator, + globalVariables: GlobalVariables, + historicalHeader: Header, protected publicContractsDB: ContractsDataSourcePublicDB, protected publicStateDB: PublicStateDB, - public phase: PublicKernelPhase = PublicKernelPhase.SETUP, + phase: PublicKernelPhase = PublicKernelPhase.SETUP, ) { super(db, publicExecutor, publicKernel, globalVariables, historicalHeader, phase); } diff --git a/yarn-project/simulator/src/public/tail_phase_manager.ts b/yarn-project/simulator/src/public/tail_phase_manager.ts index 44ebe1dd2d3..c1899ae2d72 100644 --- a/yarn-project/simulator/src/public/tail_phase_manager.ts +++ b/yarn-project/simulator/src/public/tail_phase_manager.ts @@ -23,14 +23,14 @@ import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simul export class TailPhaseManager extends AbstractPhaseManager { constructor( - protected db: MerkleTreeOperations, - protected publicExecutor: PublicExecutor, - protected publicKernel: PublicKernelCircuitSimulator, - protected globalVariables: GlobalVariables, - protected historicalHeader: Header, + db: MerkleTreeOperations, + publicExecutor: PublicExecutor, + publicKernel: PublicKernelCircuitSimulator, + globalVariables: GlobalVariables, + historicalHeader: Header, protected publicContractsDB: ContractsDataSourcePublicDB, protected publicStateDB: PublicStateDB, - public readonly phase: PublicKernelPhase = PublicKernelPhase.TAIL, + phase: PublicKernelPhase = PublicKernelPhase.TAIL, ) { super(db, publicExecutor, publicKernel, globalVariables, historicalHeader, phase); } diff --git a/yarn-project/simulator/src/public/teardown_phase_manager.ts b/yarn-project/simulator/src/public/teardown_phase_manager.ts index 5d6cff3a3bd..c5e84807227 100644 --- a/yarn-project/simulator/src/public/teardown_phase_manager.ts +++ b/yarn-project/simulator/src/public/teardown_phase_manager.ts @@ -17,14 +17,14 @@ import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simul */ export class TeardownPhaseManager extends AbstractPhaseManager { constructor( - protected db: MerkleTreeOperations, - protected publicExecutor: PublicExecutor, - protected publicKernel: PublicKernelCircuitSimulator, - protected globalVariables: GlobalVariables, - protected historicalHeader: Header, + db: MerkleTreeOperations, + publicExecutor: PublicExecutor, + publicKernel: PublicKernelCircuitSimulator, + globalVariables: GlobalVariables, + historicalHeader: Header, protected publicContractsDB: ContractsDataSourcePublicDB, protected publicStateDB: PublicStateDB, - public phase: PublicKernelPhase = PublicKernelPhase.TEARDOWN, + phase: PublicKernelPhase = PublicKernelPhase.TEARDOWN, ) { super(db, publicExecutor, publicKernel, globalVariables, historicalHeader, phase); } diff --git a/yarn-project/tsconfig.json b/yarn-project/tsconfig.json index 887a5e3c4eb..95f7ccc5cee 100644 --- a/yarn-project/tsconfig.json +++ b/yarn-project/tsconfig.json @@ -15,7 +15,8 @@ "importHelpers": true, "resolveJsonModule": true, "composite": true, - "skipLibCheck": true + "skipLibCheck": true, + "noImplicitOverride": true, }, "references": [ { "path": "accounts/tsconfig.json" }, From 67077a11250cb28dbef890009668341524b85d8b Mon Sep 17 00:00:00 2001 From: ludamad Date: Tue, 16 Apr 2024 15:09:16 -0400 Subject: [PATCH 38/56] fix: check if a runner is available + safer refcount for spot life (#5793) See commits for action https://github.com/AztecProtocol/ec2-action-builder/compare/v0.8...v0.10 This should cause less trying to contact a dying spot + spot dying incorrectly TODO probably bundle action into monorepo at this point --- .github/workflows/setup-runner.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/setup-runner.yml b/.github/workflows/setup-runner.yml index 6eb50ef922b..15b670c82ec 100644 --- a/.github/workflows/setup-runner.yml +++ b/.github/workflows/setup-runner.yml @@ -54,7 +54,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Start EC2 runner - uses: AztecProtocol/ec2-action-builder@v0.8 + uses: AztecProtocol/ec2-action-builder@v0.10 with: github_token: ${{ secrets.GH_SELF_HOSTED_RUNNER_TOKEN }} aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }} From a7b9d20a962c33d8585502fd00739138c6d79aca Mon Sep 17 00:00:00 2001 From: Maxim Vezenov Date: Tue, 16 Apr 2024 20:51:50 +0100 Subject: [PATCH 39/56] feat: Brillig pointer codegen and execution (#5737) Resolves https://github.com/noir-lang/noir/issues/3907 This PR builds upon https://github.com/AztecProtocol/aztec-packages/pull/5709. These changes do not yet include a Brillig stdlib and removal of the `Brillig` opcode itself. The generated stdlib Brillig (such as for quotient) is not created in the same manner as other Brillig calls which are generated during SSA. I have decided to leave this for another follow-up where we can actually remove `Brillig`. --------- Co-authored-by: Tom French <15848336+TomAFrench@users.noreply.github.com> Co-authored-by: jfecher --- .../acvm-repo/acir/src/circuit/mod.rs | 4 + .../acvm-repo/acvm/src/pwg/brillig.rs | 54 ++++- noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs | 72 +++++- noir/noir-repo/acvm-repo/acvm/tests/solver.rs | 32 ++- .../acvm-repo/acvm_js/src/execute.rs | 25 +- .../src/brillig/brillig_gen/brillig_block.rs | 2 +- .../noirc_evaluator/src/brillig/brillig_ir.rs | 2 +- .../src/brillig/brillig_ir/artifact.rs | 2 +- .../compiler/noirc_evaluator/src/ssa.rs | 26 +- .../src/ssa/acir_gen/acir_ir/acir_variable.rs | 100 ++++++++ .../ssa/acir_gen/acir_ir/generated_acir.rs | 32 +++ .../noirc_evaluator/src/ssa/acir_gen/mod.rs | 227 +++++++++++++++--- .../src/ssa/ssa_gen/program.rs | 29 ++- .../fold_after_inlined_calls/Nargo.toml | 7 + .../fold_after_inlined_calls/Prover.toml | 1 + .../fold_after_inlined_calls/src/main.nr | 14 ++ .../noir-repo/tooling/debugger/src/context.rs | 17 +- noir/noir-repo/tooling/debugger/src/dap.rs | 4 + noir/noir-repo/tooling/debugger/src/lib.rs | 4 +- noir/noir-repo/tooling/debugger/src/repl.rs | 25 +- .../tooling/nargo/src/ops/execute.rs | 21 +- .../tooling/nargo_cli/src/cli/debug_cmd.rs | 1 + yarn-project/circuits.js/src/constants.gen.ts | 2 +- 23 files changed, 615 insertions(+), 88 deletions(-) create mode 100644 noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Nargo.toml create mode 100644 noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Prover.toml create mode 100644 noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/src/main.nr diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs index 0c79cfdb815..188205b124c 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs @@ -266,6 +266,10 @@ impl std::fmt::Display for Program { writeln!(f, "func {}", func_index)?; writeln!(f, "{}", function)?; } + for (func_index, function) in self.unconstrained_functions.iter().enumerate() { + writeln!(f, "unconstrained func {}", func_index)?; + writeln!(f, "{:?}", function.bytecode)?; + } Ok(()) } } diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs index 9982fa890c2..67faf7f5007 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/brillig.rs @@ -1,7 +1,7 @@ use std::collections::HashMap; use acir::{ - brillig::{ForeignCallParam, ForeignCallResult}, + brillig::{ForeignCallParam, ForeignCallResult, Opcode as BrilligOpcode}, circuit::{ brillig::{Brillig, BrilligInputs, BrilligOutputs}, opcodes::BlockId, @@ -46,9 +46,9 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { /// Assigns the zero value to all outputs of the given [`Brillig`] bytecode. pub(super) fn zero_out_brillig_outputs( initial_witness: &mut WitnessMap, - brillig: &Brillig, + outputs: &[BrilligOutputs], ) -> Result<(), OpcodeResolutionError> { - for output in &brillig.outputs { + for output in outputs { match output { BrilligOutputs::Simple(witness) => { insert_value(witness, FieldElement::zero(), initial_witness)?; @@ -63,6 +63,7 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { Ok(()) } + // TODO: Delete this old method once `Brillig` is deleted /// Constructs a solver for a Brillig block given the bytecode and initial /// witness. pub(crate) fn new( @@ -72,13 +73,45 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { bb_solver: &'b B, acir_index: usize, ) -> Result { + let vm = Self::setup_brillig_vm( + initial_witness, + memory, + &brillig.inputs, + &brillig.bytecode, + bb_solver, + )?; + Ok(Self { vm, acir_index }) + } + + /// Constructs a solver for a Brillig block given the bytecode and initial + /// witness. + pub(crate) fn new_call( + initial_witness: &WitnessMap, + memory: &HashMap, + inputs: &'b [BrilligInputs], + brillig_bytecode: &'b [BrilligOpcode], + bb_solver: &'b B, + acir_index: usize, + ) -> Result { + let vm = + Self::setup_brillig_vm(initial_witness, memory, inputs, brillig_bytecode, bb_solver)?; + Ok(Self { vm, acir_index }) + } + + fn setup_brillig_vm( + initial_witness: &WitnessMap, + memory: &HashMap, + inputs: &[BrilligInputs], + brillig_bytecode: &'b [BrilligOpcode], + bb_solver: &'b B, + ) -> Result, OpcodeResolutionError> { // Set input values let mut calldata: Vec = Vec::new(); // Each input represents an expression or array of expressions to evaluate. // Iterate over each input and evaluate the expression(s) associated with it. // Push the results into memory. // If a certain expression is not solvable, we stall the ACVM and do not proceed with Brillig VM execution. - for input in &brillig.inputs { + for input in inputs { match input { BrilligInputs::Single(expr) => match get_value(expr, initial_witness) { Ok(value) => calldata.push(value), @@ -118,8 +151,8 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { // Instantiate a Brillig VM given the solved calldata // along with the Brillig bytecode. - let vm = VM::new(calldata, &brillig.bytecode, vec![], bb_solver); - Ok(Self { vm, acir_index }) + let vm = VM::new(calldata, brillig_bytecode, vec![], bb_solver); + Ok(vm) } pub fn get_memory(&self) -> &[MemoryValue] { @@ -204,13 +237,13 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { pub(crate) fn finalize( self, witness: &mut WitnessMap, - brillig: &Brillig, + outputs: &[BrilligOutputs], ) -> Result<(), OpcodeResolutionError> { // Finish the Brillig execution by writing the outputs to the witness map let vm_status = self.vm.get_status(); match vm_status { VMStatus::Finished { return_data_offset, return_data_size } => { - self.write_brillig_outputs(witness, return_data_offset, return_data_size, brillig)?; + self.write_brillig_outputs(witness, return_data_offset, return_data_size, outputs)?; Ok(()) } _ => panic!("Brillig VM has not completed execution"), @@ -222,12 +255,12 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { witness_map: &mut WitnessMap, return_data_offset: usize, return_data_size: usize, - brillig: &Brillig, + outputs: &[BrilligOutputs], ) -> Result<(), OpcodeResolutionError> { // Write VM execution results into the witness map let memory = self.vm.get_memory(); let mut current_ret_data_idx = return_data_offset; - for output in brillig.outputs.iter() { + for output in outputs.iter() { match output { BrilligOutputs::Simple(witness) => { insert_value(witness, memory[current_ret_data_idx].to_field(), witness_map)?; @@ -242,6 +275,7 @@ impl<'b, B: BlackBoxFunctionSolver> BrilligSolver<'b, B> { } } } + assert!( current_ret_data_idx == return_data_offset + return_data_size, "Brillig VM did not write the expected number of return values" diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs index e7c009f87fa..5362af961a7 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/mod.rs @@ -4,7 +4,7 @@ use std::collections::HashMap; use acir::{ brillig::ForeignCallResult, - circuit::{opcodes::BlockId, Opcode, OpcodeLocation}, + circuit::{brillig::BrilligBytecode, opcodes::BlockId, Opcode, OpcodeLocation}, native_types::{Expression, Witness, WitnessMap}, BlackBoxFunc, FieldElement, }; @@ -165,10 +165,18 @@ pub struct ACVM<'a, B: BlackBoxFunctionSolver> { /// Represents the outputs of all ACIR calls during an ACVM process /// List is appended onto by the caller upon reaching a [ACVMStatus::RequiresAcirCall] acir_call_results: Vec>, + + // Each unconstrained function referenced in the program + unconstrained_functions: &'a [BrilligBytecode], } impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { - pub fn new(backend: &'a B, opcodes: &'a [Opcode], initial_witness: WitnessMap) -> Self { + pub fn new( + backend: &'a B, + opcodes: &'a [Opcode], + initial_witness: WitnessMap, + unconstrained_functions: &'a [BrilligBytecode], + ) -> Self { let status = if opcodes.is_empty() { ACVMStatus::Solved } else { ACVMStatus::InProgress }; ACVM { status, @@ -181,6 +189,7 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { brillig_solver: None, acir_call_counter: 0, acir_call_results: Vec::default(), + unconstrained_functions, } } @@ -324,9 +333,10 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { Ok(Some(foreign_call)) => return self.wait_for_foreign_call(foreign_call), res => res.map(|_| ()), }, - Opcode::BrilligCall { .. } => { - todo!("implement brillig pointer handling"); - } + Opcode::BrilligCall { .. } => match self.solve_brillig_call_opcode() { + Ok(Some(foreign_call)) => return self.wait_for_foreign_call(foreign_call), + res => res.map(|_| ()), + }, Opcode::Call { .. } => match self.solve_call_opcode() { Ok(Some(input_values)) => return self.wait_for_acir_call(input_values), res => res.map(|_| ()), @@ -381,7 +391,8 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { let witness = &mut self.witness_map; if is_predicate_false(witness, &brillig.predicate)? { - return BrilligSolver::::zero_out_brillig_outputs(witness, brillig).map(|_| None); + return BrilligSolver::::zero_out_brillig_outputs(witness, &brillig.outputs) + .map(|_| None); } // If we're resuming execution after resolving a foreign call then @@ -407,7 +418,51 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { } BrilligSolverStatus::Finished => { // Write execution outputs - solver.finalize(witness, brillig)?; + solver.finalize(witness, &brillig.outputs)?; + Ok(None) + } + } + } + + fn solve_brillig_call_opcode( + &mut self, + ) -> Result, OpcodeResolutionError> { + let Opcode::BrilligCall { id, inputs, outputs, predicate } = + &self.opcodes[self.instruction_pointer] + else { + unreachable!("Not executing a Brillig opcode"); + }; + + let witness = &mut self.witness_map; + if is_predicate_false(witness, predicate)? { + return BrilligSolver::::zero_out_brillig_outputs(witness, outputs).map(|_| None); + } + + // If we're resuming execution after resolving a foreign call then + // there will be a cached `BrilligSolver` to avoid recomputation. + let mut solver: BrilligSolver<'_, B> = match self.brillig_solver.take() { + Some(solver) => solver, + None => BrilligSolver::new_call( + witness, + &self.block_solvers, + inputs, + &self.unconstrained_functions[*id as usize].bytecode, + self.backend, + self.instruction_pointer, + )?, + }; + match solver.solve()? { + BrilligSolverStatus::ForeignCallWait(foreign_call) => { + // Cache the current state of the solver + self.brillig_solver = Some(solver); + Ok(Some(foreign_call)) + } + BrilligSolverStatus::InProgress => { + unreachable!("Brillig solver still in progress") + } + BrilligSolverStatus::Finished => { + // Write execution outputs + solver.finalize(witness, outputs)?; Ok(None) } } @@ -425,7 +480,8 @@ impl<'a, B: BlackBoxFunctionSolver> ACVM<'a, B> { }; if should_skip { - let resolution = BrilligSolver::::zero_out_brillig_outputs(witness, brillig); + let resolution = + BrilligSolver::::zero_out_brillig_outputs(witness, &brillig.outputs); return StepResult::Status(self.handle_opcode_resolution(resolution)); } diff --git a/noir/noir-repo/acvm-repo/acvm/tests/solver.rs b/noir/noir-repo/acvm-repo/acvm/tests/solver.rs index ec7a6467ff5..f009e2c05b8 100644 --- a/noir/noir-repo/acvm-repo/acvm/tests/solver.rs +++ b/noir/noir-repo/acvm-repo/acvm/tests/solver.rs @@ -104,8 +104,9 @@ fn inversion_brillig_oracle_equivalence() { (Witness(2), FieldElement::from(3u128)), ]) .into(); - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments); + let unconstrained_functions = vec![]; + let mut acvm = + ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments, &unconstrained_functions); // use the partial witness generation solver with our acir program let solver_status = acvm.solve(); @@ -241,8 +242,9 @@ fn double_inversion_brillig_oracle() { (Witness(9), FieldElement::from(10u128)), ]) .into(); - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments); + let unconstrained_functions = vec![]; + let mut acvm = + ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments, &unconstrained_functions); // use the partial witness generation solver with our acir program let solver_status = acvm.solve(); @@ -370,8 +372,9 @@ fn oracle_dependent_execution() { let witness_assignments = BTreeMap::from([(w_x, FieldElement::from(2u128)), (w_y, FieldElement::from(2u128))]).into(); - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments); + let unconstrained_functions = vec![]; + let mut acvm = + ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments, &unconstrained_functions); // use the partial witness generation solver with our acir program let solver_status = acvm.solve(); @@ -474,8 +477,9 @@ fn brillig_oracle_predicate() { (Witness(2), FieldElement::from(3u128)), ]) .into(); - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments); + let unconstrained_functions = vec![]; + let mut acvm = + ACVM::new(&StubbedBlackBoxSolver, &opcodes, witness_assignments, &unconstrained_functions); let solver_status = acvm.solve(); assert_eq!(solver_status, ACVMStatus::Solved, "should be fully solved"); @@ -509,7 +513,8 @@ fn unsatisfied_opcode_resolved() { values.insert(d, FieldElement::from(2_i128)); let opcodes = vec![Opcode::AssertZero(opcode_a)]; - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, values); + let unconstrained_functions = vec![]; + let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, values, &unconstrained_functions); let solver_status = acvm.solve(); assert_eq!( solver_status, @@ -591,8 +596,8 @@ fn unsatisfied_opcode_resolved_brillig() { values.insert(w_result, FieldElement::from(0_i128)); let opcodes = vec![brillig_opcode, Opcode::AssertZero(opcode_a)]; - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, values); + let unconstrained_functions = vec![]; + let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, values, &unconstrained_functions); let solver_status = acvm.solve(); assert_eq!( solver_status, @@ -635,8 +640,9 @@ fn memory_operations() { }); let opcodes = vec![init, read_op, expression]; - - let mut acvm = ACVM::new(&StubbedBlackBoxSolver, &opcodes, initial_witness); + let unconstrained_functions = vec![]; + let mut acvm = + ACVM::new(&StubbedBlackBoxSolver, &opcodes, initial_witness, &unconstrained_functions); let solver_status = acvm.solve(); assert_eq!(solver_status, ACVMStatus::Solved); let witness_map = acvm.finalize(); diff --git a/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs b/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs index 8bc56295992..2fab684467e 100644 --- a/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs +++ b/noir/noir-repo/acvm-repo/acvm_js/src/execute.rs @@ -1,5 +1,6 @@ use std::{future::Future, pin::Pin}; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::BlackBoxFunctionSolver; use acvm::{ acir::circuit::{Circuit, Program}, @@ -181,7 +182,12 @@ async fn execute_program_with_native_program_and_return( initial_witness: JsWitnessMap, foreign_call_executor: &ForeignCallHandler, ) -> Result { - let executor = ProgramExecutor::new(&program.functions, &solver.0, foreign_call_executor); + let executor = ProgramExecutor::new( + &program.functions, + &program.unconstrained_functions, + &solver.0, + foreign_call_executor, + ); let witness_stack = executor.execute(initial_witness.into()).await?; Ok(witness_stack) @@ -190,6 +196,8 @@ async fn execute_program_with_native_program_and_return( struct ProgramExecutor<'a, B: BlackBoxFunctionSolver> { functions: &'a [Circuit], + unconstrained_functions: &'a [BrilligBytecode], + blackbox_solver: &'a B, foreign_call_handler: &'a ForeignCallHandler, @@ -198,10 +206,16 @@ struct ProgramExecutor<'a, B: BlackBoxFunctionSolver> { impl<'a, B: BlackBoxFunctionSolver> ProgramExecutor<'a, B> { fn new( functions: &'a [Circuit], + unconstrained_functions: &'a [BrilligBytecode], blackbox_solver: &'a B, foreign_call_handler: &'a ForeignCallHandler, ) -> Self { - ProgramExecutor { functions, blackbox_solver, foreign_call_handler } + ProgramExecutor { + functions, + unconstrained_functions, + blackbox_solver, + foreign_call_handler, + } } async fn execute(&self, initial_witness: WitnessMap) -> Result { @@ -220,7 +234,12 @@ impl<'a, B: BlackBoxFunctionSolver> ProgramExecutor<'a, B> { witness_stack: &'a mut WitnessStack, ) -> Pin> + 'a>> { Box::pin(async { - let mut acvm = ACVM::new(self.blackbox_solver, &circuit.opcodes, initial_witness); + let mut acvm = ACVM::new( + self.blackbox_solver, + &circuit.opcodes, + initial_witness, + self.unconstrained_functions, + ); loop { let solver_status = acvm.solve(); diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs index 369d8e78cda..22407fc5695 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_gen/brillig_block.rs @@ -1785,7 +1785,7 @@ pub(crate) fn type_of_binary_operation(lhs_type: &Type, rhs_type: &Type) -> Type (Type::Numeric(lhs_type), Type::Numeric(rhs_type)) => { assert_eq!( lhs_type, rhs_type, - "lhs and rhs types in a binary operation are always the same" + "lhs and rhs types in a binary operation are always the same but got {lhs_type} and {rhs_type}" ); Type::Numeric(*lhs_type) } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs index fdb03abe59f..29210dc6f99 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir.rs @@ -140,7 +140,7 @@ pub(crate) mod tests { &self, _public_key_x: &FieldElement, _public_key_y: &FieldElement, - _signature: &[u8], + _signature: &[u8; 64], _message: &[u8], ) -> Result { Ok(true) diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs index 8ce15ba4e73..8bd1bfda78f 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs @@ -17,7 +17,7 @@ pub(crate) enum BrilligParameter { /// The result of compiling and linking brillig artifacts. /// This is ready to run bytecode with attached metadata. -#[derive(Debug)] +#[derive(Debug, Default)] pub(crate) struct GeneratedBrillig { pub(crate) byte_code: Vec, pub(crate) locations: BTreeMap, diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa.rs index ce4a9bbe9f1..760340f1a88 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa.rs @@ -14,7 +14,9 @@ use crate::{ errors::{RuntimeError, SsaReport}, }; use acvm::acir::{ - circuit::{Circuit, ExpressionWidth, Program as AcirProgram, PublicInputs}, + circuit::{ + brillig::BrilligBytecode, Circuit, ExpressionWidth, Program as AcirProgram, PublicInputs, + }, native_types::Witness, }; @@ -35,14 +37,16 @@ pub mod ssa_gen; /// Optimize the given program by converting it into SSA /// form and performing optimizations there. When finished, -/// convert the final SSA into ACIR and return it. +/// convert the final SSA into an ACIR program and return it. +/// An ACIR program is made up of both ACIR functions +/// and Brillig functions for unconstrained execution. pub(crate) fn optimize_into_acir( program: Program, print_passes: bool, print_brillig_trace: bool, force_brillig_output: bool, print_timings: bool, -) -> Result, RuntimeError> { +) -> Result<(Vec, Vec), RuntimeError> { let abi_distinctness = program.return_distinctness; let ssa_gen_span = span!(Level::TRACE, "ssa_generation"); @@ -99,6 +103,18 @@ pub struct SsaProgramArtifact { } impl SsaProgramArtifact { + fn new(unconstrained_functions: Vec) -> Self { + let program = AcirProgram { functions: Vec::default(), unconstrained_functions }; + Self { + program, + debug: Vec::default(), + warnings: Vec::default(), + main_input_witnesses: Vec::default(), + main_return_witnesses: Vec::default(), + names: Vec::default(), + } + } + fn add_circuit(&mut self, mut circuit_artifact: SsaCircuitArtifact, is_main: bool) { self.program.functions.push(circuit_artifact.circuit); self.debug.push(circuit_artifact.debug_info); @@ -130,7 +146,7 @@ pub fn create_program( let func_sigs = program.function_signatures.clone(); let recursive = program.recursive; - let generated_acirs = optimize_into_acir( + let (generated_acirs, generated_brillig) = optimize_into_acir( program, enable_ssa_logging, enable_brillig_logging, @@ -143,7 +159,7 @@ pub fn create_program( "The generated ACIRs should match the supplied function signatures" ); - let mut program_artifact = SsaProgramArtifact::default(); + let mut program_artifact = SsaProgramArtifact::new(generated_brillig); // For setting up the ABI we need separately specify main's input and return witnesses let mut is_main = true; for (acir, func_sig) in generated_acirs.into_iter().zip(func_sigs) { diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/acir_variable.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/acir_variable.rs index 775571f4a41..3294eb16695 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/acir_variable.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/acir_variable.rs @@ -1463,6 +1463,7 @@ impl AcirContext { id } + // TODO: Delete this method once we remove the `Brillig` opcode pub(crate) fn brillig( &mut self, predicate: AcirVar, @@ -1553,6 +1554,105 @@ impl AcirContext { Ok(outputs_var) } + #[allow(clippy::too_many_arguments)] + pub(crate) fn brillig_call( + &mut self, + predicate: AcirVar, + generated_brillig: &GeneratedBrillig, + inputs: Vec, + outputs: Vec, + attempt_execution: bool, + unsafe_return_values: bool, + brillig_function_index: u32, + ) -> Result, RuntimeError> { + let brillig_inputs = try_vecmap(inputs, |i| -> Result<_, InternalError> { + match i { + AcirValue::Var(var, _) => Ok(BrilligInputs::Single(self.var_to_expression(var)?)), + AcirValue::Array(vars) => { + let mut var_expressions: Vec = Vec::new(); + for var in vars { + self.brillig_array_input(&mut var_expressions, var)?; + } + Ok(BrilligInputs::Array(var_expressions)) + } + AcirValue::DynamicArray(AcirDynamicArray { block_id, .. }) => { + Ok(BrilligInputs::MemoryArray(block_id)) + } + } + })?; + + // Optimistically try executing the brillig now, if we can complete execution they just return the results. + // This is a temporary measure pending SSA optimizations being applied to Brillig which would remove constant-input opcodes (See #2066) + // + // We do _not_ want to do this in the situation where the `main` function is unconstrained, as if execution succeeds + // the entire program will be replaced with witness constraints to its outputs. + if attempt_execution { + if let Some(brillig_outputs) = + self.execute_brillig(&generated_brillig.byte_code, &brillig_inputs, &outputs) + { + return Ok(brillig_outputs); + } + } + + // Otherwise we must generate ACIR for it and execute at runtime. + let mut brillig_outputs = Vec::new(); + let outputs_var = vecmap(outputs, |output| match output { + AcirType::NumericType(_) => { + let witness_index = self.acir_ir.next_witness_index(); + brillig_outputs.push(BrilligOutputs::Simple(witness_index)); + let var = self.add_data(AcirVarData::Witness(witness_index)); + AcirValue::Var(var, output.clone()) + } + AcirType::Array(element_types, size) => { + let (acir_value, witnesses) = self.brillig_array_output(&element_types, size); + brillig_outputs.push(BrilligOutputs::Array(witnesses)); + acir_value + } + }); + let predicate = self.var_to_expression(predicate)?; + + self.acir_ir.brillig_call( + Some(predicate), + generated_brillig, + brillig_inputs, + brillig_outputs, + brillig_function_index, + ); + + fn range_constraint_value( + context: &mut AcirContext, + value: &AcirValue, + ) -> Result<(), RuntimeError> { + match value { + AcirValue::Var(var, typ) => { + let numeric_type = match typ { + AcirType::NumericType(numeric_type) => numeric_type, + _ => unreachable!("`AcirValue::Var` may only hold primitive values"), + }; + context.range_constrain_var(*var, numeric_type, None)?; + } + AcirValue::Array(values) => { + for value in values { + range_constraint_value(context, value)?; + } + } + AcirValue::DynamicArray(_) => { + unreachable!("Brillig opcodes cannot return dynamic arrays") + } + } + Ok(()) + } + + // This is a hack to ensure that if we're compiling a brillig entrypoint function then + // we don't also add a number of range constraints. + if !unsafe_return_values { + for output_var in &outputs_var { + range_constraint_value(self, output_var)?; + } + } + Ok(outputs_var) + } + fn brillig_array_input( &mut self, var_expressions: &mut Vec, diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs index e16eb2172be..999ff2ddb5d 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/acir_ir/generated_acir.rs @@ -589,6 +589,7 @@ impl GeneratedAcir { Ok(()) } + // TODO: Delete this method once we remove the `Brillig` opcode pub(crate) fn brillig( &mut self, predicate: Option, @@ -617,6 +618,37 @@ impl GeneratedAcir { } } + pub(crate) fn brillig_call( + &mut self, + predicate: Option, + generated_brillig: &GeneratedBrillig, + inputs: Vec, + outputs: Vec, + brillig_function_index: u32, + ) { + let opcode = + AcirOpcode::BrilligCall { id: brillig_function_index, inputs, outputs, predicate }; + self.push_opcode(opcode); + for (brillig_index, call_stack) in generated_brillig.locations.iter() { + self.locations.insert( + OpcodeLocation::Brillig { + acir_index: self.opcodes.len() - 1, + brillig_index: *brillig_index, + }, + call_stack.clone(), + ); + } + for (brillig_index, message) in generated_brillig.assert_messages.iter() { + self.assert_messages.insert( + OpcodeLocation::Brillig { + acir_index: self.opcodes.len() - 1, + brillig_index: *brillig_index, + }, + message.clone(), + ); + } + } + pub(crate) fn last_acir_opcode_location(&self) -> OpcodeLocation { OpcodeLocation::Acir(self.opcodes.len() - 1) } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs index 76cc8acf878..afd749485d7 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs @@ -1,12 +1,13 @@ //! This file holds the pass to convert from Noir's SSA IR to ACIR. mod acir_ir; -use std::collections::HashSet; +use std::collections::{BTreeMap, HashSet}; use std::fmt::Debug; use self::acir_ir::acir_variable::{AcirContext, AcirType, AcirVar}; use super::function_builder::data_bus::DataBus; use super::ir::dfg::CallStack; +use super::ir::function::FunctionId; use super::ir::instruction::{ConstrainError, UserDefinedConstrainError}; use super::{ ir::{ @@ -28,6 +29,7 @@ use crate::errors::{InternalError, InternalWarning, RuntimeError, SsaReport}; use crate::ssa::ir::function::InlineType; pub(crate) use acir_ir::generated_acir::GeneratedAcir; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::acir::native_types::Witness; use acvm::acir::BlackBoxFunc; use acvm::{ @@ -39,9 +41,47 @@ use im::Vector; use iter_extended::{try_vecmap, vecmap}; use noirc_frontend::Distinctness; +#[derive(Default)] +struct SharedContext { + /// Final list of Brillig functions which will be part of the final program + /// This is shared across `Context` structs as we want one list of Brillig + /// functions across all ACIR artifacts + generated_brillig: Vec, + + /// Maps SSA function index -> Final generated Brillig artifact index. + /// There can be Brillig functions specified in SSA which do not act as + /// entry points in ACIR (e.g. only called by other Brillig functions) + /// This mapping is necessary to use the correct function pointer for a Brillig call. + brillig_generated_func_pointers: BTreeMap, +} + +impl SharedContext { + fn generated_brillig_pointer(&self, func_id: &FunctionId) -> Option<&u32> { + self.brillig_generated_func_pointers.get(func_id) + } + + fn generated_brillig(&self, func_pointer: usize) -> &GeneratedBrillig { + &self.generated_brillig[func_pointer] + } + + fn insert_generated_brillig( + &mut self, + func_id: FunctionId, + generated_pointer: u32, + code: GeneratedBrillig, + ) { + self.brillig_generated_func_pointers.insert(func_id, generated_pointer); + self.generated_brillig.push(code); + } + + fn new_generated_pointer(&self) -> u32 { + self.generated_brillig.len() as u32 + } +} + /// Context struct for the acir generation pass. /// May be similar to the Evaluator struct in the current SSA IR. -struct Context { +struct Context<'a> { /// Maps SSA values to `AcirVar`. /// /// This is needed so that we only create a single @@ -91,6 +131,9 @@ struct Context { max_block_id: u32, data_bus: DataBus, + + /// Contains state that is generated and also used across ACIR functions + shared_context: &'a mut SharedContext, } #[derive(Clone)] @@ -181,11 +224,12 @@ impl Ssa { self, brillig: &Brillig, abi_distinctness: Distinctness, - ) -> Result, RuntimeError> { + ) -> Result<(Vec, Vec), RuntimeError> { let mut acirs = Vec::new(); // TODO: can we parallelise this? + let mut shared_context = SharedContext::default(); for function in self.functions.values() { - let context = Context::new(); + let context = Context::new(&mut shared_context); if let Some(mut generated_acir) = context.convert_ssa_function(&self, function, brillig)? { @@ -194,6 +238,10 @@ impl Ssa { } } + let brillig = vecmap(shared_context.generated_brillig, |brillig| BrilligBytecode { + bytecode: brillig.byte_code, + }); + // TODO: check whether doing this for a single circuit's return witnesses is correct. // We probably need it for all foldable circuits, as any circuit being folded is essentially an entry point. However, I do not know how that // plays a part when we potentially want not inlined functions normally as part of the compiler. @@ -215,15 +263,15 @@ impl Ssa { .collect(); main_func_acir.return_witnesses = distinct_return_witness; - Ok(acirs) } - Distinctness::DuplicationAllowed => Ok(acirs), + Distinctness::DuplicationAllowed => {} } + Ok((acirs, brillig)) } } -impl Context { - fn new() -> Context { +impl<'a> Context<'a> { + fn new(shared_context: &'a mut SharedContext) -> Context<'a> { let mut acir_context = AcirContext::default(); let current_side_effects_enabled_var = acir_context.add_constant(FieldElement::one()); @@ -237,6 +285,7 @@ impl Context { internal_mem_block_lengths: HashMap::default(), max_block_id: 0, data_bus: DataBus::default(), + shared_context, } } @@ -576,12 +625,12 @@ impl Context { sum + dfg.try_get_array_length(*result_id).unwrap_or(1) }); - let acir_program_id = ssa - .id_to_index + let acir_function_id = ssa + .entry_point_to_generated_index .get(id) .expect("ICE: should have an associated final index"); let output_vars = self.acir_context.call_acir_function( - *acir_program_id, + *acir_function_id, inputs, output_count, self.current_side_effects_enabled_var, @@ -603,24 +652,50 @@ impl Context { ); } } - let inputs = vecmap(arguments, |arg| self.convert_value(*arg, dfg)); - let arguments = self.gen_brillig_parameters(arguments, dfg); - - let code = self.gen_brillig_for(func, arguments, brillig)?; let outputs: Vec = vecmap(result_ids, |result_id| { dfg.type_of_value(*result_id).into() }); - let output_values = self.acir_context.brillig( - self.current_side_effects_enabled_var, - code, - inputs, - outputs, - true, - false, - )?; + // Check whether we have already generated Brillig for this function + // If we have, re-use the generated code to set-up the Brillig call. + let output_values = if let Some(generated_pointer) = + self.shared_context.generated_brillig_pointer(id) + { + let code = self + .shared_context + .generated_brillig(*generated_pointer as usize); + self.acir_context.brillig_call( + self.current_side_effects_enabled_var, + code, + inputs, + outputs, + true, + false, + *generated_pointer, + )? + } else { + let arguments = self.gen_brillig_parameters(arguments, dfg); + let code = self.gen_brillig_for(func, arguments, brillig)?; + let generated_pointer = + self.shared_context.new_generated_pointer(); + let output_values = self.acir_context.brillig_call( + self.current_side_effects_enabled_var, + &code, + inputs, + outputs, + true, + false, + generated_pointer, + )?; + self.shared_context.insert_generated_brillig( + *id, + generated_pointer, + code, + ); + output_values + }; // Compiler sanity check assert_eq!(result_ids.len(), output_values.len(), "ICE: The number of Brillig output values should match the result ids in SSA"); @@ -2447,19 +2522,27 @@ mod test { }, }; - fn build_basic_foo_with_return(builder: &mut FunctionBuilder, foo_id: FunctionId) { - // acir(fold) fn foo f1 { + fn build_basic_foo_with_return( + builder: &mut FunctionBuilder, + foo_id: FunctionId, + is_brillig_func: bool, + ) { + // fn foo f1 { // b0(v0: Field, v1: Field): // v2 = eq v0, v1 // constrain v2 == u1 0 // return v0 // } - builder.new_function("foo".into(), foo_id, InlineType::Fold); + if is_brillig_func { + builder.new_brillig_function("foo".into(), foo_id); + } else { + builder.new_function("foo".into(), foo_id, InlineType::Fold); + } let foo_v0 = builder.add_parameter(Type::field()); let foo_v1 = builder.add_parameter(Type::field()); let foo_equality_check = builder.insert_binary(foo_v0, BinaryOp::Eq, foo_v1); - let zero = builder.field_constant(0u128); + let zero = builder.numeric_constant(0u128, Type::unsigned(1)); builder.insert_constrain(foo_equality_check, zero, None); builder.terminate_with_return(vec![foo_v0]); } @@ -2493,11 +2576,11 @@ mod test { builder.insert_constrain(main_call1_results[0], main_call2_results[0], None); builder.terminate_with_return(vec![]); - build_basic_foo_with_return(&mut builder, foo_id); + build_basic_foo_with_return(&mut builder, foo_id, false); let ssa = builder.finish(); - let acir_functions = ssa + let (acir_functions, _) = ssa .into_acir(&Brillig::default(), noirc_frontend::Distinctness::Distinct) .expect("Should compile manually written SSA into ACIR"); // Expected result: @@ -2589,11 +2672,11 @@ mod test { builder.insert_constrain(main_call1_results[0], main_call2_results[0], None); builder.terminate_with_return(vec![]); - build_basic_foo_with_return(&mut builder, foo_id); + build_basic_foo_with_return(&mut builder, foo_id, false); let ssa = builder.finish(); - let acir_functions = ssa + let (acir_functions, _) = ssa .into_acir(&Brillig::default(), noirc_frontend::Distinctness::Distinct) .expect("Should compile manually written SSA into ACIR"); // The expected result should look very similar to the abvoe test expect that the input witnesses of the `Call` @@ -2680,11 +2763,11 @@ mod test { .to_vec(); builder.terminate_with_return(vec![foo_call[0]]); - build_basic_foo_with_return(&mut builder, foo_id); + build_basic_foo_with_return(&mut builder, foo_id, false); let ssa = builder.finish(); - let acir_functions = ssa + let (acir_functions, _) = ssa .into_acir(&Brillig::default(), noirc_frontend::Distinctness::Distinct) .expect("Should compile manually written SSA into ACIR"); @@ -2744,4 +2827,82 @@ mod test { _ => panic!("Expected only Call opcode"), } } + + // Test that given multiple calls to the same brillig function we generate only one bytecode + // and the appropriate Brillig call opcodes are generated + #[test] + fn multiple_brillig_calls_one_bytecode() { + // acir(inline) fn main f0 { + // b0(v0: Field, v1: Field): + // v3 = call f1(v0, v1) + // v4 = call f1(v0, v1) + // v5 = call f1(v0, v1) + // v6 = call f1(v0, v1) + // return + // } + // brillig fn foo f1 { + // b0(v0: Field, v1: Field): + // v2 = eq v0, v1 + // constrain v2 == u1 0 + // return v0 + // } + // brillig fn foo f2 { + // b0(v0: Field, v1: Field): + // v2 = eq v0, v1 + // constrain v2 == u1 0 + // return v0 + // } + let foo_id = Id::test_new(0); + let mut builder = FunctionBuilder::new("main".into(), foo_id); + let main_v0 = builder.add_parameter(Type::field()); + let main_v1 = builder.add_parameter(Type::field()); + + let foo_id = Id::test_new(1); + let foo = builder.import_function(foo_id); + let bar_id = Id::test_new(2); + let bar = builder.import_function(bar_id); + + // Insert multiple calls to the same Brillig function + builder.insert_call(foo, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + builder.insert_call(foo, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + builder.insert_call(foo, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + // Interleave a call to a separate Brillig function to make sure that we can call multiple separate Brillig functions + builder.insert_call(bar, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + builder.insert_call(foo, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + builder.insert_call(bar, vec![main_v0, main_v1], vec![Type::field()]).to_vec(); + builder.terminate_with_return(vec![]); + + build_basic_foo_with_return(&mut builder, foo_id, true); + build_basic_foo_with_return(&mut builder, bar_id, true); + + let ssa = builder.finish(); + let brillig = ssa.to_brillig(false); + println!("{}", ssa); + + let (acir_functions, brillig_functions) = ssa + .into_acir(&brillig, noirc_frontend::Distinctness::Distinct) + .expect("Should compile manually written SSA into ACIR"); + + assert_eq!(acir_functions.len(), 1, "Should only have a `main` ACIR function"); + assert_eq!( + brillig_functions.len(), + 2, + "Should only have generated a single Brillig function" + ); + + let main_acir = &acir_functions[0]; + let main_opcodes = main_acir.opcodes(); + assert_eq!(main_opcodes.len(), 6, "Should have four calls to f1 and two calls to f2"); + + // We should only have `BrilligCall` opcodes in `main` + for (i, opcode) in main_opcodes.iter().enumerate() { + match opcode { + Opcode::BrilligCall { id, .. } => { + let expected_id = if i == 3 || i == 5 { 1 } else { 0 }; + assert_eq!(*id, expected_id, "Expected an id of {expected_id} but got {id}"); + } + _ => panic!("Expected only Brillig call opcode"), + } + } + } } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/program.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/program.rs index 9995c031145..b05a2cbc741 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/program.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/program.rs @@ -3,7 +3,7 @@ use std::{collections::BTreeMap, fmt::Display}; use iter_extended::btree_map; use crate::ssa::ir::{ - function::{Function, FunctionId}, + function::{Function, FunctionId, RuntimeType}, map::AtomicCounter, }; @@ -12,7 +12,11 @@ pub(crate) struct Ssa { pub(crate) functions: BTreeMap, pub(crate) main_id: FunctionId, pub(crate) next_id: AtomicCounter, - pub(crate) id_to_index: BTreeMap, + /// Maps SSA entry point function ID -> Final generated ACIR artifact index. + /// There can be functions specified in SSA which do not act as ACIR entry points. + /// This mapping is necessary to use the correct function pointer for an ACIR call, + /// as the final program artifact will be a list of only entry point functions. + pub(crate) entry_point_to_generated_index: BTreeMap, } impl Ssa { @@ -27,9 +31,26 @@ impl Ssa { (f.id(), f) }); - let id_to_index = btree_map(functions.iter().enumerate(), |(i, (id, _))| (*id, i as u32)); + let entry_point_to_generated_index = btree_map( + functions + .iter() + .filter(|(_, func)| { + let runtime = func.runtime(); + match func.runtime() { + RuntimeType::Acir(_) => runtime.is_entry_point() || func.id() == main_id, + RuntimeType::Brillig => false, + } + }) + .enumerate(), + |(i, (id, _))| (*id, i as u32), + ); - Self { functions, main_id, next_id: AtomicCounter::starting_after(max_id), id_to_index } + Self { + functions, + main_id, + next_id: AtomicCounter::starting_after(max_id), + entry_point_to_generated_index, + } } /// Returns the entry-point function of the program diff --git a/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Nargo.toml b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Nargo.toml new file mode 100644 index 00000000000..d23924af083 --- /dev/null +++ b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Nargo.toml @@ -0,0 +1,7 @@ +[package] +name = "fold_after_inlined_calls" +type = "bin" +authors = [""] +compiler_version = ">=0.27.0" + +[dependencies] \ No newline at end of file diff --git a/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Prover.toml b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Prover.toml new file mode 100644 index 00000000000..4dd6b405159 --- /dev/null +++ b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/Prover.toml @@ -0,0 +1 @@ +x = "1" diff --git a/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/src/main.nr b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/src/main.nr new file mode 100644 index 00000000000..84c81190b9b --- /dev/null +++ b/noir/noir-repo/test_programs/execution_success/fold_after_inlined_calls/src/main.nr @@ -0,0 +1,14 @@ +fn main(x: u32) { + // We want to call a foldable function after a call to a function that is set to be inlined + assert(increment(x) == x + 1); + foo(x); +} + +#[fold] +fn foo(x: u32) { + assert(x == 1); +} + +fn increment(x: u32) -> u32 { + x + 1 +} diff --git a/noir/noir-repo/tooling/debugger/src/context.rs b/noir/noir-repo/tooling/debugger/src/context.rs index b211832518d..5639407df54 100644 --- a/noir/noir-repo/tooling/debugger/src/context.rs +++ b/noir/noir-repo/tooling/debugger/src/context.rs @@ -1,4 +1,5 @@ use crate::foreign_calls::DebugForeignCallExecutor; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::acir::circuit::{Circuit, Opcode, OpcodeLocation}; use acvm::acir::native_types::{Witness, WitnessMap}; use acvm::brillig_vm::brillig::ForeignCallResult; @@ -42,10 +43,17 @@ impl<'a, B: BlackBoxFunctionSolver> DebugContext<'a, B> { debug_artifact: &'a DebugArtifact, initial_witness: WitnessMap, foreign_call_executor: Box, + unconstrained_functions: &'a [BrilligBytecode], ) -> Self { let source_to_opcodes = build_source_to_opcode_debug_mappings(debug_artifact); Self { - acvm: ACVM::new(blackbox_solver, &circuit.opcodes, initial_witness), + // TODO: need to handle brillig pointer in the debugger + acvm: ACVM::new( + blackbox_solver, + &circuit.opcodes, + initial_witness, + unconstrained_functions, + ), brillig_solver: None, foreign_call_executor, debug_artifact, @@ -630,6 +638,7 @@ fn build_source_to_opcode_debug_mappings( result } +// TODO: update all debugger tests to use unconstrained brillig pointers #[cfg(test)] mod tests { use super::*; @@ -696,12 +705,14 @@ mod tests { let foreign_call_executor = Box::new(DefaultDebugForeignCallExecutor::from_artifact(true, debug_artifact)); + let brillig_funcs = &vec![]; let mut context = DebugContext::new( &StubbedBlackBoxSolver, circuit, debug_artifact, initial_witness, foreign_call_executor, + brillig_funcs, ); assert_eq!(context.get_current_opcode_location(), Some(OpcodeLocation::Acir(0))); @@ -803,12 +814,14 @@ mod tests { let foreign_call_executor = Box::new(DefaultDebugForeignCallExecutor::from_artifact(true, debug_artifact)); + let brillig_funcs = &vec![]; let mut context = DebugContext::new( &StubbedBlackBoxSolver, circuit, debug_artifact, initial_witness, foreign_call_executor, + brillig_funcs, ); // set breakpoint @@ -860,12 +873,14 @@ mod tests { let circuit = Circuit { opcodes, ..Circuit::default() }; let debug_artifact = DebugArtifact { debug_symbols: vec![], file_map: BTreeMap::new(), warnings: vec![] }; + let brillig_funcs = &vec![]; let context = DebugContext::new( &StubbedBlackBoxSolver, &circuit, &debug_artifact, WitnessMap::new(), Box::new(DefaultDebugForeignCallExecutor::new(true)), + brillig_funcs, ); assert_eq!(context.offset_opcode_location(&None, 0), (None, 0)); diff --git a/noir/noir-repo/tooling/debugger/src/dap.rs b/noir/noir-repo/tooling/debugger/src/dap.rs index ea3204ebbbc..dc83337a973 100644 --- a/noir/noir-repo/tooling/debugger/src/dap.rs +++ b/noir/noir-repo/tooling/debugger/src/dap.rs @@ -2,6 +2,7 @@ use std::collections::BTreeMap; use std::io::{Read, Write}; use std::str::FromStr; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::acir::circuit::{Circuit, OpcodeLocation}; use acvm::acir::native_types::WitnessMap; use acvm::BlackBoxFunctionSolver; @@ -64,6 +65,7 @@ impl<'a, R: Read, W: Write, B: BlackBoxFunctionSolver> DapSession<'a, R, W, B> { circuit: &'a Circuit, debug_artifact: &'a DebugArtifact, initial_witness: WitnessMap, + unconstrained_functions: &'a [BrilligBytecode], ) -> Self { let context = DebugContext::new( solver, @@ -71,6 +73,7 @@ impl<'a, R: Read, W: Write, B: BlackBoxFunctionSolver> DapSession<'a, R, W, B> { debug_artifact, initial_witness, Box::new(DefaultDebugForeignCallExecutor::from_artifact(true, debug_artifact)), + unconstrained_functions, ); Self { server, @@ -613,6 +616,7 @@ pub fn run_session( &program.program.functions[0], &debug_artifact, initial_witness, + &program.program.unconstrained_functions, ); session.run_loop() diff --git a/noir/noir-repo/tooling/debugger/src/lib.rs b/noir/noir-repo/tooling/debugger/src/lib.rs index 4a25e3417a0..a8fc61c893f 100644 --- a/noir/noir-repo/tooling/debugger/src/lib.rs +++ b/noir/noir-repo/tooling/debugger/src/lib.rs @@ -9,6 +9,7 @@ use std::io::{Read, Write}; use ::dap::errors::ServerError; use ::dap::server::Server; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::BlackBoxFunctionSolver; use acvm::{acir::circuit::Circuit, acir::native_types::WitnessMap}; @@ -22,8 +23,9 @@ pub fn debug_circuit( circuit: &Circuit, debug_artifact: DebugArtifact, initial_witness: WitnessMap, + unconstrained_functions: &[BrilligBytecode], ) -> Result, NargoError> { - repl::run(blackbox_solver, circuit, &debug_artifact, initial_witness) + repl::run(blackbox_solver, circuit, &debug_artifact, initial_witness, unconstrained_functions) } pub fn run_dap_loop( diff --git a/noir/noir-repo/tooling/debugger/src/repl.rs b/noir/noir-repo/tooling/debugger/src/repl.rs index e30d519b62e..2a92698e5ce 100644 --- a/noir/noir-repo/tooling/debugger/src/repl.rs +++ b/noir/noir-repo/tooling/debugger/src/repl.rs @@ -1,5 +1,6 @@ use crate::context::{DebugCommandResult, DebugContext}; +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::acir::circuit::{Circuit, Opcode, OpcodeLocation}; use acvm::acir::native_types::{Witness, WitnessMap}; use acvm::{BlackBoxFunctionSolver, FieldElement}; @@ -20,6 +21,7 @@ pub struct ReplDebugger<'a, B: BlackBoxFunctionSolver> { debug_artifact: &'a DebugArtifact, initial_witness: WitnessMap, last_result: DebugCommandResult, + unconstrained_functions: &'a [BrilligBytecode], } impl<'a, B: BlackBoxFunctionSolver> ReplDebugger<'a, B> { @@ -28,6 +30,7 @@ impl<'a, B: BlackBoxFunctionSolver> ReplDebugger<'a, B> { circuit: &'a Circuit, debug_artifact: &'a DebugArtifact, initial_witness: WitnessMap, + unconstrained_functions: &'a [BrilligBytecode], ) -> Self { let foreign_call_executor = Box::new(DefaultDebugForeignCallExecutor::from_artifact(true, debug_artifact)); @@ -37,6 +40,7 @@ impl<'a, B: BlackBoxFunctionSolver> ReplDebugger<'a, B> { debug_artifact, initial_witness.clone(), foreign_call_executor, + unconstrained_functions, ); let last_result = if context.get_current_opcode_location().is_none() { // handle circuit with no opcodes @@ -44,7 +48,15 @@ impl<'a, B: BlackBoxFunctionSolver> ReplDebugger<'a, B> { } else { DebugCommandResult::Ok }; - Self { context, blackbox_solver, circuit, debug_artifact, initial_witness, last_result } + Self { + context, + blackbox_solver, + circuit, + debug_artifact, + initial_witness, + last_result, + unconstrained_functions, + } } pub fn show_current_vm_status(&self) { @@ -271,6 +283,7 @@ impl<'a, B: BlackBoxFunctionSolver> ReplDebugger<'a, B> { self.debug_artifact, self.initial_witness.clone(), foreign_call_executor, + self.unconstrained_functions, ); for opcode_location in breakpoints { self.context.add_breakpoint(opcode_location); @@ -361,9 +374,15 @@ pub fn run( circuit: &Circuit, debug_artifact: &DebugArtifact, initial_witness: WitnessMap, + unconstrained_functions: &[BrilligBytecode], ) -> Result, NargoError> { - let context = - RefCell::new(ReplDebugger::new(blackbox_solver, circuit, debug_artifact, initial_witness)); + let context = RefCell::new(ReplDebugger::new( + blackbox_solver, + circuit, + debug_artifact, + initial_witness, + unconstrained_functions, + )); let ref_context = &context; ref_context.borrow().show_current_vm_status(); diff --git a/noir/noir-repo/tooling/nargo/src/ops/execute.rs b/noir/noir-repo/tooling/nargo/src/ops/execute.rs index 5ee0c6a3891..c2c0208b395 100644 --- a/noir/noir-repo/tooling/nargo/src/ops/execute.rs +++ b/noir/noir-repo/tooling/nargo/src/ops/execute.rs @@ -1,3 +1,4 @@ +use acvm::acir::circuit::brillig::BrilligBytecode; use acvm::acir::circuit::Program; use acvm::acir::native_types::WitnessStack; use acvm::brillig_vm::brillig::ForeignCallResult; @@ -12,6 +13,9 @@ use super::foreign_calls::{ForeignCallExecutor, NargoForeignCallResult}; struct ProgramExecutor<'a, B: BlackBoxFunctionSolver, F: ForeignCallExecutor> { functions: &'a [Circuit], + + unconstrained_functions: &'a [BrilligBytecode], + // This gets built as we run through the program looking at each function call witness_stack: WitnessStack, @@ -23,11 +27,13 @@ struct ProgramExecutor<'a, B: BlackBoxFunctionSolver, F: ForeignCallExecutor> { impl<'a, B: BlackBoxFunctionSolver, F: ForeignCallExecutor> ProgramExecutor<'a, B, F> { fn new( functions: &'a [Circuit], + unconstrained_functions: &'a [BrilligBytecode], blackbox_solver: &'a B, foreign_call_executor: &'a mut F, ) -> Self { ProgramExecutor { functions, + unconstrained_functions, witness_stack: WitnessStack::default(), blackbox_solver, foreign_call_executor, @@ -44,7 +50,12 @@ impl<'a, B: BlackBoxFunctionSolver, F: ForeignCallExecutor> ProgramExecutor<'a, circuit: &Circuit, initial_witness: WitnessMap, ) -> Result { - let mut acvm = ACVM::new(self.blackbox_solver, &circuit.opcodes, initial_witness); + let mut acvm = ACVM::new( + self.blackbox_solver, + &circuit.opcodes, + initial_witness, + self.unconstrained_functions, + ); // This message should be resolved by a nargo foreign call only when we have an unsatisfied assertion. let mut assert_message: Option = None; @@ -151,8 +162,12 @@ pub fn execute_program( ) -> Result { let main = &program.functions[0]; - let mut executor = - ProgramExecutor::new(&program.functions, blackbox_solver, foreign_call_executor); + let mut executor = ProgramExecutor::new( + &program.functions, + &program.unconstrained_functions, + blackbox_solver, + foreign_call_executor, + ); let main_witness = executor.execute_circuit(main, initial_witness)?; executor.witness_stack.push(0, main_witness); diff --git a/noir/noir-repo/tooling/nargo_cli/src/cli/debug_cmd.rs b/noir/noir-repo/tooling/nargo_cli/src/cli/debug_cmd.rs index 4f3e2886b2e..5a9a33c0acd 100644 --- a/noir/noir-repo/tooling/nargo_cli/src/cli/debug_cmd.rs +++ b/noir/noir-repo/tooling/nargo_cli/src/cli/debug_cmd.rs @@ -242,6 +242,7 @@ pub(crate) fn debug_program( &compiled_program.program.functions[0], debug_artifact, initial_witness, + &compiled_program.program.unconstrained_functions, ) .map_err(CliError::from) } diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index abea48aef02..f3833975def 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,7 +68,7 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x1d2c645a18ab4d81672dd779bf1ea4fa2c0b4a2f09bf59d3fb4ee408299d00b2n; +export const DEPLOYER_CONTRACT_ADDRESS = 0x2b9c3612fc04623512ab47f68537c7b63a90b3efcc39f622f42d1820bfeb93acn; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; From 86d8176279fdc07d3b0eed91f226985e2b15f54e Mon Sep 17 00:00:00 2001 From: Alex Gherghisan Date: Tue, 16 Apr 2024 22:06:13 +0100 Subject: [PATCH 40/56] fix: set gas settings in bench (#5796) Set non-empty gas settings on benchmark txs --- .circleci/config.yml | 22 +++++++++---------- .../src/benchmarks/bench_tx_size_fees.test.ts | 10 +++++++-- 2 files changed, 19 insertions(+), 13 deletions(-) diff --git a/.circleci/config.yml b/.circleci/config.yml index fd4aec7d778..6b4c8af64ae 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -551,15 +551,15 @@ jobs: aztec_manifest_key: end-to-end <<: *defaults_e2e_test - # bench-tx-size: - # steps: - # - *checkout - # - *setup_env - # - run: - # name: "Benchmark" - # command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees - # aztec_manifest_key: end-to-end - # <<: *defaults_e2e_test + bench-tx-size: + steps: + - *checkout + - *setup_env + - run: + name: "Benchmark" + command: cond_spot_run_compose end-to-end 4 ./scripts/docker-compose-no-sandbox.yml TEST=benchmarks/bench_tx_size_fees.test.ts ENABLE_GAS=1 DEBUG=aztec:benchmarks:*,aztec:sequencer,aztec:sequencer:*,aztec:world_state,aztec:merkle_trees + aztec_manifest_key: end-to-end + <<: *defaults_e2e_test build-docs: machine: @@ -900,12 +900,12 @@ workflows: # Benchmark jobs. - bench-publish-rollup: *e2e_test - bench-process-history: *e2e_test - # - bench-tx-size: *e2e_test + - bench-tx-size: *e2e_test - bench-summary: requires: - bench-publish-rollup - bench-process-history - # - bench-tx-size + - bench-tx-size <<: *defaults # Production releases. diff --git a/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts b/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts index 2d4009042a0..c2bbcc8ceb8 100644 --- a/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts +++ b/yarn-project/end-to-end/src/benchmarks/bench_tx_size_fees.test.ts @@ -8,7 +8,7 @@ import { PublicFeePaymentMethod, TxStatus, } from '@aztec/aztec.js'; -import { GasSettings } from '@aztec/circuits.js'; +import { Fr, GasSettings } from '@aztec/circuits.js'; import { FPCContract, GasTokenContract, TokenContract } from '@aztec/noir-contracts.js'; import { getCanonicalGasTokenAddress } from '@aztec/protocol-contracts/gas-token'; @@ -68,9 +68,15 @@ describe('benchmarks/tx_size_fees', () => { () => Promise.resolve(new PrivateFeePaymentMethod(token.address, fpc.address, aliceWallet)), ])('sends a tx with a fee', async createPaymentMethod => { const paymentMethod = await createPaymentMethod(); + const gasSettings = GasSettings.new({ + da: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l1: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + l2: { gasLimit: 5, teardownGasLimit: 3, maxFeePerGas: Fr.ONE }, + inclusionFee: new Fr(6), + }); const tx = await token.methods .transfer(aliceWallet.getAddress(), bobAddress, 1n, 0) - .send({ fee: paymentMethod ? { gasSettings: GasSettings.empty(), paymentMethod } : undefined }) + .send({ fee: paymentMethod ? { gasSettings, paymentMethod } : undefined }) .wait(); expect(tx.status).toEqual(TxStatus.MINED); From 3fb94c0cd5ffba20a99b97c0088ae5ef357c205d Mon Sep 17 00:00:00 2001 From: Maxim Vezenov Date: Tue, 16 Apr 2024 23:26:03 +0100 Subject: [PATCH 41/56] chore: Use BrilligCall for unconstrained main and update AVM transpiler (#5797) A follow-up to https://github.com/AztecProtocol/aztec-packages/pull/5737 Separate PR as this touches mainly the AVM transpiler and not Noir codegen itself. Look in PR #5737 for full details about the switch, but basically we are moving away from the `Brillig` opcode to a `BrilligCall` opcode that contains a Brillig call opcode. The AVM needs to be updated to account for this change. --- avm-transpiler/src/transpile.rs | 20 ++++---- avm-transpiler/src/transpile_contract.rs | 6 +-- avm-transpiler/src/utils.rs | 47 ++++++++++++------- .../noirc_evaluator/src/ssa/acir_gen/mod.rs | 8 +++- yarn-project/circuits.js/src/constants.gen.ts | 2 +- 5 files changed, 51 insertions(+), 32 deletions(-) diff --git a/avm-transpiler/src/transpile.rs b/avm-transpiler/src/transpile.rs index 0de09a5793c..fda785f1ff9 100644 --- a/avm-transpiler/src/transpile.rs +++ b/avm-transpiler/src/transpile.rs @@ -1,5 +1,4 @@ use acvm::acir::brillig::Opcode as BrilligOpcode; -use acvm::acir::circuit::brillig::Brillig; use acvm::brillig_vm::brillig::{ BinaryFieldOp, BinaryIntOp, BlackBoxOp, HeapArray, HeapVector, MemoryAddress, ValueOrArray, @@ -14,17 +13,17 @@ use crate::opcodes::AvmOpcode; use crate::utils::{dbg_print_avm_program, dbg_print_brillig_program}; /// Transpile a Brillig program to AVM bytecode -pub fn brillig_to_avm(brillig: &Brillig) -> Vec { - dbg_print_brillig_program(brillig); +pub fn brillig_to_avm(brillig_bytecode: &[BrilligOpcode]) -> Vec { + dbg_print_brillig_program(brillig_bytecode); let mut avm_instrs: Vec = Vec::new(); // Map Brillig pcs to AVM pcs // (some Brillig instructions map to >1 AVM instruction) - let brillig_pcs_to_avm_pcs = map_brillig_pcs_to_avm_pcs(avm_instrs.len(), brillig); + let brillig_pcs_to_avm_pcs = map_brillig_pcs_to_avm_pcs(avm_instrs.len(), brillig_bytecode); // Transpile a Brillig instruction to one or more AVM instructions - for brillig_instr in &brillig.bytecode { + for brillig_instr in brillig_bytecode { match brillig_instr { BrilligOpcode::BinaryFieldOp { destination, @@ -1090,12 +1089,15 @@ fn handle_storage_read( /// brillig: the Brillig program /// returns: an array where each index is a Brillig pc, /// and each value is the corresponding AVM pc. -fn map_brillig_pcs_to_avm_pcs(initial_offset: usize, brillig: &Brillig) -> Vec { - let mut pc_map = vec![0; brillig.bytecode.len()]; +fn map_brillig_pcs_to_avm_pcs( + initial_offset: usize, + brillig_bytecode: &[BrilligOpcode], +) -> Vec { + let mut pc_map = vec![0; brillig_bytecode.len()]; pc_map[0] = initial_offset; - for i in 0..brillig.bytecode.len() - 1 { - let num_avm_instrs_for_this_brillig_instr = match &brillig.bytecode[i] { + for i in 0..brillig_bytecode.len() - 1 { + let num_avm_instrs_for_this_brillig_instr = match &brillig_bytecode[i] { BrilligOpcode::Const { bit_size: 254, .. } => 2, _ => 1, }; diff --git a/avm-transpiler/src/transpile_contract.rs b/avm-transpiler/src/transpile_contract.rs index 537dfb34bb3..e28b20aa4a3 100644 --- a/avm-transpiler/src/transpile_contract.rs +++ b/avm-transpiler/src/transpile_contract.rs @@ -5,7 +5,7 @@ use serde::{Deserialize, Serialize}; use acvm::acir::circuit::Program; use crate::transpile::brillig_to_avm; -use crate::utils::extract_brillig_from_acir; +use crate::utils::extract_brillig_from_acir_program; /// Representation of a contract with some transpiled functions #[derive(Debug, Serialize, Deserialize)] @@ -88,10 +88,10 @@ impl From for TranspiledContract { ); // Extract Brillig Opcodes from acir let acir_program = function.bytecode; - let brillig = extract_brillig_from_acir(&acir_program.functions[0].opcodes); + let brillig_bytecode = extract_brillig_from_acir_program(&acir_program); // Transpile to AVM - let avm_bytecode = brillig_to_avm(brillig); + let avm_bytecode = brillig_to_avm(brillig_bytecode); // Push modified function entry to ABI functions.push(AvmOrAcirContractFunction::Avm(AvmContractFunction { diff --git a/avm-transpiler/src/utils.rs b/avm-transpiler/src/utils.rs index 684dde7b6e4..97667a386c0 100644 --- a/avm-transpiler/src/utils.rs +++ b/avm-transpiler/src/utils.rs @@ -1,33 +1,46 @@ use log::debug; -use acvm::acir::circuit::brillig::Brillig; -use acvm::acir::circuit::Opcode; +use acvm::acir::brillig::Opcode as BrilligOpcode; +use acvm::acir::circuit::{Opcode, Program}; use crate::instructions::AvmInstruction; -/// Extract the Brillig program from its ACIR wrapper instruction. -/// An Noir unconstrained function compiles to one ACIR instruction -/// wrapping a Brillig program. This function just extracts that Brillig -/// assuming the 0th ACIR opcode is the wrapper. -pub fn extract_brillig_from_acir(opcodes: &Vec) -> &Brillig { - if opcodes.len() != 1 { - panic!("An AVM program should be contained entirely in only a single ACIR opcode flagged as 'Brillig'"); - } - let opcode = &opcodes[0]; - match opcode { - Opcode::Brillig(brillig) => brillig, +/// Extract the Brillig program from its `Program` wrapper. +/// Noir entry point unconstrained functions are compiled to their own list contained +/// as part of a full program. Function calls are then accessed through a function +/// pointer opcode in ACIR that fetches those unconstrained functions from the main list. +/// This function just extracts Brillig bytecode, with the assumption that the +/// 0th unconstrained function in the full `Program` structure. +pub fn extract_brillig_from_acir_program(program: &Program) -> &[BrilligOpcode] { + assert_eq!( + program.functions.len(), + 1, + "An AVM program should have only a single ACIR function flagged as 'BrilligCall'" + ); + let opcodes = &program.functions[0].opcodes; + assert_eq!( + opcodes.len(), + 1, + "An AVM program should have only a single ACIR function flagged as 'BrilligCall'" + ); + match opcodes[0] { + Opcode::BrilligCall { .. } => {} _ => panic!("Tried to extract a Brillig program from its ACIR wrapper opcode, but the opcode doesn't contain Brillig!"), } + assert_eq!( + program.unconstrained_functions.len(), + 1, + "An AVM program should be contained entirely in only a single `Brillig` function" + ); + &program.unconstrained_functions[0].bytecode } /// Print inputs, outputs, and instructions in a Brillig program -pub fn dbg_print_brillig_program(brillig: &Brillig) { +pub fn dbg_print_brillig_program(brillig_bytecode: &[BrilligOpcode]) { debug!("Printing Brillig program..."); - debug!("\tInputs: {:?}", brillig.inputs); - for (i, instruction) in brillig.bytecode.iter().enumerate() { + for (i, instruction) in brillig_bytecode.iter().enumerate() { debug!("\tPC:{0} {1:?}", i, instruction); } - debug!("\tOutputs: {:?}", brillig.outputs); } /// Print each instruction in an AVM program diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs index afd749485d7..8019707644b 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs @@ -360,14 +360,18 @@ impl<'a> Context<'a> { // We specifically do not attempt execution of the brillig code being generated as this can result in it being // replaced with constraints on witnesses to the program outputs. - let output_values = self.acir_context.brillig( + let output_values = self.acir_context.brillig_call( self.current_side_effects_enabled_var, - code, + &code, inputs, outputs, false, true, + // We are guaranteed to have a Brillig function pointer of `0` as main itself is marked as unconstrained + 0, )?; + self.shared_context.insert_generated_brillig(main_func.id(), 0, code); + let output_vars: Vec<_> = output_values .iter() .flat_map(|value| value.clone().flatten()) diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index f3833975def..223a3361fb4 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -68,7 +68,7 @@ export const REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af816635466f128568edb04c9fa024f6c87fb9010fdbffa68b3d99n; export const DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631n; -export const DEPLOYER_CONTRACT_ADDRESS = 0x2b9c3612fc04623512ab47f68537c7b63a90b3efcc39f622f42d1820bfeb93acn; +export const DEPLOYER_CONTRACT_ADDRESS = 0x0b98aeb0111208b95d8d71f484f849d7ab44b3e34c545d13736a707ce3cb0839n; export const L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; export const MAX_NOTE_FIELDS_LENGTH = 20; export const GET_NOTE_ORACLE_RETURN_LENGTH = 23; From 8afab01abb097870e67554b96443e7020aee1dcf Mon Sep 17 00:00:00 2001 From: AztecBot Date: Wed, 17 Apr 2024 02:09:44 +0000 Subject: [PATCH 42/56] git subrepo push --branch=master barretenberg subrepo: subdir: "barretenberg" merged: "ed310b6d7" upstream: origin: "https://github.com/AztecProtocol/barretenberg" branch: "master" commit: "ed310b6d7" git-subrepo: version: "0.4.6" origin: "???" commit: "???" [skip ci] --- barretenberg/.gitrepo | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/barretenberg/.gitrepo b/barretenberg/.gitrepo index 27488d86f2f..107719b5a24 100644 --- a/barretenberg/.gitrepo +++ b/barretenberg/.gitrepo @@ -6,7 +6,7 @@ [subrepo] remote = https://github.com/AztecProtocol/barretenberg branch = master - commit = b2e6d246e25276e190c3ae8f6895d31f843d498a - parent = 37daac6a4547d70d06714e1cd727eddbe297cf64 + commit = ed310b6d7e43b47913afacb717513cd4ff2d57dd + parent = 3fb94c0cd5ffba20a99b97c0088ae5ef357c205d method = merge cmdver = 0.4.6 From ce4a010c7c075cb68bed91e0123d4fcecc7c6938 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Wed, 17 Apr 2024 02:10:12 +0000 Subject: [PATCH 43/56] chore: replace relative paths to noir-protocol-circuits --- noir-projects/aztec-nr/aztec/Nargo.toml | 2 +- noir-projects/aztec-nr/tests/Nargo.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/noir-projects/aztec-nr/aztec/Nargo.toml b/noir-projects/aztec-nr/aztec/Nargo.toml index 7a1f1af5863..2cbb43ab278 100644 --- a/noir-projects/aztec-nr/aztec/Nargo.toml +++ b/noir-projects/aztec-nr/aztec/Nargo.toml @@ -5,4 +5,4 @@ compiler_version = ">=0.18.0" type = "lib" [dependencies] -protocol_types = { path = "../../noir-protocol-circuits/crates/types" } +protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.35.1", directory="noir-projects/noir-protocol-circuits/crates/types" } diff --git a/noir-projects/aztec-nr/tests/Nargo.toml b/noir-projects/aztec-nr/tests/Nargo.toml index 13404b37324..dfed895aad0 100644 --- a/noir-projects/aztec-nr/tests/Nargo.toml +++ b/noir-projects/aztec-nr/tests/Nargo.toml @@ -6,4 +6,4 @@ type = "lib" [dependencies] aztec = { path = "../aztec" } -protocol_types = { path = "../../noir-protocol-circuits/crates/types" } +protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.35.1", directory="noir-projects/noir-protocol-circuits/crates/types" } From 41559b0efc3968a2e36961c40828ee1c1a4cae4c Mon Sep 17 00:00:00 2001 From: AztecBot Date: Wed, 17 Apr 2024 02:10:12 +0000 Subject: [PATCH 44/56] git_subrepo.sh: Fix parent in .gitrepo file. [skip ci] --- noir-projects/aztec-nr/.gitrepo | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/noir-projects/aztec-nr/.gitrepo b/noir-projects/aztec-nr/.gitrepo index 8e79a269c16..447d520b9dc 100644 --- a/noir-projects/aztec-nr/.gitrepo +++ b/noir-projects/aztec-nr/.gitrepo @@ -9,4 +9,4 @@ commit = 28ec9ab7a3430095c0b615ef097362c9860dac3e method = merge cmdver = 0.4.6 - parent = a51c725ab39fc2fe436e1be0d19c37866c7caa2e + parent = c3a9085ed3e0e7cc97d7b36a24bbc71fb5846786 From fd720cc74fdeeb0a2a22255b2455dbace61d75d9 Mon Sep 17 00:00:00 2001 From: AztecBot Date: Wed, 17 Apr 2024 02:10:16 +0000 Subject: [PATCH 45/56] git subrepo push --branch=master noir-projects/aztec-nr subrepo: subdir: "noir-projects/aztec-nr" merged: "b3b3b3c17" upstream: origin: "https://github.com/AztecProtocol/aztec-nr" branch: "master" commit: "b3b3b3c17" git-subrepo: version: "0.4.6" origin: "???" commit: "???" [skip ci] --- noir-projects/aztec-nr/.gitrepo | 4 ++-- noir-projects/aztec-nr/aztec/Nargo.toml | 2 +- noir-projects/aztec-nr/tests/Nargo.toml | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/noir-projects/aztec-nr/.gitrepo b/noir-projects/aztec-nr/.gitrepo index 447d520b9dc..a2e45aaf6bc 100644 --- a/noir-projects/aztec-nr/.gitrepo +++ b/noir-projects/aztec-nr/.gitrepo @@ -6,7 +6,7 @@ [subrepo] remote = https://github.com/AztecProtocol/aztec-nr branch = master - commit = 28ec9ab7a3430095c0b615ef097362c9860dac3e + commit = b3b3b3c175697928e729895da32681c72e08912b method = merge cmdver = 0.4.6 - parent = c3a9085ed3e0e7cc97d7b36a24bbc71fb5846786 + parent = b8d73dd57ffae1c5b63cb4bd7364c2038af49f50 diff --git a/noir-projects/aztec-nr/aztec/Nargo.toml b/noir-projects/aztec-nr/aztec/Nargo.toml index 2cbb43ab278..7a1f1af5863 100644 --- a/noir-projects/aztec-nr/aztec/Nargo.toml +++ b/noir-projects/aztec-nr/aztec/Nargo.toml @@ -5,4 +5,4 @@ compiler_version = ">=0.18.0" type = "lib" [dependencies] -protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.35.1", directory="noir-projects/noir-protocol-circuits/crates/types" } +protocol_types = { path = "../../noir-protocol-circuits/crates/types" } diff --git a/noir-projects/aztec-nr/tests/Nargo.toml b/noir-projects/aztec-nr/tests/Nargo.toml index dfed895aad0..13404b37324 100644 --- a/noir-projects/aztec-nr/tests/Nargo.toml +++ b/noir-projects/aztec-nr/tests/Nargo.toml @@ -6,4 +6,4 @@ type = "lib" [dependencies] aztec = { path = "../aztec" } -protocol_types = { git="https://github.com/AztecProtocol/aztec-packages", tag="aztec-packages-v0.35.1", directory="noir-projects/noir-protocol-circuits/crates/types" } +protocol_types = { path = "../../noir-protocol-circuits/crates/types" } From 23d0070095bf7d32cfdcf97e7aea348753bb7492 Mon Sep 17 00:00:00 2001 From: Facundo Date: Wed, 17 Apr 2024 11:20:01 +0100 Subject: [PATCH 46/56] chore(avm): more test cleanup (#5771) --- .../simulator/src/avm/avm_simulator.test.ts | 42 +++++++++++-------- 1 file changed, 25 insertions(+), 17 deletions(-) diff --git a/yarn-project/simulator/src/avm/avm_simulator.test.ts b/yarn-project/simulator/src/avm/avm_simulator.test.ts index 051c3432de3..6eeb992c72e 100644 --- a/yarn-project/simulator/src/avm/avm_simulator.test.ts +++ b/yarn-project/simulator/src/avm/avm_simulator.test.ts @@ -136,23 +136,11 @@ describe('AVM simulator: transpiled Noir contracts', () => { }); describe.each([ - [ - 'sha256_hash', - /*input=*/ randomMemoryBytes(10), - /*output=*/ (bytes: Uint8[]) => [...sha256(Buffer.concat(bytes.map(b => b.toBuffer())))].map(b => new Fr(b)), - ], - [ - 'keccak_hash', - /*input=*/ randomMemoryBytes(10), - /*output=*/ (bytes: Uint8[]) => [...keccak256(Buffer.concat(bytes.map(b => b.toBuffer())))].map(b => new Fr(b)), - ], - ['poseidon2_hash', /*input=*/ randomMemoryFields(10), /*output=*/ (fields: Fieldable[]) => [poseidon2Hash(fields)]], - ['pedersen_hash', /*input=*/ randomMemoryFields(10), /*output=*/ (fields: Fieldable[]) => [pedersenHash(fields)]], - [ - 'pedersen_hash_with_index', - /*input=*/ randomMemoryFields(10), - /*output=*/ (fields: Fieldable[]) => [pedersenHash(fields, /*index=*/ 20)], - ], + ['sha256_hash', /*input=*/ randomMemoryBytes(10), /*output=*/ sha256FromMemoryBytes], + ['keccak_hash', /*input=*/ randomMemoryBytes(10), /*output=*/ keccak256FromMemoryBytes], + ['poseidon2_hash', /*input=*/ randomMemoryFields(10), /*output=*/ poseidon2FromMemoryFields], + ['pedersen_hash', /*input=*/ randomMemoryFields(10), /*output=*/ pedersenFromMemoryFields], + ['pedersen_hash_with_index', /*input=*/ randomMemoryFields(10), /*output=*/ indexedPedersenFromMemoryFields], ])('Hashes in noir contracts', (name: string, input: MemoryValue[], output: (msg: any[]) => Fr[]) => { it(`Should execute contract function that performs ${name}`, async () => { const calldata = input.map(e => e.toFr()); @@ -929,3 +917,23 @@ function getAvmNestedCallsTestContractBytecode(functionName: string): Buffer { ); return artifact.bytecode; } + +function sha256FromMemoryBytes(bytes: Uint8[]): Fr[] { + return [...sha256(Buffer.concat(bytes.map(b => b.toBuffer())))].map(b => new Fr(b)); +} + +function keccak256FromMemoryBytes(bytes: Uint8[]): Fr[] { + return [...keccak256(Buffer.concat(bytes.map(b => b.toBuffer())))].map(b => new Fr(b)); +} + +function poseidon2FromMemoryFields(fields: Fieldable[]): Fr[] { + return [poseidon2Hash(fields)]; +} + +function pedersenFromMemoryFields(fields: Fieldable[]): Fr[] { + return [pedersenHash(fields)]; +} + +function indexedPedersenFromMemoryFields(fields: Fieldable[]): Fr[] { + return [pedersenHash(fields, /*index=*/ 20)]; +} From 03e693a0db52a0c0b02c403f9ded2e28f3c7ced2 Mon Sep 17 00:00:00 2001 From: Lasse Herskind <16536249+LHerskind@users.noreply.github.com> Date: Wed, 17 Apr 2024 11:24:51 +0100 Subject: [PATCH 47/56] feat: decoded return values (#5762) Fixes #5450. Alters the typescript contract artifact slightly to have the proper return types of functions such that it can be used when simulating the contract interaction and return the decoded values. Allows us to get rid of some of the `unconstrained` function calls as we can simply use the constrained version instead, this is very interesting for the tokens or anything that have values that is expected to be read from multiple domains as it limits the code. ```rust #[aztec(private)] fn get_shared_immutable_constrained_private() -> pub Leader { storage.shared_immutable.read_private() } ``` ```typescript const a = await contract.methods.get_shared_immutable_constrained_private().simulate(); const b = await contract.methods.get_shared_immutable().simulate(); expect(a).toEqual(b); ``` --- .../docs_example_contract/src/main.nr | 20 ++++++++-- .../aztec-node/src/aztec-node/server.ts | 2 +- .../contract/contract_function_interaction.ts | 15 +++----- .../src/interfaces/aztec-node.ts | 5 +-- yarn-project/circuit-types/src/mocks.ts | 6 +-- .../circuit-types/src/tx/simulated_tx.test.ts | 7 ++++ .../circuit-types/src/tx/simulated_tx.ts | 38 ++++++------------- .../end-to-end/src/e2e_avm_simulator.test.ts | 8 ++-- .../end-to-end/src/e2e_state_vars.test.ts | 27 +++++++------ yarn-project/foundation/src/abi/decoder.ts | 7 ++-- .../pxe/src/pxe_service/pxe_service.ts | 5 +-- .../simulator/src/client/execution_result.ts | 5 +-- .../src/client/private_execution.test.ts | 28 ++++++-------- .../simulator/src/client/private_execution.ts | 9 +---- .../src/public/abstract_phase_manager.ts | 23 ++--------- .../simulator/src/public/avm_executor.test.ts | 4 +- .../simulator/src/public/public_processor.ts | 2 +- .../types/src/abi/contract_artifact.ts | 24 ++++++++++-- 18 files changed, 113 insertions(+), 122 deletions(-) diff --git a/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr b/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr index ae0d5e3d40a..6284c1af9a5 100644 --- a/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr @@ -115,10 +115,13 @@ contract DocsExample { // and returns the response. // Used to test that we can retrieve values through calls and // correctly return them in the simulation - context.call_private_function_no_args( + let mut leader: Leader = context.call_private_function_no_args( context.this_address(), FunctionSelector::from_signature("get_shared_immutable_constrained_private()") - ).unpack_into() + ).unpack_into(); + + leader.points += 1; + leader } #[aztec(public)] @@ -127,10 +130,13 @@ contract DocsExample { // and returns the response. // Used to test that we can retrieve values through calls and // correctly return them in the simulation - context.call_public_function_no_args( + let mut leader: Leader = context.call_public_function_no_args( context.this_address(), FunctionSelector::from_signature("get_shared_immutable_constrained_public()") - ).deserialize_into() + ).deserialize_into(); + + leader.points += 1; + leader } #[aztec(public)] @@ -138,6 +144,12 @@ contract DocsExample { storage.shared_immutable.read_public() } + #[aztec(public)] + fn get_shared_immutable_constrained_public_multiple() -> pub [Leader; 5] { + let a = storage.shared_immutable.read_public(); + [a, a, a, a, a] + } + #[aztec(private)] fn get_shared_immutable_constrained_private() -> pub Leader { storage.shared_immutable.read_private() diff --git a/yarn-project/aztec-node/src/aztec-node/server.ts b/yarn-project/aztec-node/src/aztec-node/server.ts index 7658dd95029..d0bfaa8ff32 100644 --- a/yarn-project/aztec-node/src/aztec-node/server.ts +++ b/yarn-project/aztec-node/src/aztec-node/server.ts @@ -671,7 +671,7 @@ export class AztecNodeService implements AztecNode { throw reverted[0].revertReason; } this.log.info(`Simulated tx ${tx.getTxHash()} succeeds`); - return returns; + return returns[0]; } public setConfig(config: Partial): Promise { diff --git a/yarn-project/aztec.js/src/contract/contract_function_interaction.ts b/yarn-project/aztec.js/src/contract/contract_function_interaction.ts index 5f8033124db..f0c2a9e3578 100644 --- a/yarn-project/aztec.js/src/contract/contract_function_interaction.ts +++ b/yarn-project/aztec.js/src/contract/contract_function_interaction.ts @@ -1,6 +1,6 @@ import { type FunctionCall, PackedValues, TxExecutionRequest } from '@aztec/circuit-types'; import { type AztecAddress, FunctionData, GasSettings, TxContext } from '@aztec/circuits.js'; -import { type FunctionAbi, FunctionType, encodeArguments } from '@aztec/foundation/abi'; +import { type FunctionAbi, FunctionType, decodeReturnValues, encodeArguments } from '@aztec/foundation/abi'; import { type Wallet } from '../account/wallet.js'; import { BaseContractInteraction, type SendMethodOptions } from './base_contract_interaction.js'; @@ -73,7 +73,6 @@ export class ContractFunctionInteraction extends BaseContractInteraction { * 2. It supports `unconstrained`, `private` and `public` functions * 3. For `private` execution it: * 3.a SKIPS the entrypoint and starts directly at the function - * 3.b SKIPS public execution entirely * 4. For `public` execution it: * 4.a Removes the `txRequest` value after ended simulation * 4.b Ignores the `from` in the options @@ -86,10 +85,6 @@ export class ContractFunctionInteraction extends BaseContractInteraction { return this.wallet.viewTx(this.functionDao.name, this.args, this.contractAddress, options.from); } - // TODO: If not unconstrained, we return a size 4 array of fields. - // TODO: It should instead return the correctly decoded value - // TODO: The return type here needs to be fixed! @LHerskind - if (this.functionDao.functionType == FunctionType.SECRET) { const nodeInfo = await this.wallet.getNodeInfo(); const packedArgs = PackedValues.fromValues(encodeArguments(this.functionDao, this.args)); @@ -103,13 +98,15 @@ export class ContractFunctionInteraction extends BaseContractInteraction { authWitnesses: [], gasSettings: options.gasSettings ?? GasSettings.simulation(), }); - const simulatedTx = await this.pxe.simulateTx(txRequest, false, options.from ?? this.wallet.getAddress()); - return simulatedTx.privateReturnValues?.[0]; + const simulatedTx = await this.pxe.simulateTx(txRequest, true, options.from ?? this.wallet.getAddress()); + const flattened = simulatedTx.privateReturnValues; + return flattened ? decodeReturnValues(this.functionDao, flattened) : []; } else { const txRequest = await this.create(); const simulatedTx = await this.pxe.simulateTx(txRequest, true); this.txRequest = undefined; - return simulatedTx.publicReturnValues?.[0]; + const flattened = simulatedTx.publicReturnValues; + return flattened ? decodeReturnValues(this.functionDao, flattened) : []; } } } diff --git a/yarn-project/circuit-types/src/interfaces/aztec-node.ts b/yarn-project/circuit-types/src/interfaces/aztec-node.ts index 918630b042e..03e9ddbff8a 100644 --- a/yarn-project/circuit-types/src/interfaces/aztec-node.ts +++ b/yarn-project/circuit-types/src/interfaces/aztec-node.ts @@ -7,7 +7,6 @@ import { type PUBLIC_DATA_TREE_HEIGHT, } from '@aztec/circuits.js'; import { type L1ContractAddresses } from '@aztec/ethereum'; -import { type ProcessReturnValues } from '@aztec/foundation/abi'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { type Fr } from '@aztec/foundation/fields'; import { type ContractClassPublic, type ContractInstanceWithAddress } from '@aztec/types/contracts'; @@ -22,7 +21,7 @@ import { } from '../logs/index.js'; import { type MerkleTreeId } from '../merkle_tree_id.js'; import { type SiblingPath } from '../sibling_path/index.js'; -import { type Tx, type TxHash, type TxReceipt } from '../tx/index.js'; +import { type ProcessReturnValues, type Tx, type TxHash, type TxReceipt } from '../tx/index.js'; import { type TxEffect } from '../tx_effect.js'; import { type SequencerConfig } from './configs.js'; import { type L2BlockNumber } from './l2_block_number.js'; @@ -283,7 +282,7 @@ export interface AztecNode { * This currently just checks that the transaction execution succeeds. * @param tx - The transaction to simulate. **/ - simulatePublicCalls(tx: Tx): Promise; + simulatePublicCalls(tx: Tx): Promise; /** * Updates the configuration of this node. diff --git a/yarn-project/circuit-types/src/mocks.ts b/yarn-project/circuit-types/src/mocks.ts index f0b3c805ad9..73d0ccf6317 100644 --- a/yarn-project/circuit-types/src/mocks.ts +++ b/yarn-project/circuit-types/src/mocks.ts @@ -11,7 +11,7 @@ import { getContractClassFromArtifact, } from '@aztec/circuits.js'; import { makePublicCallRequest } from '@aztec/circuits.js/testing'; -import { type ContractArtifact, type DecodedReturn } from '@aztec/foundation/abi'; +import { type ContractArtifact } from '@aztec/foundation/abi'; import { makeTuple } from '@aztec/foundation/array'; import { times } from '@aztec/foundation/collection'; import { randomBytes } from '@aztec/foundation/crypto'; @@ -21,7 +21,7 @@ import { type ContractInstanceWithAddress, SerializableContractInstance } from ' import { EncryptedL2Log } from './logs/encrypted_l2_log.js'; import { EncryptedFunctionL2Logs, EncryptedTxL2Logs, Note, UnencryptedTxL2Logs } from './logs/index.js'; import { ExtendedNote } from './notes/index.js'; -import { SimulatedTx, Tx, TxHash } from './tx/index.js'; +import { type ProcessReturnValues, SimulatedTx, Tx, TxHash } from './tx/index.js'; /** * Testing utility to create empty logs composed from a single empty log. @@ -94,7 +94,7 @@ export const mockTxForRollup = (seed = 1, { hasLogs = false }: { hasLogs?: boole export const mockSimulatedTx = (seed = 1, hasLogs = true) => { const tx = mockTx(seed, { hasLogs }); - const dec: DecodedReturn = [1n, 2n, 3n, 4n]; + const dec: ProcessReturnValues = [new Fr(1n), new Fr(2n), new Fr(3n), new Fr(4n)]; return new SimulatedTx(tx, dec, dec); }; diff --git a/yarn-project/circuit-types/src/tx/simulated_tx.test.ts b/yarn-project/circuit-types/src/tx/simulated_tx.test.ts index 29cc0019477..167c91259fa 100644 --- a/yarn-project/circuit-types/src/tx/simulated_tx.test.ts +++ b/yarn-project/circuit-types/src/tx/simulated_tx.test.ts @@ -6,4 +6,11 @@ describe('simulated_tx', () => { const simulatedTx = mockSimulatedTx(); expect(SimulatedTx.fromJSON(simulatedTx.toJSON())).toEqual(simulatedTx); }); + + it('convert undefined effects to and from json', () => { + const simulatedTx = mockSimulatedTx(); + simulatedTx.privateReturnValues = undefined; + simulatedTx.publicReturnValues = undefined; + expect(SimulatedTx.fromJSON(simulatedTx.toJSON())).toEqual(simulatedTx); + }); }); diff --git a/yarn-project/circuit-types/src/tx/simulated_tx.ts b/yarn-project/circuit-types/src/tx/simulated_tx.ts index febf33cdfb4..baef7a2d4ea 100644 --- a/yarn-project/circuit-types/src/tx/simulated_tx.ts +++ b/yarn-project/circuit-types/src/tx/simulated_tx.ts @@ -1,8 +1,9 @@ -import { AztecAddress } from '@aztec/circuits.js'; -import { type ProcessReturnValues } from '@aztec/foundation/abi'; +import { Fr } from '@aztec/circuits.js'; import { Tx } from './tx.js'; +export type ProcessReturnValues = Fr[] | undefined; + export class SimulatedTx { constructor( public tx: Tx, @@ -15,17 +16,11 @@ export class SimulatedTx { * @returns A plain object with SimulatedTx properties. */ public toJSON() { - const returnToJson = (data: ProcessReturnValues): string => { - const replacer = (key: string, value: any): any => { - if (typeof value === 'bigint') { - return value.toString() + 'n'; // Indicate bigint with "n" - } else if (value instanceof AztecAddress) { - return value.toString(); - } else { - return value; - } - }; - return JSON.stringify(data, replacer); + const returnToJson = (data: ProcessReturnValues | undefined): string => { + if (data === undefined) { + return JSON.stringify(data); + } + return JSON.stringify(data.map(fr => fr.toString())); }; return { @@ -41,22 +36,11 @@ export class SimulatedTx { * @returns A Tx class object. */ public static fromJSON(obj: any) { - const returnFromJson = (json: string): ProcessReturnValues => { - if (json == undefined) { + const returnFromJson = (json: string): ProcessReturnValues | undefined => { + if (json === undefined) { return json; } - const reviver = (key: string, value: any): any => { - if (typeof value === 'string') { - if (value.match(/\d+n$/)) { - // Detect bigint serialization - return BigInt(value.slice(0, -1)); - } else if (value.match(/^0x[a-fA-F0-9]{64}$/)) { - return AztecAddress.fromString(value); - } - } - return value; - }; - return JSON.parse(json, reviver); + return JSON.parse(json).map(Fr.fromString); }; const tx = Tx.fromJSON(obj.tx); diff --git a/yarn-project/end-to-end/src/e2e_avm_simulator.test.ts b/yarn-project/end-to-end/src/e2e_avm_simulator.test.ts index 3de9f8a1b0b..1a941a6f685 100644 --- a/yarn-project/end-to-end/src/e2e_avm_simulator.test.ts +++ b/yarn-project/end-to-end/src/e2e_avm_simulator.test.ts @@ -80,15 +80,15 @@ describe('e2e_avm_simulator', () => { }, 50_000); it('Can execute ACVM function among AVM functions', async () => { - expect(await avmContract.methods.constant_field_acvm().simulate()).toEqual([123456n]); + expect(await avmContract.methods.constant_field_acvm().simulate()).toEqual(123456n); }); it('Can call AVM function from ACVM', async () => { - expect(await avmContract.methods.call_avm_from_acvm().simulate()).toEqual([123456n]); + expect(await avmContract.methods.call_avm_from_acvm().simulate()).toEqual(123456n); }); it('Can call ACVM function from AVM', async () => { - expect(await avmContract.methods.call_acvm_from_avm().simulate()).toEqual([123456n]); + expect(await avmContract.methods.call_acvm_from_avm().simulate()).toEqual(123456n); }); it('AVM sees settled nullifiers by ACVM', async () => { @@ -146,7 +146,7 @@ describe('e2e_avm_simulator', () => { describe('Storage', () => { it('Read immutable (initialized) storage (Field)', async () => { - expect(await avmContract.methods.read_storage_immutable().simulate()).toEqual([42n]); + expect(await avmContract.methods.read_storage_immutable().simulate()).toEqual(42n); }); }); }); diff --git a/yarn-project/end-to-end/src/e2e_state_vars.test.ts b/yarn-project/end-to-end/src/e2e_state_vars.test.ts index 56783ceee2e..f13ee0bd420 100644 --- a/yarn-project/end-to-end/src/e2e_state_vars.test.ts +++ b/yarn-project/end-to-end/src/e2e_state_vars.test.ts @@ -38,6 +38,7 @@ describe('e2e_state_vars', () => { // checking the return values with: // 1. A constrained private function that reads it directly // 2. A constrained private function that calls another private function that reads. + // The indirect, adds 1 to the point to ensure that we are returning the correct value. await contract.methods.initialize_shared_immutable(1).send().wait(); @@ -45,12 +46,8 @@ describe('e2e_state_vars', () => { const b = await contract.methods.get_shared_immutable_constrained_private_indirect().simulate(); const c = await contract.methods.get_shared_immutable().simulate(); - expect((a as any)[0]).toEqual((c as any)['account'].toBigInt()); - expect((a as any)[1]).toEqual((c as any)['points']); - expect((b as any)[0]).toEqual((c as any)['account'].toBigInt()); - expect((b as any)[1]).toEqual((c as any)['points']); - - expect(a).toEqual(b); + expect(a).toEqual(c); + expect(b).toEqual({ account: c.account, points: c.points + 1n }); await contract.methods.match_shared_immutable(c.account, c.points).send().wait(); }); @@ -58,20 +55,28 @@ describe('e2e_state_vars', () => { // Reads the value using an unconstrained function checking the return values with: // 1. A constrained public function that reads it directly // 2. A constrained public function that calls another public function that reads. + // The indirect, adds 1 to the point to ensure that we are returning the correct value. const a = await contract.methods.get_shared_immutable_constrained_public().simulate(); const b = await contract.methods.get_shared_immutable_constrained_public_indirect().simulate(); const c = await contract.methods.get_shared_immutable().simulate(); - expect((a as any)[0]).toEqual((c as any)['account'].toBigInt()); - expect((a as any)[1]).toEqual((c as any)['points']); - expect((b as any)[0]).toEqual((c as any)['account'].toBigInt()); - expect((b as any)[1]).toEqual((c as any)['points']); + expect(a).toEqual(c); + expect(b).toEqual({ account: c.account, points: c.points + 1n }); - expect(a).toEqual(b); await contract.methods.match_shared_immutable(c.account, c.points).send().wait(); }); + it('public multiread of SharedImmutable', async () => { + // Reads the value using an unconstrained function checking the return values with: + // 1. A constrained public function that reads 5 times directly (going beyond the previous 4 Field return value) + + const a = await contract.methods.get_shared_immutable_constrained_public_multiple().simulate(); + const c = await contract.methods.get_shared_immutable().simulate(); + + expect(a).toEqual([c, c, c, c, c]); + }); + it('initializing SharedImmutable the second time should fail', async () => { // Jest executes the tests sequentially and the first call to initialize_shared_immutable was executed // in the previous test, so the call bellow should fail. diff --git a/yarn-project/foundation/src/abi/decoder.ts b/yarn-project/foundation/src/abi/decoder.ts index deafe602ae1..c98bac63823 100644 --- a/yarn-project/foundation/src/abi/decoder.ts +++ b/yarn-project/foundation/src/abi/decoder.ts @@ -1,20 +1,19 @@ import { AztecAddress } from '../aztec-address/index.js'; import { type Fr } from '../fields/index.js'; -import { type ABIParameter, type ABIVariable, type AbiType, type FunctionArtifact } from './abi.js'; +import { type ABIParameter, type ABIVariable, type AbiType, type FunctionAbi } from './abi.js'; import { isAztecAddressStruct } from './utils.js'; /** * The type of our decoded ABI. */ export type DecodedReturn = bigint | boolean | AztecAddress | DecodedReturn[] | { [key: string]: DecodedReturn }; -export type ProcessReturnValues = (DecodedReturn | undefined)[] | undefined; /** * Decodes return values from a function call. * Missing support for integer and string. */ class ReturnValuesDecoder { - constructor(private artifact: FunctionArtifact, private flattened: Fr[]) {} + constructor(private artifact: FunctionAbi, private flattened: Fr[]) {} /** * Decodes a single return value from field to the given type. @@ -97,7 +96,7 @@ class ReturnValuesDecoder { * @param returnValues - The decoded return values. * @returns */ -export function decodeReturnValues(abi: FunctionArtifact, returnValues: Fr[]) { +export function decodeReturnValues(abi: FunctionAbi, returnValues: Fr[]) { return new ReturnValuesDecoder(abi, returnValues.slice()).decode(); } diff --git a/yarn-project/pxe/src/pxe_service/pxe_service.ts b/yarn-project/pxe/src/pxe_service/pxe_service.ts index 45f0a9eb16e..7aa8f8fb00c 100644 --- a/yarn-project/pxe/src/pxe_service/pxe_service.ts +++ b/yarn-project/pxe/src/pxe_service/pxe_service.ts @@ -417,8 +417,7 @@ export class PXEService implements PXE { } if (simulatePublic) { - // Only one transaction, so we can take index 0. - simulatedTx.publicReturnValues = (await this.#simulatePublicCalls(simulatedTx.tx))[0]; + simulatedTx.publicReturnValues = await this.#simulatePublicCalls(simulatedTx.tx); } if (!msgSender) { @@ -646,7 +645,7 @@ export class PXEService implements PXE { await this.patchPublicCallStackOrdering(publicInputs, enqueuedPublicFunctions); const tx = new Tx(publicInputs, proof, encryptedLogs, unencryptedLogs, enqueuedPublicFunctions); - return new SimulatedTx(tx, [executionResult.returnValues]); + return new SimulatedTx(tx, executionResult.returnValues); } /** diff --git a/yarn-project/simulator/src/client/execution_result.ts b/yarn-project/simulator/src/client/execution_result.ts index 5118b28d607..9dfe877ba92 100644 --- a/yarn-project/simulator/src/client/execution_result.ts +++ b/yarn-project/simulator/src/client/execution_result.ts @@ -4,7 +4,6 @@ import { type PrivateCallStackItem, type PublicCallRequest, } from '@aztec/circuits.js'; -import { type DecodedReturn } from '@aztec/foundation/abi'; import { type Fr } from '@aztec/foundation/fields'; import { type ACVMField } from '../acvm/index.js'; @@ -40,8 +39,8 @@ export interface ExecutionResult { // Needed when we enable chained txs. The new notes can be cached and used in a later transaction. /** The notes created in the executed function. */ newNotes: NoteAndSlot[]; - /** The decoded return values of the executed function. */ - returnValues: DecodedReturn; + /** The raw return values of the executed function. */ + returnValues: Fr[]; /** The nested executions. */ nestedExecutions: this[]; /** Enqueued public function execution requests to be picked up by the sequencer. */ diff --git a/yarn-project/simulator/src/client/private_execution.test.ts b/yarn-project/simulator/src/client/private_execution.test.ts index b3bdc01968b..716232104a6 100644 --- a/yarn-project/simulator/src/client/private_execution.test.ts +++ b/yarn-project/simulator/src/client/private_execution.test.ts @@ -433,7 +433,7 @@ describe('Private Execution test suite', () => { const artifact = getFunctionArtifact(ChildContractArtifact, 'value'); const result = await runSimulator({ args: [initialValue], artifact }); - expect(result.returnValues).toEqual([initialValue + privateIncrement]); + expect(result.returnValues).toEqual([new Fr(initialValue + privateIncrement)]); }); it('parent should call child', async () => { @@ -452,12 +452,12 @@ describe('Private Execution test suite', () => { const args = [childAddress, childSelector]; const result = await runSimulator({ args, artifact: parentArtifact }); - expect(result.returnValues).toEqual([privateIncrement]); + expect(result.returnValues).toEqual([new Fr(privateIncrement)]); expect(oracle.getFunctionArtifact.mock.calls[0]).toEqual([childAddress, childSelector]); expect(oracle.getPortalContractAddress.mock.calls[0]).toEqual([childAddress]); expect(result.nestedExecutions).toHaveLength(1); - expect(result.nestedExecutions[0].returnValues).toEqual([privateIncrement]); + expect(result.nestedExecutions[0].returnValues).toEqual([new Fr(privateIncrement)]); // check that Aztec.nr calculated the call stack item hash like cpp does const expectedCallStackItemHash = result.nestedExecutions[0].callStackItem.hash(); @@ -486,7 +486,7 @@ describe('Private Execution test suite', () => { logger.info(`Calling testCodeGen function`); const result = await runSimulator({ args, artifact: testCodeGenArtifact }); - expect(result.returnValues).toEqual([argsHash.toBigInt()]); + expect(result.returnValues).toEqual([argsHash]); }); it('test function should be callable through autogenerated interface', async () => { @@ -504,11 +504,11 @@ describe('Private Execution test suite', () => { const args = [testAddress]; const result = await runSimulator({ args, artifact: parentArtifact }); - expect(result.returnValues).toEqual([argsHash.toBigInt()]); + expect(result.returnValues).toEqual([argsHash]); expect(oracle.getFunctionArtifact.mock.calls[0]).toEqual([testAddress, testCodeGenSelector]); expect(oracle.getPortalContractAddress.mock.calls[0]).toEqual([testAddress]); expect(result.nestedExecutions).toHaveLength(1); - expect(result.nestedExecutions[0].returnValues).toEqual([argsHash.toBigInt()]); + expect(result.nestedExecutions[0].returnValues).toEqual([argsHash]); }); }); @@ -899,7 +899,7 @@ describe('Private Execution test suite', () => { const readRequest = sideEffectArrayToValueArray(result.callStackItem.publicInputs.noteHashReadRequests)[0]; expect(readRequest).toEqual(innerNoteHash); - expect(result.returnValues).toEqual([amountToTransfer]); + expect(result.returnValues).toEqual([new Fr(amountToTransfer)]); const nullifier = result.callStackItem.publicInputs.newNullifiers[0]; const siloedNullifierSecretKey = computeSiloedNullifierSecretKey( @@ -974,7 +974,7 @@ describe('Private Execution test suite', () => { const readRequest = execGetThenNullify.callStackItem.publicInputs.noteHashReadRequests[0]; expect(readRequest.value).toEqual(innerNoteHash); - expect(execGetThenNullify.returnValues).toEqual([amountToTransfer]); + expect(execGetThenNullify.returnValues).toEqual([new Fr(amountToTransfer)]); const nullifier = execGetThenNullify.callStackItem.publicInputs.newNullifiers[0]; const siloedNullifierSecretKey = computeSiloedNullifierSecretKey( @@ -1013,7 +1013,6 @@ describe('Private Execution test suite', () => { it('gets the public key for an address', async () => { // Tweak the contract artifact so we can extract return values const artifact = getFunctionArtifact(TestContractArtifact, 'get_public_key'); - artifact.returnTypes = [{ kind: 'array', length: 2, type: { kind: 'field' } }]; // Generate a partial address, pubkey, and resulting address const completeAddress = CompleteAddress.random(); @@ -1022,7 +1021,7 @@ describe('Private Execution test suite', () => { oracle.getCompleteAddress.mockResolvedValue(completeAddress); const result = await runSimulator({ artifact, args }); - expect(result.returnValues).toEqual([pubKey.x.toBigInt(), pubKey.y.toBigInt()]); + expect(result.returnValues).toEqual([pubKey.x, pubKey.y]); }); }); @@ -1046,14 +1045,13 @@ describe('Private Execution test suite', () => { // Tweak the contract artifact so we can extract return values const artifact = getFunctionArtifact(TestContractArtifact, 'get_portal_contract_address'); - artifact.returnTypes = [{ kind: 'field' }]; const args = [aztecAddressToQuery.toField()]; // Overwrite the oracle return value oracle.getPortalContractAddress.mockResolvedValue(portalContractAddress); const result = await runSimulator({ artifact, args }); - expect(result.returnValues).toEqual([portalContractAddress.toField().value]); + expect(result.returnValues).toEqual([portalContractAddress.toField()]); }); it('this_address should return the current context address', async () => { @@ -1061,11 +1059,10 @@ describe('Private Execution test suite', () => { // Tweak the contract artifact so we can extract return values const artifact = getFunctionArtifact(TestContractArtifact, 'get_this_address'); - artifact.returnTypes = [{ kind: 'field' }]; // Overwrite the oracle return value const result = await runSimulator({ artifact, args: [], contractAddress }); - expect(result.returnValues).toEqual([contractAddress.toField().toBigInt()]); + expect(result.returnValues).toEqual([contractAddress.toField()]); }); it("this_portal_address should return the current context's portal address", async () => { @@ -1073,11 +1070,10 @@ describe('Private Execution test suite', () => { // Tweak the contract artifact so we can extract return values const artifact = getFunctionArtifact(TestContractArtifact, 'get_this_portal_address'); - artifact.returnTypes = [{ kind: 'field' }]; // Overwrite the oracle return value const result = await runSimulator({ artifact, args: [], portalContractAddress }); - expect(result.returnValues).toEqual([portalContractAddress.toField().toBigInt()]); + expect(result.returnValues).toEqual([portalContractAddress.toField()]); }); }); diff --git a/yarn-project/simulator/src/client/private_execution.ts b/yarn-project/simulator/src/client/private_execution.ts index 7a7b0d13288..d058985d750 100644 --- a/yarn-project/simulator/src/client/private_execution.ts +++ b/yarn-project/simulator/src/client/private_execution.ts @@ -1,5 +1,5 @@ import { type FunctionData, PrivateCallStackItem, PrivateCircuitPublicInputs } from '@aztec/circuits.js'; -import { type AbiType, type FunctionArtifactWithDebugMetadata, decodeReturnValues } from '@aztec/foundation/abi'; +import { type FunctionArtifactWithDebugMetadata } from '@aztec/foundation/abi'; import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { Fr } from '@aztec/foundation/fields'; import { createDebugLogger } from '@aztec/foundation/log'; @@ -53,12 +53,7 @@ export async function executePrivateFunction( const callStackItem = new PrivateCallStackItem(contractAddress, functionData, publicInputs); - // Mocking the return type to be an array of 4 fields - // TODO: @LHerskind must be updated as we are progressing with the macros to get the information const rawReturnValues = await context.unpackReturns(publicInputs.returnsHash); - const returnTypes: AbiType[] = [{ kind: 'array', length: rawReturnValues.length, type: { kind: 'field' } }]; - const mockArtifact = { ...artifact, returnTypes }; - const returnValues = decodeReturnValues(mockArtifact, rawReturnValues); const noteHashReadRequestPartialWitnesses = context.getNoteHashReadRequestPartialWitnesses( publicInputs.noteHashReadRequests, @@ -73,7 +68,7 @@ export async function executePrivateFunction( acir, partialWitness, callStackItem, - returnValues, + returnValues: rawReturnValues, noteHashReadRequestPartialWitnesses, newNotes, vk: Buffer.from(artifact.verificationKey!, 'hex'), diff --git a/yarn-project/simulator/src/public/abstract_phase_manager.ts b/yarn-project/simulator/src/public/abstract_phase_manager.ts index cb56906ea2a..c39d240ded7 100644 --- a/yarn-project/simulator/src/public/abstract_phase_manager.ts +++ b/yarn-project/simulator/src/public/abstract_phase_manager.ts @@ -1,5 +1,6 @@ import { MerkleTreeId, + type ProcessReturnValues, type PublicKernelRequest, type SimulationError, type Tx, @@ -47,13 +48,6 @@ import { makeEmptyProof, } from '@aztec/circuits.js'; import { computeVarArgsHash } from '@aztec/circuits.js/hash'; -import { - type AbiType, - type DecodedReturn, - type FunctionArtifact, - type ProcessReturnValues, - decodeReturnValues, -} from '@aztec/foundation/abi'; import { arrayNonEmptyLength, padArrayEnd } from '@aztec/foundation/collection'; import { type DebugLogger, createDebugLogger } from '@aztec/foundation/log'; import { type Tuple } from '@aztec/foundation/serialize'; @@ -236,13 +230,11 @@ export abstract class AbstractPhaseManager { // separate public callstacks to be proven by separate public kernel sequences // and submitted separately to the base rollup? - const returns = []; + let returns: ProcessReturnValues = undefined; for (const enqueuedCall of enqueuedCalls) { const executionStack: (PublicExecution | PublicExecutionResult)[] = [enqueuedCall]; - let currentReturn: DecodedReturn | undefined = undefined; - // Keep track of which result is for the top/enqueued call let enqueuedExecutionResult: PublicExecutionResult | undefined; @@ -301,21 +293,12 @@ export abstract class AbstractPhaseManager { if (!enqueuedExecutionResult) { enqueuedExecutionResult = result; - - // TODO(#5450) Need to use the proper return values here - const returnTypes: AbiType[] = [ - { kind: 'array', length: result.returnValues.length, type: { kind: 'field' } }, - ]; - const mockArtifact = { returnTypes } as any as FunctionArtifact; - - currentReturn = decodeReturnValues(mockArtifact, result.returnValues); + returns = result.returnValues; } } // HACK(#1622): Manually patches the ordering of public state actions // TODO(#757): Enforce proper ordering of public state actions patchPublicStorageActionOrdering(kernelOutput, enqueuedExecutionResult!, this.phase); - - returns.push(currentReturn); } // TODO(#3675): This should be done in a public kernel circuit diff --git a/yarn-project/simulator/src/public/avm_executor.test.ts b/yarn-project/simulator/src/public/avm_executor.test.ts index d0c0fc234dc..43c1dc7663c 100644 --- a/yarn-project/simulator/src/public/avm_executor.test.ts +++ b/yarn-project/simulator/src/public/avm_executor.test.ts @@ -72,6 +72,6 @@ describe('AVM WitGen and Proof Generation', () => { const valid = await executor.verifyAvmProof(vk, proof); expect(valid).toBe(true); }, - 60 * 1000, - ); // 60 seconds should be enough to generate the proof with 16-bit range checks + 120 * 1000, + ); // 120 seconds should be enough to generate the proof with 16-bit range checks }); diff --git a/yarn-project/simulator/src/public/public_processor.ts b/yarn-project/simulator/src/public/public_processor.ts index 9354bd6d6e9..b749c2276fa 100644 --- a/yarn-project/simulator/src/public/public_processor.ts +++ b/yarn-project/simulator/src/public/public_processor.ts @@ -1,6 +1,7 @@ import { type BlockProver, type FailedTx, + type ProcessReturnValues, type ProcessedTx, type PublicKernelRequest, type SimulationError, @@ -13,7 +14,6 @@ import { } from '@aztec/circuit-types'; import { type TxSequencerProcessingStats } from '@aztec/circuit-types/stats'; import { type GlobalVariables, type Header, type KernelCircuitPublicInputs } from '@aztec/circuits.js'; -import { type ProcessReturnValues } from '@aztec/foundation/abi'; import { createDebugLogger } from '@aztec/foundation/log'; import { Timer } from '@aztec/foundation/timer'; import { PublicExecutor, type PublicStateDB, type SimulationProvider } from '@aztec/simulator'; diff --git a/yarn-project/types/src/abi/contract_artifact.ts b/yarn-project/types/src/abi/contract_artifact.ts index b1b5ca3d8ac..f2c605a0886 100644 --- a/yarn-project/types/src/abi/contract_artifact.ts +++ b/yarn-project/types/src/abi/contract_artifact.ts @@ -117,9 +117,10 @@ type NoirCompiledContractFunction = NoirCompiledContract['functions'][number]; /** * Generates a function build artifact. Replaces verification key with a mock value. * @param fn - Noir function entry. + * @param contract - Parent contract. * @returns Function artifact. */ -function generateFunctionArtifact(fn: NoirCompiledContractFunction): FunctionArtifact { +function generateFunctionArtifact(fn: NoirCompiledContractFunction, contract: NoirCompiledContract): FunctionArtifact { if (fn.custom_attributes === undefined) { throw new Error( `No custom attributes found for contract function ${fn.name}. Try rebuilding the contract with the latest nargo version.`, @@ -134,10 +135,25 @@ function generateFunctionArtifact(fn: NoirCompiledContractFunction): FunctionArt parameters = parameters.slice(1); } - // If the function is secret, the return is the public inputs, which should be omitted let returnTypes: AbiType[] = []; - if (functionType !== 'secret' && fn.abi.return_type) { + if (functionType === FunctionType.UNCONSTRAINED && fn.abi.return_type) { returnTypes = [fn.abi.return_type.abi_type]; + } else { + const pathToFind = `${contract.name}::${fn.name}_abi`; + const abiStructs: AbiType[] = contract.outputs.structs['functions']; + + const returnStruct = abiStructs.find(a => a.kind === 'struct' && a.path === pathToFind); + + if (returnStruct) { + if (returnStruct.kind !== 'struct') { + throw new Error('Could not generate contract function artifact'); + } + + const returnTypeField = returnStruct.fields.find(field => field.name === 'return_type'); + if (returnTypeField) { + returnTypes = [returnTypeField.type]; + } + } } return { @@ -190,7 +206,7 @@ function hasKernelFunctionInputs(params: ABIParameter[]): boolean { function generateContractArtifact(contract: NoirCompiledContract, aztecNrVersion?: string): ContractArtifact { return { name: contract.name, - functions: contract.functions.map(generateFunctionArtifact), + functions: contract.functions.map(f => generateFunctionArtifact(f, contract)), outputs: contract.outputs, fileMap: contract.file_map, aztecNrVersion, From be9f24c16484b26a1eb88bcf35b785553160995d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=81lvaro=20Rodr=C3=ADguez?= Date: Wed, 17 Apr 2024 12:44:57 +0200 Subject: [PATCH 48/56] fix: Don't reuse brillig with slice arguments (#5800) This is a quick fix after https://github.com/AztecProtocol/aztec-packages/pull/5737 since that PR assumes that one generated brillig is valid for all calls to the brillig function. This is however not true, since the generated brillig can differ if the arguments contains slices. This is because the entry point codegen depends on the size of the slice. We currently cannot copy slices of any length into brillig due to the limitations of [CALLDATACOPY](https://yp-aztec.netlify.app/docs/public-vm/instruction-set#calldatacopy) where the size being copied needs to be known at compile-time. I'm going to chat with the AVM team to see if we can lift this restriction and make brillig entry points be able to copy in arguments that contain slices of any length. --- .../src/core/libraries/ConstantsGen.sol | 2 +- .../crates/types/src/constants.nr | 2 +- .../src/brillig/brillig_ir/artifact.rs | 2 +- .../noirc_evaluator/src/ssa/acir_gen/mod.rs | 30 ++++++++++++------- .../brillig_slice_input/src/main.nr | 3 ++ 5 files changed, 26 insertions(+), 13 deletions(-) diff --git a/l1-contracts/src/core/libraries/ConstantsGen.sol b/l1-contracts/src/core/libraries/ConstantsGen.sol index fe139215971..883f546a905 100644 --- a/l1-contracts/src/core/libraries/ConstantsGen.sol +++ b/l1-contracts/src/core/libraries/ConstantsGen.sol @@ -83,7 +83,7 @@ library Constants { uint256 internal constant DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; uint256 internal constant DEPLOYER_CONTRACT_ADDRESS = - 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74; + 0x0b98aeb0111208b95d8d71f484f849d7ab44b3e34c545d13736a707ce3cb0839; uint256 internal constant L1_TO_L2_MESSAGE_ORACLE_CALL_LENGTH = 17; uint256 internal constant MAX_NOTE_FIELDS_LENGTH = 20; uint256 internal constant GET_NOTE_ORACLE_RETURN_LENGTH = 23; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr index 96f1a6dcdd2..c4b67523bc6 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr @@ -118,7 +118,7 @@ global REGISTERER_UNCONSTRAINED_FUNCTION_BROADCASTED_MAGIC_VALUE = 0xe7af8166354 // CONTRACT INSTANCE CONSTANTS // sha224sum 'struct ContractInstanceDeployed' global DEPLOYER_CONTRACT_INSTANCE_DEPLOYED_MAGIC_VALUE = 0x85864497636cf755ae7bde03f267ce01a520981c21c3682aaf82a631; -global DEPLOYER_CONTRACT_ADDRESS = 0x2d8e7aedc70b65d49e6aa0794d8d12721896c177e87126701f6e60d184358e74; +global DEPLOYER_CONTRACT_ADDRESS = 0x0b98aeb0111208b95d8d71f484f849d7ab44b3e34c545d13736a707ce3cb0839; // NOIR CONSTANTS - constants used only in yarn-packages/noir-contracts // Some are defined here because Noir doesn't yet support globals referencing other globals yet. diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs index 8bd1bfda78f..8a4f469f5c9 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/brillig/brillig_ir/artifact.rs @@ -4,7 +4,7 @@ use std::collections::{BTreeMap, HashMap}; use crate::ssa::ir::dfg::CallStack; /// Represents a parameter or a return value of an entry point function. -#[derive(Debug, Clone)] +#[derive(Debug, Clone, Eq, PartialEq, Hash, PartialOrd, Ord)] pub(crate) enum BrilligParameter { /// A single address parameter or return value. Holds the bit size of the parameter. SingleAddr(u32), diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs index 8019707644b..02b381d79fc 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/acir_gen/mod.rs @@ -52,12 +52,18 @@ struct SharedContext { /// There can be Brillig functions specified in SSA which do not act as /// entry points in ACIR (e.g. only called by other Brillig functions) /// This mapping is necessary to use the correct function pointer for a Brillig call. - brillig_generated_func_pointers: BTreeMap, + /// This uses the brillig parameters in the map since using slices with different lengths + /// needs to create different brillig entrypoints + brillig_generated_func_pointers: BTreeMap<(FunctionId, Vec), u32>, } impl SharedContext { - fn generated_brillig_pointer(&self, func_id: &FunctionId) -> Option<&u32> { - self.brillig_generated_func_pointers.get(func_id) + fn generated_brillig_pointer( + &self, + func_id: FunctionId, + arguments: Vec, + ) -> Option<&u32> { + self.brillig_generated_func_pointers.get(&(func_id, arguments)) } fn generated_brillig(&self, func_pointer: usize) -> &GeneratedBrillig { @@ -67,10 +73,11 @@ impl SharedContext { fn insert_generated_brillig( &mut self, func_id: FunctionId, + arguments: Vec, generated_pointer: u32, code: GeneratedBrillig, ) { - self.brillig_generated_func_pointers.insert(func_id, generated_pointer); + self.brillig_generated_func_pointers.insert((func_id, arguments), generated_pointer); self.generated_brillig.push(code); } @@ -356,7 +363,7 @@ impl<'a> Context<'a> { let outputs: Vec = vecmap(main_func.returns(), |result_id| dfg.type_of_value(*result_id).into()); - let code = self.gen_brillig_for(main_func, arguments, brillig)?; + let code = self.gen_brillig_for(main_func, arguments.clone(), brillig)?; // We specifically do not attempt execution of the brillig code being generated as this can result in it being // replaced with constraints on witnesses to the program outputs. @@ -370,7 +377,7 @@ impl<'a> Context<'a> { // We are guaranteed to have a Brillig function pointer of `0` as main itself is marked as unconstrained 0, )?; - self.shared_context.insert_generated_brillig(main_func.id(), 0, code); + self.shared_context.insert_generated_brillig(main_func.id(), arguments, 0, code); let output_vars: Vec<_> = output_values .iter() @@ -657,6 +664,7 @@ impl<'a> Context<'a> { } } let inputs = vecmap(arguments, |arg| self.convert_value(*arg, dfg)); + let arguments = self.gen_brillig_parameters(arguments, dfg); let outputs: Vec = vecmap(result_ids, |result_id| { dfg.type_of_value(*result_id).into() @@ -664,8 +672,9 @@ impl<'a> Context<'a> { // Check whether we have already generated Brillig for this function // If we have, re-use the generated code to set-up the Brillig call. - let output_values = if let Some(generated_pointer) = - self.shared_context.generated_brillig_pointer(id) + let output_values = if let Some(generated_pointer) = self + .shared_context + .generated_brillig_pointer(*id, arguments.clone()) { let code = self .shared_context @@ -680,8 +689,8 @@ impl<'a> Context<'a> { *generated_pointer, )? } else { - let arguments = self.gen_brillig_parameters(arguments, dfg); - let code = self.gen_brillig_for(func, arguments, brillig)?; + let code = + self.gen_brillig_for(func, arguments.clone(), brillig)?; let generated_pointer = self.shared_context.new_generated_pointer(); let output_values = self.acir_context.brillig_call( @@ -695,6 +704,7 @@ impl<'a> Context<'a> { )?; self.shared_context.insert_generated_brillig( *id, + arguments, generated_pointer, code, ); diff --git a/noir/noir-repo/test_programs/execution_success/brillig_slice_input/src/main.nr b/noir/noir-repo/test_programs/execution_success/brillig_slice_input/src/main.nr index 09a9d9aef9d..8403cb7d4a0 100644 --- a/noir/noir-repo/test_programs/execution_success/brillig_slice_input/src/main.nr +++ b/noir/noir-repo/test_programs/execution_success/brillig_slice_input/src/main.nr @@ -25,6 +25,9 @@ fn main() { y: 8, } ]); + let brillig_sum = sum_slice(slice); + assert_eq(brillig_sum, 55); + slice = slice.push_back([ Point { x: 15, From 274f7d935230ce21d062644f6ec5f7cd0f58ae62 Mon Sep 17 00:00:00 2001 From: Gregorio Juliana Date: Wed, 17 Apr 2024 13:46:56 +0200 Subject: [PATCH 49/56] feat!: contract interfaces and better function calls (#5687) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes https://github.com/AztecProtocol/aztec-packages/issues/5081 This PR introduces autogenerated contract interfaces for easy intra and inter contract interactions. The `aztec-macro` crate is used to stub every non-internal private and public function and inject them into a ghost struct which has the same name as the contract that generated them. After that, they can be called like this: ```rust contract ImportTest { use dep::my_imported_contract::MyImportedContract; #[aztec(private)] fn a_private_fn() { let deserialized_return = MyImportedContract::at(some_address).another_private_fn(arg1, arg2).call(&mut context); MyImportedContract::at(some_address).a_public_fn(arg1).enqueue(&mut context); } #[aztec(public)] fn a_public_fn() { let deserialized_return = MyImportedContract::at(some_address).a_public_fn(arg1).call(&mut context); } #[aztec(private)] fn calling_my_own_fns() { ImportTest::at(context.this_address).a_private_fn().call(&mut context); ImportTest::at(context.this_address).a_public_fn().enqueue(&mut context); } } ``` Return values are `deserialized_into()` automatically, providing "real" return values thanks to https://github.com/AztecProtocol/aztec-packages/pull/5633 Also, some general cleanup was required to allow importing contracts in another contracts. Main changes: - `HirContext.fully_qualified_struct_path` now uses BFS to avoid returning the longest path when looking for a struct in a crate. This is required to avoid pulling structs usually imported in top-level dependencies (usually notes from our main contract) from other imported contracts. - `pack_args_oracle` now has a slice mode in addition to its usual array mode. PENDING: ~~AvmContext. The AVM team is discussing supporting args as slices. In case it's decided not to do that, a workaround could possibly be implemented using the macro, but it would be fairly complex.~~ Thanks to @fcarreiro and the amazing AVM team, this is now supported for the AvmContext! --------- Co-authored-by: esau <152162806+sklppy88@users.noreply.github.com> Co-authored-by: Álvaro Rodríguez --- boxes/boxes/react/package.json | 2 +- boxes/boxes/vanilla/package.json | 2 +- boxes/contract-only/package.json | 2 +- .../how_to_compile_contract.md | 100 +-- .../how_to_deploy_contract.md | 2 +- .../implement_slow_updates.md | 14 +- .../historical_data/slow_updates_tree/main.md | 4 - .../aztecnr-getting-started.md | 2 +- .../token_portal/minting_on_aztec.md | 7 - .../tutorials/token_portal/setup.md | 3 +- .../token_portal/withdrawing_to_l1.md | 2 +- .../developers/tutorials/uniswap/setup.md | 13 +- .../tutorials/uniswap/typescript_glue_code.md | 2 +- .../writing_private_voting_contract.md | 2 +- .../tutorials/writing_token_contract.md | 2 +- docs/docs/misc/migration_notes.md | 48 ++ noir-projects/aztec-nr/authwit/src/auth.nr | 2 +- noir-projects/aztec-nr/aztec/src/context.nr | 5 +- .../aztec-nr/aztec/src/context/avm_context.nr | 28 +- .../aztec-nr/aztec/src/context/interface.nr | 218 +++++- .../aztec/src/context/private_context.nr | 12 +- .../aztec/src/context/public_context.nr | 20 +- .../aztec-nr/aztec/src/oracle/arguments.nr | 19 +- .../app_subscription_contract/Nargo.toml | 2 + .../app_subscription_contract/src/main.nr | 34 +- .../src/main.nr | 11 +- .../src/main.nr | 47 +- .../benchmarking_contract/src/main.nr | 7 +- .../contracts/card_game_contract/src/main.nr | 22 +- .../contracts/child_contract/src/main.nr | 18 +- .../contracts/claim_contract/Nargo.toml | 1 + .../claim_contract/src/interfaces.nr | 37 - .../contracts/claim_contract/src/main.nr | 7 +- .../crowdfunding_contract/Nargo.toml | 1 + .../crowdfunding_contract/src/interfaces.nr | 27 - .../crowdfunding_contract/src/main.nr | 24 +- .../contracts/delegator_contract/Nargo.toml | 3 +- .../contracts/delegator_contract/src/main.nr | 23 +- .../docs_example_contract/src/main.nr | 25 +- .../easy_private_token_contract/src/main.nr | 2 +- .../easy_private_voting_contract/src/main.nr | 6 +- .../contracts/escrow_contract/Nargo.toml | 1 + .../contracts/escrow_contract/src/main.nr | 9 +- .../contracts/fpc_contract/Nargo.toml | 2 + .../contracts/fpc_contract/src/interfaces.nr | 60 -- .../contracts/fpc_contract/src/main.nr | 57 +- .../contracts/import_test_contract/Nargo.toml | 1 + .../import_test_contract/src/main.nr | 48 +- .../src/test_contract_interface.nr | 1 - .../contracts/lending_contract/Nargo.toml | 2 + .../contracts/lending_contract/src/asset.nr | 20 +- .../lending_contract/src/interfaces.nr | 117 --- .../contracts/lending_contract/src/main.nr | 107 +-- .../contracts/parent_contract/src/main.nr | 17 +- .../contracts/slow_tree_contract/Nargo.toml | 1 - .../contracts/slow_tree_contract/src/main.nr | 1 - .../stateful_test_contract/src/main.nr | 11 +- .../contracts/test_contract/src/interface.nr | 675 ------------------ .../contracts/test_contract/src/main.nr | 48 +- .../token_blacklist_contract/Nargo.toml | 1 + .../src/interfaces.nr | 45 -- .../token_blacklist_contract/src/main.nr | 69 +- .../token_bridge_contract/Nargo.toml | 1 + .../token_bridge_contract/src/main.nr | 11 +- .../src/token_interface.nr | 59 -- .../contracts/token_contract/src/main.nr | 13 +- .../contracts/uniswap_contract/Nargo.toml | 2 + .../uniswap_contract/src/interfaces.nr | 80 --- .../contracts/uniswap_contract/src/main.nr | 43 +- .../crates/types/src/traits.nr | 18 + noir/noir-repo/aztec_macros/src/lib.rs | 50 +- .../compute_note_hash_and_nullifier.rs | 25 +- .../src/transforms/contract_interface.rs | 326 +++++++++ .../aztec_macros/src/transforms/events.rs | 2 +- .../aztec_macros/src/transforms/mod.rs | 1 + .../src/transforms/note_interface.rs | 10 +- .../aztec_macros/src/transforms/storage.rs | 16 +- .../aztec_macros/src/utils/constants.rs | 1 + .../aztec_macros/src/utils/errors.rs | 12 + .../aztec_macros/src/utils/hir_utils.rs | 175 +++-- .../compiler/noirc_frontend/src/hir/mod.rs | 35 +- .../noirc_frontend/src/node_interner.rs | 24 +- .../compiler/noirc_frontend/src/tests.rs | 2 +- .../delegate.test.ts} | 53 +- .../e2e_delegate_calls/delegate_calls_test.ts | 72 ++ .../src/e2e_nested_contract.test.ts | 2 +- yarn-project/noir-compiler/package.json | 2 + .../add_noir_compiler_commander_actions.ts | 9 +- yarn-project/noir-compiler/src/cli/codegen.ts | 23 +- .../src/contract-interface-gen/noir.ts | 308 -------- .../src/contract-interface-gen/typescript.ts | 6 +- yarn-project/noir-compiler/src/index.ts | 1 - .../scripts/generate-noir-interfaces.sh | 17 - .../scripts/generate-types.sh | 2 +- .../simulator/src/acvm/oracle/oracle.ts | 9 +- .../simulator/src/acvm/oracle/typed_oracle.ts | 4 +- .../src/client/client_execution_context.ts | 4 +- .../src/client/private_execution.test.ts | 2 +- .../src/public/public_execution_context.ts | 4 +- yarn-project/yarn.lock | 18 + 100 files changed, 1338 insertions(+), 2205 deletions(-) delete mode 100644 noir-projects/noir-contracts/contracts/claim_contract/src/interfaces.nr delete mode 100644 noir-projects/noir-contracts/contracts/crowdfunding_contract/src/interfaces.nr delete mode 100644 noir-projects/noir-contracts/contracts/fpc_contract/src/interfaces.nr delete mode 120000 noir-projects/noir-contracts/contracts/import_test_contract/src/test_contract_interface.nr delete mode 100644 noir-projects/noir-contracts/contracts/lending_contract/src/interfaces.nr delete mode 100644 noir-projects/noir-contracts/contracts/test_contract/src/interface.nr delete mode 100644 noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr delete mode 100644 noir-projects/noir-contracts/contracts/token_bridge_contract/src/token_interface.nr delete mode 100644 noir-projects/noir-contracts/contracts/uniswap_contract/src/interfaces.nr create mode 100644 noir/noir-repo/aztec_macros/src/transforms/contract_interface.rs rename yarn-project/end-to-end/src/{e2e_delegate_calls.test.ts => e2e_delegate_calls/delegate.test.ts} (54%) create mode 100644 yarn-project/end-to-end/src/e2e_delegate_calls/delegate_calls_test.ts delete mode 100644 yarn-project/noir-compiler/src/contract-interface-gen/noir.ts delete mode 100755 yarn-project/noir-contracts.js/scripts/generate-noir-interfaces.sh diff --git a/boxes/boxes/react/package.json b/boxes/boxes/react/package.json index ea7ded69c00..0cd42e16ae5 100644 --- a/boxes/boxes/react/package.json +++ b/boxes/boxes/react/package.json @@ -7,7 +7,7 @@ "main": "./dist/index.js", "scripts": { "compile": "cd src/contracts && ${AZTEC_NARGO:-aztec-nargo} compile", - "codegen": "${AZTEC_CLI:-aztec-cli} codegen src/contracts/target -o artifacts --ts", + "codegen": "${AZTEC_CLI:-aztec-cli} codegen src/contracts/target -o artifacts", "clean": "rm -rf ./dist .tsbuildinfo ./artifacts ./src/contracts/target", "prep": "yarn clean && yarn compile && yarn codegen", "dev": "yarn prep && webpack serve --mode development", diff --git a/boxes/boxes/vanilla/package.json b/boxes/boxes/vanilla/package.json index bed49cf08f8..4e9c549afc6 100644 --- a/boxes/boxes/vanilla/package.json +++ b/boxes/boxes/vanilla/package.json @@ -6,7 +6,7 @@ "type": "module", "scripts": { "compile": "cd src/contracts && ${AZTEC_NARGO:-aztec-nargo} compile", - "codegen": "${AZTEC_CLI:-aztec-cli} codegen src/contracts/target -o artifacts --ts", + "codegen": "${AZTEC_CLI:-aztec-cli} codegen src/contracts/target -o artifacts", "clean": "rm -rf ./dest .tsbuildinfo ./artifacts ./src/contracts/target", "prep": "yarn clean && yarn compile && yarn codegen && tsc -b", "dev": "yarn prep && webpack serve --mode development", diff --git a/boxes/contract-only/package.json b/boxes/contract-only/package.json index 361571253f8..93e8c27ca85 100644 --- a/boxes/contract-only/package.json +++ b/boxes/contract-only/package.json @@ -6,7 +6,7 @@ "type": "module", "scripts": { "compile": "cd src && ${AZTEC_NARGO:-aztec-nargo} compile", - "codegen": "${AZTEC_CLI:-aztec-cli} codegen target -o artifacts --ts", + "codegen": "${AZTEC_CLI:-aztec-cli} codegen target -o artifacts", "clean": "rm -rf ./dest .tsbuildinfo ./artifacts ./target", "prep": "yarn clean && yarn compile && yarn codegen && tsc -b", "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules $(yarn bin jest) --runInBand", diff --git a/docs/docs/developers/contracts/compiling_contracts/how_to_compile_contract.md b/docs/docs/developers/contracts/compiling_contracts/how_to_compile_contract.md index 7d78818d4ff..6135b4d8e1a 100644 --- a/docs/docs/developers/contracts/compiling_contracts/how_to_compile_contract.md +++ b/docs/docs/developers/contracts/compiling_contracts/how_to_compile_contract.md @@ -24,10 +24,8 @@ This will output a JSON [artifact](./artifacts.md) for each contract in the proj You can use the code generator to autogenerate type-safe typescript classes for each of your contracts. These classes define type-safe methods for deploying and interacting with your contract based on their artifact. -To generate them, include a `--ts` option in the `codegen` command with a path to the target folder for the typescript files: - ```bash -aztec-cli codegen ./aztec-nargo/output/target/path -o src/artifacts --ts +aztec-cli codegen ./aztec-nargo/output/target/path -o src/artifacts ``` Below is typescript code generated from the [Token](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/token_contract/src/main.nr) contract: @@ -119,94 +117,34 @@ Read more about interacting with contracts using `aztec.js` [here](../../getting An Aztec.nr contract can [call a function](../writing_contracts/functions/call_functions.md) in another contract via `context.call_private_function` or `context.call_public_function`. However, this requires manually assembling the function selector and manually serializing the arguments, which is not type-safe. -To make this easier, the compiler can generate contract interface structs that expose a convenience method for each function listed in a given contract artifact. These structs are intended to be used from another contract project that calls into the current one. For each contract, two interface structs are generated: one to be used from private functions with a `PrivateContext`, and one to be used from open functions with a `PublicContext`. - -To generate them, include a `--nr` option in the `codegen` command with a path to the target folder for the generated Aztec.nr interface files: - -```bash -aztec-cli codegen ./aztec-nargo/output/target/path -o ./path/to/output/folder --nr -``` +To make this easier, the compiler automatically generates interface structs that expose a convenience method for each function listed in a given contract artifact. These structs are intended to be used from another contract project that calls into the current one. -Below is an example interface, also generated from the [Token](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/token_contract/src/main.nr) contract: +Below is an example of interface usage generated from the [Token](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/token_contract/src/main.nr) contract, used from the [FPC](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/fpc_contract/src/main.nr): ```rust -impl TokenPrivateContextInterface { - pub fn at(address: Field) -> Self { - Self { - address, - } - } - - pub fn burn( - self, - context: &mut PrivateContext, - from: FromBurnStruct, - amount: Field, - nonce: Field - ) -> [Field; RETURN_VALUES_LENGTH] { - let mut serialized_args = [0; 3]; - serialized_args[0] = from.address; - serialized_args[1] = amount; - serialized_args[2] = nonce; - - context.call_private_function(self.address, 0xd4fcc96e, serialized_args) - } - - - pub fn burn_public( - self, - context: &mut PrivateContext, - from: FromBurnPublicStruct, - amount: Field, - nonce: Field - ) { - let mut serialized_args = [0; 3]; - serialized_args[0] = from.address; - serialized_args[1] = amount; - serialized_args[2] = nonce; +contract FPC { - context.call_public_function(self.address, 0xb0e964d5, serialized_args) - } - ... - -} + ... -impl TokenPublicContextInterface { - pub fn at(address: Field) -> Self { - Self { - address, - } - } + use dep::token::Token; - pub fn burn_public( - self, - context: PublicContext, - from: FromBurnPublicStruct, - amount: Field, - nonce: Field - ) -> [Field; RETURN_VALUES_LENGTH] { - let mut serialized_args = [0; 3]; - serialized_args[0] = from.address; - serialized_args[1] = amount; - serialized_args[2] = nonce; - - context.call_public_function(self.address, 0xb0e964d5, serialized_args) - } + ... - pub fn mint_private( - self, - context: PublicContext, - amount: Field, - secret_hash: Field - ) -> [Field; RETURN_VALUES_LENGTH] { - let mut serialized_args = [0; 2]; - serialized_args[0] = amount; - serialized_args[1] = secret_hash; + #[aztec(private)] + fn fee_entrypoint_private(amount: Field, asset: AztecAddress, secret_hash: Field, nonce: Field) { + assert(asset == storage.other_asset.read_private()); + Token::at(asset).unshield(context.msg_sender(), context.this_address(), amount, nonce).call(&mut context); + FPC::at(context.this_address()).pay_fee_with_shielded_rebate(amount, asset, secret_hash).enqueue(&mut context); + } - context.call_public_function(self.address, 0x10763932, serialized_args) - } + #[aztec(private)] + fn fee_entrypoint_public(amount: Field, asset: AztecAddress, nonce: Field) { + FPC::at(context.this_address()).prepare_fee(context.msg_sender(), amount, asset, nonce).enqueue(&mut context); + FPC::at(context.this_address()).pay_fee(context.msg_sender(), amount, asset).enqueue(&mut context); + } + ... } ``` diff --git a/docs/docs/developers/contracts/deploying_contracts/how_to_deploy_contract.md b/docs/docs/developers/contracts/deploying_contracts/how_to_deploy_contract.md index 2ac74e787e2..dd646d383fb 100644 --- a/docs/docs/developers/contracts/deploying_contracts/how_to_deploy_contract.md +++ b/docs/docs/developers/contracts/deploying_contracts/how_to_deploy_contract.md @@ -40,7 +40,7 @@ aztec-nargo compile Generate the typescript class: ```bash -aztec-cli codegen ./aztec-nargo/output/target/path -o src/artifacts --ts +aztec-cli codegen ./aztec-nargo/output/target/path -o src/artifacts ``` This would create a typescript file like `Example.ts` in `./src/artifacts`. Read more on the [compiling page](../compiling_contracts/how_to_compile_contract.md). diff --git a/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/implement_slow_updates.md b/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/implement_slow_updates.md index d738af37879..6de1c8abae6 100644 --- a/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/implement_slow_updates.md +++ b/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/implement_slow_updates.md @@ -8,25 +8,19 @@ On this page you will learn how to implement a slow updates tree into your contr # How to implement a slow updates tree -1. Copy the _SlowTree.nr_ example and its dependencies, found [here](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/noir-contracts/contracts/slow_tree_contract). Replace the constants with whatever you like and deploy it to your sandbox -2. Copy the _SlowMap interface_ for easy interaction with your deployed SlowTree. Find it [here](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr) -3. Import this interface into your contract - -#include_code interface noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr rust - -5. Store the SlowTree address in private storage as a FieldNote +1. Store the SlowTree address in private storage as a FieldNote #include_code constructor noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr rust -6. Store the SlowTree address in public storage and initialize an instance of SlowMap using this address +2. Store the SlowTree address in public storage and initialize an instance of SlowMap using this address #include_code write_slow_update_public noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr rust -7. Now you can read and update from private functions: +3. Now you can read and update from private functions: #include_code get_and_update_private noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr rust -8. Or from public functions: +4. Or from public functions: #include_code get_public noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr rust diff --git a/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/main.md b/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/main.md index 170981942d9..4edc82d0537 100644 --- a/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/main.md +++ b/docs/docs/developers/contracts/writing_contracts/historical_data/slow_updates_tree/main.md @@ -16,10 +16,6 @@ There are generally 4 main components involved to make it easier to use a slow u This is the primary smart contract that will use the slow updates tree. In the example we use a [token with blacklisting features](./implement_slow_updates.md#exploring-an-example-integration-through-a-tokenblacklist-smart-contract). -## Interface - -This interface of the slow updates tree contract allows your contract to interact with the Slow Updates Tree contract. It provides methods for reading and updating values in the tree in both public and private contexts. You can find it [here](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr). - ## SlowTree.nr contract This is a smart contract developed by Aztec that establishes and manages a slow updates tree structure. It allows developers to access and interact with the tree, such as reading and updating data. diff --git a/docs/docs/developers/getting_started/aztecnr-getting-started.md b/docs/docs/developers/getting_started/aztecnr-getting-started.md index ae8b1e83e23..d7b9dd1eb10 100644 --- a/docs/docs/developers/getting_started/aztecnr-getting-started.md +++ b/docs/docs/developers/getting_started/aztecnr-getting-started.md @@ -147,7 +147,7 @@ This will compile the smart contract and create a `target` folder with a `.json` After compiling, you can generate a typescript class. In the same directory, run this: ```bash -aztec-cli codegen target -o src/artifacts --ts +aztec-cli codegen target -o src/artifacts ``` ### Deploy diff --git a/docs/docs/developers/tutorials/token_portal/minting_on_aztec.md b/docs/docs/developers/tutorials/token_portal/minting_on_aztec.md index 877a507122d..0eb400f0acb 100644 --- a/docs/docs/developers/tutorials/token_portal/minting_on_aztec.md +++ b/docs/docs/developers/tutorials/token_portal/minting_on_aztec.md @@ -12,13 +12,6 @@ In our `token-bridge` Aztec project in `aztec-contracts`, under `src` there is a #include_code token_bridge_storage_and_constructor /noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr rust -This imports Aztec-related dependencies and our helper file `token_interface.nr`. -(The code above will give errors right now - this is because we haven't implemented util and token_interface yet.) - -In `token_interface.nr`, add this: - -#include_code token_bridge_token_interface /noir-projects/noir-contracts/contracts/token_bridge_contract/src/token_interface.nr rust - ## Consume the L1 message In the previous step, we have moved our funds to the portal and created a L1->L2 message. Upon building the next rollup, the sequencer asks the inbox for any incoming messages and adds them to Aztec’s L1->L2 message tree, so an application on L2 can prove that the message exists and consumes it. diff --git a/docs/docs/developers/tutorials/token_portal/setup.md b/docs/docs/developers/tutorials/token_portal/setup.md index 1678df1f98e..8eb45c6d435 100644 --- a/docs/docs/developers/tutorials/token_portal/setup.md +++ b/docs/docs/developers/tutorials/token_portal/setup.md @@ -65,7 +65,7 @@ aztec = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_ token_portal_content_hash_lib = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_aztec_version", directory="noir-projects/noir-contracts/contracts/token_portal_content_hash_lib" } ``` -We will also be writing some helper functions that should exist elsewhere so we don't overcomplicated our contract. In `src` create two more files - one called `util.nr` and one called `token_interface` - so your dir structure should now look like this: +We will also be writing some helper functions that should exist elsewhere so we don't overcomplicated our contract. In `src` create one more file called `util.nr` - so your dir structure should now look like this: ```tree aztec-contracts @@ -73,7 +73,6 @@ aztec-contracts ├── Nargo.toml ├── src ├── main.nr - ├── token_interface.nr ├── util.nr ``` diff --git a/docs/docs/developers/tutorials/token_portal/withdrawing_to_l1.md b/docs/docs/developers/tutorials/token_portal/withdrawing_to_l1.md index 4e2246e20fb..524e106ef51 100644 --- a/docs/docs/developers/tutorials/token_portal/withdrawing_to_l1.md +++ b/docs/docs/developers/tutorials/token_portal/withdrawing_to_l1.md @@ -81,7 +81,7 @@ aztec-nargo compile And generate the TypeScript interface for the contract and add it to the test dir: ```bash -aztec-cli codegen target -o ../../src/test/fixtures --ts +aztec-cli codegen target -o ../../src/test/fixtures ``` This will create a TS interface in our `src/test` folder! diff --git a/docs/docs/developers/tutorials/uniswap/setup.md b/docs/docs/developers/tutorials/uniswap/setup.md index a80b63e734a..ba86ecb73be 100644 --- a/docs/docs/developers/tutorials/uniswap/setup.md +++ b/docs/docs/developers/tutorials/uniswap/setup.md @@ -50,6 +50,8 @@ Inside `uniswap/Nargo.toml` paste this in `[dependencies]`: [dependencies] aztec = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_aztec_version", directory="noir-projects/aztec-nr/aztec" } authwit = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_aztec_version", directory="noir-projects/aztec-nr/authwit"} +token = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_aztec_version", directory="noir-projects/noir-contracts/token_contract" } +token_bridge = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#include_aztec_version", directory="noir-projects/noir-contracts/token_bridge_contract" } ``` ## L2 contracts @@ -57,18 +59,9 @@ authwit = { git="https://github.com/AztecProtocol/aztec-packages/", tag="#includ The `main.nr` will utilize a few helper functions that are outside the scope of this tutorial. Inside `uniswap/src` create two new files: ```bash -cd uniswap/src && touch util.nr && touch interfaces.nr +cd uniswap/src && touch util.nr ``` -Inside `interfaces.nr` paste this: - -#include_code interfaces noir-projects/noir-contracts/contracts/uniswap_contract/src/interfaces.nr rust - -This creates interfaces for the `Token` contract and `TokenBridge` contract - -- `Token` is a reference implementation for a token on Aztec. Here we just need two methods - [`transfer_public`](../writing_token_contract.md#transfer_public) and [`unshield()`](../writing_token_contract.md#unshield). -- The `TokenBridge` facilitates interactions with our [bridge contract](../token_portal/main.md). Here we just need its [`exit_to_l1_public`](../token_portal/withdrawing_to_l1.md) - ## Run Aztec sandbox You will need a running sandbox. diff --git a/docs/docs/developers/tutorials/uniswap/typescript_glue_code.md b/docs/docs/developers/tutorials/uniswap/typescript_glue_code.md index 805a9249826..2d5d04e4a1b 100644 --- a/docs/docs/developers/tutorials/uniswap/typescript_glue_code.md +++ b/docs/docs/developers/tutorials/uniswap/typescript_glue_code.md @@ -36,7 +36,7 @@ aztec-nargo compile And then generate the typescript interface: ```bash -aztec-cli codegen ./target/ -o ../../../src/test/fixtures uniswap --ts +aztec-cli codegen ./target/ -o ../../../src/test/fixtures uniswap ``` This will create a TS interface in our `src/test` folder that will help us write our test. diff --git a/docs/docs/developers/tutorials/writing_private_voting_contract.md b/docs/docs/developers/tutorials/writing_private_voting_contract.md index 685b89a9412..1178600c72a 100644 --- a/docs/docs/developers/tutorials/writing_private_voting_contract.md +++ b/docs/docs/developers/tutorials/writing_private_voting_contract.md @@ -158,7 +158,7 @@ aztec-nargo compile This will create a new directory called `target` and a JSON artifact inside it. To optionally create a typescript interface, run: ```bash -aztec-cli codegen target -o src/artifacts --ts +aztec-cli codegen target -o src/artifacts ``` Once it is compiled you can [deploy](../contracts/deploying_contracts/how_to_deploy_contract.md) it to the sandbox. Ensure your [sandbox is running](../sandbox/references/sandbox-reference.md) and run this in the same dir as before: diff --git a/docs/docs/developers/tutorials/writing_token_contract.md b/docs/docs/developers/tutorials/writing_token_contract.md index a4f5926c5b5..a9b9e942391 100644 --- a/docs/docs/developers/tutorials/writing_token_contract.md +++ b/docs/docs/developers/tutorials/writing_token_contract.md @@ -431,7 +431,7 @@ aztec-nargo compile Once your contract is compiled, optionally generate a typescript interface with the following command: ```bash -aztec-cli codegen target -o src/artifacts --ts +aztec-cli codegen target -o src/artifacts ``` ## Next Steps diff --git a/docs/docs/misc/migration_notes.md b/docs/docs/misc/migration_notes.md index 8f4f8b84217..5b0a8c0cf29 100644 --- a/docs/docs/misc/migration_notes.md +++ b/docs/docs/misc/migration_notes.md @@ -8,6 +8,54 @@ Aztec is in full-speed development. Literally every version breaks compatibility ## TBD +### [Aztec.nr] Contract interfaces + +It is now possible to import contracts on another contracts and use their automatic interfaces to perform calls. The interfaces have the same name as the contract, and are automatically exported. Parameters are automatically serialized (using the `Serialize` trait) and return values are automatically deserialized (using the `Deserialize` trait). Serialize and Deserialize methods have to conform to the standard ACVM serialization schema for the interface to work! + +1. Only fixed length types are supported +2. All numeric types become Fields +3. Strings become arrays of Fields, one per char +4. Arrays become arrays of Fields following rules 2 and 3 +5. Structs become arrays of Fields, with every item defined in the same order as they are in Noir code, following rules 2, 3, 4 and 5 (recursive) + + +```diff +- context.call_public_function( +- storage.gas_token_address.read_private(), +- FunctionSelector::from_signature("pay_fee(Field)"), +- [42] +- ); +- +- context.call_public_function( +- storage.gas_token_address.read_private(), +- FunctionSelector::from_signature("pay_fee(Field)"), +- [42] +- ); +- +- let _ = context.call_private_function( +- storage.subscription_token_address.read_private(), +- FunctionSelector::from_signature("transfer((Field),(Field),Field,Field)"), +- [ +- context.msg_sender().to_field(), +- storage.subscription_recipient_address.read_private().to_field(), +- storage.subscription_price.read_private(), +- nonce +- ] +- ); ++ use dep::gas_token::GasToken; ++ use dep::token::Token; ++ ++ ... ++ // Public call from public land ++ GasToken::at(storage.gas_token_address.read_private()).pay_fee(42).call(&mut context); ++ // Public call from private land ++ GasToken::at(storage.gas_token_address.read_private()).pay_fee(42).enqueue(&mut context); ++ // Private call from private land ++ Token::at(asset).transfer(context.msg_sender(), storage.subscription_recipient_address.read_private(), amount, nonce).call(&mut context); +``` + +It is also possible to use these automatic interfaces from the local contract, and thus enqueue public calls from private without having to rely on low level `context` calls. + ### [Aztec.nr] Rename max block number setter The `request_max_block_number` function has been renamed to `set_tx_max_block_number` to better reflect that it is not a getter, and that the setting is transaction-wide. diff --git a/noir-projects/aztec-nr/authwit/src/auth.nr b/noir-projects/aztec-nr/authwit/src/auth.nr index 643f725e2f2..55c15acec77 100644 --- a/noir-projects/aztec-nr/authwit/src/auth.nr +++ b/noir-projects/aztec-nr/authwit/src/auth.nr @@ -37,7 +37,7 @@ pub fn assert_current_call_valid_authwit_public( context, on_behalf_of, function_selector, - [inner_hash], + [inner_hash].as_slice(), GasOpts::default() ).deserialize_into(); assert(result == IS_VALID_SELECTOR, "Message not authorized by account"); diff --git a/noir-projects/aztec-nr/aztec/src/context.nr b/noir-projects/aztec-nr/aztec/src/context.nr index 2b546b1e411..c7d79f2e24b 100644 --- a/noir-projects/aztec-nr/aztec/src/context.nr +++ b/noir-projects/aztec-nr/aztec/src/context.nr @@ -7,7 +7,10 @@ mod avm_context; mod interface; mod gas; -use interface::ContextInterface; +use interface::{ + ContextInterface, PrivateCallInterface, PublicCallInterface, PrivateVoidCallInterface, + PublicVoidCallInterface, AvmCallInterface, AvmVoidCallInterface +}; use private_context::PrivateContext; use private_context::PackedReturns; use public_context::PublicContext; diff --git a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr index 0446511184d..c3379ea7419 100644 --- a/noir-projects/aztec-nr/aztec/src/context/avm_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/avm_context.nr @@ -50,32 +50,32 @@ impl AvmContext { l1_to_l2_msg_exists(msg_hash, msg_leaf_index) == 1 } - fn call_public_function_raw( + fn call_public_function_raw( self: &mut Self, gas: GasOpts, contract_address: AztecAddress, temporary_function_selector: Field, - args: [Field; ARGS_COUNT] + args: [Field] ) -> ([Field; RET_COUNT], u8) { call( gas_for_call(gas), contract_address, - args.as_slice(), + args, temporary_function_selector ) } - fn static_call_public_function_raw( + fn static_call_public_function_raw( self: &mut Self, gas: GasOpts, contract_address: AztecAddress, temporary_function_selector: Field, - args: [Field; ARGS_COUNT] + args: [Field] ) -> ([Field; RET_COUNT], u8) { call_static( gas_for_call(gas), contract_address, - args.as_slice(), + args, temporary_function_selector ) } @@ -136,17 +136,17 @@ impl PublicContextInterface for AvmContext { send_l2_to_l1_msg(recipient, content); } - fn call_public_function( + fn call_public_function( self: &mut Self, contract_address: AztecAddress, temporary_function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], gas_opts: GasOpts ) -> FunctionReturns { let results = call( gas_for_call(gas_opts), contract_address, - args.as_slice(), + args, temporary_function_selector.to_field() ); let data_to_return: [Field; RETURNS_COUNT] = results.0; @@ -156,17 +156,17 @@ impl PublicContextInterface for AvmContext { FunctionReturns::new(data_to_return) } - fn static_call_public_function( + fn static_call_public_function( self: &mut Self, contract_address: AztecAddress, temporary_function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], gas_opts: GasOpts ) -> FunctionReturns { let (data_to_return, success): ([Field; RETURNS_COUNT], u8) = call_static( gas_for_call(gas_opts), contract_address, - args.as_slice(), + args, temporary_function_selector.to_field() ); @@ -174,11 +174,11 @@ impl PublicContextInterface for AvmContext { FunctionReturns::new(data_to_return) } - fn delegate_call_public_function( + fn delegate_call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT] + args: [Field] ) -> FunctionReturns { assert(false, "'delegate_call_public_function' not implemented!"); FunctionReturns::new([0; RETURNS_COUNT]) diff --git a/noir-projects/aztec-nr/aztec/src/context/interface.nr b/noir-projects/aztec-nr/aztec/src/context/interface.nr index ef64964368c..d087160c654 100644 --- a/noir-projects/aztec-nr/aztec/src/context/interface.nr +++ b/noir-projects/aztec-nr/aztec/src/context/interface.nr @@ -1,5 +1,11 @@ -use dep::protocol_types::{abis::function_selector::FunctionSelector, address::{AztecAddress, EthAddress}, header::Header}; +use dep::protocol_types::{ + abis::function_selector::FunctionSelector, address::{AztecAddress, EthAddress}, header::Header, + traits::Deserialize +}; +use crate::context::private_context::PrivateContext; +use crate::context::public_context::PublicContext; +use crate::context::avm_context::AvmContext; use crate::context::gas::GasOpts; use crate::context::public_context::FunctionReturns; @@ -30,25 +36,223 @@ trait PublicContextInterface { fn consume_l1_to_l2_message(&mut self, content: Field, secret: Field, sender: EthAddress); fn accumulate_encrypted_logs(&mut self, log: [Field; N]); fn accumulate_unencrypted_logs(&mut self, log: T); - fn call_public_function( + fn call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], gas_opts: GasOpts ) -> FunctionReturns; - fn static_call_public_function( + fn static_call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], gas_opts: GasOpts ) -> FunctionReturns; - fn delegate_call_public_function( + fn delegate_call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT] + args: [Field] ) -> FunctionReturns; fn nullifier_exists(self, unsiloed_nullifier: Field, address: AztecAddress) -> bool; } + +struct PrivateCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args_hash: Field, +} + +impl PrivateCallInterface { + pub fn call(self, context: &mut PrivateContext) -> T where T: Deserialize { + let returns = context.call_private_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ); + let unpacked: T = returns.unpack_into(); + unpacked + } + + pub fn static_call(self, context: &mut PrivateContext) -> T where T: Deserialize { + let returns = context.call_private_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false); + returns.unpack_into() + } + + pub fn delegate_call(self, context: &mut PrivateContext) -> T where T: Deserialize { + let returns = context.call_private_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true); + returns.unpack_into() + } +} + +struct PrivateVoidCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args_hash: Field, +} + +impl PrivateVoidCallInterface { + pub fn call(self, context: &mut PrivateContext) { + context.call_private_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ).assert_empty(); + } + + pub fn static_call(self, context: &mut PrivateContext) { + context.call_private_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false).assert_empty(); + } + + pub fn delegate_call(self, context: &mut PrivateContext) { + context.call_private_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true).assert_empty(); + } +} + +struct PublicCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args_hash: Field, +} + +impl PublicCallInterface { + + pub fn call(self, context: &mut PublicContext) -> T where T: Deserialize { + let returns = context.call_public_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ); + returns.deserialize_into() + } + + pub fn static_call(self, context: &mut PublicContext) -> T where T: Deserialize { + let returns = context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false); + returns.deserialize_into() + } + + pub fn delegate_call(self, context: &mut PublicContext) -> T where T: Deserialize { + let returns = context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true); + returns.deserialize_into() + } + + pub fn enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ) + } + + pub fn static_enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false) + } + + pub fn delegate_enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true) + } +} + +struct PublicVoidCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args_hash: Field +} + +impl PublicVoidCallInterface { + pub fn call(self, context: &mut PublicContext) { + context.call_public_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ).assert_empty() + } + + pub fn static_call(self, context: &mut PublicContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false).assert_empty(); + } + + pub fn delegate_call(self, context: &mut PublicContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true).assert_empty(); + } + + pub fn enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args( + self.target_contract, + self.selector, + self.args_hash, + false, + false + ) + } + + pub fn static_enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, true, false) + } + + pub fn delegate_enqueue(self, context: &mut PrivateContext) { + context.call_public_function_with_packed_args(self.target_contract, self.selector, self.args_hash, false, true) + } +} + +struct AvmCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args: [Field], +} + +impl AvmCallInterface { + pub fn call(self, context: &mut AvmContext, gas_opts: GasOpts) -> T where T: Deserialize { + let returns = context.call_public_function(self.target_contract, self.selector, self.args, gas_opts); + returns.deserialize_into() + } + + pub fn static_call( + self, + context: &mut AvmContext, + gas_opts: GasOpts + ) -> T where T: Deserialize { + let returns = context.static_call_public_function(self.target_contract, self.selector, self.args, gas_opts); + returns.deserialize_into() + } + + pub fn delegate_call(self, context: &mut AvmContext) -> T where T: Deserialize { + let returns = context.delegate_call_public_function(self.target_contract, self.selector, self.args); + returns.deserialize_into() + } +} + +struct AvmVoidCallInterface { + target_contract: AztecAddress, + selector: FunctionSelector, + args: [Field], +} + +impl AvmVoidCallInterface { + pub fn call(self, context: &mut AvmContext, gas_opts: GasOpts) { + let returns = context.call_public_function(self.target_contract, self.selector, self.args, gas_opts); + returns.assert_empty() + } + + pub fn static_call(self, context: &mut AvmContext, gas_opts: GasOpts) { + let returns = context.static_call_public_function(self.target_contract, self.selector, self.args, gas_opts); + returns.assert_empty() + } + + pub fn delegate_call(self, context: &mut AvmContext) { + let returns = context.delegate_call_public_function(self.target_contract, self.selector, self.args); + returns.assert_empty() + } +} diff --git a/noir-projects/aztec-nr/aztec/src/context/private_context.nr b/noir-projects/aztec-nr/aztec/src/context/private_context.nr index b70680db040..0fcdaa74bac 100644 --- a/noir-projects/aztec-nr/aztec/src/context/private_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/private_context.nr @@ -282,7 +282,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) -> PackedReturns { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_private_function_with_packed_args(contract_address, function_selector, args_hash, false, false) } @@ -293,7 +293,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) -> PackedReturns { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_private_function_with_packed_args(contract_address, function_selector, args_hash, true, false) } @@ -304,7 +304,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) -> PackedReturns { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_private_function_with_packed_args(contract_address, function_selector, args_hash, false, true) } @@ -402,7 +402,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, false, false) } @@ -413,7 +413,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, true, false) } @@ -424,7 +424,7 @@ impl PrivateContext { args: [Field; ARGS_COUNT] ) { let args_hash = hash_args_array(args); - assert(args_hash == arguments::pack_arguments(args)); + assert(args_hash == arguments::pack_arguments_array(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, false, true) } diff --git a/noir-projects/aztec-nr/aztec/src/context/public_context.nr b/noir-projects/aztec-nr/aztec/src/context/public_context.nr index 1c61e53712e..cdbbb3e939b 100644 --- a/noir-projects/aztec-nr/aztec/src/context/public_context.nr +++ b/noir-projects/aztec-nr/aztec/src/context/public_context.nr @@ -5,7 +5,7 @@ use crate::{ }, messaging::process_l1_to_l2_message, oracle::{arguments, public_call::call_public_function_internal, returns}, - hash::{hash_args_array, ArgsHasher} + hash::{hash_args, ArgsHasher} }; use dep::protocol_types::{ abis::{ @@ -291,37 +291,37 @@ impl PublicContextInterface for PublicContext { // TODO(https://github.com/AztecProtocol/aztec-packages/issues/1165) } - fn call_public_function( + fn call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], _gas: GasOpts ) -> FunctionReturns { - let args_hash = hash_args_array(args); + let args_hash = hash_args(args); assert(args_hash == arguments::pack_arguments(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, false, false) } - fn static_call_public_function( + fn static_call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT], + args: [Field], _gas: GasOpts ) -> FunctionReturns { - let args_hash = hash_args_array(args); + let args_hash = hash_args(args); assert(args_hash == arguments::pack_arguments(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, true, false) } - fn delegate_call_public_function( + fn delegate_call_public_function( self: &mut Self, contract_address: AztecAddress, function_selector: FunctionSelector, - args: [Field; ARGS_COUNT] + args: [Field] ) -> FunctionReturns { - let args_hash = hash_args_array(args); + let args_hash = hash_args(args); assert(args_hash == arguments::pack_arguments(args)); self.call_public_function_with_packed_args(contract_address, function_selector, args_hash, false, true) } diff --git a/noir-projects/aztec-nr/aztec/src/oracle/arguments.nr b/noir-projects/aztec-nr/aztec/src/oracle/arguments.nr index f1de424f840..2bbf2337117 100644 --- a/noir-projects/aztec-nr/aztec/src/oracle/arguments.nr +++ b/noir-projects/aztec-nr/aztec/src/oracle/arguments.nr @@ -1,11 +1,24 @@ +#[oracle(packArgumentsArray)] +fn pack_arguments_array_oracle(_args: [Field; N]) -> Field {} + #[oracle(packArguments)] -fn pack_arguments_oracle(_args: [Field; N]) -> Field {} +fn pack_arguments_oracle(_args: [Field]) -> Field {} + +/// - Pack arguments (array version) will notify the simulator that these arguments will be used later at +/// some point in the call. +/// - When the external call is made later, the simulator will know what the values unpack to. +/// - This oracle will not be required in public vm functions, as the vm will keep track of arguments +/// itself. +unconstrained pub fn pack_arguments_array(args: [Field; N]) -> Field { + pack_arguments_array_oracle(args) +} -/// - Pack arguments will notify the simulator that these arguments will be used later at +/// - Pack arguments (slice version) will notify the simulator that these arguments will be used later at /// some point in the call. /// - When the external call is made later, the simulator will know what the values unpack to. /// - This oracle will not be required in public vm functions, as the vm will keep track of arguments /// itself. -unconstrained pub fn pack_arguments(args: [Field; N]) -> Field { +unconstrained pub fn pack_arguments(args: [Field]) -> Field { pack_arguments_oracle(args) } + diff --git a/noir-projects/noir-contracts/contracts/app_subscription_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/app_subscription_contract/Nargo.toml index 34df286511b..cf460fd9497 100644 --- a/noir-projects/noir-contracts/contracts/app_subscription_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/app_subscription_contract/Nargo.toml @@ -7,3 +7,5 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } authwit = { path = "../../../aztec-nr/authwit" } +gas_token = { path = "../gas_token_contract" } +token = { path = "../token_contract" } \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/app_subscription_contract/src/main.nr b/noir-projects/noir-contracts/contracts/app_subscription_contract/src/main.nr index 999f07771bd..eb316f30186 100644 --- a/noir-projects/noir-contracts/contracts/app_subscription_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/app_subscription_contract/src/main.nr @@ -17,6 +17,9 @@ contract AppSubscription { use crate::subscription_note::{SubscriptionNote, SUBSCRIPTION_NOTE_LEN}; + use dep::gas_token::GasToken; + use dep::token::Token; + #[aztec(storage)] struct Storage { // The following is only needed in private but we use ShareImmutable here instead of PrivateImmutable because @@ -44,19 +47,11 @@ contract AppSubscription { note.remaining_txs -= 1; storage.subscriptions.at(user_address).replace(&mut note, true); - context.call_public_function( - storage.gas_token_address.read_private(), - FunctionSelector::from_signature("pay_fee(Field)"), - [42] - ); + GasToken::at(storage.gas_token_address.read_private()).pay_fee(42).enqueue(&mut context); context.capture_min_revertible_side_effect_counter(); - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("assert_not_expired(Field)"), - [note.expiry_block_number] - ); + AppSubscription::at(context.this_address()).assert_not_expired(note.expiry_block_number).enqueue(&mut context); payload.execute_calls(&mut context, storage.target_address.read_private()); } @@ -102,20 +97,15 @@ contract AppSubscription { ) { assert(tx_count as u64 <= SUBSCRIPTION_TXS as u64); - let _ = context.call_private_function( - storage.subscription_token_address.read_private(), - FunctionSelector::from_signature("transfer((Field),(Field),Field,Field)"), - [ - context.msg_sender().to_field(), storage.subscription_recipient_address.read_private().to_field(), storage.subscription_price.read_private(), nonce - ] - ); + Token::at(storage.subscription_token_address.read_private()).transfer( + context.msg_sender(), + storage.subscription_recipient_address.read_private(), + storage.subscription_price.read_private(), + nonce + ).call(&mut context); // Assert that the given expiry_block_number < current_block_number + SUBSCRIPTION_DURATION_IN_BLOCKS. - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("assert_block_number(Field)"), - [expiry_block_number] - ); + AppSubscription::at(context.this_address()).assert_block_number(expiry_block_number).enqueue(&mut context); let mut subscription_note = SubscriptionNote::new(subscriber_address, expiry_block_number, tx_count); if (!is_initialized(subscriber_address)) { diff --git a/noir-projects/noir-contracts/contracts/avm_acvm_interop_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/avm_acvm_interop_test_contract/src/main.nr index c1af41666e9..bece62fc8dc 100644 --- a/noir-projects/noir-contracts/contracts/avm_acvm_interop_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/avm_acvm_interop_test_contract/src/main.nr @@ -42,7 +42,7 @@ contract AvmAcvmInteropTest { context.call_public_function( context.this_address(), FunctionSelector::from_signature("constant_field_acvm()"), - [], + [].as_slice(), GasOpts::default() ).deserialize_into() } @@ -52,14 +52,19 @@ contract AvmAcvmInteropTest { context.call_public_function( context.this_address(), FunctionSelector::from_signature("constant_field_avm()"), - [], + [].as_slice(), GasOpts::default() ).deserialize_into() } #[aztec(public-vm)] fn avm_to_acvm_call(selector: FunctionSelector, args: Field) { - context.call_public_function(context.this_address(), selector, [args], GasOpts::default()).assert_empty(); + context.call_public_function( + context.this_address(), + selector, + [args].as_slice(), + GasOpts::default() + ).assert_empty(); } /************************************************************************ diff --git a/noir-projects/noir-contracts/contracts/avm_nested_calls_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/avm_nested_calls_test_contract/src/main.nr index 4c056f838de..e5d34183f42 100644 --- a/noir-projects/noir-contracts/contracts/avm_nested_calls_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/avm_nested_calls_test_contract/src/main.nr @@ -42,7 +42,7 @@ contract AvmNestedCallsTest { GasOpts::default(), context.this_address(), selector, - [arg_a, arg_b] + [arg_a, arg_b].as_slice() ); let data_to_return: [Field; 1] = results.0; // this explicit size is necessary to ensure that ret_size is compile-time @@ -71,7 +71,7 @@ contract AvmNestedCallsTest { GasOpts::new(l1_gas, l2_gas, da_gas), context.this_address(), selector, - [arg_a, arg_b] + [arg_a, arg_b].as_slice() ); let data_to_return: [Field; 1] = results.0; // this explicit size is necessary to ensure that ret_size is compile-time @@ -85,15 +85,7 @@ contract AvmNestedCallsTest { // Use the `call_public_function` wrapper to initiate a nested call to the add function #[aztec(public-vm)] fn nested_call_to_add(arg_a: Field, arg_b: Field) -> pub Field { - let selector = FunctionSelector::from_signature("add_args_return(Field,Field)"); - - // Nested call using standard context interface function - context.call_public_function( - context.this_address(), - selector, - [arg_a, arg_b], - GasOpts::default() - ).deserialize_into() + AvmNestedCallsTest::at(context.this_address()).add_args_return(arg_a, arg_b).call(&mut context, GasOpts::default()) } // Directly call_static the external call opcode to initiate a nested call to the add function @@ -105,7 +97,7 @@ contract AvmNestedCallsTest { GasOpts::default(), context.this_address(), selector, - [arg_a, arg_b] + [arg_a, arg_b].as_slice() ); (result_data[0], success) @@ -117,7 +109,12 @@ contract AvmNestedCallsTest { let selector = FunctionSelector::from_signature("set_storage_single(Field)").to_field(); let calldata: [Field; 1] = [20]; - let (_data_to_return, success): ([Field; 0], u8) = context.static_call_public_function_raw(GasOpts::default(), context.this_address(), selector, calldata); + let (_data_to_return, success): ([Field; 0], u8) = context.static_call_public_function_raw( + GasOpts::default(), + context.this_address(), + selector, + calldata.as_slice() + ); success } @@ -125,40 +122,24 @@ contract AvmNestedCallsTest { // Indirectly call_static the external call opcode to initiate a nested call to the add function #[aztec(public-vm)] fn nested_static_call_to_add(arg_a: Field, arg_b: Field) -> pub Field { - let selector = FunctionSelector::from_signature("add_args_return(Field,Field)"); - - context.static_call_public_function( - context.this_address(), - selector, - [arg_a, arg_b], - GasOpts::default() - ).deserialize_into() + AvmNestedCallsTest::at(context.this_address()).add_args_return(arg_a, arg_b).static_call(&mut context, GasOpts::default()) } // Indirectly call_static `set_storage_single`. Should revert since it's accessing storage. #[aztec(public-vm)] fn nested_static_call_to_set_storage() { - let selector = FunctionSelector::from_signature("set_storage_single(Field)"); - let calldata: [Field; 1] = [20]; - - context.static_call_public_function(context.this_address(), selector, calldata, GasOpts::default()).assert_empty(); + AvmNestedCallsTest::at(context.this_address()).set_storage_single(20).static_call(&mut context, GasOpts::default()); } #[aztec(public-vm)] fn create_same_nullifier_in_nested_call(nestedAddress: AztecAddress, nullifier: Field) { context.push_new_nullifier(nullifier, 0); - - let selector = FunctionSelector::from_signature("new_nullifier(Field)"); - let calldata: [Field; 1] = [nullifier]; - let _ : FunctionReturns<0> = context.call_public_function(nestedAddress, selector, calldata, GasOpts::default()); + AvmNestedCallsTest::at(nestedAddress).new_nullifier(nullifier).call(&mut context, GasOpts::default()); } #[aztec(public-vm)] fn create_different_nullifier_in_nested_call(nestedAddress: AztecAddress, nullifier: Field) { context.push_new_nullifier(nullifier, 0); - - let selector = FunctionSelector::from_signature("new_nullifier(Field)"); - let calldata: [Field; 1] = [nullifier + 1]; - let _ : FunctionReturns<0> = context.call_public_function(nestedAddress, selector, calldata, GasOpts::default()); + AvmNestedCallsTest::at(nestedAddress).new_nullifier(nullifier + 1).call(&mut context, GasOpts::default()); } } diff --git a/noir-projects/noir-contracts/contracts/benchmarking_contract/src/main.nr b/noir-projects/noir-contracts/contracts/benchmarking_contract/src/main.nr index 4e688ceb987..38511fc3a9f 100644 --- a/noir-projects/noir-contracts/contracts/benchmarking_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/benchmarking_contract/src/main.nr @@ -44,12 +44,7 @@ contract Benchmarking { fn increment_balance(owner: AztecAddress, value: Field) { let current = storage.balances.at(owner).read(); storage.balances.at(owner).write(current + value); - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("broadcast((Field))"), - [owner.to_field()], - GasOpts::default() - ).assert_empty(); + Benchmarking::at(context.this_address()).broadcast(owner).call(&mut context); } // Emits a public log. diff --git a/noir-projects/noir-contracts/contracts/card_game_contract/src/main.nr b/noir-projects/noir-contracts/contracts/card_game_contract/src/main.nr index 1e54f0c2866..d4416eff7cd 100644 --- a/noir-projects/noir-contracts/contracts/card_game_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/card_game_contract/src/main.nr @@ -39,13 +39,8 @@ contract CardGame { collection.remove_cards(cards, player); let mut game_deck = storage.game_decks.at(game as Field).at(player); let _added_to_game_deck = game_deck.add_cards(cards, player); - let selector = FunctionSelector::from_signature("on_game_joined(u32,(Field),u32)"); let strength = compute_deck_strength(cards); - context.call_public_function( - context.this_address(), - selector, - [game as Field, player.to_field(), strength] - ); + CardGame::at(context.this_address()).on_game_joined(game, player, strength as u32).enqueue(&mut context); } #[aztec(public)] @@ -75,13 +70,8 @@ contract CardGame { let mut game_deck = storage.game_decks.at(game as Field).at(player); game_deck.remove_cards([card], player); - let selector = FunctionSelector::from_signature("on_card_played(u32,(Field),Field)"); // docs:start:call_public_function - context.call_public_function( - context.this_address(), - selector, - [game as Field, player.to_field(), card.to_field()] - ); + CardGame::at(context.this_address()).on_card_played(game, player, card.to_field()).enqueue(&mut context); // docs:end:call_public_function } @@ -107,13 +97,7 @@ contract CardGame { let mut collection = storage.collections.at(player); let _inserted_cards = collection.add_cards(cards, player); - - let selector = FunctionSelector::from_signature("on_cards_claimed(u32,(Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [game as Field, player.to_field(), pedersen_hash(cards_fields, 0)] - ); + CardGame::at(context.this_address()).on_cards_claimed(game, player, pedersen_hash(cards_fields, 0)).enqueue(&mut context); } #[aztec(public)] diff --git a/noir-projects/noir-contracts/contracts/child_contract/src/main.nr b/noir-projects/noir-contracts/contracts/child_contract/src/main.nr index 8304aaecb3b..15117e2dbfa 100644 --- a/noir-projects/noir-contracts/contracts/child_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/child_contract/src/main.nr @@ -94,14 +94,7 @@ contract Child { #[aztec(public)] fn set_value_twice_with_nested_first() { - let pub_set_value_selector = FunctionSelector::from_signature("pub_set_value(Field)"); - let _result: Field = context.call_public_function( - context.this_address(), - pub_set_value_selector, - [10], - GasOpts::default() - ).deserialize_into(); - + let _result = Child::at(context.this_address()).pub_set_value(10).call(&mut context); storage.current_value.write(20); emit_unencrypted_log(&mut context, 20); } @@ -110,13 +103,6 @@ contract Child { fn set_value_twice_with_nested_last() { storage.current_value.write(20); emit_unencrypted_log(&mut context, 20); - - let pub_set_value_selector = FunctionSelector::from_signature("pub_set_value(Field)"); - let _result: Field = context.call_public_function( - context.this_address(), - pub_set_value_selector, - [10], - GasOpts::default() - ).deserialize_into(); + let _result = Child::at(context.this_address()).pub_set_value(10).call(&mut context); } } diff --git a/noir-projects/noir-contracts/contracts/claim_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/claim_contract/Nargo.toml index 1db74bdf3ac..7d81995453f 100644 --- a/noir-projects/noir-contracts/contracts/claim_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/claim_contract/Nargo.toml @@ -7,3 +7,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } value_note = { path = "../../../aztec-nr/value-note" } +token = { path = "../token_contract" } diff --git a/noir-projects/noir-contracts/contracts/claim_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/claim_contract/src/interfaces.nr deleted file mode 100644 index a7e14c8d9fc..00000000000 --- a/noir-projects/noir-contracts/contracts/claim_contract/src/interfaces.nr +++ /dev/null @@ -1,37 +0,0 @@ -use dep::aztec::{ - protocol_types::{abis::function_selector::FunctionSelector, address::AztecAddress}, - context::PrivateContext -}; - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - fn mint_public(self: Self, context: &mut PrivateContext, to: AztecAddress, amount: Field) { - let _ret = context.call_public_function( - self.address, - FunctionSelector::from_signature("mint_public((Field),Field)"), - [to.to_field(), amount] - ); - } - - pub fn transfer( - self: Self, - context: &mut PrivateContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - let _ret = context.call_private_function( - self.address, - FunctionSelector::from_signature("transfer((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce] - ); - } -} diff --git a/noir-projects/noir-contracts/contracts/claim_contract/src/main.nr b/noir-projects/noir-contracts/contracts/claim_contract/src/main.nr index 6cac882ba6f..090ea87a0a0 100644 --- a/noir-projects/noir-contracts/contracts/claim_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/claim_contract/src/main.nr @@ -1,13 +1,11 @@ contract Claim { - mod interfaces; - use dep::aztec::{ history::note_inclusion::prove_note_inclusion, protocol_types::{abis::function_selector::FunctionSelector, address::AztecAddress}, state_vars::SharedImmutable }; use dep::value_note::value_note::ValueNote; - use interfaces::Token; + use dep::token::Token; #[aztec(storage)] struct Storage { @@ -43,7 +41,6 @@ contract Claim { context.push_new_nullifier(proof_note.compute_nullifier(&mut context), 0); // 4) Finally we mint the reward token to the sender of the transaction - let reward_token = Token::at(storage.reward_token.read_private()); - reward_token.mint_public(&mut context, recipient, proof_note.value); + Token::at(storage.reward_token.read_private()).mint_public(recipient, proof_note.value).enqueue(&mut context); } } diff --git a/noir-projects/noir-contracts/contracts/crowdfunding_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/crowdfunding_contract/Nargo.toml index 78810768a4d..aa72f2f65f4 100644 --- a/noir-projects/noir-contracts/contracts/crowdfunding_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/crowdfunding_contract/Nargo.toml @@ -7,3 +7,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } value_note = { path = "../../../aztec-nr/value-note" } +token = { path = "../token_contract" } diff --git a/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/interfaces.nr deleted file mode 100644 index 746f8e0e24c..00000000000 --- a/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/interfaces.nr +++ /dev/null @@ -1,27 +0,0 @@ -use dep::aztec::protocol_types::{abis::function_selector::FunctionSelector, address::{AztecAddress, EthAddress}}; -use dep::aztec::{context::{PrivateContext, PublicContext}}; - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn transfer( - self: Self, - context: &mut PrivateContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - let _ret = context.call_private_function( - self.address, - FunctionSelector::from_signature("transfer((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce] - ); - } -} diff --git a/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/main.nr b/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/main.nr index 42a0883fabd..76d6335e6ff 100644 --- a/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/crowdfunding_contract/src/main.nr @@ -1,5 +1,4 @@ contract Crowdfunding { - mod interfaces; use dep::aztec::{ log::emit_unencrypted_log_from_private, @@ -7,7 +6,7 @@ contract Crowdfunding { state_vars::{PrivateSet, PublicImmutable, SharedImmutable} }; use dep::value_note::value_note::ValueNote; - use interfaces::Token; + use dep::token::Token; #[aztec(event)] struct WithdrawalProcessed { @@ -51,21 +50,15 @@ contract Crowdfunding { #[aztec(private)] fn donate(amount: u64) { // 1) Check that the deadline has not passed - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("_check_deadline()"), - [] - ); + Crowdfunding::at(context.this_address())._check_deadline().enqueue(&mut context); // 2) Transfer the donation tokens from donor to this contract - let donation_token = Token::at(storage.donation_token.read_private()); - donation_token.transfer( - &mut context, + Token::at(storage.donation_token.read_private()).transfer( context.msg_sender(), context.this_address(), amount as Field, 0 - ); + ).call(&mut context); // 3) Create a value note for the donor so that he can later on claim a rewards token in the Claim // contract by proving that the hash of this note exists in the note hash tree. @@ -81,14 +74,7 @@ contract Crowdfunding { assert(context.msg_sender() == operator_address, "Not an operator"); // 2) Transfer the donation tokens from this contract to the operator - let donation_token = Token::at(storage.donation_token.read_private()); - donation_token.transfer( - &mut context, - context.this_address(), - operator_address, - amount as Field, - 0 - ); + Token::at(storage.donation_token.read_private()).transfer(context.this_address(), operator_address, amount as Field, 0).call(&mut context); // 3) Emit an unencrypted event so that anyone can audit how much the operator has withdrawn let event = WithdrawalProcessed { amount, who: operator_address }; diff --git a/noir-projects/noir-contracts/contracts/delegator_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/delegator_contract/Nargo.toml index 8299f932ad2..1aad229b828 100644 --- a/noir-projects/noir-contracts/contracts/delegator_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/delegator_contract/Nargo.toml @@ -6,4 +6,5 @@ compiler_version = ">=0.25.0" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } -value_note = { path = "../../../aztec-nr/value-note" } \ No newline at end of file +value_note = { path = "../../../aztec-nr/value-note" } +delegated_on = { path = "../delegated_on_contract"} \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/delegator_contract/src/main.nr b/noir-projects/noir-contracts/contracts/delegator_contract/src/main.nr index 5cb189e7410..939c2f1907f 100644 --- a/noir-projects/noir-contracts/contracts/delegator_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/delegator_contract/src/main.nr @@ -5,6 +5,7 @@ contract Delegator { PublicMutable, PrivateSet, Deserialize }; use dep::value_note::value_note::ValueNote; + use dep::delegated_on::DelegatedOn; #[aztec(storage)] struct Storage { @@ -15,29 +16,21 @@ contract Delegator { #[aztec(private)] fn private_delegate_set_value( target_contract: AztecAddress, - target_selector: FunctionSelector, - args: [Field; 2] + value: Field, + owner: AztecAddress ) -> Field { // Call the target private function - context.delegate_call_private_function(target_contract, target_selector, args).unpack_into() + DelegatedOn::at(target_contract).private_set_value(value, owner).delegate_call(&mut context) } #[aztec(private)] - fn enqueued_delegate_set_value( - target_contract: AztecAddress, - target_selector: FunctionSelector, - args: [Field; 1] - ) { - context.delegate_call_public_function(target_contract, target_selector, args); + fn enqueued_delegate_set_value(target_contract: AztecAddress, value: Field) { + DelegatedOn::at(target_contract).public_set_value(value).delegate_enqueue(&mut context) } #[aztec(public)] - fn public_delegate_set_value( - target_contract: AztecAddress, - target_selector: FunctionSelector, - args: [Field; 1] - ) { - let _result: Field = context.delegate_call_public_function(target_contract, target_selector, args).deserialize_into(); + fn public_delegate_set_value(target_contract: AztecAddress, value: Field) -> Field { + DelegatedOn::at(target_contract).public_set_value(value).delegate_call(&mut context) } unconstrained fn view_private_value(amount: Field, owner: AztecAddress) -> pub Field { diff --git a/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr b/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr index 6284c1af9a5..177c61a6669 100644 --- a/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr @@ -115,11 +115,7 @@ contract DocsExample { // and returns the response. // Used to test that we can retrieve values through calls and // correctly return them in the simulation - let mut leader: Leader = context.call_private_function_no_args( - context.this_address(), - FunctionSelector::from_signature("get_shared_immutable_constrained_private()") - ).unpack_into(); - + let mut leader = DocsExample::at(context.this_address()).get_shared_immutable_constrained_private().call(&mut context); leader.points += 1; leader } @@ -130,11 +126,7 @@ contract DocsExample { // and returns the response. // Used to test that we can retrieve values through calls and // correctly return them in the simulation - let mut leader: Leader = context.call_public_function_no_args( - context.this_address(), - FunctionSelector::from_signature("get_shared_immutable_constrained_public()") - ).deserialize_into(); - + let mut leader = DocsExample::at(context.this_address()).get_shared_immutable_constrained_public().call(&mut context); leader.points += 1; leader } @@ -222,12 +214,7 @@ contract DocsExample { fn update_legendary_card(randomness: Field, points: u8) { let mut new_card = CardNote::new(points, randomness, context.msg_sender()); storage.legendary_card.replace(&mut new_card, true); - - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("update_leader((Field),u8)"), - [context.msg_sender().to_field(), points as Field] - ); + DocsExample::at(context.this_address()).update_leader(context.msg_sender(), points).enqueue(&mut context); } #[aztec(private)] @@ -246,11 +233,7 @@ contract DocsExample { storage.legendary_card.replace(&mut new_card, true); // docs:end:state_vars-PrivateMutableReplace - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("update_leader((Field),u8)"), - [context.msg_sender().to_field(), points as Field] - ); + DocsExample::at(context.this_address()).update_leader(context.msg_sender(), points).enqueue(&mut context); } #[aztec(private)] diff --git a/noir-projects/noir-contracts/contracts/easy_private_token_contract/src/main.nr b/noir-projects/noir-contracts/contracts/easy_private_token_contract/src/main.nr index a9081073066..1b5af4b8280 100644 --- a/noir-projects/noir-contracts/contracts/easy_private_token_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/easy_private_token_contract/src/main.nr @@ -1,7 +1,7 @@ // docs:start:easy_private_token_contract contract EasyPrivateToken { use dep::aztec::prelude::{AztecAddress, NoteHeader, Map}; - use dep::value_note::{balance_utils, value_note::ValueNote}; + use dep::value_note::balance_utils; use dep::easy_private_state::EasyPrivateUint; #[aztec(storage)] diff --git a/noir-projects/noir-contracts/contracts/easy_private_voting_contract/src/main.nr b/noir-projects/noir-contracts/contracts/easy_private_voting_contract/src/main.nr index 76cc88e1201..634acdb45bd 100644 --- a/noir-projects/noir-contracts/contracts/easy_private_voting_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/easy_private_voting_contract/src/main.nr @@ -30,11 +30,7 @@ contract EasyPrivateVoting { let secret = context.request_nullifier_secret_key(context.msg_sender()); // get secret key of caller of function let nullifier = dep::std::hash::pedersen_hash([context.msg_sender().to_field(), secret.low, secret.high]); // compute nullifier with this secret key so others can't descrypt it context.push_new_nullifier(nullifier, 0); // push nullifier - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("add_to_tally_public(Field)"), - [candidate] - ); + EasyPrivateVoting::at(context.this_address()).add_to_tally_public(candidate).enqueue(&mut context); } // docs:end:cast_vote diff --git a/noir-projects/noir-contracts/contracts/escrow_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/escrow_contract/Nargo.toml index 9982ff8b67f..a0c107d21a4 100644 --- a/noir-projects/noir-contracts/contracts/escrow_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/escrow_contract/Nargo.toml @@ -7,3 +7,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } address_note = { path = "../../../aztec-nr/address-note" } +token = { path = "../token_contract" } \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/escrow_contract/src/main.nr b/noir-projects/noir-contracts/contracts/escrow_contract/src/main.nr index 709c65b3ec5..c1ec425486b 100644 --- a/noir-projects/noir-contracts/contracts/escrow_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/escrow_contract/src/main.nr @@ -6,6 +6,8 @@ contract Escrow { use dep::address_note::address_note::AddressNote; + use dep::token::Token; + #[aztec(storage)] struct Storage { owner: PrivateImmutable, @@ -28,11 +30,6 @@ contract Escrow { let note = storage.owner.get_note(); assert(note.address == sender); - let selector = FunctionSelector::from_signature("transfer((Field),(Field),Field,Field)"); - let _callStackItem = context.call_private_function( - token, - selector, - [this.to_field(), recipient.to_field(), amount, 0] - ); + Token::at(token).transfer(this, recipient, amount, 0).call(&mut context); } } diff --git a/noir-projects/noir-contracts/contracts/fpc_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/fpc_contract/Nargo.toml index 887ffaf17d0..96bd8bacba7 100644 --- a/noir-projects/noir-contracts/contracts/fpc_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/fpc_contract/Nargo.toml @@ -7,3 +7,5 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } authwit = { path = "../../../aztec-nr/authwit" } +token = { path = "../token_contract" } +gas_token = { path = "../gas_token_contract" } diff --git a/noir-projects/noir-contracts/contracts/fpc_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/fpc_contract/src/interfaces.nr deleted file mode 100644 index f2f94f9884a..00000000000 --- a/noir-projects/noir-contracts/contracts/fpc_contract/src/interfaces.nr +++ /dev/null @@ -1,60 +0,0 @@ -use dep::aztec::prelude::{AztecAddress, EthAddress, FunctionSelector, PrivateContext, Deserialize}; -use dep::aztec::context::{PublicContext, gas::GasOpts}; - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn transfer_public( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("transfer_public((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce], - GasOpts::default() - ).assert_empty(); - } - - pub fn shield( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - amount: Field, - secret_hash: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("shield((Field),Field,Field,Field)"), - [from.to_field(), amount, secret_hash, nonce], - GasOpts::default() - ).assert_empty(); - } - - // Private - pub fn unshield( - self: Self, - context: &mut PrivateContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_private_function( - self.address, - FunctionSelector::from_signature("unshield((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce] - ); - } -} diff --git a/noir-projects/noir-contracts/contracts/fpc_contract/src/main.nr b/noir-projects/noir-contracts/contracts/fpc_contract/src/main.nr index 118fcd71c07..f7636711d0e 100644 --- a/noir-projects/noir-contracts/contracts/fpc_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/fpc_contract/src/main.nr @@ -1,11 +1,9 @@ -mod interfaces; - contract FPC { use dep::aztec::protocol_types::{abis::function_selector::FunctionSelector, address::AztecAddress, traits::is_empty}; use dep::aztec::state_vars::SharedImmutable; - use dep::aztec::prelude::Deserialize; + use dep::token::Token; + use dep::gas_token::GasToken; use dep::aztec::context::gas::GasOpts; - use crate::interfaces::Token; #[aztec(storage)] struct Storage { @@ -23,67 +21,34 @@ contract FPC { #[aztec(private)] fn fee_entrypoint_private(amount: Field, asset: AztecAddress, secret_hash: Field, nonce: Field) { assert(asset == storage.other_asset.read_private()); - - let _res = Token::at(asset).unshield( - &mut context, - context.msg_sender(), - context.this_address(), - amount, - nonce - ); - - let _void = context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("pay_fee_with_shielded_rebate(Field,(Field),Field)"), - [amount, asset.to_field(), secret_hash] - ); + Token::at(asset).unshield(context.msg_sender(), context.this_address(), amount, nonce).call(&mut context); + FPC::at(context.this_address()).pay_fee_with_shielded_rebate(amount, asset, secret_hash).enqueue(&mut context); } #[aztec(private)] fn fee_entrypoint_public(amount: Field, asset: AztecAddress, nonce: Field) { - let _void = context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("prepare_fee((Field),Field,(Field),Field)"), - [context.msg_sender().to_field(), amount, asset.to_field(), nonce] - ); - - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("pay_fee((Field),Field,(Field))"), - [context.msg_sender().to_field(), amount, asset.to_field()] - ); + FPC::at(context.this_address()).prepare_fee(context.msg_sender(), amount, asset, nonce).enqueue(&mut context); + FPC::at(context.this_address()).pay_fee(context.msg_sender(), amount, asset).enqueue(&mut context); } #[aztec(public)] #[aztec(internal)] fn prepare_fee(from: AztecAddress, amount: Field, asset: AztecAddress, nonce: Field) { - let _res = Token::at(asset).transfer_public(&mut context, from, context.this_address(), amount, nonce); + Token::at(asset).transfer_public(from, context.this_address(), amount, nonce).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn pay_fee(refund_address: AztecAddress, amount: Field, asset: AztecAddress) { - let refund: Field = context.call_public_function( - storage.gas_token_address.read_public(), - FunctionSelector::from_signature("pay_fee(Field)"), - [amount], - GasOpts::default() - ).deserialize_into(); - + let refund = GasToken::at(storage.gas_token_address.read_public()).pay_fee(amount).call(&mut context); // Just do public refunds for the present - Token::at(asset).transfer_public(&mut context, context.this_address(), refund_address, refund, 0) + Token::at(asset).transfer_public(context.this_address(), refund_address, refund, 0).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn pay_fee_with_shielded_rebate(amount: Field, asset: AztecAddress, secret_hash: Field) { - let refund: Field = context.call_public_function( - storage.gas_token_address.read_public(), - FunctionSelector::from_signature("pay_fee(Field)"), - [amount], - GasOpts::default() - ).deserialize_into(); - - Token::at(asset).shield(&mut context, context.this_address(), refund, secret_hash, 0); + let refund = GasToken::at(storage.gas_token_address.read_public()).pay_fee(amount).call(&mut context); + Token::at(asset).shield(context.this_address(), refund, secret_hash, 0).call(&mut context); } } diff --git a/noir-projects/noir-contracts/contracts/import_test_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/import_test_contract/Nargo.toml index f4ec2663e2b..fe205fd0f17 100644 --- a/noir-projects/noir-contracts/contracts/import_test_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/import_test_contract/Nargo.toml @@ -6,3 +6,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } +test = { path = "../test_contract"} diff --git a/noir-projects/noir-contracts/contracts/import_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/import_test_contract/src/main.nr index 0168119b822..9224c0c2a3e 100644 --- a/noir-projects/noir-contracts/contracts/import_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/import_test_contract/src/main.nr @@ -1,54 +1,44 @@ -mod test_contract_interface; - // Contract that uses the autogenerated interface of the Test contract for calling its functions. // Used for testing calling into other contracts via autogenerated interfaces. contract ImportTest { - use dep::aztec::prelude::{AztecAddress, Deserialize}; + use dep::aztec::prelude::AztecAddress; + + use dep::test::{Test, Test::DeepStruct, Test::DummyNote}; - use crate::test_contract_interface::{ - TestPrivateContextInterface, TestPublicContextInterface, AStructTestCodeGenStruct, - ADeepStructTestCodeGenStruct, ANoteADeepStructTestCodeGenStruct, - ManyNotesADeepStructTestCodeGenStruct - }; + use dep::test::Test::FieldNote; + use dep::test::Test::ValueNote; // Calls the test_code_gen on the Test contract at the target address // Used for testing calling a function with arguments of multiple types // See yarn-project/simulator/src/client/private_execution.ts // See yarn-project/end-to-end/src/e2e_nested_contract.test.ts #[aztec(private)] - fn main(target: AztecAddress) -> Field { - let test_contract_instance = TestPrivateContextInterface::at(target); - let returned_field: Field = test_contract_instance.test_code_gen( - &mut context, + fn main_contract(target: AztecAddress) -> Field { + Test::at(target).test_code_gen( 1, true, 1 as u32, [1, 2], - AStructTestCodeGenStruct { amount: 1, secret_hash: 2 }, - ADeepStructTestCodeGenStruct { + DummyNote { amount: 1, secret_hash: 2 }, + DeepStruct { a_field: 1, a_bool: true, - a_note: ANoteADeepStructTestCodeGenStruct { amount: 1, secret_hash: 2 }, + a_note: DummyNote { amount: 1, secret_hash: 2 }, many_notes: [ - ManyNotesADeepStructTestCodeGenStruct { amount: 1, secret_hash: 2 }, - ManyNotesADeepStructTestCodeGenStruct { amount: 1, secret_hash: 2 }, - ManyNotesADeepStructTestCodeGenStruct { amount: 1, secret_hash: 2 } + DummyNote { amount: 1, secret_hash: 2 }, + DummyNote { amount: 1, secret_hash: 2 }, + DummyNote { amount: 1, secret_hash: 2 } ] } - ).unpack_into(); - - returned_field + ).call(&mut context) } // Calls the get_this_address on the Test contract at the target address // Used for testing calling a function with no arguments // See yarn-project/end-to-end/src/e2e_nested_contract.test.ts #[aztec(private)] - fn call_no_args(target: AztecAddress) -> Field { - let test_contract_instance = TestPrivateContextInterface::at(target); - let returned_field: Field = test_contract_instance.get_this_address(&mut context).unpack_into(); - - returned_field + fn call_no_args(target: AztecAddress) -> AztecAddress { + Test::at(target).get_this_address().call(&mut context) } // Calls the create_nullifier_public on the Test contract at the target address @@ -56,8 +46,7 @@ contract ImportTest { // See yarn-project/end-to-end/src/e2e_nested_contract.test.ts #[aztec(private)] fn call_open_fn(target: AztecAddress) { - let test_contract_instance = TestPrivateContextInterface::at(target); - test_contract_instance.create_nullifier_public(&mut context, 1, 2); + Test::at(target).create_nullifier_public(1, 2).enqueue(&mut context); } // Calls the create_nullifier_public on the Test contract at the target address @@ -65,8 +54,7 @@ contract ImportTest { // See yarn-project/end-to-end/src/e2e_nested_contract.test.ts #[aztec(public)] fn pub_call_open_fn(target: AztecAddress) { - let test_contract_instance = TestPublicContextInterface::at(target); - test_contract_instance.create_nullifier_public(&mut context, 1, 2).assert_empty(); + Test::at(target).create_nullifier_public(1, 2).call(&mut context); } } diff --git a/noir-projects/noir-contracts/contracts/import_test_contract/src/test_contract_interface.nr b/noir-projects/noir-contracts/contracts/import_test_contract/src/test_contract_interface.nr deleted file mode 120000 index 1113fbe816e..00000000000 --- a/noir-projects/noir-contracts/contracts/import_test_contract/src/test_contract_interface.nr +++ /dev/null @@ -1 +0,0 @@ -../../test_contract/src/interface.nr \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/lending_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/lending_contract/Nargo.toml index e6a337360bc..f1e58a4ef1f 100644 --- a/noir-projects/noir-contracts/contracts/lending_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/lending_contract/Nargo.toml @@ -6,3 +6,5 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } +token = { path = "../token_contract" } +price_feed = { path = "../price_feed_contract" } diff --git a/noir-projects/noir-contracts/contracts/lending_contract/src/asset.nr b/noir-projects/noir-contracts/contracts/lending_contract/src/asset.nr index 5dc8cb7f300..7415ec54d92 100644 --- a/noir-projects/noir-contracts/contracts/lending_contract/src/asset.nr +++ b/noir-projects/noir-contracts/contracts/lending_contract/src/asset.nr @@ -1,7 +1,7 @@ use dep::aztec::prelude::AztecAddress; use dep::aztec::protocol_types::traits::{Deserialize, Serialize}; -// Struct to be used to represent "totals". Generally, there should be one per asset. +// Struct to be used to represent "totals". Generally, there should be one per Asset. // It stores the global values that are shared among all users, such as an accumulator // and last time it was updated. // In practice, it should also point to an oracle and have more fields related to @@ -13,23 +13,23 @@ struct Asset { oracle: AztecAddress, } -global ASSET_SERIALIZED_LEN: Field = 4; +global SERIALIZED_LEN: Field = 4; -impl Serialize for Asset { - fn serialize(asset: Asset) -> [Field; ASSET_SERIALIZED_LEN] { +impl Serialize for Asset { + fn serialize(Asset: Asset) -> [Field; SERIALIZED_LEN] { [ - asset.interest_accumulator.to_integer(), - asset.last_updated_ts as Field, - asset.loan_to_value.to_integer(), - asset.oracle.to_field() + Asset.interest_accumulator.to_integer(), + Asset.last_updated_ts as Field, + Asset.loan_to_value.to_integer(), + Asset.oracle.to_field() ] } } -impl Deserialize for Asset { +impl Deserialize for Asset { // Right now we are wasting so many writes. If changing last_updated_ts // we will end up rewriting all of them, wasting writes. - fn deserialize(fields: [Field; ASSET_SERIALIZED_LEN]) -> Asset { + fn deserialize(fields: [Field; SERIALIZED_LEN]) -> Asset { let interest_accumulator = U128::from_integer(fields[0]); let last_updated_ts = fields[1] as u64; let loan_to_value = U128::from_integer(fields[2]); diff --git a/noir-projects/noir-contracts/contracts/lending_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/lending_contract/src/interfaces.nr deleted file mode 100644 index 5a2e31ec79f..00000000000 --- a/noir-projects/noir-contracts/contracts/lending_contract/src/interfaces.nr +++ /dev/null @@ -1,117 +0,0 @@ -use dep::aztec::prelude::{FunctionSelector, AztecAddress, PrivateContext, Deserialize}; - -use dep::aztec::context::{PublicContext, gas::GasOpts}; - -use crate::asset::Asset; - -struct PriceFeed { - address: AztecAddress, -} - -impl PriceFeed { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn get_price(self: Self, context: &mut PublicContext) -> U128 { - let price_field: Field = context.call_public_function( - self.address, - FunctionSelector::from_signature("get_price(Field)"), - [0], - GasOpts::default() - ).deserialize_into(); - - U128::from_integer(price_field) - } -} - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn transfer_public( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("transfer_public((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce], - GasOpts::default() - ).assert_empty(); - } - - pub fn mint_public(self: Self, context: &mut PublicContext, to: AztecAddress, amount: Field) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("mint_public((Field),Field)"), - [to.to_field(), amount], - GasOpts::default() - ).assert_empty(); - } - - pub fn burn_public( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("burn_public((Field),Field,Field)"), - [from.to_field(), amount, nonce], - GasOpts::default() - ).assert_empty(); - } - - // Private - pub fn unshield( - self: Self, - context: &mut PrivateContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_private_function( - self.address, - FunctionSelector::from_signature("unshield((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce] - ); - } - - pub fn burn(self: Self, context: &mut PrivateContext, from: AztecAddress, amount: Field, nonce: Field) { - context.call_private_function( - self.address, - FunctionSelector::from_signature("burn((Field),Field,Field)"), - [from.to_field(), amount, nonce] - ); - } -} - -struct Lending { - address: AztecAddress, -} - -impl Lending { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn update_accumulator(self: Self, context: &mut PublicContext) -> Asset { - context.call_public_function_no_args( - self.address, - FunctionSelector::from_signature("update_accumulator()") - ).deserialize_into() - } -} diff --git a/noir-projects/noir-contracts/contracts/lending_contract/src/main.nr b/noir-projects/noir-contracts/contracts/lending_contract/src/main.nr index 37727015e25..c2c05f58a09 100644 --- a/noir-projects/noir-contracts/contracts/lending_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/lending_contract/src/main.nr @@ -1,7 +1,6 @@ mod asset; mod interest_math; mod helpers; -mod interfaces; // Single asset CDP contract. // Shoving re-entries up the ass. @@ -17,7 +16,8 @@ contract Lending { use crate::asset::Asset; use crate::interest_math::compute_multiplier; use crate::helpers::{covered_by_collateral, DebtReturn, debt_updates, debt_value, compute_identifier}; - use crate::interfaces::{Token, Lending, PriceFeed}; + use dep::token::Token; + use dep::price_feed::PriceFeed; // Storage structure, containing all storage, and specifying what slots they use. #[aztec(storage)] @@ -49,7 +49,7 @@ contract Lending { stable_coin: AztecAddress ) { let asset_loc = storage.assets.at(0); - let asset = asset_loc.read(); + let asset: Asset = asset_loc.read(); let loan_to_value = U128::from_integer(loan_to_value); @@ -71,7 +71,7 @@ contract Lending { #[aztec(public)] fn update_accumulator() -> Asset { let asset_loc = storage.assets.at(0); - let mut asset = asset_loc.read(); + let mut asset: Asset = asset_loc.read(); let timestamp = context.timestamp(); let dt = timestamp - asset.last_updated_ts; @@ -103,38 +103,28 @@ contract Lending { collateral_asset: AztecAddress ) { let on_behalf_of = compute_identifier(secret, on_behalf_of, context.msg_sender().to_field()); - let _res = Token::at(collateral_asset).unshield(&mut context, from, context.this_address(), amount, nonce); - // _deposit(on_behalf_of, amount, collateral_asset) - let selector = FunctionSelector::from_signature("_deposit((Field),Field,(Field))"); - context.call_public_function( - context.this_address(), - selector, - [on_behalf_of, amount, collateral_asset.to_field()] - ); + let _res = Token::at(collateral_asset).unshield(from, context.this_address(), amount, nonce).call(&mut context); + Lending::at(context.this_address())._deposit( + AztecAddress::from_field(on_behalf_of), + amount, + collateral_asset + ).enqueue(&mut context); } #[aztec(public)] fn deposit_public(amount: Field, nonce: Field, on_behalf_of: Field, collateral_asset: AztecAddress) { - Token::at(collateral_asset).transfer_public( - &mut context, - context.msg_sender(), - context.this_address(), + let _ = Token::at(collateral_asset).transfer_public(context.msg_sender(), context.this_address(), amount, nonce).call(&mut context); + let _ = Lending::at(context.this_address())._deposit( + AztecAddress::from_field(on_behalf_of), amount, - nonce - ); - let selector = FunctionSelector::from_signature("_deposit((Field),Field,(Field))"); - context.call_public_function( - context.this_address(), - selector, - [on_behalf_of, amount, collateral_asset.to_field()], - GasOpts::default() - ).assert_empty(); + collateral_asset + ).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn _deposit(owner: AztecAddress, amount: Field, collateral_asset: AztecAddress) { - let _asset = Lending::at(context.this_address()).update_accumulator(&mut context); + let _asset = Lending::at(context.this_address()).update_accumulator().call(&mut context); let coll_asset = storage.collateral_asset.read(); assert(coll_asset.eq(collateral_asset)); @@ -147,30 +137,19 @@ contract Lending { #[aztec(private)] fn withdraw_private(secret: Field, to: AztecAddress, amount: Field) { let on_behalf_of = compute_identifier(secret, 0, context.msg_sender().to_field()); - let selector = FunctionSelector::from_signature("_withdraw((Field),(Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [on_behalf_of, to.to_field(), amount] - ); + Lending::at(context.this_address())._withdraw(AztecAddress::from_field(on_behalf_of), to, amount).enqueue(&mut context); } #[aztec(public)] fn withdraw_public(to: AztecAddress, amount: Field) { - let selector = FunctionSelector::from_signature("_withdraw((Field),(Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [context.msg_sender().to_field(), to.to_field(), amount], - GasOpts::default() - ).assert_empty(); + let _ = Lending::at(context.this_address())._withdraw(context.msg_sender(), to, amount).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn _withdraw(owner: AztecAddress, recipient: AztecAddress, amount: Field) { - let asset = Lending::at(context.this_address()).update_accumulator(&mut context); - let price = PriceFeed::at(asset.oracle).get_price(&mut context); + let asset = Lending::at(context.this_address()).update_accumulator().call(&mut context); + let price = PriceFeed::at(asset.oracle).get_price(0).call(&mut context).price; let coll_loc = storage.collateral.at(owner); let collateral: Field = coll_loc.read(); @@ -200,36 +179,25 @@ contract Lending { // @todo @LHerskind Support both shielding and transfers (for now just transfer) let collateral_asset = storage.collateral_asset.read(); - Token::at(collateral_asset).transfer_public(&mut context, context.this_address(), recipient, amount, 0); + let _ = Token::at(collateral_asset).transfer_public(context.this_address(), recipient, amount, 0).call(&mut context); } #[aztec(private)] fn borrow_private(secret: Field, to: AztecAddress, amount: Field) { let on_behalf_of = compute_identifier(secret, 0, context.msg_sender().to_field()); - let selector = FunctionSelector::from_signature("_borrow((Field),(Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [on_behalf_of, to.to_field(), amount] - ); + let _ = Lending::at(context.this_address())._borrow(AztecAddress::from_field(on_behalf_of), to, amount).enqueue(&mut context); } #[aztec(public)] fn borrow_public(to: AztecAddress, amount: Field) { - let selector = FunctionSelector::from_signature("_borrow((Field),(Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [context.msg_sender().to_field(), to.to_field(), amount], - GasOpts::default() - ).assert_empty(); + let _ = Lending::at(context.this_address())._borrow(context.msg_sender(), to, amount).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn _borrow(owner: AztecAddress, to: AztecAddress, amount: Field) { - let asset = Lending::at(context.this_address()).update_accumulator(&mut context); - let price = PriceFeed::at(asset.oracle).get_price(&mut context); + let asset = Lending::at(context.this_address()).update_accumulator().call(&mut context); + let price = PriceFeed::at(asset.oracle).get_price(0).call(&mut context).price; // Fetch collateral and static_debt, compute health of current position let collateral = U128::from_integer(storage.collateral.at(owner).read()); @@ -255,7 +223,7 @@ contract Lending { // @todo @LHerskind Need to support both private and public minting. let stable_coin = storage.stable_coin.read(); - Token::at(stable_coin).mint_public(&mut context, to, amount); + let _ = Token::at(stable_coin).mint_public(to, amount).call(&mut context); } #[aztec(private)] @@ -268,31 +236,20 @@ contract Lending { stable_coin: AztecAddress ) { let on_behalf_of = compute_identifier(secret, on_behalf_of, context.msg_sender().to_field()); - let _res = Token::at(stable_coin).burn(&mut context, from, amount, nonce); - let selector = FunctionSelector::from_signature("_repay((Field),Field,(Field))"); - context.call_public_function( - context.this_address(), - selector, - [on_behalf_of, amount, stable_coin.to_field()] - ); + let _ = Token::at(stable_coin).burn(from, amount, nonce).call(&mut context); + let _ = Lending::at(context.this_address())._repay(AztecAddress::from_field(on_behalf_of), amount, stable_coin).enqueue(&mut context); } #[aztec(public)] fn repay_public(amount: Field, nonce: Field, owner: AztecAddress, stable_coin: AztecAddress) { - Token::at(stable_coin).burn_public(&mut context, context.msg_sender(), amount, nonce); - let selector = FunctionSelector::from_signature("_repay((Field),Field,(Field))"); - context.call_public_function( - context.this_address(), - selector, - [owner.to_field(), amount, stable_coin.to_field()], - GasOpts::default() - ).assert_empty(); + let _ = Token::at(stable_coin).burn_public(context.msg_sender(), amount, nonce).call(&mut context); + let _ = Lending::at(context.this_address())._repay(owner, amount, stable_coin).call(&mut context); } #[aztec(public)] #[aztec(internal)] fn _repay(owner: AztecAddress, amount: Field, stable_coin: AztecAddress) { - let asset = Lending::at(context.this_address()).update_accumulator(&mut context); + let asset = Lending::at(context.this_address()).update_accumulator().call(&mut context); // To ensure that private is using the correct token. assert(stable_coin.eq(storage.stable_coin.read())); @@ -315,7 +272,7 @@ contract Lending { unconstrained fn get_position(owner: AztecAddress) -> pub Position { let collateral = storage.collateral.at(owner).read(); let static_debt = storage.static_debt.at(owner).read(); - let asset = storage.assets.at(0).read(); + let asset: Asset = storage.assets.at(0).read(); let debt = debt_value( U128::from_integer(static_debt), U128::from_integer(asset.interest_accumulator) diff --git a/noir-projects/noir-contracts/contracts/parent_contract/src/main.nr b/noir-projects/noir-contracts/contracts/parent_contract/src/main.nr index 5dffc5e6493..fb066de5ad6 100644 --- a/noir-projects/noir-contracts/contracts/parent_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/parent_contract/src/main.nr @@ -1,8 +1,8 @@ + // A contract used along with `Child` contract to test nested calls. contract Parent { use dep::aztec::prelude::{AztecAddress, FunctionSelector, Deserialize}; use dep::aztec::context::gas::GasOpts; - // Private function to call another private function in the target_contract using the provided selector #[aztec(private)] fn entry_point(target_contract: AztecAddress, target_selector: FunctionSelector) -> Field { @@ -20,7 +20,7 @@ contract Parent { context.call_public_function( target_contract, target_selector, - [init_value], + [init_value].as_slice(), GasOpts::default() ).deserialize_into() } @@ -35,13 +35,13 @@ contract Parent { let return_value: Field = context.call_public_function( target_contract, target_selector, - [init_value], + [init_value].as_slice(), GasOpts::default() ).deserialize_into(); context.call_public_function( target_contract, target_selector, - [return_value], + [return_value].as_slice(), GasOpts::default() ).deserialize_into() } @@ -189,7 +189,12 @@ contract Parent { target_selector: FunctionSelector, args: [Field; 1] ) -> Field { - context.static_call_public_function(target_contract, target_selector, args, GasOpts::default()).deserialize_into() + context.static_call_public_function( + target_contract, + target_selector, + args.as_slice(), + GasOpts::default() + ).deserialize_into() } // Public function to set a static context and verify correct propagation for nested public calls @@ -205,7 +210,7 @@ contract Parent { context.static_call_public_function( this_address, pub_entry_point_selector, - [target_contract.to_field(), target_selector.to_field(), args[0]], + [target_contract.to_field(), target_selector.to_field(), args[0]].as_slice(), GasOpts::default() ).deserialize_into() } diff --git a/noir-projects/noir-contracts/contracts/slow_tree_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/slow_tree_contract/Nargo.toml index 54270ccd97e..2edcc357b5a 100644 --- a/noir-projects/noir-contracts/contracts/slow_tree_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/slow_tree_contract/Nargo.toml @@ -6,5 +6,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } -value_note = { path = "../../../aztec-nr/value-note" } slow_updates_tree = { path = "../../../aztec-nr/slow-updates-tree" } diff --git a/noir-projects/noir-contracts/contracts/slow_tree_contract/src/main.nr b/noir-projects/noir-contracts/contracts/slow_tree_contract/src/main.nr index 2fa7b935a4b..f71c2ff62c5 100644 --- a/noir-projects/noir-contracts/contracts/slow_tree_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/slow_tree_contract/src/main.nr @@ -12,7 +12,6 @@ contract SlowTree { Map, PublicMutable, PrivateSet }; - use dep::value_note::{balance_utils, utils::{increment, decrement}, value_note::ValueNote}; use dep::aztec::{context::{PublicContext, Context}, protocol_types::type_serialization::FIELD_SERIALIZED_LEN}; use dep::slow_updates_tree::{SlowMap, Leaf, SlowUpdateProof, compute_merkle_root, deserialize_slow_update_proof}; diff --git a/noir-projects/noir-contracts/contracts/stateful_test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/stateful_test_contract/src/main.nr index 3c7ac5c3af0..db8efde4a25 100644 --- a/noir-projects/noir-contracts/contracts/stateful_test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/stateful_test_contract/src/main.nr @@ -17,8 +17,7 @@ contract StatefulTest { #[aztec(private)] #[aztec(initializer)] fn constructor(owner: AztecAddress, value: Field) { - let selector = FunctionSelector::from_signature("create_note_no_init_check((Field),Field)"); - context.call_private_function(context.this_address(), selector, [owner.to_field(), value]).assert_empty(); + StatefulTest::at(context.this_address()).create_note_no_init_check(owner, value).call(&mut context); } #[aztec(private)] @@ -31,13 +30,7 @@ contract StatefulTest { #[aztec(public)] #[aztec(initializer)] fn public_constructor(owner: AztecAddress, value: Field) { - let selector = FunctionSelector::from_signature("increment_public_value_no_init_check((Field),Field)"); - context.call_public_function( - context.this_address(), - selector, - [owner.to_field(), value], - GasOpts::default() - ).assert_empty(); + StatefulTest::at(context.this_address()).increment_public_value_no_init_check(owner, value).call(&mut context); } #[aztec(private)] diff --git a/noir-projects/noir-contracts/contracts/test_contract/src/interface.nr b/noir-projects/noir-contracts/contracts/test_contract/src/interface.nr deleted file mode 100644 index 71133236902..00000000000 --- a/noir-projects/noir-contracts/contracts/test_contract/src/interface.nr +++ /dev/null @@ -1,675 +0,0 @@ -/* Autogenerated file, do not edit! */ - -use dep::std; -use dep::aztec::context::{ PrivateContext, PublicContext, PackedReturns, FunctionReturns, gas::GasOpts }; -use dep::aztec::protocol_types::{ - address::AztecAddress, - abis::function_selector::FunctionSelector, -}; - -struct AddressGetPublicKeyStruct { - inner: Field, -} - -struct TargetDeployContractStruct { - inner: Field, -} - -struct SenderConsumeMessageFromArbitrarySenderPublicStruct { - inner: Field, -} - -struct ToConsumeMintPublicMessageStruct { - inner: Field, -} - -struct RecipientCreateL2ToL1MessageArbitraryRecipientPrivateStruct { - inner: Field, -} - -struct SenderConsumeMessageFromArbitrarySenderPrivateStruct { - inner: Field, -} - -struct CoinbaseAssertPublicGlobalVarsStruct { - inner: Field, -} - -struct FeeRecipientAssertPublicGlobalVarsStruct { - inner: Field, -} - -struct OwnerCallCreateNoteStruct { - inner: Field, -} - -struct AStructTestCodeGenStruct { - amount: Field, - secret_hash: Field, -} - -struct ADeepStructTestCodeGenStruct { - a_field: Field, - a_bool: bool, - a_note: ANoteADeepStructTestCodeGenStruct, - many_notes: [ManyNotesADeepStructTestCodeGenStruct;3], -} - -struct ANoteADeepStructTestCodeGenStruct { - amount: Field, - secret_hash: Field, -} - -struct ManyNotesADeepStructTestCodeGenStruct { - amount: Field, - secret_hash: Field, -} - -struct RecipientCreateL2ToL1MessageArbitraryRecipientPublicStruct { - inner: Field, -} - -struct AztecAddressGetPortalContractAddressStruct { - inner: Field, -} - - -// Interface for calling Test functions from a private context -struct TestPrivateContextInterface { - address: AztecAddress, -} - -impl TestPrivateContextInterface { - pub fn at(address: AztecAddress) -> Self { - Self { - address, - } - } - - pub fn get_public_key( - self, - context: &mut PrivateContext, - address: AddressGetPublicKeyStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = address.inner; - - context.call_private_function(self.address, FunctionSelector::from_field(0x501e4f48), serialized_args) - } - - - pub fn assert_header_public( - self, - context: &mut PrivateContext, - header_hash: Field - ) { - let mut serialized_args = [0; 1]; - serialized_args[0] = header_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0x86e38c61), serialized_args) - } - - - pub fn deploy_contract( - self, - context: &mut PrivateContext, - target: TargetDeployContractStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = target.inner; - - context.call_private_function(self.address, FunctionSelector::from_field(0x5acec588), serialized_args) - } - - - pub fn get_this_address( - self, - context: &mut PrivateContext - ) -> PackedReturns{ - let mut serialized_args = [0; 0]; - - context.call_private_function(self.address, FunctionSelector::from_field(0x95a7b2ae), serialized_args) - } - - - pub fn emit_msg_sender( - self, - context: &mut PrivateContext - ) -> PackedReturns{ - let mut serialized_args = [0; 0]; - - context.call_private_function(self.address, FunctionSelector::from_field(0x11fb5d45), serialized_args) - } - - - pub fn consume_message_from_arbitrary_sender_public( - self, - context: &mut PrivateContext, - content: Field, - secret: Field, - sender: SenderConsumeMessageFromArbitrarySenderPublicStruct - ) { - let mut serialized_args = [0; 3]; - serialized_args[0] = content; - serialized_args[1] = secret; - serialized_args[2] = sender.inner; - - context.call_public_function(self.address, FunctionSelector::from_field(0x42ca6d60), serialized_args) - } - - - pub fn emit_unencrypted( - self, - context: &mut PrivateContext, - value: Field - ) { - let mut serialized_args = [0; 1]; - serialized_args[0] = value; - - context.call_public_function(self.address, FunctionSelector::from_field(0x817a64cb), serialized_args) - } - - - pub fn consume_mint_public_message( - self, - context: &mut PrivateContext, - to: ToConsumeMintPublicMessageStruct, - amount: Field, - secret: Field - ) { - let mut serialized_args = [0; 3]; - serialized_args[0] = to.inner; - serialized_args[1] = amount; - serialized_args[2] = secret; - - context.call_public_function(self.address, FunctionSelector::from_field(0xa0f84219), serialized_args) - } - - - pub fn create_nullifier_public( - self, - context: &mut PrivateContext, - amount: Field, - secret_hash: Field - ) { - let mut serialized_args = [0; 2]; - serialized_args[0] = amount; - serialized_args[1] = secret_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0xdf02db8d), serialized_args) - } - - - pub fn call_get_notes_many( - self, - context: &mut PrivateContext, - storage_slot: Field, - active_or_nullified: bool - ) -> PackedReturns{ - let mut serialized_args = [0; 2]; - serialized_args[0] = storage_slot; - serialized_args[1] = active_or_nullified as Field; - - context.call_private_function(self.address, FunctionSelector::from_field(0xcfcadbce), serialized_args) - } - - - pub fn create_l2_to_l1_message_arbitrary_recipient_private( - self, - context: &mut PrivateContext, - content: Field, - recipient: RecipientCreateL2ToL1MessageArbitraryRecipientPrivateStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 2]; - serialized_args[0] = content; - serialized_args[1] = recipient.inner; - - context.call_private_function(self.address, FunctionSelector::from_field(0xaccc5d5d), serialized_args) - } - - - pub fn consume_message_from_arbitrary_sender_private( - self, - context: &mut PrivateContext, - content: Field, - secret: Field, - sender: SenderConsumeMessageFromArbitrarySenderPrivateStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 3]; - serialized_args[0] = content; - serialized_args[1] = secret; - serialized_args[2] = sender.inner; - - context.call_private_function(self.address, FunctionSelector::from_field(0x2847cb26), serialized_args) - } - - - pub fn create_l2_to_l1_message_public( - self, - context: &mut PrivateContext, - amount: Field, - secret_hash: Field - ) { - let mut serialized_args = [0; 2]; - serialized_args[0] = amount; - serialized_args[1] = secret_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0x9749ca06), serialized_args) - } - - - pub fn is_time_equal( - self, - context: &mut PrivateContext, - time: u64 - ) { - let mut serialized_args = [0; 1]; - serialized_args[0] = time as Field; - - context.call_public_function(self.address, FunctionSelector::from_field(0xb5bb17fa), serialized_args) - } - - - pub fn assert_private_global_vars( - self, - context: &mut PrivateContext, - chain_id: Field, - version: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 2]; - serialized_args[0] = chain_id; - serialized_args[1] = version; - - context.call_private_function(self.address, FunctionSelector::from_field(0x7a8e9b66), serialized_args) - } - - - pub fn assert_public_global_vars( - self, - context: &mut PrivateContext, - chain_id: Field, - version: Field, - block_number: Field, - timestamp: u64, - coinbase: CoinbaseAssertPublicGlobalVarsStruct, - fee_recipient: FeeRecipientAssertPublicGlobalVarsStruct, - fee_per_da_gas: Field, - fee_per_l1_gas: Field, - fee_per_l2_gas: Field - ) { - let mut serialized_args = [0; 9]; - serialized_args[0] = chain_id; - serialized_args[1] = version; - serialized_args[2] = block_number; - serialized_args[3] = timestamp as Field; - serialized_args[4] = coinbase.inner; - serialized_args[5] = fee_recipient.inner; - serialized_args[6] = fee_per_da_gas; - serialized_args[7] = fee_per_l1_gas; - serialized_args[8] = fee_per_l2_gas; - - context.call_public_function(self.address, FunctionSelector::from_field(0x33b3a245), serialized_args) - } - - - pub fn consume_note_from_secret( - self, - context: &mut PrivateContext, - secret: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = secret; - - context.call_private_function(self.address, FunctionSelector::from_field(0x754932c8), serialized_args) - } - - - pub fn call_destroy_note( - self, - context: &mut PrivateContext, - storage_slot: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = storage_slot; - - context.call_private_function(self.address, FunctionSelector::from_field(0xf52a62f7), serialized_args) - } - - - pub fn call_create_note( - self, - context: &mut PrivateContext, - value: Field, - owner: OwnerCallCreateNoteStruct, - storage_slot: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 3]; - serialized_args[0] = value; - serialized_args[1] = owner.inner; - serialized_args[2] = storage_slot; - - context.call_private_function(self.address, FunctionSelector::from_field(0x946991ff), serialized_args) - } - - - pub fn get_this_portal_address( - self, - context: &mut PrivateContext - ) -> PackedReturns{ - let mut serialized_args = [0; 0]; - - context.call_private_function(self.address, FunctionSelector::from_field(0xc71384f5), serialized_args) - } - - - pub fn call_get_notes( - self, - context: &mut PrivateContext, - storage_slot: Field, - active_or_nullified: bool - ) -> PackedReturns{ - let mut serialized_args = [0; 2]; - serialized_args[0] = storage_slot; - serialized_args[1] = active_or_nullified as Field; - - context.call_private_function(self.address, FunctionSelector::from_field(0x11eeb3ea), serialized_args) - } - - - pub fn test_code_gen( - self, - context: &mut PrivateContext, - a_field: Field, - a_bool: bool, - a_number: u32, - an_array: [Field;2], - a_struct: AStructTestCodeGenStruct, - a_deep_struct: ADeepStructTestCodeGenStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 17]; - serialized_args[0] = a_field; - serialized_args[1] = a_bool as Field; - serialized_args[2] = a_number as Field; - serialized_args[3] = an_array[0]; - serialized_args[4] = an_array[1]; - serialized_args[5] = a_struct.amount; - serialized_args[6] = a_struct.secret_hash; - serialized_args[7] = a_deep_struct.a_field; - serialized_args[8] = a_deep_struct.a_bool as Field; - serialized_args[9] = a_deep_struct.a_note.amount; - serialized_args[10] = a_deep_struct.a_note.secret_hash; - serialized_args[11] = a_deep_struct.many_notes[0].amount; - serialized_args[12] = a_deep_struct.many_notes[0].secret_hash; - serialized_args[13] = a_deep_struct.many_notes[1].amount; - serialized_args[14] = a_deep_struct.many_notes[1].secret_hash; - serialized_args[15] = a_deep_struct.many_notes[2].amount; - serialized_args[16] = a_deep_struct.many_notes[2].secret_hash; - - context.call_private_function(self.address, FunctionSelector::from_field(0x0f054f9b), serialized_args) - } - - - pub fn set_constant( - self, - context: &mut PrivateContext, - value: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = value; - - context.call_private_function(self.address, FunctionSelector::from_field(0x1b3b9e18), serialized_args) - } - - - pub fn consume_mint_private_message( - self, - context: &mut PrivateContext, - secret_hash_for_redeeming_minted_notes: Field, - amount: Field, - secret_for_L1_to_L2_message_consumption: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 3]; - serialized_args[0] = secret_hash_for_redeeming_minted_notes; - serialized_args[1] = amount; - serialized_args[2] = secret_for_L1_to_L2_message_consumption; - - context.call_private_function(self.address, FunctionSelector::from_field(0xa0fdbaa9), serialized_args) - } - - - pub fn create_l2_to_l1_message_arbitrary_recipient_public( - self, - context: &mut PrivateContext, - content: Field, - recipient: RecipientCreateL2ToL1MessageArbitraryRecipientPublicStruct - ) { - let mut serialized_args = [0; 2]; - serialized_args[0] = content; - serialized_args[1] = recipient.inner; - - context.call_public_function(self.address, FunctionSelector::from_field(0x2fb25188), serialized_args) - } - - - pub fn emit_nullifier( - self, - context: &mut PrivateContext, - nullifier: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = nullifier; - - context.call_private_function(self.address, FunctionSelector::from_field(0x82a8b183), serialized_args) - } - - - pub fn emit_array_as_unencrypted_log( - self, - context: &mut PrivateContext, - fields: [Field;5] - ) -> PackedReturns{ - let mut serialized_args = [0; 5]; - serialized_args[0] = fields[0]; - serialized_args[1] = fields[1]; - serialized_args[2] = fields[2]; - serialized_args[3] = fields[3]; - serialized_args[4] = fields[4]; - - context.call_private_function(self.address, FunctionSelector::from_field(0xe25cbdd3), serialized_args) - } - - - pub fn get_portal_contract_address( - self, - context: &mut PrivateContext, - aztec_address: AztecAddressGetPortalContractAddressStruct - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = aztec_address.inner; - - context.call_private_function(self.address, FunctionSelector::from_field(0x30e5344b), serialized_args) - } - - - pub fn request_max_block_number( - self, - context: &mut PrivateContext, - max_block_number: u32, - enqueue_public_call: bool - ) -> PackedReturns{ - let mut serialized_args = [0; 2]; - serialized_args[0] = max_block_number as Field; - serialized_args[1] = enqueue_public_call as Field; - - context.call_private_function(self.address, FunctionSelector::from_field(0x6db24b2e), serialized_args) - } - - - pub fn assert_header_private( - self, - context: &mut PrivateContext, - header_hash: Field - ) -> PackedReturns{ - let mut serialized_args = [0; 1]; - serialized_args[0] = header_hash; - - context.call_private_function(self.address, FunctionSelector::from_field(0x4e45eb9e), serialized_args) - } - -} - - - - -// Interface for calling Test functions from a public context -struct TestPublicContextInterface { - address: AztecAddress, -} - -impl TestPublicContextInterface { - pub fn at(address: AztecAddress) -> Self { - Self { - address, - } - } - - pub fn assert_header_public( - self, - context: &mut PublicContext, - header_hash: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 1]; - serialized_args[0] = header_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0x86e38c61), serialized_args, GasOpts::default()) - } - - - pub fn consume_message_from_arbitrary_sender_public( - self, - context: &mut PublicContext, - content: Field, - secret: Field, - sender: SenderConsumeMessageFromArbitrarySenderPublicStruct - ) -> FunctionReturns { - let mut serialized_args = [0; 3]; - serialized_args[0] = content; - serialized_args[1] = secret; - serialized_args[2] = sender.inner; - - context.call_public_function(self.address, FunctionSelector::from_field(0x42ca6d60), serialized_args, GasOpts::default()) - } - - - pub fn emit_unencrypted( - self, - context: &mut PublicContext, - value: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 1]; - serialized_args[0] = value; - - context.call_public_function(self.address, FunctionSelector::from_field(0x817a64cb), serialized_args, GasOpts::default()) - } - - - pub fn consume_mint_public_message( - self, - context: &mut PublicContext, - to: ToConsumeMintPublicMessageStruct, - amount: Field, - secret: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 3]; - serialized_args[0] = to.inner; - serialized_args[1] = amount; - serialized_args[2] = secret; - - context.call_public_function(self.address, FunctionSelector::from_field(0xa0f84219), serialized_args, GasOpts::default()) - } - - - pub fn create_nullifier_public( - self, - context: &mut PublicContext, - amount: Field, - secret_hash: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 2]; - serialized_args[0] = amount; - serialized_args[1] = secret_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0xdf02db8d), serialized_args, GasOpts::default()) - } - - - pub fn create_l2_to_l1_message_public( - self, - context: &mut PublicContext, - amount: Field, - secret_hash: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 2]; - serialized_args[0] = amount; - serialized_args[1] = secret_hash; - - context.call_public_function(self.address, FunctionSelector::from_field(0x9749ca06), serialized_args, GasOpts::default()) - } - - - pub fn is_time_equal( - self, - context: &mut PublicContext, - time: u64 - ) -> FunctionReturns { - let mut serialized_args = [0; 1]; - serialized_args[0] = time as Field; - - context.call_public_function(self.address, FunctionSelector::from_field(0xb5bb17fa), serialized_args, GasOpts::default()) - } - - - pub fn assert_public_global_vars( - self, - context: &mut PublicContext, - chain_id: Field, - version: Field, - block_number: Field, - timestamp: u64, - coinbase: CoinbaseAssertPublicGlobalVarsStruct, - fee_recipient: FeeRecipientAssertPublicGlobalVarsStruct, - fee_per_da_gas: Field, - fee_per_l1_gas: Field, - fee_per_l2_gas: Field - ) -> FunctionReturns { - let mut serialized_args = [0; 9]; - serialized_args[0] = chain_id; - serialized_args[1] = version; - serialized_args[2] = block_number; - serialized_args[3] = timestamp as Field; - serialized_args[4] = coinbase.inner; - serialized_args[5] = fee_recipient.inner; - serialized_args[6] = fee_per_da_gas; - serialized_args[7] = fee_per_l1_gas; - serialized_args[8] = fee_per_l2_gas; - - context.call_public_function(self.address, FunctionSelector::from_field(0x33b3a245), serialized_args, GasOpts::default()) - } - - - pub fn create_l2_to_l1_message_arbitrary_recipient_public( - self, - context: &mut PublicContext, - content: Field, - recipient: RecipientCreateL2ToL1MessageArbitraryRecipientPublicStruct - ) -> FunctionReturns { - let mut serialized_args = [0; 2]; - serialized_args[0] = content; - serialized_args[1] = recipient.inner; - - context.call_public_function(self.address, FunctionSelector::from_field(0x2fb25188), serialized_args, GasOpts::default()) - } - -} - - diff --git a/noir-projects/noir-contracts/contracts/test_contract/src/main.nr b/noir-projects/noir-contracts/contracts/test_contract/src/main.nr index 663cafa4860..535e96dc43a 100644 --- a/noir-projects/noir-contracts/contracts/test_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/test_contract/src/main.nr @@ -7,7 +7,7 @@ contract Test { use dep::aztec::protocol_types::{ abis::private_circuit_public_inputs::PrivateCircuitPublicInputs, - constants::{MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, MAX_NOTES_PER_PAGE} + constants::{MAX_NOTE_HASH_READ_REQUESTS_PER_CALL, MAX_NOTES_PER_PAGE}, traits::Serialize }; // docs:start:unencrypted_import use dep::aztec::prelude::emit_unencrypted_log; @@ -72,11 +72,7 @@ contract Test { context.set_tx_max_block_number(max_block_number); if enqueue_public_call { - let _ = context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("dummy_public_call()"), - [] - ); + Test::at(context.this_address()).dummy_public_call().enqueue(&mut context) } } @@ -179,18 +175,15 @@ contract Test { destroy_note(&mut context, note); } - // Test codegen for Aztec.nr interfaces - // See yarn-project/simulator/src/client/private_execution.test.ts 'nested calls through autogenerated interface' - // Note; this function is deliberately NOT annotated with #[aztec(private)] due to its use in tests + #[aztec(private)] fn test_code_gen( - inputs: PrivateContextInputs, a_field: Field, a_bool: bool, a_number: u32, an_array: [Field; 2], a_struct: DummyNote, a_deep_struct: DeepStruct - ) -> distinct pub PrivateCircuitPublicInputs { + ) -> Field { let mut args = ArgsHasher::new(); args.add(a_field); args.add(a_bool as Field); @@ -206,12 +199,7 @@ contract Test { args.add(note.amount); args.add(note.secret_hash); } - let args_hash = args.hash(); - let mut context = PrivateContext::new(inputs, args_hash); - let mut returns = ArgsHasher::new(); - returns.add(args_hash); - context.set_return_hash(returns); - context.finish() + args.hash() } // Purely exists for testing @@ -408,10 +396,36 @@ contract Test { } } + impl Serialize<2> for DummyNote { + fn serialize(self) -> [Field; 2] { + [self.amount, self.secret_hash] + } + } + struct DeepStruct { a_field: Field, a_bool: bool, a_note: DummyNote, many_notes: [DummyNote; 3], } + + // Serializing using "canonical" form. + // 1. Everything that fits in a field, *becomes* a Field + // 2. Strings become arrays of bytes (no strings here) + // 4. Arrays become arrays of Fields following rules 2 and 3 (no arrays here) + // 5. Structs become arrays of Fields, with every item defined in the same order as they are in Noir code, following rules 2, 3, 4 and 5 (recursive) + impl Serialize<10> for DeepStruct { + fn serialize(self) -> [Field; 10] { + let mut result = [0; 10]; + result[0] = self.a_field; + result[1] = self.a_bool as Field; + result[2] = self.a_note.amount; + result[3] = self.a_note.secret_hash; + for i in 0..3 { + result[4 + i * 2] = self.many_notes[i].amount; + result[5 + i * 2] = self.many_notes[i].secret_hash; + } + result + } + } } diff --git a/noir-projects/noir-contracts/contracts/token_blacklist_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/token_blacklist_contract/Nargo.toml index 493c9159332..54bc420b804 100644 --- a/noir-projects/noir-contracts/contracts/token_blacklist_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/token_blacklist_contract/Nargo.toml @@ -8,3 +8,4 @@ type = "contract" aztec = { path = "../../../aztec-nr/aztec" } field_note = { path = "../../../aztec-nr/field-note" } authwit = { path = "../../../aztec-nr/authwit" } +slow_tree = { path = "../slow_tree_contract" } \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr deleted file mode 100644 index 601d9ba65f0..00000000000 --- a/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/interfaces.nr +++ /dev/null @@ -1,45 +0,0 @@ -use dep::aztec::protocol_types::{abis::function_selector::FunctionSelector, address::AztecAddress}; -use dep::aztec::prelude::Deserialize; -use dep::aztec::context::{PrivateContext, PublicContext, Context, gas::GasOpts}; - -struct SlowMap { - address: AztecAddress, -} - -impl SlowMap { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn initialize(self: Self, context: &mut PublicContext) { - context.call_public_function_no_args( - self.address, - FunctionSelector::from_signature("initialize()") - ).assert_empty(); - } - - pub fn read_at_pub(self: Self, context: &mut PublicContext, index: Field) -> Field { - context.call_public_function( - self.address, - FunctionSelector::from_signature("read_at_pub(Field)"), - [index], - GasOpts::default() - ).deserialize_into() - } - - pub fn read_at(self: Self, context: &mut PrivateContext, index: Field) -> Field { - context.call_private_function( - self.address, - FunctionSelector::from_signature("read_at(Field)"), - [index] - ).unpack_into() - } - - pub fn update_at_private(self: Self, context: &mut PrivateContext, index: Field, new_value: Field) { - let _ = context.call_private_function( - self.address, - FunctionSelector::from_signature("update_at_private(Field,Field)"), - [index, new_value] - ); - } -} diff --git a/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr b/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr index cfad6717cc9..ddb115c721e 100644 --- a/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/token_blacklist_contract/src/main.nr @@ -1,6 +1,4 @@ mod types; -mod interfaces; - // Minimal token implementation that supports `AuthWit` accounts and the slow update tree. // The auth message follows a similar pattern to the cross-chain message and includes a designated caller. // The designated caller is ALWAYS used here, and not based on a flag as cross-chain. @@ -27,7 +25,7 @@ contract TokenBlacklist { use crate::types::{transparent_note::TransparentNote, token_note::TokenNote, balances_map::BalancesMap, roles::UserFlags}; // docs:start:interface - use crate::interfaces::SlowMap; + use dep::slow_tree::SlowTree; // docs:end:interface #[aztec(storage)] @@ -51,25 +49,20 @@ contract TokenBlacklist { storage.slow_update.initialize(slow_updates_contract); // docs:end:write_slow_update_public // docs:start:slowmap_initialize - SlowMap::at(slow_updates_contract).initialize(&mut context); + SlowTree::at(slow_updates_contract).initialize().call(&mut context); // docs:end:slowmap_initialize // We cannot do the following atm // let roles = UserFlags { is_admin: true, is_minter: false, is_blacklisted: false }.get_value().to_field(); - // SlowMap::at(slow_updates_contract).update_at_private(&mut context, admin.to_field(), roles); + // SlowTree::at(slow_updates_contract).update_at_private(&mut context, admin.to_field(), roles); } #[aztec(private)] fn init_slow_tree(user: AztecAddress) { let roles = UserFlags { is_admin: true, is_minter: false, is_blacklisted: false }.get_value().to_field(); // docs:start:get_and_update_private - let slow = SlowMap::at(storage.slow_update.read_private()); - slow.update_at_private(&mut context, user.to_field(), roles); + SlowTree::at(storage.slow_update.read_private()).update_at_private(user.to_field(), roles).call(&mut context); // docs:end:get_and_update_private - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("_init_slow_tree((Field))"), - [context.msg_sender().to_field()] - ); + TokenBlacklist::at(context.this_address())._init_slow_tree(context.msg_sender()).enqueue(&mut context); } #[aztec(public)] @@ -81,25 +74,27 @@ contract TokenBlacklist { #[aztec(private)] fn update_roles(user: AztecAddress, roles: Field) { // docs:start:slowmap_at - let slow = SlowMap::at(storage.slow_update.read_private()); + let slow = SlowTree::at(storage.slow_update.read_private()); // docs:end:slowmap_at - let caller_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, context.msg_sender().to_field()))); + let role = slow.read_at(context.msg_sender().to_field()).call(&mut context); + + let caller_roles = UserFlags::new(U128::from_integer(role)); assert(caller_roles.is_admin, "caller is not admin"); - slow.update_at_private(&mut context, user.to_field(), roles); + slow.update_at_private(user.to_field(), roles).call(&mut context); } #[aztec(public)] fn mint_public(to: AztecAddress, amount: Field) { // docs:start:get_public - let slow = SlowMap::at(storage.slow_update.read_public()); + let slow = SlowTree::at(storage.slow_update.read_public()); // docs:end:get_public // docs:start:read_at_pub - let to_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, to.to_field()))); + let to_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(to.to_field()).call(&mut context))); // docs:end:read_at_pub assert(!to_roles.is_blacklisted, "Blacklisted: Recipient"); - let caller_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, context.msg_sender().to_field()))); + let caller_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(context.msg_sender().to_field()).call(&mut context))); assert(caller_roles.is_minter, "caller is not minter"); let amount = U128::from_integer(amount); @@ -112,8 +107,8 @@ contract TokenBlacklist { #[aztec(public)] fn mint_private(amount: Field, secret_hash: Field) { - let slow = SlowMap::at(storage.slow_update.read_public()); - let caller_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, context.msg_sender().to_field()))); + let slow = SlowTree::at(storage.slow_update.read_public()); + let caller_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(context.msg_sender().to_field()).call(&mut context))); assert(caller_roles.is_minter, "caller is not minter"); let pending_shields = storage.pending_shields; @@ -126,8 +121,8 @@ contract TokenBlacklist { #[aztec(public)] fn shield(from: AztecAddress, amount: Field, secret_hash: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_public()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_public()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); if (!from.eq(context.msg_sender())) { @@ -149,10 +144,10 @@ contract TokenBlacklist { #[aztec(public)] fn transfer_public(from: AztecAddress, to: AztecAddress, amount: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_public()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_public()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); - let to_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, to.to_field()))); + let to_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(to.to_field()).call(&mut context))); assert(!to_roles.is_blacklisted, "Blacklisted: Recipient"); if (!from.eq(context.msg_sender())) { @@ -171,8 +166,8 @@ contract TokenBlacklist { #[aztec(public)] fn burn_public(from: AztecAddress, amount: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_public()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_public()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at_pub(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); if (!from.eq(context.msg_sender())) { @@ -191,9 +186,9 @@ contract TokenBlacklist { #[aztec(private)] fn redeem_shield(to: AztecAddress, amount: Field, secret: Field) { - let slow = SlowMap::at(storage.slow_update.read_private()); + let slow = SlowTree::at(storage.slow_update.read_private()); // docs:start:slowmap_read_at - let to_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, to.to_field()))); + let to_roles = UserFlags::new(U128::from_integer(slow.read_at(to.to_field()).call(&mut context))); // docs:end:slowmap_read_at assert(!to_roles.is_blacklisted, "Blacklisted: Recipient"); @@ -218,10 +213,10 @@ contract TokenBlacklist { #[aztec(private)] fn unshield(from: AztecAddress, to: AztecAddress, amount: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_private()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_private()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); - let to_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, to.to_field()))); + let to_roles = UserFlags::new(U128::from_integer(slow.read_at(to.to_field()).call(&mut context))); assert(!to_roles.is_blacklisted, "Blacklisted: Recipient"); if (!from.eq(context.msg_sender())) { @@ -239,10 +234,10 @@ contract TokenBlacklist { // docs:start:transfer_private #[aztec(private)] fn transfer(from: AztecAddress, to: AztecAddress, amount: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_private()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_private()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); - let to_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, to.to_field()))); + let to_roles = UserFlags::new(U128::from_integer(slow.read_at(to.to_field()).call(&mut context))); assert(!to_roles.is_blacklisted, "Blacklisted: Recipient"); // docs:end:transfer_private @@ -259,8 +254,8 @@ contract TokenBlacklist { #[aztec(private)] fn burn(from: AztecAddress, amount: Field, nonce: Field) { - let slow = SlowMap::at(storage.slow_update.read_private()); - let from_roles = UserFlags::new(U128::from_integer(slow.read_at(&mut context, from.to_field()))); + let slow = SlowTree::at(storage.slow_update.read_private()); + let from_roles = UserFlags::new(U128::from_integer(slow.read_at(from.to_field()).call(&mut context))); assert(!from_roles.is_blacklisted, "Blacklisted: Sender"); if (!from.eq(context.msg_sender())) { diff --git a/noir-projects/noir-contracts/contracts/token_bridge_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/token_bridge_contract/Nargo.toml index da41973739d..75c729d9c50 100644 --- a/noir-projects/noir-contracts/contracts/token_bridge_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/token_bridge_contract/Nargo.toml @@ -7,3 +7,4 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } token_portal_content_hash_lib = { path = "../token_portal_content_hash_lib" } +token = { path = "../token_contract" } diff --git a/noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr b/noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr index 673e4b8aa7f..c5814ed81ce 100644 --- a/noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr @@ -1,5 +1,4 @@ // docs:start:token_bridge_imports -mod token_interface; // Minimal implementation of the token bridge that can move funds between L1 <> L2. // The bridge has a corresponding Portal contract on L1 that it is attached to @@ -13,7 +12,7 @@ contract TokenBridge { use dep::token_portal_content_hash_lib::{get_mint_public_content_hash, get_mint_private_content_hash, get_withdraw_content_hash}; - use crate::token_interface::Token; + use dep::token::Token; // docs:end:token_bridge_imports // docs:start:token_bridge_storage_and_constructor @@ -42,7 +41,7 @@ contract TokenBridge { context.consume_l1_to_l2_message(content_hash, secret, context.this_portal_address()); // Mint tokens - Token::at(storage.token.read()).mint_public(&mut context, to, amount); + Token::at(storage.token.read()).mint_public(to, amount).call(&mut context); } // docs:end:claim_public @@ -61,7 +60,7 @@ contract TokenBridge { context.message_portal(context.this_portal_address(), content); // Burn tokens - Token::at(storage.token.read()).burn_public(&mut context, context.msg_sender(), amount, nonce); + Token::at(storage.token.read()).burn_public(context.msg_sender(), amount, nonce).call(&mut context); } // docs:end:exit_to_l1_public // docs:start:claim_private @@ -118,7 +117,7 @@ contract TokenBridge { // docs:end:call_assert_token_is_same // Burn tokens - Token::at(token).burn(&mut context, context.msg_sender(), amount, nonce); + Token::at(token).burn(context.msg_sender(), amount, nonce).call(&mut context); } /// docs:end:exit_to_l1_private @@ -151,7 +150,7 @@ contract TokenBridge { #[aztec(public)] #[aztec(internal)] fn _call_mint_on_token(amount: Field, secret_hash: Field) { - Token::at(storage.token.read()).mint_private(&mut context, amount, secret_hash); + Token::at(storage.token.read()).mint_private(amount, secret_hash).call(&mut context); } // docs:end:call_mint_on_token diff --git a/noir-projects/noir-contracts/contracts/token_bridge_contract/src/token_interface.nr b/noir-projects/noir-contracts/contracts/token_bridge_contract/src/token_interface.nr deleted file mode 100644 index 8cebb78da04..00000000000 --- a/noir-projects/noir-contracts/contracts/token_bridge_contract/src/token_interface.nr +++ /dev/null @@ -1,59 +0,0 @@ -// docs:start:token_bridge_token_interface -use dep::aztec::prelude::{FunctionSelector, AztecAddress, EthAddress, PrivateContext}; -use dep::aztec::context::{PublicContext, Context, gas::GasOpts}; - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn mint_public(self: Self, context: &mut PublicContext, to: AztecAddress, amount: Field) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("mint_public((Field),Field)"), - [to.to_field(), amount], - GasOpts::default() - ).assert_empty(); - } - - // docs:start:public_burn_interface - pub fn burn_public( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("burn_public((Field),Field,Field)"), - [from.to_field(), amount, nonce], - GasOpts::default() - ).assert_empty(); - } - // docs:end:public_burn_interface - - pub fn mint_private(self: Self, context: &mut PublicContext, amount: Field, secret_hash: Field) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("mint_private(Field,Field)"), - [amount, secret_hash], - GasOpts::default() - ).assert_empty(); - } - - // docs:start:private_burn_interface - pub fn burn(self: Self, context: &mut PrivateContext, from: AztecAddress, amount: Field, nonce: Field) { - let _return_values = context.call_private_function( - self.address, - FunctionSelector::from_signature("burn((Field),Field,Field)"), - [from.to_field(), amount, nonce] - ); - } - // docs:end:private_burn_interface -} -// docs:end:token_bridge_token_interface diff --git a/noir-projects/noir-contracts/contracts/token_contract/src/main.nr b/noir-projects/noir-contracts/contracts/token_contract/src/main.nr index 7924299b27c..7978fe76412 100644 --- a/noir-projects/noir-contracts/contracts/token_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/token_contract/src/main.nr @@ -168,12 +168,7 @@ contract Token { #[aztec(private)] fn privately_mint_private_note(amount: Field) { storage.balances.add(context.msg_sender(), U128::from_integer(amount)); - let selector = FunctionSelector::from_signature("assert_minter_and_mint((Field),Field)"); - let _void = context.call_public_function( - context.this_address(), - selector, - [context.msg_sender().to_field(), amount] - ); + Token::at(context.this_address()).assert_minter_and_mint(context.msg_sender(), amount).enqueue(&mut context); } #[aztec(public)] @@ -277,8 +272,7 @@ contract Token { storage.balances.sub(from, U128::from_integer(amount)); - let selector = FunctionSelector::from_signature("_increase_public_balance((Field),Field)"); - let _void = context.call_public_function(context.this_address(), selector, [to.to_field(), amount]); + Token::at(context.this_address())._increase_public_balance(to, amount).enqueue(&mut context); } // docs:end:unshield @@ -312,8 +306,7 @@ contract Token { storage.balances.sub(from, U128::from_integer(amount)); - let selector = FunctionSelector::from_signature("_reduce_total_supply(Field)"); - let _void = context.call_public_function(context.this_address(), selector, [amount]); + Token::at(context.this_address())._reduce_total_supply(amount).enqueue(&mut context); } // docs:end:burn diff --git a/noir-projects/noir-contracts/contracts/uniswap_contract/Nargo.toml b/noir-projects/noir-contracts/contracts/uniswap_contract/Nargo.toml index cabd23e359e..dbc2b0cf06d 100644 --- a/noir-projects/noir-contracts/contracts/uniswap_contract/Nargo.toml +++ b/noir-projects/noir-contracts/contracts/uniswap_contract/Nargo.toml @@ -7,3 +7,5 @@ type = "contract" [dependencies] aztec = { path = "../../../aztec-nr/aztec" } authwit = { path = "../../../aztec-nr/authwit" } +token = { path = "../token_contract" } +token_bridge = { path = "../token_bridge_contract" } \ No newline at end of file diff --git a/noir-projects/noir-contracts/contracts/uniswap_contract/src/interfaces.nr b/noir-projects/noir-contracts/contracts/uniswap_contract/src/interfaces.nr deleted file mode 100644 index cd68492fabb..00000000000 --- a/noir-projects/noir-contracts/contracts/uniswap_contract/src/interfaces.nr +++ /dev/null @@ -1,80 +0,0 @@ -// docs:start:interfaces -use dep::aztec::prelude::{FunctionSelector, AztecAddress, EthAddress, PrivateContext, Deserialize}; -use dep::aztec::context::{PublicContext, gas::GasOpts}; - -struct Token { - address: AztecAddress, -} - -impl Token { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn transfer_public( - self: Self, - context: &mut PublicContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("transfer_public((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce], - GasOpts::default() - ).assert_empty(); - } - - pub fn unshield( - self: Self, - context: &mut PrivateContext, - from: AztecAddress, - to: AztecAddress, - amount: Field, - nonce: Field - ) { - let _ret = context.call_private_function( - self.address, - FunctionSelector::from_signature("unshield((Field),(Field),Field,Field)"), - [from.to_field(), to.to_field(), amount, nonce] - ); - } -} - -struct TokenBridge { - address: AztecAddress, -} - -impl TokenBridge { - pub fn at(address: AztecAddress) -> Self { - Self { address } - } - - pub fn token(self: Self, context: &mut PublicContext) -> AztecAddress { - context.call_public_function( - self.address, - FunctionSelector::from_signature("get_token()"), - [], - GasOpts::default() - ).deserialize_into() - } - - pub fn exit_to_l1_public( - self: Self, - context: &mut PublicContext, - recipient: EthAddress, - amount: Field, - caller_on_l1: EthAddress, - nonce: Field - ) { - context.call_public_function( - self.address, - FunctionSelector::from_signature("exit_to_l1_public((Field),Field,(Field),Field)"), - [recipient.to_field(), amount, caller_on_l1.to_field(), nonce], - GasOpts::default() - ).assert_empty(); - } -} -// docs:end:interfaces diff --git a/noir-projects/noir-contracts/contracts/uniswap_contract/src/main.nr b/noir-projects/noir-contracts/contracts/uniswap_contract/src/main.nr index a595616248e..32a89fcc704 100644 --- a/noir-projects/noir-contracts/contracts/uniswap_contract/src/main.nr +++ b/noir-projects/noir-contracts/contracts/uniswap_contract/src/main.nr @@ -1,5 +1,4 @@ // docs:start:uniswap_setup -mod interfaces; mod util; // Demonstrates how to use portal contracts to swap on L1 Uniswap with funds on L2 @@ -15,7 +14,8 @@ contract Uniswap { compute_outer_authwit_hash }; - use crate::interfaces::{Token, TokenBridge}; + use dep::token::Token; + use dep::token_bridge::TokenBridge; use crate::util::{compute_swap_private_content_hash, compute_swap_public_content_hash}; #[aztec(storage)] @@ -51,25 +51,18 @@ contract Uniswap { assert_current_call_valid_authwit_public(&mut context, sender); } - let input_asset = TokenBridge::at(input_asset_bridge).token(&mut context); + let input_asset = TokenBridge::at(input_asset_bridge).get_token().call(&mut context); // Transfer funds to this contract Token::at(input_asset).transfer_public( - &mut context, sender, context.this_address(), input_amount, nonce_for_transfer_approval - ); + ).call(&mut context); // Approve bridge to burn this contract's funds and exit to L1 Uniswap Portal - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("_approve_bridge_and_exit_input_asset_to_L1((Field),(Field),Field)"), - [input_asset.to_field(), input_asset_bridge.to_field(), input_amount], - GasOpts::default() - ).assert_empty(); - + Uniswap::at(context.this_address())._approve_bridge_and_exit_input_asset_to_L1(input_asset, input_asset_bridge, input_amount).call(&mut context); // Create swap message and send to Outbox for Uniswap Portal // this ensures the integrity of what the user originally intends to do on L1. let input_asset_bridge_portal_address = get_portal_address(input_asset_bridge); @@ -115,27 +108,18 @@ contract Uniswap { ) { // Assert that user provided token address is same as expected by token bridge. // we can't directly use `input_asset_bridge.token` because that is a public method and public can't return data to private - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("_assert_token_is_same((Field),(Field))"), - [input_asset.to_field(), input_asset_bridge.to_field()] - ); + Uniswap::at(context.this_address())._assert_token_is_same(input_asset, input_asset_bridge).enqueue(&mut context); // Transfer funds to this contract Token::at(input_asset).unshield( - &mut context, context.msg_sender(), context.this_address(), input_amount, nonce_for_unshield_approval - ); + ).call(&mut context); // Approve bridge to burn this contract's funds and exit to L1 Uniswap Portal - context.call_public_function( - context.this_address(), - FunctionSelector::from_signature("_approve_bridge_and_exit_input_asset_to_L1((Field),(Field),Field)"), - [input_asset.to_field(), input_asset_bridge.to_field(), input_amount] - ); + Uniswap::at(context.this_address())._approve_bridge_and_exit_input_asset_to_L1(input_asset, input_asset_bridge, input_amount).enqueue(&mut context); // Create swap message and send to Outbox for Uniswap Portal // this ensures the integrity of what the user originally intends to do on L1. @@ -193,7 +177,11 @@ contract Uniswap { // this method is used for both private and public swaps. #[aztec(public)] #[aztec(internal)] - fn _approve_bridge_and_exit_input_asset_to_L1(token: AztecAddress, token_bridge: AztecAddress, amount: Field) { + fn _approve_bridge_and_exit_input_asset_to_L1( + token: AztecAddress, + token_bridge: AztecAddress, + amount: Field + ) { // approve bridge to burn this contract's funds (required when exiting on L1, as it burns funds on L2): let nonce_for_burn_approval = storage.nonce_for_burn_approval.read(); let selector = FunctionSelector::from_signature("burn_public((Field),Field,Field)"); @@ -212,12 +200,11 @@ contract Uniswap { // Exit to L1 Uniswap Portal ! TokenBridge::at(token_bridge).exit_to_l1_public( - &mut context, context.this_portal_address(), amount, context.this_portal_address(), nonce_for_burn_approval - ); + ).call(&mut context) } // docs:end:authwit_uniswap_set @@ -226,7 +213,7 @@ contract Uniswap { #[aztec(internal)] fn _assert_token_is_same(token: AztecAddress, token_bridge: AztecAddress) { assert( - token.eq(TokenBridge::at(token_bridge).token(&mut context)), "input_asset address is not the same as seen in the bridge contract" + token.eq(TokenBridge::at(token_bridge).get_token().call(&mut context)), "input_asset address is not the same as seen in the bridge contract" ); } // docs:end:assert_token_is_same diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/traits.nr b/noir-projects/noir-protocol-circuits/crates/types/src/traits.nr index 70870f64d84..4d272c90cba 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/traits.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/traits.nr @@ -1,4 +1,5 @@ use dep::std::cmp::Eq; +use crate::utils::field::field_from_bytes; // Trait: is_empty // @@ -55,6 +56,12 @@ impl ToField for U128 { self.to_integer() } } +impl ToField for str { + fn to_field(self) -> Field { + assert(N < 32, "String doesn't fit in a field, consider using Serialize instead"); + field_from_bytes(self.as_bytes(), true) + } +} trait FromField { fn from_field(value: Field) -> Self; @@ -83,6 +90,17 @@ trait Serialize { } // docs:end:serialize +impl Serialize for str { + fn serialize(self) -> [Field; N] { + let mut result = [0; N]; + let bytes: [u8; N] = self.as_bytes(); + for i in 0..N { + result[i] = field_from_bytes([bytes[i];1], true); + } + result + } +} + // docs:start:deserialize trait Deserialize { fn deserialize(fields: [Field; N]) -> Self; diff --git a/noir/noir-repo/aztec_macros/src/lib.rs b/noir/noir-repo/aztec_macros/src/lib.rs index 48c30ab6ffa..dff3193a327 100644 --- a/noir/noir-repo/aztec_macros/src/lib.rs +++ b/noir/noir-repo/aztec_macros/src/lib.rs @@ -3,6 +3,9 @@ mod utils; use transforms::{ compute_note_hash_and_nullifier::inject_compute_note_hash_and_nullifier, + contract_interface::{ + generate_contract_interface, stub_function, update_fn_signatures_in_contract_interface, + }, events::{generate_selector_impl, transform_events}, functions::{export_fn_abi, transform_function, transform_unconstrained}, note_interface::{generate_note_interface_impl, inject_note_exports}, @@ -59,7 +62,14 @@ fn transform( // Usage -> mut ast -> aztec_library::transform(&mut ast) // Covers all functions in the ast for submodule in ast.submodules.iter_mut().filter(|submodule| submodule.is_contract) { - if transform_module(&mut submodule.contents).map_err(|err| (err.into(), file_id))? { + if transform_module( + crate_id, + context, + &mut submodule.contents, + submodule.name.0.contents.as_str(), + ) + .map_err(|err| (err.into(), file_id))? + { check_for_aztec_dependency(crate_id, context)?; } } @@ -72,7 +82,12 @@ fn transform( /// Determines if ast nodes are annotated with aztec attributes. /// For annotated functions it calls the `transform` function which will perform the required transformations. /// Returns true if an annotated node is found, false otherwise -fn transform_module(module: &mut SortedModule) -> Result { +fn transform_module( + crate_id: &CrateId, + context: &HirContext, + module: &mut SortedModule, + module_name: &str, +) -> Result { let mut has_transformed_module = false; // Check for a user defined storage struct @@ -84,7 +99,12 @@ fn transform_module(module: &mut SortedModule) -> Result if !check_for_storage_implementation(module, &storage_struct_name) { generate_storage_implementation(module, &storage_struct_name)?; } - generate_storage_layout(module, storage_struct_name)?; + // Make sure we're only generating the storage layout for the root crate + // In case we got a contract importing other contracts for their interface, we + // don't want to generate the storage layout for them + if crate_id == context.root_crate_id() { + generate_storage_layout(module, storage_struct_name)?; + } } for structure in module.types.iter_mut() { @@ -102,6 +122,8 @@ fn transform_module(module: &mut SortedModule) -> Result .any(|attr| is_custom_attribute(attr, "aztec(initializer)")) }); + let mut stubs: Vec<_> = vec![]; + for func in module.functions.iter_mut() { let mut is_private = false; let mut is_public = false; @@ -129,15 +151,18 @@ fn transform_module(module: &mut SortedModule) -> Result // Apply transformations to the function based on collected attributes if is_private || is_public || is_public_vm { + let fn_type = if is_private { + "Private" + } else if is_public_vm { + "Avm" + } else { + "Public" + }; + stubs.push(stub_function(fn_type, func)); + export_fn_abi(&mut module.types, func)?; transform_function( - if is_private { - "Private" - } else if is_public_vm { - "Avm" - } else { - "Public" - }, + fn_type, func, storage_defined, is_initializer, @@ -171,6 +196,8 @@ fn transform_module(module: &mut SortedModule) -> Result span: Span::default(), }); } + + generate_contract_interface(module, module_name, &stubs)?; } Ok(has_transformed_module) @@ -189,7 +216,8 @@ fn transform_hir( transform_events(crate_id, context)?; inject_compute_note_hash_and_nullifier(crate_id, context)?; assign_storage_slots(crate_id, context)?; - inject_note_exports(crate_id, context) + inject_note_exports(crate_id, context)?; + update_fn_signatures_in_contract_interface(crate_id, context) } else { Ok(()) } diff --git a/noir/noir-repo/aztec_macros/src/transforms/compute_note_hash_and_nullifier.rs b/noir/noir-repo/aztec_macros/src/transforms/compute_note_hash_and_nullifier.rs index 1b6630935d9..4ff97a5dcae 100644 --- a/noir/noir-repo/aztec_macros/src/transforms/compute_note_hash_and_nullifier.rs +++ b/noir/noir-repo/aztec_macros/src/transforms/compute_note_hash_and_nullifier.rs @@ -49,20 +49,20 @@ pub fn inject_compute_note_hash_and_nullifier( crate_id: &CrateId, context: &mut HirContext, ) -> Result<(), (AztecMacroError, FileId)> { - if let Some((module_id, file_id)) = get_contract_module_data(context, crate_id) { + if let Some((_, module_id, file_id)) = get_contract_module_data(context, crate_id) { // If compute_note_hash_and_nullifier is already defined by the user, we skip auto-generation in order to provide an // escape hatch for this mechanism. // TODO(#4647): improve this diagnosis and error messaging. - if check_for_compute_note_hash_and_nullifier_definition(crate_id, context) { + if context.crate_graph.root_crate_id() != crate_id + || check_for_compute_note_hash_and_nullifier_definition(crate_id, context) + { return Ok(()); } // In order to implement compute_note_hash_and_nullifier, we need to know all of the different note types the // contract might use. These are the types that are marked as #[aztec(note)]. - let note_types = fetch_notes(context) - .iter() - .map(|(_, note)| note.borrow().name.0.contents.clone()) - .collect::>(); + let note_types = + fetch_notes(context).iter().map(|(path, _)| path.to_string()).collect::>(); // We can now generate a version of compute_note_hash_and_nullifier tailored for the contract in this crate. let func = generate_compute_note_hash_and_nullifier(¬e_types); @@ -73,7 +73,14 @@ pub fn inject_compute_note_hash_and_nullifier( // pass an empty span. This function should not produce errors anyway so this should not matter. let location = Location::new(Span::empty(0), file_id); - inject_fn(crate_id, context, func, location, module_id, file_id); + inject_fn(crate_id, context, func, location, module_id, file_id).map_err(|err| { + ( + AztecMacroError::CouldNotImplementComputeNoteHashAndNullifier { + secondary_message: err.secondary_message, + }, + file_id, + ) + })?; } Ok(()) } @@ -100,7 +107,7 @@ fn generate_compute_note_hash_and_nullifier_source(note_types: &[String]) -> Str // so we include a dummy version. " unconstrained fn compute_note_hash_and_nullifier( - contract_address: AztecAddress, + contract_address: dep::aztec::protocol_types::address::AztecAddress, nonce: Field, storage_slot: Field, note_type_id: Field, @@ -130,7 +137,7 @@ fn generate_compute_note_hash_and_nullifier_source(note_types: &[String]) -> Str format!( " unconstrained fn compute_note_hash_and_nullifier( - contract_address: AztecAddress, + contract_address: dep::aztec::protocol_types::address::AztecAddress, nonce: Field, storage_slot: Field, note_type_id: Field, diff --git a/noir/noir-repo/aztec_macros/src/transforms/contract_interface.rs b/noir/noir-repo/aztec_macros/src/transforms/contract_interface.rs new file mode 100644 index 00000000000..4401c867df9 --- /dev/null +++ b/noir/noir-repo/aztec_macros/src/transforms/contract_interface.rs @@ -0,0 +1,326 @@ +use noirc_frontend::{ + graph::CrateId, + macros_api::{FileId, HirContext, HirExpression, HirLiteral, HirStatement}, + parse_program, + parser::SortedModule, + NoirFunction, Type, UnresolvedTypeData, +}; + +use crate::utils::{ + constants::SELECTOR_PLACEHOLDER, + errors::AztecMacroError, + hir_utils::{collect_crate_structs, get_contract_module_data, signature_of_type}, +}; + +// Generates the stubs for contract functions as low level calls using CallInterface, turning +// #[aztec(public)] // also private +// fn a_function(first_arg: Field, second_arg: Struct, third_arg: [Field; 4]) -> Field { +// ... +// } +// +// into +// +// pub fn a_function(self, first_arg: Field, second_arg: Struct, third_arg: [Field; 4]) -> PublicCallInterface { +// let mut args_acc: [Field] = &[]; +// args_acc = args_acc.append(first_arg.serialize().as_slice()); +// args_acc = args_acc.append(second_arg.serialize().as_slice()); +// let hash_third_arg = third_arg.map(|x: Field| x.serialize()); +// for i in 0..third_arg.len() { +// args_acc = args_acc.append(third_arg[i].serialize().as_slice()); +// } +// let args_hash = dep::aztec::hash::hash_args(args_acc); +// assert(args_hash == dep::aztec::oracle::arguments::pack_arguments(args_acc)); +// PublicCallInterface { +// target_contract: self.target_contract, +// selector: FunctionSelector::from_signature("SELECTOR_PLACEHOLDER"), +// args_hash +// } +// } +// +// The selector placeholder has to be replaced with the actual function signature after type checking in the next macro pass +pub fn stub_function(aztec_visibility: &str, func: &NoirFunction) -> String { + let fn_name = func.name().to_string(); + let fn_parameters = func + .parameters() + .iter() + .map(|param| { + format!( + "{}: {}", + param.pattern.name_ident().0.contents, + param.typ.to_string().replace("plain::", "") + ) + }) + .collect::>() + .join(", "); + let fn_return_type: noirc_frontend::UnresolvedType = func.return_type(); + + let fn_selector = format!("dep::aztec::protocol_types::abis::function_selector::FunctionSelector::from_signature(\"{}\")", SELECTOR_PLACEHOLDER); + + let parameters = func.parameters(); + let is_void = if matches!(fn_return_type.typ, UnresolvedTypeData::Unit) { "Void" } else { "" }; + let return_type_hint = if is_void == "Void" { + "".to_string() + } else { + format!("<{}>", fn_return_type.typ.to_string().replace("plain::", "")) + }; + let call_args = parameters + .iter() + .map(|arg| { + let param_name = arg.pattern.name_ident().0.contents.clone(); + match &arg.typ.typ { + UnresolvedTypeData::Array(_, typ) => { + format!( + "let hash_{0} = {0}.map(|x: {1}| x.serialize()); + for i in 0..{0}.len() {{ + args_acc = args_acc.append(hash_{0}[i].as_slice()); + }}\n", + param_name, typ.typ + ) + } + _ => { + format!("args_acc = args_acc.append({}.serialize().as_slice());\n", param_name) + } + } + }) + .collect::>() + .join(""); + if aztec_visibility != "Avm" { + let args_hash = if !parameters.is_empty() { + format!( + "let mut args_acc: [Field] = &[]; + {} + let args_hash = dep::aztec::hash::hash_args(args_acc); + assert(args_hash == dep::aztec::oracle::arguments::pack_arguments(args_acc));", + call_args + ) + } else { + "let args_hash = 0;".to_string() + }; + + let fn_body = format!( + "{} + dep::aztec::context::{}{}CallInterface {{ + target_contract: self.target_contract, + selector: {}, + args_hash, + }}", + args_hash, aztec_visibility, is_void, fn_selector, + ); + format!( + "pub fn {}(self, {}) -> dep::aztec::context::{}{}CallInterface{} {{ + {} + }}", + fn_name, fn_parameters, aztec_visibility, is_void, return_type_hint, fn_body + ) + } else { + let args = format!( + "let mut args_acc: [Field] = &[]; + {} + ", + call_args + ); + let fn_body = format!( + "{} + dep::aztec::context::Avm{}CallInterface {{ + target_contract: self.target_contract, + selector: {}, + args: args_acc, + }}", + args, is_void, fn_selector, + ); + format!( + "pub fn {}(self, {}) -> dep::aztec::context::Avm{}CallInterface{} {{ + {} + }}", + fn_name, fn_parameters, is_void, return_type_hint, fn_body + ) + } +} + +// Generates the contract interface as a struct with an `at` function that holds the stubbed functions and provides +// them with a target contract address. The struct has the same name as the contract (which is technically a module) +// so imports look nice. The `at` function is also exposed as a contract library method for external use. +pub fn generate_contract_interface( + module: &mut SortedModule, + module_name: &str, + stubs: &[String], +) -> Result<(), AztecMacroError> { + let contract_interface = format!( + " + struct {0} {{ + target_contract: dep::aztec::protocol_types::address::AztecAddress + }} + + impl {0} {{ + {1} + + pub fn at( + target_contract: dep::aztec::protocol_types::address::AztecAddress + ) -> Self {{ + Self {{ target_contract }} + }} + }} + + #[contract_library_method] + pub fn at( + target_contract: dep::aztec::protocol_types::address::AztecAddress + ) -> {0} {{ + {0} {{ target_contract }} + }} + ", + module_name, + stubs.join("\n"), + ); + + let (contract_interface_ast, errors) = parse_program(&contract_interface); + if !errors.is_empty() { + dbg!(errors); + return Err(AztecMacroError::CouldNotGenerateContractInterface { secondary_message: Some("Failed to parse Noir macro code during contract interface generation. This is either a bug in the compiler or the Noir macro code".to_string()), }); + } + + let mut contract_interface_ast = contract_interface_ast.into_sorted(); + module.types.push(contract_interface_ast.types.pop().unwrap()); + module.impls.push(contract_interface_ast.impls.pop().unwrap()); + module.functions.push(contract_interface_ast.functions.pop().unwrap()); + + Ok(()) +} + +fn compute_fn_signature(fn_name: &str, parameters: &[Type]) -> String { + format!( + "{}({})", + fn_name, + parameters.iter().map(signature_of_type).collect::>().join(",") + ) +} + +// Updates the function signatures in the contract interface with the actual ones, replacing the placeholder. +// This is done by locating the contract interface struct, its functions (stubs) and assuming the last statement of each +// is the constructor for a CallInterface. This constructor has a selector field that holds a +// FunctionSelector::from_signature function that receives the signature as a string literal. +pub fn update_fn_signatures_in_contract_interface( + crate_id: &CrateId, + context: &mut HirContext, +) -> Result<(), (AztecMacroError, FileId)> { + if let Some((name, _, file_id)) = get_contract_module_data(context, crate_id) { + let maybe_interface_struct = + collect_crate_structs(crate_id, context).iter().find_map(|struct_id| { + let r#struct = context.def_interner.get_struct(*struct_id); + if r#struct.borrow().name.0.contents == name { + Some(r#struct) + } else { + None + } + }); + + if let Some(interface_struct) = maybe_interface_struct { + let methods = context.def_interner.get_struct_methods(interface_struct.borrow().id); + + for func_id in methods.iter().flat_map(|methods| methods.direct.iter()) { + let name = context.def_interner.function_name(func_id); + let fn_parameters = &context.def_interner.function_meta(func_id).parameters.clone(); + + if name == "at" { + continue; + } + + let fn_signature = compute_fn_signature( + name, + &fn_parameters + .iter() + .skip(1) + .map(|(_, typ, _)| typ.clone()) + .collect::>(), + ); + let hir_func = context.def_interner.function(func_id).block(&context.def_interner); + let call_interface_constructor_statement = context.def_interner.statement( + hir_func + .statements() + .last() + .ok_or((AztecMacroError::AztecDepNotFound, file_id))?, + ); + let call_interface_constructor_expression = + match call_interface_constructor_statement { + HirStatement::Expression(expression_id) => { + match context.def_interner.expression(&expression_id) { + HirExpression::Constructor(hir_constructor_expression) => { + Ok(hir_constructor_expression) + } + _ => Err(( + AztecMacroError::CouldNotGenerateContractInterface { + secondary_message: Some( + "CallInterface constructor statement must be a constructor expression" + .to_string(), + ), + }, + file_id, + )), + } + } + _ => Err(( + AztecMacroError::CouldNotGenerateContractInterface { + secondary_message: Some( + "CallInterface constructor statement must be an expression" + .to_string(), + ), + }, + file_id, + )), + }?; + let (_, function_selector_expression_id) = + call_interface_constructor_expression.fields[1]; + let function_selector_expression = + context.def_interner.expression(&function_selector_expression_id); + + let current_fn_signature_expression_id = match function_selector_expression { + HirExpression::Call(call_expr) => Ok(call_expr.arguments[0]), + _ => Err(( + AztecMacroError::CouldNotGenerateContractInterface { + secondary_message: Some( + "Function selector argument expression must be call expression" + .to_string(), + ), + }, + file_id, + )), + }?; + + let current_fn_signature_expression = + context.def_interner.expression(¤t_fn_signature_expression_id); + + match current_fn_signature_expression { + HirExpression::Literal(HirLiteral::Str(signature)) => { + if signature != SELECTOR_PLACEHOLDER { + Err(( + AztecMacroError::CouldNotGenerateContractInterface { + secondary_message: Some(format!( + "Function signature argument must be a placeholder: {}", + SELECTOR_PLACEHOLDER + )), + }, + file_id, + )) + } else { + Ok(()) + } + } + _ => Err(( + AztecMacroError::CouldNotAssignStorageSlots { + secondary_message: Some( + "Function signature argument must be a literal string".to_string(), + ), + }, + file_id, + )), + }?; + + context + .def_interner + .update_expression(current_fn_signature_expression_id, |expr| { + *expr = HirExpression::Literal(HirLiteral::Str(fn_signature)) + }); + } + } + } + Ok(()) +} diff --git a/noir/noir-repo/aztec_macros/src/transforms/events.rs b/noir/noir-repo/aztec_macros/src/transforms/events.rs index 4f2b70453df..b77a5821b81 100644 --- a/noir/noir-repo/aztec_macros/src/transforms/events.rs +++ b/noir/noir-repo/aztec_macros/src/transforms/events.rs @@ -174,7 +174,7 @@ pub fn transform_events( crate_id: &CrateId, context: &mut HirContext, ) -> Result<(), (AztecMacroError, FileId)> { - for (_, struct_id) in collect_crate_structs(crate_id, context) { + for struct_id in collect_crate_structs(crate_id, context) { let attributes = context.def_interner.struct_attributes(&struct_id); if attributes.iter().any(|attr| is_custom_attribute(attr, "aztec(event)")) { transform_event(struct_id, &mut context.def_interner)?; diff --git a/noir/noir-repo/aztec_macros/src/transforms/mod.rs b/noir/noir-repo/aztec_macros/src/transforms/mod.rs index 5a454c75148..2a6fef7647f 100644 --- a/noir/noir-repo/aztec_macros/src/transforms/mod.rs +++ b/noir/noir-repo/aztec_macros/src/transforms/mod.rs @@ -1,4 +1,5 @@ pub mod compute_note_hash_and_nullifier; +pub mod contract_interface; pub mod events; pub mod functions; pub mod note_interface; diff --git a/noir/noir-repo/aztec_macros/src/transforms/note_interface.rs b/noir/noir-repo/aztec_macros/src/transforms/note_interface.rs index 0514155824e..4b72759a5db 100644 --- a/noir/noir-repo/aztec_macros/src/transforms/note_interface.rs +++ b/noir/noir-repo/aztec_macros/src/transforms/note_interface.rs @@ -528,12 +528,12 @@ fn generate_note_properties_fn_source( .join(", "); format!( " - pub fn properties() -> {}Properties {{ - {}Properties {{ - {} + pub fn properties() -> {0}Properties {{ + {0}Properties {{ + {1} }} }}", - note_type, note_type, note_property_selectors + note_type, note_property_selectors ) .to_string() } @@ -623,7 +623,7 @@ pub fn inject_note_exports( crate_id: &CrateId, context: &mut HirContext, ) -> Result<(), (AztecMacroError, FileId)> { - if let Some((module_id, file_id)) = get_contract_module_data(context, crate_id) { + if let Some((_, module_id, file_id)) = get_contract_module_data(context, crate_id) { let notes = fetch_notes(context); for (_, note) in notes { diff --git a/noir/noir-repo/aztec_macros/src/transforms/storage.rs b/noir/noir-repo/aztec_macros/src/transforms/storage.rs index 0bfb39cbc71..9135be32443 100644 --- a/noir/noir-repo/aztec_macros/src/transforms/storage.rs +++ b/noir/noir-repo/aztec_macros/src/transforms/storage.rs @@ -265,13 +265,13 @@ pub fn assign_storage_slots( context: &mut HirContext, ) -> Result<(), (AztecMacroError, FileId)> { let traits: Vec<_> = collect_traits(context); - if let Some((_, file_id)) = get_contract_module_data(context, crate_id) { + if let Some((_, _, file_id)) = get_contract_module_data(context, crate_id) { let maybe_storage_struct = - collect_crate_structs(crate_id, context).iter().find_map(|&(_, struct_id)| { - let r#struct = context.def_interner.get_struct(struct_id); - let attributes = context.def_interner.struct_attributes(&struct_id); + collect_crate_structs(crate_id, context).iter().find_map(|struct_id| { + let r#struct = context.def_interner.get_struct(*struct_id); + let attributes = context.def_interner.struct_attributes(struct_id); if attributes.iter().any(|attr| is_custom_attribute(attr, "aztec(storage)")) - && r#struct.borrow().id.krate().is_root() + && r#struct.borrow().id.krate() == *crate_id { Some(r#struct) } else { @@ -290,7 +290,11 @@ pub fn assign_storage_slots( let expr = context.def_interner.expression(&statement.unwrap().expression); match expr { HirExpression::Constructor(hir_constructor_expression) => { - Some(hir_constructor_expression) + if hir_constructor_expression.r#type.borrow().id.krate() == *crate_id { + Some(hir_constructor_expression) + } else { + None + } } _ => None, } diff --git a/noir/noir-repo/aztec_macros/src/utils/constants.rs b/noir/noir-repo/aztec_macros/src/utils/constants.rs index 464cd10e2c7..848cca0477d 100644 --- a/noir/noir-repo/aztec_macros/src/utils/constants.rs +++ b/noir/noir-repo/aztec_macros/src/utils/constants.rs @@ -1,3 +1,4 @@ pub const FUNCTION_TREE_HEIGHT: u32 = 5; pub const MAX_CONTRACT_PRIVATE_FUNCTIONS: usize = 2_usize.pow(FUNCTION_TREE_HEIGHT); pub const SIGNATURE_PLACEHOLDER: &str = "SIGNATURE_PLACEHOLDER"; +pub const SELECTOR_PLACEHOLDER: &str = "SELECTOR_PLACEHOLDER"; diff --git a/noir/noir-repo/aztec_macros/src/utils/errors.rs b/noir/noir-repo/aztec_macros/src/utils/errors.rs index 52ee5587559..4c5411dfe0f 100644 --- a/noir/noir-repo/aztec_macros/src/utils/errors.rs +++ b/noir/noir-repo/aztec_macros/src/utils/errors.rs @@ -11,10 +11,12 @@ pub enum AztecMacroError { UnsupportedFunctionReturnType { span: Span, typ: UnresolvedTypeData }, UnsupportedStorageType { span: Option, typ: UnresolvedTypeData }, CouldNotAssignStorageSlots { secondary_message: Option }, + CouldNotImplementComputeNoteHashAndNullifier { secondary_message: Option }, CouldNotImplementNoteInterface { span: Option, secondary_message: Option }, MultipleStorageDefinitions { span: Option }, CouldNotExportStorageLayout { span: Option, secondary_message: Option }, CouldNotExportFunctionAbi { span: Option, secondary_message: Option }, + CouldNotGenerateContractInterface { secondary_message: Option }, EventError { span: Span, message: String }, UnsupportedAttributes { span: Span, secondary_message: Option }, } @@ -52,6 +54,11 @@ impl From for MacroError { secondary_message, span: None, }, + AztecMacroError::CouldNotImplementComputeNoteHashAndNullifier { secondary_message } => MacroError { + primary_message: "Could not implement compute_note_hash_and_nullifier automatically, please provide an implementation".to_string(), + secondary_message, + span: None, + }, AztecMacroError::CouldNotImplementNoteInterface { span, secondary_message } => MacroError { primary_message: "Could not implement automatic methods for note, please provide an implementation of the NoteInterface trait".to_string(), secondary_message, @@ -72,6 +79,11 @@ impl From for MacroError { secondary_message, span, }, + AztecMacroError::CouldNotGenerateContractInterface { secondary_message } => MacroError { + primary_message: "Could not generate contract interface".to_string(), + secondary_message, + span: None + }, AztecMacroError::EventError { span, message } => MacroError { primary_message: message, secondary_message: None, diff --git a/noir/noir-repo/aztec_macros/src/utils/hir_utils.rs b/noir/noir-repo/aztec_macros/src/utils/hir_utils.rs index c4414e6419b..ae895d2075c 100644 --- a/noir/noir-repo/aztec_macros/src/utils/hir_utils.rs +++ b/noir/noir-repo/aztec_macros/src/utils/hir_utils.rs @@ -7,43 +7,32 @@ use noirc_frontend::{ resolution::{path_resolver::StandardPathResolver, resolver::Resolver}, type_check::type_check_func, }, - macros_api::{FileId, HirContext, ModuleDefId, StructId}, + macros_api::{FileId, HirContext, MacroError, ModuleDefId, StructId}, node_interner::{FuncId, TraitId}, ItemVisibility, LetStatement, NoirFunction, Shared, Signedness, StructType, Type, }; use super::ast_utils::is_custom_attribute; -pub fn collect_crate_structs(crate_id: &CrateId, context: &HirContext) -> Vec<(String, StructId)> { +pub fn collect_crate_structs(crate_id: &CrateId, context: &HirContext) -> Vec { context .def_map(crate_id) - .expect("ICE: Missing crate in def_map") - .modules() - .iter() - .flat_map(|(_, module)| { - module.type_definitions().filter_map(move |typ| { - if let ModuleDefId::TypeId(struct_id) = typ { - let module_id = struct_id.module_id(); - let path = - context.fully_qualified_struct_path(context.root_crate_id(), struct_id); - let path = if path.contains("::") { - let prefix = if &module_id.krate == context.root_crate_id() { - "crate" + .map(|def_map| { + def_map + .modules() + .iter() + .flat_map(|(_, module)| { + module.type_definitions().filter_map(move |typ| { + if let ModuleDefId::TypeId(struct_id) = typ { + Some(struct_id) } else { - "dep" - }; - format!("{}::{}", prefix, path) - } else { - path - }; - - Some((path, struct_id)) - } else { - None - } - }) + None + } + }) + }) + .collect() }) - .collect() + .unwrap_or_default() } pub fn collect_crate_functions(crate_id: &CrateId, context: &HirContext) -> Vec { @@ -96,22 +85,48 @@ pub fn signature_of_type(typ: &Type) -> String { let fields = vecmap(types, signature_of_type); format!("({})", fields.join(",")) } + Type::String(len_typ) => { + if let Type::Constant(len) = **len_typ { + format!("str<{len}>") + } else { + unimplemented!( + "Cannot generate signature for string with length type {:?}", + len_typ + ) + } + } + Type::MutableReference(typ) => signature_of_type(typ), _ => unimplemented!("Cannot generate signature for type {:?}", typ), } } -// Fetches the name of all structs tagged as #[aztec(note)] in a given crate +// Fetches the name of all structs tagged as #[aztec(note)] in a given crate, avoiding +// contract dependencies that are just there for their interfaces. pub fn fetch_crate_notes( context: &HirContext, crate_id: &CrateId, ) -> Vec<(String, Shared)> { collect_crate_structs(crate_id, context) .iter() - .filter_map(|(path, struct_id)| { + .filter_map(|struct_id| { let r#struct = context.def_interner.get_struct(*struct_id); let attributes = context.def_interner.struct_attributes(struct_id); if attributes.iter().any(|attr| is_custom_attribute(attr, "aztec(note)")) { - Some((path.clone(), r#struct)) + let module_id = struct_id.module_id(); + + fully_qualified_note_path(context, *struct_id).map(|path| { + let path = if path.contains("::") { + let prefix = if &module_id.krate == context.root_crate_id() { + "crate" + } else { + "dep" + }; + format!("{}::{}", prefix, path) + } else { + path + }; + (path.clone(), r#struct) + }) } else { None } @@ -127,23 +142,24 @@ pub fn fetch_notes(context: &HirContext) -> Vec<(String, Shared)> { pub fn get_contract_module_data( context: &mut HirContext, crate_id: &CrateId, -) -> Option<(LocalModuleId, FileId)> { +) -> Option<(String, LocalModuleId, FileId)> { + let def_map = context.def_map(crate_id).expect("ICE: Missing crate in def_map"); // We first fetch modules in this crate which correspond to contracts, along with their file id. - let contract_module_file_ids: Vec<(LocalModuleId, FileId)> = context - .def_map(crate_id) - .expect("ICE: Missing crate in def_map") + let contract_module_file_ids: Vec<(String, LocalModuleId, FileId)> = def_map .modules() .iter() .filter(|(_, module)| module.is_contract) - .map(|(idx, module)| (LocalModuleId(idx), module.location.file)) + .map(|(idx, module)| { + (def_map.get_module_path(idx, module.parent), LocalModuleId(idx), module.location.file) + }) .collect(); - // If the current crate does not contain a contract module we simply skip it. More than 1 contract in a crate is forbidden by the compiler + // If the current crate does not contain a contract module we simply skip it. if contract_module_file_ids.is_empty() { return None; } - Some(contract_module_file_ids[0]) + Some(contract_module_file_ids[0].clone()) } pub fn inject_fn( @@ -153,7 +169,7 @@ pub fn inject_fn( location: Location, module_id: LocalModuleId, file_id: FileId, -) { +) -> Result<(), MacroError> { let func_id = context.def_interner.push_empty_fn(); context.def_interner.push_function( func_id, @@ -164,12 +180,11 @@ pub fn inject_fn( context.def_map_mut(crate_id).unwrap().modules_mut()[module_id.0] .declare_function(func.name_ident().clone(), ItemVisibility::Public, func_id) - .unwrap_or_else(|_| { - panic!( - "Failed to declare autogenerated {} function, likely due to a duplicate definition", - func.name() - ) - }); + .map_err(|err| MacroError { + primary_message: format!("Failed to declare autogenerated {} function", func.name()), + secondary_message: Some(format!("Duplicate definition found {}", err.0)), + span: None, + })?; let def_maps = &mut context.def_maps; @@ -183,7 +198,17 @@ pub fn inject_fn( context.def_interner.push_fn_meta(meta, func_id); context.def_interner.update_fn(func_id, hir_func); - type_check_func(&mut context.def_interner, func_id); + let errors = type_check_func(&mut context.def_interner, func_id); + + if !errors.is_empty() { + return Err(MacroError { + primary_message: "Failed to type check autogenerated function".to_owned(), + secondary_message: Some(errors.iter().map(|err| err.to_string()).collect::()), + span: None, + }); + } + + Ok(()) } pub fn inject_global( @@ -224,3 +249,63 @@ pub fn inject_global( let statement_id = context.def_interner.get_global(global_id).let_statement; context.def_interner.replace_statement(statement_id, hir_stmt); } + +pub fn fully_qualified_note_path(context: &HirContext, note_id: StructId) -> Option { + let module_id = note_id.module_id(); + let child_id = module_id.local_id.0; + let def_map = + context.def_map(&module_id.krate).expect("The local crate should be analyzed already"); + + let module = context.module(module_id); + + let module_path = def_map.get_module_path_with_separator(child_id, module.parent, "::"); + + if &module_id.krate == context.root_crate_id() { + Some(module_path) + } else { + find_non_contract_dependencies_bfs(context, context.root_crate_id(), &module_id.krate) + .map(|crates| crates.join("::") + "::" + &module_path) + } +} + +fn filter_contract_modules(context: &HirContext, crate_id: &CrateId) -> bool { + if let Some(def_map) = context.def_map(crate_id) { + !def_map.modules().iter().any(|(_, module)| module.is_contract) + } else { + true + } +} + +fn find_non_contract_dependencies_bfs( + context: &HirContext, + crate_id: &CrateId, + target_crate_id: &CrateId, +) -> Option> { + context.crate_graph[crate_id] + .dependencies + .iter() + .filter(|dep| filter_contract_modules(context, &dep.crate_id)) + .find_map(|dep| { + if &dep.crate_id == target_crate_id { + Some(vec![dep.name.to_string()]) + } else { + None + } + }) + .or_else(|| { + context.crate_graph[crate_id] + .dependencies + .iter() + .filter(|dep| filter_contract_modules(context, &dep.crate_id)) + .find_map(|dep| { + if let Some(mut path) = + find_non_contract_dependencies_bfs(context, &dep.crate_id, target_crate_id) + { + path.insert(0, dep.name.to_string()); + Some(path) + } else { + None + } + }) + }) +} diff --git a/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs index 727a6596df1..29be7524659 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs @@ -157,7 +157,8 @@ impl Context<'_, '_> { } } - /// Recursively walks down the crate dependency graph from crate_id until we reach requested crate + /// Tries to find the requested crate in the current one's dependencies, + /// otherwise walks down the crate dependency graph from crate_id until we reach it. /// This is needed in case a library (lib1) re-export a structure defined in another library (lib2) /// In that case, we will get [lib1,lib2] when looking for a struct defined in lib2, /// re-exported by lib1 and used by the main crate. @@ -167,16 +168,26 @@ impl Context<'_, '_> { crate_id: &CrateId, target_crate_id: &CrateId, ) -> Option> { - for dep in &self.crate_graph[crate_id].dependencies { - if &dep.crate_id == target_crate_id { - return Some(vec![dep.name.to_string()]); - } - if let Some(mut path) = self.find_dependencies(&dep.crate_id, target_crate_id) { - path.insert(0, dep.name.to_string()); - return Some(path); - } - } - None + self.crate_graph[crate_id] + .dependencies + .iter() + .find_map(|dep| { + if &dep.crate_id == target_crate_id { + Some(vec![dep.name.to_string()]) + } else { + None + } + }) + .or_else(|| { + self.crate_graph[crate_id].dependencies.iter().find_map(|dep| { + if let Some(mut path) = self.find_dependencies(&dep.crate_id, target_crate_id) { + path.insert(0, dep.name.to_string()); + Some(path) + } else { + None + } + }) + }) } pub fn function_meta(&self, func_id: &FuncId) -> &FuncMeta { @@ -241,7 +252,7 @@ impl Context<'_, '_> { .get_all_contracts(&self.def_interner) } - fn module(&self, module_id: def_map::ModuleId) -> &def_map::ModuleData { + pub fn module(&self, module_id: def_map::ModuleId) -> &def_map::ModuleData { module_id.module(&self.def_maps) } } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs b/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs index ffd760d6d7f..c9eef286bbd 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs @@ -223,10 +223,10 @@ pub enum TraitImplKind { /// /// Additionally, types can define specialized impls with methods of the same name /// as long as these specialized impls do not overlap. E.g. `impl Struct` and `impl Struct` -#[derive(Default, Debug)] +#[derive(Default, Debug, Clone)] pub struct Methods { - direct: Vec, - trait_impl_methods: Vec, + pub direct: Vec, + pub trait_impl_methods: Vec, } /// All the information from a function that is filled out during definition collection rather than @@ -921,6 +921,24 @@ impl NodeInterner { self.structs[&id].clone() } + pub fn get_struct_methods(&self, id: StructId) -> Vec { + self.struct_methods + .keys() + .filter_map(|(key_id, name)| { + if key_id == &id { + Some( + self.struct_methods + .get(&(*key_id, name.clone())) + .expect("get_struct_methods given invalid StructId") + .clone(), + ) + } else { + None + } + }) + .collect() + } + pub fn get_trait(&self, id: TraitId) -> &Trait { &self.traits[&id] } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/tests.rs b/noir/noir-repo/compiler/noirc_frontend/src/tests.rs index c4f0a8d67ba..e4d308fbb6b 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/tests.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/tests.rs @@ -66,7 +66,7 @@ mod test { // Allocate a default Module for the root, giving it a ModuleId let mut modules: Arena = Arena::default(); let location = Location::new(Default::default(), root_file_id); - let root = modules.insert(ModuleData::new(None, location, false)); + let root = modules.insert(ModuleData::new(None, None, location, false)); let def_map = CrateDefMap { root: LocalModuleId(root), diff --git a/yarn-project/end-to-end/src/e2e_delegate_calls.test.ts b/yarn-project/end-to-end/src/e2e_delegate_calls/delegate.test.ts similarity index 54% rename from yarn-project/end-to-end/src/e2e_delegate_calls.test.ts rename to yarn-project/end-to-end/src/e2e_delegate_calls/delegate.test.ts index 45fb4a22e1d..03246dcff0f 100644 --- a/yarn-project/end-to-end/src/e2e_delegate_calls.test.ts +++ b/yarn-project/end-to-end/src/e2e_delegate_calls/delegate.test.ts @@ -1,34 +1,25 @@ -import { type Wallet } from '@aztec/aztec.js'; -import { DelegatedOnContract, DelegatorContract } from '@aztec/noir-contracts.js'; - -import { setup } from './fixtures/utils.js'; +import { DelegateCallsTest } from './delegate_calls_test.js'; describe('e2e_delegate_calls', () => { - let wallet: Wallet; - let delegatorContract: DelegatorContract; - let delegatedOnContract: DelegatedOnContract; - let teardown: () => Promise; - - beforeEach(async () => { - ({ teardown, wallet } = await setup()); - }, 100_000); - - afterEach(() => teardown()); + const t = new DelegateCallsTest('delegate_calls'); + let { delegatorContract, delegatedOnContract, wallet } = t; + + beforeAll(async () => { + await t.applyBaseSnapshots(); + await t.setup(); + // Have to destructure again to ensure we have latest refs. + ({ delegatorContract, delegatedOnContract, wallet } = t); + }); - beforeEach(async () => { - delegatorContract = await DelegatorContract.deploy(wallet).send().deployed(); - delegatedOnContract = await DelegatedOnContract.deploy(wallet).send().deployed(); - }, 100_000); + afterAll(async () => { + await t.teardown(); + }); describe('delegates on another contract', () => { it("runs another contract's private function on delegator's storage", async () => { const sentValue = 42n; await delegatorContract.methods - .private_delegate_set_value( - delegatedOnContract.address, - delegatedOnContract.methods.private_set_value.selector, - [sentValue, wallet.getCompleteAddress().address], - ) + .private_delegate_set_value(delegatedOnContract.address, sentValue, wallet.getCompleteAddress().address) .send() .wait(); @@ -46,14 +37,7 @@ describe('e2e_delegate_calls', () => { it("runs another contract's enqueued public function on delegator's storage", async () => { const sentValue = 42n; - await delegatorContract.methods - .enqueued_delegate_set_value( - delegatedOnContract.address, - delegatedOnContract.methods.public_set_value.selector, - [sentValue], - ) - .send() - .wait(); + await delegatorContract.methods.enqueued_delegate_set_value(delegatedOnContract.address, sentValue).send().wait(); const delegatorValue = await delegatorContract.methods.view_public_value().simulate(); const delegatedOnValue = await delegatedOnContract.methods.view_public_value().simulate(); @@ -64,12 +48,7 @@ describe('e2e_delegate_calls', () => { it("runs another contract's public function on delegator's storage", async () => { const sentValue = 42n; - await delegatorContract.methods - .public_delegate_set_value(delegatedOnContract.address, delegatedOnContract.methods.public_set_value.selector, [ - sentValue, - ]) - .send() - .wait(); + await delegatorContract.methods.public_delegate_set_value(delegatedOnContract.address, sentValue).send().wait(); const delegatorValue = await delegatorContract.methods.view_public_value().simulate(); const delegatedOnValue = await delegatedOnContract.methods.view_public_value().simulate(); diff --git a/yarn-project/end-to-end/src/e2e_delegate_calls/delegate_calls_test.ts b/yarn-project/end-to-end/src/e2e_delegate_calls/delegate_calls_test.ts new file mode 100644 index 00000000000..457408a05f7 --- /dev/null +++ b/yarn-project/end-to-end/src/e2e_delegate_calls/delegate_calls_test.ts @@ -0,0 +1,72 @@ +import { getSchnorrAccount } from '@aztec/accounts/schnorr'; +import { type AccountWallet, type DebugLogger, createDebugLogger } from '@aztec/aztec.js'; +import { DelegatedOnContract, DelegatorContract } from '@aztec/noir-contracts.js'; + +import { SnapshotManager, type SubsystemsContext, addAccounts } from '../fixtures/snapshot_manager.js'; + +const { E2E_DATA_PATH: dataPath } = process.env; + +export class DelegateCallsTest { + private snapshotManager: SnapshotManager; + logger: DebugLogger; + wallet!: AccountWallet; + delegatorContract!: DelegatorContract; + delegatedOnContract!: DelegatedOnContract; + + constructor(testName: string) { + this.logger = createDebugLogger(`aztec:e2e_delegate_calls:${testName}`); + this.snapshotManager = new SnapshotManager(`e2e_delegate_calls/${testName}`, dataPath); + } + + /** + * Adds two state shifts to snapshot manager. + * 1. Add 3 accounts. + * 2. Publicly deploy accounts, deploy token contract and a "bad account". + */ + async applyBaseSnapshots() { + await this.snapshotManager.snapshot('accounts', addAccounts(1, this.logger), async ({ accountKeys }, { pxe }) => { + const accountManager = getSchnorrAccount(pxe, accountKeys[0][0], accountKeys[0][1], 1); + this.wallet = await accountManager.getWallet(); + this.logger.verbose(`Wallet address: ${this.wallet.getAddress()}`); + }); + + await this.snapshotManager.snapshot( + 'e2e_delegate_calls', + async () => { + this.logger.verbose(`Deploying DelegatorContract...`); + this.delegatorContract = await DelegatorContract.deploy(this.wallet).send().deployed(); + this.logger.verbose(`Delegator deployed to ${this.delegatorContract.address}`); + + this.logger.verbose(`Deploying DelegatedOnContract...`); + this.delegatedOnContract = await DelegatedOnContract.deploy(this.wallet).send().deployed(); + + return { + delegatorContractAddress: this.delegatorContract.address, + delegatedOnContractAddress: this.delegatedOnContract.address, + }; + }, + async ({ delegatorContractAddress, delegatedOnContractAddress }) => { + // Restore the token contract state. + this.delegatorContract = await DelegatorContract.at(delegatorContractAddress, this.wallet); + this.logger.verbose(`Delegator contract address: ${this.delegatorContract.address}`); + + this.delegatedOnContract = await DelegatedOnContract.at(delegatedOnContractAddress, this.wallet); + this.logger.verbose(`DelegatedOn address: ${this.delegatedOnContract.address}`); + }, + ); + } + + async setup() { + await this.snapshotManager.setup(); + } + + snapshot = ( + name: string, + apply: (context: SubsystemsContext) => Promise, + restore: (snapshotData: T, context: SubsystemsContext) => Promise = () => Promise.resolve(), + ): Promise => this.snapshotManager.snapshot(name, apply, restore); + + async teardown() { + await this.snapshotManager.teardown(); + } +} diff --git a/yarn-project/end-to-end/src/e2e_nested_contract.test.ts b/yarn-project/end-to-end/src/e2e_nested_contract.test.ts index 102e10069d3..0310b4bbfd1 100644 --- a/yarn-project/end-to-end/src/e2e_nested_contract.test.ts +++ b/yarn-project/end-to-end/src/e2e_nested_contract.test.ts @@ -169,7 +169,7 @@ describe('e2e_nested_contract', () => { it('calls a method with multiple arguments', async () => { logger.info(`Calling main on importer contract`); - await importerContract.methods.main(testContract.address).send().wait(); + await importerContract.methods.main_contract(testContract.address).send().wait(); }, 30_000); it('calls a method no arguments', async () => { diff --git a/yarn-project/noir-compiler/package.json b/yarn-project/noir-compiler/package.json index 110a881ff8f..c35f9e851d5 100644 --- a/yarn-project/noir-compiler/package.json +++ b/yarn-project/noir-compiler/package.json @@ -58,6 +58,7 @@ "fs-extra": "^11.1.1", "lodash.camelcase": "^4.3.0", "lodash.capitalize": "^4.2.1", + "lodash.uniqby": "^4.7.0", "memfs": "^4.6.0", "pako": "^2.1.0", "semver": "^7.5.4", @@ -70,6 +71,7 @@ "@types/jest": "^29.5.0", "@types/lodash.camelcase": "^4.3.7", "@types/lodash.capitalize": "^4.2.7", + "@types/lodash.uniqby": "^4.7.9", "@types/node": "^18.7.23", "@types/pako": "^2.0.0", "@types/semver": "^7.5.4", diff --git a/yarn-project/noir-compiler/src/cli/add_noir_compiler_commander_actions.ts b/yarn-project/noir-compiler/src/cli/add_noir_compiler_commander_actions.ts index 02fa9eb6c0b..a3330b8368f 100644 --- a/yarn-project/noir-compiler/src/cli/add_noir_compiler_commander_actions.ts +++ b/yarn-project/noir-compiler/src/cli/add_noir_compiler_commander_actions.ts @@ -12,15 +12,10 @@ export function addCodegenCommanderAction(program: Command, _: LogFn = () => {}) .command('codegen') .argument('', 'Path to the Noir ABI or project dir.') .option('-o, --outdir ', 'Output folder for the generated code.') - .option('--ts', 'Generate TypeScript wrapper.') - .option('--nr', 'Generate Noir interface.') .option('--force', 'Force code generation even when the contract has not changed.') .description('Validates and generates an Aztec Contract ABI from Noir ABI.') - .action(async (noirAbiPath: string, { outdir, ts, nr, force }) => { - if (ts && nr) { - throw new Error('--ts and --nr are mutually exclusive.'); - } + .action(async (noirAbiPath: string, { outdir, force }) => { const { generateCode } = await import('./codegen.js'); - generateCode(outdir || dirname(noirAbiPath), noirAbiPath, { ts, nr, force }); + generateCode(outdir || dirname(noirAbiPath), noirAbiPath, { force }); }); } diff --git a/yarn-project/noir-compiler/src/cli/codegen.ts b/yarn-project/noir-compiler/src/cli/codegen.ts index 47aaeaa390b..858109a982b 100644 --- a/yarn-project/noir-compiler/src/cli/codegen.ts +++ b/yarn-project/noir-compiler/src/cli/codegen.ts @@ -5,14 +5,13 @@ import crypto from 'crypto'; import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'fs'; import path from 'path'; -import { generateNoirContractInterface } from '../contract-interface-gen/noir.js'; import { generateTypescriptContractInterface } from '../contract-interface-gen/typescript.js'; const cacheFilePath = './codegenCache.json'; let cache: Record = {}; /** Generate code options */ -type GenerateCodeOptions = { /** Typescript */ ts?: boolean; /** Noir */ nr?: boolean; force?: boolean }; +type GenerateCodeOptions = { force?: boolean }; /** * Generates Noir interface or Typescript interface for a folder or single file from a Noir compilation artifact. @@ -49,26 +48,18 @@ function generateFromNoirAbi(outputPath: string, noirAbiPath: string, opts: Gene const contract = JSON.parse(readFileSync(noirAbiPath, 'utf8')); const aztecAbi = loadContractArtifact(contract); - const { nr, ts } = opts; mkdirSync(outputPath, { recursive: true }); - if (nr) { - const noirContract = generateNoirContractInterface(aztecAbi); - writeFileSync(`${outputPath}/${aztecAbi.name}.nr`, noirContract); - return; + let relativeArtifactPath = path.relative(outputPath, noirAbiPath); + if (relativeArtifactPath === path.basename(noirAbiPath)) { + // Prepend ./ for local import if the folder is the same + relativeArtifactPath = `./${relativeArtifactPath}`; } - if (ts) { - let relativeArtifactPath = path.relative(outputPath, noirAbiPath); - if (relativeArtifactPath === path.basename(noirAbiPath)) { - // Prepend ./ for local import if the folder is the same - relativeArtifactPath = `./${relativeArtifactPath}`; - } + const tsWrapper = generateTypescriptContractInterface(aztecAbi, relativeArtifactPath); + writeFileSync(`${outputPath}/${aztecAbi.name}.ts`, tsWrapper); - const tsWrapper = generateTypescriptContractInterface(aztecAbi, relativeArtifactPath); - writeFileSync(`${outputPath}/${aztecAbi.name}.ts`, tsWrapper); - } updateCache(contractName, currentHash); } diff --git a/yarn-project/noir-compiler/src/contract-interface-gen/noir.ts b/yarn-project/noir-compiler/src/contract-interface-gen/noir.ts deleted file mode 100644 index 52fd0788973..00000000000 --- a/yarn-project/noir-compiler/src/contract-interface-gen/noir.ts +++ /dev/null @@ -1,308 +0,0 @@ -import { - type ABIParameter, - type ABIVariable, - type ContractArtifact, - type FunctionArtifact, - FunctionSelector, - FunctionType, - type StructType, -} from '@aztec/foundation/abi'; -import { times } from '@aztec/foundation/collection'; - -import camelCase from 'lodash.camelcase'; -import capitalize from 'lodash.capitalize'; - -/** - * Returns whether this function type corresponds to a private call. - * @param functionType - The function type. - * @returns Whether this function type corresponds to a private call. - */ -function isPrivateCall(functionType: FunctionType) { - return functionType === FunctionType.SECRET; -} - -/** - * Generates a call to a private function using the context. - * @param selector - The selector of a function. - * @param functionType - Type of the function. - * @returns A code string. - */ -function generateCallStatement( - selector: FunctionSelector, - functionType: FunctionType, - callingContext: 'private' | 'public', -) { - const callMethod = isPrivateCall(functionType) ? 'call_private_function' : 'call_public_function'; - const args = [ - 'self.address', - `FunctionSelector::from_field(${selector.toString()})`, - 'serialized_args', - ...(callingContext === 'private' ? [] : ['GasOpts::default()']), - ]; - return ` - context.${callMethod}(${args.join(', ')})`; -} - -/** - * Formats a string as pascal case. - * @param str - A string. - * @returns A capitalized camelcase string. - */ -function toPascalCase(str: string) { - const camel = camelCase(str); - return camel[0].toUpperCase() + camel.slice(1); -} - -/** - * Returns a struct name given a list of fragments. - * @param fragments - Fragments. - * @returns The concatenation of the capitalized fragments. - */ -function getStructName(...fragments: string[]) { - return fragments.map(toPascalCase).join('') + 'Struct'; -} - -/** - * Returns a Noir type name for the given ABI variable. - * @param param - ABI variable to translate to a Noir type name. - * @param parentNames - Function name or parent structs or arrays to use for struct qualified names. - * @returns A valid Noir basic type name or a name for a struct. - */ -function getTypeName(param: ABIVariable, ...parentNames: string[]): string { - const type = param.type; - switch (type.kind) { - case 'field': - return 'Field'; - case 'boolean': - return 'bool'; - case 'integer': - return `${type.sign === 'signed' ? 'i' : 'u'}${type.width}`; - case 'string': - throw new Error(`Strings not supported yet`); - case 'array': - return `[${getTypeName({ name: param.name, type: type.type }, ...parentNames)};${type.length}]`; - case 'struct': - return getStructName(param.name, ...parentNames); - default: - throw new Error(`Unknown type ${type}`); - } -} - -/** - * Generates a parameter string. - * @param param - ABI parameter. - * @param functionData - Parent function. - * @returns A Noir string with the param name and type to be used in a function call. - */ -function generateParameter(param: ABIParameter, functionData: FunctionArtifact) { - const typename = getTypeName(param, functionData.name); - return `${param.name}: ${typename}`; -} - -/** - * Collects all parameters for a given function and flattens them according to how they should be serialized. - * @param parameters - Parameters for a function. - * @returns List of parameters flattened to basic data types. - */ -function collectParametersForSerialization(parameters: ABIVariable[]) { - const flattened: string[] = []; - for (const parameter of parameters) { - const { name } = parameter; - if (parameter.type.kind === 'array') { - const nestedType = parameter.type.type; - const nested = times(parameter.type.length, i => - collectParametersForSerialization([{ name: `${name}[${i}]`, type: nestedType }]), - ); - flattened.push(...nested.flat()); - } else if (parameter.type.kind === 'struct') { - const nested = parameter.type.fields.map(field => - collectParametersForSerialization([{ name: `${name}.${field.name}`, type: field.type }]), - ); - flattened.push(...nested.flat()); - } else if (parameter.type.kind === 'string') { - throw new Error(`String not yet supported`); - } else if (parameter.type.kind === 'field') { - flattened.push(name); - } else { - flattened.push(`${name} as Field`); - } - } - return flattened; -} - -/** - * Generates Noir code for serializing the parameters into an array of fields. - * @param parameters - Parameters to serialize. - * @returns The serialization code. - */ -function generateSerialization(parameters: ABIParameter[]) { - const flattened = collectParametersForSerialization(parameters); - const declaration = ` let mut serialized_args = [0; ${flattened.length}];`; - const lines = flattened.map((param, i) => ` serialized_args[${i}] = ${param};`); - return [declaration, ...lines].join('\n'); -} - -/** - * Generate a function interface for a particular function of the Aztec.nr Contract being processed. This function will be a method of the ContractInterface struct being created here. - * @param functionData - Data relating to the function, which can be used to generate a callable Aztec.nr Function. - * @param kind - Whether this interface will be used from private or public functions. - * @returns A code string. - */ -function generateFunctionInterface(functionData: FunctionArtifact, kind: 'private' | 'public') { - const { name, parameters } = functionData; - const selector = FunctionSelector.fromNameAndParameters(name, parameters); - const serialization = generateSerialization(parameters); - const contextType = kind === 'private' ? '&mut PrivateContext' : '&mut PublicContext'; - const callStatement = generateCallStatement(selector, functionData.functionType, kind); - const allParams = ['self', `context: ${contextType}`, ...parameters.map(p => generateParameter(p, functionData))]; - const isPrivate = isPrivateCall(functionData.functionType); - const isSync = (isPrivate && kind === 'private') || (!isPrivate && kind === 'public'); - // TODO: When return typing data is available in the artifact, we can instead codegen the concrete return type for public and private. - const generics = !isPrivate && isSync ? `` : ``; - const retType = isPrivate ? `-> PackedReturns` : isSync ? `-> FunctionReturns ` : ``; - - return ` - pub fn ${name}${generics}( - ${allParams.join(',\n ')} - ) ${retType}{ -${serialization} -${callStatement} - } - `; -} - -/** - * Generates static imports. - * @returns A string of code which will be needed in every contract interface, regardless of the contract. - */ -function generateStaticImports() { - return `use dep::std; -use dep::aztec::context::{ PrivateContext, PublicContext, PackedReturns, FunctionReturns, gas::GasOpts }; -use dep::aztec::protocol_types::{ - address::AztecAddress, - abis::function_selector::FunctionSelector, -};`; -} - -/** - * Generates the name of the contract struct, based on whether it's for private or public usage. - * @param contractName - Name of the contract. - * @param kind - Whether this interface will be used from private or public functions. - * @returns A name. - */ -function generateContractStructName(contractName: string, kind: 'private' | 'public') { - return `${contractName}${capitalize(kind)}ContextInterface`; -} - -/** - * Generate the main focus of this code generator: the contract interface struct. - * @param contractName - the name of the contract, as matches the original source file. - * @param kind - Whether this interface will be used from private or public functions. - * @returns Code. - */ -function generateContractInterfaceStruct(contractName: string, kind: 'private' | 'public') { - return `// Interface for calling ${contractName} functions from a ${kind} context -struct ${generateContractStructName(contractName, kind)} { - address: AztecAddress, -} -`; -} - -/** - * Generates the implementation of the contract interface struct. - * @param contractName - The name of the contract, as matches the original source file. - * @param kind - Whether this interface will be used from private or public functions. - * @param functions - An array of strings, where each string is valid Noir code describing the function interface of one of the contract's functions (as generated via `generateFunctionInterface` above). - * @returns Code. - */ -function generateContractInterfaceImpl(contractName: string, kind: 'private' | 'public', functions: string[]) { - return `impl ${generateContractStructName(contractName, kind)} { - pub fn at(address: AztecAddress) -> Self { - Self { - address, - } - } - ${functions.join('\n')} -} -`; -} - -/** Represents a struct along its parent names to derive a fully qualified name. */ -type StructInfo = ABIVariable & { /** Parent name */ parentNames: string[] }; - -/** - * Generates a Noir struct. - * @param struct - Struct info. - * @returns Code representing the struct. - */ -function generateStruct(struct: StructInfo) { - const fields = (struct.type as StructType).fields.map( - field => ` ${field.name}: ${getTypeName(field, struct.name, ...struct.parentNames)},`, - ); - - return ` -struct ${getStructName(struct.name, ...struct.parentNames)} { -${fields.join('\n')} -}`; -} - -/** - * Collects all structs across all parameters. - * @param params - Parameters to look for structs, either structs themselves or nested. - * @param parentNames - Parent names to derive fully qualified names when needed. - * @returns A list of struct infos. - */ -function collectStructs(params: ABIVariable[], parentNames: string[]): StructInfo[] { - const structs: StructInfo[] = []; - for (const param of params) { - if (param.type.kind === 'struct') { - const struct = { ...param, parentNames }; - structs.push(struct, ...collectStructs(param.type.fields, [param.name, ...parentNames])); - } else if (param.type.kind === 'array') { - structs.push(...collectStructs([{ name: param.name, type: param.type.type }], [...parentNames])); - } - } - return structs; -} - -/** - * Generates the struct definition and implementation for a contract interface. - * @param abiName - Name of the contract. - * @param kind - Whether this interface will be used from private or public functions. - * @param methods - Contract methods to generate (private ones will be excluded if kind is public) - * @returns Code. - */ -function generateContractStruct(abiName: string, kind: 'private' | 'public', methods: FunctionArtifact[]) { - const contractStruct: string = generateContractInterfaceStruct(abiName, kind); - const applicableMethods = methods.filter(m => kind === 'private' || !isPrivateCall(m.functionType)); - const functionInterfaces = applicableMethods.map(m => generateFunctionInterface(m, kind)); - const contractImpl: string = generateContractInterfaceImpl(abiName, kind, functionInterfaces); - - return ` -${contractStruct} -${contractImpl} - `; -} - -/** - * Generates the Noir code to represent an interface for calling a contract. - * @param artifact - The compiled Aztec.nr artifact. - * @returns The corresponding ts code. - */ -export function generateNoirContractInterface(artifact: ContractArtifact) { - // We don't allow calling internal fns or unconstrained fns from other contracts - const methods = artifact.functions.filter(f => !f.isInternal && f.functionType !== FunctionType.UNCONSTRAINED); - const paramStructs = methods.flatMap(m => collectStructs(m.parameters, [m.name])).map(generateStruct); - const privateContractStruct = generateContractStruct(artifact.name, 'private', methods); - const publicContractStruct = generateContractStruct(artifact.name, 'public', methods); - - return `/* Autogenerated file, do not edit! */ - -${generateStaticImports()} -${paramStructs.join('\n')} - -${privateContractStruct} - -${publicContractStruct} -`; -} diff --git a/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts b/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts index 0ade1726ec8..04f1af32ed4 100644 --- a/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts +++ b/yarn-project/noir-compiler/src/contract-interface-gen/typescript.ts @@ -14,6 +14,8 @@ import { isWrappedFieldStruct, } from '@aztec/foundation/abi'; +import uniqBy from 'lodash.uniqby'; + /** * Returns the corresponding typescript type for a given Noir type. * @param type - The input Noir type. @@ -224,7 +226,9 @@ function generateStorageLayoutGetter(input: ContractArtifact) { * @param input - The contract artifact. */ function generateNotesGetter(input: ContractArtifact) { - const notes = input.outputs.globals.notes ? (input.outputs.globals.notes as TupleValue[]) : []; + const notes = input.outputs.globals.notes + ? uniqBy(input.outputs.globals.notes as TupleValue[], n => (n.fields[1] as BasicValue<'string', string>).value) + : []; const notesUnionType = notes.map(n => `'${(n.fields[1] as BasicValue<'string', string>).value}'`).join(' | '); const noteMetadata = notes diff --git a/yarn-project/noir-compiler/src/index.ts b/yarn-project/noir-compiler/src/index.ts index a28e4f09303..c6c4a84e441 100644 --- a/yarn-project/noir-compiler/src/index.ts +++ b/yarn-project/noir-compiler/src/index.ts @@ -1,2 +1 @@ export { generateTypescriptContractInterface } from './contract-interface-gen/typescript.js'; -export { generateNoirContractInterface } from './contract-interface-gen/noir.js'; diff --git a/yarn-project/noir-contracts.js/scripts/generate-noir-interfaces.sh b/yarn-project/noir-contracts.js/scripts/generate-noir-interfaces.sh deleted file mode 100755 index 249d168242f..00000000000 --- a/yarn-project/noir-contracts.js/scripts/generate-noir-interfaces.sh +++ /dev/null @@ -1,17 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail - -CONTRACTS=( - test_contract-Test -) - -NOIR_CONTRACTS_DIR="../../noir-projects/noir-contracts" - -for contract in $CONTRACTS; do - echo "Generating Noir interface for $contract" - OUT_DIR="$NOIR_CONTRACTS_DIR/contracts/${contract%%-*}/src" - node --no-warnings ../noir-compiler/dest/cli.js codegen -o $OUT_DIR --nr --force $NOIR_CONTRACTS_DIR/target/$contract.json - mv $OUT_DIR/${contract#*-}.nr $OUT_DIR/interface.nr -done - -echo "Done updating Noir interfaces" \ No newline at end of file diff --git a/yarn-project/noir-contracts.js/scripts/generate-types.sh b/yarn-project/noir-contracts.js/scripts/generate-types.sh index 87a13d3459d..6e98b09125b 100755 --- a/yarn-project/noir-contracts.js/scripts/generate-types.sh +++ b/yarn-project/noir-contracts.js/scripts/generate-types.sh @@ -28,7 +28,7 @@ for ABI in $(find ../../noir-projects/noir-contracts/target -maxdepth 1 -type f done # Generate types for the contracts -node --no-warnings ../noir-compiler/dest/cli.js codegen -o $OUT_DIR --ts artifacts +node --no-warnings ../noir-compiler/dest/cli.js codegen -o $OUT_DIR artifacts # Append exports for each generated TypeScript file to index.ts find "$OUT_DIR" -maxdepth 1 -type f -name '*.ts' ! -name 'index.ts' | while read -r TS_FILE; do diff --git a/yarn-project/simulator/src/acvm/oracle/oracle.ts b/yarn-project/simulator/src/acvm/oracle/oracle.ts index c9223ae8f1d..cccbb59c2bc 100644 --- a/yarn-project/simulator/src/acvm/oracle/oracle.ts +++ b/yarn-project/simulator/src/acvm/oracle/oracle.ts @@ -21,8 +21,13 @@ export class Oracle { return toACVMField(val); } - async packArguments(args: ACVMField[]): Promise { - const packed = await this.typedOracle.packArguments(args.map(fromACVMField)); + async packArgumentsArray(args: ACVMField[]): Promise { + const packed = await this.typedOracle.packArgumentsArray(args.map(fromACVMField)); + return toACVMField(packed); + } + + async packArguments(_length: ACVMField[], values: ACVMField[]): Promise { + const packed = await this.typedOracle.packArgumentsArray(values.map(fromACVMField)); return toACVMField(packed); } diff --git a/yarn-project/simulator/src/acvm/oracle/typed_oracle.ts b/yarn-project/simulator/src/acvm/oracle/typed_oracle.ts index 4f245732275..e52548cb5c2 100644 --- a/yarn-project/simulator/src/acvm/oracle/typed_oracle.ts +++ b/yarn-project/simulator/src/acvm/oracle/typed_oracle.ts @@ -85,8 +85,8 @@ export abstract class TypedOracle { return Fr.random(); } - packArguments(_args: Fr[]): Promise { - throw new OracleMethodNotAvailableError('packArguments'); + packArgumentsArray(_args: Fr[]): Promise { + throw new OracleMethodNotAvailableError('packArgumentsArray'); } packReturns(_returns: Fr[]): Promise { diff --git a/yarn-project/simulator/src/client/client_execution_context.ts b/yarn-project/simulator/src/client/client_execution_context.ts index 0c045247407..08aeebed187 100644 --- a/yarn-project/simulator/src/client/client_execution_context.ts +++ b/yarn-project/simulator/src/client/client_execution_context.ts @@ -171,10 +171,10 @@ export class ClientExecutionContext extends ViewDataOracle { } /** - * Pack the given arguments. + * Pack the given array of arguments. * @param args - Arguments to pack */ - public override packArguments(args: Fr[]): Promise { + public override packArgumentsArray(args: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(args)); } diff --git a/yarn-project/simulator/src/client/private_execution.test.ts b/yarn-project/simulator/src/client/private_execution.test.ts index 716232104a6..512060e9948 100644 --- a/yarn-project/simulator/src/client/private_execution.test.ts +++ b/yarn-project/simulator/src/client/private_execution.test.ts @@ -491,7 +491,7 @@ describe('Private Execution test suite', () => { it('test function should be callable through autogenerated interface', async () => { const testAddress = AztecAddress.random(); - const parentArtifact = getFunctionArtifact(ImportTestContractArtifact, 'main'); + const parentArtifact = getFunctionArtifact(ImportTestContractArtifact, 'main_contract'); const testCodeGenSelector = FunctionSelector.fromNameAndParameters( testCodeGenArtifact.name, testCodeGenArtifact.parameters, diff --git a/yarn-project/simulator/src/public/public_execution_context.ts b/yarn-project/simulator/src/public/public_execution_context.ts index e0b0922c934..686b7e3ba05 100644 --- a/yarn-project/simulator/src/public/public_execution_context.ts +++ b/yarn-project/simulator/src/public/public_execution_context.ts @@ -90,10 +90,10 @@ export class PublicExecutionContext extends TypedOracle { } /** - * Pack the given arguments. + * Pack the given array of arguments. * @param args - Arguments to pack */ - public override packArguments(args: Fr[]): Promise { + public override packArgumentsArray(args: Fr[]): Promise { return Promise.resolve(this.packedValuesCache.pack(args)); } diff --git a/yarn-project/yarn.lock b/yarn-project/yarn.lock index 23adca3a1b6..6fb7bf150b5 100644 --- a/yarn-project/yarn.lock +++ b/yarn-project/yarn.lock @@ -607,6 +607,7 @@ __metadata: "@types/jest": ^29.5.0 "@types/lodash.camelcase": ^4.3.7 "@types/lodash.capitalize": ^4.2.7 + "@types/lodash.uniqby": ^4.7.9 "@types/node": ^18.7.23 "@types/pako": ^2.0.0 "@types/semver": ^7.5.4 @@ -616,6 +617,7 @@ __metadata: jest: ^29.5.0 lodash.camelcase: ^4.3.0 lodash.capitalize: ^4.2.1 + lodash.uniqby: ^4.7.0 memfs: ^4.6.0 pako: ^2.1.0 semver: ^7.5.4 @@ -3634,6 +3636,15 @@ __metadata: languageName: node linkType: hard +"@types/lodash.uniqby@npm:^4.7.9": + version: 4.7.9 + resolution: "@types/lodash.uniqby@npm:4.7.9" + dependencies: + "@types/lodash": "*" + checksum: 24cc8af36e0d4c52b7294c7ba7d814c89ce2c8118d94350bbed21031fef850fa1a280bfd2b30a47e0b5f7aa6ac649a36a5089aa76bc23787963a5ee6443f631e + languageName: node + linkType: hard + "@types/lodash@npm:*": version: 4.14.202 resolution: "@types/lodash@npm:4.14.202" @@ -9844,6 +9855,13 @@ __metadata: languageName: node linkType: hard +"lodash.uniqby@npm:^4.7.0": + version: 4.7.0 + resolution: "lodash.uniqby@npm:4.7.0" + checksum: 659264545a95726d1493123345aad8cbf56e17810fa9a0b029852c6d42bc80517696af09d99b23bef1845d10d95e01b8b4a1da578f22aeba7a30d3e0022a4938 + languageName: node + linkType: hard + "lodash@npm:^4.17.21, lodash@npm:^4.17.4": version: 4.17.21 resolution: "lodash@npm:4.17.21" From 18e75b85bcd6eec53cee3a5da854a8d27e3f186e Mon Sep 17 00:00:00 2001 From: ludamad Date: Wed, 17 Apr 2024 09:17:26 -0400 Subject: [PATCH 50/56] fix(ci): race condition when making spot in multiple PRs (#5798) Example https://github.com/AztecProtocol/aztec-packages/actions/runs/8712337433/job/23898451395 Changes: https://github.com/AztecProtocol/ec2-action-builder/commit/88099b7e3e4c22b8bca63ded25ee13f5f29629a0 --- .github/workflows/setup-runner.yml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/.github/workflows/setup-runner.yml b/.github/workflows/setup-runner.yml index 15b670c82ec..80a9ba497b1 100644 --- a/.github/workflows/setup-runner.yml +++ b/.github/workflows/setup-runner.yml @@ -3,7 +3,7 @@ # just for the CI job. These are specced per user and run the entire CI. # TODO These have a persistent EBS volume that forms a fast-online docker image cache (used by Earthly), meaning # TODO build steps that ran in previous invocations are quickly ran from cache. -name: Reusable Spot Instance and Setup Workflow +name: Setup Runner and CI on: workflow_call: inputs: @@ -52,9 +52,12 @@ on: jobs: start-builder: runs-on: ubuntu-latest + # we want to avoid race conditions when making spot across multiple PRs as we only use one runner + concurrency: + group: start-builder-${{ inputs.runner_label }} steps: - name: Start EC2 runner - uses: AztecProtocol/ec2-action-builder@v0.10 + uses: AztecProtocol/ec2-action-builder@v0.12 with: github_token: ${{ secrets.GH_SELF_HOSTED_RUNNER_TOKEN }} aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }} From f7d5cf2c683ee7840885ac176b9e838b4e3ab6e2 Mon Sep 17 00:00:00 2001 From: Alex Gherghisan Date: Wed, 17 Apr 2024 14:24:10 +0100 Subject: [PATCH 51/56] feat: bump lmdb (#5783) --- yarn-project/archiver/package.json | 1 - yarn-project/kv-store/package.json | 2 +- yarn-project/yarn.lock | 61 +++++++++++++++--------------- 3 files changed, 31 insertions(+), 33 deletions(-) diff --git a/yarn-project/archiver/package.json b/yarn-project/archiver/package.json index 17e7cb0ffdf..e1de8022869 100644 --- a/yarn-project/archiver/package.json +++ b/yarn-project/archiver/package.json @@ -51,7 +51,6 @@ "@aztec/protocol-contracts": "workspace:^", "@aztec/types": "workspace:^", "debug": "^4.3.4", - "lmdb": "^2.9.2", "lodash.groupby": "^4.6.0", "lodash.omit": "^4.5.0", "tsc-watch": "^6.0.0", diff --git a/yarn-project/kv-store/package.json b/yarn-project/kv-store/package.json index d5bfb66aec4..d22d0190c7d 100644 --- a/yarn-project/kv-store/package.json +++ b/yarn-project/kv-store/package.json @@ -37,7 +37,7 @@ }, "dependencies": { "@aztec/foundation": "workspace:^", - "lmdb": "^2.9.2" + "lmdb": "^3.0.6" }, "devDependencies": { "@jest/globals": "^29.5.0", diff --git a/yarn-project/yarn.lock b/yarn-project/yarn.lock index 6fb7bf150b5..1121959ee0b 100644 --- a/yarn-project/yarn.lock +++ b/yarn-project/yarn.lock @@ -103,7 +103,6 @@ __metadata: debug: ^4.3.4 jest: ^29.5.0 jest-mock-extended: ^3.0.4 - lmdb: ^2.9.2 lodash.groupby: ^4.6.0 lodash.omit: ^4.5.0 ts-node: ^10.9.1 @@ -556,7 +555,7 @@ __metadata: "@types/node": ^18.7.23 jest: ^29.5.0 jest-mock-extended: ^3.0.3 - lmdb: ^2.9.2 + lmdb: ^3.0.6 ts-node: ^10.9.1 typescript: ^5.0.4 languageName: unknown @@ -2565,44 +2564,44 @@ __metadata: languageName: node linkType: hard -"@lmdb/lmdb-darwin-arm64@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-darwin-arm64@npm:2.9.2" +"@lmdb/lmdb-darwin-arm64@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-darwin-arm64@npm:3.0.6" conditions: os=darwin & cpu=arm64 languageName: node linkType: hard -"@lmdb/lmdb-darwin-x64@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-darwin-x64@npm:2.9.2" +"@lmdb/lmdb-darwin-x64@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-darwin-x64@npm:3.0.6" conditions: os=darwin & cpu=x64 languageName: node linkType: hard -"@lmdb/lmdb-linux-arm64@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-linux-arm64@npm:2.9.2" +"@lmdb/lmdb-linux-arm64@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-linux-arm64@npm:3.0.6" conditions: os=linux & cpu=arm64 languageName: node linkType: hard -"@lmdb/lmdb-linux-arm@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-linux-arm@npm:2.9.2" +"@lmdb/lmdb-linux-arm@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-linux-arm@npm:3.0.6" conditions: os=linux & cpu=arm languageName: node linkType: hard -"@lmdb/lmdb-linux-x64@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-linux-x64@npm:2.9.2" +"@lmdb/lmdb-linux-x64@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-linux-x64@npm:3.0.6" conditions: os=linux & cpu=x64 languageName: node linkType: hard -"@lmdb/lmdb-win32-x64@npm:2.9.2": - version: 2.9.2 - resolution: "@lmdb/lmdb-win32-x64@npm:2.9.2" +"@lmdb/lmdb-win32-x64@npm:3.0.6": + version: 3.0.6 + resolution: "@lmdb/lmdb-win32-x64@npm:3.0.6" conditions: os=win32 & cpu=x64 languageName: node linkType: hard @@ -9685,16 +9684,16 @@ __metadata: languageName: node linkType: hard -"lmdb@npm:^2.9.2": - version: 2.9.2 - resolution: "lmdb@npm:2.9.2" - dependencies: - "@lmdb/lmdb-darwin-arm64": 2.9.2 - "@lmdb/lmdb-darwin-x64": 2.9.2 - "@lmdb/lmdb-linux-arm": 2.9.2 - "@lmdb/lmdb-linux-arm64": 2.9.2 - "@lmdb/lmdb-linux-x64": 2.9.2 - "@lmdb/lmdb-win32-x64": 2.9.2 +"lmdb@npm:^3.0.6": + version: 3.0.6 + resolution: "lmdb@npm:3.0.6" + dependencies: + "@lmdb/lmdb-darwin-arm64": 3.0.6 + "@lmdb/lmdb-darwin-x64": 3.0.6 + "@lmdb/lmdb-linux-arm": 3.0.6 + "@lmdb/lmdb-linux-arm64": 3.0.6 + "@lmdb/lmdb-linux-x64": 3.0.6 + "@lmdb/lmdb-win32-x64": 3.0.6 msgpackr: ^1.9.9 node-addon-api: ^6.1.0 node-gyp: latest @@ -9716,7 +9715,7 @@ __metadata: optional: true bin: download-lmdb-prebuilds: bin/download-prebuilds.js - checksum: b2471c4d2c36f15a27233ae1eece86fcbb40613574ec54245cf697b16b1b35c70c72e4092dc739407df145f14b7c1b6b56c4281a439c314e79a5338df8b2b63b + checksum: e8ab5bbef94e254ec1fa85deec251c4b34047786c87f54abd842cd12c3f29d55f62828512a4b69046075a624a25b2327e232072be702a68fcb3d8183e0175cca languageName: node linkType: hard From 98e8da094dbac1c06f800f82bd89181a6b9039b5 Mon Sep 17 00:00:00 2001 From: ludamad Date: Wed, 17 Apr 2024 10:07:18 -0400 Subject: [PATCH 52/56] fix: don't refcount spot (#5812) This logic has proven tricky and is taking down builds early. I may have found the mistake, but its best to make sure everything is stable without this https://github.com/AztecProtocol/ec2-action-builder/commit/95568a191495422eee22a20e48c9d4995aa32538 --- .github/workflows/setup-runner.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/setup-runner.yml b/.github/workflows/setup-runner.yml index 80a9ba497b1..c581738eace 100644 --- a/.github/workflows/setup-runner.yml +++ b/.github/workflows/setup-runner.yml @@ -57,7 +57,7 @@ jobs: group: start-builder-${{ inputs.runner_label }} steps: - name: Start EC2 runner - uses: AztecProtocol/ec2-action-builder@v0.12 + uses: AztecProtocol/ec2-action-builder@v0.13 with: github_token: ${{ secrets.GH_SELF_HOSTED_RUNNER_TOKEN }} aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }} From 323f59f55bcd64e32725d1ed5aab72d5b9dbe31d Mon Sep 17 00:00:00 2001 From: Leila Wang Date: Wed, 17 Apr 2024 15:09:16 +0100 Subject: [PATCH 53/56] feat: verify public data reads (#5701) Please read [contributing guidelines](CONTRIBUTING.md) and remove this line. --- .../src/core/libraries/ConstantsGen.sol | 1 + .../noir-protocol-circuits/Nargo.toml | 1 + .../src/private_kernel_tail.nr | 10 +- .../src/private_kernel_tail_to_public.nr | 2 +- .../crates/public-kernel-lib/src/common.nr | 31 +- .../src/public_kernel_tail.nr | 323 +++++++++++++----- .../crates/reset-kernel-lib/src/lib.nr | 11 +- ...llifier_non_existent_read_request_reset.nr | 4 +- .../src/nullifier_read_request_reset.nr | 4 +- .../private_validation_request_processor.nr | 2 +- .../src/public_data_read_request_reset.nr | 9 + .../public_validation_request_processor.nr | 127 +++++++ .../crates/reset-kernel-lib/src/reset.nr | 3 + .../src/reset/mutable_data_read_request.nr | 320 +++++++++++++++++ .../non_existent_read_request.nr} | 18 +- .../read_request.nr} | 4 +- .../crates/reset-kernel-lib/src/tests.nr | 1 + .../nullifier_read_request_hints_builder.nr | 2 +- .../public_data_read_request_hints_builder.nr | 29 ++ .../crates/reset-kernel-lib/src/types.nr | 1 + .../src/types/public_data_hint.nr | 27 ++ .../rollup-lib/src/base/base_rollup_inputs.nr | 67 +--- .../combined_accumulated_data.nr | 2 +- .../kernel_circuit_public_inputs.nr | 6 +- ...te_kernel_circuit_public_inputs_builder.nr | 6 +- ...ic_kernel_circuit_public_inputs_builder.nr | 21 +- .../crates/types/src/constants.nr | 3 + .../crates/types/src/merkle_tree.nr | 4 +- .../types/src/merkle_tree/indexed_tree.nr | 2 + .../indexed_tree/check_valid_low_leaf.nr | 78 +++++ .../types/src/merkle_tree/membership.nr | 199 +++++------ .../src/public_data_tree_leaf_preimage.nr | 16 +- .../crates/types/src/tests/fixture_builder.nr | 35 +- yarn-project/circuit-types/src/mocks.ts | 24 +- yarn-project/circuits.js/src/constants.gen.ts | 1 + .../circuits.js/src/hints/build_hints.test.ts | 9 +- .../circuits.js/src/hints/build_hints.ts | 8 +- .../src/hints/build_public_data_hints.test.ts | 123 +++++++ .../src/hints/build_public_data_hints.ts | 49 +++ ...ild_public_data_read_request_hints.test.ts | 150 ++++++++ .../build_public_data_read_request_hints.ts | 45 +++ yarn-project/circuits.js/src/hints/index.ts | 3 +- yarn-project/circuits.js/src/index.ts | 1 + .../src/structs/contract_storage_read.ts | 5 +- .../contract_storage_update_request.ts | 4 +- yarn-project/circuits.js/src/structs/index.ts | 2 + .../kernel/kernel_circuit_public_inputs.ts | 5 + ...ivate_kernel_tail_circuit_public_inputs.ts | 2 + ...blic_kernel_tail_circuit_private_inputs.ts | 18 +- .../src/structs/membership_witness.ts | 2 +- .../non_existent_read_request_hints.ts | 2 +- .../src/structs/public_data_hint.ts | 47 +++ .../structs/public_data_read_request_hints.ts | 86 +++++ .../src/structs/read_request_hints.ts | 10 +- .../circuits.js/src/tests/factories.ts | 7 + .../src/type_conversion.ts | 36 ++ .../pxe/src/kernel_prover/hints_builder.ts | 2 +- .../src/public/abstract_phase_manager.ts | 22 +- .../simulator/src/public/execution.ts | 16 +- .../simulator/src/public/hints_builder.ts | 122 +++---- .../simulator/src/public/index.test.ts | 5 + .../src/public/public_processor.test.ts | 321 +++++++++-------- .../simulator/src/public/state_actions.ts | 2 + .../src/public/tail_phase_manager.ts | 48 ++- .../src/public/transitional_adaptors.ts | 4 +- 65 files changed, 1939 insertions(+), 611 deletions(-) create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_data_read_request_reset.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_validation_request_processor.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/mutable_data_read_request.nr rename noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/{non_existent_read_request_reset.nr => reset/non_existent_read_request.nr} (94%) rename noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/{read_request_reset.nr => reset/read_request.nr} (99%) create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/tests/public_data_read_request_hints_builder.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types/public_data_hint.nr create mode 100644 noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree/check_valid_low_leaf.nr create mode 100644 yarn-project/circuits.js/src/hints/build_public_data_hints.test.ts create mode 100644 yarn-project/circuits.js/src/hints/build_public_data_hints.ts create mode 100644 yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.test.ts create mode 100644 yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.ts create mode 100644 yarn-project/circuits.js/src/structs/public_data_hint.ts create mode 100644 yarn-project/circuits.js/src/structs/public_data_read_request_hints.ts diff --git a/l1-contracts/src/core/libraries/ConstantsGen.sol b/l1-contracts/src/core/libraries/ConstantsGen.sol index 883f546a905..0681d433e03 100644 --- a/l1-contracts/src/core/libraries/ConstantsGen.sol +++ b/l1-contracts/src/core/libraries/ConstantsGen.sol @@ -39,6 +39,7 @@ library Constants { uint256 internal constant MAX_NULLIFIER_KEY_VALIDATION_REQUESTS_PER_TX = 4; uint256 internal constant NUM_ENCRYPTED_LOGS_HASHES_PER_TX = 1; uint256 internal constant NUM_UNENCRYPTED_LOGS_HASHES_PER_TX = 1; + uint256 internal constant MAX_PUBLIC_DATA_HINTS = 64; uint256 internal constant NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP = 16; uint256 internal constant VK_TREE_HEIGHT = 3; uint256 internal constant FUNCTION_TREE_HEIGHT = 5; diff --git a/noir-projects/noir-protocol-circuits/Nargo.toml b/noir-projects/noir-protocol-circuits/Nargo.toml index d3f3c3d55b0..48cc2fc96f6 100644 --- a/noir-projects/noir-protocol-circuits/Nargo.toml +++ b/noir-projects/noir-protocol-circuits/Nargo.toml @@ -22,6 +22,7 @@ members = [ "crates/public-kernel-teardown-simulated", "crates/public-kernel-tail", "crates/public-kernel-tail-simulated", + "crates/reset-kernel-lib", "crates/rollup-lib", "crates/rollup-merge", "crates/rollup-base", diff --git a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail.nr b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail.nr index ac229a9beb9..551605f4426 100644 --- a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail.nr +++ b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail.nr @@ -59,7 +59,7 @@ mod tests { use crate::private_kernel_tail::PrivateKernelTailCircuitPrivateInputs; use dep::reset_kernel_lib::{ tests::nullifier_read_request_hints_builder::NullifierReadRequestHintsBuilder, - read_request_reset::{PendingReadHint, ReadRequestState, ReadRequestStatus} + reset::read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus} }; use dep::types::constants::{ MAX_NOTE_HASH_READ_REQUESTS_PER_TX, MAX_NEW_NOTE_HASHES_PER_TX, MAX_NEW_NULLIFIERS_PER_TX, @@ -177,6 +177,14 @@ mod tests { } } + #[test] + unconstrained fn execution_succeeded() { + let mut builder = PrivateKernelTailInputsBuilder::new(); + let public_inputs = builder.execute(); + + assert(is_empty(public_inputs.start_state)); + } + #[test] unconstrained fn native_matching_one_read_request_to_commitment_works() { let mut builder = PrivateKernelTailInputsBuilder::new(); diff --git a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail_to_public.nr b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail_to_public.nr index d3569bdf3b5..1a6aef17c5b 100644 --- a/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail_to_public.nr +++ b/noir-projects/noir-protocol-circuits/crates/private-kernel-lib/src/private_kernel_tail_to_public.nr @@ -59,7 +59,7 @@ mod tests { use crate::private_kernel_tail_to_public::PrivateKernelTailToPublicCircuitPrivateInputs; use dep::reset_kernel_lib::{ tests::nullifier_read_request_hints_builder::NullifierReadRequestHintsBuilder, - read_request_reset::{PendingReadHint, ReadRequestState, ReadRequestStatus} + reset::read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus} }; use dep::types::constants::{ MAX_NOTE_HASH_READ_REQUESTS_PER_TX, MAX_NEW_NOTE_HASHES_PER_TX, MAX_NEW_NULLIFIERS_PER_TX, diff --git a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr index 006b531e94d..61ea76033e5 100644 --- a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr +++ b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/common.nr @@ -79,11 +79,8 @@ pub fn initialize_emitted_end_values( circuit_outputs.end_non_revertible.encrypted_logs_hash = start_non_revertible.encrypted_logs_hash; circuit_outputs.end_non_revertible.encrypted_log_preimages_length = start_non_revertible.encrypted_log_preimages_length; - // TODO - should be propagated only in initialize_end_values() and clear them in the tail circuit. The - // max_block_number must be propagated to the rollup however as a RollupValidationRequest. let start = previous_kernel.public_inputs.validation_requests; circuit_outputs.validation_requests.max_block_number = start.for_rollup.max_block_number; - circuit_outputs.validation_requests.public_data_reads = array_to_bounded_vec(start.public_data_reads); } // Initialises the circuit outputs with the end state of the previous iteration. @@ -110,6 +107,7 @@ pub fn initialize_end_values( circuit_outputs.validation_requests.max_block_number = previous_kernel.public_inputs.validation_requests.for_rollup.max_block_number; circuit_outputs.validation_requests.nullifier_read_requests = array_to_bounded_vec(start.nullifier_read_requests); circuit_outputs.validation_requests.nullifier_non_existent_read_requests = array_to_bounded_vec(start.nullifier_non_existent_read_requests); + circuit_outputs.validation_requests.public_data_reads = array_to_bounded_vec(start.public_data_reads); } fn perform_static_call_checks(public_call: PublicCallData) { @@ -244,7 +242,7 @@ pub fn update_public_end_non_revertible_values( propagate_new_nullifiers_non_revertible(public_call, circuit_outputs); propagate_new_note_hashes_non_revertible(public_call, circuit_outputs); - propagate_new_l2_to_l1_messages(public_call, circuit_outputs); + propagate_new_l2_to_l1_messages_non_revertible(public_call, circuit_outputs); propagate_valid_non_revertible_public_data_update_requests(public_call, circuit_outputs); } @@ -457,6 +455,31 @@ fn propagate_new_nullifiers( circuit_outputs.end.new_nullifiers.extend_from_bounded_vec(siloed_new_nullifiers); } +fn propagate_new_l2_to_l1_messages_non_revertible( + public_call: PublicCallData, + public_inputs: &mut PublicKernelCircuitPublicInputsBuilder +) { + // new l2 to l1 messages + let public_call_public_inputs = public_call.call_stack_item.public_inputs; + let storage_contract_address = public_call_public_inputs.call_context.storage_contract_address; + + let new_l2_to_l1_msgs = public_call_public_inputs.new_l2_to_l1_msgs; + let mut new_l2_to_l1_msgs_to_insert : BoundedVec = BoundedVec::new(); + for i in 0..MAX_NEW_L2_TO_L1_MSGS_PER_CALL { + let msg = new_l2_to_l1_msgs[i]; + if !is_empty(msg) { + let new_l2_to_l1_msgs = compute_l2_to_l1_hash( + storage_contract_address, + public_inputs.constants.tx_context.version, + public_inputs.constants.tx_context.chain_id, + msg + ); + new_l2_to_l1_msgs_to_insert.push(new_l2_to_l1_msgs) + } + } + public_inputs.end_non_revertible.new_l2_to_l1_msgs.extend_from_bounded_vec(new_l2_to_l1_msgs_to_insert); +} + fn propagate_new_l2_to_l1_messages(public_call: PublicCallData, public_inputs: &mut PublicKernelCircuitPublicInputsBuilder) { // new l2 to l1 messages let public_call_public_inputs = public_call.call_stack_item.public_inputs; diff --git a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_tail.nr b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_tail.nr index 23ab1034779..d84e309b6a9 100644 --- a/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_tail.nr +++ b/noir-projects/noir-protocol-circuits/crates/public-kernel-lib/src/public_kernel_tail.nr @@ -1,29 +1,28 @@ use crate::common; use dep::reset_kernel_lib::{ - NullifierReadRequestHints, NullifierNonExistentReadRequestHints, reset_non_existent_read_requests, - reset_read_requests + NullifierReadRequestHints, NullifierNonExistentReadRequestHints, PublicDataReadRequestHints, + PublicValidationRequestProcessor, PublicDataHint }; use dep::types::{ abis::{ - kernel_circuit_public_inputs::{KernelCircuitPublicInputs, PublicKernelCircuitPublicInputsBuilder}, - kernel_data::PublicKernelData, side_effect::SideEffectLinkedToNoteHash + accumulated_data::CombinedAccumulatedData, kernel_circuit_public_inputs::KernelCircuitPublicInputs, + kernel_data::PublicKernelData }, - constants::MAX_NEW_NULLIFIERS_PER_TX, - utils::{arrays::{array_length, array_merge, array_to_bounded_vec, assert_sorted_array}}, - hash::silo_nullifier, traits::is_empty + constants::MAX_PUBLIC_DATA_HINTS, + merkle_tree::{conditionally_assert_check_membership, MembershipWitness}, + partial_state_reference::PartialStateReference, utils::{arrays::array_length} }; struct PublicKernelTailCircuitPrivateInputs { previous_kernel: PublicKernelData, nullifier_read_request_hints: NullifierReadRequestHints, nullifier_non_existent_read_request_hints: NullifierNonExistentReadRequestHints, + public_data_hints: [PublicDataHint; MAX_PUBLIC_DATA_HINTS], + public_data_read_request_hints: PublicDataReadRequestHints, + start_state: PartialStateReference, } impl PublicKernelTailCircuitPrivateInputs { - fn propagate_revert_code(self, public_inputs: &mut PublicKernelCircuitPublicInputsBuilder) { - public_inputs.revert_code = self.previous_kernel.public_inputs.revert_code; - } - fn validate_inputs(self) { let previous_public_inputs = self.previous_kernel.public_inputs; assert(previous_public_inputs.needs_setup() == false, "Previous kernel needs setup"); @@ -37,106 +36,96 @@ impl PublicKernelTailCircuitPrivateInputs { ); } - fn validate_nullifier_read_requests(self, public_inputs: &mut PublicKernelCircuitPublicInputsBuilder) { - let end_non_revertible = self.previous_kernel.public_inputs.end_non_revertible; - let end = self.previous_kernel.public_inputs.end; - - let requests = self.previous_kernel.public_inputs.validation_requests.nullifier_read_requests; - - let pending_nullifiers = array_merge(end_non_revertible.new_nullifiers, end.new_nullifiers); - - let hints = self.nullifier_read_request_hints; - - let nullifier_tree_root = public_inputs.constants.historical_header.state.partial.nullifier_tree.root; - - let unverified_nullifier_read_requests = reset_read_requests( - requests, - pending_nullifiers, - hints.read_request_statuses, - hints.pending_read_hints, - hints.settled_read_hints, - nullifier_tree_root - ); - - assert( - unverified_nullifier_read_requests.len() == 0, "All nullifier read requests must be verified" - ); - } - - fn validate_nullifier_non_existent_read_requests(self, public_inputs: &mut PublicKernelCircuitPublicInputsBuilder) { - let end_non_revertible = self.previous_kernel.public_inputs.end_non_revertible; - let end = self.previous_kernel.public_inputs.end; - - // The values of the read requests here need to be siloed. - // Notice that it's not the case for regular read requests, which can be run between two kernel iterations, and will to be verified against unsiloed pending values. - let mut read_requests = self.previous_kernel.public_inputs.validation_requests.nullifier_non_existent_read_requests; - for i in 0..read_requests.len() { - let read_request = read_requests[i]; - if !is_empty(read_request) { - read_requests[i].value = silo_nullifier(read_request.contract_address, read_request.value); + fn validate_public_data_hints(self) { + let public_data_hints = self.public_data_hints; + let public_data_tree_root = self.start_state.public_data_tree.root; + for i in 0..public_data_hints.len() { + let hint = public_data_hints[i]; + // We only need to check leaf_slot to decide if a (non-)membership check is required. + // It will fail if a PublicDataHint with 0 leaf_slot is used to verify a non-empty public read or write. + if hint.leaf_slot != 0 { + let exists_in_tree = hint.leaf_slot == hint.leaf_preimage.slot; + if exists_in_tree { + assert( + hint.value == hint.leaf_preimage.value, "Hinted public data value does not match the value in leaf preimage" + ); + } else { + assert(hint.value == 0, "Value must be 0 for non-existent public data"); + } + + conditionally_assert_check_membership( + hint.leaf_slot, + exists_in_tree, + hint.leaf_preimage, + MembershipWitness { leaf_index: hint.membership_witness.leaf_index, sibling_path: hint.membership_witness.sibling_path }, + public_data_tree_root + ); } } + } - let nullifier_tree_root = public_inputs.constants.historical_header.state.partial.nullifier_tree.root; - - let hints = self.nullifier_non_existent_read_request_hints; - - let pending_nullifiers = array_merge(end_non_revertible.new_nullifiers, end.new_nullifiers); - assert_sorted_array( - pending_nullifiers, - hints.sorted_pending_values, - hints.sorted_pending_value_index_hints, - |a: SideEffectLinkedToNoteHash, b: SideEffectLinkedToNoteHash| a.value.lt(b.value) - ); - let sorted_pending_nullifiers = array_to_bounded_vec(hints.sorted_pending_values); - - reset_non_existent_read_requests( - read_requests, - hints.non_membership_hints, - nullifier_tree_root, - sorted_pending_nullifiers, - hints.next_pending_value_indices - ); + fn propagate_accumulated_data(self) -> CombinedAccumulatedData { + let previous_public_inputs = self.previous_kernel.public_inputs; + // TODO: Sort the combined data. + CombinedAccumulatedData::combine( + previous_public_inputs.end_non_revertible, + previous_public_inputs.end + ) } pub fn public_kernel_tail(self) -> KernelCircuitPublicInputs { - let mut public_inputs = PublicKernelCircuitPublicInputsBuilder::empty(); - self.validate_inputs(); - self.propagate_revert_code(&mut public_inputs); - - common::initialize_emitted_end_values(self.previous_kernel, &mut public_inputs); + self.validate_public_data_hints(); - self.validate_nullifier_read_requests(&mut public_inputs); + let previous_public_inputs = self.previous_kernel.public_inputs; + let request_processor = PublicValidationRequestProcessor::new( + previous_public_inputs, + self.nullifier_read_request_hints, + self.nullifier_non_existent_read_request_hints, + self.start_state.nullifier_tree.root, + self.public_data_read_request_hints, + self.public_data_hints + ); + request_processor.validate(); - self.validate_nullifier_non_existent_read_requests(&mut public_inputs); + let end = self.propagate_accumulated_data(); - public_inputs.finish_tail() + KernelCircuitPublicInputs { + aggregation_object: previous_public_inputs.aggregation_object, + rollup_validation_requests: previous_public_inputs.validation_requests.for_rollup, + end, + constants: previous_public_inputs.constants, + start_state: self.start_state, + revert_code: previous_public_inputs.revert_code + } } } mod tests { - use crate::{public_kernel_tail::PublicKernelTailCircuitPrivateInputs}; + use crate::public_kernel_tail::PublicKernelTailCircuitPrivateInputs; use dep::reset_kernel_lib::{ tests::{ nullifier_non_existent_read_request_hints_builder::NullifierNonExistentReadRequestHintsBuilder, - nullifier_read_request_hints_builder::NullifierReadRequestHintsBuilder + nullifier_read_request_hints_builder::NullifierReadRequestHintsBuilder, + public_data_read_request_hints_builder::PublicDataReadRequestHintsBuilder }, - read_request_reset::{PendingReadHint, ReadRequestState, ReadRequestStatus} + PublicDataHint, reset::read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus} }; use dep::types::{ abis::{ - kernel_circuit_public_inputs::{KernelCircuitPublicInputs, PublicKernelCircuitPublicInputsBuilder}, - kernel_data::PublicKernelData, nullifier_leaf_preimage::NullifierLeafPreimage + kernel_circuit_public_inputs::KernelCircuitPublicInputs, kernel_data::PublicKernelData, + nullifier_leaf_preimage::NullifierLeafPreimage, membership_witness::PublicDataMembershipWitness }, constants::{ - MAX_NEW_NULLIFIERS_PER_TX, MAX_NULLIFIER_READ_REQUESTS_PER_TX, NULLIFIER_TREE_HEIGHT, - NULLIFIER_SUBTREE_SIBLING_PATH_LENGTH, NULLIFIER_SUBTREE_HEIGHT + MAX_NEW_NULLIFIERS_PER_TX, MAX_NULLIFIER_READ_REQUESTS_PER_TX, MAX_PUBLIC_DATA_HINTS, + MAX_PUBLIC_DATA_READS_PER_TX, MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, NULLIFIER_TREE_HEIGHT, + NULLIFIER_SUBTREE_SIBLING_PATH_LENGTH, NULLIFIER_SUBTREE_HEIGHT, PUBLIC_DATA_SUBTREE_HEIGHT, + PUBLIC_DATA_SUBTREE_SIBLING_PATH_LENGTH, PUBLIC_DATA_TREE_HEIGHT }, - hash::silo_nullifier, + hash::silo_nullifier, public_data_tree_leaf_preimage::PublicDataTreeLeafPreimage, tests::{fixture_builder::FixtureBuilder, merkle_tree_utils::NonEmptyMerkleTree}, - utils::arrays::array_merge + partial_state_reference::PartialStateReference, utils::arrays::array_merge }; fn build_nullifier_tree() -> NonEmptyMerkleTree { @@ -151,11 +140,33 @@ mod tests { ) } + fn get_settled_public_data_leaves() -> [PublicDataTreeLeafPreimage; MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX] { + let mut settled_public_data_leaves = [PublicDataTreeLeafPreimage::empty(); MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX]; + settled_public_data_leaves[0] = PublicDataTreeLeafPreimage { slot: 22, value: 200, next_slot: 33, next_index: 1 }; + settled_public_data_leaves[1] = PublicDataTreeLeafPreimage { slot: 33, value: 300, next_slot: 0, next_index: 0 }; + settled_public_data_leaves[2] = PublicDataTreeLeafPreimage { slot: 11, value: 100, next_slot: 22, next_index: 0 }; + settled_public_data_leaves + } + + fn build_public_data_tree() -> NonEmptyMerkleTree { + let settled_public_data_leaves = get_settled_public_data_leaves(); + NonEmptyMerkleTree::new( + settled_public_data_leaves.map(|preimage: PublicDataTreeLeafPreimage| preimage.hash()), + [0; PUBLIC_DATA_TREE_HEIGHT], + [0; PUBLIC_DATA_TREE_HEIGHT - PUBLIC_DATA_SUBTREE_HEIGHT], + [0; PUBLIC_DATA_SUBTREE_HEIGHT] + ) + } + struct PublicKernelTailCircuitPrivateInputsBuilder { previous_kernel: FixtureBuilder, previous_revertible: FixtureBuilder, nullifier_read_request_hints_builder: NullifierReadRequestHintsBuilder, nullifier_non_existent_read_request_hints_builder: NullifierNonExistentReadRequestHintsBuilder, + public_data_read_request_hints_builder: PublicDataReadRequestHintsBuilder, + public_data_hints: BoundedVec, + public_data_tree: NonEmptyMerkleTree, + start_state: PartialStateReference, } impl PublicKernelTailCircuitPrivateInputsBuilder { @@ -168,7 +179,11 @@ mod tests { previous_kernel, previous_revertible, nullifier_read_request_hints_builder: NullifierReadRequestHintsBuilder::new(MAX_NULLIFIER_READ_REQUESTS_PER_TX), - nullifier_non_existent_read_request_hints_builder + nullifier_non_existent_read_request_hints_builder, + public_data_read_request_hints_builder: PublicDataReadRequestHintsBuilder::new(MAX_PUBLIC_DATA_READS_PER_TX), + public_data_hints: BoundedVec::new(), + public_data_tree: NonEmptyMerkleTree::empty(), + start_state: PartialStateReference::empty() }; builder.set_nullifiers_for_non_existent_read_request_hints(); builder @@ -176,8 +191,17 @@ mod tests { pub fn with_nullifier_tree(&mut self) -> Self { let nullifier_tree = build_nullifier_tree(); - self.previous_kernel.historical_header.state.partial.nullifier_tree.root = nullifier_tree.get_root(); self.nullifier_non_existent_read_request_hints_builder.set_nullifier_tree(nullifier_tree); + let tree_root = nullifier_tree.get_root(); + self.start_state.nullifier_tree.root = tree_root; + self.previous_kernel.historical_header.state.partial.nullifier_tree.root = tree_root; + *self + } + + pub fn with_public_data_tree(&mut self) -> Self { + let public_data_tree = build_public_data_tree(); + self.public_data_tree = public_data_tree; + self.start_state.public_data_tree.root = public_data_tree.get_root(); *self } @@ -236,6 +260,37 @@ mod tests { self.nullifier_non_existent_read_request_hints_builder.add_value_read(siloed_nullifier); } + pub fn add_public_data_hint_for_settled_public_data(&mut self, leaf_index: u64) { + let leaf_preimage = get_settled_public_data_leaves()[leaf_index]; + let membership_witness = PublicDataMembershipWitness { leaf_index: leaf_index as Field, sibling_path: self.public_data_tree.get_sibling_path(leaf_index) }; + let hint = PublicDataHint { + leaf_slot: leaf_preimage.slot, + value: leaf_preimage.value, + override_counter: 0, + membership_witness, + leaf_preimage + }; + self.public_data_hints.push(hint); + } + + pub fn add_public_data_hint_for_non_existent_public_data(&mut self, leaf_slot: Field, low_leaf_index: u64) { + let leaf_preimage = get_settled_public_data_leaves()[low_leaf_index]; + let membership_witness = PublicDataMembershipWitness { + leaf_index: low_leaf_index as Field, + sibling_path: self.public_data_tree.get_sibling_path(low_leaf_index) + }; + let hint = PublicDataHint { leaf_slot, value: 0, override_counter: 0, membership_witness, leaf_preimage }; + self.public_data_hints.push(hint); + } + + pub fn add_pending_public_data_read_request(&mut self, public_date_update_request_index: u64) { + let read_request_index = self.previous_kernel.add_read_request_for_pending_public_data(public_date_update_request_index); + let hint_index = self.public_data_read_request_hints_builder.pending_read_hints.len(); + let hint = PendingReadHint { read_request_index, pending_value_index: public_date_update_request_index }; + self.public_data_read_request_hints_builder.pending_read_hints.push(hint); + self.public_data_read_request_hints_builder.read_request_statuses[read_request_index] = ReadRequestStatus { state: ReadRequestState.PENDING, hint_index }; + } + fn sync_counters(&mut self) { let counter_non_revertible = self.previous_kernel.counter; let counter_revertible = self.previous_revertible.counter; @@ -253,7 +308,10 @@ mod tests { let kernel = PublicKernelTailCircuitPrivateInputs { previous_kernel, nullifier_read_request_hints: self.nullifier_read_request_hints_builder.to_hints(), - nullifier_non_existent_read_request_hints: self.nullifier_non_existent_read_request_hints_builder.to_hints() + nullifier_non_existent_read_request_hints: self.nullifier_non_existent_read_request_hints_builder.to_hints(), + public_data_hints: self.public_data_hints.storage, + public_data_read_request_hints: self.public_data_read_request_hints_builder.to_hints(), + start_state: self.start_state }; kernel.public_kernel_tail() @@ -356,6 +414,95 @@ mod tests { builder.read_non_existent_nullifier(1); + builder.failed(); + } + + #[test] + unconstrained fn validate_public_data_hints() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new().with_public_data_tree(); + + builder.add_public_data_hint_for_settled_public_data(1); + builder.add_public_data_hint_for_settled_public_data(0); + builder.add_public_data_hint_for_settled_public_data(2); + + builder.succeeded(); + } + + #[test(should_fail_with="Hinted public data value does not match the value in leaf preimage")] + unconstrained fn validate_public_data_hints_failed_mismatch_value() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new().with_public_data_tree(); + + builder.add_public_data_hint_for_settled_public_data(1); + + let mut hint = builder.public_data_hints.pop(); + hint.value += 1; + builder.public_data_hints.push(hint); + + builder.failed(); + } + + #[test] + unconstrained fn validate_public_data_hints_uninitialized_value() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new().with_public_data_tree(); + + builder.add_public_data_hint_for_non_existent_public_data(25, 0); + + builder.succeeded(); + } + + #[test(should_fail_with="Value must be 0 for non-existent public data")] + unconstrained fn validate_public_data_hints_failed_non_zero_uninitialized_value() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new().with_public_data_tree(); + + builder.add_public_data_hint_for_non_existent_public_data(25, 0); + + let mut hint = builder.public_data_hints.pop(); + hint.value = 1; + builder.public_data_hints.push(hint); + + builder.failed(); + } + + #[test] + unconstrained fn pending_public_data_read_requests() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new(); + + builder.previous_kernel.append_public_data_update_requests(3); + + builder.add_pending_public_data_read_request(1); + builder.add_pending_public_data_read_request(0); + builder.add_pending_public_data_read_request(2); + builder.succeeded(); } + + #[test(should_fail_with="Hinted slot of data write does not match read request")] + unconstrained fn pending_public_data_read_requests_failed_wrong_write_index() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new(); + + builder.previous_kernel.append_public_data_update_requests(2); + + builder.add_pending_public_data_read_request(1); + + let mut hint = builder.public_data_read_request_hints_builder.pending_read_hints.pop(); + hint.pending_value_index += 1; + builder.public_data_read_request_hints_builder.pending_read_hints.push(hint); + + builder.failed(); + } + + #[test(should_fail_with="Hinted value of data write does not match read request")] + unconstrained fn pending_public_data_read_requests_failed_wrong_write_value() { + let mut builder = PublicKernelTailCircuitPrivateInputsBuilder::new(); + + builder.previous_kernel.append_public_data_update_requests(1); + + builder.add_pending_public_data_read_request(0); + + let mut public_data_write = builder.previous_kernel.public_data_update_requests.pop(); + public_data_write.new_value += 1; + builder.previous_kernel.public_data_update_requests.push(public_data_write); + + builder.failed(); + } } diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/lib.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/lib.nr index a156e40f1a6..8a7ffb5e38b 100644 --- a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/lib.nr +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/lib.nr @@ -1,12 +1,15 @@ -use non_existent_read_request_reset::reset_non_existent_read_requests; use nullifier_non_existent_read_request_reset::NullifierNonExistentReadRequestHints; use nullifier_read_request_reset::NullifierReadRequestHints; use private_validation_request_processor::PrivateValidationRequestProcessor; -use read_request_reset::reset_read_requests; +use public_data_read_request_reset::PublicDataReadRequestHints; +use public_validation_request_processor::PublicValidationRequestProcessor; +use types::public_data_hint::PublicDataHint; -mod non_existent_read_request_reset; mod nullifier_non_existent_read_request_reset; mod nullifier_read_request_reset; mod private_validation_request_processor; -mod read_request_reset; +mod public_data_read_request_reset; +mod public_validation_request_processor; +mod reset; mod tests; +mod types; diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_non_existent_read_request_reset.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_non_existent_read_request_reset.nr index cc76145b18e..5f9f7548782 100644 --- a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_non_existent_read_request_reset.nr +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_non_existent_read_request_reset.nr @@ -1,7 +1,7 @@ -use crate::non_existent_read_request_reset::{NonMembershipHint}; +use crate::reset::non_existent_read_request::NonMembershipHint; use dep::types::{ abis::{nullifier_leaf_preimage::NullifierLeafPreimage, side_effect::SideEffectLinkedToNoteHash}, - merkle_tree::{MembershipWitness}, + merkle_tree::MembershipWitness, constants::{MAX_NEW_NULLIFIERS_PER_TX, MAX_NULLIFIER_NON_EXISTENT_READ_REQUESTS_PER_TX, NULLIFIER_TREE_HEIGHT} }; diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_read_request_reset.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_read_request_reset.nr index cb2e0abc875..de2da03dc8c 100644 --- a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_read_request_reset.nr +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/nullifier_read_request_reset.nr @@ -1,5 +1,5 @@ // This will be moved to a separate Read Request Reset Circuit. -use crate::read_request_reset::{PendingReadHint, ReadRequestStatus, ReadValueHint, SettledReadHint}; +use crate::reset::read_request::{PendingReadHint, ReadRequestStatus, ReadValueHint, SettledReadHint}; use dep::types::{ abis::{nullifier_leaf_preimage::NullifierLeafPreimage}, constants::{MAX_NULLIFIER_READ_REQUESTS_PER_TX, NULLIFIER_TREE_HEIGHT}, @@ -44,7 +44,7 @@ struct NullifierReadRequestHints { mod tests { use crate::nullifier_read_request_reset::NullifierSettledReadHint; - use crate::read_request_reset::{PendingReadHint, ReadRequestState, ReadRequestStatus, reset_read_requests}; + use crate::reset::read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus, reset_read_requests}; use dep::types::{ address::AztecAddress, abis::{ diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/private_validation_request_processor.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/private_validation_request_processor.nr index 9f60134dd45..469a4d6d9bf 100644 --- a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/private_validation_request_processor.nr +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/private_validation_request_processor.nr @@ -1,4 +1,4 @@ -use crate::{nullifier_read_request_reset::NullifierReadRequestHints, read_request_reset::reset_read_requests}; +use crate::{nullifier_read_request_reset::NullifierReadRequestHints, reset::read_request::reset_read_requests}; use dep::types::{ abis::{side_effect::{SideEffect, SideEffectLinkedToNoteHash}, validation_requests::ValidationRequests}, constants::{ diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_data_read_request_reset.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_data_read_request_reset.nr new file mode 100644 index 00000000000..7c6b6634074 --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_data_read_request_reset.nr @@ -0,0 +1,9 @@ +use crate::reset::{mutable_data_read_request::LeafDataReadHint, read_request::{PendingReadHint, ReadRequestStatus}}; +use dep::types::constants::MAX_PUBLIC_DATA_READS_PER_TX; + +// The MAX_PUBLIC_DATA_READS_PER_TX for pending_read_hints and leaf_data_read_hints can change if we create various circuits that deal with different number of reads. +struct PublicDataReadRequestHints { + read_request_statuses: [ReadRequestStatus; MAX_PUBLIC_DATA_READS_PER_TX], + pending_read_hints: [PendingReadHint; MAX_PUBLIC_DATA_READS_PER_TX], + leaf_data_read_hints: [LeafDataReadHint; MAX_PUBLIC_DATA_READS_PER_TX], +} diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_validation_request_processor.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_validation_request_processor.nr new file mode 100644 index 00000000000..4a74f99fd5b --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/public_validation_request_processor.nr @@ -0,0 +1,127 @@ +use crate::{ + reset::{ + non_existent_read_request::reset_non_existent_read_requests, + mutable_data_read_request::reset_mutable_data_read_requests, read_request::reset_read_requests +}, + nullifier_read_request_reset::NullifierReadRequestHints, + nullifier_non_existent_read_request_reset::NullifierNonExistentReadRequestHints, + public_data_read_request_reset::PublicDataReadRequestHints, types::public_data_hint::PublicDataHint +}; +use dep::types::{ + abis::{ + kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs, + public_data_update_request::PublicDataUpdateRequest, side_effect::SideEffectLinkedToNoteHash, + validation_requests::ValidationRequests +}, + constants::{MAX_NEW_NULLIFIERS_PER_TX, MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX}, + hash::silo_nullifier, traits::is_empty, + utils::arrays::{array_merge, array_to_bounded_vec, assert_sorted_array} +}; + +struct PublicValidationRequestProcessor { + validation_requests: ValidationRequests, + pending_nullifiers: [SideEffectLinkedToNoteHash; MAX_NEW_NULLIFIERS_PER_TX], + pending_public_data_writes: [PublicDataUpdateRequest; MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX], + nullifier_read_request_hints: NullifierReadRequestHints, + nullifier_non_existent_read_request_hints: NullifierNonExistentReadRequestHints, + nullifier_tree_root: Field, + public_data_read_request_hints: PublicDataReadRequestHints, + public_data_hints: [PublicDataHint; N], +} + +impl PublicValidationRequestProcessor { + pub fn new( + public_inputs: PublicKernelCircuitPublicInputs, + nullifier_read_request_hints: NullifierReadRequestHints, + nullifier_non_existent_read_request_hints: NullifierNonExistentReadRequestHints, + nullifier_tree_root: Field, + public_data_read_request_hints: PublicDataReadRequestHints, + public_data_hints: [PublicDataHint; N] + ) -> Self { + let end_non_revertible = public_inputs.end_non_revertible; + let end = public_inputs.end; + + let pending_nullifiers = array_merge(end_non_revertible.new_nullifiers, end.new_nullifiers); + + let pending_public_data_writes = array_merge( + end_non_revertible.public_data_update_requests, + end.public_data_update_requests + ); + + PublicValidationRequestProcessor { + validation_requests: public_inputs.validation_requests, + pending_nullifiers, + pending_public_data_writes, + nullifier_read_request_hints, + nullifier_non_existent_read_request_hints, + nullifier_tree_root, + public_data_read_request_hints, + public_data_hints + } + } + + pub fn validate(self) { + self.validate_nullifier_read_requests(); + self.validate_nullifier_non_existent_read_requests(); + self.validate_public_data_read_requests(); + } + + fn validate_nullifier_read_requests(self) { + let requests = self.validation_requests.nullifier_read_requests; + let hints = self.nullifier_read_request_hints; + let unverified_nullifier_read_requests = reset_read_requests( + requests, + self.pending_nullifiers, + hints.read_request_statuses, + hints.pending_read_hints, + hints.settled_read_hints, + self.nullifier_tree_root + ); + assert( + unverified_nullifier_read_requests.len() == 0, "All nullifier read requests must be verified" + ); + } + + fn validate_nullifier_non_existent_read_requests(self) { + // The values of the read requests here need to be siloed. + // Notice that it's not the case for regular read requests, which can be run between two kernel iterations, and will to be verified against unsiloed pending values. + let mut read_requests = self.validation_requests.nullifier_non_existent_read_requests; + for i in 0..read_requests.len() { + let read_request = read_requests[i]; + if !is_empty(read_request) { + read_requests[i].value = silo_nullifier(read_request.contract_address, read_request.value); + } + } + + let hints = self.nullifier_non_existent_read_request_hints; + + assert_sorted_array( + self.pending_nullifiers, + hints.sorted_pending_values, + hints.sorted_pending_value_index_hints, + |a: SideEffectLinkedToNoteHash, b: SideEffectLinkedToNoteHash| a.value.lt(b.value) + ); + let sorted_pending_nullifiers = array_to_bounded_vec(hints.sorted_pending_values); + + reset_non_existent_read_requests( + read_requests, + hints.non_membership_hints, + self.nullifier_tree_root, + sorted_pending_nullifiers, + hints.next_pending_value_indices + ); + } + + fn validate_public_data_read_requests(self) { + let hints = self.public_data_read_request_hints; + + reset_mutable_data_read_requests( + self.validation_requests.public_data_reads, + hints.read_request_statuses, + self.pending_public_data_writes, + self.public_data_hints, + hints.pending_read_hints, + hints.leaf_data_read_hints + ); + } +} diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset.nr new file mode 100644 index 00000000000..8b98420b3cd --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset.nr @@ -0,0 +1,3 @@ +mod mutable_data_read_request; +mod non_existent_read_request; +mod read_request; diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/mutable_data_read_request.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/mutable_data_read_request.nr new file mode 100644 index 00000000000..a86ab40f20d --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/mutable_data_read_request.nr @@ -0,0 +1,320 @@ +use crate::reset::read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus}; +use dep::types::{ + abis::{public_data_read::PublicDataRead, public_data_update_request::PublicDataUpdateRequest}, + traits::{Empty, is_empty} +}; + +trait LeafDataHint { + fn leaf_slot(self) -> Field; + fn value(self) -> Field; + fn override_counter(self) -> u32; +} + +struct LeafDataReadHint { + read_request_index: u64, + data_hint_index: u64, +} + +impl LeafDataReadHint { + pub fn nada(read_request_len: u64) -> Self { + LeafDataReadHint { read_request_index: read_request_len, data_hint_index: 0 } + } +} + +fn validate_pending_read_requests( + read_requests: [PublicDataRead; READ_REQUEST_LEN], + data_writes: [PublicDataUpdateRequest; PENDING_VALUE_LEN], + hints: [PendingReadHint; NUM_PENDING_READS] +) { + for i in 0..NUM_PENDING_READS { + let read_request_index = hints[i].read_request_index; + if read_request_index != READ_REQUEST_LEN { + let read_request = read_requests[read_request_index]; + let pending_value = data_writes[hints[i].pending_value_index]; + assert( + read_request.leaf_slot.eq(pending_value.leaf_slot), "Hinted slot of data write does not match read request" + ); + assert( + read_request.value.eq(pending_value.new_value), "Hinted value of data write does not match read request" + ); + // TODO: Add counters and verify the following: + // assert( + // read_request.counter > pending_value.counter, "Read request counter must be greater than the counter of the data write" + // ); + // assert((read_request.counter < pending_value.next_counter) | (pending_value.next_counter == 0), "Read request counter must be less than the counter of the next data write"); + } + } +} + +fn validate_leaf_data_read_requests( + read_requests: [PublicDataRead; READ_REQUEST_LEN], + leaf_data_hints: [H; NUM_LEAF_DATA_HINTS], + hints: [LeafDataReadHint; NUM_LEAF_DATA_READS] +) where H: LeafDataHint { + for i in 0..NUM_LEAF_DATA_READS { + let read_request_index = hints[i].read_request_index; + if read_request_index != READ_REQUEST_LEN { + let read_request = read_requests[read_request_index]; + let data_hint = leaf_data_hints[hints[i].data_hint_index]; + assert( + read_request.leaf_slot == data_hint.leaf_slot(), "Hinted slot does not match read request" + ); + assert(read_request.value == data_hint.value(), "Hinted value does not match read request"); + // TODO: Add counters and verify the following: + // assert((read_request.counter < data_hint.override_counter) | (data_hint.override_counter == 0), "Hinted leaf is overridden before the read request"); + } + } +} + +fn ensure_all_read_requests_are_verified( + read_requests: [PublicDataRead; READ_REQUEST_LEN], + read_request_statuses: [ReadRequestStatus; READ_REQUEST_LEN], + pending_read_hints: [PendingReadHint; NUM_PENDING_READS], + leaf_data_read_hints: [LeafDataReadHint; NUM_LEAF_DATA_READS] +) { + for i in 0..READ_REQUEST_LEN { + let read_request = read_requests[i]; + if !is_empty(read_request) { + let status = read_request_statuses[i]; + if status.state == ReadRequestState.PENDING { + assert( + pending_read_hints[status.hint_index].read_request_index == i, "Hinted pending read request does not match status" + ); + } else if status.state == ReadRequestState.SETTLED { + assert( + leaf_data_read_hints[status.hint_index].read_request_index == i, "Hinted settled read request does not match status" + ); + } else { + assert(false, "Read request status must be PENDING or SETTLED"); + } + } + } +} + +pub fn reset_mutable_data_read_requests( + read_requests: [PublicDataRead; READ_REQUEST_LEN], + read_request_statuses: [ReadRequestStatus; READ_REQUEST_LEN], + data_writes: [PublicDataUpdateRequest; PENDING_VALUE_LEN], + leaf_data_hints: [H; NUM_LEAF_DATA_HINTS], + pending_read_hints: [PendingReadHint; NUM_PENDING_READS], + leaf_data_read_hints: [LeafDataReadHint; NUM_LEAF_DATA_READS] +) where H: LeafDataHint { + validate_pending_read_requests(read_requests, data_writes, pending_read_hints); + + validate_leaf_data_read_requests(read_requests, leaf_data_hints, leaf_data_read_hints); + + ensure_all_read_requests_are_verified( + read_requests, + read_request_statuses, + pending_read_hints, + leaf_data_read_hints + ); +} + +mod tests { + use crate::reset::{ + mutable_data_read_request::{ + ensure_all_read_requests_are_verified, reset_mutable_data_read_requests, LeafDataHint, + LeafDataReadHint, validate_pending_read_requests, validate_leaf_data_read_requests + }, + read_request::{PendingReadHint, ReadRequestState, ReadRequestStatus} + }; + use dep::types::{abis::{public_data_read::PublicDataRead, public_data_update_request::PublicDataUpdateRequest}}; + + struct TestLeafDataHint { + leaf_slot: Field, + value: Field, + } + + impl LeafDataHint for TestLeafDataHint { + fn leaf_slot(self) -> Field { + self.leaf_slot + } + + fn value(self) -> Field { + self.value + } + + fn override_counter(_self: Self) -> u32 { + 0 + } + } + + global data_writes = [ + PublicDataUpdateRequest { leaf_slot: 22, new_value: 200 }, + PublicDataUpdateRequest { leaf_slot: 11, new_value: 100 }, + PublicDataUpdateRequest { leaf_slot: 33, new_value: 300 }, + PublicDataUpdateRequest { leaf_slot: 44, new_value: 400 } + ]; + + global leaf_data_hints = [ + TestLeafDataHint { leaf_slot: 7, value: 70 }, + TestLeafDataHint { leaf_slot: 6, value: 60 }, + TestLeafDataHint { leaf_slot: 5, value: 50 }, + ]; + + fn create_pending_read_requests(data_write_indices: [u64; N]) -> ([PublicDataRead; N], [PendingReadHint; N]) { + let read_requests = data_write_indices.map( + |data_write_index: u64| PublicDataRead { leaf_slot: data_writes[data_write_index].leaf_slot, value: data_writes[data_write_index].new_value } + ); + let mut hints = BoundedVec::new(); + for i in 0..N { + hints.push(PendingReadHint { read_request_index: i, pending_value_index: data_write_indices[i] }); + } + (read_requests, hints.storage) + } + + fn create_leaf_data_read_requests(data_hint_indices: [u64; N]) -> ([PublicDataRead; N], [LeafDataReadHint; N]) { + let read_requests = data_hint_indices.map( + |data_hint_index: u64| PublicDataRead { leaf_slot: leaf_data_hints[data_hint_index].leaf_slot, value: leaf_data_hints[data_hint_index].value } + ); + let mut hints = BoundedVec::new(); + for i in 0..N { + hints.push(LeafDataReadHint { read_request_index: i, data_hint_index: data_hint_indices[i] }); + } + (read_requests, hints.storage) + } + + #[test] + fn reset_pending_reads_succeeds() { + let (read_requests, hints) = create_pending_read_requests([2, 0, 1, 3]); + validate_pending_read_requests(read_requests, data_writes, hints); + } + + #[test] + fn reset_pending_reads_repeated_values() { + let (read_requests, hints) = create_pending_read_requests([1, 0, 0, 1]); + validate_pending_read_requests(read_requests, data_writes, hints); + } + + #[test] + fn reset_pending_reads_skips_nada() { + let read_requests = [PublicDataRead { leaf_slot: 88, value: 9999 }]; + let hints = [PendingReadHint::nada(1)]; + validate_pending_read_requests(read_requests, data_writes, hints); + } + + #[test(should_fail_with="Hinted slot of data write does not match read request")] + fn reset_pending_reads_wrong_slot_fails() { + let mut (read_requests, hints) = create_pending_read_requests([1]); + hints[0].pending_value_index = 0; + validate_pending_read_requests(read_requests, data_writes, hints); + } + + #[test(should_fail_with="Hinted value of data write does not match read request")] + fn reset_pending_reads_wrong_value_fails() { + let mut (read_requests, hints) = create_pending_read_requests([1]); + read_requests[0].value += 1; + validate_pending_read_requests(read_requests, data_writes, hints); + } + + #[test] + fn reset_leaf_data_reads_succeeds() { + let (read_requests, hints) = create_leaf_data_read_requests([2, 1, 0]); + validate_leaf_data_read_requests(read_requests, leaf_data_hints, hints); + } + + #[test] + fn reset_leaf_data_reads_repeated_values() { + let (read_requests, hints) = create_leaf_data_read_requests([1, 0, 1, 0]); + validate_leaf_data_read_requests(read_requests, leaf_data_hints, hints); + } + + #[test] + fn reset_leaf_data_reads_skips_nada() { + let read_requests = [PublicDataRead { leaf_slot: 88, value: 9999 }]; + let hints = [LeafDataReadHint::nada(1)]; + validate_leaf_data_read_requests(read_requests, leaf_data_hints, hints); + } + + #[test(should_fail_with=""Hinted slot does not match read request")] + fn reset_leaf_reads_wrong_slot_fails() { + let mut (read_requests, hints) = create_leaf_data_read_requests([1]); + hints[0].data_hint_index = 0; + validate_leaf_data_read_requests(read_requests, leaf_data_hints, hints); + } + + #[test(should_fail_with=""Hinted value does not match read request")] + fn reset_leaf_reads_wrong_value_fails() { + let mut (read_requests, hints) = create_leaf_data_read_requests([1]); + read_requests[0].value += 1; + validate_leaf_data_read_requests(read_requests, leaf_data_hints, hints); + } + + #[test] + fn ensure_all_read_requests_are_verified_succeeds() { + let mut (pending_read_requests, pending_read_hints) = create_pending_read_requests([1]); + let mut (leaf_read_requests, leaf_data_read_hints) = create_leaf_data_read_requests([0, 1]); + let read_requests = [leaf_read_requests[0], pending_read_requests[0], leaf_read_requests[1]]; + pending_read_hints[0].read_request_index = 1; + leaf_data_read_hints[1].read_request_index = 2; + + let statuses = [ + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.PENDING, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 1 } + ]; + + ensure_all_read_requests_are_verified( + read_requests, + statuses, + pending_read_hints, + leaf_data_read_hints + ); + } + + #[test(should_fail_with="Hinted pending read request does not match status")] + fn ensure_all_read_requests_are_verified_wrong_pending_hint_index_fails() { + let (read_requests, hints) = create_pending_read_requests([0, 1]); + let statuses = [ + ReadRequestStatus { state: ReadRequestState.PENDING, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.PENDING, hint_index: 0 } + ]; + ensure_all_read_requests_are_verified(read_requests, statuses, hints, []); + } + + #[test(should_fail_with="Hinted settled read request does not match status")] + fn ensure_all_read_requests_are_verified_wrong_leaf_hint_index_fails() { + let (read_requests, hints) = create_leaf_data_read_requests([0, 1]); + let statuses = [ + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 0 } + ]; + ensure_all_read_requests_are_verified(read_requests, statuses, [], hints); + } + + #[test(should_fail_with="Read request status must be PENDING or SETTLED")] + fn ensure_all_read_requests_are_verified_wrong_status_fails() { + let (read_requests, hints) = create_leaf_data_read_requests([0]); + let statuses = [ReadRequestStatus { state: ReadRequestState.NADA, hint_index: 0 }]; + ensure_all_read_requests_are_verified(read_requests, statuses, [], hints); + } + + #[test] + fn reset_mutable_data_read_requests_succeeds() { + let mut (pending_read_requests, pending_read_hints) = create_pending_read_requests([3, 1]); + let mut (leaf_read_requests, leaf_data_read_hints) = create_leaf_data_read_requests([0, 1]); + let read_requests = [ + leaf_read_requests[0], pending_read_requests[0], pending_read_requests[1], leaf_read_requests[1] + ]; + pending_read_hints[0].read_request_index = 1; + pending_read_hints[1].read_request_index = 2; + leaf_data_read_hints[1].read_request_index = 3; + + let statuses = [ + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.PENDING, hint_index: 0 }, + ReadRequestStatus { state: ReadRequestState.PENDING, hint_index: 1 }, + ReadRequestStatus { state: ReadRequestState.SETTLED, hint_index: 1 } + ]; + + reset_mutable_data_read_requests( + read_requests, + statuses, + data_writes, + leaf_data_hints, + pending_read_hints, + leaf_data_read_hints + ); + } +} diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/non_existent_read_request_reset.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/non_existent_read_request.nr similarity index 94% rename from noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/non_existent_read_request_reset.nr rename to noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/non_existent_read_request.nr index 4beeee665ae..afb50e68ce5 100644 --- a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/non_existent_read_request_reset.nr +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/reset/non_existent_read_request.nr @@ -86,7 +86,7 @@ pub fn reset_non_existent_read_requests, + leaf_data_read_hints: BoundedVec, +} + +impl PublicDataReadRequestHintsBuilder { + pub fn new(read_request_len: u64) -> Self { + PublicDataReadRequestHintsBuilder { + read_request_statuses: [ReadRequestStatus::empty(); MAX_PUBLIC_DATA_READS_PER_TX], + pending_read_hints: BoundedVec { storage: [PendingReadHint::nada(read_request_len); MAX_PUBLIC_DATA_READS_PER_TX], len: 0 }, + leaf_data_read_hints: BoundedVec { storage: [LeafDataReadHint::nada(read_request_len); MAX_PUBLIC_DATA_READS_PER_TX], len: 0 } + } + } + + pub fn to_hints(self) -> PublicDataReadRequestHints { + PublicDataReadRequestHints { + read_request_statuses: self.read_request_statuses, + pending_read_hints: self.pending_read_hints.storage, + leaf_data_read_hints: self.leaf_data_read_hints.storage + } + } +} diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types.nr new file mode 100644 index 00000000000..aa16f1fe678 --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types.nr @@ -0,0 +1 @@ +mod public_data_hint; diff --git a/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types/public_data_hint.nr b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types/public_data_hint.nr new file mode 100644 index 00000000000..28a3eb74cb0 --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/reset-kernel-lib/src/types/public_data_hint.nr @@ -0,0 +1,27 @@ +use crate::reset::{mutable_data_read_request::LeafDataHint}; +use dep::types::{ + abis::membership_witness::PublicDataMembershipWitness, + public_data_tree_leaf_preimage::PublicDataTreeLeafPreimage +}; + +struct PublicDataHint { + leaf_slot: Field, + value: Field, + override_counter: u32, + membership_witness: PublicDataMembershipWitness, // Should be MembershipWitness when we can handle generics when converting to ts types. + leaf_preimage: PublicDataTreeLeafPreimage, +} + +impl LeafDataHint for PublicDataHint { + fn leaf_slot(self) -> Field { + self.leaf_slot + } + + fn value(self) -> Field { + self.value + } + + fn override_counter(self) -> u32 { + self.override_counter + } +} diff --git a/noir-projects/noir-protocol-circuits/crates/rollup-lib/src/base/base_rollup_inputs.nr b/noir-projects/noir-protocol-circuits/crates/rollup-lib/src/base/base_rollup_inputs.nr index a9e9e772f59..db3a8cddfb0 100644 --- a/noir-projects/noir-protocol-circuits/crates/rollup-lib/src/base/base_rollup_inputs.nr +++ b/noir-projects/noir-protocol-circuits/crates/rollup-lib/src/base/base_rollup_inputs.nr @@ -29,7 +29,7 @@ use dep::types::{ }, mocked::{AggregationObject, Proof}, partial_state_reference::PartialStateReference, public_data_tree_leaf::PublicDataTreeLeaf, - public_data_tree_leaf_preimage::PublicDataTreeLeafPreimage, + public_data_tree_leaf_preimage::PublicDataTreeLeafPreimage, traits::is_empty, utils::{field::{full_field_less_than, full_field_greater_than}, uint256::U256} }; @@ -66,6 +66,8 @@ impl BaseRollupInputs { == self.constants.global_variables.version, "kernel version does not match the rollup version" ); + self.validate_kernel_start_state(); + let rollup_validation_requests = self.kernel_data.public_inputs.rollup_validation_requests; // Verify the max block number @@ -177,18 +179,22 @@ impl BaseRollupInputs { calculate_subtree_root(leaves.map(|leaf:NullifierLeafPreimage| leaf.hash())) } - fn validate_and_process_public_state(self) -> AppendOnlyTreeSnapshot { - // TODO(#2521) - data read validation should happen against the current state of the tx and not the start state. - // Blocks all interesting usecases that read and write to the same public state in the same tx. - // https://aztecprotocol.slack.com/archives/C02M7VC7TN0/p1695809629015719?thread_ts=1695653252.007339&cid=C02M7VC7TN0 - - // Process public data reads and public data update requests for left input - // validate_public_data_reads( - // self.start_public_data_tree_root, - // self.kernel_data[0].public_inputs.end.public_data_reads, - // 0, - // self.new_public_data_reads_sibling_paths); + fn validate_kernel_start_state(self) { + let kernel_state = self.kernel_data.public_inputs.start_state; + if !is_empty(kernel_state) { + assert( + kernel_state.note_hash_tree.eq(self.start.note_hash_tree), "Mismatch start state for note hash tree" + ); + assert( + kernel_state.nullifier_tree.eq(self.start.nullifier_tree), "Mismatch start state for nullifier tree" + ); + assert( + kernel_state.public_data_tree.eq(self.start.public_data_tree), "Mismatch start state for public data tree" + ); + } + } + fn validate_and_process_public_state(self) -> AppendOnlyTreeSnapshot { let end_public_data_tree_snapshot = insert_public_data_update_requests( self.start.public_data_tree, self.kernel_data.public_inputs.end.public_data_update_requests.map( @@ -318,43 +324,6 @@ fn insert_public_data_update_requests( ) } -fn validate_public_data_reads( - tree_root: Field, - public_data_reads: [PublicDataRead; MAX_PUBLIC_DATA_READS_PER_TX], - public_data_reads_preimages: [PublicDataTreeLeafPreimage; MAX_PUBLIC_DATA_READS_PER_TX], - public_data_reads_witnesses: [PublicDataMembershipWitness; MAX_PUBLIC_DATA_READS_PER_TX] -) { - for i in 0..MAX_PUBLIC_DATA_READS_PER_TX { - let read = public_data_reads[i]; - let low_preimage = public_data_reads_preimages[i]; - let witness = public_data_reads_witnesses[i]; - - let is_low_empty = low_preimage.is_empty(); - let is_exact = low_preimage.slot == read.leaf_slot; - - let is_less_than_slot = full_field_less_than(low_preimage.slot, read.leaf_slot); - let is_next_greater_than = full_field_less_than(read.leaf_slot, low_preimage.next_slot); - let is_in_range = is_less_than_slot - & (is_next_greater_than | ((low_preimage.next_index == 0) & (low_preimage.next_slot == 0))); - - if (!read.is_empty()) { - assert(!is_low_empty, "public data read is not empty but low preimage is empty"); - if is_in_range { - assert_eq(read.value, 0, "low leaf for public data read is in range but value is not zero"); - } else { - assert(is_exact, "low leaf for public data read is invalid"); - assert_eq(read.value, low_preimage.value, "low leaf for public data has different value"); - } - assert_check_membership( - low_preimage.hash(), - witness.leaf_index, - witness.sibling_path, - tree_root - ); - } - } -} - #[test] fn consistent_not_hash_subtree_width() { assert_eq( diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr index 93f148a675a..9cb5a03c9c5 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/accumulated_data/combined_accumulated_data.nr @@ -30,7 +30,7 @@ struct CombinedAccumulatedData { } impl CombinedAccumulatedData { - pub fn recombine(non_revertible: PublicAccumulatedData, revertible: PublicAccumulatedData) -> Self { + pub fn combine(non_revertible: PublicAccumulatedData, revertible: PublicAccumulatedData) -> Self { CombinedAccumulatedData { new_note_hashes: array_merge(non_revertible.new_note_hashes, revertible.new_note_hashes).map(|n: SideEffect| n.value), new_nullifiers: array_merge(non_revertible.new_nullifiers, revertible.new_nullifiers).map(|n: SideEffectLinkedToNoteHash| n.value), diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/kernel_circuit_public_inputs.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/kernel_circuit_public_inputs.nr index b15b68d2365..41100691cbc 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/kernel_circuit_public_inputs.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/kernel_circuit_public_inputs.nr @@ -1,6 +1,9 @@ -use crate::abis::{ +use crate::{ + abis::{ accumulated_data::CombinedAccumulatedData, combined_constant_data::CombinedConstantData, validation_requests::RollupValidationRequests +}, + partial_state_reference::PartialStateReference }; use crate::mocked::AggregationObject; @@ -9,5 +12,6 @@ struct KernelCircuitPublicInputs { rollup_validation_requests: RollupValidationRequests, end: CombinedAccumulatedData, constants: CombinedConstantData, + start_state: PartialStateReference, revert_code: u8, } diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/private_kernel_circuit_public_inputs_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/private_kernel_circuit_public_inputs_builder.nr index 5aa04bfc44f..b4fc5217621 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/private_kernel_circuit_public_inputs_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/private_kernel_circuit_public_inputs_builder.nr @@ -8,8 +8,7 @@ use crate::{ }, validation_requests::validation_requests_builder::ValidationRequestsBuilder }, -mocked::AggregationObject, -traits::Empty + mocked::AggregationObject, partial_state_reference::PartialStateReference, traits::Empty }; struct PrivateKernelCircuitPublicInputsBuilder { @@ -37,6 +36,7 @@ impl PrivateKernelCircuitPublicInputsBuilder { rollup_validation_requests: self.validation_requests.to_rollup(), end: self.end.to_combined(), constants: self.constants, + start_state: PartialStateReference::empty(), revert_code: 0 } } @@ -65,4 +65,4 @@ impl Empty for PrivateKernelCircuitPublicInputsBuilder { constants: CombinedConstantData::empty(), } } -} \ No newline at end of file +} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/public_kernel_circuit_public_inputs_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/public_kernel_circuit_public_inputs_builder.nr index 6d3dc6fefc4..5a0ff151e9b 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/public_kernel_circuit_public_inputs_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/abis/kernel_circuit_public_inputs/public_kernel_circuit_public_inputs_builder.nr @@ -2,14 +2,10 @@ use crate::{ abis::{ accumulated_data::{CombinedAccumulatedData, PublicAccumulatedDataBuilder}, combined_constant_data::CombinedConstantData, - kernel_circuit_public_inputs::{ - kernel_circuit_public_inputs::KernelCircuitPublicInputs, - public_kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs -}, + kernel_circuit_public_inputs::{public_kernel_circuit_public_inputs::PublicKernelCircuitPublicInputs}, validation_requests::ValidationRequestsBuilder }, -mocked::AggregationObject, -traits::Empty + mocked::AggregationObject, traits::Empty }; struct PublicKernelCircuitPublicInputsBuilder { @@ -35,17 +31,6 @@ impl PublicKernelCircuitPublicInputsBuilder { revert_code: self.revert_code } } - - pub fn finish_tail(self) -> KernelCircuitPublicInputs { - KernelCircuitPublicInputs { - aggregation_object: self.aggregation_object, - rollup_validation_requests: self.validation_requests.to_rollup(), - // TODO: Sort by counters. - end: CombinedAccumulatedData::recombine(self.end_non_revertible.finish(), self.end.finish()), - constants: self.constants, - revert_code: self.revert_code - } - } } impl Empty for PublicKernelCircuitPublicInputsBuilder { @@ -59,4 +44,4 @@ impl Empty for PublicKernelCircuitPublicInputsBuilder { revert_code: 0 as u8, } } -} \ No newline at end of file +} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr index c4b67523bc6..fb60b1b479d 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr @@ -50,6 +50,9 @@ global NUM_ENCRYPTED_LOGS_HASHES_PER_TX: u64 = 1; global NUM_UNENCRYPTED_LOGS_HASHES_PER_TX: u64 = 1; // docs:end:constants +// KERNEL CIRCUIT PRIVATE INPUTS CONSTANTS +global MAX_PUBLIC_DATA_HINTS: u64 = 64; // MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX + MAX_PUBLIC_DATA_READS_PER_TX; + // ROLLUP CONTRACT CONSTANTS - constants used only in l1-contracts global NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP: u64 = 16; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree.nr b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree.nr index 67b23d3f449..9ef29b02628 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree.nr @@ -7,8 +7,8 @@ mod root; use leaf_preimage::{IndexedTreeLeafPreimage, LeafPreimage}; use membership::{ - assert_check_membership, assert_check_non_membership, check_membership, check_non_membership, - MembershipWitness + assert_check_membership, assert_check_non_membership, check_membership, + conditionally_assert_check_membership, MembershipWitness }; use merkle_tree::MerkleTree; use root::{calculate_empty_tree_root, calculate_subtree_root, root_from_sibling_path}; diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree.nr b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree.nr index bd8d3d1b482..28d880c9891 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree.nr @@ -1,3 +1,5 @@ +mod check_valid_low_leaf; + use crate::{ abis::{append_only_tree_snapshot::AppendOnlyTreeSnapshot}, merkle_tree::{ diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree/check_valid_low_leaf.nr b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree/check_valid_low_leaf.nr new file mode 100644 index 00000000000..01b4136bded --- /dev/null +++ b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/indexed_tree/check_valid_low_leaf.nr @@ -0,0 +1,78 @@ +use crate::merkle_tree::leaf_preimage::IndexedTreeLeafPreimage; + +pub fn assert_check_valid_low_leaf( + key: Field, + low_leaf_preimage: LEAF_PREIMAGE +) where LEAF_PREIMAGE: IndexedTreeLeafPreimage { + let low_key = low_leaf_preimage.get_key(); + let next_key = low_leaf_preimage.get_next_key(); + + assert(low_key.lt(key), "Key is not greater than the low leaf"); + assert(key.lt(next_key) | (next_key == 0), "Key is not less than the next leaf"); +} + +mod tests { + use crate::{ + merkle_tree::{ + leaf_preimage::IndexedTreeLeafPreimage, + indexed_tree::check_valid_low_leaf::assert_check_valid_low_leaf + } + }; + + struct TestLeafPreimage { + value: Field, + next_value: Field, + } + + impl IndexedTreeLeafPreimage for TestLeafPreimage { + fn get_key(self) -> Field { + self.value + } + + fn get_next_key(self) -> Field { + self.next_value + } + + fn as_leaf(self) -> Field { + self.value + } + } + + #[test] + fn test_assert_check_valid_low_leaf() { + let key = 12; + let leaf = TestLeafPreimage { value: 11, next_value: 13 }; + assert_check_valid_low_leaf(key, leaf); + } + + #[test] + fn test_assert_check_empty_low_leaf() { + // An all-zero low leaf should be valid. It could be used as the first dummy leaf in a tree. + // It's not possible to prove against an empty leaf at an uninitialized index. + // The membership check will fail because the leaf value hash(0, 0) is not 0. + let key = 12; + let leaf = TestLeafPreimage { value: 0, next_value: 0 }; + assert_check_valid_low_leaf(key, leaf); + } + + #[test(should_fail_with="Key is not greater than the low leaf")] + fn test_assert_check_valid_low_leaf_failed_wrong_low_leaf() { + let key = 12; + let leaf = TestLeafPreimage { value: 13, next_value: 15 }; + assert_check_valid_low_leaf(key, leaf); + } + + #[test(should_fail_with="Key is not greater than the low leaf")] + fn test_assert_check_valid_low_leaf_failed_is_low_leaf() { + let key = 12; + let leaf = TestLeafPreimage { value: 12, next_value: 15 }; + assert_check_valid_low_leaf(key, leaf); + } + + #[test(should_fail_with="Key is not less than the next leaf")] + fn test_assert_check_valid_low_leaf_failed_wrong_next_key() { + let key = 12; + let leaf = TestLeafPreimage { value: 9, next_value: 11 }; + assert_check_valid_low_leaf(key, leaf); + } +} diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/membership.nr b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/membership.nr index d7847467dc1..d549f269984 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/membership.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/merkle_tree/membership.nr @@ -1,4 +1,10 @@ -use crate::{merkle_tree::{leaf_preimage::IndexedTreeLeafPreimage, root::root_from_sibling_path}, traits::Empty}; +use crate::{ + merkle_tree::{ + leaf_preimage::IndexedTreeLeafPreimage, + indexed_tree::check_valid_low_leaf::assert_check_valid_low_leaf, root::root_from_sibling_path +}, + traits::Empty +}; struct MembershipWitness { leaf_index: Field, @@ -19,36 +25,18 @@ pub fn check_membership(leaf: Field, index: Field, sibling_path: [Field; N], calculated_root == root } -pub fn assert_check_membership(leaf: Field, index: Field, sibling_path: [Field; N], root: Field) { +pub fn assert_check_membership(leaf: Field, index: Field, sibling_path: [Field; TREE_HEIGHT], root: Field) { assert(check_membership(leaf, index, sibling_path, root), "membership check failed"); } -struct NonMembershipCheckErrorCodeEnum { - NADA: u64, - IS_EMPTY: u64, - NOT_EXISTS: u64, - NOT_GREATER_THAN_LOW: u64, - NOT_LESS_THAN_NEXT: u64, -} - -global NonMembershipCheckErrorCode = NonMembershipCheckErrorCodeEnum { - NADA: 0, - IS_EMPTY: 1, - NOT_EXISTS: 2, - NOT_GREATER_THAN_LOW: 3, - NOT_LESS_THAN_NEXT: 4, -}; - -fn check_non_membership_internal( +pub fn assert_check_non_membership( key: Field, low_leaf_preimage: LEAF_PREIMAGE, low_leaf_membership_witness: MembershipWitness, tree_root: Field -) -> u64 where +) where LEAF_PREIMAGE: IndexedTreeLeafPreimage { - let low_key = low_leaf_preimage.get_key(); - let next_key = low_leaf_preimage.get_next_key(); - let is_empty_leaf = (low_key == 0) & (next_key == 0); + assert_check_valid_low_leaf(key, low_leaf_preimage); let low_leaf_exists = check_membership( low_leaf_preimage.as_leaf(), @@ -56,52 +44,31 @@ fn check_non_membership_internal( low_leaf_membership_witness.sibling_path, tree_root ); - - if is_empty_leaf { - NonMembershipCheckErrorCode.IS_EMPTY - } else if !low_leaf_exists { - NonMembershipCheckErrorCode.NOT_EXISTS - } else if !low_key.lt(key) { - NonMembershipCheckErrorCode.NOT_GREATER_THAN_LOW - } else if !key.lt(next_key) & (next_key != 0) { - NonMembershipCheckErrorCode.NOT_LESS_THAN_NEXT - } else { - NonMembershipCheckErrorCode.NADA - } + assert(low_leaf_exists, "Low leaf does not exist"); } -pub fn check_non_membership( +// Prove either membership or non-membership depending on the value of `exists`. +// If `exists` == false, `key` is not in the tree, `leaf_preimage` and `membership_witness` are for the low leaf. +pub fn conditionally_assert_check_membership( key: Field, - low_leaf_preimage: LEAF_PREIMAGE, - low_leaf_membership_witness: MembershipWitness, - tree_root: Field -) -> bool where - LEAF_PREIMAGE: IndexedTreeLeafPreimage { - let error = check_non_membership_internal(key, low_leaf_preimage, low_leaf_membership_witness, tree_root); - error == NonMembershipCheckErrorCode.NADA -} - -pub fn assert_check_non_membership( - key: Field, - low_leaf_preimage: LEAF_PREIMAGE, - low_leaf_membership_witness: MembershipWitness, + exists: bool, + leaf_preimage: LEAF_PREIMAGE, + membership_witness: MembershipWitness, tree_root: Field ) where LEAF_PREIMAGE: IndexedTreeLeafPreimage { - let error = check_non_membership_internal(key, low_leaf_preimage, low_leaf_membership_witness, tree_root); - if error != NonMembershipCheckErrorCode.NADA { - assert( - error != NonMembershipCheckErrorCode.IS_EMPTY, "Cannot check non membership against empty leaf" - ); - assert(error != NonMembershipCheckErrorCode.NOT_EXISTS, "Low leaf does not exist"); - assert( - error != NonMembershipCheckErrorCode.NOT_GREATER_THAN_LOW, "Key is not greater than the low leaf" - ); - assert( - error != NonMembershipCheckErrorCode.NOT_LESS_THAN_NEXT, "Key is not less than the next leaf" - ); - assert(false, "Unknown error"); + if exists { + assert(key == leaf_preimage.get_key(), "Key does not match the key of the leaf preimage"); + } else { + assert_check_valid_low_leaf(key, leaf_preimage); } + + assert_check_membership( + leaf_preimage.as_leaf(), + membership_witness.leaf_index, + membership_witness.sibling_path, + tree_root + ); } mod tests { @@ -109,8 +76,8 @@ mod tests { merkle_tree::{ leaf_preimage::{IndexedTreeLeafPreimage, LeafPreimage}, membership::{ - assert_check_membership, assert_check_non_membership, check_membership, check_non_membership, - MembershipWitness + assert_check_membership, assert_check_non_membership, check_membership, + conditionally_assert_check_membership, MembershipWitness } }, tests::merkle_tree_utils::NonEmptyMerkleTree @@ -186,7 +153,7 @@ mod tests { ); } - fn check_non_membership_at_index(low_leaf_index: u64, leaf: Field) -> bool { + fn assert_check_non_membership_at_index(low_leaf_index: u64, key: Field) { let tree = build_tree(); let tree_root = tree.get_root(); let leaf_preimage = if low_leaf_index < leaf_preimages.len() { @@ -195,15 +162,15 @@ mod tests { TestLeafPreimage { value: 0, next_value: 0 } }; - check_non_membership( - leaf, + assert_check_non_membership( + key, leaf_preimage, MembershipWitness { leaf_index: low_leaf_index as Field, sibling_path: tree.get_sibling_path(low_leaf_index) } , tree_root - ) + ); } - fn assert_check_non_membership_at_index(low_leaf_index: u64, leaf: Field) { + fn conditionally_assert_check_membership_at_index(exists: bool, low_leaf_index: u64, key: Field) { let tree = build_tree(); let tree_root = tree.get_root(); let leaf_preimage = if low_leaf_index < leaf_preimages.len() { @@ -212,8 +179,9 @@ mod tests { TestLeafPreimage { value: 0, next_value: 0 } }; - assert_check_non_membership( - leaf, + conditionally_assert_check_membership( + key, + exists, leaf_preimage, MembershipWitness { leaf_index: low_leaf_index as Field, sibling_path: tree.get_sibling_path(low_leaf_index) } , tree_root @@ -270,80 +238,89 @@ mod tests { ); } - #[test] - fn test_check_non_membership() { - assert_eq(check_non_membership_at_index(0, 25), true); - } - #[test] fn test_assert_check_non_membership() { assert_check_non_membership_at_index(0, 25); } - #[test] - fn test_check_non_membership_greater_than_max() { - assert_eq(check_non_membership_at_index(1, 45), true); - } - #[test] fn test_assert_check_non_membership_greater_than_max() { assert_check_non_membership_at_index(1, 45); } - #[test] - fn test_check_non_membership_false_empty_leaf() { - assert_eq(check_non_membership_at_index(4, 25), false); + #[test(should_fail_with="Key is not greater than the low leaf")] + fn test_assert_check_non_membership_failed_wrong_low_leaf() { + assert_check_non_membership_at_index(3, 25); } - #[test(should_fail_with="Cannot check non membership against empty leaf")] - fn test_assert_check_non_membership_failed_empty_leaf() { - assert_check_non_membership_at_index(4, 25); + #[test(should_fail_with="Key is not less than the next leaf")] + fn test_assert_check_non_membership_failed_wrong_next_key() { + assert_check_non_membership_at_index(2, 25); } - #[test] - fn test_check_non_membership_false_wrong_low_leaf() { - assert_eq(check_non_membership_at_index(3, 25), false); + #[test(should_fail_with="Low leaf does not exist")] + fn test_assert_check_non_membership_failed_invalid_leaf() { + let tree = build_tree(); + let tree_root = tree.get_root(); + + let fake_leaf = TestLeafPreimage { value: 50, next_value: 60 }; + assert_check_non_membership( + 55, + fake_leaf, + MembershipWitness { leaf_index: 1, sibling_path: tree.get_sibling_path(1) } , + tree_root + ); } - #[test(should_fail_with="Key is not greater than the low leaf")] - fn test_assert_check_non_membership_failed_wrong_low_leaf() { - assert_check_non_membership_at_index(3, 25); + #[test] + fn test_conditionally_assert_check_membership_exists() { + conditionally_assert_check_membership_at_index(true, 1, leaf_preimages[1].get_key()); } #[test] - fn test_check_non_membership_false_wrong_next_key() { - assert_eq(check_non_membership_at_index(2, 25), false); + fn test_conditionally_assert_check_membership_not_exists() { + conditionally_assert_check_membership_at_index(false, 1, leaf_preimages[1].get_key() + 1); + } + + #[test(should_fail_with="Key does not match the key of the leaf preimage")] + fn test_conditionally_assert_check_membership_exists_value_mismatch() { + conditionally_assert_check_membership_at_index(true, 1, leaf_preimages[1].get_key() + 1); + } + + #[test(should_fail_with="Key is not greater than the low leaf")] + fn test_conditionally_assert_check_membership_failed_not_exists_wrong_low_leaf() { + conditionally_assert_check_membership_at_index(false, 3, 25); } #[test(should_fail_with="Key is not less than the next leaf")] - fn test_assert_check_non_membership_failed_wrong_next_key() { - assert_check_non_membership_at_index(2, 25); + fn test_conditionally_assert_check_membership_failed_not_exists_wrong_next_key() { + conditionally_assert_check_membership_at_index(false, 2, 25); } - #[test] - fn test_check_non_membership_false_invalid_leaf() { + #[test(should_fail_with="membership check failed")] + fn test_conditionally_assert_check_membership_failed_exists_invalid_leaf() { let tree = build_tree(); let tree_root = tree.get_root(); - let fake_leaf = TestLeafPreimage { value: 50, next_value: 60 }; - assert_eq( - check_non_membership( - 55, - fake_leaf, - MembershipWitness { leaf_index: 1, sibling_path: tree.get_sibling_path(1) } , - tree_root - ), false + let exists = true; + conditionally_assert_check_membership( + 50, + exists, + fake_leaf, + MembershipWitness { leaf_index: 1, sibling_path: tree.get_sibling_path(1) } , + tree_root ); } - #[test(should_fail_with="Low leaf does not exist")] - fn test_assert_check_non_membership_failed_invalid_leaf() { + #[test(should_fail_with="membership check failed")] + fn test_conditionally_assert_check_membership_failed_not_exists_invalid_leaf() { let tree = build_tree(); let tree_root = tree.get_root(); - let fake_leaf = TestLeafPreimage { value: 50, next_value: 60 }; - assert_check_non_membership( + let exists = false; + conditionally_assert_check_membership( 55, + exists, fake_leaf, MembershipWitness { leaf_index: 1, sibling_path: tree.get_sibling_path(1) } , tree_root diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/public_data_tree_leaf_preimage.nr b/noir-projects/noir-protocol-circuits/crates/types/src/public_data_tree_leaf_preimage.nr index dcc84fe7026..992bbdecd18 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/public_data_tree_leaf_preimage.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/public_data_tree_leaf_preimage.nr @@ -1,4 +1,4 @@ -use crate::traits::{Empty, Hash}; +use crate::{merkle_tree::leaf_preimage::IndexedTreeLeafPreimage, traits::{Empty, Hash}}; struct PublicDataTreeLeafPreimage { slot : Field, @@ -28,6 +28,20 @@ impl Hash for PublicDataTreeLeafPreimage { } } +impl IndexedTreeLeafPreimage for PublicDataTreeLeafPreimage { + fn get_key(self) -> Field { + self.slot + } + + fn get_next_key(self) -> Field { + self.next_slot + } + + fn as_leaf(self) -> Field { + self.hash() + } +} + impl PublicDataTreeLeafPreimage { pub fn is_empty(self) -> bool { (self.slot == 0) & (self.value == 0) & (self.next_slot == 0) & (self.next_index == 0) diff --git a/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr b/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr index 9c6a861edde..45dd91dab7e 100644 --- a/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr +++ b/noir-projects/noir-protocol-circuits/crates/types/src/tests/fixture_builder.nr @@ -24,7 +24,8 @@ use crate::{ VK_TREE_HEIGHT }, hash::silo_nullifier, header::Header, mocked::{AggregationObject, Proof, VerificationKey}, - tests::fixtures, transaction::tx_context::TxContext, traits::Empty + partial_state_reference::PartialStateReference, tests::fixtures, transaction::tx_context::TxContext, + traits::Empty }; struct FixtureBuilder { @@ -67,6 +68,9 @@ struct FixtureBuilder { // Counters. min_revertible_side_effect_counter: u32, counter: u32, + + // States. + start_state: PartialStateReference, } impl FixtureBuilder { @@ -101,6 +105,7 @@ impl FixtureBuilder { revert_code: 0, min_revertible_side_effect_counter: 0, counter: 0, + start_state: PartialStateReference::empty(), gas_used: Gas::empty(), gas_settings: GasSettings::empty() } @@ -231,6 +236,7 @@ impl FixtureBuilder { rollup_validation_requests, end, constants, + start_state: self.start_state, revert_code: self.revert_code } } @@ -267,17 +273,21 @@ impl FixtureBuilder { } } + pub fn add_public_data_update_request(&mut self, leaf_slot: Field, value: Field) { + let update_request = PublicDataUpdateRequest { leaf_slot, new_value: value }; + self.public_data_update_requests.push(update_request); + } + pub fn append_public_data_update_requests(&mut self, num_updates: u64) { let value_offset = self.public_data_update_requests.len(); for i in 0..MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX { if i < num_updates { - let update_request = PublicDataUpdateRequest { - // The default leaf index is its index + 23. - leaf_slot: (value_offset + i + 23) as Field, - // The default value is its index + 678. - new_value: (value_offset + i + 678) as Field - }; - self.public_data_update_requests.push(update_request); + // The default leaf index is its index + 23. + // The default value is its index + 678. + self.add_public_data_update_request( + (value_offset + i + 23) as Field, + (value_offset + i + 678) as Field + ); } } } @@ -326,6 +336,14 @@ impl FixtureBuilder { self.nullifier_non_existent_read_requests.push(read_request); } + pub fn add_read_request_for_pending_public_data(&mut self, public_date_update_request_index: u64) -> u64 { + let new_read_request_index = self.public_data_reads.len(); + let public_write = self.public_data_update_requests.get(public_date_update_request_index); + let read_request = PublicDataRead { leaf_slot: public_write.leaf_slot, value: public_write.new_value }; + self.public_data_reads.push(read_request); + new_read_request_index + } + pub fn set_encrypted_logs(&mut self, hash: Field, preimages_length: Field) { self.encrypted_logs_hash = hash; self.encrypted_log_preimages_length = preimages_length; @@ -419,6 +437,7 @@ impl Empty for FixtureBuilder { revert_code: 0, min_revertible_side_effect_counter: 0, counter: 0, + start_state: PartialStateReference::empty(), gas_settings: GasSettings::empty(), gas_used: Gas::empty(), } diff --git a/yarn-project/circuit-types/src/mocks.ts b/yarn-project/circuit-types/src/mocks.ts index 73d0ccf6317..1995f18365c 100644 --- a/yarn-project/circuit-types/src/mocks.ts +++ b/yarn-project/circuit-types/src/mocks.ts @@ -6,6 +6,7 @@ import { PartialPrivateTailPublicInputsForPublic, PrivateKernelTailCircuitPublicInputs, Proof, + type PublicCallRequest, SideEffectLinkedToNoteHash, computeContractClassId, getContractClassFromArtifact, @@ -39,14 +40,21 @@ export const mockTx = ( hasLogs = false, numberOfNonRevertiblePublicCallRequests = MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX / 2, numberOfRevertiblePublicCallRequests = MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX / 2, + publicCallRequests = [], }: { hasLogs?: boolean; numberOfNonRevertiblePublicCallRequests?: number; numberOfRevertiblePublicCallRequests?: number; + publicCallRequests?: PublicCallRequest[]; } = {}, ) => { - const totalPublicCallRequests = numberOfNonRevertiblePublicCallRequests + numberOfRevertiblePublicCallRequests; - const publicCallRequests = times(totalPublicCallRequests, i => makePublicCallRequest(seed + 0x100 + i)); + const totalPublicCallRequests = + numberOfNonRevertiblePublicCallRequests + numberOfRevertiblePublicCallRequests || publicCallRequests.length; + if (publicCallRequests.length && publicCallRequests.length !== totalPublicCallRequests) { + throw new Error( + `Provided publicCallRequests does not match the required number of call requests. Expected ${totalPublicCallRequests}. Got ${publicCallRequests.length}`, + ); + } const isForPublic = totalPublicCallRequests > 0; const data = PrivateKernelTailCircuitPublicInputs.empty(); @@ -59,15 +67,19 @@ export const mockTx = ( data.forPublic.endNonRevertibleData.newNullifiers[0] = firstNullifier; - data.forPublic.end.publicCallStack = makeTuple(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, i => - i < numberOfRevertiblePublicCallRequests ? publicCallRequests[i].toCallRequest() : CallRequest.empty(), - ); + publicCallRequests = publicCallRequests.length + ? publicCallRequests.slice().sort((a, b) => b.callContext.sideEffectCounter - a.callContext.sideEffectCounter) + : times(totalPublicCallRequests, i => makePublicCallRequest(seed + 0x100 + i)); data.forPublic.endNonRevertibleData.publicCallStack = makeTuple(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, i => i < numberOfNonRevertiblePublicCallRequests - ? publicCallRequests[i + numberOfRevertiblePublicCallRequests].toCallRequest() + ? publicCallRequests[numberOfRevertiblePublicCallRequests + i].toCallRequest() : CallRequest.empty(), ); + + data.forPublic.end.publicCallStack = makeTuple(MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, i => + i < numberOfRevertiblePublicCallRequests ? publicCallRequests[i].toCallRequest() : CallRequest.empty(), + ); } else { data.forRollup!.end.newNullifiers[0] = firstNullifier.value; } diff --git a/yarn-project/circuits.js/src/constants.gen.ts b/yarn-project/circuits.js/src/constants.gen.ts index 223a3361fb4..d0cc639cbaf 100644 --- a/yarn-project/circuits.js/src/constants.gen.ts +++ b/yarn-project/circuits.js/src/constants.gen.ts @@ -25,6 +25,7 @@ export const MAX_NULLIFIER_NON_EXISTENT_READ_REQUESTS_PER_TX = 8; export const MAX_NULLIFIER_KEY_VALIDATION_REQUESTS_PER_TX = 4; export const NUM_ENCRYPTED_LOGS_HASHES_PER_TX = 1; export const NUM_UNENCRYPTED_LOGS_HASHES_PER_TX = 1; +export const MAX_PUBLIC_DATA_HINTS = 64; export const NUMBER_OF_L1_L2_MESSAGES_PER_ROLLUP = 16; export const VK_TREE_HEIGHT = 3; export const FUNCTION_TREE_HEIGHT = 5; diff --git a/yarn-project/circuits.js/src/hints/build_hints.test.ts b/yarn-project/circuits.js/src/hints/build_hints.test.ts index 7ac9ee39a52..5df210ca1e8 100644 --- a/yarn-project/circuits.js/src/hints/build_hints.test.ts +++ b/yarn-project/circuits.js/src/hints/build_hints.test.ts @@ -22,10 +22,8 @@ import { buildNullifierNonExistentReadRequestHints, buildNullifierReadRequestHin describe('buildNullifierReadRequestHints', () => { const contractAddress = AztecAddress.random(); const settledNullifierInnerValue = 99999; - const settledNullifierValue = makeNullifier(settledNullifierInnerValue).value; const oracle = { - getNullifierMembershipWitness: (value: Fr) => - value.equals(settledNullifierValue) ? ({ membershipWitness: {}, leafPreimage: {} } as any) : undefined, + getNullifierMembershipWitness: () => ({ membershipWitness: {}, leafPreimage: {} } as any), }; let nullifierReadRequests: Tuple; let nullifiers: Tuple; @@ -113,11 +111,6 @@ describe('buildNullifierReadRequestHints', () => { const hints = await buildHints(); expect(hints).toEqual(expectedHints); }); - - it('throws if reading an unknown nullifier', async () => { - nullifierReadRequests[0] = makeReadRequest(88888); - await expect(buildHints()).rejects.toThrow('Read request is reading an unknown nullifier value.'); - }); }); describe('buildNullifierNonExistentReadRequestHints', () => { diff --git a/yarn-project/circuits.js/src/hints/build_hints.ts b/yarn-project/circuits.js/src/hints/build_hints.ts index 1266082c2d0..302ed3a14f9 100644 --- a/yarn-project/circuits.js/src/hints/build_hints.ts +++ b/yarn-project/circuits.js/src/hints/build_hints.ts @@ -17,14 +17,14 @@ import { NullifierReadRequestHintsBuilder } from '../structs/read_request_hints. import { SideEffectLinkedToNoteHash } from '../structs/side_effects.js'; import { countAccumulatedItems } from '../utils/index.js'; -export interface NullifierMembershipWitnessWithPreimage { +interface NullifierMembershipWitnessWithPreimage { membershipWitness: MembershipWitness; leafPreimage: IndexedTreeLeafPreimage; } export async function buildNullifierReadRequestHints( oracle: { - getNullifierMembershipWitness(nullifier: Fr): Promise; + getNullifierMembershipWitness(nullifier: Fr): Promise; }, nullifierReadRequests: Tuple, nullifiers: Tuple, @@ -46,10 +46,6 @@ export async function buildNullifierReadRequestHints( builder.addPendingReadRequest(i, pendingValueIndex); } else { const membershipWitnessWithPreimage = await oracle.getNullifierMembershipWitness(value); - if (!membershipWitnessWithPreimage) { - throw new Error('Read request is reading an unknown nullifier value.'); - } - builder.addSettledReadRequest( i, membershipWitnessWithPreimage.membershipWitness, diff --git a/yarn-project/circuits.js/src/hints/build_public_data_hints.test.ts b/yarn-project/circuits.js/src/hints/build_public_data_hints.test.ts new file mode 100644 index 00000000000..a041d8fd32f --- /dev/null +++ b/yarn-project/circuits.js/src/hints/build_public_data_hints.test.ts @@ -0,0 +1,123 @@ +import { makeTuple } from '@aztec/foundation/array'; +import { Fr } from '@aztec/foundation/fields'; +import { type Tuple } from '@aztec/foundation/serialize'; + +import { + MAX_PUBLIC_DATA_HINTS, + MAX_PUBLIC_DATA_READS_PER_TX, + type MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, +} from '../constants.gen.js'; +import { PublicDataRead, PublicDataTreeLeafPreimage, PublicDataUpdateRequest } from '../structs/index.js'; +import { buildPublicDataHints } from './build_public_data_hints.js'; + +class ExpectedHint { + constructor(public leafSlot: number, public value: number, public matchOrLowLeafSlot: number) {} + + static empty() { + return new ExpectedHint(0, 0, 0); + } + + toExpectedObject() { + return expect.objectContaining({ + leafSlot: new Fr(this.leafSlot), + value: new Fr(this.value), + leafPreimage: expect.objectContaining({ slot: new Fr(this.matchOrLowLeafSlot) }), + }); + } +} + +describe('buildPublicDataHints', () => { + let publicDataReads: Tuple; + let publicDataUpdateRequests: Tuple; + let expectedHints: Tuple; + + const publicDataLeaves = [ + new PublicDataTreeLeafPreimage(new Fr(22), new Fr(200), new Fr(33), 0n), + new PublicDataTreeLeafPreimage(new Fr(11), new Fr(100), new Fr(22), 0n), + new PublicDataTreeLeafPreimage(new Fr(0), new Fr(0), new Fr(11), 0n), + ]; + + const makePublicDataRead = (leafSlot: number, value: number) => new PublicDataRead(new Fr(leafSlot), new Fr(value)); + const makePublicDataWrite = (leafSlot: number, value: number) => + new PublicDataUpdateRequest(new Fr(leafSlot), new Fr(value)); + + const oracle = { + getMatchOrLowPublicDataMembershipWitness: (leafSlot: bigint) => { + const leafPreimage = publicDataLeaves.find(l => l.slot.toBigInt() <= leafSlot); + return { membershipWitness: {}, leafPreimage } as any; + }, + }; + + const buildHints = () => buildPublicDataHints(oracle, publicDataReads, publicDataUpdateRequests); + + const buildAndCheckHints = async () => { + const hints = await buildHints(); + const partialHints = expectedHints.map(h => h.toExpectedObject()); + expect(hints).toEqual(partialHints); + }; + + beforeEach(() => { + publicDataReads = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, PublicDataRead.empty); + publicDataUpdateRequests = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, PublicDataUpdateRequest.empty); + expectedHints = makeTuple(MAX_PUBLIC_DATA_HINTS, ExpectedHint.empty); + }); + + it('returns empty hints', async () => { + await buildAndCheckHints(); + }); + + it('builds hints for reads for uninitialized slots', async () => { + publicDataReads[0] = makePublicDataRead(12, 0); + publicDataReads[1] = makePublicDataRead(39, 0); + expectedHints[0] = new ExpectedHint(12, 0, 11); + expectedHints[1] = new ExpectedHint(39, 0, 22); + + await buildAndCheckHints(); + }); + + it('builds hints for reads for initialized slots', async () => { + publicDataReads[0] = makePublicDataRead(22, 200); + publicDataReads[1] = makePublicDataRead(11, 100); + expectedHints[0] = new ExpectedHint(22, 200, 22); + expectedHints[1] = new ExpectedHint(11, 100, 11); + + await buildAndCheckHints(); + }); + + it('builds hints for writes to uninitialized slots', async () => { + publicDataUpdateRequests[0] = makePublicDataWrite(5, 500); + publicDataUpdateRequests[1] = makePublicDataWrite(17, 700); + expectedHints[0] = new ExpectedHint(5, 0, 0); + expectedHints[1] = new ExpectedHint(17, 0, 11); + + await buildAndCheckHints(); + }); + + it('builds hints for writes to initialized slots', async () => { + publicDataUpdateRequests[0] = makePublicDataWrite(11, 111); + publicDataUpdateRequests[1] = makePublicDataWrite(22, 222); + expectedHints[0] = new ExpectedHint(11, 100, 11); + expectedHints[1] = new ExpectedHint(22, 200, 22); + + await buildAndCheckHints(); + }); + + it('builds hints for mixed reads and writes', async () => { + publicDataReads[0] = makePublicDataRead(22, 200); + publicDataReads[1] = makePublicDataRead(12, 0); + publicDataReads[2] = makePublicDataRead(39, 0); + publicDataReads[3] = makePublicDataRead(11, 100); + publicDataUpdateRequests[0] = makePublicDataWrite(11, 111); + publicDataUpdateRequests[1] = makePublicDataWrite(5, 500); + publicDataUpdateRequests[2] = makePublicDataWrite(17, 700); + publicDataUpdateRequests[3] = makePublicDataWrite(22, 222); + expectedHints[0] = new ExpectedHint(22, 200, 22); + expectedHints[1] = new ExpectedHint(12, 0, 11); + expectedHints[2] = new ExpectedHint(39, 0, 22); + expectedHints[3] = new ExpectedHint(11, 100, 11); + expectedHints[4] = new ExpectedHint(5, 0, 0); + expectedHints[5] = new ExpectedHint(17, 0, 11); + + await buildAndCheckHints(); + }); +}); diff --git a/yarn-project/circuits.js/src/hints/build_public_data_hints.ts b/yarn-project/circuits.js/src/hints/build_public_data_hints.ts new file mode 100644 index 00000000000..22d69a520bb --- /dev/null +++ b/yarn-project/circuits.js/src/hints/build_public_data_hints.ts @@ -0,0 +1,49 @@ +import { padArrayEnd } from '@aztec/foundation/collection'; +import { Fr } from '@aztec/foundation/fields'; +import { type Tuple } from '@aztec/foundation/serialize'; + +import { + MAX_PUBLIC_DATA_HINTS, + type MAX_PUBLIC_DATA_READS_PER_TX, + type MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, + type PUBLIC_DATA_TREE_HEIGHT, +} from '../constants.gen.js'; +import { + type PublicDataRead, + type PublicDataTreeLeafPreimage, + type PublicDataUpdateRequest, +} from '../structs/index.js'; +import { type MembershipWitness } from '../structs/membership_witness.js'; +import { PublicDataHint } from '../structs/public_data_hint.js'; + +interface PublicDataMembershipWitnessWithPreimage { + membershipWitness: MembershipWitness; + leafPreimage: PublicDataTreeLeafPreimage; +} + +export async function buildPublicDataHints( + oracle: { + getMatchOrLowPublicDataMembershipWitness(leafSlot: bigint): Promise; + }, + publicDataReads: Tuple, + publicDataUpdateRequests: Tuple, +) { + const publicDataLeafSlotSet: Set = new Set(); + [...publicDataReads, ...publicDataUpdateRequests] + .filter(r => !r.isEmpty()) + .forEach(v => { + publicDataLeafSlotSet.add(v.leafSlot.toBigInt()); + }); + const uniquePublicDataLeafSlots = [...publicDataLeafSlotSet]; + + const hints: PublicDataHint[] = []; + for (let i = 0; i < uniquePublicDataLeafSlots.length; i++) { + const leafSlot = uniquePublicDataLeafSlots[i]; + const { membershipWitness, leafPreimage } = await oracle.getMatchOrLowPublicDataMembershipWitness(leafSlot); + const exists = leafPreimage.slot.toBigInt() === leafSlot; + const value = exists ? leafPreimage.value : Fr.ZERO; + hints.push(new PublicDataHint(new Fr(leafSlot), value, 0, membershipWitness, leafPreimage)); + } + + return padArrayEnd(hints, PublicDataHint.empty(), MAX_PUBLIC_DATA_HINTS); +} diff --git a/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.test.ts b/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.test.ts new file mode 100644 index 00000000000..164256ede3e --- /dev/null +++ b/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.test.ts @@ -0,0 +1,150 @@ +import { makeTuple } from '@aztec/foundation/array'; +import { padArrayEnd } from '@aztec/foundation/collection'; +import { Fr } from '@aztec/foundation/fields'; +import { type Tuple } from '@aztec/foundation/serialize'; + +import { + MAX_PUBLIC_DATA_HINTS, + MAX_PUBLIC_DATA_READS_PER_TX, + MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, +} from '../constants.gen.js'; +import { + LeafDataReadHint, + PendingReadHint, + PublicDataHint, + PublicDataRead, + PublicDataUpdateRequest, + ReadRequestStatus, +} from '../structs/index.js'; +import { buildPublicDataReadRequestHints } from './build_public_data_read_request_hints.js'; + +describe('buildPublicDataReadRequestHints', () => { + let publicDataReads: Tuple; + let expectedStatuses: Tuple; + let expectedPendingHints: Tuple; + let expectedLeafDataHints: Tuple; + + const makePublicDataWrite = (leafSlot: number, value: number) => + new PublicDataUpdateRequest(new Fr(leafSlot), new Fr(value)); + const makePublicDataHint = (slot: number, value: number) => { + const hint = PublicDataHint.empty(); + hint.leafSlot = new Fr(slot); + hint.value = new Fr(value); + return hint; + }; + const makePublicDataRead = (leafSlot: number, value: number) => new PublicDataRead(new Fr(leafSlot), new Fr(value)); + const makePendingHint = (readRequestIndex: number, hintIndex: number) => + new PendingReadHint(readRequestIndex, hintIndex); + const makeLeafDataHint = (readRequestIndex: number, hintIndex: number) => + new LeafDataReadHint(readRequestIndex, hintIndex); + + const publicDataUpdateRequests = padArrayEnd( + [makePublicDataWrite(55, 5555), makePublicDataWrite(77, 7777), makePublicDataWrite(99, 9999)], + PublicDataUpdateRequest.empty(), + MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, + ); + + const publicDataHints = padArrayEnd( + [ + makePublicDataHint(11, 100), + makePublicDataHint(22, 200), + makePublicDataHint(33, 300), + makePublicDataHint(55, 500), + makePublicDataHint(77, 0), + makePublicDataHint(99, 900), + ], + PublicDataHint.empty(), + MAX_PUBLIC_DATA_HINTS, + ); + + const buildHints = () => buildPublicDataReadRequestHints(publicDataReads, publicDataUpdateRequests, publicDataHints); + + const buildAndCheckHints = () => { + const hints = buildHints(); + expect(hints.readRequestStatuses).toEqual(expectedStatuses); + expect(hints.pendingReadHints).toEqual(expectedPendingHints); + expect(hints.leafDataReadHints).toEqual(expectedLeafDataHints); + }; + + beforeEach(() => { + publicDataReads = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, PublicDataRead.empty); + expectedStatuses = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, ReadRequestStatus.nada); + expectedPendingHints = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => + PendingReadHint.nada(MAX_PUBLIC_DATA_READS_PER_TX), + ); + expectedLeafDataHints = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => + LeafDataReadHint.nada(MAX_PUBLIC_DATA_READS_PER_TX), + ); + }); + + it('returns empty hints', () => { + buildAndCheckHints(); + }); + + it('builds hints for reading pending values', () => { + publicDataReads[0] = makePublicDataRead(77, 7777); + publicDataReads[1] = makePublicDataRead(99, 9999); + publicDataReads[2] = makePublicDataRead(55, 5555); + expectedStatuses[0] = ReadRequestStatus.pending(0); + expectedStatuses[1] = ReadRequestStatus.pending(1); + expectedStatuses[2] = ReadRequestStatus.pending(2); + expectedPendingHints[0] = makePendingHint(0, 1); + expectedPendingHints[1] = makePendingHint(1, 2); + expectedPendingHints[2] = makePendingHint(2, 0); + + buildAndCheckHints(); + }); + + it('builds hints for reading settled or uninitialized values', () => { + publicDataReads[0] = makePublicDataRead(33, 300); + publicDataReads[1] = makePublicDataRead(77, 0); + publicDataReads[2] = makePublicDataRead(55, 500); + publicDataReads[3] = makePublicDataRead(11, 100); + expectedStatuses[0] = ReadRequestStatus.settled(0); + expectedStatuses[1] = ReadRequestStatus.settled(1); + expectedStatuses[2] = ReadRequestStatus.settled(2); + expectedStatuses[3] = ReadRequestStatus.settled(3); + expectedLeafDataHints[0] = makeLeafDataHint(0, 2); + expectedLeafDataHints[1] = makeLeafDataHint(1, 4); + expectedLeafDataHints[2] = makeLeafDataHint(2, 3); + expectedLeafDataHints[3] = makeLeafDataHint(3, 0); + + buildAndCheckHints(); + }); + + it('builds hints for reading pending and settled values', () => { + publicDataReads[0] = makePublicDataRead(55, 500); + publicDataReads[1] = makePublicDataRead(55, 5555); + publicDataReads[2] = makePublicDataRead(77, 0); + publicDataReads[3] = makePublicDataRead(11, 100); + publicDataReads[4] = makePublicDataRead(99, 9999); + publicDataReads[5] = makePublicDataRead(77, 7777); + publicDataReads[6] = makePublicDataRead(11, 100); + expectedStatuses[0] = ReadRequestStatus.settled(0); + expectedStatuses[1] = ReadRequestStatus.pending(0); + expectedStatuses[2] = ReadRequestStatus.settled(1); + expectedStatuses[3] = ReadRequestStatus.settled(2); + expectedStatuses[4] = ReadRequestStatus.pending(1); + expectedStatuses[5] = ReadRequestStatus.pending(2); + expectedStatuses[6] = ReadRequestStatus.settled(3); + expectedPendingHints[0] = makePendingHint(1, 0); + expectedPendingHints[1] = makePendingHint(4, 2); + expectedPendingHints[2] = makePendingHint(5, 1); + expectedLeafDataHints[0] = makeLeafDataHint(0, 3); + expectedLeafDataHints[1] = makeLeafDataHint(2, 4); + expectedLeafDataHints[2] = makeLeafDataHint(3, 0); + expectedLeafDataHints[3] = makeLeafDataHint(6, 0); + + buildAndCheckHints(); + }); + + it('throws if reading unknown slot', () => { + publicDataReads[0] = makePublicDataRead(123, 100); + expect(() => buildHints()).toThrow('Cannot find a pending write or a data hint for the read request.'); + }); + + it('throws if reading unknown value', () => { + publicDataReads[0] = makePublicDataRead(11, 1111); + expect(() => buildHints()).toThrow('Value being read does not match existing public data or pending writes.'); + }); +}); diff --git a/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.ts b/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.ts new file mode 100644 index 00000000000..4f7b15f312b --- /dev/null +++ b/yarn-project/circuits.js/src/hints/build_public_data_read_request_hints.ts @@ -0,0 +1,45 @@ +import { type Tuple } from '@aztec/foundation/serialize'; + +import { + type MAX_PUBLIC_DATA_HINTS, + type MAX_PUBLIC_DATA_READS_PER_TX, + type MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, +} from '../constants.gen.js'; +import { + type PublicDataRead, + PublicDataReadRequestHintsBuilder, + type PublicDataUpdateRequest, +} from '../structs/index.js'; +import { type PublicDataHint } from '../structs/public_data_hint.js'; +import { countAccumulatedItems } from '../utils/index.js'; + +export function buildPublicDataReadRequestHints( + publicDataReads: Tuple, + publicDataUpdateRequests: Tuple, + publicDataHints: Tuple, +) { + const builder = new PublicDataReadRequestHintsBuilder(); + + const numReadRequests = countAccumulatedItems(publicDataReads); + for (let i = 0; i < numReadRequests; ++i) { + const rr = publicDataReads[i]; + // TODO: Add counters to reads and writes. + const writeIndex = publicDataUpdateRequests.findIndex( + w => w.leafSlot.equals(rr.leafSlot) && w.newValue.equals(rr.value), + ); + if (writeIndex !== -1) { + builder.addPendingReadRequest(i, writeIndex); + } else { + const hintIndex = publicDataHints.findIndex(h => h.leafSlot.equals(rr.leafSlot)); + if (hintIndex === -1) { + throw new Error('Cannot find a pending write or a data hint for the read request.'); + } + if (!publicDataHints[hintIndex].value.equals(rr.value)) { + throw new Error('Value being read does not match existing public data or pending writes.'); + } + builder.addLeafDataReadRequest(i, hintIndex); + } + } + + return builder.toHints(); +} diff --git a/yarn-project/circuits.js/src/hints/index.ts b/yarn-project/circuits.js/src/hints/index.ts index 476edce05e9..d9378ed85b5 100644 --- a/yarn-project/circuits.js/src/hints/index.ts +++ b/yarn-project/circuits.js/src/hints/index.ts @@ -1,2 +1,3 @@ export * from './build_hints.js'; -export * from '../utils/index.js'; +export * from './build_public_data_hints.js'; +export * from './build_public_data_read_request_hints.js'; diff --git a/yarn-project/circuits.js/src/index.ts b/yarn-project/circuits.js/src/index.ts index 3b6fdbcd0e6..d4c939ef836 100644 --- a/yarn-project/circuits.js/src/index.ts +++ b/yarn-project/circuits.js/src/index.ts @@ -6,3 +6,4 @@ export * from './interfaces/index.js'; export * from './keys/index.js'; export * from './structs/index.js'; export * from './types/index.js'; +export * from './utils/index.js'; diff --git a/yarn-project/circuits.js/src/structs/contract_storage_read.ts b/yarn-project/circuits.js/src/structs/contract_storage_read.ts index 2c376a1d3f5..52d708f0ef1 100644 --- a/yarn-project/circuits.js/src/structs/contract_storage_read.ts +++ b/yarn-project/circuits.js/src/structs/contract_storage_read.ts @@ -1,3 +1,4 @@ +import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { Fr } from '@aztec/foundation/fields'; import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize'; @@ -24,6 +25,7 @@ export class ContractStorageRead { * Note: Not serialized */ public readonly sideEffectCounter?: number, + public contractAddress?: AztecAddress, // TODO: Should not be optional. This is a temporary hack to silo the storage slot with the correct address for nested executions. ) {} static from(args: { @@ -39,8 +41,9 @@ export class ContractStorageRead { * Optional side effect counter tracking position of this event in tx execution. */ sideEffectCounter?: number; + contractAddress?: AztecAddress; }) { - return new ContractStorageRead(args.storageSlot, args.currentValue, args.sideEffectCounter); + return new ContractStorageRead(args.storageSlot, args.currentValue, args.sideEffectCounter, args.contractAddress); } toBuffer() { diff --git a/yarn-project/circuits.js/src/structs/contract_storage_update_request.ts b/yarn-project/circuits.js/src/structs/contract_storage_update_request.ts index 8508fa8c7b8..378279d55bb 100644 --- a/yarn-project/circuits.js/src/structs/contract_storage_update_request.ts +++ b/yarn-project/circuits.js/src/structs/contract_storage_update_request.ts @@ -1,3 +1,4 @@ +import { type AztecAddress } from '@aztec/foundation/aztec-address'; import { Fr } from '@aztec/foundation/fields'; import { BufferReader, FieldReader, serializeToBuffer } from '@aztec/foundation/serialize'; import { type FieldsOf } from '@aztec/foundation/types'; @@ -24,6 +25,7 @@ export class ContractStorageUpdateRequest { * Optional side effect counter tracking position of this event in tx execution. */ public readonly sideEffectCounter?: number, + public contractAddress?: AztecAddress, // TODO: Should not be optional. This is a temporary hack to silo the storage slot with the correct address for nested executions. ) {} toBuffer() { @@ -50,7 +52,7 @@ export class ContractStorageUpdateRequest { * @returns The array. */ static getFields(fields: FieldsOf) { - return [fields.storageSlot, fields.newValue, fields.sideEffectCounter] as const; + return [fields.storageSlot, fields.newValue, fields.sideEffectCounter, fields.contractAddress] as const; } static empty() { diff --git a/yarn-project/circuits.js/src/structs/index.ts b/yarn-project/circuits.js/src/structs/index.ts index da3ec5a2c96..400c60e8ac9 100644 --- a/yarn-project/circuits.js/src/structs/index.ts +++ b/yarn-project/circuits.js/src/structs/index.ts @@ -47,7 +47,9 @@ export * from './proof.js'; export * from './public_call_request.js'; export * from './public_call_stack_item.js'; export * from './public_circuit_public_inputs.js'; +export * from './public_data_hint.js'; export * from './public_data_read_request.js'; +export * from './public_data_read_request_hints.js'; export * from './public_data_update_request.js'; export * from './read_request.js'; export * from './read_request_hints.js'; diff --git a/yarn-project/circuits.js/src/structs/kernel/kernel_circuit_public_inputs.ts b/yarn-project/circuits.js/src/structs/kernel/kernel_circuit_public_inputs.ts index cb59c58b76d..84637a61f91 100644 --- a/yarn-project/circuits.js/src/structs/kernel/kernel_circuit_public_inputs.ts +++ b/yarn-project/circuits.js/src/structs/kernel/kernel_circuit_public_inputs.ts @@ -1,6 +1,7 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; import { AggregationObject } from '../aggregation_object.js'; +import { PartialStateReference } from '../partial_state_reference.js'; import { RevertCode } from '../revert_code.js'; import { RollupValidationRequests } from '../rollup_validation_requests.js'; import { CombinedAccumulatedData } from './combined_accumulated_data.js'; @@ -28,6 +29,7 @@ export class KernelCircuitPublicInputs { * Data which is not modified by the circuits. */ public constants: CombinedConstantData, + public startState: PartialStateReference, /** * Flag indicating whether the transaction reverted. */ @@ -44,6 +46,7 @@ export class KernelCircuitPublicInputs { this.rollupValidationRequests, this.end, this.constants, + this.startState, this.revertCode, ); } @@ -60,6 +63,7 @@ export class KernelCircuitPublicInputs { reader.readObject(RollupValidationRequests), reader.readObject(CombinedAccumulatedData), reader.readObject(CombinedConstantData), + reader.readObject(PartialStateReference), reader.readObject(RevertCode), ); } @@ -70,6 +74,7 @@ export class KernelCircuitPublicInputs { RollupValidationRequests.empty(), CombinedAccumulatedData.empty(), CombinedConstantData.empty(), + PartialStateReference.empty(), RevertCode.OK, ); } diff --git a/yarn-project/circuits.js/src/structs/kernel/private_kernel_tail_circuit_public_inputs.ts b/yarn-project/circuits.js/src/structs/kernel/private_kernel_tail_circuit_public_inputs.ts index cc7ac7fb8b4..f064b5ee6ec 100644 --- a/yarn-project/circuits.js/src/structs/kernel/private_kernel_tail_circuit_public_inputs.ts +++ b/yarn-project/circuits.js/src/structs/kernel/private_kernel_tail_circuit_public_inputs.ts @@ -3,6 +3,7 @@ import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; import { MAX_NEW_NULLIFIERS_PER_TX } from '../../constants.gen.js'; import { countAccumulatedItems, mergeAccumulatedData } from '../../utils/index.js'; import { AggregationObject } from '../aggregation_object.js'; +import { PartialStateReference } from '../partial_state_reference.js'; import { RevertCode } from '../revert_code.js'; import { RollupValidationRequests } from '../rollup_validation_requests.js'; import { ValidationRequests } from '../validation_requests.js'; @@ -135,6 +136,7 @@ export class PrivateKernelTailCircuitPublicInputs { this.forRollup.rollupValidationRequests, this.forRollup.end, this.constants, + PartialStateReference.empty(), this.revertCode, ); } diff --git a/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts index be3037d4565..5399146b7e5 100644 --- a/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts +++ b/yarn-project/circuits.js/src/structs/kernel/public_kernel_tail_circuit_private_inputs.ts @@ -1,15 +1,16 @@ -import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; +import { BufferReader, type Tuple, serializeToBuffer } from '@aztec/foundation/serialize'; +import { MAX_PUBLIC_DATA_HINTS } from '../../constants.gen.js'; import { type NullifierNonExistentReadRequestHints, nullifierNonExistentReadRequestHintsFromBuffer, } from '../non_existent_read_request_hints.js'; +import { PartialStateReference } from '../partial_state_reference.js'; +import { PublicDataHint } from '../public_data_hint.js'; +import { PublicDataReadRequestHints } from '../public_data_read_request_hints.js'; import { type NullifierReadRequestHints, nullifierReadRequestHintsFromBuffer } from '../read_request_hints.js'; import { PublicKernelData } from './public_kernel_data.js'; -/** - * Inputs to the public kernel circuit. - */ export class PublicKernelTailCircuitPrivateInputs { constructor( /** @@ -24,6 +25,9 @@ export class PublicKernelTailCircuitPrivateInputs { * Contains hints for the nullifier non existent read requests. */ public readonly nullifierNonExistentReadRequestHints: NullifierNonExistentReadRequestHints, + public readonly publicDataHints: Tuple, + public readonly publicDataReadRequestHints: PublicDataReadRequestHints, + public readonly startState: PartialStateReference, ) {} toBuffer() { @@ -31,6 +35,9 @@ export class PublicKernelTailCircuitPrivateInputs { this.previousKernel, this.nullifierReadRequestHints, this.nullifierNonExistentReadRequestHints, + this.publicDataHints, + this.publicDataReadRequestHints, + this.startState, ); } @@ -40,6 +47,9 @@ export class PublicKernelTailCircuitPrivateInputs { reader.readObject(PublicKernelData), nullifierReadRequestHintsFromBuffer(reader), nullifierNonExistentReadRequestHintsFromBuffer(reader), + reader.readArray(MAX_PUBLIC_DATA_HINTS, PublicDataHint), + reader.readObject(PublicDataReadRequestHints), + reader.readObject(PartialStateReference), ); } diff --git a/yarn-project/circuits.js/src/structs/membership_witness.ts b/yarn-project/circuits.js/src/structs/membership_witness.ts index db0457ef394..fd623300be1 100644 --- a/yarn-project/circuits.js/src/structs/membership_witness.ts +++ b/yarn-project/circuits.js/src/structs/membership_witness.ts @@ -49,7 +49,7 @@ export class MembershipWitness { * @param leafIndex - Index of the leaf in the Merkle tree. * @returns Membership witness with zero sibling path. */ - public static empty(pathSize: N, leafIndex: bigint): MembershipWitness { + public static empty(pathSize: N, leafIndex = 0n): MembershipWitness { const arr = Array(pathSize) .fill(0) .map(() => Fr.ZERO) as Tuple; diff --git a/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts b/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts index 9659c63d0c3..faea5129fbb 100644 --- a/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts +++ b/yarn-project/circuits.js/src/structs/non_existent_read_request_hints.ts @@ -18,7 +18,7 @@ export class NonMembershipHint LEAF_PREIMAGE, ) { - return new NonMembershipHint(MembershipWitness.empty(treeHeight, 0n), makeEmptyLeafPreimage()); + return new NonMembershipHint(MembershipWitness.empty(treeHeight), makeEmptyLeafPreimage()); } static fromBuffer( diff --git a/yarn-project/circuits.js/src/structs/public_data_hint.ts b/yarn-project/circuits.js/src/structs/public_data_hint.ts new file mode 100644 index 00000000000..52d73a080f0 --- /dev/null +++ b/yarn-project/circuits.js/src/structs/public_data_hint.ts @@ -0,0 +1,47 @@ +import { Fr } from '@aztec/foundation/fields'; +import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize'; + +import { PUBLIC_DATA_TREE_HEIGHT } from '../constants.gen.js'; +import { MembershipWitness } from './membership_witness.js'; +import { PublicDataTreeLeafPreimage } from './rollup/public_data_leaf/index.js'; + +export class PublicDataHint { + constructor( + public leafSlot: Fr, + public value: Fr, + public overrideCounter: number, + public membershipWitness: MembershipWitness, + public leafPreimage: PublicDataTreeLeafPreimage, + ) {} + + static empty() { + return new PublicDataHint( + Fr.ZERO, + Fr.ZERO, + 0, + MembershipWitness.empty(PUBLIC_DATA_TREE_HEIGHT), + PublicDataTreeLeafPreimage.empty(), + ); + } + + static fromBuffer(buffer: Buffer | BufferReader) { + const reader = BufferReader.asReader(buffer); + return new PublicDataHint( + reader.readObject(Fr), + reader.readObject(Fr), + reader.readNumber(), + MembershipWitness.fromBuffer(reader, PUBLIC_DATA_TREE_HEIGHT), + reader.readObject(PublicDataTreeLeafPreimage), + ); + } + + toBuffer() { + return serializeToBuffer( + this.leafSlot, + this.value, + this.overrideCounter, + this.membershipWitness, + this.leafPreimage, + ); + } +} diff --git a/yarn-project/circuits.js/src/structs/public_data_read_request_hints.ts b/yarn-project/circuits.js/src/structs/public_data_read_request_hints.ts new file mode 100644 index 00000000000..8c6b324d63f --- /dev/null +++ b/yarn-project/circuits.js/src/structs/public_data_read_request_hints.ts @@ -0,0 +1,86 @@ +import { makeTuple } from '@aztec/foundation/array'; +import { BufferReader, type Tuple, serializeToBuffer } from '@aztec/foundation/serialize'; + +import { MAX_PUBLIC_DATA_READS_PER_TX } from '../constants.gen.js'; +import { PendingReadHint, ReadRequestState, ReadRequestStatus } from './read_request_hints.js'; + +export class LeafDataReadHint { + constructor(public readRequestIndex: number, public dataHintIndex: number) {} + + static nada(readRequestLen: number) { + return new LeafDataReadHint(readRequestLen, 0); + } + + static fromBuffer(buffer: Buffer | BufferReader) { + const reader = BufferReader.asReader(buffer); + return new LeafDataReadHint(reader.readNumber(), reader.readNumber()); + } + + toBuffer() { + return serializeToBuffer(this.readRequestIndex, this.dataHintIndex); + } +} + +export class PublicDataReadRequestHints { + constructor( + public readRequestStatuses: Tuple, + public pendingReadHints: Tuple, + public leafDataReadHints: Tuple, + ) {} + + static fromBuffer(buffer: Buffer | BufferReader) { + const reader = BufferReader.asReader(buffer); + return new PublicDataReadRequestHints( + reader.readArray(MAX_PUBLIC_DATA_READS_PER_TX, ReadRequestStatus), + reader.readArray(MAX_PUBLIC_DATA_READS_PER_TX, PendingReadHint), + reader.readArray(MAX_PUBLIC_DATA_READS_PER_TX, LeafDataReadHint), + ); + } + + toBuffer() { + return serializeToBuffer(this.readRequestStatuses, this.pendingReadHints, this.leafDataReadHints); + } +} + +export class PublicDataReadRequestHintsBuilder { + private hints: PublicDataReadRequestHints; + private numPendingReadHints = 0; + private numLeafDataReadHints = 0; + + constructor() { + this.hints = new PublicDataReadRequestHints( + makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, ReadRequestStatus.nada), + makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => PendingReadHint.nada(MAX_PUBLIC_DATA_READS_PER_TX)), + makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => LeafDataReadHint.nada(MAX_PUBLIC_DATA_READS_PER_TX)), + ); + } + + static empty() { + return new PublicDataReadRequestHintsBuilder().toHints(); + } + + addPendingReadRequest(readRequestIndex: number, publicDataWriteIndex: number) { + this.hints.readRequestStatuses[readRequestIndex] = new ReadRequestStatus( + ReadRequestState.PENDING, + this.numPendingReadHints, + ); + this.hints.pendingReadHints[this.numPendingReadHints] = new PendingReadHint(readRequestIndex, publicDataWriteIndex); + this.numPendingReadHints++; + } + + addLeafDataReadRequest(readRequestIndex: number, leafDataDataHintIndex: number) { + this.hints.readRequestStatuses[readRequestIndex] = new ReadRequestStatus( + ReadRequestState.SETTLED, + this.numLeafDataReadHints, + ); + this.hints.leafDataReadHints[this.numLeafDataReadHints] = new LeafDataReadHint( + readRequestIndex, + leafDataDataHintIndex, + ); + this.numLeafDataReadHints++; + } + + toHints() { + return this.hints; + } +} diff --git a/yarn-project/circuits.js/src/structs/read_request_hints.ts b/yarn-project/circuits.js/src/structs/read_request_hints.ts index 6e6439ec426..fd0be737614 100644 --- a/yarn-project/circuits.js/src/structs/read_request_hints.ts +++ b/yarn-project/circuits.js/src/structs/read_request_hints.ts @@ -19,6 +19,14 @@ export class ReadRequestStatus { return new ReadRequestStatus(ReadRequestState.NADA, 0); } + static pending(hintIndex: number) { + return new ReadRequestStatus(ReadRequestState.PENDING, hintIndex); + } + + static settled(hintIndex: number) { + return new ReadRequestStatus(ReadRequestState.SETTLED, hintIndex); + } + static fromBuffer(buffer: Buffer | BufferReader) { const reader = BufferReader.asReader(buffer); return new ReadRequestStatus(reader.readNumber(), reader.readNumber()); @@ -58,7 +66,7 @@ export class SettledReadHint LEAF_PREIMAGE, ) { - return new SettledReadHint(readRequestLen, MembershipWitness.empty(treeHeight, 0n), emptyLeafPreimage()); + return new SettledReadHint(readRequestLen, MembershipWitness.empty(treeHeight), emptyLeafPreimage()); } static fromBuffer( diff --git a/yarn-project/circuits.js/src/tests/factories.ts b/yarn-project/circuits.js/src/tests/factories.ts index 1a1c2473d6e..665808a4431 100644 --- a/yarn-project/circuits.js/src/tests/factories.ts +++ b/yarn-project/circuits.js/src/tests/factories.ts @@ -56,6 +56,7 @@ import { MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX, MAX_PUBLIC_CALL_STACK_LENGTH_PER_CALL, MAX_PUBLIC_CALL_STACK_LENGTH_PER_TX, + MAX_PUBLIC_DATA_HINTS, MAX_PUBLIC_DATA_READS_PER_CALL, MAX_PUBLIC_DATA_READS_PER_TX, MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_CALL, @@ -97,7 +98,9 @@ import { PublicCallRequest, PublicCallStackItem, PublicCircuitPublicInputs, + PublicDataHint, PublicDataRead, + PublicDataReadRequestHintsBuilder, PublicDataTreeLeaf, PublicDataTreeLeafPreimage, PublicDataUpdateRequest, @@ -537,6 +540,7 @@ export function makeKernelCircuitPublicInputs(seed = 1, fullAccumulatedData = tr makeRollupValidationRequests(seed), makeCombinedAccumulatedData(seed, fullAccumulatedData), makeConstantData(seed + 0x100), + makePartialStateReference(seed + 0x200), RevertCode.OK, ); } @@ -791,6 +795,9 @@ export function makePublicKernelTailCircuitPrivateInputs(seed = 1): PublicKernel makePublicKernelData(seed), NullifierReadRequestHintsBuilder.empty(), NullifierNonExistentReadRequestHintsBuilder.empty(), + makeTuple(MAX_PUBLIC_DATA_HINTS, PublicDataHint.empty, seed + 0x100), + PublicDataReadRequestHintsBuilder.empty(), + makePartialStateReference(seed + 0x200), ); } diff --git a/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts b/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts index 0dbf841e51e..025f6533657 100644 --- a/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts +++ b/yarn-project/noir-protocol-circuits-types/src/type_conversion.ts @@ -31,6 +31,7 @@ import { KernelCircuitPublicInputs, type KernelData, type L2ToL1Message, + type LeafDataReadHint, MAX_NEW_L2_TO_L1_MSGS_PER_TX, MAX_NEW_NOTE_HASHES_PER_TX, MAX_NEW_NULLIFIERS_PER_TX, @@ -76,7 +77,9 @@ import { type PublicCallData, type PublicCallStackItem, type PublicCircuitPublicInputs, + type PublicDataHint, PublicDataRead, + type PublicDataReadRequestHints, type PublicDataTreeLeaf, type PublicDataTreeLeafPreimage, PublicDataUpdateRequest, @@ -170,8 +173,11 @@ import { type StorageUpdateRequest as StorageUpdateRequestNoir, } from './types/public_kernel_setup_types.js'; import { + type LeafDataReadHint as LeafDataReadHintNoir, type NullifierNonExistentReadRequestHints as NullifierNonExistentReadRequestHintsNoir, type NullifierNonMembershipHint as NullifierNonMembershipHintNoir, + type PublicDataHint as PublicDataHintNoir, + type PublicDataReadRequestHints as PublicDataReadRequestHintsNoir, type PublicDataUpdateRequest as PublicDataUpdateRequestNoir, type PublicKernelTailCircuitPrivateInputs as PublicKernelTailCircuitPrivateInputsNoir, } from './types/public_kernel_tail_types.js'; @@ -926,6 +932,13 @@ function mapPendingReadHintToNoir(hint: PendingReadHint): PendingReadHintNoir { }; } +function mapLeafDataReadHintToNoir(hint: LeafDataReadHint): LeafDataReadHintNoir { + return { + read_request_index: mapNumberToNoir(hint.readRequestIndex), + data_hint_index: mapNumberToNoir(hint.dataHintIndex), + }; +} + function mapNullifierSettledReadHintToNoir( hint: SettledReadHint, ): NullifierSettledReadHintNoir { @@ -964,6 +977,24 @@ function mapNullifierNonExistentReadRequestHintsToNoir( }; } +function mapPublicDataHintToNoir(hint: PublicDataHint): PublicDataHintNoir { + return { + leaf_slot: mapFieldToNoir(hint.leafSlot), + value: mapFieldToNoir(hint.value), + override_counter: mapNumberToNoir(hint.overrideCounter), + membership_witness: mapPublicDataMembershipWitnessToNoir(hint.membershipWitness), + leaf_preimage: mapPublicDataTreePreimageToNoir(hint.leafPreimage), + }; +} + +function mapPublicDataReadRequestHintsToNoir(hints: PublicDataReadRequestHints): PublicDataReadRequestHintsNoir { + return { + read_request_statuses: mapTuple(hints.readRequestStatuses, mapReadRequestStatusToNoir), + pending_read_hints: mapTuple(hints.pendingReadHints, mapPendingReadHintToNoir), + leaf_data_read_hints: mapTuple(hints.leafDataReadHints, mapLeafDataReadHintToNoir), + }; +} + function mapValidationRequestsToNoir(requests: ValidationRequests): ValidationRequestsNoir { return { for_rollup: mapRollupValidationRequestsToNoir(requests.forRollup), @@ -1221,6 +1252,7 @@ export function mapKernelCircuitPublicInputsFromNoir(inputs: KernelCircuitPublic mapRollupValidationRequestsFromNoir(inputs.rollup_validation_requests), mapCombinedAccumulatedDataFromNoir(inputs.end), mapCombinedConstantDataFromNoir(inputs.constants), + mapPartialStateReferenceFromNoir(inputs.start_state), mapRevertCodeFromNoir(inputs.revert_code), ); } @@ -1231,6 +1263,7 @@ export function mapKernelCircuitPublicInputsToNoir(inputs: KernelCircuitPublicIn rollup_validation_requests: mapRollupValidationRequestsToNoir(inputs.rollupValidationRequests), constants: mapCombinedConstantDataToNoir(inputs.constants), end: mapCombinedAccumulatedDataToNoir(inputs.end), + start_state: mapPartialStateReferenceToNoir(inputs.startState), revert_code: mapRevertCodeToNoir(inputs.revertCode), }; } @@ -1399,6 +1432,9 @@ export function mapPublicKernelTailCircuitPrivateInputsToNoir( nullifier_non_existent_read_request_hints: mapNullifierNonExistentReadRequestHintsToNoir( inputs.nullifierNonExistentReadRequestHints, ), + public_data_hints: mapTuple(inputs.publicDataHints, mapPublicDataHintToNoir), + public_data_read_request_hints: mapPublicDataReadRequestHintsToNoir(inputs.publicDataReadRequestHints), + start_state: mapPartialStateReferenceToNoir(inputs.startState), }; } diff --git a/yarn-project/pxe/src/kernel_prover/hints_builder.ts b/yarn-project/pxe/src/kernel_prover/hints_builder.ts index f57f1d8c7b4..dea4ae58b96 100644 --- a/yarn-project/pxe/src/kernel_prover/hints_builder.ts +++ b/yarn-project/pxe/src/kernel_prover/hints_builder.ts @@ -84,7 +84,7 @@ export class HintsBuilder { async getNullifierMembershipWitness(nullifier: Fr) { const res = await this.oracle.getNullifierMembershipWitness(nullifier); if (!res) { - return; + throw new Error(`Cannot find the leaf for nullifier ${nullifier.toBigInt()}.`); } const { index, siblingPath, leafPreimage } = res; diff --git a/yarn-project/simulator/src/public/abstract_phase_manager.ts b/yarn-project/simulator/src/public/abstract_phase_manager.ts index c39d240ded7..e5f64338bb1 100644 --- a/yarn-project/simulator/src/public/abstract_phase_manager.ts +++ b/yarn-project/simulator/src/public/abstract_phase_manager.ts @@ -501,29 +501,9 @@ function patchPublicStorageActionOrdering( // so the returned result will be a subset of the public kernel output. const simPublicDataReads = collectPublicDataReads(execResult); - // verify that each read is in the kernel output - for (const read of simPublicDataReads) { - if (!publicDataReads.find(item => item.equals(read))) { - throw new Error( - `Public data reads from simulator do not match those from public kernel.\nFrom simulator: ${simPublicDataReads - .map(p => p.toFriendlyJSON()) - .join(', ')}\nFrom public kernel: ${publicDataReads.map(i => i.toFriendlyJSON()).join(', ')}`, - ); - } - } const simPublicDataUpdateRequests = collectPublicDataUpdateRequests(execResult); - for (const update of simPublicDataUpdateRequests) { - if (!publicDataUpdateRequests.find(item => item.equals(update))) { - throw new Error( - `Public data update requests from simulator do not match those from public kernel.\nFrom simulator: ${simPublicDataUpdateRequests - .map(p => p.toFriendlyJSON()) - .join(', ')}\nFrom public kernel revertible: ${publicDataUpdateRequests - .map(i => i.toFriendlyJSON()) - .join(', ')}`, - ); - } - } + // We only want to reorder the items from the public inputs of the // most recently processed top/enqueued call. diff --git a/yarn-project/simulator/src/public/execution.ts b/yarn-project/simulator/src/public/execution.ts index 74d33ec15c6..fe12e76526a 100644 --- a/yarn-project/simulator/src/public/execution.ts +++ b/yarn-project/simulator/src/public/execution.ts @@ -1,6 +1,5 @@ import { type SimulationError, type UnencryptedFunctionL2Logs } from '@aztec/circuit-types'; import { - type AztecAddress, type ContractStorageRead, type ContractStorageUpdateRequest, type Fr, @@ -85,10 +84,8 @@ export function isPublicExecutionResult( */ export function collectPublicDataReads(execResult: PublicExecutionResult): PublicDataRead[] { // HACK(#1622): part of temporary hack - may be able to remove this function after public state ordering is fixed - const contractAddress = execResult.execution.callContext.storageContractAddress; - const thisExecPublicDataReads = execResult.contractStorageReads.map(read => - contractStorageReadToPublicDataRead(read, contractAddress), + contractStorageReadToPublicDataRead(read), ); const unsorted = [ ...thisExecPublicDataReads, @@ -105,10 +102,8 @@ export function collectPublicDataReads(execResult: PublicExecutionResult): Publi */ export function collectPublicDataUpdateRequests(execResult: PublicExecutionResult): PublicDataUpdateRequest[] { // HACK(#1622): part of temporary hack - may be able to remove this function after public state ordering is fixed - const contractAddress = execResult.execution.callContext.storageContractAddress; - const thisExecPublicDataUpdateRequests = execResult.contractStorageUpdateRequests.map(update => - contractStorageUpdateRequestToPublicDataUpdateRequest(update, contractAddress), + contractStorageUpdateRequestToPublicDataUpdateRequest(update), ); const unsorted = [ ...thisExecPublicDataUpdateRequests, @@ -123,9 +118,9 @@ export function collectPublicDataUpdateRequests(execResult: PublicExecutionResul * @param contractAddress - the contract address of the read * @returns The public data read. */ -function contractStorageReadToPublicDataRead(read: ContractStorageRead, contractAddress: AztecAddress): PublicDataRead { +function contractStorageReadToPublicDataRead(read: ContractStorageRead): PublicDataRead { return new PublicDataRead( - computePublicDataTreeLeafSlot(contractAddress, read.storageSlot), + computePublicDataTreeLeafSlot(read.contractAddress!, read.storageSlot), computePublicDataTreeValue(read.currentValue), read.sideEffectCounter!, ); @@ -139,10 +134,9 @@ function contractStorageReadToPublicDataRead(read: ContractStorageRead, contract */ function contractStorageUpdateRequestToPublicDataUpdateRequest( update: ContractStorageUpdateRequest, - contractAddress: AztecAddress, ): PublicDataUpdateRequest { return new PublicDataUpdateRequest( - computePublicDataTreeLeafSlot(contractAddress, update.storageSlot), + computePublicDataTreeLeafSlot(update.contractAddress!, update.storageSlot), computePublicDataTreeValue(update.newValue), update.sideEffectCounter!, ); diff --git a/yarn-project/simulator/src/public/hints_builder.ts b/yarn-project/simulator/src/public/hints_builder.ts index b2a581d7696..5cc4988fd6f 100644 --- a/yarn-project/simulator/src/public/hints_builder.ts +++ b/yarn-project/simulator/src/public/hints_builder.ts @@ -1,65 +1,77 @@ import { MerkleTreeId } from '@aztec/circuit-types'; import { type Fr, - MAX_NEW_NULLIFIERS_PER_TX, + type MAX_NEW_NULLIFIERS_PER_TX, type MAX_NULLIFIER_NON_EXISTENT_READ_REQUESTS_PER_TX, type MAX_NULLIFIER_READ_REQUESTS_PER_TX, - MAX_PUBLIC_DATA_READS_PER_TX, + type MAX_PUBLIC_DATA_HINTS, + type MAX_PUBLIC_DATA_READS_PER_TX, + type MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, MembershipWitness, NULLIFIER_TREE_HEIGHT, PUBLIC_DATA_TREE_HEIGHT, + type PublicDataHint, type PublicDataRead, - PublicDataTreeLeafPreimage, + type PublicDataTreeLeafPreimage, + type PublicDataUpdateRequest, type ReadRequestContext, type SideEffectLinkedToNoteHash, buildNullifierNonExistentReadRequestHints, buildNullifierReadRequestHints, - mergeAccumulatedData, + buildPublicDataHints, + buildPublicDataReadRequestHints, } from '@aztec/circuits.js'; -import { makeTuple } from '@aztec/foundation/array'; import { type Tuple } from '@aztec/foundation/serialize'; -import { type MerkleTreeOperations } from '@aztec/world-state'; +import { type IndexedTreeId, type MerkleTreeOperations } from '@aztec/world-state'; export class HintsBuilder { constructor(private db: MerkleTreeOperations) {} getNullifierReadRequestHints( nullifierReadRequests: Tuple, - nullifiersNonRevertible: Tuple, - nullifiersRevertible: Tuple, + pendingNullifiers: Tuple, ) { - return buildNullifierReadRequestHints( - this, - nullifierReadRequests, - mergeAccumulatedData(MAX_NEW_NULLIFIERS_PER_TX, nullifiersNonRevertible, nullifiersRevertible), - ); + return buildNullifierReadRequestHints(this, nullifierReadRequests, pendingNullifiers); } getNullifierNonExistentReadRequestHints( nullifierNonExistentReadRequests: Tuple, - nullifiersNonRevertible: Tuple, - nullifiersRevertible: Tuple, + pendingNullifiers: Tuple, ) { - const pendingNullifiers = mergeAccumulatedData( - MAX_NEW_NULLIFIERS_PER_TX, - nullifiersNonRevertible, - nullifiersRevertible, - ); return buildNullifierNonExistentReadRequestHints(this, nullifierNonExistentReadRequests, pendingNullifiers); } + getPublicDataHints( + publicDataReads: Tuple, + publicDataUpdateRequests: Tuple, + ) { + return buildPublicDataHints(this, publicDataReads, publicDataUpdateRequests); + } + + getPublicDataReadRequestHints( + publicDataReads: Tuple, + publicDataUpdateRequests: Tuple, + publicDataHints: Tuple, + ) { + return buildPublicDataReadRequestHints(publicDataReads, publicDataUpdateRequests, publicDataHints); + } + async getNullifierMembershipWitness(nullifier: Fr) { const index = await this.db.findLeafIndex(MerkleTreeId.NULLIFIER_TREE, nullifier.toBuffer()); if (index === undefined) { - return; + throw new Error(`Cannot find the leaf for nullifier ${nullifier.toBigInt()}.`); } - return this.getNullifierMembershipWitnessWithPreimage(index); + return this.getMembershipWitnessWithPreimage( + MerkleTreeId.NULLIFIER_TREE, + NULLIFIER_TREE_HEIGHT, + index, + ); } async getLowNullifierMembershipWitness(nullifier: Fr) { const res = await this.db.getPreviousValueIndex(MerkleTreeId.NULLIFIER_TREE, nullifier.toBigInt()); - if (res === undefined) { + if (!res) { throw new Error(`Cannot find the low leaf for nullifier ${nullifier.toBigInt()}.`); } @@ -68,52 +80,40 @@ export class HintsBuilder { throw new Error(`Nullifier ${nullifier.toBigInt()} already exists in the tree.`); } - return this.getNullifierMembershipWitnessWithPreimage(index); - } - - private async getNullifierMembershipWitnessWithPreimage(index: bigint) { - const siblingPath = await this.db.getSiblingPath(MerkleTreeId.NULLIFIER_TREE, index); - const membershipWitness = new MembershipWitness( + return this.getMembershipWitnessWithPreimage( + MerkleTreeId.NULLIFIER_TREE, NULLIFIER_TREE_HEIGHT, index, - siblingPath.toTuple(), ); + } - const leafPreimage = await this.db.getLeafPreimage(MerkleTreeId.NULLIFIER_TREE, index); - if (!leafPreimage) { - throw new Error(`Cannot find the leaf preimage at index ${index}.`); + async getMatchOrLowPublicDataMembershipWitness(leafSlot: bigint) { + const res = await this.db.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot); + if (!res) { + throw new Error(`Cannot find the previous value index for public data ${leafSlot}.`); } - return { membershipWitness, leafPreimage }; + const { membershipWitness, leafPreimage } = await this.getMembershipWitnessWithPreimage< + typeof PUBLIC_DATA_TREE_HEIGHT + >(MerkleTreeId.PUBLIC_DATA_TREE, PUBLIC_DATA_TREE_HEIGHT, res.index); + + // Should find a way to stop casting IndexedTreeLeafPreimage as PublicDataTreeLeafPreimage everywhere. + return { membershipWitness, leafPreimage: leafPreimage as PublicDataTreeLeafPreimage }; } - async getPublicDataReadsInfo(publicDataReads: PublicDataRead[]) { - const newPublicDataReadsWitnesses: Tuple< - MembershipWitness, - typeof MAX_PUBLIC_DATA_READS_PER_TX - > = makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => MembershipWitness.empty(PUBLIC_DATA_TREE_HEIGHT, 0n)); - - const newPublicDataReadsPreimages: Tuple = - makeTuple(MAX_PUBLIC_DATA_READS_PER_TX, () => PublicDataTreeLeafPreimage.empty()); - - for (const i in publicDataReads) { - const leafSlot = publicDataReads[i].leafSlot.value; - const lowLeafResult = await this.db.getPreviousValueIndex(MerkleTreeId.PUBLIC_DATA_TREE, leafSlot); - if (!lowLeafResult) { - throw new Error(`Public data tree should have one initial leaf`); - } - const preimage = await this.db.getLeafPreimage(MerkleTreeId.PUBLIC_DATA_TREE, lowLeafResult.index); - const path = await this.db.getSiblingPath(MerkleTreeId.PUBLIC_DATA_TREE, lowLeafResult.index); - newPublicDataReadsWitnesses[i] = new MembershipWitness( - PUBLIC_DATA_TREE_HEIGHT, - BigInt(lowLeafResult.index), - path.toTuple(), - ); - newPublicDataReadsPreimages[i] = preimage! as PublicDataTreeLeafPreimage; + private async getMembershipWitnessWithPreimage( + treeId: IndexedTreeId, + treeHeight: TREE_HEIGHT, + index: bigint, + ) { + const siblingPath = await this.db.getSiblingPath(treeId, index); + const membershipWitness = new MembershipWitness(treeHeight, index, siblingPath.toTuple()); + + const leafPreimage = await this.db.getLeafPreimage(treeId, index); + if (!leafPreimage) { + throw new Error(`Cannot find the leaf preimage for tree ${treeId} at index ${index}.`); } - return { - newPublicDataReadsWitnesses, - newPublicDataReadsPreimages, - }; + + return { membershipWitness, leafPreimage }; } } diff --git a/yarn-project/simulator/src/public/index.test.ts b/yarn-project/simulator/src/public/index.test.ts index 5f97336dcbf..7cd22cf4df1 100644 --- a/yarn-project/simulator/src/public/index.test.ts +++ b/yarn-project/simulator/src/public/index.test.ts @@ -148,11 +148,13 @@ describe('ACIR public execution simulator', () => { // There should be 2 storage updates, one for the recipient's balance and one for the total supply expect(result.contractStorageUpdateRequests).toEqual([ { + contractAddress, storageSlot: recipientBalanceStorageSlot, newValue: expectedBalance, sideEffectCounter: 3, }, { + contractAddress, storageSlot: totalSupplyStorageSlot, newValue: expectedTotalSupply, sideEffectCounter: 4, @@ -165,6 +167,7 @@ describe('ACIR public execution simulator', () => { // the updates expect(result.contractStorageReads).toEqual([ { + contractAddress, storageSlot: isMinterStorageSlot, currentValue: isMinter, sideEffectCounter: 0, @@ -223,11 +226,13 @@ describe('ACIR public execution simulator', () => { expect(result.contractStorageUpdateRequests).toEqual([ { + contractAddress, storageSlot: senderStorageSlot, newValue: expectedSenderBalance, sideEffectCounter: 1, // 1 read (sender balance) }, { + contractAddress, storageSlot: recipientStorageSlot, newValue: expectedRecipientBalance, sideEffectCounter: 3, // 1 read (sender balance), 1 write (new sender balance), 1 read (recipient balance) diff --git a/yarn-project/simulator/src/public/public_processor.test.ts b/yarn-project/simulator/src/public/public_processor.test.ts index 4d540b0a890..904321e2d6c 100644 --- a/yarn-project/simulator/src/public/public_processor.test.ts +++ b/yarn-project/simulator/src/public/public_processor.test.ts @@ -1,45 +1,39 @@ import { type BlockProver, - EncryptedTxL2Logs, type ProcessedTx, PublicDataWrite, - SiblingPath, SimulationError, - Tx, + type Tx, type TxValidator, - UnencryptedTxL2Logs, mockTx, toTxEffect, } from '@aztec/circuit-types'; import { + AppendOnlyTreeSnapshot, ContractStorageUpdateRequest, Fr, GlobalVariables, Header, - MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, PUBLIC_DATA_TREE_HEIGHT, + PartialStateReference, type Proof, type PublicCallRequest, - PublicDataUpdateRequest, + PublicDataTreeLeafPreimage, + StateReference, makeEmptyProof, } from '@aztec/circuits.js'; import { computePublicDataTreeLeafSlot } from '@aztec/circuits.js/hash'; -import { - fr, - makeAztecAddress, - makePrivateKernelTailCircuitPublicInputs, - makePublicCallRequest, - makeSelector, -} from '@aztec/circuits.js/testing'; -import { makeTuple } from '@aztec/foundation/array'; -import { arrayNonEmptyLength, times } from '@aztec/foundation/collection'; +import { fr, makeAztecAddress, makePublicCallRequest, makeSelector } from '@aztec/circuits.js/testing'; +import { arrayNonEmptyLength } from '@aztec/foundation/collection'; +import { openTmpStore } from '@aztec/kv-store/utils'; +import { type AppendOnlyTree, Pedersen, StandardTree, newTree } from '@aztec/merkle-tree'; import { type PublicExecutionResult, type PublicExecutor, WASMSimulator } from '@aztec/simulator'; import { type MerkleTreeOperations, type TreeInfo } from '@aztec/world-state'; import { jest } from '@jest/globals'; import { type MockProxy, mock } from 'jest-mock-extended'; -import { PublicExecutionResultBuilder, addKernelPublicCallStack, makeFunctionCall } from '../mocks/fixtures.js'; +import { PublicExecutionResultBuilder, makeFunctionCall } from '../mocks/fixtures.js'; import { type ContractsDataSourcePublicDB, type WorldStatePublicDB } from './public_executor.js'; import { RealPublicKernelCircuitSimulator } from './public_kernel.js'; import { type PublicKernelCircuitSimulator } from './public_kernel_circuit_simulator.js'; @@ -143,17 +137,68 @@ describe('public_processor', () => { describe('with actual circuits', () => { let publicKernel: PublicKernelCircuitSimulator; + let publicDataTree: AppendOnlyTree; + + const mockTxWithPartialState = ( + { + hasLogs = false, + numberOfNonRevertiblePublicCallRequests = 0, + numberOfRevertiblePublicCallRequests = 0, + publicCallRequests = [], + }: { + hasLogs?: boolean; + numberOfNonRevertiblePublicCallRequests?: number; + numberOfRevertiblePublicCallRequests?: number; + publicCallRequests?: PublicCallRequest[]; + } = {}, + seed = 1, + ) => { + return mockTx(seed, { + hasLogs, + numberOfNonRevertiblePublicCallRequests, + numberOfRevertiblePublicCallRequests, + publicCallRequests, + }); + }; + + beforeAll(async () => { + publicDataTree = await newTree( + StandardTree, + openTmpStore(), + new Pedersen(), + 'PublicData', + Fr, + PUBLIC_DATA_TREE_HEIGHT, + 1, // Add a default low leaf for the public data hints to be proved against. + ); + }); beforeEach(() => { - const path = times(PUBLIC_DATA_TREE_HEIGHT, i => Buffer.alloc(32, i)); - db.getSiblingPath.mockResolvedValue(new SiblingPath(PUBLIC_DATA_TREE_HEIGHT, path)); + const snap = new AppendOnlyTreeSnapshot( + Fr.fromBuffer(publicDataTree.getRoot(true)), + Number(publicDataTree.getNumLeaves(true)), + ); + + const header = Header.empty(); + const stateReference = new StateReference( + header.state.l1ToL2MessageTree, + new PartialStateReference(header.state.partial.noteHashTree, header.state.partial.nullifierTree, snap), + ); + // Clone the whole state because somewhere down the line (AbstractPhaseManager) the public data root is modified in the referenced header directly :/ + header.state = StateReference.fromBuffer(stateReference.toBuffer()); + + db.getStateReference.mockResolvedValue(stateReference); + db.getSiblingPath.mockResolvedValue(publicDataTree.getSiblingPath(0n, false)); + db.getPreviousValueIndex.mockResolvedValue({ index: 0n, alreadyPresent: true }); + db.getLeafPreimage.mockResolvedValue(new PublicDataTreeLeafPreimage(new Fr(0), new Fr(0), new Fr(0), 0n)); + publicKernel = new RealPublicKernelCircuitSimulator(new WASMSimulator()); processor = new PublicProcessor( db, publicExecutor, publicKernel, GlobalVariables.empty(), - Header.empty(), + header, publicContractsDB, publicWorldStateDB, ); @@ -166,7 +211,9 @@ describe('public_processor', () => { }); it('runs a tx with enqueued public calls', async function () { - const tx = mockTx(1, { numberOfNonRevertiblePublicCallRequests: 0, numberOfRevertiblePublicCallRequests: 2 }); + const tx = mockTxWithPartialState({ + numberOfRevertiblePublicCallRequests: 2, + }); publicExecutor.simulate.mockImplementation(execution => { for (const request of tx.enqueuedPublicFunctionCalls) { @@ -192,7 +239,7 @@ describe('public_processor', () => { }); it('runs a tx with an enqueued public call with nested execution', async function () { - const tx = mockTx(1, { numberOfNonRevertiblePublicCallRequests: 0, numberOfRevertiblePublicCallRequests: 1 }); + const tx = mockTxWithPartialState({ numberOfRevertiblePublicCallRequests: 1 }); const callRequest = tx.enqueuedPublicFunctionCalls[0]; const publicExecutionResult = PublicExecutionResultBuilder.fromPublicCallRequest({ @@ -223,7 +270,7 @@ describe('public_processor', () => { it('does not attempt to overfill a block', async function () { const txs = Array.from([1, 2, 3], index => - mockTx(index, { numberOfNonRevertiblePublicCallRequests: 0, numberOfRevertiblePublicCallRequests: 1 }), + mockTxWithPartialState({ numberOfRevertiblePublicCallRequests: 1 }, index), ); let txCount = 0; @@ -255,7 +302,7 @@ describe('public_processor', () => { }); it('does not send a transaction to the prover if validation fails', async function () { - const tx = mockTx(1, { numberOfNonRevertiblePublicCallRequests: 0, numberOfRevertiblePublicCallRequests: 1 }); + const tx = mockTxWithPartialState({ numberOfRevertiblePublicCallRequests: 1 }); publicExecutor.simulate.mockImplementation(execution => { for (const request of tx.enqueuedPublicFunctionCalls) { @@ -283,40 +330,21 @@ describe('public_processor', () => { it('rolls back app logic db updates on failed public execution, but persists setup/teardown', async function () { const baseContractAddressSeed = 0x200; const baseContractAddress = makeAztecAddress(baseContractAddressSeed); - const callRequests: PublicCallRequest[] = [ + const publicCallRequests: PublicCallRequest[] = [ baseContractAddressSeed, baseContractAddressSeed, baseContractAddressSeed, ].map(makePublicCallRequest); - callRequests[0].callContext.sideEffectCounter = 2; - callRequests[1].callContext.sideEffectCounter = 3; - callRequests[2].callContext.sideEffectCounter = 4; - - const kernelOutput = makePrivateKernelTailCircuitPublicInputs(0x10); - kernelOutput.forPublic!.endNonRevertibleData.publicDataUpdateRequests = makeTuple( - MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, - PublicDataUpdateRequest.empty, - ); - kernelOutput.forPublic!.end.publicDataUpdateRequests = makeTuple( - MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, - PublicDataUpdateRequest.empty, - ); - - addKernelPublicCallStack(kernelOutput, { - setupCalls: [callRequests[0]], - appLogicCalls: [callRequests[2]], - teardownCall: callRequests[1], + publicCallRequests[0].callContext.sideEffectCounter = 2; + publicCallRequests[1].callContext.sideEffectCounter = 3; + publicCallRequests[2].callContext.sideEffectCounter = 4; + + const tx = mockTxWithPartialState({ + numberOfNonRevertiblePublicCallRequests: 2, + numberOfRevertiblePublicCallRequests: 1, + publicCallRequests, }); - const tx = new Tx( - kernelOutput, - proof, - EncryptedTxL2Logs.empty(), - UnencryptedTxL2Logs.empty(), - // reverse because `enqueuedPublicFunctions` expects the last element to be the front of the queue - callRequests.slice().reverse(), - ); - const contractSlotA = fr(0x100); const contractSlotB = fr(0x150); const contractSlotC = fr(0x200); @@ -325,24 +353,26 @@ describe('public_processor', () => { const simulatorResults: PublicExecutionResult[] = [ // Setup PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[0], - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotA, fr(0x101))], + request: publicCallRequests[0], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotA, fr(0x101), 11, baseContractAddress), + ], }).build(), // App Logic PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[2], + request: publicCallRequests[2], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), contractStorageUpdateRequests: [ - new ContractStorageUpdateRequest(contractSlotA, fr(0x102)), - new ContractStorageUpdateRequest(contractSlotB, fr(0x151)), + new ContractStorageUpdateRequest(contractSlotA, fr(0x102), 13, baseContractAddress), + new ContractStorageUpdateRequest(contractSlotB, fr(0x151), 14, baseContractAddress), ], }).build(), PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), revertReason: new SimulationError('Simulation Failed', []), }).build(), @@ -351,12 +381,14 @@ describe('public_processor', () => { // Teardown PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[1], + request: publicCallRequests[1], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotC, fr(0x201))], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotC, fr(0x201), 12, baseContractAddress), + ], }).build(), ], }).build(), @@ -406,32 +438,21 @@ describe('public_processor', () => { it('fails a transaction that reverts in setup', async function () { const baseContractAddressSeed = 0x200; const baseContractAddress = makeAztecAddress(baseContractAddressSeed); - const callRequests: PublicCallRequest[] = [ + const publicCallRequests: PublicCallRequest[] = [ baseContractAddressSeed, baseContractAddressSeed, baseContractAddressSeed, ].map(makePublicCallRequest); - callRequests[0].callContext.sideEffectCounter = 2; - callRequests[1].callContext.sideEffectCounter = 3; - callRequests[2].callContext.sideEffectCounter = 4; - - const kernelOutput = makePrivateKernelTailCircuitPublicInputs(0x10); - - addKernelPublicCallStack(kernelOutput, { - setupCalls: [callRequests[0]], - appLogicCalls: [callRequests[2]], - teardownCall: callRequests[1], + publicCallRequests[0].callContext.sideEffectCounter = 2; + publicCallRequests[1].callContext.sideEffectCounter = 3; + publicCallRequests[2].callContext.sideEffectCounter = 4; + + const tx = mockTxWithPartialState({ + numberOfNonRevertiblePublicCallRequests: 2, + numberOfRevertiblePublicCallRequests: 1, + publicCallRequests, }); - const tx = new Tx( - kernelOutput, - proof, - EncryptedTxL2Logs.empty(), - UnencryptedTxL2Logs.empty(), - // reverse because `enqueuedPublicFunctions` expects the last element to be the front of the queue - callRequests.slice().reverse(), - ); - const contractSlotA = fr(0x100); const contractSlotB = fr(0x150); const contractSlotC = fr(0x200); @@ -440,19 +461,21 @@ describe('public_processor', () => { const simulatorResults: PublicExecutionResult[] = [ // Setup PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[0], - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotA, fr(0x101))], + request: publicCallRequests[0], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotA, fr(0x101), 11, baseContractAddress), + ], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), contractStorageUpdateRequests: [ - new ContractStorageUpdateRequest(contractSlotA, fr(0x102)), - new ContractStorageUpdateRequest(contractSlotB, fr(0x151)), + new ContractStorageUpdateRequest(contractSlotA, fr(0x102), 12, baseContractAddress), + new ContractStorageUpdateRequest(contractSlotB, fr(0x151), 13, baseContractAddress), ], }).build(), PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), revertReason: new SimulationError('Simulation Failed', []), }).build(), @@ -461,17 +484,19 @@ describe('public_processor', () => { // App Logic PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[2], + request: publicCallRequests[2], }).build(), // Teardown PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[1], + request: publicCallRequests[1], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotC, fr(0x201))], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotC, fr(0x201), 14, baseContractAddress), + ], }).build(), ], }).build(), @@ -511,32 +536,21 @@ describe('public_processor', () => { it('fails a transaction that reverts in teardown', async function () { const baseContractAddressSeed = 0x200; const baseContractAddress = makeAztecAddress(baseContractAddressSeed); - const callRequests: PublicCallRequest[] = [ + const publicCallRequests: PublicCallRequest[] = [ baseContractAddressSeed, baseContractAddressSeed, baseContractAddressSeed, ].map(makePublicCallRequest); - callRequests[0].callContext.sideEffectCounter = 2; - callRequests[1].callContext.sideEffectCounter = 3; - callRequests[2].callContext.sideEffectCounter = 4; - - const kernelOutput = makePrivateKernelTailCircuitPublicInputs(0x10); - - addKernelPublicCallStack(kernelOutput, { - setupCalls: [callRequests[0]], - appLogicCalls: [callRequests[2]], - teardownCall: callRequests[1], + publicCallRequests[0].callContext.sideEffectCounter = 2; + publicCallRequests[1].callContext.sideEffectCounter = 3; + publicCallRequests[2].callContext.sideEffectCounter = 4; + + const tx = mockTxWithPartialState({ + numberOfNonRevertiblePublicCallRequests: 2, + numberOfRevertiblePublicCallRequests: 1, + publicCallRequests, }); - const tx = new Tx( - kernelOutput, - proof, - EncryptedTxL2Logs.empty(), - UnencryptedTxL2Logs.empty(), - // reverse because `enqueuedPublicFunctions` expects the last element to be the front of the queue - callRequests.slice().reverse(), - ); - const contractSlotA = fr(0x100); const contractSlotB = fr(0x150); const contractSlotC = fr(0x200); @@ -545,15 +559,17 @@ describe('public_processor', () => { const simulatorResults: PublicExecutionResult[] = [ // Setup PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[0], - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotA, fr(0x101))], + request: publicCallRequests[0], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotA, fr(0x101), 11, baseContractAddress), + ], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), contractStorageUpdateRequests: [ - new ContractStorageUpdateRequest(contractSlotA, fr(0x102)), - new ContractStorageUpdateRequest(contractSlotB, fr(0x151)), + new ContractStorageUpdateRequest(contractSlotA, fr(0x102), 12, baseContractAddress), + new ContractStorageUpdateRequest(contractSlotB, fr(0x151), 13, baseContractAddress), ], }).build(), ], @@ -561,22 +577,24 @@ describe('public_processor', () => { // App Logic PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[2], + request: publicCallRequests[2], }).build(), // Teardown PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[1], + request: publicCallRequests[1], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), revertReason: new SimulationError('Simulation Failed', []), }).build(), PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotC, fr(0x201))], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotC, fr(0x201), 14, baseContractAddress), + ], }).build(), ], }).build(), @@ -615,42 +633,21 @@ describe('public_processor', () => { it('runs a tx with setup and teardown phases', async function () { const baseContractAddressSeed = 0x200; const baseContractAddress = makeAztecAddress(baseContractAddressSeed); - const callRequests: PublicCallRequest[] = [ + const publicCallRequests: PublicCallRequest[] = [ baseContractAddressSeed, baseContractAddressSeed, baseContractAddressSeed, ].map(makePublicCallRequest); - callRequests[0].callContext.sideEffectCounter = 2; - callRequests[1].callContext.sideEffectCounter = 3; - callRequests[2].callContext.sideEffectCounter = 4; - - const kernelOutput = makePrivateKernelTailCircuitPublicInputs(0x10); - kernelOutput.forPublic!.end.encryptedLogsHash = Fr.ZERO; - kernelOutput.forPublic!.end.unencryptedLogsHash = Fr.ZERO; - kernelOutput.forPublic!.endNonRevertibleData.publicDataUpdateRequests = makeTuple( - MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, - PublicDataUpdateRequest.empty, - ); - kernelOutput.forPublic!.end.publicDataUpdateRequests = makeTuple( - MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, - PublicDataUpdateRequest.empty, - ); - - addKernelPublicCallStack(kernelOutput, { - setupCalls: [callRequests[0]], - appLogicCalls: [callRequests[2]], - teardownCall: callRequests[1], + publicCallRequests[0].callContext.sideEffectCounter = 2; + publicCallRequests[1].callContext.sideEffectCounter = 3; + publicCallRequests[2].callContext.sideEffectCounter = 4; + + const tx = mockTxWithPartialState({ + numberOfNonRevertiblePublicCallRequests: 2, + numberOfRevertiblePublicCallRequests: 1, + publicCallRequests, }); - const tx = new Tx( - kernelOutput, - proof, - EncryptedTxL2Logs.empty(), - UnencryptedTxL2Logs.empty(), - // reverse because `enqueuedPublicFunctions` expects the last element to be the front of the queue - callRequests.slice().reverse(), - ); - // const baseContractAddress = makeAztecAddress(30); const contractSlotA = fr(0x100); const contractSlotB = fr(0x150); @@ -659,33 +656,35 @@ describe('public_processor', () => { let simulatorCallCount = 0; const simulatorResults: PublicExecutionResult[] = [ // Setup - PublicExecutionResultBuilder.fromPublicCallRequest({ request: callRequests[0] }).build(), + PublicExecutionResultBuilder.fromPublicCallRequest({ request: publicCallRequests[0] }).build(), // App Logic PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[2], + request: publicCallRequests[2], contractStorageUpdateRequests: [ - new ContractStorageUpdateRequest(contractSlotA, fr(0x101)), - new ContractStorageUpdateRequest(contractSlotB, fr(0x151)), + new ContractStorageUpdateRequest(contractSlotA, fr(0x101), 14, baseContractAddress), + new ContractStorageUpdateRequest(contractSlotB, fr(0x151), 15, baseContractAddress), ], }).build(), // Teardown PublicExecutionResultBuilder.fromPublicCallRequest({ - request: callRequests[1], + request: publicCallRequests[1], nestedExecutions: [ PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), contractStorageUpdateRequests: [ - new ContractStorageUpdateRequest(contractSlotA, fr(0x101)), - new ContractStorageUpdateRequest(contractSlotC, fr(0x201)), + new ContractStorageUpdateRequest(contractSlotA, fr(0x101), 11, baseContractAddress), + new ContractStorageUpdateRequest(contractSlotC, fr(0x201), 12, baseContractAddress), ], }).build(), PublicExecutionResultBuilder.fromFunctionCall({ - from: callRequests[1].contractAddress, + from: publicCallRequests[1].contractAddress, tx: makeFunctionCall(baseContractAddress, makeSelector(5)), - contractStorageUpdateRequests: [new ContractStorageUpdateRequest(contractSlotA, fr(0x102))], + contractStorageUpdateRequests: [ + new ContractStorageUpdateRequest(contractSlotA, fr(0x102), 13, baseContractAddress), + ], }).build(), ], }).build(), diff --git a/yarn-project/simulator/src/public/state_actions.ts b/yarn-project/simulator/src/public/state_actions.ts index a4b63c54a60..cd25d82f669 100644 --- a/yarn-project/simulator/src/public/state_actions.ts +++ b/yarn-project/simulator/src/public/state_actions.ts @@ -83,6 +83,7 @@ export class ContractStorageActionsCollector { public collect(): [ContractStorageRead[], ContractStorageUpdateRequest[]] { const reads = Array.from(this.contractStorageReads.entries()).map(([slot, valueAndCounter]) => ContractStorageRead.from({ + contractAddress: this.address, storageSlot: new Fr(slot), ...valueAndCounter, }), @@ -90,6 +91,7 @@ export class ContractStorageActionsCollector { const updateRequests = Array.from(this.contractStorageUpdateRequests.entries()).map(([slot, valuesAndCounter]) => ContractStorageUpdateRequest.from({ + contractAddress: this.address, storageSlot: new Fr(slot), ...valuesAndCounter, }), diff --git a/yarn-project/simulator/src/public/tail_phase_manager.ts b/yarn-project/simulator/src/public/tail_phase_manager.ts index c1899ae2d72..56d12b124c5 100644 --- a/yarn-project/simulator/src/public/tail_phase_manager.ts +++ b/yarn-project/simulator/src/public/tail_phase_manager.ts @@ -5,6 +5,8 @@ import { type Header, type KernelCircuitPublicInputs, MAX_NEW_NOTE_HASHES_PER_TX, + MAX_NEW_NULLIFIERS_PER_TX, + MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, type Proof, type PublicKernelCircuitPublicInputs, PublicKernelTailCircuitPrivateInputs, @@ -88,27 +90,59 @@ export class TailPhaseManager extends AbstractPhaseManager { previousOutput: PublicKernelCircuitPublicInputs, previousProof: Proof, ): Promise<[PublicKernelTailCircuitPrivateInputs, KernelCircuitPublicInputs]> { + const inputs = await this.buildPrivateInputs(previousOutput, previousProof); + // We take a deep copy (clone) of these to pass to the prover + return [inputs.clone(), await this.publicKernel.publicKernelCircuitTail(inputs)]; + } + + private async buildPrivateInputs(previousOutput: PublicKernelCircuitPublicInputs, previousProof: Proof) { const previousKernel = this.getPreviousKernelData(previousOutput, previousProof); const { validationRequests, endNonRevertibleData, end } = previousOutput; - const nullifierReadRequestHints = await this.hintsBuilder.getNullifierReadRequestHints( - validationRequests.nullifierReadRequests, + + const pendingNullifiers = mergeAccumulatedData( + MAX_NEW_NULLIFIERS_PER_TX, endNonRevertibleData.newNullifiers, end.newNullifiers, ); + + const nullifierReadRequestHints = await this.hintsBuilder.getNullifierReadRequestHints( + validationRequests.nullifierReadRequests, + pendingNullifiers, + ); + const nullifierNonExistentReadRequestHints = await this.hintsBuilder.getNullifierNonExistentReadRequestHints( validationRequests.nullifierNonExistentReadRequests, - endNonRevertibleData.newNullifiers, - end.newNullifiers, + pendingNullifiers, ); - // We take a deep copy (clone) of these to pass to the prover - const inputs = new PublicKernelTailCircuitPrivateInputs( + const pendingPublicDataWrites = mergeAccumulatedData( + MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, + endNonRevertibleData.publicDataUpdateRequests, + end.publicDataUpdateRequests, + ); + + const publicDataHints = await this.hintsBuilder.getPublicDataHints( + validationRequests.publicDataReads, + pendingPublicDataWrites, + ); + + const publicDataReadRequestHints = this.hintsBuilder.getPublicDataReadRequestHints( + validationRequests.publicDataReads, + pendingPublicDataWrites, + publicDataHints, + ); + + const currentState = await this.db.getStateReference(); + + return new PublicKernelTailCircuitPrivateInputs( previousKernel, nullifierReadRequestHints, nullifierNonExistentReadRequestHints, + publicDataHints, + publicDataReadRequestHints, + currentState.partial, ); - return [inputs.clone(), await this.publicKernel.publicKernelCircuitTail(inputs)]; } private sortNoteHashes(noteHashes: Tuple): Tuple { diff --git a/yarn-project/simulator/src/public/transitional_adaptors.ts b/yarn-project/simulator/src/public/transitional_adaptors.ts index 81bd36011e6..ddd72e75e6d 100644 --- a/yarn-project/simulator/src/public/transitional_adaptors.ts +++ b/yarn-project/simulator/src/public/transitional_adaptors.ts @@ -112,10 +112,10 @@ export async function convertAvmResults( const execution = executionContext.execution; const contractStorageReads: ContractStorageRead[] = newWorldState.storageReads.map( - read => new ContractStorageRead(read.slot, read.value, read.counter.toNumber()), + read => new ContractStorageRead(read.slot, read.value, read.counter.toNumber(), read.storageAddress), ); const contractStorageUpdateRequests: ContractStorageUpdateRequest[] = newWorldState.storageWrites.map( - write => new ContractStorageUpdateRequest(write.slot, write.value, write.counter.toNumber()), + write => new ContractStorageUpdateRequest(write.slot, write.value, write.counter.toNumber(), write.storageAddress), ); // We need to write the storage updates to the DB, because that's what the ACVM expects. // Assumes the updates are in the right order. From dd3a521b59b950871645306179d23a3f332ef6f3 Mon Sep 17 00:00:00 2001 From: ludamad Date: Wed, 17 Apr 2024 10:13:15 -0400 Subject: [PATCH 54/56] chore: workaround earthly flake (#5811) Unfortunate but rare issue I saw crop up --- .github/workflows/ci.yml | 13 ++++--- scripts/earthly-ci | 36 +++++++++++++++++ scripts/earthly-cloud | 84 ---------------------------------------- scripts/setup_env.sh | 2 +- 4 files changed, 44 insertions(+), 91 deletions(-) create mode 100755 scripts/earthly-ci delete mode 100755 scripts/earthly-cloud diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 72b97bb2e1d..44a736a22c2 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -44,8 +44,9 @@ jobs: # prepare images locally, tagged by commit hash - name: "Build E2E Image" timeout-minutes: 40 - run: earthly ./yarn-project+export-end-to-end + run: earthly-ci ./yarn-project+export-end-to-end # We base our e2e list used in e2e-x86 off the targets in ./yarn-project/end-to-end + # (Note ARM uses just 2 tests as a smoketest) - name: Create list of end-to-end jobs id: e2e_list run: echo "list=$(earthly ls ./yarn-project/end-to-end | grep -v '+base' | sed 's/+//' | jq -R . | jq -cs .)" >> $GITHUB_OUTPUT @@ -68,7 +69,7 @@ jobs: - name: Test working-directory: ./yarn-project/end-to-end/ timeout-minutes: 25 - run: earthly -P --no-output +${{ matrix.test }} --e2e_mode=cache + run: earthly-ci -P --no-output +${{ matrix.test }} --e2e_mode=cache # TODO # - name: Upload logs # run: BRANCH=${{ github.ref_name }} PULL_REQUEST=${{ github.event.number }} scripts/ci/upload_logs_to_s3 ./yarn-project/end-to-end/log @@ -92,7 +93,7 @@ jobs: working-directory: ./barretenberg/cpp/ timeout-minutes: 25 # limit our parallelism to half our cores - run: earthly --no-output +test --hardware_concurrency=64 + run: earthly-ci --no-output +test --hardware_concurrency=64 # push benchmarking binaries to dockerhub registry bb-bench-binaries: @@ -108,7 +109,7 @@ jobs: if: ${{ github.event.inputs.just_start_spot != 'true' }} timeout-minutes: 15 working-directory: ./barretenberg/cpp/ - run: earthly --push +bench-binaries + run: earthly-ci --push +bench-binaries setup-bench: uses: ./.github/workflows/setup-runner.yml @@ -136,12 +137,12 @@ jobs: - name: Client IVC Bench working-directory: ./barretenberg/cpp/ timeout-minutes: 15 - run: earthly --no-output +bench-client-ivc --bench_mode=cache + run: earthly-ci --no-output +bench-client-ivc --bench_mode=cache - name: Ultrahonk Bench working-directory: ./barretenberg/cpp/ timeout-minutes: 15 - run: earthly --no-output +bench-ultra-honk --bench_mode=cache + run: earthly-ci --no-output +bench-ultra-honk --bench_mode=cache merge-check: runs-on: ${{ github.actor }}-x86 diff --git a/scripts/earthly-ci b/scripts/earthly-ci new file mode 100755 index 00000000000..43eeb9b17aa --- /dev/null +++ b/scripts/earthly-ci @@ -0,0 +1,36 @@ +#!/usr/bin/env bash +# A wrapper for Earthly that is meant to caught signs of known intermittent failures and continue. +# The silver lining is if Earthly does crash, the cache can pick up the build. +set -eu -o pipefail + +# Flag to determine if -i is present +INTERACTIVE=false +# Check for -i flag in the arguments +for arg in "$@"; do + if [ "$arg" == "-i" ] || [ "$arg" == "--interactive" ]; then + INTERACTIVE=true + break + fi +done + +OUTPUT_FILE=$(mktemp) +# capture output to handle earthly edge cases +if $INTERACTIVE ; then + # don't play nice with tee if interactive + earthly $@ +elif ! earthly $@ 2>&1 | tee $OUTPUT_FILE >&2 ; then + # we try earthly once, capturing output + # if we get one of our (unfortunate) known failures, handle retries + # TODO potentially handle other intermittent errors here + if grep 'failed to get edge: inconsistent graph state' $OUTPUT_FILE >/dev/null ; then + # TODO when earthly is overloaded we sometimes get + # 'failed to solve: failed to get edge: inconsistent graph state' + echo "Got 'inconsistent graph state'. Restarting earthly. See https://github.com/earthly/earthly/issues/2454'" + earthly $@ + # TODO handle + # could not configure satellite: failed getting org: unable to authenticate: failed to execute login request: Post + else + # otherwise, propagate error + exit 1 + fi +fi diff --git a/scripts/earthly-cloud b/scripts/earthly-cloud deleted file mode 100755 index d2a0e39bc2c..00000000000 --- a/scripts/earthly-cloud +++ /dev/null @@ -1,84 +0,0 @@ -#!/usr/bin/env bash - -# This script uses Earthly cloud satellites based on a runner type and hash of the GITHUB_ACTOR environment variable. -# ARM or x86 can be specified. -# Usage: earthly-cloud [options] -# Arguments: -# runner type: The type of runner, e.g., 'build' or 'bench'. -# architecture: The target architecture, e.g., 'arm' or 'x86'. -set -eu -o pipefail - -# Check if at least two arguments are passed -if [ $# -lt 2 ]; then - echo "Error: Insufficient arguments provided." - echo "Usage: $0 [options]" - exit 1 -fi - -RUNNER_TYPE=$1 -ARCH=$2 -shift 2 - -if [ "$ARCH" == "arm" ]; then - PLATFORM=linux/arm64 -elif [ "$ARCH" == "x86" ]; then - PLATFORM=linux/amd64 -fi - -# default sizes for build type -if [ "$RUNNER_TYPE" == "build" ] ; then - SIZE=4xlarge - NUMBER_OF_RUNNERS=2 - if [ "$ARCH" = arm ] ; then - NUMBER_OF_RUNNERS=1 - fi - # TODO why cant we set this?? - # MAX_PARALLELISM=8 -elif [ "$RUNNER_TYPE" == "bench" ] ; then - SIZE=2xlarge - NUMBER_OF_RUNNERS=1 - # MAX_PARALLELISM=1 -elif [ "$RUNNER_TYPE" == "test" ] ; then - SIZE=4xlarge - NUMBER_OF_RUNNERS=1 -fi - -# Flag to determine if -i is present -INTERACTIVE=false -# Check for -i flag in the arguments -for arg in "$@"; do - if [ "$arg" == "-i" ] || [ "$arg" == "--interactive" ]; then - INTERACTIVE=true - break - fi -done - -# we hash our GITHUB_ACTOR to pick from 1 to NUMBER_RUNNERS (inclusive) as RUNNER_ID -# this means everyone gets assigned to runners based on their user group -NAME_HASH=$(cksum <<< "$GITHUB_ACTOR" | cut -f 1 -d ' ') -RUNNER_ID=$(($NAME_HASH % $NUMBER_OF_RUNNERS + 1)) -RUNNER=$RUNNER_TYPE-$RUNNER_ID-$ARCH -earthly sat --org aztec launch --size $SIZE --platform $PLATFORM $RUNNER || true -# --remote-cache=aztecprotocol/cache:bb-native-tests -EARTHLY_FLAGS="-P --no-output --org aztec --sat $RUNNER" -OUTPUT_FILE=$(mktemp) -# capture output to handle earthly edge cases -if $INTERACTIVE ; then - # don't play nice with tee if interactive - earthly $EARTHLY_FLAGS $@ -elif ! earthly $EARTHLY_FLAGS $@ 2>&1 | tee $OUTPUT_FILE >&2 ; then - # we try earthly once, capturing output - # if we get one of our (unfortunate) known failures, handle retries - # TODO potentially handle other intermittent errors here - if grep 'failed to get edge: inconsistent graph state' $OUTPUT_FILE >/dev/null ; then - # TODO when earthly is overloaded we sometimes get - # 'failed to solve: failed to get edge: inconsistent graph state' - echo "Got 'inconsistent graph state'. Restarting earthly. See https://github.com/earthly/earthly/issues/2454'" - earthly $EARTHLY_FLAGS $@ - # TODO handle - # could not configure satellite: failed getting org: unable to authenticate: failed to execute login request: Post - else - # otherwise, propagate error - exit 1 - fi -fi diff --git a/scripts/setup_env.sh b/scripts/setup_env.sh index 97fb8fd68a1..70ecf9d7654 100755 --- a/scripts/setup_env.sh +++ b/scripts/setup_env.sh @@ -8,6 +8,6 @@ echo FORCE_COLOR=1 >> $GITHUB_ENV echo "Logging in to Docker..." echo $1 | docker login -u aztecprotocolci --password-stdin -# Make earthly-cloud and earthly-cloud-bench scripts available +# Make earthly-ci script available echo "PATH=$(dirname $(realpath $0)):$PATH" >> $GITHUB_ENV echo "EARTHLY_CONFIG=$(git rev-parse --show-toplevel)/.github/earthly-ci-config.yml" >> $GITHUB_ENV \ No newline at end of file From 96da3334af2b4b1815f9d3eb9839840c0b76d5bc Mon Sep 17 00:00:00 2001 From: ludamad Date: Wed, 17 Apr 2024 10:13:42 -0400 Subject: [PATCH 55/56] fix: start spot label (#5810) --- .github/workflows/start-spot.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/start-spot.yml b/.github/workflows/start-spot.yml index 2cbc0e8415d..350d6520cd8 100644 --- a/.github/workflows/start-spot.yml +++ b/.github/workflows/start-spot.yml @@ -1,5 +1,5 @@ # Useful if the spot runners are in a bad state -name: Stop Personal Spot +name: Start Personal Spot on: workflow_dispatch: {} jobs: @@ -27,4 +27,4 @@ jobs: ec2_instance_type: m6a.4xlarge ec2_ami_id: ami-0d8a9b0419ddb331a ec2_instance_ttl: 15 - secrets: inherit \ No newline at end of file + secrets: inherit From 84c930a912ca9ed0d9c0ce2436309a4e9a840bcb Mon Sep 17 00:00:00 2001 From: Aztec Bot <49558828+AztecBot@users.noreply.github.com> Date: Wed, 17 Apr 2024 10:53:09 -0400 Subject: [PATCH 56/56] feat: Sync from noir (#5794) Automated pull of development from the [noir](https://github.com/noir-lang/noir) programming language, a dependency of Aztec. BEGIN_COMMIT_OVERRIDE chore: fix alerts on rust msrv (https://github.com/noir-lang/noir/pull/4817) chore(ci): fix alerts on msrv issues (https://github.com/noir-lang/noir/pull/4816) chore: run clippy (https://github.com/noir-lang/noir/pull/4810) chore: optimize poseidon2 implementation (https://github.com/noir-lang/noir/pull/4807) fix: catch panics from EC point creation (e.g. the point is at infinity) (https://github.com/noir-lang/noir/pull/4790) feat: Sync from aztec-packages (https://github.com/noir-lang/noir/pull/4792) feat: lalrpop lexer prototype (https://github.com/noir-lang/noir/pull/4656) feat(nargo): Handle call stacks for multiple Acir calls (https://github.com/noir-lang/noir/pull/4711) fix: proper field inversion for bigints (https://github.com/noir-lang/noir/pull/4802) feat: add `NARGO_FOREIGN_CALL_TIMEOUT` environment variable (https://github.com/noir-lang/noir/pull/4780) chore(debugger): Docs (https://github.com/noir-lang/noir/pull/4145) feat: narrow ABI encoding errors down to target problem argument/field (https://github.com/noir-lang/noir/pull/4798) chore: Rename 'global' to 'function' in the monomorphization pass (https://github.com/noir-lang/noir/pull/4774) chore: Add Hir -> Ast conversion (https://github.com/noir-lang/noir/pull/4788) fix: Fix panic when returning a zeroed unit value (https://github.com/noir-lang/noir/pull/4797) END_COMMIT_OVERRIDE --------- Co-authored-by: vezenovm Co-authored-by: Tom French <15848336+TomAFrench@users.noreply.github.com> --- .noir-sync-commit | 2 +- avm-transpiler/Cargo.lock | 342 +++- .../workflows/test-rust-workspace-msrv.yml | 6 +- noir/noir-repo/.gitignore | 1 + noir/noir-repo/Cargo.lock | 127 +- .../acvm-repo/acir/src/circuit/mod.rs | 10 + .../acvm-repo/acvm/src/pwg/blackbox/bigint.rs | 2 +- .../bn254_blackbox_solver/Cargo.toml | 15 +- .../benches/criterion.rs | 21 + .../src/fixed_base_scalar_mul.rs | 46 +- .../bn254_blackbox_solver/src/lib.rs | 5 +- .../bn254_blackbox_solver/src/poseidon2.rs | 1386 ++++++----------- .../compiler/noirc_driver/src/contract.rs | 2 +- .../compiler/noirc_driver/src/lib.rs | 10 +- .../compiler/noirc_driver/src/program.rs | 2 +- .../compiler/noirc_errors/src/debug_info.rs | 79 +- .../noirc_evaluator/src/ssa/ssa_gen/mod.rs | 1 + .../compiler/noirc_frontend/Cargo.toml | 7 + .../compiler/noirc_frontend/build.rs | 28 + .../compiler/noirc_frontend/src/ast/mod.rs | 4 + .../src/hir/comptime/hir_to_ast.rs | 350 +++++ .../noirc_frontend/src/hir/comptime/mod.rs | 1 + .../compiler/noirc_frontend/src/hir/mod.rs | 1 + .../src/hir/resolution/resolver.rs | 1 + .../noirc_frontend/src/lexer/lexer.rs | 30 +- .../noirc_frontend/src/lexer/token.rs | 150 ++ .../src/monomorphization/ast.rs | 1 + .../src/monomorphization/mod.rs | 25 +- .../src/monomorphization/printer.rs | 3 + .../noirc_frontend/src/node_interner.rs | 4 + .../noirc_frontend/src/noir_parser.lalrpop | 164 ++ .../noirc_frontend/src/parser/errors.rs | 14 +- .../compiler/noirc_frontend/src/parser/mod.rs | 13 +- .../noirc_frontend/src/parser/parser.rs | 151 +- .../compiler/wasm/src/types/noir_artifact.ts | 10 + .../wasm/test/compiler/shared/compile.test.ts | 13 +- noir/noir-repo/cspell.json | 1 + noir/noir-repo/deny.toml | 3 +- .../docs/getting_started/tooling/index.mdx | 38 - .../docs/docs/how_to/debugger/_category_.json | 6 + .../debugger/debugging_with_the_repl.md | 164 ++ .../how_to/debugger/debugging_with_vs_code.md | 68 + .../docs/docs/how_to/merkle-proof.mdx | 1 + .../docs/docs/noir/concepts/functions.md | 4 +- .../docs/docs/noir/concepts/oracles.md | 8 + .../debugger}/_category_.json | 4 +- .../debugger/debugger_known_limitations.md | 59 + .../docs/reference/debugger/debugger_repl.md | 360 +++++ .../reference/debugger/debugger_vscode.md | 82 + noir/noir-repo/docs/docs/tooling/debugger.md | 27 + .../tooling/language_server.md | 0 .../{getting_started => }/tooling/testing.md | 0 noir/noir-repo/docs/sidebars.js | 5 + .../docs/static/img/debugger/1-started.png | Bin 0 -> 786947 bytes .../docs/static/img/debugger/2-icon.png | Bin 0 -> 27014 bytes .../docs/static/img/debugger/3-debug-pane.png | Bin 0 -> 83927 bytes .../img/debugger/4-debugger-buttons.png | Bin 0 -> 12345 bytes .../docs/static/img/debugger/5-assert.png | Bin 0 -> 512053 bytes .../docs/static/img/debugger/6-hover.png | Bin 0 -> 292419 bytes .../docs/static/img/debugger/7-break.png | Bin 0 -> 627627 bytes .../static/img/debugger/debugger-intro.gif | Bin 0 -> 1260930 bytes .../img/debugger/ref1-create-launch.png | Bin 0 -> 113387 bytes .../fold_dyn_index_fail/Nargo.toml | 7 + .../fold_dyn_index_fail/Prover.toml | 2 + .../fold_dyn_index_fail/src/main.nr | 10 + .../Nargo.toml | 7 + .../Prover.toml | 1 + .../src/main.nr | 26 + .../execution_success/bigint/src/main.nr | 8 +- .../execution_success/unit_value/Nargo.toml | 7 + .../execution_success/unit_value/src/main.nr | 7 + .../noir-repo/tooling/debugger/src/context.rs | 6 +- noir/noir-repo/tooling/debugger/src/dap.rs | 2 +- .../tooling/lsp/src/requests/profile_run.rs | 19 +- .../tooling/nargo/src/artifacts/contract.rs | 10 +- .../tooling/nargo/src/artifacts/debug.rs | 4 +- .../tooling/nargo/src/artifacts/program.rs | 12 +- noir/noir-repo/tooling/nargo/src/errors.rs | 104 +- .../tooling/nargo/src/ops/execute.rs | 73 +- .../tooling/nargo/src/ops/foreign_calls.rs | 9 +- .../tooling/nargo/src/ops/optimize.rs | 33 +- noir/noir-repo/tooling/nargo/src/ops/test.rs | 2 +- .../tooling/nargo/src/ops/transform.rs | 45 +- .../tooling/nargo_cli/src/cli/debug_cmd.rs | 2 +- .../tooling/nargo_cli/src/cli/execute_cmd.rs | 2 +- .../tooling/nargo_cli/src/cli/info_cmd.rs | 12 +- .../tooling/nargo_fmt/src/rewrite/typ.rs | 1 + .../noir-repo/tooling/noirc_abi/src/errors.rs | 9 +- .../tooling/noirc_abi/src/input_parser/mod.rs | 157 +- noir/noir-repo/tooling/noirc_abi/src/lib.rs | 10 +- .../test/browser/errors.test.ts | 2 +- .../noirc_abi_wasm/test/node/errors.test.ts | 2 +- yarn-project/foundation/src/abi/abi.ts | 17 +- 93 files changed, 3190 insertions(+), 1275 deletions(-) create mode 100644 noir/noir-repo/acvm-repo/bn254_blackbox_solver/benches/criterion.rs create mode 100644 noir/noir-repo/compiler/noirc_frontend/build.rs create mode 100644 noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/hir_to_ast.rs create mode 100644 noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/mod.rs create mode 100644 noir/noir-repo/compiler/noirc_frontend/src/noir_parser.lalrpop delete mode 100644 noir/noir-repo/docs/docs/getting_started/tooling/index.mdx create mode 100644 noir/noir-repo/docs/docs/how_to/debugger/_category_.json create mode 100644 noir/noir-repo/docs/docs/how_to/debugger/debugging_with_the_repl.md create mode 100644 noir/noir-repo/docs/docs/how_to/debugger/debugging_with_vs_code.md rename noir/noir-repo/docs/docs/{getting_started/tooling => reference/debugger}/_category_.json (53%) create mode 100644 noir/noir-repo/docs/docs/reference/debugger/debugger_known_limitations.md create mode 100644 noir/noir-repo/docs/docs/reference/debugger/debugger_repl.md create mode 100644 noir/noir-repo/docs/docs/reference/debugger/debugger_vscode.md create mode 100644 noir/noir-repo/docs/docs/tooling/debugger.md rename noir/noir-repo/docs/docs/{getting_started => }/tooling/language_server.md (100%) rename noir/noir-repo/docs/docs/{getting_started => }/tooling/testing.md (100%) create mode 100644 noir/noir-repo/docs/static/img/debugger/1-started.png create mode 100644 noir/noir-repo/docs/static/img/debugger/2-icon.png create mode 100644 noir/noir-repo/docs/static/img/debugger/3-debug-pane.png create mode 100644 noir/noir-repo/docs/static/img/debugger/4-debugger-buttons.png create mode 100644 noir/noir-repo/docs/static/img/debugger/5-assert.png create mode 100644 noir/noir-repo/docs/static/img/debugger/6-hover.png create mode 100644 noir/noir-repo/docs/static/img/debugger/7-break.png create mode 100644 noir/noir-repo/docs/static/img/debugger/debugger-intro.gif create mode 100644 noir/noir-repo/docs/static/img/debugger/ref1-create-launch.png create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_dyn_index_fail/Nargo.toml create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_dyn_index_fail/Prover.toml create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_dyn_index_fail/src/main.nr create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_nested_brillig_assert_fail/Nargo.toml create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_nested_brillig_assert_fail/Prover.toml create mode 100644 noir/noir-repo/test_programs/execution_failure/fold_nested_brillig_assert_fail/src/main.nr create mode 100644 noir/noir-repo/test_programs/execution_success/unit_value/Nargo.toml create mode 100644 noir/noir-repo/test_programs/execution_success/unit_value/src/main.nr diff --git a/.noir-sync-commit b/.noir-sync-commit index 64da23777cd..f45e08b4171 100644 --- a/.noir-sync-commit +++ b/.noir-sync-commit @@ -1 +1 @@ -1d96937a8e94a91c0c17c97102498d067fca76c3 +053d5e8879865c25ac2bfcfd206a6b729d328b9c diff --git a/avm-transpiler/Cargo.lock b/avm-transpiler/Cargo.lock index b99f5b35be6..629248c8136 100644 --- a/avm-transpiler/Cargo.lock +++ b/avm-transpiler/Cargo.lock @@ -185,7 +185,7 @@ dependencies = [ "ark-std", "derivative", "hashbrown 0.13.2", - "itertools", + "itertools 0.10.5", "num-traits", "zeroize", ] @@ -202,7 +202,7 @@ dependencies = [ "ark-std", "derivative", "digest", - "itertools", + "itertools 0.10.5", "num-bigint", "num-traits", "paste", @@ -291,6 +291,15 @@ version = "0.7.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711" +[[package]] +name = "ascii-canvas" +version = "3.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8824ecca2e851cec16968d54a01dd372ef8f95b244fb84b84e70128be347c3c6" +dependencies = [ + "term", +] + [[package]] name = "autocfg" version = "1.1.0" @@ -355,6 +364,33 @@ dependencies = [ "serde", ] +[[package]] +name = "bit-set" +version = "0.5.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0700ddab506f33b20a03b13996eccd309a48e5ff77d0d95926aa0210fb4e95f1" +dependencies = [ + "bit-vec", +] + +[[package]] +name = "bit-vec" +version = "0.6.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "349f9b6a179ed607305526ca489b34ad0a41aed5f7980fa90eb03160b69598fb" + +[[package]] +name = "bitflags" +version = "1.3.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a" + +[[package]] +name = "bitflags" +version = "2.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "cf4b9d6a944f767f8e5e0db018570623c85f3d925ac718db4e06d0187adb21c1" + [[package]] name = "bitmaps" version = "2.1.0" @@ -464,7 +500,7 @@ dependencies = [ "num-traits", "serde", "wasm-bindgen", - "windows-targets", + "windows-targets 0.52.0", ] [[package]] @@ -587,6 +623,12 @@ dependencies = [ "cfg-if", ] +[[package]] +name = "crunchy" +version = "0.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7" + [[package]] name = "crypto-bigint" version = "0.4.9" @@ -686,6 +728,27 @@ dependencies = [ "subtle", ] +[[package]] +name = "dirs-next" +version = "2.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b98cf8ebf19c3d1b223e151f99a4f9f0690dca41414773390fc824184ac833e1" +dependencies = [ + "cfg-if", + "dirs-sys-next", +] + +[[package]] +name = "dirs-sys-next" +version = "0.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4ebda144c4fe02d1f7ea1a7d9641b6fc6b580adcfa024ae48797ecdeb6825b4d" +dependencies = [ + "libc", + "redox_users", + "winapi", +] + [[package]] name = "ecdsa" version = "0.14.8" @@ -724,6 +787,15 @@ dependencies = [ "zeroize", ] +[[package]] +name = "ena" +version = "0.14.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c533630cf40e9caa44bd91aadc88a75d75a4c3a12b4cfde353cbed41daa1e1f1" +dependencies = [ + "log", +] + [[package]] name = "env_filter" version = "0.1.0" @@ -970,6 +1042,15 @@ dependencies = [ "either", ] +[[package]] +name = "itertools" +version = "0.11.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57" +dependencies = [ + "either", +] + [[package]] name = "itoa" version = "1.0.10" @@ -1018,12 +1099,63 @@ dependencies = [ "cpufeatures", ] +[[package]] +name = "lalrpop" +version = "0.20.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "55cb077ad656299f160924eb2912aa147d7339ea7d69e1b5517326fdcec3c1ca" +dependencies = [ + "ascii-canvas", + "bit-set", + "ena", + "itertools 0.11.0", + "lalrpop-util", + "petgraph", + "pico-args", + "regex", + "regex-syntax", + "string_cache", + "term", + "tiny-keccak", + "unicode-xid", + "walkdir", +] + +[[package]] +name = "lalrpop-util" +version = "0.20.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "507460a910eb7b32ee961886ff48539633b788a36b65692b95f225b844c82553" +dependencies = [ + "regex-automata", +] + [[package]] name = "libc" version = "0.2.153" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd" +[[package]] +name = "libredox" +version = "0.1.3" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c0ff37bd590ca25063e35af745c343cb7a0271906fb7b37e4813e8f79f00268d" +dependencies = [ + "bitflags 2.5.0", + "libc", +] + +[[package]] +name = "lock_api" +version = "0.4.11" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3c168f8615b12bc01f9c17e2eb0cc07dcae1940121185446edc3744920e8ef45" +dependencies = [ + "autocfg", + "scopeguard", +] + [[package]] name = "log" version = "0.4.20" @@ -1056,6 +1188,12 @@ dependencies = [ "serde_json", ] +[[package]] +name = "new_debug_unreachable" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086" + [[package]] name = "noirc_abi" version = "0.27.0" @@ -1136,6 +1274,8 @@ dependencies = [ "chumsky", "fm", "iter-extended", + "lalrpop", + "lalrpop-util", "noirc_errors", "noirc_printable_type", "petgraph", @@ -1209,6 +1349,29 @@ dependencies = [ "sha2", ] +[[package]] +name = "parking_lot" +version = "0.12.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f" +dependencies = [ + "lock_api", + "parking_lot_core", +] + +[[package]] +name = "parking_lot_core" +version = "0.9.9" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4c42a9226546d68acdd9c0a280d17ce19bfe27a46bf68784e4066115788d008e" +dependencies = [ + "cfg-if", + "libc", + "redox_syscall", + "smallvec", + "windows-targets 0.48.5", +] + [[package]] name = "paste" version = "1.0.14" @@ -1225,6 +1388,21 @@ dependencies = [ "indexmap 2.2.1", ] +[[package]] +name = "phf_shared" +version = "0.10.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b6796ad771acdc0123d2a88dc428b5e38ef24456743ddb1744ed628f9815c096" +dependencies = [ + "siphasher", +] + +[[package]] +name = "pico-args" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315" + [[package]] name = "pin-project-lite" version = "0.2.13" @@ -1253,6 +1431,12 @@ version = "0.2.17" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de" +[[package]] +name = "precomputed-hash" +version = "0.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c" + [[package]] name = "proc-macro2" version = "1.0.78" @@ -1309,6 +1493,26 @@ dependencies = [ "rand_core", ] +[[package]] +name = "redox_syscall" +version = "0.4.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa" +dependencies = [ + "bitflags 1.3.2", +] + +[[package]] +name = "redox_users" +version = "0.4.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "bd283d9651eeda4b2a83a43c1c91b266c40fd76ecd39a50a8c630ae69dc72891" +dependencies = [ + "getrandom", + "libredox", + "thiserror", +] + [[package]] name = "regex" version = "1.10.3" @@ -1398,6 +1602,12 @@ dependencies = [ "semver", ] +[[package]] +name = "rustversion" +version = "1.0.15" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "80af6f9131f277a45a3fba6ce8e2258037bb0477a67e610d3c1fe046ab31de47" + [[package]] name = "ryu" version = "1.0.16" @@ -1466,6 +1676,12 @@ dependencies = [ "winapi-util", ] +[[package]] +name = "scopeguard" +version = "1.2.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49" + [[package]] name = "sec1" version = "0.3.0" @@ -1595,6 +1811,12 @@ dependencies = [ "rand_core", ] +[[package]] +name = "siphasher" +version = "0.3.11" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "38b58827f4464d87d377d175e90bf58eb00fd8716ff0a62f80356b5e61555d0d" + [[package]] name = "sized-chunks" version = "0.6.5" @@ -1639,6 +1861,19 @@ dependencies = [ "der", ] +[[package]] +name = "string_cache" +version = "0.8.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f91138e76242f575eb1d3b38b4f1362f10d3a43f47d182a5b359af488a02293b" +dependencies = [ + "new_debug_unreachable", + "once_cell", + "parking_lot", + "phf_shared", + "precomputed-hash", +] + [[package]] name = "strsim" version = "0.10.0" @@ -1673,6 +1908,17 @@ dependencies = [ "unicode-ident", ] +[[package]] +name = "term" +version = "0.7.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c59df8ac95d96ff9bede18eb7300b0fda5e5d8d90960e76f8e14ae765eedbf1f" +dependencies = [ + "dirs-next", + "rustversion", + "winapi", +] + [[package]] name = "termcolor" version = "1.4.1" @@ -1731,6 +1977,15 @@ dependencies = [ "time-core", ] +[[package]] +name = "tiny-keccak" +version = "2.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2c9d3793400a45f954c52e73d068316d76b6f4e36977e3fcebb13a2721e80237" +dependencies = [ + "crunchy", +] + [[package]] name = "toml" version = "0.7.8" @@ -1820,6 +2075,12 @@ version = "0.1.11" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "e51733f11c9c4f72aa0c160008246859e340b00807569a0da0e7a1079b27ba85" +[[package]] +name = "unicode-xid" +version = "0.2.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f962df74c8c05a667b5ee8bcf162993134c104e96440b663c8daa176dc772d8c" + [[package]] name = "utf8parse" version = "0.2.1" @@ -1939,7 +2200,7 @@ version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "33ab640c8d7e35bf8ba19b884ba838ceb4fba93a4e8c65a9059d08afcfc683d9" dependencies = [ - "windows-targets", + "windows-targets 0.52.0", ] [[package]] @@ -1948,7 +2209,22 @@ version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d" dependencies = [ - "windows-targets", + "windows-targets 0.52.0", +] + +[[package]] +name = "windows-targets" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c" +dependencies = [ + "windows_aarch64_gnullvm 0.48.5", + "windows_aarch64_msvc 0.48.5", + "windows_i686_gnu 0.48.5", + "windows_i686_msvc 0.48.5", + "windows_x86_64_gnu 0.48.5", + "windows_x86_64_gnullvm 0.48.5", + "windows_x86_64_msvc 0.48.5", ] [[package]] @@ -1957,51 +2233,93 @@ version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "8a18201040b24831fbb9e4eb208f8892e1f50a37feb53cc7ff887feb8f50e7cd" dependencies = [ - "windows_aarch64_gnullvm", - "windows_aarch64_msvc", - "windows_i686_gnu", - "windows_i686_msvc", - "windows_x86_64_gnu", - "windows_x86_64_gnullvm", - "windows_x86_64_msvc", + "windows_aarch64_gnullvm 0.52.0", + "windows_aarch64_msvc 0.52.0", + "windows_i686_gnu 0.52.0", + "windows_i686_msvc 0.52.0", + "windows_x86_64_gnu 0.52.0", + "windows_x86_64_gnullvm 0.52.0", + "windows_x86_64_msvc 0.52.0", ] +[[package]] +name = "windows_aarch64_gnullvm" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8" + [[package]] name = "windows_aarch64_gnullvm" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "cb7764e35d4db8a7921e09562a0304bf2f93e0a51bfccee0bd0bb0b666b015ea" +[[package]] +name = "windows_aarch64_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc" + [[package]] name = "windows_aarch64_msvc" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "bbaa0368d4f1d2aaefc55b6fcfee13f41544ddf36801e793edbbfd7d7df075ef" +[[package]] +name = "windows_i686_gnu" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e" + [[package]] name = "windows_i686_gnu" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "a28637cb1fa3560a16915793afb20081aba2c92ee8af57b4d5f28e4b3e7df313" +[[package]] +name = "windows_i686_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406" + [[package]] name = "windows_i686_msvc" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "ffe5e8e31046ce6230cc7215707b816e339ff4d4d67c65dffa206fd0f7aa7b9a" +[[package]] +name = "windows_x86_64_gnu" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e" + [[package]] name = "windows_x86_64_gnu" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "3d6fa32db2bc4a2f5abeacf2b69f7992cd09dca97498da74a151a3132c26befd" +[[package]] +name = "windows_x86_64_gnullvm" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc" + [[package]] name = "windows_x86_64_gnullvm" version = "0.52.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "1a657e1e9d3f514745a572a6846d3c7aa7dbe1658c056ed9c3344c4109a6949e" +[[package]] +name = "windows_x86_64_msvc" +version = "0.48.5" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538" + [[package]] name = "windows_x86_64_msvc" version = "0.52.0" diff --git a/noir/noir-repo/.github/workflows/test-rust-workspace-msrv.yml b/noir/noir-repo/.github/workflows/test-rust-workspace-msrv.yml index 0b2855fa834..cdd7a064a8d 100644 --- a/noir/noir-repo/.github/workflows/test-rust-workspace-msrv.yml +++ b/noir/noir-repo/.github/workflows/test-rust-workspace-msrv.yml @@ -112,6 +112,10 @@ jobs: # We treat any cancelled, skipped or failing jobs as a failure for the workflow as a whole. FAIL: ${{ contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled') || contains(needs.*.result, 'skipped') }} + - name: Checkout + if: ${{ failure() }} + uses: actions/checkout@v4 + # Raise an issue if the tests failed - name: Alert on failed publish uses: JasonEtco/create-an-issue@v2 @@ -122,4 +126,4 @@ jobs: WORKFLOW_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} with: update_existing: true - filename: .github/JS_PUBLISH_FAILED.md \ No newline at end of file + filename: .github/ACVM_NOT_PUBLISHABLE.md diff --git a/noir/noir-repo/.gitignore b/noir/noir-repo/.gitignore index 9a829afab8b..2c877a4d02c 100644 --- a/noir/noir-repo/.gitignore +++ b/noir/noir-repo/.gitignore @@ -4,6 +4,7 @@ examples/**/target/ examples/9 node_modules pkg/ +.idea # Yarn .pnp.* diff --git a/noir/noir-repo/Cargo.lock b/noir/noir-repo/Cargo.lock index ee7d1d7d024..e6072ffb82b 100644 --- a/noir/noir-repo/Cargo.lock +++ b/noir/noir-repo/Cargo.lock @@ -269,7 +269,7 @@ dependencies = [ "ark-std", "derivative", "hashbrown 0.13.2", - "itertools", + "itertools 0.10.5", "num-traits", "zeroize", ] @@ -286,7 +286,7 @@ dependencies = [ "ark-std", "derivative", "digest", - "itertools", + "itertools 0.10.5", "num-bigint", "num-traits", "paste", @@ -375,6 +375,15 @@ version = "0.7.4" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711" +[[package]] +name = "ascii-canvas" +version = "3.0.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8824ecca2e851cec16968d54a01dd372ef8f95b244fb84b84e70128be347c3c6" +dependencies = [ + "term", +] + [[package]] name = "assert_cmd" version = "2.0.12" @@ -607,11 +616,14 @@ dependencies = [ "ark-ec", "ark-ff", "cfg-if 1.0.0", + "criterion", "getrandom 0.2.10", + "hex", "js-sys", + "lazy_static", "noir_grumpkin", "num-bigint", - "num-traits", + "pprof", "thiserror", "wasm-bindgen-futures", "wasmer", @@ -1179,7 +1191,7 @@ dependencies = [ "clap", "criterion-plot", "is-terminal", - "itertools", + "itertools 0.10.5", "num-traits", "once_cell", "oorandom", @@ -1200,7 +1212,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "6b50826342786a51a89e2da3a28f1c32b06e387201bc2d19791f622c673706b1" dependencies = [ "cast", - "itertools", + "itertools 0.10.5", ] [[package]] @@ -1256,6 +1268,12 @@ dependencies = [ "cfg-if 1.0.0", ] +[[package]] +name = "crunchy" +version = "0.2.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7" + [[package]] name = "crypto-bigint" version = "0.4.9" @@ -1527,6 +1545,15 @@ dependencies = [ "zeroize", ] +[[package]] +name = "ena" +version = "0.14.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c533630cf40e9caa44bd91aadc88a75d75a4c3a12b4cfde353cbed41daa1e1f1" +dependencies = [ + "log", +] + [[package]] name = "encode_unicode" version = "0.3.6" @@ -2365,6 +2392,15 @@ dependencies = [ "either", ] +[[package]] +name = "itertools" +version = "0.11.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57" +dependencies = [ + "either", +] + [[package]] name = "itoa" version = "1.0.9" @@ -2535,6 +2571,37 @@ dependencies = [ "libc", ] +[[package]] +name = "lalrpop" +version = "0.20.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "55cb077ad656299f160924eb2912aa147d7339ea7d69e1b5517326fdcec3c1ca" +dependencies = [ + "ascii-canvas", + "bit-set", + "ena", + "itertools 0.11.0", + "lalrpop-util", + "petgraph", + "pico-args", + "regex", + "regex-syntax 0.8.2", + "string_cache", + "term", + "tiny-keccak", + "unicode-xid", + "walkdir", +] + +[[package]] +name = "lalrpop-util" +version = "0.20.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "507460a910eb7b32ee961886ff48539633b788a36b65692b95f225b844c82553" +dependencies = [ + "regex-automata 0.4.5", +] + [[package]] name = "lazy_static" version = "1.4.0" @@ -2857,6 +2924,12 @@ dependencies = [ "winapi", ] +[[package]] +name = "new_debug_unreachable" +version = "1.0.6" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "650eef8c711430f1a879fdd01d4745a7deea475becfb90269c06775983bbf086" + [[package]] name = "nibble_vec" version = "0.1.0" @@ -3088,6 +3161,8 @@ dependencies = [ "chumsky", "fm", "iter-extended", + "lalrpop", + "lalrpop-util", "noirc_errors", "noirc_printable_type", "petgraph", @@ -3387,6 +3462,12 @@ dependencies = [ "siphasher", ] +[[package]] +name = "pico-args" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5be167a7af36ee22fe3115051bc51f6e6c7054c9348e28deb4f49bd6f705a315" + [[package]] name = "pin-project-lite" version = "0.2.13" @@ -3471,6 +3552,12 @@ version = "0.2.17" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de" +[[package]] +name = "precomputed-hash" +version = "0.1.1" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "925383efa346730478fb4838dbe9137d2a47675ad789c546d150a6e1dd4ab31c" + [[package]] name = "predicates" version = "2.1.5" @@ -3479,7 +3566,7 @@ checksum = "59230a63c37f3e18569bdb90e4a89cbf5bf8b06fea0b84e65ea10cc4df47addd" dependencies = [ "difflib", "float-cmp", - "itertools", + "itertools 0.10.5", "normalize-line-endings", "predicates-core", "regex", @@ -3493,7 +3580,7 @@ checksum = "09963355b9f467184c04017ced4a2ba2d75cbcb4e7462690d388233253d4b1a9" dependencies = [ "anstyle", "difflib", - "itertools", + "itertools 0.10.5", "predicates-core", ] @@ -4613,6 +4700,19 @@ version = "0.1.0" source = "registry+https://github.com/rust-lang/crates.io-index" checksum = "9091b6114800a5f2141aee1d1b9d6ca3592ac062dc5decb3764ec5895a47b4eb" +[[package]] +name = "string_cache" +version = "0.8.7" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "f91138e76242f575eb1d3b38b4f1362f10d3a43f47d182a5b359af488a02293b" +dependencies = [ + "new_debug_unreachable", + "once_cell", + "parking_lot 0.12.1", + "phf_shared", + "precomputed-hash", +] + [[package]] name = "strsim" version = "0.10.0" @@ -4855,6 +4955,15 @@ dependencies = [ "time-core", ] +[[package]] +name = "tiny-keccak" +version = "2.0.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "2c9d3793400a45f954c52e73d068316d76b6f4e36977e3fcebb13a2721e80237" +dependencies = [ + "crunchy", +] + [[package]] name = "tinytemplate" version = "1.2.1" @@ -5276,9 +5385,9 @@ dependencies = [ [[package]] name = "walkdir" -version = "2.3.3" +version = "2.5.0" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "36df944cda56c7d8d8b7496af378e6b16de9284591917d307c9b4d313c44e698" +checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b" dependencies = [ "same-file", "winapi-util", diff --git a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs index 188205b124c..d655d136bc8 100644 --- a/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs +++ b/noir/noir-repo/acvm-repo/acir/src/circuit/mod.rs @@ -89,6 +89,16 @@ impl Circuit { } } +#[derive(Debug, Copy, Clone)] +/// The opcode location for a call to a separate ACIR circuit +/// This includes the function index of the caller within a [program][Program] +/// and the index in the callers ACIR to the specific call opcode. +/// This is only resolved and set during circuit execution. +pub struct ResolvedOpcodeLocation { + pub acir_function_index: usize, + pub opcode_location: OpcodeLocation, +} + #[derive(Debug, Copy, Clone, PartialEq, Eq, Hash, PartialOrd, Ord, Serialize, Deserialize)] /// Opcodes are locatable so that callers can /// map opcodes to debug information related to their context. diff --git a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/bigint.rs b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/bigint.rs index f094bb1ba20..a47afa5049a 100644 --- a/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/bigint.rs +++ b/noir/noir-repo/acvm-repo/acvm/src/pwg/blackbox/bigint.rs @@ -105,7 +105,7 @@ impl BigIntSolver { } BlackBoxFunc::BigIntMul => lhs * rhs, BlackBoxFunc::BigIntDiv => { - lhs * rhs.modpow(&(&modulus - BigUint::from(1_u32)), &modulus) + lhs * rhs.modpow(&(&modulus - BigUint::from(2_u32)), &modulus) } //TODO ensure that modulus is prime _ => unreachable!("ICE - bigint_op must be called for an operation"), }; diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/Cargo.toml b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/Cargo.toml index 318833180ea..448642e1a9e 100644 --- a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/Cargo.toml +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/Cargo.toml @@ -16,8 +16,9 @@ repository.workspace = true acir.workspace = true acvm_blackbox_solver.workspace = true thiserror.workspace = true -num-traits.workspace = true cfg-if = "1.0.0" +hex.workspace = true +lazy_static = "1.4" # BN254 fixed base scalar multiplication solver grumpkin = { version = "0.1.0", package = "noir_grumpkin", features = ["std"] } @@ -38,6 +39,18 @@ js-sys.workspace = true getrandom.workspace = true wasmer = "4.2.6" +[dev-dependencies] +criterion = "0.5.0" +pprof = { version = "0.12", features = [ + "flamegraph", + "frame-pointer", + "criterion", +] } + +[[bench]] +name = "criterion" +harness = false + [features] default = ["bn254"] bn254 = ["acir/bn254"] diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/benches/criterion.rs b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/benches/criterion.rs new file mode 100644 index 00000000000..eb529ed2c11 --- /dev/null +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/benches/criterion.rs @@ -0,0 +1,21 @@ +use criterion::{criterion_group, criterion_main, Criterion}; +use std::{hint::black_box, time::Duration}; + +use acir::FieldElement; +use bn254_blackbox_solver::poseidon2_permutation; + +use pprof::criterion::{Output, PProfProfiler}; + +fn bench_poseidon2(c: &mut Criterion) { + let inputs = [FieldElement::zero(); 4]; + + c.bench_function("poseidon2", |b| b.iter(|| poseidon2_permutation(black_box(&inputs), 4))); +} + +criterion_group!( + name = benches; + config = Criterion::default().sample_size(40).measurement_time(Duration::from_secs(20)).with_profiler(PProfProfiler::new(100, Output::Flamegraph(None))); + targets = bench_poseidon2 +); + +criterion_main!(benches); diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/fixed_base_scalar_mul.rs b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/fixed_base_scalar_mul.rs index 5e68c7d4030..cd91c290f49 100644 --- a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/fixed_base_scalar_mul.rs +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/fixed_base_scalar_mul.rs @@ -47,17 +47,29 @@ pub fn fixed_base_scalar_mul( } } +fn create_point(x: FieldElement, y: FieldElement) -> Result { + let point = grumpkin::SWAffine::new_unchecked(x.into_repr(), y.into_repr()); + if !point.is_on_curve() { + return Err(format!("Point ({}, {}) is not on curve", x.to_hex(), y.to_hex())); + }; + if !point.is_in_correct_subgroup_assuming_on_curve() { + return Err(format!("Point ({}, {}) is not in correct subgroup", x.to_hex(), y.to_hex())); + }; + Ok(point) +} + pub fn embedded_curve_add( input1_x: FieldElement, input1_y: FieldElement, input2_x: FieldElement, input2_y: FieldElement, ) -> Result<(FieldElement, FieldElement), BlackBoxResolutionError> { - let mut point1 = grumpkin::SWAffine::new(input1_x.into_repr(), input1_y.into_repr()); - let point2 = grumpkin::SWAffine::new(input2_x.into_repr(), input2_y.into_repr()); - let res = point1 + point2; - point1 = res.into(); - if let Some((res_x, res_y)) = point1.xy() { + let point1 = create_point(input1_x, input1_y) + .map_err(|e| BlackBoxResolutionError::Failed(BlackBoxFunc::EmbeddedCurveAdd, e))?; + let point2 = create_point(input2_x, input2_y) + .map_err(|e| BlackBoxResolutionError::Failed(BlackBoxFunc::EmbeddedCurveAdd, e))?; + let res = grumpkin::SWAffine::from(point1 + point2); + if let Some((res_x, res_y)) = res.xy() { Ok((FieldElement::from_repr(*res_x), FieldElement::from_repr(*res_y))) } else { Err(BlackBoxResolutionError::Failed( @@ -72,6 +84,7 @@ mod grumpkin_fixed_base_scalar_mul { use ark_ff::BigInteger; use super::*; + #[test] fn smoke_test() -> Result<(), BlackBoxResolutionError> { let input = FieldElement::one(); @@ -84,6 +97,7 @@ mod grumpkin_fixed_base_scalar_mul { assert_eq!(y, res.1.to_hex()); Ok(()) } + #[test] fn low_high_smoke_test() -> Result<(), BlackBoxResolutionError> { let low = FieldElement::one(); @@ -103,9 +117,9 @@ mod grumpkin_fixed_base_scalar_mul { let max_limb = FieldElement::from(u128::MAX); let invalid_limb = max_limb + FieldElement::one(); - let expected_error = Err(BlackBoxResolutionError::Failed( + let expected_error = Err(BlackBoxResolutionError::Failed( BlackBoxFunc::FixedBaseScalarMul, - "Limb 0000000000000000000000000000000100000000000000000000000000000000 is not less than 2^128".into() + "Limb 0000000000000000000000000000000100000000000000000000000000000000 is not less than 2^128".into(), )); let res = fixed_base_scalar_mul(&invalid_limb, &FieldElement::zero()); @@ -128,7 +142,23 @@ mod grumpkin_fixed_base_scalar_mul { res, Err(BlackBoxResolutionError::Failed( BlackBoxFunc::FixedBaseScalarMul, - "30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47 is not a valid grumpkin scalar".into() + "30644e72e131a029b85045b68181585d97816a916871ca8d3c208c16d87cfd47 is not a valid grumpkin scalar".into(), + )) + ); + } + + #[test] + fn rejects_addition_of_points_not_in_curve() { + let x = FieldElement::from(1u128); + let y = FieldElement::from(2u128); + + let res = embedded_curve_add(x, y, x, y); + + assert_eq!( + res, + Err(BlackBoxResolutionError::Failed( + BlackBoxFunc::EmbeddedCurveAdd, + "Point (0000000000000000000000000000000000000000000000000000000000000001, 0000000000000000000000000000000000000000000000000000000000000002) is not on curve".into(), )) ); } diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs index f7c303888e8..25b10252a78 100644 --- a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/lib.rs @@ -10,7 +10,7 @@ mod poseidon2; mod wasm; pub use fixed_base_scalar_mul::{embedded_curve_add, fixed_base_scalar_mul}; -use poseidon2::Poseidon2; +pub use poseidon2::poseidon2_permutation; use wasm::Barretenberg; use self::wasm::{Pedersen, SchnorrSig}; @@ -112,7 +112,6 @@ impl BlackBoxFunctionSolver for Bn254BlackBoxSolver { inputs: &[FieldElement], len: u32, ) -> Result, BlackBoxResolutionError> { - let poseidon = Poseidon2::new(); - poseidon.permutation(inputs, len) + poseidon2_permutation(inputs, len) } } diff --git a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/poseidon2.rs b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/poseidon2.rs index e0ed5bcd053..65058e15099 100644 --- a/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/poseidon2.rs +++ b/noir/noir-repo/acvm-repo/bn254_blackbox_solver/src/poseidon2.rs @@ -1,9 +1,20 @@ use acir::FieldElement; use acvm_blackbox_solver::BlackBoxResolutionError; -use num_bigint::BigUint; -use num_traits::Num; +use lazy_static::lazy_static; -pub(crate) struct Poseidon2 { +pub fn poseidon2_permutation( + inputs: &[FieldElement], + len: u32, +) -> Result, BlackBoxResolutionError> { + let poseidon = Poseidon2::new(); + poseidon.permutation(inputs, len) +} + +pub(crate) struct Poseidon2<'a> { + config: &'a Poseidon2Config, +} + +struct Poseidon2Config { t: u32, rounds_f: u32, rounds_p: u32, @@ -11,929 +22,415 @@ pub(crate) struct Poseidon2 { round_constant: [[FieldElement; 4]; 64], } -impl Poseidon2 { +fn field_from_hex(hex: &str) -> FieldElement { + FieldElement::from_be_bytes_reduce(&hex::decode(hex).expect("Should be passed only valid hex")) +} + +lazy_static! { + static ref INTERNAL_MATRIX_DIAGONAL: [FieldElement; 4] = [ + field_from_hex("10dc6e9c006ea38b04b1e03b4bd9490c0d03f98929ca1d7fb56821fd19d3b6e7"), + field_from_hex("0c28145b6a44df3e0149b3d0a30b3bb599df9756d4dd9b84a86b38cfb45a740b"), + field_from_hex("00544b8338791518b2c7645a50392798b21f75bb60e3596170067d00141cac15"), + field_from_hex("222c01175718386f2e2e82eb122789e352e105a3b8fa852613bc534433ee428b"), + ]; + static ref ROUND_CONSTANT: [[FieldElement; 4]; 64] = [ + [ + field_from_hex("19b849f69450b06848da1d39bd5e4a4302bb86744edc26238b0878e269ed23e5"), + field_from_hex("265ddfe127dd51bd7239347b758f0a1320eb2cc7450acc1dad47f80c8dcf34d6"), + field_from_hex("199750ec472f1809e0f66a545e1e51624108ac845015c2aa3dfc36bab497d8aa"), + field_from_hex("157ff3fe65ac7208110f06a5f74302b14d743ea25067f0ffd032f787c7f1cdf8"), + ], + [ + field_from_hex("2e49c43c4569dd9c5fd35ac45fca33f10b15c590692f8beefe18f4896ac94902"), + field_from_hex("0e35fb89981890520d4aef2b6d6506c3cb2f0b6973c24fa82731345ffa2d1f1e"), + field_from_hex("251ad47cb15c4f1105f109ae5e944f1ba9d9e7806d667ffec6fe723002e0b996"), + field_from_hex("13da07dc64d428369873e97160234641f8beb56fdd05e5f3563fa39d9c22df4e"), + ], + [ + field_from_hex("0c009b84e650e6d23dc00c7dccef7483a553939689d350cd46e7b89055fd4738"), + field_from_hex("011f16b1c63a854f01992e3956f42d8b04eb650c6d535eb0203dec74befdca06"), + field_from_hex("0ed69e5e383a688f209d9a561daa79612f3f78d0467ad45485df07093f367549"), + field_from_hex("04dba94a7b0ce9e221acad41472b6bbe3aec507f5eb3d33f463672264c9f789b"), + ], + [ + field_from_hex("0a3f2637d840f3a16eb094271c9d237b6036757d4bb50bf7ce732ff1d4fa28e8"), + field_from_hex("259a666f129eea198f8a1c502fdb38fa39b1f075569564b6e54a485d1182323f"), + field_from_hex("28bf7459c9b2f4c6d8e7d06a4ee3a47f7745d4271038e5157a32fdf7ede0d6a1"), + field_from_hex("0a1ca941f057037526ea200f489be8d4c37c85bbcce6a2aeec91bd6941432447"), + ], + [ + field_from_hex("0c6f8f958be0e93053d7fd4fc54512855535ed1539f051dcb43a26fd926361cf"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("123106a93cd17578d426e8128ac9d90aa9e8a00708e296e084dd57e69caaf811"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("26e1ba52ad9285d97dd3ab52f8e840085e8fa83ff1e8f1877b074867cd2dee75"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1cb55cad7bd133de18a64c5c47b9c97cbe4d8b7bf9e095864471537e6a4ae2c5"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1dcd73e46acd8f8e0e2c7ce04bde7f6d2a53043d5060a41c7143f08e6e9055d0"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("011003e32f6d9c66f5852f05474a4def0cda294a0eb4e9b9b12b9bb4512e5574"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2b1e809ac1d10ab29ad5f20d03a57dfebadfe5903f58bafed7c508dd2287ae8c"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2539de1785b735999fb4dac35ee17ed0ef995d05ab2fc5faeaa69ae87bcec0a5"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0c246c5a2ef8ee0126497f222b3e0a0ef4e1c3d41c86d46e43982cb11d77951d"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("192089c4974f68e95408148f7c0632edbb09e6a6ad1a1c2f3f0305f5d03b527b"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1eae0ad8ab68b2f06a0ee36eeb0d0c058529097d91096b756d8fdc2fb5a60d85"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("179190e5d0e22179e46f8282872abc88db6e2fdc0dee99e69768bd98c5d06bfb"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("29bb9e2c9076732576e9a81c7ac4b83214528f7db00f31bf6cafe794a9b3cd1c"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("225d394e42207599403efd0c2464a90d52652645882aac35b10e590e6e691e08"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("064760623c25c8cf753d238055b444532be13557451c087de09efd454b23fd59"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("10ba3a0e01df92e87f301c4b716d8a394d67f4bf42a75c10922910a78f6b5b87"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0e070bf53f8451b24f9c6e96b0c2a801cb511bc0c242eb9d361b77693f21471c"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1b94cd61b051b04dd39755ff93821a73ccd6cb11d2491d8aa7f921014de252fb"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1d7cb39bafb8c744e148787a2e70230f9d4e917d5713bb050487b5aa7d74070b"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2ec93189bd1ab4f69117d0fe980c80ff8785c2961829f701bb74ac1f303b17db"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2db366bfdd36d277a692bb825b86275beac404a19ae07a9082ea46bd83517926"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("062100eb485db06269655cf186a68532985275428450359adc99cec6960711b8"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0761d33c66614aaa570e7f1e8244ca1120243f92fa59e4f900c567bf41f5a59b"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("20fc411a114d13992c2705aa034e3f315d78608a0f7de4ccf7a72e494855ad0d"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("25b5c004a4bdfcb5add9ec4e9ab219ba102c67e8b3effb5fc3a30f317250bc5a"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("23b1822d278ed632a494e58f6df6f5ed038b186d8474155ad87e7dff62b37f4b"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("22734b4c5c3f9493606c4ba9012499bf0f14d13bfcfcccaa16102a29cc2f69e0"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("26c0c8fe09eb30b7e27a74dc33492347e5bdff409aa3610254413d3fad795ce5"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("070dd0ccb6bd7bbae88eac03fa1fbb26196be3083a809829bbd626df348ccad9"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("12b6595bdb329b6fb043ba78bb28c3bec2c0a6de46d8c5ad6067c4ebfd4250da"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("248d97d7f76283d63bec30e7a5876c11c06fca9b275c671c5e33d95bb7e8d729"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1a306d439d463b0816fc6fd64cc939318b45eb759ddde4aa106d15d9bd9baaaa"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("28a8f8372e3c38daced7c00421cb4621f4f1b54ddc27821b0d62d3d6ec7c56cf"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0094975717f9a8a8bb35152f24d43294071ce320c829f388bc852183e1e2ce7e"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("04d5ee4c3aa78f7d80fde60d716480d3593f74d4f653ae83f4103246db2e8d65"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2a6cf5e9aa03d4336349ad6fb8ed2269c7bef54b8822cc76d08495c12efde187"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2304d31eaab960ba9274da43e19ddeb7f792180808fd6e43baae48d7efcba3f3"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("03fd9ac865a4b2a6d5e7009785817249bff08a7e0726fcb4e1c11d39d199f0b0"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("00b7258ded52bbda2248404d55ee5044798afc3a209193073f7954d4d63b0b64"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("159f81ada0771799ec38fca2d4bf65ebb13d3a74f3298db36272c5ca65e92d9a"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1ef90e67437fbc8550237a75bc28e3bb9000130ea25f0c5471e144cf4264431f"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1e65f838515e5ff0196b49aa41a2d2568df739bc176b08ec95a79ed82932e30d"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2b1b045def3a166cec6ce768d079ba74b18c844e570e1f826575c1068c94c33f"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0832e5753ceb0ff6402543b1109229c165dc2d73bef715e3f1c6e07c168bb173"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("02f614e9cedfb3dc6b762ae0a37d41bab1b841c2e8b6451bc5a8e3c390b6ad16"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0e2427d38bd46a60dd640b8e362cad967370ebb777bedff40f6a0be27e7ed705"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0493630b7c670b6deb7c84d414e7ce79049f0ec098c3c7c50768bbe29214a53a"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("22ead100e8e482674decdab17066c5a26bb1515355d5461a3dc06cc85327cea9"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("25b3e56e655b42cdaae2626ed2554d48583f1ae35626d04de5084e0b6d2a6f16"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1e32752ada8836ef5837a6cde8ff13dbb599c336349e4c584b4fdc0a0cf6f9d0"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2fa2a871c15a387cc50f68f6f3c3455b23c00995f05078f672a9864074d412e5"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("2f569b8a9a4424c9278e1db7311e889f54ccbf10661bab7fcd18e7c7a7d83505"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("044cb455110a8fdd531ade530234c518a7df93f7332ffd2144165374b246b43d"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("227808de93906d5d420246157f2e42b191fe8c90adfe118178ddc723a5319025"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("02fcca2934e046bc623adead873579865d03781ae090ad4a8579d2e7a6800355"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("0ef915f0ac120b876abccceb344a1d36bad3f3c5ab91a8ddcbec2e060d8befac"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + field_from_hex("0000000000000000000000000000000000000000000000000000000000000000"), + ], + [ + field_from_hex("1797130f4b7a3e1777eb757bc6f287f6ab0fb85f6be63b09f3b16ef2b1405d38"), + field_from_hex("0a76225dc04170ae3306c85abab59e608c7f497c20156d4d36c668555decc6e5"), + field_from_hex("1fffb9ec1992d66ba1e77a7b93209af6f8fa76d48acb664796174b5326a31a5c"), + field_from_hex("25721c4fc15a3f2853b57c338fa538d85f8fbba6c6b9c6090611889b797b9c5f"), + ], + [ + field_from_hex("0c817fd42d5f7a41215e3d07ba197216adb4c3790705da95eb63b982bfcaf75a"), + field_from_hex("13abe3f5239915d39f7e13c2c24970b6df8cf86ce00a22002bc15866e52b5a96"), + field_from_hex("2106feea546224ea12ef7f39987a46c85c1bc3dc29bdbd7a92cd60acb4d391ce"), + field_from_hex("21ca859468a746b6aaa79474a37dab49f1ca5a28c748bc7157e1b3345bb0f959"), + ], + [ + field_from_hex("05ccd6255c1e6f0c5cf1f0df934194c62911d14d0321662a8f1a48999e34185b"), + field_from_hex("0f0e34a64b70a626e464d846674c4c8816c4fb267fe44fe6ea28678cb09490a4"), + field_from_hex("0558531a4e25470c6157794ca36d0e9647dbfcfe350d64838f5b1a8a2de0d4bf"), + field_from_hex("09d3dca9173ed2faceea125157683d18924cadad3f655a60b72f5864961f1455"), + ], + [ + field_from_hex("0328cbd54e8c0913493f866ed03d218bf23f92d68aaec48617d4c722e5bd4335"), + field_from_hex("2bf07216e2aff0a223a487b1a7094e07e79e7bcc9798c648ee3347dd5329d34b"), + field_from_hex("1daf345a58006b736499c583cb76c316d6f78ed6a6dffc82111e11a63fe412df"), + field_from_hex("176563472456aaa746b694c60e1823611ef39039b2edc7ff391e6f2293d2c404"), + ], + ]; + static ref POSEIDON2_CONFIG: Poseidon2Config = Poseidon2Config { + t: 4, + rounds_f: 8, + rounds_p: 56, + internal_matrix_diagonal: *INTERNAL_MATRIX_DIAGONAL, + round_constant: *ROUND_CONSTANT, + }; +} + +impl<'a> Poseidon2<'a> { pub(crate) fn new() -> Self { - Poseidon2 { - t: 4, - rounds_f: 8, - rounds_p: 56, - internal_matrix_diagonal: [ - Poseidon2::field_from_hex( - "0x10dc6e9c006ea38b04b1e03b4bd9490c0d03f98929ca1d7fb56821fd19d3b6e7", - ), - Poseidon2::field_from_hex( - "0x0c28145b6a44df3e0149b3d0a30b3bb599df9756d4dd9b84a86b38cfb45a740b", - ), - Poseidon2::field_from_hex( - "0x00544b8338791518b2c7645a50392798b21f75bb60e3596170067d00141cac15", - ), - Poseidon2::field_from_hex( - "0x222c01175718386f2e2e82eb122789e352e105a3b8fa852613bc534433ee428b", - ), - ], - round_constant: [ - [ - Poseidon2::field_from_hex( - "0x19b849f69450b06848da1d39bd5e4a4302bb86744edc26238b0878e269ed23e5", - ), - Poseidon2::field_from_hex( - "0x265ddfe127dd51bd7239347b758f0a1320eb2cc7450acc1dad47f80c8dcf34d6", - ), - Poseidon2::field_from_hex( - "0x199750ec472f1809e0f66a545e1e51624108ac845015c2aa3dfc36bab497d8aa", - ), - Poseidon2::field_from_hex( - "0x157ff3fe65ac7208110f06a5f74302b14d743ea25067f0ffd032f787c7f1cdf8", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2e49c43c4569dd9c5fd35ac45fca33f10b15c590692f8beefe18f4896ac94902", - ), - Poseidon2::field_from_hex( - "0x0e35fb89981890520d4aef2b6d6506c3cb2f0b6973c24fa82731345ffa2d1f1e", - ), - Poseidon2::field_from_hex( - "0x251ad47cb15c4f1105f109ae5e944f1ba9d9e7806d667ffec6fe723002e0b996", - ), - Poseidon2::field_from_hex( - "0x13da07dc64d428369873e97160234641f8beb56fdd05e5f3563fa39d9c22df4e", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0c009b84e650e6d23dc00c7dccef7483a553939689d350cd46e7b89055fd4738", - ), - Poseidon2::field_from_hex( - "0x011f16b1c63a854f01992e3956f42d8b04eb650c6d535eb0203dec74befdca06", - ), - Poseidon2::field_from_hex( - "0x0ed69e5e383a688f209d9a561daa79612f3f78d0467ad45485df07093f367549", - ), - Poseidon2::field_from_hex( - "0x04dba94a7b0ce9e221acad41472b6bbe3aec507f5eb3d33f463672264c9f789b", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0a3f2637d840f3a16eb094271c9d237b6036757d4bb50bf7ce732ff1d4fa28e8", - ), - Poseidon2::field_from_hex( - "0x259a666f129eea198f8a1c502fdb38fa39b1f075569564b6e54a485d1182323f", - ), - Poseidon2::field_from_hex( - "0x28bf7459c9b2f4c6d8e7d06a4ee3a47f7745d4271038e5157a32fdf7ede0d6a1", - ), - Poseidon2::field_from_hex( - "0x0a1ca941f057037526ea200f489be8d4c37c85bbcce6a2aeec91bd6941432447", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0c6f8f958be0e93053d7fd4fc54512855535ed1539f051dcb43a26fd926361cf", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x123106a93cd17578d426e8128ac9d90aa9e8a00708e296e084dd57e69caaf811", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x26e1ba52ad9285d97dd3ab52f8e840085e8fa83ff1e8f1877b074867cd2dee75", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1cb55cad7bd133de18a64c5c47b9c97cbe4d8b7bf9e095864471537e6a4ae2c5", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1dcd73e46acd8f8e0e2c7ce04bde7f6d2a53043d5060a41c7143f08e6e9055d0", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x011003e32f6d9c66f5852f05474a4def0cda294a0eb4e9b9b12b9bb4512e5574", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2b1e809ac1d10ab29ad5f20d03a57dfebadfe5903f58bafed7c508dd2287ae8c", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2539de1785b735999fb4dac35ee17ed0ef995d05ab2fc5faeaa69ae87bcec0a5", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0c246c5a2ef8ee0126497f222b3e0a0ef4e1c3d41c86d46e43982cb11d77951d", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x192089c4974f68e95408148f7c0632edbb09e6a6ad1a1c2f3f0305f5d03b527b", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1eae0ad8ab68b2f06a0ee36eeb0d0c058529097d91096b756d8fdc2fb5a60d85", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x179190e5d0e22179e46f8282872abc88db6e2fdc0dee99e69768bd98c5d06bfb", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x29bb9e2c9076732576e9a81c7ac4b83214528f7db00f31bf6cafe794a9b3cd1c", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x225d394e42207599403efd0c2464a90d52652645882aac35b10e590e6e691e08", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x064760623c25c8cf753d238055b444532be13557451c087de09efd454b23fd59", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x10ba3a0e01df92e87f301c4b716d8a394d67f4bf42a75c10922910a78f6b5b87", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0e070bf53f8451b24f9c6e96b0c2a801cb511bc0c242eb9d361b77693f21471c", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1b94cd61b051b04dd39755ff93821a73ccd6cb11d2491d8aa7f921014de252fb", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1d7cb39bafb8c744e148787a2e70230f9d4e917d5713bb050487b5aa7d74070b", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2ec93189bd1ab4f69117d0fe980c80ff8785c2961829f701bb74ac1f303b17db", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2db366bfdd36d277a692bb825b86275beac404a19ae07a9082ea46bd83517926", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x062100eb485db06269655cf186a68532985275428450359adc99cec6960711b8", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0761d33c66614aaa570e7f1e8244ca1120243f92fa59e4f900c567bf41f5a59b", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x20fc411a114d13992c2705aa034e3f315d78608a0f7de4ccf7a72e494855ad0d", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x25b5c004a4bdfcb5add9ec4e9ab219ba102c67e8b3effb5fc3a30f317250bc5a", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x23b1822d278ed632a494e58f6df6f5ed038b186d8474155ad87e7dff62b37f4b", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x22734b4c5c3f9493606c4ba9012499bf0f14d13bfcfcccaa16102a29cc2f69e0", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x26c0c8fe09eb30b7e27a74dc33492347e5bdff409aa3610254413d3fad795ce5", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x070dd0ccb6bd7bbae88eac03fa1fbb26196be3083a809829bbd626df348ccad9", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x12b6595bdb329b6fb043ba78bb28c3bec2c0a6de46d8c5ad6067c4ebfd4250da", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x248d97d7f76283d63bec30e7a5876c11c06fca9b275c671c5e33d95bb7e8d729", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1a306d439d463b0816fc6fd64cc939318b45eb759ddde4aa106d15d9bd9baaaa", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x28a8f8372e3c38daced7c00421cb4621f4f1b54ddc27821b0d62d3d6ec7c56cf", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0094975717f9a8a8bb35152f24d43294071ce320c829f388bc852183e1e2ce7e", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x04d5ee4c3aa78f7d80fde60d716480d3593f74d4f653ae83f4103246db2e8d65", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2a6cf5e9aa03d4336349ad6fb8ed2269c7bef54b8822cc76d08495c12efde187", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2304d31eaab960ba9274da43e19ddeb7f792180808fd6e43baae48d7efcba3f3", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x03fd9ac865a4b2a6d5e7009785817249bff08a7e0726fcb4e1c11d39d199f0b0", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x00b7258ded52bbda2248404d55ee5044798afc3a209193073f7954d4d63b0b64", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x159f81ada0771799ec38fca2d4bf65ebb13d3a74f3298db36272c5ca65e92d9a", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1ef90e67437fbc8550237a75bc28e3bb9000130ea25f0c5471e144cf4264431f", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1e65f838515e5ff0196b49aa41a2d2568df739bc176b08ec95a79ed82932e30d", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2b1b045def3a166cec6ce768d079ba74b18c844e570e1f826575c1068c94c33f", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0832e5753ceb0ff6402543b1109229c165dc2d73bef715e3f1c6e07c168bb173", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x02f614e9cedfb3dc6b762ae0a37d41bab1b841c2e8b6451bc5a8e3c390b6ad16", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0e2427d38bd46a60dd640b8e362cad967370ebb777bedff40f6a0be27e7ed705", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0493630b7c670b6deb7c84d414e7ce79049f0ec098c3c7c50768bbe29214a53a", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x22ead100e8e482674decdab17066c5a26bb1515355d5461a3dc06cc85327cea9", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x25b3e56e655b42cdaae2626ed2554d48583f1ae35626d04de5084e0b6d2a6f16", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1e32752ada8836ef5837a6cde8ff13dbb599c336349e4c584b4fdc0a0cf6f9d0", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2fa2a871c15a387cc50f68f6f3c3455b23c00995f05078f672a9864074d412e5", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x2f569b8a9a4424c9278e1db7311e889f54ccbf10661bab7fcd18e7c7a7d83505", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x044cb455110a8fdd531ade530234c518a7df93f7332ffd2144165374b246b43d", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x227808de93906d5d420246157f2e42b191fe8c90adfe118178ddc723a5319025", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x02fcca2934e046bc623adead873579865d03781ae090ad4a8579d2e7a6800355", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0ef915f0ac120b876abccceb344a1d36bad3f3c5ab91a8ddcbec2e060d8befac", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - Poseidon2::field_from_hex( - "0x0000000000000000000000000000000000000000000000000000000000000000", - ), - ], - [ - Poseidon2::field_from_hex( - "0x1797130f4b7a3e1777eb757bc6f287f6ab0fb85f6be63b09f3b16ef2b1405d38", - ), - Poseidon2::field_from_hex( - "0x0a76225dc04170ae3306c85abab59e608c7f497c20156d4d36c668555decc6e5", - ), - Poseidon2::field_from_hex( - "0x1fffb9ec1992d66ba1e77a7b93209af6f8fa76d48acb664796174b5326a31a5c", - ), - Poseidon2::field_from_hex( - "0x25721c4fc15a3f2853b57c338fa538d85f8fbba6c6b9c6090611889b797b9c5f", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0c817fd42d5f7a41215e3d07ba197216adb4c3790705da95eb63b982bfcaf75a", - ), - Poseidon2::field_from_hex( - "0x13abe3f5239915d39f7e13c2c24970b6df8cf86ce00a22002bc15866e52b5a96", - ), - Poseidon2::field_from_hex( - "0x2106feea546224ea12ef7f39987a46c85c1bc3dc29bdbd7a92cd60acb4d391ce", - ), - Poseidon2::field_from_hex( - "0x21ca859468a746b6aaa79474a37dab49f1ca5a28c748bc7157e1b3345bb0f959", - ), - ], - [ - Poseidon2::field_from_hex( - "0x05ccd6255c1e6f0c5cf1f0df934194c62911d14d0321662a8f1a48999e34185b", - ), - Poseidon2::field_from_hex( - "0x0f0e34a64b70a626e464d846674c4c8816c4fb267fe44fe6ea28678cb09490a4", - ), - Poseidon2::field_from_hex( - "0x0558531a4e25470c6157794ca36d0e9647dbfcfe350d64838f5b1a8a2de0d4bf", - ), - Poseidon2::field_from_hex( - "0x09d3dca9173ed2faceea125157683d18924cadad3f655a60b72f5864961f1455", - ), - ], - [ - Poseidon2::field_from_hex( - "0x0328cbd54e8c0913493f866ed03d218bf23f92d68aaec48617d4c722e5bd4335", - ), - Poseidon2::field_from_hex( - "0x2bf07216e2aff0a223a487b1a7094e07e79e7bcc9798c648ee3347dd5329d34b", - ), - Poseidon2::field_from_hex( - "0x1daf345a58006b736499c583cb76c316d6f78ed6a6dffc82111e11a63fe412df", - ), - Poseidon2::field_from_hex( - "0x176563472456aaa746b694c60e1823611ef39039b2edc7ff391e6f2293d2c404", - ), - ], - ], - } - } - fn field_from_hex(hex: &str) -> FieldElement { - let bigint = BigUint::from_str_radix(hex.strip_prefix("0x").unwrap(), 16).unwrap(); - FieldElement::from_be_bytes_reduce(&bigint.to_bytes_be()) + Poseidon2 { config: &POSEIDON2_CONFIG } } fn single_box(x: FieldElement) -> FieldElement { @@ -948,7 +445,9 @@ impl Poseidon2 { } fn add_round_constants(&self, state: &mut [FieldElement], round: usize) { - for (state_element, constant_element) in state.iter_mut().zip(self.round_constant[round]) { + for (state_element, constant_element) in + state.iter_mut().zip(self.config.round_constant[round]) + { *state_element += constant_element; } } @@ -982,7 +481,7 @@ impl Poseidon2 { sum += *i; } for (index, i) in input.iter_mut().enumerate() { - *i = *i * self.internal_matrix_diagonal[index]; + *i = *i * self.config.internal_matrix_diagonal[index]; *i += sum; } } @@ -1002,10 +501,10 @@ impl Poseidon2 { ), )); } - if len != self.t { + if len != self.config.t { return Err(BlackBoxResolutionError::Failed( acir::BlackBoxFunc::Poseidon2Permutation, - format!("Expected {} values but encountered {}", self.t, len), + format!("Expected {} values but encountered {}", self.config.t, len), )); } // Read witness assignments @@ -1017,22 +516,22 @@ impl Poseidon2 { Self::matrix_multiplication_4x4(&mut state); // First set of external rounds - let rf_first = self.rounds_f / 2; + let rf_first = self.config.rounds_f / 2; for r in 0..rf_first { self.add_round_constants(&mut state, r as usize); Self::s_box(&mut state); Self::matrix_multiplication_4x4(&mut state); } // Internal rounds - let p_end = rf_first + self.rounds_p; + let p_end = rf_first + self.config.rounds_p; for r in rf_first..p_end { - state[0] += self.round_constant[r as usize][0]; + state[0] += self.config.round_constant[r as usize][0]; state[0] = Self::single_box(state[0]); self.internal_m_multiplication(&mut state); } // Remaining external rounds - let num_rounds = self.rounds_f + self.rounds_p; + let num_rounds = self.config.rounds_f + self.config.rounds_p; for i in p_end..num_rounds { self.add_round_constants(&mut state, i as usize); Self::s_box(&mut state); @@ -1041,3 +540,24 @@ impl Poseidon2 { Ok(state.into()) } } + +#[cfg(test)] +mod test { + use acir::FieldElement; + + use super::{field_from_hex, poseidon2_permutation}; + + #[test] + fn smoke_test() { + let inputs = [FieldElement::zero(); 4]; + let result = poseidon2_permutation(&inputs, 4).expect("should successfully permute"); + + let expected_result = [ + field_from_hex("18DFB8DC9B82229CFF974EFEFC8DF78B1CE96D9D844236B496785C698BC6732E"), + field_from_hex("095C230D1D37A246E8D2D5A63B165FE0FADE040D442F61E25F0590E5FB76F839"), + field_from_hex("0BB9545846E1AFA4FA3C97414A60A20FC4949F537A68CCECA34C5CE71E28AA59"), + field_from_hex("18A4F34C9C6F99335FF7638B82AEED9018026618358873C982BBDDE265B2ED6D"), + ]; + assert_eq!(result, expected_result); + } +} diff --git a/noir/noir-repo/compiler/noirc_driver/src/contract.rs b/noir/noir-repo/compiler/noirc_driver/src/contract.rs index a33a9b809d3..d6c3dc6205d 100644 --- a/noir/noir-repo/compiler/noirc_driver/src/contract.rs +++ b/noir/noir-repo/compiler/noirc_driver/src/contract.rs @@ -53,7 +53,7 @@ pub struct ContractFunction { )] pub bytecode: Program, - pub debug: DebugInfo, + pub debug: Vec, /// Names of the functions in the program. These are used for more informative debugging and benchmarking. pub names: Vec, diff --git a/noir/noir-repo/compiler/noirc_driver/src/lib.rs b/noir/noir-repo/compiler/noirc_driver/src/lib.rs index 6fe44780484..8a554879e9f 100644 --- a/noir/noir-repo/compiler/noirc_driver/src/lib.rs +++ b/noir/noir-repo/compiler/noirc_driver/src/lib.rs @@ -430,7 +430,8 @@ fn compile_contract_inner( } if errors.is_empty() { - let debug_infos: Vec<_> = functions.iter().map(|function| function.debug.clone()).collect(); + let debug_infos: Vec<_> = + functions.iter().flat_map(|function| function.debug.clone()).collect(); let file_map = filter_relevant_files(&debug_infos, &context.file_manager); let out_structs = contract @@ -547,13 +548,8 @@ pub fn compile_no_check( Ok(CompiledProgram { hash, - // TODO(https://github.com/noir-lang/noir/issues/4428) program, - // TODO(https://github.com/noir-lang/noir/issues/4428) - // Debug info is only relevant for errors at execution time which is not yet supported - // The CompileProgram `debug` field is used in multiple places and is better - // left to be updated once execution of multiple ACIR functions is enabled - debug: debug[0].clone(), + debug, abi, file_map, noir_version: NOIR_ARTIFACT_VERSION_STRING.to_string(), diff --git a/noir/noir-repo/compiler/noirc_driver/src/program.rs b/noir/noir-repo/compiler/noirc_driver/src/program.rs index 9ffd2d70dda..ed7ddb29f59 100644 --- a/noir/noir-repo/compiler/noirc_driver/src/program.rs +++ b/noir/noir-repo/compiler/noirc_driver/src/program.rs @@ -24,7 +24,7 @@ pub struct CompiledProgram { )] pub program: Program, pub abi: noirc_abi::Abi, - pub debug: DebugInfo, + pub debug: Vec, pub file_map: BTreeMap, pub warnings: Vec, /// Names of the functions in the program. These are used for more informative debugging and benchmarking. diff --git a/noir/noir-repo/compiler/noirc_errors/src/debug_info.rs b/noir/noir-repo/compiler/noirc_errors/src/debug_info.rs index 09117bdc3b7..54e2521e413 100644 --- a/noir/noir-repo/compiler/noirc_errors/src/debug_info.rs +++ b/noir/noir-repo/compiler/noirc_errors/src/debug_info.rs @@ -46,6 +46,49 @@ pub type DebugVariables = BTreeMap; pub type DebugFunctions = BTreeMap; pub type DebugTypes = BTreeMap; +#[derive(Default, Debug, Clone, Deserialize, Serialize)] +pub struct ProgramDebugInfo { + pub debug_infos: Vec, +} + +impl ProgramDebugInfo { + pub fn serialize_compressed_base64_json( + debug_info: &ProgramDebugInfo, + s: S, + ) -> Result + where + S: Serializer, + { + let json_str = serde_json::to_string(debug_info).map_err(S::Error::custom)?; + + let mut encoder = DeflateEncoder::new(Vec::new(), Compression::default()); + encoder.write_all(json_str.as_bytes()).map_err(S::Error::custom)?; + let compressed_data = encoder.finish().map_err(S::Error::custom)?; + + let encoded_b64 = base64::prelude::BASE64_STANDARD.encode(compressed_data); + s.serialize_str(&encoded_b64) + } + + pub fn deserialize_compressed_base64_json<'de, D>( + deserializer: D, + ) -> Result + where + D: Deserializer<'de>, + { + let encoded_b64: String = Deserialize::deserialize(deserializer)?; + + let compressed_data = + base64::prelude::BASE64_STANDARD.decode(encoded_b64).map_err(D::Error::custom)?; + + let mut decoder = DeflateDecoder::new(&compressed_data[..]); + let mut decompressed_data = Vec::new(); + decoder.read_to_end(&mut decompressed_data).map_err(D::Error::custom)?; + + let json_str = String::from_utf8(decompressed_data).map_err(D::Error::custom)?; + serde_json::from_str(&json_str).map_err(D::Error::custom) + } +} + #[serde_as] #[derive(Default, Debug, Clone, Deserialize, Serialize)] pub struct DebugInfo { @@ -130,40 +173,4 @@ impl DebugInfo { counted_opcodes } - - pub fn serialize_compressed_base64_json( - debug_info: &DebugInfo, - s: S, - ) -> Result - where - S: Serializer, - { - let json_str = serde_json::to_string(debug_info).map_err(S::Error::custom)?; - - let mut encoder = DeflateEncoder::new(Vec::new(), Compression::default()); - encoder.write_all(json_str.as_bytes()).map_err(S::Error::custom)?; - let compressed_data = encoder.finish().map_err(S::Error::custom)?; - - let encoded_b64 = base64::prelude::BASE64_STANDARD.encode(compressed_data); - s.serialize_str(&encoded_b64) - } - - pub fn deserialize_compressed_base64_json<'de, D>( - deserializer: D, - ) -> Result - where - D: Deserializer<'de>, - { - let encoded_b64: String = Deserialize::deserialize(deserializer)?; - - let compressed_data = - base64::prelude::BASE64_STANDARD.decode(encoded_b64).map_err(D::Error::custom)?; - - let mut decoder = DeflateDecoder::new(&compressed_data[..]); - let mut decompressed_data = Vec::new(); - decoder.read_to_end(&mut decompressed_data).map_err(D::Error::custom)?; - - let json_str = String::from_utf8(decompressed_data).map_err(D::Error::custom)?; - serde_json::from_str(&json_str).map_err(D::Error::custom) - } } diff --git a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs index 59ce4e4f754..2a4b5276547 100644 --- a/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs +++ b/noir/noir-repo/compiler/noirc_evaluator/src/ssa/ssa_gen/mod.rs @@ -243,6 +243,7 @@ impl<'a> FunctionContext<'a> { Ok(Tree::Branch(vec![string, field_count.into(), fields])) } + ast::Literal::Unit => Ok(Self::unit_value()), } } diff --git a/noir/noir-repo/compiler/noirc_frontend/Cargo.toml b/noir/noir-repo/compiler/noirc_frontend/Cargo.toml index 03b92e15032..e39ab2fe106 100644 --- a/noir/noir-repo/compiler/noirc_frontend/Cargo.toml +++ b/noir/noir-repo/compiler/noirc_frontend/Cargo.toml @@ -24,9 +24,16 @@ small-ord-set = "0.1.3" regex = "1.9.1" tracing.workspace = true petgraph = "0.6" +lalrpop-util = { version = "0.20.2", features = ["lexer"] } [dev-dependencies] base64.workspace = true strum = "0.24" strum_macros = "0.24" tempfile.workspace = true + +[build-dependencies] +lalrpop = "0.20.2" + +[features] +experimental_parser = [] diff --git a/noir/noir-repo/compiler/noirc_frontend/build.rs b/noir/noir-repo/compiler/noirc_frontend/build.rs new file mode 100644 index 00000000000..eb896a377ae --- /dev/null +++ b/noir/noir-repo/compiler/noirc_frontend/build.rs @@ -0,0 +1,28 @@ +use std::fs::{read_to_string, File}; +use std::io::Write; + +fn main() { + lalrpop::Configuration::new() + .emit_rerun_directives(true) + .use_cargo_dir_conventions() + .process() + .unwrap(); + + // here, we get a lint error from "extern crate core" so patching that until lalrpop does + // (adding cfg directives appears to be unsupported by lalrpop) + let out_dir = std::env::var("OUT_DIR").unwrap(); + let parser_path = std::path::Path::new(&out_dir).join("noir_parser.rs"); + let content_str = read_to_string(parser_path.clone()).unwrap(); + let mut parser_file = File::create(parser_path).unwrap(); + for line in content_str.lines() { + if line.contains("extern crate core") { + parser_file + .write_all( + format!("{}\n", line.replace("extern crate core", "use core")).as_bytes(), + ) + .unwrap(); + } else { + parser_file.write_all(format!("{}\n", line).as_bytes()).unwrap(); + } + } +} diff --git a/noir/noir-repo/compiler/noirc_frontend/src/ast/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/ast/mod.rs index 4547dc2a176..254ec4a7590 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/ast/mod.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/ast/mod.rs @@ -112,6 +112,9 @@ pub enum UnresolvedTypeData { /*env:*/ Box, ), + // The type of quoted code for metaprogramming + Code, + Unspecified, // This is for when the user declares a variable without specifying it's type Error, } @@ -200,6 +203,7 @@ impl std::fmt::Display for UnresolvedTypeData { } } MutableReference(element) => write!(f, "&mut {element}"), + Code => write!(f, "Code"), Unit => write!(f, "()"), Error => write!(f, "error"), Unspecified => write!(f, "unspecified"), diff --git a/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/hir_to_ast.rs b/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/hir_to_ast.rs new file mode 100644 index 00000000000..8ffcbce7d62 --- /dev/null +++ b/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/hir_to_ast.rs @@ -0,0 +1,350 @@ +use iter_extended::vecmap; +use noirc_errors::{Span, Spanned}; + +use crate::ast::{ConstrainStatement, Expression, Statement, StatementKind}; +use crate::hir_def::expr::{HirArrayLiteral, HirExpression, HirIdent}; +use crate::hir_def::stmt::{HirLValue, HirPattern, HirStatement}; +use crate::macros_api::HirLiteral; +use crate::node_interner::{ExprId, NodeInterner, StmtId}; +use crate::{ + ArrayLiteral, AssignStatement, BlockExpression, CallExpression, CastExpression, ConstrainKind, + ConstructorExpression, ExpressionKind, ForLoopStatement, ForRange, Ident, IfExpression, + IndexExpression, InfixExpression, LValue, Lambda, LetStatement, Literal, + MemberAccessExpression, MethodCallExpression, Path, Pattern, PrefixExpression, Type, + UnresolvedType, UnresolvedTypeData, UnresolvedTypeExpression, +}; + +// TODO: +// - Full path for idents & types +// - Assert/AssertEq information lost +// - The type name span is lost in constructor patterns & expressions +// - All type spans are lost +// - Type::TypeVariable has no equivalent in the Ast + +impl StmtId { + #[allow(unused)] + fn to_ast(self, interner: &NodeInterner) -> Statement { + let statement = interner.statement(&self); + let span = interner.statement_span(&self); + + let kind = match statement { + HirStatement::Let(let_stmt) => { + let pattern = let_stmt.pattern.into_ast(interner); + let r#type = interner.id_type(let_stmt.expression).to_ast(); + let expression = let_stmt.expression.to_ast(interner); + StatementKind::Let(LetStatement { + pattern, + r#type, + expression, + attributes: Vec::new(), + }) + } + HirStatement::Constrain(constrain) => { + let expr = constrain.0.to_ast(interner); + let message = constrain.2.map(|message| message.to_ast(interner)); + + // TODO: Find difference in usage between Assert & AssertEq + StatementKind::Constrain(ConstrainStatement(expr, message, ConstrainKind::Assert)) + } + HirStatement::Assign(assign) => StatementKind::Assign(AssignStatement { + lvalue: assign.lvalue.into_ast(interner), + expression: assign.expression.to_ast(interner), + }), + HirStatement::For(for_stmt) => StatementKind::For(ForLoopStatement { + identifier: for_stmt.identifier.to_ast(interner), + range: ForRange::Range( + for_stmt.start_range.to_ast(interner), + for_stmt.end_range.to_ast(interner), + ), + block: for_stmt.block.to_ast(interner), + span, + }), + HirStatement::Break => StatementKind::Break, + HirStatement::Continue => StatementKind::Continue, + HirStatement::Expression(expr) => StatementKind::Expression(expr.to_ast(interner)), + HirStatement::Semi(expr) => StatementKind::Semi(expr.to_ast(interner)), + HirStatement::Error => StatementKind::Error, + }; + + Statement { kind, span } + } +} + +impl ExprId { + #[allow(unused)] + fn to_ast(self, interner: &NodeInterner) -> Expression { + let expression = interner.expression(&self); + let span = interner.expr_span(&self); + + let kind = match expression { + HirExpression::Ident(ident) => { + let path = Path::from_ident(ident.to_ast(interner)); + ExpressionKind::Variable(path) + } + HirExpression::Literal(HirLiteral::Array(array)) => { + let array = array.into_ast(interner, span); + ExpressionKind::Literal(Literal::Array(array)) + } + HirExpression::Literal(HirLiteral::Slice(array)) => { + let array = array.into_ast(interner, span); + ExpressionKind::Literal(Literal::Slice(array)) + } + HirExpression::Literal(HirLiteral::Bool(value)) => { + ExpressionKind::Literal(Literal::Bool(value)) + } + HirExpression::Literal(HirLiteral::Integer(value, sign)) => { + ExpressionKind::Literal(Literal::Integer(value, sign)) + } + HirExpression::Literal(HirLiteral::Str(string)) => { + ExpressionKind::Literal(Literal::Str(string)) + } + HirExpression::Literal(HirLiteral::FmtStr(string, _exprs)) => { + // TODO: Is throwing away the exprs here valid? + ExpressionKind::Literal(Literal::FmtStr(string)) + } + HirExpression::Literal(HirLiteral::Unit) => ExpressionKind::Literal(Literal::Unit), + HirExpression::Block(expr) => { + let statements = vecmap(expr.statements, |statement| statement.to_ast(interner)); + ExpressionKind::Block(BlockExpression { statements }) + } + HirExpression::Prefix(prefix) => ExpressionKind::Prefix(Box::new(PrefixExpression { + operator: prefix.operator, + rhs: prefix.rhs.to_ast(interner), + })), + HirExpression::Infix(infix) => ExpressionKind::Infix(Box::new(InfixExpression { + lhs: infix.lhs.to_ast(interner), + operator: Spanned::from(infix.operator.location.span, infix.operator.kind), + rhs: infix.rhs.to_ast(interner), + })), + HirExpression::Index(index) => ExpressionKind::Index(Box::new(IndexExpression { + collection: index.collection.to_ast(interner), + index: index.index.to_ast(interner), + })), + HirExpression::Constructor(constructor) => { + let type_name = constructor.r#type.borrow().name.to_string(); + let type_name = Path::from_single(type_name, span); + let fields = + vecmap(constructor.fields, |(name, expr)| (name, expr.to_ast(interner))); + + ExpressionKind::Constructor(Box::new(ConstructorExpression { type_name, fields })) + } + HirExpression::MemberAccess(access) => { + ExpressionKind::MemberAccess(Box::new(MemberAccessExpression { + lhs: access.lhs.to_ast(interner), + rhs: access.rhs, + })) + } + HirExpression::Call(call) => { + let func = Box::new(call.func.to_ast(interner)); + let arguments = vecmap(call.arguments, |arg| arg.to_ast(interner)); + ExpressionKind::Call(Box::new(CallExpression { func, arguments })) + } + HirExpression::MethodCall(method_call) => { + ExpressionKind::MethodCall(Box::new(MethodCallExpression { + object: method_call.object.to_ast(interner), + method_name: method_call.method, + arguments: vecmap(method_call.arguments, |arg| arg.to_ast(interner)), + })) + } + HirExpression::Cast(cast) => { + let lhs = cast.lhs.to_ast(interner); + let r#type = cast.r#type.to_ast(); + ExpressionKind::Cast(Box::new(CastExpression { lhs, r#type })) + } + HirExpression::If(if_expr) => ExpressionKind::If(Box::new(IfExpression { + condition: if_expr.condition.to_ast(interner), + consequence: if_expr.consequence.to_ast(interner), + alternative: if_expr.alternative.map(|expr| expr.to_ast(interner)), + })), + HirExpression::Tuple(fields) => { + ExpressionKind::Tuple(vecmap(fields, |field| field.to_ast(interner))) + } + HirExpression::Lambda(lambda) => { + let parameters = vecmap(lambda.parameters, |(pattern, typ)| { + (pattern.into_ast(interner), typ.to_ast()) + }); + let return_type = lambda.return_type.to_ast(); + let body = lambda.body.to_ast(interner); + ExpressionKind::Lambda(Box::new(Lambda { parameters, return_type, body })) + } + HirExpression::Quote(block) => ExpressionKind::Quote(block), + HirExpression::Error => ExpressionKind::Error, + }; + + Expression::new(kind, span) + } +} + +impl HirPattern { + fn into_ast(self, interner: &NodeInterner) -> Pattern { + match self { + HirPattern::Identifier(ident) => Pattern::Identifier(ident.to_ast(interner)), + HirPattern::Mutable(pattern, location) => { + let pattern = Box::new(pattern.into_ast(interner)); + Pattern::Mutable(pattern, location.span, false) + } + HirPattern::Tuple(patterns, location) => { + let patterns = vecmap(patterns, |pattern| pattern.into_ast(interner)); + Pattern::Tuple(patterns, location.span) + } + HirPattern::Struct(typ, patterns, location) => { + let patterns = + vecmap(patterns, |(name, pattern)| (name, pattern.into_ast(interner))); + let name = match typ.follow_bindings() { + Type::Struct(struct_def, _) => { + let struct_def = struct_def.borrow(); + struct_def.name.0.contents.clone() + } + // This pass shouldn't error so if the type isn't a struct we just get a string + // representation of any other type and use that. We're relying on name + // resolution to fail later when this Ast is re-converted to Hir. + other => other.to_string(), + }; + // The name span is lost here + let path = Path::from_single(name, location.span); + Pattern::Struct(path, patterns, location.span) + } + } + } +} + +impl HirIdent { + fn to_ast(&self, interner: &NodeInterner) -> Ident { + let name = interner.definition_name(self.id).to_owned(); + Ident(Spanned::from(self.location.span, name)) + } +} + +impl Type { + fn to_ast(&self) -> UnresolvedType { + let typ = match self { + Type::FieldElement => UnresolvedTypeData::FieldElement, + Type::Array(length, element) => { + let length = length.to_type_expression(); + let element = Box::new(element.to_ast()); + UnresolvedTypeData::Array(length, element) + } + Type::Slice(element) => { + let element = Box::new(element.to_ast()); + UnresolvedTypeData::Slice(element) + } + Type::Integer(sign, bit_size) => UnresolvedTypeData::Integer(*sign, *bit_size), + Type::Bool => UnresolvedTypeData::Bool, + Type::String(length) => { + let length = length.to_type_expression(); + UnresolvedTypeData::String(Some(length)) + } + Type::FmtString(length, element) => { + let length = length.to_type_expression(); + let element = Box::new(element.to_ast()); + UnresolvedTypeData::FormatString(length, element) + } + Type::Unit => UnresolvedTypeData::Unit, + Type::Tuple(fields) => { + let fields = vecmap(fields, |field| field.to_ast()); + UnresolvedTypeData::Tuple(fields) + } + Type::Struct(def, generics) => { + let struct_def = def.borrow(); + let generics = vecmap(generics, |generic| generic.to_ast()); + let name = Path::from_ident(struct_def.name.clone()); + UnresolvedTypeData::Named(name, generics, false) + } + Type::Alias(type_def, generics) => { + // Keep the alias name instead of expanding this in case the + // alias' definition was changed + let type_def = type_def.borrow(); + let generics = vecmap(generics, |generic| generic.to_ast()); + let name = Path::from_ident(type_def.name.clone()); + UnresolvedTypeData::Named(name, generics, false) + } + Type::TypeVariable(_, _) => todo!("Convert Type::TypeVariable Hir -> Ast"), + Type::TraitAsType(_, name, generics) => { + let generics = vecmap(generics, |generic| generic.to_ast()); + let name = Path::from_single(name.as_ref().clone(), Span::default()); + UnresolvedTypeData::TraitAsType(name, generics) + } + Type::NamedGeneric(_, name) => { + let name = Path::from_single(name.as_ref().clone(), Span::default()); + UnresolvedTypeData::TraitAsType(name, Vec::new()) + } + Type::Function(args, ret, env) => { + let args = vecmap(args, |arg| arg.to_ast()); + let ret = Box::new(ret.to_ast()); + let env = Box::new(env.to_ast()); + UnresolvedTypeData::Function(args, ret, env) + } + Type::MutableReference(element) => { + let element = Box::new(element.to_ast()); + UnresolvedTypeData::MutableReference(element) + } + // Type::Forall is only for generic functions which don't store a type + // in their Ast so they don't need to call to_ast for their Forall type. + // Since there is no UnresolvedTypeData equivalent for Type::Forall, we use + // this to ignore this case since it shouldn't be needed anyway. + Type::Forall(_, typ) => return typ.to_ast(), + Type::Constant(_) => panic!("Type::Constant where a type was expected: {self:?}"), + Type::Code => UnresolvedTypeData::Code, + Type::Error => UnresolvedTypeData::Error, + }; + + UnresolvedType { typ, span: None } + } + + fn to_type_expression(&self) -> UnresolvedTypeExpression { + let span = Span::default(); + + match self.follow_bindings() { + Type::Constant(length) => UnresolvedTypeExpression::Constant(length, span), + Type::NamedGeneric(_, name) => { + let path = Path::from_single(name.as_ref().clone(), span); + UnresolvedTypeExpression::Variable(path) + } + // TODO: This should be turned into a proper error. + other => panic!("Cannot represent {other:?} as type expression"), + } + } +} + +impl HirLValue { + fn into_ast(self, interner: &NodeInterner) -> LValue { + match self { + HirLValue::Ident(ident, _) => LValue::Ident(ident.to_ast(interner)), + HirLValue::MemberAccess { object, field_name, field_index: _, typ: _, location } => { + let object = Box::new(object.into_ast(interner)); + LValue::MemberAccess { object, field_name, span: location.span } + } + HirLValue::Index { array, index, typ: _, location } => { + let array = Box::new(array.into_ast(interner)); + let index = index.to_ast(interner); + LValue::Index { array, index, span: location.span } + } + HirLValue::Dereference { lvalue, element_type: _, location } => { + let lvalue = Box::new(lvalue.into_ast(interner)); + LValue::Dereference(lvalue, location.span) + } + } + } +} + +impl HirArrayLiteral { + fn into_ast(self, interner: &NodeInterner, span: Span) -> ArrayLiteral { + match self { + HirArrayLiteral::Standard(elements) => { + ArrayLiteral::Standard(vecmap(elements, |element| element.to_ast(interner))) + } + HirArrayLiteral::Repeated { repeated_element, length } => { + let repeated_element = Box::new(repeated_element.to_ast(interner)); + let length = match length { + Type::Constant(length) => { + let literal = Literal::Integer((length as u128).into(), false); + let kind = ExpressionKind::Literal(literal); + Box::new(Expression::new(kind, span)) + } + other => panic!("Cannot convert non-constant type for repeated array literal from Hir -> Ast: {other:?}"), + }; + ArrayLiteral::Repeated { repeated_element, length } + } + } + } +} diff --git a/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/mod.rs new file mode 100644 index 00000000000..91621c857cf --- /dev/null +++ b/noir/noir-repo/compiler/noirc_frontend/src/hir/comptime/mod.rs @@ -0,0 +1 @@ +mod hir_to_ast; diff --git a/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs index 29be7524659..55dc22d6c5d 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/hir/mod.rs @@ -1,3 +1,4 @@ +pub mod comptime; pub mod def_collector; pub mod def_map; pub mod resolution; diff --git a/noir/noir-repo/compiler/noirc_frontend/src/hir/resolution/resolver.rs b/noir/noir-repo/compiler/noirc_frontend/src/hir/resolution/resolver.rs index 08b12069d76..9180201fe17 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/hir/resolution/resolver.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/hir/resolution/resolver.rs @@ -502,6 +502,7 @@ impl<'a> Resolver<'a> { let fields = self.resolve_type_inner(*fields, new_variables); Type::FmtString(Box::new(resolved_size), Box::new(fields)) } + Code => Type::Code, Unit => Type::Unit, Unspecified => Type::Error, Error => Type::Error, diff --git a/noir/noir-repo/compiler/noirc_frontend/src/lexer/lexer.rs b/noir/noir-repo/compiler/noirc_frontend/src/lexer/lexer.rs index 265b9e4b5a3..2d1ebf530e3 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/lexer/lexer.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/lexer/lexer.rs @@ -2,7 +2,9 @@ use crate::token::{Attribute, DocStyle}; use super::{ errors::LexerErrorKind, - token::{IntType, Keyword, SpannedToken, Token, Tokens}, + token::{ + token_to_borrowed_token, BorrowedToken, IntType, Keyword, SpannedToken, Token, Tokens, + }, }; use acvm::FieldElement; use noirc_errors::{Position, Span}; @@ -21,6 +23,21 @@ pub struct Lexer<'a> { pub type SpannedTokenResult = Result; +pub(crate) fn from_spanned_token_result( + token_result: &SpannedTokenResult, +) -> Result<(usize, BorrowedToken<'_>, usize), LexerErrorKind> { + token_result + .as_ref() + .map(|spanned_token| { + ( + spanned_token.to_span().start() as usize, + token_to_borrowed_token(spanned_token.into()), + spanned_token.to_span().end() as usize, + ) + }) + .map_err(Clone::clone) +} + impl<'a> Lexer<'a> { /// Given a source file of noir code, return all the tokens in the file /// in order, along with any lexing errors that occurred. @@ -94,7 +111,7 @@ impl<'a> Lexer<'a> { fn next_token(&mut self) -> SpannedTokenResult { match self.next_char() { - Some(x) if x.is_whitespace() => { + Some(x) if Self::is_code_whitespace(x) => { let spanned = self.eat_whitespace(x); if self.skip_whitespaces { self.next_token() @@ -560,16 +577,21 @@ impl<'a> Lexer<'a> { } } + fn is_code_whitespace(c: char) -> bool { + c == '\t' || c == '\n' || c == '\r' || c == ' ' + } + /// Skips white space. They are not significant in the source language fn eat_whitespace(&mut self, initial_char: char) -> SpannedToken { let start = self.position; - let whitespace = self.eat_while(initial_char.into(), |ch| ch.is_whitespace()); + let whitespace = self.eat_while(initial_char.into(), Self::is_code_whitespace); SpannedToken::new(Token::Whitespace(whitespace), Span::inclusive(start, self.position)) } } impl<'a> Iterator for Lexer<'a> { type Item = SpannedTokenResult; + fn next(&mut self) -> Option { if self.done { None @@ -578,10 +600,12 @@ impl<'a> Iterator for Lexer<'a> { } } } + #[cfg(test)] mod tests { use super::*; use crate::token::{FunctionAttribute, SecondaryAttribute, TestScope}; + #[test] fn test_single_double_char() { let input = "! != + ( ) { } [ ] | , ; : :: < <= > >= & - -> . .. % / * = == << >>"; diff --git a/noir/noir-repo/compiler/noirc_frontend/src/lexer/token.rs b/noir/noir-repo/compiler/noirc_frontend/src/lexer/token.rs index 357b1ead593..86f26fd1c97 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/lexer/token.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/lexer/token.rs @@ -9,12 +9,105 @@ use crate::lexer::errors::LexerErrorKind; /// smallest unit of grammar. A parser may (will) decide to parse /// items differently depending on the Tokens present but will /// never parse the same ordering of identical tokens differently. +#[derive(PartialEq, Eq, Hash, Debug, Clone, PartialOrd, Ord)] +pub enum BorrowedToken<'input> { + Ident(&'input str), + Int(FieldElement), + Bool(bool), + Str(&'input str), + /// the u8 is the number of hashes, i.e. r###.. + RawStr(&'input str, u8), + FmtStr(&'input str), + Keyword(Keyword), + IntType(IntType), + Attribute(Attribute), + LineComment(&'input str, Option), + BlockComment(&'input str, Option), + /// < + Less, + /// <= + LessEqual, + /// > + Greater, + /// >= + GreaterEqual, + /// == + Equal, + /// != + NotEqual, + /// + + Plus, + /// - + Minus, + /// * + Star, + /// / + Slash, + /// % + Percent, + /// & + Ampersand, + /// ^ + Caret, + /// << + ShiftLeft, + /// >> + ShiftRight, + /// . + Dot, + /// .. + DoubleDot, + /// ( + LeftParen, + /// ) + RightParen, + /// { + LeftBrace, + /// } + RightBrace, + /// [ + LeftBracket, + /// ] + RightBracket, + /// -> + Arrow, + /// | + Pipe, + /// # + Pound, + /// , + Comma, + /// : + Colon, + /// :: + DoubleColon, + /// ; + Semicolon, + /// ! + Bang, + /// = + Assign, + #[allow(clippy::upper_case_acronyms)] + EOF, + + Whitespace(&'input str), + + /// An invalid character is one that is not in noir's language or grammar. + /// + /// We don't report invalid tokens in the source as errors until parsing to + /// avoid reporting the error twice (once while lexing, again when it is encountered + /// during parsing). Reporting during lexing then removing these from the token stream + /// would not be equivalent as it would change the resulting parse. + Invalid(char), +} + #[derive(PartialEq, Eq, Hash, Debug, Clone, PartialOrd, Ord)] pub enum Token { Ident(String), Int(FieldElement), Bool(bool), Str(String), + /// the u8 is the number of hashes, i.e. r###.. RawStr(String, u8), FmtStr(String), Keyword(Keyword), @@ -100,6 +193,57 @@ pub enum Token { Invalid(char), } +pub fn token_to_borrowed_token(token: &Token) -> BorrowedToken<'_> { + match token { + Token::Ident(ref s) => BorrowedToken::Ident(s), + Token::Int(n) => BorrowedToken::Int(*n), + Token::Bool(b) => BorrowedToken::Bool(*b), + Token::Str(ref b) => BorrowedToken::Str(b), + Token::FmtStr(ref b) => BorrowedToken::FmtStr(b), + Token::RawStr(ref b, hashes) => BorrowedToken::RawStr(b, *hashes), + Token::Keyword(k) => BorrowedToken::Keyword(*k), + Token::Attribute(ref a) => BorrowedToken::Attribute(a.clone()), + Token::LineComment(ref s, _style) => BorrowedToken::LineComment(s, *_style), + Token::BlockComment(ref s, _style) => BorrowedToken::BlockComment(s, *_style), + Token::IntType(ref i) => BorrowedToken::IntType(i.clone()), + Token::Less => BorrowedToken::Less, + Token::LessEqual => BorrowedToken::LessEqual, + Token::Greater => BorrowedToken::Greater, + Token::GreaterEqual => BorrowedToken::GreaterEqual, + Token::Equal => BorrowedToken::Equal, + Token::NotEqual => BorrowedToken::NotEqual, + Token::Plus => BorrowedToken::Plus, + Token::Minus => BorrowedToken::Minus, + Token::Star => BorrowedToken::Star, + Token::Slash => BorrowedToken::Slash, + Token::Percent => BorrowedToken::Percent, + Token::Ampersand => BorrowedToken::Ampersand, + Token::Caret => BorrowedToken::Caret, + Token::ShiftLeft => BorrowedToken::ShiftLeft, + Token::ShiftRight => BorrowedToken::ShiftRight, + Token::Dot => BorrowedToken::Dot, + Token::DoubleDot => BorrowedToken::DoubleDot, + Token::LeftParen => BorrowedToken::LeftParen, + Token::RightParen => BorrowedToken::RightParen, + Token::LeftBrace => BorrowedToken::LeftBrace, + Token::RightBrace => BorrowedToken::RightBrace, + Token::LeftBracket => BorrowedToken::LeftBracket, + Token::RightBracket => BorrowedToken::RightBracket, + Token::Arrow => BorrowedToken::Arrow, + Token::Pipe => BorrowedToken::Pipe, + Token::Pound => BorrowedToken::Pound, + Token::Comma => BorrowedToken::Comma, + Token::Colon => BorrowedToken::Colon, + Token::DoubleColon => BorrowedToken::DoubleColon, + Token::Semicolon => BorrowedToken::Semicolon, + Token::Assign => BorrowedToken::Assign, + Token::Bang => BorrowedToken::Bang, + Token::EOF => BorrowedToken::EOF, + Token::Invalid(c) => BorrowedToken::Invalid(*c), + Token::Whitespace(ref s) => BorrowedToken::Whitespace(s), + } +} + #[derive(Clone, Copy, PartialEq, Eq, Hash, Debug, PartialOrd, Ord)] pub enum DocStyle { Outer, @@ -126,6 +270,12 @@ impl From for Token { } } +impl<'a> From<&'a SpannedToken> for &'a Token { + fn from(spt: &'a SpannedToken) -> Self { + &spt.0.contents + } +} + impl SpannedToken { pub fn new(token: Token, span: Span) -> SpannedToken { SpannedToken(Spanned::from(span, token)) diff --git a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/ast.rs b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/ast.rs index 7d20c2bcfee..d9c33d8604e 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/ast.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/ast.rs @@ -92,6 +92,7 @@ pub enum Literal { Slice(ArrayLiteral), Integer(FieldElement, Type, Location), Bool(bool), + Unit, Str(String), FmtStr(String, u64, Box), } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/mod.rs index 6aa0abce152..4e779244d30 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/mod.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/mod.rs @@ -52,14 +52,13 @@ struct LambdaContext { /// This struct holds the FIFO queue of functions to monomorphize, which is added to /// whenever a new (function, type) combination is encountered. struct Monomorphizer<'interner> { - /// Globals are keyed by their unique ID and expected type so that we can monomorphize - /// a new version of the global for each type. Note that 'global' here means 'globally - /// visible' and thus includes both functions and global variables. + /// Functions are keyed by their unique ID and expected type so that we can monomorphize + /// a new version of the function for each type. /// /// Using nested HashMaps here lets us avoid cloning HirTypes when calling .get() - globals: HashMap>, + functions: HashMap>, - /// Unlike globals, locals are only keyed by their unique ID because they are never + /// Unlike functions, locals are only keyed by their unique ID because they are never /// duplicated during monomorphization. Doing so would allow them to be used polymorphically /// but would also cause them to be re-evaluated which is a performance trap that would /// confuse users. @@ -165,7 +164,7 @@ pub fn monomorphize_debug( impl<'interner> Monomorphizer<'interner> { fn new(interner: &'interner mut NodeInterner, debug_type_tracker: DebugTypeTracker) -> Self { Monomorphizer { - globals: HashMap::new(), + functions: HashMap::new(), locals: HashMap::new(), queue: VecDeque::new(), finished_functions: BTreeMap::new(), @@ -203,7 +202,7 @@ impl<'interner> Monomorphizer<'interner> { trait_method: Option, ) -> Definition { let typ = typ.follow_bindings(); - match self.globals.get(&id).and_then(|inner_map| inner_map.get(&typ)) { + match self.functions.get(&id).and_then(|inner_map| inner_map.get(&typ)) { Some(id) => Definition::Function(*id), None => { // Function has not been monomorphized yet @@ -251,8 +250,8 @@ impl<'interner> Monomorphizer<'interner> { } /// Prerequisite: typ = typ.follow_bindings() - fn define_global(&mut self, id: node_interner::FuncId, typ: HirType, new_id: FuncId) { - self.globals.entry(id).or_default().insert(typ, new_id); + fn define_function(&mut self, id: node_interner::FuncId, typ: HirType, new_id: FuncId) { + self.functions.entry(id).or_default().insert(typ, new_id); } fn compile_main( @@ -786,7 +785,7 @@ impl<'interner> Monomorphizer<'interner> { }) } - /// A local (ie non-global) ident only + /// A local (ie non-function) ident only fn local_ident( &mut self, ident: &HirIdent, @@ -1280,7 +1279,7 @@ impl<'interner> Monomorphizer<'interner> { trait_method: Option, ) -> FuncId { let new_id = self.next_function_id(); - self.define_global(id, function_type.clone(), new_id); + self.define_function(id, function_type.clone(), new_id); let bindings = self.interner.get_instantiation_bindings(expr_id); let bindings = self.follow_bindings(bindings); @@ -1553,9 +1552,7 @@ impl<'interner> Monomorphizer<'interner> { ast::Expression::Literal(ast::Literal::Integer(0_u128.into(), typ, location)) } ast::Type::Bool => ast::Expression::Literal(ast::Literal::Bool(false)), - // There is no unit literal currently. Replace it with 'false' since it should be ignored - // anyway. - ast::Type::Unit => ast::Expression::Literal(ast::Literal::Bool(false)), + ast::Type::Unit => ast::Expression::Literal(ast::Literal::Unit), ast::Type::Array(length, element_type) => { let element = self.zeroed_value_of_type(element_type.as_ref(), location); ast::Expression::Literal(ast::Literal::Array(ast::ArrayLiteral { diff --git a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/printer.rs b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/printer.rs index c253bfe7930..ea8f079cc2f 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/printer.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/monomorphization/printer.rs @@ -110,6 +110,9 @@ impl AstPrinter { s.fmt(f)?; write!(f, "\"") } + super::ast::Literal::Unit => { + write!(f, "()") + } } } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs b/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs index c9eef286bbd..153c7e45d4a 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/node_interner.rs @@ -917,6 +917,10 @@ impl NodeInterner { self.id_location(expr_id) } + pub fn statement_span(&self, stmt_id: &StmtId) -> Span { + self.id_location(stmt_id).span + } + pub fn get_struct(&self, id: StructId) -> Shared { self.structs[&id].clone() } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/noir_parser.lalrpop b/noir/noir-repo/compiler/noirc_frontend/src/noir_parser.lalrpop new file mode 100644 index 00000000000..c8d293fb72f --- /dev/null +++ b/noir/noir-repo/compiler/noirc_frontend/src/noir_parser.lalrpop @@ -0,0 +1,164 @@ +use noirc_errors::Span; + +use crate::lexer::token::BorrowedToken; +use crate::lexer::token as noir_token; +use crate::lexer::errors::LexerErrorKind; +use crate::parser::TopLevelStatement; +use crate::{Ident, Path, PathKind, UseTree, UseTreeKind}; + +use lalrpop_util::ErrorRecovery; + +grammar<'input, 'err>(input: &'input str, errors: &'err mut [ErrorRecovery, &'static str>]); + +extern { + type Location = usize; + + type Error = LexerErrorKind; + + // NOTE: each token needs a terminal defined + enum BorrowedToken<'input> { + string => BorrowedToken::Str(<&'input str>), + ident => BorrowedToken::Ident(<&'input str>), + + // symbols + "<" => BorrowedToken::Less, + "<=" => BorrowedToken::LessEqual, + ">" => BorrowedToken::Greater, + ">=" => BorrowedToken::GreaterEqual, + "==" => BorrowedToken::Equal, + "!=" => BorrowedToken::NotEqual, + "+" => BorrowedToken::Plus, + "-" => BorrowedToken::Minus, + "*" => BorrowedToken::Star, + "/" => BorrowedToken::Slash, + "%" => BorrowedToken::Percent, + "&" => BorrowedToken::Ampersand, + "^" => BorrowedToken::Caret, + "<<" => BorrowedToken::ShiftLeft, + ">>" => BorrowedToken::ShiftRight, + "." => BorrowedToken::Dot, + ".." => BorrowedToken::DoubleDot, + "(" => BorrowedToken::LeftParen, + ")" => BorrowedToken::RightParen, + "{" => BorrowedToken::LeftBrace, + "}" => BorrowedToken::RightBrace, + "[" => BorrowedToken::LeftBracket, + "]" => BorrowedToken::RightBracket, + "->" => BorrowedToken::Arrow, + "|" => BorrowedToken::Pipe, + "#" => BorrowedToken::Pound, + "," => BorrowedToken::Comma, + ":" => BorrowedToken::Colon, + "::" => BorrowedToken::DoubleColon, + ";" => BorrowedToken::Semicolon, + "!" => BorrowedToken::Bang, + "=" => BorrowedToken::Assign, + // keywords + "as" => BorrowedToken::Keyword(noir_token::Keyword::As), + "assert" => BorrowedToken::Keyword(noir_token::Keyword::Assert), + "assert_eq" => BorrowedToken::Keyword(noir_token::Keyword::AssertEq), + "bool" => BorrowedToken::Keyword(noir_token::Keyword::Bool), + "break" => BorrowedToken::Keyword(noir_token::Keyword::Break), + "call_data" => BorrowedToken::Keyword(noir_token::Keyword::CallData), + "char" => BorrowedToken::Keyword(noir_token::Keyword::Char), + "comptime" => BorrowedToken::Keyword(noir_token::Keyword::CompTime), + "constrain" => BorrowedToken::Keyword(noir_token::Keyword::Constrain), + "continue" => BorrowedToken::Keyword(noir_token::Keyword::Continue), + "contract" => BorrowedToken::Keyword(noir_token::Keyword::Contract), + "crate" => BorrowedToken::Keyword(noir_token::Keyword::Crate), + "dep" => BorrowedToken::Keyword(noir_token::Keyword::Dep), + "distinct" => BorrowedToken::Keyword(noir_token::Keyword::Distinct), + "else" => BorrowedToken::Keyword(noir_token::Keyword::Else), + "Field" => BorrowedToken::Keyword(noir_token::Keyword::Field), + "fn" => BorrowedToken::Keyword(noir_token::Keyword::Fn), + "for" => BorrowedToken::Keyword(noir_token::Keyword::For), + "fmtstr" => BorrowedToken::Keyword(noir_token::Keyword::FormatString), + "global" => BorrowedToken::Keyword(noir_token::Keyword::Global), + "if" => BorrowedToken::Keyword(noir_token::Keyword::If), + "impl" => BorrowedToken::Keyword(noir_token::Keyword::Impl), + "in" => BorrowedToken::Keyword(noir_token::Keyword::In), + "let" => BorrowedToken::Keyword(noir_token::Keyword::Let), + "mod" => BorrowedToken::Keyword(noir_token::Keyword::Mod), + "mut" => BorrowedToken::Keyword(noir_token::Keyword::Mut), + "pub" => BorrowedToken::Keyword(noir_token::Keyword::Pub), + "quote" => BorrowedToken::Keyword(noir_token::Keyword::Quote), + "return" => BorrowedToken::Keyword(noir_token::Keyword::Return), + "return_data" => BorrowedToken::Keyword(noir_token::Keyword::ReturnData), + "str" => BorrowedToken::Keyword(noir_token::Keyword::String), + "struct" => BorrowedToken::Keyword(noir_token::Keyword::Struct), + "trait" => BorrowedToken::Keyword(noir_token::Keyword::Trait), + "type" => BorrowedToken::Keyword(noir_token::Keyword::Type), + "unchecked" => BorrowedToken::Keyword(noir_token::Keyword::Unchecked), + "unconstrained" => BorrowedToken::Keyword(noir_token::Keyword::Unconstrained), + "use" => BorrowedToken::Keyword(noir_token::Keyword::Use), + "where" => BorrowedToken::Keyword(noir_token::Keyword::Where), + "while" => BorrowedToken::Keyword(noir_token::Keyword::While), + // bool + "true" => BorrowedToken::Bool(true), + "false" => BorrowedToken::Bool(false), + + r"[\t\r\n ]+" => BorrowedToken::Whitespace(_), + + EOF => BorrowedToken::EOF, + } +} + +pub(crate) TopLevelStatement: TopLevelStatement = { + "use" r"[\t\r\n ]+" ";" EOF => { + TopLevelStatement::Import(use_tree) + } +} + +UseTree: UseTree = { + // path::to::ident as SomeAlias + => { + let ident = prefix.pop(); + let kind = UseTreeKind::Path(ident, alias); + UseTree { prefix, kind } + }, +} + +pub(crate) Path: Path = { + "crate" "::" => { + let kind = PathKind::Crate; + let span = Span::from(lo as u32..hi as u32); + Path { segments, kind, span } + }, + + "dep" "::" => { + let kind = PathKind::Dep; + let span = Span::from(lo as u32..hi as u32); + Path { segments, kind, span } + }, + + => { + segments.insert(0, id); + let kind = PathKind::Plain; + let span = Span::from(lo as u32..hi as u32); + Path { segments, kind, span } + }, +} + +PathSegments: Vec = { + )*> => { + segments + } +} + +Alias: Ident = { + r"[\t\r\n ]+" "as" r"[\t\r\n ]+" => <>, +} + +Ident: Ident = { + => { + let token = noir_token::Token::Ident(i.to_string()); + let span = Span::from(lo as u32..hi as u32); + Ident::from_token(token, span) + }, +} + +Bool: BorrowedToken<'input> = { + "true" => BorrowedToken::Bool(true), + "false" => BorrowedToken::Bool(false), +}; + diff --git a/noir/noir-repo/compiler/noirc_frontend/src/parser/errors.rs b/noir/noir-repo/compiler/noirc_frontend/src/parser/errors.rs index 43a1f96f13f..895d4e07bbd 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/parser/errors.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/parser/errors.rs @@ -110,25 +110,31 @@ impl ParserError { impl std::fmt::Display for ParserError { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { + let reason_str: String = if self.reason.is_none() { + "".to_string() + } else { + format!("\nreason: {}", Diagnostic::from(self.clone())) + }; let mut expected = vecmap(&self.expected_tokens, ToString::to_string); expected.append(&mut vecmap(&self.expected_labels, |label| format!("{label}"))); if expected.is_empty() { - write!(f, "Unexpected {} in input", self.found) + write!(f, "Unexpected {} in input{}", self.found, reason_str) } else if expected.len() == 1 { let first = expected.first().unwrap(); let vowel = "aeiou".contains(first.chars().next().unwrap()); write!( f, - "Expected a{} {} but found {}", + "Expected a{} {} but found {}{}", if vowel { "n" } else { "" }, first, - self.found + self.found, + reason_str ) } else { let expected = expected.iter().map(ToString::to_string).collect::>().join(", "); - write!(f, "Unexpected {}, expected one of {}", self.found, expected) + write!(f, "Unexpected {}, expected one of {}{}", self.found, expected, reason_str) } } } diff --git a/noir/noir-repo/compiler/noirc_frontend/src/parser/mod.rs b/noir/noir-repo/compiler/noirc_frontend/src/parser/mod.rs index ea96dee8a47..80c5f47f07b 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/parser/mod.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/parser/mod.rs @@ -97,14 +97,14 @@ where /// Sequence the two parsers. /// Fails if the first parser fails, otherwise forces /// the second parser to succeed while logging any errors. -fn then_commit<'a, P1, P2, T1, T2: 'a>( +fn then_commit<'a, P1, P2, T1, T2>( first_parser: P1, second_parser: P2, ) -> impl NoirParser<(T1, T2)> + 'a where P1: NoirParser + 'a, P2: NoirParser + 'a, - T2: Clone + Recoverable, + T2: Clone + Recoverable + 'a, { let second_parser = skip_then_retry_until(second_parser) .map_with_span(|option, span| option.unwrap_or_else(|| Recoverable::error(span))); @@ -112,14 +112,15 @@ where first_parser.then(second_parser) } -fn then_commit_ignore<'a, P1, P2, T1: 'a, T2: 'a>( +fn then_commit_ignore<'a, P1, P2, T1, T2>( first_parser: P1, second_parser: P2, ) -> impl NoirParser + 'a where P1: NoirParser + 'a, P2: NoirParser + 'a, - T2: Clone, + T1: 'a, + T2: Clone + 'a, { let second_parser = skip_then_retry_until(second_parser); first_parser.then_ignore(second_parser) @@ -140,10 +141,10 @@ where first_parser.ignore_then(second_parser) } -fn skip_then_retry_until<'a, P, T: 'a>(parser: P) -> impl NoirParser> + 'a +fn skip_then_retry_until<'a, P, T>(parser: P) -> impl NoirParser> + 'a where P: NoirParser + 'a, - T: Clone, + T: Clone + 'a, { let terminators = [ Token::EOF, diff --git a/noir/noir-repo/compiler/noirc_frontend/src/parser/parser.rs b/noir/noir-repo/compiler/noirc_frontend/src/parser/parser.rs index 0a21465fe87..5706c3ef12f 100644 --- a/noir/noir-repo/compiler/noirc_frontend/src/parser/parser.rs +++ b/noir/noir-repo/compiler/noirc_frontend/src/parser/parser.rs @@ -35,7 +35,7 @@ use super::{spanned, Item, ItemKind}; use crate::ast::{ Expression, ExpressionKind, LetStatement, StatementKind, UnresolvedType, UnresolvedTypeData, }; -use crate::lexer::Lexer; +use crate::lexer::{lexer::from_spanned_token_result, Lexer}; use crate::parser::{force, ignore_then_commit, statement_recovery}; use crate::token::{Keyword, Token, TokenKind}; use crate::{ @@ -47,6 +47,7 @@ use crate::{ use chumsky::prelude::*; use iter_extended::vecmap; +use lalrpop_util::lalrpop_mod; use noirc_errors::{Span, Spanned}; mod assertion; @@ -59,6 +60,9 @@ mod primitives; mod structs; mod traits; +// synthesized by LALRPOP +lalrpop_mod!(pub noir_parser); + #[cfg(test)] mod test_helpers; @@ -77,8 +81,79 @@ pub fn parse_program(source_program: &str) -> (ParsedModule, Vec) { let (module, mut parsing_errors) = program().parse_recovery_verbose(tokens); parsing_errors.extend(lexing_errors.into_iter().map(Into::into)); + let parsed_module = module.unwrap_or(ParsedModule { items: vec![] }); + + if cfg!(feature = "experimental_parser") { + for parsed_item in &parsed_module.items { + if lalrpop_parser_supports_kind(&parsed_item.kind) { + match &parsed_item.kind { + ItemKind::Import(parsed_use_tree) => { + prototype_parse_use_tree(Some(parsed_use_tree), source_program); + } + // other kinds prevented by lalrpop_parser_supports_kind + _ => unreachable!(), + } + } + } + } + (parsed_module, parsing_errors) +} + +fn prototype_parse_use_tree(expected_use_tree_opt: Option<&UseTree>, input: &str) { + // TODO(https://github.com/noir-lang/noir/issues/4777): currently skipping + // recursive use trees, e.g. "use std::{foo, bar}" + if input.contains('{') { + return; + } + + let mut lexer = Lexer::new(input); + lexer = lexer.skip_whitespaces(false); + let mut errors = Vec::new(); + + // NOTE: this is a hack to get the references working + // => this likely means that we'll want to propagate the <'input> lifetime further into Token + let lexer_result = lexer.collect::>(); + let referenced_lexer_result = lexer_result.iter().map(from_spanned_token_result); + + let calculated = noir_parser::TopLevelStatementParser::new().parse( + input, + &mut errors, + referenced_lexer_result, + ); + + if let Some(expected_use_tree) = expected_use_tree_opt { + assert!( + calculated.is_ok(), + "calculated not Ok(_): {:?}\n\nlexer: {:?}\n\ninput: {:?}", + calculated, + lexer_result, + input + ); + + match calculated.unwrap() { + TopLevelStatement::Import(parsed_use_tree) => { + assert_eq!(expected_use_tree, &parsed_use_tree); + } + unexpected_calculated => { + panic!( + "expected a TopLevelStatement::Import, but found: {:?}", + unexpected_calculated + ) + } + } + } else { + assert!( + calculated.is_err(), + "calculated not Err(_): {:?}\n\nlexer: {:?}\n\ninput: {:?}", + calculated, + lexer_result, + input + ); + } +} - (module.unwrap_or(ParsedModule { items: vec![] }), parsing_errors) +fn lalrpop_parser_supports_kind(kind: &ItemKind) -> bool { + matches!(kind, ItemKind::Import(_)) } /// program: module EOF @@ -1512,33 +1587,53 @@ mod test { #[test] fn parse_use() { - parse_all( - use_statement(), - vec![ - "use std::hash", - "use std", - "use foo::bar as hello", - "use bar as bar", - "use foo::{}", - "use foo::{bar,}", - "use foo::{bar, hello}", - "use foo::{bar as bar2, hello}", - "use foo::{bar as bar2, hello::{foo}, nested::{foo, bar}}", - "use dep::{std::println, bar::baz}", - ], - ); + let valid_use_statements = [ + "use std::hash", + "use std", + "use foo::bar as hello", + "use bar as bar", + "use foo::{}", + "use foo::{bar,}", + "use foo::{bar, hello}", + "use foo::{bar as bar2, hello}", + "use foo::{bar as bar2, hello::{foo}, nested::{foo, bar}}", + "use dep::{std::println, bar::baz}", + ]; - parse_all_failing( - use_statement(), - vec![ - "use std as ;", - "use foobar as as;", - "use hello:: as foo;", - "use foo bar::baz", - "use foo bar::{baz}", - "use foo::{,}", - ], - ); + let invalid_use_statements = [ + "use std as ;", + "use foobar as as;", + "use hello:: as foo;", + "use foo bar::baz", + "use foo bar::{baz}", + "use foo::{,}", + ]; + + let use_statements = valid_use_statements + .into_iter() + .map(|valid_str| (valid_str, true)) + .chain(invalid_use_statements.into_iter().map(|invalid_str| (invalid_str, false))); + + for (use_statement_str, expect_valid) in use_statements { + let mut use_statement_str = use_statement_str.to_string(); + let expected_use_statement = if expect_valid { + let (result_opt, _diagnostics) = + parse_recover(&use_statement(), &use_statement_str); + use_statement_str.push(';'); + match result_opt.unwrap() { + TopLevelStatement::Import(expected_use_statement) => { + Some(expected_use_statement) + } + _ => unreachable!(), + } + } else { + let result = parse_with(&use_statement(), &use_statement_str); + assert!(result.is_err()); + None + }; + + prototype_parse_use_tree(expected_use_statement.as_ref(), &use_statement_str); + } } #[test] diff --git a/noir/noir-repo/compiler/wasm/src/types/noir_artifact.ts b/noir/noir-repo/compiler/wasm/src/types/noir_artifact.ts index f241b539dc7..6ecc3ccd56f 100644 --- a/noir/noir-repo/compiler/wasm/src/types/noir_artifact.ts +++ b/noir/noir-repo/compiler/wasm/src/types/noir_artifact.ts @@ -151,6 +151,16 @@ export interface DebugInfo { locations: Record; } +/** + * The debug information for a given program. + */ +export interface ProgramDebugInfo { + /** + * An array that maps to each function of a program. + */ + debug_infos: Array; +} + /** * Maps a file ID to its metadata for debugging purposes. */ diff --git a/noir/noir-repo/compiler/wasm/test/compiler/shared/compile.test.ts b/noir/noir-repo/compiler/wasm/test/compiler/shared/compile.test.ts index 52cef14968b..f9e37530cbc 100644 --- a/noir/noir-repo/compiler/wasm/test/compiler/shared/compile.test.ts +++ b/noir/noir-repo/compiler/wasm/test/compiler/shared/compile.test.ts @@ -5,6 +5,7 @@ import { ContractCompilationArtifacts, DebugFileMap, DebugInfo, + ProgramDebugInfo, NoirFunctionEntry, ProgramArtifact, ProgramCompilationArtifacts, @@ -15,7 +16,7 @@ export function shouldCompileProgramIdentically( expect: typeof Expect, timeout = 5000, ) { - it('both nargo and noir_wasm should compile identically', async () => { + it('both nargo and noir_wasm should compile program identically', async () => { // Compile! const { nargoArtifact, noirWasmArtifact } = await compileFn(); @@ -51,7 +52,7 @@ export function shouldCompileContractIdentically( expect: typeof Expect, timeout = 5000, ) { - it('both nargo and noir_wasm should compile identically', async () => { + it('both nargo and noir_wasm should compile contract identically', async () => { // Compile! const { nargoArtifact, noirWasmArtifact } = await compileFn(); @@ -90,7 +91,7 @@ function extractDebugInfos(fns: NoirFunctionEntry[]) { return fns.map((fn) => { const debugSymbols = inflateDebugSymbols(fn.debug_symbols); delete (fn as Partial).debug_symbols; - clearFileIdentifiers(debugSymbols); + clearFileIdentifiersProgram(debugSymbols); return debugSymbols; }); } @@ -113,6 +114,12 @@ function deleteContractDebugMetadata(contract: ContractArtifact) { return [extractDebugInfos(contract.functions), fileMap]; } +function clearFileIdentifiersProgram(debugSymbols: ProgramDebugInfo) { + debugSymbols.debug_infos.map((debug_info) => { + clearFileIdentifiers(debug_info); + }); +} + /** Clears file identifiers from a set of debug symbols. */ function clearFileIdentifiers(debugSymbols: DebugInfo) { for (const loc of Object.values(debugSymbols.locations)) { diff --git a/noir/noir-repo/cspell.json b/noir/noir-repo/cspell.json index 16de9757fb8..bf3040265c2 100644 --- a/noir/noir-repo/cspell.json +++ b/noir/noir-repo/cspell.json @@ -113,6 +113,7 @@ "Maddiaa", "mathbb", "memfs", + "memset", "merkle", "metas", "minreq", diff --git a/noir/noir-repo/deny.toml b/noir/noir-repo/deny.toml index eff233687e8..db7e53cad24 100644 --- a/noir/noir-repo/deny.toml +++ b/noir/noir-repo/deny.toml @@ -58,7 +58,7 @@ allow = [ # bitmaps 2.1.0, im 15.1.0 "MPL-2.0", # Boost Software License - "BSL-1.0", + "BSL-1.0" ] # Allow 1 or more licenses on a per-crate basis, so that particular licenses @@ -70,6 +70,7 @@ exceptions = [ { allow = ["CC0-1.0"], name = "more-asserts" }, { allow = ["CC0-1.0"], name = "jsonrpc" }, { allow = ["CC0-1.0"], name = "notify" }, + { allow = ["CC0-1.0"], name = "tiny-keccak" }, { allow = ["MPL-2.0"], name = "sized-chunks" }, { allow = ["MPL-2.0"], name = "webpki-roots" }, diff --git a/noir/noir-repo/docs/docs/getting_started/tooling/index.mdx b/noir/noir-repo/docs/docs/getting_started/tooling/index.mdx deleted file mode 100644 index ac480f3c9f5..00000000000 --- a/noir/noir-repo/docs/docs/getting_started/tooling/index.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Tooling -Description: This section provides information about the various tools and utilities available for Noir development. It covers the Noir playground, IDE tools, Codespaces, and community projects. -Keywords: [Noir, Development, Playground, IDE Tools, Language Service Provider, VS Code Extension, Codespaces, noir-starter, Community Projects, Awesome Noir Repository, Developer Tooling] ---- - -Noir is meant to be easy to develop with. For that reason, a number of utilities have been put together to ease the development process as much as feasible in the zero-knowledge world. - -## Playground - -The Noir playground is an easy way to test small ideas, share snippets, and integrate in other websites. You can access it at [play.noir-lang.org](https://play.noir-lang.org). - -## IDE tools - -When you install Nargo, you're also installing a Language Service Provider (LSP), which can be used by IDEs to provide syntax highlighting, codelens, warnings, and more. - -The easiest way to use these tools is by installing the [Noir VS Code extension](https://marketplace.visualstudio.com/items?itemName=noir-lang.vscode-noir). - -## Codespaces - -Some Noir repos have leveraged Codespaces in order to ease the development process. You can visit the [noir-starter](https://github.com/noir-lang/noir-starter) for an example. - - - -## GitHub Actions - -You can use `noirup` with GitHub Actions for CI/CD and automated testing. It is as simple as -installing `noirup` and running tests in your GitHub Action `yml` file. - -See the -[config file in the Noir repo](https://github.com/TomAFrench/noir-hashes/blob/master/.github/workflows/noir.yml) for an example usage. - -## Community projects - -As an open-source project, Noir has received many contributions over time. Some of them are related with developer tooling, and you can see some of them in [Awesome Noir repository](https://github.com/noir-lang/awesome-noir#dev-tools) diff --git a/noir/noir-repo/docs/docs/how_to/debugger/_category_.json b/noir/noir-repo/docs/docs/how_to/debugger/_category_.json new file mode 100644 index 00000000000..cc2cbb1c253 --- /dev/null +++ b/noir/noir-repo/docs/docs/how_to/debugger/_category_.json @@ -0,0 +1,6 @@ +{ + "label": "Debugging", + "position": 5, + "collapsible": true, + "collapsed": true +} diff --git a/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_the_repl.md b/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_the_repl.md new file mode 100644 index 00000000000..09e5bae68ad --- /dev/null +++ b/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_the_repl.md @@ -0,0 +1,164 @@ +--- +title: Using the REPL Debugger +description: + Step by step guide on how to debug your Noir circuits with the REPL Debugger. +keywords: + [ + Nargo, + Noir CLI, + Noir Debugger, + REPL, + ] +sidebar_position: 1 +--- + +#### Pre-requisites + +In order to use the REPL debugger, first you need to install recent enough versions of Nargo and vscode-noir. + +## Debugging a simple circuit + +Let's debug a simple circuit: + +```rust +fn main(x : Field, y : pub Field) { + assert(x != y); +} +``` + +To start the REPL debugger, using a terminal, go to a Noir circuit's home directory. Then: + +`$ nargo debug` + +You should be seeing this in your terminal: + +``` +[main] Starting debugger +At ~/noir-examples/recursion/circuits/main/src/main.nr:1:9 + 1 -> fn main(x : Field, y : pub Field) { + 2 assert(x != y); + 3 } +> +``` + +The debugger displays the current Noir code location, and it is now waiting for us to drive it. + +Let's first take a look at the available commands. For that we'll use the `help` command. + +``` +> help +Available commands: + + opcodes display ACIR opcodes + into step into to the next opcode + next step until a new source location is reached + out step until a new source location is reached + and the current stack frame is finished + break LOCATION:OpcodeLocation add a breakpoint at an opcode location + over step until a new source location is reached + without diving into function calls + restart restart the debugging session + delete LOCATION:OpcodeLocation delete breakpoint at an opcode location + witness show witness map + witness index:u32 display a single witness from the witness map + witness index:u32 value:String update a witness with the given value + memset index:usize value:String update a memory cell with the given + value + continue continue execution until the end of the + program + vars show variable values available at this point + in execution + stacktrace display the current stack trace + memory show memory (valid when executing unconstrained code) + step step to the next ACIR opcode + +Other commands: + + help Show this help message + quit Quit repl + +``` + +Some commands operate only for unconstrained functions, such as `memory` and `memset`. If you try to use them while execution is paused at an ACIR opcode, the debugger will simply inform you that you are not executing unconstrained code: + +``` +> memory +Unconstrained VM memory not available +> +``` + +Before continuing, we can take a look at the initial witness map: + +``` +> witness +_0 = 1 +_1 = 2 +> +``` + +Cool, since `x==1`, `y==2`, and we want to check that `x != y`, our circuit should succeed. At this point we could intervene and use the witness setter command to change one of the witnesses. Let's set `y=3`, then back to 2, so we don't affect the expected result: + +``` +> witness +_0 = 1 +_1 = 2 +> witness 1 3 +_1 = 3 +> witness +_0 = 1 +_1 = 3 +> witness 1 2 +_1 = 2 +> witness +_0 = 1 +_1 = 2 +> +``` + +Now we can inspect the current state of local variables. For that we use the `vars` command. + +``` +> vars +> +``` + +We currently have no vars in context, since we are at the entry point of the program. Let's use `next` to execute until the next point in the program. + +``` +> vars +> next +At ~/noir-examples/recursion/circuits/main/src/main.nr:1:20 + 1 -> fn main(x : Field, y : pub Field) { + 2 assert(x != y); + 3 } +> vars +x:Field = 0x01 +``` + +As a result of stepping, the variable `x`, whose initial value comes from the witness map, is now in context and returned by `vars`. + +``` +> next + 1 fn main(x : Field, y : pub Field) { + 2 -> assert(x != y); + 3 } +> vars +y:Field = 0x02 +x:Field = 0x01 +``` + +Stepping again we can finally see both variables and their values. And now we can see that the next assertion should succeed. + +Let's continue to the end: + +``` +> continue +(Continuing execution...) +Finished execution +> q +[main] Circuit witness successfully solved +``` + +Upon quitting the debugger after a solved circuit, the resulting circuit witness gets saved, equivalent to what would happen if we had run the same circuit with `nargo execute`. + +We just went through the basics of debugging using Noir REPL debugger. For a comprehensive reference, check out [the reference page](../../reference/debugger/debugger_repl.md). diff --git a/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_vs_code.md b/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_vs_code.md new file mode 100644 index 00000000000..a5858c1a5eb --- /dev/null +++ b/noir/noir-repo/docs/docs/how_to/debugger/debugging_with_vs_code.md @@ -0,0 +1,68 @@ +--- +title: Using the VS Code Debugger +description: + Step by step guide on how to debug your Noir circuits with the VS Code Debugger configuration and features. +keywords: + [ + Nargo, + Noir CLI, + Noir Debugger, + VS Code, + IDE, + ] +sidebar_position: 0 +--- + +This guide will show you how to use VS Code with the vscode-noir extension to debug a Noir project. + +#### Pre-requisites + +- Nargo +- vscode-noir +- A Noir project with a `Nargo.toml`, `Prover.toml` and at least one Noir (`.nr`) containing an entry point function (typically `main`). + +## Running the debugger + +The easiest way to start debugging is to open the file you want to debug, and press `F5`. This will cause the debugger to launch, using your `Prover.toml` file as input. + +You should see something like this: + +![Debugger launched](@site/static/img/debugger/1-started.png) + +Let's inspect the state of the program. For that, we open VS Code's _Debug pane_. Look for this icon: + +![Debug pane icon](@site/static/img/debugger/2-icon.png) + +You will now see two categories of variables: Locals and Witness Map. + +![Debug pane expanded](@site/static/img/debugger/3-debug-pane.png) + +1. **Locals**: variables of your program. At this point in execution this section is empty, but as we step through the code it will get populated by `x`, `result`, `digest`, etc. + +2. **Witness map**: these are initially populated from your project's `Prover.toml` file. In this example, they will be used to populate `x` and `result` at the beginning of the `main` function. + +Most of the time you will probably be focusing mostly on locals, as they represent the high level state of your program. + +You might be interested in inspecting the witness map in case you are trying to solve a really low level issue in the compiler or runtime itself, so this concerns mostly advanced or niche users. + +Let's step through the program, by using the debugger buttons or their corresponding keyboard shortcuts. + +![Debugger buttons](@site/static/img/debugger/4-debugger-buttons.png) + +Now we can see in the variables pane that there's values for `digest`, `result` and `x`. + +![Inspecting locals](@site/static/img/debugger/5-assert.png) + +We can also inspect the values of variables by directly hovering on them on the code. + +![Hover locals](@site/static/img/debugger/6-hover.png) + +Let's set a break point at the `keccak256` function, so we can continue execution up to the point when it's first invoked without having to go one step at a time. + +We just need to click the to the right of the line number 18. Once the breakpoint appears, we can click the `continue` button or use its corresponding keyboard shortcut (`F5` by default). + +![Breakpoint](@site/static/img/debugger/7-break.png) + +Now we are debugging the `keccak256` function, notice the _Call Stack pane_ at the lower right. This lets us inspect the current call stack of our process. + +That covers most of the current debugger functionalities. Check out [the reference](../../reference/debugger/debugger_vscode.md) for more details on how to configure the debugger. \ No newline at end of file diff --git a/noir/noir-repo/docs/docs/how_to/merkle-proof.mdx b/noir/noir-repo/docs/docs/how_to/merkle-proof.mdx index 003c7019a93..16c425bed76 100644 --- a/noir/noir-repo/docs/docs/how_to/merkle-proof.mdx +++ b/noir/noir-repo/docs/docs/how_to/merkle-proof.mdx @@ -5,6 +5,7 @@ description: merkle tree with a specified root, at a given index. keywords: [merkle proof, merkle membership proof, Noir, rust, hash function, Pedersen, sha256, merkle tree] +sidebar_position: 4 --- Let's walk through an example of a merkle membership proof in Noir that proves that a given leaf is diff --git a/noir/noir-repo/docs/docs/noir/concepts/functions.md b/noir/noir-repo/docs/docs/noir/concepts/functions.md index 2c9bc33fdfc..f656cdfd97a 100644 --- a/noir/noir-repo/docs/docs/noir/concepts/functions.md +++ b/noir/noir-repo/docs/docs/noir/concepts/functions.md @@ -62,7 +62,7 @@ fn main(x : [Field]) // can't compile, has variable size fn main(....// i think you got it by now ``` -Keep in mind [tests](../../getting_started/tooling/testing.md) don't differentiate between `main` and any other function. The following snippet passes tests, but won't compile or prove: +Keep in mind [tests](../../tooling/testing.md) don't differentiate between `main` and any other function. The following snippet passes tests, but won't compile or prove: ```rust fn main(x : [Field]) { @@ -190,7 +190,7 @@ Supported attributes include: - **deprecated**: mark the function as _deprecated_. Calling the function will generate a warning: `warning: use of deprecated function` - **field**: Used to enable conditional compilation of code depending on the field size. See below for more details - **oracle**: mark the function as _oracle_; meaning it is an external unconstrained function, implemented in noir_js. See [Unconstrained](./unconstrained.md) and [NoirJS](../../reference/NoirJS/noir_js/index.md) for more details. -- **test**: mark the function as unit tests. See [Tests](../../getting_started/tooling/testing.md) for more details +- **test**: mark the function as unit tests. See [Tests](../../tooling/testing.md) for more details ### Field Attribute diff --git a/noir/noir-repo/docs/docs/noir/concepts/oracles.md b/noir/noir-repo/docs/docs/noir/concepts/oracles.md index 2e6a6818d48..aa380b5f7b8 100644 --- a/noir/noir-repo/docs/docs/noir/concepts/oracles.md +++ b/noir/noir-repo/docs/docs/noir/concepts/oracles.md @@ -11,6 +11,12 @@ keywords: sidebar_position: 6 --- +:::note + +This is an experimental feature that is not fully documented. If you notice any outdated information or potential improvements to this page, pull request contributions are very welcome: https://github.com/noir-lang/noir + +::: + Noir has support for Oracles via RPC calls. This means Noir will make an RPC call and use the return value for proof generation. Since Oracles are not resolved by Noir, they are [`unconstrained` functions](./unconstrained.md) @@ -21,3 +27,5 @@ You can declare an Oracle through the `#[oracle()]` flag. Example: #[oracle(get_number_sequence)] unconstrained fn get_number_sequence(_size: Field) -> [Field] {} ``` + +The timeout for when using an external RPC oracle resolver can be set with the `NARGO_FOREIGN_CALL_TIMEOUT` environment variable. This timeout is in units of milliseconds. diff --git a/noir/noir-repo/docs/docs/getting_started/tooling/_category_.json b/noir/noir-repo/docs/docs/reference/debugger/_category_.json similarity index 53% rename from noir/noir-repo/docs/docs/getting_started/tooling/_category_.json rename to noir/noir-repo/docs/docs/reference/debugger/_category_.json index 55804c03a71..27869205ad3 100644 --- a/noir/noir-repo/docs/docs/getting_started/tooling/_category_.json +++ b/noir/noir-repo/docs/docs/reference/debugger/_category_.json @@ -1,6 +1,6 @@ { - "position": 2, - "label": "Tooling", + "label": "Debugger", + "position": 1, "collapsible": true, "collapsed": true } diff --git a/noir/noir-repo/docs/docs/reference/debugger/debugger_known_limitations.md b/noir/noir-repo/docs/docs/reference/debugger/debugger_known_limitations.md new file mode 100644 index 00000000000..936d416ac4b --- /dev/null +++ b/noir/noir-repo/docs/docs/reference/debugger/debugger_known_limitations.md @@ -0,0 +1,59 @@ +--- +title: Known limitations +description: + An overview of known limitations of the current version of the Noir debugger +keywords: + [ + Nargo, + Noir Debugger, + VS Code, + ] +sidebar_position: 2 +--- + +# Debugger Known Limitations + +There are currently some limits to what the debugger can observe. + +## Mutable references + +The debugger is currently blind to any state mutated via a mutable reference. For example, in: + +``` +let mut x = 1; +let y = &mut x; +*y = 2; +``` + +The update on `x` will not be observed by the debugger. That means, when running `vars` from the debugger REPL, or inspecting the _local variables_ pane in the VS Code debugger, `x` will appear with value 1 despite having executed `*y = 2;`. + +## Variables of type function or mutable references are opaque + +When inspecting variables, any variable of type `Function` or `MutableReference` will render its value as `<>` or `<>`. + +## Debugger instrumentation affects resulting ACIR + +In order to make the state of local variables observable, the debugger compiles Noir circuits interleaving foreign calls that track any mutations to them. While this works (except in the cases described above) and doesn't introduce any behavior changes, it does as a side effect produce bigger bytecode. In particular, when running the command `opcodes` on the REPL debugger, you will notice Unconstrained VM blocks that look like this: + +``` +... +5 BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [], q_c: 2 }), Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(2))], q_c: 0 })] + | outputs=[] + 5.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 5.1 | Mov { destination: RegisterIndex(3), source: RegisterIndex(1) } + 5.2 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 5.3 | Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 5.4 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 5.5 | Mov { destination: RegisterIndex(3), source: RegisterIndex(3) } + 5.6 | Call { location: 8 } + 5.7 | Stop + 5.8 | ForeignCall { function: "__debug_var_assign", destinations: [], inputs: [RegisterIndex(RegisterIndex(2)), RegisterIndex(RegisterIndex(3))] } +... +``` + +If you are interested in debugging/inspecting compiled ACIR without these synthetic changes, you can invoke the REPL debugger with the `--skip-instrumentation` flag or launch the VS Code debugger with the `skipConfiguration` property set to true in its launch configuration. You can find more details about those in the [Debugger REPL reference](debugger_repl.md) and the [VS Code Debugger reference](debugger_vscode.md). + +:::note +Skipping debugger instrumentation means you won't be able to inspect values of local variables. +::: + diff --git a/noir/noir-repo/docs/docs/reference/debugger/debugger_repl.md b/noir/noir-repo/docs/docs/reference/debugger/debugger_repl.md new file mode 100644 index 00000000000..46e2011304e --- /dev/null +++ b/noir/noir-repo/docs/docs/reference/debugger/debugger_repl.md @@ -0,0 +1,360 @@ +--- +title: REPL Debugger +description: + Noir Debugger REPL options and commands. +keywords: + [ + Nargo, + Noir CLI, + Noir Debugger, + REPL, + ] +sidebar_position: 1 +--- + +## Running the REPL debugger + +`nargo debug [OPTIONS] [WITNESS_NAME]` + +Runs the Noir REPL debugger. If a `WITNESS_NAME` is provided the debugger writes the resulting execution witness to a `WITNESS_NAME` file. + +### Options + +| Option | Description | +| --------------------- | ------------------------------------------------------------ | +| `-p, --prover-name ` | The name of the toml file which contains the inputs for the prover [default: Prover]| +| `--package ` | The name of the package to debug | +| `--print-acir` | Display the ACIR for compiled circuit | +| `--deny-warnings` | Treat all warnings as errors | +| `--silence-warnings` | Suppress warnings | +| `-h, --help` | Print help | + +None of these options are required. + +:::note +Since the debugger starts by compiling the target package, all Noir compiler options are also available. Check out the [compiler reference](../nargo_commands.md#nargo-compile) to learn more about the compiler options. +::: + +## REPL commands + +Once the debugger is running, it accepts the following commands. + +#### `help` (h) + +Displays the menu of available commands. + +``` +> help +Available commands: + + opcodes display ACIR opcodes + into step into to the next opcode + next step until a new source location is reached + out step until a new source location is reached + and the current stack frame is finished + break LOCATION:OpcodeLocation add a breakpoint at an opcode location + over step until a new source location is reached + without diving into function calls + restart restart the debugging session + delete LOCATION:OpcodeLocation delete breakpoint at an opcode location + witness show witness map + witness index:u32 display a single witness from the witness map + witness index:u32 value:String update a witness with the given value + memset index:usize value:String update a memory cell with the given + value + continue continue execution until the end of the + program + vars show variable values available at this point + in execution + stacktrace display the current stack trace + memory show memory (valid when executing unconstrained code) value + step step to the next ACIR opcode + +Other commands: + + help Show this help message + quit Quit repl + +``` + +### Stepping through programs + +#### `next` (n) + +Step until the next Noir source code location. While other commands, such as [`into`](#into-i) and [`step`](#step-s), allow for finer grained control of the program's execution at the opcode level, `next` is source code centric. For example: + +``` +3 ... +4 fn main(x: u32) { +5 assert(entry_point(x) == 2); +6 swap_entry_point(x, x + 1); +7 -> assert(deep_entry_point(x) == 4); +8 multiple_values_entry_point(x); +9 } +``` + + +Using `next` here would cause the debugger to jump to the definition of `deep_entry_point` (if available). + +If you want to step over `deep_entry_point` and go straight to line 8, use [the `over` command](#over) instead. + +#### `over` + +Step until the next source code location, without diving into function calls. For example: + +``` +3 ... +4 fn main(x: u32) { +5 assert(entry_point(x) == 2); +6 swap_entry_point(x, x + 1); +7 -> assert(deep_entry_point(x) == 4); +8 multiple_values_entry_point(x); +9 } +``` + + +Using `over` here would cause the debugger to execute until line 8 (`multiple_values_entry_point(x);`). + +If you want to step into `deep_entry_point` instead, use [the `next` command](#next-n). + +#### `out` + +Step until the end of the current function call. For example: + +``` + 3 ... + 4 fn main(x: u32) { + 5 assert(entry_point(x) == 2); + 6 swap_entry_point(x, x + 1); + 7 -> assert(deep_entry_point(x) == 4); + 8 multiple_values_entry_point(x); + 9 } + 10 + 11 unconstrained fn returns_multiple_values(x: u32) -> (u32, u32, u32, u32) { + 12 ... + ... + 55 + 56 unconstrained fn deep_entry_point(x: u32) -> u32 { + 57 -> level_1(x + 1) + 58 } + +``` + +Running `out` here will resume execution until line 8. + +#### `step` (s) + +Skips to the next ACIR code. A compiled Noir program is a sequence of ACIR opcodes. However, an unconstrained VM opcode denotes the start of an unconstrained code block, to be executed by the unconstrained VM. For example (redacted for brevity): + +``` +0 BLACKBOX::RANGE [(_0, num_bits: 32)] [ ] +1 -> BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(0))], q_c: 0 })] outputs=[Simple(Witness(1))] + 1.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 1.1 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 1.2 | Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 1.3 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 1.4 | Call { location: 7 } + ... + 1.43 | Return +2 EXPR [ (1, _1) -2 ] +``` + +The `->` here shows the debugger paused at an ACIR opcode: `BRILLIG`, at index 1, which denotes an unconstrained code block is about to start. + +Using the `step` command at this point would result in the debugger stopping at ACIR opcode 2, `EXPR`, skipping unconstrained computation steps. + +Use [the `into` command](#into-i) instead if you want to follow unconstrained computation step by step. + +#### `into` (i) + +Steps into the next opcode. A compiled Noir program is a sequence of ACIR opcodes. However, a BRILLIG opcode denotes the start of an unconstrained code block, to be executed by the unconstrained VM. For example (redacted for brevity): + +``` +0 BLACKBOX::RANGE [(_0, num_bits: 32)] [ ] +1 -> BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(0))], q_c: 0 })] outputs=[Simple(Witness(1))] + 1.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 1.1 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 1.2 | Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 1.3 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 1.4 | Call { location: 7 } + ... + 1.43 | Return +2 EXPR [ (1, _1) -2 ] +``` + +The `->` here shows the debugger paused at an ACIR opcode: `BRILLIG`, at index 1, which denotes an unconstrained code block is about to start. + +Using the `into` command at this point would result in the debugger stopping at opcode 1.0, `Mov ...`, allowing the debugger user to follow unconstrained computation step by step. + +Use [the `step` command](#step-s) instead if you want to skip to the next ACIR code directly. + +#### `continue` (c) + +Continues execution until the next breakpoint, or the end of the program. + +#### `restart` (res) + +Interrupts execution, and restarts a new debugging session from scratch. + +#### `opcodes` (o) + +Display the program's ACIR opcode sequence. For example: + +``` +0 BLACKBOX::RANGE [(_0, num_bits: 32)] [ ] +1 -> BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(0))], q_c: 0 })] outputs=[Simple(Witness(1))] + 1.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 1.1 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 1.2 | Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 1.3 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 1.4 | Call { location: 7 } + ... + 1.43 | Return +2 EXPR [ (1, _1) -2 ] +``` + +### Breakpoints + +#### `break [Opcode]` (or shorthand `b [Opcode]`) + +Sets a breakpoint on the specified opcode index. To get a list of the program opcode numbers, see [the `opcode` command](#opcodes-o). For example: + +``` +0 BLACKBOX::RANGE [(_0, num_bits: 32)] [ ] +1 -> BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(0))], q_c: 0 })] outputs=[Simple(Witness(1))] + 1.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 1.1 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 1.2 | Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 1.3 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 1.4 | Call { location: 7 } + ... + 1.43 | Return +2 EXPR [ (1, _1) -2 ] +``` + +In this example, issuing a `break 1.2` command adds break on opcode 1.2, as denoted by the `*` character: + +``` +0 BLACKBOX::RANGE [(_0, num_bits: 32)] [ ] +1 -> BRILLIG inputs=[Single(Expression { mul_terms: [], linear_combinations: [(1, Witness(0))], q_c: 0 })] outputs=[Simple(Witness(1))] + 1.0 | Mov { destination: RegisterIndex(2), source: RegisterIndex(0) } + 1.1 | Const { destination: RegisterIndex(0), value: Value { inner: 0 } } + 1.2 | * Const { destination: RegisterIndex(1), value: Value { inner: 0 } } + 1.3 | Mov { destination: RegisterIndex(2), source: RegisterIndex(2) } + 1.4 | Call { location: 7 } + ... + 1.43 | Return +2 EXPR [ (1, _1) -2 ] +``` + +Running [the `continue` command](#continue-c) at this point would cause the debugger to execute the program until opcode 1.2. + +#### `delete [Opcode]` (or shorthand `d [Opcode]`) + +Deletes a breakpoint at an opcode location. Usage is analogous to [the `break` command](#). + +### Variable inspection + +#### vars + +Show variable values available at this point in execution. + +:::note +The ability to inspect variable values from the debugger depends on compilation to be run in a special debug instrumentation mode. This instrumentation weaves variable tracing code with the original source code. + +So variable value inspection comes at the expense of making the resulting ACIR bytecode bigger and harder to understand and optimize. + +If you find this compromise unacceptable, you can run the debugger with the flag `--skip-debug-instrumentation`. This will compile your circuit without any additional debug information, so the resulting ACIR bytecode will be identical to the one produced by standard Noir compilation. However, if you opt for this, the `vars` command will not be available while debugging. +::: + + +### Stacktrace + +#### `stacktrace` + +Displays the current stack trace. + + +### Witness map + +#### `witness` (w) + +Show witness map. For example: + +``` +_0 = 0 +_1 = 2 +_2 = 1 +``` + +#### `witness [Witness Index]` + +Display a single witness from the witness map. For example: + +``` +> witness 1 +_1 = 2 +``` + +#### `witness [Witness Index] [New value]` + +Overwrite the given index with a new value. For example: + +``` +> witness 1 3 +_1 = 3 +``` + + +### Unconstrained VM memory + +#### `memory` + +Show unconstrained VM memory state. For example: + +``` +> memory +At opcode 1.13: Store { destination_pointer: RegisterIndex(0), source: RegisterIndex(3) } +... +> registers +0 = 0 +1 = 10 +2 = 0 +3 = 1 +4 = 1 +5 = 2³² +6 = 1 +> into +At opcode 1.14: Const { destination: RegisterIndex(5), value: Value { inner: 1 } } +... +> memory +0 = 1 +> +``` + +In the example above: we start with clean memory, then step through a `Store` opcode which stores the value of register 3 (1) into the memory address stored in register 0 (0). Thus now `memory` shows memory address 0 contains value 1. + +:::note +This command is only functional while the debugger is executing unconstrained code. +::: + +#### `memset [Memory address] [New value]` + +Update a memory cell with the given value. For example: + +``` +> memory +0 = 1 +> memset 0 2 +> memory +0 = 2 +> memset 1 4 +> memory +0 = 2 +1 = 4 +> +``` + +:::note +This command is only functional while the debugger is executing unconstrained code. +::: \ No newline at end of file diff --git a/noir/noir-repo/docs/docs/reference/debugger/debugger_vscode.md b/noir/noir-repo/docs/docs/reference/debugger/debugger_vscode.md new file mode 100644 index 00000000000..c027332b3b0 --- /dev/null +++ b/noir/noir-repo/docs/docs/reference/debugger/debugger_vscode.md @@ -0,0 +1,82 @@ +--- +title: VS Code Debugger +description: + VS Code Debugger configuration and features. +keywords: + [ + Nargo, + Noir CLI, + Noir Debugger, + VS Code, + IDE, + ] +sidebar_position: 0 +--- + +# VS Code Noir Debugger Reference + +The Noir debugger enabled by the vscode-noir extension ships with default settings such that the most common scenario should run without any additional configuration steps. + +These defaults can nevertheless be overridden by defining a launch configuration file. This page provides a reference for the properties you can override via a launch configuration file, as well as documenting the Nargo `dap` command, which is a dependency of the VS Code Noir debugger. + + +## Creating and editing launch configuration files + +To create a launch configuration file from VS Code, open the _debug pane_, and click on _create a launch.json file_. + +![Creating a launch configuration file](@site/static/img/debugger/ref1-create-launch.png) + +A `launch.json` file will be created, populated with basic defaults. + +### Noir Debugger launch.json properties + +#### projectFolder + +_String, optional._ + +Absolute path to the Nargo project to debug. By default, it is dynamically determined by looking for the nearest `Nargo.toml` file to the active file at the moment of launching the debugger. + +#### proverName + +_String, optional._ + +Name of the prover input to use. Defaults to `Prover`, which looks for a file named `Prover.toml` at the `projectFolder`. + +#### generateAcir + +_Boolean, optional._ + +If true, generate ACIR opcodes instead of unconstrained opcodes which will be closer to release binaries but less convenient for debugging. Defaults to `false`. + +#### skipInstrumentation + +_Boolean, optional._ + +Skips variables debugging instrumentation of code, making debugging less convenient but the resulting binary smaller and closer to production. Defaults to `false`. + +:::note +Skipping instrumentation causes the debugger to be unable to inspect local variables. +::: + +## `nargo dap [OPTIONS]` + +When run without any option flags, it starts the Nargo Debug Adapter Protocol server, which acts as the debugging backend for the VS Code Noir Debugger. + +All option flags are related to preflight checks. The Debug Adapter Protocol specifies how errors are to be informed from a running DAP server, but it doesn't specify mechanisms to communicate server initialization errors between the DAP server and its client IDE. + +Thus `nargo dap` ships with a _preflight check_ mode. If flag `--preflight-check` and the rest of the `--preflight-*` flags are provided, Nargo will run the same initialization routine except it will not start the DAP server. + +`vscode-noir` will then run `nargo dap` in preflight check mode first before a debugging session starts. If the preflight check ends in error, vscode-noir will present stderr and stdout output from this process through its own Output pane in VS Code. This makes it possible for users to diagnose what pieces of configuration might be wrong or missing in case of initialization errors. + +If the preflight check succeeds, `vscode-noir` proceeds to start the DAP server normally but running `nargo dap` without any additional flags. + +### Options + +| Option | Description | +| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | +| `--preflight-check` | If present, dap runs in preflight check mode. | +| `--preflight-project-folder ` | Absolute path to the project to debug for preflight check. | +| `--preflight-prover-name ` | Name of prover file to use for preflight check | +| `--preflight-generate-acir` | Optional. If present, compile in ACIR mode while running preflight check. | +| `--preflight-skip-instrumentation` | Optional. If present, compile without introducing debug instrumentation while running preflight check. | +| `-h, --help` | Print help. | diff --git a/noir/noir-repo/docs/docs/tooling/debugger.md b/noir/noir-repo/docs/docs/tooling/debugger.md new file mode 100644 index 00000000000..184c436068f --- /dev/null +++ b/noir/noir-repo/docs/docs/tooling/debugger.md @@ -0,0 +1,27 @@ +--- +title: Debugger +description: Learn about the Noir Debugger, in its REPL or VS Code versions. +keywords: [Nargo, VSCode, Visual Studio Code, REPL, Debugger] +sidebar_position: 2 +--- + +# Noir Debugger + +There are currently two ways of debugging Noir programs: + +1. From VS Code, via the [vscode-noir](https://github.com/noir-lang/vscode-noir) extension. You can install it via the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=noir-lang.vscode-noir). +2. Via the REPL debugger, which ships with Nargo. + +In order to use either version of the debugger, you will need to install recent enough versions of Noir, [Nargo](../getting_started/installation) and vscode-noir: + +- Noir 0.xx +- Nargo 0.xx +- vscode-noir 0.xx + +:::info +At the moment, the debugger supports debugging binary projects, but not contracts. +::: + +We cover the VS Code Noir debugger more in depth in [its VS Code debugger how-to guide](../how_to/debugger/debugging_with_vs_code.md) and [the reference](../reference/debugger/debugger_vscode.md). + +The REPL debugger is discussed at length in [the REPL debugger how-to guide](../how_to/debugger/debugging_with_the_repl.md) and [the reference](../reference/debugger/debugger_repl.md). diff --git a/noir/noir-repo/docs/docs/getting_started/tooling/language_server.md b/noir/noir-repo/docs/docs/tooling/language_server.md similarity index 100% rename from noir/noir-repo/docs/docs/getting_started/tooling/language_server.md rename to noir/noir-repo/docs/docs/tooling/language_server.md diff --git a/noir/noir-repo/docs/docs/getting_started/tooling/testing.md b/noir/noir-repo/docs/docs/tooling/testing.md similarity index 100% rename from noir/noir-repo/docs/docs/getting_started/tooling/testing.md rename to noir/noir-repo/docs/docs/tooling/testing.md diff --git a/noir/noir-repo/docs/sidebars.js b/noir/noir-repo/docs/sidebars.js index f1e79ba9ebc..cf7e852fed5 100644 --- a/noir/noir-repo/docs/sidebars.js +++ b/noir/noir-repo/docs/sidebars.js @@ -65,6 +65,11 @@ export default { label: 'Reference', items: [{ type: 'autogenerated', dirName: 'reference' }], }, + { + type: 'category', + label: 'Tooling', + items: [{ type: 'autogenerated', dirName: 'tooling' }], + }, { type: 'html', value: '
', diff --git a/noir/noir-repo/docs/static/img/debugger/1-started.png b/noir/noir-repo/docs/static/img/debugger/1-started.png new file mode 100644 index 0000000000000000000000000000000000000000..6f764d4e60125cdbc08d2a7fd06de694324ba10f GIT binary patch literal 786947 zcmaHR1z1#D_dei^!hnQ?AV`;VNOwrb&>-C+-3<<)2$IrL14t=IcMC{&*U%j!-S8j0 z*ZY0<-rx71=Naa3&e{8%z4lt~dRK&im82hno`8^$kRHm)NU9@BQp%#n~}LgEr0sH;s8yc=lPq{yHlPaRAqPeoD{f0cnc z+#)4|67)!12D_Lskcurc@4e9r=@)n;v6QA_k|hsO2#S@W#Kedmpl6zRKGp_U!o1*x zRdD`opY5j0ow8G%Q?p$pQB5=Sw^qfJNSi1n^t}Tg2yls|TOT5$=8;FDuvt2n289g{ zlE0bky>j>V$J&?Lsa!QH@b|wpR1E3qSwcd3OPSK#xAd9H=Lr!NNrnst(rb}SVy4IF zbTvdm)Py_3FJ+&l)v_qf8pAE_$^O z@^|r|xseghYSeVeNxXfr=fh?`Uf36V;qK|TG}aMQ);o&d!fpSV$LL^jm^>Ovln}dM<;(pWtkY$9+qs(G9v)4qv^VU;oQzWO#0l%W zoZGn14j+d$n0cd(h@0QkKNm?#i+jqV%P1w>IaQHS%Bf)dAgG@W^}*(whmxWgugD1p zAzVhGo_tGP;)z7x^>9R<=_r_z^Mpy8qVZ}vTUCx%o**f}CN>8aZRbaYg4FlRrteb+ zpA(?YCXNN*BJ+l))TquCScIL?7a&6`(x`CEm95p>(eAzPEJDK1yZ6)xNdZDr42)>T z_dp@TMiLhVya&o7KcJ?X`q1oD{HWj_5Q=JpEFcP;e1I8{wE)O_pt!(Pjr#2kF%*3k zhy}sJ2uLu(tABut4Ok@Skc5m<=y#%)zOkX;U%@;V6$2CEp|?xOMj?F^Wz2X8#!&}p zh(3V6-gvx$;eu0p-&Nu?!|xTL*FE0=6*jb-@6*NXf>=4N7`)gKZxWhi9cWV?thXjF zI#q*&F?qf}UL^jhuMKJn>Hs6r1gpN-%wSS+!NbK52$i78l*}8;6IUnt0@C>KTFez{ zm-RUhXH@z*fuh*RVEiksauNPVePWiGT3H{4@HetHq+A3pxNFITLT^GTOv~8_2p?mh z;|9upXX?N+>ShaOf0)>lSeGc)>&-;)HI%D`-}t(uWD;)&WW(-;Rf#zhy88pusKbFb zg})zV{T+HsiKB@gvfbl7-aV9W4|v{RzDa1^Ub5Y9JmalLY9cj!C-P1t65b-xp^S}( zCIxsbjtY_Qq>07G#CeHYg&G)ymicHXXhSNDJO_IMrzfPMt*1@8t;)&C>B6bs34Qg< z$$GVWRjFG)Zad*pMwK=xCh>DSHJTOYCTf11OZri~0xfZjP?w__yC-MOC!dh3pewO7 zN_(1tkL%q<(M7TLvG8dBY*8?qsu4YtMyDFR8gI6Pys>07^i@Hpx*6j)%>s47tjVvu zIg%=+Dj*d(Ee1{g92Z3^8KPX9f}N~hjeafRJRe!lHvyT1;6yx3^LwkrYWX3l zh~}8aY$A0M_-yu!(rgT@{CZF-9m*GUcS<(WJ|t}mYOz(lwkx9P`e>YFt7AH4pZyx& ztOE9>Yimrf)zk5?vVS}AbZokXzwaXISc2F*87cXgo0;3*rq7nIGOp5nr_-&`&3fn4 zuEC7%hB;YAGe>tCzql*(B-#9;}01a?w%TUKk;#RIWms9l;gj{U zelmR${Wg|k7XO-;wK=t<&QCwtbENa!4qhSi`0`ZFAoJu4^a;Uyo9ad-1_F0gR`*9o znq#&-ClC2r!=k_Q_Is?F@6sH+{`thRmQ9OYw?PHw2YU-k748;}7RDD=_Br;A@v-)i zz9zZSJgc}cy}EZ@b#Yo+u0x{9W&OPQnURL5H~BL*!D7mvR#Bc&^m#Odn3$+Af~!}M zA(WPY9Bl0Gpecd_-cjo3oJSLHC*NkEGd>nZFGJHM8plyWGbHe1y7CRul9X+0l^Kzd zHPek1A6?4Z%G-Yh-xz*n)mxva!OmmCWpZB9=U82xSKaDp`oV`_SNnPOq_JbmlDE7< z{0dV|rMjur^ssXeUVKSHYG_BBbO+go+g?m#t&)yM+GusSQhW;iO8xTR=-dU|6W4z* zt_mr;$TKOD$T`VR$3IWmiPno3{BC)`cvhr#rFN1Xmiz8AsqA$;L8@j#gmR>^2o;#% zGiaLAg~N%X_ASA8l#J&iG|tj%dGufxUi9vlAIF$-D8q*oL-JQ1$of}$yP2N^ud4JY zuhOrgI@zs#TDR-=O(r`a>(@ycj16cMRLLU5&WP`Hfv?o&<88Ti>6!C={xV zsAh4Uv)?Y9NciSoMd2kO-{^KTeFY)A^2>V`#fpu8Walzh4VONOydo3enX;X(*tDjo z`so$zs-iQrZlbh*oNnXCaJxCP*4CFw6G7u$WmJV)IXkmea{MY^)yiPAxpKiae8y@9 zy{c)Z#HOQyb(h>*Y6@(g<-DWFD0D|&37UEW3`zv3!hh3J{T_f*JzPx&%1^CeK{!~+MIhB z`|i6`9($Ez`Li0?X_A>)U)lu)-4E9Ctwowmq37z#jWgIh ztx0rogxc!Nw92z5?3J_H!0Smo&bRRA858&kpFaLpt1sl;w>q7)eYCB}Lt_6N=2AWN zGr86NVQNHbcvXrWmph+(h06e3cz$`vdB5^>m(g9@-ELOjq3Y6LrJ)hl-Y_g|H$Qk? zepy6jCX(n;eS)*5vS`}gVXj=BrhaXA;+;CG;`MF5?sjeDXD-$Q-g~UKofpf8MmL-X zWu@!217Cw}g8MNqG2I)qk4%1M|6Fa8X-Sv!-}5uS*g7&y^PeLLCwl6`>~+1XxUYL$ zB@LTuvL;4<>U|)5eck4<_}~~zT4Y$n%_sEc$j9W|a(4ZI)xz*)<9$EhBj)QF9tz#I zwAVmz=NsJU#>GAyq|Oo~a4ix!%cs5ET#QdQSZpsAMD|?z4!YVwH|Q|NlZ;bRu=KAX6j^a zZs+{U-sL^Ms6OHZnuCmvGZGR3&D|GSR+aiEV*W`hb!``IMFoCSds`M`GkX(r77ts8 zyLpfVJ@^raw&pIzoova*OtnBT`@8&f&v3GS5qNKcg&|jZF-qYN}>OW7i zbN+K#hy}9VU14QsVPpMkZp2W*yR-aYD-UxU9Z4%&gv=1n5a!_EW)J@rzKiyAQws@rVA8U&QhK-Kn65CyGc&qDZomV(K2q zJE;$h%rqKq{nbXQcq+}xnCqB2DFdM7nUoC5z%+Vt`uEomJRp;@k7`>)z;Q^PKiCrr zN6Vy#YKwNO#+NpnrWH<=TiqVkx$n)^aK`MIameQQVA||8u5w{ZN(?$33l=%Qy}9k+LKWPNcjbDUQFW*>Ia9$Nqaq4vSuTBEC}DPoJJ-f2)+* z+ImfcjUl6`7!K$g!^5xZ52^`$mj1dsw2F9`H$Co~r)i1D0nEOl(9v>PpQn@yvyBK#oL{Z3V~O~mUrYFFUie(y znBT(M;OSR4ee+~j*X{G^SJ!=4frp$!SMQ8&e2i{h@J%`^w({MY4UA0rPw+KW;d9*5 zbe;3;#&Fulo?k}J8RCd64_w;AAgUg>$NFUbaFOX?5qSFbp|ro<#+4X_h<~C#@uzbh zeJm$G|B=)28w~e#e@_1!y5aHposuyQiy$@gIruHi?{;vWY6p(9E;MBA_0;Zi`kk8c z8k{U*x1nO-vg0)UI%1k6W!_ZhcIl4=X*G!)9jXOh67{dMHu+=p!O80VeQx*9Ti01d z{LjvN;ACsL8C-_n;f7Z??Qp}LreTr3`~0`~AKE{E{o3<#V0&XDs=uFQs>#3U++Ead z_jQczj9a3=0L`P2q?!ikSX$+#55eZx!xPK$>l8oun!}zC1AQ@_KUWs9%b}>sE8{9Nh&e$wzbr4_oYtxs}LsL%Hf?ko{k`zcAy*MNed;6z*T=Rb-iq4mRBCU zAT{mIKso5Y^r5SyqdyK;*{j0E{gm)UtKC$+XR^&?@mL*ePR8Zn&*17Hx>~Uf)kS z7tkkj*&8Y3Kmi9L+y}q$oNiZ6_p>{*V0@eT%cvlt+G=nHkt#N0?tyb0APt zBmRGC0%8$?V&o*4UHctPauI?~@ia^x3lNd6AK^1$RRK}1iHX}uvq??zhMX=-qoqMq z^n)X^ZS=TdiR9x{bSWOO`w9-_^+&@T=Mzl^Z2Mb};{L8^|D_TbLXe}bh9xu*HZI1s z%rNC2I%!mmilL{zz`|yM4l38OyKp#;cBA;e=KzNTuKdzdoVxd&df5-das$>^_B+z! zL`7c!kpo*j$cl6JIM(4Q$I=3@128n^Jp-)_wbx3YJ)eqH7zvI4^>$3Dv!yPVQ})2` zUH`AQ`?Z-kDE($>)=KcS2hSr@n@$Cle1)C)Wd{pm1%BHRLmI*oxqMyxAOCdYt#L?v zsiiRY+1z=#^aarFKUmKzl8Dl!*oJCC>e%cCDgAn(}jp&#|D%6%?fURrbPZ<8b~ON(w`$TgQ7(b9e|aa zVQw$2$qy{UwpTK?*G5^owElYYWYOk7HI9lt`h)l|? z-fuDH`Jgb+gN-3i^&p}bWsC%!soy;31l_uh4mR0mCH|K}OURSsfx44nE+5M)cB69B z{f6Fy#4Use>~B^-!4ZNkbK`aIpTS+GU4 z{l~L-`fv!VJ%>l;ywh2Y6rY?7lMnq?Cv`T6B&8hySW-@!!%8`Qx>sxB^+~NQ-1*Qv zmyi9gMg0?wAsKYon87Q%_97Z-o@+!1U`qg?Q1qbcszaT9YTY)RKt5K& zj+E|$qbRYe@pPeHo;z%Qn(7*iko|nQ;+u|Y25av>1HZ-pX0vY&!~($`R5eBg$zjn=;6GftrJJyekL6v`I6Lr z$^{PWN2BIrAP4=qFbD%V_J3MJx7LxuqRzV=hmI_ zKOjU6YUuk3`13AN4IHo-#L*aj*;Ujw3-8ctN)L}(LzliIXO~9 z?3Co&bm<^PjC9LYB0qr9rT0s>)9{gP09QZcdg zPT8P8@IxILVj~7|HK;P_ulUG<6Jyn+5 ziOyPY0|0WxCj=G zU%8O}4@=7yYZkDbs525RRQ&A8Cd0Z8Th4$!m%?ZKQ$1T1n+fpp@VCZiOK4q9+jaBv z^AJc^cDWNjpb?4N@jrP5p%O}#bR?T~$Xu!Sso(zPy&rf@Ts#{EB9!!m{X-eH|ECoo zqaMjMyUo|3)v2sH2a#@_R^CCO;a90T`<1g-bkXg~s#Qhs!5|u z)kY}l@Q8wqrtkv|!_2@VCndi>mIsai9NBlhdQLkxC*;(br-emoli+)aDJMwE+OcQE z`FDGVe4z$wX)$K?eY$xUz8xMM5S4VO#tO6(1uv8?VE$WOAb!|+MMW_oxEDi-m66xs6$QP6jKiJt2HOIb_Ja^EFYc+p^yjSB>Q2gk+L@>< zE^4p@hf|x(RH9Q=G`_QMaFSoX1Kh{Ny?f-gpRdQ@pfZ24pEC+(a^pNOF zj<+vM1oQV+$eWZTx;p7I{g8FdW;2)s+X3p;T&IYkBO@bk?@ucWFzd!frLh_-#knYR zu=4O{o7gwAI`!)|kdXQJvkFXOYvDVG^+posf5owaZ}=CU`sGSTq%Gf&46ALpE_=}2 z2LOE|UmKdBF>rw&%1#)hyX!c!I2k&e!W zEdo9FLE#738;_CUr^C$%H{@$4gbKRgB55$=4zBLZoOkt974h=bPSZ2vo<6}*e{ZyA zojqeiO5=eRW+T^`WFOX3a=66dDK1VMsoZ&1VnJ1AJZ=Ss&n}k%h^@KLR-)~KCPtA zFE6N+FIKg%?wjxC?94Txg0S(9q!kwG-Q#E(cz5e|ACWHJC}3Xo&gd!&{(=>=N2tMp9Om8BJ9AqsjPR|O6L@!sPf^bJhWUD1_~Lp`kT=(ClPOhGrLq9k4ayiPs;G8R_(1g1P%d z_gYi_1IA#pb3JLI0d|q3VHt z5NH1)P20q*&ubzjxMn}n5bnRctY|(iAtGb8)}LyeRO5YWFjbOOII8$V7&Z18WXFmh z{-d||=zsu^NqdmNdF{Dn_?QHi5XBadMhJj{%(tGxlP#@tO3Y)I@D}~CWjmIeq(1;i zmyCPn?_{d16qDxJ#hTv4MJ+J>#j-Wqi>CTWNTp`ydtOj4EzIQYoVTyjVPxRJMiYu= z94cs5akGNI;Ta+s$ID4epjn^C>Pl#Q9NQ$gsW8i*W#~DPb3dAFevqo8fBX9R(c^^6)pHuZsm30h$Cw9|vg@E66=SY5L>CKJ-$@2-Q%g&MP zZeq}Ac({DwIgEJfQB1u1kqmDzwgiryHv{#6Pqx9MDH%@GgnrW;=)!oPu%``taMIl; zrZYiz*1hxy2<)cO2i&nmqgODZmykR6y#>foOg8gm*w~BcTxw^e$zf?n{U;cL9|0@| zQs_P;2-^aHu1lu^EV{dV!h(3QZP>jtuXPRio_R{#ff)alX1rHqjkVC!SvovqM=7 zdY(=iJ#`CX4p*CnbJE?$cSs!UOoZi;3v_jOEAoGCj(Hx^@VaGXObW$1%y~9ZT zcQOGO0qx}J+}z#|)2h9UCf#DF##*mc|Le1i;Iya+O!&78xkE5E7g=r#iT8{v=XJ$A zM%PCTKDRE*XohrDd}N>XLma;A<0&{y;ufP*%MUNs_lKHmUk#1BC_|Dl6PEd~iJAF2So?)L!blzofAS zuj?<}c_8(V^i1A!lrqcyIGP>;IdZV6AYR_OO)75XdKiL)T4gEv|1F&V1s5+Up>*Bh zWFk^0dqU*8ReMaTh3fYZA&ydWU6y+0~`^F1-KN~oyx(6QclpSDY$356DqSqDO>EUElP* znIaQ>*J=NyXzv2vc+qQ@x?}{2yXNruJ7Iz!XZ-}T;ayqX`&R@4c0;63n@HSeRo2W< z(hGFTRBBz;=@5BELNk=9x(-GiFq@Z4%yTX-GxoVs^Mp1NSl?o8zTj=L)2)w{ zmA*Rrflt}NVl4q>)-ckNbOhPyYXIcO-FZdIx( zbY@BfEV$VX9i6pr8re?od(s*Df7?P{42y9t8};he06Uz&RXJY)stl2}Cd?D|KV#_B z0z*v#5TJu|U0JstiCl9oEk&e;Y~0-zbk$UJ+=;V1H!x_o>Z(@Rnae5$$=py>|0#k6 zT*)DeCo5`20~wsl78cy-E2_W(p5;odoLLLBrROMau%}6rUdzNBk;egi<$uC75@eW~&7xN(Nyxhv!Bx%1zC6sfqSh3HE}>Q@8>fELD1|m}n(`TZ zpr8jU1D?P<#P#eNIVeq~%p-4GBq$AU{A6yf&YG3>t8|~F70uUk&v-XKZX*6Tf1O?J z`=toK=2T#g!}%q*^sXl#2t>jT;dE*U0UhAreg1%!a={?0&NlWQ5u zsHeL6&oO1`m3gHyAOiy}c>nF`p|*3pAA&v?Z`xCM?h*fJm&R$GJ*+doX*Yl~f4wb| zGN@_w35@@Tv5x~@>gx99Cy41Zcm?iEl{FPy2JHW}e)7i*2E?9UyaK24>8 zTajpaD!jMp8QATo= zqwnJ8y*Y35jtK5*1c{RnC-tw&Mv>WEyE7z;aOyv8$Fxxa~@$y@&F z=BY`mzCeWOwyik$Bs)>1__(h`ym0ZTd!_rn%#X_y2<#@0 ztjzy(kl~+kDjT`Le2l_{#<$$>mj86yFaE`}??EnlGWGbf?Y4vKLv#KBMDkPOym5#C zAs)zUN;bzOULqd5SgxXSa0U6zEc+s{8>nv6s5}fWJe=?q|k}F z>|~4;pnxM}#gCNhbPm(LoS8DCwuB_s}wLfv4Ci-H%CUsiv`F5bDKuXhIAvt3&n7yMf zvS)67V^bQ9$GQd$GySGa>Va^wC_ZIG$C=}5ja7 zMmb)$M$L)^REktb%}TF@4H(l^2!2BVvsc*-nHEoX+UmVS(&2*>QqSYK)HK?(Teno3 zEBOd4Zsl)_-gkb@=nN+O@-E#7o&rdPy^69LiHJHm!PKdBaW!|3hy6|>f;9kgR)O{R z8fU6^>(7?9SMqZS_*7^d-)i`^-i52@tE^4ThiiSkMa|f&;_7UY(BNXC2?+=YbS2Bm zSgRC;jo4FO?B~FLbK}P-MSjOVJe&lJ}li|8rgbsFvNDJksvxmCX9;HQVCax-F+xC8y}`y`#X6o zT7i8waC`N6|Gq=xnEv(C++4bkS`%~%gp8aP3Ka)iA@Dl4-M+7S!bv~EiJ8kRxOy@q zQl0i{5)#4^%fOoFM>T_j*_~f1E2R*Hr*s{72jt%FL5Ijq;ozQm9C{+IHte*Kvux=S zHzPBks`1!ls_sEM%pN7OVj3qiOB=BYBpChhzoQkT42RRG%# zYSdU(WcTHYkq7Xu$)rtG5Q&n6?^6Xa$O#P|Ud`4Lf?T+beroI6nMaquKG0b%G}`VT zo+CHZVl4g1qo0{uFCZqwl$Qq`1iyzuQ`!NTxve1}nB!{&nDe{KvX?@5S1XOsSx2?V z=UluMlM{UcKB^&UX!Q*{*ZI=`pyJ5V!Mma=`M!&OifytMJO`Ig@afvWw6alE+Z ztjL@1R}q}8UkK55?K9t z;a3gj>dB*(su;OxUIAA-mWEspR^J|Q+i#DjI>9`(x_^Z0UNSi^g`lr|t80A5aIwKC zNr_W)G(6BFa(ixLI3-8PJR$+Hjl~iZlMTa^`g?$Xw;;KwW@|(5F!QmGG}WJ3TNYbB zhtfnfES7x)0*k!HY@A;Ymlq8AoGs>lE-UN7Ey~@f-`3CdS~@Zw$$5HkbtvIKylR9F zN{MLPo2;Ha*nF=*7;|k$B1r8t5_!K;Y~IR}?OPEa1B<)w+#I;Tw*Gkd6LJXoT3=X? z*0<0#+i&{^%(v%rU>z^o&K)zu%z$uRpW#nyL*hd0VVuOBIJjo2c=_C7kVjyZ7Hi=- ziW|Z4k+e(AR1$5&>WvNx;q3xazBSy`{w!BSV~v!|K+E&D(R8jJWY~D*^n@^;s9&ic zb#6#j#3x%j?m!e_*|TXf6&06V9pP<82^&y3b!Tt1L?T zw=PNo(FuBE3~w(4h9?u#*ERGfE}9>Fd*;brfdH#{ej{uw;I*%J=Rf)ppyH@OeJq_m zbM~4t37b;L00fgl3a7*-WP|J|F2^y^YZpVus-d?1nJ0r1$}-Z@mC%J0XIN~U`|^+7 zQisK*g0q$gLI#AHn3}1H+g+)vEBQBgqxgE=eygXU_V;vJAbvBl&Ge(eORIX1YH#hf z(pQ-8II~fC|Cv->oSw9OW`NIy-fkKiiPRW9y~BlY>;ziJi`A7P!ZEd%9!FVCVqvcxYcOnyKQ>EWwEApX%};KC1|O!X>Wx zO^+^8@SsR|+wU-0`Qx2?^uDCd0UeLA;}rxjO=^Q@(Mkd9XD` zT+nyfu)1qspEld%bKZK*93R(&2LzT`Dkn7E9JBO{d+&LIg->hj&8Oyc+hUYqbZR*Y zxAaB=S-HM?00aj`5=MSkP+@ZkN+NY!8a>S$|t|pm;9`@<@9|0 zaZiro%!Q7`xtTN=ENuEVJ5I8B&S&=sBnDB;oCX5@IHNB!P9;}EKV+_r60YwS7iBZh z|9sh{#*TI*t^OvlS)No3lF(r!G^QNdGvl|1k9V~jDm7Jw$b!-yE++$W&4J zPro!Kj*$Efl|KE~E8Pu$C4{`wlj7;y6%SBBAmSb!DR8mb=7>dMKFel?=sK-yBNi6$ zElxJx-?aN_ zk=$c^a{A8mC)j8ZG1{o>q@C-;eg$Q16uKFDp1#W|yN;RTyEI0L*q*fC80()IP;p#zLLQr|7%B5l@@eXCPcB5aX<}W34TqacyB~; zP$!9RMi{@CiM2#a_eT+N(&oBP)ZWg_r*ZC?*9q-2Y8-mwo21go@#nU}Dx8D&tudcpY`9T^fi{Ae&?$s!6+~MM`{rj#2)<_vO3Acm2 z2I2Fo!i*GKi*?$ZM`%Yhcf#^+!@*lwQ{9;yKXvO-NvKVa-hbbD&yq;R?j*9tghwCj zdxwB{M@wMTUp9I``36ePs$drId$D1th+XwB{tbb_0XLi@k38tBYm^-fFQ>VjT7dA< zgILP1F3V*=V5K|Cu_{b0 z>eD?mhE4MOmp7gHID8gT>MwI8KYQA!|A-9L%?+y9#p--Fhpbb>MbBD<-c#B~I&nAvWKAoKuwDplxZq7BQ6dR9ZEGlY5s(oc8nmvi%tzdL) zEK~%Kz<-bgXdzDdB>I(dq>H<2SI(U6LC{q5E!LrZ7e!T8L(4O%tDzC9gEiCI)zR}g z4qK;&(eZJaYFg?>qvqc4PbLnBswHcwhNs4uldD`hMdHUhO<5;8mmXGLw-;v=@o(v7 za$HQ>5gFT%IJU{4O-#rP{zShYU~)wG=)(`{C!5h}{VaUduIW4eHJT@lgz*u_5~hZR zl`;4K7QEmoi8egSb4Q^=I1w3)t53S>#iQ>*l^FF0kMfbl#6mCt7V1O@`K)p*1U{qZ zbu-Xw^i!0~QR?<1s}0Kvw4cTK=zVLp_7n|U=8g`{D23#DT=`}gR_;FeRI{(1W$tv? zKVm`}NjAW`-_w0u%&_+JywCH6eZwJiRM}y^%heyF=fgaYT>hhnzuf-D*ASgwZa)Cw z_CpD!_y_0(f-`7$Pf-Bz$n%z9K z@R+c!TbZMC>D-s*k+oH8IJ*K(zDFHRt3Ka4tTFKEYiKhac7>{?>3V_vnu?W3^|S>N z*SaQSYR!&hQ#lql*i|P+sr{Bo4VHdja*a&pRz9J!^;;9R*x44GWD$4_k84n#kV`(7 z{(BQscVzQwf+6*U!R1iw;(Ihz`cOB79sFGS&|`Le(f7jIl$TK)%$9OwRp*6fW>4NB zA!gP1Fpz?N(5g;3g)A;I+21RjD86vN=Pt!u+h<`{B=^0|5iN;>f?~Vs%xvIhYtuar zgLRJNK1zk@GRJZ+>E`Te!m&RlRw&RJHp47!IK7&GnVxPHTbUhLr@3rZoQ{PGDlpHa z<~l9YoT%Da&`b5%D{Ej&=#3*yWlBm*3thVZ%TB(8B6jG@6FdGtYwUTT|3dHkEq_Dr z9!>C1*giX-y|{vfqCHMN+RO#Aykb;JKsonD^21AEq0JvQp*%5hXc|v8KAV?IkAE|y zyDg)lZ<^!c#T{EupQd=+n4xA-5y1mP4Uredm>!7o4THxMT6OEuU*rS+jVUjo%s#$ml zvw+XRwIOizH1c7;p1sDK>=+Gsqodix-t$wtBp;_Xl4-Mg0{8P3Rxd_S zDXly@Qpe-@6(}MyAPAp3<}jl3N1aqu13^-vZrL7pGu#qfq~jt22g@9qpI`^)^o7Qg z3hR{sbeQ?-GX!J%VTlN+)XNg;YtGf(Eha)(Az!^{&whT+>rG_uu^H##oRwu%OFr%k z$ImwGO{v-&Q=Sx9-j!8yPJb_DK6g>!v|hR7&EQeBukbUPbJ|>K8;4TNRJ8X*Zec|6 zl7V?JM6CjmJPA9v)BqThhVi@^W322^CbeR!%|$s@VB74)Od6fG2|}UJRWN#@!RQ)7 zZs(~iW1^uOmQe|7A>2LOzWq`E-bS}Zwo*i$)%&M9H0p1KIC@VMME@@E;4P~Ur8(Ul zK@h9!qG9kr6r~Vd?KxuB&h!jYh%9_8A`71caN+18c46s#nDzkI*1}6wC7&2~9Y$yA z|M7h1Y;P}7m&P54LyssD&e=zFJr*H~en(>IwKKaMGvF^kt=#mP(`yW;(M3nH-&-0E z-^jWJb&eTw9;R*GB#ui+j!Qka@Td|w=+xzNe zJ9{s6ZnmE&>*WiP)3f!6kMl=IC~Vyq6U%SNn?w{;M4<|32-O>bwA%cxcOx_o5jG0q zEo4Be5?e|qDq#OOrXw+=gE}T%6D`T z=D9f-->@(`mg7RW|%yvb7c&!Fg6S;7WML4F&x;9hYL?qf8a^1 z4aI))GSjJzZyS*9 zjY0K`%Gr79r`v%qiX#~QR;GfqQ2rc>Y*cPMYwuAVqoS3`AUsM|P=Rot4a+lz7wM*(ZqzuF{6(DO`s)VGPJ+nz7+FTbaz7mF`jq+< z8e)2$MhNJ9z2SG%6OTwqii%c5)2V^cedQsvZ_rpcm%zgII>eeWZ*zgK_c_lOBq&DW zTk4yv)p@TZD!b&^Dm>;Z?_>49mdtANlDl-q5QFH<$URiK)2%Uo6O_A_R#8U;y`;yK zetlQr{?#?*@{4aW{he=Sdu-hpfk5R0$Hx^1Uk&FNI-a`63X^izA9REGZm+&(H(U=I zA7WbG?~s5n(mNDBlf?oel&JfKbBFBi`{>GSi}n$n2V?mP)|(?fLug8Kgm6^!0zi)j zBqxc;>98s1bZ4H`y>OCQWcDSA`=nO=SA7<~GN~=;=TC;-fB;M5n>T1Z_ufp^+E1-1 z)lQo{Fb#1N=h;b)DxI60^n~jB?SrdkZ;Vb*zQom}8`7rFv2enss2^rY5wYI;k>)}i z38(6KUBGG6E)LH!1vOXd8je!6H`% z=feps%Bu(}FV1epQzHpvZK@YXwBzuaapRRy0D$eEW%aQ;6W(y@F0Z+-we2MKy14iE zrf#ykr-{1}33NBI;v))jz(Nj7rLvi+l{rMmiE--L$23I8-pXCZh17h`ezsblfJH9_ zUt|*J9zLGW(M9pB%L_@`@BtDvPOV9rgE0Z|gC?xUmMqT2I(TI_hW=lr33^AeR4y>R zss}>gUkgLS7ks1H<_Qi$4l@rN50&AmP#?Rd83O&pLo?KO%^Nsq=S4l42jejf#9L$N zoyS#gS3=hNBz@lohZKc$Z`+@+ShR;HF2xCKneD<`-=4w>Xh^OXS&|OZ_6qpZ&U^xQ zyh@JRMebOeSwp?#uOy!6(4Fc$kz@EPRFOo*tCc0i0(#JI?Bf6UgA|YKB4J8iOf z{HL0)Tb7+xM)PJ}7XA3PG-8;B0=y_>_~m3O(!U5=#jyVfRaG0KW+z4V*#b7dM|W9n z)GS_!+jY7wlIkw)yO*q2WFH~dL-WAwK!sWJ+VMCIy30uHY)w`2%xa`o&{8*-hud)V zO8`dC=$mNyL}5GqQYG#ypU*BfPZE7|@c-U;12#iR&^v%TwLa9!dHv!}hgR-%sHnbF zRkH}jwo-{vE(QSJqml7M#S<5`G_4m~cb;AFWE(;SA&Rd?eIwbltFt%;_1&!L*P5OD z=CJU>2mzts)v0+m*~0zVC}rN$?qVigwe#d=Z_|u=KQHIVlxnCu@{c=5q+!V1zj@d& zrGmM?EJe5CZx6?5I3ch*heus)wH&p_z?|aUuN<{pyN{~Oy^*IbBxUYez9cU;SEuX^ zik6EuqYxF^(q=^YMH^9u(bx2OCPhwP93R{}=;6l?Uut(omZn?8UlZ~})hTf@UUzcnRvpol`w=>I$7f|OGIY{5#S;+b>N z=(cMEJi}|fBmBi4`wT-dXx+~c=94@0eY~4uL4m$TNE~cbmiHVBxQ9C9&R=m>Hh+KB zy9xA3cD;9W%Yzir7Vh7~co}pE^YX8lqQ8AV#b#KzxKx(qG$)ODTk5kYK;gMiG}a?K zA4%quFRkQl3;&MZmu2u2=KLbOV8&)3(prz^zJ3DlVp$CkDY){|ylcSPyrXQ*Ij_tf z({*`y*dz#TWS$_p)^W8*5a=6)j8~aPabiQ7TlJNBqZyeFv`cnAwYIfF})WBhXI)L4Igw z)Wfi6P3P8ivo3H{MF!sIhA!ZoCfBghF&^!J2R#fUMzb${D`zIU$L=rFx12;RxR4XU zf2tRMTERNY9{D+QHX&5HxJQdC@%Iov36Ta7iGef{f{65xQgU>c z(jXnu3{V6Ck#0tJNJy80bVy1gA>GpT-l#l}`uP1FuYY(bZ1=9~?D(AL5cQ(h<7v1i zUF}Van-yf4*}DbrdOe;m2ugZuvph&<@TJz$*!XkaEFR%)wIT_iBrOp-0=JM{g3MExvZ}$?baY&3oc!&<+E2J45*#@cSQr#5RHkoBx}Sot>T2Gyn@J zbc>V~a5Q_E;3i6kk;AnRH(Ok{7*aWMOniKlVXEK6(=B4|4q>7m>f3X8r10SjZ?RLA z?8NRHzHtH4+RCE#JC=rHTQb3~zntwE!}9B%>Mo-mlyHnW9e+gM^wZ&^4wdO(e&~18 z=rZqhh{31=rHKYf7)<(smpwZAjrHE7bRQ{hZYq4)mm|Kka|<0nRY=OJSS_)|K|T1E zqlpLre;*tk>sACRJewAeAwZOYkbnZ{Bs{S<0vFAo;PW~)Phjo(Rf7S?yvveJ!a{n- z*~7r!jS^*H&h*a=S`{LY_48L#cPDe2Xz1wo^~_#ZTR6O;exO$zt#w`0o~f24J=*NO zl;P4@<*rG7gy5y(-mozyOP+Le2kp+7wgM+AIVa}7 zHPobl{{iR=i9$x!`)MPVk3>~UeYH&;dIld#R^A4_t5pY~X*F@UZJ~nj0_|GUpO5PA zIEoYMUw{64d^(M1Y>{yL?0CLF;j!2B;6&ZXd5OJ^fA2WS0!(m_kYwd$C~W~k40d$$0tZqW5;=H)b_77nR}6w3vX1qhoW0+ zg)@XadJjsKmOJ&98h!X&jZP;>Wq1mdvB;NVP14d6Y@MYnY8mU|SK9~o=f;>&-?_tC zNRMyga26#z6n<*=yMdJ52Ygk@r%!l6hR> zjy@c_Xt-`|Bs5r7rGLEf>}dWq3u;<{0VO^0@f{@Odkf>dkX{;a_vB)H2^;Z%t92&n z5|H({MFI&B7rR?CFw zZ_FDbH+Tmo?pdyS%O=!XIx6oC6sQ$TOjPOXUIp!CkB*yN>;mx6E9>AlEi&m=)m{2_ zCX0SA7}4mpe+huWt?oZa71m`#TbK>t zQdQu}%IvT+(r#gskfT{lNYdG&|# zYbIJKpDn#c!niysa4KV}`$=P2IDb`=N8GO|d(3?a_j5|JE+WN|7 zDkBwCRjDA>wc-Bt>jx(O?j)e3v50D4G{c>uNdKWnUqHtFGb1}s)Pb#oF)u!6r-xpi zYy=h}D#=Pn=&O<6k-59#JR0{c+u2(`h7TFTfj~ooOzrR|KqFK8d!TXjTc80Z$H16T z_D@rU7douUqYvGUVV-s7tF^!>n-`UogruZnhQ-K&c>MY#L4y4??401KuyL^ z2W8bw_%q5Zhf^x>KRSzAYGe={+T+)C6{^qZfgzG*H-#Eh6_PjD&f1>><%bUzkF@Bb z&SnhfxCd%Y6h=GGeX!zFcy0wro$H6rsky}S^^^Y5B}2VSw^oKJOa)n685 z_YjnpRVp^@6dNuw5MOf2v{olk-q?)oKeOsFq*>3G29?oV#Mh@x3& z%}{t1aX6Q}e8mAOC$Ji(PQIhew#v-kYa{kLAbL_zPe>(JXYhpKc8-m*lc*qt}Mkh;eA`!K$zr!S%OQ_L407uowuzTtxMqYNT&a_J+` ztL!25+Rv-KnwlnXFzW`)ZHO=#PE?mY%BU1wqq%#xzdchGDFIl2rw z#`|ku3lBVpIW2ZWV=Wd+XTcD`xV~EjW>4RUu<3X7bsjp~sPyXd+fRz9`!2>xuMH}d zHOEfee-9eJWZ90c_!3FesqAdaUMJ!_8y&tp7n*bB9n`AXz-2BBKj1o|Fxp_K!v2X) zugEAG=SY#}>b(Z`&$afoBM!qAxt)jZPoCVRI#Vx~6gc!oI9-ae9T12<9AUu2d`?Zy zL9O^rSLl;+c;L<33Y=Z+4-*x)bn^%E7|d3R$S=G5iB{_Oy?jBVU1I~Lu!%ZxR z3H%}kcDN#KGeK+M1r$V_ZP2mW0H>U-Vem}hB>;^~k2VcewOQ)%n^~ek#?}j-ZDuZf zbh?I{!m3)+z$#ct2la5PbmqrTRdC+#vXEQ9?tAr>%E4T94(dHR_wsuZ+*&tI7Bj}b zS|xtaIM_bB+E(VSoItliQR{dxXB>wY`L)kQA1IG5xQ#z6HVppAV$(twUv*M6GmJDp zQF*wV%QpGi*W=o@SvA<^T4W~j!?D!kme*>IFt0#hvDte^^Yf zvi=F#<-`TLw9+ZkIu~79q4O^7jOK4$+Dv6^NGP3bu*-UlbWAMW9=gS^P?ruB3_k!T z%|VV4@lX{48BE$X{M3d)Lr=f|{@cqqe#au8rKQmA9>aShF~NhZU5zPjK&7LERat^P zk(s{dG3`Ay>XA>Bbs7~)wUv6h87f*H6DZt!%-8VlW#bbPPzT^fkSULj#Lf8Cr*hLS z2Xcg(j;HhIxEXTZvdL6%KN@nV*qp!}iTC>O?G;vANni6rH{q1VWJ4nL<=4v?1|iSI zZg?}_Tg)>SC>^S#=4T)V5FE|dHy#ZoISg+^))Z|S-6o)8jzo~x?b3B!C3Lt9Xs49Hr1LRs`Qa@ctEi1OZLlYG;5nS|irPq*-jT;sVn ze1-X+S%8&Q1xly1Oybs5Y!r#+TU%QR=EITvCH-|N-O?+asYUnED?UORuu3Em^ zs3Z2taZ@-Ov2$UE=+=JG-S5^;-2L_fKQSl|4&jO^u-m+}mqhKHAFZV{j0M2^5d|v{ z8kc=ni&VeDI@XoUj&`u56%&k(vD^z4&{@{1PG?`fp{`5(jA8 zi>0scH|)ZL3!>`Z7HNt=iVaKJDtFpx2(qu&ZNiZaJTJ8ifZ@1?6S#!ji8d8z1gDVwuWXFe09=i0^TD%_0TX*Q;W%{UJxD~zJ@a|s4 z(_#06Nv+GV=mP84;vumPUZ^{dl$E5Y_97D;Xvj&BC zfd$;P6RUns=F%rdzu0=3qQJADUx< z-g;Hi*0ZBa1``aFnEq`LB5$A9onGm^e|S+2Km4x7g}rK8cAt#&&rZD$u9K(6S-Q^n z*>rMJyfZzUzHS*_weGGPtln0q4xp`yCAztzyu7a1P8}znxn|5o>jEg9tufnzRIYe? zkCnIEc{L=AjL({R1#TbhlC`ucFyaC_&k5+fM9VXJpfTM=Zd0sL-4BLrFX3;cMZD~Y z3pwIvw6T_x|$OI}0CotgUF9_3?;Y}@HeWQu)>9G~4EslLk!G&SwL*Ly16dNI8cEDCiCJ+^M1 z^H_2(b)jzosey3M3r;>|)pOoO&O0xTuVM;yH4qR;MYGE#xNZsLT;H2K%hYt5>vY>) zFw?0LV=14~QcjT954Sj8iQd-l9HGH`$45|p)L>uW)(SwIH`>!h=8`LB(i|GmjFzjY zZ_8fV)pj&8>5rb~l1$DzHI18zhwZH_yLBTj+YI?@ZGB+2m{)*clvhk^`Ob!Le2^C` zY8@#oxLOh+R$pRRFu?NwEl=~Q!dt}GJ6E#u>rEBbrDM2H>z3<<4i1FJZH~MHmD^x- zQUXW89nXwX?go&Uln}J;&RFNTiCcV8ol||1gJE99Z1It$&Y_Le(%$$?K8+^Xu+nM6BA}FZ1L}@miQ^Re`!xY#R}dmsb%P z4<@S%h{tT^8u?RC&Y{^dkfm+vXx zSf~wC~XZ>M|^Nm3aHFwRKJKXw*?%m}(Ka-ZWb?9C#F$uTdMDsVF&$EeGZ7+diqwaMGOUJf z;jr!Uzb%xuI1)~|eUF^LANL%EF}LE)zSGEHs37@yS6;Uf^Ic|xHcW=tSYRhcSD_TX znAeSlp4&y-jqYws;b+&L{#?Ug^d!*6*v%SzqiNxm{YA;+hx%2Z11qWI065~P!II)m zHm%JRtSa+rYoxY%Le-_WmuZ6;XnX3gb(~G2b2ZAG>g}t;DXSp*nXs4{y~W3mX`y*m1U-WW*bn`XHem zz-W!d8osiV6Md8!mZ+xbyRSpB{40hjy9^yQv zghLN`sVPZ;<*~F=ck6zw_$7ZFx{GwH`8uGfPRLiiN zBi8QNFr~(X7w8%Gz2KoLyf@D@I}7CbYKX9etoIRHSnZ$w{37|zaGBflF&SL^6p9i55C zpgABzL0Y2DQNrm_T(IbB>}=HOZiGi$P>}1poLI`JixRB8OF=H~ACB+xZ3CK9t#F%S#Rd3YU(H&~;ZZeASZMsJN zuK`4x&rMgPH%;?Sw>yMKa1&akY`4y0t}V|^kf9uO=1=>h$8{y{y}+v22qa@S>H@ci zdYO{tK36MNnZ$?)G?W`6&cVXRGezofZN-{VQ{||vh3T9W3!Tny@?^9nYd0qjGT={) zQQ{lQa(L_9+Kd``%*swDT?__C)YlVdTARjnuSX^%SPWM^DtN4cvtCoyjw>EeW^T#l@k-Nm)BZe43e(b&=$smR>_sCcRan|D#r&BZ z41uJiK*9d7`WR7(fzUc6?A2$38gh)4XBoin7)r)|+P&-$m~`M~_0tDuV8~ib(;{t;REF?QnTI=pPeIX(}UAddOzQy1S8LLmSFh6BXxq(TiV z(Y6NX-WrSZ<)r0RjFqzYq!K!9D zB?`~vmaEIjk$hKD+B$ROz4hA7UCpK?zQb;bBw+bBke)=%+XAr%hU|myx>rVCH>GCq zQfZCz7n#`l9^0A(^6lCL-k!iA!L%(}%C+=s%Y0I$-|uB%5_4DL{Z1(!CIr~l8C#9+ zCz_1+N-VW1MH0(g5PGD8(O!GqEcHnZe^Q(hCGL;3<0ncFHjHCz68+c@gI1cvXxMcD zo}p>eY7e0C+YS1BYhDAQUK=}MP4#6w_Pl#6GY-B}G0-ri}+lH*RNp|Z^o`;IORWcR=JWHSG<`*0x>JyRKYc5X*c z?VZ!JdrL!H;%RzfB1;*fG*X1$PAsahKeqCX0R1T$^-*M*RY; z@EyUhgB!(d8-q(YMvG4yP|7o@*VssL*kd%en4yy^Kzw<{n&nOdu(vTnI`-YQ!mqtd z0Oh`Y1i#Am^Q<|TTzosDR`29cjq|yCsiIH%k*qL0xa+ygh4ml>*4tT$UYg+KY;LM3 z4$d^dA-F$V{$uBY2Y||1V7;?-5s3o(0saNoTfDx(Ay347SQB0iOx2ieyIVRP-P8g0 z5w%AOj!iyRJHRDS3_?Q3g%REBT=Jkg{sSYTo9zHrg37NLhKZQiQlRl(VB?N4`iH0}hl;6U>K! z(*ANncPG~{7xK7Rq2fj{421T4LR*;b-xT*Pl!*CreX}JABHw&B^n@; zy1_u`O-x;=c(GZhz7Qy&1PdPiR%1P%$FS=>eIxF!x9Xu!HuA*_ z9<@@_n(C9)NQt{7+hI@5&2ij3=wuV1%R`oLfQh1p(1e4Hks+2~U@FyMD4&08uuS{5 z%U;A9d4L+nJP9^LGK3tX7dvr}lD>shHQ|q`FGWTK0Kd^lzz};)&Y+@copSsI+asqx zA4|RNd{t&gELY#i%Ok*IwS4UyMa|3ml20tuVD-C8Q>mg1-qUXwbea8oo^HtI*T^(lm7;v z`j(0#*HGMDO9dbt)J!Y|XB9)YV+t~nnvLL*Ry%BnK;7nJQzr(_WnV+Qp7XUWyBG#C zcSU|0_FwM>jMd28|Dt3#QBT(%Szs_@U5d$ba+?w~+-I+i4K_7(P8cJ{$kkMX;N!if zOU-Crt}XT9dChQPJTa+&Rf$u3yk02t*=8@+YMdn001*9iuOFKu7U)n2-wr1T;3wa7 z_!lOK#6ugi>l@et`twii=PW&3Mo1qJwdQE_rAvnZvszE)w5p$_ZF*@}d$)fB?>q^L zX429cw>dpfX-yWD+%7UHpi33BWY|y*tKV8K?wgHFU{`)klt&IsBK$HaU z=^JP5p&vov0^r^z(7OS(%1c0RXM2{3v2b~9Er?_tGA9g{ywD@!`zVB{{r%uj!ir>+ zK;WA~tZMszWG336(o(%oeGhKEF>Wct##m)TSSFERdr`O3F z@fc~#&nNzXQK4h#yWYBNy>P(-tNYZBW1EDMioqUP4c%F&-SLhS;pa9BKwlBP@TvdD zeGkMQ)O*Tc(9!_FA>t4eB<_Wr{v#r=3fw3`k9T+P4YmVoKW2N9x@6fs%d=-C$;?|5MVE3 z1Tdwl36#`Ft3IWMks*Mo9zcULBRvI;$#lMU%zjBiuDrnazM%ERnSh19vOsLbz-~RQ zI$Y~k229-FJicNAMEot#U(kQag6aW z=oANeOGnldWvdAEP}!wQDB+k3?}(esR|i`|S~UjlTM7o{-@PPaiIUA?jGm+Hu8hNq zaVQ|2in7g%3>VB)64nJ`Sej2m2??3F*5r)n8qORb<(fB}A5pzgZrn-!bdy_3mW)g* z`7z-G1KdJBf?T!RNme!cZjWTsAF%?-D5F{K;eqV41xf6 zBQ^!)6W5z?OX3I95*Kdk`(upp*q~#SNXg1dOy-p{Hca8p2r#O>xZm98HWt)4Calnj;uw5~af=nm}Kd>gm zXN(V6-mswvKd{8(|K5g1EYZMU8iCT3q8vdv`aAE_=fB@PmjxJ5-w%J`SN~JLZTBB~N1tuSK7ws`-xfIRmlU$y&RWZ!X1nq5XF2*eWe+1q z+~7!W1Nu4oduufjE{DCvIIp1aMPQzAwb~1`>S34wU|YFrxa5Rx6LGyyD(||1ccDR< zmq3hYXje|~(4s_zn4a;YE>Imx$RiE<})g=gPi4~RSt7ODXteS_Vx zO|MiQiHjTU*d-+V;dtovKny}cpV2T}QJ!Q)cXNcg@#FwL*9R4=?}BXq%E||6WSW7$ zR1}*sP!P$(pDU8(qOiDXLIDbwfoiY?*R%?9$g)s+a>=f(&vo!co7XHxXYpMKCR;za zh-<@z>u6r0J78O2bgstQpqJ36HI!)hXvS@ z$O3(IK>hF+{Nj3z731|me^ehM@JE$qG-Z5)s&45x?tHwoeQ1}HtaMG=QN9a zcpn(!*$?yuB~Gfwu#un7{VoLSov+OJP0V3PJG21OVQSm?u0qU_8kd5V&!3ceKI)-^ zv%O%u=_f1Fr^8Nmpbe`78y7|^`z^^JZrfU}j0;5^s$lOybimj+S)3AQC*{D6@wR(K{S> zzi#(jG;V+)&7~)54i3GRPQK?8u+iM!dO%NXBb9sfjoNz6oIRizvi&=}TRr z?Ld50=&-|Fm-y|AOV{8pxXrj5M%VIR*1w8gQe74>8o@PT(F&}j-syhPG4?}*Ut&(FK_grA(QbU9_%^ARpee|Us%cBb+!Og&MFe~k`VzW; zFZ#_d`LkOxnm-k@9ZN4Sur+HVargqSmY!!XD1plJ{Fgue zf^Fg#vJ*5mKGN4O!F{NkN~`jEAB~>geG)aF7#M?xUHbPggyz*ShEQm!nM&m6&%`N# z!oIzLPjO4WjH!wPg9<`cP}k>~Ghur}Dpk942TspR0)Kvt)Ad4Zs-9Itvi-yx&|v#S z$CHlA3AYm7!78lL@8|eJi@c1+s7OzTj=uRZjZDy8{+{_~DxMsgtN)zy`=emS82!?w zPzDC3TujK}Q{Bes`4?aUpRfEWDi`;;xS3BbOi?kcKT}SWQHjxVXLGhy;iKdeGTq>W z1eOe$w482CGeIUaC=MpdkeE5gasX5P~qp8yLxosNH<1iWI;FCQg#Y|GWSJI%0qSewJoMbr`FTGQZUZ zshuJC|~yb)YP@p&ENUJEA62ByG<)|y&3b?d2SWyFc~NAk(4j;{wIKe&c42fJcV z4WSyG?OEtFK-Ai`R`vNKwJJ`yi{C|eioU&i&Rb|Mn4Mil(sW5+xPn8;AdinkdFW%) zPwDu1fiH|xE;veq0jyR1@*>^+5j#7-axA$AW*Liq4(3;yx@{`d7VV;5>^IhuA zEXJ_C&-rn>US5@vaj3vS(Uee5EXCsew)QviLn0g$vB-FCAMH_u1Yoi&yjbE-(fN&l zp7EaIFhm<1`5sM?^JF5}6U58f_M0?c$Td9`D4_wxFoVMzqXX~6L}#exMFG$5suOuD z(Z!jnVS|{L4JlSGqjc2dcjww~4JH^Zn^XRxMgKAywtz;A0_oDXzAqu+6LS}iN)U%m z2Nf1t7^8Le`uAo3{tIRSUbzfe@xHXOJd!w2SGha?*7A+~Pt8M_ppq&sBKMsTF`;Qf2LOvMu@Uu5bP=a*=w+FxQ>EiA% zs0yeS^=uS-e@|<2Z_(B^V14lOcgq3X%?Y<<6?&H2e1JvWbJDIZ$XfGN^>>4C@fdni zM5R5+!?rpm;4`b+;5Y_$4~!UkBt<%7u5Z)!Ag8YX^?m+Dp6ku7yF!pdbvKGoF27?_ zF3Xx};~%f}e*tsHoG!Br)%8l=3`9o$^}e%8NNssxYo5@iFFh!bPh#{4_mt~NqbAB=$UJp9OKJ3=85<<}-%D8xnWc?WwQm1R~kGUJw1?XSalfo=sThWBl#V2tEuP-C%JT)(>?; z27`e*9`!SsSAQcW?BP|wLDMrZwBq687l1I5*^BWrwL_Djsg`8%7tH%j=AnvUGe|~9I&X|>{Jit7&6tiA5VY}r5}m@_Qb!@=zsjoKge?( z69Oh6h_8Am3;6Y4KkTo1_P3Xy!OxZT+z8>~v%Y!ri4i@!%WJ7k686ID(w(fJzme(x z<7Y5A-0$)QP%`B*1{IZ3nGy_v!Puh*!F}|IOfv~0I%m3YZhCO0K^Zdfcb!#fljL9S zg{}QnQU8&5g7o^g_~HS585tC;9Trv=|Dhb(Ekv<|PV}59sUJhgv?lGHpb)^`wUth` z0M<^3=r#sG7eqA%4q#!0{%&C}sOax|2?f$LBVZf;hX|q(qgmN+Ht(H7N@k!8L zek9C*0dSH+6XadbFM*nbJUzXpts*PL{&T!v7yw-dfeB{EgNgpbsd|NaN0?9%2K`F~ zz$-8^3;DDx_APmPf@JyMogW{H23Q=hNX#z}yEyc}&+CA85jSXkE=e1!Ux1NNI4KwiqOlyK&3=Yrf0wK+7J#M`*Gy3U^J_lH z3JBvdzJh+dE#S(hm0oz!6F$N*(Wi&wLh#;%^$Rr-6@IsSU`c>hx{rDRWXRv_;E$i- zOaP?v**lqA`uBc6{zZ?8qJsjFA%x>RxkB*JM@ClH?zN}a`*O)RpsxL19e8$OZH*@B z|M~E{C?E_ku}8xHIe?W|y$THRCaGRdp6Zt33(ynpyvG<+t#B(bZ)||GP-Ea!;J}a< ze;(>rz90&Tph#%0CF}J+tv4(Q?K6bne%pN-8k*r2AUwTc0LFV6r+o4XibTTK@aRM@ z{qHybrh#B-;GRgiUY!42GY+@#D*a1oDclU(=*IigN^FSph>9cfWojxGPl+ewoNv&F z=hr|FG5kNT!FC5Xm90xERjKIcrDP4W~moKS>g($~v$pHC--noQC zP3p4z-J$%{53~?KR)xG$Z~RAJ3c;?Z1k{pJQgKX37zD4yBs>zQb@pZw(f@MuB6 z8yl=s3IFrPUw8l=gP_r)?eTW({ApX@8z2W1NRUXz{rJ{tt4vG?t{kxTh?)wB{$2u1 zn6kt*61jx1I=}kZI@{2n9Q>UL;s6t-?)PH+hY9)^0G}Ia(_47v*{vHhJ-u4!mDDn5 zdzt|w#L#@6Ip9#Aiy-(B$A3idAHxUrghgEi)cz}1RQsQf2#Eu>0gT1V07X6UoBV{V z+uv=h-A547Iav@;bl`o|4`YP>Yb5?<`Fl;^_-u6zn*VX-&!NFjVThDe5wT2N5aB~8 zk3WnK=prI<*6=a_>ikdn{+&Aihlp;F!3z~h@6gatu}d`JW@SE zI_=XxIrj@)E`h!<0YbJvp^=aIhaEz^$1B99-&cw2O8eo@sg&*`+T@YfK^U4?$Ns;y@f#Vbsnj=7Ab<)qm<&|BL?cwR zIxG>Prm^oC1>mc|VTJGj8G0Ce_aZs@E2DiX0BP29_padkQ=Bn`>RFJ`dv`>qM`{~4MkAk6QN zPHpV}yd=SkpN>by$R+|4^56wvs71dUYAt{ZR&^gVDgL88zc2)c^ju439{x9C4rb83 z4#$a&N(Ny>Jd%>C_NVN*fuYHb@lEbL*pM+I@A{sf!?XcuYRQ2%1B;~p_Xjlz1BaQm zPOOml^O6|y02k`{frO?@0(px6Ne|3e0=(9%nm-PxB=~y+)NlI2VjKA9y??obCv4*U z3{{lOzy9$1X@Ee!z|)JssL1Gr7sn$EH2RHiPtFSzEycidooG}4FPg)Usz6Ktziq*B z{g0xJClGc0YJM6eMfAhkB$3xomQC0Rh>4ERlX|cma1H3=UV{Hk6~IV+JlBHF&bi({ zc~4LMT?>*G_&5j_y5iB99!e}(RR$lnnVi>}3JCzwzir8M9f*wnH)X)*B7h9-h5q@P zChc>ghbQS~wZY-?R8&-fXZ@^SjZRT-MNf1dBxD+N;kB%1YQ zeEMsJ^8D8D>hpNW?gc1A1BM`Ce}JJF0Rmz8@9jO$5x<0R#Q`Wp0XM<>Uo1w}LnI<@ zQ@(wB=cChW3PA=FlV*%+?B~|+qoRx%bdv1!;zsVzqZ`yXt|vX<6{KTP1r!BiFt+$V zcO?b?I0hMf3Vs8F3JA+MzJP(q(rbDneu@MahV%r;M6YWl^FLi(un`IwpVjWLeX9G1 zCHWjfgDlOoTnP{I)lX}!p&9z~L2gCXGcsyb4zF&@YEw7}UE%S3TrWJHrd?x7KBOId z^Tv%ETWgJ$`kTr25GVC6rSsr}0FN(2^miiyg9boWE@Q+gzwl~lF%FNfZ;?e3$N-60 zK;2bMK$!{7BZlYT?sEzIJJmo$#$)B_n*FEd6-ZHU&({N}$Hi889r3ZZb5x$T4QwXa z!Rf*HQRHC4D7-Icj{pZU`6M4$7x$ZRBfN;t11L^*0_vPcBGc3l4Ct+%<7eu$!r?t- zzT1?*LKT2_$opdk`M7_)_2R$uBOv>bu8^Dp3ufuqfp;~*B_Epg*K37sRu-(EcxYZlJff)5_fx>4 z;32W%AY`JE`0#>L1eLIQbHpRi90!H#J&LFpAg5HeIScfE%BiT>xgP0(32x(yOI0sm zLU=e3{_T%KC~7ZY}l|6kCrq_qj*tcxVw>-6RFt0f2P! z?D_xJ0RZ%ipcXdQMp(r6y6v@gTKZb#Otb8)cps!U9msRK;Duckia^QwE<3?OkO*KU zp?lt;KxlCXuuDkd2|E^G2i|W?KmRWh23GuPVA7wN-k+l*-4@QoJl94??CpU~#z*Bc zFg4%b?>((qrUWd8q0V^q$xgxVlcE)VuX6Vv(>PjC+ zCk0a_YyI(wm#DaS*1DKi82y)E)ssZw&XTm+`!7DA8(6QT9_EvV;nT?+jOwcn^bJD} zzpbvk35Tw3$Q^v~^_U&vmb`o#)Y!y5J1yDuCWq(UMvG>l>%o<1_5+PalDx{P#{hBU z%b3i0Bw<3I$0S(5zuya*2yxzBq3!11(-lZ;8aM{N(`K%V*Ef4!LmXq)wL!pd-P6ke z2$PI}2)+kRM;^hWrBz~$RV8?|3;`g!n1xG-@d;j}Z*+&@M+ zEO>PF>!VjTaK!f{I*UD&HU|^3$tWz8+9r*YMIM--oNmg`kR^O4CWS6a2Y-Ye0(^}u zO2tgja)9&+XgbMPJ7l~D`2!3jYQALfQC)kZJaM zRK<#N!}Ua|GtmgT0>&hUEe`Wqo!+9032K!O&p@IGe2- zQD6VC#QxQ=44Kurys`wmliP*J$Yc`5A3++`a-1aKc%G@e01?XTvWN;Gp_ECfW5ZRk zPW(b=q+AZppF4Z;%~J<*>J)TX!rAvbiu67xFZO(qu?>|4+Ypq`hD0zz4xESIK5-1P zKgsJ!Yo}qioS@=t@2B*@Mpp-z_}6S6U}TdjQUu+1Y@*m(GxG|46>C*L=8;E-4#Q~K zsS0D?X$^2k@JxwYYgn*h~ADEiM5aUk$eT$g&b_X>z^YU?z~ ze)k%%2{23T{)6cIn~>MmZBAx)Hd0uYP4NvwIV%?JT04ZzoZp{hILEd2;iv?D>QL8fd`lr)nPb_Lk`wIeE10 zC11Ym%Iut;g-TJYO>!?+Pw5lKQupbhEC5GMi9u^&e5Ym7gRHb$9FZX5%r{xpDYZ!n za9Vyvb<&}OsFib*8KRRIiM{&=vJoT7ZeoYPl%ruQ^fXqXeX{KkNXN?T$+~>X^`=7 zxn71=AElbZs{PY6+el@xNjqe#S&CrkHQFA+{KY}BO6~EHdHasUvIhds&QKGNI>~r4 zr#=aBsjt7Tjjn+ix^YjAkrgEZvG+6;txJ zEC7cE#1o}Eg^cY-?)DaWoas3|?avVK##k%gW;7Yi&$3>0R{pkLd!kVr!>M!aWjkd^ z{WVF!TPx1?Oi!#z4yrfyDq6R`c(~i-DA_6RK%bFGAvv%XXtbnXl$=hka$|Y!)dHb1 zeU?U9b_}96?Co+%TtunaJL0{@DvL}DUd4BabZN6!Gg7anpLogvVO+3x(Yn^dm)2&p?+4Z`? z&sqs`yTKTU(;Ug>$>de#A19ES9^v|P;s_n#TM41?19FS1a6mP^YPPy()e+SWg@b) zri#cLO5YNFDY}ShP_fe0eKjXeub2!>Gwv7_m`$~<@oVI{eQj%1pwmA?@E7UznI0G| zvOcb*ySrEAQK_>%aZ)v#(yeVf8Na;K$WAz0^eR6xJy1RC2CtTftd-?Tqu-N|>LuCe z?W1{{4R}|y-`LUOM9`7*$3@JY`8AYB<7En`YFn?&Co4X=IY!t&9Zvo7T&>NPQMF`6 zCHicrjC^1##ePLPaQX!X3v@Jqk;M@4SZDUb7LL&9 zC|-a0@7^^fKp~EywT(kYD;DU4HxDm~uPqg~pb{+jR;%dPzI7__I^~`TrRbLuKdnQe zIivbN^p58#joe+;X!*8SOvCN;6nBwx920_aGVZk9Nk_xOGqNB9C=H<^8$6A%`#>+k z@vO?RPF^gC)cl0D*2ciU4bG-ogT}j{#i>))iTd0CPm?ubYe)a?U%MbMTpTNG+MaP~ zX@2??C0K*@&SH(`#23Dbg9ypM$7C=zyH) z+vV$CV~6`Y2Rkl;hde)qX2|$;m0NvV@Efz2t)a_SsPb3LRvf&qjY{Uqf~?W9b@y1=r`WAvS()9Enwio$+nnu{~Me&F)*xMttz;P5DGc+e5}-aEo^ z2aD0S+O!_~UfrJlFy_v5E^~Dn1pyKZ3zEcxPlB)U3lYDDQj|1sRTM}!KbP_qtd*HJ zWI`VZ!jYgVPp{971Zwk|>9nSPj_q(HIZ;j;AXmgH4Xi+}o(jpYE{YEzI|?IIoU*gH z>xCh&;FiI+S36}f&Jy`4#aF!n4B*zodDlskz0k3oR66&b0wGX*6#jo|I_J3wB?9J! zehy>Wz;&Y$nBY`Beigl~2z)E(mTPHzRY{0hftgu}?f!NR_9jAI~*?aZ@Bh8|wacv*2t9?NaNP!Uv<$FrlPR*O&3} z;W(dH_ps=D#C7_zUWc2&EYC_8=%POe*3e_FZmx z7De6d#l?)Gl|IPYNlD&RidAA;CEIBY-9SaLA!b{iK_O69i7Z}Dd@Y&$8{X>y3<>nGo9%}z1s#SEA;>Uf{Y${^f@_!UfX-DI%opn^02DOJ?Z3-I6WFC# z2!Pf}-6|bw6tz80&}XM+xw)SY#g?!{et}2V{Xd8H* z+e$M|I3^1TivP$b?6w%eV%_G4zk8Yal>}Vq%%!poa{Vrw#k|x`{Mp3obyt0TA3pBf z48M(oLx=i25Xmhwn^YU+v!5` zb@@z}0|flA{8dZrf{u?zGm?w%MoB)%5~-LDi4DAc<*-}M_L25ZhU@O!ecQg7zM4dy zg{ko~zWKL0Mq=~|>D9O$J%?U7jbE%Ffr}DH*eh>_ngyrjbS%p?)*g-1>bUcAOOjQ2 zeK0{48LeUkOvc`>+OI$xL=PT)hbM@iXs3Fci@+<>G3i|8XL!OI+dEMcXtWOzAO_jpOtM*zGJy_mMx*utDlGrw8 zTjn=@Z5r zQeGW?G7LQB~r3j6R-Xo2FjcCT2QYP`w3wTu)_1cEz&-VAf~yo%vs!zm)2?GA@q0WRmiPl?_+8#&;*$fH02b zlKN&G@RW zr3SvwjEz#2Ah~B}KzHAID{SG$^bWE?ml+6Y!?KmMyqoucJZgE+0$sUJ$TH(W6T3WD zR`#d0FC{5Oj}KlT6H;V))#S4tCx807yP8#G(#Mjx>gxZ2W&l}nz4*uZ zsQCKo&o*;-vxDT3lH0Z+9aJ-_@j@c3bOU=jS&%{l`O z|LUWL;x(mQdq7*vl&tFS5>ii@WkvRDI*;>x9&ww}&92_v{V@1W+ZwQ$k!BX~J6d`;zxxx_SKJIHy*8*Q{?nT}WAGB}sC-BHYEuF|KbNGL>y=7R`Th~9X zz(@!pB_a|^4Im;d4JutjcPOQ#v~*cC(%nddk`e@V&h50YT{Vf)C^Zo4s8vptk5|oR4k@*~ zjh^zYC%pQ-BdKlT)=+xgi42`L6GC)BP&mMo#tCjv%Z)lYWXN@xVMO`|)gq4i{m+Y^ ziWpzG8S_9`-z zJ4;*75xS_=wS~$j#%;yAGr7)7YHLburBWiHVKdl(P}kx6Sbp$9z8ehbqf>VcX$HkT>N{aQ5Fxw{hWo8 zfy=1HjO0+Hf`eVOwu}$ywl&ScGvWfnyx^X-qB5_WtgK@JKH(+;`PerKHCQcq>&-jt zz)*M^{ZpJsQOF; znOl#sOQT1t48_I$FHmeRjp^!DTbZTEprz2P4)FGYB*2ckQ?3?&SVr3`d(n9!l;3rSO2!x?#Ez^aT5yWW(dV}1 zqQzpvX~v4EP7H}nyi+ZkL+$4_TVy&c)5EwLV;Ywe=hoq9V~P)VCdWHb?qjw?tvrbF zbtif_`n<vB|Z*dp#dY5_wQ4=@#_ow#Jepqf{D?^-hi&*XpsSCLe zf^@R8x|w^5hD;qdrXM0dvX?$)m}wR@^?pTp+rSQoY%f~#ixp$K7RW-f=p>y@yI_(j zP*MOVW&Td-s@ZbI@t9~e%=!p{E8gBP6_0!DF=jk&V7ET<=`p&Gs;M0z&H*NN1x%Pk zzpY}-)M)5g$&x~%n2PR!ImrXF;-!R5>{@n_UtT$O8(m*PZs)5S z7>JoP_+hR4oj+bpytBhP(r6mEDOCpyid^qx>rj{Dj!@3#*5CnO-LXk_|4RWX(AdX> z#R6mdds_l#JEOjxT^VN3{0#0}go~%a18?2FKd<`I(!Mh^&c48FYq?6p=jwM|s9|b! z5PW%fs71ta3aORxvfCr0g6;#Szg`_35}pQ_Q4IGlRO_#(`DG!jOj1~e6mWJi5w-Ay zD619c*~HC0p(KgpkR*^-KJN7-mKdTs=Uk}m)I)5@z+kw<(8;~E6>of{)jYn6TOdqD zba-NDTQxix`<6*lG5B)sfyiZF8R6q_^ z(B$UjjTwcc&CMTe)hig`2G`?~f9Q_?;gC9N#OZo+dQz`j+JL%k+H}Y{iRP(4l$7wV zH|R#%j;7>sJ2gB$_F7b=aGMl-aEV5q$LCUWgl~6y?|YL^+)G32_&YR$aZX<#FpyNl zl9(s|=k@z5S#X0jatsuEaG}RN!&2OQL}%)x!xL_Uw~8(f=`{K9QQh6M$ewuNTlPk7 z-G^-338&%{-pOL~}iMf~BYE=!E2USG$rR zck?c80cU0h9!M}gHe9nFsd%_yscYwC-yW+F`GetrYM{nul7q8xBl9rxMuoD3Wb1hF zqX7~SX{Ll_G~M<1c#M54trOi&qby9H-6EFXj)*$ctgS6p&}F0Z5o#Z=JnrnG-?Mz> zWs-VWpPtu7=WA*4x~)s%*?PE3V^-d^jj0|s+7mrrL7&g3ZaI^Z#HWX=Jo_#u@mii9 zOajLZ=u%24ONs9taki|eHC)6sr6|HgkhtF+no?Z?`XzLBYJp#s3f9l zLCuJvd_iK6$My%kmxN2}n~>wxnip2hyP5N>#R!C$r-D=)@B8YVcxql7Ri=fj;)t(Va*dVOP%>AQ?Z}nDk^(STP@{%*Gp^@LKG%sxwPYdRQkc zQY}x!gZxQrAaUcO5&1@)r-c9EC!xbHAmSrMtTUtl_oxc(gbWmFx|T76)?X3BR)zf4Es}$@#rd(%Zv`?{W@UYs6S-vS018!d?A=Af4mW?SHFOZ+5u*`C{i)o;686R+X6RVqO{- zM1?-3E3~S$9JvqTfU=(2#SAQ(gzP4P$&UA?EM~)G>r@LnlLEjX*4TYTDjgSg9v!hc zNkck@L%!!r?Hs9sMsh}NX=X$;t_#g{tUE;?TTO$?Otu*}Y6hNmFezEeGIW#WnT#*m zu5MrL$#DKl)l+2INo1~q+L4eYRQqNI{fG0A10!P(RkzxeEM&=8spY1<#;F&pdR>F6 z>ph~6zM5cIvv`F*Fc0X+W+ESAv*;_Gpo=!kZN7O~3kzWXC<#Oq9~n>mP^*1JWNM9= zT;;a-X*#LtI8OWQR9{Ufvsl%BW}c5N*>AyfZ+zQn@e3Ja>2vn6o?eQr*{w2>(-r)F z?)s3{h!b-+vE9F+60_+Na1Xv5OGLL?=DjS?h)Y-OXoFf#Ni=c>e`ZD@-+wH%e{b+$ zIdM`okq;@bKNDdtNSntFhQufyCvTIQj<2HTloR<^g|ms8F1=OD#3R>|khHr!Xcy{Y zH;UiPbpinZ@Mw=Uy;*F60DrAW+hHOJHz5JJ766@ao&mn07WM=W-S;F4qh~*C6NPr1 zocazLj(4qR_ZR5OtKC*d*=IwaE5@3zFBfTDR@W@`MoE@>=j=fD;a4(-{EjRc zzLzFFRd6Z3nm;j_Y>;w9PpA~&4zyIPuy+E03xRsN(|^KR0TlQ1porQ1ZI5&4(}}~k zQ`oiGf)4>wAe1_N|N4Z87V(Ec?6QldtlFiOi=Fs_9G(O82QK@(uZ=9@@{Ktc#ICEJ zhqQH^bQKgyP8gSXKnjey`1%@0HcAZ-!ECi7_Y20gj=DQWIl=CQ2EJ>e5 zEyoPn$}-$_q0m7UV4nO&u!NzN|N>3%tPZS00UoM(6jw22vMkfW~6 z96Qyu?L7J6y>H#4f^jNq`bTbvog5KG95?d!_NkbU#L^viIFe$3@_)K3C_{-bV=c0a z;x{SSEy8=obC@ss9xUMtD#K8%3^i^03j(Oc8TPUU&W?CXI_Jq8IT|XV${N0cAUhL) z6tN<-`Jo6~b2x9a2M`w@S(K`U0kY>L*1W?vesNJ}$LVrGxSMEt57{w@t8rLvxOosu zAX-}^f!I1wbl6--=jpdkNaSg_n@X*@A!(dWqhB%a>5`otdR(`9uv3Q0FRGw2aFEh3 zy2WH3Eq}3LaCFyb^OD-$e6q3m$8!kDomzY-Q0Wi|+(>T;Z^b1SP~C{iY1| zSPSV>8jzlbVvF0sHP?F4>yw`8aR73nW1d+K%4hP&@eh6rLjP$3!M+5&9a)A802r5esU$7$LfbE%hxkvx z5lw0I3h{`J%?wOd=!d6q#iT$o?k!bp77L%_@Y=-HyhHlEs_t*xs})0DgF_?uwA6Q$ z&2>2+_6xeBo;UE;rORyG&%pk%s{EFRe$i=ZF3;GqbzHpsG_k@uduC2F$F}2kb7^)< zui01XwDphJOL?VZn<$V_jkFF8@KF&usyc~Ed$ZnF+Ao9kx<_bqrfm$lFj>|RP4{R;1JVoVQ!EO?tW+EcusCXKy z3YOS{!(3Y1W2bZu)z#4o9dQDBV;RnfTv?zw^UvwqAwN={|xIejV93B=Fq{f5byE8h-`7An`$I|Q4JU(); zh>fDX-onQS!hqkzw*P< zzdiOjj)Ph*-KR9DS}bk1;^+X$J?8O3ckg51M6PbdD6OH+HbRI&!CxkGsM%%6m@!qz za8Z+ud;7iHz;nY_6*0*WP?DX6E!GfE=es9!ayVi?`Ay0y8C03u#W$UY)D8H+)8eiT zEPJL*@4tap5W1rCr>lR6;Z15wNIE-*^4boom97ns5ioyOTJ%5h_}Fwv+A8r3Ju^O( zPJ{C2d%E0V&(fBa>yO)CX+5A>TGzRwtZ#Yl*~vitxXO*S<9@Q`)lv9}Y18EE5CvEw zsl2{Fj>QXm-vii*!5+N!iFcj8-V2}NS#sFr;*%)@AYg z`*Ig#>8&{n|1TsA(ab~@Cq_1Lh{UZ3#k8Z`+9!u2_2_}#%=-!v-UsV3Zd0NL;WWZ) zs@>9yzqs7<;V*c!BlCSp{2iWIpz}%ql+vx)U8vpj+(BoeczcFq*`Cc-mq2< z=v2*mG?-vEsB73s;IYwk3F}V$OCsTdctYL2b4iC4hyA)(w;MKW67T#FEYbsc7SJxZ zp#eSVTjIK^<#X_)u)jckV$`Kua012qY+N`)!jcq7V84OJiD1uWT+ye7=uh68jp-E@ z$11e$W*^vy4gq>?m!TJvo zGH)8Z}a5su6&iW!G`ekHO`E$cyp$jQ_BukIGd#9~yetjOrD zE*o(;?kD8P(M0@W{#AB;KTmg5q4-<{XG<+56%wRmR=Kgw1V6r=UizfY$i_B0yfuO7 zn~i8{swjx{R(%y>9}_ZWWUV3O^E2U%>c?X|v`<~UWldTpH|f#c1+v7`_+tQ96}MuAI*UY%8~GOVX9H*K+t zDE~bAtM&oZSLFM4G#8~~4>fTxFy50Qe-1$41QZ?ZV>9WU0_*zrK8oD^flDSFli1&< zyxm?N+*8^fX#lmlv?8KzYxmN3K;*6*q?9c^*L&wkm&W%W2_CMzR4dd-If(jtm3YIs zGH8Od*e}4k>{wj4QRFZ&#-jT=OINZ$WgQ8~JJFbB268y+0i?K-mX|LUfn!~|U~0s1 z+8>~)aBn?tPQxaLrS%gqy-U+7YhmCb$R zGq153yEg7$afwgjbleG9=q63FF9Z|6+P$N(>xZ%|$IZ#Hi5B%NPv?bxcWQ2FDMT}s zerlHqr;P^~1dFi;&I$0s;8${({~7*aL+?dkTTNJvNEwxrjNFeMY`8jS`p%$ zaZJm?(}*k{e`k1I6-jF)m?*c83UQaF7NpV7dVasoa7^nOf8h;W;+!^t3d+_x7kww8 zTeD~~ke(U)v@UT^1l&uYjfCAS@)&+la5J@y0N`N|K(0f>UqTHjg%=DmLA1c`M_ zu6oRx7WMsEPz1YqirtCvR4e-Qa9E^jDt*WWuHP*@M)9@w^dqgi_YnhaOC7q;^i@Qd zXu;SlNKEGWgnQ$@_@IB#zB`@0f9o4y|644Xf0@?5kj90YMT|A$j=35dGk%y@Gmpj5 z>`+dh$A%kvExvFwcSrL$8?`g!q*?vo^h9a2@`)kHGy)s(Sx21U+!n%D^;GPxF8z>x zii+b*SZcq{l0U8g`P!XUPzgD{ooiUXH5W)M?Q#9u^1o``?))l75Y;kJ8qI1Bl>voH zcqiK&v?BZUss(C-i6V2gUczlvLn7pH=ONw)qy}d?QYQWS-n2! z+LtftydCm6hLvIVXNbOzOI_hB@*-`^Q+hFRY=Z4C%hF+Z(06vSc%{xO&)zib4Bnxb z{z<@`AYlJydtF>HoKE}(haPVf7W0Sb-qd@>hF|C2f6 z5AuZ?(@!6Cynb^$;M7DaZM;*w?BTj&!r@_ZGNUqS!JCJxOH6|*<$5Qmv$~)y92At> zk0ZzzI=@q4EBaVCfoE$7#?ze4^J#U$^G*)#f>yqc^fI$1->p9*FF3LA|BxbdyyL&N z{Vq?F-*1^B>_lA5IcjB$dT(nh1&hGz=kN+t`?loEh(*hlHibc)o^Zy5_vHqccU|%x2dq7T%f7~U^y5kr?A5^t z9f%1Y)<{cv=N7@DF`e`UIy8i8r$$qac#E*r*#aI!uDgC{vGUnQ%;4DkZE658JPZQx z4i6@u&B#S`UUnA*j_%3Qh$U23m5Ly)z!&k23e;1nBhvR{{Q_1Ve&Nb6S?(w4ZS zK3Rc?ph;oViFQoiL&?&TZ1zdNC-Pu`6YLYKApcE5lkd1P?0}5aDoN^?ZR1n`6%VS_ zR+_=v%R31xW0d1m1;u0+-T}YqoQ}qS%0}Q>`%458)VbO+4dsvI?POWL^7R~#x7zTU z402YRJj8X5x9GB>4)fmJUq?;2`7XeJU|C6`>&@hbaM+Xi*P~X))B+tXM3cuxx{$KY zF==7)i7aLD3^I;s?**YO2q^}Sb2EYqjJk<0hKfgunUe%lLgLD4Nhud#QxQVVAzg$! zx%zcq3oP=4W2>^*@OMnGCYFTP8stZ-t*y3w0pxFPy-AB2>3>Ap=@$@Ja!oG1F*U3Y zap+xpv=B&#y(I5Hzyx3v`GRkfF?C8rP$-qL-i682w-2OhnK}AC;edEC)I-8ERZr>G z{u0krjHdM!y)jqzwZQ2idjr-!G3wM@y@LYvCFpu6)xs+n2B(jHyGByK{DR+&nyz~-%=NJImsti9|8lvJxN0b%Y zu2Z;mm|P&=b0nnWgnGKX=2UosNq5r^P`5sp(9&EcCgcol2PAVV=7YZ{1;&UG0 zYr{Sz@gX%Ygh`gW+5flzuzV994+X3;W)8FNj2bdZJUKIy|_H{N-C%e>4=NEKxDv!pRUFE4CI~|afxX+(I{Kw z5}G|Mxj*K)+Gg{K1}IvpwJWlnfUyNVbWQ^DOCcS9gYG`k$q zfukx3@km5Xx|L5OGzDqZuTp>l5JH!3P|NfblRn(iEpXMEKSbfHziiu0r5-r^`i$!6 zqt4DH?&iJTCA524xVMDT3?F52lAWj|g|cLxsUhE!0UX`BM@Gu8 zbPva>mTzhs4t^OO9Km;v!$N;c_bJR|=HC0{pvEos>8^(5lV@{XhqE8rADh(R^l^(H zSPohKRxC?zk0mF^H;XKrde4k2=s272wfCdgk9u`zojGFV0*EQgB$!G_n#CN%r|NCn zh#X|+TSD)YX5k%^E}q*q!6olZ7dK?nE;R`{27npIA;SoLkgAI}8g0M&&Nhw=Ch-z$ zt3Hx0eaL7`(#YH8brRPD8PT9y1|P=ve3r#!y*O4!Q#rw4jI5nk-E}V18n90$BNdkE zW%p6=6u$s3mU++=d)RB)OwdPp<;L5_nJ)YBdLE^E|*5RW8LfXJKrHE8f?Rbf6F zVjecr$HQ$_+pZjm+;toZF`&uCzTw>b60|sL-hA>z#ypnbovaGl-u3Z%^z!a9aGmEm zV)QVr_h#zNBK>K1Z(wqN{0JPy46Q z#e{?`{pU_dtmvC)zo+-9-Q+i-RhK+xv3o&u&v(!IxZ?V}y|~L;oK&t)23I(aH5-py zqiUBnsT4bo7Sm-cNB+K*pl&n+ZxKH`Pl?*Rs>*4B_Q}|;mi5?FET{^JPPnRlMaY{F z$fY&_>HAk@{a1zOR4|k06e%EmBtAGjz_#Ltg{CX+vyxA|KvYV4e6M+k+oDsw7u1Uk zu8E)M*boj@6ZE(L2_`AYYV=Nz5p=quGv;C59z)`|`HiEv93^0yL*=Pj$Pb$w}dbAb6A}?^`qJz5wZ2s@;i-Dwnfs@{W9C`=wYt5@7wwbNCnj zQ^zYP8`hd61oRDy8sl!t$WbD%AUcYPXnkz71r(Y&&D@JpCd*vzLk( zmp1))#GWwyCqy2lDqIkzWQXevf5*F&f^V0p8(wU3fj-TLi`}n@%Uf>p!)7+L+`@{dPe9j z(Ukk%_SOQ)sS0VP?6vSzwvbO34sTtsIDBzDa=KRPC>e4=TEN2Rq~7avVoK0e&eHlB zs$dM@%sSf&Is+>^HYmlTybmuWO8I!ZE*En@cW!FUuYdYOFOk=w+PH;6nh9hT?x#AD z!Y+f0i>ZBhb7-XQJ1;|JT!@XUKDSdtr|R48-gt3+V#c9By<^9X(9mIiC8(Uyy>yk5 z3-Ig?{t*qH{TNlvXLe4w)NL#8D$R0tq>wwnOfAEG>on)#q#)bm>Dfe2(XL(Pdc4u$ zoLEDTTyOK=-pcfpma8p~4ddV03lv}$VFU2O_uUUm|B!gQpgQUAnE7SAG>p2h=u}d` zB=;ZWdAv<2#^N;qF(*Ts4|ZNrnIE4*-x(7KXMlnOy5jR=9v8A-5*aSpt)APqQMyR! zbKAWAgAv=JkQo#N&DZLqhRUh!R~R{)j`DXV49d-737D^v!p;SCzvX)P*-49W6o3$c zSd#!v@c7CmF77?UBEVvv0p-#Eyi>n|C;pFaW&{!(>>_W`DIQCT)^DYnYglr5Z~Qm3r*uY>EN92h~ua);WlRXVBWVbvt?N@hD{Y_S-z*+npfl-zU{^{qEAHeQ$C3F z5<@<{9t4umfq~L_9~zBO?Q{t>=Xr3(=)8^TFVxg^7M{mc1cPd=vRYj;F_+5{GtGP@ z3++N3pDp-2Pu3=I9UEGN*d_M~a&s-Z&=C z45D?9%yIx*&L0o@IY10daWdG3ulFm3x!}?!fkppSdler8*VU1vxeg5wBq8)MDSjYR z&&<{rxFHkaDGMBeRy6^PsGIR8e2(a)stIU)ElaicQ6H0YDdKgRy0pL2QDZ(9zN3{` zt5$DeTKj&?I||kwnMO`V1CNN*wHZwF~(iH^*}C%*2=2Ix!{0 z0SIbE`d=N^{s`A@fYM65G;=$>@{7=?=1`qNW-C@!lI5wm1M!`Z#YC^0!5$KlOTD?X zYn}$g_nojUXnE#KBIfoSPSxN^Ewl3#@30BtIFfT|N1OEx>3A0@5(T$p02r``_*v7z zGEIScUY)L)*ULvQvB0Ro8atYPH=%p;U57FUXgZ7J(F8&WZ4I{>za6|Pq+#zTL-TQ8 zs=TrhJKTdvi$@|CGTw5DX0-K#142gnyJ7!0nWAt+FD1d7^+S~~+{mAsYvyB!1 zh}wxmwlmOa@Y2XDlol4{1FuRA>!o~7IdnlG7=!2Tbr@n-A-N#L|WzL39h9+K(E609wb2YotWzjdsq z>}E`y;_Hbbqa7Ii)2L!Qv^|MOZP}+|;767Mb{qmmo=uv?xIdbJXNSRX&eK1eczY=E z48FR~SEd7(5Ia4f@qS&E0>Gu)O*6Vd!R>^heZnrTexPQksA(%l&dVS`qf|p(p2h3} z>7o#rzYtk7<@p(p?fckdh^Kf&p{sO*Lzx>z#43n>zX8#2UGsIHjTD=a`O4~@;QHJX zVR?@_B*HR6o}W4-+BdqaDSi1pi}=BU0~Y^3s2?23@n8&!4UnG(AQd+LO2^?ZxuIFeoW8BPrU&cJidAx zZ&H|v>hn(d7X;>W@y242d(X6mmMGW<3rqr9Ks4-QFH^no_gL-f==Y}SYMku`#0as| zBU~zxXE~m+Ud94+C$Vx*a~r$SWR6(>K~jRY4>}pUP;vL1(m!BC)wF8SyT7Z1q^DZC_v z57ec#MK{Jao$7&UIAtO^+=0AyY8~~%qm#9!=^|U(8rH(~6vq`~dG?k??d+Vsw~(6C z(ojwSdqYj&Pc;JA+c10}@P{#`Oef#wk(B#lTF>AV_U`HwlfB~A$E)b7-ujjqwLC2{ zYqWs)iOiLwt-z`h?Qz^sWiGelo}|O)--~}ILi=y{Uq>FfB_3He7wKM-yQMCY|3F8c>9 z-`2m^gazCL!5-LEr-|3U%Jru~E2H?=vf5V+O!a8_1c}c>Eb~J^NqaQ&j@e-G<{&l& z+CC`_|D$&^GkksH2Lp($T1W@NE<(S5!V${<=&f5}0e4>Nor1UOuw>9*l#?Z|v~mdt zgVzi&O?g3SFECB!#1cL>WGJVOb|l+hihgl1UZKfHg?vwe3yYvr_`h_-{6qqc){!5r zv1hg&<&QS%Rut~L8iKyM$<>`qU50p%-wTh5InJKG%OK#47S>GS@URx9qh=cNx-MFwR)eD2QE zVOsPpm`GCHcZ46b1+e2@aAmDLj*CHKTJAQVtG=;Qo??QcH}^q$E8dgXio zq_z&QNMhzk60)+iu_eC%9$lX=Hvo)Q)>*Tq+T8+lnJ|bQMKo1%l4rTFN0V#sZ`zsYS#a19qtHskwTwT5MFAt#ncMrg7+V>AMx%tkrZ;5Sv zY$8vK+}3tTRqi zm<}VuLGJ`WX)<>s<-zfr>erfANZ7K!Y?`vneQ3XzA&zDXA!~nomjj!2Ka^PN0K7Ujny4WJi&cH5-e!fl?HP{xvnBZ9ZJ;nXxKr0Qd)PkbVJv>0D9S_f zS*7G&*l)7&T7HFG3-O^p8qjWPB~uBF1KqXTRm7F5T*n~fgmfqQad;|LO%$ z)Ey=u_Ly)M<0%TSi*RZiyrJ6bX*{+qw;j8UX44%69xBs;0J+n9Ab<`nx{~OXk_UMT zZ9xz1R^^Pq8x8SICkKjM2C?<+t6c%;gVAdE!1(r|6Q*#N8MZ!Nn_g^K|7m?@tLRa^>p}-EUFi1X z#(yT#ezhFLAhbZ~uF~h9*M#kGD4qj|%jbYgd0T@;+6sErHl-G~g1NBH$8j24Q$N4l zK4g%2PdD4sb9d$9oLz6tBaBMms_ijg{txkg%$0#X$8pw*IIV9=rqIZ!KLLm>)VEIe z>JcAm-r`bbD>e??OF3=r6x0=PwN#Ryf3^KsUNQ;T1l4$n_b=(1XEvg~GYH56Z-giU zBzL?)VxOKwJ?3j1PUy3rznR2T)d*ad*PD zl;U^N|0^{F6~YoymjvPD+$R;IT6r$Jesqn-(5BcFy6FsGs)_P$T7z@`yd~DnfK(&9yVh!a>wPw?e4*=jRJn{5(SnG8OObEjS}} zjk^T|LdGqjI24x^VY7|=?#p*T@3WsXCcjx{)2AcCWD?Zv{Ndtg$1;xkd)2aPvbis= z#AxMeM3Ga-$>n+vJIjkYweb)KQl)I^?zai?|Bg*4BI zsYCC?M7K%z_$gr?%eBreUs^nJH83NORG8}r1hN&Hkr6|Y`7vBMLlR7|V03MKOoMe< z_8xd3>ZuwPDGvR=Pg?jjpTVDz0ajz=BDgRfnhQQ(tZt z3E2k*k`KiF`8agmca*?AKz84bLOyx&E!Q#D5g&QjO;i7wK!|jZ^;$TH&O;pTD||aM z8-zYm0<%!ODP9^zsBBr}!|Oqv@y=wK^xy8{t4e;NRp)2=RyzkJuz~hf_ zqOAVgqQPJe`Zb(uv|9SgVzoiM!fz$hMw7T^EEBoi8*k|zDWruj(BrKj!GN$8q~*Dp zUlSbv9_A650{(;1)hG~5DPc2f?+vYGz9;#_{yA2kCJrPhl~WHq9~F5nAb>GN<0a1D z-#bG=`ZoN>v;NIW%kqI2_;Qs~3jxeoYRln0K!()29S6(`g$9Mx!R_<;AA^vX@ zZ~mUJaoO*qn5=}<1t$3%U52Umrj$SZy*I9#v~IHaWze65Vx~C#^Wk$i1ZiM{0hVia zT;&-Vp*cBMDuVSL17b9AAa>7+?}IrUuR+^V$omXgnloQKdnWYzVBVnYiJ-;vGY{@c z{n`;yG9X|ZMHTf%aOwdQ2U9`8Hzk{Z;zgXOM}x})))g%84d1$825YrR0m?Xbv1I>q zh~n>aP5wB5O)!a*-pH)r_u)TaccgOQ7j7FHG2*`hNN)YCN-)u|W#3$(O zYnPRmFWg5!@o(`-5(ET%Ri-Qfyxk@X_<_5d&Ggq~sejP^?8o<*quy04AUV4hQk7pE zMK2>MX~o6B1e5e{X2P7>NEYB_dR7e8+n<=j{{MCW-bFtT1ku;)tQ43t{par(WEMk4!G&1W|LLCS0Cv4>oz;)~+q=Q>z3`VP z#(}864UJnKK)b!Fak(wV1+SJK!%`2tO*VvBTU`ZR619_j7Stds&Sy-fz z*nMv91xtJawGiD21+GU}T$%WZ!SzA?M#O)z^ z?R0k3dOg0ZG3kl{{rOsOGe{}8(b7;T11p%HmxH4#mrc=MG}OFEAp7gAF0*5llvI?* ze?NdO3X@KVi^A_$Avn*+1U<=f~N2u>K>`*=J`*IYL8me%^q-9=N;S2zsY_?|f5s zQHU>%tmv*A9Z`N6OE2j!d`}X{5`4u-tCvnV0pdqt+vHq~$zP<)u zzUrTI?d;mmY%_8eW8UoJ@Q9pw@DK{*K~U-*y`*FiL1HDz*iyW5nA3Yeh*)ZYBjyu)awi^Cl)n11Y{0(Mo$07?|cEykuh6mVSHe(o}?-2zbL1Lp`42a73Kd# zIS#Po_j7W#|3_5wpeQM?S%UY%y_^#N_CZ5b#R- zlThR&_#*$$tjt~x$xkA3D(oEBGEE|+nTM(Wj}8bhf&$Mx5P!M>SnqKl1zIxd{0QN2 zJaCzLemN_l5;Ly3(KZhVasLPTCqYk()7w|k$i6xWXP_NWXZg3IrN4m#29M%Vi5}?Y zttut+D@-+V3XTOC2%^Uad&}qED^teZ(q&#qaSE$QC1n2(p68cho(p&q88Bd5F3>dauH&otNMESy+psJEmnJyiO2GG zsIMtx_+DfNJ^bEFGqXSZNhZF5MLaddP%H*!SuW%QDD>kJmfxpLW;*lyGR54O_Z8-)4cRIiU) zRaKj|h(m_il+J!pqWm({NTdWtock`AAWBy;gXICEq@>pKfS-fz*{TG*H=ytCY!IJa zeX`>io-iEKHMnbN`yZ1jb z)Sv1d_7Nx@@;gtH0)JP5k!Co-0U7jdk(5C{Faos0QdWB23m7*TM=&gbo?Xaa)eEeS zv_hT*BS8Pl7XD#G&@W+xN*$}Y#F?`rhyfxM>zkq3wTq@FZ%goF@j$@_ptAb-uue|=DTp8;1B&A3iNZDmY$kgNTSy6RXNGRfos6dkjNwW z-)+TD!Va)kD+gEm8B@>CFZo;mmH^S9E!H2#wE2@}138|6fMPs|-sl6?@23J!`X5Gk z-%WS{ir2g+ak!_heN_&=_~-yg~8feMD;CBHrM z^1tFnTvyfJWtb%1>Plc=dXme;#58b#up*F@Bz&z7`Cm#AdN4_deD?gcS7&MHcmJHE ze_#Lwr9Ut%J@yIPT2s=Qpt2kmvC4mWZ_@!SZ2!yGWMqKr4TbhrV*h?b^nw^Fb-Q=1 z=l>ypEo7i~0s_dl#MwzQ>6<K`=6$qzD0dVzD&0*PRAEgH-8CLgmdaO?Y z0p`-MJ2Jh!@^V&I4#+zS8sMPu{`UvHhdF59=E^fCN1uqVZZ4f8dAERz za_|#MAEsmZ_VI3rVCrCPr$?&qeYDq=EftqWMQzZdvAka zcZPysCQ>ZJ`h37Gy~@>F>^{1ruj2B7YxX+M?^>km z-BUeQqgzVN0OSgiHlm~VP1Q;#C12^Uj>UR!FF|!bnAO1(BhB+d>>@|`h~JND{pg$i zfetaYap(ZZ0Wzrfbqt?w}vndQVC`gs*y#r7E8J6&+`G3vs0Q(5V)zt5^A)|AW&jIL<-E zHx>OXPi~61JA>f)8Mo@3{|5|R1S&Po(&bOagK|`#%F-e)*Jj0#`KO1}XMNp9o1xxqJE7qW546ALPEIE%naTnrG3Vcbl|8YEfhPswH$%lNN zTV#uJek9ZW->3t8pI{(5AH2ykJR>^WFs`j*r)jawo9qnwssvz~tEm;gB_aRnaUmaZ z6PERWwLmkw@xJN6a_D8w$!=vQ`AOF=PT`bxUB*ogsf2VR0`+*-Kq32+$*OSPpiK8o z?Z17LEaFAI8=xZE^8uX{~ohSzK`u7B zjrR-JKnqa)FpYHY%_|Bz(`HwCVjo|n=*gs5vXgN#y3&7ctg=oviDsnT$}S|BKrts^ zhkB4gW29(1|Zir)zAC@QZ8GZKS!mk6vKsc-6Mg)1d7}D%}H*c82K6O&6-Cv0GpKZE!)I zF-BM&D=Rq-(CvSkK=Qx@k^^4DC`fL+c=S1{ip*A}N%0z;PXiAa>rH|RHjcYHb`o2m zT(1%Sxc_sTawUsn9z(H&2^~vhn%2Gky|LYxQ)H4kx83JyEWjwtGZu%ui|zw~^X7U? z*6Kt@xJ`~tM_UMH&zh>xW*xDl_k8(N8l&lb69t}ay(6fTuO!{BszyOCRaI$?RaZTE z7tAHYSNr2A6QHblI!bmU2Q{Iz0uuZ-M{xRj34Kp|MpO-bTr`llalBhvl!znunP%1h z#BKsW<&A84KAm88TyCS3Pt_x0GB11ebp`&2N|;msy=-HWh_Y7cK^vU?DO`HTV_sOB z(|YQ>W_jw}F?n#5>B{u9FGjx@^dvyNxkx^qJD%^(m<$+-C zd`rrWmgG}Md4R5t@vXLrB5Jh!@}kml!#3eS|Eiv5IY(siEzz+OFVZe{tA zmb*u7sDT`Z<{u+XYlgovJ%0*1a&Ew<1S8MMqt^Zib;w#Yi^z?!L%)~msS-Gk7%n*c^;;E%Ac=X*gg=7wdDFR%q_#*ZAkR3nMEq=ZjzR^N}L#jg0!7)KfF{~=X z`?K`}+KAL!jsl@E9GdJ>Tu@NZyZ3G;*Q~9V+xG|WNVT^DUclqfxojH!Zv=-5*)Ln# zld9Ms7)P=w1iw@*53PcRF^q1N)3@{=blY}-z05Mv>u+$$i~kg#r%=S*Gz2XAJ^nB!EQ3e;0JQXl1@yu^TDq| zNVijxy26?8jMsF9fIpH*E5}J;t9$ylmedF~^^J5A400cU+S4zNtyJ(-<#(q@q<~bWN>s zQZj5dSlLa^F0^L;D)zC%I#HD9yzh@Ff*awYg-RbL9&QZ?_EAfZzjxGpCKKVY@#7UO zJIxrH|H1>N&x3Q5nQsU*ir;&gqr8foBO-n!+kV}rNJ1RPEyX0l8FRuO61+d6Xr>^F z#&z%Hk?tcOifw97N*qX!L$1bc{8=ejWCt@8q$0`b{VRViIri*}=DK#>FV^zicPR+< zwST>GAmEb~@cHrhbs`iv&5-5cEGl1K^Q?#DN}@4A9R8m@jH-n;MP`B)c&*r^{>82Ir7y|tl*`xMW)P?um|YldC1lj zvH#?cUK_|eGZGT-E-E$#&HnPYn*A2!>HTX=u1)XdVLEnV&)lPhVq_<2wD10RLU_mq zJa>Owvl`b0R6D@m=A@_hsJKbO;5G!<@u3PDiJnETmg(+>gmk{3IKFbF=1DFEGi^hg z{Pv{eWU2RBX^zbWPG%Je_35sqFRJWxoZt0){!>|?=Sa@W$s!_iXV;!?tySwzpKx$z zfLWu&vWY{Glb)|R4bA0)lQ4U1*U|fiq=j8$6i(8DdZh5b4850=Xs$iwuQU=88*JG_ zpZU|g=)0!eBgu_m#2vqj7O))o0iLt(VBVZ<{N$V*ycYh&C%t$(XU+?x>ag=5B4JKJvBt6+bT;N}hSx*v{@Kj;w}or!%?#vwF>{i|FlRhDW6 zo?L??O7zcER4dfQ%(tgSe;Og69oZL^<)>@xcK%&GUTm_fE_Q7|ezq1Fw3f9O$4E?s z`fNBAl;f+c*4y)LaT<1**bG+tt(e0HS$3ewQ{YrljGPfrD^{K&M4VAN!(+|$kfr)% ztPOW0477$=rna`8u2Og~SKtG6zZ}JudsJ-%PF;2E{|ZM8rX%$}rCsIn5IFLFsULa} z2gO^k-fSbYX_&5#3CMP^5mTR4Ajg+%jKX`$@W>2dqd?O-Z@FJ5kN1jOp{n4YVnHC( z@wxWOc)!ZL+K8m>@xa4o`Ke@&xT`ych!Qhlcm=LIGi|WKZ=ghqfUhYZH1~07 zd{3*A3;>&tZcMq@Gd2EBdwMjClgV#2^O%TFjkBIF#~150q;3itm00TT1dOM(LUN*4 zOS*w1mRaN6JQ`uxrkuj@l$=6zKulkyAnilN95G1=8TgjPHhi8(^YKnc3Ev7q0LuW4 z0Y;1QU%Tg?u|Ty`WEGNeua^IaLBMp;mRR57GUVKo@vrhEJqCnmi`~p{$PU~dQdZw7HBeMY_KxEdz zR2w3du%12-9|%^XZE{6!XNI2RyxuLyPowe(*DGF*(0b4Ypi(eZKUN+bH&O0+OB3$P z&J|g6r@3^hrt#$jR(T_FrMeZ)Amc66=f#yEL6)59Pagan?umx?6Ijg|sG5BGh>_rS zhFwqVv}+w9u0g;f`<4o!4o=$mzdWJ=DXZolb*ATd62Hf~CAxA3e8H^Z#AEc}5qiV! z6UyD#N^1|JFJ-alz(TE+78Gh&?VJ8HTUbfR<-Dssq2yUFb71LN!~}Oix$Q-!sJIg|GD4x zjl7=K{Yh-ci+$CRa~umr8jEevet(_tZypYfO7U0=Xh8uo28r|iw9%$2vX7=!^(vjM zdgF%<3V;q)cJ&`ua2o;@!*PKFX^dI9x!Zp>tfeIL-W1h)xy>}GIFQ1-F@wdfldor) zG=f55+DHV9*v~b5s+`KfXa~x$H2}&3A_0d zXCu?y{t0pri`1!g7|oUpTz?ZcaN_LmyKAul-?-!1hhgf16Jzg!Fq0~gdeOjNcK3vU)51y0;%O{%I_tD|u#FUx!Oco-^hP-i;Mr+-K3en;WrJ)Yv|HkEb~CF~{C~i;V41 z))Vcofz)H0_{^8BiuqmfUZr&Bv#fe&gJLIcJ=?qUZAVQnI+*Mv>Tb|e;RbuGj7Q3D z55s2pU3A=3G|ue?+59#_ztm3C)!Zo5Ha2_M`@k!v4*Y{rJt{&!HsvCTJtEe3l+MHD zrhgPei-Y(LgtOBvvk=m4zvI0W?9lD+{nBkRNAZr3+WO~arF-b-1%LIQI`1hDdJy!` zd2B`031A)ap<%I#3i`vZhY6oD(v?^fhri|3xYV^ISr9t4^%@Om|>r`&L~C|L^i$ z+VJ6c7??scfNOf((z%% z5GtEAzw>F}i;G2tDualf<$+&k5H&OVyvSmW=O*LGYc##w2D_k<`L%pezP+P?wbDV< zkwj$ilFRC5(cWV>!))J+8Fx!`T}3OV$@kcoh9->2G~mj9e74%hs&*7RVOq2()o}{R z{An&Ql(lE1o+R!9S)4Iz5R>VNW#P!;-FAj0`gnh$$wGhcLiyMk?i`BTkYVVTk(b8b zU;P5Mpioj*Pi9k?yxk^c-hHPMEt@ZgQ=R3f2Q-FiDA=e&$`CVncAE!~drLnEZp55RYL| zLtc1$#UX#QGPA#vuZb*)^Xvn@g|-|%E`0(U5H=lYDqgC-KD2riKZ8tPs1rZ^h+9Pn z(gTkbSP+bLwRHHq*}~LZ8&X56uiBKUTVl4#Uvc3XNApRk!t2<&(19DbNZA4ebiR%d z_zM>8`2j@gcwxdL)Ky3=Y&t@R##LGxX$Ogd6plC#ko({p$F@2pdxDiizu88_2lR@RG(_cO_7y4Twwjt$KR!lGqBe$tGz*>l?IOrP;_3%vQ1G}#cs`8P%S zjm)trkvEQDTCdb|XUuo@)&Zzwkp^H0JXNt{aFg2<{={!H(9Z)qj|@ngMz42tq=`9i zDJN7?&=pzFs67%?&-wrp+2u7QSAw-l-G5xKsoD3*rxxxX_CWR@-{h;;m!{Colh;W5 z>fDE2?c$%nvg6McZ@Yf5tK`$2*d}$K7+vJNS1O>;w3w z0iKDGJKB%zdb67JE1L9mY{n4GINW6FjX-?n2QyR^L(-e(KCU3?@9gpcQ~SGISIc-v zL$1&mmIRkT)P^}rr11|{NMIZ{Nsoi7eslVy3;NU^J~(a^A2iZu#lN4!#%yQj!~Iw? z(3~IKV0sKYxKGo5S{^Gl#8YlQTq_f&gVdCWNIT-3+QH^p#IvwyA)5uT!u9(UE$fp0 zpu{Bkrp@U!mxSP2(p~xZecCkpr-b1~k^MKKE#0DejWM_66Z{urw0`rYIlP9kWkM))U&|l!`uysJyMUK}?lFg?lxr_s!O<4M#${GKF#pvn7+EF$-t zYW#oq@V{+>S4UKR038AU0y=%GUSck_gHw`_B`L~uFF)RN3tn@wKvY84`q>rwI>XKQ za4lISE@=zkj+cVBM0fK?w5C^-sV=)B=du`x5{K76S>pLca1< z{>!$-e9mz~<3m)Ekqe>I;pmXo6>>*Yoru70?!4&HaUB9U(;SG&p_KY22qRw-A+k?B z2+T66&kW@&+s>E2agaGmRB&=w21EXW+DuwK>hT6hwc=g}!GMWXyDIdu+IGJ%A0_EF z0_@~x;f=7V0?PtUU`cR*&O?6tP2v@DCVWT;lXzqFa86b|s*Q*ft~OgEbSAdRb@A~`Lis}$S9(24dU0*)A?723 zg+lDjeD?AJ$z)q4L(L6(t)2OjB>$e;vwfLzjIT-lUfi0*vlcaad6SNAXlZL`gxFcAS^*gr&^qi=QJ(@6P_k@QM`zZ zp)WKUJu5&QefxsFcGAnkQ4PG-50?sx>f{BQ($3DA6Rw-#i2I9AiF*XT)pHG2rzT-s zC*7CaAQ;lZ!&zP)!=iXFE0))DVIzuscI@@<6P<4VH& z-oV|IWWMKPzOP}^o1)ENgc>?GmDwGN7#{kBj|&jo%1R6>{U#r-AgxqIj(Nx;;7!B% z^E1)3&w>DUu>_R5k&Lp~;&J?LVbU#~W?(v>RERN1mwJUk@j@kQ;Pi;IWXlLFXo7JF3z_dGq8b~Eb<-B9#dbgS6;kq z8HWU(C?$5Rp4KD@3Bhhs5i3li2^L`RiSZ=F2`4oj`^@K92Ilm?2TD6!V0Jy&nR)+( zZTw{5h_?KIR*qCiHWT2;a3F~X(JVGmxevzyuHoi)g@4>q|GDo0!*>M zFTYBh>m44DrTOnz)b=>iUdmw-$CDpVzBc@`L%JBj5pyhb9%Avg}-JKrdL^Z6+I#kSAV4Q7<3$+*oNo^c5hq-XEex+;qH&O%|nSHQ+N*57kgL>R4%T-dpOI|hsN3n-~EwJehdh!b+p_mC_ zjt_fau=h}1G%n!Fh7WgEj~~O^tN#_ta$ns%&3SpdK$C&<_}ZlpnwtBzvL^JB2Zw@Z zG)ZGT!>$Ovt@0UN&Q{Xo>v*5~Gf}tfCC}9XnOJE{^vZDJ08JTWAdUeYd(r4p$gU1! zG8A)A9Z#blD<~EU7xOh~yh^*5tCn1>;e18g>fn)X`4*FNM#rlI7Rvrtkwh+=g zn8(5xcy~_iMl!7F;~cZr2K4IJH%DdSJ%ueE-zvUwp;7fSNIEz$k>QJa4yNH&QOnOG z{?h9^!1FlzLD1$4Z%VMJ$8gipTGI;1?{Ids@0R0Rdv+RSz`}Yv(o#-IW|TcT{NiZ3 zcKc80CU}vS^6(z@rs%J>UMuFSwt~JH{ClitZtME--yLS~&-xsSOt>L&t=fsfRS@Kf zfB00?!)=QTtdyR3WZAMwMk+1j+9PS^9L!$^=K0S~G-{H>hm1w0j(96q5Ct3649FZW zh+Ts8mH}1aTR?xzlCd&O({{+zo3!dXbFR9Fc~YfR#hBG)KzAP(m$CQAI!m2u2y<4* zdcW9u|IjYSyJS+NI@|Q8QR!GcgE}tRSYv6i2z}tOZerLNkhE4Kv(brXT)N*_EWI*u z)y18~r2;onK?rrFr5SHdhB`?{%!#EA@(!P{@dr-pA7NH+?K@tXoA~*2?RG3J(Ty#n z?|ND6a56)9qvY1btE=cvHV%Cdoe?G1crGgqZOwuQ3E9?#LZXf0C)Dvbv}Ez$71EwcD-r209~H0t8?%*TIT@J8;=&W z>R64HGW2LgF`FO-6e~o%X(EU%?A-(#yU~b=clNM0QMyTdx9$iQ(Z65o_`H4I7i8{| z$GBPZ>}@scH1LF~pNsG1&xVuK?7D`N;`*I^yoPl@mg(akg_;Kl>-YXBt(JNnY>FB% z5Bi{_EtP_tuB^Z2#jp-rFx0=ch{Vug!m7;jkIyv@-MX$T3>vNrPXs2ApBqaj#9{tk zWp0=^of{uw3VbT;n8dGWWz9w^`%{Sy@$irP_x$z9C*tBHGDDq)`{zq&7a$1#x>!hZ z*x!-=<&;9KY0lYt@Zo>)J~=L~Sw7+z)hsPu8V25%BSTSPMJ{$fFC>*GAr)M;w-j~j z9K-k&y>0`Y7~oo%6=YN#;bOTXD$!@`ulOk0t<%kU4OsUhb|L5Ci>Xu${t7PSBbbF< z86Q7*3D}hHjy4KCxaatk5}0EGRzIG5|?tUb&9qqF0 z)Hw^ei&uGrPWY=rLh5EsY#(zp)s?xWQb>+XVV%FttQp>l8K8U;)?bmETS|$Tx0e+n z9Lo~Ha`2CHoF>GEpZdu?pQC1w{qb3IyT7^rA%(@<{S$8tB*mlv0w!3V!yx?yB1R+8 z@d2mfv!jrZ|CrK{9^%Ir2cKTx!0Op9#q7VB_2=1b;vQvYO}^6UzC!RkamWJLk9D;Z zWDgy>kdne^&PF*+kdl(wE!J!D6#T1CfoX*gm+O060oX1D6LP}8R1F6GZhswMH;+GA zonaJ=`*XRF$;F*4e6o72MY>6>r^%?Y_!g-eII!kL6ljJyui*i1|9zgkuCx-!xGWOv z!(h2SE>zus4vkF>G7?i*%s7oP{ZS`Tr^@aCti9~6fTmu7{?;G0qMWmneL~k&s`yPv z@>qBdGd>q*7jLB22zP3~Mgj;`97FL=d-Y{pRKV*^$!s?uN4s(Bz1bGm?rzLxq#icn zW+!*B>pM8njoSMlW{rej*jO3rYv5{zwPnW9!yV(ki_VU^FhH4X36ftm)>#sEX~b1{ z5v?VHZ#-@K4u=uX()Ot_F1u>dAy)*OGllRkeQFZDeDLRtiT2Xc;YYfw>0Bu6u}Am| zH9bmw4bpR-G52ubhx7XT`{A9fmUVd6QOCt|^!waLpJ|&mly9>>s81dqEUp>p0|1U+ zhQqa5-B%0d*03V*l~z{8VoG3}X`F!Vz?j|gNqZe}b+|JiDBIn(dt>&O(x}T!;0slWRi-JTkwRy!!FUYSByDCirl4a{(p*bY`mZmQJULcyXJD z(eYFHh_&nI4O$pBQU%y^x*BN8E`0I#f0RPyYO)_*^$g4&+hBl_-s5rjoXeq`j)F&C zi&n?mSi0r(m*oPa>`-XcoIWx@OCUW}s^rsB1eh6n(RkXO2YE9ZQ2K307cE@Eqj7*3 z68c}X4BYi#gIlC2di@`^Qj2pfxn{a$S z08JN?)D&yP2H~bn+)JvDKVAE;Xr2RawRv@x$DzGruSa#Pmx7Rgp6D;npKBi}1 zK#2=a)ybO|-D3*H0bv+8id>qJbV=i-Qz~&X*(i{l`{06Pvs#6W>a{<-);CqF;)3Sg zZ`y9GHw58MfpI9rx9m?sm%6EqK9ieY1f@znf8H&hag-4j1Dnix+CoF^x&Q9HfTM3_ zQG70BXIj*xa{o8Ja#OU=$?4o5ws!i&qx;HdacIm&J2uUR@gEb>!R3nMyPo$P^MpY< zn1}5-^g<;mPGbrCSCyHS)Y;=-&1US1-G3lVFn{%asw6In$8PlPWuK|2s(v(+7tokZ zX_~NJF*a<<{JRU_PftLnqQ8n~EYyoT_ikJxF(ALV;A9R2L)CnG4fN-<`F?aMfLx|K z84pW@@vL!J6Y&z-K+IRyqC7T^<}Vv7c|E_q)A^nA0*GDgC$@cB58bDmBfft%AM|{(_l&u}1i6+V+e&==)qh&&6o*RRB==x%hP3 zFQAW$BAwPIBTIs)4A{TX3}LhVu5XzVz>}^IvG|0XK0p`Q;|=4Us-7b}LhQ`&ct!&| z4|y-A3@U4HxOJS4gV~{BNl11WoE)@bTVXdn-`|5K%vqEHZyKwo3ti>Z^tP3$7I|4IBA5WgNY_%I7Fg8OFYN=D3Syp_^zn)F%Zb$hU~S%Y{3QLh92xK zZ99f2FAQsK4%dbAlRuN0ix&&{T9zP1@s})ybXPme4a-253A>m@Q2V2FWcG7|)T*C^ z;$=^JRE&Ig%hqhsgZm6?uk%fRDUn}btK4&8oM5Q=nk<()zbO|1XO{SI1UfW>I1Ivl z6z2PcLPy==PvuGUk@TIJdi`53LA10X(=l(tKIX(Ie$p80Rk>#7kLDaJ7Litxb8P?v z{Kt5){G#2UM%Sv36dmAG3ZyA=PH(&|XtZqMW4;_D%r(mfUH_^a@fhjw1^@DIC;B-y zh_WDk+n~QJkh3^ZuFl~5HzAd=y@5T%wnF?wP^wOk*HhvO7w|8-$3Ts3^L5! z$~Qax!?UJ^gOC(H{h5jR{RQH{rK-^nz~8>4VKW+EzJ;orQPv78Y8?E0FWkQ;OeTOj zsFjePy@79Z2`761No%0DUXonS|H2>WT}&Pt7|>h@r&u01L#I`lJn546%U4~EXlv_u zhZeKQqfd@DaVct_c4f)Ymky3$(m7sID}x%d0s6ff z<~1krADuJekdGXf==8r6y6Tr{)|i^JNjT5RCt~3zc=Y@7+;6Coz;B6{Z_RS5`a_y( zNw}K0TUN6k-s$s5j^YEHkNWn#+oy4<_qhq0 zlTrLyM~u~ypj`FbrVB-{Rht~-&GQUSl%ZJ}T1#Kz8VSKqOMM2gEsWzAwDW(Z->~)j zJ)P!`j&s9igNTN`rrvHWB^HleesNCX>R`QX5_y`pH%R6fR)!GHWDE&lfgkUy4n@R& zV|rOhS=vFvi!nB)GYvgHs&S5d5>=7K(#>BJ;J(`He3_|L^7x*iXKa4nOBJHiGrN6y z>p_7@+G-m_uN+}JVgvQ6(yx+l4Znp1rjZe{3LK-G*BA=FsiB}3rQBzJsW5u)Enz)g zvXBtK+9ju?D%Q{-2?gHNRr_&u)`dc>t;rern2)SwZstzYZ{b!ZfnCX7aZibTD}o|7 zq4>%2dC6}M|DY*W?e(MZ<(TzP(15y$f+?j9(KX5E8v~Zemf!I8<0cIf!*g62bMs!o z#;0s>_|vS(yoy_{fvHnj;qQwE6>{PR^by0Nb?^Pog37gf2Xv(d=cuk5UPq|ePI8%b zS;Jf<04puZt9#`^Y-`&YH(dfUB*42wk!4@_6~d05ra4UI**Bd>U$fW(iNVqB=oT1# z?J@E;4wk#IzMtqmW-IG)DO=<&}Hj z&$5y{M%uNE9%Nw55S1$Mz%ne}egf|kn|N<)233h^R)<5hf&XQPwp`+J3xk~0;f0qT zy3yB%yPOLF3w2tB z?u~WqJY^9lD~l}DThHyx&)h$*#xu$cN(yhLB)o_nTnoA57~ zf3#~GeA=XparDZR5KKp)pD%8;H|i^O$+Sb~%bMjz*5p)dS4$}l?^2&`aI$wb+54W6 z=O_Rk1Q>z8H}oag=C@m%qYOh!-iVhOD}15N=aT8`ixoxw3#{2y*RbW@AuW}f_6xeI zCD_44BqRp-mmDw(6I%$ve%(<5?#j9p#ZUE3()ShsAiGBJz^2OXZd2|n^NteALLSR# z9jFBr^(I~w<>Bql*fZxRJs3}W?EZtLRcb6G#7F9ZZD*6WPx~P_NAkk6z{`9B^KR=P zqPMTb&fCjd0bE>l<-4syqj$W=ZDnAa7Y7U#c1Wa<7$C~8hxSCO;SNoeUa-7U9*iEE z8yHhn_fC(I2LPhLc&T*(PQ$!bU)iQ6rveA|E@kVD9m>mI)W-S23gp-S+0ZW;Pwmc9xZLg!VbsJ9~gDo1jM>kM)f zR&8~NoC|3uwo&MfRm8aN6(m(1qhjZaHc>DAD5RPa^F_Mh^HuiG@Hde zW3$cF=NX4|aHC&8iSPhroZ35K*NQUzi)7>aWVXnrgI%rxN>a~<(&+QW9~M0-1lnN{ zDqvol!oMid1kF)qdvkc41^BJSZ9a&cESb`%Z22v1_uyo}YQ)Sca}w|Dn(k@~TK$zj zD>Bz&IEKn*2|P)ElSNSa(WNHQQPFapkCb{WO#B@HR~~f^`ozTiUkR7+%SddeAWL}R zWeLibyhftsHIj54Cs&>ff$c;dtHxSVqSVJ{dLPT$7I(Jn1$y{O*d#*5@tLCPY;>$W z@A^><6TH~NjUMz#-rJG6!%gFl15<@_YctGgQyTkg`YerY$s0DB_o(Yd_Q}w%S5557 z0ltPWCrGqsCcfVNZ$STtEB6{LHQCGT*TQrOUy{bV_o}Ec51fla?ok&beshT-m!tJ8 zu+nKnrmBDhxwEd%zoGRb= z41lKElgFD?>;;&XHZS?C82Wy`g)6yUV%+HBjk;s_Z@vC`m+Pz2>kBJL#t&R>D$V<+ zBqU=HW`sZ9S@_teRQF_?az1N5B*b3M0TKY5rTL&0^zh)3J*&v3$OU#%_BLs~`hEdo zpp3Hp-JDGZi+^jq#Fs3X0}uL0Vu@gy0EqBM@xp__Q+2OZ!0f#+><4b+n!X9tg_FH( z-Z>`SfT%kM|4O5pYjF5mi@TxOBj|J|L0)4?O1>!vLg>le4O?yLzIKi)vJ3$jvm{i< zCW|4%M`;iV$YoKDF{J!0Mfe}dvuJ-Oy(t>WB=0bwBq z3;*%hJWyV3kRg6eH~E5k^Uv<%JKG9bkH>D3x~Hob@dJ^H|L-g*LaqQxDu)QrIN)te z>oC50_r28<&F^l#f**jMVyEa^jjsAHzTY&gwGQ_(DJP1q_i3+&c=$)?lmXu6{neCb z`lW15$E1OFFMkj9KCzmS*f;>_Bs;r1TnznhN4c;71SZ3jMRJRDy4=*FgQPOXpo}3- z{USg|5uk$o;QpxD1{s0Z!Cx(VzO4*rTvz(czXs|pQ3#6T4*;gd>@Y{-?`Bfk*A68M4@}hkGZ@PMU zUkX%vrL4ThjUwv9P7|U9KVb>pN2_bP8r4=CLi9pMkH$P+%<5qNnoWJXwiL>sqT6N8 zgp^YT5U7tYP}Wdvlul~kKQ4U|1t6^Py@pqrNA5mA0*8cfXFycc5cq^>Yy33WB}_7(1kwaOIzjvQ3VH@Po7(z zWeQK0$$A>{fCmLd}{ONh)}`YDuE;IQIEL7x-w!f2f*b9-BNUmw-%@R!Hv z36rtSH@Oo(1p>z@NW@1z+A|bBdDQr{s!L z8hYe~9*`P3=VV~7O+&_~efH>x+dg2d3hZ3bU2wgY#T{}5i}}K5X-@ZnNAmr((!=Fm zmAMH%j~HrTSM=V^qA(NU!_$fck{JP-V|?C*Qc$w|?a|^t(}8QMZG8Y&k=XAol>^;U zTbXglfPGG|iP=Iu&BnRZe+)eB2iI;Eea`+3C_i-`sGjncWL3|irciGh`)vI;2Tif` zQs1KfgeDlW=tTLh+4v{}ki0^8X3LBIHQ!lQ0Y(q1H=IQG!>eX01U3V ztae&ZIV{MyLECJnDPaVVtrkA(E1|7M>dR_U&$E`Gf#QSAXn3a9#+{~59NmkkK1e0# zK$dpo3m^zOD}=Lolk#6Agx5d;H|3M-!q8gS%B(Vg_5T_YRcWa6Jvti&k8pk?{jb3F z55(j$bRH04O=oxE05pe{QdZB6-TKLrd6N_%Jpk^K$5eb_{qu3wdO|&|d53U0cF&iN z3sExlYBIDq3rM6G_H?`)UHpk2cebyB{v`?ETMu@&FNFl88R|w-J0$1tbjA51#3ym> z(f9s?idAb9PoteX?w%8=!e0T))ytroTdu(m!as9(OAkUs$zq2y|jfgO;!}6=dVvd@E8_P|H%x}TlJWxzj6 zd=Gnxe^$DUGr`s$=4y6wW|RZ@S^0wlMs8YpKn!P~6FSlyE0$Oucc|bKf|IjH&M|p) zkXC&qe0s_e1>8p4l~_Ns){f(W(6c)?jDf21t@)Y+9U*K+djTN1)mP+Np~oZJnOE*p z6$=-Qt(f(_sMRo=E7itnh;|qAy-C9y8nN7_KzzqPwu(`r&>Xd1bEj~ z%LBjFFM6o?ypa3^$u}+?XZ)OI5-M*FPFJe>#tXlgoq33sM|G>DJ>$YIGHky>wXsN& z9xtJ)%7GAwQgWBEZ!HG2cQwJBw~aWrw|avIUQ(wj}JL zZr>+zP)YeOTn=X{C_7p5#ogmc^s~&qle>w&`A^&I{EUGr3Zpxc#YqoLnvy0<0TL~R zmsTrjc~_`>O8}sQoX9C2ntK?X&Y>2Y zu7$W9rUx0&ANEikZJZ-B&q*D-dDun|S4Dm%xZp_+&kk9H>1Bntq9%UW0b5w0w zY>v9wQi=vW!s%bs8eDRX$t+Je`r?*biue)okAdMM0I(p1kc_pDRhwH^40%dJLPCEw zO){IZ9K^~Ar~XSD1nu^ZpxW1UH8jc%-265xH6PuHI?jYRe#5LAZ+WXrEihhUk4NXI z;R%d-M}Q2QIwoii*hSyHZD@7JPbJ{Wl5<{e41n`x(1HWqTNQkVDG1jXb5(|oeh=3a zMZTw4B;|R9RB9fHkN-a-daGHN?F4ly>#VFmm&UjnLenZe+}^%V;z!kO1W- z%q*^~uGw_+aEz|tV57ZsOa$7R(m9t+6rHTXZ|0qwB$0w5MzdLgg%iTM+hs4T)Rf}( zTz5a4s*%g*(EHYHROj(>9FX-mU8Yzk4R!!3;&_*VNVwZ?lFjsZl8-}UWI#ogBU!Oz zr?5#y(2ClX9iF?S!73zzjJmU1e^@1Dy$MeEmEmX9nr~@OVucLU)FT{eXK#;(0)mA6 z96b${fWXGlR!4kzTT@b-%r489=(5h?q8QRkzdIBZY%G!^B=+YA8=Ue;NEo~n z@==#ugNb(yp~I#KpiW|Moc}pPU)j*b$jrKtJu}rGtuxJ;(xrT<{~><>9zZ`WG7Ku6 zAwxT~Pu+s=A!KiSz{b6L3zRi2Rrb36V2sOs)%}{GUuop?PAh0P`n<-fSBU;%;Hq28 z$pYTH%KyhTc_;p!s9X0QIgUy?a99XlxB~h4Y`;%UZ%h5oq-Lk~=5GVw!ktzz>g1`A z3xH3Gd~g3WnuhwvhU5yI7Ix?jHFVB<&~hovdq5ZNefb6o{pSznZy7Jq_zDS-nF=Z? z&Q;GD1R8C-Bo^jtZ8Dy+_5HkVR z?w%CYpzb94-G*bWHxLK&+MmI!njs+{dip0#g~|CT*_E3iE2ca#At7B10?ETnE-#Rk zwe41|3e*XHLuI+IaD{m{XrxZH6LY(HsXUoyam-r?(?&+=5OFzHj?ts#YiuJFEvl2Z zK8ly*E`80$&l^rd;K9OCL80Wzs*E{LfHdQs881|R*6X9bzaIpb(Q58Ln}EI#P*D7R zDsg3_1d`yZWx6lpudOQ`)_?E^U>@&7U~dV2y*07pK;`}jN3j;nhqP)xAW+>lOQp5I zusN}lJD(nIxGMMFhRhh|^&E#r;MFH{hjV_93Bzd}1uJ#B`T>31xK@^u^Mm6gE3h`b zWPUF!7I_L{D_izymb#C52zLu|xkdss9XPe$;P#$9sRCv-ok}OUmc}`mVT)OBqO=d4 zo1FEZVaU5+e2*7@fVFuMv#C=1*oPwV7jq()`@;1Z?;}Q0X8&VOdEa-zusQzM@v9iU z+l#(?R9dyNClvAK8X7&aRn3dCHPy+aI@v4%kzTN0fO>YdjOmG&W0`Oq^7XTh0bZgB8x@gz36*N4ac%wc+0IRY7=^*=1Rd?vUEzQT4?vD(& zmK%g~jwUIq$eTXB&4_M&zMe%Z+Z`UQ21M01{Upg~qSpR>WpRtr9A92pW|P}TQoZ-B zfk|=UUz4J!@o|EJLN!(wnZm0(-Cw7F>`%}h!G0hH zAmc;HT2^Sjyj|=>S)a5kd8c*qLWv#?7Y$qLBZPltj4#y$=71wo^=z0MkbEECtM%U- zO0?l7A+cKYTMW1{&oCY#C6guJLh?|0-s_EPy#KVQrxfd*60MR}0q1}`9S%4=8D%zx zVi~z}B$hXhm&R<^nxR=aih+pL@iy~CoWckK%XTLX!-z2I;;_AT?^&k9#P;u3H9tbS zr9LVCoQZ$BSEIniQ4D$I+;W&ciV}cV_CHtqvR_x`k(#h5K8wy$@Y!r?s6mlEPaR4GECGa=&`u@)Z%M?z3vW+FIi7)v%_>TP>KLF=jniLlfm1K@ ziWO`Q$Sqy8w5Z=Dfj1$|gG?R$O5-N8#2OeB0eDJGjtxq*i24&|W&rb-SU>C(cYh;g z*tSo*^^VY>g~~0bugPbjgll#_!1*RLW+|Uk%37ItW>He72zFi(=Q($X z2srIm^nYpX;HR_iBJr#(j2#(-1+bBo+v+nv7h{c07*&f6KZExw5b!Y&6tw<(nvdk-JPxh7xA1 z1=ob9C+#2Q_effqChvDNBmVBI=pVO#%%J;2tp+Zyy;?ubw7bodK(P-Vnprk-W2^^z zH*!2n^=e`GxlxMzO9vJ0Sir*fBG?<@I$!PwfSe!PP_Tls;1bJlJWr^fU}n>VLQcFp zSz-TJZOXP0=p`ke_Gu!QLi~}ZSOUqriHv|k3Yy2KVcX6)LcFL zEvhl~e4O}oC;MI&i+IU%o73WsM|}CZ)gEp*aG^_@Dk7yFg-7S zqEt-3aKuupxi`#JNC z<9?ph10)>rN%2ZmhT@fFEzXr1#qj8TYSpkSM87RsdHX<*b*SBGoR>Zm+AHDHH{UIK z@u1wz8)?1;$}|*-`5Cit7XQ_vLJx@$0cZwfZ(&?q+%eTZyLMoG@ws8bdyMEN%EzpU z>d-h5(ZSZ`MzCwi+-C$}C;M!uk+=+E<0%a>TqVuqm+>)*RUG5LY^yLzUxj-kFme$M z6&k^N0hqAl`+v1H|Kq~C{Fq34g#;M1B)75Q=n+?*OG}MSHT@}<-jkkS6+A?tPd5v7 z>-`>_=*_60O-%12-OBdaC0xCJ2c{Ba+|-$q<=TZ#B*ofZljFFlKb<25q#uFj0Au#< zJdnKj=56PdyxwaK-SE-BuOc1Xwy3xxV+J!1I>Xo%DJFi0*S#E|!QTPoTk;-@Tq%+% zbB&NIdxI@@CJvA3a@J6(b$Arq5SckIZ#p~-<9hZD2xVml$DifVP}}P+KW1ycn7zs- zcB-CjE8YnIe(#+xKh~vqNhV9XR7QcuH*5z7n3*XkXeONw$v=CsZarBF3SxaNeT6;m zra%QHDbPABn1oU`?%XIpy|!+?(%jZZN?NL4!D=eDu>D;MsD(H?eJ>31JBfhI=v4i5 zNmv449HVJ`#{jP-4_-cY`?Egzwm?ZFVW(<;r-Zey%T?lBum9%NN}(%%`WV%Dhqp@# z8F!-=5!*k|tEX0K94iMdOk^3`4}cGt18 z*tc*_unl0P0`kfp^-HOLxe`WAm9)y4@LV=rAk@4?YV;Ef!2EtNS;#W#tZZW#Yt4na zR~U3dwVE`su`|d|ilnHpSpAoio2GGcdj;8894v9qlr`0B#(C9lOZedwZvB^!S-phb zYSCh5Jce;$Zmo+xb_Z|D`ZXfpPQ-EeYm_$j2lmWA$_+ddW4fehK!|LSWLbE}FqL_=7N87GHl>(j2 z!3>c1_uG7=&<_B_?nlRFrIfD6`C(a>P!_5~WO74=aO};u4U|_;lO?(*EYMK1h?%-StzsGj3<9{Q{rr zNPebrSrcMj1ye}lF*d5)ou1D499fZO4jGXMwSJ#?q#>sh`9w?O?!S-lVSo?` zTNu5l_vSuPVj|`>EyE%ArEC;ZtmZ)a{}wg^=lX8MD`0)JX#J45+gRk2M3pcSFOfB; z7I4(P!|yj6863HWIFP8;O8#sw9SlimZ@~VcZf)6C1*C2?DEs?r)RlT_{Z6VS1}}!e zL652J6|{zYPR#VB*rv*uSGV-*8P8Q6H~S(b9+P2ffOO5Sd11tHi_qL*lIcj!4x$f8 z@zn@d*eI?1wOyHUoxbbKz3dBn;bX?E7>Rl0WF9Eh{U77Y;ZvYqrz0S_#2YC8mE(90 zohzVw6fE|PcRb`uR_^UNOd?5B6o?@e@lNAr~awyEHM31OhgE zCL~kIr~=>am{|lflr@RtluNu{@u<&Ou(Aj;KM2CEV)n=Mb-3TM3o7H?$9+|Tk4I96 zv|7gh)Ix?0NzB}&pJzty9RV8i0s>un0~GNsz3B%XHpniFWJmbIWk?$+Q;1>kD!F0e z!ywq>J7L;1o@HaYu@BbvDNT!ZWrMRz+5BuI`#P1lQ_N~K;5IbtD=P(#JH#onG9MKI zFn>_h@$4et5yaNaavQ?r$s@1^J>MbZIkQKvDb%6$$v~)&#mA)yf4u-QLT^O|nW`3E z?1#d=nwn0FJ|AUKmTZb<*|x(Gf|LSkf`~xTv_D%@5x8tK93kaR$Q7nJzn)heUtXjn zux$mRdq0~)WbMKMU3p~`e9qu8;=wqz<2nhLHcMxw)Bf63Wh{b^;;|kPRaPb)?lpd6 z638(7EO!5&FjbV`Py)!*ajF=VGVw9Dk0PA~0A&9UWp5o;b=Tz&D=8t}c_gGkK)R8V z?ha|`ZVo9SNJ&X|BPrb?UDDm%-EhwP<(avE^UUo%*SvFG=MOl!_u8x1XRRH%4M1wV z%D^q#5bkr7B%W;@8IpX2=9g%;mPZkX{MTmSsU4vk&ZrdyO0UZ$b&(Lw1{gsRe64wsd1!KseQ_tD!qEN$SP!ELUqEVCr9PLul;&5S_T77wl0 z!00KK$Cqxh@sA9>!pn$p_NJ7ZZu@uNJdWnbilk((sFf8nVS%*uQ}eI8K+1HX{xp_U z6Ag_NcYNYLo``=6{XYTVHWJ!fnQ0aEhmva(P=*h8Z__idB{?j8)(_2xxO$Te!?ys< zpxgBs59edsMal`#468#%z4*wu7Z9)veVF7v@{r|xZ0QhS9P#wo=4b;9_LneTX6|bu zY>q1&g=NRNnW{@W4~t(=7)q9zo-F|L(Bs^6pwBboJ$_xFWSoK4Ab8QdySUzmA*l*6 zew@Dpo2>i>B5#K1f2)@wlLPa#g6!mxt)i-cDKS)CGmE>+oUZg$03hI*C5CSr>#!3s zcosJNhw8f<4G9nEi%H%IV*6yI#E%64a^tm3#H(x}7ohjQCtAJ*r6keNEzETJz*9vf zTnk|n7&`O8T)bvNNIInTF0@eiXGVY+GKB4_mWcKUGV&>oF~Q7K94N3W4Y@3mBi)Zl zia)~^^6e~}!+J*Ibx|~YMQnG?B{4IQYU3sTQnX3e(Q3x?&=Hac@#nKPF^FyHX)Eb{ zf&63LJk3muT7m>S&e`YkVMrO(L#EL19)J1Exmhw(TftE@Oe-pfri&yUaJk0sP@+ZV zws~Xj{Stb6c4eyY^Dk1_Sqik+nx7d|B3ul7_qCL=VuZTxh+eYc)y_{?Nw#D*9kW~s zwnPR;c@KVy9`vEZ8)!UmJ*&DPjxMe|`F6^pX%yK!kvMM*`0p(=Kq^UpV)7|=^O#+@ z4=B4g!N#GDo1#gxL$aiJK6ZZC8D$WwO4;h@wafAa5WNs0r~#0m8j1GdfNA9F5jgHc z3Cmum!!TPPxop!~+6d$?`n4`NwQ;iLc(t3>dGXr&3Mf_9i6I_g0VxuYdF}4Ta9Dj= zHhY~P<1sL0HB^r1CDr0)hgk?F3L2+TR2rYLvB@DG_Qypazs7o^Pv-F3V_`PaM`bh= zXbI?oPhP+*KXBZan=x(4@H*!4z<+9t`*EL~Vw&xX;y6B?+D}1yf^{Y-zkB_2h-^gp zw0`8tVB#23zhz5c>;IR>>t$OB|3?MhPxuJv&hA}P%TspY`R*cVF>z9lLFvJzbg3_7 z4l!A$Iy?-O*!KKFq*YQ`!)G&F^`6YDtbmVUdf&45*tIz}1-Ui(?eN9o{bKDg*qC2! zhig_c{b;KXWlr%`cM#P4n17{&wpPdo>jm{i`tQ7JecWA804+V97$#qW`E`7oLPj}$ zlMz0OrZBu1oLJma_yw8gaZ4TaVT&!LA*F@7PtGy+0gb%M#?|$zsk++hSfI_x6a8%d zV(8j#U<|kVVJfJ4#r7Td{WrEip}QPpg1T8oPe(USZT6d&mj?~wj-v35^Yx~AvKbr_ zXe4ts@h9nW$1W{7$K#C|vo$O?hZ?s&50Y2K6r4h7j3pV=a?$Pd&my4z}wBPN!G* z0&lIG`a^4m%5b=R+EU0hVnRx0N??cWW^3goB5#HH*b(VBa9=K#9OTk17at%ls!i+| zc{;rjd5-);L+Nn-$H9?We5sPsyzjS@q-rLTZ3>lo+1)eV#=^tikF_3hn2(S1tjG5} zQnQ7iMYm%d||%!T6ic4f?%V*J?5i zs3a^O-qmzZ9MsRM5+ipNTEQJtl+PN_S=PvYE1^oj?Dqo4XG+V_;NY{D=28u;8d z8cg`QHGCoHu~fIqO`B}_WpK1^j7rXN^=`J_Bi<`kA8mRTf21Q%gA?4fo0~kK`*3-=#Gu*a>#bv`+ZpeFku z;yD)RkB1cLb7bTPkJamwz+I!nZ!Rqx5EMn_*a5IQT_3g5-8J|WLYIal` z=S>n$*Z6!b4z9lbXr?X0=7MiT!8+Sq6uSF>#*iBQ^?U!~im9Gn7lEU%yc{VW5^+Ms zV@Q!{+^XiN!gz?3w0=a7hv*QK$yi4`c`1$BqnNeE_RpBZU%FSGp;QJ`DzrUBfrvao zo%oVA+RoVAos?tEi5<^96C9NdntUp!&CJvIWIFlC1;{VvjC=OImU7%VT=v`_)6CyV zVA&%}en2n~y=c9%y`{F)UfdJOT@+ z^_eBYwrN+1G!G^TNj{yIEZ2F13*ON-ILB_}=rOIbSCH)vk_s<0@Uu(hLeti+dYim) zo7(>)Z18rc&M|a!iNxMVxNVy%%bL1{G^XEx^g%VO3S8D?06v}S)q-|=jT99gLI{l( zV)kAo*z?(T8hW)K_9?wPK?MeRW~3Z&=*Vu7?IpDS3d(50D zoNCw4s~#p%#ay)sl-iNLw6SMuv?)WyH&G-l7 zjZK&yc+VSFDIfsDJZjh+m6f7v!d*5WRDiBl||tG;76E{4dHBb zKn<-m#|U|UEABQGBbSwft-8~SPOjbhQ8ig!$iiiiK|;qgp}ANlr|`IB!;MOOT6{3q z(#4qntr32brR_3Tx6zqZyg@3GeYN@Ae52{sM*2oe{PWQV3=wcv)nJ;C@36}-Bp|^4 zNXMJg!|1nfn&(vE2)WP~=!90ctYvw@@-T2c(mzOb?>p?}#ULV3S{ z0946TW3*_^vQ%W*=0O@-MMC5c+Nzn}cE&_g$NR^68AA$9ir$#tZBFX2UGBgfH@|9pFfA03Ez-AlIl zF)$Q;x2D-+4X)Tbl*e8#l8mo(dt8U*Dn!Np^O`BOzW92inq^X8zX&N>j=s_|r9<<_ z5?D0Z&zr?B?(j(_SKX7wSm~S96PZ**s>R~exGR5-BF79-8ro-efwi*52zh)SLajBx zxY=<(h_a&->4RRNn^OC>!T=Mxfx3f9K>?+1eNX6v01;)L8nH~G^n{$BiUBta`tg-S z74tEr`}ZJ93+r@#kswO_d(&>-ren&mTS00HUT-*_(6TV#lFtG)vzHg>FEBuR?@PozNdhyGM(jd=fkH3Di)Q1xS@|XU z?t85R)zzGNW4q*Go*idz{4NF{+HMBm;15% zN*I_0zq45e9-yHrM1_|j6%qNOi}o!|g$-w;Y@n|?!VD&@tW}B6S)wrl2;gHcrE$e5 zpV%rz_|zzGbEyfkQOcYDOPd@FaWkK_%C}!NI{V$8sJexe@e{*zNlnWGbm2c)KCVnO zWtX!}d5cJqo#fObStUIs{%iYpwj}C?5joXLBkDTi$@oGBLvL$D90zRm%I#&Jl#$?4 znS2Hhom~sGM@p^7^Y2Ug`wAs7GBZJvx)SMde?JTpLcpk2p@M7q?2SZu-b-uev*Y~g zrU0?B;pi&IYJRrRY%5RBiFt-3769x&CbO3p_$}pknfhsXj*A?y53UXNs{z(C&B|BD z%XHhr8Mr2Fz|6$2RE1DmVu344tu}{->f`_zM0oT6ZH=8zR9p@9c=mTC@t20+%BIl} zd?jK^tGQ=F`+F9NncP1hAT-;|v?1*og)dE935f%0$rNK;-?*fBv%b0%3{^Dyi;K3+ z_eF}W+QkZHQ_V(KME(~J;0XpOz_X=% zCieHOfMi|(Yp0&6-V`}Rg=g)R&V=lv!qclf2RP>JYt`s~^3jSyrqW~WSj)K$7IAop zxBa`RfQ;8*>XPY4yk=0{*MAn2|2i-eTHvVIa99{<{-#I$NdOlmfW-GRrE7psK)?)t zG-jwW?#>+@Z76}6`d_|`mJCR+HS}%iyfz@|w0Sbr(xchb)C$)64eq-EsRCZwSBJ}V z4C*6^HT(DjK`8iDwUzw5|MlztB*aM3eu|3i@_&j;G#LyIPHu?)(OjLkXh5lgHvR3| z8npxpvONR`5M=%KYU;o3;eY-&lpgplvB}L3#($7~9ur{edA%w|t2b;o)>7K99e_c# zA47+g{VY1~z$~U(1MVOG&Q1Slg#P2n-n=JMl!u>QAoq7xz@z{a(S9$52Sk`4RBzldwtA*SB-!k0>J@XEBb8BEX1!*F`9*0 zKRRorDpgocwJad`@?PIj+A;W#&-_h&{rkTll_yc7`{sf1_to`QK5e!#k#mhE;hUm7 zpeBmhaDc0LG)!rJ-y&T&(9(u-+dgT9KiTzvcqR+bNEpeOGJmo@+-raxK5#CqDF876 z(BZ+T0^BcymBWq$lJv*Iee=#=h?W`9nSXxppPvyndph)LsdMhXFD{z>Nh`9KTS=s< zW#i#6#(O8S2@feLe(+yo{Qtd|XGkV^PkJi+ZPdHJ)0!vtNrRp@n*GvhfQOfm1+iL|89ufq zvaMzQpEe=|dIS6fO!X?>-*!u7_q>PM=;R6C>_6%gd zB$ulcZ~@*2T|=<2Zu&#Rmaa$k->LqO{182l+LBc^m0!2+yKw7Gp$#Rm z#NYQxh0y{hpUS)OmYG~ghnJB%_N%aCaDe;gh@l*K_C%>UzS413hY4&v01ma1i191 z3s;p8`K%Zfo}yP80~>n)6~3Vq7^^m(mkFA7dk*uT2FAbe^>1hbO`hnjWn)B>t6hvC zrGCWTRh7d(Zu{v;jKe2NT`~N+`jg(dA;8J)W+gUV1!aQhERr@N80@tapS|}V`Igll zz4BJ$Nug-ynx#|yC)rG7V1W5nUz_d)3g&%I*Tg;SdQlwLHY%+>n62ObLE66*q!`N6 zv2IFNkp8(!LJ{C(zGNn|@5{>47QjC-H1%uFD8W90v;tvMxZR!!Oe292f9k%!DEINn#J|;hSsV1{Nj!0r6!B=Y$9k?X#GS_tQu^dD zG3)i;9$oY*RtQ=Y{h|{QDaFFMIm0e&W0h71zG{va>$*Q3_+W4Pbj0`n{9XT4`Anl* zOUE82g}w2GMsN!%`K_zGkZC&k|41DZWPmzs@a*WKf2f&gap3D;pa~kZ!YCJs$`wUx zs?k&FzA}~8hz@{9MuLOyX4Y>6709PWulGdtUg;6TwesEgKK#N|p^}sZFsA0Tp`X=w zVWg0OMPlM7(!}sSxowfaX!gI3#stk@eW*$5k(X)nXBP^a(ZmNHr!Cbjl5diIHE?Sv zcnRGv%N>V(ch9sO&n6tqli2?}!KY`U|7EpR%BV&H{~&IAIKX6dMeRzh(s^@Z^*%a9 zdeuq4Hir_c6bY-d3lLj(SjkVF{hf%j0beci zPq;6cnd%X*l}jWj_3j_U+xnNld=%cfE0d<(r(SwaiR$R2g3ShIKu1%v2w??BPSkSk zB!_ab3D4r$sgN%nemtz1nYNj3=O8~h8N(r5RU=D&%jQBXoU($Sv4Q(w7!ETt>6~6U z%1Anw5*pbY_EMw;ZT#rS{M)ymn@pbhOYFhgZc1~w42_#V(n>~=%3dp#wYg>j?XI%Z zPG=je9&WuTd*D5z#(h)xQ5ldgBw+0OI8&p)PHkE2X33U>oiR%tBUgk2u4;aAe#G1^ zdj{t@B9H5X{e%JepUR=?No1-9;*I$Jv>s!ChKKRBoGkxHt2ehyWhxziy&N5xhfS~2 z@z51(x|D4YSFz&FYuP`i2L|Tpeq})m2;lDvfT3;&q}i(cWmJ0K6D`fJ`SL^-)$exJ zU!%pwTj7~l%CN29wE3~$(J>SNtpoRCi zy*t}B+%~=Pre%koA#u%&QWuuj7B1hTt8B*;II5uS%;gkXRY$eNyh= z{@Xv)zJKqN+GHcqLit1Hg`Kf7Guz$tq!Xp%j?!#n8R(~nDo|WjR>*F5r&&zTYikHy zzkDgJ|Ib7;NFSb2gAjSb7jOnls9dK=Bc9YvbII4yVIi%VF}Sc+Wj64T$q3mD zqi@CUym%1_qNv~O4xzS7ulEyMr4_WkDRI2%h4`6Pbs~s~m+9BE+U^ApF#zE2i1eYz z{K}DPf29g6`DJ@Z@K7?B2rz{mqe|^Y*y%XU*RlV*UYl6=7w9i7G|pH+em?XJN6x2v z-0FB#2E_A13(czCcK0o7#j)VQ4f$-GGt+xq<%Yr*|UESOO$ z+WION^hfV5FsIj&!gHj}TGleXlyn%*3d|gYfdrdWk!_4)wx z!zj`&id^u1e5VZZ^=?OTzZ-n-4_X1r1CARrB0P>8ek5utH!(O2+R|b8OiW#2MHZD~ z%2n>OewQCQtKzHUD^?hAU)<~db{wr`t<>dtKUeXTwiGEf)K<0M#bU=1o9{C6VoLy& z9^t@rnLtjOZ`IsqKJ8RX85|Z$*n6nR+S!)V$$E#|&4~|P?k5D`1XW;tzEs=%%q=&$ zEp8ZQGl#*hFMyJ}hk3jC;`fyfT_Uu@8-%uXnJA2){)_PWO6{dyEY8I@qjB2X4l$i*UHf-YSwb zm@+~!$Zrs0;A|Fxb;Yp#Tc8Z`fAe%&uW9lAbfJ0^;2fI(OixSgSjoK}J#q7h$PySc z=9SOs*)CAZq1cRdT56efYH%((8_Rx=XrWmbfklFI!dUHeZFakL?-s8xi#c*QT3-c( zaQ%uE6M&P|Yr3p#MjP5a(8Xy=^<;LxmiaCc9zMiQ$}iNOZ`XhBG}%mshdg7mKtda_ z_YO|uagq)$k;?bFvUQ3?E7*Sin684%Yj7117;@F$^A5Udy)F9zu&Hon*oQh4uV~#> zd4ll6Sc(-~mLX|pm%Vix7rU{;MKrHfV*thFR)zmi>)iOjcFAY%<(iTOC<%>Hhd_qS zWahg4{;AS?IiGJQS_HT~AGeis2!hjm9(J7`MP94I6FxS-ba^bTO@S&NU9I?f z*csAiX~hb$wKZh==MwshVodbF+K5>2=i_3YG@Mi;#KrtaASFEf3Mr+6&{f#_Z~mK{ zZGkk>n6HRvaozg9+gkCK+of6?z@@1`py=0!P%_RyORLh@ymHs+J?fuv&A&g_KYNU@ zd4b61d6C%+-IehaEbBnh)(eoDjayF?Txwl z8*RSEEBvWOl8$~wlao=`5t&9>7leiL&56FW>H)R!+HS8?rBt88ceI?%Ws9JiXS^T= zP|=?29_@usDeei~u*{c0S~B@5J*kH0nCKI-TjJgwEy{Rn z>mGk^|KzLP9_&MVvpVmUt;1_^KO=2Y0sj54;>y4dkO4@HW3Vj!HBmIKGc+m%a>I~{ z_z%}=J?xHXuuBHtbgi7ynMxxCXF~FOvRjNau9eg%1@-1bkkcMY0Bn`@rmj|jD!)Ht z>dw_FiIC!>CV77cMocuH{-UJ#a>V##>2kg9l$~ZmcE2>PrPTTB!#uIms;>rlwmd#- zp$Bu-YCv~>?p9Pjt)05q-c7#X^;;4Vk(7kRJd;y4&uQ3@t3pobTA9SlFQZ;BRo+h3 zWLs|XI_^hA?bI}>sRv{k(1auCif>jTLa9&TQT8Vde6JHg5ek;2K4}TcdCE*J13$Ec zdb`5$^W+cBluNWJ>BorZW=j|;!!g|OeF*qnh!8V<9n>{D(&wjfIV+6<}V zQMJWVU{U>`$^6(gNdQWdHrY}3;xWsrr_~ep%AWwX)?=TD$7dlixffhse{ZC#D_Eq} z5~HfIE}1lj`V7}ekr&-;MYYKcy92CICM(WU9{07E`?+});5b?ybzGs>Fe#+- zj}`jpyq7JcH;o_nPUT$&OOrN$w2FQlSiwx@ZZzwC>gMX>b9E?-E|eSFiEj4A(ZwSzw?BL z*W+8F7$P$GZY3d<#ADvvqa+qZt{}M9bd1sQ04VnpM*Lx5s#AE8;Ii^E%MMrlRnw$q zxK*{!I$PVp3sjvgg-So~B;x5C}n(gxRZaguUhg0!kpwiBC0Ki4p4p>uelai>S+ zugy~|mO8!(2SY^k<9Gn`!n3(JQqHmOs{(Gx3fox{<{Mjw_ZXl zaIJa%n)LEUIoIAn?_lP%v&zQnE2AdAct8a1kr(N;?4hw;8VG5w3vvw%B#ZjJq0CNG=*K7JN3J7dsrHDcVakH-Z#HBKd z>+Vb(Wrktb{@9lMOGR+#Kmje9>Js8-9*~%~Nt8u)A^8Id%%*QT$K!JMX)pX9KoJlY z`S>)<`&3j48P#ddf~BNf>6#4t;BTg=}I zm+M54kd-@$jA;3>4Xd~0UffuVrpy()(dnZ9K)U8y;(Eipmh|zu5~zF)C{c&9nvolq zdD@bz9vkWho15BPHU|x*@`+4h?(h&&zTB@#;N2r*DeG<~$otZB%4wtjJ)L9xg0EiV z(d^)SZmY(2I3T0b6VLOIxagjWIb!x_fW2MU3#X+B(+K=!vynjailt4UzM) z!KJOHkjYG2bMXr+J?%RI0uGg9j0%K3Pa>U4%k(5%H(!S+2WpwP$zvCSeUu_MIriZ7 zN7UIyQ7vu3`4#=0iLxlN<(MkRzB4Ulxy5%i#avSvu%qN5Q6#C^(6vRvW4Zc}6I)Ly z0Ts8yrDC9$a_^DB9S*hGV5J3TeZM3yLw?#ziT3q^{NH2g27kaIYgnZ}CwULrf1z5e ztBtU*_#W&FCrNVIvOmbdb~_!{)?}`S;$iY{9wiXYgSe29Jzbkrk~uFPA=U=Vn|s&W z89tB7D^0POQ-zTDv77dyRNxPE*wujG8Y-tkTim$XBT?!eVi@@U3==;w5Gt@$12-)K}T9 zb8X=2GcIlu4TZU1PKhd*u~jFav8+2;{VW1?Nu8F{@(K&RJqDlQo5w#s1o&l{j>}7P zt1QjhjtqWdm){!9_*j0HVz;m&y}NYF8B((>QR7z&0h~jvX6s-8(^Y%yvM|7P>C;}m zz_^);YHnd{qvL}Af)<9byL@zAP~BK%PEfI(mFW5nYQPr&xlH*xEA^6qVdZTY1VL%d zDllVI_D%3lv%y;>)`wZTV-D;c4=cXTcN;g4^$N|d(~n2Hl3>vnIPL~|cIyOa)Q(YQ zk3ZJyw}&mMk1h>64K5!*33FDenZnJH{d)bB;;B54j(1+03|)A`hZd|(EFTO)1p~l- zpPr#?qjwU7urAr`9`+QXYcU-uj`j}K89fXOA!{&}!@C-0@<#K1wVdm8>#2Z0;Z zZyQ#y?SvngV+k#6{igimWThQH?OLyVy=huxB39c$iRw6ZqP4Dm-VP;hVIGZqw!FNn zoez@91@9x@bS>MEI^~1zkJg?4Ve5$HiXdcL9w@$h9HG71?a6>r_Rd6Kjc~edQJ6&e zS9FI)$Qlbio(V-tJv+|g(!ch@BmH)Gw5v-!oGxeu;4Q1I&70rLv^mqSq5cu!`vJM~ z=X|2_H1_wTdU;Z#H>f;A4#wsK!=(4@xkstWyNlP(U;E?1B1iV}H#WP=P?93w?OwX= z-t&Ktj6!W;8sroe8${(A&Zo>Dyos1~xywJn84P^IWoLgdiU&|AcUL|$NK2Mz^%nb< zgo1nD{rq|48cI{=2$3=PaiQQ=2WjngRCp~93-^P;*BFtRndxC+K0rl3HD50I?t5hD zeyJjR=ogRUH0bvB1Cse`?x-1rkXRs{T%)n;G5^YG;g=z=Q4<}`@TuJF2bK9-vlGb? zKJggO&2)&bGXgtzhp6m|y2NEGkOKQYIXH{XZtpsnLNjcq2ih*bAX`2Lk)hOL*UgKx zn%6<(CscG30S?uZWT`3XL!16>Yv;M8!?{oOg!Rx^bwxv~)7Me-Yc+6uDJnY&$2lil(559! zaVtnAV3C4;5@Lfqh2iuyL6YJu=91<6C_YaCMOZ+q)^uXB&@L{{C%009hQoZxv_Vqa ztoQCNp+7#(De=~|^_6oUF{HMEmsdQ&XI*V^nI`21vlqz72p3-R((#Pj)5{Lly4W-R zuuY~rCmN~7b0aKnzLLa;_b7a?h<~n`(iu#|EEX6y5vO{x20j{MIL~l`uQb~jk<3!S zWUIp zu{-asG(j+=AK$F9r}1Qq90_2rxmOR^O5_@2sHmSLt-M=e0z+E~$DyadecAD2ka%*_uZ8tj=k z0$@y@H8k3==+z`jQDHq2%zBeGZ?pLDI|%b59^4~o5g`{_zkE~fRz6Wtn|9Lz2j7e8 zu&g(7zo=5*vvAEVM(SThE-tO;cRh@F1gXYRnhpMv#dPFF23`wPFc_OMuRN>JdD?3j=1 zqESP`s!eF_=gO$D&{R^^VC4`&h}Tbp6E~5zwi#m~u`zP*I}HKbZ;wN7Q?Ci)E*smd zMf|6~eR>3Ov+Xh*s~qd*O*AF4E-+w>ttA<^IWYk!zGc2Vx+sf~lCs1prp7(B-e;WZ z0_6V?30gc=iRNZa>ja3ois%^<>?Y9`V?Oc;4&)3|%S^aQKn#2(vhPACPp_I3WRj{{ z8QU>SE*!<7H~Z#cyWLV6DLH#yD;>69qj#XBui@ZZGu3$ZR6W?JqAg(vB(0`o61EA$u)#(mWDNq4+Xw(Qx5HkMn0*|Xf9w6_Po6b@S+-ncy>mt*?ju)^)AxPU~ z%*sD9acEai8h0n<;iQ?g`thkwv#}OQx$R{$VjpRknad~a6yM)gq$W<5xN^6`x+WdG zArBLGwOUh9S&(#*-! zBy-OYo5S7t%6T(6XbuzM-c=(;Tuw}z``VlT;<%ByNnn?!RZk()WB&6z9uDa18w%vk z6|tbgK70K-rY7BYO+!T)Q8A9vNYg;79Kc&eERja~b;cQ=kWHGaSk(f)zbGU7T~Acp zyCWrkDR?xmc!sHq61#e2OuO?C+HtOFq)z7biTs#-tOrQS|1@*fykS zI`*~-bM?A>zdLschtn=C>)xpK{xS%8>Q6{B9V94_u6Ash^Bvp3Z2Ybna$lN=^^y?r zhqz3BU-`I1^4c)YPhxBj(wOd5**#NNgI}&Eq&XD+lvr;{m4k@J>PA34hVuib549;| zP9)=)goM@(b{%2#G}14=$x4LoR{N?BPj*ly?2~>Msts)68-IQjA}Da|a%90$DOqBc zmbX3$P9^FfK^y0m{80kbZs_AxghJ?$J$dLk3#YX~H>?PVd$aTb0;%<*QN;$M!exi9 zA?s4;h|O+75T{}x#<^{)DD*7+6e z4`~XwyO20+J5Sa;?uVjyC|G9#GYw9_W z*DN8i=PJpQQLeXV-E{*l5OV4sctwU5Z|}?{ACHK3sC2!3rJ}2*nTcBWR8KTKURvxn~xk9;}|gBWongkgI;DTi;}cZ34XUY~j{ zCBx2)&c<9C57fGt#j@9=WyN5w0SWv|PMv5!+;KBVW*uRV0XM?(#J$LNYu&sZy}}U3 zUQX&4)&zpiQ=kx9aE!>0PgHoIbj2O_!yyQm@s&kKcJ&s}zV~;GT7oh@>LXajF*`l( zXaern;mSWgzSm=#f#jxpx!VFbUwJI-VkvX#7h=JL^UWmbDxJLFGM`=dbzVOX5hj8_ zBI@Z8I_kUIPouEoa-8gFI{hsYo8)4Et7VnuSeHP=eF-*JlTNE&`wtY=p4ti4K~dLp zQG!sN;&j5Ra|$LfJ>^mCkLEhzK{%z@N)7;wcHkkjTZua2(R^ReF6kjqFa+_>kJ-7- zKiVeqRS`mb)7|zkg>B{%Rz$cy7`&V?91R4vMJz*LgZ%lQjB$jI>pfNapLJ}2VPM2S z-|Al1JxTY#qF1e+U{ttg>>|wxbBK9vA54H3qQp#aXH^vs`>ap5w1oPH#@WFZ7g1(}B`@v)1bargWOhr}RDK;}xZ(pBR zI0gJF;d?5RF^!LHd4Jq3(45dW)Ixs7hX?bc6}lT92~Aw?rq!g)hz0>zB6^`>cU)(} z0GOH0wn0Sfk>oafN9bxY00T!iKT5vG_UXOImd z1`7@0{HyU7$Ug;Ic_a#p99jVl9Ex;w1ofiPew~fsdo}5+BE}n{a;y^7yvFS*iuzpX zla2jDD^MLFiBHsU9{NGHEGS>`q$Ws6sz+KihQ^O)2?*z-zE?A?^J+F<$y5u?Mi`W$L0Ltc`rpzAM0QF%vUM`Sx?+bD64r(Voo-AnF8i5g-FxO?J$U0>JVln>CeE4Z-*eu z?vROtV`eY4eXBf|fih2yZsmCp=+^b33Fh>j<#%C!cVO0C$VCGg(4{0!4&m<-fJJoS zF78};1D(}?p7Y77BP0LTSlO}r#hz~%S`Rq^`%Z6fdLd*BQA7KUgkV=e4@)#G`MqCZ zv-&%)U-NO4tB?R{sSCZ zc1c_)bB)>caUC!aDokqk=q?P8jxO*B{JuPR{3_)b+Cev_&tqL@u}Yi+vi{W08r_gl z=gOml`or}R>+p+>U5L~EcvNeC54mp1^fGwLgQZ;nd}->i8Z5_PGW-xHn(u1k2|#1L zcIda6Q>lRV?`{_39g$l-+oI>|!dB4fDH z`j}Is9|G}$P1vW*cApHi3A`^{=(PS{Kf6NXv7XtYgP#467ao~=L^|dSwYEbcUEFL* zpaf^+Ubb}MwZZjAo3(|n=r*U1>u-N74;O3Wy37+-tgt*3y(F|LEc%%=2lTLrj!Jpg zI-nrKL@0gy4HRUY;9&jPP(be##HrH*MJm>Z1wUQ(N}V-@Kq9m{?l&2pG z43%iwnwwHCjAp5F$erghzEhs9ySC3Q8FILcXVlUp;w+}%t0j-i&DG;MdTs8|i_3hbg>Ks2B(1mo{3_|Qfl3!eHyyvVym@jdzWpc=iW=frx_xrvq_K`?coICR&V5Ii&N$ z+!#2yTQ~U-MV0vujNxS1d3t=h*(<_8LGH&Ok`_U+aA2aYcVh{;W;+29s@ zsudJJ;0IzaHRe*Y84uUvV74AQc5K;*Jf~P1PURC6cbFd~$GpINzih*G5!e{4Tur(2H}P+3Lv z#rNL0i;Dw;0{;7}t}}IA1Qq8wO5T> z%>KrlgNKEovM7N^k0ndN4tPJ2uy=LKe?XiMXEe;G+l!fWru#!jk2Q7Pjm&}RumS>@ zNo}#jgk6d6hWA{;O}Y;p=)^!rRl8c8@`)=!=aozh@bIDa{N5Y$u1={Q^9`3y)BzRj zIWuUB%Ml(1(McTx(MX7+=Y|B+qvqDt$Cn@EfAy9IUbX)Y0bm;D$vvX?H%A`#&5-M@ z^`jxWghQWAvh(QORZQxBKMy^(CN}n3_XtxAGk(?`-@9<_a!>2+(;o{~wb8vLLZ7@M zl8d*w1V40u6#YR=(X(KyvkRpv`_lvM_wFiO*~m_wqIE4v^Th7(1cIQJJ-mlQOAolM=I2^!;7e-u?}6 znJ{oJ8jgI5)LLQ$#VQ8rG-?{u#ldariJeWuB=NVe<6e1TEa`l}curCM{F5G`VNrv^ z*xi!Rr_b)Kt+$Y4ShK-O_OJCBX$s* zxK7_fy=yB0;5o(2?mZVKzUE&w(Eu(!WX z_TTD`PXMo`CzK>#nQz^ZT&~=__HZ8n3el5@NR9PW^2fry*qanh<|yBqs8JQCB;_;n zhmg){^$|X0(gD!@8$tE*n8FdCk)uv+DvTFh-|GzWV3xc1QY5_vR3b@b^eSl0&4;6f z(Wn%2Lmjni#bRp59p7>nggBvxSegT%^{O|h1T&+UDuPGEKQSv*swDR za{$;b(%HXPEp7w8!dEqmP!M3V5+hDtprGAZzNQm7kudH>IO$7-_G1WvoW3ZI&wS&D zF<1@T1dD7clC?3kv2S&VL z1kQd9`7k#g51_Bl!D3w}4~^GWpQOGz`r3nM{QPV^lu1E4=&a8`c3m(i&|$25(<02< zj(pmREF1MAF#sOL%3rl3AZVk}3V~bvP-=mo=Wh8fZpn4$L~zr2*U8ZpS%>}QUhSAt zQ)T~Q;Yah#lYT}+HOeA7t7G#mN+w#r93x^}LegNVJ@N1a#fPxuPK%IZJBb!bdwKct zEFZ8mVATFUo)jq^=_?l`!nD7VIOP5X~s+Jt_}u^LA{xHfryoaF^sGvRpQ>I+}eWhaUZZ-40aP z0DdD$Ts~v}Uoq0y_D!IZUV~%G7cw3$HBrCxmSmZ8yuL_KI8eTKFvia>j!Yd++6J)O zfL^(1D5{BLKD_^qGn%~mjI>ueo|)osZZiG>e$8Yu%%;kyYf4zWAsx<<+8^O%-1yn1 zTVi;>#Vz)L1rJf`cxOY%yBc=D7r<}zjDWM4`;n}x+O|28R;})O#Qlxw{v9pe>{)Jh z^C%%TZM%8E8LoGm+VQ-XShu&3Q2+bT4FnO9pkJ136&WngY8yaKc(QSQ>=H>`j4A3x zsyau_UE4BNM66Cn+)14Gh}8rf93{keMAxT%EQ$$jkoH)m!CtYLUYm=fszItGK2%H0;-{ z9SN^!{VLiuwWI8=&^c;I`wy!m)u?`73xWIeH@PwZ={M*cua6e;6%qO2hRs1XS)UUW zqEf>|dvh@W-8sNLdbAc10c|&b2!NSig*+G*Hx%)Ii~@a-;BA3W(|1qjPAb_fy_Ko&Tt?pi}%W{%oa?8l^f$&?hx)qSE3*+ety*M zE5}opFE52X zYP8;kR&*pM4h=yAu27pqNU zd5o`62*A>P1&aUsjFK}n(eT(fpNOJt4Br)&!n$(8mK!5jW@y=6(^WJ7zF5zKMg#D$ z{27uWA8Wpi5YMAoEfc^e`1rx{2=QJIT}vWb@8`EPR+@>M&!tkmk#J6RPcG4fF2guP z_}YIK&2aaTo)Vocv3-l_K|Fs*8j5%`Sg!!nQa5AN`oS1}czW1u(?{Oe>rJ?78&}Vp z?RD%R0YmkIZ^18wE#*KW+`vGval~Gbi?#X;LQXW zoAMuzu09Dei|q^6fWx}&}jE+J?K7I4(>Z7_M+ zHLjs{UjL{F8H!Iw-Wz7>R(ZBX0vmtSZp`5MZcU8QlI8`@PZpeCw!L=yHr3?coR-Tp zegwmUVbTpWq=>pEIoX)Qyy!ML*)=(`aLK3V8}N27LwkI|g=Rx-D}dA?YT@a=dEX9x zOJwm#x4}JpDW33*NAGyD^kkZT;7Y(t*aspgZO-JUEmffGS!48R=nbxto?B zpbPxGq3gylLZP+2>b)a<_sVn^`wjo7SfnAvuYeSe1}v=+TWN%mA4*rbGhFzKiTo~w z$90vqOYqZXg6ZOMnJ}}%=@7~MtSsNF1!^Vb@%EGbN_fE~sRM_56v3Ji|CPcT zKPwxR8p4YJ;{VH5GgM|7ugfJ{Kh>{fc*fLlv{xx`g1{BAwBMnU z6fk_0n-vVaKKm`$2KiVi5@%$(I!es$^V5Q3FEZ~c>mckfl%9_+6A7Yq3 z8s-_gGV%7hDvKm0ncIjEh6<_Qz(0P*z$m0O*VIoS%GtLxO}9TlL#8KkEU`;O>Jn;bjNPR&Pc%hw<$|CF zH4cH1v=wb7ie=7C&Qn8a)?<~aIC`W>#ZNfz?R;j0>I$=pjoeSP3d-~oHtvyGA7j(L zd|^D-jJM*_Z=ie6d|xx?SYDw~RI@l$9|i4jOX@{^q!QRqTr(bi=Gj_h{Fs#IE>XYY z`)kcXp%vWbJ+Sk3I=f-DF7sVWw{TnYvjx86<&lxkGFq8`&(t84e6D+1@on|jy!U2T zN$)>cE-#)t%`VaWbh0#lL{eIRu-J&J@QhDct77>}h0@t=obq`hgDmduohr)jo?mUZ z5V};DGb~NAW=ZuOI@ou#UHDb;v2Xo(L#DJu*6SyShoFR#%dA-*CTfq3^D3i|wI*9R zAPHp)?VMXIWHteFNV^1~2+Zey3yW!hSwY;|@sp8sF+>3YZ-a2&wcq#qiss4>Cp<|C zN~Uzgk1ggaz{NS;>}ONP_nbc&N2_+=Ki&c>isnA_hQ%wTX!O=0C@J1-b+#hCdT)Rs|gX>5ha4cmE76 z15)mUunaLT1z48QE{QAdKhaiQih{4FlTbD;-kq+^#8e*i2y==4*FCGz_{ah1%z-<- z{gV@gJh8C1Mb=7^lC_wx4yJmLtyE{fdaotWUy6iR&r7Im?(e(c4L8b|>E$`u9Z-Zf zp@B1=imL%XXdq&??Cofud0wArlZe(MeV9C7diF{%PB_>I}FxQg`^DNf3q2n+A zv?|jfh>*6Vh+ZCQj=xC(gyPqe}pBy;8t*>xs<=72no=X0n7 zg&bp}j09a%td~U{)oK-Jq^v?;?1}?p;FRrzI@Tll7KJj(-cc1~P|`^O?YZIP6t(%p zl)YuuK+dYbSqq*(9YSfU$A1y}y7y)XaPHg|*H!S3SeNal>64Pn?Dsm8KYS=GeRY>W zNR;?eN{Ti?>PO{@}qxga45{ zO{g@$O_w-&kbeL3y6PZ?cDE6-viI-x1m;Ht`W$@plceFcI4#tgMoF{DFuRjKv)E3a zJNyy{+;<=rtMiy9W*_vwGvfZdA5wf2G&145*5x7LU*e;9Bm50Gy&`?T&H}0$374=3M+C(e`_l1p6@wmdnA6&VrFHg01N{WNDb>+b2NSrf~oNM`&M9xwEByiu4EBIra zKgtCMl+PU^ofwQ-zIu;OD{iXAq%2m>qQh^i!PGdk)i^{*BFU{wS2%VTwi^^1lA9V9G05n^`)0d;^Hk2lQ}QD6ITLQtN)Aq6 zSR7J2^EP^w zje!GPuK*{(0GXOWhD}R%FH$>&SE;1*B@1cuuS`_7VVuv$lRLf(zThT@(ciBjjgtkV zyKO{DUPJekJhE1ar&}LBSB?G%?6r*EtpGs8CRTjEJ(6u%{4b05Nwx!^7Gi+K{cdX7CIWo8`Ca*D*n5*RH zMhhNu(kst0)c*1IDq*sEboS96Jp-biYrdX6CRe*{HDl@nmV3r;9t9T23)z;!5l`pfYmQ|Z6UE=Ce+s5Ya$hM1=RPF2YpDV!bb+_&I!gapI?&Fj}ywFxI z>N4=*gjj6I@DhG2;$tyYLxlGpi0bl^uxpyL9)`8-mR(h6OWNgT(-m`)QpJt`n}pBE z?inVn?&yZoT#kuJ(VZ6gU^Jgf5RE*G7l;x0A~D~FUhWY=P;_XbqsLi)_RamSknJy` zW8gCPbD7?nGJs)65&`qnoaiA%!z`}>Mq}E;DxhotEVBynue4_o4H4v>qixp}9aRH% z^II>P5C=xV>XyKs?tJ&C7Z3ZzT1|R5%(LF9D`cLi_&l8Z-Xb`=16rC6z_pxSXFRX8 ztdrgW1nIuSGMkL*o=zSxE>3!!Dj!pLQtYzWVd6KZg!A1E7Fb_1ZMz9Mwun8L;5waf zoIuT2#nW5m6c-RnB)580Uz~kGs+R_C^~cEr<1aZ&Y70Vj9P0jT8uQ?UqKl=5g+I|q z>TymrIjh=Ra4P=Yi}6wQQ{DsX+57^7`KAz~fBE2T^SYqa<*_p(($0o3&VN~fE33cF ztk5v+6t>lO&(79^pJ4+Du}Q=V)oBi$VIty~o)C6bDG5tUVFF1~?eomR9!1&J(epj# zC82PZhu{Mx;|4PoP%l1wQHj0A-9-7A7?tJ!lOraZ%Rf{D>y!i%pA4+|g@(k8i`oZb9Bn0sxPCqL`!>Enrx0WcO{0Xd|p^KVVjwvfw} zM5QF-eBY!T!%nTaQ3AJMwEZM5070K|{WXLKk8Fnm@FdiYneRp(S>D^no%5*QhsCZ) zoaDn74qBq|iW+HcgAaL@U{Km2;U(X?)yqSHwZ@=GaHZrOCgLRkfn(LGd1a+O<+$<{ znHL{kNZ=fSc|M?V+bPC<43pU5(&WK^J4MFM>)oIU+4eEJP6yV%n69D)rbeUKHwI16 z7TK`X@|lvwQR`-dY>&yOw#uWIQFk8={WCv+p5Q_vahXA(-4H6TXFzxn2nVfg9N3s% z`k8Bl_sN|j-l0b7g(W5!%!#}Azx<;3cJm^5)b4We{r`@&y#oV=f{78%=A-$;-KL2m zXKCac!YfoSE%~+2!AhPDqXgu_!+ExUlsHM~#v&wTpB?m7-JtE(gJ$Tm4Qo5W+I_y7 zW1`a3vfa*MNUJU0cTdqWf~<(0I58KlOMv{<`|`+|>@MFSvAb$5bf@m;dGqF8h1%2m z_Yv8T@V`1t)ZoGFdQK2V(O1zD*Rs$9(H*0VVoTtEF=7JADsXfXgh8QO4v#Ke^40eb zB8gWa)JX?-JXx^;0Ww=8i&|l73W@Cd;-yC7h19i>VVyD><^wbbo%XG|l5|bvH2>vk zg!MxIn6CBk;#fh#^P@}Oq+h$Lj7Sls`g{uCB%7uD{1FABz42(y*O)#Q867(2$!R{V z`L26FBR^aM9=U~58uStmNco*s4AwfgvMJdw<})ow-~)eS_kRW}qNr!nVBhjk z-teX;OXYX|D7hvdl^Pbn&fg=h_4bv8g!On%Q#UJ%ZGC6|B_!eTZ?cySgEF3!D4h@( z-e&k`%X53z!|RiqwdYK)uI2nRAFkheXk$A!pvHdSB7xf�=vhI@sm?DBh=7c$t=B4ORUp5 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

Bv=&i-c|8hFe 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
    ox zC-h4y!c1lcDoX16I(C4`f~uF=_2NXNQx^+Q`Wn&u?DcQiJWZ*hiF&7}4hcvt#<^tW~%RqldG!wO~!_MMEnarla?yr)g>5Pp*YS?y5fjo;3*V ziX=wfwZHzksB~juJU%31N%Bz|E0xAmE%}bV1&!5(!C~DlZFzKK-Om)M$u2E-NeT|` zC>Pcec~Gl+iFuIgQ_SXUMAtHnLv8t!z`gcj)%f^VS;A zh4G6f@dlyMq0G&#uEZ93c^F2LyWS^*IhH$@);B8(PG%PfEu7?k=>?>x1Lt}$n6LJ) zV@NNL155`QtSY;@z7B!xNXVt$1V1xnC>zyu2}$3)txK zMNuh?*A`rM-vL;JMitFaa&owhhvWDrYKc@hP~qK&*KgdacZMIW zU1w?<9>Zt~UvYLM0T?maBWlZ@EiT*vK+n9$`ERoX@puZTUL<`sJ}M_#1qrm-O$=kfB7r1wdG`vNZ&H>gt@O-K2#3Kt%oe zvKk0HR;zA}--)8U673khV%wy2x}AFT#?U&U|GKnxT?k->`c*yH+0!?FGNqg;ei9O6 zKd|q8PVG$Zm`Cmj3i?^!c8C?AQC3;LMZ2drcUBjZeY5C{$>l03xH*k$LO{BO1}-Qg zJcq3?uz;Mge8k~yT~4G*NJt25LXX&&`}EB#9pppxHr)Klsv zjC=iY3DMS+^f*Hcew>cBlOd6lvndz;7Xz)><_gTO67WTy)PB`=FkPUWhB;nOjr(6`=8Wn^Kn8KaDJ{tQ`w* zoYlMm7Ao)avP^;bB+~@LcGb@t(`hB^Upa~9m!di_aNkrARgn>^?-pZ_asqr#P8f*6 zC*Ps~NtyKTAXc_X0dI()*&l$zn9q-jQT4As->=f7!cak~&i$@Br?hcg8ZyGNYn>%0&k2216_%<@a|tI*U8c9h0OB5=~~wF59&` zrWmz!cgS>r=J|laDc~u%_r4obUe;<dhIVavOk2k z0qzOLd>O@??=_fk6`3-T3z*94L`q9{`bh6Y^S3k!zIsWYS8DxG{|wT2vG!$vdCt+1 z-ijt$WcvIB)jMs zdH%P{`%5|hKMq#sFE|x9^~^tm2)qn=ASN4`6wjOC24KHDk7q2p8x~*{;j$d}!A!^N zz87RE>-UE$+YLk6UXB5MXFhm10a+_zc^C#wu<}?zqL~)ZeS(4O1Uwkgq;Zg;CPchZ z(8mP4#SCbyWPwG+y3=c;^3R9-zr3UU2U5lGPe09eV%T3H>Fs!o-j%P7cOA>muPsp> zbO}E&F~yh-E2U6 zxEUC@@Xo{30H3D%A{WZ^00;q9Ne*Tp6!BbK8(9BQl>E;v{GX4;US?AWkp8-@{;ScB z7w^Rd11A{-`{Bbxh3WD2&ac`sIcqPPh*0*35akgf>V3Mx&!u4l=%yVt(Q4uN5|||4 zG+aG-w~-$Gtecy1Ijei$O~EYw$SSS*0Nmtqk0c5MdRp@mK=R#kdH{=#oukhIR52!cM$g+UnLaq)YN)Du)~$EUd2&Er z;l7!`Trt1?V90)32%Mi~yCJRKF#?9hJ<(yol)z06-tD!X|6iW`pTX5X{vL@8e5uVh zI7$CpW*~`|>x?Av=8Fgw8Qw!w@|ZaHA|aRkQ1rPpgnNn5S1aL6JXU44JDb&PxfKGH zKRz8&ND)Qx3WEJ(VyV8`qbe|ENuhb&SHX0PrW#+h`UkcO``Z6ga&ig_fGe$+j-dqt zJ%cSGeSDD@?taz*+3a6c1OHE7!uf@2Ybjj(&!1k!da166DEETlLW5vI6BeaMJ5#NM zi64(%&2l!Q1EWSn2i@EcjoYq(Q*@?XhGtH_c6a;f&f=!V&3&r;c?ot!O*+v*HEwU4 z28QwOOmdBfmMSuorj>)kI1F4g&Wm856D{gXdO}?o68ZsjkN!VjUjD#2zZvzPfg%p~ z+7$($Wyvd!9j{s6d@}nqvg?G#P>XC~L6EOi#|B6Z1Xp_emYtu~(%VUm1clV!B*E}F zB2Y*_`%ZDxg|R4~XXk6rfB95xe3O)DI2>341trmT-J5C8J(Fw`-UL>Tb@8tN8P#Km|5=y+&VAlL_yJdSD50Jvpg-ouNlU=J ztnxX{2VlkisXuntY|k+T41@UrzE%p^-_cmv6lBxkgRT2s6q7fO8I}JwA@k1w{ntBx zXfrkc^Kx0)y?@YwBk%8LY)_r)1xzaD_h?-?PkMbmd`z>o(kAL8?Ode-z$+Bp!WFidkqo)^C2F*ctW+mxnAlh##~?B zGQm{)u}wBH;jPSb+I8f6z;vh~jg_O3~pT|;>`J*p>HbXh7gHZ~BYg8m#s^Ytiy3VQGLm&wG# zRK#6pTzc-*{NeJhUm{xfx=WwS_>)wC5<>W;B!bFwO~X!M_JI2q=L4L*Ce&WPfsOue z$@_n`Z}0*%NQh;a8M4)bgV4NG7tr+zVd3soFCrz?m*Dt#CsQPa^j7{o=DzaRQPbQ= z4^3!Eb@a-Upd<4eEdqT%`hqS=+puMYmIxK8up@rV(hMEyc=5!LbLdP_+b z{~U%qF;SxlVa6r1o3UzkBUcXxu*WkDBWRxJn@<5}J=41bz`Fn_Y?K!|e*W*F@V5l$ zCG}DVDKx*Yw58B7VzgMy+8N6zFnAmvuZU;ar*1+;XGSpg>v&96xCZ9I(fy`LCthub z84pf*P=aOU{=%t~6$D~(44Uu@9a@y|`wX=v#YZ0!>BF1BH|L-4R$U}(4I4TW!%4uv zR*eE-e0%#j9~Ow=V#HO}tC#zDKLJTY~tM(_S^+*{!d^a<&D zGU~6@?k)!`*%}UOE9VZI|Hga`iR8={QjRT=o-;ZNAt1Tbvdjd6S zF>3G$#+491P=t$k<3$m`nTe&kFW>_Oz=4GXEAhXh7d#HRsG-hyoPoI}Hz3ueGkj|P z%fZ64H9^sN4VO1LP@iUzy9JpsX&aYXm*78}nHM%BgnujSb?{~A%uq9aM8D7|7Ofun z%f}#S2>im2T~QekM!AWpG2UVe+p7+Z?kT?%@mOub|G0TqVlOv;5mO{ShO_@Ph~h32 zSci$f1%-NyIMKU%$uV{THYu3%0pRKon1=t^Cs6yPYznn4RC@nL21%68Mg|HPE&_VA zsMZZ9J&->nYtvU@7S#d6NFi!43ZWGxn8D+iVV3VD;F`jgYW0Yln>i(s%JuF&njdF$ zqkhx$lb`f^5$tg6=tz+qO5@}LJvn)K@!p8KGFF!g=VH zJNwBYY9@ht0i0{`pgBS{vtH5+>zxH=x_ggNtIm)WCB8F!Lp6jR?sLBM@~gh--*iXI zP#-F@;c4%YZCcMnGMTMMRY?&FSI}EbR?2p%gs}EG>mErvNSIbM6l5bU?bvW!>RCxy zn5acsvkaque5!}RKJ)we$EK71l4ZE?BqMo)h#3yUw&g11(+ygl2@tx1>1WtB=TrPl zH)I;6_>3JbhwnUEtWc;U%&q%tY~=p9@9!gkt?0ewD72!4ohEl!{yye+`%lNmQtr)z?F&uS^OwU(-}^x;?hYW=lp?M#YAH%u&Idx5N8R5`%Tp$Q+y2MTlEGE@1pP9k*VKv3-*q-Uh}lU znJ~@Grf>k1A;s>&N$BZ9|9p1}a$snC3x_Vyo}6s?!!!b&F5>S&<*DewOHQUO{2B{! zlMk($TnbWy&he^AszHBa1CjtyB-vGr7ww(FrNEHAZ9W-e_NCII2#|ib?2gILL`Cb* zQ9^+0odY81UYW> z>X;b))Y;V!yI3=O80^y$-_i_oZ!(BnTNC(SS#u0yij1o#^jxdEefviIgO;)eAD_z*`XYDMr9-60Bd7exqp4h*H^I@42IVV@&f$c2 zGa8}YCDnHCcTr}~jx2UmDj-zv?lUq`MDLm!I)&W641k0$dNfLTnXoE88g$W;Y_9WK9MR&lGr5Ye?J-ZeO*r=T z{ykpHuhNps^vqEd=kQIi$i~B|S{!BX&ZSFc@%+Og$Y(~NZvC|DH~1R`IY;LQ+u{uW z`q|%&Y9W_#E!V0tqNDBD70ZNWf@@{C;kRZKTIWkX10mNJyowmdwmBLS#P69D4xHIN znmo{WG#X0hp7Gl8h`JJ8kK}4l7paW7KsU@TD0Hn)IN}$wtFJ!6#{qT#FvZWmO?7sn z&GiW}aU*oxdlLZTimC-=*q&dxk5hh<3oL}=Kf`b9@4jL=f#;K`b8 z!w+h#NyIr+n`v`n!BcZ6=GC8a?%D!x6MoxHyJHY(EeNeMj2I83l#F3Y`wJ9X3}k$t zW@99DA0Iw0i!2kXC*+4ASCDyF$oHI=19o18unmex1Ll>a zU+i=gqhIR1pM=f)QEV zMUNpz;f^8CzUBHr0_#HlS6SfF?bp`EqOHRq3KOM{H?QX?RCgUdTpcq6Ffx~F%|nk) z7kR(^>Sh;b^udFi7@IITl=s^kEY-HjYyx&jecX;j^>XQsw>sLbWDh@jU#U`QvM*&TdLOe*IN2Uu)i|#b-i!G6O2n*V9AKofQ&+@ObY*y{XDhcI=!c%+o}G z*@)Z`Ua2pn%{#D|4}@_(OWnTy4eV(ZLSJSV-V^IZr=r1bqdl~QzBA%h5hyLC-nM*jsH}QzrKGty*az0s?sC25Qw5b%YUqdz$>TOL@>zFjcgTGF z)$l;<&+&pR7`Wt~xL0W_voOT#H5Ss5sc>6q+?LWxO=V2ApOr$3<$e}BYXa=(ihH1y zrg_}M6^%xcU^&m?mnU(x`_8#!yCy5|G|$&bk1~`iFP*52BltHNfUk)ENasEJa-C?- zP^{xLihl?F{#=DQ4(^@!v)Wjd@a3=J;ER2@ciPuoIqb*`_WF#b}ozSgX9bIx%iAZ?h zBQ&33d_B5=Q7cgy8Q-EJ>o+(WeBJ>8n3^sQd`R?fD?N>)>5+dkf^bA5;2R0hC7r?f znkGLCPX6XPtx%g#J_;|z_@Q8{b_;!jOW-F-W2Pos43JOXTJuN;b40d16mVIEC(Ng`8t3iT+ogC z9F*oQZtOo12)MPSU5m5loCy?^?zgoeA5PVyP8D?K|CbDn$8`n3 zCKzYg>A+2cw@lF0Sek#k--F|iFTFf}4*-1izzpq)5pr_Rgps&}eSL8R@X!#|L*^ zVad}vh?Ux7waJD9nA@#0zpZ4GwrPvC5ebAtB5lDUTq>moM-pH@q32a<$+Y-_D?aYV zWL3sd5R|-wbk=RN_~LX$vib8e9E%+~b~1U<(##w=vfGqbs<&xRamjynA7*YWH!^9gA{G}aWLK03aaHy3A1z^ zehsiNgzmb&VqQBuiR;H@CDAG>bVPTIrJ%HITm|?kos3iz9E*V+I0z}1mK{*2Id$0KhkqO zCoJRS@UBHXCRrV9dMt(p2_{VZCYrN1S<#ZICYpWjcsQkk9ws|_lnF*zj<1y*4h}+x zwxgLLAkY50oQ)r_hVV(KKV~t1%|7#7$Wda%}kfJ~yl%Gkn71 zF0eG!@sO!4!Nvmx0)4Kq03S2C8ufzs<|rmE&@YUZOP92Zi-42U861ZpHBKqFa=K+< z{Fy904;g?lH#&gB0@T;ZB!GjtXYg)D`S0qz}6d?|Unt2@2 zJTzDPM~}mnVpSEhuPfN39v$q)`ti}~o(_6`MM;UbmFo2ed=__8+WTl1vO4^3Or2~; z-{~pQjsRSw)mb|8RT6|?dtc__Ys}WAY@L>Ocyh8tvy_Md$bo1#VSXP0mqm|Bl$K2A z^{Few^^2=@994LF(AS>jCub&%pj~X?IO1df?fvO782D(opPe_2v&YcU*qlT8A4GgLlPit6`W)1_in9mw_XQ1m!BYCY+}07zHe~l)>Sel&;>|PpNR3c2 z%7%Ctab9B2cyU@G`D>^;UwGbU=O#*{zP&utr0;Dcj>bG*I%}Ol91XD_yrk~PQ>1iT z`lu+wskpeZvN;cDItt({M`W4+9)%ayK6uzml&#J(Tscwo;bbWGI@0;m;CSrM%Riu= zXrh;{NBVGWRt^&W9g54PNm;^pj)WY)VmX4Cm>(%sxuUH07oJ-Oh%LHgvnj9Tr6q+8 zKHk}d_T*7=V&cqg7SB%hL`lWJZ%zHOR`y1%+=0B(ffJ1qu0JC-JtGMI!7VLXUG9trN*!dXAL0)GnFejtm`nV<&6m@1m z?t@U{pHi$(6X8cR==>%z)&0_mt_5V_xvPAxW&h3casfakiu&0S1yNDLrIj&wZXDNg zc5m?x76yY~gC=d`>&#yCpPNf^u^H2V@_wtTQWzL7p~(~FdkqB@yTZ~_=U0O`6G9Jr zpWIM$o#)yG`G9={(0@l7=vedZ0GCCy3^rno0#U|$1hB#$*w46a@?^`Bkj zflz%r@!S{xeC!E&6#s>4kM?qYBE!F;k}1)eZEZ-cux{geCZeNV%9wdD z>6%}+dpbbdd&cPeQP?RUP|n(-0UJ&PHrm_{fuhBwl$dbZaJou+o~nLlEZd8jwvtyu zaqb#|wjcE&6kaCU;mXC{)}eQ1q(reJ8U%;%w6TK6j{``4neEx7smhcZ-mOJNUJF}dWrOAiTOI1oSxMjZ!G$4ya;Rnx;af=Aj(aQ zMjlp#LshQg&p|SQ9nC@t-xG4UUWw8+V;aw0@LlYl)@#->@^yrajs%p+sMIXaBc5BG zUGSL9GssuD2ylK>G|l=R4+@FE;I#ZAMarHY;Dh%i{?GjdfB_5?2Ka8)23h1FLt9u4 zWGLwgY5;mTl_f$F0Z=W6>+oq8ffbV^en@Hx4g z6|2C^FA)ZhjWy=06n&`dmdn^4(dcLkkk(zOZL>P$kq75; zeUwjD;i-jnbrxEAzp3go7hu61B2Kdiq{o&>q2P(r-L$WB!C`&ol5x47T11voW-3Fgrm+5 zn|kqmYwhsrwzBYnYwWLmYF0M}gq4yfN)f`^k@&0L^PNR0SNgD>`)Y#}bB=2Md+8Fn zHfyd$bX!i_4-n4}?vSn?kJO{~3oav9i*4`U?*DfCFji~uqcIuMTK*xmsud8U=~hd2 zSScPb|Ms~x>@B(iG2%4ohQ{fNk_=wUx?kI<^L~n?SuwJn^O@k?*Z`#wO0tg&UqQYm zos?SwqF`?W@wz|9M}pHX7RK=R9jfkku7;}_Z(;Ls!Lv!;aIL$EXivYJr8UpHJ-?^2 zqV9T!7B`1&n78mWoT>m$aEkPvA|+=>TiRym1g{W$fvK&PzzWly(8tZQJz$bmhtK(o6AsZR?_5 zlj)*51;+KVE|dB1r2g0K%sTq!14#nbn`7N&%v*J4`3Ww$tO;iM3?I|z5svYtWKSAd zbJ~hVC?75HIeb@2`*zF|+(2rSsZCVQyKTqAm;`Jd;9LSW7nqFxL4JnJZ?xaXb!Kxf; z0a(i-7$8MVpXmGfkF#duhnow(>aGbxaX7Gsk4=3L)=GpumQ~vJL>5EC$K9my8H$k; z>)_DSc9X5Q1X(}3H6X>&YYy9n{N5I0lb*x~ldbbGhkOgo8}6tHhZ~XHUV7;IJ^Nh! zhhab_|D&+|xFIjHBB;#x`RvIG^Sa@HRMTm@-iGpB(x;>LU9{LBh$gN@So4JyiY?{W zUmqX8Ehtlr8~(T%!p*xidy2X-BXEDrWt;RZ;ZFKwI)`=5Glqkh^esK~rrA@>&4IiA zSnHwnT&8=m-mh?)I!n4GF_Dd&j4ZgaIZe;3g2#Zbvit|jwR&7sg>iRp@5ag-kudb% z{qTiYFwVzca4ZB@rraWaD08SCMU*AQ^%f<52xy5z(%T(>a7R`sabaM$>-XT1yNjAF zQG4Q*47KNm-n|-R{rA3x^)d;;NHs)F1Mvphfp4W1*~ovP^0!Q}O4aa|fEpFJ+>ZZH z?V7)CL}1!rG#gBFva4o<~kk z(R5p(Zg3YkIM*-eBJz1_sc5;i9GFkNBY{xhYs`Mo{fYeLWLGsy=|v^maXH1PdMJ75 z_n=2_a>VC&g_`yk4TtPV-q}D6N0f%Ep7Xf1zDqUxs>^kGUWVT_K{$GzEfA!zlv6iu zNAhONt^3WKgjTC9mC|-MbFsuumdtz zP}biq+P)N&iVzDI@wSH%tMq5A>k)9^tUwdt3x?G12aQ5g@{4Yh9#Jn5gB*-Zc^VB84O~5=Xv6XcUE=($-_j@e6nv|mZY>b3FmJ;zUZUuM9$r>ZKnf*1uA~UJ9gzp&hI*OoF3e_xW;Sq+W)Xt^7a$5^# zi}b-!AeM%K^S{J4Ec`lZ#81ZNO`z>EKUsRkTK;mBx-1@buAxfBB>jT6ZdH{u;Hbws+$G`3Bmu?Jk4W ze5Lwy>X)IP_s=o2H)wk9SX%&Z0ei!*BB&sp8eH#ki!%@uMaIQx`>D4T!x>)&!DB=* z?(^s;fEh>{x)`dp37LI5tVTcjasNW3NaoiF2XmixOCsyzb5S2%dzTV5Ijh|`JbiHy zRp`A9oh;5>+hf0yU4GW3L1b0zM+&Y9OaK?G2uGFldU0>CQpOQV z`;gBwYPxuCTjWhyx;gFn3=IX@TuU7bmRh(mA`K#iNysB3UYDXO&gFhEsiZS317MSa zdF`#9wWuZGv$)dWThkkrc7V`*Com_hTuDeNOZlGDed%X;vDOk>eM7zO&#tmU6$(qu zcIf-qqFo4v_x6zM z8?NI-w0=cvc##G==@E8nFWiQFLoI@i)2@*Z1Tv=K!$d<(qjFp~(~yxhM2iK?iPdEB z!b!G^ib$oiU4${_N#o-$H8&*=_Xv0{PmXkoR2z)8gEF%P<^bilU-92`bD=6A9ADp4 z-{=__aec+U(d5+fbh-0MjQt+|`pKy&s5abUEj&Ld{xoXw#8L z29G1GV8am0{OKZ_afhQk&&A7sT%0`tch<6F-FeW?<|0dev*n>_^!x##U||m!Vkcc6 za$cfoslTW{IZ9R@PR+Vl9Lt+zXyLX)tGzL!Yr%J`eGq^Qi8`@`KeH|1%LWRA2ceeaqvW{k2UgPT;yX*AQGG(Ub&;aU2 zw;HRMWma+iC#yC!8M?oTq?|2mqtO9@+r+om zPnfh@IM!Pb$$rG@U1KOWH#=#;x1IIM)_2)gg4Rp5GvR=>&n|7H>deD-|p8?FLq#N z(eF6FxglMIo@|@-T-pymH%Jq;GmT77@*AwMxY_o>%zURVCvh>?>hLa`vF)8j9^1y+ zt-TEk_p^38x)euFSTlKUBax(&III2en+dNLOx_)?N8!!xv|rlu4o8kN-!A}pSB*GuUfPwzwWrgbS1c33&O z^FP4>RtJj`l-zQf9+V`s*N=+P(Ajam&CPP0^E5~{OX65{l{gk;jk>ydMq#2tsI}R- zAs&9$K3U3~j9M@v`tysj3vF-P#xL*}W5T)+^jVDvGZo~cq#KTgcl zRmiAjcVftQlX+Cq37E$kfBP{$EPQHW{$%0D&6S?>Y?rTy12u`PsICnRWXe9EK+%jq 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�)4= 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

    %Xr*uMZU203=6REF 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%0AF;lKL;?{hGb^dCWO7iP? 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%0Adzm7s7*Yi$K0xmCZ$7tVe*WCPMnevn)eY$EDg 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%0DMECRoFamaMbQ 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

    h!PXp3E4#iGX}M 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

    M-`vX58}jyPshKrv_{>k^b{;(J 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 z≧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

    S|4@f@+7pFiD6! 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 literal 0 HcmV?d00001 diff --git a/noir/noir-repo/docs/static/img/debugger/2-icon.png b/noir/noir-repo/docs/static/img/debugger/2-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..31706670ccbfd99a6323d1f6c66766e0f2a9170d GIT binary patch literal 27014 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 IN*V|MACM4BAOHXW literal 0 HcmV?d00001 diff --git a/noir/noir-repo/docs/static/img/debugger/3-debug-pane.png b/noir/noir-repo/docs/static/img/debugger/3-debug-pane.png new file mode 100644 index 0000000000000000000000000000000000000000..24c112da96f0548d80ae3cddfe1c76493bf79d42 GIT binary patch literal 83927 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

    5yZeNK3Yz@^{;+?$sU`v>e&IW)8R*R}IhYjm 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Ðm%cWWB*}@ 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 z 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

    9}eY&+mwC?=ZXk0qV`9zn%e4CoF}ozA#P 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%0D~?iWdwxpqtquq-$yH* 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

    lsJ7HPq^=;aIb! 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≈yth24x$k!6tt@A# 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 z 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

  1. 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

    8cAejVQ`QHzb# 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ⅈ&#RqgiRR|CJNm^a)u^e37n?9D4frJ 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 zฮLrmvq>->?beW0+DaPrpm3DaWC1yRbi(jDlKbfp2lJAnR9@3uF(xw8aD4tyI zjrkt4+^9TI`?y{n4ly(-dj6S`f%894ZZA)`1<*r*q|fp$jF$%wVzm2ME%Trz^Ajm@ zWAQ6ftpijE!s9@b*s}%yfx)BD6>S{Q7;j0tSJayskC-&BbrwZ!>9{P@t$S{=t-S-o zSwzzxiM!hJ74v@)r7%1ik%y3E@A3Eosuuemrjg_?za=!D6?bwb{bkBL39>6=`NX;z zr<&1(%dzred9mgs7sg|VyWc^Futz2pE-fn!iEvq3hjoqpC_>i%qiIrf3l8-+9jZkv zcVzM~?*M)0>-mj|yU7)8VB^*biOt*2r$@q!2P9beUkeIcfu+q?BGV*_DD$t8gsHSx(u~dKdLaldtdCf#)3|mab_H)Z*W~e=?=te;8D2(MREA<-y zZ6#sfot+vR3gd0pJYvJ1h|$KXhM^IMLTOT;)I=fEWK9@{h~4Lz87(+<>K!(s>z+cg zg0jV@$q@!l(PpQ&l8|o_D+hpsthMdvc$m0f^Zck4SP(c^yxr8XVXfd&lg-?YGi-3% zi+iIlLLB8OnUI=KNQqdED>KCQ~G>o-NLDY5Oq9}A5xHcd1xB`yg%>@PLHoTSEo z(kj@CCYCsIjZV|%$$9BSW3G1kdH$1pM29<}m+gXw#RLhA@goC5MRkd8HS-h_?NVL# zTCMu(T-@hYq=0!P5~;>&LePx?`Q(RBULC1aImJue;drwZhMdj*jwbliQ^Vw>;kZ_c6=-o};L#eeJZyi#(M24- z*5qw>F&Y3_t~5VBw!Xdu_S0LTPFNZ^`4=#;R&)4n)6X)7KPJ}*N;wn}N9C91%Uwq&&_Y@>4cXq~qPcF0U!VPIf63+KFOJ8C5;h)onf z5WbD^dsiJJe$q(FS{$@waw^GkL@4v*3!$Zvz{Oz9fhfvg%ilmJQW)?QLO6A^@qZ47 z0PA{Xva)Ook$`MlpuUSLE%MOBLHs7z(ws2^!4}#>5TC7{9h$Byud6_SjBjCQEjdVr zP#*14&wXyBccI=vj=L?L!Jy-w+GNv-utkGy9i`#GZLRg^#k(Di^VzR7|K>FxB0kAA zUDQj+bx41eb5XZ}<0tl@J*-nj#vXDJ7#f(RY)y4?HpZ#Hak!V;($JE#61wlz)nuNb zSX@2w$7NA2y`RbwnBR;l-T_)fn^bnI+>*253&2D3m{*e1$VnYYo&3_kgcex1>k>vO z1HxdFf~%m(44vG)|41591#X3hK`W@L#s}k0sRCclfdfRu@0_@_x1#X3w;ljNUI<>R zi#k*FF9nk8P{M8(U8T`I_39`Wnoa5rL6g`$FPjit@@)6$5{6&-C5rM-Q^8?V$-q?h zO9v+^Lli=@OBmbu8uy(|)^nfh?eyt3(#n>Om#-x&tc`TcKYuzo@D(Qm&lcjvqyFM( zoD@lM1y60}u#A{^dR7y9R4zsTu@#h?OqPK8)4ZhZHQ|9N)1^94lB)+TmNz z-8p#uOo?2j&)nAW^_l0VIng_Y)Y^b`pJO?a?qr~uJpkO5%THSpKvU^yA zQb>nz(=l^S1Gv*d*{|pEYmi9Vd4rn6{5TP|lv%aw7_R2)9qZLwA{_KCsYy3_FzL|U zL!~n1S8QkFN;z(jwUANOSNj4cv1b-TqXXpAm6{<(1^YZ<>j zQzuuX#IxX}-t2>tYX)XtpN$u}I?Uy|7hBBJklI`t;6w>9XgzFj$m6vJvK@7c?^6wn zqg#$%@{tLY`7l$KWOP+cehkGY;i+*h!hyvOuEmf=Qrj2?ol&`j-0fC0V%|InV81Tx z52Z!r$@fltF-;V&PWV^9HL0Gw>h{KY*aYy>SjRtJ-(9?vUx{pfA-S?juMd4GwN`CSVu=@EJ&Qk`!8S``9%xe#6Yb!n`Q*y4$Qy#;mq zV}UmN52<1MPA6aHx9Gal?Q?m|i;3Pyfj;3_#|O2%0R4%em7m$H&v*{7Yibi(qEyTP~NY{=AaPKt4A3&Naim83C-v9VC}*YC&}Ddxgp?y)2Xj@zSeINT}l_07>u zt(E}fOZMGWirg{*}C-D&xQ18YEdD_5L&7b0<@$(5+@5gOi;!dOEY}V5NPgWVpz=l1hGR zx;t<1beFqJWNL}r+5cjgSTwO06#E1-y*%vuD3Iuc9W&~~PV+nQyU`Sg{tfrD^imu` ze9y;qLj?Ob#8pqFOH8`iyUAS_yv%&Fx7wefeQIN_-mG$E=bUnWilNN-ULfkG()oN> z(DQhKd@gUl+?|**H}9Y`oK6J%aNlXW6GCi(<`1A0m?dg;??z0_a5W?ea7!ns%aav) ztb1(5BC2wgMzX0EKqcp|dim3GXlw3YInS9bAg3>4hh*0j{%pDm0vHhOD7w}83*zc;T-DS0wRNL^q)pU4i zc$rL0$IU8!%S~#>5Y73J*k*mS)UTIVDL^#GS*C*a^lATH7I*0u*JBL>Dn1PG{EUjF z$OEtdeb;p}+y;nbFnt{BNiqy7zE~O)gN5uWnoLR*c*7D<)`wkG_O$ya)+4n<@A}4g zF_eL@C4TtrQIZiOa=Ng5SNCimu7|Dj^?ae*>Q3N1|BZTyd-4B#eE3pu{p;3J zHIGDM&+JN`rGCBsVoJ_ysq2O&V*u{`5S#fj?+IrfRqn_(9Iix6`z}Iy9>&CM*uVmVD@x!?@ZKA zYnFWQYF==VtWcVGE{^5gCl+fBBBbQ;t+~z{?bjr&Gb`Uee;63Zs<^Xv0|4n?J>gk( zGtTt^jdk+k+zi#(EoFB!q^m&O97VXP`3{?h=~40{e^s#=z8B$v7=3QDSx*6)8CuF| zZj)_4#-5RFMU75S!%#Mne#Jjb+ms}u+EG7rWAnQ+Vkse@tY*lO4mY(J@FK6vp&e!#_+ zjnDFW5U|lDv)TeIcid4=Op+DvwX0rn7v_Y^Lko`NyMkdmKR9MOyIp=rtR$FOTZ%7< zQAEvIwQlC$pH#l07!LN2v4&R(vsdId0S-;LmN{uIl1(3&>^pcLXhJ;IENc z-EOK?QMB?!L{Zrzs0jw3N;FU(^JVIXFDVNM!2Lk>& zdBy*Z5@wWFf@p{6P>&96tCIjMH%9e{lV~pCB${QR@kVeObmo7x?cLED`C=K^<(FtZ z-pgn6BNvLvh4Q!LFF5(e@i(}E4l?VA&1vQjpgdL4Zt5W6r{B-huDb?qKm^4Vv_7&a?x>aiPe&4^5r) zSk)d3s-o4(s|Et6TKqRZQHL&5d?fJnY4iFWIiz+fh-I_$=xAP$ceM^gn*ylGB6qCS z>)DFVc$+8JAPByCY3sAmU4MDL``Od9XY06!@I@RtYeWaFERR}WUv8CE(%Jd0j(85+ z3KK$fbbP#sRxeTyy|quQ*hz?*aeBwOH}?B)6z3xV$2I}dK7b+M9mkhk*Iw#7B!e(FPgV0<-CDN?E+~D>$uBkFFYdAwuMFI>_(e-MzVb~ zjK2l9N@-q0A1+^_TsB1`8MS5HP(`)3->J=5tiT^W2MG^_f!_&{^GE5YUwse~i0Rx7 zV(41y9u&4*^@;#xDS-WQdTUu!CqbCxZa-lKKwj+z4K!oVd1B?7Ix z{&_l;KSMgzr`Cqs6T}4p`*KfsrV}V6Pjcn4SZn5MMY@*1Kx9?jPnBP|)B~31dvjo6 z68HwVggJ5-N?pe}`3nT>??z}1l>c9dm#b%x7qeB0CXPZ*FO;cB>-PZ1-}Vo~Cpb8e z7*>wwy=*=F1F8`@ueEG(h5}z>BHM*NadmY9!x1K}PxD(o(hRNB>4Vkk(KW%-%rC?L zv*?-W{;f!H3h-+w$^TMQ{>7}BZYsdTZtG3DXMbFLvt@NUqY^lm3gmTJd1LazZc1w- zt-46BhD~3-EPEp%PbnXT`1l9TjI3j2Cf+ zVi<9w%c~x}6x{fFO2>c4)IR~D?g35@NfL!Lks&NPJGDwd@gP>Cq^N;qX#oxmF3$#>f$lT+$BT__mEr;g^Y5QC z)%(%g*|8#4>*4RYvvQqoxw4KJX#@!=yGz^1BJI3>2O+fq!$m(WXSYQ@qgd6Ltu_8!C$+s75kp@*?73k;osU0xBEj$pEV@yEiImN>T=aURihi$)Pz%_cwYb&{{xJm>*ga@5x=okh0+t9fBrO64|HA7>%O*6asHgk5Zk9~ z73LuX9~btLR#e@47w<;bJAYJI>`+;EMTrX7Mq-FQEwW=lQizhH?$pLi$|kQiiuC}7 z^Lk}JuD@*Q;w8yurm9YAOW5m(+`5oOTFfMS=Gm(e`8ny3ivl1HhR(-~b@OeHmCf6I z;l4jEqK{0RTDpWt*t8%1l>cF)EU}X@8!?~!$c%Y0VyTP0`SRw%F1!dqvNc5bHE~?E z5J@XoYWXb!4PW^YwUrdG&ffopdX)i4?<55uJMj5??N(_`3UU}WY(J7AMae4=kw>v+ za?e`nqPF|9ZS+z0HqUXl&{YNMMSxtwkS`=~UU>Z{M+EYP$Ejp52h^>YPK8Bl>K~bz z%R1-I_O~BE*OoGDV9096%BT_zo-guf^eic1sj=ke^CIreI-IiZHmvxTocgU0QfUlE z{nQRqyb@G?{;?caZZTswFjIETe(D?TY8pX21PA-Q@b$(bNqTJ5=z&ldI?uKmxLoZ- zW%7f1Cp4W-M%qFF#^1*jD1~&^X*}K&P#8Af^L_i`CK5_5^I$yeg3^Rgb9{B{)GZ*6 za!u`0lc@k(`1)#tnZheo16T%Jj=(OZ8nmFo_kN`LGu_keNTKx=PxIG<(`A@u@DD+L zTV;?_+`YRMB6$0d$q3maqPq|_$Fm(6y~iOZQIv=9e^pxjwZ+HYfg|7xI&I&Kqe$=8=bGk2R#@IA1RmirbLn;Ro$ z_ER$wsQz236Ot$Psag!#41f6&-YYc#G*T&IfM?kbi9m8pN-TMs9Ue&4C0_74f<98n zXZ77)uF2kfSaIyagh)^4M;p+0INHd>Avzt+`4P&rWZv!*hG?Jf4Uz0#mWaJk=S@8J zyJdC#iDjrTVC$apd+>kk1#TB!f88`VKzGTK+OfI-*oTjFk!-p9l}y*b?%}RovkHc@ zee42=^hR8FqP?6!_b?H~Bsqv`oB4tHr zXg0~&ep2+kQb6!bSugyk3%*rn@yB!nC*x+zN51?a84pNKXn|O#Z0ZsX)8#^!aN3ID z?IjcWr%B@64`o-HK5u%3#4e5J-up40&JE;8HhFf2%LcZAYxSFbN{$w$u!-0Sp#Q8AA~SL+s#b%i!rC}1jp0)(BZ zPcH39)U!ZI?y{428YzLr^1ofP2ED}j5Rbx6nJEv%qVg_m>mY}E7;QhX5O*sf5v}t} z`n_UONaqr|-=b=~>A^})23Ddxjz#8x4{uq&fo)T!f8T66Gt;VaBcMs&yR1A~?G!v> zFq`bQKd=FS$+>Esm&F3V`$u(En^jS|s9s72Gi05P^H7K9)oXXsfG6QU0H#CqlwXF$ zIRPe}%+3Dm(78rQ#QR#;8cz*X|oGk(d7)BJY1RIWM{#(rd9{h93CzUDR2*;b4qP{m<37=hczl-v2bJoXeFx1WQ?Rdys;6651S+8Esw@ zIe^~=I-Zw<;-Ga|hLcmH6jKu{R=(DdYZhOx?zzz@h0+Plbtd>CZa;r|#X5CSu zzzrUaSo9W4nWhBiAMX6HGbT9TJH(CRHAtNF$b#8O;N7(;>7W>Xi~+RQXTn)Qt2x5C z$W*}Mk28cm5l9hEd$O(O;9Rq@^Cu)C13-bPc``^eocfiw%PS|x4unqGlyl1g;oIE! zL_Je}^Itp8O_#ZMmMKzL>aGmQC|o@X_IYYSg3_Ld50IA}S12Wsem=h}nD~R&V87ps z{5NbqAA&ajdcRiK#+%8JinHtswcpllUOAt^VYp{(^H^(%^6Gw{;<;8&zvg5 zJEfrL9&xkj4WLCx>UcT88wrtxOhK zwRI{n(rGDp9kg@|Gb~9rL2Pq+Um?J*IwK}^v_ECiBO2Q1g1cS!FJ-;@rBwf!ERRK- z3~o1m^R6{EIGF8|ZZAdu9B`#_f1=Z=0>=3U3k_!h{3-nELn%wjv@!lsyB&_S;y$!5 zq{6th#V|P3G`C0cT-0(yo#sbR*`oek?Fekg_h5>ffYrn+9=afsHi97nvd?c+e`I< z$1RcI0MN4jm&+$Z>)8%poLpUUm4P8=Us*ND=#cl|(<1a}D%TWcVo4!MKYfKDd>cP* zn1x9?{@oz)v9bDdQQ!NBB*(l19+@@o965!x)w+=_>sTbaQImy5x8mkgcaN8*+Mck8 zGW5OZR~i$Ly1k$-KE&R4mEja*mwb25pyQgI);@*G;km6MmVPVf&yf1Xb&N&B5+r;4 zpKvTIR3x2pgUv_NIsNAP%&rlL^BB9iJ!#}Z(!!q``FgY9V&Akisc-9_PKVgVpT4LQ zrYu+Pn;7|+0vQABD%GQJDBAmn7M!2e?utxxNgzQOccMbsOTw@H&=$vJB)A?2o&Z6? z$r;k};xDz4lGmkr@>S&%O4#=2t?%*c4>*k#`9E#lH8RHVb@zjdBcA z!^kE-V@m(E)peKv(;kAs7ytQ%{-8O-Jd}j+#et+Q&)rmueKOI{N?%zo;1)|`?#@^; zP*AY*Fw>CVFrh>LOvRM6x$IM6!P=Z&oDf1A0`jFBwT0}-Q^c|wkky;edmk0Bq#_R` zgrNVtA)*tb>e1DAB-mDNs)x#)RGB&NunH@Yv7$W%b%p-8{xKMvrc$THm+4nS!GF`0 zgT!P~_LXISx72WMGhbWY&29;ZCST2)MvDK-$-yU0(}L2`Eq>4XwxNlBq>mQ~N()EI z(bvQv<%;^n9h)g)wNAMHrnK{)<`x4>(;Q(u6EC}iSAmONF6Dn`6DyAoxn0c_BdHhc zY;>=6RO>2M3DJHu8}d4Mq)AqmRIol409dI3yRXv*&yD+^Ur9i9*WsmLi!#Mxdh6&rG<8hN)!l1OnO}VReKkOXda8oxn?8+11|Lz z`Pe~Tf+C#VLrFTf4h5h;)i#?zIVE?;+iRZH{l_&mtNYc-{2yoG3eX?bC#6;}2Bfv} zCsq;k1zD*Zv2e0|DyB2Fm#ovrBP!r~4Q1Q8Cn9kiW59;KW@`i?xSTT1lmi$)&pu0sCc8<~m4WaHB3d%}S zFTB8H#{6cK#?lKq9PCJ@D{1#n@`brW2Jp!cLaG5vFOoYqKrHfeWT(+n^`A5HW&D)a z&f(zyL)u#gwHdZ+yFe*WMO)n6i(8PEq6LDx6!%b^;FLm(yF>8eP+WqR;_fcRHNjo> z)3xT^d*+*2Klb{5WTrEe@aTPCa$d)|zQzXI57Te-jt!t)+=~uKTWwT%Q9TlD%{Z6M z2~TueIR`jabBeF?lKp0%$qba9omnq7h9UJd3=_^l2;5hrFiPX*IP>rnt;|Lw$!eSD zc}b(jE|&D;b!N|R;b@s>v;KzPP_P9D=U$}uG9B1m05%KXU%no@Z@+!Z8R>RGO+xAy zo-6x((t+a!?$9Pm3V}lmv*cGAJO(oae*+?KueW9DTI3VhP_r>`o+Aeot*QJ1`j%Pv)G9-0+?lhP9|%GeZ_ij$->Gjtko( zNz!ZfR{@&T6CcQ;j{g$HtPT@%W#+s-*3&hf%NNcJkUy(ca z$d{r}b8#57o~|qHHRVFCT7}y&Six-J;w3mKo)eHUm|!LB7u0V>>`J zgMV(SwlW3GiO;H2Im4Am%f((`W{KY!yW@O0wqq02I!o*t)>mNQDwImwiCM-SiRiXU z`gdKiCh-;7RBzdg z%3XR_OBmt0ie1=@s?oC~aT6RE;}iUh6{T?c)>}mYfxD&z|HxIEs(-z-`BY=S0K^-7 z94OaYEEB1Zl|BSZ{*)hScmMFuv;*zNmrNKPhZ@7dEAHLS)yaUGXpW8h-VedTCx7Q5?f-jT*Q^9LVv8t;RVIjm8D^k=ljz{-Zc)5$}J5nCAO_Q_&v( z(dCGkZX9|6*2eBrpPok(B_o}4#wEQrF+{0d*ZBwH;@L;5n9mW(g8^|#e-TW<|0f?fh<$N4VU zB%Qx~$`cd#5p_H6laHsDMe*x(JV^g0 zNg)!D{Aaek<8EsRb4#@d2xSTE@}Gxn^A9**`~IWZ&Nlt5fJJ8*JiGaf=Mqy}($c4O zpVebb4CmP?E>(e*e@YFbY*IpS_{w?R zSVIZsv~HA<_{~-^po`o<_h(ZaeQ~B=*Yeco>UIVB8jTas2tros7&h?%k#ByZZEQ(e zLP^@5(2(=~d(EazCqXw2jB@S~_V1H}%x`?;EQdvAE`F9fp?2HJDD-)aGQGXm|J%Yr zYpX>(^3^5{=zqr0qTGMb1xk~4dU|yiK3DH3TBZfDlieL7A_vbM$(N+8>M6UY%H@2@ ztw4KoP1a=e1Q?_Ym1Vs6~Ok0f#*`g=1BoS{gmfR*5*AwM1M}i z*72>}7;9seZ$FeJz;5B>nIBu1@xV;XPqkn=nj?#UM zdO}V^B8&tg{UgBu&P*{;auSyL?oYr_dC>tD70Km}e`*y#5|Ee{MSLLvfL|G0jQ-V@ z1y6F@7RDrbhOsU_Gk*O5fQ_+JjS{nQhOyi@pPxj%0_6)_j&*w*Qfd=5DUwJJIYof0F zeAQ(if$ncgdBcjQ)P$aBvW*%y8dsTyBhpOkoTP|w2cK!bm1_e^(zr^9*)T-Sqr&Op z#bpfmg;W%-yz7MN6cjSaok33xj11DLgDU2_rC?GfLLSiB|F8h&aN@5@^a^Vz*PbI0 zbxm%|G~4B0XEnA6i%LS8IgRkTctb&90%HMBVpI~0TM^YuQP2f4)Wrvv+YTSf`|@Ca zz)qk-iNvz12>=+p-(<>u0N7^{B;RrhEl|VQ3lx7R6MxUD>g)RW-v^r0gT?56AmzR% zZt9pMrQ=09m;Wh@eHLDZC))JG1zF$HDL*$&Dl=5IdD`FTq6#>PL@e+0TR;!{o1%=j zvL(k7hX!$fxEQ!(^X(HOM9tPrd&<#+@5jn5puEE$xEIb-CY$jkIDc?l|Agv$l$MB_ zChYZ~0OQT51d^t}miefI51Pp*za-Us)Ehh?0XmaAa~Oh(*+OI})Lw){nQmDxyMHVn zU8*#HU*g#EWb>HEE%>Wp4LSpctU3^aQNLNT@aJDRI1p_0d&0RGS*{9bIOPB8mPoMQ{C=4Hds8H)wU zFWa+~0}*pMvPo}xTEp7@?eVE1ls^yz;w84QPyU_mD-j|We^EZCqbLjvMvB+*pxim_ zPfr20*nVU@JIoe`Vn_v4?**7Qm|4Nnf|PENArxuZJwS|bNGZB*pG}6!vWk@E0%!r% z0eJPZXf|<5D9t2#Rr7s4R^2kI?)#4Q)%BS|kC8< zML(sl=gWv8;P4GposGI6jUypTY)65fVmC|_n}bNeo%0l;l6c1jvFY$j% zFpYfQm;#_qn$LC?O4efoq@r3y)s4i?{4A1`h94g;&P*{4DFAxQkurySzj8rtk8WlMTk+BXHB8GzWc z-6;6`7k=)2OZ)qRANUeHEe7S&G@gu^j8?GyKvf?oAS#^j@M+=E$KQv!p%7lNHia;# z{nuy!gO_asM2ixb;xrBqH7s(5!A-i>Iv~R}ff*IgmJ{Q@V6>we16}RF1%O9Uyn#ja zU$zbS$BU5T#pd_fPzc3`!&Xku(o70Qd)UG>E?GUEgDtDxJO=~#f*;97(?A*MD6pjI zG5*%8L!iihW2KUIew>dPdq)3h9l0xe*&tKJgn(Ps$}NDbFg|;JE4JMXw?FoXBDzul47I~;FTjE|Gr zt3y28F2oKaLOr1m=oNFn3(tN9l=l?kwNB@?w#1O8q+3K!$m`1i&dA=J$PHDPFVNNQ zUwLvVB-gftgn2;l_Dfo{i&Ny#y0J$Z`zNK3u5Fd zccL%F!;B&xbpcI~-58gzz)g_1{}@az9X|GTsD&Z296x9TZeAPsP@S=|dX7MYYChW0?+wTt(c!10USmZ5)i{5CUR!RY_O2`}A0+m* z`eeR#z{EV(x8ZdA;mRvH-j!`8mQ2b3mOA-MDvSm;a$f*G&A^P^^O>pfHS`u!lvtmxdJOpF(DB?>d5!3Tcl zKA?r%xHSR988jMTu`!Q(UPJH*-HgdTq|b48ylf+!&ya8BHN2n231+n@U3KlOr8%Vw zhEIDYvZYXxqL-4Imr30N;LT;g;>u4sSm>1#-)r>$rp;{*{MdE_sKRG8Ta98&wLHLV zhOcL-Eo@;JcLJs{txc$V0touGd1lJ=NN$&cDa+q`FTX7VbR*B=Pn@07UUyan z4FU>)*DrINUPMuKMv!9TWqwGDqHK%xaM&Gx`b3J5Sov$cwXxgvNxjJ-D=9AH@un*m zE>MahurGN{!WjC?UcXnfPEjW3mx$X`G5y8JyK(h{4*`@4=^cOQTG=7-R?gra&wta| zpQ5BZgMQ$0(3f?19aNDpy0!c7`KD%BBezfI!||pDfhAwSN)%IZeEPIS89#k)Y(JH|CUfZcGLw zfN?A9`(s<_^@u?|2PFOC%JJ-;r0;X8F?L6LS7amrNA`B;OjCLPMnUf@6R?wlyiMcY z9x8gR;$pu3)AqOp^ZIYY5_6|qZulYd{97%KLXvFzSYo2;4iuMZ2Z#n$P)643;WhO_J##ir>vs& z&ag$e^~g#qn97nh`M?Vy6xX9yzlKXST^d3<*JLhzO-fBj%Oa2=;n#D+Z+DG~GBm#V{Pj;-rx8Y&o znTKG!XMi<^R2f=(#O&>~-fnj?lgYB5Uz+=^0r6lyE;95X#SsVsDrxNg3iofE z^oY1qyb`4#9$$`yLH*&f@6-!_zF2GIL)FP5IbQ4ol&7VlNYlvldhLzZ`0>s=&j8fe zBukH9eTMyw&*A)%w)3KucV(LCjWOx z$hMu~tKn|uCvcA+6ls*0S{2>b>vi@qF}A1ROD{BxV>hRWzC*9u%QkZ7tvY1mHZ}z) zLTdG+SoO9h40J&0}1#) z#X!VW7~(3U<^G~yyW4pi@`ns+Dj;&wnc+aUo8fIFbqbK7_J$aN@?)v|x{Bg?W_G9X zvK1cuTs>saVXsf5sp**I-#h}SX1}eX7S;giCLfW)tpJ?0Fi*4COS?AnCGy{VDxYvT zu;|7fGsO^mwTuU3SoS<45xOb9KcT?LsX-&HXSioEi>T5XNZ~TaD^Z6t#>bE<=ShD_8wn2-{eq$+)4`mMV0;g`}Xe<0De9&&FLg@6CZ=vEX zPU?TTI%scXz#?BfFdzjZi4^CR$ZD`V*J*ZhqueflPP$iAQ0TuZ5Fn(BkP02?ZO%Eq zqA>ub=z6D>MhVv&9y*$F^{t^ z9DqE5{7K9?AAh@Yku~UQ{yRwCn^f-&3Pkd+z*UGm;NBKJk+qVM(H{^0 zJVPNK5vcrSg-m@i;!c}%JuM~X{*b8QHdF5U{&S=NrjB;68{sER0Z}EOI)_t&eLqv8 zHKz2OLgP=Be;~Qwx1CWyK@+;!chk|}j{z)}p966mp3 zer6OKahW037aA&vWH@a&G`+W)tFmHLznl~NImi7wg7orxPQvYpA*WRV3l1eFLfUCcq=@#G@%RrX1_4)xtPU)Ue;SBCHWR6EanOcfd!WA6Qt$^G3Shb7* z&>qPGd}G|=cVA@KzJ?h10$Xi%0CDhaYd-`I+QxE+kX~oRYiqmYx&nj4^x-tp#Q3PL zj}KNQ?t09b>IIE%$mKW+X&Q#gAR2s{O}>ypTxB zQ^+le^u+~y?s9Q^zD-f=R`+gkgURjBmm&Tg8WU;V+gKY5{ibeAQi1Yh#}_?0#}7M1 zm=Qe3H4}@C&cA!(J_a6NI}fN4O7rCArQ)W8Yb@i0<&`{pk6yx$)g_#$R&x zCiy6ZSp#S|vJ0_9sxQm%;I41DJJ6}aIaK%CEzh8Pupkpb5i6iTzS@6z^WTOV#zLaj zcd3?5N+sczWa3|NOpVO|(^l%Jcif2%W&~#ML_CQ%|)r&h^8H%gVx*zymXho|f%-YhJ_fL$|!xTxqBU{5{wxC-~Fx%)tH-eGFbpgO> z&60O@6lmtpYfta)HUvr@Sp3F*S#pT}UoIyd0t2nW*W1m=cToy{4jz47VFISaUwHo{ zzk4QfHCAr0--+Z`x~(&|D~%nb?7CV{U_GvE=h@W@A9AeuSw@s$nkVpy`l9CCU$V9!#sf$a{FN{SIw=iL&)jfIq|Z1!|@0{tlD8^p#^YP z_yaL$z(G#TDn?P3Ph_y>ZfFFQ9&+$fmn3agKu2u%ea6tuLUzH=&e?*a~&`K-Mjr!T3oQNx0YHNL{mQJBB! zybvCFc5&DsDcF6D@I>33eHGotxjtTrCXdcl|M?+}T zEJ)`6dvQc0v>R{+fpfw{#9;g7rdgNAWAJ2}vqllC3(S zZ~FC5&Ti*-u$LY4fC>3m!WS+Vbi*6KxM;l}DTMaYVt}PV{J`KEq#GzB%A&!-Sld?!w7Kg4Y9INq>?v4e2_4yc;pC6h8I+Y*p*J zpQ>F4OzideZr^_qbyM^ua8p27$m2y^)>~6xM!@k^!#S(!X5D(|K1{DXTvU4r-3=jF z?kbPY?u1mBjK1-{YJqp-5%^y?uCc^j`BH$0gp^cd#u2nSu3;3nJ3lCTWTGs*IdrPt zX*VCrcm#Gw>uBGZ)9gz}Wxu>T24ef49&44hXAMr9IUnc34~L>Ny(5cYXJ56unfdbeUPCQ%NZ(9EF?yJ_zl}?CDBMd(UZHp>;5d75&W0*ac&DjfM{(bVoy3jkn8mO@^8AE z1g2BD-K*n)03{RGwd60Sxkl}k9pU0{nNltr;kyk$w!mo!5)b!p^Lu>6=%AnoYJLfO zl+GHG8VMc@zB4WWgou|!r*hUyP5J*w=fTad17*-G&)moF41Rfa+^sH$CND~mH@8(} zTaNS0lpDOAwntE_;R`j&$}f1jpKc}OZ`T1>(ZuGQo(B&yOwsAGf8&K0#05Drl<{{b zcFWDeqeT^w=38ku=QEZjGY6DM6fT!;?WkL}cMPjI&dk%`tJVd0^QYN2W*K)OUq`3@yy}@^)_)S`QnRB!mZ*R?{IHZnETe?nesb^T-wju zC=bcs#~%mfp1liDc(xMMmeTyQ73dQyTg{NEMdkvjdG36p2ja@3JSJBW`|T7ixu_@e ztm0iZ^TT8HrA4KynKjHP?`H`eX}COaD}n+w6>?nr!?_mbyq503ys70nX%w@rB*)V44%AxuPN>#j zFs@5omK=(3VDh;2i`1)h-^Cb+yAu<;hnN{f?LFb1!5^tk*!JYD$mOCtcUBy)N*~!< zkQc_iX`OC>-7L9{i?s92)?Uu&NmJ~P$<;^kyC2syZY?Ar7hSkVx!v;U;TP$X0M)-i70 zP0S1G!aJ|mh;bwr@r-I+1F9`c?BG&x7CB`WzuZWo5T;rjb08ZtcX2dTsPFYyZb16s z`M9T6-nnWJX#V2_CvDVbZ?2i%6DifnP;NBk%+2Z%4tiL)Jt5Sk#d;QOCJNqjYgIB# z%;|RUbsK(vuZ}cp5_=)(>Ro+|43HTcsRDznpidzC$N7 zZ41V8%#A;0)Uo?q+ODIQEn5wXyu7?P9|vNN;lNe-A*3Sx9YRcEIez6I&UU6)?4V}Q zhG>x^VN}l4kfzqbhg4FTn#I_arO@eh1Um%7wl@?W}XG* z=WItUhElI{#B5dY%$(ApwHGUNTDZ5G0<>{SX3q6*8aiGg>EHb@F9av?yo+6OBGR35^ol>1DER0 zuoDozt6grN4*BWH=0Kq&>jG~tg@9n$>nu=LAD(vHuyuU(pPpCyaIeds?P0o`8_x*) zQ;(+oYnngvHgWi@_L4@vq*+sq^}=!A|QuU48hqD{C zg1lqM8xl8`*hhjX{k+9Ilt}u1fjDiBxU60B=(cCp_rqP8@}sIe*&aM!&idt-^?uhzacFF_&t&DvYGI+s$trQu9#^DD_wsTfC1iVw z+rIo$-j(ZRV~EHTdq{#pNloJv$rMN5K`JF~4r;Qh`59$G&P$BkliK|{IwU*~ zYWDffCjE>#Ez;m-SnC@hzDmzfoOz3(sQKN+-|wE6;!$k6_p}jFy;QQyLtgr(hHj1A z9v<5nEv@6eWv9WtagV=LLjC1dG`O3T{pbcfhtYeE%%&n?E$wV9s<>}L={OJxcgd?L0O z2U9oQ^;|4h=)q+*L3WQ({mu>TyL%Ta9@#8g7HeRlx zZl0$@ORbi76kckbo8KlhUJZowXI&VnkdqJ_?qp;&(#@d8F*|#DP74(Ncx>gp9;~40 z^*QPw_FF!voQvNhBnAhuay!RfdXIx@8c%;z*EL!%v#JR21ZCEb{ykrg$PRyyCtg=V z2pzb#I@^=XCC2qT+;viFaO_ra{)Da zsTUh=E@u(b<9(vt?G8zGnC&_$WoQZ3dQEnvQ!5j9R>-jBb;i^(?u=hT2xU!L%kLD1@Uf741e_=_PsAEoft=@Jpwgn=?t-VlGXe?&0}Ps;X6p9%~vnaFb;E?o098P0$XB9 znNiksdEw>h-PU0#MTzQ_A;<#pV|R8#1-jcv?31x=`VvpC3{|4!D2c+R2UeV zPnUHMv7V^ffs4bprz_QFre;Rr+G7Nh(!~yZe0*xev^IHmTKoc2pAK{9BMQKlU&XSz zD^KVQw&6$$tT)-VFoEF`Wbbb=*>%AuPo6tKx*Zd*O-Vm}b>yFbDJm&FHPyRtbR5{j zKD#K#LIgGM?t}N67-I<&@{hCgq^ljbRWfh>g!sJo>m5EFli9wzg+-L@6>-rJ)2HOg z0n-=KgIpO8VW44gRGp1VgG};`%35Ula_3%W;nJvkYAZQkqQHuhg_qG=*RH+WVxLKm z+&y|zj)hV70qErGmdA$<<;f@K6O&@auWa(oa-{bb4B7rj1iP=j6MJA&aUt!?q`4_% ziy+*EtJ}l3dd--!>hw2@4oaU9kI0wbty?*76LW6y*8^{j_jV#@iOz_BIHxbMfa$%| zFlFNiDK`SoI>XiZF=gL6qLJd%Y*1!fdlP8qK1}vZH>`O-dJ10|77;#MipM_>14*k` zN7w^*<1$<0X3BfJE?A#Uojtl|I<_as^R@1EGZ9+N$&z($lQqg^gn--A=Rt0@e9T44 zdr%DL!xLd+o&L9~OlmUAN+-W)9U`G|4D07(Kl3`=n1y4hMt?{Y^fxfTUz3x(jtARG zt40ID;28Di;}^#k#86(kD@92Zs6P2`jd&0XZ%cD@8ePTti=qa|UWdaze)NZBAnK8P zqp_kj*03j)`kcI7K8sB*Z6I*e27NwzXzI`6a*Jd(zXBQGGrFj9?#Q7yGg-fb*@_r%8#eM~alLUdTXH2$EQ-`4aSV_!Q=CZ1Uh`iZFySB*A0EE1gqn(qO@ zk3Zz^p4&q}q!(;#0ZMkx160HA5Mp)aYAm!~4_ty4Dkln4oi4yN%H)~Lnm)EYq;do& z|BXx*{(^q1bC{PeQ;{}W22)fQo}HofCrr%C$BC^Bj{B6KKTi~6^Tlap%&4iN3QkfP zz$Mas`kPkJg}U>A8KRL}F=c7lbsfP^2J^>6(5V>rbe~&(%;lvG_C=-CS-?OmpoMv& z3e>UJIZv0sTp{xBOh)CnIk4kSgd0tJJdwRI_N^vs&40s<^WMz?x^lj1OAWQxCswjY zX^AK&+Vq<7pyH3jXvsf>RKGMk7r5q-XjCNUYtm7f`<*+SflJI7XET=~tPh7U0*&`7+;8T_S`7`7ZcvT9 z9rJP4+dDd1m3ftfmbG_&;2ruRh4UYJ*Y7fMoHBg z1BK4ZpT7^=>8a%pv8&A;8tRV7O_j-tn_tW+I?2%ERq1C9MB#>IumB%&8U84Vg28jD zs3EVPf@*GP8IxNl8EN-Ie|xuZcIcpXug6Y?KYa8*nRPSkOI;9kv9isI#=-O--PGW& z`sMR@FX?M_yO-tXio63#OwRQ!3-vt*Ln%p7lq(v?cIAC**y5n?s=5}b8PHXeBu8jz z%^RU5I9t~$5WQmHJ0V(Y_IpirO*Y)0QAKt2tw)lReh7BT^mZCcOHX%-seT>MgdY5T z<|zg}$;SwJRhPTf!0N`_zK;n@kqcJN3&-WIkPN+|A%OH6SZ@iQYFKDt1!pQ<%lFU* zF=<_%pL;MW9h9Z7-CZv%52fWMxW1)|{^n0WdOjRQdKn$i2Q*iXVIXK?UPEI4#LCJ( zxp*twWM@@VsULO%661@oUCj&oA;f>8SHj{YqX~ta!;5{qF}BfOe>X~X8Uk`By! z0L0?r~y6?6nTuCu8w*e;>%Z14#0N>$a#sELA#@8EtCbUYjhiqrGXm>zU& zVjVnuo~q(e z^-sddN}YY+@_cQ}dq2V9Bc6Te+aAZ7#;|oUw`q+UAe~AeXO51DC~6bNJ=4qg*8eyT zAK*tzPECE*N*%_O#w{G@4;vyCkQPZ(?Z>LJMFibxl z5>+Y>b4-^X9{((`e3HTz*xU;CJBiDEKgO+^)R9et7EPth3nbuND!_-0T%>={>2MLeZfCuxom)h}%#yj3VqIS2m$K>mv0;k@4ds=+VdXxBlTX+{T}7@vJU^ zb)nKHQ`E-rQ`XYI>u8H))|*d~fDf47#$wNqN&3ITo~HW6^o)t76WC(J9gj>@3@Hhp z2DkxRciqHNPI*{{1Q@LK`Hn{@Bw)>?ZARb75-)4$aPW3mW1Ep`-AC#yE!o2`wbJuJ zR}~FiII#Whn{tH%8`tL0aO**M*cJ=*Xbx~q-?nh6zd(D6E7AP|O^yr4N(Bvwly)Mr zb#a(}pl}=F$c6?;paTC7jY<_A{W(p$JLEkTGX|Rd2NX$v{zesbd^8+?6m%*SR4fUU z|NsA_Li^PIzx>tz{F=lqPCHJP58@49(Et88fG@+r^|$N%@z(YK=BfllGWt_X^oXOO{9oK-lz-1G zwS>qL``+{a-Ba@4Cq)hh9=S+Abd>*`U=;F4 zER_F?8;ycK9|C;Kp-X)s>;L)%0uIRqg!&Ry_yHH?e|0_n^Y+%@2bdqK&uNzIvsN^( z0fneZuVa()sp7iAy@{ok#k7=^Q@}*wR?5|&%!A9oV4%6NF=^R-rIvC34Qt}l5qZ`s z12$LPR&O1uFi$1fO*{#TflWA(ybMK}J7E&L-rn_+n1frQduFy$nyqa7WmtGp&op}q z{|x=_rcWqPmyr1SWrTe>?2QjAm#@k)PnB6n_uAQ^xZbiHlMvOr5l`!d$ZD#nP4V7d z)9dgd;&}s#AyccpqIwb#DS#f0rv?Vs zGnzXyi-W;!M=-IB3&YmCa_V7#veG5u<_tXi@PoFZkDk=_LnOk_R6!xpuOu7~;Fu&hl%73uKljJm8Y}}Q_*7C7hd;*VzuHI_fH+27)#7s`J1xe>sX9`x%Ok9@E zYee7zAn;4XvQPR>T3zxyCqflS6`+`}?VjCOnA~1(Cvjg^gi^U~^lG+&HT<@R!Og^%i)QALU@JF1itqtn?cQ$ zh8NcH8o&c+=P;1yT7+uQ>OBJYJoi0t1k?mM#+d)pJFQF=a8s@E6jnGD8mpRw;c(mb=VJNxcgG&i3$9aT5J( z!AbtvPr3@3)B^)qN&n^LHv!|`%Gt?&K-!Q`iY9Ap6o5}zyB&DXe5eCU5v-ErV`oLOlrHbKu?t9Mvg zHE0u?KWd2AkV`js{;ZDd4`m@{F6a{q^X>e3bSya5t+U)g7g`e)p_hnuI;wmQ1#D*C z8*JjY*t#PYakTW84pXmMoajNjAwU*3hOM|ikQ*O13F+M#R#Z96?V|;M1H>@L{0@lA zg;~Su#x1S>Th-z5TOPTzJh3g9Xj=2%za3ee8*iC5Klau4E5uG3C2(cWzsQ~4q+pap zsfF)h_Ar-GulF|GE)G`Iw}uzkI}hwUnb?vR7uBgB$Bd+%xj9MBA6lxl&8>LZOoPbT zhd4}9YLXUlVfGcaGB2GSWq1ETV62NGS_@r?pX`8rLV;3+mjDEGCM}KN+}ruUoi*Fy zWl9hkya0^~GQG(8{m$?8 z7^f6BVyUx5_}0oIiA%8oj<%I_PQFgek_FlXc9-y2hAW^1LCz%7Eu|k_-(8qzss5Z?RaVgFMjEGW#FNJSW^Tn;+#7m=vKCuDTu{BPcq3uVCFbwhQ4U;7- z^%KvVtu(l|!~KA1SmJ>^wUYc70PGXN4t}m{W1CALu=sllB0slR?`zw(0x^tIFPH3& zalCA_K0gO?E@Ge0^NS{#Z*SVWPV6+Tbr$rAtF4>qKNZhVLewcU!2R(y;B!Ujqi^%t zwfl;c%-*ZbXm=fY9ko z)uh4^AtVenFbuT|0x`#M=HdD?B;^vU@K)wn=1;}JhJej`UB)+14-UAj5 za^s+ts*H252ljmxXJN(I!QtVj#w&*zu}1bY8?k9-f;nH#xk;igJ)!1_zw_l%)jiiE z3|bvWYM(~18ShO%+EUr#f7ctcRCq;EitGIvh$g%N>Rva;8A zPG)<5F}y!_vV2eBOk1i4lp_hjKQp+AoD=BOM{{N30xngh@QL*`_?w_b&vkU&9H*Y6kfQ

    vn+T|iYrD8%ARZJ!Lkno%a*cTr=mv#0Bu(-HD>Cmf8hyZQP!%-@|q3B`_CIKiWfSghj)+m!{tR zq^>e6Qp-%97{L-s$4rje0)F$f?`&?8vkB;5U+nGA0os;pF9!$PDRbhu zy%e{&)_OjrJT4lk&`?z~4Fa}$q}5F^4-d(Rj^>2rRKtFn0|HP2ui9-~rS4^O^SRLy zSH<;D3;sDMy_p%Xy_s<{tPTf};B`IHM0N2D(MGx16S!*F>!}lHix}l@{{8Ek&BVsg zw((_mT+7Dn%k9N^M{*g>5wARn^bFh^sEtQdO)nYcg%2b%^=I{#`7hf80oLpi8GQIo zg^k4R|9mR{-=O*_-VT!_3bVvQ=;j&|7;@74Q;vfk+5n*LGqU?w6eaHWv@B^7M)^?l zkEUnC82gFJEk^oKJu`yIG<&xa+S!q!+kdR^^q(()9_hJ3L+}tZuqF zIkC6_*n1tR4HX~AGFch3%|czrpy4yy=d9L&uugo&i|I+VINZ?TQQ2!F{Bmeq43}CY zgFn5Vn<|XQ5~7KyC7=dIGVnl87*<++(w^i7F$F0oDt!_%@S~-@^jS|2_^jHexjbq% zTfef5#Zar55_YWh98dK~A@*m%cC6VcZwCWCu_!h+g~G>HeEc`+5)4!CyFWn2zZEpw z*E#jGMxB={;uopN_nk+E%rnw&369u69s~n%HY(+xLrbfyy7GYyW!i%@;qOHKisnKt z-FafwPMKcrd(zFi5^hxyPZzyHzal2Ge*x%Z+n2bL`R<}vM(DN{yv)2dd(ZD+3Et>b z*vz*_jx(jjmEv-6xM2GJaYkcLRj){_^rp&fzS1<%!NYZ6nShOUU4yRIBSET!ee=I| zZFsnqvjNTZG|=_D>lbS(0%~JFQG9Vc#%sK+Mm%MMv)>L?#;>FCZuE_u%$pR8urn;D>ErT<|_{FY##k6URvFG}x*9~_O zb@hSaJbsfq995M6Q)1iuDJ%CSs@nk;>-YXnp!z!hoZ>n7zK=1aQ%Guh0=fS{_*?0R` zq&9Oei!mVCKcuQ2-yxApC*>&Rq?~LGE#cV((wYD^1`YXlJ+%`R1fu!zx@O~|cwkjA zH0UN5;^5?C5f;4^U7x|&NdOQXN`ca(lBn0KhSD%UbQO!oO*W`t%5xPN{z2J{8E>Ka z*m8?NHBu>>zt>ziJ2KXOCjVSbRk&tCU`7A@4NGyTizlTK{NmkFvJGh?i<443wLcB1 z?3^;pU_JirR8#_PhHqCF-9lXD+}rc8aN2d1k**I80}ES;W0-C!qgzcMPs%1RhkGgp zbHl8h4{v~J19Bpkg@ti8+jQyRXAIT~lEEY8sPLOVls+!QUdWcfH^^<0{kdPpWsmk} zvt$&vCCF8veS)knlg!?UzcHM?gy11ND}(B!6heH7dsu9~#s?ifl-(q$1f$&iBqu4p7@|+g^l=mVp}d(`=CdaQ z_puhpY>5Q%Ura(y<*UL$4B6`9VBC{J2VJ-#k7aydGy?Hu60f>q89--uCh&u=dHvSv zprIrMZfaxEUS4q4E@r%HvR@5y-6F_VxVV{M7AV%-CwJcT528|TX5oFe2=swz*N2Ys ze@c3yVePSJ-)pvUNfb1H7{u|mmp#V-j_7SrjNA-jP}WS-LpH?%Y7}y#4Y7?%+0^)iBncIJ$g<~bkHcKma9odRTwXMi z1U1=5)uPqoxLoIzZ@mL{{Y-WSF01e|U%A#Kc_sDxtQ7P~%|4;88N7xk0J7}Edh*3X zp*izv&$-Id-3bkZk@-%BUVuA+#--6zNTnx#DH!yVUizU5i-11L$A{Inn8{Kq)6X~G z!YlVxXri6WakNU3E&AvF(aZdB^n(pyU#?qTh`9{*sGCoL@7Wmi(Lj~dpo=W&|6%Vv zgPLr+zF$Q|R1gtR=~4tj6_6gfp{P{pRi*b%2%(CiQl(3mCMERV0xHr%?saf*{_A%v)iGM89p&&s6D|Iv;s%Qo zFf!4D|LUj}4Z6t8Th9;_olrqP)NQzG(2PY%$knbHqhQ#Y=BmYNek; z7&}Etsa55|$e%Q3LjPs~l)iO^G4lDoYA@OCPp4N5JGL3XTmv!NYuoLwud^pCLNH-D z!|P+Sm|wpd2l=~kpVhh*O&wl7?zm9<@-0{hZ5FS{`TR1`{hM6Rm{t9tUKRT`uM|zP;`Hq+(Fre$GTONL-^)=$({%?t1rRd|Zdm z7=y)mW2kqjTXDLWJuPi?_P1JVDz2)&5-4Bf@t6H5J_}}?0f{cESK&F!^o-KJNmDIn ze4f^#u-JT5$GiFXWW~$IJld#HgZT6)CUU&;ra!OZCo&>9{>B?t9lNwg3-|4XQIDO^ zwarko>>+v*{tr|a9=V}9IW#iN7X>M#qxiz)XmMN(TI}=_hrD*_6UC|%GV1E;Z^*ot zI~@`IAG7-r(4dYmptyL&X(+%}^E;lg{Jm$uFhFvo` zn60Q;HB_~gCKg|#7?}gNBO|3F_f_V~f7}u(h?17(dDUvwlSq;=W!C(07f=#7Wm3N> zY|yF2-pL1``ya=&1D1wdCrTp|Ds%eRxFtHebBfN^5mMY%Q`ckdCLAh|bEb*4pt)%PdIE@-^To`pM&zrTKB2k#gJ*;ve(ac3R?x*?8_fG6&ShNiK(`J0wQa$LK8K^ZSHOr zdEBZ@mEFd(L;$D)D2;47>2aK8$Jcm|Fw9v*PmJW5;({Seh_tX+<%Cskx4>m(*e@vmG>Rtkpy+-{RV7QH9ufy0K*UeFW6b#C)QEgsCzP)GIK@LIhY(g64iSw;K?j))T%9s3uS6?(D4Y zuvE>RJZ`9LvRD4NMlV0tg?r_wtO|%xY@ruOD))Jm=??rWy>)K~?u5H=_t@Q8^pg*@ zK^7i*!Gan11(aq!8is7Uuw`@|SdUolO zuD~Qt(}EKgte(1jrJ)Tq(blGWf3bSW%RRt+PUM+3b&%NH%oacl&FUci!mk;|oDvZo zPWobn&%$uuZ=+=P>myGywhLn#F%+BZF7_iMRR^EHB`qP%%_^RTr9P-jh|lu@EwPJr zQ)NboJ&paAyD&{2UYX(SR^HYb5kzZkv3DHQSkc!iw8*ST zaR+Du81$L{k+$^yb{Al%ZcG9~5+!=j$#T(*C5Afpgf)*InS^@UWufI+)uY0R%4u$y zc1mE4nQ4_Z8|{0?t1RU8<4fY83}o9iPLM$a-Pys>`*LYwPrsL>CMTNd4f3J&T2)aq zP;b4N>{{gsmk%za7jjlvJcV?O+~h^{mFU0C_5V>IWb2VrP>mB^6zrP?RrQV4y{3++ zs)gBWs6DnPTjkC}&((Y`W^WaGt$*Ie?thNXi0|_b=wT}lIHfx`_Hc=$41z1swgYtU zuc0JYx7{EmJ#lA%1(EkVsodOHsX|Nk$He44>7x#MDaHJH?=5*tVj{TTb5GA~>l02L zm0+GOi{J;sx8H#KrSd_>OmP?{I0M(qWA@6ATsC|hIJL!#YBQ5Jgn*)(ikVdX^1p8k z216cyDynEw5ztJkc?l8mY#Psr&k_;m(|FDSs;+HrLrFEM8YWcbrQN4^XnoI=>V3+O zl=O6A2=t^3d_@|5`#|CIdl)oZ`g*}aCv=PpC*$(~*v!;OuKh?cFs*a;%Cm)#*TeBz zYi2{-oO^fn9D6ksjJGcbc0CXgSx|fW6y~d>R^UsRthYjMAaOH|G&i~#peEy6*92TV z0FL^@=M1_TC1031uV_=(B?tq@6E&8BTiWzL6!>n$4Zq#+;$HVV5T&JB#n4j(O1{mw zC{2~ieNmsOhSUCKneU^@`!M1Jt*G=pKZlpw?coyUdNf%UrdD;^bP=XYf#ruzK;YW@%|3+nsHumeYq z2M>G>UBBUl^wWy(MRz+>;0&t4dUJw}m#pfdg(N>{#hjLYaLWMqHg@Y;r)89G@u1=m zP7gkv6&+ux6?C}W{wRTGK|C&(8irdGsY+P`e9ocdv;syQZ5@EW&?iO4b(Bgzl^$aC zvz8?q(qjR0DxIESKD7<}Ro*pdyZ~+tJgx=oMWd<7g-(iFoKKwMwX}7lrnw5YL@XpZ zT*d`i8Oxw?PV5EP%d|gYiip3riOx?jNszf>75Cp+J~=%_ifE1PrE_8rkGF?*KS7%$ zqBE#w5oIlOs@|_&xfhyy@2wuB3_olsaM6y;v+aF4@EMlqAY@FR>*$167U5@=;Nm$_ zB@X4} z7neB`zLBsegsk(m*rcplz&Q!ea+s--rN%vQ%Oeos)|O5%KEd^9S<(OpT+ z?Tsx}f(;4+!p{xl_5GQRv*y!-43tN<1$(|B2C2Hfv6&M8G3Y9W z)d4%YcQ|QD5=*pwcoZX=QgQ$o@pGWIQlJ$oT{Vmy3O?IYPfzjv+1&%x5()w9xsc%u ztX?FBB`Vj**2d)bdtfnC9*y4u$Ci=%;~9_5wK)d~?EUB*#1|}G&;Fk08%)l^!hqjG zd#8w&@{Bv3=|}3mgH76NR#IN;MtxEO@hm^D37K7f6QOVTF)!PyIRa3XMApUBn8nw9 zp!C4-1pBF^|Bt=iUP|B>AdEIie=-L;j{8~{5$!Tdw;O4RZKosd4KzL=PAVfcM(CGC zMCjNYPA*)wHf|Bj=44U401*a~P`$poWC?w#vm)mB#Z;YZpS9+E^EKuQ8aBm4wo)Pl z={*OiuMVpVJ(l%YwpJO^UGO^Q5E+_S-1{^n{4yySYUtmDfS z!~FVEq|s1aTKe9WskNl1ErL^-i(`!`@N{2gQ4Ar~|4ESde&kpeX&aN`u(yAz^Ykc| z5oite^liyuYNQ>8@j*@>L%@4`+Vq|a*zANyKlHi-ICB(8x2wsZBH`lr2?l};vu ztCQYSb1D+ECY{R6z`THmHL}-SAEv}~CkGRPdnhL4-kQD1efd_miVh}w1L4td?M~4O zV34)QTvPJmQe?to=jNxFQ~=W`y-%5=P7>?E6V-*93GYKQu1pwEtlt;D^X$&z(1%~( z#R`3g7{WcISJrIpC3B)q;;ME0$zp-4+EeGTVLZ$6->6yvsON$oy!FeFM+ zy{pVeK~@a3L3ymiAs0ZbEDO3}K(_cM5%pn5XnMxA1mR#u_%g;8Cor_kVPoY!d_|Of z_%x9vy3f%gr&Mo_;y7-82XHs2-KH(-{@BS5;sbR4Je4<|5U#46xnzsIRIdn?Q;L1X z-nxQg&h;yIFWV9rwi=r~R+KaXBV!rv**^VDtD14Ph2`4s8_jg@6nLnf1yq{0!$1d? z2;x^|wp`Yt+UN78Usyt7$^U3cr8EH1k+G?xV?Mw?!W*6tzovF;4(ROMrOncXS#H|r z7Zw_73`wfROTsgeyh?O7n(s0SRd_+bry}Vj%K6gj^AkMAxl(102*$^PTIop-a9x44` z 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

    !DqQtR@JM4ghG_ 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

    g#qgbNJ)DW&TtkBb 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

    IUf3D(rk`Nc(u*^Vp>eSnhlsy>DMdSEl=IG#( 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%0Ax8}n@Ew`;uF_+XO%=RSXbNiYt*TENV4 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ξnD3BfW#Phcc?txrKWNgo226e4 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%0DVm6x5+LM`j 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

    s83W8ncONK7obQ!h_YAl$hq! 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 literal 0 HcmV?d00001 diff --git a/noir/noir-repo/docs/static/img/debugger/7-break.png b/noir/noir-repo/docs/static/img/debugger/7-break.png new file mode 100644 index 0000000000000000000000000000000000000000..aca5121d722eba6a117f9400ec310103eb6e0f0f GIT binary patch literal 627627 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

    2. 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�mlja@7 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%0DqUd!#CQChK*` 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