Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
docs(solana): complete Atomic V1 documentation (#232)
ni3ac34bdbac8a61
diff --git a/STRUCTURE.md b/STRUCTURE.mdindex 67f73b649..778f9b1ef 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -193,6 +193,7 @@ bottom.| Production server (Google Cloud Run) | [server/](server) + [Dockerfile](Dockerfile) | Live | Single Express container serving the static frontend, the vercel.json route table, and all `api/**` handlers with Vercel-parity routing; deploy via `npm run deploy:gcp` ([server/cloudbuild.yaml](server/cloudbuild.yaml)), crons via [scripts/create-gcp-scheduler.mjs](scripts/create-gcp-scheduler.mjs) · see [server/README.md](server/README.md) || Multiplayer 3D world (world.three.ws) | [deploy/world/](deploy/world) — [Dockerfile](deploy/world/Dockerfile), [cloudrun.yaml](deploy/world/cloudrun.yaml), [apply-hardening.sh](deploy/world/apply-hardening.sh), patches in [deploy/world/patches/](deploy/world/patches); health monitor [api/cron/world-health.js](api/cron/world-health.js) | Live · `hyperfy-world` on Cloud Run | [Hyperfy](https://github.com/hyperfy-xyz/hyperfy) pinned to an exact upstream commit and rebuilt with three local patches (server-side upload cap, `/status` blueprint-asset enumeration, fail-closed-without-`ADMIN_CODE`). World state (SQLite + uploaded assets) lives in the GCS bucket `world-three-ws-data` mounted at `/app/world`, so the container is stateless. **The world is gated:** without `ADMIN_CODE` Hyperfy's `effectiveRank` falls back to `Ranks.ADMIN` and every anonymous visitor gets server-side build rights — the fail-open default that emptied the world on 2026-06-12. Deploy + verify with `bash deploy/world/apply-hardening.sh`; builders unlock in-world with `/admin <code>`. See [deploy/world/README.md](deploy/world/README.md) || Metaplex Agent Registry deploy (Genesis-333 mint for everyone) | [pages/deploy-onchain.html](pages/deploy-onchain.html) + [src/deploy-onchain.js](src/deploy-onchain.js) `→ /deploy-onchain`, shared builders [packages/metaplex-agent-mcp/src/lib/](packages/metaplex-agent-mcp/src/lib) (published as `@three-ws/metaplex-agent-mcp`, also in the official MCP registry as `io.github.nirholas/metaplex-agent`) | Live | Mint any agent into the Metaplex Agent Registry in the exact Genesis 333 shape: data: URI metadata, verified creator, 5% royalties, immutable metadata, EIP-8004 identity with `model.uri` + `x402Support`. The page signs with the user's own wallet (Phantom/Solflare/Backpack, `signAllTransactions`) through the same-origin RPC proxy; the MCP server gives agents the identical mint with their own key (preview-first, `confirm:true` gated) plus a prepare/send lane for external wallets. Both consume one isomorphic builder library, and [tests](packages/metaplex-agent-mcp/test/genesis-shape.test.mjs) pin the output byte-for-byte to the live Genesis #332 URIs. Devnet is a free rehearsal lane end-to-end. A mainnet deploy also pays a flat 0.02 SOL fee to the $THREE buyback wallet, halved at 50k $THREE in the paying wallet and waived at 250k, disclosed in every preview and carried inside the create transaction ([packages/metaplex-agent-mcp/src/lib/three.js](packages/metaplex-agent-mcp/src/lib/three.js)); the `three_status` tool prices it against any wallet. |+| Solana Memo viewer | [public/onchain/index.html](public/onchain/index.html) `→ /onchain` | Live | A shareable, wallet-free reader for public Solana transaction Memos. It accepts a signature or Solscan transaction URL, requests version-1 transactions directly from the mainnet RPC, previews the supported raster data URI formats, provides a file download or text-copy action, and keeps each result tied to its signer, timestamp, and Solscan source. It refuses to execute active formats such as SVG because Memo content is untrusted. Docs: [docs/solana.md](docs/solana.md#viewing-files-written-in-a-transaction-memo). || Onchain agent wallets (spending allowances, not private keys) | [packages/onchain-agent-wallets/](packages/onchain-agent-wallets) (published as `@three-ws/onchain-agent-wallets`, MCP registry `io.github.nirholas/onchain-agent-wallets`) | Live | Give an agent a Solana wallet without giving it the money. Funds sit in a vault token account the OWNER owns, derived deterministically from the owner address plus the agent id (`createWithSeed(owner, "oaw1:<agent>")`); the agent holds only a capped SPL Token delegation over it, so the token program itself refuses any spend past the ceiling and decrements it on every transfer. Guardrails on top (per-tx, rolling daily, recipient and host allowlists, expiry, pause, confirm-above threshold) are enforced before signing, and every decision including refusals lands in a local ledger. `pay_x402` probes the price unpaid, checks it against the guardrails, tops the agent up for exactly that amount, pays, and leaves it empty. Owner actions need no key on the machine: they come back as unsigned transactions for Phantom/Solflare/Ledger. [Delegation tests](packages/onchain-agent-wallets/test/token-delegation.test.mjs) run the real SPL Token program in process and assert that 61 against a remaining allowance of 60 fails on-chain. || On-chain contracts (Solidity + Solana) | [contracts/](contracts) · [contracts/README.md](contracts/README.md) | Mixed: `ThreeWSPayments` + `ThreeWSFactory` live on BSC/Base/Arbitrum, the rest in-repo | Every contract and program three.ws owns, in one Foundry project plus three Anchor programs. ERC-8004 identity/reputation/validation registries (reference implementations of the canonical deployments the platform actually reads), the live x402 USDC receiver and its CREATE2 vanity factory, `AgentPayments`, `GreenfieldVault`, `WorldMoves`, and the Solana `skill_license` / `agent_invocation` programs. `forge test` covers the Solidity set with 242 tests across 8 suites; the Solana side is covered by the LiteSVM row below. Deploy status per contract and the address provenance per chain: [contracts/DEPLOYMENTS.md](contracts/DEPLOYMENTS.md) || Contract audit pack | [contracts/AUDIT-README.md](contracts/AUDIT-README.md), invariants [specs/ECONOMY_CONTRACT_INVARIANTS.md](specs/ECONOMY_CONTRACT_INVARIANTS.md), threat model [specs/ECONOMY_CONTRACT_THREAT_MODEL.md](specs/ECONOMY_CONTRACT_THREAT_MODEL.md), static analysis [contracts/audit/](contracts/audit) | In-repo | Everything a review firm needs on day one for the reputation, royalty and delegation contracts: scope + deploy status per contract, stable invariant ids with a positive and a negative test each, an assets/actors/failure-modes threat model, and committed Slither + Clippy output with every finding fixed or dispositioned in writing |@@ -476,7 +477,7 @@ array. Runbook: [docs/contributing.md](docs/contributing.md#publishing-packages-- **On-chain identity & contracts** — [contracts/](contracts), [packages/avatar-schema/](packages/avatar-schema)- **API endpoints** — [api/](api) (serverless-style handlers, served in production by the [server/](server) Cloud Run container), [workers/](workers) (long-running workers)- **Examples & demos** — [examples/](examples), [multiplayer/](multiplayer)-- **Announcement pipeline**: [docs/announcements/](docs/announcements/README.md) (one pack per feature: the claim and its evidence, the postable text, the media by shot id, the Telegram variant), `data/announcements.json` (the ledger `npm run announce:rank` writes: every shipped surface, whether it was ever announced, its score and its stage; generated, so it is gitignored rather than committed), [data/announce-media.json](data/announce-media.json) (media recipes captured from the live product into `public/announce/`), [docs/announce-voice.md](docs/announce-voice.md) (the voice contract, derived from the engagement archive). [docs/announcement-checklist.md](docs/announcement-checklist.md) is the work plan over that backlog: every unannounced surface grouped into a cluster (one post or one thread each), ordered into waves, with the endpoint that proves the surface has something to show and the verified reason where it does not, plus the platform problems the verification turned up. Its inventory reaches beyond the ranker's: the top-level SDKs, `robinhood/`, `extensions/`, `integrations/`, `apps/`, `examples/`, the native apps, the plugin marketplace and published skills, the hosted MCP servers, `specs/`, and platform-wide capabilities declared in the plan are all covered, and feature releases that shipped inside existing surfaces are listed from the changelog. Its editorial content lives in [data/announcement-plan.json](data/announcement-plan.json) and it is rendered by [scripts/announce-checklist.mjs](scripts/announce-checklist.mjs). `npm run announce:rank` ranks the backlog, `npm run announce:checklist` re-renders the plan (`-- --probe` re-verifies every blocker against production first), `npm run check:announce-checklist` fails if a shipped surface is in no cluster, `npm run announce:media` captures the frames, `npm run check:announce` gates a pack. Nothing here posts: publishing stays owner-gated.+- **Announcement pipeline**: [docs/announcements/](docs/announcements/README.md) (one pack per feature: the claim and its evidence, the postable text, the media by shot id, and the Telegram variant), `data/announcements.json` (the generated ledger `npm run announce:rank` writes: every shipped surface, whether it was announced, its score, and its stage), [data/announce-media.json](data/announce-media.json) (media recipes captured from the live product into `public/announce/`), and [docs/announce-voice.md](docs/announce-voice.md) (the voice contract derived from the engagement archive). `npm run announce:rank -- --probe` refreshes liveness and ranking, `npm run announce:media` captures the frames, and `npm run check:announce` gates a finished pack. Nothing here posts: publishing stays owner-gated.- **Marketing assets**: [marketing/](marketing/README.md) (produced promo videos + re-render scripts, e.g. [marketing/imessage-video/](marketing/imessage-video); source-of-truth assets, not shipped to production). The narrated product demo lives in [marketing/product-demo/](marketing/product-demo/README.md): [scripts/make-product-demo.mjs](scripts/make-product-demo.mjs) (`npm run demo:video`) films a presenter walking every feature page on the live site, chaptered, with narration from the platform's own TTS lane. Its route is the Feature Tour curriculum, so a new page is in the next recording without editing a script. Docs: [docs/product-demo.md](docs/product-demo.md)- **Platform agents (server-side)**: [agents/](agents/README.md) (endpoint-shopper, fact-checker, tutor, unstoppable, x402-buildout: library modules imported by `api/` handlers, each with its own README)- **Site data files**: [data/](data/README.md) (pages.json, changelog.json, skills seed, RSS items: what each file drives and which script regenerates it)diff --git a/data/pages.json b/data/pages.jsonindex bc79b3322..14c697a2e 100644--- a/data/pages.json+++ b/data/pages.json@@ -1601,6 +1601,14 @@"changefreq": "always","added": "2026-09-15"},+ {+ "path": "/onchain",+ "title": "Onchain Viewer",+ "description": "Open an image or text written into a public Solana Memo. Paste a transaction signature or Solscan link to preview the signed data without copying a data URI.",+ "priority": 0.7,+ "changefreq": "always",+ "added": "2026-09-15"+ },{"path": "/airdrops","title": "Airdrop Checker",diff --git a/docs/announcement-coverage.md b/docs/announcement-coverage.mdindex d1ba2fbb3..b641a480b 100644--- a/docs/announcement-coverage.md+++ b/docs/announcement-coverage.md@@ -2,9 +2,9 @@Source: `trythreews_tweets_2026-08-09.json` (174 posts scraped 2026-08-09, first post 2026-04-17) cross-referenced against `data/pages.json`, `packages/*`, the top-level SDKs, and `workers/` + `services/`.-**This file is the audit, not the plan.** It establishes which surfaces have been posted about, as of the-scrape date above. The prioritized work queue derived from it, with clusters, waves, verified blockers and-checkboxes, is [announcement-checklist.md](./announcement-checklist.md).+**This file is the historical audit.** It establishes which surfaces had been posted about as of the+scrape date above. Run `npm run announce:rank -- --probe` for the current prioritized queue, live-route+checks, evidence score, and stage of every shipped surface.Status legend: **Yes** = the surface was specifically announced or demoed in a post. **Passing** = covered only by a related, aggregate, or partner post (never given its own announcement). **No** = never referenced on X in any form.diff --git a/docs/announcements/README.md b/docs/announcements/README.mdindex 042e555b0..c417f58f8 100644--- a/docs/announcements/README.md+++ b/docs/announcements/README.md@@ -7,10 +7,10 @@ they are inventory that already works, and the audit that established this lives[announcement-coverage.md](../announcement-coverage.md). Working that backlog down is what thisdirectory is for.-**Which pack to make next** is not decided in this directory. The backlog is grouped into clusters, ordered-into waves, and checked for whether it can be demoed at all in-[announcement-checklist.md](../announcement-checklist.md). Work that file top down; come here when a cluster-comes up.+**Which pack to make next** is not decided in this directory. Run+`npm run announce:rank -- --probe` to rebuild the backlog from the current page, package, worker, and+service inventories, verify which routes can be demonstrated, and rank the viable candidates. Come here+after selecting a live candidate from that output.## How a pack gets madediff --git a/docs/api-reference.md b/docs/api-reference.mdindex be0510312..234fe34a3 100644--- a/docs/api-reference.md+++ b/docs/api-reference.md@@ -46,6 +46,101 @@ Rate-limited responses return HTTP 429 with `{ "error": "...", "code": "RATE_LIM---+## Solana Transaction Inspection API++Atomic is a public, read-only inspector for legacy, V0, and V1 Solana transactions. It never signs,+simulates, or broadcasts. See the [Atomic guide](./atomic.md) for the V1 resource model and sponsor-safety+rules.++### Read V1 activation status++```http+GET /api/solana/atomic+```++Returns Solana mainnet's current confirmed slot, the Transaction V1 activation slot, and the legacy and+V1 wire limits. The response is cached for 15 seconds.++```json+{+ "status": {+ "cluster": "mainnet-beta",+ "feature": "txv1",+ "featureAddress": "txv1aq4pp281K9um3tnPgkfX8UqtFT6wcVW3hNezGLL",+ "active": true,+ "activationSlot": 447120000,+ "currentSlot": 447120123,+ "legacyLimitBytes": 1232,+ "v1LimitBytes": 4096+ }+}+```++### Inspect a confirmed mainnet transaction++```http+GET /api/solana/atomic?signature=<base58-signature>+```++The RPC read opts into transaction version 1. The response includes exact signed-wire utilization,+transaction structure, normalized resource limits, sponsor safety, confirmation status, fee, and actual+compute use when Solana supplies it. Confirmed inspections are cached for one hour.++### Inspect signed wire bytes offline++```http+POST /api/solana/atomic+Content-Type: application/json++{ "transaction": "BASE64_SIGNED_TRANSACTION" }+```++The body may be at most 16 KiB. The transaction is decoded locally and is not sent to an RPC. The+inspection shape is the same as the signature path except that confirmation and explorer fields are absent.++```json+{+ "inspection": {+ "version": 1,+ "versionLabel": "V1",+ "wireDiscriminator": "0x81",+ "bytes": 1036,+ "limitBytes": 4096,+ "headroomBytes": 3060,+ "utilizationPct": 25.3,+ "largerThanLegacyLimit": false,+ "signatureCount": 1,+ "requiredSignatureCount": 1,+ "feePayer": "SOLANA_ADDRESS",+ "staticAccountCount": 4,+ "instructionCount": 1,+ "budget": {+ "source": "transaction-config",+ "computeUnitLimit": 5480,+ "loadedAccountsDataSizeLimit": 393216,+ "heapSize": null,+ "priorityFeeLamports": 2740,+ "explicit": {+ "computeUnitLimit": true,+ "loadedAccountsDataSizeLimit": true,+ "heapSize": false,+ "priorityFee": true+ }+ },+ "sponsor": {+ "verdict": "caps-explicit",+ "safeToCosign": true,+ "notes": ["Read caps from transactionConfig. Compute Budget instruction scans do not bind V1 transactions."]+ }+ }+}+```++Errors use `invalid_signature`, `invalid_transaction`, `not_found`, `rate_limited`, or `upstream_error`.+The endpoint allows cross-origin `GET` and `POST` requests and requires no authentication.++---+## Asset Catalog APIOne search across every ready-made asset three.ws publishes: the CC0 object/prop library, the ready-made character library, and the motion-clip library. **No authentication, no API key, no payment.** Open CORS, cached at the edge for 5 minutes.diff --git a/docs/solana.md b/docs/solana.mdindex 0cca7e03f..3bbd54546 100644--- a/docs/solana.md+++ b/docs/solana.md@@ -54,6 +54,20 @@ Agent record shape (`agent_identities.meta`):Public RPCs are rate-limited. For production, set `SOLANA_RPC_URL` to a Helius, Quicknode, or Triton endpoint. Server-side calls do not depend on a single endpoint: [api/_lib/solana/connection.js](../api/_lib/solana/connection.js) builds a failover chain (explicit `SOLANA_RPC_URL`, then keyed providers such as Helius and Alchemy when their keys are set, then operator-supplied `SOLANA_RPC_FALLBACK_URLS`, then keyless public endpoints, with `SOLANA_RPC_LAST_RESORT_URLS` as a paid reserve tried last) and rotates past endpoints that are rate-limited or cooling down.+## Viewing files written in a transaction Memo++[Onchain Viewer](/onchain) turns a public Solana transaction Memo back into something a person can read. It is for small files or messages written directly into a signed transaction, such as a PNG encoded as a `data:image/png;base64,...` URI. The viewer reads the transaction from Solana in the browser; it does not upload the Memo to three.ws or ask the visitor to connect a wallet.++Share a transaction with a ready-to-open URL:++```text+https://three.ws/onchain/?tx=<Solana transaction signature>+```++The page also accepts the complete Solscan transaction URL. For a supported PNG, JPEG, GIF, or WebP data URI, it previews the image and provides a download. Plain-text Memos are shown with a copy action. The page shows the signing account, time, format, and a link to the original transaction on Solscan, so the displayed content can be independently checked against the signed chain record.++The viewer supports version-1 transactions by requesting `maxSupportedTransactionVersion: 1`. It intentionally does not preview SVG or other active/document formats: content inside an on-chain Memo is public but still untrusted input. Unsupported payloads remain visible as text rather than being executed in the page.+**Never name the same endpoint as both the primary and the last-resort reserve.** The chain dedupes by URL and keeps the FIRST occurrence, so an endpoint listed in `SOLANA_RPC_URL` (or `QUICKNODE_RPC_URL`) *and* in `SOLANA_RPC_LAST_RESORT_URLS` is simply the primary: it absorbs 100% of traffic and its reserve status is a no-op. Production ran this exact misconfiguration until 2026-07-28, pointing `SOLANA_RPC_URL` at the metered QuickNode endpoint that was also the reserve; it burned through its daily request cap (`-32003 daily request limit reached`) while the free chain sat idle. The reserve must appear in `SOLANA_RPC_LAST_RESORT_URLS` and **nowhere else**.Two safeguards back this up. A bare public-cluster URL passed as the caller's explicit endpoint no longer wins priority 1: roughly 35 call sites spell their default as ``process.env.SOLANA_RPC_URL || 'https://api.mainnet-beta.solana.com'``, so an unset `SOLANA_RPC_URL` used to pin the most-throttled endpoint in the chain ahead of every paid lane. It is still tried, just at its natural position. And the cooldown breaker is fleet-wide, mirrored through the shared cache: when one instance parks a provider for an exhausted quota, siblings inherit that verdict on their first call instead of each re-burning a doomed request against a cap that is already full.diff --git a/docs/start-here.md b/docs/start-here.mdindex 6e161863f..35100b4f5 100644--- a/docs/start-here.md+++ b/docs/start-here.md@@ -179,6 +179,7 @@ Want the model in your hands rather than on a screen? [Materialize](./materializDeeper references that don't fit a track above but answer real questions:+- [Atomic Solana V1 inspector](./atomic.md): inspect a confirmed mainnet signature or raw signed transaction, measure its exact 1,232-byte or 4,096-byte envelope, and verify the execution limits a fee sponsor is being asked to accept- [Global Intel Globe](./globe.md): the live 3D globe at /globe, its eleven keyless open-data layers, the one call that returns them all, and why a cron keeps its own GDELT window- [The ship log](./shipfeed.md): how every release note is joined to the commits that shipped it, the public feed at /api/ship/feed (JSON, Markdown, RSS, and a per-commit "why did you link that" endpoint), and the zero-dependency package that does it for any repository- [Docs World](./docs-world.md): these same docs as a walkable 3D world, where every section is a pavilion you can stroll up to and read inside the scenediff --git a/package.json b/package.jsonindex a7f1db67f..5e3cd009d 100644--- a/package.json+++ b/package.json@@ -193,10 +193,8 @@"i18n:backfill": "node scripts/i18n-backfill.mjs","changelog:gaps": "node scripts/changelog-gaps.mjs","announce:rank": "node scripts/announce-rank.mjs",- "announce:checklist": "node scripts/announce-checklist.mjs","announce:media": "node scripts/capture-doc-media.mjs --spec data/announce-media.json --out public/announce/img --manifest public/announce/media-manifest.json","check:announce": "node scripts/check-announce.mjs",- "check:announce-checklist": "node scripts/announce-checklist.mjs --check","changelog:push": "node scripts/changelog-telegram.mjs","changelog:push:x": "node scripts/changelog-x.mjs","tweet": "node scripts/post-tweet.mjs",diff --git a/public/.well-known/openapi.yaml b/public/.well-known/openapi.yamlindex e012e81e5..0cf7dd8ea 100644--- a/public/.well-known/openapi.yaml+++ b/public/.well-known/openapi.yaml@@ -6,7 +6,7 @@ info:session cookies, and API keys for authentication. Avatars are stored asglTF/GLB files on Cloudflare R2 and exposed via a Model Context Protocol(MCP) JSON-RPC server for AI tool integrations.- version: 1.5.1+ version: 1.5.2contact:email: [email protected]license:@@ -31,6 +31,8 @@ tags:description: Account usage and quota statistics- name: Discoverydescription: Well-known discovery endpoints+ - name: Solana+ description: Read-only Solana transaction inspection# ---------------------------------------------------------------------------# Security schemes@@ -224,6 +226,109 @@ components:type: integerrequired: [avatars, bytes, mcp_calls_24h, events_30d]+ # -- Solana --------------------------------------------------------------+ SolanaTransactionInspection:+ type: object+ required:+ - version+ - versionLabel+ - bytes+ - limitBytes+ - headroomBytes+ - utilizationPct+ - largerThanLegacyLimit+ - signatureCount+ - requiredSignatureCount+ - staticAccountCount+ - instructionCount+ - budget+ - sponsor+ properties:+ version:+ oneOf:+ - type: string+ enum: [legacy]+ - type: integer+ enum: [0, 1]+ versionLabel: { type: string, enum: [Legacy, V0, V1] }+ wireDiscriminator:+ type: string+ nullable: true+ enum: [0x81]+ bytes: { type: integer, minimum: 1 }+ limitBytes: { type: integer, enum: [1232, 4096] }+ headroomBytes: { type: integer }+ utilizationPct: { type: number }+ largerThanLegacyLimit: { type: boolean }+ signatureCount: { type: integer, minimum: 0 }+ requiredSignatureCount: { type: integer, minimum: 0 }+ feePayer:+ type: string+ nullable: true+ staticAccountCount: { type: integer, minimum: 0 }+ instructionCount: { type: integer, minimum: 0 }+ budget:+ type: object+ required: [source, explicit]+ properties:+ source:+ type: string+ enum: [compute-budget-instructions, transaction-config]+ computeUnitLimit:+ oneOf:+ - type: integer+ - type: string+ nullable: true+ loadedAccountsDataSizeLimit:+ oneOf:+ - type: integer+ - type: string+ nullable: true+ heapSize:+ oneOf:+ - type: integer+ - type: string+ nullable: true+ priorityFeeLamports:+ oneOf:+ - type: integer+ - type: string+ nullable: true+ explicit:+ type: object+ required: [computeUnitLimit, loadedAccountsDataSizeLimit, heapSize, priorityFee]+ properties:+ computeUnitLimit: { type: boolean }+ loadedAccountsDataSizeLimit: { type: boolean }+ heapSize: { type: boolean }+ priorityFee: { type: boolean }+ sponsor:+ type: object+ required: [verdict, safeToCosign, notes]+ properties:+ verdict:+ type: string+ enum: [legacy-rules, caps-explicit, limits-missing]+ safeToCosign:+ type: boolean+ nullable: true+ notes:+ type: array+ items: { type: string }+ signature: { type: string }+ cluster: { type: string, enum: [mainnet-beta] }+ confirmation:+ type: object+ properties:+ slot: { type: integer }+ blockTime: { type: integer, nullable: true }+ success: { type: boolean }+ error: { nullable: true }+ feeLamports: { type: integer, nullable: true }+ computeUnitsConsumed: { type: integer, nullable: true }+ computeUtilizationPct: { type: number, nullable: true }+ explorerUrl: { type: string, format: uri }+# -- Pagination ----------------------------------------------------------Cursor:type: string@@ -359,6 +464,111 @@ paths:'200':description: The 3D viewer HTML page.+ # --------------------------------------------------------------------------+ # Solana+ # --------------------------------------------------------------------------+ /api/solana/atomic:+ get:+ operationId: inspectSolanaTransaction+ tags: [Solana]+ summary: Read Transaction V1 status or inspect a confirmed transaction+ description: >+ With no query parameter, returns Solana mainnet Transaction V1 activation status.+ With `signature`, fetches a confirmed transaction using+ `maxSupportedTransactionVersion: 1` and returns its exact wire footprint,+ normalized resource limits, confirmation metadata, and sponsor-safety assessment.+ This endpoint never signs, simulates, or broadcasts.+ parameters:+ - in: query+ name: signature+ required: false+ schema:+ type: string+ pattern: '^[1-9A-HJ-NP-Za-km-z]{64,96}$'+ description: Base58 Solana transaction signature. Omit for live V1 status.+ responses:+ '200':+ description: Activation status or transaction inspection+ content:+ application/json:+ schema:+ oneOf:+ - type: object+ required: [status]+ properties:+ status:+ type: object+ required: [cluster, feature, active, currentSlot, legacyLimitBytes, v1LimitBytes]+ properties:+ cluster: { type: string, enum: [mainnet-beta] }+ feature: { type: string, enum: [txv1] }+ featureAddress: { type: string }+ active: { type: boolean }+ activationSlot: { type: integer, nullable: true }+ currentSlot: { type: integer }+ legacyLimitBytes: { type: integer, enum: [1232] }+ v1LimitBytes: { type: integer, enum: [4096] }+ - type: object+ required: [inspection]+ properties:+ inspection:+ $ref: '#/components/schemas/SolanaTransactionInspection'+ '400':+ description: Invalid signature or transaction+ content:+ application/json:+ schema:+ $ref: '#/components/schemas/Error'+ '404':+ description: Transaction not found on Solana mainnet+ content:+ application/json:+ schema:+ $ref: '#/components/schemas/Error'+ '429':+ $ref: '#/components/responses/TooManyRequests'+ '502':+ description: Solana RPC unavailable+ content:+ application/json:+ schema:+ $ref: '#/components/schemas/Error'+ post:+ operationId: inspectSolanaWireTransaction+ tags: [Solana]+ summary: Inspect signed Solana wire bytes without broadcasting+ requestBody:+ required: true+ content:+ application/json:+ schema:+ type: object+ required: [transaction]+ properties:+ transaction:+ type: string+ format: byte+ description: Base64-encoded signed or partially signed Solana transaction.+ responses:+ '200':+ description: Normalized transaction inspection+ content:+ application/json:+ schema:+ type: object+ required: [inspection]+ properties:+ inspection:+ $ref: '#/components/schemas/SolanaTransactionInspection'+ '400':+ description: Invalid JSON or transaction bytes+ content:+ application/json:+ schema:+ $ref: '#/components/schemas/Error'+ '429':+ $ref: '#/components/responses/TooManyRequests'+# --------------------------------------------------------------------------# Auth# --------------------------------------------------------------------------diff --git a/scripts/audit-docs.mjs b/scripts/audit-docs.mjsindex 8ab0edb6e..8056b2d1f 100644--- a/scripts/audit-docs.mjs+++ b/scripts/audit-docs.mjs@@ -284,7 +284,6 @@ if (!explicitFiles.length) {const UNPUBLISHED_DOCS = new Map([['agora', 'internal: strategy framing, not a reader-facing product doc'],['announce-voice', 'internal: the voice contract announcement packs are written and gated against'],- ['announcement-checklist', 'internal: the prioritized work plan over the unannounced backlog, including unfixed blockers'],['announcement-coverage', 'internal: X announcement coverage matrix for marketing planning'],['announcement-coverage-telegram', 'internal: paste-ready holders-channel post drafted from the coverage matrix'],['avatar-cli', 'internal: in-flight, register when the CLI ships'],