@trucore/openclaw-atf 0.1.0 → 0.1.1

package/README.md

@@ -190,11 +190,58 @@ Full docs: [docs/runbooks/agent-adoption-atf.md](../../docs/runbooks/agent-adopt
 
 ---
 
+## Jupiter Endpoint Configuration
+
+ATF swap commands use the canonical Jupiter v6 production endpoint by default:
+
+```text
+https://quote-api.jup.ag/v6
+```
+
+Override via environment:
+
+| Variable | Purpose |
+| --- | --- |
+| `ATF_JUPITER_BASE` | Full override (takes priority over all other settings) |
+| `ATF_JUPITER_API_KEY` | API key for x-api-key header (never logged) |
+| `ATF_JUPITER_PREPROD` | Set to `1` for preprod endpoint (explicit opt-in only) |
+
+Or via ATF profile config: `jupiter_quote_url` / `jupiter_swap_url`.
+
+---
+
+## Fallback: Direct CLI (if plugin install fails)
+
+If `openclaw plugins install @trucore/openclaw-atf` is unavailable:
+
+```sh
+# Install ATF CLI directly
+npm install -g @trucore/atf
+
+# Bootstrap
+atf bootstrap --recipe bootstrap_local --execute-safe
+
+# Protect an intent
+echo '{"chain_id":"solana","intent_type":"swap","intent":{...}}' | atf bot protect --stdin
+
+# Verify receipt
+atf receipts verify --receipt sha256:aabbcc...
+
+# Report savings
+atf report savings --receipts-dir ./atf_receipts --format json
+```
+
+The plugin is an optional convenience layer. All ATF security guarantees
+work identically via direct CLI.
+
+---
+
 ## Tests
 
 ```sh
 cd packages/openclaw-atf
 node --test tests/test_tools.mjs
+node --test tests/test_plugin_package.mjs
 ```
 
 All tests are offline. No network calls. No ATF CLI required.

package/openclaw.plugin.json

@@ -1,10 +1,11 @@
 {
   "id": "trucore-atf",
   "name": "TruCore ATF",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Transaction firewall tools for autonomous finance agents: protect + verify + report savings. ATF evaluates swap, lend, and perps intents against policy before they reach the chain. Never signs. Deny-by-default.",
   "homepage": "https://github.com/trucore-ai/agent-transaction-firewall",
   "main": "src/index.mjs",
+  "extensions": ["src/index.mjs"],
   "tools": "optional",
   "configSchema": {
     "$schema": "http://json-schema.org/draft-07/schema#",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trucore/openclaw-atf",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenClaw plugin — ATF transaction firewall tools for autonomous agents: discover, protect, verify, report savings.",
   "license": "MIT",
   "type": "module",
@@ -40,6 +40,11 @@
   "engines": {
     "node": ">=18"
   },
+  "openclaw": {
+    "extensions": [
+      "openclaw.plugin.json"
+    ]
+  },
   "peerDependencies": {
     "openclaw": "*"
   },
@@ -49,7 +54,9 @@
     }
   },
   "scripts": {
-    "test": "node --test tests/test_tools.mjs"
+    "test": "node --test tests/test_tools.mjs",
+    "validate": "node tests/test_plugin_package.mjs",
+    "prepublishOnly": "npm run validate && npm run test"
   },
   "dependencies": {}
 }