Merge pull request #617 from demergent-labs/583_final_benchmarking

583 final benchmarking

README.md

@@ -2438,6 +2438,34 @@ The following is a comparison of all of the major features of the [Rust CDK](htt
 
 ### Benchmarks
 
+#### TLDR
+
+Last major update to this benchmarking information: August 2022
+
+Here's a quick rough estimate summary of the benchmarks:
+
+-   Average/Median Azle Wasm instructions per function call: 121_919_698 / 2_387_322
+-   Average/Median Motoko Wasm instructions per function call: 272_877 / 5_169
+-   Average/Median Rust Wasm instructions per function call: 26_378_678 / 44_074
+
+-   Average/Median Azle/Motoko Wasm instructions difference: 1_273x / 396x
+-   Average/Median Azle/Rust Wasm instructions difference: 204x / 51x
+-   Average/Median Motoko/Rust Wasm instructions difference: -22x / -8x
+
+-   Average/Median Azle/Motoko USD cost estimate difference using average Wasm instructions: 5x / 3x
+-   Maximum Azle/Motoko USD cost estimate difference using average Wasm instructions: 13x
+
+-   Average/Median Azle/Rust USD cost estimate difference using average Wasm instructions: 2x / 2x
+-   Maximum Azle/Rust USD cost estimate difference using average Wasm instructions: 4x
+
+-   Average/Median Azle/Motoko USD cost difference using median Wasm instructions: 1x / 1x
+-   Maximum Azle/Motoko USD cost difference using median Wasm instructions: 1x
+
+-   Average/Median Azle/Rust USD cost difference using median Wasm instructions: 1x / 1x
+-   Maximum Azle/Rust USD cost difference using median Wasm instructions: 1x
+
+#### Introduction to the Benchmarks
+
 Azle's automated benchmarking framework is currently based on the `ic0.performance_counter` [System API](https://internetcomputer.org/docs/current/references/ic-interface-spec/#system-api-imports). `ic0.performance_counter` seems to have a number of limitations. The following may not be measured accurately:
 
 -   Candid serialization/deserialization of function parameters and return types