# Bitcoin

## **getBitcoinSignedTransaction**

The D'CENT Android SDK provides functions for signing transaction of coins.

**This function for :** 

* `.BITCOIN` - bitcoin (BTC)
* `.BITCOIN_SV` - bitcoin sv (BSV)
* `.BTC_SEGWIT` - bitcoin segwit (BTC)
* `.MONACOIN` - monacoin (MONA)
* `.LITECOIN` - litecoin (LTC)
* `.LTC_SEGWIT` - litecoin segwit (LTC)
* `.ZCASH` - zcash (ZEC)
* `.HORIZEN` - horizen (ZEN)
* `.BITCOINCASH` - bitcoin cash (BCH)
* `.DOGECOIN` - dogecoin (DOGE)
* `.BCH_ABC` - bitcoin cash abc (BCHA)
* `.ECASH` - ecash (XEC)
* `.DASH` - dash (DASH)
* `.BITCOIN_GOLD` - bitcoin gold (BTG)
* `.DIGIBYTE` - digibyte (DGB)
* `.DGB_SEGWIT` - digibyte segwit (DGB)
* `.RAVENCOIN` - ravencoin (RVN)
* `.BTC_TESTNET` - bitcoin testnet (BTCt)
* `.BTC_SEGWIT_TESTNET` - bitcoin segwit testnet (BTCt)
* `.MONA_TESTNET` - monacoin testnet (MONAt)
* `.LITE_TESTNET` - litecoin testnet (tLTC)
* `.LTC_SEGWIT_TESTNET` - litecoin segwit testnet (tLTC)
* `.ZCASH_TESTNET` - zcash testnet (TAZ)
* `.BCH_TESTNET` - bitcoin cash testnet (tBCH)
* `.DASH_TESTNET` - dash testnet (tDASH)
* `.BTG_TESTNET` - bitcoin gold testnet (tBTG)
* `.DIGIBYTE_TESTNET` - digibyte testnet (tDGB)
* `.DGB_SEGWIT_TESTNET` - digibyte segwit testnet (tDGB)
* `.RVN_TESTNET` - ravencoin testnet (tRVN)

### **Parameters**

* coinType: bitcoin networks coin type
* bitcoinTransaction: ([BitcoinTransation](#class-bitcointransaction))bitcoin transaction parameter

#### **class BitCoinTransaction**

This class to be used for bitcoin transaction.

<table><thead><tr><th width="147.33333333333331">Name</th><th width="288">Type</th><th>Description</th></tr></thead><tbody><tr><td>version</td><td><code>UInt32</code></td><td>version of bitcoin transaction. Currently 1<br>- <code>BCH</code> /<code>Dash</code>/<code>BTG</code> :  <code>2</code><br>- <code>ZCASH</code> : <code>4</code></td></tr><tr><td>input</td><td><a href="#class-unspenttransactionoutput"><code>UnspentTransactionOutput</code></a></td><td>previous transaction output information to be used</td></tr><tr><td>output</td><td><a href="#class-transactionoutput"><code>TransactionOutput</code></a></td><td>coin spending information</td></tr><tr><td>locktime</td><td><code>UInt32</code></td><td>locktime for this transaction</td></tr><tr><td>optionParam</td><td><code>String</code></td><td>(optional)option parameter for this transaction in case <code>ZCASH</code></td></tr></tbody></table>

#### **class UnspentTransactionOutput**

The class for previous transaction output information to be used for bitcoin network transaction.

<table><thead><tr><th width="115.33333333333331">Name</th><th width="145">Type</th><th>Description</th></tr></thead><tbody><tr><td>prev_tx</td><td><code>String</code></td><td>full of previous transaction data</td></tr><tr><td>utxo_idx</td><td><code>UInt32</code></td><td>index of previous transaction output to be sent</td></tr><tr><td>type</td><td><a href="#enum-btctxtype"><code>BtcTxtype</code></a></td><td>bitcoin transaction type for this UTXO</td></tr><tr><td>key</td><td><code>String</code></td><td>BIP44 key path for unlocking UTX</td></tr></tbody></table>

#### class TransactionOutput

The class for coin spending information of Bitcoin network Transaction

<table><thead><tr><th width="105.33333333333331">Name</th><th width="152">Type</th><th>Description</th></tr></thead><tbody><tr><td>value</td><td><code>UInt64</code></td><td>amount of coin to spend. Satoshi unit.</td></tr><tr><td>to</td><td><code>[String]</code></td><td>if <code>type</code> is <code>p2pkh</code> or <code>p2sh</code>, Base58Check encoded address of the receiver.<br>The value of the field may follow the rule of version prefix.(<code>BITCOIN_BASE58CHECK</code>)<br>if the type is <code>p2pk</code> , Base58Check encoded non-compressed public key without version prefix.<br>if the type is <code>multisig</code> , Base58Check encoded non-compressed public key (without version prefix) list.<br>if the type is <code>change</code> , BIP44 formatted PATH to get change address. In this case, the transaction type is assumed as <code>p2pkh</code></td></tr><tr><td>type</td><td><a href="#enum-btctxtype"><code>BtcTxtype</code></a></td><td>bitcoin network transaction type or this field can indicate output as a <code>change</code></td></tr></tbody></table>

#### **enum BtcTxtype**

* `p2Pkh`: pay to public key hash
* `p2Pk`: pay to public key
* `p2Sh`: pay to script hash
* `change`: indicate output as a change

### **Returns**

* result: (Bool) `true` if successful, `false` if error occurred
* txData: signed transaction

**Example**

```swift
let transactionOutput : TransactionOutput = TransactionOutput()
let unspentTransactionOutput : UnspentTransactionOutput = UnspentTransactionOutput()
var unspenttxOut : [UnspentTransactionOutput] = [UnspentTransactionOutput()]
  
unspenttxOut.append(unspentTransactionOutput)
  
let BtcTxData : BitcoinTransaction = BitcoinTransaction(version: 0, input: unspenttxOut, output: [transactionOutput], locktime: 0)
  
// test data
BtcTxData.version = 1
BtcTxData.input[1].prev_tx = "0100000001001355540aa694ddde95548de76168666f33d8fad420fab6c554180846676df1000000006a47304402205089f4b1bdb1f96786f4750af3c16a23c73b60de0fe3cfec0da906a181eea645022078047d56dded692477d35052e9179ac71f79c6ec6b5f49941056c03663255be9012103ac2a317f777d63a6bac857ba07e30920a0f2ebd3f99f15a92b8d295791a971f6ffffffff0230750000000000001976a914848d227771119767a8c08ee0b105633cbff2d6b688ac77180000000000001976a9145dadfc1f7c4548336912f23311b424310d6533c088ac00000000"
BtcTxData.input[1].type = BtcTxtype.p2Pkh
BtcTxData.input[1].utxo_idx = 1
BtcTxData.input[1].key = "m/44'/0'/0'/1/4"
BtcTxData.input[0].prev_tx = "0100000001076524b52baf87fe521e5b8a910fadd91c944f952520677def057e346a96380d000000006a473044022045a30be5dc493c36a3a55fd522b4aa2d795f49bb8b61507e1fca1c15819142c1022010846e11893840e521b277f31c1ca835d352fb582633e5ac95106d0ed52d1654012103b72bcab65c4ea43f4b700220729bdde9638c3bb70cc66b7a0de30738e8241382ffffffff0210270000000000001976a9149189ffd2039f1824de14562e592dc4bccaa57d6e88ac6a290000000000001976a9147046ed0f139552ada485f925e74f6576016fc55e88ac00000000"
BtcTxData.input[0].type = BtcTxtype.p2Pkh
BtcTxData.input[0].utxo_idx = 0
BtcTxData.input[0].key = "m/44'/0'/0'/0/2"
BtcTxData.output[0].to[0] = "1K8EfJgWR16Wo3Ejb3AtMk2mfoeAjmMtDL"
BtcTxData.output[0].type = BtcTxtype.p2Pkh
BtcTxData.output[0].value = 10000
BtcTxData.locktime = 0
  
DcentMgr.getBitcoinSignedTransaction(coinType: .BITCOIN, bitcoinTransaction: BtcTxData){ (result, txData) in
    if result == false {
        print("FAIL !!!")
    }else{
        print(txData)
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev-docs.dcentwallet.com/dcent-biometric-wallet-for-mobile/dcent-biometric-sdk-ios/bitcoin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.