mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-21 12:15:50 +00:00
d6e06ae140
- Removes lodash dependecy for web version - Uses the new generateFaucetWallet() API method - Make 'issue a token' code capable of running in-browser or in Node.js without modification
94 lines
3.8 KiB
JavaScript
94 lines
3.8 KiB
JavaScript
// Example credentials
|
|
let address = "rMCcNuTcajgw7YTgBy1sys3b89QqjUrMpH"
|
|
let secret = "sn3nxiW7v8KXzPzAqzyHXbSSKNuN9"
|
|
|
|
// Connect ---------------------------------------------------------------------
|
|
// ripple = require('ripple-lib') // For Node.js. In browsers, use <script>.
|
|
api = new ripple.RippleAPI({server: 'wss://s.altnet.rippletest.net:51233'})
|
|
api.connect()
|
|
api.on('connected', async () => {
|
|
|
|
// Get credentials from the Testnet Faucet -----------------------------------
|
|
const data = await api.generateFaucetWallet()
|
|
address = data.account.address
|
|
secret = data.account.secret
|
|
|
|
console.log("Waiting until we have a validated starting sequence number...")
|
|
// If you go too soon, the funding transaction might slip back a ledger and
|
|
// then your starting Sequence number will be off. This is mostly relevant
|
|
// when you want to use a Testnet account right after getting a reply from
|
|
// the faucet.
|
|
while (true) {
|
|
try {
|
|
await api.request("account_info", {account: address, ledger_index: "validated"})
|
|
break
|
|
} catch(e) {
|
|
await new Promise(resolve => setTimeout(resolve, 1000))
|
|
}
|
|
}
|
|
|
|
// Prepare transaction -------------------------------------------------------
|
|
const preparedTx = await api.prepareTransaction({
|
|
"TransactionType": "Payment",
|
|
"Account": address,
|
|
"Amount": api.xrpToDrops("22"), // Same as "Amount": "22000000"
|
|
"Destination": "rUCzEr6jrEyMpjhs4wSdQdz4g8Y382NxfM"
|
|
}, {
|
|
// Expire this transaction if it doesn't execute within ~5 minutes:
|
|
"maxLedgerVersionOffset": 75
|
|
})
|
|
const maxLedgerVersion = preparedTx.instructions.maxLedgerVersion
|
|
console.log("Prepared transaction instructions:", preparedTx.txJSON)
|
|
console.log("Transaction cost:", preparedTx.instructions.fee, "XRP")
|
|
console.log("Transaction expires after ledger:", maxLedgerVersion)
|
|
|
|
// Sign prepared instructions ------------------------------------------------
|
|
const signed = api.sign(preparedTx.txJSON, secret)
|
|
const txID = signed.id
|
|
const tx_blob = signed.signedTransaction
|
|
console.log("Identifying hash:", txID)
|
|
console.log("Signed blob:", tx_blob)
|
|
|
|
// Submit signed blob --------------------------------------------------------
|
|
// The earliest ledger a transaction could appear in is the first ledger
|
|
// after the one that's already validated at the time it's *first* submitted.
|
|
const earliestLedgerVersion = (await api.getLedgerVersion()) + 1
|
|
const result = await api.submit(tx_blob)
|
|
console.log("Tentative result code:", result.resultCode)
|
|
console.log("Tentative result message:", result.resultMessage)
|
|
|
|
// Wait for validation -------------------------------------------------------
|
|
let has_final_status = false
|
|
api.request("subscribe", {accounts: [address]})
|
|
api.connection.on("transaction", (event) => {
|
|
if (event.transaction.hash == txID) {
|
|
console.log("Transaction has executed!", event)
|
|
has_final_status = true
|
|
}
|
|
})
|
|
api.on('ledger', ledger => {
|
|
if (ledger.ledgerVersion > maxLedgerVersion && !has_final_status) {
|
|
console.log("Ledger version", ledger.ledgerVersion, "was validated.")
|
|
console.log("If the transaction hasn't succeeded by now, it's expired")
|
|
has_final_status = true
|
|
}
|
|
})
|
|
|
|
// There are other ways to do this, but they're more complicated.
|
|
// See https://xrpl.org/reliable-transaction-submission.html for details.
|
|
while (!has_final_status) {
|
|
await new Promise(resolve => setTimeout(resolve, 1000))
|
|
}
|
|
|
|
// Check transaction results -------------------------------------------------
|
|
try {
|
|
tx = await api.getTransaction(txID, {
|
|
minLedgerVersion: earliestLedgerVersion})
|
|
console.log("Transaction result:", tx.outcome.result)
|
|
console.log("Balance changes:", JSON.stringify(tx.outcome.balanceChanges))
|
|
} catch(error) {
|
|
console.log("Couldn't get transaction outcome:", error)
|
|
}
|
|
|
|
}) // End of api.on.('connected')
|