Pustaka JavaScript/TypeScript untuk berinteraksi dengan XRP Ledger
Ini adalah perpustakaan yang direkomendasikan untuk mengintegrasikan aplikasi JavaScript/TypeScript dengan Buku Besar XRP, terutama jika Anda ingin menggunakan fungsionalitas tingkat lanjut seperti IOU, jalur pembayaran, pertukaran terdesentralisasi, pengaturan akun, saluran pembayaran, escrow, multi-penandatanganan, dan banyak lagi .
Lihat dokumentasi referensi lengkap untuk semua kelas, metode, dan utilitas.
Mengelola kunci & membuat kredensial pengujian ( Wallet
&& Client.fundWallet()
)
Mengirimkan transaksi ke Buku Besar XRP ( Client.submit(...)
& jenis transaksi)
Mengirim permintaan untuk mengamati buku besar ( Client.request(...)
menggunakan metode API publik)
Berlangganan perubahan dalam buku besar (Mis. buku besar, transaksi, & lainnya...)
Mengurai data buku besar ke dalam format yang lebih nyaman ( xrpToDrops
dan rippleTimeToISOTime
)
Semuanya berfungsi di Node.js (diuji untuk v18+) & browser web (diuji untuk Chrome).
Node.js v18 direkomendasikan. Kami juga mendukung v20. Versi lain mungkin berfungsi tetapi tidak sering diuji.
Dalam proyek yang sudah ada (dengan package.json), instal xrpl.js dengan:
$ npm install --save xrpl
Atau dengan yarn
:
$ yarn add xrpl
Contoh penggunaan:
const xrpl = memerlukan("xrpl");fungsi async main() { klien const = xrpl.Klien baru("wss://s.altnet.rippletest.net:51233"); menunggu klien.connect(); const respon = menunggu klien.request({perintah: "account_info",akun: "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe",ledger_index: "divalidasi", }); console.log(respon); menunggu klien.disconnect();}main();
Untuk contoh yang lebih mendalam, Anda dapat menyalin/mem-forking template Code Sandbox ini!
https://codesandbox.io/s/xrpl-intro-pxgdjr?file=/src/App.js
Itu melewati:
Membuat akun pengujian baru
Mengirim transaksi pembayaran
Dan mengirimkan permintaan untuk melihat saldo akun Anda!
Jika Anda menggunakan xrpl.js dengan React atau Deno, Anda perlu melakukan beberapa langkah tambahan untuk menyiapkannya:
Menggunakan xrpl.js dengan CDN
Menggunakan xrpl.js dengan create-react-app
Menggunakan xrpl.js dengan React Native
Menggunakan xrpl.js dengan Vite React
Menggunakan xrpl.js dengan Deno
Saat Anda mengembangkan xrpl.js, ada dua situs yang akan Anda gunakan secara luas:
xrpl.org adalah sumber utama untuk:
Cara kerja buku besar (Lihat Konsep)
Jenis transaksi apa saja yang ada (Jenis Transaksi)
Permintaan yang dapat Anda kirim (Metode API Publik)
Tutorial berinteraksi dengan berbagai fitur ledger (Tutorial)
js.xrpl.org memiliki dokumen referensi untuk perpustakaan ini
Jika Anda ingin mengetahui kapan kami merilis versi baru xrpl.js, Anda dapat bergabung dengan milis kami dengan lalu lintas rendah (Sekitar 1 email per minggu):
Berlangganan xrpl-umumkan
Jika Anda menggunakan Buku Besar XRP dalam produksi, Anda harus menjalankan server riak dan berlangganan milis server riak juga.
Berlangganan ke server riak
Salah satu tempat terbaik untuk meminta bantuan adalah di Perselisihan Pengembang XRPL - Ada saluran untuk xrpl.js tempat anggota komunitas lain dapat membantu Anda mencari cara untuk mencapai tujuan Anda.
Anda juga dapat membuat masalah di sini dan kami akan melakukan yang terbaik untuk meresponsnya dalam waktu 3 hari.
Dokumen Referensi xrpl.js
xrpl.org (Dokumen terperinci tentang cara kerja XRPL)
Contoh Kode XRPL
#javascript di Perselisihan Pengembang XRPL untuk pertanyaan & dukungan
xrpl-announce (Milis untuk versi xrpl.js baru)
Aplikasi yang menggunakan xrpl.js (Anda dapat membuka PR untuk menambahkan proyek Anda!)