PerpScope v2.0.0

PerpScope v2.0.0

PerpScope v2.0 turns the embed layer into a schema-locked terminal integration kit.

Shipped

• Adds schemas/perpscope-export.schema.json for the perpscope.export.v1 contract.
• Adds package helpers: parsePerpScopeExport(), summarizePerpScopeExport(), summarizeFeedHealth(), and rankRadarRows().
• Adds examples/copy-integration/, a live copy page for iframe snippets, npm parser imports, schema links, and terminal placement.
• Updates examples/embed-consumer/ into a richer terminal side-rail mock that consumes the same export contract.
• Bumps the app export and @perpscope/percolator-adapter package surfaces to 2.0.0.
• Documents the install-and-embed path in the README and docs/embed-integration.md.

Safety

The v2.0 integration kit remains read-only. The schema requires wallet, signer, transaction, and orderRouting to be false, and the helpers reject exports that do not declare that safety boundary.

Live

https://williamclay8.github.io/perpscope/
https://williamclay8.github.io/perpscope/examples/copy-integration/
https://williamclay8.github.io/perpscope/examples/embed-consumer/
https://williamclay8.github.io/perpscope/examples/perpscope-export.sample.json
https://williamclay8.github.io/perpscope/schemas/perpscope-export.schema.json

PerpScope v1.9.0

PerpScope v1.9.0

PerpScope v1.9 makes the export and embed layer easier for other terminals to copy.

Shipped

• Adds docs/embed-integration.md with copy-paste ?embed=feed, ?embed=radar, and ?embed=market examples.
• Adds examples/perpscope-export.sample.json, a stable perpscope.export.v1 fixture for parser tests and terminal mocks.
• Adds examples/embed-consumer/, a tiny read-only iframe plus JSON parsing example.
• Bumps the cockpit export version to 1.9.0.
• Keeps the hosted live decoded worker path documented for terminals that want live Percolator source data.

Safety

PerpScope embeds and exports stay observational. They expose feed health, ranked risk context, selected market display fields, why-hot reasons, and adapter target hints. They do not include wallets, signers, transactions, order routes, private keys, or trade execution controls.

Live

https://williamclay8.github.io/perpscope/
https://williamclay8.github.io/perpscope/?embed=feed
https://williamclay8.github.io/perpscope/?embed=radar&filter=hot
https://williamclay8.github.io/perpscope/?embed=market&market=wif-perp
https://williamclay8.github.io/perpscope/examples/embed-consumer/

PerpScope v1.8.0

PerpScope v1.8.0

PerpScope v1.8 makes the live cockpit usable outside the PerpScope page.

Shipped

• Adds perpscope.export.v1, a read-only JSON export for feed health, radar rows, selected market context, why-hot reasons, and adapter targets.
• Adds embeddable views with ?embed=feed, ?embed=radar, and ?embed=market.
• Adds Export Hub controls for cockpit JSON, radar JSON, current market JSON, and embed URLs.
• Adds adapter target docs for terminal rails, risk overlays, execution lanes, and feed monitors.
• Keeps public-site live Percolator auto-load and shareable ?market= / ?filter= state.

Safety

PerpScope exports and embeds remain read-only. They expose normalized display data and source health only; they do not include wallets, signers, transactions, order routes, private keys, or trade execution controls.

Live

https://williamclay8.github.io/perpscope/
https://williamclay8.github.io/perpscope/?embed=feed
https://williamclay8.github.io/perpscope/?embed=radar&filter=hot
https://williamclay8.github.io/perpscope/?embed=market&market=devnet-small-1

PerpScope v1.7.0

PerpScope v1.7.0

PerpScope v1.7 turns the live cockpit into a more useful trader and builder surface.

Shipped

• Adds a Why Hot panel that explains the selected market's heat with stress, skew, carry, freshness, spread, and decode confidence.
• Adds a Feed Health panel for market count, slot, age, unit checks, gaps, and decoder source.
• Adds shareable cockpit links with ?market= and ?filter= state.
• Adds Adapter Targets for terminal rails, risk overlays, execution lanes, and feed monitors.
• Keeps the public site auto-loading the hosted read-only Percolator decoder worker.

Safety

PerpScope remains read-only. The new explanations are data-quality and risk-context summaries only; they do not connect wallets, sign transactions, submit orders, route trades, or provide trade recommendations.

Live

https://williamclay8.github.io/perpscope/
https://perpscope-decoder-worker.onrender.com/perpscope.json

PerpScope v1.6.0

PerpScope v1.6.0

PerpScope v1.6 makes the hosted site feel live immediately.

Shipped

• Auto-loads the hosted Percolator decoder worker on the public GitHub Pages site.
• Keeps fixture mode available with ?fixture=1 or disables live boot with ?live=0.
• Adds a compact Data Confidence strip for decoded live status, market count, unit-checked markets, normalized markets, and read-only wallet posture.
• Adds Trader Radar filters: All, Hot, Unit checked, Normalized, and Fresh.
• Adds a visible Load Percolator loading state and a clearer fallback note when the live source is unavailable.

Safety

PerpScope remains read-only. The automatic live load fetches decoded public protocol state only; it does not connect wallets, sign transactions, submit orders, route trades, or provide trade recommendations.

Live

https://williamclay8.github.io/perpscope/
https://perpscope-decoder-worker.onrender.com/perpscope.json

PerpScope v1.5.0

PerpScope v1.5.0

PerpScope v1.5 makes the live Percolator feed easier for traders to use.

Shipped

• Added a default hosted live source: https://perpscope-decoder-worker.onrender.com/perpscope.json.
• Renamed the decoded action to Load Percolator so users can load the live worker without adding a query string.
• Added a Trader Radar panel that ranks markets by heat across flags, stress, skew, funding pressure, oracle age, and unit-confidence checks.
• Added decoded sanity checks in the worker so raw-scale or unit-ambiguous values are hidden instead of displayed as polished USD.
• Preserved dataQuality metadata through the terminal DTO so the cockpit can show normalized versus unit-checked markets.
• Allowed localhost CORS previews for the hosted worker while keeping the production origin explicit.

Safety

PerpScope remains read-only. The live worker does not connect wallets, sign transactions, submit orders, route trades, or provide trade recommendations. Unit-ambiguous decoded fields are labeled and hidden from headline risk math until their scale is trustworthy.

Live

https://williamclay8.github.io/perpscope/
https://perpscope-decoder-worker.onrender.com/perpscope.json

PerpScope v1.4.0

PerpScope v1.4.0

PerpScope v1.4 adds the read-only Percolator decoder worker.

Shipped

• Added scripts/percolator-decoder-worker.mjs, a small HTTP service with /perpscope.json and /healthz.
• Added src/lib/percolator-decoder-worker.js to fetch a Percolator market directory, group slab accounts by program id, decode them through @percolatorct/sdk, and emit the PerpScope decoded live source contract.
• Added render.yaml for a Render web service named perpscope-decoder-worker.
• Added worker-thread bounded decode timeouts so slow SDK/RPC/source calls return decoded_source_unavailable instead of hanging the cockpit.
• Added tests for directory grouping, SDK-to-PerpScope mapping, injectable SDK/RPC seams, CORS, health-compatible HTTP serving, timeout handling, and safe RPC defaults.
• Added npm run decoder:start for local and hosted worker runs.

Safety

The worker is read-only. It uses public market directories and Solana RPC reads, does not connect wallets, does not sign transactions, does not build transaction instructions, does not submit orders, and does not provide trade recommendations.

Local Smoke

npm run decoder:start
curl -fsS http://127.0.0.1:8787/healthz
curl -fsS http://127.0.0.1:8787/perpscope.json

Then open PerpScope with:

https://williamclay8.github.io/perpscope/?decodedSource=http://127.0.0.1:8787/perpscope.json

PerpScope v1.3.0

PerpScope v1.3.0

PerpScope v1.3 adds the decoded live source intake.

Shipped

• Added Load Decoded to the Data Source panel.
• Added ?decodedSource=https://... and window.PERPSCOPE_DECODED_SOURCE_URL as the clean, no-textbox connection path for CORS-readable decoded protocol feeds.
• Added URL/protocol validation, live-source validation, and a raw-account-data guard so PerpScope does not label undecoded bytes as decoded protocol state.
• Added examples/decoded-live-source.sample.json for local and deployed smoke tests.
• Added docs/decoded-live-source.md with the endpoint contract for terminal teams and decoder workers.
• Documented the recommended Percolator decoder path: @percolatorct/sdk, an address directory such as https://percolatorlaunch.com/api/markets, Solana getMultipleAccounts, SDK layout parsing, and a PerpScope snapshot response.

Safety

PerpScope remains read-only. It does not connect wallets, sign transactions, submit orders, route trades, or provide trade recommendations. The decoded live source path accepts sanitized decoded state only; raw Solana account data still needs a Percolator decoder before the cockpit can display it honestly.

PerpScope v1.2.0

PerpScope v1.2.0

PerpScope v1.2.0 adds actual public market prices to the website without pretending those prices are live decoded Percolator account state.

Shipped

• Added Load Live to the Data Source panel.
• Added a read-only browser fetch against the CoinGecko simple price endpoint for SOL, BTC, and WIF public USD prices.
• The cockpit now updates visible mark prices, price paths, receipt tick rows, and simulated account PnL from actual public prices.
• The Data Source panel labels this mode as actual public prices with simulated risk context.
• Failure keeps the previous source visible and reports that live public prices are unavailable instead of silently falling back to fixture data.

Safety Boundary

PerpScope still does not connect wallets, sign transactions, submit orders, or provide trade recommendations. Load Live is actual public price data, not live decoded protocol state. Funding, OI, margin, and account risk remain simulated Percolator context until a decoded Percolator live data source is wired.

PerpScope v1.1.0

PerpScope v1.1.0

PerpScope v1.1.0 makes the website honest at first glance: fixture data, static real-backed data, and unwired live data are now separate cockpit states.

Shipped

• Published npm adapter: @perpscope/percolator-adapter@1.1.0.
• Added the Data Source cockpit panel so visitors can see whether the screen is using a local fixture, a static real-backed snapshot, or a live read-only stream.
• Added examples/static-real-snapshot.json, a sanitized static snapshot derived from the read-only RPC example path.
• Added Load Snapshot on the website to switch from the default fixture into the static real-backed sample while saying it is not a live stream.
• Extended checks and tests so the Data Source disclosure, static snapshot path, and adapter version stay aligned.

Safety Boundary

PerpScope remains read-only. The public site does not connect wallets, submit transactions, route orders, or host a live RPC/indexer pipeline. The static real-backed snapshot is for terminal adapter development and UX validation, not for trading decisions.