2015-07-13 18:22:55 +02:00
Shared Libraries
================
2018-01-20 19:35:31 +01:00
## dogecoinconsensus
2015-07-13 18:22:55 +02:00
2018-01-20 19:35:31 +01:00
The purpose of this library is to make the verification functionality that is critical to Dogecoin's consensus available to other applications, e.g. to language bindings.
2015-07-13 18:22:55 +02:00
### API
2018-01-20 19:35:31 +01:00
The interface is defined in the C header `dogecoinconsensus.h` located in `src/script/dogecoinconsensus.h` .
2015-07-13 18:22:55 +02:00
#### Version
2018-01-20 19:35:31 +01:00
`dogecoinconsensus_version` returns an `unsigned int` with the API version *(currently at an experimental `0`)* .
2015-07-13 18:22:55 +02:00
#### Script Validation
2018-01-20 19:35:31 +01:00
`dogecoinconsensus_verify_script` returns an `int` with the status of the verification. It will be `1` if the input script correctly spends the previous output `scriptPubKey` .
2015-07-13 18:22:55 +02:00
##### Parameters
- `const unsigned char *scriptPubKey` - The previous output script that encumbers spending.
- `unsigned int scriptPubKeyLen` - The number of bytes for the `scriptPubKey` .
- `const unsigned char *txTo` - The transaction with the input that is spending the previous output.
- `unsigned int txToLen` - The number of bytes for the `txTo` .
- `unsigned int nIn` - The index of the input in `txTo` that spends the `scriptPubKey` .
- `unsigned int flags` - The script validation flags *(see below)* .
2018-01-20 19:35:31 +01:00
- `dogecoinconsensus_error* err` - Will have the error/success code for the operation *(see below)* .
2015-07-13 18:22:55 +02:00
##### Script Flags
2018-01-20 19:35:31 +01:00
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_NONE`
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_P2SH` - Evaluate P2SH ([BIP16](https://github.com/bitcoin/bips/blob/master/bip-0016.mediawiki)) subscripts
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_DERSIG` - Enforce strict DER ([BIP66](https://github.com/bitcoin/bips/blob/master/bip-0066.mediawiki)) compliance
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_NULLDUMMY` - Enforce NULLDUMMY ([BIP147](https://github.com/bitcoin/bips/blob/master/bip-0147.mediawiki))
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_CHECKLOCKTIMEVERIFY` - Enable CHECKLOCKTIMEVERIFY ([BIP65](https://github.com/bitcoin/bips/blob/master/bip-0065.mediawiki))
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_CHECKSEQUENCEVERIFY` - Enable CHECKSEQUENCEVERIFY ([BIP112](https://github.com/bitcoin/bips/blob/master/bip-0112.mediawiki))
- `dogecoinconsensus_SCRIPT_FLAGS_VERIFY_WITNESS` - Enable WITNESS ([BIP141](https://github.com/bitcoin/bips/blob/master/bip-0141.mediawiki))
2015-07-13 18:22:55 +02:00
##### Errors
2018-01-20 19:35:31 +01:00
- `dogecoinconsensus_ERR_OK` - No errors with input parameters *(see the return value of `dogecoinconsensus_verify_script` for the verification status)*
- `dogecoinconsensus_ERR_TX_INDEX` - An invalid index for `txTo`
- `dogecoinconsensus_ERR_TX_SIZE_MISMATCH` - `txToLen` did not match with the size of `txTo`
- `dogecoinconsensus_ERR_DESERIALIZE` - An error deserializing `txTo`
- `dogecoinconsensus_ERR_AMOUNT_REQUIRED` - Input amount is required if WITNESS is used
2015-07-13 18:22:55 +02:00
### Example Implementations
2015-07-15 14:40:18 +02:00
- [NBitcoin ](https://github.com/NicolasDorier/NBitcoin/blob/master/NBitcoin/Script.cs#L814 ) (.NET Bindings)
2018-01-20 19:35:31 +01:00
- [node-libdogecoinconsensus ](https://github.com/bitpay/node-libdogecoinconsensus ) (Node.js Bindings)
- [java-libdogecoinconsensus ](https://github.com/dexX7/java-libdogecoinconsensus ) (Java Bindings)
- [dogecoinconsensus-php ](https://github.com/Bit-Wasp/dogecoinconsensus-php ) (PHP Bindings)