[33imattei33]

Closes ECO-190.

What's in it

How-to guides: new pages in 04_building-apps/how-to/, linked from 03_how-to-guides.md. Each page has a sample in docs/_samples.

Page	Sample	What it shows
Airdrop a Token	airdrop.ts	Mass Transfer in batches of 100, fee formula
Accept Payments	payments.ts	Invoice ID in the transfer attachment, matched with node-api-js
Exchange Tokens with a dApp	token-exchange.ts, ride/token-exchange.ride	Fixed-price buy and sell dApp
Run a Simple Vote	voting.ts, ride/voting.ride	One vote per address, verifier locks the poll
Pass a List to a dApp	list-argument.ts, ride/list-argument.ride	Two list parameters, FOLD<10>

SDK pages: 02_client-libraries-and-sdk.md is now an overview. Each language page covers install, connecting to the Testnet, and signing and broadcasting, including error handling.

• sdk/01_typescript.md now holds the package table. check_sdk_table.py and the drift workflow point to it.
• sdk/02_java.md covers java-sdk 2.0.2, the latest release on Maven Central. Samples are in docs/_samples/java.

Tools

• 01_developer-tools.md is expanded: the node's compileCode, estimate and decompile endpoints, and the current state of surfboard, ride-js and @decentralchain/ride.
• New page developer-tools/01_ride-repl.md covers @decentralchain/ride-repl@1.6.2.

CI: new java_samples_compile job in docs_checks.yml. It runs mvn -q compile on Temurin 25.

Facts that differ from the old pages or the package READMEs

• Java SDK 2.0.x needs Java 25. Its jars are class file version 69. The old page and the README say Java 11, which only holds for older releases. The README's Asset.DCC is also wrong: the class is AssetId.DCC.
• Java transaction builders default to the Mainnet chain ID. Testnet code has to call .chainId(ChainId.TESTNET).
• The REPL needs host globals. It calls httpGet and the hash functions (blake2b256, keccak256, sha256) as globals, which a host has to provide. The sample provides them from ts-lib-crypto.
• surfboard 2.2.6 and ride-js 2.3.0 still depend on compiler packages outside the DecentralChain org. The page says so without naming that project.

Verification

• sphinx-build -W: no warnings. The independence grep and Vale are clean.
• npm run typecheck passes in docs/_samples. mvn -q compile passes on JDK 25.
• check_install_snippets.py (15 snippets) and check_sdk_table.py (22 rows) pass.
• check_ride_samples.py: all 7 Ride samples compile on the public Testnet node.
• Run against the Testnet: ride-repl.ts, CreateAccount.java and ConnectToTestnet.java. The other samples haven't been broadcast, because that needs funded accounts. That is ECO-201.

Notes for the reviewer

• The branch is based on main, so this PR also brings ci: cut Actions minutes (path filters, pip cache, grouped Renovate) #26 and chore(deps): update dependency gitpython to v3.2.1 [security] #27 into dev. That accounts for the renovate.json, requirements.txt and workflow path-filter changes in the diff.
• Install lines pin the versions already on npm (transactions@5.0.1 and so on), as the existing pages do. They get bumped when ECO-206 publishes new releases.
• Not in this PR: 03_ride-language/01_syntax-basics.rst and 05_structures.rst use decentralchainBalance(). The compiler rejects that name; the real one is dccBalance(). That fix belongs to the Ride reference ticket.

🤖 Generated with Claude Code