From 3ad3f3092933f39fb1d696af2bd6c174dc59f6e8 Mon Sep 17 00:00:00 2001 From: admin Date: Sun, 8 Nov 2026 14:53:51 +0800 Subject: [PATCH] =?UTF-8?q?docs(tools):=20=E5=9B=BD=E5=AF=86=E9=93=BE?= =?UTF-8?q?=E7=9C=9F=E9=93=BE=E5=A4=8D=E7=8E=B0=E8=84=9A=E6=9C=AC=E4=B8=8E?= =?UTF-8?q?=E8=AF=81=E6=8D=AE=E5=85=A5=E5=BA=93=EF=BC=8C=E9=81=BF=E5=85=8D?= =?UTF-8?q?=E6=95=A3=E8=90=BD=20/tmp=20=E5=90=8E=E4=B8=A2=E5=A4=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增 tools/fisco-realnode/:真链实证期用过的 Python SDK 发送器 (fj-sdk/)、Java JNI 独立交叉验证探针 (jni/)、TARS 编解码辅助 (tars/), 作为审计轨迹留档,便于回看签名口径根因。 - 新增 example.chain.json(非密钥,可入库)与 README.md 索引:明确 规范入口 (selftest-fisco-contract.py 主门禁第22条) 与审计轨迹的分工、 复现所需环境变量、下载项、密钥与诚实边界。 - .gitignore 屏蔽私钥 (*.pem/*.key)、下载型二进制 (jar/tar.gz) 与大证据 blob,防止密钥或体积大的文件进 git 历史。 --- tools/fisco-realnode/.gitignore | 22 ++++ tools/fisco-realnode/README.md | 116 ++++++++++++++++++++ tools/fisco-realnode/example.chain.json | 7 ++ tools/fisco-realnode/fj-sdk/abidef.py | 16 +++ tools/fisco-realnode/fj-sdk/findcompiler.py | 14 +++ tools/fisco-realnode/fj-sdk/findexec.py | 16 +++ tools/fisco-realnode/fj-sdk/findexec2.py | 8 ++ tools/fisco-realnode/fj-sdk/findtx.py | 14 +++ tools/fisco-realnode/fj-sdk/mgr.py | 7 ++ tools/fisco-realnode/fj-sdk/mgr2.py | 6 + tools/fisco-realnode/fj-sdk/prop.py | 12 ++ tools/fisco-realnode/fj-sdk/readabi.py | 14 +++ tools/fisco-realnode/fj-sdk/readtx.py | 10 ++ tools/fisco-realnode/fj-sdk/req.py | 5 + tools/fisco-realnode/fj-sdk/sender.py | 11 ++ tools/fisco-realnode/fj-sdk/sender2.py | 6 + tools/fisco-realnode/fj-sdk/sender3.py | 6 + tools/fisco-realnode/fj-sdk/sender4.py | 6 + tools/fisco-realnode/fj-sdk/tree.py | 15 +++ tools/fisco-realnode/fj-sdk/tree2.py | 15 +++ tools/fisco-realnode/jni/Decode.java | 31 ++++++ tools/fisco-realnode/jni/DiffProbe.java | 58 ++++++++++ tools/fisco-realnode/jni/Dual.java | 34 ++++++ tools/fisco-realnode/jni/Encode.java | 74 +++++++++++++ tools/fisco-realnode/jni/HashProbe.java | 33 ++++++ tools/fisco-realnode/jni/Mini.java | 17 +++ tools/fisco-realnode/jni/OffReal.java | 60 ++++++++++ tools/fisco-realnode/jni/OfficialTx.java | 37 +++++++ tools/fisco-realnode/jni/OfficialTx2.java | 50 +++++++++ tools/fisco-realnode/jni/Oracle.java | 105 ++++++++++++++++++ tools/fisco-realnode/jni/Pos.java | 31 ++++++ tools/fisco-realnode/jni/Probe.java | 27 +++++ tools/fisco-realnode/jni/Probe2.java | 28 +++++ tools/fisco-realnode/tars/analyze_tars.py | 78 +++++++++++++ tools/fisco-realnode/tars/decode_tars.py | 114 +++++++++++++++++++ tools/fisco-realnode/tars/gh_decode.py | 7 ++ 36 files changed, 1110 insertions(+) create mode 100644 tools/fisco-realnode/.gitignore create mode 100644 tools/fisco-realnode/README.md create mode 100644 tools/fisco-realnode/example.chain.json create mode 100644 tools/fisco-realnode/fj-sdk/abidef.py create mode 100644 tools/fisco-realnode/fj-sdk/findcompiler.py create mode 100644 tools/fisco-realnode/fj-sdk/findexec.py create mode 100644 tools/fisco-realnode/fj-sdk/findexec2.py create mode 100644 tools/fisco-realnode/fj-sdk/findtx.py create mode 100644 tools/fisco-realnode/fj-sdk/mgr.py create mode 100644 tools/fisco-realnode/fj-sdk/mgr2.py create mode 100644 tools/fisco-realnode/fj-sdk/prop.py create mode 100644 tools/fisco-realnode/fj-sdk/readabi.py create mode 100644 tools/fisco-realnode/fj-sdk/readtx.py create mode 100644 tools/fisco-realnode/fj-sdk/req.py create mode 100644 tools/fisco-realnode/fj-sdk/sender.py create mode 100644 tools/fisco-realnode/fj-sdk/sender2.py create mode 100644 tools/fisco-realnode/fj-sdk/sender3.py create mode 100644 tools/fisco-realnode/fj-sdk/sender4.py create mode 100644 tools/fisco-realnode/fj-sdk/tree.py create mode 100644 tools/fisco-realnode/fj-sdk/tree2.py create mode 100644 tools/fisco-realnode/jni/Decode.java create mode 100644 tools/fisco-realnode/jni/DiffProbe.java create mode 100644 tools/fisco-realnode/jni/Dual.java create mode 100644 tools/fisco-realnode/jni/Encode.java create mode 100644 tools/fisco-realnode/jni/HashProbe.java create mode 100644 tools/fisco-realnode/jni/Mini.java create mode 100644 tools/fisco-realnode/jni/OffReal.java create mode 100644 tools/fisco-realnode/jni/OfficialTx.java create mode 100644 tools/fisco-realnode/jni/OfficialTx2.java create mode 100644 tools/fisco-realnode/jni/Oracle.java create mode 100644 tools/fisco-realnode/jni/Pos.java create mode 100644 tools/fisco-realnode/jni/Probe.java create mode 100644 tools/fisco-realnode/jni/Probe2.java create mode 100644 tools/fisco-realnode/tars/analyze_tars.py create mode 100644 tools/fisco-realnode/tars/decode_tars.py create mode 100644 tools/fisco-realnode/tars/gh_decode.py diff --git a/tools/fisco-realnode/.gitignore b/tools/fisco-realnode/.gitignore new file mode 100644 index 0000000..704093b --- /dev/null +++ b/tools/fisco-realnode/.gitignore @@ -0,0 +1,22 @@ +# 国密链真链复现目录:只入库源码与说明,二进制/密钥/大证据一律不入库。 + +# 1) 密钥:真实链私钥绝对不入库(一旦进 git 历史就废了,且泄漏风险) +*.pem +*.key +key +key.pem + +# 2) 下载型二进制:按需按下方 README 获取,体积大且可重新下载 +*.jar +*.tar.gz +*.tgz +fisco-bcos-* +tassl-* +solcJ-* +sdk.jar + +# 3) 大证据 blob(真链 RPC 回包录制):可经 fj-sdk 发送脚本重新生成,不入库 +fisco-tree.json +fisco-rel.json +ci-chain*.log +*.log diff --git a/tools/fisco-realnode/README.md b/tools/fisco-realnode/README.md new file mode 100644 index 0000000..b728b4e --- /dev/null +++ b/tools/fisco-realnode/README.md @@ -0,0 +1,116 @@ +# 国密链真链合约:复现与证据索引 + +> 本目录是 **FISCO BCOS 国密链「真链」智能合约** 工作的落地与索引。 +> 目标:把「区块链智能合约真的跑通」这件事所需的关键脚本、证据、复现说明 +> 全部留在仓库里,避免散落在 `/tmp` 之后找不着。 +> +> 一句话结论:**部署 → 真调用写接口 → 只读读回 → 负向矩阵** 已在真链 +> 全绿(合约地址 `0x82a3c328…`,`isRecorded=0x…01`,摘要原样读回, +> 零摘要被 `require` 拒、`10008 InvalidSignature` 已根除)。 + +--- + +## 1. 哪些是「规范入口」(要跑就跑这些) + +| 文件 | 作用 | 说明 | +|---|---|---| +| `tools/selftest-fisco-contract.py` | **真链判据主脚本**(主门禁第 22 条) | 连真链跑完整流程:部署→写→读→负向矩阵。**这是唯一权威验收脚本**。 | +| `tools/sm2_verify.py` | SM2 签名口径自检 | 交叉验证 `ZA‖digest` 口径,附 ZA 值锚点。 | +| `tools/ci.sh` | 门禁(22 条) | 第 22 条即本真链判据;全绿才放行。 | +| `contracts/MpcHardRule.sol` | 合约源码 | `recordHardRule(summary)` 写接口 + `isRecorded`/`hardRuleSummary` 读接口,`require(summary!=0)`。 | +| `build/contracts/combined.json` | solc 产物 | 含 `abi` 与 `bin`(部署字节码),selftest 的 `MPC_FISCO_ABI` 指向这里。 | +| `docs/FISCO_UPSTREAM_TRUTH.md` | **上游事实真相** | 签名口径(`fast_sm2_verify` → `e=SM3(ZA‖dataHash)`)、TARS 编码、端点、selector 二元数组等,全部以真链实测为准。 | + +> 不要去跑 `tools/selftest-chain.py` / `selftest-chain-gm.py` / `selftest-chain-tx.py` / +> `selftest-chain-opa.py` 当作「真链验收」——那些是**框架契约**或**其它子系统**的判据, +> 不证明真链能上链。真链验收只看 `selftest-fisco-contract.py`。 + +--- + +## 2. 复现所需环境变量 + +`selftest-fisco-contract.py` 必须的三个变量(缺一会显式 `SKIPPED` 并点名缺哪个): + +| 变量 | 含义 | +|---|---| +| `MPC_FISCO_CHAIN_CONFIG` | 链配置文件路径(见本目录 `example.chain.json`) | +| `MPC_FISCO_KEY` | SM2 **私钥** PEM 路径(**密钥,绝不入库**,见 §5) | +| `MPC_FISCO_ABI` | solc ABI JSON 路径(用 `build/contracts/combined.json`) | +| `MPC_FISCO_NODE` | 可选,默认 `node0` | + +跑法: + +```bash +# 零依赖判据逻辑自测(不需要真链) +python3 tools/selftest-fisco-contract.py --self-test + +# 连真链跑完整验收 +MPC_FISCO_CHAIN_CONFIG=tools/fisco-realnode/example.chain.json \ +MPC_FISCO_KEY=/path/to/key.pem \ +MPC_FISCO_ABI=build/contracts/combined.json \ +python3 tools/selftest-fisco-contract.py +``` + +`example.chain.json` 字段:`rpc_endpoint`(通道端口 20200)、`group_id`、 +`chain_id`、`sm_crypto=true`、`client_tlcp=false`。 + +--- + +## 3. 真链环境怎么来(不在仓库,按需下载) + +这些二进制**体积大且可重新下载,已用 `.gitignore` 排除**,不要入库: + +- **节点二进制** `fisco-bcos`:FISCO BCOS v3 官方发布(国密链 `sm_crypto=true`, + 通道端口 20200 / RPC 30300,`chain0`/`group0`)。 +- **Java SDK** `fisco-bcos-java-sdk`(Maven Central 可达,含 `sdk.jar`)。 +- **solcJ** `solcJ-mac-1.0.0.jar`:FISCO 提供的 Solidity 编译器封装。 +- **TASSL / TLCP** 国密 TLS 工具链(如需 `client_tlcp=true` 再准备)。 + +> 本机历史上真链跑在 `/tmp/fisco-linux-node` + 容器 `fisco-gm` 上; +> 重新部署时按 FISCO 官方 `build_chain.sh` 起一个 `sm_crypto=true` 的链即可。 + +--- + +## 4. 审计轨迹 / 证据(本目录的 `fj-sdk/` `jni/` `tars/`) + +这些是 **2026-11-08 真链实证期间** 用来挖根因、做独立交叉验证的脚本, +作为**审计轨迹**保留,便于将来回看「为什么这么签」。它们不是要日常跑的入口。 + +- `fj-sdk/*.py`:基于 FISCO Java SDK 的 Python 封装与发送器 + (`sender*.py` 真发过部署/调用交易,`tree*.py` 录制回包树, + `readabi.py`/`readtx.py` 读 ABI 与回执,`req.py` 发 JSON-RPC)。 +- `jni/*.java`:**独立地面真相探针**——用官方 JNI(`OffReal.java` / + `OfficialTx.java`)按官方流程签名并组交易,与本项目 `mpc-chain` 的 + 签名结果逐一比对,由此锁定 `10008 InvalidSignature` 根因 + (节点 `fast_sm2_verify` 验的是 `e=SM3(ZA‖dataHash)`,旧代码签裸摘要)。 + `Probe*.java` / `DiffProbe.java` 做逐字节 diff。 +- `tars/*.py`:TARS 二进制编解码辅助(`analyze_tars.py` / `decode_tars.py` / + `gh_decode.py`),用来核对交易编码与 `TransactionData` 哈希口径。 + +> 这些脚本依赖上面 §3 的 jar/二进制,且多为实证期的迭代稿; +> **重跑验证请用 §1 的 `selftest-fisco-contract.py`**,本目录脚本仅作证据留档。 + +--- + +## 5. 密钥与秘密(重点) + +- **真实链私钥(`*.pem`)绝对不入库**——一旦进 git 历史就无法撤回,且泄漏即失陷。 + 本目录 `.gitignore` 已屏蔽 `*.pem`/`*.key`。 +- `example.chain.json` 只含 `rpc_endpoint`/`group_id`/`chain_id`/`sm_crypto`, + **不含任何密钥**,可安全入库。 +- 真实私钥请放在仓库外(如 `/tmp/mpc-chain-real/key.pem` 或密钥管理器), + 通过 `MPC_FISCO_KEY` 环境变量注入。 + +--- + +## 6. 诚实边界(仍未做的,不要误以为已做) + +- **软件 OpenSSL 签名器私钥可导出 ⇒ 密评不可过**:生产须换硬件加密模组 + (`SignerPolicy::ProductionModule` 必拒软件签名器)。真链验证用的是软件签名器, + 仅证明「口径正确、能上链」,不代表满足密评。 +- **TLCP 接真 `bcos-rpc` 通道未通**:此前只在环回 echo 上验过框架契约, + 不等于真链 TLCP 通道已打通(`client_tlcp=false` 跑的通)。 +- **部署地址非确定**:nonce 随机,每次部署地址不同,不写死。 +- `tools/fisco-realnode-probe.py`(仓库根 `tools/`)是更早的探针, + 含 4 处 `IMPL_GAPS`、只报 `SKIPPED`/`NEEDS_IMPL`,已被 + `selftest-fisco-contract.py` 取代;保留作历史参考。 diff --git a/tools/fisco-realnode/example.chain.json b/tools/fisco-realnode/example.chain.json new file mode 100644 index 0000000..ebf9ae8 --- /dev/null +++ b/tools/fisco-realnode/example.chain.json @@ -0,0 +1,7 @@ +{ + "rpc_endpoint": "127.0.0.1:20200", + "group_id": "group0", + "chain_id": "chain0", + "sm_crypto": true, + "client_tlcp": false +} diff --git a/tools/fisco-realnode/fj-sdk/abidef.py b/tools/fisco-realnode/fj-sdk/abidef.py new file mode 100644 index 0000000..40fe008 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/abidef.py @@ -0,0 +1,16 @@ +import os +import re + +base = '/tmp/fj-sdk/src' +# 找 ABI JSON 生成相关:搜 "conflictFields" 与 "selector" 同时出现,或 "setSelector" +for root, dirs, files in os.walk(base): + for f in files: + if not f.endswith('.java'): + continue + p = os.path.join(root, f) + try: + s = open(p, encoding='utf-8', errors='replace').read() + except Exception: + continue + if 'conflictFields' in s: + print('###', p.replace(base, ''), len(s)) diff --git a/tools/fisco-realnode/fj-sdk/findcompiler.py b/tools/fisco-realnode/fj-sdk/findcompiler.py new file mode 100644 index 0000000..01b8524 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/findcompiler.py @@ -0,0 +1,14 @@ +import os + +base = '/tmp/fj-sdk/src' +for root, dirs, files in os.walk(base): + for f in files: + if not f.endswith('.java'): + continue + p = os.path.join(root, f) + try: + s = open(p, encoding='utf-8', errors='replace').read() + except Exception: + continue + if 'SolidityCompiler' in s or 'solidityCompiler' in s: + print('###', p.replace(base, ''), len(s)) diff --git a/tools/fisco-realnode/fj-sdk/findexec.py b/tools/fisco-realnode/fj-sdk/findexec.py new file mode 100644 index 0000000..bc9e42a --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/findexec.py @@ -0,0 +1,16 @@ +import re + +p = '/Users/xs/Desktop/workspace/ssw-mpc/.tmp-fisco/fisco/bcos-executor/src/executor/TransactionExecutor.cpp' +s = open(p, encoding='utf-8', errors='replace').read() +for kw in ['functionAbi', 'flatInputs', 'decode']: + idxs = [m.start() for m in re.finditer(kw, s)] + print(kw, len(idxs)) + +i = s.find('functionAbi') +# 找解码调用点 +for m in re.finditer(r'.{400}(flatInputs|functionAbi->|deserialize).{600}', s, re.S): + t = m.group(0) + if 'flatInputs' in t and ('decode' in t.lower() or 'serialize' in t.lower()): + print(t) + print('=====') + break diff --git a/tools/fisco-realnode/fj-sdk/findexec2.py b/tools/fisco-realnode/fj-sdk/findexec2.py new file mode 100644 index 0000000..39c1e4f --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/findexec2.py @@ -0,0 +1,8 @@ +import re + +p = '/Users/xs/Desktop/workspace/ssw-mpc/.tmp-fisco/fisco/bcos-executor/src/executor/TransactionExecutor.cpp' +s = open(p, encoding='utf-8', errors='replace').read() +for m in re.finditer(r'functionAbi', s): + a = max(0, m.start() - 200) + print(repr(s[a:m.start() + 400])) + print('-----') diff --git a/tools/fisco-realnode/fj-sdk/findtx.py b/tools/fisco-realnode/fj-sdk/findtx.py new file mode 100644 index 0000000..4261272 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/findtx.py @@ -0,0 +1,14 @@ +import os + +os.chdir('/tmp/fj-sdk/src') +for root, dirs, files in os.walk('.'): + for f in files: + if not f.endswith('.java'): + continue + p = os.path.join(root, f) + try: + s = open(p, encoding='utf-8', errors='replace').read() + except Exception: + continue + if 'dataHash' in s and 'signature' in s and 'abi' in s: + print('###', p, len(s)) diff --git a/tools/fisco-realnode/fj-sdk/mgr.py b/tools/fisco-realnode/fj-sdk/mgr.py new file mode 100644 index 0000000..30f8e4e --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/mgr.py @@ -0,0 +1,7 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/DefaultTransactionManager.java' +s = open(p, encoding='utf-8', errors='replace').read() +print('LEN', len(s)) +for m in re.finditer(r'^\s*(public|private|protected)[^\n{]*\(', s, re.M): + print(m.group(0).strip()) diff --git a/tools/fisco-realnode/fj-sdk/mgr2.py b/tools/fisco-realnode/fj-sdk/mgr2.py new file mode 100644 index 0000000..cf82052 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/mgr2.py @@ -0,0 +1,6 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/DefaultTransactionManager.java' +s = open(p, encoding='utf-8', errors='replace').read() +i = s.find('public String createSignedTransaction(') +print(s[i:i + 4000]) diff --git a/tools/fisco-realnode/fj-sdk/prop.py b/tools/fisco-realnode/fj-sdk/prop.py new file mode 100644 index 0000000..d99bf74 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/prop.py @@ -0,0 +1,12 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/contract/auth/contracts/ProposalManager.java' +s = open(p, encoding='utf-8', errors='replace').read() +for m in re.finditer(r'"selector"\s*:\s*\[[^\]]*\]', s): + print(m.group(0)) +print('--- function sigs ---') +for m in re.finditer(r'"name"\s*:\s*"([^"]+)"\s*,\s*"type"\s*:\s*"function"', s): + print(m.group(1)) +print('--- first selector context ---') +i = s.find('"selector"') +print(s[max(0, i - 1200):i + 400]) diff --git a/tools/fisco-realnode/fj-sdk/readabi.py b/tools/fisco-realnode/fj-sdk/readabi.py new file mode 100644 index 0000000..5d0e555 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/readabi.py @@ -0,0 +1,14 @@ +import os +import re + +root = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/codec/wrapper' +for f in sorted(os.listdir(root)): + if not f.endswith('.java'): + continue + p = os.path.join(root, f) + s = open(p, encoding='utf-8', errors='replace').read() + if 'selector' in s.lower(): + print('###', f, len(s)) + for m in re.finditer(r'.{200}[Ss]elector.{400}', s, re.S): + print(m.group(0)) + print('-----') diff --git a/tools/fisco-realnode/fj-sdk/readtx.py b/tools/fisco-realnode/fj-sdk/readtx.py new file mode 100644 index 0000000..885fc7c --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/readtx.py @@ -0,0 +1,10 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/ProxySignTransactionManager.java' +s = open(p, encoding='utf-8', errors='replace').read() + +# 找 TARS 字段声明(形如: private X field; / @TarsField ...) +for m in re.finditer(r'(dataHash|signature|abi|attribute|input|to|value|gasPrice|gasLimit|maxFeePerGas|maxPriorityFeePerGas|blockLimit|nonce|chainId|groupId|version|extension|extraData|txType)\s*;', s): + a = max(0, m.start() - 320) + print(repr(s[a:m.end()])) + print('-----') diff --git a/tools/fisco-realnode/fj-sdk/req.py b/tools/fisco-realnode/fj-sdk/req.py new file mode 100644 index 0000000..65b17c8 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/req.py @@ -0,0 +1,5 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/dto/AbiEncodedRequest.java' +s = open(p, encoding='utf-8', errors='replace').read() +print(s[:4000]) diff --git a/tools/fisco-realnode/fj-sdk/sender.py b/tools/fisco-realnode/fj-sdk/sender.py new file mode 100644 index 0000000..7db14d4 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/sender.py @@ -0,0 +1,11 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/AssembleTransactionService.java' +s = open(p, encoding='utf-8', errors='replace').read() +print('LEN', len(s)) +for kw in ['sender', 'setSender', 'getAddress']: + for m in re.finditer(r'.{250}' + kw + r'.{350}', s, re.S): + print('###', kw) + print(m.group(0)) + print('-----') + break diff --git a/tools/fisco-realnode/fj-sdk/sender2.py b/tools/fisco-realnode/fj-sdk/sender2.py new file mode 100644 index 0000000..72ceab5 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/sender2.py @@ -0,0 +1,6 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/AssembleTransactionService.java' +s = open(p, encoding='utf-8', errors='replace').read() +i = s.find('public TransactionReceipt sendTransaction') +print(s[i:i + 3000] if i > 0 else 'NOT FOUND sendTransaction') diff --git a/tools/fisco-realnode/fj-sdk/sender3.py b/tools/fisco-realnode/fj-sdk/sender3.py new file mode 100644 index 0000000..d8015c9 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/sender3.py @@ -0,0 +1,6 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/AssembleTransactionService.java' +s = open(p, encoding='utf-8', errors='replace').read() +for m in re.finditer(r'^\s*(public|private|protected)[^\n{]*\(', s, re.M): + print(m.group(0).strip()) diff --git a/tools/fisco-realnode/fj-sdk/sender4.py b/tools/fisco-realnode/fj-sdk/sender4.py new file mode 100644 index 0000000..e2cb1ee --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/sender4.py @@ -0,0 +1,6 @@ +import re + +p = '/tmp/fj-sdk/src/org/fisco/bcos/sdk/v3/transaction/manager/transactionv1/AssembleTransactionService.java' +s = open(p, encoding='utf-8', errors='replace').read() +i = s.find('public TransactionResponse deployContract(') +print(s[i:i + 3500]) diff --git a/tools/fisco-realnode/fj-sdk/tree.py b/tools/fisco-realnode/fj-sdk/tree.py new file mode 100644 index 0000000..0d177cc --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/tree.py @@ -0,0 +1,15 @@ +import os + +base = '/tmp/fj-sdk/src' +skip = {'codec/datatypes/generated'} +for root, dirs, files in os.walk(base): + rel = os.path.relpath(root, base) + if rel.count(os.sep) > 4: + dirs[:] = [] + continue + for f in sorted(files): + if f.endswith('.java'): + p = os.path.join(rel, f) + if 'generated' in p: + continue + print(p) diff --git a/tools/fisco-realnode/fj-sdk/tree2.py b/tools/fisco-realnode/fj-sdk/tree2.py new file mode 100644 index 0000000..e218775 --- /dev/null +++ b/tools/fisco-realnode/fj-sdk/tree2.py @@ -0,0 +1,15 @@ +import os + +base = '/tmp/fj-sdk/src' +out = [] +for root, dirs, files in os.walk(base): + rel = os.path.relpath(root, base) + depth = 0 if rel == '.' else rel.count(os.sep) + 1 + if depth > 4: + dirs[:] = [] + continue + for f in sorted(files): + if f.endswith('.java') and 'generated' not in rel: + out.append(os.path.join(rel, f)) +print(len(out)) +open('/tmp/fj-sdk/tree.txt', 'w').write('\n'.join(out) + '\n') diff --git a/tools/fisco-realnode/jni/Decode.java b/tools/fisco-realnode/jni/Decode.java new file mode 100644 index 0000000..ad72177 --- /dev/null +++ b/tools/fisco-realnode/jni/Decode.java @@ -0,0 +1,31 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.Transaction; + +/** + * 用官方 JNI 解码我构造的交易 TARS 字节,输出官方视角的 JSON。 + * + * 用法: java -cp bcos-sdk-jni.jar Decode + */ +public class Decode { + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String hex = new String(java.nio.file.Files.readAllBytes( + java.nio.file.Paths.get(args[0])), "utf-8").trim(); + if (hex.startsWith("0x")) hex = hex.substring(2); + + Transaction tx = TransactionStructBuilderJniObj.decodeTransactionStruct(hex); + String json = TransactionStructBuilderJniObj.encodeTransactionStructToJson(tx); + System.out.println("OFFICIAL_JSON=" + json); + + byte[] dh = tx.getDataHash(); + StringBuilder sb = new StringBuilder(); + for (byte b : dh) sb.append(String.format("%02x", b)); + System.out.println("OFFICIAL_DECODED_HASH=" + sb); + + byte[] sg = tx.getSignature(); + StringBuilder sb2 = new StringBuilder(); + for (byte b : sg) sb2.append(String.format("%02x", b)); + System.out.println("OFFICIAL_DECODED_SIG=" + sb2); + } +} diff --git a/tools/fisco-realnode/jni/DiffProbe.java b/tools/fisco-realnode/jni/DiffProbe.java new file mode 100644 index 0000000..5960a79 --- /dev/null +++ b/tools/fisco-realnode/jni/DiffProbe.java @@ -0,0 +1,58 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import java.nio.file.*; + +public class DiffProbe { + static final int SM = 0; + static TransactionDataV1 mk(int variant) { + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce("abc"); + d.setTo(""); + d.setAbi("{\"a\":1}"); + d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(30000000); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + return d; + } + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String base = TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, mk(0)); + System.out.println("BASE=" + base); + + // 逐字段扰动,看 hash 是否变化 + TransactionDataV1 a = mk(0); a.setVersion(2); + System.out.println("version2 = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, a)); + TransactionDataV1 b = mk(0); b.setBlockLimit(501); + System.out.println("blockLimit = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, b)); + TransactionDataV1 c = mk(0); c.setChainId("chain1"); + System.out.println("chainId = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, c)); + TransactionDataV1 dd = mk(0); dd.setGroupId("group1"); + System.out.println("groupId = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, dd)); + TransactionDataV1 e = mk(0); e.setNonce("abd"); + System.out.println("nonce = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, e)); + TransactionDataV1 f = mk(0); f.setTo("0x1"); + System.out.println("to = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, f)); + TransactionDataV1 g = mk(0); g.setAbi("{\"a\":2}"); + System.out.println("abi = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, g)); + TransactionDataV1 h = mk(0); h.setInput(new byte[]{1,2,4}); + System.out.println("input = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, h)); + TransactionDataV1 i2 = mk(0); i2.setValue("0x1"); + System.out.println("value = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, i2)); + TransactionDataV1 j = mk(0); j.setGasPrice("0x1"); + System.out.println("gasPrice = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, j)); + TransactionDataV1 k = mk(0); k.setGasLimit(30000001); + System.out.println("gasLimit = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, k)); + TransactionDataV1 l = mk(0); l.setMaxFeePerGas("0x1"); + System.out.println("maxFee = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, l)); + TransactionDataV1 m = mk(0); m.setMaxPriorityFeePerGas("0x1"); + System.out.println("maxPrio = " + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, m)); + } +} diff --git a/tools/fisco-realnode/jni/Dual.java b/tools/fisco-realnode/jni/Dual.java new file mode 100644 index 0000000..4eb9c40 --- /dev/null +++ b/tools/fisco-realnode/jni/Dual.java @@ -0,0 +1,34 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +public class Dual { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce("abc"); + d.setTo(""); + d.setAbi("{\"a\":1}"); + d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(30000000); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + + System.out.println("STRUCT_HASH=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d)); + String tars = TransactionStructBuilderJniObj.encodeTransactionDataStruct(d); + System.out.println("TARS=" + tars); + + long p = TransactionBuilderJniObj.createTransactionDataWithJson(tars); + System.out.println("BUILDER_HASH=" + TransactionBuilderJniObj.calcTransactionDataHash(SM, p)); + System.out.println("BUILDER_ENCODE=" + TransactionBuilderJniObj.encodeTransactionData(p)); + TransactionBuilderJniObj.destroyTransactionData(p); + } +} diff --git a/tools/fisco-realnode/jni/Encode.java b/tools/fisco-realnode/jni/Encode.java new file mode 100644 index 0000000..5e89b93 --- /dev/null +++ b/tools/fisco-realnode/jni/Encode.java @@ -0,0 +1,74 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +/** + * 用官方 JNI 编码同一份 TransactionData,输出官方 TARS hex + 官方 hash。 + * + * 用法: java -cp bcos-sdk-jni.jar Encode + */ +public class Encode { + static final int SM = 0; + + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String text = new String(java.nio.file.Files.readAllBytes( + java.nio.file.Paths.get(args[0])), "utf-8"); + + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion((int) jlong(text, "version")); + d.setChainId(jstr(text, "chainId")); + d.setGroupId(jstr(text, "groupId")); + d.setNonce(jstr(text, "nonce")); + d.setTo(jstr(text, "to")); + d.setAbi(jstr(text, "abi")); + d.setBlockLimit(jlong(text, "blockLimit")); + d.setInput(fromHex(jstr(text, "input"))); + d.setValue(jstr(text, "value")); + d.setGasPrice(jstr(text, "gasPrice")); + d.setGasLimit(jlong(text, "gasLimit")); + d.setMaxFeePerGas(jstr(text, "maxFeePerGas")); + d.setMaxPriorityFeePerGas(jstr(text, "maxPriorityFeePerGas")); + + String hash = TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d); + String enc = TransactionStructBuilderJniObj.encodeTransactionDataStruct(d); + System.out.println("OFFICIAL_HASH=" + hash); + System.out.println("OFFICIAL_TARS=" + enc); + System.out.println("OFFICIAL_TARS_LEN=" + (enc.length() / 2)); + } + + static byte[] fromHex(String h) { + if (h == null) return new byte[0]; + h = h.startsWith("0x") ? h.substring(2) : h; + int n = h.length() / 2; + byte[] out = new byte[n]; + for (int i = 0; i < n; i++) { + out[i] = (byte) Integer.parseInt(h.substring(i * 2, i * 2 + 2), 16); + } + return out; + } + + static String jstr(String text, String key) { + String pat = "\"" + key + "\""; + int i = text.indexOf(pat); + if (i < 0) return ""; + int c = text.indexOf(':', i); + int q = text.indexOf('"', c + 1); + if (q < 0) return ""; + int e = text.indexOf('"', q + 1); + if (e < 0) return ""; + return text.substring(q + 1, e); + } + + static long jlong(String text, String key) { + String pat = "\"" + key + "\""; + int i = text.indexOf(pat); + if (i < 0) return 0; + int c = text.indexOf(':', i); + int s = c + 1; + while (s < text.length() && Character.isWhitespace(text.charAt(s))) s++; + int e = s; + while (e < text.length() && (Character.isDigit(text.charAt(e)) || text.charAt(e) == '-')) e++; + return Long.parseLong(text.substring(s, e)); + } +} diff --git a/tools/fisco-realnode/jni/HashProbe.java b/tools/fisco-realnode/jni/HashProbe.java new file mode 100644 index 0000000..91d36b2 --- /dev/null +++ b/tools/fisco-realnode/jni/HashProbe.java @@ -0,0 +1,33 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import java.nio.file.*; + +public class HashProbe { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + // 从文件读:abi 文件 + input 文件 + 其余标量从 argv + String abi = new String(Files.readAllBytes(Paths.get(args[0])), "utf-8"); + byte[] input = Files.readAllBytes(Paths.get(args[1])); + String nonce = args[2]; + long gasLimit = Long.parseLong(args[3]); + + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce(nonce); + d.setTo(""); + d.setAbi(abi); + d.setBlockLimit(500); + d.setInput(input); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + System.out.println("OFFICIAL_HASH=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d)); + System.out.println("OFFICIAL_TARS=" + TransactionStructBuilderJniObj.encodeTransactionDataStruct(d)); + } +} diff --git a/tools/fisco-realnode/jni/Mini.java b/tools/fisco-realnode/jni/Mini.java new file mode 100644 index 0000000..db043e2 --- /dev/null +++ b/tools/fisco-realnode/jni/Mini.java @@ -0,0 +1,17 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +public class Mini { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); d.setChainId("chain0"); d.setGroupId("group0"); + d.setNonce("abc"); d.setTo(""); d.setAbi("{\"a\":1}"); d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); d.setValue("0x0"); d.setGasPrice("0x0"); + d.setGasLimit(30000000); d.setMaxFeePerGas("0x0"); d.setMaxPriorityFeePerGas("0x0"); + System.out.println("H=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d)); + System.out.println("T=" + TransactionStructBuilderJniObj.encodeTransactionDataStruct(d)); + } +} diff --git a/tools/fisco-realnode/jni/OffReal.java b/tools/fisco-realnode/jni/OffReal.java new file mode 100644 index 0000000..e1c50a6 --- /dev/null +++ b/tools/fisco-realnode/jni/OffReal.java @@ -0,0 +1,60 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.keypair.KeyPairJniObj; +import java.nio.file.*; + +/** + * 官方 SDK 正确用法的最小复现。 + * 严格照抄 DefaultTransactionManager.createTransactionData 的调用序列: + * 1) calcTransactionDataStructHash(cryptoType, data) + * 2) signTransactionDataHash(jniKeyPair, hash) + * 3) createEncodedTransaction(data, signature, hash, attribute, extraData) + */ +public class OffReal { + static final int SM = 0; + + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String abi = new String(Files.readAllBytes(Paths.get(args[0])), "utf-8"); + byte[] input = Files.readAllBytes(Paths.get(args[1])); + String nonce = args[2]; + String privHex = args[3]; + long gasLimit = Long.parseLong(args[4]); + int attribute = Integer.parseInt(args[5]); + + // 用真实私钥建 JNI 密钥对 + byte[] priv = new byte[32]; + for (int i = 0; i < 32; i++) priv[i] = (byte) Integer.parseInt(privHex.substring(i*2, i*2+2), 16); + long kp = KeyPairJniObj.createJniKeyPair(SM, priv); + System.out.println("JNI_PUB=" + KeyPairJniObj.getJniKeyPairPubKey(kp)); + + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce(nonce); + d.setTo(""); + d.setAbi(abi); + d.setBlockLimit(500); + d.setInput(input); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + + String hash = TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d); + System.out.println("OFFICIAL_HASH=" + hash); + + String signature = TransactionBuilderJniObj.signTransactionDataHash(kp, hash); + System.out.println("OFFICIAL_SIG=" + signature); + + String tx = TransactionStructBuilderJniObj.createEncodedTransaction( + d, signature, hash.substring(2), attribute, ""); + System.out.println("OFFICIAL_TX=" + tx); + + KeyPairJniObj.destroyJniKeyPair(kp); + } +} diff --git a/tools/fisco-realnode/jni/OfficialTx.java b/tools/fisco-realnode/jni/OfficialTx.java new file mode 100644 index 0000000..40962a3 --- /dev/null +++ b/tools/fisco-realnode/jni/OfficialTx.java @@ -0,0 +1,37 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import java.nio.file.*; + +public class OfficialTx { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String abi = new String(Files.readAllBytes(Paths.get(args[0])), "utf-8"); + byte[] input = Files.readAllBytes(Paths.get(args[1])); + String nonce = args[2]; + String keyHex = args[3]; + long gasLimit = Long.parseLong(args[4]); + + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce(nonce); + d.setTo(""); + d.setAbi(abi); + d.setBlockLimit(500); + d.setInput(input); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + System.out.println("OFFICIAL_HASH=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d)); + String hash = TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d); + // createEncodedTransaction(data, keyHex, dataHash, attribute, extraData) + String tx = TransactionStructBuilderJniObj.createEncodedTransaction( + d, keyHex, hash.substring(2), 1, ""); + System.out.println("OFFICIAL_TX=" + tx); + } +} diff --git a/tools/fisco-realnode/jni/OfficialTx2.java b/tools/fisco-realnode/jni/OfficialTx2.java new file mode 100644 index 0000000..dc4f458 --- /dev/null +++ b/tools/fisco-realnode/jni/OfficialTx2.java @@ -0,0 +1,50 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import org.fisco.bcos.sdk.jni.utilities.tx.TxPair; +import java.nio.file.*; + +public class OfficialTx2 { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String abi = new String(Files.readAllBytes(Paths.get(args[0])), "utf-8"); + byte[] input = Files.readAllBytes(Paths.get(args[1])); + String nonce = args[2]; + String keyHex = args[3]; + long gasLimit = Long.parseLong(args[4]); + + // 官方 SDK 的做法:先用 StructBuilder 编码 TransactionData 得到 hex, + // 再用 createTransactionDataWithJson / createSignedTransaction 组装。 + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce(nonce); + d.setTo(""); + d.setAbi(abi); + d.setBlockLimit(500); + d.setInput(input); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + String tars = TransactionStructBuilderJniObj.encodeTransactionDataStruct(d); + System.out.println("TARS=" + tars); + System.out.println("STRUCT_HASH=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d)); + + // createTransactionDataWithJson 需要 json,不是 tars。用 encodeTransactionDataStructToJson + String json = TransactionStructBuilderJniObj.encodeTransactionDataStructToJson(d); + System.out.println("JSON=" + json.substring(0, Math.min(300, json.length()))); + + long ptr = TransactionBuilderJniObj.createTransactionDataWithJson(json); + System.out.println("BUILDER_HASH=" + TransactionBuilderJniObj.calcTransactionDataHash(SM, ptr)); + TxPair pair = TransactionBuilderJniObj.createSignedTransaction( + ptr, keyHex, "", "", "", "", 0, 0, ""); + System.out.println("SIGNED_TX=" + pair.getSignedTx()); + System.out.println("TX_HASH=" + pair.getTxHash()); + TransactionBuilderJniObj.destroyTransactionData(ptr); + } +} diff --git a/tools/fisco-realnode/jni/Oracle.java b/tools/fisco-realnode/jni/Oracle.java new file mode 100644 index 0000000..792fbb9 --- /dev/null +++ b/tools/fisco-realnode/jni/Oracle.java @@ -0,0 +1,105 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.Transaction; +import org.fisco.bcos.sdk.jni.utilities.tx.TxPair; +import org.fisco.bcos.sdk.jni.utilities.signature.SignatureJniObj; + +/** + * 官方 bcos-sdk-jni 地面真值对拍。 + * + * 用法: + * java -cp bcos-sdk-jni.jar Oracle hash + * java -cp bcos-sdk-jni.jar Oracle sign + */ +public class Oracle { + // CryptoType: 0 = SM3/国密 (见 sdk 的 CryptoType) + static final int SM = 0; + + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + String mode = args[0]; + String jsonPath = args[1]; + String text = new String(java.nio.file.Files.readAllBytes( + java.nio.file.Paths.get(jsonPath)), "utf-8"); + + // 极简 JSON 字段读取(避免依赖外部 JSON 库):形如 "key":"value" / "key":123 + String abi = jstr(text, "abi"); + String to = jstr(text, "to"); + String nonce = jstr(text, "nonce"); + String chainId = jstr(text, "chainId"); + String groupId = jstr(text, "groupId"); + String inputHex = jstr(text, "input"); + long blockLimit = jlong(text, "blockLimit"); + long gasLimit = jlong(text, "gasLimit"); + String value = jstr(text, "value"); + String gasPrice = jstr(text, "gasPrice"); + String maxFee = jstr(text, "maxFeePerGas"); + String maxPrio = jstr(text, "maxPriorityFeePerGas"); + int version = (int) jlong(text, "version"); + + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(version); + d.setChainId(chainId); + d.setGroupId(groupId); + d.setNonce(nonce); + d.setTo(to); + d.setAbi(abi); + d.setBlockLimit(blockLimit); + d.setInput(fromHex(inputHex)); + d.setValue(value); + d.setGasPrice(gasPrice); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas(maxFee); + d.setMaxPriorityFeePerGas(maxPrio); + + String hash = TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, d); + System.out.println("OFFICIAL_HASH=" + hash); + + String encData = TransactionStructBuilderJniObj.encodeTransactionDataStruct(d); + System.out.println("OFFICIAL_TARS=" + encData); + + if (mode.equals("sign")) { + String keyHex = args[2]; + String encodedTx = TransactionStructBuilderJniObj.createEncodedTransaction( + d, keyHex, "", 1, ""); + System.out.println("OFFICIAL_TX=" + encodedTx); + } + } + + static byte[] fromHex(String h) { + if (h == null) return new byte[0]; + h = h.startsWith("0x") ? h.substring(2) : h; + int n = h.length() / 2; + byte[] out = new byte[n]; + for (int i = 0; i < n; i++) { + out[i] = (byte) Integer.parseInt(h.substring(i * 2, i * 2 + 2), 16); + } + return out; + } + + static String jstr(String text, String key) { + String pat = "\"" + key + "\""; + int i = text.indexOf(pat); + if (i < 0) return ""; + int c = text.indexOf(':', i); + int q = text.indexOf('"', c + 1); + if (q < 0) return ""; + int e = text.indexOf('"', q + 1); + if (e < 0) return ""; + return text.substring(q + 1, e); + } + + static long jlong(String text, String key) { + String pat = "\"" + key + "\""; + int i = text.indexOf(pat); + if (i < 0) return 0; + int c = text.indexOf(':', i); + int s = c + 1; + while (s < text.length() && Character.isWhitespace(text.charAt(s))) s++; + int e = s; + while (e < text.length() && (Character.isDigit(text.charAt(e)) || text.charAt(e) == '-')) e++; + return Long.parseLong(text.substring(s, e)); + } +} diff --git a/tools/fisco-realnode/jni/Pos.java b/tools/fisco-realnode/jni/Pos.java new file mode 100644 index 0000000..cd09358 --- /dev/null +++ b/tools/fisco-realnode/jni/Pos.java @@ -0,0 +1,31 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +public class Pos { + static final int SM = 0; + static TransactionDataV1 mk() { + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); d.setChainId("chain0"); d.setGroupId("group0"); + d.setNonce("abc"); d.setTo(""); d.setAbi("{\"a\":1}"); d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); d.setValue("0x0"); d.setGasPrice("0x0"); + d.setGasLimit(30000000); d.setMaxFeePerGas("0x0"); d.setMaxPriorityFeePerGas("0x0"); + return d; + } + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + System.out.println("BASE=" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, mk())); + // 把 to 设成 40 字节,看 hash 变化 —— 用于定位字段偏移 + TransactionDataV1 t = mk(); t.setTo("0x0000000000000000000000000000000000000001"); + System.out.println("TO =" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, t)); + // abi 设成不同长度 + TransactionDataV1 a = mk(); a.setAbi("{\"a\":2}"); + System.out.println("ABI2 =" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, a)); + // input 变长 + TransactionDataV1 i = mk(); i.setInput(new byte[]{1,2,3,4,5}); + System.out.println("IN5 =" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, i)); + // nonce 变长 + TransactionDataV1 n = mk(); n.setNonce("abcdef"); + System.out.println("N6 =" + TransactionStructBuilderJniObj.calcTransactionDataStructHash(SM, n)); + } +} diff --git a/tools/fisco-realnode/jni/Probe.java b/tools/fisco-realnode/jni/Probe.java new file mode 100644 index 0000000..5b35477 --- /dev/null +++ b/tools/fisco-realnode/jni/Probe.java @@ -0,0 +1,27 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +public class Probe { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + long gasLimit = Long.parseLong(args[0]); + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce("abc"); + d.setTo(""); + d.setAbi("{\"a\":1}"); + d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(gasLimit); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + String enc = TransactionStructBuilderJniObj.encodeTransactionDataStruct(d); + System.out.println("TARS=" + enc); + } +} diff --git a/tools/fisco-realnode/jni/Probe2.java b/tools/fisco-realnode/jni/Probe2.java new file mode 100644 index 0000000..ef65c9d --- /dev/null +++ b/tools/fisco-realnode/jni/Probe2.java @@ -0,0 +1,28 @@ +import org.fisco.bcos.sdk.jni.common.JniLibLoader; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionStructBuilderJniObj; +import org.fisco.bcos.sdk.jni.utilities.tx.TransactionDataV1; + +public class Probe2 { + static final int SM = 0; + public static void main(String[] args) throws Exception { + JniLibLoader.loadJniLibrary(); + int n = Integer.parseInt(args[0]); + StringBuilder sb = new StringBuilder(); + for (int i = 0; i < n; i++) sb.append((char) ('a' + (i % 26))); + TransactionDataV1 d = new TransactionDataV1(); + d.setVersion(1); + d.setChainId("chain0"); + d.setGroupId("group0"); + d.setNonce("abc"); + d.setTo(""); + d.setAbi(sb.toString()); + d.setBlockLimit(500); + d.setInput(new byte[]{1,2,3}); + d.setValue("0x0"); + d.setGasPrice("0x0"); + d.setGasLimit(30000000); + d.setMaxFeePerGas("0x0"); + d.setMaxPriorityFeePerGas("0x0"); + System.out.println("TARS=" + TransactionStructBuilderJniObj.encodeTransactionDataStruct(d)); + } +} diff --git a/tools/fisco-realnode/tars/analyze_tars.py b/tools/fisco-realnode/tars/analyze_tars.py new file mode 100644 index 0000000..962a137 --- /dev/null +++ b/tools/fisco-realnode/tars/analyze_tars.py @@ -0,0 +1,78 @@ +#!/usr/bin/env python3 +"""解析 FISCO TARS 字节布局(从官方 SDK oracle 样本反推规则)。""" +import json, sys + +SAMPLES = [] + +def hexdump(b, width=16): + out = [] + for i in range(0, len(b), width): + chunk = b[i:i+width] + h = ' '.join(f'{x:02x}' for x in chunk) + a = ''.join(chr(x) if 32 <= x < 127 else '.' for x in chunk) + out.append(f'{i:04x} {h:<{width*3}} |{a}|') + return '\n'.join(out) + +def parse_tars(buf): + """TARS/JCE 二进制:struct 头 = 4 字节 (tag<<4 | type) BE + 4 字节长度 BE。 + type: 0=BYTE,1=SHORT,2=INT,3=LONG,4=FLOAT,5=DOUBLE,6=STRING,7=MAP,8=LIST,9=STRUCT_BEGIN,10=STRUCT_END,11=ZERO_TAG,12=SIMPLE_LIST + """ + pos = 0 + fields = [] + def read_u32(p): + return int.from_bytes(buf[p:p+4], 'big') + while pos + 4 <= len(buf): + head = read_u32(pos) + tag = head >> 4 + typ = head & 0xF + if typ == 11: # ZERO_TAG: 无数据 + fields.append((tag, typ, 0, None)) + pos += 4 + continue + if typ in (0,): # BYTE + fields.append((tag, typ, 1, buf[pos+4])) + pos += 5 + elif typ in (1, 2): # SHORT / INT + fields.append((tag, typ, 4, int.from_bytes(buf[pos+4:pos+8], 'big'))) + pos += 8 + elif typ in (3,): # LONG + fields.append((tag, typ, 8, int.from_bytes(buf[pos+4:pos+12], 'big'))) + pos += 12 + elif typ in (4, 5): # FLOAT / DOUBLE + n = 4 if typ == 4 else 8 + fields.append((tag, typ, 4+n, buf[pos+4:pos+4+n].hex())) + pos += 4 + n + elif typ in (6,): # STRING + n = read_u32(pos+4) + fields.append((tag, typ, 4+n, buf[pos+8:pos+8+n].decode('utf8', 'replace'))) + pos += 8 + n + elif typ in (12,): # SIMPLE_LIST + n = read_u32(pos+4) + fields.append((tag, typ, 4+n, buf[pos+8:pos+8+n].hex())) + pos += 8 + n + elif typ == 11: + pos += 4 + else: + fields.append((tag, typ, -1, f'UNSUPPORTED type={typ} at {pos}')) + break + return fields + +TNAMES = {0:'BYTE',1:'SHORT',2:'INT',3:'LONG',4:'FLOAT',5:'DOUBLE',6:'STRING', + 7:'MAP',8:'LIST',9:'STRUCT_BEGIN',10:'STRUCT_END',11:'ZERO',12:'SIMPLE_LIST'} + +for line in open(sys.argv[1]): + line = line.strip() + if not line.startswith('{'): + continue + o = json.loads(line) + if o.get('kind') == 'SIGNED': + continue + b = bytes.fromhex(o['enc']) + print(f"===== {o['kind']} enc={len(b)}B hash={o['hash']}") + print(hexdump(b)) + try: + for tag, typ, n, val in parse_tars(b): + print(f" tag={tag:<3} type={TNAMES.get(typ,typ):<12} len={n:<5} val={val!r}") + except Exception as e: + print(" parse error:", e) + print() diff --git a/tools/fisco-realnode/tars/decode_tars.py b/tools/fisco-realnode/tars/decode_tars.py new file mode 100644 index 0000000..91802a9 --- /dev/null +++ b/tools/fisco-realnode/tars/decode_tars.py @@ -0,0 +1,114 @@ +#!/usr/bin/env python3 +"""按 TARS/JCE 规则解码 FISCO TransactionData 字节,并对照 oracle 样本。""" +import json, sys + +# TARS 类型枚举(TarsStruct.cs 权威) +BYTE, SHORT, INT, LONG, FLOAT, DOUBLE = 0, 1, 2, 3, 4, 5 +STRING1, STRING4, MAP, LIST = 6, 7, 8, 9 +STRUCT_BEGIN, STRUCT_END, ZERO_TAG, SIMPLE_LIST = 10, 11, 12, 13 +TN = {0:'BYTE',1:'SHORT',2:'INT',3:'LONG',4:'FLOAT',5:'DOUBLE',6:'STRING1',7:'STRING4', + 8:'MAP',9:'LIST',10:'STRUCT_BEGIN',11:'STRUCT_END',12:'ZERO',13:'SIMPLE_LIST'} + +FIELDS = { + 1: ('version','int'), 2: ('chainID','string'), 3: ('groupID','string'), + 4: ('blockLimit','long'), 5: ('nonce','string'), 6: ('to','string'), + 7: ('input','bytes'), 8: ('abi','string'), 9: ('value','string'), + 10: ('gasPrice','string'), 11: ('gasLimit','long'), + 12: ('maxFeePerGas','string'), 13: ('maxPriorityFeePerGas','string'), + 14: ('extension','bytes'), +} + +class R: + def __init__(self, b): self.b = b; self.p = 0 + def u8(self): + v = self.b[self.p]; self.p += 1; return v + def u16(self): + v = int.from_bytes(self.b[self.p:self.p+2],'big'); self.p += 2; return v + def u32(self): + v = int.from_bytes(self.b[self.p:self.p+4],'big'); self.p += 4; return v + def raw(self, n): + v = self.b[self.p:self.p+n]; self.p += n; return v + +def read_head(r): + """返回 (tag, type)。tag<15: 1 字节 (tag<<4)|type; 15<=tag<256: 0xF0|type + 1 字节 tag。""" + h = r.u8() + typ = h & 0xF + tag = h >> 4 + if tag == 15: + tag = r.u8() + return tag, typ + +def read_value(r, typ): + if typ == BYTE: + v = r.u8(); return v + if typ == ZERO_TAG: + return 0 + if typ == SHORT: + return r.u16() + if typ == INT: + return r.u32() + if typ == LONG: + return int.from_bytes(r.raw(8),'big') + if typ == FLOAT: + return r.raw(4).hex() + if typ == DOUBLE: + return r.raw(8).hex() + if typ == STRING1: + n = r.u8(); return r.raw(n) + if typ == STRING4: + n = r.u32(); return r.raw(n) + if typ == SIMPLE_LIST: + # head(type,0) then Write(len,0) + t2, ty2 = read_head(r) # 元素类型头 (tag=0) + n = read_int_sized(r, ty2) + return ('list', ty2, r.raw(n)) + raise ValueError(f'unhandled type {typ}') + +def read_int_sized(r, typ): + if typ == BYTE: return r.u8() + if typ == ZERO_TAG: return 0 + if typ == SHORT: return r.u16() + if typ == INT: return r.u32() + if typ == LONG: return int.from_bytes(r.raw(8),'big') + raise ValueError(typ) + +def decode_fields(buf): + r = R(buf) + out = [] + while r.p < len(buf): + tag, typ = read_head(r) + if typ == STRUCT_BEGIN: + out.append((tag,'STRUCT_BEGIN',None)); continue + if typ == STRUCT_END: + out.append((tag,'STRUCT_END',None)); continue + v = read_value(r, typ) + name = FIELDS.get(tag, ('?',''))[0] + out.append((tag, name, v)) + return out + +def show(v): + if isinstance(v, bytes): + try: + s = v.decode('utf8') + if all(32 <= c < 127 or c in (10,13,9) for c in v): + return repr(s) + except Exception: + pass + return 'hex:' + v.hex() + return repr(v) + +for line in open(sys.argv[1]): + line = line.strip() + if not line.startswith('{'): + continue + o = json.loads(line) + if o.get('kind') == 'SIGNED': + continue + b = bytes.fromhex(o['enc']) + print(f"===== {o['kind']} enc={len(b)}B hash={o['hash']}") + try: + for tag, name, v in decode_fields(b): + print(f" tag={tag:<3} {name:<24} {show(v)}") + except Exception as e: + print(" ERR:", e) + print() diff --git a/tools/fisco-realnode/tars/gh_decode.py b/tools/fisco-realnode/tars/gh_decode.py new file mode 100644 index 0000000..ef16fd9 --- /dev/null +++ b/tools/fisco-realnode/tars/gh_decode.py @@ -0,0 +1,7 @@ +import json, base64, sys +d = json.load(open('/tmp/gh_api.json')) +if 'content' not in d: + print("ERR:", d.get('message')) + sys.exit(1) +open(sys.argv[1], 'wb').write(base64.b64decode(d['content'])) +print("OK", sys.argv[1])