> For the complete documentation index, see [llms.txt](https://dev-docs.dcentwallet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev-docs.dcentwallet.com/in-app-browser/xrpl-network.md).

# XRPL network

D'CENT mobile app's in-app browser injects `window.xrpl` as providers. If your dapp is based on XRPL network, you can interact with D'CENT wallet through `window.xrpl` providers.

## Injection Method

When the in-app browser loads a webpage, it must inject the following provider object

```ts
// Injected into window on page load
window.xrpl = {
  getWalletInfo: function () {
    // Return wallet information
  },
  request: function (args) {
    // [IoTrust]
    // 1. Return XRPL account information
    // 2. Switch XRPL networks
    // 3. Handle transaction signing/submission
  },
};

```

### ⚠️ Important Notes 

* **The `window.xrpl` object must be injected before or immediately after the page loads.**
* **The Doppler WebApp can recognize the wallet only if the `window.xrpl` object exists.**
* **It must be injected before the DOM is ready for Doppler to detect it properly.**
* **Both methods (`getWalletInfo` and `request`) are required.**

## Interface Definition

**Required Implementation Methods**

```ts
interface InjectedXRPL {
  getWalletInfo(): WalletInfo | Promise<WalletInfo> | string | Promise<string>;
  request(args: {
    method: string;
    params?: unknown[] | object;
  }): Promise<T>;  // IoTrust
}

interface WalletInfo {
  name: string; // Wallet name
  icon: string; // Base64 image or URL
  version: string; // Version (e.g., "1.0.0") --> Interface version?
  // address: string;  // Removed by [IoTrust]
  chainId: string; // Currently connected chain information [IoTrust] "xrpl:0" | "xrpl:1" | "xrpl:2"
}

```

* **Chain ID definition**

| Chain ID | Network | Endpoint                       |
| -------- | ------- | ------------------------------ |
| `xrpl:0` | Mainnet | wss\://xrplcluster.com         |
| `xrpl:1` | Testnet | wss\://s.altnet.rippletest.net |
| `xrpl:2` | Devnet  | wss\://s.devnet.rippletest.net |

## **Method Details**

### Request Method

* **xrpl\_accounts**

Returns the addresses of the currently connected wallet as an array.

```ts
request({ method: 'xrpl_accounts' })
  .then((accounts) => console.log(accounts))
  .catch((error) => console.error(error));
```

* **xrpl\_switchChain**

Changes the active XRPL chain by specifying a chain ID.

```ts
request({ 
  method: 'xrpl_switchChain', 
  params: [{ chainId: "xrpl:1" }]
})
```

* **xrpl\_signTransaction**

Requests the wallet to sign (and optionally submit) an XRPL transaction.

```ts
request({ 
  method: 'xrpl_signTransaction', 
  params: [{ 
    // ...
  }]
})
  .then((xrplTxResponse) => console.log(xrplTxResponse))
  .catch((error) => console.error(error));
```

### **Request Parameters for `xrpl_signTransaction`**

```ts
interface XRPLRequestParams {
  tx_json: TransactionJSON;
  submit?: boolean; // Default: true
  chainId: string; // "xrpl:0" | "xrpl:1" | "xrpl:2"
  autofill?: boolean; // Automatically fills Fee, Sequence, etc.
}
```

### Transction Types

* **Payment Transaction**

  Used for sending XRP or tokens.

  ```ts
  interface PaymentTransaction {
    TransactionType: "Payment";
    Account: string;       // Sender address
    Destination: string;   // Recipient address
    Amount:
      | string
      | {
          currency: string;  // Token symbol
          issuer: string;    // Token issuer
          value: string;     // Amount
        };
    DestinationTag?: number;
    Memos?: Array<{
      Memo: {
        MemoData: string;    // HEX encoded
      };
    }>;
    Fee?: string;            // Auto-filled if autofill=true
    Sequence?: number;       // Auto-filled if autofill=true
    LastLedgerSequence?: number;
  }
  ```

* **TrustSet Transaction**

  Used for setting a trustline.

  ```ts
  interface TrustSetTransaction {
    TransactionType: "TrustSet";
    Account: string;
    LimitAmount: {
      currency: string;  // 3-letter code (e.g., "USD")
      issuer: string;    // Token issuer
      value: string;     // Limit
    };
    Flags?: number;       // 262144 = NoRipple
  }
  ```

* **OfferCreate Transaction(DEX Order**)

  Used for creating an order on the XRPL decentralized exchange.

  ```ts
  interface OfferCreateTransaction {
    TransactionType: "OfferCreate";
    Account: string;
    TakerGets: string | CurrencyAmount;  // Amount you will receive
    TakerPays: string | CurrencyAmount;  // Amount you will pay
    Flags?: number;
  }
  ```

### Response Format

```ts
interface XRPLResponse {
  tx_json: SignedTransaction;
  hash?: string; // Present only when submit=true
}

interface SignedTransaction extends TransactionJSON {
  SigningPubKey: string;
  TxnSignature: string;
  hash?: string;
  date?: number;
  ledger_index?: number;
}
```