byte_buy_dataвнешний мир

Купить один пакет данных из любого фида PayPerByte через платёжный шлюз x402. Без подписки, без allowance, без предварительной настройки ончейна — расчёт USDC за каждый вызов. Сервер MCP подписывает transferWithAuthorization по EIP-3009 от имени кошелька, для которого настроен PRIVATE_KEY, фасилитатор x402 отправляет транзакцию, и данные возвращаются вместе с хешем ончейн-транзакции расчёта. Используйте byte_subscribe, если вам нужен непрерывный поток трансляций от издателя. Каталог доступных feed slugs находится по адресу https://x402.payperbyte.io/feeds (бесплатный GET). GET-фиды данных (погода, землетрясения, …) требуют только `feed`; 9 POST-оракулов — address-reputation, sanctions-screen, pkg-verdict, reasoning-verdict, evidence-pack, liquidation-stream, positioning-snapshot, runtime-eol, threat-intel — дополнительно требуют JSON `body` (запрос) — передача `body` переключает этот вызов на POST. Требует переменную окружения PRIVATE_KEY на сервере MCP и USDC на настроенном кошельке. ПРИМЕЧАНИЕ: платные фиды проводят расчёты в НАСТОЯЩИХ USDC в сети Base mainnet (eip155:8453) — точная цена указана в челлендже 402 (флагманский address-reputation: $0.10/verdict). Используйте выделенный кошелек, на котором хранится ровно столько, сколько вы собираетесь потратить.

Параметры

feedstringобязательный
Feed slug — one of: weather ($0.0050), earthquakes ($0.0030), runtime-eol ($0.020), threat-intel ($0.050), evidence-pack ($0.100), address-reputation ($0.100), pkg-verdict ($0.100), sanctions-screen ($0.100), reasoning-verdict ($0.100), liquidation-stream ($0.030), positioning-snapshot ($0.030). Full catalog: https://x402.payperbyte.io/feeds (free GET). (For fact-oracle Q&A use byte_query_fact instead — it uses a different request-response flow.)
bodyobject
Optional JSON query body for POST oracles. Supplying it switches the call from GET to POST. Required by the verdict oracles, e.g. address-reputation {domain,address[,amount,chain]}, sanctions-screen {address|name}, pkg-verdict {ecosystem,package[,version]}, reasoning-verdict {subject}. Omit for GET data feeds (weather, earthquakes, …).

byte_check_subscriptionтолько чтениеидемпотентныйвнешний мир

Проверьте, подписан ли адрес на конкретного издателя в PayPerByte.

Параметры

subscriberstringобязательный
Subscriber Ethereum address (0x...)
publisherstringобязательный
Publisher Ethereum address (0x...)

byte_get_network_statsтолько чтениеидемпотентныйвнешний мир

Получить статистику по всей сети PayPerByte: общее количество издателей, переданных сообщений и общая сумма комиссий подписчиков, выплаченных в USDC.

Параметры

Без параметров.

byte_get_publisherтолько чтениеидемпотентныйвнешний мир

Получить ончейн-информацию для конкретного издателя PayPerByte: статус, количество подписчиков и сообщений, доход в USDC и зарегистрированную схему (ограничения по размеру, каденцию, цену за КБ).

Параметры

addressstringобязательный
Publisher Ethereum address (0x...)

byte_get_token_balancesтолько чтениеидемпотентныйвнешний мир

Получает балансы USDC и ETH для адреса на Arbitrum Sepolia (ончейн-тестнет — MockUSDC выполняет расчёты по подпискам и запросам факт-оракула там). НЕ показывает баланс USDC в Base-mainnet, который расходует byte_buy_data.

Параметры

addressstringобязательный
Ethereum address (0x...)

byte_list_feedsтолько чтениеидемпотентныйвнешний мир

Перечисли все активные потоки данных в каталоге PayPerByte с темами, ценой за КБ и частотой.

Параметры

Без параметров.

byte_list_my_subscriptionsтолько чтениеидемпотентныйвнешний мир

Выводит все активные подписки для указанного адреса кошелька. Каждая запись содержит адрес издателя, тему, статус, дату подписки, количество полученных сообщений за 7/30 дней, потраченные USDC за 7/30 дней и время последнего полученного сообщения. Используйте эту информацию, чтобы увидеть, за что вы сейчас платите, и решить, стоит ли отписаться.

Параметры

subscriberstringобязательный
Wallet address to list subscriptions for
indexerUrlstring
Optional indexer URL override (default: INDEXER_URL/BYTE_INDEXER_URL env or https://feeds.payperbyte.io)

byte_publish_dataвнешний мир

Публикует данные подписчику через контракт PayPerByte DataStream. Хеширует полезную нагрузку, записывает размер в цепочку и проводит оплату в USDC. Требуется PRIVATE_KEY.

Параметры

subscriberstringобязательный
Subscriber Ethereum address (0x...)
datastringобязательный
Data payload to publish (will be hashed on-chain)
maxFeenumberобязательный
Maximum fee in USDC willing to pay for this publish (e.g. 0.05)

byte_query_factвнешний мир

Запрашивает у издателя fact-oracle PayPerByte подписанный ответ с цитатами. Отправляет вопрос зарегистрированному издателю fact-oracle (topic='fact-oracle'), ожидает ответа в формате BroadcastStreamed в блокчейне и возвращает ответ вместе с URL-адресами структурированных цитат. Подписанная квитанция подтверждает, какой издатель предоставил ответ (происхождение + защита от подделки), НО НЕ то, что ответ верен: опирайтесь в выводе на цитируемые источники, а не на гарантию истинности. Доступность: для этого требуется активная трансляция зарегистрированного издателя fact-oracle; если ни один из них не работает, вызов возвращает тайм-аут, а не ответ.

Параметры

questionstringобязательный
The factual question to ask (e.g. 'What was last night's Lakers vs Warriors score?'). Should be specific and verifiable.
subscriber_addressstringобязательный
Your wallet address. You MUST be subscribed to the chosen publisher (with sufficient USDC escrow) or the publisher's on-chain broadcast will be skipped.
max_byte_costnumber
Max response payload bytes you're willing to pay for (defaults to 2000, ≈$1 at $0.0005/byte). Publisher refuses if can't fit answer.
topic_filterstring
Optional topic filter (e.g. 'fact-oracle' default; future: 'sports', 'finance').
min_publisher_pqsnumber
Minimum PQS to consider (BPS scale, 0-10000). 9000 = Elite-only, 7500 = Premium+.
max_response_latency_msnumber
Max time to wait for the publisher's broadcast (default 30000 ms). Local-LLM publishers (Ollama + Searxng + 3-sample NLI gate) take ~30-60s; Anthropic + passthrough takes ~10-20s. Hard ceiling 180s.

byte_register_publisherвнешний мир

Регистрация в качестве издателя данных на PayPerByte. Регистрирует схему и издателя в блокчейне. Требуется PRIVATE_KEY. Издатели PayPerByte v1 являются собственной стороной и не делают стейк — оставьте долю на '0'; ненулевой стейк в USDC сначала одобряется в DataRegistry, если вы решите его внести.

Параметры

stakestringобязательный
USDC reputation stake to post, as a decimal string. Default '0' — PayPerByte v1 publishers are unstaked.
topicstringобязательный
Data feed topic (e.g. 'eth-price', 'weather-nyc', 'gas-tracker')
expectedSizenumberобязательный
Expected payload size in bytes per message
maxSizenumberобязательный
Maximum payload size in bytes per message
frequencynumberобязательный
Expected publishing frequency in seconds
pricePerKBnumberобязательный
Price per kilobyte in USDC (e.g. 0.003)

byte_search_publishersтолько чтениеидемпотентныйвнешний мир

Ищет издателей PayPerByte по теме и порядку сортировки. Возвращает адреса издателей, темы, количество подписчиков, количество сообщений и цену за килобайт.

Параметры

querystring
Topic keyword to search (e.g. 'weather', 'crypto', 'cve')
sortBystring
Sort field: 'subscribers', 'revenue', 'messages'
limitnumber
Max results to return (default 20)

byte_subscribeвнешний мир

Подписывается на поток данных издателя PayPerByte. По умолчанию также устанавливает разрешение USDC для DataStreamLib на type(uint256).max, чтобы подписка не теряла платежи незаметно, когда запас расходуется (контракт пропускает проверку разрешения и генерирует DataStreamed с amount=0 при ошибке transferFrom, а не откатывает транзакцию). Передайте skipAllowance: true, чтобы отказаться и установить конечный лимит вручную. Требуется PRIVATE_KEY.

Параметры

publisherstringобязательный
Publisher Ethereum address (0x...) to subscribe to
skipAllowanceboolean
If true, don't bundle the USDC approve(max) call. Default false. Auto-approve is also skipped when the wallet already has ≥ $1000 USDC of allowance to DataStreamLib.

byte_subscription_healthтолько чтениеидемпотентныйвнешний мир

Получает сигнал content-drift для издателя. Сравнивает их последние 7 дней публикационной активности (частота, количество сообщений) с 23-дневным базовым периодом (дни 8-30). Возвращает 'stable' (стабильная публикация), 'moderate' (сдвиг частоты на 20-50% или тишина 24-48 ч), 'significant' (сдвиг более 50% или тишина более 48 ч) или 'unknown' (новый издатель, недостаточно базовых данных). Используйте это, чтобы определить, когда издатель, на которого вы подписаны, сменил тематику или перестал публиковать.

Параметры

publisherstringобязательный
Publisher address to check
indexerUrlstring
Optional indexer URL override

byte_unsubscribeвнешний мир

Отписка от фида данных издателя. Вступает в силу со следующим блоком: списания прекращаются, поток данных останавливается. Обратимо – вы можете повторно подписаться позже через byte_subscribe. Используйте эту функцию, если издатель изменил направление контента (сначала проверьте через byte_subscription_health) или если вы просто больше не хотите получать этот фид. Требуется PRIVATE_KEY для подключённого кошелька.

Параметры

publisherstringобязательный
Publisher address to unsubscribe from

byte_verify_payloadтолько чтениеидемпотентныйвнешний мир

Verify-before-act: убедитесь, что полезные данные (data payload), с которыми агент собирается работать, действительно соответствуют тому, что издатель криптографически засвидетельствовал в цепочке. Пересчитывает keccak256 полученных байтов и сравнивает его с хешем EIP-712 PayloadAttestation в цепочке. ВСЕГДА вызывайте это для данных, полученных из BYTE, перед тем как с ними работать; если verified=false - байты были подделаны/повреждены при передаче и НЕ ДОЛЖНЫ использоваться. Привязывайте проверку к ЛИБО expectedHash (payloadHash в цепочке, который у вас уже есть, например из byte_query_fact / byte_buy_data), ЛИБО txHash (транзакция расчёта - также восстанавливает подписавшего аттестацию и подтверждает, что это указанный издатель). Read-only; кошелёк или платёж не требуется.

Параметры

datastringобязательный
The exact payload bytes the agent received and is about to act on — the raw delivered string, or a 0x-prefixed hex byte string.
expectedHashstring
On-chain payloadHash to verify against (0x + 64 hex), e.g. the payloadHash returned by byte_query_fact or byte_buy_data.
txHashstring
Settlement tx hash whose on-chain BroadcastStreamed attestation to verify against. When provided, also recovers the EIP-712 signer and confirms it is the attesting publisher.
hashModeenum
How to hash structured payloads: 'raw' (keccak of the utf8 string, default — matches byte_publish_data) or 'canonical' (keccak of key-sorted, whitespace-free JSON).
rawcanonical