All lessons · Developer tooling · Start here · Glossary
ckb-cli needs --skip-check to sign and send transactions with custom locksWorkingFrom one fix
From one fix · Check: right · Checked 2026-11-19
ckb-cli refuses transactions whose inputs or outputs use a lock it cannot classify (for example a custom type script based lock with 1 byte of args). `tx sign-inputs` then signs nothing, reporting `invalid lock script ... args.length` and leaving the signatures map and witness empty, and `tx send` refuses the file. Pass `--skip-check` to both sign-inputs and send; otherwise send fails with -2 ERROR_ENCODING because the secp lock reads an empty witness. Since this disables ckb-cli's own checks, run your own verifier on the signed file between sign-inputs and send.
Why it matters: Without --skip-check on sign-inputs, ckb-cli leaves the signatures map and witness empty, and the node rejects the transaction with -2 ERROR_ENCODING when the secp lock reads an unsigned witness.
Joined with toastmanAu/daowow@6f4cb48641.
Pattern
--from-account ${OPERATOR_LOCK_ARG} --add-signatures --skip-checkTaken from the commit, shortened.
- Concepts
- Witnesses and signatures, Transaction building and fees
- Evidence
- From one fix: from one project, checked against its commit
- First seen
- 2026-09-26
- Last changed
- 2026-09-26
- Last checked
- 2026-11-19
- Check against the commit
- right: the lesson follows from its commit and still holds in the code today
Sources (2)
- 2026-09-26 · toastmanAu/daowow · more from this project
- 2026-09-25 · toastmanAu/daowow · more from this project
More about Developer tooling
- ckb-cli deploy info file layout for offline multisig signing
- ckb-cli tx init overwrites an existing tx file with an empty skeleton
- ckb-cli tx sign-inputs stores signatures in the file's signatures map, not witness 0
Do you maintain a project this lesson came from? Confirm or correct it
Cite this lesson
LusoCryptoLabs, "ckb-cli needs --skip-check to sign and send transactions with custom locks", CKB lessons, https://pulse.lusocryptolabs.com/learned/tooling/ckb-cli-needs-skip-check-to-sign-and-send-transactions-with, CC BY 4.0, last changed 2026-09-26.