# XRPL (XRP Ledger)

## Sign Transaction

### **Supported Transaction Types**

The following transaction types are supported on D'CENT Biometric wallet.

|   Transaction Type   | Supported |
| :------------------: | :-------: |
|      AccountSet      |     O     |
|     AccountDelete    |     O     |
|      CheckCancel     |     O     |
|       CheckCash      |     O     |
|      CheckCreate     |     O     |
|    DepositPreauth    |     O     |
|     EscrowCancel     |     O     |
|     EscrowCreate     |     O     |
|     EscrowFinish     |     O     |
|  NFTokenAcceptOffer  |     X     |
|      NFTokenBurn     |     X     |
|  NFTokenCancelOffer  |     X     |
|  NFTokenCreateOffer  |     X     |
|      NFTokenMint     |     X     |
|      OfferCancel     |     O     |
|      OfferCreate     |     O     |
|        Payment       |     O     |
|  PaymentChannelClaim |     O     |
| PaymentChannelCreate |     O     |
|  PaymentChannelFund  |     O     |
|     SetRegularKey    |     O     |
|     SignerListSet    |     O     |
|     TicketCreate     |     X     |
|       TrustSet       |     O     |

For your reference, All transaction types for XRPL can be found here.

* <https://xrpl.org/transaction-types.html>

### **getXrpSignedTransaction()**

#### Supported Coin Type

* XRP(Ripple)

#### Parameters :

* transaction: this value conforms JSON format of Transaction Types in [XRP Doc](https://xrpl.org/transaction-formats.html).
* key: key path, wallet sign with that private key with a given key path (BIP32 ex) "m/44'/144'/0'/0/0").

#### Requirements:

* `D'CENT Bridge` version 1.1.4 or higher is required.
* D'CENT Biometric Wallet version 2.4.0. or higher is required.

#### Usage:

```javascript
const transactionJson = {
    "TransactionType": "AccountSet", // or use defined value `dcent.xrpTxType.AccountSet`
    "Account": "rfQrsnD8ywrgSX457qshpBTDru7EDnM2Lb",
    "Fee": "10",
    "Sequence": 34,
    "MessageKey": "02000000000000000000000000415F8315C9948AD91E2CCE5B8583A36DA431FB61",
    "Flags": 2147483648, // if exist then D'Cent check that `tfFullyCanonicalSig` is set?
}

var result
try {
    result = await dcent.getXrpSignedTransaction(transactionJson, "m/44'/144'/0'/0/0");    
} catch (e) {
    console.log(e)
    result = e
}
```

#### Returned response object:

```json
{
    "header": {
        "version": "1.0",
        "response_from": "ripple",
        "status": "success"
    },
    "body": {
        "command": "get_sign",
        "parameter": {
            "sign": "3045022100e81c9e2...8e373e30b8f5e0a33eb094ffc7c8d009ad71fd7581b6b89ef9",
            "pubkey": "02c65f2a496909123973282c47edbd0e760bb44bb0d87ec1b30115b2ce3072c766",
            "accountId": "462a5a061ebe03fb52e5bca443233bcc6d0e9699"
        }
    }
}
```

### Send a Multi-Signed Transaction

* Reference the [XRP Doc](https://xrpl.org/send-a-multi-signed-transaction.html)
* Multi-signing a Transaction
  1. First, prepare by referring to [Set Up Multi-Signing](https://xrpl.org/set-up-multi-signing.html) (You can get address of account using `getAddress()` function.)
  2. Get signature

#### Example

```javascript
// You can use xrp library for encoding
//const api = require('ripple-binary-codec')
//const addrs = require('ripple-address-codec')

const transactionJson = {
    "TransactionType": "Payment",
    "Account": "rfQrsnD8ywrgSX457qshpBTDru7EDnM2Lb",
    "Fee": "30", // normal cost * (1 + N)
    "Sequence": 45,
    "Amount": "1234567",
    "Flags": 2147483648,
    "Destination": "rJZMdVmbqFPi5oMyzGKJhHW9mNHwpiYKpS",
    "SigningPubKey": "", // Must be blank
}

var result
var signer = {}
try {
    // Keypath is SignerEntry's key path
    result = await DcentWebConnector.getXrpSignedTransaction(transactionJson, "m/44'/144'/1'/0/0");
    signer = {
        "Account": "rBV2LGGm5XAc5KbL7hBaPnLnUJ5aTQzVj9", // addrs.encodeAccountID(Buffer.from(result.accountId,'hex'))
        "SigningPubKey": result.pubkey,
        "TxnSignature": result.sign
    }
} catch (e) {
    console.log(e)
    result = e
}
```

For broadcast the sign transaction, you must reconstruct transaction include `TxnSignature` & `SigningPubKey` for normal (single-signature) or `Signers` array for multi-signed-transaction


---

# 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-pc/dcent-web-connector/xrpl-xrp-ledger.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.