#601

Global Rank · of 601 Skills

junglebus AI Agent Skill

View Source: b-open-io/bsv-skills

Medium

Installation

npx skills add b-open-io/bsv-skills --skill junglebus

19

Installs

JungleBus

Real-time BSV blockchain data streaming from GorillaPool. Indexes all Bitcoin transactions with special handling for data protocols.

When to Use

  • Subscribe to transactions matching specific patterns
  • Stream real-time mempool and block data
  • Build indexers or notification systems
  • Monitor addresses or script patterns
  • Track 1Sat Ordinals, MAP, BAP, and other protocols

Creating a Subscription

Step-by-Step (Dashboard)

  1. Visit https://junglebus.gorillapool.io
  2. Sign in or create an account
  3. Navigate: Dashboard > Subscriptions > Create New
  4. Fill in subscription details:
    • ID: Auto-generated unique identifier
    • Name: Descriptive name for your subscription
    • Description: What this subscription monitors

Subscription Filters

Define what transactions to capture using AND logic (all conditions must match):

Filter Description Examples
Addresses Comma-separated Bitcoin addresses 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa
Input types Input script types ordlock, sigil
Output types Output classifications aip, bap, bitcom, map, ord, run, token_stas, pubkeyhash, nulldata
Contexts Main data from OP_RETURN outputs Protocol-specific identifiers
Sub contexts Secondary data from outputs Depends on output type
Data keys Key=value pairs from transactions app=junglebus, type=post

Note: Multiple values in a single field use AND logic - all must be present in the transaction.

Common Subscription Patterns

Monitor 1Sat Ordinals:

  • Output types: ord
  • Contexts: image/png, text/plain (content types)

Monitor BAP Identity:

  • Output types: bap
  • Contexts: 1BAPSuaPnfGnSBM3GLV9yhxUdYe4vGbdMT (BAP address)

Monitor MAP Protocol:

  • Output types: map
  • Contexts: 1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5 (MAP prefix)

Monitor Specific Address:

  • Addresses: 1YourAddressHere

JavaScript Client

Installation

bun add @gorillapool/js-junglebus

Basic Usage

import { JungleBusClient, ControlMessageStatusCode } from '@gorillapool/js-junglebus';

const client = new JungleBusClient("junglebus.gorillapool.io", {
  useSSL: true,
  onConnected(ctx) { 
    console.log("Connected", ctx); 
  },
  onConnecting(ctx) { 
    console.log("Connecting", ctx); 
  },
  onDisconnected(ctx) { 
    console.log("Disconnected", ctx); 
  },
  onError(ctx) { 
    console.error("Error", ctx); 
  }
});

// Subscribe to a subscription ID
const subscriptionId = "your-subscription-id";
const fromBlock = 750000;

client.Subscribe(
  subscriptionId,
  fromBlock,
  (tx) => {
    // Confirmed transaction received
    console.log("TX:", tx.id, "at height", tx.block_height);
    console.log("Output types:", tx.output_types);
    console.log("Contexts:", tx.contexts);
  },
  (status) => {
    // Status updates
    if (status.statusCode === ControlMessageStatusCode.BLOCK_DONE) {
      console.log("Block done:", status.block);
    } else if (status.statusCode === ControlMessageStatusCode.WAITING) {
      console.log("Waiting for new block...");
    } else if (status.statusCode === ControlMessageStatusCode.REORG) {
      console.log("Reorg triggered:", status);
    }
  },
  (error) => {
    // Subscription errors
    console.error("Subscription error:", error);
  },
  (mempoolTx) => {
    // Unconfirmed mempool transaction
    console.log("Mempool TX:", mempoolTx.id);
  }
);

Lite Mode (Lower Bandwidth)

// Last parameter = true for lite mode
client.Subscribe(
  subscriptionId, 
  fromBlock, 
  onTx, 
  onStatus, 
  onError, 
  onMempool, 
  true // Lite mode - only txid and block height
);

Transaction Data Format

Full Transaction Object

{
  "id": "e597af34eb78b599b7d458110a3cc602a40dedd020db684992b40926217612a4",
  "block_hash": "000000000000000006296f1e5437dd6c01b9b5471691a89a9c7d8e9f06920da5",
  "block_height": 750000,
  "block_time": 1658878267,
  "block_index": 3,
  "transaction": "0100000002...",
  "merkle_proof": "AAOkEnYhJgm0kklo2yDQ7Q2kAsY8ChFY1LeZtXjrNK+X...",
  "addresses": [
    "18FJd9tDLAC2S6PCzfnqNfUMXhZuPfsFUm",
    "1P7UWRLdL5pH2Si1GauwASYAA1LQHs2z45"
  ],
  "inputs": [],
  "outputs": [
    "76a9144f7d6a485e09770f947c0ba38d15050a5a80b6fa88ac",
    "76a914f28c3992dd6a43eccaed16f3f7fb6ac8da1bc3c288ac"
  ],
  "input_types": [],
  "output_types": ["nulldata", "pubkeyhash", "run"],
  "contexts": [
    "555aad1953bcfef8c7779d246fa03efae0412ed700b955435831814f5be3a82b_o1",
    "c2c4c971e85b499c29a8ab2148fd324fe12b550b8f4f57658a4686e011d8fd58_o1"
  ],
  "sub_contexts": [
    "2e729d39a9cd300f5100044a54204e6d8b43fe49555309361fdc3d8565323499"
  ],
  "data": []
}

Field Descriptions

Field Type Description
id string Transaction ID (txid)
block_hash string Block hash where transaction was mined
block_height number Block height
block_time number Unix timestamp
block_index number Position of transaction in block
transaction string Full transaction in hex
merkle_proof string TSC-compatible binary merkle proof
addresses string[] All addresses found in transaction
outputs string[] Output scripts (capped to 1024 chars)
output_types string[] Classifications (aip, bap, map, ord, etc.)
contexts string[] Main data from OP_RETURN outputs
sub_contexts string[] Secondary data from outputs
data string[] Other key=value attributes

Supported Protocols

JungleBus automatically recognizes and indexes these protocols:

Protocol Output Type Context Description
1Sat Outputs 1sat none 1 satoshi outputs
1Sat Ordinals ord content-type Inscriptions with content type
AIP aip protocol data Bitcoin Attestation Protocol
B Protocol b protocol data B:// file storage
BAP bap 1BAPSuaPnfGnSBM3GLV9yhxUdYe4vGbdMT BAP identity
Bitcom bitcom protocol data Bitcom protocol
Boost boost protocol data Boost POW
MAP map 1PuQa7K62MiKCtssSLKy1kh56WWU7MtUR5 MAP protocol
Run run protocol data Run tokens
STAS token_stas protocol data STAS tokens

REST API Endpoints

Get Transaction

curl https://junglebus.gorillapool.io/v1/transaction/get/{txid}

Returns full transaction with parsed data.

Get Address History

curl https://junglebus.gorillapool.io/v1/address/get/{address}

Returns:

[
  {
    "id": "8859250950ecbb7025731c1206e277e344a6db5f285274b7a1d2817980ab8e64",
    "address": "13qRymPwRxAr7oRdAoFdo5Wp8815sstHE5",
    "transaction_id": "eb197a43a7c4ed230a7125d7e7bf5990cd60be8ff0f59b8fffdfd91d52dfce82",
    "block_hash": "0000000000000000002be95240df5e4215e6878259dce8b9df08650641fdd40a",
    "block_index": 50545
  }
]

Get Block Header

curl https://junglebus.gorillapool.io/v1/block_header/get/{block_hash}

Returns:

{
  "hash": "000000000000000006296f1e5437dd6c01b9b5471691a89a9c7d8e9f06920da5",
  "coin": 1,
  "height": 750000,
  "time": 1658878267,
  "nonce": 4188280238,
  "version": 671080448,
  "merkleroot": "e88b40ac9367eb11dd918416b668e67f09bf24550eac93de7f2d68a0ca0c6eae",
  "bits": "180f4e90",
  "synced": 8971
}

Control Message Status Codes

import { ControlMessageStatusCode } from '@gorillapool/js-junglebus';

// Available codes:
ControlMessageStatusCode.BLOCK_DONE    // Block processing complete
ControlMessageStatusCode.WAITING       // Waiting for new block
ControlMessageStatusCode.REORG         // Blockchain reorganization
ControlMessageStatusCode.ERROR         // Error occurred

Go Client

go get github.com/GorillaPool/go-junglebus
package main

import (
    "github.com/GorillaPool/go-junglebus"
)

func main() {
    client, _ := junglebus.New(
        junglebus.WithHTTP("https://junglebus.gorillapool.io"),
    )

    client.Subscribe("subscription-id", 750000, func(tx *junglebus.Transaction) {
        fmt.Printf("TX: %s at height %d\n", tx.Id, tx.BlockHeight)
        fmt.Printf("Types: %v\n", tx.OutputTypes)
    })
}

JungleBus vs WhatsOnChain

Feature JungleBus WhatsOnChain
Real-time streaming ✅ Yes ❌ No
Transaction history ✅ Yes ✅ Yes
Address balance ❌ No ✅ Yes
UTXOs ❌ No ✅ Yes
Price data ❌ No ✅ Yes
Parsed tx data ✅ Yes ⚠️ Limited
Protocol indexing ✅ Yes ❌ No

Use JungleBus for: Streaming, protocol monitoring, real-time indexing
Use WhatsOnChain for: Balances, UTXOs, price data

Dashboard Workflow

junglebus.gorillapool.io
    ↓
Dashboard → Subscriptions → Create New
    ↓
Configure filters:
  - Addresses (optional)
  - Input types (optional)
  - Output types (required for protocol filtering)
  - Contexts (required for specific protocols)
  - Sub contexts (optional)
  - Data keys (optional)
    ↓
Save subscription
    ↓
Copy subscription ID
    ↓
Use in your code

Links

Installs

Installs 19
Global Rank #601 of 601

Security Audit

ath Safe
socket Safe
Alerts: 0 Score: 90
snyk Medium
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

How to use this skill

1

Install junglebus by running npx skills add b-open-io/bsv-skills --skill junglebus in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.

2

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

3

The skill enhances your agent's understanding of junglebus, helping it follow established patterns, avoid common mistakes, and produce production-ready output.

What you get

Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.

Compatibility

This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing

Get the App:

Download on the App Store Get it on Google Play
Customer Support