@senpi/runtime 3.0.56 → 3.0.58

package/dist/validate/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/validate/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,+CAA+C,CAAC;AAEhF,MAAM,MAAM,YAAY;AACtB,iCAAiC;AAC/B,UAAU;AACZ,mEAAmE;GACjE,QAAQ;AACV,6CAA6C;GAC3C,aAAa;AACf,oBAAoB;GAClB,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAWlE;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAc9F"}

package/dist/validate/wallet.js

@@ -0,0 +1,66 @@
+/**
+ * Which account a live tick runs against.
+ *
+ * Executing a scanner needs an account identity — it is handed to the exchange reads the scanner
+ * makes. But during authoring no account exists yet: the wallet is created when the strategy is
+ * funded, which is deliberately after validation. So one is resolved rather than required.
+ */
+/** As the chain writes them. Shape only; whether it exists is not this layer's concern. */
+const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
+/**
+ * The stand-in used when no real account is available.
+ *
+ * Faithful rather than a workaround: an account with no history returns an empty book, which is
+ * exactly what a freshly funded strategy sees on its first tick. A scanner that breaks on an empty
+ * position list is broken, and would break identically in production — catching that is the point.
+ * The deploy preflight already validates against this same address for the same reason.
+ */
+export const PLACEHOLDER_ADDRESS = "0x0000000000000000000000000000000000000000";
+/**
+ * Resolve in order of specificity.
+ *
+ * The recipe's own wallet is preferred over any default because validating an edit to a deployed
+ * strategy against its real positions is more faithful than forcing a cold start. It is accepted
+ * only when it *looks* like an address: an unresolved placeholder is a non-empty string that the
+ * schema accepts happily, and passing that to the exchange would produce a confusing failure well
+ * away from its cause.
+ */
+export function resolveWallet(inputs) {
+    if (inputs.explicit !== undefined && ADDRESS.test(inputs.explicit)) {
+        return { address: inputs.explicit, source: "explicit", book: "real" };
+    }
+    if (inputs.fromRecipe !== undefined && ADDRESS.test(inputs.fromRecipe)) {
+        return { address: inputs.fromRecipe, source: "recipe", book: "real" };
+    }
+    if (inputs.fromEnvironment !== undefined && ADDRESS.test(inputs.fromEnvironment)) {
+        return { address: inputs.fromEnvironment, source: "environment", book: "real" };
+    }
+    return { address: PLACEHOLDER_ADDRESS, source: "placeholder", book: "empty" };
+}
+/** Whether a supplied address is well formed. Checked before anything runs. */
+export function isWellFormedAddress(value) {
+    return ADDRESS.test(value);
+}
+/**
+ * What running against this account does and does not establish.
+ *
+ * Rides the result so a caller cannot report more confidence than the run earned. Against an empty
+ * book, logic that depends on open positions never executes — which is correct for a strategy about
+ * to be funded, and worth saying out loud rather than leaving to inference.
+ */
+export function walletClaim(wallet) {
+    if (wallet.book === "real") {
+        return {
+            proves: `runnable against the live book of ${wallet.address}`,
+            doesNotProve: ["branches this tick did not take"],
+        };
+    }
+    return {
+        proves: "runnable from cold start — the state a newly funded strategy begins in",
+        doesNotProve: [
+            "logic that depends on open positions, since the account had none",
+            "branches this tick did not take",
+        ],
+    };
+}
+//# sourceMappingURL=wallet.js.map

package/dist/validate/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/validate/wallet.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,2FAA2F;AAC3F,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,4CAA4C,CAAC;AA4BhF;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAChF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,MAAsB;IAChD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,qCAAqC,MAAM,CAAC,OAAO,EAAE;YAC7D,YAAY,EAAE,CAAC,iCAAiC,CAAC;SAClD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,wEAAwE;QAChF,YAAY,EAAE;YACZ,kEAAkE;YAClE,iCAAiC;SAClC;KACF,CAAC;AACJ,CAAC"}

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "runtime",
   "name": "Senpi Runtime",
   "description": "Senpi runtime plugin for OpenClaw. Orchestrates scanners, LLM-based trade decisions, and a DSL trailing stop-loss exit engine.",
-  "version": "3.0.56",
+  "version": "3.0.58",
   "commandAliases": [
     {
       "name": "senpi"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senpi/runtime",
-  "version": "3.0.56",
+  "version": "3.0.58",
   "description": "Senpi runtime plugin for OpenClaw",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,7 @@
     "copy:external-scanners": "node -e \"require('fs').rmSync('dist/scanners/external', { recursive: true, force: true }); require('fs').cpSync('src/scanners/external', 'dist/scanners/external', { recursive: true })\"",
     "copy:skills-manifest": "node -e \"require('fs').cpSync('src/skills-manager/skills-manifest.json', 'dist/skills-manager/skills-manifest.json')\"",
     "copy:approvals-manifest": "node -e \"require('fs').cpSync('src/approvals/tool-approvals-manifest.json', 'dist/approvals/tool-approvals-manifest.json')\"",
+    "fixture:tick": "node scripts/generate-tick-fixture.mjs",
     "typecheck:tests": "tsc -p tsconfig.tests.json --noEmit",
     "start": "node dist/index.js",
     "debug": "npm run build && node dist/debug.js",