Codex/examples correctness pass#20
Merged
Merged
Conversation
Rewrite every examples surface (api, tx, transfers, neardata, fastdata/kv, snapshots, rpc, socialdb-proofs) to one framing sentence + one curl + one narrative sentence tying output to insight. Cut the BOS widget NFT archive scenario (obscure), the chunk tracing scenario (data aged off non-archival RPC window within 2-3 days), and the OutLayer page. Repin tx scenario 5 to mainnet 2KhhB1u... so scenarios 2/5/6 triangulate on one real DeFi failure. Fix cross-cutting transaction_outcome -> execution_outcome jq bug. Replace /tmp/ files with shell vars across scenarios. Mirror the full tightening across i18n/ru/** using the three-tier model: Latin brands (FastNear, mainnet, archival), transliterated common nouns (аккаунт, шард, чанк), native prose (запрос, ответ, метод). Russian corpus now matches English line-for-line (4282 -> 1261, 70.6% reduction). yarn audit:ru-terminology clean, yarn audit:i18n:all clean, yarn build passes both locales with no broken anchors.
Append one scenario to tx/examples.md (Failure and async section) that hydrates an outlayer.near request + worker resolution pair in a single /v0/transactions batch and surfaces the request_id + data_id correlation along with the TEE resources_used fingerprint (instructions, time_ms, encrypted bytes). Pinned pair: retrorn.near's request_execution tx BZDQAxEd... (block 194832281) + worker.outlayer.near's submit_execution_output_and_resolve tx 3NYD4Mkn... (block 194832292), both calling the zavodil.near/near-email project for a delete_email action. Narrative deliberately avoids claiming yield/resume receipt kinds (they render as Action in the indexed view) or DAO attestation posting (no receipt chain to any DAO contract was observed; product docs' DAO governs only the CKD master key). Archival note is one line: the indexed /v0/transactions surface serves historical pairs regardless. Mirrored in i18n/ru/.../tx/examples.md using the three-tier model. yarn audit:ru-terminology + yarn audit:i18n:all clean; yarn build passes both locales.
- README "Examples Voice And Shape": add four principle bullets (teach NEAR not verify the RPC; one question per subsection; lead with mental model when the RPC surface surprises; one jq pipeline per example). - /rpc: reshape Tip Block, Account Keys, and Contract Reads around the codified principles; add a new "Account State" section with a view_account beginner intro. - /api: add three examples (NFT collections by publisher suffix, balance decomposition via /full state, activity recency across /full arrays), plus a one-call account summary beginner intro. - /neardata: drop the 33-line shared contract_touch_summary helper, rewrite all three examples with inline minimal jq, fix a latent echo/backslash bug in the optimistic-vs-final pipeline with printf, and add a current-tip + txs-per-shard beginner intro. - /transfers: add an unfiltered-recent-activity beginner intro before the existing filter-and-page example. - /tx: merge the overlapping "successful outer, failed descendant" and "callback ran" examples into one consolidated async-failure example; trim the OutLayer pairing to a request_id handshake (richer TEE fingerprint fields noted inline rather than decoded). EN/RU line parity verified on every page; yarn audit:ru-terminology clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
this is the one with curl examples that have been QAed