Skip to content

align docs with java-tron v4.8.2.2 - #385

Merged
Benson0224 merged 3 commits into
tronprotocol:masterfrom
abn2357:align_docs_with_v4.8.2.2
Sep 30, 2026
Merged

align docs with java-tron v4.8.2.2#385
Benson0224 merged 3 commits into
tronprotocol:masterfrom
abn2357:align_docs_with_v4.8.2.2

Conversation

@abn2357

@abn2357 abn2357 commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Summary

  • align the Chinese CI workflow documentation with the current single-node smoke test setup
  • document the 32-byte contract-name limit and VERSION_4_8_2_2 activation behavior
  • clarify the node-populated code_hash and trx_hash fields
  • sync the OpenAPI and OpenRPC definitions with the English repository

Validation

  • mkdocs build --strict

@vivian1912

vivian1912 commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

In the OpenAPI specification, code_hash and trx_hash are still defined as undocumented writable strings in both SmartContract and SmartContractInt64StringCompatible. These schemas are reachable through TransactionRequest -> CreateSmartContract -> SmartContract, so SDKs generated from this OpenAPI definition may still expose the fields as deployment inputs and serialize them into transactions submitted for broadcast.
These fields are maintained by the node and should not be supplied by callers when constructing a deployment transaction. Please document their semantics and mark them as readOnly: true. If the shared SmartContract schema cannot accurately represent both request and response directions, please use separate request and response schemas.

vivian1912
vivian1912 reviewed Sep 10, 2026
View reviewed changes
Comment thread docs/api/rpc/smart-contract/DeployContract.md Outdated
rpc DeployContract (CreateSmartContract) returns (TransactionExtention) {}
```

构造 `CreateSmartContract` 时，请确保 `new_contract.name` 不超过 32 字节。`VERSION_4_8_2_2` 升级生效后，该限制按 UTF-8 编码后的字节数计算，而不是按字符数计算。例如，大多数汉字在 UTF-8 编码中各占三个字节。

@vivian1912 vivian1912 Sep 10, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

建议去掉：”VERSION_4_8_2_2 升级生效后，“

@abn2357 abn2357 Sep 29, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thx. Both the Chinese and English PRs have had the specific version information removed.

@Benson0224
Benson0224 merged commit 9bb46e8 into tronprotocol:master Sep 30, 2026
abn2357 added a commit to abn2357/documentation-zh that referenced this pull request Sep 30, 2026
@abn2357
Rebuild site to ship doc fixes merged after tronprotocol#382
5fb6ff5 
Rebuild the gh-pages site to publish Chinese documentation updates merged into master after the previous rebuild (tronprotocol#382), ordered by merge time.

Included changes:
- tronprotocol#384 complete the java-tron release history
- tronprotocol#388 sync and translate wallet-cli documentation with upstream v4.14.0
- tronprotocol#385 align docs with java-tron v4.8.2.2
- tronprotocol#386 fix remaining inconsistencies with the java-tron source
- tronprotocol#387 add a simulation results note for the triggerconstantcontract API
- tronprotocol#390 fix tcmalloc setup guidance before node deployment commands
- tronprotocol#389 add missing section landing pages and improve documentation structure

This rebuild also adds translated major section landing pages, wallet-cli 8004, BAI, and x402 command groups, and legacy derivation recovery troubleshooting. It refreshes the OpenAPI/OpenRPC specifications, LLM index, sitemap, search index, documentation manifest, and revision dates.
@abn2357 abn2357 mentioned this pull request Sep 30, 2026
Merged
7 tasks done
kuny0707 pushed a commit that referenced this pull request Sep 30, 2026
@abn2357
Rebuild site to ship doc fixes merged after #382 (#391)
a324a2f 
Rebuild the gh-pages site to publish Chinese documentation updates merged into master after the previous rebuild (#382), ordered by merge time.

Included changes:
- #384 complete the java-tron release history
- #388 sync and translate wallet-cli documentation with upstream v4.14.0
- #385 align docs with java-tron v4.8.2.2
- #386 fix remaining inconsistencies with the java-tron source
- #387 add a simulation results note for the triggerconstantcontract API
- #390 fix tcmalloc setup guidance before node deployment commands
- #389 add missing section landing pages and improve documentation structure

This rebuild also adds translated major section landing pages, wallet-cli 8004, BAI, and x402 command groups, and legacy derivation recovery troubleshooting. It refreshes the OpenAPI/OpenRPC specifications, LLM index, sitemap, search index, documentation manifest, and revision dates.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@Benson0224 Benson0224 Benson0224 approved these changes
+1 more reviewer
@vivian1912 vivian1912 vivian1912 approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@abn2357 @vivian1912 @Benson0224