mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-23 05:05:50 +00:00
Complete first draft
This commit is contained in:
Dennis Dawson
@@ -8,9 +8,10 @@ labels:
|
|||||||
- Broker
|
- Broker
|
||||||
- XRP
|
- XRP
|
||||||
---
|
---
|
||||||
|
|
||||||
# Broker a NFToken Sale
|
# Broker a NFToken Sale
|
||||||
|
|
||||||
Earlier examples showed how to make buy and sell offers directly between two accounts. Another option is to use a third account as a broker for the sale. The broker acts on behalf of the NFToken owner. The seller creates an offer with the broker account as its destination. The broker gathers and evaluates buy offers and chooses which one to accept, adding an agreed-upon fee for arranging the sale. When the broker account matches the sell offer with a buy offer, the funds and ownership of the NFToken are transferred simultaneously, completing the deal. This allows an account to act as a marketplace or personal agent for NFToken creators and traders.
|
Earlier examples showed how to make buy and sell offers directly between two accounts. Another option is to use a third account as a broker for the sale. The broker acts on behalf of the NFToken owner. The seller creates an offer with the broker account as its destination. The broker gathers and evaluates buy offers and chooses which one to accept, adding an agreed-upon fee for arranging the sale. When the broker account accepts a sell offer with a buy offer, the funds and ownership of the NFToken are transferred simultaneously, completing the deal. This allows an account to act as a marketplace or personal agent for NFToken creators and traders.
|
||||||
|
|
||||||
# Usage
|
# Usage
|
||||||
|
|
||||||
@@ -74,18 +75,21 @@ After accepting a buy offer, a best practice for the broker is to cancel all oth
|
|||||||
|
|
||||||
# Code Walkthrough
|
# Code Walkthrough
|
||||||
|
|
||||||
```
|
You can download the [Quickstart Samples](https://github.com/XRPLF/xrpl-dev-portal/tree/master/content/_code-samples/quickstart/js/quickstart.zip) archive to examine the code samples.
|
||||||
// *******************************************************
|
|
||||||
// *******************************************************
|
|
||||||
// ************** Broker Transactions ********************
|
|
||||||
// *******************************************************
|
|
||||||
// *******************************************************
|
|
||||||
|
|
||||||
// *******************************************************
|
## ripplex5-broker-nfts.js
|
||||||
// *************** Broker Get Offers *********************
|
|
||||||
// *******************************************************
|
This script has new functions for brokered transactions and revised functions to support a third account on the same screen.
|
||||||
|
|
||||||
|
## Broker Get Offers
|
||||||
|
|
||||||
|
```
|
||||||
async function brGetOffers() {
|
async function brGetOffers() {
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect to the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
const standby_wallet = xrpl.Wallet.fromSeed(brokerSeedField.value)
|
const standby_wallet = xrpl.Wallet.fromSeed(brokerSeedField.value)
|
||||||
let net = getNet()
|
let net = getNet()
|
||||||
const client = new xrpl.Client(net)
|
const client = new xrpl.Client(net)
|
||||||
@@ -94,7 +98,11 @@ async function brGetOffers() {
|
|||||||
await client.connect()
|
await client.connect()
|
||||||
results += '\nConnected. Getting offers...'
|
results += '\nConnected. Getting offers...'
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Request the list of sell offers for the token.
|
||||||
|
|
||||||
|
```
|
||||||
results += '\n\n***Sell Offers***\n'
|
results += '\n\n***Sell Offers***\n'
|
||||||
let nftSellOffers
|
let nftSellOffers
|
||||||
try {
|
try {
|
||||||
@@ -107,7 +115,11 @@ async function brGetOffers() {
|
|||||||
}
|
}
|
||||||
results += JSON.stringify(nftSellOffers,null,2)
|
results += JSON.stringify(nftSellOffers,null,2)
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Request the list of buy offers for the token.
|
||||||
|
|
||||||
|
```
|
||||||
results += '\n\n***Buy Offers***\n'
|
results += '\n\n***Buy Offers***\n'
|
||||||
let nftBuyOffers
|
let nftBuyOffers
|
||||||
try {
|
try {
|
||||||
@@ -120,16 +132,24 @@ async function brGetOffers() {
|
|||||||
results += JSON.stringify(nftBuyOffers,null,2)
|
results += JSON.stringify(nftBuyOffers,null,2)
|
||||||
|
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
client.disconnect()
|
Disconnect from the ledger.
|
||||||
// End of brGetOffers()
|
|
||||||
}
|
|
||||||
|
|
||||||
// *******************************************************
|
```
|
||||||
// ******************* Broker Sale ***********************
|
client.disconnect()
|
||||||
// *******************************************************
|
}// End of brGetOffers()
|
||||||
|
```
|
||||||
|
|
||||||
|
## Broker Sale
|
||||||
|
|
||||||
|
```
|
||||||
async function brokerSale() {
|
async function brokerSale() {
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect to the ledger and get the wallet accounts.
|
||||||
|
|
||||||
|
```
|
||||||
const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
|
const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
|
||||||
const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
|
const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
|
||||||
const broker_wallet = xrpl.Wallet.fromSeed (brokerSeedField.value)
|
const broker_wallet = xrpl.Wallet.fromSeed (brokerSeedField.value)
|
||||||
@@ -140,8 +160,11 @@ async function brokerSale() {
|
|||||||
await client.connect()
|
await client.connect()
|
||||||
results += '\nConnected. Brokering sale...'
|
results += '\nConnected. Brokering sale...'
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
// Prepare transaction -------------------------------------------------------
|
Prepare the transaction. The difference between a brokered sale and a direct sale is that you provide both a sell offer and a buy offer, with an agreed-upon broker's fee.
|
||||||
|
|
||||||
|
```
|
||||||
const transactionBlob = {
|
const transactionBlob = {
|
||||||
"TransactionType": "NFTokenAcceptOffer",
|
"TransactionType": "NFTokenAcceptOffer",
|
||||||
"Account": broker_wallet.classicAddress,
|
"Account": broker_wallet.classicAddress,
|
||||||
@@ -149,10 +172,17 @@ async function brokerSale() {
|
|||||||
"NFTokenBuyOffer": brokerTokenBuyOfferIndexField.value,
|
"NFTokenBuyOffer": brokerTokenBuyOfferIndexField.value,
|
||||||
"Fee": brokerBrokerFeeField.value
|
"Fee": brokerBrokerFeeField.value
|
||||||
}
|
}
|
||||||
// Submit transaction --------------------------------------------------------
|
```
|
||||||
|
|
||||||
|
Submit the transaction and wait for the results.
|
||||||
|
|
||||||
|
```
|
||||||
const tx = await client.submitAndWait(transactionBlob,{wallet: broker_wallet})
|
const tx = await client.submitAndWait(transactionBlob,{wallet: broker_wallet})
|
||||||
|
```
|
||||||
|
|
||||||
// Check transaction results -------------------------------------------------
|
Report the results.
|
||||||
|
|
||||||
|
```
|
||||||
results += "\n\nTransaction result:\n" +
|
results += "\n\nTransaction result:\n" +
|
||||||
JSON.stringify(tx.result.meta.TransactionResult, null, 2)
|
JSON.stringify(tx.result.meta.TransactionResult, null, 2)
|
||||||
results += "\nBalance changes:\n" +
|
results += "\nBalance changes:\n" +
|
||||||
@@ -164,16 +194,24 @@ async function brokerSale() {
|
|||||||
document.getElementById('brokerBalanceField').value =
|
document.getElementById('brokerBalanceField').value =
|
||||||
(await client.getXrpBalance(broker_wallet.address))
|
(await client.getXrpBalance(broker_wallet.address))
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Disconnect from the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
client.disconnect()
|
client.disconnect()
|
||||||
|
|
||||||
}// End of brokerSale()
|
}// End of brokerSale()
|
||||||
|
```
|
||||||
|
|
||||||
// *******************************************************
|
## Broker Cancel Offer
|
||||||
// ************* Broker Cancel Offer ****************
|
|
||||||
// *******************************************************
|
|
||||||
|
|
||||||
|
```
|
||||||
async function brCancelOffer() {
|
async function brCancelOffer() {
|
||||||
|
```
|
||||||
|
|
||||||
|
Get the broker wallet and connect to the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
const wallet = xrpl.Wallet.fromSeed(brokerSeedField.value)
|
const wallet = xrpl.Wallet.fromSeed(brokerSeedField.value)
|
||||||
const client = new xrpl.Client("wss://xls20-sandbox.rippletest.net:51233")
|
const client = new xrpl.Client("wss://xls20-sandbox.rippletest.net:51233")
|
||||||
results = 'Connecting to ' + getNet() + '...'
|
results = 'Connecting to ' + getNet() + '...'
|
||||||
@@ -181,18 +219,33 @@ async function brCancelOffer() {
|
|||||||
await client.connect()
|
await client.connect()
|
||||||
results += "\nConnected. Cancelling offer..."
|
results += "\nConnected. Cancelling offer..."
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
The Token ID must be converted to an array.
|
||||||
|
|
||||||
|
```
|
||||||
const tokenOfferIDs = [brokerTokenBuyOfferIndexField.value]
|
const tokenOfferIDs = [brokerTokenBuyOfferIndexField.value]
|
||||||
|
```
|
||||||
|
|
||||||
// Prepare transaction -------------------------------------------------------
|
Prepare the transaction.
|
||||||
|
|
||||||
|
```
|
||||||
const transactionBlob = {
|
const transactionBlob = {
|
||||||
"TransactionType": "NFTokenCancelOffer",
|
"TransactionType": "NFTokenCancelOffer",
|
||||||
"Account": wallet.classicAddress,
|
"Account": wallet.classicAddress,
|
||||||
"NFTokenOffers": tokenOfferIDs
|
"NFTokenOffers": tokenOfferIDs
|
||||||
}
|
}
|
||||||
// Submit transaction --------------------------------------------------------
|
```
|
||||||
const tx = await client.submitAndWait(transactionBlob,{wallet})
|
|
||||||
|
|
||||||
|
Submit the transaction and wait for the results.
|
||||||
|
|
||||||
|
```
|
||||||
|
const tx = await client.submitAndWait(transactionBlob,{wallet})
|
||||||
|
```
|
||||||
|
|
||||||
|
Get the sell offers and report the results.
|
||||||
|
|
||||||
|
```
|
||||||
results += "\n\n***Sell Offers***\n"
|
results += "\n\n***Sell Offers***\n"
|
||||||
let nftSellOffers
|
let nftSellOffers
|
||||||
try {
|
try {
|
||||||
@@ -204,6 +257,11 @@ async function brCancelOffer() {
|
|||||||
nftSellOffers = "No sell offers."
|
nftSellOffers = "No sell offers."
|
||||||
}
|
}
|
||||||
results += JSON.stringify(nftSellOffers,null,2)
|
results += JSON.stringify(nftSellOffers,null,2)
|
||||||
|
```
|
||||||
|
|
||||||
|
Get the buy offers and report the results.
|
||||||
|
|
||||||
|
```
|
||||||
results += "\n\n***Buy Offers***\n"
|
results += "\n\n***Buy Offers***\n"
|
||||||
let nftBuyOffers
|
let nftBuyOffers
|
||||||
try {
|
try {
|
||||||
@@ -214,34 +272,43 @@ async function brCancelOffer() {
|
|||||||
nftBuyOffers = "No buy offers."
|
nftBuyOffers = "No buy offers."
|
||||||
}
|
}
|
||||||
results += JSON.stringify(nftBuyOffers,null,2)
|
results += JSON.stringify(nftBuyOffers,null,2)
|
||||||
|
```
|
||||||
|
|
||||||
// Check transaction results -------------------------------------------------
|
Report the transaction results.
|
||||||
|
|
||||||
|
```
|
||||||
results += "\nTransaction result:\n" +
|
results += "\nTransaction result:\n" +
|
||||||
JSON.stringify(tx.result.meta.TransactionResult, null, 2)
|
JSON.stringify(tx.result.meta.TransactionResult, null, 2)
|
||||||
results += "\nBalance changes:\n" +
|
results += "\nBalance changes:\n" +
|
||||||
JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
|
JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Disconnect from the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
client.disconnect()
|
client.disconnect()
|
||||||
}// End of brCancelOffer()
|
}// End of brCancelOffer()
|
||||||
|
```
|
||||||
|
## Get Account
|
||||||
|
|
||||||
// ***************************************************************************
|
To accommodate the broker account, override the `getAccount(type)` function to watch for the _broker_ type.
|
||||||
// ************** Revised Functions ******************************************
|
|
||||||
// ***************************************************************************
|
|
||||||
|
|
||||||
// *******************************************************
|
|
||||||
// ************* Get Account *****************************
|
|
||||||
// *******************************************************
|
|
||||||
|
|
||||||
|
|
||||||
|
```
|
||||||
async function getAccount(type) {
|
async function getAccount(type) {
|
||||||
let net = getNet()
|
```
|
||||||
|
|
||||||
|
Connect to the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
|
let net = getNet()
|
||||||
const client = new xrpl.Client(net)
|
const client = new xrpl.Client(net)
|
||||||
results = 'Connecting to ' + net + '....'
|
results = 'Connecting to ' + net + '....'
|
||||||
|
```
|
||||||
|
|
||||||
// This uses the default faucet for Testnet/Devnet
|
Get the correct network host.
|
||||||
|
|
||||||
|
```
|
||||||
let faucetHost = null
|
let faucetHost = null
|
||||||
if(document.getElementById("xls").checked) {
|
if(document.getElementById("xls").checked) {
|
||||||
faucetHost = "faucet-nft.ripple.com"
|
faucetHost = "faucet-nft.ripple.com"
|
||||||
@@ -256,6 +323,12 @@ async function getAccount(type) {
|
|||||||
if (type == 'broker') {
|
if (type == 'broker') {
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect to the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
await client.connect()
|
await client.connect()
|
||||||
|
|
||||||
results += '\nConnected, funding wallet.'
|
results += '\nConnected, funding wallet.'
|
||||||
@@ -268,9 +341,12 @@ async function getAccount(type) {
|
|||||||
if (type == 'broker') {
|
if (type == 'broker') {
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
|
||||||
// -----------------------------------Create and fund a test account wallet
|
Create and fund a test wallet and report progress.
|
||||||
const my_wallet = (await client.fundWallet(null, { faucetHost })).wallet
|
|
||||||
|
```
|
||||||
|
const my_wallet = (await client.fundWallet(null, { faucetHost })).wallet
|
||||||
|
|
||||||
results += '\nGot a wallet.'
|
results += '\nGot a wallet.'
|
||||||
if (type == 'standby') {
|
if (type == 'standby') {
|
||||||
@@ -282,10 +358,17 @@ async function getAccount(type) {
|
|||||||
if (type == 'broker') {
|
if (type == 'broker') {
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
}
|
}
|
||||||
|
```
|
||||||
|
|
||||||
// -----------------------------------Get the current balance.
|
Get the XRP balance for the new account.
|
||||||
const my_balance = (await client.getXrpBalance(my_wallet.address))
|
|
||||||
|
|
||||||
|
```
|
||||||
|
const my_balance = (await client.getXrpBalance(my_wallet.address))
|
||||||
|
```
|
||||||
|
|
||||||
|
Populate the form fields for the appropriate account with the new account information.
|
||||||
|
|
||||||
|
```
|
||||||
if (type == 'standby') {
|
if (type == 'standby') {
|
||||||
document.getElementById('standbyAccountField').value = my_wallet.address
|
document.getElementById('standbyAccountField').value = my_wallet.address
|
||||||
document.getElementById('standbyPubKeyField').value = my_wallet.publicKey
|
document.getElementById('standbyPubKeyField').value = my_wallet.publicKey
|
||||||
@@ -316,16 +399,32 @@ async function getAccount(type) {
|
|||||||
results += '\nBroker account created.'
|
results += '\nBroker account created.'
|
||||||
document.getElementById('brokerResultField').value = results
|
document.getElementById('brokerResultField').value = results
|
||||||
}
|
}
|
||||||
// --------------- Capture the seeds for accounts for ease of reload.
|
```
|
||||||
document.getElementById('seeds').value = standbySeedField.value + '\n' + operationalSeedField.value + "\n" + brokerSeedField.value
|
|
||||||
|
Add the new account seed to corresponding line in the **Account Seeds** field.
|
||||||
|
|
||||||
|
```
|
||||||
|
document.getElementById('seeds').value = standbySeedField.value + '\n' + operationalSeedField.value + "\n" + brokerSeedField.value
|
||||||
|
```
|
||||||
|
|
||||||
|
Disconnect from the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
client.disconnect()
|
client.disconnect()
|
||||||
} // End of getAccount()
|
} // End of getAccount()
|
||||||
|
```
|
||||||
|
|
||||||
// *******************************************************
|
## Get Accounts from Seeds
|
||||||
// ********** Get Accounts from Seeds ********************
|
|
||||||
// *******************************************************
|
|
||||||
|
|
||||||
|
Override the `getAccountsFromSeeds()` function to include the broker account fields.
|
||||||
|
|
||||||
|
```
|
||||||
async function getAccountsFromSeeds() {
|
async function getAccountsFromSeeds() {
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect to the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
let net = getNet()
|
let net = getNet()
|
||||||
const client = new xrpl.Client(net)
|
const client = new xrpl.Client(net)
|
||||||
results = 'Connecting to ' + getNet() + '....'
|
results = 'Connecting to ' + getNet() + '....'
|
||||||
@@ -333,18 +432,33 @@ async function getAccountsFromSeeds() {
|
|||||||
await client.connect()
|
await client.connect()
|
||||||
results += '\nConnected, finding wallets.\n'
|
results += '\nConnected, finding wallets.\n'
|
||||||
document.getElementById('standbyResultField').value = results
|
document.getElementById('standbyResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
// -----------------------------------Find the test account wallets
|
Use the `split` function to parse the values from the **Seeds** field.
|
||||||
|
|
||||||
|
```
|
||||||
var lines = seeds.value.split('\n');
|
var lines = seeds.value.split('\n');
|
||||||
|
```
|
||||||
|
|
||||||
|
Get the wallets based on the seed values.
|
||||||
|
|
||||||
|
```
|
||||||
const standby_wallet = xrpl.Wallet.fromSeed(lines[0])
|
const standby_wallet = xrpl.Wallet.fromSeed(lines[0])
|
||||||
const operational_wallet = xrpl.Wallet.fromSeed(lines[1])
|
const operational_wallet = xrpl.Wallet.fromSeed(lines[1])
|
||||||
const broker_wallet = xrpl.Wallet.fromSeed(lines[2])
|
const broker_wallet = xrpl.Wallet.fromSeed(lines[2])
|
||||||
|
```
|
||||||
|
|
||||||
// -----------------------------------Get the current balance.
|
Get the XRP balances for the accounts.
|
||||||
|
|
||||||
|
```
|
||||||
const standby_balance = (await client.getXrpBalance(standby_wallet.address))
|
const standby_balance = (await client.getXrpBalance(standby_wallet.address))
|
||||||
const operational_balance = (await client.getXrpBalance(operational_wallet.address))
|
const operational_balance = (await client.getXrpBalance(operational_wallet.address))
|
||||||
const broker_balance = (await client.getXrpBalance(broker_wallet.address))
|
const broker_balance = (await client.getXrpBalance(broker_wallet.address))
|
||||||
|
```
|
||||||
|
|
||||||
|
Populate the form fields based on the wallet values.
|
||||||
|
|
||||||
|
```
|
||||||
document.getElementById('standbyAccountField').value = standby_wallet.address
|
document.getElementById('standbyAccountField').value = standby_wallet.address
|
||||||
document.getElementById('standbyPubKeyField').value = standby_wallet.publicKey
|
document.getElementById('standbyPubKeyField').value = standby_wallet.publicKey
|
||||||
document.getElementById('standbyPrivKeyField').value = standby_wallet.privateKey
|
document.getElementById('standbyPrivKeyField').value = standby_wallet.privateKey
|
||||||
@@ -365,12 +479,556 @@ async function getAccountsFromSeeds() {
|
|||||||
document.getElementById('brokerSeedField').value = broker_wallet.seed
|
document.getElementById('brokerSeedField').value = broker_wallet.seed
|
||||||
document.getElementById('brokerBalanceField').value =
|
document.getElementById('brokerBalanceField').value =
|
||||||
(await client.getXrpBalance(broker_wallet.address))
|
(await client.getXrpBalance(broker_wallet.address))
|
||||||
|
```
|
||||||
|
|
||||||
|
Disconnect from the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
client.disconnect()
|
client.disconnect()
|
||||||
|
```
|
||||||
|
|
||||||
|
Use the `getBalances()` function to get the current balances of fiat currency.
|
||||||
|
|
||||||
|
```
|
||||||
getBalances()
|
getBalances()
|
||||||
|
|
||||||
} // End of getAccountsFromSeeds()
|
} // End of getAccountsFromSeeds()
|
||||||
|
```
|
||||||
|
|
||||||
|
## Get Balances
|
||||||
|
|
||||||
|
Override the `getBalances()` function to include the broker balance.
|
||||||
|
|
||||||
|
```
|
||||||
|
async function getBalances() {
|
||||||
|
```
|
||||||
|
|
||||||
|
Connect with the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
|
let net = getNet()
|
||||||
|
const client = new xrpl.Client(net)
|
||||||
|
results = 'Connecting to ' + getNet() + '....'
|
||||||
|
document.getElementById('standbyResultField').value = results
|
||||||
|
|
||||||
|
await client.connect()
|
||||||
|
|
||||||
|
results += '\nConnected.'
|
||||||
|
document.getElementById('standbyResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Get the wallets for each of the three accounts.
|
||||||
|
|
||||||
|
```
|
||||||
|
const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
|
||||||
|
const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
|
||||||
|
const broker_wallet = xrpl.Wallet.fromSeed(brokerSeedField.value)
|
||||||
|
```
|
||||||
|
|
||||||
|
Get and report the Standby account balances.
|
||||||
|
|
||||||
|
```
|
||||||
|
results= "\nGetting standby account balances...\n"
|
||||||
|
const standby_balances = await client.request({
|
||||||
|
command: "gateway_balances",
|
||||||
|
account: standby_wallet.address,
|
||||||
|
ledger_index: "validated",
|
||||||
|
hotwallet: [operational_wallet.address]
|
||||||
|
})
|
||||||
|
results += JSON.stringify(standby_balances.result, null, 2)
|
||||||
|
document.getElementById('standbyResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Get and report the Operational account balances.
|
||||||
|
|
||||||
|
```
|
||||||
|
results= "\nGetting operational account balances...\n"
|
||||||
|
const operational_balances = await client.request({
|
||||||
|
command: "account_lines",
|
||||||
|
account: operational_wallet.address,
|
||||||
|
ledger_index: "validated"
|
||||||
|
})
|
||||||
|
results += JSON.stringify(operational_balances.result, null, 2)
|
||||||
|
document.getElementById('operationalResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Get and report the Broker account balances.
|
||||||
|
|
||||||
|
```
|
||||||
|
results= "\nGetting broker account balances...\n"
|
||||||
|
const broker_balances = await client.request({
|
||||||
|
command: "account_lines",
|
||||||
|
account: broker_wallet.address,
|
||||||
|
ledger_index: "validated"
|
||||||
|
})
|
||||||
|
results += JSON.stringify(broker_balances.result, null, 2)
|
||||||
|
document.getElementById('brokerResultField').value = results
|
||||||
|
```
|
||||||
|
|
||||||
|
Update the XRP balances for the three accounts.
|
||||||
|
|
||||||
|
```
|
||||||
|
document.getElementById('operationalBalanceField').value =
|
||||||
|
(await client.getXrpBalance(operational_wallet.address))
|
||||||
|
document.getElementById('standbyBalanceField').value =
|
||||||
|
(await client.getXrpBalance(standby_wallet.address))
|
||||||
|
document.getElementById('brokerBalanceField').value =
|
||||||
|
(await client.getXrpBalance(broker_wallet.address))
|
||||||
|
```
|
||||||
|
|
||||||
|
Disconnect from the ledger.
|
||||||
|
|
||||||
|
```
|
||||||
|
client.disconnect()
|
||||||
|
} // end of getBalances()
|
||||||
|
```
|
||||||
|
## 5.broker-nfts.html
|
||||||
|
|
||||||
|
Revise the HTML form to add a new Broker section at the top.
|
||||||
|
|
||||||
|
```
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<title>Token Test Harness</title>
|
||||||
|
<script src='https://unpkg.com/xrpl@2.2.3'></script>
|
||||||
|
<script src='ripplex1-send-xrp.js'></script>
|
||||||
|
<script src='ripplex2-send-currency.js'></script>
|
||||||
|
<script src='ripplex3-mint-nfts.js'></script>
|
||||||
|
<script src='ripplex4-transfer-nfts.js'></script>
|
||||||
|
<script src='ripplex5-broker-nfts.js'></script>
|
||||||
|
<script>
|
||||||
|
if (typeof module !== "undefined") {
|
||||||
|
const xrpl = require('xrpl')
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
|
||||||
|
<!-- ************************************************************** -->
|
||||||
|
<!-- ********************** The Form ****************************** -->
|
||||||
|
<!-- ************************************************************** -->
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<h1>Token Test Harness</h1>
|
||||||
|
<form id="theForm">
|
||||||
|
Choose your ledger instance:
|
||||||
|
<input type="radio" id="xls" name="server"
|
||||||
|
value="wss://xls20-sandbox.rippletest.net:51233" checked>
|
||||||
|
<label for="xls20">XLS20-NFT</label>
|
||||||
|
|
||||||
|
<input type="radio" id="tn" name="server"
|
||||||
|
value="wss://s.altnet.rippletest.net:51233">
|
||||||
|
<label for="testnet">Testnet</label>
|
||||||
|
|
||||||
|
<input type="radio" id="dn" name="server"
|
||||||
|
value="wss://s.devnet.rippletest.net:51233">
|
||||||
|
<label for="devnet">Devnet</label>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="getAccountsFromSeeds()">Get Accounts From Seeds</button>
|
||||||
|
<br/>
|
||||||
|
<textarea id="seeds" cols="40" rows= "3"></textarea>
|
||||||
|
<br/><br/>
|
||||||
|
<table align="center">
|
||||||
|
<tr valign="top">
|
||||||
|
<td>
|
||||||
|
<button type="button" onClick="getAccount('broker')">Get New Broker Account</button>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr valign="top">
|
||||||
|
<td align="right">
|
||||||
|
Broker Account
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerAccountField" size="40"></input>
|
||||||
|
<button type="button" id="another" onclick="brokerSale()">Broker Sale</button>
|
||||||
|
</td>
|
||||||
|
<td rowspan="7">
|
||||||
|
<textarea id="brokerResultField" cols="40" rows="12"></textarea>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Public Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerPubKeyField" size="40"></input>
|
||||||
|
<button type="button" onClick="brGetOffers()">Get Offers</button>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Private Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerPrivKeyField" size="40"></input>
|
||||||
|
<button type="button" onClick="brCancelOffer()">Cancel Offer</button>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Seed
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerSeedField" size="40"></input>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
XRP Balance
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerBalanceField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Amount
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="brokerAmountField" size="40" value="100"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken ID</td>
|
||||||
|
<td><input type="text" id="brokerTokenIdField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Sell NFToken Offer Index</td>
|
||||||
|
<td><input type="text" id="brokerTokenSellOfferIndexField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Buy NFToken Offer Index</td>
|
||||||
|
<td><input type="text" id="brokerTokenBuyOfferIndexField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Owner</td>
|
||||||
|
<td><input type="text" id="brokerOwnerField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Broker Fee</td>
|
||||||
|
<td><input type="text" id="brokerBrokerFeeField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
<br/><br/>
|
||||||
|
<table>
|
||||||
|
<tr valign="top">
|
||||||
|
<td>
|
||||||
|
<table>
|
||||||
|
<tr valign="top">
|
||||||
|
<td>
|
||||||
|
<td>
|
||||||
|
<button type="button" onClick="getAccount('standby')">Get New Standby Account</button>
|
||||||
|
<table>
|
||||||
|
<tr valign="top">
|
||||||
|
<td align="right">
|
||||||
|
Standby Account
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyAccountField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Public Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyPubKeyField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Private Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyPrivKeyField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Seed
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbySeedField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
XRP Balance
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyBalanceField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Amount
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyAmountField" size="40" value="100"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr valign="top">
|
||||||
|
<td><button type="button" onClick="configureAccount('standby',document.querySelector('#standbyDefault').checked)">Configure Account</button></td>
|
||||||
|
<td>
|
||||||
|
<input type="checkbox" id="standbyDefault" checked="true"/>
|
||||||
|
<label for="standbyDefault">Allow Rippling</label>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Currency
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="standbyCurrencyField" size="40" value="USD"></input>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken URL</td>
|
||||||
|
<td><input type="text" id="standbyTokenUrlField"
|
||||||
|
value = "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf4dfuylqabf3oclgtqy55fbzdi" size="80"/>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Flags</td>
|
||||||
|
<td><input type="text" id="standbyFlagsField" value="1" size="10"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken ID</td>
|
||||||
|
<td><input type="text" id="standbyTokenIdField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken Offer Index</td>
|
||||||
|
<td><input type="text" id="standbyTokenOfferIndexField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Owner</td>
|
||||||
|
<td><input type="text" id="standbyOwnerField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Destination</td>
|
||||||
|
<td><input type="text" id="standbyDestinationField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Expiration</td>
|
||||||
|
<td><input type="text" id="standbyExpirationField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Transfer Fee</td>
|
||||||
|
<td><input type="text" id="standbyTransferFeeField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
<p align="left">
|
||||||
|
<textarea id="standbyResultField" cols="80" rows="20" ></textarea>
|
||||||
|
</p>
|
||||||
|
</td>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<table>
|
||||||
|
<tr valign="top">
|
||||||
|
<td align="center" valign="top">
|
||||||
|
<button type="button" onClick="sendXRP()">Send XRP></button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="createTrustline()">Create TrustLine</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="sendCurrency()">Send Currency</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="getBalances()">Get Balances</button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="mintToken()">Mint NFToken</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="getTokens()">Get NFTokens</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="burnToken()">Burn NFToken</button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="createSellOffer()">Create Sell Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="acceptSellOffer()">Accept Sell Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="createBuyOffer()">Create Buy Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="acceptBuyOffer()">Accept Buy Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="getOffers()">Get Offers</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="cancelOffer()">Cancel Offer</button>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<table>
|
||||||
|
<tr>
|
||||||
|
<td>
|
||||||
|
<td>
|
||||||
|
<table>
|
||||||
|
<tr>
|
||||||
|
<td align="center" valign="top">
|
||||||
|
<button type="button" onClick="oPsendXRP()">< Send XRP</button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="oPcreateTrustline()">Create TrustLine</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPsendCurrency()">Send Currency</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="getBalances()">Get Balances</button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="oPmintToken()">Mint NFToken</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPgetTokens()">Get NFTokens</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPburnToken()">Burn NFToken</button>
|
||||||
|
<br/><br/>
|
||||||
|
<button type="button" onClick="oPcreateSellOffer()">Create Sell Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPacceptSellOffer()">Accept Sell Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPcreateBuyOffer()">Create Buy Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPacceptBuyOffer()">Accept Buy Offer</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPgetOffers()">Get Offers</button>
|
||||||
|
<br/>
|
||||||
|
<button type="button" onClick="oPcancelOffer()">Cancel Offer</button>
|
||||||
|
</td>
|
||||||
|
<td valign="top" align="right">
|
||||||
|
<button type="button" onClick="getAccount('operational')">Get New Operational Account</button>
|
||||||
|
<table>
|
||||||
|
<tr valign="top">
|
||||||
|
<td align="right">
|
||||||
|
Operational Account
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalAccountField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Public Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalPubKeyField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Private Key
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalPrivKeyField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Seed
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalSeedField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
XRP Balance
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalBalanceField" size="40"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Amount
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalAmountField" size="40" value="100"></input>
|
||||||
|
<br>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td>
|
||||||
|
</td>
|
||||||
|
<td align="right"> <input type="checkbox" id="operationalDefault" checked="true"/>
|
||||||
|
<label for="operationalDefault">Allow Rippling</label>
|
||||||
|
<button type="button" onClick="configureAccount('operational',document.querySelector('#operationalDefault').checked)">Configure Account</button>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">
|
||||||
|
Currency
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<input type="text" id="operationalCurrencyField" size="40" value="USD"></input>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken URL</td>
|
||||||
|
<td><input type="text" id="operationalTokenUrlField"
|
||||||
|
value = "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26nf4dfuylqabf3oclgtqy55fbzdi" size="80"/>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Flags</td>
|
||||||
|
<td><input type="text" id="operationalFlagsField" value="1" size="10"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken ID</td>
|
||||||
|
<td><input type="text" id="operationalTokenIdField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">NFToken Offer Index</td>
|
||||||
|
<td><input type="text" id="operationalTokenOfferIndexField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Owner</td>
|
||||||
|
<td><input type="text" id="operationalOwnerField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Destination</td>
|
||||||
|
<td><input type="text" id="operationalDestinationField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Expiration</td>
|
||||||
|
<td><input type="text" id="operationalExpirationField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td align="right">Transfer Fee</td>
|
||||||
|
<td><input type="text" id="operationalTransferFeeField" value="" size="80"/></td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
<p align="right">
|
||||||
|
<textarea id="operationalResultField" cols="80" rows="20" ></textarea>
|
||||||
|
</p>
|
||||||
|
</td>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
</form>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
Reference in New Issue
Block a user