decodescript

decodescript takes a hex-encoded Bitcoin script and expands it into human-readable form: the disassembled asm, the inferred script type (such as pubkeyhash, scripthash, or witness_v0_keyhash), the resulting address, and the p2sh address you would get by wrapping the script in pay-to-script-hash. On newer Bitcoin Core it also reports a segwit object describing the script's witness form. It decodes the script bytes directly without spending any BTC or querying the chain. Send the request to the Bitcoin JSON-RPC endpoint at https://bitcoin.therpc.io/YOUR_API_KEY.

Use cases

• Resolve a raw scriptPubKey or redeemScript into its address and script type so you can label outputs in an explorer or accounting view.
• Inspect a custom or multisig script before you commit it to a transaction, checking the disassembled ASM matches your intent.
• Read the p2sh address that wraps a given redeem script, which is what you fund when spending into a pay-to-script-hash output.

Parameters

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "decodescript",
8  "params": [
9    "76a914000000000000000000000000000000000000000088ac"
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• The response shape changed across Bitcoin Core versions: newer releases return a single address field, while older ones returned an addresses[] array. Parse defensively and handle both so your client works regardless of which node version answers.

Supported networks

• Mainnet
• Testnet

See also

• decoderawtransaction
• validateaddress
• gettxout