feat: qubic solana smart contract (review only)

.gitignore

@@ -14,6 +14,7 @@ x64/
 .clang-format
 tmp
 build/
+build-test/
 /build**
 
 # Build directories and temporary files
@@ -31,4 +32,4 @@ CLAUDE.md
 
 # Explorer embedded assets (generated by regen.sh at build)
 src/extensions/http/controller/explorer_assets.generated.h
-crash.dump
+crash.dump

README_CLANG.md

@@ -78,3 +78,56 @@ For a example compilation execute the following commands:
     ```
 
 The output binary will be located at `build/src`
+
+## Running Tests
+
+### Configure (once)
+
+Use a dedicated build directory to avoid mixing test and release artifacts:
+
+```bash
+cd /path/to/core-lite
+
+cmake -S . -B build-test \
+  -DCMAKE_CXX_COMPILER=clang-18 \
+  -DCMAKE_BUILD_TYPE=Debug \
+  -DBUILD_TESTS=ON \
+  -DBUILD_BINARY=OFF \
+  -DUSE_SANITIZER=OFF
+```
+
+### Compile
+
+```bash
+cmake --build build-test --target qubic_core_tests -j$(nproc)
+```
+
+> **Known linker issue on Ubuntu (clang-18 + GCC stdlib mix):**
+> The link step may fail with `undefined reference to '__cxa_pure_virtual'` or
+> `vtable for __cxxabiv1::...`. Work around it by appending `-lc++abi -lstdc++`
+> manually after compilation completes:
+>
+> ```bash
+> cd build-test/test
+> eval "$(cat CMakeFiles/qubic_core_tests.dir/link.txt) -lc++abi -lstdc++"
+> ```
+>
+> Prerequisites: `sudo apt install libc++abi-dev libstdc++-12-dev`
+
+### Run all tests
+
+```bash
+./build-test/test/qubic_core_tests
+```
+
+### Run QSB contract tests only
+
+```bash
+./build-test/test/qubic_core_tests --gtest_filter="ContractTestingQSB*"
+```
+
+### Run a single test
+
+```bash
+./build-test/test/qubic_core_tests --gtest_filter="ContractTestingQSB.TestOverrideLock_BlockedAfterMaxAttempts"
+```

docker/orchestrator/Dockerfile

@@ -41,7 +41,6 @@ RUN rm -rf build \
         -D BUILD_BINARY:BOOL=ON \
         -D CMAKE_BUILD_TYPE=Release \
         -D ENABLE_AVX512=OFF \
-        -D ONLY_LOGGING=ON \
     && cmake --build . --target Qubic -- -j$(nproc)
 
 # Collect build outputs into a common location

src/Qubic.vcxproj

@@ -50,6 +50,7 @@
     <ClInclude Include="contracts\Qusino.h" />
     <ClInclude Include="contracts\QReservePool.h" />
     <ClInclude Include="contracts\QThirtyFour.h" />
+    <ClInclude Include="contracts\QubicSolanaBridge.h" />
     <ClInclude Include="contracts\Pulse.h" />
     <ClInclude Include="contracts\Escrow.h" />
     <ClInclude Include="contracts\GGWP.h" />

src/Qubic.vcxproj.filters

@@ -320,6 +320,10 @@
     <ClInclude Include="contracts\QDuel.h">
       <Filter>contracts</Filter>
     </ClInclude>
+
+    <ClInclude Include="contracts\QubicSolanaBridge.h">
+      <Filter>contracts</Filter>
+    </ClInclude>
     <ClInclude Include="contracts\Pulse.h">
       <Filter>contracts</Filter>
     </ClInclude>

src/contract_core/contract_def.h

@@ -282,25 +282,31 @@
 #undef CONTRACT_STATE_TYPE
 #undef CONTRACT_STATE2_TYPE
 
-#define ESCROW_CONTRACT_INDEX 27
-#define CONTRACT_INDEX ESCROW_CONTRACT_INDEX
-#define CONTRACT_STATE_TYPE ESCROW
-#define CONTRACT_STATE2_TYPE ESCROW2
-#include "contracts/Escrow.h"
-
-#ifndef NO_GGWP
-
-#undef CONTRACT_INDEX
-#undef CONTRACT_STATE_TYPE
-#undef CONTRACT_STATE2_TYPE
-
-#define WOLFPACK_CONTRACT_INDEX 28
-#define CONTRACT_INDEX WOLFPACK_CONTRACT_INDEX
-#define CONTRACT_STATE_TYPE WOLFPACK
-#define CONTRACT_STATE2_TYPE WOLFPACK2
-#include "contracts/GGWP.h"
-
-#endif
+#define ESCROW_CONTRACT_INDEX 27
+#define CONTRACT_INDEX ESCROW_CONTRACT_INDEX
+#define CONTRACT_STATE_TYPE ESCROW
+#define CONTRACT_STATE2_TYPE ESCROW2
+#include "contracts/Escrow.h"
+
+#undef CONTRACT_INDEX
+#undef CONTRACT_STATE_TYPE
+#undef CONTRACT_STATE2_TYPE
+
+#define WOLFPACK_CONTRACT_INDEX 28
+#define CONTRACT_INDEX WOLFPACK_CONTRACT_INDEX
+#define CONTRACT_STATE_TYPE WOLFPACK
+#define CONTRACT_STATE2_TYPE WOLFPACK2
+#include "contracts/GGWP.h"
+
+#undef CONTRACT_INDEX
+#undef CONTRACT_STATE_TYPE
+#undef CONTRACT_STATE2_TYPE
+
+#define QSB_CONTRACT_INDEX 29
+#define CONTRACT_INDEX QSB_CONTRACT_INDEX
+#define CONTRACT_STATE_TYPE QSB
+#define CONTRACT_STATE2_TYPE QSB2
+#include "contracts/QubicSolanaBridge.h"
 
 // new contracts should be added above this line
 
@@ -413,13 +419,12 @@ constexpr struct ContractDescription
 	{"QTF", 199, 10000, sizeof(QTF::StateData)}, // proposal in epoch 197, IPO in 198, construction and first use in 199
     {"QDUEL", 199, 10000, sizeof(QDUEL::StateData)}, // proposal in epoch 197, IPO in 198, construction and first use in 199
 	{"PULSE", 204, 10000, sizeof(PULSE::StateData)}, // proposal in epoch 202, IPO in 203, construction and first use in 204
-    {"VOTTUN", 206, 10000, sizeof(VOTTUNBRIDGE::StateData)}, // proposal in epoch 204, IPO in 205, construction and first use in 206
-    {"QUSINO", 208, 10000, sizeof(QUSINO::StateData)}, // proposal in epoch 206, IPO in 207, construction and first use in 208
-    {"ESCROW", 210, 10000, sizeof(ESCROW::StateData)}, // proposal in epoch 208, IPO in 209, construction and first use in 210
-#ifndef NO_GGWP
-    {"GGWP", 217, 10000, sizeof(WOLFPACK::StateData)}, // proposal in epoch 215, IPO in 216, construction and first use in 217
-#endif
-    // new contracts should be added above this line
+    {"VOTTUN", 206, 10000, sizeof(VOTTUNBRIDGE::StateData)}, // proposal in epoch 204, IPO in 205, construction and first use in 206
+    {"QUSINO", 208, 10000, sizeof(QUSINO::StateData)}, // proposal in epoch 206, IPO in 207, construction and first use in 208
+    {"ESCROW", 210, 10000, sizeof(ESCROW::StateData)}, // proposal in epoch 208, IPO in 209, construction and first use in 210
+    {"GGWP", 217, 10000, sizeof(WOLFPACK::StateData)}, // proposal in epoch 215, IPO in 216, construction and first use in 217
+    {"QSB", 216, 10000, sizeof(QSB::StateData)}, // local testnet: align constructionEpoch with current testnet epoch so INITIALIZE runs on clean reset
+    // new contracts should be added above this line
 #ifdef INCLUDE_CONTRACT_TEST_EXAMPLES
     {"TESTEXA", 138, 10000, sizeof(TESTEXA::StateData)},
     {"TESTEXB", 138, 10000, sizeof(TESTEXB::StateData)},
@@ -539,13 +544,12 @@ static void initializeContracts()
     REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(QTF);
     REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(QDUEL);
 	REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(PULSE);
-    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(VOTTUNBRIDGE);
-    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(QUSINO);
-    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(ESCROW);
-#ifndef NO_GGWP
-    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(WOLFPACK);
-#endif
-    // new contracts should be added above this line
+    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(VOTTUNBRIDGE);
+    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(QUSINO);
+    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(ESCROW);
+    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(WOLFPACK);
+    REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(QSB);
+    // new contracts should be added above this line
 #ifdef INCLUDE_CONTRACT_TEST_EXAMPLES
     REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(TESTEXA);
     REGISTER_CONTRACT_FUNCTIONS_AND_PROCEDURES(TESTEXB);