OpenClaw Plugin

@trucore/trucore-atf

The official OpenClaw plugin for TruCore ATF. Install it, restart the gateway, and every agent intent passes through policy-enforced transaction protection before it reaches the chain. Thirteen tools, zero config required, fail-closed by default.

Install

Via OpenClaw gateway (recommended)

openclaw plugins install @trucore/trucore-atf
openclaw gateway restart

Via npm (pinned version)

npm i @trucore/trucore-atf@0.2.11

Published on npm. Current version: 0.2.11.

What's new in 0.2.11

Version 0.2.11 is the current published release. The package has been renamed from @trucore/openclaw-atf to @trucore/trucore-atf. This release includes the onboarding verification flow (atf_setup, browser/device claim, atf_claim_status, atf_whoami, atf_bot_preflight, atf_integration_doctor), zero-env onboarding support, and deny-by-default enforcement improvements.

Package renamed. The npm package is now @trucore/trucore-atf. Install via openclaw plugins install @trucore/trucore-atf.
Onboarding verification flow. A structured sequence for zero-env onboarding: atf_setup, browser/device claim, atf_claim_status, atf_whoami, atf_bot_preflight, atf_integration_doctor.
Deny-by-default enforcement. Deny decisions like CHAIN_NOT_SUPPORTED are policy behavior, not runtime failure.
Recursive schema guard. Deep validation on all 14 schemas (13 tools + 1 config). 756 tests pass, zero failures.

Safety defaults

The plugin ships with conservative defaults. Nothing reaches the network unless you opt in.

allowNetwork = false — the plugin cannot initiate outbound network calls unless explicitly enabled in agent config.
allowExecuteSafe = true — safe recipe steps (env checks, verification) can run automatically. No signing, no transactions.
tools = optional — agents can call atf_protect_intent directly without declaring the full tool set upfront.

Tools (13)

The plugin exposes thirteen tools. All are optional: your agent can use as few or as many as needed.

Core

atf_protect_intent

Submit a DeFi intent (swap, lend, perps) to ATF for policy evaluation. Returns a permit or denial receipt.

atf_verify_receipt

Verify an ATF receipt deterministically. Returns verified status, content_hash, and intent_hash.

atf_tx_explain

Explain an ATF deny decision or receipt in human terms. Returns reason codes, policy triggers, and remediation suggestions.

Operations

atf_health

Check ATF CLI and API backend availability. Returns health status and dependency checks.

atf_integration_doctor

Run ATF integration readiness check. Reports plugin loading status, config validity, and backend connectivity.

atf_bot_preflight

Pre-session readiness check: is ATF ready to protect intents right now? Confirms CLI, policy, and network are operational.

Bootstrap

atf_bootstrap_plan

Generate ATF bootstrap steps for a given recipe. Dry-run only, nothing is executed.

atf_bootstrap_execute_safe

Run only the safe steps of a bootstrap recipe (env setup and verification). Never runs cli steps that need network or signer access.

Discovery

atf_discover

Fetch and summarize the ATF manifest and toolcard so the agent knows what ATF offers.

Reporting

atf_report_savings

Generate a receipt-backed savings or losses-prevented report from local receipt files.

Billing

atf_billing_info

Discover ATF billing, pricing, and package metadata for the active account.

atf_billing_claim

Verify an on-chain Solana payment and process a billing claim for ATF service credits.

Advisory

atf_adoption_advisor

Evaluate bot capability signals and return a deterministic ATF adoption recommendation with next steps.

Quick workflow

A typical integration follows five steps. Copy the commands and you are protected.

Install the plugin openclaw plugins install @trucore/trucore-atf
Restart the gateway openclaw gateway restart
Run a preflight check atf_bot_preflight to confirm everything is ready.
Protect every intent Call atf_protect_intent before signing any transaction. ATF returns a permit or denial receipt.
Verify receipts and report savings Use atf_verify_receipt and atf_report_savings to build an auditable trail.

Configuration

The plugin is configured through your OpenClaw agent config. All fields are optional. Sensible defaults apply.

{
  "atfCli": "atf",
  "prefer": "cli",
  "receiptsDir": "./atf_receipts",
  "safety": {
    "allowExecuteSafe": true,
    "allowNetwork": false
  }
}

atfCli — ATF CLI command name or absolute path. Defaults to "atf".
prefer —"cli" (subprocess) or "api" (HTTP). CLI is default and does not require network access.
receiptsDir — where receipt JSON files are stored. Used by atf_report_savings.