xrpl-dev-portal/content/tutorials/get-started/get-started.md

html, parent, blurb, filters, labels

html	parent	blurb	filters	labels
get-started.html	tutorials.html	Get up and running with some of the resources you'll use to work with the XRP Ledger.	js_editor	Development

Get Started

The XRP Ledger is always online and entirely public. Anyone can access it directly from a web browser with source code like what's on this page.

The following example gets the latest ledger version and a list of transactions that were newly-validated in that ledger version, using the [ledger method][]. Try running it as-is, or change the code and see what happens.

Tip: If you can, open your browser's Developer Tools by pressing F12. The "Console" tab provides a native JavaScript console and can give insight into what code is running on any webpage.

{{currentpage.ripple_lib_tag}}

async function main() {
  const api = new xrpl.Client('wss://xrplcluster.com');
  await api.connect();

  let response = await api.request({
    "command": "ledger",
    "ledger_index": "validated"
    "transactions": true
  });
  console.log(response);
}
main()

async function main() {
  const api = new xrpl.Client('wss://s.altnet.rippletest.net/');
  await api.connect();

  let response = await api.request({
    "command": "ledger",
    "ledger_index": "validated"
    "transactions": true
  });
  console.log(response);
}
main()

async function main() {
  const api = new xrpl.Client('wss://xrplcluster.com');
  await api.connect();

  let response = await api.request({
    "command": "ledger",
    "ledger_index": "validated"
    "transactions": true
  });

  let tx_id = response.result.transactions[0];
  let response2 = await api.request({
    "command": "tx",
    "transaction": tx_id
  });
  console.log(response2);
}
main()

async function main() {
  const api = new xrpl.Client('wss://xrplcluster.com');
  await api.connect();

  let response = await api.request({
    "command": "ledger",
    "ledger_index": "validated"
    "transactions": true
  });
  console.log('Total XRP: '+xrpl.dropsToXrp(response.result.ledger.total_coins));
}
main()

Suggestions

Try editing the code above to do something different:

• Connect to the Testnet public server at wss://s.altnet.rippletest.net/ instead. Answer >
• Look up the details of a transaction using the getTransaction() method. For the id, use one of the transactionHashes from the getLedger() response! Answer >
• Convert the totalDrops from the response to decimal XRP. Answer >

Setup Steps

This page has the necessary prerequisites already loaded, but you can access the XRP Ledger from any webpage if you load xrpl.js in that page's HTML. For example:

<script src="https://unpkg.com/ripple-lib@1.10.0/build/ripple-latest-min.js"></script>

Further Reading

When you're ready to move on, continue using the XRP Ledger with these resources:

• Understand the Concepts behind the XRP Ledger's design.
• Use the RippleAPI Reference to see what else you can do.
• Install rippled to participate in the network.
• Get Testnet XRP to try sending and receiving payments.

{% include '_snippets/rippled-api-links.md' %} {% include '_snippets/tx-type-links.md' %} {% include '_snippets/rippled_versions.md' %}