# Pinion Broadcast

> Sign and broadcast an unsigned transaction on Base. Requires the sender's private key. Costs $0.01 USDC via x402.

- **Type:** Skill
- **Install:** `agentstack add skill-chu2bard-pinion-os-broadcast`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [chu2bard](https://agentstack.voostack.com/s/chu2bard)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [chu2bard](https://github.com/chu2bard)
- **Source:** https://github.com/chu2bard/pinion-os/tree/main/skills/broadcast

## Install

```sh
agentstack add skill-chu2bard-pinion-os-broadcast
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Sign & Broadcast

Signs an unsigned transaction with the provided private key and broadcasts it to Base mainnet. Returns the transaction hash and Basescan link.

## Endpoint

```
POST https://pinionos.com/skill/broadcast
```

**Price:** $0.01 USDC per call (x402 on Base)

## Request Body

```json
{
  "tx": {
    "to": "0x7a21...",
    "value": "0xb1a2bc2ec50000",
    "data": "0x",
    "chainId": 8453
  },
  "privateKey": "0x4b3f..."
}
```

| Field      | Type   | Required | Description                                                |
|------------|--------|----------|------------------------------------------------------------|
| tx         | object | yes      | Unsigned transaction object (from /send or /trade skills)  |
| tx.to      | string | yes      | Recipient or contract address                              |
| tx.value   | string | no       | ETH value in hex (default: "0x0")                          |
| tx.data    | string | no       | Calldata in hex (default: "0x")                            |
| tx.chainId | number | yes      | Must be 8453 (Base mainnet)                                |
| privateKey | string | yes      | Sender's private key (0x + 64 hex chars)                   |

## Example Request

```bash
curl -X POST https://pinionos.com/skill/broadcast \
  -H "Content-Type: application/json" \
  -d '{
    "tx": {
      "to": "0x7a21...",
      "value": "0xb1a2bc2ec50000",
      "data": "0x",
      "chainId": 8453
    },
    "privateKey": "0x4b3f..."
  }'
```

The first request returns HTTP 402 with payment requirements. Sign a USDC `TransferWithAuthorization` (EIP-3009) and retry with the `X-PAYMENT` header.

## Example Response

```json
{
  "txHash": "0xabc123...",
  "explorerUrl": "https://basescan.org/tx/0xabc123...",
  "from": "0x1234...",
  "to": "0x7a21...",
  "network": "base",
  "status": "submitted",
  "note": "Transaction submitted to Base. It may take a few seconds to confirm.",
  "timestamp": "2026-02-17T12:00:00.000Z"
}
```

## When to Use

- After calling `/send` to transfer ETH or USDC -- pass the returned `tx` object here with the sender's private key to execute it.
- After calling `/trade` to swap tokens -- broadcast the `approve` tx first (if present), wait for confirmation, then broadcast the `swap` tx.
- Any time you have an unsigned Base transaction and need to sign + broadcast it.

## Typical Flow

1. Call `/send` or `/trade` to get an unsigned transaction.
2. Ask the user for their private key.
3. Call `/broadcast` with the unsigned tx and the private key.
4. Return the tx hash and Basescan link to the user.

## Security

- The private key is sent over HTTPS and used only to sign the transaction. It is not stored or logged.
- Only use this with wallets you control and amounts you're comfortable with.
- The sender's wallet needs ETH on Base for gas fees.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [chu2bard](https://github.com/chu2bard)
- **Source:** [chu2bard/pinion-os](https://github.com/chu2bard/pinion-os)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-chu2bard-pinion-os-broadcast
- Seller: https://agentstack.voostack.com/s/chu2bard
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.