pinion-chain-intel

Category: Tools & Productivity | Uploader: Azure55562 | Downloads: 0 | Version: v1.0（Latest）

On-chain intelligence, transactions and wallet tools on Base. 9 x402-paywalled skills at $0.01 USDC each.

Changelog: Source: GitHub https://github.com/Azure55562/pinion-os

Directory Structure

Current level: Root

📁 assets/
- 📄 banner.png 22.4 KB
📁 examples/
- 📄 claude-config.json 228 B
- 📄 custom-skill.ts 1.3 KB
- 📄 use-sdk.ts 894 B
📁 skills/
- 📁 balance/
  - 📄 SKILL.md 1.2 KB
- 📁 broadcast/
  - 📄 SKILL.md 2.9 KB
- 📁 chat/
  - 📄 SKILL.md 1.5 KB
- 📁 fund/
  - 📄 SKILL.md 1.8 KB
- 📁 price/
  - 📄 SKILL.md 1.8 KB
- 📁 send/
  - 📄 SKILL.md 2.1 KB
- 📁 trade/
  - 📄 SKILL.md 2.4 KB
- 📁 tx/
  - 📄 SKILL.md 1.2 KB
- 📁 wallet/
  - 📄 SKILL.md 1.2 KB
📁 src/
- 📁 client/
  - 📄 index.ts 4.1 KB
  - 📄 skills.ts 5.3 KB
  - 📄 types.ts 3.4 KB
  - 📄 x402-generic.ts 4.8 KB
  - 📄 x402-v2.ts 3.7 KB
  - 📄 x402.ts 2.9 KB
- 📁 plugin/
  - 📄 config.ts 938 B
  - 📄 index.ts 297 B
  - 📄 limits.ts 2.5 KB
  - 📄 server.ts 1.8 KB
  - 📄 tools.ts 19.8 KB
- 📁 server/
  - 📄 index.ts 2.6 KB
  - 📄 manifest.ts 2.0 KB
  - 📄 middleware.ts 1.4 KB
  - 📄 skill.ts 914 B
  - 📄 types.ts 647 B
- 📁 shared/
  - 📄 constants.ts 1.2 KB
  - 📄 errors.ts 764 B
  - 📄 rpc.ts 917 B
- 📁 skills/
  - 📄 balance.ts 1.4 KB
  - 📄 broadcast.ts 2.6 KB
  - 📄 catalog.ts 3.3 KB
  - 📄 chat.ts 1.8 KB
  - 📄 price.ts 4.4 KB
  - 📄 tx.ts 1.5 KB
  - 📄 wallet.ts 1.2 KB
- 📄 index.ts 536 B
📁 tests/
- 📄 client.test.ts 2.2 KB
- 📄 server.test.ts 2.0 KB
- 📄 x402.test.ts 2.5 KB
📄 .env.example 807 B
📄 .gitignore 108 B
📄 .mcp.json 125 B
📄 .npmignore 75 B
📄 LICENSE 1.0 KB
📄 openclaw.plugin.json 8.9 KB
📄 package-lock.json 318.3 KB
📄 package.json 1.3 KB
📄 README.md 6.2 KB
📄 SKILL.md 4.4 KB
📄 tsconfig.json 471 B

SKILL.md

---
name: pinion-chain-intel
description: On-chain intelligence, transactions and wallet tools on Base. 9 x402-paywalled skills at $0.01 USDC each.
---

# Pinion Chain Intel -- OpenClaw Skills

On-chain intelligence, transactions, wallet tools and an AI agent on Base, paywalled via x402 USDC micropayments.

**Server:** https://pinionos.com/skill/
**Price:** $0.01 USDC per call (x402 on Base)
**Free catalog:** `GET /skill/catalog`

## Skills

| # | Skill | Endpoint | Method | Description |
|---|-------|----------|--------|-------------|
| 1 | [balance](skills/balance/SKILL.md) | `/balance/:address` | GET | ETH and USDC balances for any Base address |
| 2 | [tx](skills/tx/SKILL.md) | `/tx/:hash` | GET | Decoded transaction details for any Base tx hash |
| 3 | [price](skills/price/SKILL.md) | `/price/:token` | GET | Current USD price for ETH, USDC, WETH, DAI, USDT, CBETH |
| 4 | [wallet](skills/wallet/SKILL.md) | `/wallet/generate` | GET | Generate a fresh Ethereum keypair for Base |
| 5 | [chat](skills/chat/SKILL.md) | `/chat` | POST | Chat with the Pinion AI agent (web search enabled) |
| 6 | [send](skills/send/SKILL.md) | `/send` | POST | Construct an unsigned ETH or USDC transfer on Base |
| 7 | [trade](skills/trade/SKILL.md) | `/trade` | POST | Get an unsigned swap tx via 1inch aggregator on Base |
| 8 | [fund](skills/fund/SKILL.md) | `/fund/:address` | GET | Wallet balances and funding instructions for Base |
| 9 | [broadcast](skills/broadcast/SKILL.md) | `/broadcast` | POST | Sign and broadcast an unsigned tx on Base |

Each skill has its own `SKILL.md` in `skills/<name>/` with full parameters, example requests and responses.

## How x402 Works

1. Client calls a paywalled endpoint (e.g. `GET /skill/balance/0x...`)
2. Server responds with HTTP 402 and payment requirements (amount, token, network, recipient)
3. Client signs a USDC `TransferWithAuthorization` (EIP-3009) using their wallet
4. Client retries the request with the `X-PAYMENT` header containing the signed payment
5. Server verifies the payment via the x402 facilitator, returns the data, and settles the USDC transfer

Every call = 1 real USDC transaction on Base.

## Install as OpenClaw Plugin

Copy the `pinion-openclaw-skill/` directory into your OpenClaw workspace `skills/` folder:

```bash
cp -r pinion-openclaw-skill ~/.openclaw/workspace/skills/pinion-chain-intel
```

Or install from the repo:

```bash
git clone https://github.com/chu2bard/pinion-os.git
cp -r pinion-os/pinion-openclaw-skill ~/.openclaw/workspace/skills/pinion-chain-intel
```

OpenClaw loads skills from `workspace/skills/` on the next session. The 8 individual `SKILL.md` files tell the agent what each skill does, how to call it, and what to expect back.

## Use with Pinion OS SDK

```bash
npm install pinion-os
```

```typescript
import { PinionClient } from "pinion-os";

const pinion = new PinionClient({ privateKey: process.env.PINION_PRIVATE_KEY });
const balance = await pinion.skills.balance("0x101C...");
const price = await pinion.skills.price("ETH");
const chat = await pinion.skills.chat("what is x402?");
```

The SDK handles x402 payment signing automatically.

## Run Your Own Server

```bash
git clone https://github.com/chu2bard/pinion-os.git
cd pinion-os
npm install
cp .env.example .env
# Set ADDRESS to your wallet
npm run dev
```

### Configuration

- `ADDRESS` -- Your wallet address to receive USDC payments
- `FACILITATOR_URL` -- x402 facilitator (default: `https://facilitator.payai.network`)
- `NETWORK` -- `base` for mainnet, `base-sepolia` for testnet
- `PORT` -- Server port (default: 4020)

## Directory Structure

```
pinion-openclaw-skill/
  SKILL.md                  -- this file (index)
  openclaw.plugin.json      -- OpenClaw plugin manifest
  skills/
    balance/SKILL.md        -- balance lookup
    tx/SKILL.md             -- transaction details
    price/SKILL.md          -- token price
    wallet/SKILL.md         -- wallet generation
    chat/SKILL.md           -- AI agent chat
    send/SKILL.md           -- send ETH/USDC
    trade/SKILL.md          -- swap tokens via 1inch
    fund/SKILL.md           -- funding instructions
    broadcast/SKILL.md      -- sign and broadcast tx
```

## Tech Stack

- Express.js with `x402-express` paymentMiddleware (official Coinbase x402 package)
- Base mainnet RPC for on-chain data
- CoinGecko API for token prices
- 1inch aggregator for swaps
- Anthropic Claude for AI agent chat
- TypeScript

## License

MIT

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

pinion-chain-intel

Directory Structure

SKILL.md

Report

Notice