@t54-labs/clawcredit-sdk 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,114 @@
+# ClawCredit SDK for Open Claw
+
+ClawCredit provides a credit line and payment workflow for Open Claw Agents using t54's Trustline and the x402 protocol.
+This SDK lets an agent register for credit, submit audit materials, and pay
+merchants with this credit service. Trustline's risk engine evaluates the
+agent's integration depth, richness of risk signals, and credit history
+(including on-time repayments and other records) to issue updated credit
+limits daily or dynamically.
+
+## About Open Claw
+
+Open Claw is an open-source agent framework that runs your personal AI assistant
+across platforms, with a gateway, skills, and channel integrations. It is
+designed to let agents run locally or remotely, with a configurable workspace
+and a modular “skills” system you can extend.  
+Repository: https://github.com/openclaw/openclaw
+
+## Quick Start
+
+Install the SDK:
+
+```bash
+npm install @t54-labs/clawcredit-sdk
+```
+
+Initialize and register:
+
+```javascript
+const { ClawCredit, audit } = require('@t54-labs/clawcredit-sdk');
+
+function myCoreLogic(input) {
+  return input * 2;
+}
+
+// Optional but recommended: capture core code for audit
+audit(myCoreLogic);
+
+const credit = new ClawCredit({
+  agentName: "MyOpenClawAgent"
+});
+
+await credit.register({
+  inviteCode: "YOUR_INVITE_CODE",
+  coreCode: "function main() { ... }",
+  systemPrompt: "You are a helpful assistant.",
+  runtimeEnv: "node-v22",
+  model: "gpt-5.2" // Optional
+});
+```
+
+## Enable Reasoning Trace (Recommended)
+
+Trace helps the risk engine evaluate why a payment is needed.
+
+```javascript
+const OpenAI = require('openai');
+const { wrapOpenAI, withTrace } = require('@t54-labs/clawcredit-sdk');
+
+const openai = wrapOpenAI(new OpenAI({ apiKey: process.env.OPENAI_API_KEY }));
+
+await withTrace(async () => {
+  await openai.chat.completions.create({
+    messages: [{ role: "user", content: "Fetch the latest BTC price." }],
+    model: "gpt-5.2"
+  });
+});
+```
+
+## Pay a Merchant
+
+```javascript
+const result = await credit.pay({
+  transaction: {
+    recipient: "merchant_address_or_id",
+    amount: 1.5,
+    chain: "BASE",
+    asset: "USDC"
+  },
+  request_body: {
+    service_name: "PremiumSearch",
+    params: { query: "BTC price" }
+  },
+  // Optional: reasoning process can increase approval probability
+  // context: { reasoning_process: "I need real-time data to answer the user." }
+});
+
+console.log(result);
+```
+
+## How an Open Claw Agent Learns This Skill
+
+Open Claw agents can be taught via a skill guide. Provide the agent with the
+`SKILL.md` in this package and instruct it to:
+
+1. Install the SDK: `npm install @t54-labs/clawcredit-sdk`
+2. Register using `credit.register()` with audit materials.
+3. Wrap the OpenAI client with `wrapOpenAI()` for trace capture.
+4. Use `credit.pay()` with `transaction` and `request_body`.
+
+The `SKILL.md` file in this package contains a step-by-step guide tailored for
+agent use. You can host it and prompt agents to read and follow it.
+
+## Exports
+
+```javascript
+const {
+  ClawCredit,
+  audit,
+  wrapOpenAI,
+  withTrace
+} = require('@t54-labs/clawcredit-sdk');
+```
+
+

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@t54-labs/clawcredit-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Integration SDK for Open Claw Agents to access ClawCredit",
   "main": "index.js",
   "dependencies": {
     "axios": "^1.6.0",
     "uuid": "^9.0.0"
-  }
+  },
+  "license": "MIT"
 }
-