@t54-labs/clawcredit-sdk 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,120 @@
+# 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
+```
+
+Configure token via CLI (recommended for humans, not agents):
+
+```bash
+clawcredit configure --token YOUR_API_TOKEN --service-url https://api.claw.credit
+```
+
+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/SKILL.md

@@ -1,8 +1,13 @@
+---
+name: clawcredit
+description: ClawCredit integration for Open Claw Agents (registration, trace, and payments).
+---
+
 # ClawCredit Integration Skill
 
 ## 1. Overview
 This skill allows Open Claw Agents to access **ClawCredit**, a decentralized credit service.
-By integrating the `@clawcredit/sdk`, agents can:
+By integrating the `@t54-labs/clawcredit-sdk`, agents can:
 1.  **Get a Credit Line**: Prove your worth (code, prompt, environment) and get funded.
 2.  **Pay for Services**: Use your credit to pay other agents/merchants via x402.
 3.  **Build Credit**: Good repayment and low-risk behavior increases your limit.

package/bin/clawcredit.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+const { loadConfig, saveConfig, DEFAULT_SERVICE_URL } = require('../lib/config');
+
+function printHelp() {
+    console.log(`
+ClawCredit CLI
+
+Usage:
+  clawcredit configure --token <API_TOKEN> [--service-url <URL>] [--agent <id>]
+  clawcredit show [--agent <id>]
+
+Notes:
+  - Config is stored at: ~/.openclaw/agents/<agent>/agent/clawcredit.json
+  - You can override the config path with CLAWCREDIT_CONFIG
+`);
+}
+
+function parseArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const key = argv[i];
+        if (!key.startsWith('--')) continue;
+        const value = argv[i + 1];
+        args[key.slice(2)] = value;
+        i += 1;
+    }
+    return args;
+}
+
+async function main() {
+    const [,, command, ...rest] = process.argv;
+    const args = parseArgs(rest);
+    const agent = args.agent || 'default';
+
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        printHelp();
+        return;
+    }
+
+    if (command === 'configure' || command === 'set-token') {
+        const token = args.token;
+        const serviceUrl = args['service-url'] || DEFAULT_SERVICE_URL;
+
+        if (!token) {
+            console.error('Missing --token');
+            process.exit(1);
+        }
+
+        const configPath = saveConfig({ agent, token, serviceUrl });
+        console.log(`Saved: ${configPath}`);
+        return;
+    }
+
+    if (command === 'show') {
+        const { configPath, data, error } = loadConfig(agent);
+        if (error) {
+            console.error(`Failed to read ${configPath}: ${error.message}`);
+            process.exit(1);
+        }
+        if (!data) {
+            console.log(`No config found at: ${configPath}`);
+            process.exit(0);
+        }
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exit(1);
+}
+
+main();
+

package/index.js

@@ -2,12 +2,19 @@ const axios = require('axios');
 const { v4: uuidv4 } = require('uuid');
 const { audit, getAuditedSnapshot } = require('./lib/audit');
 const { wrapOpenAI, withTrace, getTraceContext } = require('./lib/monitor');
+const { loadConfig, DEFAULT_SERVICE_URL } = require('./lib/config');
 
 class ClawCredit {
     constructor(config = {}) {
-        this.serviceUrl = config.serviceUrl || 'https://api.clawcredit.com'; // Default production URL
+        const agent = config.agent || 'default';
+        const loaded = loadConfig(agent);
+        const loadedData = loaded.data || {};
+
+        this.serviceUrl = config.serviceUrl
+            || loadedData.serviceUrl
+            || DEFAULT_SERVICE_URL;
         this.agentName = config.agentName;
-        this.apiToken = config.apiToken; // Token stored after registration
+        this.apiToken = config.apiToken || loadedData.apiToken; // Token stored after registration
         this.agentId = config.agentId;
     }
 

package/lib/config.js

@@ -0,0 +1,50 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const DEFAULT_SERVICE_URL = 'https://api.claw.credit';
+
+function getDefaultConfigPath(agent = 'default') {
+    const home = os.homedir();
+    return path.join(home, '.openclaw', 'agents', agent, 'agent', 'clawcredit.json');
+}
+
+function loadConfig(agent = 'default') {
+    const overridePath = process.env.CLAWCREDIT_CONFIG;
+    const configPath = overridePath || getDefaultConfigPath(agent);
+
+    if (!fs.existsSync(configPath)) {
+        return { configPath, data: null };
+    }
+
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const data = JSON.parse(raw);
+        return { configPath, data };
+    } catch (err) {
+        return { configPath, data: null, error: err };
+    }
+}
+
+function saveConfig({ agent = 'default', token, serviceUrl }) {
+    const configPath = getDefaultConfigPath(agent);
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+
+    const payload = {
+        apiToken: token,
+        serviceUrl: serviceUrl || DEFAULT_SERVICE_URL,
+        updatedAt: new Date().toISOString()
+    };
+
+    fs.writeFileSync(configPath, JSON.stringify(payload, null, 2));
+    return configPath;
+}
+
+module.exports = {
+    DEFAULT_SERVICE_URL,
+    getDefaultConfigPath,
+    loadConfig,
+    saveConfig
+};
+

package/package.json

@@ -1,11 +1,21 @@
 {
   "name": "@t54-labs/clawcredit-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Integration SDK for Open Claw Agents to access ClawCredit",
   "main": "index.js",
+  "bin": {
+    "clawcredit": "bin/clawcredit.js"
+  },
+  "files": [
+    "index.js",
+    "lib",
+    "bin",
+    "README.md",
+    "SKILL.md"
+  ],
   "dependencies": {
     "axios": "^1.6.0",
     "uuid": "^9.0.0"
-  }
+  },
+  "license": "MIT"
 }
-