# Forest Agent Tools – Blob Decoder

> Forest Agent Tools – Blob Decoder is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-22).

Decodes an opaque encoded string (JWT, Base64, Base64URL, gzip, hex, Brotli) into readable JSON, text, or binary evidence using deterministic local rules

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/blob/decode?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-agent-tools-blob-decoder-4e213d8c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_deYkFhpLpy2nQ7wyMh6Dw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-agent-tools-blob-decoder-4e213d8c -d '<json body>'
```

Example prompt: Can you decode this blob for me — it looks like it might be JWT or base64, use auto-detection and up to 3 layers: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.dozjgNryP38NW3jZAIDbwQ

## When to prefer this

Choose this endpoint when you need deterministic, local decoding of encoded blobs (JWT, Base64, Base64URL, gzip, hex, Brotli) without sending data to an external AI model. It is ideal when you need reproducible, rule-based unwrapping of opaque values, especially for JWT claim inspection (decode-only, no verification), multi-layer encoded configs, or compressed payloads. Prefer it over general-purpose LLM decoding when auditability and determinism matter.

## Known failure modes

- Ambiguous encoding (e.g. hex vs Base64 overlap) causes auto-mode to halt and return an error requiring an explicit hint
- Blob exceeds 180,000 character maximum — request rejected
- max_layers value out of range (must be 1–4) causes validation failure
- Brotli or hex decoding requested without an explicit hint in auto mode — returns error asking for hint
- Malformed or truncated input that cannot be decoded — returns decoding error
- Unsupported encoding type not covered by deterministic rules — returns unknown encoding error

## How this service works

Machine-readable contract for active Forest paid capabilities. Unsigned paid calls return HTTP 402 with a PAYMENT-REQUIRED x402 challenge.

## Output

Returns the decoded content as readable JSON, plain text, or binary data. For JWT inputs, claims are returned as-is and explicitly marked as unverified. Multi-layer decoding is applied up to the specified max_layers limit. The response indicates the detected encoding type and the decoded result at each layer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "blob": {
   "type": "string",
   "maxLength": 180000,
   "description": "Public blob value used to scope this lookup."
  },
  "hint": {
   "enum": [
    "auto",
    "brotli",
    "hex"
   ],
   "type": "string",
   "description": "Public hint value used to scope this lookup."
  },
  "max_layers": {
   "type": "integer",
   "maximum": 4,
   "minimum": 1,
   "description": "Public max layers value used to scope this lookup."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "scope": "caller_supplied_blob_decode_only",
   "layers": [],
   "decoded": false,
   "truncated": false,
   "final_json": null,
   "final_kind": "json",
   "final_text": "example",
   "final_bytes": 0,
   "stop_reason": "already_json",
   "final_base64": "example",
   "ambiguity_candidates": []
  },
  "meta": {
   "cache": "miss",
   "provider": "node-buffer",
   "checked_at": "2026-01-01T00:00:00.000Z",
   "duration_ms": 0
  },
  "version": "1",
  "capability": "blob.decode"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-agent-tools-blob-decoder-4e213d8c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)