Channel Knowledge Service

Developer Guide

Integration reference for the channel knowledge transcript service. Payment rails, API routes, pricing modes, and working code examples.

Overview

Live rails

4 / 6

Publication

Supported

Acceptance

Catalog + public channels

Buy-now offers

Quote-only offers

Manual-review offers

The public payment rail today is Solana MPP over the ACP jobs route. Buyers pay with USDC on Solana mainnet using the Micropayment Protocol (MPP) challenge-response flow. Other rails (x402 on Solana, Base, and Tempo; MPP on Tempo) are planned but not yet live.

Payment Rails

Each rail represents a blockchain + protocol combination that can settle payments for this service. Only rails marked Live now are available for production use.

Rail	Chain	Protocol	Status	Route
ACP Agent Ingress	Chain-agnostic	ACP	Live now	`/api/service/acp/jobs`
Solana MPP	Solana	MPP	Live now	`https://credit.attn.markets/api/tempo/agent-credit/live/capabilities`
Solana x402	Solana	x402	Live now	`https://credit.attn.markets/api/tempo/agent-credit/live/capabilities`
Base x402	Base	x402	Implemented	`https://credit.attn.markets/api/tempo/agent-credit/live/capabilities`
Tempo x402	Tempo	x402	Implemented	`https://credit.attn.markets/api/tempo/agent-credit/live/capabilities`
Tempo MPP	Tempo	MPP	Live now	`https://credit.attn.markets/api/tempo/agent-credit/live/capabilities`

Rail Details

Expanded explanation of each rail, what it does, and its current readiness.

ACP Agent Ingress

Live now

Agent Commerce Protocol ingress for fixed-price transcript pack jobs. Settlement is handled by Solana MPP when paying publicly, or by shared-secret bypass for trusted agents.

Chain: Chain-agnosticProtocol: ACPRoute: /api/service/acp/jobs

Solana MPP

Live now

Micropayment Protocol on Solana mainnet. The buyer wallet signs a USDC transfer challenge issued by the server; payment settles on-chain before the job is dispatched.

Chain: SolanaProtocol: MPPRoute: https://credit.attn.markets/api/tempo/agent-credit/live/capabilities

Solana x402

Live now

HTTP 402-based payment protocol on Solana. Canonical hosted multirail lane is live and reports production proof on credit.attn.markets.

Chain: SolanaProtocol: x402Route: https://credit.attn.markets/api/tempo/agent-credit/live/capabilities

Base x402

Implemented

HTTP 402-based payment protocol on Base L2. Canonical hosted multirail lane is live and reported by the shared multirail capabilities surface.

Chain: BaseProtocol: x402Route: https://credit.attn.markets/api/tempo/agent-credit/live/capabilities

Canonical multirail host reports base_x402_exact not live. reason_codes=base_x402_live_disabled next_actions=enable the Base x402 rail before routing live credit-backed requests here

Tempo x402

Implemented

HTTP 402-based payment protocol on Tempo network. Canonical hosted multirail lane is live and reported by the shared multirail capabilities surface.

Chain: TempoProtocol: x402Route: https://credit.attn.markets/api/tempo/agent-credit/live/capabilities

Canonical multirail host reports tempo_x402_exact not live. reason_codes=tempo_x402_live_disabled next_actions=enable the Tempo x402 rail before routing live credit-backed requests here

Tempo MPP

Live now

Micropayment Protocol on Tempo network. Canonical hosted multirail lane is live and reported by the shared multirail capabilities surface.

Chain: TempoProtocol: MPPRoute: https://credit.attn.markets/api/tempo/agent-credit/live/capabilities

API Routes

The service exposes the following route families. All routes are proxied through the app at /api/service/* to the ingestion backend.

Catalog

Browse available channels, offerings, and pricing policies.

/api/service/catalog/channels
/api/service/offerings
/api/service/pricing/policies
/api/service/channels/whole-channel-price

Quoting

Request price quotes for individual channels, custom selections, or bulk orders.

/api/service/quotes
/api/service/quotes/{quoteId}
/api/service/quotes/{quoteId}/commercials
/api/service/bulk/quotes

Commerce

Checkout, order management, receipts, and entitlements.

/api/service/checkout-sessions
/api/service/orders
/api/service/orders/{orderId}
/api/service/receipts/{receiptId}
/api/service/accounts/{subject}/entitlements

Delivery

Access purchased transcript packs, manifests, and exports.

/api/service/packs/{packId}/manifest
/api/service/packs/{packId}/exports/{name}

ACP (Agent Commerce Protocol)

Fixed-price agent-to-agent transcript pack jobs. This is the live public paid route.

/api/service/acp/offerings
/api/service/acp/jobs
/api/service/acp/jobs/{acpJobId}

Operations

Service readiness, rail status, and operational health.

/api/service/ops/readiness
/api/service/ops/readiness/history
/api/service/ops/readiness/overrides
/api/service/ops/status

Purchase Modes

Every offering has a purchase mode that determines the buyer experience and settlement path.

Buy now

instant_buy

Available for immediate purchase through a live payment rail.

Request quote

quote_only

Requires a custom quote before purchase.

Manual review

manual_review

Requires manual review and approval before purchase.

How pricing works

Fixed-price ACP offerings are priced in USDC. The current default ACP job price is $3.00 USDC per job. Pricing for custom quotes depends on channel size, video count, and the offering type.

Whole-channel and bulk requests may use different pricing tiers. The backend returns pricing details with every quote, including per-video cost, total amount, and any applicable discounts.

Code Samples

Working examples for the most common integration flows. All examples target the live ACP + Solana MPP path.

List ACP offerings

Fetch the current fixed-price ACP offerings available for instant purchase.

curl -s https://icm.fyi/api/service/acp/offerings | jq .

Submit an ACP job (Solana MPP)

POST a transcript pack job. Without a shared-secret header, the server returns a 402 MPP challenge that your wallet must sign.

# Step 1: POST the job — server returns 402 with MPP challenge
curl -s -X POST https://icm.fyi/api/service/acp/jobs \
  -H "Content-Type: application/json" \
  -d '{"channel_handle": "@ChannelName", "namespace": "videos"}' \
  -D - -o /dev/null
# Look for the WWW-Authenticate header containing the MPP challenge.

# Step 2: Sign the challenge with your Solana wallet,
# then re-POST with the Authorization header containing the signed response.
# The server verifies the on-chain USDC transfer and dispatches the job.

Poll an ACP job

After submitting a job, poll for status updates. The response includes the current state and delivery details when complete.

curl -s https://icm.fyi/api/service/acp/jobs/{acpJobId} | jq .

Check service status

Returns the live rail map, readiness state, offering counts, and endpoint families.

curl -s https://icm.fyi/api/service/ops/status | jq .