Xpersona
agentCLAWHUBUnverified

circle chain skill

JavaScript SDK and CLI for Circle Chain (@lidh04/circle-chain-sdk): user auth, wallet, block, miner, transfers, contacts. Global CLI binary `circle`. Skill: circle chain skill Owner: lidh04 Summary: JavaScript SDK and CLI for Circle Chain (@lidh04/circle-chain-sdk): user auth, wallet, block, miner, transfers, contacts. Global CLI binary circle. Tags: latest:1.1.2 Version history: v1.1.2 | 2026-06-24T02:04:00.658Z | user 1.1.2 - Adds persistent HTTP config overrides in ~/.ccl/http.config with merging behavior. - New CLI group: circle config show / circle config set

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.0k

Updated

Oct 11, 2026

Version

1.1.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 11, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 11, 2026
Adoption signal
1K downloadsadoption · observed Oct 11, 2026
Latest release
1.1.2release · observed Jun 24, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s178wvjbgx210ctbkegjy7pdad884ca4:circle-chain
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-lidh04-circle-chain/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

18,545 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: circle-chain-js-sdk
description: JavaScript SDK and CLI for Circle Chain (@lidh04/circle-chain-sdk): user auth,
  wallet, block, miner, transfers, contacts, HTTP config. Global CLI binary `circle`. Use when
  working in js-circle-chain-sdk, integrating Circle Chain from Node/browser, or
  when the user mentions circle-chain SDK, @lidh04/circle-chain-sdk, local mining,
  or the circle CLI.
---

# Circle Chain JavaScript SDK

## Package and layout

- **npm**: `@lidh04/circle-chain-sdk` — local dependency: `npm i @lidh04/circle-chain-sdk`
- **Default export**: an object with namespaces `user`, `wallet`, `block`, `node`, `miner`, `common` — e.g. `import sdk from '@lidh04/circle-chain-sdk'` then `const { user, wallet, miner } = sdk`. README snippets use bare names like `login`, `createWallet`; bind them from the matching namespace (`user.login`, `wallet.createWallet`, etc.).
- **Source repo**: `src/` — `circle-user.js`, `circle-wallet.js`, `circle-block.js`, `circle-node.js`, `circle-miner.js`, `circle-common.js`; CLI under `src/cli/`.

## Development workflow

1. **Build**: `npm run build` — outputs `dist/cjs` and `dist/mjs` (TypeScript + fixup).
2. **Tests**: Run `npm run build` before `npm test` when suites need fresh `dist/`. CLI-only: `npm run test:cli` (builds, then Jest matches `dist/cjs/cli`).
3. **CLI from a clone**: after build, `npm run cli -- <args>` or `node ./dist/mjs/cli/main.js <args>`.

## CLI (Commander.js)

Published executable name: **`circle`** (see `package.json` `"bin"` → `dist/mjs/cli/main.js`).

### Install globally

```bash
npm install -g @lidh04/circle-chain-sdk
circle --help
```

### Using `circle`

- **`-d` / `--dev`** — use `http://localhost:8888` instead of production (e.g. `circle --dev user login-send-code --email [email protected]`).
- Subcommand groups: **user**, **wallet**, **block**, **miner**, **config**. Discover flags with `circle <group> --help`.

```bash
circle --help
circle user --help
circle user login-send-code --email [email protected]
circle wallet query public-balance --address <addr>
circle block header-list --base-height 0
circle miner mine --address <your-miner-address>
circle config show
circle config set --host your.api.example --timeout-read 8000
```

### `circle config` (HTTP settings)

User overrides are stored under **`~/.ccl/`** (or `%USERPROFILE%\.ccl\` on Windows) and apply to the Node.js SDK and CLI.

| Command | Purpose |
| -------- | -------- |
| `circle config show` | Print **effective** HTTP settings (bundled defaults + `http.config` + Geo hint when applicable). |
| `circle config set …` | Merge options into **`~/.ccl/http.config`** (JSON). At least one flag required. |

Supported flags for `config set`:

- `--host`, `--protocol` (`http` \| `https`)
- `--timeout-read`, `--timeout-write` (milliseconds, non‑negative integers as strings in config)
- `--retry-count`, `--retry-wait-time`
- `--ssl-support` (`true` \| `false`)

Example:

```bash
circle config set --host api.example.com --

_meta.json

{
  "ownerId": "kn71y801nzhazxtj1t2ymyqamn82nd7g",
  "slug": "circle-chain",
  "version": "1.1.2",
  "publishedAt": 1782266640658
}

skill-card.md

## Description:

JavaScript SDK and CLI guidance for Circle Chain, covering user authentication, wallet operations, blocks, mining, transfers, contacts, and HTTP configuration.

This skill is ready for commercial/non-commercial use.

## Publisher:

[lidh04](https://clawhub.ai/user/lidh04)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and engineers use this skill when integrating Circle Chain from Node.js or browser code, using the circle CLI, or maintaining the @lidh04/circle-chain-sdk package.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill relies on an external npm package for wallet, account, transfer, and payment-password workflows.

Mitigation: Use a reviewed pinned package version and avoid entering account, wallet, or payment-password data until package provenance and behavior are acceptable.

Risk: The SDK may contact a GeoIP service to choose the gateway host.

Mitigation: Set an explicit gateway host or set CIRCLE_SKIP_GEO=1 when automatic GeoIP-based host selection is not desired.

Risk: Global installation exposes the circle command from the trusted package on the local system.

Mitigation: Avoid global installation unless the circle command is required; prefer local project installation for scoped use.

## Reference(s):

- [Circle Chain Skill on ClawHub](https://clawhub.ai/lidh04/skills/circle-chain)
- [Publisher Profile](https://clawhub.ai/user/lidh04)
- [ipwho.is GeoIP Service](https://ipwho.is/)

## Skill Output:

**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]

**Output Format:** [Markdown with inline JavaScript and shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include CLI commands, SDK usage patterns, and HTTP configuration guidance.]

## Skill Version(s):

1.1.2 (source: server release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Related agents

Same protocol, similar job.

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/lidh04/skills/circle-chain",
      "sourceUrl": "https://clawhub.ai/lidh04/skills/circle-chain",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T16:51:21.143Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lidh04-circle-chain/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lidh04-circle-chain/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-11T16:51:21.143Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1K downloads",
      "href": "https://clawhub.ai/lidh04/circle-chain",
      "sourceUrl": "https://clawhub.ai/lidh04/circle-chain",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-11T16:51:21.143Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.1.2",
      "href": "https://clawhub.ai/lidh04/circle-chain",
      "sourceUrl": "https://clawhub.ai/lidh04/circle-chain",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-24T02:04:00.658Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-lidh04-circle-chain/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-lidh04-circle-chain/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.1.2",
      "description": "### 1.1.2 - Adds persistent HTTP config overrides in `~/.ccl/http.config` with merging behavior. - New CLI group: `circle config show` / `circle config set` for inspecting and updating HTTP settings. - Implements Node.js-only GeoIP logic: `common.getGatewayHttp()` auto-selects API host (`circle-node.net` for CN, `www.circlecoin.me` otherwise), with sign-off by user config or `CIRCLE_SKIP_GEO=1`. - Exposes new helper functions via the `common` namespace for config paths, merging, and host selection. - Includes new tests for GeoIP/cache/config and live HTTP config structures. - Minor build/tooling: CLI entry gains execute bit via build fixup.",
      "href": "https://clawhub.ai/lidh04/circle-chain",
      "sourceUrl": "https://clawhub.ai/lidh04/circle-chain",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-06-24T02:04:00.658Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 11, 2026.

Sponsored

Ads related to circle chain skill and adjacent AI workflows.