← 返回 Skills 市场

Blockscout OpenAPI Skill

Name: Blockscout OpenAPI Skill
Author: jolestar

作者 jolestar · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

161

总下载

当前安装

版本数

在 OpenClaw 中安装

/install blockscout-openapi-skill

功能描述

Operate Blockscout explorer reads through UXC with a curated OpenAPI schema, instance-specific host selection, and read-first guardrails.

使用说明 (SKILL.md)

Blockscout Explorer API Skill

Use this skill to run Blockscout explorer operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

uxc is installed and available in PATH.
Network access to a Blockscout deployment that exposes /api/v2.
Access to the curated OpenAPI schema URL:
- https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
A target Blockscout instance. Examples in this skill use https://eth.blockscout.com/api/v2.

Scope

This skill covers a read-first explorer surface:

address summary lookup
address token balances
address transaction history
token metadata
token holder reads
transaction detail lookup
block detail lookup

This skill does not cover:

Blockscout GraphQL
raw JSON-RPC proxying
write operations or admin/configuration flows
custom authenticated gateways beyond what the caller explicitly binds

Authentication

Public Blockscout instances usually allow explorer reads without auth.

If you are targeting a self-hosted or gateway-protected instance, configure auth separately with standard uxc auth bindings for that host. This skill does not assume any default credential.

Core Workflow

Use the fixed link command by default:
- command -v blockscout-openapi-cli
- If missing, create it: uxc link blockscout-openapi-cli https://eth.blockscout.com/api/v2 --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json
- blockscout-openapi-cli -h
Inspect operation schema first:
- blockscout-openapi-cli get:/addresses/{address_hash} -h
- blockscout-openapi-cli get:/tokens/{address_hash} -h
- blockscout-openapi-cli get:/transactions/{hash} -h
Prefer narrow lookup validation before larger history reads:
- blockscout-openapi-cli get:/blocks/{block_number_or_hash} block_number_or_hash=latest
- blockscout-openapi-cli get:/addresses/{address_hash} address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
- blockscout-openapi-cli get:/tokens/{address_hash} address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
Execute with key/value parameters:
- blockscout-openapi-cli get:/addresses/{address_hash}/transactions address_hash=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
- blockscout-openapi-cli get:/tokens/{address_hash}/holders address_hash=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

Operation Groups

Address Reads

get:/addresses/{address_hash}
get:/addresses/{address_hash}/token-balances
get:/addresses/{address_hash}/transactions

Token, Transaction, And Block Reads

get:/tokens/{address_hash}
get:/tokens/{address_hash}/holders
get:/transactions/{hash}
get:/blocks/{block_number_or_hash}

Multi-Instance Use

To target a different Blockscout deployment, keep the same schema and relink the command to another host that serves /api/v2:

uxc link blockscout-openapi-cli https://optimism.blockscout.com/api/v2 \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/blockscout-openapi-skill/references/blockscout-v2.openapi.json

Guardrails

Keep automation on the JSON output envelope; do not use --text.
Parse stable fields first: ok, kind, protocol, data, error.
Treat this v1 skill as read-only. Do not imply transaction broadcast or contract write support.
This schema is designed for Blockscout deployments that expose the explorer REST surface at /api/v2. If host help fails, check the deployment path before assuming a protocol mismatch.
Pagination and filter options vary across deployments. Start with host help and operation help on the target instance before building large crawls.
blockscout-openapi-cli \x3Coperation> ... is equivalent to uxc \x3Cblockscout_api_v2_host> --schema-url \x3Cblockscout_openapi_schema> \x3Coperation> ....

References

Usage patterns: references/usage-patterns.md
Curated OpenAPI schema: references/blockscout-v2.openapi.json
Blockscout API docs: https://docs.blockscout.com/devs/apis-redirect

安全使用建议

This skill appears coherent and read-only, but before installing: (1) ensure you trust the local 'uxc' CLI the skill expects to call (the skill delegates auth/requests to uxc); (2) verify the curated OpenAPI schema URL (raw.githubusercontent.com) if you have supply-chain concerns; (3) do not link the CLI to hosts you don't trust — linking binds the command to a target host and subsequent calls will query that host; (4) if you will target protected/self-hosted Blockscout instances, configure credentials via your own 'uxc auth' and avoid embedding secrets in skill files; (5) the included validate.sh is a harmless repo check but requires jq and ripgrep (rg) if you run it locally. If any of these assumptions are unacceptable, review or modify the SKILL.md and schema before use.

功能分析

Type: OpenClaw Skill Name: blockscout-openapi-skill Version: 1.0.0 The skill bundle provides a legitimate read-only interface for interacting with the Blockscout blockchain explorer API via the `uxc` utility. It includes a standard OpenAPI schema (blockscout-v2.openapi.json), a validation script (validate.sh), and clear instructions in SKILL.md that emphasize read-first guardrails and public API access without evidence of malicious intent or data exfiltration.

能力评估

✓ Purpose & Capability

Name, description, and included files (OpenAPI schema and usage docs) align with a read-only Blockscout explorer skill. The only runtime dependency the skill documents is the 'uxc' CLI and a target Blockscout host, which is appropriate for the described functionality.

✓ Instruction Scope

SKILL.md confines runtime actions to linking/using the 'uxc' CLI and an OpenAPI-based 'blockscout-openapi-cli' command for read operations. It explicitly declares read-only guardrails and does not instruct the agent to read or exfiltrate unrelated local files or environment variables. It does assume network access and use of a GitHub raw URL for the schema.

ℹ Install Mechanism

There is no install spec (instruction-only), which is low risk. The repo includes a validate.sh script that requires jq and rg for local validation; this is a development/CI helper and not an installation of remote code. The skill does reference fetching a schema from raw.githubusercontent.com (a common release host) — understandable for a curated schema but worth auditing if you distrust that URL.

✓ Credentials

The skill declares no required environment variables or credentials. It notes that protected/self-hosted instances may require auth managed via the caller's 'uxc auth' bindings, which is proportionate and keeps credentials out of the skill itself.

✓ Persistence & Privilege

The skill does not request always: true, does not modify other skills, and uses the platform default (agent-invocable). It does not ask to write system-wide configuration beyond linking a command via 'uxc', which is consistent with its purpose.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install blockscout-openapi-skill
安装完成后，直接呼叫该 Skill 的名称或使用 /blockscout-openapi-skill 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of the blockscout-openapi-skill: - Provides read-access to Blockscout explorer via curated OpenAPI schema and uxc integration. - Supports essential explorer operations: address details, token balances, transaction history, token and block lookups. - Requires no authentication for public explorers; supports uxc auth for protected instances. - Includes host relinking for multi-instance support. - Enforces read-only usage and JSON output for reliable automation.

元数据

Slug blockscout-openapi-skill

版本 1.0.0

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 1

常见问题