first release

Author: ilyar

.env.example

@@ -0,0 +1,6 @@
+WALLET_MNEMONIC="mnemonic words..."
+WALLET_VERSION="v4" # "v1r1" | "v1r2" | "v1r3" | "v2r1" | "v2r2" | "v3r1" | "v3r2" | "v4" | "v5r1"
+TONCENTER_ENDPOINT="https://testnet.toncenter.com/api/v2/"
+TONCENTER_TYPE="testnet"
+TONCENTER_VERSION="v2"
+TONCENTER_KEY="see https://t.me/toncenter"

.github/workflows/qa.yml

@@ -0,0 +1,42 @@
+name: qa
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+    paths:
+      - '.github/**'
+      - 'contracts/**'
+      - 'scripts/**'
+      - 'tests/**'
+      - 'wrappers/**'
+      - 'jest.config.ts'
+      - 'package.json'
+      - 'pnpm-lock.yaml'
+      - 'tsconfig.json'
+
+jobs:
+  qa:
+    runs-on: ubuntu-latest
+    permissions: write-all
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ever-guild/tvm-action@v1
+        with:
+          args: tlbc -v -t -q  contracts/SampleBench.tlb
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'pnpm'
+          cache-dependency-path: '**/pnpm-lock.yaml'
+      - run: |
+          pnpm install
+          pnpm lint
+          pnpm build-all
+          pnpm test

.gitignore

@@ -0,0 +1,22 @@
+node_modules
+temp
+build
+dist
+.DS_Store
+
+# VS Code
+.vscode/*
+.history/
+*.vsix
+
+# IDEA files
+.idea
+
+# VIM
+Session.vim
+.vim/
+
+# Other private editor folders
+.nvim/
+.emacs/
+.helix/

.prettierignore

@@ -0,0 +1 @@
+build

LICENSE

@@ -0,0 +1,15 @@
+import 'dotenv/config'
+import { Config } from '@ton/blueprint';
+
+export const config: Config = {
+    network: {
+        endpoint: process.env.TONCENTER_ENDPOINT ?? 'https://toncenter.com/api/v3/jsonRPC',
+        // @ts-ignore
+        type: process.env.TONCENTER_TYPE ?? 'testnet',
+        // @ts-ignore
+        version: process.env.TONCENTER_VERSION ?? 'v3',
+        key: process.env.TONCENTER_KEY,
+    },
+};
+
+

blueprint.config.ts

@@ -0,0 +1,12 @@
+# Change Log
+
+All notable changes to the Sample Blueprint project will be documented in this file
+
+## [1.0.0] - 2025-??-??
+
+- [ ] ???
+- [ ] ???
+- [ ] ???
+- [ ] ???
+- [ ] ???
+- [ ] ???

changelog.md

@@ -0,0 +1,36 @@
+#include "lib/SampleBench.auto.fc";
+#include "lib/stdlib.fc";
+
+;; recv_internal is the main function of the contract
+;; and is called when it receives a message from other contracts
+() recv_internal(cell msg, slice body) impure {
+    ;; ignore all empty messages
+    if (body.slice_empty?()) {
+        return ();
+    }
+    slice cs = msg.begin_parse();
+    int flags = cs~load_uint(4);
+    ;; ignore all bounced messages
+    if (flags & 1) {
+        return ();
+    }
+    ;; here we populate the storage variables
+    load_state();
+    ;; by convention, the first 32 bits of incoming message is the op
+    int op = body~load_op();
+    ;; by convention, the next 64 bits contain the "query id", although this is not always the case
+    body~skip_query_id();
+    ;; actiom message procesed
+    int change = body~load_change();
+    if (op == OP_INCR) {
+        counter += change;
+        save_state();
+        return ();
+    } elseif (op == OP_DECR) {
+        counter -= change;
+        save_state();
+        return ();
+    }
+    ;; if the message contains an op that is not known to this contract, we throw
+    throw(0xffff);
+}

contracts/SampleBench.fc

@@ -0,0 +1,34 @@
+message(0x49533468) Incr {
+    queryId: Int as uint64;
+    change: Int as uint8;
+}
+
+message(0x0ee52db3) Decr {
+    queryId: Int as uint64;
+    change: Int as uint8;
+}
+
+struct State {
+    id: Int as uint32;
+    counter: Int as int32;
+}
+
+contract SampleBench(id: Int as uint32, counter: Int as int32) {
+    // Empty receiver for the deployment, which expects the `null` message body
+    receive() { }
+
+    receive(msg: Incr) {
+        self.counter += msg.change;
+    }
+
+    receive(msg: Decr) {
+        self.counter -= msg.change;
+    }
+
+    get fun state(): State {
+        return State {
+            id: self.id,
+            counter: self.counter,
+        };
+    }
+}

contracts/SampleBench.tact

@@ -0,0 +1,18 @@
+_ id:uint32 counter:int32 = State;
+
+action_incr#49533468 queryId:uint64 change:uint8 = IncrAction;
+action_decr#0ee52db3 queryId:uint64 change:uint8 = DecrAction;
+_ _:IncrAction = Action;
+_ _:DecrAction = Action;
+
+// (crc16('state') & 0xffff) | 0x10000
+get_state#12f15 result:State = GetState;
+_ _:GetState = Gertter;
+
+// tlbc -qvvv contracts/SampleBench.tlb 2>&1 | tee build/SampleBench.txt
+// tlbc -o build/SampleBench -n SampleBench -z contracts/SampleBench.tlb
+// npx @ton-community/tlb-codegen -o wrappers/SampleBench.schema.ts contracts/SampleBench.tlb
+
+// experemental
+// npx @ton-community/tlb-codegen -o contracts/lib/SampleBench.auto.fc contracts/SampleBench.tlb
+// npx @ton-community/tlb-codegen -o contracts/lib/SampleBench.auto.tolk contracts/SampleBench.tlb