Merge pull request #798 from qubic/develop

Release v1.282.0 

Add QBridge contract (Vottun)
Add Oracle Documentation
Fix bug on loading execution fee after seamless epoch change
Fix problem during loading of assets from snapshot
Adjust TICK_DURATION_FOR_ALLOCATION_MS and TRANSACTION_SPARSENESS
Increase ADDITION_SOLUTION_THRESHOLD_DEFAULT to 74800

Author: fnordspace

.github/workflows/contract-verify.yml

@@ -39,6 +39,6 @@ jobs:
           echo "contract-filepaths=$files" >> "$GITHUB_OUTPUT"
       - name: Contract verify action step
         id: verify
-        uses: Franziska-Mueller/qubic-contract-verify@v1.0.4
+        uses: Franziska-Mueller/qubic-contract-verify@v1.0.5
         with:
           filepaths: '${{ steps.filepaths.outputs.contract-filepaths }}'

README.md

@@ -150,5 +150,6 @@ We cannot support you in any case. You are welcome to provide updates, bug fixes
 - [Qubic protocol](doc/protocol.md)
 - [Custom mining](doc/custom_mining.md)
 - [Seamless epoch transition](SEAMLESS.md)
+- [Querying oracles](doc/contracts_oracles.md)
 - [Proposals and voting](doc/contracts_proposals.md)
 

doc/OracleEngine.png

@@ -478,6 +478,12 @@ QX never releases shares passively (following call of `qpi.acquireShares()` by a
 The callbacks `PRE_RELEASE_SHARES()` and `PRE_ACQUIRE_SHARES()` may also check that the `qpi.originator()` initiating the transfer is the owner/possessor.
 
 
+## Querying off-chain data from Oracles
+
+Oracles enable Smart Contracts to actively query off-chain data sources called Oracles.
+Read [Querying Oracles from Contracts](contracts_oracles.md) for more details.
+
+
 ## Other QPI features
 
 ### Container types

doc/OracleEngine.svg

@@ -26,7 +26,6 @@
     <ClInclude Include="contracts\Qdraw.h" />
     <ClInclude Include="contracts\qRWA.h" />
     <ClInclude Include="contracts\Qswap.h" />
-    <ClInclude Include="contracts\QVAULT_old.h" />
     <ClInclude Include="contracts\RandomLottery.h" />
     <ClInclude Include="contracts\QDuel.h" />
     <ClInclude Include="contracts\SupplyWatcher.h" />

doc/contracts.md

@@ -365,9 +365,6 @@
     <ClInclude Include="oracle_core\snapshot_files.h">
       <Filter>oracle_core</Filter>
     </ClInclude>
-    <ClInclude Include="contracts\QVAULT_old.h">
-      <Filter>contracts</Filter>
-    </ClInclude>
   </ItemGroup>
   <ItemGroup>
     <Filter Include="platform">
@@ -418,4 +415,4 @@
       <Filter>platform</Filter>
     </MASM>
   </ItemGroup>
-</Project>
+</Project>

doc/contracts_oracles.md

@@ -14,6 +14,7 @@
 #include "contract_core/contract_def.h"
 
 #include "public_settings.h"
+#include "private_settings.h"
 #include "logging/logging.h"
 #include "kangaroo_twelve.h"
 #include "four_q.h"
@@ -771,7 +772,7 @@ static bool saveUniverse(const CHAR16* fileName = UNIVERSE_FILE_NAME, const CHAR
     return false;
 }
 
-static bool loadUniverse(const CHAR16* fileName = UNIVERSE_FILE_NAME, CHAR16* directory = NULL)
+static bool loadUniverse(const CHAR16* fileName = UNIVERSE_FILE_NAME, CHAR16* directory = NULL, bool rebuildIndexLists = true)
 {
     PROFILE_SCOPE();
 
@@ -782,9 +783,38 @@ static bool loadUniverse(const CHAR16* fileName = UNIVERSE_FILE_NAME, CHAR16* di
 
         return false;
     }
-    as.indexLists.rebuild();
+
+    if (rebuildIndexLists)
+        as.indexLists.rebuild();
+
+    return true;
+}
+
+#if TICK_STORAGE_AUTOSAVE_MODE
+static bool saveSnapshotUniverseIndex(const CHAR16* fileName, const CHAR16* directory = NULL)
+{
+    long long savedSize = save(fileName, sizeof(as.indexLists), (unsigned char*)&as.indexLists, directory);
+    logToConsole(L"Saving universe index");
+    if (savedSize != sizeof(as.indexLists))
+    {
+        logToConsole(L"Failed to save universe index");
+        return false;
+    }
+    return true;
+}
+
+static bool loadSnapshotUniverseIndex(const CHAR16* fileName, CHAR16* directory = NULL)
+{
+    long long loadedSize = load(fileName, sizeof(as.indexLists), (unsigned char*)&as.indexLists, directory);
+    logToConsole(L"Loading universe index");
+    if (loadedSize != sizeof(as.indexLists))
+    {
+        logToConsole(L"Failed to load universe index");
+        return false;
+    }
     return true;
 }
+#endif
 
 static void assetsEndEpoch()
 {

src/Qubic.vcxproj

@@ -135,14 +135,14 @@ static void processRequestAssetsSendRecord(Peer* peer, RequestResponseHeader* re
 
 static void processRequestAssets(Peer* peer, RequestResponseHeader* header)
 {
-    // check size of recieved message (request by universe index may be smaller than sizeof(RequestAssets))
+    // check size of received message (request by universe index may be smaller than sizeof(RequestAssets))
     if (!header->checkPayloadSizeMinMax(sizeof(RequestAssets::byUniverseIdx), sizeof(RequestAssets)))
         return;
     RequestAssets* request = header->getPayload<RequestAssets>();
     if (request->assetReqType != RequestAssets::requestByUniverseIdx && !header->checkPayloadSize(sizeof(RequestAssets)))
         return;
 
-    // initalize output message (with siblings because the variant without siblings is just a subset)
+    // initialize output message (with siblings because the variant without siblings is just a subset)
     struct
     {
         RequestResponseHeader header;
@@ -152,7 +152,7 @@ static void processRequestAssets(Peer* peer, RequestResponseHeader* header)
     response.header.setType(RespondAssets::type());
     response.header.setDejavu(header->dejavu());
 
-    // size of output message depends on whether sibilings are requested
+    // size of output message depends on whether siblings are requested
     if (request->byFilter.flags & RequestAssets::getSiblings)
         response.header.setSize<sizeof(RequestResponseHeader) + sizeof(RespondAssetsWithSiblings)>();
     else