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
feat(atomic): add five Transaction V1 lab tabs beyond the Inspector
nirholas271978b2c9af
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 1b8bc90c2..e6315591a 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-10-14- **A read-only drift report for every standalone GitHub mirror**: npm run mirrors:drift compares each of the ~105 standalone mirrors in data/standalone-mirrors.json against its monorepo source at the last synced commit (GitHub API, with a README-timestamp fallback when rate-limited), flags any package whose GitHub copy has diverged, and writes the result to tasks/mirror-drift-<date>.json. It never pushes or mutates a mirror; it is the audit step that found the two fixes above. (`/docs/contributing`) `[infra, docs]`+- **Atomic is now a six-tab Transaction V1 lab, not just an inspector**: /atomic grew five tabs beyond the Inspector, each reachable by click, arrow-key/Home/End tab navigation, or a deep link (?tab=mask, ?tab=sponsor, ?tab=planner, ?tab=diff, ?tab=wallet). The config mask decoder reads a V1 transaction's real TransactionConfigMask u32 and its fixed-width ConfigValues byte by byte, flagging a half-set priority-fee pair or a reserved bit SIMD-0385 has not assigned yet. The sponsor cap view shows a paymaster exactly what it is agreeing to pay, reading V1's inline config instead of a Compute Budget instruction scan that sees nothing on a V1 transaction. The size and budget planner compiles a pasted instruction set with @solana/kit to an exact byte count against legacy, V0, or V1's ceiling, including an exact lamport total for a chosen priority fee. The legacy/V0/V1 diff compiles the same instructions three ways and reports the real byte deltas, honestly, including the case where V1's inline config makes it larger than legacy. The wallet V1 capability check connects the browser's injected wallet and reports the same verdict the rest of three.ws would get from findV1WalletStandardSigner before ever requesting a real V1 signature. Nothing here is estimated: every number comes from compiling and decoding real transactions, and nothing is ever signed, simulated, or broadcast. (`/atomic`) `[feature]`- **Atomic now replays a pump.fun transaction step by step**: Atomic (/atomic) decodes every Pump, PumpSwap, and PumpFees event in a transaction's logs, oldest first, and renders it as a Replay panel: a bonding-curve-position bar, a human-readable description of each step (create, buy/sell, graduation, creator-fee collection and distribution, GitHub social-fee claims, and post-graduation PumpSwap swaps), and the SOL/token amounts that moved. An event the installed SDK does not recognize still renders, labeled unrecognized, instead of silently disappearing. For a create transaction, the panel also pages through the earliest trades on that mint since launch, walking Solana's signature history backward in bounded pages since RPC has no forward cursor. `[feature]`- **Deep links to a specific avatar now actually load that avatar**: @three-ws/walk's ?walk=play&avatar=<id> deep link and the drop-in resume path read the saved avatar preference straight out of storage and never looked at the query string, so sharing a link to a specific avatar silently loaded the stored (or default) one instead. A new deepLinkAvatarId resolver gives the query param precedence and persists it, the same way picking an avatar in the UI does. `[fix, sdk]`- **GitHub fee-claim channel now attributes withdrawals to a coin, or says plainly it cannot**: A GitHub identity withdrawing pump.fun fees through the claim_social_fee_pda instruction only proves payment to that identity, not which coin paid it: one GitHub fee account can be a shareholder on more than one coin, and its address can be pasted into a copycat coin's metadata. The claims feed and its Telegram channel now classify every such withdrawal with on-chain evidence: a same-transaction distribution to the exact account, or a 90%-dominant distribution history since the previous claim, then a repository-owner or creator-wallet match, down to an honest unresolved or unverified label when nothing proves a coin. A new-GitHub-account-plus-copycat-coin pattern holds the claim for review instead of posting it with a celebratory card. `[feature, security]`@@ -467,7 +468,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-09-15-- **Atomic - Solana V1 Inspector** (`/atomic`): A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.+- **Atomic - Solana V1 Transaction Lab** (`/atomic`): A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.- **Contributors** (`/contributors`): A living thank-you to the developers, issue reporters, and community members improving the open-source three.ws platform.- **Docs · Solana Memo Media MCP** (`/docs/mcp-solana-memo-media`): Decode validated image data embedded in Solana Memo transactions and return safe inline MCP images with provenance.- **Onchain Viewer** (`/onchain`): 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.diff --git a/api/_lib/solana/transaction-v1.js b/api/_lib/solana/transaction-v1.jsindex ba4708b58..f9b8adf52 100644--- a/api/_lib/solana/transaction-v1.js+++ b/api/_lib/solana/transaction-v1.js@@ -11,9 +11,13 @@import {COMPUTE_BUDGET_PROGRAM_ADDRESS,ComputeBudgetInstruction,+ getRequestHeapFrameInstruction,getRequestHeapFrameInstructionDataDecoder,+ getSetComputeUnitLimitInstruction,getSetComputeUnitLimitInstructionDataDecoder,+ getSetComputeUnitPriceInstruction,getSetComputeUnitPriceInstructionDataDecoder,+ getSetLoadedAccountsDataSizeLimitInstruction,getSetLoadedAccountsDataSizeLimitInstructionDataDecoder,identifyComputeBudgetInstruction,MAX_COMPUTE_UNIT_LIMIT,@@ -25,6 +29,7 @@ import {assertIsTransactionWithinSizeLimit,blockhash,compileTransaction,+ compileTransactionMessage,createTransactionMessage,decompileTransactionMessage,getBase64Encoder,@@ -43,6 +48,17 @@ export const V1_TRANSACTION_LIMIT = 4_096;export const SOLANA_TRANSACTION_V1 = 1;const DEFAULT_COMPUTE_UNITS_PER_INSTRUCTION = 200_000;+// Agave's cost model treats an unset loaded-accounts-data-size request as+// this ceiling on legacy/v0 (MAX_LOADED_ACCOUNTS_DATA_SIZE_BYTES); V1 instead+// defaults an unset request to 0 (SIMD-0385), so the planner reports headroom+// against this same ceiling either way: on legacy/v0 an unset request already+// sits at it, on V1 an unset request has the full ceiling in hand.+export const LOADED_ACCOUNTS_DATA_SIZE_DEFAULT_MAX = 64 * 1024 * 1024;++// A synthetic lifetime for size-only planning: the planner never broadcasts,+// so this only needs to decode to 32 bytes, never a real recent blockhash.+const SYNTHETIC_LIFETIME = 'So11111111111111111111111111111111111111112';+// V1 has no implicit compute/data limits. These conservative limits cover a// Metaplex Core create while bounding the resources a prepared tx may consume.export const AGENT_DEPLOY_V1_CONFIG = Object.freeze({@@ -142,6 +158,11 @@ function defaultComputeUnitLimit(instructionCount) {return Math.min(DEFAULT_COMPUTE_UNITS_PER_INSTRUCTION * instructionCount, MAX_COMPUTE_UNIT_LIMIT);}+/** Total lamports for a compute-unit price, rounded up to the nearest lamport (matches the runtime's own ceiling-division cost accounting). */+function priorityFeeLamportsFor(computeUnitLimit, microLamportsPerCu) {+ return (BigInt(computeUnitLimit) * BigInt(microLamportsPerCu) + 999_999n) / 1_000_000n;+}+function budgetFromLegacyMessage(compiled) {const instructions = compiled.instructions || [];const budget = {};@@ -172,8 +193,7 @@ function budgetFromLegacyMessage(compiled) {const implicitComputeLimit = defaultComputeUnitLimit(instructions.length);if (priceMicroLamportsPerCu !== undefined) {- const computeLimit = BigInt(budget.computeUnitLimit ?? implicitComputeLimit);- budget.priorityFeeLamports = (computeLimit * priceMicroLamportsPerCu + 999_999n) / 1_000_000n;+ budget.priorityFeeLamports = priorityFeeLamportsFor(budget.computeUnitLimit ?? implicitComputeLimit, priceMicroLamportsPerCu);}return {@@ -240,6 +260,83 @@ function sponsorAssessment(version, budget) {return { verdict: safeToCosign ? 'caps-explicit' : 'limits-missing', safeToCosign, notes };}+/** The v1 sanitization rule (SIMD-0385, "Addresses"): the static account table must contain no duplicates. Works for any version; legacy/v0 fail the same way if an encoder lists one address twice. */+export function findDuplicateAccounts(addresses) {+ const counts = new Map();+ for (const raw of addresses || []) {+ const key = String(raw);+ counts.set(key, (counts.get(key) || 0) + 1);+ }+ return [...counts.entries()].filter(([, count]) => count > 1).map(([address, count]) => ({ address, count }));+}++function toHex(bytes) {+ return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');+}++const CONFIG_MASK_FIELDS = [+ { field: 'priorityFeeLamports', label: 'Priority fee', bits: [0, 1], byteWidth: 8, read: (view, offset) => view.getBigUint64(offset, true) },+ { field: 'computeUnitLimit', label: 'Compute unit limit', bits: [2], byteWidth: 4, read: (view, offset) => view.getUint32(offset, true) },+ { field: 'loadedAccountsDataSizeLimit', label: 'Loaded accounts data size limit', bits: [3], byteWidth: 4, read: (view, offset) => view.getUint32(offset, true) },+ { field: 'heapSize', label: 'Requested heap size', bits: [4], byteWidth: 4, read: (view, offset) => view.getUint32(offset, true) },+];+const CONFIG_MASK_KNOWN_BITS = (1 << 5) - 1;++/**+ * Decode SIMD-0385's TransactionConfigMask and ConfigValues directly from a+ * V1 message's bytes, independent of @solana/kit's own higher-level config+ * decode: VersionByte, LegacyHeader(3), ConfigMask(u32 LE), LifetimeSpecifier+ * (32), NumInstructions, NumAddresses, Addresses, then ConfigValues in+ * ascending bit order (each bit = one 4-byte slot; priority fee spans two+ * bits for its 8-byte u64). Byte offsets confirmed against transactions this+ * module itself compiles (see tests/transaction-v1-lab.test.js).+ */+export function decodeV1ConfigMask(messageBytes) {+ const bytes = messageBytes instanceof Uint8Array ? messageBytes : new Uint8Array(messageBytes);+ if (bytes.length < 42 || bytes[0] !== 0x81) throw new TypeError('messageBytes is not a V1 transaction message');+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);++ const mask = view.getUint32(4, true);+ const numInstructions = bytes[40];+ const numAddresses = bytes[41];+ const configValuesByteOffset = 42 + numAddresses * 32;+ let offset = configValuesByteOffset;++ const fields = CONFIG_MASK_FIELDS.map((spec) => {+ const bitValues = spec.bits.map((bit) => (mask >>> bit) & 1);+ const present = bitValues.every((value) => value === 1);+ const invalidPartial = !present && bitValues.some((value) => value === 1);+ const field = { field: spec.field, label: spec.label, bits: spec.bits, present, invalidPartial, byteWidth: spec.byteWidth, rawHex: null, value: null };+ if (present) {+ field.rawHex = toHex(bytes.slice(offset, offset + spec.byteWidth));+ const read = spec.read(view, offset);+ field.value = typeof read === 'bigint' ? asSafeNumber(read) : read;+ offset += spec.byteWidth;+ }+ return field;+ });++ const reservedBits = mask & ~CONFIG_MASK_KNOWN_BITS;+ return {+ maskUint32: mask,+ maskHex: `0x${mask.toString(16).padStart(8, '0')}`,+ maskBinary: mask.toString(2).padStart(32, '0'),+ popcount: mask.toString(2).split('').filter((bit) => bit === '1').length,+ fields,+ reservedBitsSet: reservedBits !== 0,+ reservedBitsHex: reservedBits ? `0x${reservedBits.toString(16)}` : null,+ header: {+ numRequiredSignatures: bytes[1],+ numReadonlySignedAccounts: bytes[2],+ numReadonlyUnsignedAccounts: bytes[3],+ },+ numInstructions,+ numAddresses,+ configValuesByteOffset,+ configValuesByteLength: offset - configValuesByteOffset,+ };+}+/** Decode a signed Solana wire transaction into one JSON-safe shape. */export function inspectWireTransaction(base64Transaction) {const value = String(base64Transaction || '').trim();@@ -268,6 +365,7 @@ export function inspectWireTransaction(base64Transaction) {const budget = serializableBudget(rawBudget);const signatures = Object.keys(transaction.signatures || {});const bytes = wire.length;+ const staticAccounts = (compiled.staticAccounts || []).map(String);return {version,@@ -285,6 +383,8 @@ export function inspectWireTransaction(base64Transaction) {instructionCount: instructionCount(compiled),budget,sponsor: sponsorAssessment(version, budget),+ duplicateAccounts: findDuplicateAccounts(staticAccounts),+ configMask: version === 1 ? decodeV1ConfigMask(transaction.messageBytes) : null,};}@@ -295,3 +395,147 @@ export function decodeFeatureActivationSlot(data) {const slot = new DataView(bytes.buffer, bytes.byteOffset + 1, 8).getBigUint64(0, true);return asSafeNumber(slot);}++/** A synthetic lifetime that decodes to 32 bytes, for size-only planning that never broadcasts. */+export const SYNTHETIC_PLAN_BLOCKHASH = SYNTHETIC_LIFETIME;++const MAX_PLANNED_INSTRUCTIONS = 64;++/** Normalize pasted Umi/web3.js-shaped instructions into the {programId, keys, data} shape toKitInstruction expects, with clear errors for a hand-edited paste box. */+export function parseInstructionsInput(instructions) {+ if (!Array.isArray(instructions) || instructions.length === 0) {+ throw new TypeError('instructions must be a non-empty array');+ }+ if (instructions.length > MAX_PLANNED_INSTRUCTIONS) {+ throw new TypeError(`a transaction cannot hold more than ${MAX_PLANNED_INSTRUCTIONS} instructions`);+ }+ return instructions.map((raw, i) => {+ if (!raw || typeof raw.programId !== 'string') throw new TypeError(`instructions[${i}].programId must be a base58 program address`);+ if (!Array.isArray(raw.keys)) throw new TypeError(`instructions[${i}].keys must be an array`);+ let data;+ try {+ data = typeof raw.data === 'string' ? getBase64Encoder().encode(raw.data) : Uint8Array.from(raw.data || []);+ } catch {+ throw new TypeError(`instructions[${i}].data must be base64 or a byte array`);+ }+ return {+ programId: raw.programId,+ keys: raw.keys.map((key, k) => {+ if (!key || typeof key.pubkey !== 'string') throw new TypeError(`instructions[${i}].keys[${k}].pubkey must be a base58 address`);+ return { pubkey: key.pubkey, isSigner: Boolean(key.isSigner), isWritable: Boolean(key.isWritable) };+ }),+ data,+ };+ });+}++/** Legacy/v0 carry resource requests as ComputeBudget program instructions. */+function budgetInstructionsForLegacy(budgetConfig) {+ const instructions = [];+ if (budgetConfig.computeUnitLimit != null) instructions.push(getSetComputeUnitLimitInstruction({ units: budgetConfig.computeUnitLimit }));+ if (budgetConfig.priorityFeeMicroLamportsPerCu != null) {+ instructions.push(getSetComputeUnitPriceInstruction({ microLamports: BigInt(budgetConfig.priorityFeeMicroLamportsPerCu) }));+ }+ if (budgetConfig.loadedAccountsDataSizeLimit != null) {+ instructions.push(getSetLoadedAccountsDataSizeLimitInstruction({ accountDataSizeLimit: budgetConfig.loadedAccountsDataSizeLimit }));+ }+ if (budgetConfig.heapSize != null) instructions.push(getRequestHeapFrameInstruction({ bytes: budgetConfig.heapSize }));+ return instructions;+}++/** V1 carries the same requests in transactionConfig instead of instructions. */+function v1ConfigFrom(budgetConfig) {+ const config = {};+ if (budgetConfig.computeUnitLimit != null) config.computeUnitLimit = budgetConfig.computeUnitLimit;+ if (budgetConfig.loadedAccountsDataSizeLimit != null) config.loadedAccountsDataSizeLimit = budgetConfig.loadedAccountsDataSizeLimit;+ if (budgetConfig.heapSize != null) config.heapSize = budgetConfig.heapSize;+ if (budgetConfig.computeUnitLimit != null && budgetConfig.priorityFeeMicroLamportsPerCu != null) {+ config.priorityFeeLamports = priorityFeeLamportsFor(budgetConfig.computeUnitLimit, budgetConfig.priorityFeeMicroLamportsPerCu);+ }+ return config;+}++/**+ * Compile one instruction set for one transaction version and report exact+ * wire metrics: no estimate, no broadcast, no signing. @solana/kit reports a+ * transaction's true size before anyone has signed it (compileTransaction+ * leaves every required signer's slot `null`, and getTransactionEncoder still+ * encodes the full reserved 64-byte slot for it); buildPartiallySignedV1Transaction+ * above already relies on exactly this to size-check a transaction mid-flow.+ */+export function planTransactionSize({ instructions, feePayer, blockhash: blockhashInput = SYNTHETIC_LIFETIME, version, budgetConfig = {} }) {+ if (version !== 'legacy' && version !== 0 && version !== 1) throw new TypeError('version must be "legacy", 0, or 1');+ if (typeof feePayer !== 'string' || !feePayer) throw new TypeError('feePayer is required');++ const parsedInstructions = parseInstructionsInput(instructions);+ const naiveAccounts = new Set([feePayer]);+ for (const ix of parsedInstructions) {+ naiveAccounts.add(ix.programId);+ for (const key of ix.keys) naiveAccounts.add(key.pubkey);+ }+ const kitInstructions = parsedInstructions.map(toKitInstruction);+ const budgetInstructions = version === 1 ? [] : budgetInstructionsForLegacy(budgetConfig);++ let message = pipe(+ createTransactionMessage({ version }),+ (m) => setTransactionMessageFeePayer(address(feePayer), m),+ (m) => setTransactionMessageLifetimeUsingBlockhash({ blockhash: blockhash(blockhashInput), lastValidBlockHeight: 0n }, m),+ (m) => appendTransactionMessageInstructions([...budgetInstructions, ...kitInstructions], m),+ );+ if (version === 1) message = setTransactionMessageConfig(v1ConfigFrom(budgetConfig), message);++ const compiledMessage = compileTransactionMessage(message);+ const compiled = compileTransaction(message);+ const encoded = getTransactionEncoder().encode(compiled);+ const limitBytes = version === 1 ? V1_TRANSACTION_LIMIT : LEGACY_TRANSACTION_LIMIT;+ const staticAccounts = (compiledMessage.staticAccounts || []).map(String);++ const implicitComputeLimit = defaultComputeUnitLimit(budgetInstructions.length + kitInstructions.length);+ const resolvedComputeUnitLimit = budgetConfig.computeUnitLimit ?? (version === 1 ? 0 : implicitComputeLimit);+ const requestedDataSizeLimit = budgetConfig.loadedAccountsDataSizeLimit ?? (version === 1 ? 0 : LOADED_ACCOUNTS_DATA_SIZE_DEFAULT_MAX);+ const priorityFeeLamports = budgetConfig.priorityFeeMicroLamportsPerCu != null+ ? priorityFeeLamportsFor(resolvedComputeUnitLimit, budgetConfig.priorityFeeMicroLamportsPerCu)+ : 0n;++ return {+ version,+ versionLabel: version === 'legacy' ? 'Legacy' : `V${version}`,+ bytes: encoded.length,+ messageBytes: compiled.messageBytes.length,+ signatureBytes: encoded.length - compiled.messageBytes.length,+ limitBytes,+ headroomBytes: limitBytes - encoded.length,+ overLimitBy: Math.max(0, encoded.length - limitBytes),+ fitsLegacy: encoded.length <= LEGACY_TRANSACTION_LIMIT,+ fitsV1: encoded.length <= V1_TRANSACTION_LIMIT,+ staticAccountCount: staticAccounts.length,+ instructionCount: budgetInstructions.length + kitInstructions.length,+ signerCount: Object.keys(compiled.signatures || {}).length,+ duplicateAccounts: findDuplicateAccounts(staticAccounts),+ accountReuse: {+ referencedCount: naiveAccounts.size,+ dedupedCount: staticAccounts.length,+ },+ resourceBudget: {+ computeUnitLimit: resolvedComputeUnitLimit,+ loadedAccountsDataSizeLimit: requestedDataSizeLimit,+ loadedAccountsHeadroomBytes: LOADED_ACCOUNTS_DATA_SIZE_DEFAULT_MAX - requestedDataSizeLimit,+ priorityFeeLamports: asSafeNumber(priorityFeeLamports),+ },+ };+}++/** The same instruction set compiled legacy, v0, and v1: byte-exact totals for all three, side by side. */+export function diffTransactionVersions({ instructions, feePayer, blockhash: blockhashInput, budgetConfig = {} }) {+ const plan = (version) => planTransactionSize({ instructions, feePayer, blockhash: blockhashInput, version, budgetConfig });+ const legacy = plan('legacy');+ const v0 = plan(0);+ const v1 = plan(1);+ return {+ legacy,+ v0,+ v1,+ bytesSavedVsLegacy: legacy.bytes - v1.bytes,+ bytesSavedVsV0: v0.bytes - v1.bytes,+ };+}diff --git a/api/solana/atomic-plan.js b/api/solana/atomic-plan.jsnew file mode 100644index 000000000..ddf68bad7--- /dev/null+++ b/api/solana/atomic-plan.js@@ -0,0 +1,62 @@+// Solana Transaction V1 size and budget planner: offline, exact byte math.+//+// POST /api/solana/atomic-plan+// { instructions, feePayer, version, budgetConfig?, blockhash? }+// -> { plan } for one version ("legacy" | 0 | 1)+//+// POST /api/solana/atomic-plan { instructions, feePayer, diff: true, budgetConfig?, blockhash? }+// -> { diff } with legacy, v0, and v1 compiled side by side+//+// No RPC round trip: the same instruction set is compiled with @solana/kit's+// own encoder, the library three.ws ships to real callers, so every reported+// byte is the exact wire size that version would produce, never an estimate.+// Nothing is signed or broadcast.++import { cors, error, json, method, readJson, wrap } from '../_lib/http.js';+import { clientIp, limits } from '../_lib/rate-limit.js';+import { diffTransactionVersions, planTransactionSize } from '../_lib/solana/transaction-v1.js';++function normalizeVersion(value) {+ if (value === 'legacy') return 'legacy';+ if (value === 0 || value === '0') return 0;+ if (value === 1 || value === '1') return 1;+ return undefined;+}++export default wrap(async function atomicPlanHandler(req, res) {+ if (cors(req, res, { origins: '*', methods: 'POST,OPTIONS' })) return;+ if (!method(req, res, ['POST'])) return;++ const [ipLimit, globalLimit] = await Promise.all([+ limits.cryptoDataIp(clientIp(req)),+ limits.cryptoDataGlobal(),+ ]);+ if (!ipLimit.success || !globalLimit.success) {+ return error(res, 429, 'rate_limited', 'too many requests - retry shortly');+ }++ let body;+ try {+ body = await readJson(req, 65_536);+ } catch (err) {+ return error(res, err.status || 400, 'invalid_json', err.message);+ }++ const { instructions, feePayer, budgetConfig, blockhash } = body;+ res.setHeader('cache-control', 'no-store');++ try {+ if (body.diff) {+ const diff = diffTransactionVersions({ instructions, feePayer, blockhash, budgetConfig });+ return json(res, 200, { diff });+ }+ const version = normalizeVersion(body.version);+ if (version === undefined) {+ return error(res, 400, 'invalid_version', 'version must be "legacy", 0, or 1');+ }+ const plan = planTransactionSize({ instructions, feePayer, blockhash, version, budgetConfig });+ return json(res, 200, { plan });+ } catch (err) {+ return error(res, 400, 'invalid_plan_input', err.message);+ }+});diff --git a/data/changelog.json b/data/changelog.jsonindex 0b812b8b9..f38988ee4 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-10-14",+ "title": "Atomic is now a six-tab Transaction V1 lab, not just an inspector",+ "summary": "/atomic grew five tabs beyond the Inspector, each reachable by click, arrow-key/Home/End tab navigation, or a deep link (?tab=mask, ?tab=sponsor, ?tab=planner, ?tab=diff, ?tab=wallet). The config mask decoder reads a V1 transaction's real TransactionConfigMask u32 and its fixed-width ConfigValues byte by byte, flagging a half-set priority-fee pair or a reserved bit SIMD-0385 has not assigned yet. The sponsor cap view shows a paymaster exactly what it is agreeing to pay, reading V1's inline config instead of a Compute Budget instruction scan that sees nothing on a V1 transaction. The size and budget planner compiles a pasted instruction set with @solana/kit to an exact byte count against legacy, V0, or V1's ceiling, including an exact lamport total for a chosen priority fee. The legacy/V0/V1 diff compiles the same instructions three ways and reports the real byte deltas, honestly, including the case where V1's inline config makes it larger than legacy. The wallet V1 capability check connects the browser's injected wallet and reports the same verdict the rest of three.ws would get from findV1WalletStandardSigner before ever requesting a real V1 signature. Nothing here is estimated: every number comes from compiling and decoding real transactions, and nothing is ever signed, simulated, or broadcast.",+ "tags": [+ "feature"+ ],+ "link": "/atomic"+ },{"date": "2026-10-14","title": "Atomic now replays a pump.fun transaction step by step",diff --git a/data/pages.json b/data/pages.jsonindex 759f003d8..aea0330cc 100644--- a/data/pages.json+++ b/data/pages.json@@ -1968,8 +1968,8 @@},{"path": "/atomic",- "title": "Atomic - Solana V1 Inspector",- "description": "A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.",+ "title": "Atomic - Solana V1 Transaction Lab",+ "description": "A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.","priority": 0.8,"changefreq": "always","added": "2026-09-15"diff --git a/docs/atomic.md b/docs/atomic.mdindex 2da3c8011..733acb260 100644--- a/docs/atomic.md+++ b/docs/atomic.md@@ -1,11 +1,12 @@-# Atomic: Solana Transaction V1 inspector+# Atomic: Solana Transaction V1 lab-[Atomic](/atomic) is three.ws's read-only flight recorder for Solana transactions. It accepts either a confirmed mainnet signature or signed wire bytes and returns the same normalized inspection for legacy, V0, and V1 transactions.+[Atomic](/atomic) is three.ws's read-only lab for Solana transactions: a tabbed flight recorder, size and budget planner, config mask decoder, legacy/V0/V1 diff, sponsor cap view, and wallet V1 capability check. The Inspector tab accepts either a confirmed mainnet signature or signed wire bytes and returns the same normalized inspection for legacy, V0, and V1 transactions; the other five tabs are documented below in "The lab: five more tools."-It is built for two jobs:+It is built for three jobs:-- Developers can see whether a payload needs V1's 4,096-byte envelope.+- Developers can see whether a payload needs V1's 4,096-byte envelope, and plan an exact byte budget before they build one.- Wallets, relayers, and fee sponsors can read the limits they are actually agreeing to before they co-sign.+- Anyone can check whether their own wallet honestly advertises V1 signing before they rely on it.Atomic never signs, simulates, or broadcasts a transaction.@@ -76,6 +77,45 @@ $THREE graduated its bonding curve some time ago, so this particular signature dA transaction with no pump.fun events (most Solana transactions) shows a plain "no pump.fun events in this transaction" state instead of an empty panel.+## The lab: five more tools++`/atomic` is a tabbed lab, not a single tool. The Inspector above is the first tab; the other five share its read-only guarantee (nothing is ever signed, simulated, or broadcast) and are reachable by click, by arrow-key/Home/End navigation on the tab bar, or by a deep link: `/atomic?tab=mask`, `?tab=sponsor`, `?tab=planner`, `?tab=diff`, `?tab=wallet`.++### Config mask decoder++Every V1 transaction carries a 4-byte `TransactionConfigMask` (a little-endian `u32`) immediately after the version byte and legacy header, followed by fixed-width `ConfigValues` for each set bit. This tab decodes those exact bytes from a pasted signature or wire transaction, independently of the higher-level `budget` field the Inspector shows, and reports:++- the mask as hex, as a 32-character binary string, and as a bit popcount;+- each of the five known bits (priority fee spans bits 0-1 as one 8-byte value; compute unit limit, loaded accounts data size, and heap size each own one bit and one 4-byte value), whether it is present, and its raw bytes and decoded value;+- a priority-fee mask with only one of its two bits set, flagged as a partial, invalid encoding (SIMD-0385 requires both or neither);+- any set bit above bit 4, flagged as reserved, since a future SIMD may assign it a meaning this decoder does not yet know;+- the exact byte offset range `ConfigValues` occupies in the message.++A legacy or V0 transaction has no config mask; the tab states that plainly instead of showing an empty table.++### Sponsor cap view++A paymaster or co-signer reads this before it agrees to pay. For the same pasted signature or wire transaction, it shows only what a sponsor needs: the resolved priority fee, compute unit limit, loaded-accounts data size limit, and heap size (reading V1's `transactionConfig` directly, never a Compute Budget instruction scan that would see nothing on a V1 transaction), plus a duplicate-static-account check. SIMD-0385 makes a duplicate entry in the static address table a sanitization failure; this view lists any duplicate it finds and states plainly when there is none.++### Size and budget planner++Paste a fee payer address and a JSON array of instructions (`{programId, keys: [{pubkey, isSigner, isWritable}], data}`, `data` as base64 or a byte array), pick a target version, and optionally a compute unit limit, loaded-accounts data size limit, heap size, and priority fee in micro-lamports per CU. The planner compiles that exact instruction set with `@solana/kit`, the same encoder three.ws ships to real callers, and reports:++- the exact wire byte count, headroom or overage against the chosen version's ceiling, and a visual ruler;+- inline account count, instruction count, required signer count, and message byte count;+- the resolved resource budget, including the priority fee as an exact total in lamports (compute unit limit times the micro-lamports price, rounded up to the nearest lamport, matching the runtime's own cost accounting);+- the duplicate-static-account check described above.++"Load example instruction" fills the form with a System Program transfer using `$THREE`'s mint as a clearly-synthetic placeholder account; it is never auto-filled on page load.++### Legacy vs V0 vs V1 diff++Same form as the planner, minus the version picker: it compiles the identical instruction set three ways (legacy, V0, V1) and reports each version's exact byte count, ceiling, headroom, and fit side by side, plus the byte delta V1 saves (or costs) against legacy and against V0. V1 is not assumed to always win: its inline config mask and fixed-width values can make a very small transaction larger than the same payload on legacy or V0, and the diff reports whichever is actually true for the pasted instructions.++### Wallet V1 capability check++Connects the browser's injected Solana wallet (a plain `connect()`, with no SIWS account-linking and no three.ws login as a side effect) and reads its real [Wallet Standard](https://github.com/wallet-standard/wallet-standard) `solana:signTransaction` feature. The pass/fail verdict comes from the same `findV1WalletStandardSigner` helper three.ws calls before it ever asks a wallet for a real V1 signature, so this tab reports exactly what the rest of the platform would see, not a separate approximation. If the wallet is V1-capable, the tab also lists every transaction version its own feature set advertises, verbatim.+## API### Mainnet activation status@@ -105,6 +145,37 @@ Content-Type: application/jsonThe raw path is not cached and does not send the transaction to Solana.+### Size and budget plan++```http+POST /api/solana/atomic-plan+Content-Type: application/json++{+ "feePayer": "BASE58_ADDRESS",+ "version": 1,+ "budgetConfig": { "computeUnitLimit": 200000, "loadedAccountsDataSizeLimit": 4096, "priorityFeeMicroLamportsPerCu": 10 },+ "instructions": [+ { "programId": "11111111111111111111111111111111", "keys": [{ "pubkey": "BASE58_ADDRESS", "isSigner": true, "isWritable": true }], "data": "BASE64_DATA" }+ ]+}+```++`version` is `"legacy"`, `0`, or `1`. `budgetConfig` and each of its fields are optional. Every reported number comes from compiling and encoding this exact instruction set with `@solana/kit`; nothing is estimated, signed, simulated, or broadcast. The handler is rate-limited the same way as `/api/solana/atomic` and caps the request body at 64 KiB and 64 instructions.++### Legacy vs V0 vs V1 diff++Same endpoint, with `"diff": true` in place of `version`:++```http+POST /api/solana/atomic-plan+Content-Type: application/json++{ "feePayer": "BASE58_ADDRESS", "diff": true, "budgetConfig": {}, "instructions": [ ... ] }+```++The response is `{ "diff": { "legacy", "v0", "v1", "bytesSavedVsLegacy", "bytesSavedVsV0" } }`, one plan object per version plus the byte deltas between them.+## Platform compatibilityEvery three.ws Solana transaction read now opts into version 1. The web app and API dependency floor is `@solana/kit` 8.3 and `@solana/web3.js` 1.99, so direct readers can decode V1 rather than rejecting it as an unsupported transaction version.diff --git a/pages/atomic.html b/pages/atomic.htmlindex e71bc6b8c..821edf917 100644--- a/pages/atomic.html+++ b/pages/atomic.html@@ -4,14 +4,14 @@<script>/* three.ws theme boot, no-flash; runtime in /theme-switcher.js */(function(){try{var m=localStorage.getItem('twx_theme');var l=m==='auto'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: light)').matches):m==='light';document.documentElement.setAttribute('data-theme',l?'light':'dark');}catch(e){document.documentElement.setAttribute('data-theme','dark');}})();</script><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1.0" />- <title data-i18n="atomic.page_title">Atomic · Solana V1 Transaction Inspector · three.ws</title>- <meta name="description" data-i18n-attr="content:atomic.meta_desc" content="Inspect any Solana transaction or unsigned handoff before you co-sign it. See exact wire size, V1 transactionConfig limits, compute use, and sponsor safety." />+ <title data-i18n="atomic.page_title">Atomic · Solana V1 Transaction Lab · three.ws</title>+ <meta name="description" data-i18n-attr="content:atomic.meta_desc" content="A real Solana Transaction V1 lab: inspect, plan exact byte budgets, decode the config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign." /><meta property="og:type" content="website" /><meta property="og:site_name" content="three.ws" /><meta property="og:url" content="https://three.ws/atomic" />- <meta property="og:title" data-i18n-attr="content:atomic.og_title" content="Atomic · Solana V1 Transaction Inspector" />- <meta property="og:description" data-i18n-attr="content:atomic.og_desc" content="A live V1 observatory and pre-sign safety microscope for Solana's new 4,096-byte transactions." />- <meta property="og:image" content="https://three.ws/api/page-og?s=crypto&t=Atomic+-+Solana+V1+Inspector&d=A+live+Solana+Transaction+V1+observatory+and+pre-sign+inspector.+Paste+a+mainnet+signature+or+base64+wire+transaction+to+see+exact+bytes%2C+resource+caps&p=%2Fatomic" />+ <meta property="og:title" data-i18n-attr="content:atomic.og_title" content="Atomic · Solana V1 Transaction Lab" />+ <meta property="og:description" data-i18n-attr="content:atomic.og_desc" content="A live V1 observatory, byte-exact planner, config-mask decoder, and pre-sign safety microscope for Solana's new 4,096-byte transactions." />+ <meta property="og:image" content="https://three.ws/api/page-og?s=crypto&t=Atomic+-+Solana+V1+Transaction+Lab&d=A+real+Solana+Transaction+V1+lab%3A+inspect+a+transaction%2C+plan+an+exact+byte+budget%2C+decode+the+raw+config+mask%2C+diff+legacy%2Fv0%2Fv1%2C+check+sponsor+caps%2C+and+test&p=%2Fatomic" /><meta name="twitter:card" content="summary_large_image" /><meta name="twitter:site" content="@trythreews" /><meta name="theme-color" content="#07100d" />@@ -22,14 +22,14 @@<link rel="stylesheet" href="/src/atomic.css" /><link rel="stylesheet" href="/footer.css" /><script defer src="/footer-newsletter.js"></script>- <script type="application/ld+json">{"@context":"https://schema.org","@type":"WebApplication","name":"Atomic","applicationCategory":"DeveloperApplication","operatingSystem":"Any","url":"https://three.ws/atomic","description":"A Solana V1 transaction inspector for wire size, resource configuration, compute use, and sponsor safety.","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"}}</script>+ <script type="application/ld+json">{"@context":"https://schema.org","@type":"WebApplication","name":"Atomic","applicationCategory":"DeveloperApplication","operatingSystem":"Any","url":"https://three.ws/atomic","description":"A Solana V1 transaction lab: wire inspector, size and budget planner, config mask decoder, legacy/v0/v1 diff, sponsor cap view, and wallet v1 capability check.","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"}}</script><meta name="robots" content="index, follow, max-image-preview:large, max-snippet:-1"><meta property="og:locale" content="en_US">- <meta property="og:image:alt" content="Atomic - Solana V1 Inspector - three.ws">- <meta name="twitter:title" data-i18n-attr="content:atomic.tw_title" content="Atomic - Solana V1 Inspector · three.ws">- <meta name="twitter:description" data-i18n-attr="content:atomic.tw_desc" content="A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.">- <meta name="twitter:image" content="https://three.ws/api/page-og?s=crypto&t=Atomic+-+Solana+V1+Inspector&d=A+live+Solana+Transaction+V1+observatory+and+pre-sign+inspector.+Paste+a+mainnet+signature+or+base64+wire+transaction+to+see+exact+bytes%2C+resource+caps&p=%2Fatomic">+ <meta property="og:image:alt" content="Atomic - Solana V1 Transaction Lab - three.ws">+ <meta name="twitter:title" data-i18n-attr="content:atomic.tw_title" content="Atomic - Solana V1 Transaction Lab · three.ws">+ <meta name="twitter:description" data-i18n-attr="content:atomic.tw_desc" content="A live Solana Transaction V1 lab. Inspect a transaction, plan an exact byte budget, decode the config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support.">+ <meta name="twitter:image" content="https://three.ws/api/page-og?s=crypto&t=Atomic+-+Solana+V1+Transaction+Lab&d=A+real+Solana+Transaction+V1+lab%3A+inspect+a+transaction%2C+plan+an+exact+byte+budget%2C+decode+the+raw+config+mask%2C+diff+legacy%2Fv0%2Fv1%2C+check+sponsor+caps%2C+and+test&p=%2Fatomic"></head><body><header><div id="nav-container"></div></header>@@ -40,7 +40,7 @@<div class="at-live" id="at-live"><span></span><strong data-i18n="atomic.live_status">Checking mainnet</strong><small id="at-slot" data-i18n="atomic.live_rpc">Live RPC</small></div><p class="at-eyebrow" data-i18n="atomic.eyebrow">Solana Transaction V1</p><h1 data-i18n-html="atomic.hero_title">See what fits <em>atomically.</em></h1>- <p class="at-lede" data-i18n="atomic.lede">The transaction ceiling is now 4 KiB. Atomic shows where every byte goes, reads V1 resource caps from the right place, and tells a sponsor what it would actually co-sign.</p>+ <p class="at-lede" data-i18n="atomic.lede">The transaction ceiling is now 4 KiB. Atomic inspects a real transaction, plans an exact byte budget before you build one, decodes the raw config mask, diffs legacy against v0 against v1, and tells a sponsor or a wallet exactly what it is agreeing to.</p><div class="at-hero-stats" aria-label="Transaction V1 headline statistics" data-i18n-attr="aria-label:atomic.hero_stats_aria"><div><strong>4,096</strong><span data-i18n="atomic.stat_bytes">bytes per V1 transaction</span></div><div><strong>3.3x</strong><span data-i18n="atomic.stat_legacy_room">the legacy payload room</span></div>@@ -48,93 +48,411 @@</div></section>- <section class="at-inspector" aria-labelledby="at-inspector-title">- <div class="at-panel-head">- <div><p class="at-label" data-i18n="atomic.inspector_label">Flight recorder</p><h2 id="at-inspector-title" data-i18n="atomic.inspector_title">Inspect before you sign</h2></div>- <div class="at-tabs" role="tablist" aria-label="Transaction input type" data-i18n-attr="aria-label:atomic.tabs_aria">- <button type="button" role="tab" id="at-tab-signature" aria-selected="true" data-mode="signature" data-i18n="atomic.tab_signature">On-chain signature</button>- <button type="button" role="tab" id="at-tab-wire" aria-selected="false" data-mode="wire" data-i18n="atomic.tab_wire">Base64 wire</button>+ <nav class="at-nav-tabs" role="tablist" aria-label="Atomic lab tools" data-i18n-attr="aria-label:atomic.nav_tabs_aria" id="at-nav-tabs">+ <button type="button" role="tab" id="at-nav-tab-inspector" aria-selected="true" aria-controls="at-panel-inspector" data-tab="inspector" data-i18n="atomic.nav_inspector">Inspector</button>+ <button type="button" role="tab" id="at-nav-tab-mask" aria-selected="false" aria-controls="at-panel-mask" tabindex="-1" data-tab="mask" data-i18n="atomic.nav_mask">Config mask</button>+ <button type="button" role="tab" id="at-nav-tab-sponsor" aria-selected="false" aria-controls="at-panel-sponsor" tabindex="-1" data-tab="sponsor" data-i18n="atomic.nav_sponsor">Sponsor caps</button>+ <button type="button" role="tab" id="at-nav-tab-planner" aria-selected="false" aria-controls="at-panel-planner" tabindex="-1" data-tab="planner" data-i18n="atomic.nav_planner">Planner</button>+ <button type="button" role="tab" id="at-nav-tab-diff" aria-selected="false" aria-controls="at-panel-diff" tabindex="-1" data-tab="diff" data-i18n="atomic.nav_diff">Version diff</button>+ <button type="button" role="tab" id="at-nav-tab-wallet" aria-selected="false" aria-controls="at-panel-wallet" tabindex="-1" data-tab="wallet" data-i18n="atomic.nav_wallet">Wallet check</button>+ </nav>++ <section class="at-panel" id="at-panel-inspector" role="tabpanel" aria-labelledby="at-nav-tab-inspector">+ <section class="at-inspector" aria-labelledby="at-inspector-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.inspector_label">Flight recorder</p><h2 id="at-inspector-title" data-i18n="atomic.inspector_title">Inspect before you sign</h2></div>+ <div class="at-tabs" role="tablist" aria-label="Transaction input type" data-i18n-attr="aria-label:atomic.tabs_aria">+ <button type="button" role="tab" id="at-tab-signature" aria-selected="true" data-mode="signature" data-i18n="atomic.tab_signature">On-chain signature</button>+ <button type="button" role="tab" id="at-tab-wire" aria-selected="false" data-mode="wire" data-i18n="atomic.tab_wire">Base64 wire</button>+ </div></div>- </div>- <form id="at-form" class="at-form">- <label for="at-input" id="at-input-label" data-i18n="atomic.input_label">Solana mainnet transaction signature</label>- <div class="at-input-row">- <textarea id="at-input" rows="2" spellcheck="false" autocomplete="off" placeholder="Paste a transaction signature" data-i18n-attr="placeholder:atomic.input_placeholder"></textarea>- <button type="submit" id="at-submit" data-i18n="atomic.submit_btn">Inspect transaction</button>+ <form id="at-form" class="at-form">+ <label for="at-input" id="at-input-label" data-i18n="atomic.input_label">Solana mainnet transaction signature</label>+ <div class="at-input-row">+ <textarea id="at-input" rows="2" spellcheck="false" autocomplete="off" placeholder="Paste a transaction signature" data-i18n-attr="placeholder:atomic.input_placeholder"></textarea>+ <button type="submit" id="at-submit" data-i18n="atomic.submit_btn">Inspect transaction</button>+ </div>+ <p id="at-hint" data-i18n="atomic.hint">Fetched through the three.ws rotating Solana RPC rail with V1 reads enabled.</p>+ </form>+ </section>++ <section class="at-state" id="at-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.loading_text">Decoding the exact wire transaction...</p>+ </section>+ <section class="at-state at-error" id="at-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.error_title">Could not inspect that transaction</strong><p id="at-error-message"></p><button type="button" id="at-retry" data-i18n="atomic.retry_btn">Try again</button>+ </section>++ <section class="at-report" id="at-report" hidden aria-live="polite">+ <div class="at-verdict">+ <div><p class="at-label" data-i18n="atomic.verdict_label">Decoded format</p><h2><span id="at-version">V1</span> transaction</h2><p id="at-verdict-copy"></p></div>+ <div class="at-verdict-badge" id="at-verdict-badge" data-i18n="atomic.verdict_badge">Caps explicit</div></div>- <p id="at-hint" data-i18n="atomic.hint">Fetched through the three.ws rotating Solana RPC rail with V1 reads enabled.</p>- </form>- </section>- <section class="at-state" id="at-loading" hidden aria-live="polite">- <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.loading_text">Decoding the exact wire transaction...</p>- </section>- <section class="at-state at-error" id="at-error" hidden aria-live="assertive">- <strong data-i18n="atomic.error_title">Could not inspect that transaction</strong><p id="at-error-message"></p><button type="button" id="at-retry" data-i18n="atomic.retry_btn">Try again</button>+ <section class="at-size-card" aria-labelledby="at-size-title">+ <div class="at-section-head"><div><p class="at-label" data-i18n="atomic.size_label">Wire envelope</p><h3 id="at-size-title"><span id="at-bytes">0</span> bytes</h3></div><strong id="at-headroom">0 bytes free</strong></div>+ <div class="at-ruler" id="at-ruler"><div id="at-size-fill"></div><i id="at-legacy-mark"><span data-i18n="atomic.legacy_wall">Legacy wall · 1,232</span></i></div>+ <p class="at-ruler-note" id="at-size-note"></p>+ </section>++ <div class="at-metrics">+ <div><span data-i18n="atomic.metric_signatures">Signatures</span><strong id="at-signatures">0</strong></div>+ <div><span data-i18n="atomic.metric_accounts">Inline accounts</span><strong id="at-accounts">0</strong></div>+ <div><span data-i18n="atomic.metric_instructions">Instructions</span><strong id="at-instructions">0</strong></div>+ <div><span data-i18n="atomic.metric_compute">Compute used</span><strong id="at-compute-used" data-i18n="atomic.compute_not_onchain">Not on-chain</strong></div>+ </div>++ <div class="at-report-grid">+ <section class="at-card" aria-labelledby="at-config-title">+ <div class="at-section-head"><div><p class="at-label" data-i18n="atomic.config_label">Resource envelope</p><h3 id="at-config-title" data-i18n="atomic.config_title">Transaction config</h3></div><span class="at-source" id="at-config-source"></span></div>+ <dl class="at-config">+ <div><dt data-i18n="atomic.cfg_cu_limit">Compute unit limit</dt><dd id="at-cu-limit"></dd></div>+ <div><dt data-i18n="atomic.cfg_data_limit">Loaded account data</dt><dd id="at-data-limit"></dd></div>+ <div><dt data-i18n="atomic.cfg_heap">Heap size</dt><dd id="at-heap"></dd></div>+ <div><dt data-i18n="atomic.cfg_priority">Priority fee</dt><dd id="at-priority"></dd></div>+ </dl>+ </section>+ <section class="at-card" aria-labelledby="at-sponsor-title">+ <p class="at-label" data-i18n="atomic.sponsor_label">Co-signing lens</p><h3 id="at-sponsor-title" data-i18n="atomic.sponsor_title">Sponsor assessment</h3>+ <ul class="at-notes" id="at-notes"></ul>+ <div class="at-actions"><a id="at-explorer" target="_blank" rel="noopener noreferrer" hidden data-i18n="atomic.explorer_link">Open in Solscan</a><button type="button" id="at-share" data-i18n="atomic.share_btn">Copy inspection link</button></div>+ </section>+ </div>++ <section class="at-replay" id="at-replay" aria-labelledby="at-replay-title">+ <div class="at-section-head">+ <div><p class="at-label" data-i18n="atomic.replay_label">Pump.fun lifecycle</p><h3 id="at-replay-title" data-i18n="atomic.replay_title">Replay</h3></div>+ <a id="at-replay-mint-link" class="at-replay-mint-link" target="_blank" rel="noopener noreferrer" hidden data-i18n="atomic.replay_view_launch">View launch →</a>+ </div>+ <p class="at-replay-empty" id="at-replay-empty" hidden data-i18n="atomic.replay_empty">No pump.fun events in this transaction. Atomic decodes create, trade, graduation, fee-collection, fee-distribution, and GitHub social-fee-claim events from Pump, PumpSwap, and PumpFees. This transaction did not invoke any of them.</p>+ <div class="at-replay-curve" id="at-replay-curve" hidden>+ <div class="at-ruler"><div id="at-replay-curve-fill"></div></div>+ <p class="at-ruler-note" id="at-replay-curve-note"></p>+ </div>+ <ol class="at-replay-steps" id="at-replay-steps"></ol>+ <div class="at-replay-skeleton" id="at-replay-skeleton" hidden aria-hidden="true"><div></div><div></div><div></div></div>+ <div class="at-replay-error" id="at-replay-error" hidden>+ <p id="at-replay-error-message"></p>+ <button type="button" id="at-replay-retry" data-i18n="atomic.replay_retry">Retry replay</button>+ </div>+ <div class="at-replay-loadmore" id="at-replay-loadmore-wrap" hidden>+ <button type="button" id="at-replay-loadmore" data-i18n="atomic.replay_loadmore">Load earlier trades</button>+ </div>+ </section>+ </section>++ <section class="at-empty" id="at-empty">+ <article><span>01</span><h2 data-i18n="atomic.feat1_title">Reader safe</h2><p data-i18n="atomic.feat1_body">Atomic requests transaction version 1 explicitly, so V1 traffic cannot break or disappear from the read path.</p></article>+ <article><span>02</span><h2 data-i18n="atomic.feat2_title">Sponsor aware</h2><p data-i18n-html="atomic.feat2_body">V1 caps live in <code>transactionConfig</code>. Atomic never pretends a Compute Budget instruction scan still binds them.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.feat3_title">Byte exact</h2><p data-i18n="atomic.feat3_body">The gauge measures signed wire bytes, not an estimate. Transactions above the old MTU wall become immediately visible.</p></article>+ </section></section>- <section class="at-report" id="at-report" hidden aria-live="polite">- <div class="at-verdict">- <div><p class="at-label" data-i18n="atomic.verdict_label">Decoded format</p><h2><span id="at-version">V1</span> transaction</h2><p id="at-verdict-copy"></p></div>- <div class="at-verdict-badge" id="at-verdict-badge" data-i18n="atomic.verdict_badge">Caps explicit</div>- </div>+ <section class="at-panel" id="at-panel-mask" role="tabpanel" aria-labelledby="at-nav-tab-mask" hidden>+ <section class="at-inspector" aria-labelledby="at-mask-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.mask_label">Bit layout</p><h2 id="at-mask-title" data-i18n="atomic.mask_title">Decode the config mask</h2></div>+ <div class="at-tabs" role="tablist" aria-label="Transaction input type" data-i18n-attr="aria-label:atomic.tabs_aria">+ <button type="button" role="tab" id="at-mask-tab-signature" aria-selected="true" data-mask-mode="signature" data-i18n="atomic.tab_signature">On-chain signature</button>+ <button type="button" role="tab" id="at-mask-tab-wire" aria-selected="false" data-mask-mode="wire" data-i18n="atomic.tab_wire">Base64 wire</button>+ </div>+ </div>+ <p class="at-panel-note" data-i18n="atomic.mask_intro">Every V1 transaction carries a 4-byte <code>TransactionConfigMask</code> right after the version byte and legacy header. Atomic reads those exact bits and the fixed-width values that follow, SIMD-0385, not an estimate.</p>+ <form id="at-mask-form" class="at-form">+ <label for="at-mask-input" id="at-mask-input-label" data-i18n="atomic.input_label">Solana mainnet transaction signature</label>+ <div class="at-input-row">+ <textarea id="at-mask-input" rows="2" spellcheck="false" autocomplete="off" placeholder="Paste a transaction signature" data-i18n-attr="placeholder:atomic.input_placeholder"></textarea>+ <button type="submit" id="at-mask-submit" data-i18n="atomic.mask_submit_btn">Decode mask</button>+ </div>+ <p id="at-mask-hint" data-i18n="atomic.hint">Fetched through the three.ws rotating Solana RPC rail with V1 reads enabled.</p>+ </form>+ </section>- <section class="at-size-card" aria-labelledby="at-size-title">- <div class="at-section-head"><div><p class="at-label" data-i18n="atomic.size_label">Wire envelope</p><h3 id="at-size-title"><span id="at-bytes">0</span> bytes</h3></div><strong id="at-headroom">0 bytes free</strong></div>- <div class="at-ruler" id="at-ruler"><div id="at-size-fill"></div><i id="at-legacy-mark"><span data-i18n="atomic.legacy_wall">Legacy wall · 1,232</span></i></div>- <p class="at-ruler-note" id="at-size-note"></p>+ <section class="at-state" id="at-mask-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.mask_loading_text">Reading the config mask bits...</p>+ </section>+ <section class="at-state at-error" id="at-mask-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.error_title">Could not inspect that transaction</strong><p id="at-mask-error-message"></p><button type="button" id="at-mask-retry" data-i18n="atomic.retry_btn">Try again</button></section>- <div class="at-metrics">- <div><span data-i18n="atomic.metric_signatures">Signatures</span><strong id="at-signatures">0</strong></div>- <div><span data-i18n="atomic.metric_accounts">Inline accounts</span><strong id="at-accounts">0</strong></div>- <div><span data-i18n="atomic.metric_instructions">Instructions</span><strong id="at-instructions">0</strong></div>- <div><span data-i18n="atomic.metric_compute">Compute used</span><strong id="at-compute-used" data-i18n="atomic.compute_not_onchain">Not on-chain</strong></div>- </div>+ <section class="at-report" id="at-mask-report" hidden aria-live="polite">+ <div class="at-verdict">+ <div><p class="at-label" data-i18n="atomic.verdict_label">Decoded format</p><h2><span id="at-mask-version">V1</span> transaction</h2><p id="at-mask-not-v1" hidden data-i18n="atomic.mask_not_v1">Legacy and V0 carry resource limits as Compute Budget instructions, not a config mask. There is no mask to decode on this transaction.</p></div>+ <div class="at-verdict-badge" id="at-mask-reserved-badge" hidden data-i18n="atomic.mask_reserved_badge">Reserved bits set</div>+ </div>+ <section class="at-card" id="at-mask-bits-card" aria-labelledby="at-mask-bits-title">+ <div class="at-section-head"><div><p class="at-label" data-i18n="atomic.mask_bits_label">u32, little-endian</p><h3 id="at-mask-bits-title" data-i18n="atomic.mask_bits_title">Mask bits</h3></div><strong id="at-mask-hex"></strong></div>+ <p class="at-mask-binary" id="at-mask-binary"></p>+ <p class="at-ruler-note" id="at-mask-popcount"></p>+ </section>+ <table class="at-mask-table" id="at-mask-table" aria-describedby="at-mask-bits-title">+ <thead><tr><th data-i18n="atomic.mask_th_field">Field</th><th data-i18n="atomic.mask_th_bits">Bit(s)</th><th data-i18n="atomic.mask_th_present">Present</th><th data-i18n="atomic.mask_th_width">Width</th><th data-i18n="atomic.mask_th_raw">Raw bytes</th><th data-i18n="atomic.mask_th_value">Value</th></tr></thead>+ <tbody id="at-mask-fields"></tbody>+ </table>+ <p class="at-ruler-note" id="at-mask-offsets"></p>+ </section>++ <section class="at-empty" id="at-mask-empty">+ <article><span>01</span><h2 data-i18n="atomic.mask_feat1_title">4 known fields</h2><p data-i18n="atomic.mask_feat1_body">Priority fee (bits 0-1, 8 bytes), compute unit limit (bit 2, 4 bytes), loaded accounts data size (bit 3, 4 bytes), and requested heap size (bit 4, 4 bytes).</p></article>+ <article><span>02</span><h2 data-i18n="atomic.mask_feat2_title">Sanitization aware</h2><p data-i18n="atomic.mask_feat2_body">The priority fee bits must both be set or both cleared. Atomic flags a mask where only one is set as a partial, invalid encoding.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.mask_feat3_title">Reserved bits</h2><p data-i18n="atomic.mask_feat3_body">Bits 5-31 are reserved. Atomic calls out any transaction that sets one, since a future SIMD may assign it a meaning this decoder does not yet know.</p></article>+ </section>+ </section>++ <section class="at-panel" id="at-panel-sponsor" role="tabpanel" aria-labelledby="at-nav-tab-sponsor" hidden>+ <section class="at-inspector" aria-labelledby="at-sponsor-view-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.sponsor_view_label">Before you co-sign</p><h2 id="at-sponsor-view-title" data-i18n="atomic.sponsor_view_title">Sponsor cap view</h2></div>+ <div class="at-tabs" role="tablist" aria-label="Transaction input type" data-i18n-attr="aria-label:atomic.tabs_aria">+ <button type="button" role="tab" id="at-sponsor-tab-signature" aria-selected="true" data-sponsor-mode="signature" data-i18n="atomic.tab_signature">On-chain signature</button>+ <button type="button" role="tab" id="at-sponsor-tab-wire" aria-selected="false" data-sponsor-mode="wire" data-i18n="atomic.tab_wire">Base64 wire</button>+ </div>+ </div>+ <p class="at-panel-note" data-i18n="atomic.sponsor_view_intro">A paymaster or co-signer reads this before it agrees to pay. It shows the exact fee and resource caps the transaction commits to, and whether its static account list holds a duplicate the v1 sanitizer would reject.</p>+ <form id="at-sponsor-form" class="at-form">+ <label for="at-sponsor-input" id="at-sponsor-input-label" data-i18n="atomic.input_label">Solana mainnet transaction signature</label>+ <div class="at-input-row">+ <textarea id="at-sponsor-input" rows="2" spellcheck="false" autocomplete="off" placeholder="Paste a transaction signature" data-i18n-attr="placeholder:atomic.input_placeholder"></textarea>+ <button type="submit" id="at-sponsor-submit" data-i18n="atomic.sponsor_submit_btn">Check sponsor caps</button>+ </div>+ <p id="at-sponsor-hint" data-i18n="atomic.hint">Fetched through the three.ws rotating Solana RPC rail with V1 reads enabled.</p>+ </form>+ </section>++ <section class="at-state" id="at-sponsor-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.sponsor_loading_text">Reading the resource caps this sponsor would agree to...</p>+ </section>+ <section class="at-state at-error" id="at-sponsor-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.error_title">Could not inspect that transaction</strong><p id="at-sponsor-error-message"></p><button type="button" id="at-sponsor-retry" data-i18n="atomic.retry_btn">Try again</button>+ </section>- <div class="at-report-grid">- <section class="at-card" aria-labelledby="at-config-title">- <div class="at-section-head"><div><p class="at-label" data-i18n="atomic.config_label">Resource envelope</p><h3 id="at-config-title" data-i18n="atomic.config_title">Transaction config</h3></div><span class="at-source" id="at-config-source"></span></div>- <dl class="at-config">- <div><dt data-i18n="atomic.cfg_cu_limit">Compute unit limit</dt><dd id="at-cu-limit"></dd></div>- <div><dt data-i18n="atomic.cfg_data_limit">Loaded account data</dt><dd id="at-data-limit"></dd></div>- <div><dt data-i18n="atomic.cfg_heap">Heap size</dt><dd id="at-heap"></dd></div>- <div><dt data-i18n="atomic.cfg_priority">Priority fee</dt><dd id="at-priority"></dd></div>- </dl>+ <section class="at-report" id="at-sponsor-report" hidden aria-live="polite">+ <div class="at-verdict">+ <div><p class="at-label" data-i18n="atomic.verdict_label">Decoded format</p><h2><span id="at-sponsor-version">V1</span> transaction</h2><p id="at-sponsor-verdict-copy"></p></div>+ <div class="at-verdict-badge" id="at-sponsor-verdict-badge" data-i18n="atomic.verdict_badge">Caps explicit</div>+ </div>+ <section class="at-card" aria-labelledby="at-sponsor-caps-title">+ <p class="at-label" data-i18n="atomic.sponsor_caps_label">What this sponsor is agreeing to</p><h3 id="at-sponsor-caps-title" data-i18n="atomic.sponsor_caps_title">Fee and resource caps</h3>+ <dl class="at-config">+ <div><dt data-i18n="atomic.cfg_priority">Priority fee</dt><dd id="at-sponsor-priority"></dd></div>+ <div><dt data-i18n="atomic.cfg_cu_limit">Compute unit limit</dt><dd id="at-sponsor-cu"></dd></div>+ <div><dt data-i18n="atomic.cfg_data_limit">Loaded account data</dt><dd id="at-sponsor-data"></dd></div>+ <div><dt data-i18n="atomic.cfg_heap">Heap size</dt><dd id="at-sponsor-heap"></dd></div>+ </dl></section>- <section class="at-card" aria-labelledby="at-sponsor-title">- <p class="at-label" data-i18n="atomic.sponsor_label">Co-signing lens</p><h3 id="at-sponsor-title" data-i18n="atomic.sponsor_title">Sponsor assessment</h3>- <ul class="at-notes" id="at-notes"></ul>- <div class="at-actions"><a id="at-explorer" target="_blank" rel="noopener noreferrer" hidden data-i18n="atomic.explorer_link">Open in Solscan</a><button type="button" id="at-share" data-i18n="atomic.share_btn">Copy inspection link</button></div>+ <section class="at-card" aria-labelledby="at-sponsor-dup-title">+ <p class="at-label" data-i18n="atomic.sponsor_dup_label">V1 sanitization rule</p><h3 id="at-sponsor-dup-title" data-i18n="atomic.sponsor_dup_title">Duplicate static accounts</h3>+ <p class="at-ruler-note" id="at-sponsor-dup-summary"></p>+ <ul class="at-notes" id="at-sponsor-dup-list"></ul></section>- </div>+ <section class="at-card" aria-labelledby="at-sponsor-notes-title">+ <p class="at-label" data-i18n="atomic.sponsor_label">Co-signing lens</p><h3 id="at-sponsor-notes-title" data-i18n="atomic.sponsor_title">Sponsor assessment</h3>+ <ul class="at-notes" id="at-sponsor-view-notes"></ul>+ </section>+ </section>- <section class="at-replay" id="at-replay" aria-labelledby="at-replay-title">- <div class="at-section-head">- <div><p class="at-label" data-i18n="atomic.replay_label">Pump.fun lifecycle</p><h3 id="at-replay-title" data-i18n="atomic.replay_title">Replay</h3></div>- <a id="at-replay-mint-link" class="at-replay-mint-link" target="_blank" rel="noopener noreferrer" hidden data-i18n="atomic.replay_view_launch">View launch →</a>+ <section class="at-empty" id="at-sponsor-empty">+ <article><span>01</span><h2 data-i18n="atomic.sponsor_feat1_title">Caps, not hopes</h2><p data-i18n="atomic.sponsor_feat1_body">On V1, a Compute Budget instruction scan sees nothing. The real caps live in transactionConfig, and this view reads them from there.</p></article>+ <article><span>02</span><h2 data-i18n="atomic.sponsor_feat2_title">Duplicate check</h2><p data-i18n="atomic.sponsor_feat2_body">SIMD-0385 makes a duplicate static account a sanitization failure. This view decodes the wire account list and flags one if present.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.sponsor_feat3_title">Zero means zero</h2><p data-i18n="atomic.sponsor_feat3_body">An unset V1 compute or data limit resolves to zero, not a legacy default. A sponsor relying on the old default would be wrong to assume otherwise.</p></article>+ </section>+ </section>++ <section class="at-panel" id="at-panel-planner" role="tabpanel" aria-labelledby="at-nav-tab-planner" hidden>+ <section class="at-inspector" aria-labelledby="at-plan-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.plan_label">Before you build</p><h2 id="at-plan-title" data-i18n="atomic.plan_title">Size and budget planner</h2></div></div>- <p class="at-replay-empty" id="at-replay-empty" hidden data-i18n="atomic.replay_empty">No pump.fun events in this transaction. Atomic decodes create, trade, graduation, fee-collection, fee-distribution, and GitHub social-fee-claim events from Pump, PumpSwap, and PumpFees. This transaction did not invoke any of them.</p>- <div class="at-replay-curve" id="at-replay-curve" hidden>- <div class="at-ruler"><div id="at-replay-curve-fill"></div></div>- <p class="at-ruler-note" id="at-replay-curve-note"></p>+ <p class="at-panel-note" data-i18n="atomic.plan_intro">Compiles your instruction set with the same @solana/kit encoder three.ws ships to real callers and reports the exact wire size. Nothing here is signed, simulated, or broadcast.</p>+ <form id="at-plan-form" class="at-plan-form">+ <div class="at-plan-grid">+ <div class="at-field">+ <label for="at-plan-feepayer" data-i18n="atomic.plan_feepayer_label">Fee payer address</label>+ <input id="at-plan-feepayer" type="text" spellcheck="false" autocomplete="off" placeholder="Base58 Solana address" data-i18n-attr="placeholder:atomic.plan_feepayer_placeholder" />+ </div>+ <div class="at-field">+ <label for="at-plan-version" data-i18n="atomic.plan_version_label">Transaction version</label>+ <select id="at-plan-version">+ <option value="1" selected data-i18n="atomic.plan_version_v1">V1 (4,096 bytes)</option>+ <option value="0" data-i18n="atomic.plan_version_v0">V0 (1,232 bytes)</option>+ <option value="legacy" data-i18n="atomic.plan_version_legacy">Legacy (1,232 bytes)</option>+ </select>+ </div>+ <div class="at-field">+ <label for="at-plan-cu" data-i18n="atomic.plan_cu_label">Compute unit limit</label>+ <input id="at-plan-cu" type="number" min="0" max="1400000" placeholder="e.g. 200000" />+ </div>+ <div class="at-field">+ <label for="at-plan-data-size" data-i18n="atomic.plan_data_label">Loaded accounts data size (bytes)</label>+ <input id="at-plan-data-size" type="number" min="0" placeholder="e.g. 4096" />+ </div>+ <div class="at-field">+ <label for="at-plan-heap" data-i18n="atomic.plan_heap_label">Requested heap size (bytes)</label>+ <input id="at-plan-heap" type="number" min="32768" max="262144" step="1024" placeholder="32768 default" />+ </div>+ <div class="at-field">+ <label for="at-plan-priority" data-i18n="atomic.plan_priority_label">Priority fee (µlamports / CU)</label>+ <input id="at-plan-priority" type="number" min="0" placeholder="e.g. 10" />+ </div>+ </div>+ <div class="at-field">+ <label for="at-plan-instructions" data-i18n="atomic.plan_instructions_label">Instructions (JSON array)</label>+ <textarea id="at-plan-instructions" rows="7" spellcheck="false" autocomplete="off" placeholder='[{"programId":"...","keys":[{"pubkey":"...","isSigner":true,"isWritable":true}],"data":"base64..."}]' data-i18n-attr="placeholder:atomic.plan_instructions_placeholder"></textarea>+ </div>+ <div class="at-input-row">+ <button type="button" id="at-plan-example" data-i18n="atomic.plan_example_btn">Load example instruction</button>+ <button type="submit" id="at-plan-submit" data-i18n="atomic.plan_submit_btn">Plan size and budget</button>+ </div>+ <p id="at-plan-hint" data-i18n="atomic.plan_hint">$THREE's mint is used in the example only as a clearly-synthetic placeholder account, not a live transfer.</p>+ </form>+ </section>++ <section class="at-state" id="at-plan-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.plan_loading_text">Compiling the exact wire transaction...</p>+ </section>+ <section class="at-state at-error" id="at-plan-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.plan_error_title">Could not plan that transaction</strong><p id="at-plan-error-message"></p><button type="button" id="at-plan-retry" data-i18n="atomic.retry_btn">Try again</button>+ </section>++ <section class="at-report" id="at-plan-report" hidden aria-live="polite">+ <section class="at-size-card" aria-labelledby="at-plan-size-title">+ <div class="at-section-head"><div><p class="at-label" id="at-plan-version-label">V1</p><h3 id="at-plan-size-title"><span id="at-plan-bytes">0</span> bytes</h3></div><strong id="at-plan-headroom">0 bytes free</strong></div>+ <div class="at-ruler" id="at-plan-ruler"><div id="at-plan-size-fill"></div></div>+ <p class="at-ruler-note" id="at-plan-size-note"></p>+ </section>+ <div class="at-metrics">+ <div><span data-i18n="atomic.metric_accounts">Inline accounts</span><strong id="at-plan-accounts">0</strong></div>+ <div><span data-i18n="atomic.metric_instructions">Instructions</span><strong id="at-plan-instructions-count">0</strong></div>+ <div><span data-i18n="atomic.plan_metric_signers">Required signers</span><strong id="at-plan-signers">0</strong></div>+ <div><span data-i18n="atomic.plan_metric_message">Message bytes</span><strong id="at-plan-message-bytes">0</strong></div></div>- <ol class="at-replay-steps" id="at-replay-steps"></ol>- <div class="at-replay-skeleton" id="at-replay-skeleton" hidden aria-hidden="true"><div></div><div></div><div></div></div>- <div class="at-replay-error" id="at-replay-error" hidden>- <p id="at-replay-error-message"></p>- <button type="button" id="at-replay-retry" data-i18n="atomic.replay_retry">Retry replay</button>+ <div class="at-report-grid">+ <section class="at-card" aria-labelledby="at-plan-budget-title">+ <p class="at-label" data-i18n="atomic.plan_budget_label">Resolved resource budget</p><h3 id="at-plan-budget-title" data-i18n="atomic.config_title">Transaction config</h3>+ <dl class="at-config">+ <div><dt data-i18n="atomic.cfg_cu_limit">Compute unit limit</dt><dd id="at-plan-cu-out"></dd></div>+ <div><dt data-i18n="atomic.cfg_data_limit">Loaded account data</dt><dd id="at-plan-data-out"></dd></div>+ <div><dt data-i18n="atomic.plan_data_headroom">Data size headroom</dt><dd id="at-plan-data-headroom"></dd></div>+ <div><dt data-i18n="atomic.cfg_priority">Priority fee total</dt><dd id="at-plan-priority-out"></dd></div>+ </dl>+ </section>+ <section class="at-card" aria-labelledby="at-plan-dup-title">+ <p class="at-label" data-i18n="atomic.sponsor_dup_label">V1 sanitization rule</p><h3 id="at-plan-dup-title" data-i18n="atomic.sponsor_dup_title">Duplicate static accounts</h3>+ <p class="at-ruler-note" id="at-plan-dup-summary"></p>+ <ul class="at-notes" id="at-plan-dup-list"></ul>+ </section></div>- <div class="at-replay-loadmore" id="at-replay-loadmore-wrap" hidden>- <button type="button" id="at-replay-loadmore" data-i18n="atomic.replay_loadmore">Load earlier trades</button>+ </section>++ <section class="at-empty" id="at-plan-empty">+ <article><span>01</span><h2 data-i18n="atomic.plan_feat1_title">Exact, not estimated</h2><p data-i18n="atomic.plan_feat1_body">Every byte count comes from compiling your instructions with @solana/kit and encoding the result, the same path a real sender would take.</p></article>+ <article><span>02</span><h2 data-i18n="atomic.plan_feat2_title">Ceilings both ways</h2><p data-i18n="atomic.plan_feat2_body">Plan against the 1,232-byte legacy/v0 wall or the 4,096-byte V1 envelope, with the exact headroom or overage reported either way.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.plan_feat3_title">Priority fee, computed</h2><p data-i18n="atomic.plan_feat3_body">Set a µlamports-per-CU price and a compute unit limit; the planner multiplies them into the exact total lamports a V1 sender would commit to.</p></article>+ </section>+ </section>++ <section class="at-panel" id="at-panel-diff" role="tabpanel" aria-labelledby="at-nav-tab-diff" hidden>+ <section class="at-inspector" aria-labelledby="at-diff-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.diff_label">Same instructions, three envelopes</p><h2 id="at-diff-title" data-i18n="atomic.diff_title">Legacy vs V0 vs V1</h2></div></div>+ <p class="at-panel-note" data-i18n="atomic.diff_intro">Compiles the same instruction set three ways and reports the byte-exact total for each, side by side.</p>+ <form id="at-diff-form" class="at-plan-form">+ <div class="at-plan-grid">+ <div class="at-field">+ <label for="at-diff-feepayer" data-i18n="atomic.plan_feepayer_label">Fee payer address</label>+ <input id="at-diff-feepayer" type="text" spellcheck="false" autocomplete="off" placeholder="Base58 Solana address" data-i18n-attr="placeholder:atomic.plan_feepayer_placeholder" />+ </div>+ <div class="at-field">+ <label for="at-diff-cu" data-i18n="atomic.plan_cu_label">Compute unit limit</label>+ <input id="at-diff-cu" type="number" min="0" max="1400000" placeholder="e.g. 200000" />+ </div>+ <div class="at-field">+ <label for="at-diff-data-size" data-i18n="atomic.plan_data_label">Loaded accounts data size (bytes)</label>+ <input id="at-diff-data-size" type="number" min="0" placeholder="e.g. 4096" />+ </div>+ <div class="at-field">+ <label for="at-diff-heap" data-i18n="atomic.plan_heap_label">Requested heap size (bytes)</label>+ <input id="at-diff-heap" type="number" min="32768" max="262144" step="1024" placeholder="32768 default" />+ </div>+ <div class="at-field">+ <label for="at-diff-priority" data-i18n="atomic.plan_priority_label">Priority fee (µlamports / CU)</label>+ <input id="at-diff-priority" type="number" min="0" placeholder="e.g. 10" />+ </div>+ </div>+ <div class="at-field">+ <label for="at-diff-instructions" data-i18n="atomic.plan_instructions_label">Instructions (JSON array)</label>+ <textarea id="at-diff-instructions" rows="7" spellcheck="false" autocomplete="off" placeholder='[{"programId":"...","keys":[{"pubkey":"...","isSigner":true,"isWritable":true}],"data":"base64..."}]' data-i18n-attr="placeholder:atomic.plan_instructions_placeholder"></textarea>+ </div>+ <div class="at-input-row">+ <button type="button" id="at-diff-example" data-i18n="atomic.plan_example_btn">Load example instruction</button>+ <button type="submit" id="at-diff-submit" data-i18n="atomic.diff_submit_btn">Diff all three versions</button>+ </div>+ <p id="at-diff-hint" data-i18n="atomic.plan_hint">$THREE's mint is used in the example only as a clearly-synthetic placeholder account, not a live transfer.</p>+ </form>+ </section>++ <section class="at-state" id="at-diff-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.diff_loading_text">Compiling legacy, v0, and v1...</p>+ </section>+ <section class="at-state at-error" id="at-diff-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.plan_error_title">Could not plan that transaction</strong><p id="at-diff-error-message"></p><button type="button" id="at-diff-retry" data-i18n="atomic.retry_btn">Try again</button>+ </section>++ <section class="at-report" id="at-diff-report" hidden aria-live="polite">+ <table class="at-diff-table" id="at-diff-table">+ <thead><tr><th data-i18n="atomic.diff_th_metric">Metric</th><th data-i18n="atomic.diff_th_legacy">Legacy</th><th data-i18n="atomic.diff_th_v0">V0</th><th data-i18n="atomic.diff_th_v1">V1</th></tr></thead>+ <tbody>+ <tr><th data-i18n="atomic.diff_row_bytes">Total bytes</th><td id="at-diff-legacy-bytes"></td><td id="at-diff-v0-bytes"></td><td id="at-diff-v1-bytes"></td></tr>+ <tr><th data-i18n="atomic.diff_row_limit">Envelope ceiling</th><td id="at-diff-legacy-limit"></td><td id="at-diff-v0-limit"></td><td id="at-diff-v1-limit"></td></tr>+ <tr><th data-i18n="atomic.diff_row_headroom">Headroom</th><td id="at-diff-legacy-headroom"></td><td id="at-diff-v0-headroom"></td><td id="at-diff-v1-headroom"></td></tr>+ <tr><th data-i18n="atomic.diff_row_fits">Fits?</th><td id="at-diff-legacy-fits"></td><td id="at-diff-v0-fits"></td><td id="at-diff-v1-fits"></td></tr>+ </tbody>+ </table>+ <p class="at-ruler-note" id="at-diff-savings"></p>+ </section>++ <section class="at-empty" id="at-diff-empty">+ <article><span>01</span><h2 data-i18n="atomic.diff_feat1_title">Same payload, three compiles</h2><p data-i18n="atomic.diff_feat1_body">One instruction set, compiled once per version with the identical @solana/kit pipeline, so the only variable is the envelope itself.</p></article>+ <article><span>02</span><h2 data-i18n="atomic.diff_feat2_title">V1 is not always smaller</h2><p data-i18n="atomic.diff_feat2_body">A tiny transaction can come out larger on V1 once the config mask and its fixed-width values are counted. The diff shows that honestly instead of assuming V1 always wins.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.diff_feat3_title">Legacy wall, both rails</h2><p data-i18n="atomic.diff_feat3_body">Legacy and V0 share the same 1,232-byte ceiling. The diff flags the first version, if any, that needs V1's room to fit at all.</p></article></section></section>- <section class="at-empty" id="at-empty">- <article><span>01</span><h2 data-i18n="atomic.feat1_title">Reader safe</h2><p data-i18n="atomic.feat1_body">Atomic requests transaction version 1 explicitly, so V1 traffic cannot break or disappear from the read path.</p></article>- <article><span>02</span><h2 data-i18n="atomic.feat2_title">Sponsor aware</h2><p data-i18n-html="atomic.feat2_body">V1 caps live in <code>transactionConfig</code>. Atomic never pretends a Compute Budget instruction scan still binds them.</p></article>- <article><span>03</span><h2 data-i18n="atomic.feat3_title">Byte exact</h2><p data-i18n="atomic.feat3_body">The gauge measures signed wire bytes, not an estimate. Transactions above the old MTU wall become immediately visible.</p></article>+ <section class="at-panel" id="at-panel-wallet" role="tabpanel" aria-labelledby="at-nav-tab-wallet" hidden>+ <section class="at-inspector" aria-labelledby="at-wallet-title">+ <div class="at-panel-head">+ <div><p class="at-label" data-i18n="atomic.wallet_label">Before the wallet signs</p><h2 id="at-wallet-title" data-i18n="atomic.wallet_title">Wallet V1 capability check</h2></div>+ </div>+ <p class="at-panel-note" data-i18n="atomic.wallet_intro">Connects your injected Solana wallet (no linking, no signature request) and reads its real Wallet Standard feature set to see whether it honestly advertises V1 transaction signing.</p>+ <div class="at-input-row"><button type="button" id="at-wallet-check-btn" data-i18n="atomic.wallet_check_btn">Check my wallet</button></div>+ <p id="at-wallet-hint" data-i18n="atomic.wallet_hint">Reads wallet.features['solana:signTransaction'].supportedTransactionVersions. Never signs or sends anything.</p>+ </section>++ <section class="at-state" id="at-wallet-loading" hidden aria-live="polite">+ <span class="at-spinner" aria-hidden="true"></span><p data-i18n="atomic.wallet_loading_text">Asking your wallet what it supports...</p>+ </section>+ <section class="at-state at-error" id="at-wallet-error" hidden aria-live="assertive">+ <strong data-i18n="atomic.wallet_error_title">Could not check wallet capability</strong><p id="at-wallet-error-message"></p><button type="button" id="at-wallet-retry" data-i18n="atomic.retry_btn">Try again</button>+ </section>++ <section class="at-report" id="at-wallet-report" hidden aria-live="polite">+ <div class="at-verdict">+ <div><p class="at-label" data-i18n="atomic.wallet_report_label">Connected wallet</p><h2 id="at-wallet-name">Wallet</h2><p id="at-wallet-address"></p></div>+ <div class="at-verdict-badge" id="at-wallet-verdict-badge"></div>+ </div>+ <section class="at-card" aria-labelledby="at-wallet-versions-title">+ <p class="at-label" data-i18n="atomic.wallet_versions_label">Wallet Standard, verbatim</p><h3 id="at-wallet-versions-title" data-i18n="atomic.wallet_versions_title">Supported transaction versions</h3>+ <p class="at-ruler-note" id="at-wallet-verdict-copy"></p>+ <ul class="at-notes" id="at-wallet-versions"></ul>+ </section>+ </section>++ <section class="at-empty" id="at-wallet-empty">+ <article><span>01</span><h2 data-i18n="atomic.wallet_feat1_title">No wallet needed to try the lab</h2><p data-i18n="atomic.wallet_feat1_body">Only this tab needs a browser wallet. Every other tab works from a pasted signature or wire transaction.</p></article>+ <article><span>02</span><h2 data-i18n="atomic.wallet_feat2_title">The existing signer, reused</h2><p data-i18n="atomic.wallet_feat2_body">This check calls the same findV1WalletStandardSigner function three.ws uses before it ever asks a wallet for a real V1 signature.</p></article>+ <article><span>03</span><h2 data-i18n="atomic.wallet_feat3_title">Honest advertising only</h2><p data-i18n="atomic.wallet_feat3_body">A wallet that does not list version 1 in its signTransaction feature gets reported as unsupported, even if it can technically parse the bytes.</p></article>+ </section></section></main>diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 3e0e2dd57..549d9f984 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,11 +1,11 @@{- "generated_at": "2026-10-14T04:58:24.891Z",+ "generated_at": "2026-10-14T17:22:11.561Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 4086,+ "total": 4087,"complete": false,"full_feed": "/changelog.json","entries": [@@ -20,6 +20,16 @@"docs"]},+ {+ "date": "2026-10-14",+ "type": "update",+ "title": "Atomic is now a six-tab Transaction V1 lab, not just an inspector",+ "summary": "/atomic grew five tabs beyond the Inspector, each reachable by click, arrow-key/Home/End tab navigation, or a deep link (?tab=mask, ?tab=sponsor, ?tab=planner, ?tab=diff, ?tab=wallet). The config mask decoder reads a V1 transaction's real TransactionConfigMask u32 and its fixed-width ConfigValues byte by byte, flagging a half-set priority-fee pair or a reserved bit SIMD-0385 has not assigned yet. The sponsor cap view shows a paymaster exactly what it is agreeing to pay, reading V1's inline config instead of a Compute Budget instruction scan that sees nothing on a V1 transaction. The size and budget planner compiles a pasted instruction set with @solana/kit to an exact byte count against legacy, V0, or V1's ceiling, including an exact lamport total for a chosen priority fee. The legacy/V0/V1 diff compiles the same instructions three ways and reports the real byte deltas, honestly, including the case where V1's inline config makes it larger than legacy. The wallet V1 capability check connects the browser's injected wallet and reports the same verdict the rest of three.ws would get from findV1WalletStandardSigner before ever requesting a real V1 signature. Nothing here is estimated: every number comes from compiling and decoding real transactions, and nothing is ever signed, simulated, or broadcast.",+ "link": "/atomic",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-14","type": "update",@@ -1547,16 +1557,6 @@"tags": ["feature"]- },- {- "date": "2026-10-10",- "type": "update",- "title": "Calmer homepage first visit: one corner card at a time, full agent descriptions, language in the footer",- "summary": "A first visit used to stack three cards in the bottom-right corner over the hero avatar. The search-shortcut hint now goes first and the \"Have you tried\" suggestion waits until it is dismissed. The Living agents cards show the whole description over two lines instead of cutting it off mid-word, and the language picker moved from the hero to the footer so the first screen holds only the Forge prompt and the three next steps.",- "link": "/",- "tags": [- "improvement"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex 5e342b318..728cfa8fa 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-14T04:58:24.870Z",+ "generated_at": "2026-10-14T17:22:11.540Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -17,6 +17,16 @@"docs"]},+ {+ "date": "2026-10-14",+ "type": "update",+ "title": "Atomic is now a six-tab Transaction V1 lab, not just an inspector",+ "summary": "/atomic grew five tabs beyond the Inspector, each reachable by click, arrow-key/Home/End tab navigation, or a deep link (?tab=mask, ?tab=sponsor, ?tab=planner, ?tab=diff, ?tab=wallet). The config mask decoder reads a V1 transaction's real TransactionConfigMask u32 and its fixed-width ConfigValues byte by byte, flagging a half-set priority-fee pair or a reserved bit SIMD-0385 has not assigned yet. The sponsor cap view shows a paymaster exactly what it is agreeing to pay, reading V1's inline config instead of a Compute Budget instruction scan that sees nothing on a V1 transaction. The size and budget planner compiles a pasted instruction set with @solana/kit to an exact byte count against legacy, V0, or V1's ceiling, including an exact lamport total for a chosen priority fee. The legacy/V0/V1 diff compiles the same instructions three ways and reports the real byte deltas, honestly, including the case where V1's inline config makes it larger than legacy. The wallet V1 capability check connects the browser's injected wallet and reports the same verdict the rest of three.ws would get from findV1WalletStandardSigner before ever requesting a real V1 signature. Nothing here is estimated: every number comes from compiling and decoding real transactions, and nothing is ever signed, simulated, or broadcast.",+ "link": "/atomic",+ "tags": [+ "feature"+ ]+ },{"date": "2026-10-14","type": "update",@@ -4188,8 +4198,8 @@{"date": "2026-09-15","type": "launch",- "title": "Atomic - Solana V1 Inspector",- "summary": "A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.",+ "title": "Atomic - Solana V1 Transaction Lab",+ "summary": "A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.","link": "/atomic","tags": ["launch"diff --git a/public/changelog.xml b/public/changelog.xmlindex df1ae22a6..1ccbe5d04 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -14,6 +14,14 @@<category>infra</category><description>npm run mirrors:drift compares each of the ~105 standalone mirrors in data/standalone-mirrors.json against its monorepo source at the last synced commit (GitHub API, with a README-timestamp fallback when rate-limited), flags any package whose GitHub copy has diverged, and writes the result to tasks/mirror-drift-<date>.json. It never pushes or mutates a mirror; it is the audit step that found the two fixes above.</description></item>+ <item>+ <title>Atomic is now a six-tab Transaction V1 lab, not just an inspector</title>+ <link>https://three.ws/atomic</link>+ <guid isPermaLink="false">2026-10-14:Atomic is now a six-tab Transaction V1 lab, not just an inspector</guid>+ <pubDate>Wed, 14 Oct 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>/atomic grew five tabs beyond the Inspector, each reachable by click, arrow-key/Home/End tab navigation, or a deep link (?tab=mask, ?tab=sponsor, ?tab=planner, ?tab=diff, ?tab=wallet). The config mask decoder reads a V1 transaction's real TransactionConfigMask u32 and its fixed-width ConfigValues byte by byte, flagging a half-set priority-fee pair or a reserved bit SIMD-0385 has not assigned yet. The sponsor cap view shows a paymaster exactly what it is agreeing to pay, reading V1's inline config instead of a Compute Budget instruction scan that sees nothing on a V1 transaction. The size and budget planner compiles a pasted instruction set with @solana/kit to an exact byte count against legacy, V0, or V1's ceiling, including an exact lamport total for a chosen priority fee. The legacy/V0/V1 diff compiles the same instructions three ways and reports the real byte deltas, honestly, including the case where V1's inline config makes it larger than legacy. The wallet V1 capability check connects the browser's injected wallet and reports the same verdict the rest of three.ws would get from findV1WalletStandardSigner before ever requesting a real V1 signature. Nothing here is estimated: every number comes from compiling and decoding real transactions, and nothing is ever signed, simulated, or broadcast.</description>+ </item><item><title>Atomic now replays a pump.fun transaction step by step</title><link>https://three.ws/changelog</link>@@ -3239,12 +3247,12 @@<description>The pump.fun launch, swap and fee skills that agents use on three.ws now run on version 2 of the pump.fun SDK. Launching a coin can now turn on holder rewards, which sends every creator fee to the coin's holders instead of the launcher, permanently. Cashback launches were retired by pump.fun, so the skill now refuses them up front with a clear message instead of handing back a transaction that would fail after you sign it. The fee skill also recognizes holder-reward coins and explains where their fees go rather than trying to collect them.</description></item><item>- <title>Atomic - Solana V1 Inspector</title>+ <title>Atomic - Solana V1 Transaction Lab</title><link>https://three.ws/atomic</link>- <guid isPermaLink="false">2026-09-15:Atomic - Solana V1 Inspector</guid>+ <guid isPermaLink="false">2026-09-15:Atomic - Solana V1 Transaction Lab</guid><pubDate>Tue, 15 Sep 2026 12:00:00 GMT</pubDate><category>launch</category>- <description>A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.</description>+ <description>A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.</description></item><item><title>Contributors</title>diff --git a/public/features.json b/public/features.jsonindex 5b4bd3c27..24d8fdd44 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-10-14T04:58:24.857Z",+ "generated_at": "2026-10-14T17:22:11.527Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -2857,8 +2857,8 @@},{"path": "/atomic",- "title": "Atomic - Solana V1 Inspector",- "description": "A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.",+ "title": "Atomic - Solana V1 Transaction Lab",+ "description": "A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.","added": "2026-09-15","auth": null,"indexable": true,diff --git a/public/llms-full.txt b/public/llms-full.txtindex 2684bf3eb..6371b5add 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -1427,11 +1427,11 @@ URL: https://three.ws/portfolioA live portfolio view for any Solana or Ethereum wallet: total value, 24h move with honest coverage, stablecoin/major/token breakdown, top-asset allocation, and every holding priced in real time. Free, keyless, deep-linkable, no account.-### Atomic - Solana V1 Inspector+### Atomic - Solana V1 Transaction LabURL: https://three.ws/atomic-A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.+A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.### Onchain Viewerdiff --git a/public/locales/en.json b/public/locales/en.jsonindex 1dc12fff6..c8fdb1050 100644--- a/public/locales/en.json+++ b/public/locales/en.json@@ -1823,6 +1823,25 @@"compute_not_onchain": "Not on-chain","config_label": "Resource envelope","config_title": "Transaction config",+ "diff_feat1_body": "One instruction set, compiled once per version with the identical @solana/kit pipeline, so the only variable is the envelope itself.",+ "diff_feat1_title": "Same payload, three compiles",+ "diff_feat2_body": "A tiny transaction can come out larger on V1 once the config mask and its fixed-width values are counted. The diff shows that honestly instead of assuming V1 always wins.",+ "diff_feat2_title": "V1 is not always smaller",+ "diff_feat3_body": "Legacy and V0 share the same 1,232-byte ceiling. The diff flags the first version, if any, that needs V1's room to fit at all.",+ "diff_feat3_title": "Legacy wall, both rails",+ "diff_intro": "Compiles the same instruction set three ways and reports the byte-exact total for each, side by side.",+ "diff_label": "Same instructions, three envelopes",+ "diff_loading_text": "Compiling legacy, v0, and v1...",+ "diff_row_bytes": "Total bytes",+ "diff_row_fits": "Fits?",+ "diff_row_headroom": "Headroom",+ "diff_row_limit": "Envelope ceiling",+ "diff_submit_btn": "Diff all three versions",+ "diff_th_legacy": "Legacy",+ "diff_th_metric": "Metric",+ "diff_th_v0": "V0",+ "diff_th_v1": "V1",+ "diff_title": "Legacy vs V0 vs V1","error_title": "Could not inspect that transaction","explorer_link": "Open in Solscan","eyebrow": "Solana Transaction V1",@@ -1844,19 +1863,98 @@"live_rpc": "Live RPC","live_status": "Checking mainnet","loading_text": "Decoding the exact wire transaction...",+ "mask_bits_label": "u32, little-endian",+ "mask_bits_title": "Mask bits",+ "mask_feat1_body": "Priority fee (bits 0-1, 8 bytes), compute unit limit (bit 2, 4 bytes), loaded accounts data size (bit 3, 4 bytes), and requested heap size (bit 4, 4 bytes).",+ "mask_feat1_title": "4 known fields",+ "mask_feat2_body": "The priority fee bits must both be set or both cleared. Atomic flags a mask where only one is set as a partial, invalid encoding.",+ "mask_feat2_title": "Sanitization aware",+ "mask_feat3_body": "Bits 5-31 are reserved. Atomic calls out any transaction that sets one, since a future SIMD may assign it a meaning this decoder does not yet know.",+ "mask_feat3_title": "Reserved bits",+ "mask_intro": "Every V1 transaction carries a 4-byte TransactionConfigMask right after the version byte and legacy header. Atomic reads those exact bits and the fixed-width values that follow, SIMD-0385, not an estimate.",+ "mask_label": "Bit layout",+ "mask_loading_text": "Reading the config mask bits...",+ "mask_not_v1": "Legacy and V0 carry resource limits as Compute Budget instructions, not a config mask. There is no mask to decode on this transaction.",+ "mask_reserved_badge": "Reserved bits set",+ "mask_submit_btn": "Decode mask",+ "mask_th_bits": "Bit(s)",+ "mask_th_field": "Field",+ "mask_th_present": "Present",+ "mask_th_raw": "Raw bytes",+ "mask_th_value": "Value",+ "mask_th_width": "Width",+ "mask_title": "Decode the config mask","meta_desc": "Inspect any Solana transaction or unsigned handoff before you co-sign it. See exact wire size, V1 transactionConfig limits, compute use, and sponsor safety.","metric_accounts": "Inline accounts","metric_compute": "Compute used","metric_instructions": "Instructions","metric_signatures": "Signatures",+ "nav_diff": "Version diff",+ "nav_inspector": "Inspector",+ "nav_mask": "Config mask",+ "nav_planner": "Planner",+ "nav_sponsor": "Sponsor caps",+ "nav_tabs_aria": "Atomic lab tools",+ "nav_wallet": "Wallet check","og_desc": "A live V1 observatory and pre-sign safety microscope for Solana's new 4,096-byte transactions.","og_title": "Atomic · Solana V1 Transaction Inspector","page_title": "Atomic · Solana V1 Transaction Inspector · three.ws",+ "plan_budget_label": "Resolved resource budget",+ "plan_cu_label": "Compute unit limit",+ "plan_data_headroom": "Data size headroom",+ "plan_data_label": "Loaded accounts data size (bytes)",+ "plan_error_title": "Could not plan that transaction",+ "plan_example_btn": "Load example instruction",+ "plan_feat1_body": "Every byte count comes from compiling your instructions with @solana/kit and encoding the result, the same path a real sender would take.",+ "plan_feat1_title": "Exact, not estimated",+ "plan_feat2_body": "Plan against the 1,232-byte legacy/v0 wall or the 4,096-byte V1 envelope, with the exact headroom or overage reported either way.",+ "plan_feat2_title": "Ceilings both ways",+ "plan_feat3_body": "Set a µlamports-per-CU price and a compute unit limit; the planner multiplies them into the exact total lamports a V1 sender would commit to.",+ "plan_feat3_title": "Priority fee, computed",+ "plan_feepayer_label": "Fee payer address",+ "plan_feepayer_placeholder": "Base58 Solana address",+ "plan_heap_label": "Requested heap size (bytes)",+ "plan_hint": "$THREE's mint is used in the example only as a clearly-synthetic placeholder account, not a live transfer.",+ "plan_instructions_label": "Instructions (JSON array)",+ "plan_instructions_placeholder": "[{\"programId\":\"...\",\"keys\":[{\"pubkey\":\"...\",\"isSigner\":true,\"isWritable\":true}],\"data\":\"base64...\"}]",+ "plan_intro": "Compiles your instruction set with the same @solana/kit encoder three.ws ships to real callers and reports the exact wire size. Nothing here is signed, simulated, or broadcast.",+ "plan_label": "Before you build",+ "plan_loading_text": "Compiling the exact wire transaction...",+ "plan_metric_message": "Message bytes",+ "plan_metric_signers": "Required signers",+ "plan_priority_label": "Priority fee (µlamports / CU)",+ "plan_submit_btn": "Plan size and budget",+ "plan_title": "Size and budget planner",+ "plan_version_label": "Transaction version",+ "plan_version_legacy": "Legacy (1,232 bytes)",+ "plan_version_v0": "V0 (1,232 bytes)",+ "plan_version_v1": "V1 (4,096 bytes)",+ "replay_empty": "No pump.fun events in this transaction. Atomic decodes create, trade, graduation, fee-collection, fee-distribution, and GitHub social-fee-claim events from Pump, PumpSwap, and PumpFees. This transaction did not invoke any of them.",+ "replay_label": "Pump.fun lifecycle",+ "replay_loadmore": "Load earlier trades",+ "replay_retry": "Retry replay",+ "replay_title": "Replay",+ "replay_view_launch": "View launch →","retry_btn": "Try again","share_btn": "Copy inspection link","size_label": "Wire envelope",+ "sponsor_caps_label": "What this sponsor is agreeing to",+ "sponsor_caps_title": "Fee and resource caps",+ "sponsor_dup_label": "V1 sanitization rule",+ "sponsor_dup_title": "Duplicate static accounts",+ "sponsor_feat1_body": "On V1, a Compute Budget instruction scan sees nothing. The real caps live in transactionConfig, and this view reads them from there.",+ "sponsor_feat1_title": "Caps, not hopes",+ "sponsor_feat2_body": "SIMD-0385 makes a duplicate static account a sanitization failure. This view decodes the wire account list and flags one if present.",+ "sponsor_feat2_title": "Duplicate check",+ "sponsor_feat3_body": "An unset V1 compute or data limit resolves to zero, not a legacy default. A sponsor relying on the old default would be wrong to assume otherwise.",+ "sponsor_feat3_title": "Zero means zero","sponsor_label": "Co-signing lens",+ "sponsor_loading_text": "Reading the resource caps this sponsor would agree to...",+ "sponsor_submit_btn": "Check sponsor caps","sponsor_title": "Sponsor assessment",+ "sponsor_view_intro": "A paymaster or co-signer reads this before it agrees to pay. It shows the exact fee and resource caps the transaction commits to, and whether its static account list holds a duplicate the v1 sanitizer would reject.",+ "sponsor_view_label": "Before you co-sign",+ "sponsor_view_title": "Sponsor cap view","stat_bytes": "bytes per V1 transaction","stat_legacy_room": "the legacy payload room","stat_wire_zero": "visible at wire byte zero",@@ -1867,7 +1965,23 @@"tw_desc": "A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.","tw_title": "Atomic - Solana V1 Inspector · three.ws","verdict_badge": "Caps explicit",- "verdict_label": "Decoded format"+ "verdict_label": "Decoded format",+ "wallet_check_btn": "Check my wallet",+ "wallet_error_title": "Could not check wallet capability",+ "wallet_feat1_body": "Only this tab needs a browser wallet. Every other tab works from a pasted signature or wire transaction.",+ "wallet_feat1_title": "No wallet needed to try the lab",+ "wallet_feat2_body": "This check calls the same findV1WalletStandardSigner function three.ws uses before it ever asks a wallet for a real V1 signature.",+ "wallet_feat2_title": "The existing signer, reused",+ "wallet_feat3_body": "A wallet that does not list version 1 in its signTransaction feature gets reported as unsupported, even if it can technically parse the bytes.",+ "wallet_feat3_title": "Honest advertising only",+ "wallet_hint": "Reads wallet.features['solana:signTransaction'].supportedTransactionVersions. Never signs or sends anything.",+ "wallet_intro": "Connects your injected Solana wallet (no linking, no signature request) and reads its real Wallet Standard feature set to see whether it honestly advertises V1 transaction signing.",+ "wallet_label": "Before the wallet signs",+ "wallet_loading_text": "Asking your wallet what it supports...",+ "wallet_report_label": "Connected wallet",+ "wallet_title": "Wallet V1 capability check",+ "wallet_versions_label": "Wallet Standard, verbatim",+ "wallet_versions_title": "Supported transaction versions"},"autopilot": {"autopilot": "Autopilot",diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex a7e4c8b77..f5be9ba7d 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -1828,9 +1828,9 @@</li><li><a href="/atomic">- <span class="sm-title"><span data-i18n="sitemap_index.t_atomic">Atomic - Solana V1 Inspector</span></span>+ <span class="sm-title"><span data-i18n="sitemap_index.t_atomic">Atomic - Solana V1 Transaction Lab</span></span><span class="sm-path" translate="no">/atomic</span>- <span class="sm-desc" data-i18n="sitemap_index.d_atomic">A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.</span>+ <span class="sm-desc" data-i18n="sitemap_index.d_atomic">A real Solana Transaction V1 lab: inspect a transaction, plan an exact byte budget, decode the raw config mask, diff legacy/v0/v1, check sponsor caps, and test wallet v1 support before you co-sign.</span></a></li><li>diff --git a/src/atomic.css b/src/atomic.cssindex de46ef1a3..cfd864857 100644--- a/src/atomic.css+++ b/src/atomic.css@@ -84,3 +84,41 @@ body { margin: 0; background: var(--at-bg); color: var(--at-text); }[data-theme="light"] body { --at-bg: #f2f7f4; --at-panel: rgba(255,255,255,.86); --at-line: rgba(14,61,39,.15); --at-green: #087d45; --at-mint: #135d3b; --at-amber: #9b5a00; --at-text: #071a11; --at-muted: #546d60; }[data-theme="light"] .at-shell { background: radial-gradient(circle at 76% 5%, rgba(55,190,120,.13), transparent 31rem), var(--at-bg); }[data-theme="light"] .at-metrics div { background: #f7fbf8; }++.at-nav-tabs { display: flex; flex-wrap: wrap; gap: .4rem; width: min(1160px, 100%); margin: 0 auto 1.4rem; padding: .35rem; border: 1px solid var(--at-line); border-radius: 16px; background: rgba(0,0,0,.2); }+.at-nav-tabs button { min-height: 44px; padding: .6rem 1rem; border: 0; border-radius: 11px; color: var(--at-muted); background: transparent; cursor: pointer; font: 600 .84rem/1 inherit; white-space: nowrap; }+.at-nav-tabs button[aria-selected="true"] { color: #062014; background: var(--at-green); }+.at-nav-tabs button:not([aria-selected="true"]):hover { color: var(--at-text); background: rgba(101,245,170,.08); }+.at-nav-tabs button:focus-visible, .at-tabs button:focus-visible { outline: 2px solid var(--at-green); outline-offset: 2px; }+.at-panel { display: grid; gap: 1rem; }+.at-panel-note { max-width: 760px; margin: 1.1rem 0 0; color: var(--at-muted); line-height: 1.6; font-size: .88rem; }+.at-panel-note code { color: var(--at-mint); }++.at-plan-form { margin-top: 1.4rem; display: grid; gap: 1.1rem; }+.at-plan-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 1rem; }+.at-field { display: grid; gap: .5rem; }+.at-field label { color: var(--at-mint); font-size: .82rem; }+.at-field input, .at-field select, .at-field textarea { width: 100%; box-sizing: border-box; padding: .8rem 1rem; border: 1px solid var(--at-line); border-radius: 12px; background: rgba(0,0,0,.24); color: var(--at-text); font: .84rem/1.45 monospace; outline: none; }+.at-field textarea { resize: vertical; }+.at-field input:focus, .at-field select:focus, .at-field textarea:focus { border-color: var(--at-green); box-shadow: 0 0 0 3px rgba(101,245,170,.12); }+.at-plan-form .at-input-row { grid-template-columns: auto 1fr; }+.at-plan-form .at-input-row button[type="button"] { background: transparent; color: var(--at-green); }+.at-plan-form .at-input-row button[type="button"]:hover { color: var(--at-mint); border-color: var(--at-mint); background: rgba(101,245,170,.08); }+.at-plan-form > p { margin: 0; color: var(--at-muted); font-size: .76rem; }++.at-mask-binary { margin: 1rem 0 .4rem; color: var(--at-mint); font: 700 1rem/1.4 monospace; letter-spacing: .08em; word-break: break-all; }+.at-mask-table, .at-diff-table { width: 100%; margin-top: .5rem; border-collapse: collapse; overflow: hidden; border: 1px solid var(--at-line); border-radius: 16px; }+.at-mask-table th, .at-mask-table td, .at-diff-table th, .at-diff-table td { padding: .85rem 1rem; border-top: 1px solid var(--at-line); text-align: left; font-size: .84rem; }+.at-mask-table thead th, .at-diff-table thead th { border-top: 0; color: var(--at-muted); font-size: .72rem; text-transform: uppercase; letter-spacing: .06em; }+.at-mask-table tbody td, .at-diff-table td, .at-diff-table tbody th { font-family: monospace; }+.at-mask-table tr.at-field-present td { color: var(--at-green); }+.at-mask-table tr.at-field-missing td { color: var(--at-muted); }+.at-mask-table tr.at-field-invalid { outline: 1px solid rgba(255,198,109,.5); }+.at-diff-table td.at-fits-no { color: var(--at-amber); font-weight: 700; }++@media (max-width: 760px) {+ .at-nav-tabs { width: 100%; overflow-x: auto; flex-wrap: nowrap; }+ .at-plan-grid { grid-template-columns: 1fr; }+ .at-plan-form .at-input-row { grid-template-columns: 1fr; }+ .at-mask-table, .at-diff-table { display: block; overflow-x: auto; white-space: nowrap; }+}diff --git a/src/atomic.js b/src/atomic.jsindex 51ecebafe..370cf9a57 100644--- a/src/atomic.js+++ b/src/atomic.js@@ -1,3 +1,7 @@+import { getWallets } from '@wallet-standard/app';+import { injectedProvider } from './launch/launch-wallet.js';+import { findV1WalletStandardSigner } from './onchain/adapters/solana.js';+const $ = (id) => document.getElementById(id);const state = { mode: 'signature', lastInspection: null, replayNextBefore: null };@@ -208,10 +212,23 @@ function setMode(mode) {async function responseJson(response) {const data = await response.json().catch(() => ({}));- if (!response.ok) throw new Error(data.message || data.error || `Request failed with HTTP ${response.status}`);+ if (!response.ok) throw new Error(data.message || data.error_description || data.error || `Request failed with HTTP ${response.status}`);return data;}+/** Fetches an /api/solana/atomic inspection for a signature or base64 wire value, shared by the Inspector, Mask, and Sponsor tabs. */+async function fetchInspectionFor(mode, value) {+ const request = mode === 'wire'+ ? fetch('/api/solana/atomic', {+ method: 'POST',+ headers: { 'content-type': 'application/json', accept: 'application/json' },+ body: JSON.stringify({ transaction: value }),+ })+ : fetch(`/api/solana/atomic?signature=${encodeURIComponent(value)}`, { headers: { accept: 'application/json' } });+ const { inspection } = await request.then(responseJson);+ return inspection;+}+async function loadStatus() {try {const { status } = await fetch('/api/solana/atomic', { headers: { accept: 'application/json' } }).then(responseJson);@@ -295,14 +312,7 @@ async function inspect() {show('loading');$('at-submit').disabled = true;try {- const request = state.mode === 'wire'- ? fetch('/api/solana/atomic', {- method: 'POST',- headers: { 'content-type': 'application/json', accept: 'application/json' },- body: JSON.stringify({ transaction: value }),- })- : fetch(`/api/solana/atomic?signature=${encodeURIComponent(value)}`, { headers: { accept: 'application/json' } });- const { inspection } = await request.then(responseJson);+ const inspection = await fetchInspectionFor(state.mode, value);render(inspection);if (state.mode === 'signature') {const url = new URL(location.href);@@ -374,7 +384,499 @@ $('at-replay-retry').addEventListener('click', async () => {}});+// ---------------------------------------------------------------------------+// Top-level lab tabs: Inspector, Config mask, Sponsor caps, Planner, Diff,+// Wallet check. Deep-linked via ?tab=<key> and reachable by arrow-key/Home/End+// on the tablist, per the ARIA tabs pattern.+// ---------------------------------------------------------------------------++const TAB_KEYS = ['inspector', 'mask', 'sponsor', 'planner', 'diff', 'wallet'];++function switchTab(tab) {+ if (!TAB_KEYS.includes(tab)) return;+ for (const key of TAB_KEYS) {+ const active = key === tab;+ $(`at-nav-tab-${key}`).setAttribute('aria-selected', String(active));+ $(`at-nav-tab-${key}`).tabIndex = active ? 0 : -1;+ $(`at-panel-${key}`).hidden = !active;+ }+ const url = new URL(location.href);+ url.searchParams.set('tab', tab);+ history.replaceState(null, '', url);+}++const navTabButtons = TAB_KEYS.map((key) => $(`at-nav-tab-${key}`));+for (const button of navTabButtons) button.addEventListener('click', () => switchTab(button.dataset.tab));+$('at-nav-tabs').addEventListener('keydown', (event) => {+ const currentIndex = navTabButtons.findIndex((button) => button.getAttribute('aria-selected') === 'true');+ let nextIndex = null;+ if (event.key === 'ArrowRight') nextIndex = (currentIndex + 1) % navTabButtons.length;+ else if (event.key === 'ArrowLeft') nextIndex = (currentIndex - 1 + navTabButtons.length) % navTabButtons.length;+ else if (event.key === 'Home') nextIndex = 0;+ else if (event.key === 'End') nextIndex = navTabButtons.length - 1;+ if (nextIndex == null) return;+ event.preventDefault();+ switchTab(navTabButtons[nextIndex].dataset.tab);+ navTabButtons[nextIndex].focus();+});++// ---------------------------------------------------------------------------+// Config mask decoder tab+// ---------------------------------------------------------------------------++const maskState = { mode: 'signature' };++function showMask(name) {+ for (const key of ['loading', 'error', 'report', 'empty']) $(`at-mask-${key}`).hidden = key !== name;+}++function setMaskMode(mode) {+ maskState.mode = mode;+ for (const tab of document.querySelectorAll('[data-mask-mode]')) tab.setAttribute('aria-selected', String(tab.dataset.maskMode === mode));+ const wire = mode === 'wire';+ $('at-mask-input-label').textContent = wire ? 'Signed or partially signed transaction bytes' : 'Solana mainnet transaction signature';+ $('at-mask-input').placeholder = wire ? 'Paste a base64-encoded wire transaction' : 'Paste a transaction signature';+ $('at-mask-input').rows = wire ? 6 : 2;+}++function bitsLabel(bits) {+ return bits.length > 1 ? `bits ${bits[0]}-${bits[bits.length - 1]}` : `bit ${bits[0]}`;+}++function renderMask(inspection) {+ $('at-mask-version').textContent = inspection.versionLabel;+ const mask = inspection.configMask;+ $('at-mask-not-v1').hidden = Boolean(mask);+ $('at-mask-bits-card').hidden = !mask;+ $('at-mask-table').hidden = !mask;+ $('at-mask-offsets').hidden = !mask;+ if (!mask) {+ $('at-mask-reserved-badge').hidden = true;+ showMask('report');+ return;+ }++ $('at-mask-hex').textContent = mask.maskHex;+ $('at-mask-binary').textContent = mask.maskBinary;+ $('at-mask-popcount').textContent = `${mask.popcount} of 5 known bits set.`;++ const reservedBadge = $('at-mask-reserved-badge');+ reservedBadge.hidden = !mask.reservedBitsSet;+ if (mask.reservedBitsSet) reservedBadge.textContent = `Reserved bits set (${mask.reservedBitsHex})`;++ $('at-mask-fields').replaceChildren(...mask.fields.map((field) => {+ const tr = document.createElement('tr');+ tr.className = field.invalidPartial ? 'at-field-invalid' : field.present ? 'at-field-present' : 'at-field-missing';+ const cells = [+ field.label,+ bitsLabel(field.bits),+ field.invalidPartial ? 'Partial (invalid)' : field.present ? 'Yes' : 'No',+ `${field.byteWidth} bytes`,+ field.rawHex || '-',+ field.value == null ? '<unset>' : formatNumber(field.value),+ ];+ tr.append(...cells.map((text) => {+ const td = document.createElement('td');+ td.textContent = text;+ return td;+ }));+ return tr;+ }));++ $('at-mask-offsets').textContent =+ `Config values occupy bytes ${mask.configValuesByteOffset}-${mask.configValuesByteOffset + mask.configValuesByteLength - 1} ` ++ `of the message (${mask.numInstructions} instruction(s), ${mask.numAddresses} inline address(es)).`;+ showMask('report');+}++for (const tab of document.querySelectorAll('[data-mask-mode]')) tab.addEventListener('click', () => setMaskMode(tab.dataset.maskMode));+$('at-mask-form').addEventListener('submit', async (event) => {+ event.preventDefault();+ const value = $('at-mask-input').value.trim();+ if (!value) {+ $('at-mask-error-message').textContent = maskState.mode === 'wire' ? 'Paste base64 wire bytes first.' : 'Paste a Solana transaction signature first.';+ showMask('error');+ return;+ }+ showMask('loading');+ $('at-mask-submit').disabled = true;+ try {+ renderMask(await fetchInspectionFor(maskState.mode, value));+ } catch (err) {+ $('at-mask-error-message').textContent = err.message;+ showMask('error');+ } finally {+ $('at-mask-submit').disabled = false;+ }+});+$('at-mask-retry').addEventListener('click', () => $('at-mask-form').requestSubmit());++// ---------------------------------------------------------------------------+// Sponsor cap view tab+// ---------------------------------------------------------------------------++const sponsorViewState = { mode: 'signature' };++function showSponsor(name) {+ for (const key of ['loading', 'error', 'report', 'empty']) $(`at-sponsor-${key}`).hidden = key !== name;+}++function setSponsorMode(mode) {+ sponsorViewState.mode = mode;+ for (const tab of document.querySelectorAll('[data-sponsor-mode]')) tab.setAttribute('aria-selected', String(tab.dataset.sponsorMode === mode));+ const wire = mode === 'wire';+ $('at-sponsor-input-label').textContent = wire ? 'Signed or partially signed transaction bytes' : 'Solana mainnet transaction signature';+ $('at-sponsor-input').placeholder = wire ? 'Paste a base64-encoded wire transaction' : 'Paste a transaction signature';+ $('at-sponsor-input').rows = wire ? 6 : 2;+}++function renderSponsorView(inspection) {+ $('at-sponsor-version').textContent = inspection.versionLabel;+ const budget = inspection.budget;+ $('at-sponsor-priority').textContent = budgetValue(budget.priorityFeeLamports, 'lamports total', budget.explicit.priorityFee);+ $('at-sponsor-cu').textContent = budgetValue(budget.computeUnitLimit, 'CU', budget.explicit.computeUnitLimit);+ $('at-sponsor-data').textContent = budgetValue(budget.loadedAccountsDataSizeLimit, 'bytes', budget.explicit.loadedAccountsDataSizeLimit);+ $('at-sponsor-heap').textContent = budgetValue(budget.heapSize, 'bytes', budget.explicit.heapSize);++ const badge = $('at-sponsor-verdict-badge');+ badge.className = 'at-verdict-badge';+ if (inspection.version === 1 && inspection.sponsor.safeToCosign) {+ badge.textContent = 'Caps explicit';+ badge.classList.add('is-safe');+ $('at-sponsor-verdict-copy').textContent = 'The 0x81 envelope is V1 and both execution limits are explicit in transactionConfig.';+ } else if (inspection.version === 1) {+ badge.textContent = 'Limits missing';+ badge.classList.add('is-warn');+ $('at-sponsor-verdict-copy').textContent = 'This is V1, but at least one required execution limit resolves to zero.';+ } else {+ badge.textContent = 'Legacy budget rules';+ $('at-sponsor-verdict-copy').textContent = `${inspection.versionLabel} keeps the 1,232-byte ceiling and instruction-based compute budget.`;+ }++ const dup = inspection.duplicateAccounts || [];+ $('at-sponsor-dup-summary').textContent = dup.length+ ? `${dup.length} duplicate static account(s) found. This transaction would FAIL v1 sanitization.`+ : 'No duplicate static accounts. This transaction would pass the v1 sanitization check.';+ $('at-sponsor-dup-list').replaceChildren(...dup.map((address) => {+ const li = document.createElement('li');+ li.textContent = address;+ return li;+ }));++ $('at-sponsor-view-notes').replaceChildren(...inspection.sponsor.notes.map((note) => {+ const li = document.createElement('li');+ li.textContent = note;+ return li;+ }));+ showSponsor('report');+}++for (const tab of document.querySelectorAll('[data-sponsor-mode]')) tab.addEventListener('click', () => setSponsorMode(tab.dataset.sponsorMode));+$('at-sponsor-form').addEventListener('submit', async (event) => {+ event.preventDefault();+ const value = $('at-sponsor-input').value.trim();+ if (!value) {+ $('at-sponsor-error-message').textContent = sponsorViewState.mode === 'wire' ? 'Paste base64 wire bytes first.' : 'Paste a Solana transaction signature first.';+ showSponsor('error');+ return;+ }+ showSponsor('loading');+ $('at-sponsor-submit').disabled = true;+ try {+ renderSponsorView(await fetchInspectionFor(sponsorViewState.mode, value));+ } catch (err) {+ $('at-sponsor-error-message').textContent = err.message;+ showSponsor('error');+ } finally {+ $('at-sponsor-submit').disabled = false;+ }+});+$('at-sponsor-retry').addEventListener('click', () => $('at-sponsor-form').requestSubmit());++// ---------------------------------------------------------------------------+// Planner and Diff tabs: compile a pasted instruction set with the same+// @solana/kit path the rest of three.ws uses, through /api/solana/atomic-plan.+// ---------------------------------------------------------------------------++const EXAMPLE_FEEPAYER = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';+const EXAMPLE_INSTRUCTIONS = JSON.stringify(+ [+ {+ programId: '11111111111111111111111111111111',+ keys: [+ { pubkey: EXAMPLE_FEEPAYER, isSigner: true, isWritable: true },+ { pubkey: 'So11111111111111111111111111111111111111112', isSigner: false, isWritable: true },+ ],+ data: 'AgAAAIgTAAAAAAAA',+ },+ ],+ null,+ 2,+);++function loadExample(prefix) {+ $(`at-${prefix}-feepayer`).value = EXAMPLE_FEEPAYER;+ $(`at-${prefix}-instructions`).value = EXAMPLE_INSTRUCTIONS;+ $(`at-${prefix}-cu`).value = '200000';+ $(`at-${prefix}-data-size`).value = '4096';+ $(`at-${prefix}-priority`).value = '10';+}++function parseInstructionsJson(raw) {+ let parsed;+ try {+ parsed = JSON.parse(raw);+ } catch (err) {+ throw new Error(`Instructions must be valid JSON: ${err.message}`);+ }+ if (!Array.isArray(parsed) || parsed.length === 0) throw new Error('Instructions must be a non-empty JSON array.');+ return parsed;+}++function budgetConfigFrom(prefix) {+ const cu = $(`at-${prefix}-cu`).value.trim();+ const dataSize = $(`at-${prefix}-data-size`).value.trim();+ const heap = $(`at-${prefix}-heap`).value.trim();+ const priority = $(`at-${prefix}-priority`).value.trim();+ const config = {};+ if (cu !== '') config.computeUnitLimit = Number(cu);+ if (dataSize !== '') config.loadedAccountsDataSizeLimit = Number(dataSize);+ if (heap !== '') config.heapSize = Number(heap);+ if (priority !== '') config.priorityFeeMicroLamportsPerCu = Number(priority);+ return config;+}++function duplicateAccountsSummary(duplicateAccounts) {+ const dup = duplicateAccounts || [];+ return dup.length+ ? `${dup.length} duplicate static account(s) found. This transaction would FAIL v1 sanitization.`+ : 'No duplicate static accounts. This transaction would pass the v1 sanitization check.';+}++function duplicateAccountsList(duplicateAccounts) {+ return (duplicateAccounts || []).map((address) => {+ const li = document.createElement('li');+ li.textContent = address;+ return li;+ });+}++function showPlan(name) {+ for (const key of ['loading', 'error', 'report', 'empty']) $(`at-plan-${key}`).hidden = key !== name;+}++function renderPlan(plan) {+ $('at-plan-version-label').textContent = plan.versionLabel;+ $('at-plan-bytes').textContent = formatNumber(plan.bytes);+ $('at-plan-headroom').textContent = plan.overLimitBy > 0 ? `${formatNumber(plan.overLimitBy)} bytes over` : `${formatNumber(plan.headroomBytes)} bytes free`;+ const utilizationPct = Math.round((plan.bytes / plan.limitBytes) * 1_000) / 10;+ $('at-plan-size-fill').style.width = `${Math.min(100, utilizationPct)}%`;+ $('at-plan-size-note').textContent = plan.overLimitBy > 0+ ? `This plan is ${formatNumber(plan.overLimitBy)} bytes beyond the ${formatNumber(plan.limitBytes)}-byte ${plan.versionLabel} envelope. It would not fit.`+ : `${utilizationPct}% of the ${formatNumber(plan.limitBytes)}-byte ${plan.versionLabel} envelope is in use.`;++ $('at-plan-accounts').textContent = formatNumber(plan.staticAccountCount);+ $('at-plan-instructions-count').textContent = formatNumber(plan.instructionCount);+ $('at-plan-signers').textContent = formatNumber(plan.signerCount);+ $('at-plan-message-bytes').textContent = formatNumber(plan.messageBytes);++ const rb = plan.resourceBudget;+ $('at-plan-cu-out').textContent = `${formatNumber(rb.computeUnitLimit)} CU`;+ $('at-plan-data-out').textContent = `${formatNumber(rb.loadedAccountsDataSizeLimit)} bytes`;+ $('at-plan-data-headroom').textContent = `${formatNumber(rb.loadedAccountsHeadroomBytes)} bytes`;+ $('at-plan-priority-out').textContent = `${formatNumber(rb.priorityFeeLamports)} lamports total`;++ $('at-plan-dup-summary').textContent = duplicateAccountsSummary(plan.duplicateAccounts);+ $('at-plan-dup-list').replaceChildren(...duplicateAccountsList(plan.duplicateAccounts));+ showPlan('report');+}++$('at-plan-example').addEventListener('click', () => loadExample('plan'));+$('at-plan-form').addEventListener('submit', async (event) => {+ event.preventDefault();+ showPlan('loading');+ $('at-plan-submit').disabled = true;+ try {+ const feePayer = $('at-plan-feepayer').value.trim();+ if (!feePayer) throw new Error('Fee payer address is required.');+ const instructions = parseInstructionsJson($('at-plan-instructions').value.trim() || '[]');+ const versionField = $('at-plan-version').value;+ const version = versionField === 'legacy' ? 'legacy' : Number(versionField);+ const budgetConfig = budgetConfigFrom('plan');+ const { plan } = await fetch('/api/solana/atomic-plan', {+ method: 'POST',+ headers: { 'content-type': 'application/json', accept: 'application/json' },+ body: JSON.stringify({ feePayer, version, budgetConfig, instructions }),+ }).then(responseJson);+ renderPlan(plan);+ } catch (err) {+ $('at-plan-error-message').textContent = err.message;+ showPlan('error');+ } finally {+ $('at-plan-submit').disabled = false;+ }+});+$('at-plan-retry').addEventListener('click', () => $('at-plan-form').requestSubmit());++function showDiff(name) {+ for (const key of ['loading', 'error', 'report', 'empty']) $(`at-diff-${key}`).hidden = key !== name;+}++function renderDiff(diff) {+ for (const key of ['legacy', 'v0', 'v1']) {+ const part = diff[key];+ $(`at-diff-${key}-bytes`).textContent = `${formatNumber(part.bytes)} bytes`;+ $(`at-diff-${key}-limit`).textContent = `${formatNumber(part.limitBytes)} bytes`;+ $(`at-diff-${key}-headroom`).textContent = part.overLimitBy > 0 ? `${formatNumber(part.overLimitBy)} bytes over` : `${formatNumber(part.headroomBytes)} bytes free`;+ const fits = key === 'v1' ? part.fitsV1 : part.fitsLegacy;+ const fitsCell = $(`at-diff-${key}-fits`);+ fitsCell.textContent = fits ? 'Fits' : 'Does not fit';+ fitsCell.classList.toggle('at-fits-no', !fits);+ }++ const notes = [];+ if (diff.bytesSavedVsLegacy > 0) notes.push(`V1 saves ${formatNumber(diff.bytesSavedVsLegacy)} bytes versus legacy.`);+ else if (diff.bytesSavedVsLegacy < 0) notes.push(`V1 costs ${formatNumber(-diff.bytesSavedVsLegacy)} more bytes than legacy for this payload.`);+ else notes.push('V1 is byte-identical to legacy for this payload.');+ if (diff.bytesSavedVsV0 > 0) notes.push(`It saves ${formatNumber(diff.bytesSavedVsV0)} bytes versus V0.`);+ else if (diff.bytesSavedVsV0 < 0) notes.push(`It costs ${formatNumber(-diff.bytesSavedVsV0)} more bytes than V0.`);+ else notes.push('It is byte-identical to V0.');+ $('at-diff-savings').textContent = notes.join(' ');+ showDiff('report');+}++$('at-diff-example').addEventListener('click', () => loadExample('diff'));+$('at-diff-form').addEventListener('submit', async (event) => {+ event.preventDefault();+ showDiff('loading');+ $('at-diff-submit').disabled = true;+ try {+ const feePayer = $('at-diff-feepayer').value.trim();+ if (!feePayer) throw new Error('Fee payer address is required.');+ const instructions = parseInstructionsJson($('at-diff-instructions').value.trim() || '[]');+ const budgetConfig = budgetConfigFrom('diff');+ const { diff } = await fetch('/api/solana/atomic-plan', {+ method: 'POST',+ headers: { 'content-type': 'application/json', accept: 'application/json' },+ body: JSON.stringify({ feePayer, diff: true, budgetConfig, instructions }),+ }).then(responseJson);+ renderDiff(diff);+ } catch (err) {+ $('at-diff-error-message').textContent = err.message;+ showDiff('error');+ } finally {+ $('at-diff-submit').disabled = false;+ }+});+$('at-diff-retry').addEventListener('click', () => $('at-diff-form').requestSubmit());++// ---------------------------------------------------------------------------+// Wallet V1 capability check tab: client-only, never signs or sends anything.+// The pass/fail verdict comes exclusively from the existing+// findV1WalletStandardSigner helper also used by the real signing paths+// (src/launch/launch-wallet.js, src/onchain/adapters/solana.js).+// ---------------------------------------------------------------------------++function showWallet(name) {+ for (const key of ['loading', 'error', 'report', 'empty']) $(`at-wallet-${key}`).hidden = key !== name;+}++function renderWallet({ name, address, supportsV1, versions }) {+ $('at-wallet-name').textContent = name;+ $('at-wallet-address').textContent = shortKey(address);++ const badge = $('at-wallet-verdict-badge');+ badge.className = 'at-verdict-badge';+ if (supportsV1) {+ badge.textContent = 'V1 capable';+ badge.classList.add('is-safe');+ $('at-wallet-verdict-copy').textContent =+ "wallet.features['solana:signTransaction'].supportedTransactionVersions includes 1, found via findV1WalletStandardSigner.";+ } else {+ badge.textContent = 'V1 not advertised';+ badge.classList.add('is-warn');+ $('at-wallet-verdict-copy').textContent = versions?.length+ ? `This wallet's own Wallet Standard feature set advertises versions [${versions.join(', ')}], which does not include 1.`+ : 'This wallet is not registered with the Wallet Standard, or does not expose a solana:signTransaction feature three.ws can read a version list from.';+ }++ const items = (versions || []).map((v) => {+ const li = document.createElement('li');+ li.textContent = v === 1 ? 'Version 1 (SIMD-0385, 4,096-byte envelope)' : v === 0 ? 'Version 0 (address lookup tables)' : `Version ${v}`;+ return li;+ });+ if (!items.length) {+ const li = document.createElement('li');+ li.textContent = 'No explicit version list available from this wallet.';+ items.push(li);+ }+ $('at-wallet-versions').replaceChildren(...items);+ showWallet('report');+}++async function checkWallet() {+ showWallet('loading');+ $('at-wallet-check-btn').disabled = true;+ try {+ const provider = injectedProvider();+ if (!provider?.connect) {+ throw new Error('No Solana wallet extension detected. Install a Wallet Standard wallet (Phantom, Backpack, Solflare) and reload.');+ }+ const resp = await provider.connect();+ const address = (resp?.publicKey || provider.publicKey)?.toString();+ if (!address) throw new Error('Wallet connected but returned no address.');++ let signer = findV1WalletStandardSigner(getWallets().get(), address);+ if (!signer) {+ // A silent standard:connect on already-approved wallets fills in the+ // Wallet Standard account list without a second prompt; mirrors the+ // retry loop in src/launch/launch-wallet.js's v1SignerFor.+ for (const wallet of getWallets().get()) {+ const connect = wallet?.features?.['standard:connect']?.connect;+ if (!connect) continue;+ try {+ await connect({ silent: true });+ } catch {+ continue;+ }+ signer = findV1WalletStandardSigner(getWallets().get(), address);+ if (signer) break;+ }+ }++ let versions = signer ? signer.feature.supportedTransactionVersions : null;+ if (!versions) {+ const registered = getWallets().get().find((wallet) => wallet.accounts?.some((a) => a.address === address));+ versions = registered?.features?.['solana:signTransaction']?.supportedTransactionVersions || null;+ }++ const name = provider.isPhantom ? 'Phantom' : provider.isBackpack ? 'Backpack' : provider.isSolflare ? 'Solflare' : provider.isThreeWs ? 'three.ws wallet' : 'Wallet';+ renderWallet({ name, address, supportsV1: Boolean(signer), versions });+ } catch (err) {+ $('at-wallet-error-message').textContent = err.message;+ showWallet('error');+ } finally {+ $('at-wallet-check-btn').disabled = false;+ }+}++$('at-wallet-check-btn').addEventListener('click', checkWallet);+$('at-wallet-retry').addEventListener('click', checkWallet);++// ---------------------------------------------------------------------------+// Bootstrap+// ---------------------------------------------------------------------------+loadStatus();+showMask('empty');+showSponsor('empty');+showPlan('empty');+showDiff('empty');+showWallet('empty');++const initialTab = new URLSearchParams(location.search).get('tab');+switchTab(TAB_KEYS.includes(initialTab) ? initialTab : 'inspector');+const initialSignature = new URLSearchParams(location.search).get('signature');if (initialSignature) {$('at-input').value = initialSignature;diff --git a/tests/transaction-v1-lab.test.js b/tests/transaction-v1-lab.test.jsnew file mode 100644index 000000000..bd7be695b--- /dev/null+++ b/tests/transaction-v1-lab.test.js@@ -0,0 +1,172 @@+import { describe, it, expect } from 'vitest';+import { Keypair, SystemProgram } from '@solana/web3.js';+import {+ LEGACY_TRANSACTION_LIMIT,+ V1_TRANSACTION_LIMIT,+ buildPartiallySignedV1Transaction,+ decodeV1ConfigMask,+ diffTransactionVersions,+ findDuplicateAccounts,+ inspectWireTransaction,+ planTransactionSize,+} from '../api/_lib/solana/transaction-v1.js';+import { getTransactionDecoder } from '@solana/kit';++const THREE_MINT = 'FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump';++function transferInstructionInput(fromPubkey, toPubkey) {+ const instruction = SystemProgram.transfer({ fromPubkey, toPubkey, lamports: 1_000 });+ return {+ programId: instruction.programId.toBase58(),+ keys: instruction.keys.map((key) => ({ pubkey: key.pubkey.toBase58(), isSigner: key.isSigner, isWritable: key.isWritable })),+ data: instruction.data,+ };+}++describe('findDuplicateAccounts', () => {+ it('reports no duplicates for a unique account list', () => {+ expect(findDuplicateAccounts([THREE_MINT, SystemProgram.programId.toBase58()])).toEqual([]);+ });++ it('counts a repeated address exactly once with its occurrence count', () => {+ const dup = findDuplicateAccounts([THREE_MINT, SystemProgram.programId.toBase58(), THREE_MINT, THREE_MINT]);+ expect(dup).toEqual([{ address: THREE_MINT, count: 3 }]);+ });++ it('treats an empty or missing list as having no duplicates', () => {+ expect(findDuplicateAccounts([])).toEqual([]);+ expect(findDuplicateAccounts(undefined)).toEqual([]);+ });+});++describe('decodeV1ConfigMask', () => {+ it('decodes the exact bits and fixed-width values a real V1 transaction carries', async () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const wire = await buildPartiallySignedV1Transaction({+ feePayer: owner.publicKey.toBase58(),+ lifetime: { blockhash: Keypair.generate().publicKey.toBase58(), lastValidBlockHeight: 1n },+ instructions: [transferInstructionInput(owner.publicKey, asset.publicKey)],+ signers: [],+ clientSigners: [owner.publicKey.toBase58()],+ });+ const decoded = getTransactionDecoder().decode(wire);+ const mask = decodeV1ConfigMask(decoded.messageBytes);++ expect(mask.maskUint32).toBe(0b1111);+ expect(mask.popcount).toBe(4);+ expect(mask.reservedBitsSet).toBe(false);++ const byField = Object.fromEntries(mask.fields.map((f) => [f.field, f]));+ expect(byField.priorityFeeLamports.present).toBe(true);+ expect(byField.priorityFeeLamports.value).toBe(5_000);+ expect(byField.computeUnitLimit.present).toBe(true);+ expect(byField.computeUnitLimit.value).toBe(500_000);+ expect(byField.loadedAccountsDataSizeLimit.present).toBe(true);+ expect(byField.loadedAccountsDataSizeLimit.value).toBe(8 * 1024 * 1024);+ expect(byField.heapSize.present).toBe(false);+ expect(byField.heapSize.invalidPartial).toBe(false);++ expect(mask.configValuesByteLength).toBe(8 + 4 + 4);+ expect(decoded.messageBytes[0]).toBe(0x81);+ });++ it('rejects a message that is not a V1 envelope', () => {+ expect(() => decodeV1ConfigMask(new Uint8Array(50))).toThrow(/not a V1 transaction message/);+ });++ it('agrees with inspectWireTransaction on the same wire bytes', async () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const wire = await buildPartiallySignedV1Transaction({+ feePayer: owner.publicKey.toBase58(),+ lifetime: { blockhash: Keypair.generate().publicKey.toBase58(), lastValidBlockHeight: 1n },+ instructions: [transferInstructionInput(owner.publicKey, asset.publicKey)],+ signers: [],+ clientSigners: [owner.publicKey.toBase58()],+ });+ const inspected = inspectWireTransaction(Buffer.from(wire).toString('base64'));+ expect(inspected.configMask.maskHex).toBe(`0x${(0b1111).toString(16).padStart(8, '0')}`);+ });+});++describe('planTransactionSize', () => {+ it('compiles a real transfer instruction to its exact V1 wire size with no duplicate accounts', () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const plan = planTransactionSize({+ feePayer: owner.publicKey.toBase58(),+ version: 1,+ instructions: [transferInstructionInput(owner.publicKey, asset.publicKey)],+ });++ expect(plan.version).toBe(1);+ expect(plan.versionLabel).toBe('V1');+ expect(plan.limitBytes).toBe(V1_TRANSACTION_LIMIT);+ expect(plan.headroomBytes).toBe(V1_TRANSACTION_LIMIT - plan.bytes);+ expect(plan.overLimitBy).toBe(0);+ expect(plan.fitsV1).toBe(true);+ expect(plan.fitsLegacy).toBe(true);+ expect(plan.duplicateAccounts).toEqual([]);+ expect(plan.staticAccountCount).toBe(plan.accountReuse.dedupedCount);+ expect(plan.instructionCount).toBe(1);+ expect(plan.signerCount).toBeGreaterThanOrEqual(1);+ });++ it('resolves an explicit priority fee to the exact ceiling-divided lamport total', () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const plan = planTransactionSize({+ feePayer: owner.publicKey.toBase58(),+ version: 1,+ instructions: [transferInstructionInput(owner.publicKey, asset.publicKey)],+ budgetConfig: { computeUnitLimit: 200_000, priorityFeeMicroLamportsPerCu: 10 },+ });++ expect(plan.resourceBudget.computeUnitLimit).toBe(200_000);+ expect(plan.resourceBudget.priorityFeeLamports).toBe(2);+ });++ it('flags a plan that does not fit the legacy/v0 ceiling but does fit V1', () => {+ const owner = Keypair.generate();+ const instructions = Array.from({ length: 30 }, () => transferInstructionInput(owner.publicKey, Keypair.generate().publicKey));+ const legacyPlan = planTransactionSize({ feePayer: owner.publicKey.toBase58(), version: 'legacy', instructions });++ expect(legacyPlan.bytes).toBeGreaterThan(LEGACY_TRANSACTION_LIMIT);+ expect(legacyPlan.fitsLegacy).toBe(false);+ expect(legacyPlan.overLimitBy).toBe(legacyPlan.bytes - LEGACY_TRANSACTION_LIMIT);++ const v1Plan = planTransactionSize({ feePayer: owner.publicKey.toBase58(), version: 1, instructions });+ expect(v1Plan.fitsV1).toBe(true);+ });++ it('rejects a missing fee payer, an invalid version, and too many instructions', () => {+ const owner = Keypair.generate();+ const instruction = transferInstructionInput(owner.publicKey, Keypair.generate().publicKey);+ expect(() => planTransactionSize({ version: 1, instructions: [instruction] })).toThrow(/feePayer is required/);+ expect(() => planTransactionSize({ feePayer: owner.publicKey.toBase58(), version: 2, instructions: [instruction] })).toThrow(/version must be/);+ const tooMany = Array.from({ length: 65 }, () => instruction);+ expect(() => planTransactionSize({ feePayer: owner.publicKey.toBase58(), version: 1, instructions: tooMany })).toThrow(/cannot hold more than/);+ });+});++describe('diffTransactionVersions', () => {+ it('compiles the same instruction set legacy, v0, and v1 and reports the real byte deltas', () => {+ const owner = Keypair.generate();+ const asset = Keypair.generate();+ const diff = diffTransactionVersions({+ feePayer: owner.publicKey.toBase58(),+ instructions: [transferInstructionInput(owner.publicKey, asset.publicKey)],+ });++ expect(diff.legacy.version).toBe('legacy');+ expect(diff.v0.version).toBe(0);+ expect(diff.v1.version).toBe(1);+ expect(diff.bytesSavedVsLegacy).toBe(diff.legacy.bytes - diff.v1.bytes);+ expect(diff.bytesSavedVsV0).toBe(diff.v0.bytes - diff.v1.bytes);+ // V1 carries its config mask and fixed-width values inline, so a tiny+ // single-instruction transfer is not guaranteed to be the smaller+ // encoding; only the arithmetic relationship is asserted here.+ expect(diff.v1.bytes).toBeGreaterThan(0);+ });+});