Fix sidebar highlight color issues in Realm 0.132

Claude Code Release Notes Skill

.claude/CLAUDE.md

@@ -0,0 +1,19 @@
+# XRPL Dev Portal — Claude Code Instructions
+
+## Quick Reference
+
+- **Framework:** Redocly Realm
+- **Production branch:** `master`
+- **Local preview:** `npm start`
+
+## Localization
+
+- Default: `en-US`
+- Japanese: `ja`
+- Translations mirror `docs/` structure under `@l10n/<language-code>/`
+
+## Navigation
+
+- Update `sidebars.yaml` when adding new doc pages
+- Blog posts have a separate `blog/sidebars.yaml`
+- Redirects go in `redirects.yaml`

.claude/settings.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "deny": [
+      "Bash(git push *)"
+    ]
+  }
+}

.claude/skills/generate-release-notes/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: generate-release-notes
+description: Generate and sort rippled release notes from GitHub commit history
+argument-hint: --from <ref> --to <ref> [--date YYYY-MM-DD] [--output <path>]
+allowed-tools: Bash, Read, Edit, Write, Grep, Glob
+effort: max
+---
+
+# Generate rippled Release Notes
+
+This skill generates a draft release notes blog post for a new rippled version, then sorts the entries into the correct subsections.
+
+## Execution constraints
+
+- **Do NOT write scripts** to sort or process the file. Prefer the Edit tool for targeted changes. Use Write only when replacing large sections that are impractical to edit incrementally.
+- **Output progress**: Before each major step (generating raw release notes, reviewing file, processing amendments, sorting entries, reformatting, cleanup), output a brief status message so the user can see progress.
+
+## Step 1: Generate the raw release notes
+
+Run the Python script from the repo root. Pass through all arguments from `$ARGUMENTS`:
+
+```bash
+python3 tools/generate-release-notes.py $ARGUMENTS
+```
+
+If the user didn't provide `--from` or `--to`, ask them for the base and target refs (tags or branches).
+
+The script will:
+- Fetch the version string from `BuildInfo.cpp`
+- Fetch all commits between the two refs
+- Fetch PR details (title, link, labels, files, description) via GraphQL
+- Compare `features.macro` between refs to identify amendment changes
+- Auto-sort amendment entries into the Amendments section
+- Output all other entries as unsorted with full context
+
+## Step 2: Review the generated file
+
+Read the output file (path shown in script output). Note the **Full Changelog** structure:
+- **Amendments section**: Contains auto-sorted entries and an HTML comment listing which amendments to include or remove
+- **Empty subsections**: Features, Breaking Changes, Bug Fixes, Refactors, Documentation, Testing, CI/Build
+- **Unsorted entries**: After the **Bug Bounties and Responsible Disclosures** section is an unsorted list of entries with title, link, labels, files, and description for context
+
+## Step 3: Process amendments
+
+Handle Amendments first, before sorting other entries.
+
+**3a. Process the auto-sorted Amendments subsection:**
+The HTML comment contains three lists — follow them exactly:
+- **Include**: Keep these entries.
+- **Exclude**: Remove these entries.
+- Entries on **neither** list: Remove these entries.
+
+**3b. Scan unsorted entries for unreleased amendment work:**
+Search through ALL unsorted entries for titles, labels, descriptions, or files that reference amendments on the "Exclude" or "Other amendments not part of this release" lists. Remove entries that directly implement, enable, fix, or refactor these amendments. Keep entries that are general changes that merely reference the amendment as motivation — if the code change is useful on its own regardless of whether the amendment ships, keep it.
+
+**3c. If you disagree with any amendment decisions, make a note to the user but do NOT deviate from the rules.**
+
+## Step 4: Sort remaining unsorted entries into subsections
+
+Move each remaining unsorted entry into the appropriate subsection.
+
+Use these signals to categorize:
+
+**Files changed** (strongest signal):
+- Only `.github/`, `CMakeLists.txt`, `conan*`, CI config files → **CI/Build**
+- Only `src/test/`, `*_test.cpp` files → **Testing**
+- Only `*.md`, `docs/` files → **Documentation**
+
+**Labels** (strong signal):
+- `Bug` label → **Bug Fixes**
+
+**Title prefixes** (medium signal):
+- `fix:` → **Bug Fixes**
+- `feat:` → **Features**
+- `refactor:` → **Refactors**
+- `docs:` → **Documentation**
+- `test:` → **Testing**
+- `ci:`, `build:`, `chore:` → **CI/Build**
+
+**Description content** (when other signals are ambiguous):
+- Read the PR description to understand the change's purpose
+- PRs that change API behavior, remove features, or have "Breaking change" checked in their description → **Breaking Changes**
+
+Additional sorting guidance:
+- Watch for revert pairs: If a PR was committed and then reverted (or vice versa), check that the net effect is accounted for — don't include both.
+
+## Step 5: Reformat sorted entries
+
+After sorting, reformat each entry to match the release notes style.
+
+**Amendment entries** should follow this format:
+```markdown
+- **amendmentName**: Description of what the amendment does. ([#1234](https://github.com/XRPLF/rippled/pull/1234))
+```
+- Use more detail for amendment descriptions since they are the most important. Use present tense.
+- If there are multiple entries for the same amendment, merge into one, prioritizing the entry that describes the actual amendment.
+
+**Feature and Breaking Change entries** should follow this format:
+```markdown
+- Description of the change. ([#1234](https://github.com/XRPLF/rippled/pull/1234))
+```
+- Keep the description concise. Use past tense.
+
+**All other entries** should follow this format:
+```markdown
+- The PR title of the entry. ([#1234](https://github.com/XRPLF/rippled/pull/1234))
+```
+- Copy the PR title as-is. Only fix capitalization, remove conventional commit prefixes (fix:, feat:, ci:, refactor:, docs:, test:, chore:, build:), and adjust to past tense if needed. Do NOT rewrite, paraphrase, or summarize.
+
+## Step 6: Clean up
+
+- Add a short and generic description of changes to the existing `seo.description` frontmatter, e.g., "This version introduces new amendments and bug fixes." Do not create long lists of detailed changes.
+- Add a more detailed summary of the release to the existing "Introducing XRP Ledger Version X.Y.Z" section. Include amendment names (organized in a list if more than 2), featuress, and breaking changes. Limit this to 1 paragraph.
+- Do NOT delete the **Credits** or **Bug Bounties and Responsible Disclosures** sections
+- Remove empty subsections that have no entries
+- Remove all HTML comments (sorting instructions)
+- Do a final review of the release notes. If you see anything strange, or were forced to take unintuitive actions by these instructions, notify the user, but don't make changes.

@theme/plugin.js

@@ -1,13 +1,15 @@
 import { indexPages } from './plugins/index-pages.js';
 import { codeSamples } from './plugins/code-samples.js';
 import { blogPosts } from './plugins/blog-posts.js';
-import { tutorialLanguages } from './plugins/tutorial-languages.js'
+import { tutorialLanguages } from './plugins/tutorial-languages.js';
+import { tutorialMetadata } from './plugins/tutorial-metadata.js';
 
 export default function customPlugin() {
   const indexPagesInst = indexPages();
   const codeSamplesInst = codeSamples();
   const blogPostsInst = blogPosts();
   const tutorialLanguagesInst = tutorialLanguages();
+  const tutorialMetadataInst = tutorialMetadata();
 
 
   /** @type {import("@redocly/realm/dist/server/plugins/types").PluginInstance } */
@@ -18,12 +20,14 @@ export default function customPlugin() {
       await codeSamplesInst.processContent?.(content, actions);
       await blogPostsInst.processContent?.(content, actions);
       await tutorialLanguagesInst.processContent?.(content, actions);
+      await tutorialMetadataInst.processContent?.(content, actions);
     },
     afterRoutesCreated: async (content, actions) => {
       await indexPagesInst.afterRoutesCreated?.(content, actions);
       await codeSamplesInst.afterRoutesCreated?.(content, actions);
       await blogPostsInst.afterRoutesCreated?.(content, actions);
       await tutorialLanguagesInst.processContent?.(content, actions);
+      await tutorialMetadataInst.processContent?.(content, actions);
     },
   };
 

@theme/plugins/tutorial-languages.js

@@ -1,7 +1,15 @@
 // @ts-check
 
+import { getInnerText } from '@redocly/realm/dist/markdoc/helpers/get-inner-text.js'
+
 /**
- * Plugin to detect languages supported in tutorial pages by scanning for tab labels.
+ * Plugin to detect languages supported in tutorial pages.
+ *
+ * Detection methods (in priority order):
+ * 1. Tab labels in the markdown (for multi-language tutorials)
+ * 2. Filename patterns like "-js.md", "-py.md" (for single-language tutorials)
+ * 3. Title containing language name (for single-language tutorials)
+ *
  * This creates shared data that maps tutorial paths to their supported languages.
  */
 export function tutorialLanguages() {
@@ -21,7 +29,18 @@ export function tutorialLanguages() {
         for (const { relativePath } of tutorialFiles) {
           try {
             const { data } = await cache.load(relativePath, 'markdown-ast')
-            const languages = extractLanguagesFromAst(data.ast)
+
+            // Try to detect languages from tab labels first
+            let languages = extractLanguagesFromAst(data.ast)
+
+            // Fallback: detect language from filename/title for single-language tutorials
+            if (languages.length === 0) {
+              const title = extractFirstHeading(data.ast) || ''
+              const fallbackLang = detectLanguageFromPathAndTitle(relativePath, title)
+              if (fallbackLang) {
+                languages = [fallbackLang]
+              }
+            }
 
             if (languages.length > 0) {
               // Convert file path to URL path
@@ -54,16 +73,31 @@ function extractLanguagesFromAst(ast) {
   const languages = new Set()
 
   visit(ast, (node) => {
-    // Look for tab nodes with a label attribute
-    if (isNode(node) && node.type === 'tag' && node.tag === 'tab') {
+    if (!isNode(node)) return
+
+    // Detect languages from tab labels
+    if (node.type === 'tag' && node.tag === 'tab') {
       const label = node.attributes?.label
       if (label) {
-        const normalizedLang = normalizeLanguage(label)
-        if (normalizedLang) {
-          languages.add(normalizedLang)
-        }
+        const normalized = normalizeLanguage(label)
+        if (normalized) languages.add(normalized)
       }
     }
+
+    // Detect languages from code-snippet language attributes
+    if (node.type === 'tag' && node.tag === 'code-snippet') {
+      const lang = node.attributes?.language
+      if (lang) {
+        const normalized = normalizeLanguage(lang)
+        if (normalized) languages.add(normalized)
+      }
+    }
+
+    // Detect languages from fenced code blocks (```js, ```python, etc.)
+    if (node.type === 'fence' && node.attributes?.language) {
+      const normalized = normalizeLanguage(node.attributes.language)
+      if (normalized) languages.add(normalized)
+    }
   })
 
   return Array.from(languages)
@@ -98,6 +132,70 @@ function normalizeLanguage(label) {
   return null
 }
 
+/**
+ * Detect language from file path and title for single-language tutorials.
+ * This is a fallback when no tab labels are found in the markdown.
+ */
+function detectLanguageFromPathAndTitle(relativePath, title) {
+  const pathLower = relativePath.toLowerCase()
+  const titleLower = (title || '').toLowerCase()
+
+  // Check filename suffixes like "-js.md", "-py.md"
+  if (pathLower.endsWith('-js.md') || pathLower.includes('-javascript.md') || pathLower.includes('-in-javascript.md')) {
+    return 'javascript'
+  }
+  if (pathLower.endsWith('-py.md') || pathLower.includes('-python.md') || pathLower.includes('-in-python.md')) {
+    return 'python'
+  }
+  if (pathLower.endsWith('-java.md') || pathLower.includes('-in-java.md')) {
+    return 'java'
+  }
+  if (pathLower.endsWith('-go.md') || pathLower.includes('-in-go.md') || pathLower.includes('-golang.md')) {
+    return 'go'
+  }
+  if (pathLower.endsWith('-php.md') || pathLower.includes('-in-php.md')) {
+    return 'php'
+  }
+
+  // Check title for language indicators
+  if (titleLower.includes('javascript') || titleLower.includes(' js ') || titleLower.endsWith(' js')) {
+    return 'javascript'
+  }
+  if (titleLower.includes('python')) {
+    return 'python'
+  }
+  if (titleLower.includes('java') && !titleLower.includes('javascript')) {
+    return 'java'
+  }
+  if (titleLower.includes('golang') || (titleLower.includes(' go ') || titleLower.endsWith(' go') || titleLower.includes('using go'))) {
+    return 'go'
+  }
+  if (titleLower.includes('php')) {
+    return 'php'
+  }
+
+  return null
+}
+
+const EXIT = Symbol('Exit visitor')
+
+/**
+ * Extract the first heading from the markdown AST
+ */
+function extractFirstHeading(ast) {
+  let heading = null
+
+  visit(ast, (node) => {
+    if (!isNode(node)) return
+    if (node.type === 'heading') {
+      heading = getInnerText([node])
+      return EXIT
+    }
+  })
+
+  return heading
+}
+
 function isNode(value) {
   return !!(value?.$$mdtype === 'Node')
 }
@@ -105,14 +203,16 @@ function isNode(value) {
 function visit(node, visitor) {
   if (!node) return
 
-  visitor(node)
+  const res = visitor(node)
+  if (res === EXIT) return res
 
   if (node.children) {
     for (const child of node.children) {
       if (!child || typeof child === 'string') {
         continue
       }
-      visit(child, visitor)
+      const res = visit(child, visitor)
+      if (res === EXIT) return res
     }
   }
 }

@theme/plugins/tutorial-metadata.js

@@ -0,0 +1,207 @@
+// @ts-check
+
+import { getInnerText } from '@redocly/realm/dist/markdoc/helpers/get-inner-text.js';
+import { readFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = resolve(__dirname, '../..');
+
+/**
+ * Plugin to extract tutorial metadata including last modified dates.
+ * Uses Redocly's built-in git integration for dates (same as "Last updated" display).
+ * Only includes tutorials that appear in the sidebar navigation (sidebars.yaml).
+ * This creates shared data for displaying "What's New" tutorials and
+ * auto-generating tutorial sections on the landing page.
+ */
+export function tutorialMetadata() {
+  /** @type {import("@redocly/realm/dist/server/plugins/types").PluginInstance } */
+  const instance = {
+    processContent: async (actions, { fs, cache }) => {
+      try {
+        // Extract tutorial paths and categories from sidebars.yaml.
+        // Only tutorials present in the sidebar are included.
+        const { pageCategory, categories } = extractSidebarData();
+
+        /** @type {Array<{path: string, title: string, description: string, lastModified: string, category: string}>} */
+        const tutorials = [];
+        const allFiles = await fs.scan();
+
+        // Find all markdown files in tutorials directory
+        const tutorialFiles = allFiles.filter((file) =>
+          file.relativePath.match(/^docs[\/\\]tutorials[\/\\].*\.md$/)
+        );
+
+        for (const { relativePath } of tutorialFiles) {
+          try {
+            // Skip tutorials not present in sidebar navigation
+            const category = pageCategory.get(relativePath);
+            if (!category) continue;
+
+            const { data: { ast } } = await cache.load(relativePath, 'markdown-ast');
+            const { data: { frontmatter } } = await cache.load(relativePath, 'markdown-frontmatter');
+
+            // Get last modified date using Redocly's built-in git integration
+            const lastModified = await fs.getLastModified(relativePath);
+            if (!lastModified) continue; // Skip files without dates
+
+            // Extract title from first heading
+            const title = extractFirstHeading(ast) || '';
+            if (!title) continue;
+
+            // Get description from frontmatter or first paragraph
+            const description = frontmatter?.seo?.description || '';
+
+            // Convert file path to URL path
+            const urlPath = '/' + relativePath
+              .replace(/[\/\\]index\.md$/, '/')
+              .replace(/\.md$/, '/')
+              .replace(/\\/g, '/');
+
+            tutorials.push({
+              path: urlPath,
+              title,
+              description,
+              lastModified,
+              category,
+            });
+          } catch (err) {
+            continue; // Skip files that can't be parsed
+          }
+        }
+
+        // Sort by last modified date (newest first) for "What's New"
+        tutorials.sort((a, b) =>
+          new Date(b.lastModified).getTime() - new Date(a.lastModified).getTime()
+        );
+
+        // Create shared data including sidebar-derived categories
+        actions.createSharedData('tutorial-metadata', { tutorials, categories });
+        actions.addRouteSharedData('/docs/tutorials/', 'tutorial-metadata', 'tutorial-metadata');
+        actions.addRouteSharedData('/ja/docs/tutorials/', 'tutorial-metadata', 'tutorial-metadata');
+        actions.addRouteSharedData('/es-es/docs/tutorials/', 'tutorial-metadata', 'tutorial-metadata');
+      } catch (e) {
+        console.log('[tutorial-metadata] Error:', e);
+      }
+    },
+  };
+  return instance;
+}
+
+/**
+ * Extract the first heading from the markdown AST
+ */
+function extractFirstHeading(ast) {
+  let heading = null;
+
+  visit(ast, (node) => {
+    if (!isNode(node)) return;
+    if (node.type === 'heading') {
+      heading = getInnerText([node]);
+      return EXIT;
+    }
+  });
+
+  return heading;
+}
+
+function isNode(value) {
+  return !!(value?.$$mdtype === 'Node');
+}
+
+const EXIT = Symbol('Exit visitor');
+
+function visit(node, visitor) {
+  if (!node) return;
+
+  const res = visitor(node);
+  if (res === EXIT) return res;
+
+  if (node.children) {
+    for (const child of node.children) {
+      if (!child || typeof child === 'string') continue;
+      const res = visit(child, visitor);
+      if (res === EXIT) return res;
+    }
+  }
+}
+
+/**
+ * Extract tutorial page paths and categories from sidebars.yaml.
+ *
+ * Returns:
+ * - pageCategory: Map of relativePath to category id (slug)
+ * - categories: Array of { id, title } in sidebar display order
+ *
+ * Top-level groups under the tutorials section become categories.
+ * Pages not inside a group (e.g. public-servers.md) are skipped.
+ */
+function extractSidebarData() {
+  /** @type {Map<string, string>} */
+  const pageCategory = new Map();
+  /** @type {Array<{id: string, title: string}>} */
+  const categories = [];
+
+  try {
+    const content = readFileSync(resolve(PROJECT_ROOT, 'sidebars.yaml'), 'utf-8');
+    const lines = content.split('\n');
+
+    let inTutorials = false;
+    let entryIndent = -1;       // indent of the tutorials entry itself
+    let topItemIndent = -1;     // indent of direct children (groups/pages)
+    let currentCategory = null; // current top-level group { id, title }
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      const indent = line.search(/\S/);
+
+      // Detect the tutorials section
+      if (trimmed.includes('page: docs/tutorials/index.page.tsx')) {
+        inTutorials = true;
+        entryIndent = indent;
+        continue;
+      }
+
+      if (!inTutorials) continue;
+
+      // Exit tutorials when we reach a sibling entry at the same indent
+      if (indent <= entryIndent && trimmed.startsWith('- ')) {
+        break;
+      }
+
+      // Detect the indent of top-level items (first `- ` under tutorials items)
+      if (topItemIndent === -1 && trimmed.startsWith('- ')) {
+        topItemIndent = indent;
+      }
+
+      // Top-level group - start a new category
+      if (indent === topItemIndent && trimmed.startsWith('- group:')) {
+        const title = trimmed.replace('- group:', '').trim();
+        const id = title.toLowerCase().replace(/\s+/g, '-');
+        currentCategory = { id, title };
+        categories.push(currentCategory);
+        continue;
+      }
+
+      // Top-level page (no group, e.g. public-servers.md) - reset current category
+      if (indent === topItemIndent && trimmed.startsWith('- page:')) {
+        currentCategory = null;
+        continue;
+      }
+
+      // Nested page under a group - assign to current category
+      if (currentCategory) {
+        const pageMatch = trimmed.match(/^- page:\s+(docs\/tutorials\/\S+\.md)/);
+        if (pageMatch) {
+          pageCategory.set(pageMatch[1], currentCategory.id);
+        }
+      }
+    }
+  } catch (err) {
+    console.log('[tutorial-metadata] Warning: Could not read sidebars.yaml:', String(err));
+  }
+
+  return { pageCategory, categories };
+}

@theme/styles.css

@@ -233,6 +233,7 @@ ul.nav.navbar-nav {
   --footer-title-text-color: var(--color-gray-6);
 
   --menu-item-padding-horizontal: 0px;
+  --menu-item-bg-color-active: var(--color-gray-2);
 
   --md-list-left-padding: 40px;
   --md-list-margin: 0 0 20px 0;
@@ -278,6 +279,8 @@ ul.nav.navbar-nav {
   --bg-color-raised: var(--color-gray-8);
   --button-content-color-link: black;
 
+  --menu-item-bg-color-active: var(--color-gray-8);
+
   --md-table-header-bg-color: var(--color-gray-8);
   --md-table-border-color: var(--color-gray-8);
 
@@ -285,6 +288,7 @@ ul.nav.navbar-nav {
   --code-panel-bg-color: var(--color-blue-7);
   --layer-color-hover: var(--color-gray-9);
 
+
   --code-block-text-color: var(--color-gray-1);
   --code-block-tokens-comment-color: var(--color-gray-4);
   --code-block-tokens-constant-color: var(--color-gray-1);

_code-samples/airgapped-wallet/js/.gitignore

@@ -1 +0,0 @@
-Wallet/

_code-samples/airgapped-wallet/js/README.md

@@ -1,92 +0,0 @@
-# Airgapped Wallet
-Airgapped describes a state where a device or a system becomes fully disconnected from other devices and systems. It is the maximum protection for a system against unwanted visitors/viruses, this allows any sensitive data like a private key to be stored without worry of it being compromised as long as reasonable security practices are being practiced.
-
-This airgapped XRP wallet allows users to sign a Payment transaction in a secure environment without the private key being exposed to a machine connected to the internet. The private key and seed is encrypted by password and stored securely.
-
-*Note*: You should not use this airgapped wallet in production, it should only be used for educational purposes only. 
-
-This code sample consists of 2 parts:
-
-- `airgapped-wallet.js` - This code should be stored in a standalone airgapped machine, it consist of features to generate a wallet, store a keypair securely, sign a transaction and share the signed transaction via QR code.
-- `relay-transaction.js` - This code could be stored in any online machine, no credentials is stored on this code other than a signed transaction which would be sent to an XRPL node for it to be validated on the ledger.
-
-Preferably, `airgapped-wallet.js` should be on a Linux machine while `relay-transaction.js` could be on any operating system.
-
-# Security Practices
-Strongly note that an airgapped system's security is not determined by its code alone but the security practices that are being followed by an operator.
-
-There are channels that can be maliciously used by outside parties to infiltrate an airgapped system and steal sensitive information.
-
-There are other ways malware could interact across airgapped networks, but they all involve an infected USB drive or a similar device introducing malware onto the airgapped machine. They could also involve a person physically accessing the computer, compromising it and installing malware or modifying its hardware.
-
-This is why it is also recommended to encrypt sensitive information being stored in an airgapped machine.
-
-The airgapped machine should have a few rules enforced to close any possible channels getting abused to leak information outside of the machine:
-
-### Wifi
-
-- Disable any wireless networking hardware on the airgapped machine. For example, if you have a desktop PC with a Wifi card, open the PC and remove the Wifi hardware. If you cannot do that, you could go to the system’s BIOS or UEFI firmware and disable the Wifi hardware.
-
-### BlueTooth
-
-- BlueTooth can be maliciously used by neighboring devices to steal data from an airgapped machine. It is recommended to remove or disable the BlueTooth hardware.  
-
-### USB
-
-- The USB port can be used to transfer files in and out of the airgapped machine and this may act as a threat to an airgapped machine if the USB drive is infected with a malware. So after installing & setting up this airgapped wallet, it is highly recommended to block off all USB ports by using a USB blocker and not use them.
-
-Do not reconnect the airgapped machine to a network, even when you need to transfer files! An effective airgapped machine should only serve 1 purpose, which is to store data and never open up a gateway for hackers to abuse and steal data.
-
-# Tutorial
-For testing purposes, you would need to have 2 machines and 1 phone in hand to scan the QR code.
-
-1. 1st machine would be airgapped, following the security practices written [here](#security-practices). It stores and manages an XRPL Wallet. 
-2. 2nd machine would be a normal computer connected to the internet. It relays a signed transaction blob to a rippled node.
-3. The phone would be used to scan a QR code, which contains a signed transaction blob. The phone would transmit it to the 2nd machine.
-
-The diagram below shows you the process of submitting a transaction to the XRPL:
-<p align="center">
-  <img src="https://user-images.githubusercontent.com/87929946/197970678-2a1b7f7e-d91e-424e-915e-5ba7d34689cc.png" width=75% height=75%>
-</p>
-
-# Setup
-- Machine 1 - An airgapped computer (during setup, it must be connected to the internet to download the files)
-- Machine 2 - A normal computer connected to the internet
-- Phone - A normal phone with a working camera to scan a QR
-
-## Machine 1 Setup
-Since this machine will be airgapped, it is best to use Linux as the Operating System.
-
-1. Clone all the files under the [`airgapped-wallet`](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/airgapped-wallet/js) directory
-
-2. Import all the modules required by running: `npm install`
-
-3. Airgap the machine by following the security practices written [here](#security-practices).
-
-4. Run `node airgapped-wallet.js`
-
-5. Scan the QR code and fund the account using the [testnet faucet](https://test.bithomp.com/faucet/) 
-
-6. Re-run the script and input '1' to generate a new transaction by following the instructions.
-
-7. Use your phone to scan the QR code, then to send the signed transaction to Machine 2 for submission
-
-## Phone Setup
-The phone requires a working camera that is able to scan a QR code and an internet connection for it to be able to transmit the signed transaction blob to Machine 2.
-
-Once you have signed a transaction in the airgapped machine, a QR code will be generated which will contain the signed transaction blob. Example:
-
-<img src="https://user-images.githubusercontent.com/87929946/196018292-f210a9f2-c5f8-412e-98c1-361a72286378.png" width=20% height=20%>
-
-Scan the QR code using the phone, copy it to the clipboard,  and transmit it to Machine 2, which will then be sending it to a rippled node.
-
-You can send a message to yourself using Discord, WhatsApp or even e-mail, then open up the message using Machine 2 to receive the signed transaction blob.
-
-## Machine 2 Setup
-This machine will be used to transmit a signed transaction blob from Machine 1, it would require internet access.
-
-1. Clone all the files under the [`airgapped-wallet`](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/airgapped-wallet/js) directory
-
-2. Import all the modules required by running `npm install`
-
-3. Run `relay-transaction.js` and copy-and-paste the received output of Machine 1 when prompted

_code-samples/airgapped-wallet/js/airgapped-wallet.js

@@ -1,223 +0,0 @@
-const crypto = require("crypto")
-const fs = require('fs')
-const fernet = require("fernet");
-const open = require('open');
-const path = require('path')
-const prompt = require('prompt')
-const { generateSeed, deriveAddress, deriveKeypair } = require("ripple-keypairs/dist/")
-const QRCode = require('qrcode')
-const xrpl = require('xrpl')
-
-const demoAccountSeed = 'sskwYQmxT7SA37ceRaGXA5PhQYrDS'
-const demoAccountAddress = 'rEDd3Wy76Ta1WqfDP2DcnBKHu31SpSiUQrS'
-
-const demoDestinationSeed = 'sEdVokfq7fVXXjZTii2WhtpqGbJni6s'
-const demoDestinationAddress = 'rBgNowfkmPczhMjHRYnBPsuSodDHWHQLdj'
-
-const FEE = '12'
-const LEDGER_OFFSET = 300
-const WALLET_DIR = 'Wallet'
-
-/**
- * Generates a new (unfunded) wallet
- *
- * @returns {{address: *, seed: *}}
- */
-createWallet = function () {
-    const seed = generateSeed()
-    const {publicKey, privateKey} = deriveKeypair(seed)
-    const address = deriveAddress(publicKey)
-
-    console.log(
-        "XRP Wallet Credentials " +
-        "Wallet Address: " + address +
-        "Seed: " + seed
-    )
-
-    return {address, seed}
-}
-
-/**
- * Signs transaction and returns signed transaction blob in QR code
- *
- * @param xrpAmount
- * @param destination
- * @param ledgerSequence
- * @param walletSequence
- * @param password
- * @returns {Promise<void>}
- */
-signTransaction = async function (xrpAmount, destination, ledgerSequence, walletSequence, password) {
-
-    const salt = fs.readFileSync(path.join(__dirname, WALLET_DIR , 'salt.txt')).toString()
-
-    const encodedSeed = fs.readFileSync(path.join(__dirname, WALLET_DIR , 'seed.txt')).toString()
-
-    // Hashing salted password using Password-Based Key Derivation Function 2
-    const derivedKey = crypto.pbkdf2Sync(password, salt, 1000, 32, 'sha256')
-
-    // Generate a Fernet secret we can use for symmetric encryption
-    const secret = new fernet.Secret(derivedKey.toString('base64'));
-
-    // Generate decryption token
-    const token = new fernet.Token({
-        secret: secret,
-        token: encodedSeed,
-        ttl: 0
-    })
-    const seed = token.decode();
-
-    const wallet = xrpl.Wallet.fromSeed(seed)
-
-    const paymentTx = {
-        'TransactionType': 'Payment',
-        'Account': wallet.classicAddress,
-        'Amount': xrpl.xrpToDrops(xrpAmount),
-        'Destination': destination
-    }
-
-    // Normally we would fetch certain needed values like Fee,
-    // LastLedgerSequence snd programmatically, like so:
-    //
-    // const preparedTx = await client.autofill(paymentTx)
-    //
-    // But since this is an airgapped wallet without internet
-    // connection, we have to do it manually:
-    //
-    // paymentTx.Sequence is set in setNextValidSequenceNumber() via sugar/autofill
-    // paymentTx.LastLedgerSequence is set in setLatestValidatedLedgerSequence() via sugar/autofill
-    // paymentTx.Fee is set in getFeeXrp() via sugar/getFeeXrp
-
-    paymentTx.Sequence = walletSequence
-    paymentTx.LastLedgerSequence = ledgerSequence + LEDGER_OFFSET
-    paymentTx.Fee = FEE
-
-    const signedTx = wallet.sign(paymentTx)
-
-    fs.writeFileSync(path.join(__dirname, WALLET_DIR , 'tx_blob.txt'), signedTx.tx_blob)
-    QRCode.toFile(path.join(__dirname, WALLET_DIR , 'tx_blob.png'), signedTx.tx_blob)
-
-    open(path.join(__dirname, WALLET_DIR , 'tx_blob.png'))
-}
-
-main = async function () {
-
-    if (!fs.existsSync(WALLET_DIR )) {
-        // Create Wallet directory in case it does not exist yet
-        fs.mkdirSync(path.join(__dirname, WALLET_DIR ));
-    }
-
-    if (!fs.existsSync(path.join(__dirname, WALLET_DIR , 'address.txt'))) {
-        // Generate a new (unfunded) Wallet
-        const {address, seed} = createWallet()
-
-        prompt.start();
-
-        const {password} = await prompt.get([{
-            name: 'password',
-            description: 'Creating a brand new Wallet, please enter a new password \n Enter Password:',
-            type: 'string',
-            required: true
-        }])
-
-        prompt.stop();
-
-        const salt = crypto.randomBytes(20).toString('hex')
-
-        fs.writeFileSync(path.join(__dirname, WALLET_DIR , 'salt.txt'), salt);
-
-        // Hashing salted password using Password-Based Key Derivation Function 2
-        const derivedKey = crypto.pbkdf2Sync(password, salt, 1000, 32, 'sha256')
-
-        // Generate a Fernet secret we can use for symmetric encryption
-        const secret = new fernet.Secret(derivedKey.toString('base64'));
-
-        // Generate encryption token with secret, time and initialization vector
-        // In a real-world use case we would have current time and a random IV,
-        // but for demo purposes being deterministic is just fine
-        const token = new fernet.Token({
-            secret: secret,
-            time: Date.parse(1),
-            iv: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
-        })
-
-        const privateKey = token.encode(seed)
-
-        fs.writeFileSync(path.join(__dirname, WALLET_DIR , 'seed.txt'), privateKey)
-        fs.writeFileSync(path.join(__dirname, WALLET_DIR , 'address.txt'), address)
-        QRCode.toFile(path.join(__dirname, WALLET_DIR , 'address.png'), address)
-
-        console.log(''
-            + 'Finished generating an account.\n'
-            + 'Wallet Address: ' + address + '\n'
-            + 'Please scan the QR code on your phone and use https://test.bithomp.com/faucet/ to fund the account.\n'
-            + 'After that, you\'re able to sign transactions and transmit them to Machine 2 (online machine).')
-
-        return
-    }
-
-    prompt.start();
-
-    console.log(''
-        + '1. Transact XRP.\n'
-        + '2. Generate an XRP wallet (read only)\n'
-        + '3. Showcase XRP Wallet Address (QR Code)\n'
-        + '4. Exit')
-
-    const {menu} = await prompt.get([{
-        name: 'menu',
-        description: 'Enter Index:',
-        type: 'integer',
-        required: true
-    }])
-
-    if (menu === 1) {
-        const {
-            password,
-            xrpAmount,
-            destinationAddress,
-            accountSequence,
-            ledgerSequence
-        } = await prompt.get([{
-            name: 'password',
-            description: 'Enter Password',
-            type: 'string',
-            required: true
-        }, {
-            name: 'xrpAmount',
-            description: 'Enter XRP To Send',
-            type: 'number',
-            required: true
-        }, {
-            name: 'destinationAddress',
-            description: 'If you just want to try it out, you can use the faucet account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe. Enter Destination',
-            type: 'string',
-            required: true
-        }, {
-            name: 'accountSequence',
-            description: 'Look up the \'Next Sequence\' for the account using test.bithomp.com and enter it',
-            type: 'integer',
-            required: true
-        }, {
-            name: 'ledgerSequence',
-            description: 'Look up the latest ledger sequence on testnet.xrpl.org and enter it below!',
-            type: 'integer',
-            required: true
-        }])
-
-        await signTransaction(xrpAmount, destinationAddress, ledgerSequence, accountSequence, password)
-    } else if (menu === 2) {
-        const {address, seed} = createWallet()
-        console.log('Generated readonly Wallet (address: ' + address + ' seed: ' + seed + ')')
-    } else if (menu === 3) {
-        const address = fs.readFileSync(path.join(__dirname, WALLET_DIR , 'address.txt')).toString()
-        console.log('Wallet Address: ' + address)
-        open(path.join(__dirname, WALLET_DIR , 'address.png'))
-    } else {
-        return
-    }
-
-    prompt.stop();
-}
-
-main()

_code-samples/airgapped-wallet/js/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "airgapped-wallet",
-  "version": "0.1.0",
-  "license": "MIT",
-  "dependencies": {
-    "fernet": "^0.4.0",
-    "open": "^8.4.0",
-    "pbkdf2-hmac": "^1.1.0",
-    "prompt": "^1.3.0",
-    "qrcode": "^1.5.1",
-    "xrpl": "^4.0.0"
-  },
-  "main": "index.js",
-  "scripts": {
-    "start": "node index.js",
-    "test": "echo \"Error: no test specified\" && exit 1"
-  }
-}

_code-samples/airgapped-wallet/js/relay-transaction.js

@@ -1,37 +0,0 @@
-const prompt = require('prompt')
-const xrpl = require('xrpl')
-
-sendTransaction = async function (tx_blob) {
-    const client = new xrpl.Client('wss://s.altnet.rippletest.net:51233')
-    await client.connect()
-
-    console.log("Connected to node")
-
-    const tx = await client.submitAndWait(tx_blob)
-
-    const txHash = tx.result.hash
-    const txDestination = tx.result.Destination
-    const txXrpAmount = xrpl.dropsToXrp(tx.result.Amount)
-    const txAccount = tx.result.Account
-
-    console.log("XRPL Explorer: https://testnet.xrpl.org/transactions/" + txHash)
-    console.log("Transaction Hash: " + txHash)
-    console.log("Transaction Destination: " + txDestination)
-    console.log("XRP sent: " + txXrpAmount)
-    console.log("Wallet used: " + txAccount)
-
-    await client.disconnect()
-}
-
-main = async function () {
-    const {tx_blob} = await prompt.get([{
-        name: 'tx_blob',
-        description: 'Set tx to \'tx_blob\' received from scanning the QR code generated by the airgapped wallet',
-        type: 'string',
-        required: true
-    }])
-
-    await sendTransaction(tx_blob)
-}
-
-main()

_code-samples/airgapped-wallet/py/README.md

@@ -1,115 +0,0 @@
-# Airgapped Wallet
-Airgapped describes a state where a device or a system becomes fully disconnected from other devices and systems. It is the maximum protection for a system against unwanted visitors/viruses, this allows any sensitive data like a private key to be stored without worry of it being compromised as long as reasonable security practices are being practiced.
-
-This airgapped XRP wallet allows users to sign a Payment transaction in a secure environment without the private key being exposed to a machine connected to the internet. The private key and seed is encrypted by password and stored securely.
-
-*Note*: You should not use this airgapped wallet in production, it should only be used for educational purposes only. 
-
-This code sample consists of 2 parts:
-
-- `airgapped-wallet.py` - This code should be stored in a standalone airgapped machine, it consist of features to generate a wallet, store a keypair securely, sign a transaction and share the signed transaction via QR code.
-- `relay-transaction.py` - This code could be stored in any online machine, no credentials is stored on this code other than a signed transaction which would be sent to an XRPL node for it to be validated on the ledger.
-
-Preferably, `airgapped-wallet.py` should be on a Linux machine while `relay-transaction.py` could be on any operating system.
-
-# Security Practices
-Strongly note that an airgapped system's security is not determined by its code alone but the security practices that are being followed by an operator.
-
-There are channels that can be maliciously used by outside parties to infiltrate an airgapped system and steal sensitive information.
-
-There are other ways malware could interact across airgapped networks, but they all involve an infected USB drive or a similar device introducing malware onto the airgapped machine. They could also involve a person physically accessing the computer, compromising it and installing malware or modifying its hardware.
-
-This is why it is also recommended to encrypt sensitive information being stored in an airgapped machine.
-
-The airgapped machine should have a few rules enforced to close any possible channels getting abused to leak information outside of the machine:
-### Wifi
-
-- Disable any wireless networking hardware on the airgapped machine. For example, if you have a desktop PC with a Wifi card, open the PC and remove the Wifi hardware. If you cannot do that, you could go to the system’s BIOS or UEFI firmware and disable the Wifi hardware.
-
-### BlueTooth
-
-- BlueTooth can be maliciously used by neighboring devices to steal data from an airgapped machine. It is recommended to remove or disable the BlueTooth hardware.  
-
-### USB
-
-- The USB port can be used to transfer files in and out of the airgapped machine and this may act as a threat to an airgapped machine if the USB drive is infected with a malware. So after installing & setting up this airgapped wallet, it is highly recommended to block off all USB ports by using a USB blocker and not use them.
-
-Do not reconnect the airgapped machine to a network, even when you need to transfer files! An effective airgapped machine should only serve 1 purpose, which is to store data and never open up a gateway for hackers to abuse and steal data.
-
-# Tutorial
-For testing purposes, you would need to have 2 machines and 1 phone in hand to scan the QR code.
-
-1. 1st machine would be airgapped, following the security practices written [here](#security-practices). It stores and manages an XRPL Wallet. 
-2. 2nd machine would be a normal computer connected to the internet. It relays a signed transaction blob to a rippled node.
-3. The phone would be used to scan a QR code, which contains a signed transaction blob. The phone would transmit it to the 2nd machine.
-
-The diagram below shows you the process of submitting a transaction to the XRPL:
-<p align="center">
-  <img src="https://user-images.githubusercontent.com/87929946/197970678-2a1b7f7e-d91e-424e-915e-5ba7d34689cc.png" width=75% height=75%>
-</p>
-
-# Setup
-- Machine 1 - An airgapped computer (during setup, it must be connected to the internet to download the files)
-- Machine 2 - A normal computer connected to the internet
-- Phone - A normal phone with a working camera to scan a QR
-
-## Machine 1 Setup
-Since this machine will be airgapped, it is best to use Linux as the Operating System.
-
-1. Install Python 3.8:
-
-**Linux Command Line**:
-```
-sudo apt-get update
-sudo apt-get install python3.8 python3-pip
-```
-**Website**: https://www.python.org/downloads/source/
-
-2. Clone all the files under the [`airgapped-wallet`](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/airgapped-wallet/py) directory
-
-3. Import all the modules required by running:
-```
-pip install -r requirements.txt
-```
-
-4. Airgap the machine by following the security practices written [here](#security-practices).
-
-5. Run `airgapped-wallet.py`
-
-6. Scan the QR code and fund the account using the [testnet faucet](https://test.bithomp.com/faucet/) 
-
-7. Re-run the script and input '1' to generate a new transaction by following the instructions.
-
-8. Use your phone to scan the QR code, then to send the signed transaction to Machine 2 for submission
-
-## Machine 2 Setup
-This machine will be used to transmit a signed transaction blob from Machine 1, it would require internet access.
-
-1. Install Python 3.8
-
-**Linux Command Line**:
-```
-sudo apt-get update
-sudo apt-get install python3.8 python3-pip
-```
-**Website**: https://www.python.org/downloads/source/
-
-2. Clone all the files under the [`airgapped-wallet`](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/airgapped-wallet/py) directory
-
-3. Import all the modules required by running:
-```
-pip install -r requirements.txt
-```
-
-4. Run `relay-transaction.py` with one argument, the signed transaction blob to submit.
-
-## Phone Setup
-The phone requires a working camera that is able to scan a QR code and an internet connection for it to be able to transmit the signed transaction blob to Machine 2.
-
-Once you have signed a transaction in the airgapped machine, a QR code will be generated which will contain the signed transaction blob. Example:
-
-<img src="https://user-images.githubusercontent.com/87929946/196018292-f210a9f2-c5f8-412e-98c1-361a72286378.png" width=20% height=20%>
-
-Scan the QR code using the phone and transmit it to Machine 2, which will then be sending it to a rippled node.
-
-You can send a message to yourself using Discord, WhatsApp or even e-mail, then open up the message using Machine 2 to receive the signed transaction blob.

_code-samples/airgapped-wallet/py/airgapped-wallet-TEST.py

@@ -1,223 +0,0 @@
-import os
-import base64
-import qrcode
-import platform
-from PIL import Image
-from pathlib import Path, PureWindowsPath, PurePath
-from cryptography.fernet import Fernet
-from cryptography.hazmat.primitives import hashes
-from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
-from xrpl.core import keypairs
-from xrpl.utils import xrp_to_drops
-from xrpl.models.transactions import Payment
-from xrpl.transaction import sign
-from xrpl.wallet.main import Wallet
-
-
-def create_wallet(silent: False):
-    """
-    Generates a keypair
-    """
-    if not silent:
-        print("1. Generating seed...")
-        seed = keypairs.generate_seed()
-
-        print("2. Deriving keypair from seed...")
-        pub, priv = keypairs.derive_keypair(seed)
-
-        print("3. Deriving classic addresses from keypair..\n")
-        address = keypairs.derive_classic_address(pub)
-
-    else:
-        seed = keypairs.generate_seed()
-        pub, priv = keypairs.derive_keypair(seed)
-        address = keypairs.derive_classic_address(pub)
- 
-    return address, seed
-
-
-def sign_transaction(xrp_amount, destination, ledger_seq, wallet_seq, password):
-    """
-    Signs transaction and returns signed transaction blob in QR code
-    """
-    print("1. Retrieving encrypted private key and salt...")
-    with open(get_path("/WalletTEST/private.txt"), "r") as f:
-        seed = f.read()
-        seed = bytes.fromhex(seed)
-
-    with open(get_path("/WalletTEST/salt.txt"), "rb") as f:
-        salt = f.read()
-
-    print("2. Initializing key...")
-    kdf = PBKDF2HMAC(
-        algorithm=hashes.SHA256(),
-        length=32,
-        iterations=100000,
-        salt=salt
-    )
-
-    key = base64.urlsafe_b64encode(kdf.derive(bytes(password.encode())))
-    crypt = Fernet(key)
-
-    print("3. Decrypting wallet's private key using password")
-    seed = crypt.decrypt(seed)
-
-    print("4. Initializing wallet using decrypted private key")
-    _wallet = Wallet.from_seed(seed=seed.decode())
-
-    validated_seq = ledger_seq
-
-    print("5. Constructing payment transaction...")
-    my_tx_payment = Payment(
-        account=_wallet.address,
-        amount=xrp_to_drops(xrp=xrp_amount),
-        destination=destination,
-        last_ledger_sequence=validated_seq + 100,
-        # +100 to catch up with the ledger when we transmit the signed tx blob to Machine 2
-        sequence=wallet_seq,
-        fee="10"
-    )
-
-    print("6. Signing transaction...")
-    my_tx_payment_signed = sign(transaction=my_tx_payment, wallet=_wallet)
-
-    img = qrcode.make(my_tx_payment_signed.to_dict())
-
-    print("7. Displaying signed transaction blob's QR code on the screen...")
-    img.save(get_path("/WalletTEST/transactionID.png"))
-    image = Image.open(get_path("/WalletTEST/transactionID.png"))
-    image.show()
-
-    print(f"RESULT: {my_tx_payment_signed.to_dict()}")
-    print("END RESULT: Successful")
-
-
-def get_path(file):
-    """
-    Get path (filesystem management)
-    """
-
-    global File_
-    # Checks what OS is being used
-    OS = platform.system()
-    usr = Path.home()
-
-    # Get PATH format based on the OS
-    if OS == "Windows":
-        File_ = PureWindowsPath(str(usr) + file)
-    else: # Assuming Linux-style file format
-        File_ = PurePath(str(usr) + file)
-
-    return str(File_)
-
-
-def create_wallet_directory():
-    global File, Path_
-    OS = platform.system()
-    usr = Path.home()
-    if OS == "Windows":
-        # If it's Windows, use this path:
-        print("- OS Detected: Windows")
-        File = PureWindowsPath(str(usr) + '/WalletTEST')
-        Path_ = str(PureWindowsPath(str(usr)))
-    else:
-        print("- OS Detected: Linux")
-        # If it's Linux, use this path:
-        File = PurePath(str(usr) + '/WalletTEST')
-        Path_ = str(PurePath(str(usr)))
-
-    if not os.path.exists(File):
-        print("1. Generating wallet's keypair...")
-        pub, seed = create_wallet(silent=True)
-
-        print("2. Creating wallet's file directory...")
-        os.makedirs(File)
-
-        print("3. Generating and saving public key's QR code...")
-        img = qrcode.make(pub)
-        img.save(get_path("/WalletTEST/public.png"))
-
-        print("4. Generating and saving wallet's salt...")
-        salt = os.urandom(16)
-
-        with open(get_path("/WalletTEST/salt.txt"), "wb") as f:
-            f.write(salt)
-
-        print("5. Generating wallet's filesystem password...")
-        password = "This is a unit test password 123 !@# -+= }{/"
-        kdf = PBKDF2HMAC(
-            algorithm=hashes.SHA256(),
-            length=32,
-            iterations=100000,
-            salt=salt
-        )
-
-        key = base64.urlsafe_b64encode(kdf.derive(bytes(password.encode())))
-
-        crypt = Fernet(key)
-
-        print("6. Encrypting and saving private key by password...")
-        priv = crypt.encrypt(bytes(seed, encoding='utf-8'))
-        seed = crypt.encrypt(bytes(seed, encoding='utf-8'))
-
-        with open(get_path("/WalletTEST/seed.txt"), "w") as f:
-            f.write(seed.hex())
-
-        with open(get_path("/WalletTEST/private.txt"), "w") as f:
-            f.write(priv.hex())
-
-        with open(get_path("/WalletTEST/public.txt"), "w") as f:
-            f.write(pub)
-
-    if os.path.exists(File):
-        print(f"0. Wallet's filesystem already exist as the unit test has been performed before. Directory: {File}")
-
-
-def showcase_wallet_address_qr_code():
-    with open(get_path("/WalletTEST/public.txt"), "r") as f:
-        print(f"0. Wallet Address: {f.read()}")
-
-    __path = get_path("/WalletTEST/public.png")
-    print(f"1. Getting address from {__path}...")
-    print("2. Displaying QR code on the screen...")
-    image = Image.open(get_path("/WalletTEST/public.png"))
-    image.show()
-
-
-if __name__ == '__main__':
-    print("Airgapped Machine Unit Test (5 functions):\n")
-
-    print(f"UNIT TEST 1. create_wallet():")
-    _address, _seed = create_wallet(silent=False)
-    print(f"-- RESULTS --\n"
-          f"Address: {_address}\n"
-          f"Seed: {_seed}\n"
-          f"END RESULT: Successful"
-          )
-
-    print(f"\nUNIT TEST 2. create_wallet_directory():")
-    create_wallet_directory()
-    print("RESULT: Successful")
-
-    print("\nUNIT TEST 3. showcase_wallet_address_qr_code():")
-    showcase_wallet_address_qr_code()
-    print("RESULT: Successful")
-
-    print("\nUNIT TEST 4. get_path():")
-    print("1. Getting files' path...\n")
-    txt_file = get_path("/WalletTEST/FILE123.txt")
-    png_file = get_path("/WalletTEST/PIC321.png")
-    print(f"-- RESULTS --\n"
-          f"txt_file: {txt_file}\n"
-          f"png_file: {png_file}\n"
-          f"END RESULT: Successful")
-
-    print("\nUNIT TEST 5. sign_transaction():")
-    print("Parameters: xrp_amount, destination, ledger_seq, wallet_seq, password")
-    sign_transaction(
-        xrp_amount=10,
-        destination="rPEpirdT9UCNbnaZMJ4ENwKAwJqrTpvgMQ",
-        ledger_seq=32602000,
-        wallet_seq=32600100,
-        password="This is a unit test password 123 !@# -+= }{/"
-    )

_code-samples/airgapped-wallet/py/airgapped-wallet.py

@@ -1,232 +0,0 @@
-import os
-import shutil
-import base64
-import qrcode
-import platform
-from PIL import Image
-from pathlib import Path, PureWindowsPath, PurePath
-from cryptography.fernet import Fernet
-from cryptography.hazmat.primitives import hashes
-from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
-from xrpl.wallet import Wallet
-from xrpl.core import keypairs
-from xrpl.utils import xrp_to_drops
-from xrpl.models.transactions import Payment
-from xrpl.transaction import sign
-
-
-def create_wallet():
-    """
-    Generates a keypair
-    """
-
-    seed = keypairs.generate_seed()
-    pub, priv = keypairs.derive_keypair(seed)
-
-    address = keypairs.derive_classic_address(pub)
-    print(
-        f"\n\n       XRP WALLET CREDENTIALS"
-        f"\n  Wallet Address: {address}"
-        f"\n            Seed: {seed}"
-    )
-
-    return address, seed
-
-
-def sign_transaction(_xrp_amount, _destination, _ledger_seq, _wallet_seq, password):
-    """
-    Signs transaction and returns signed transaction blob in QR code
-    """
-
-    with open(get_path("/Wallet/private.txt"), "r") as f:
-        _seed = f.read()
-        _seed = bytes.fromhex(_seed)
-
-    with open(get_path("/Wallet/salt.txt"), "rb") as f:
-        salt = f.read()
-
-    # Line 49-58: initialize key
-    kdf = PBKDF2HMAC(
-        algorithm=hashes.SHA256(),
-        length=32,
-        iterations=100000,
-        salt=salt
-    )
-
-    key = base64.urlsafe_b64encode(kdf.derive(bytes(password.encode())))
-    crypt = Fernet(key)
-
-    # Decrypts the wallet's private key
-    _seed = crypt.decrypt(_seed)
-    _wallet = Wallet.from_seed(seed=_seed.decode())
-
-    validated_seq = _ledger_seq
-
-    # Construct Payment transaction
-    my_tx_payment = Payment(
-        account=_wallet.address,
-        amount=xrp_to_drops(xrp=_xrp_amount),
-        destination=_destination,
-        last_ledger_sequence=validated_seq + 100,
-        # 100 ledgers usually takes about 6 minutes, so you have about that
-        # long to submit it before it expires. To give more time, increase 
-        # this number; for unlimited time, remove last_ledger entirely.
-        sequence=_wallet_seq,
-        fee="10"
-    )
-
-    # Signs transaction and displays the signed_tx blob in QR code
-    # Scan the QR code and transmit the signed_tx blob to an online machine (Machine 2) to relay it to the XRPL
-    my_tx_payment_signed = sign(transaction=my_tx_payment, wallet=_wallet)
-
-    img = qrcode.make(my_tx_payment_signed.blob())
-    img.save(get_path("/Wallet/transactionID.png"))
-    image = Image.open(get_path("/Wallet/transactionID.png"))
-    image.show()
-
-
-def get_path(file):
-    """
-    Get path (filesystem management)
-    """
-
-    global File_
-    # Checks what OS is being us
-    OS = platform.system()
-    usr = Path.home()
-
-    # Get PATH format based on the OS
-    if OS == "Windows":
-        File_ = PureWindowsPath(str(usr) + file)
-    else: # Assuming Linux-style file format, use this path:
-        File_ = PurePath(str(usr) + file)
-
-    return str(File_)
-
-
-def main():
-    global File, Path_
-
-    # Gets the machine's operating system (OS)
-    OS = platform.system()
-    usr = Path.home()
-    if OS == "Windows":
-        # If it's Windows, use this path:
-        File = PureWindowsPath(str(usr) + '/Wallet')
-        Path_ = str(PureWindowsPath(str(usr)))
-    else: # Assuming Linux-style file format, use this path:
-        File = PurePath(str(usr) + '/Wallet')
-        Path_ = str(PurePath(str(usr)))
-
-    # If the Wallet's folder already exists, continue on
-    if os.path.exists(File) and os.path.exists(get_path("/Wallet/public.txt")):
-        while True:
-            try:
-                ask = int(input("\n 1. Transact XRP"
-                            "\n 2. Generate an XRP wallet (read only)"
-                            "\n 3. Showcase XRP Wallet Address (QR Code)"
-                            "\n 4. Exit"
-                            "\n\n Enter Index: "
-                            ))
-            except ValueError:
-                continue
-
-            if ask == 1:
-                password = str(input("             Enter Password: "))
-                amount = float(input("\n           Enter XRP To Send: "))
-                destination = input("If you just want to try it out, you can use the faucet account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
-                "\n        Enter Destination: ")
-                wallet_sequence = int(input("Look up the 'Next Sequence' for the account using test.bithomp.com and enter it below!"
-                                            "\n    Enter Wallet Sequence: "))
-                ledger_sequence = int(input("Look up the latest ledger sequence on testnet.xrpl.org and enter it below!"
-                                            "\n    Enter Ledger Sequence: "))
-
-                sign_transaction(_xrp_amount=amount,
-                                 _destination=destination,
-                                 _ledger_seq=ledger_sequence,
-                                 _wallet_seq=wallet_sequence,
-                                 password=password
-                                 )
-                print("This transaction is expected to expire in ~6 minutes.")
-
-                del destination, amount, wallet_sequence, ledger_sequence
-
-            if ask == 2:
-                _pub, _seed = create_wallet()
-
-            if ask == 3:
-                with open(get_path("/Wallet/public.txt"), "r") as f:
-                    print(f"\n  Wallet Address: {f.read()}")
-
-                image = Image.open(get_path("/Wallet/public.png"))
-                image.show()
-
-            if ask == 4:
-                return 0
-    else:
-        # If the Wallet's folder does not exist, create one and store wallet data (encrypted private key, encrypted seed, account address)
-        # If the Wallet's directory exists but files are missing, delete it and generate a new wallet
-        if os.path.exists(File):
-            confirmation = input(f"We've detected missing files on {File}, would you like to delete your wallet's credentials & generate new wallet credentials? (YES/NO):")
-            if confirmation == "YES":
-                confirmation_1 = input(f"All wallet credentials will be lost if you continue, are you sure? (YES/NO): ")
-                if confirmation_1 == "YES":
-                    shutil.rmtree(File)
-                else:
-                    print("Aborted: Wallet credentials are still intact")
-                    return 0
-            else:
-                print("- Wallet credentials are still intact")
-                return 0
-
-        os.makedirs(File)
-
-        pub, seed = create_wallet()
-
-        img = qrcode.make(pub)
-        img.save(get_path("/Wallet/public.png"))
-
-        print("\nCreating a brand new Wallet, please enter a new password")
-        password = str(input("\n        Enter Password: "))
-        salt = os.urandom(16)
-
-        with open(get_path("/Wallet/salt.txt"), "wb") as f:
-            f.write(salt)
-
-        kdf = PBKDF2HMAC(
-            algorithm=hashes.SHA256(),
-            length=32,
-            iterations=100000,
-            salt=salt
-        )
-
-        key = base64.urlsafe_b64encode(kdf.derive(bytes(password.encode())))
-
-        crypt = Fernet(key)
-
-        priv = crypt.encrypt(bytes(seed, encoding='utf-8'))
-        seed = crypt.encrypt(bytes(seed, encoding='utf-8'))
-
-        with open(get_path("/Wallet/seed.txt"), "w") as f:
-            f.write(seed.hex())
-
-        with open(get_path("/Wallet/private.txt"), "w") as f:
-            f.write(priv.hex())
-
-        with open(get_path("/Wallet/public.txt"), "w") as f:
-            f.write(pub)
-
-        openimg = Image.open(get_path("/Wallet/public.png"))
-        openimg.show()
-
-        print("\nFinished generating an account.")
-        print(f"\nWallet Address: {pub}")
-        print("\nPlease scan the QR code on your phone and use https://test.bithomp.com/faucet/ to fund the account."
-              "\nAfter that, you're able to sign transactions and transmit them to Machine 2 (online machine).")
-
-        # Loop back to the start after setup
-        main()
-
-
-if __name__ == '__main__':
-    main()

_code-samples/airgapped-wallet/py/relay-transaction.py

@@ -1,53 +0,0 @@
-from xrpl.clients import JsonRpcClient
-from xrpl.models.transactions import Payment
-from xrpl.transaction import submit_and_wait
-from xrpl.utils import drops_to_xrp
-import argparse
-
-def connect_node(_node):
-    """
-    Connects to a node
-    """
-
-    JSON_RPC_URL = _node
-    _client = JsonRpcClient(url=JSON_RPC_URL)
-    print("\n   ---   Connected to Node")
-    return _client
-
-
-def send_transaction(tx_blob):
-    """
-    Connects to a node -> Send Transaction
-    Main Function to send transaction to the XRPL
-    """
-
-    client = connect_node("https://s.altnet.rippletest.net:51234/")
-    # TESTNET: "https://s.altnet.rippletest.net:51234/"
-    # MAINNET: "https://s2.ripple.com:51234/"
-
-    tx = submit_and_wait(transaction=tx_blob, client=client)
-
-    tx_account = tx.result["tx_json"]["Account"]
-    tx_hash = tx.result["hash"]
-    tx_destination = tx.result["tx_json"]['Destination']
-    delivered = tx.result["meta"]["delivered_amount"]
-    if type(delivered) == str:
-        tx_delivered_amount = f"{drops_to_xrp(delivered)} XRP"
-    else:
-        tx_delivered_amount = f"{delivered['value']} {delivered['currency']}.{delivered['issuer']}"
-
-
-    print(f"\n           XRPL Explorer: https://testnet.xrpl.org/transactions/{tx_hash}"
-          f"\n              Wallet Used: {tx_account}"
-          f"\n         Transaction Hash: {tx_hash}"
-          f"\n  Transaction Destination: {tx_destination}"
-          f"\n         Amount Delivered: {tx_delivered_amount}"
-         )
-
-
-if __name__ == '__main__':
-    p = argparse.ArgumentParser(description='Submit a signed transaction blob')
-    p.add_argument('blob', type=str, 
-        help='Transaction blob (in hexadecimal) to submit')
-    tx_blob = p.parse_args().blob
-    send_transaction(tx_blob)

_code-samples/airgapped-wallet/py/requirements.txt

@@ -1,4 +0,0 @@
-cryptography==44.0.1
-Pillow==10.3.0
-qrcode==7.2
-xrpl-py>=3.0.0

_code-samples/assign-regular-key/go/README.md

@@ -0,0 +1,10 @@
+# Assign a Regular Key (Go)
+
+Demonstrates how to assign a regular key pair to an XRP Ledger account. Both WebSocket (`ws/`) and JSON-RPC (`rpc/`) examples are included.
+
+Quick setup and usage:
+
+```sh
+go mod tidy
+go run ./ws/main.go
+```

_code-samples/assign-regular-key/go/go.mod

@@ -1,8 +1,6 @@
 module github.com/XRPLF
 
-go 1.23.0
-
-toolchain go1.23.10
+go 1.24.0
 
 require github.com/Peersyst/xrpl-go v0.1.11
 
@@ -20,5 +18,5 @@ require (
 	github.com/tyler-smith/go-bip32 v1.0.0 // indirect
 	github.com/tyler-smith/go-bip39 v1.1.0 // indirect
 	github.com/ugorji/go/codec v1.2.11 // indirect
-	golang.org/x/crypto v0.35.0 // indirect
+	golang.org/x/crypto v0.45.0 // indirect
 )

_code-samples/assign-regular-key/go/go.sum

@@ -46,8 +46,8 @@ github.com/ugorji/go/codec v1.2.11/go.mod h1:UNopzCgEMSXjBc6AOMqYvWC1ktqTAfzJZUZ
 golang.org/x/crypto v0.0.0-20170613210332-850760c427c5/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4=
 golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
 golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto=
-golang.org/x/crypto v0.35.0 h1:b15kiHdrGCHrP6LvwaQ3c03kgNhhiMgvlhxHQhmg2Xs=
-golang.org/x/crypto v0.35.0/go.mod h1:dy7dXNW32cAb/6/PRuTNsix8T+vJAqvuIy5Bli/x0YQ=
+golang.org/x/crypto v0.45.0 h1:jMBrvKuj23MTlT0bQEOBcAE0mjg8mK9RXFhRH6nyF3Q=
+golang.org/x/crypto v0.45.0/go.mod h1:XTGrrkGJve7CYK7J8PEww4aY7gM3qMCElcJQ8n8JdX4=
 golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
 golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
 golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=

_code-samples/auction-slot/README.md

@@ -0,0 +1,3 @@
+# Use AMM Auction Slot to Save on Fees
+
+Estimate the fees that would be paid for trading through an AMM and use the auction slot to save on fees if applicable.

_code-samples/auction-slot/js/amm-formulas.js

@@ -1,4 +1,4 @@
-const BigNumber = require('bignumber.js')
+import BigNumber from 'bignumber.js'
 
 /* Convert a trading fee to a value that can be multiplied
  * by a total to "subtract" the fee from the total.
@@ -50,7 +50,7 @@ function feeDecimal(tFee) {
  *                      theoretical input to the pool, it should be rounded 
  *                      up (ceiling) to preserve the pool's constant product.
  */
-function swapOut(asset_out_bn, pool_in_bn, pool_out_bn, trading_fee) {
+export function swapOut(asset_out_bn, pool_in_bn, pool_out_bn, trading_fee) {
     return ( ( pool_in_bn.multipliedBy(pool_out_bn) ).dividedBy(
                 pool_out_bn.minus(asset_out_bn)
              ).minus(pool_in_bn)
@@ -76,7 +76,7 @@ function solveQuadraticEq(a,b,c) {
  * @param trading_fee int - The trading fee as an integer {0,1000} where 1000
  *                          represents a 1% fee.
  */
-function ammAssetIn(pool_in, lpt_balance, desired_lpt, trading_fee) {
+export function ammAssetIn(pool_in, lpt_balance, desired_lpt, trading_fee) {
     // convert inputs to BigNumber
     const lpTokens = BigNumber(desired_lpt)
     const lptAMMBalance = BigNumber(lpt_balance)
@@ -100,7 +100,7 @@ function ammAssetIn(pool_in, lpt_balance, desired_lpt, trading_fee) {
  * XLS-30 section 4.1.1, but factors in the increase in the minimum bid as a 
  * result of having new LP Tokens issued to you from your deposit.
  */
-function auctionDeposit(old_bid, time_interval, trading_fee, lpt_balance) {
+export function auctionDeposit(old_bid, time_interval, trading_fee, lpt_balance) {
     const tfee_decimal = feeDecimal(trading_fee)
     const lptokens = BigNumber(lpt_balance)
     const b = BigNumber(old_bid)
@@ -133,7 +133,7 @@ function auctionDeposit(old_bid, time_interval, trading_fee, lpt_balance) {
  * 
  * @returns BigNumber - the minimum amount of LP tokens to win the auction slot
  */
-function auctionPrice(old_bid, time_interval, trading_fee, lpt_balance) {
+export function auctionPrice(old_bid, time_interval, trading_fee, lpt_balance) {
     const tfee_decimal = feeDecimal(trading_fee)
     const lptokens = BigNumber(lpt_balance)
     const min_bid = lptokens.multipliedBy(tfee_decimal).dividedBy(25)
@@ -154,10 +154,3 @@ function auctionPrice(old_bid, time_interval, trading_fee, lpt_balance) {
                               ).minus(lptokens).precision(15, BigNumber.FLOOR)
     return rounded_bid
 }
-
-module.exports = {
-    "auctionDeposit": auctionDeposit,
-    "auctionPrice": auctionPrice,
-    "ammAssetIn": ammAssetIn,
-    "swapOut": swapOut,
-}

_code-samples/auction-slot/js/auction-slot.js

@@ -1,170 +1,165 @@
-const xrpl = require('xrpl')
-const BigNumber = require('bignumber.js')
-const {auctionDeposit, ammAssetIn, swapOut} = require("./amm-formulas.js")
+import xrpl from 'xrpl'
+import BigNumber from 'bignumber.js'
+import { auctionDeposit, ammAssetIn, swapOut } from "./amm-formulas.js"
 
-async function main() {
-    // Connect ----------------------------------------------------------------
-    const client = new xrpl.Client('wss://s.altnet.rippletest.net:51233')
-    console.log("Connecting to Testnet...")
-    await client.connect()
-  
-    // // Get credentials from the faucet -------------------------------------
-    console.log("Requesting test XRP from the faucet...")
-    const wallet = (await client.fundWallet()).wallet
-    console.log(`Got address ${wallet.address} / seed ${wallet.seed}.`)
+// Connect and get account ----------------------------------------------------
+const client = new xrpl.Client('wss://s.altnet.rippletest.net:51233')
+console.log("Connecting to Testnet...")
+await client.connect()
 
-    // Look up AMM status -----------------------------------------------------
-    const from_asset = {
-        "currency": "XRP"
-    }
-    const to_asset = {
-        "currency": "TST",
-        "issuer": "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
-    }
-    const amm_info = (await client.request({
-        "command": "amm_info", 
-        "asset": from_asset, 
-        "asset2": to_asset
-    }))
-    console.dir(amm_info, {depth: null})
-    const lpt = amm_info.result.amm.lp_token
-    // XRP is always first if the pool is token←→XRP.
-    // For a token←→token AMM, you'd need to figure out which asset is first.
-    const pool_drops = amm_info.result.amm.amount
-    const pool_tst = amm_info.result.amm.amount2
-    const full_trading_fee = amm_info.result.amm.trading_fee
-    const discounted_fee = amm_info.result.amm.auction_slot.discounted_fee
-    const old_bid = amm_info.result.amm.auction_slot.price.value
-    const time_interval = amm_info.result.amm.auction_slot.time_interval
+console.log("Requesting test XRP from the faucet...")
+const { wallet } = await client.fundWallet()
+console.log(`Got address ${wallet.address} / seed ${wallet.seed}.`)
 
-    // Calculate price in XRP to get 10 TST from the AMM ----------------------
-    // Note, this ignores Offers from the non-AMM part of the DEX.
-    const to_amount = {
-        "currency": to_asset.currency,
-        "issuer": to_asset.issuer,
-        "value": "10.0"
-    }
+// Look up AMM status -----------------------------------------------------
+const from_asset = {
+    "currency": "XRP"
+}
+const to_asset = {
+    "currency": "TST",
+    "issuer": "rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd"
+}
+const amm_info = (await client.request({
+    "command": "amm_info", 
+    "asset": from_asset, 
+    "asset2": to_asset
+}))
+console.dir(amm_info, {depth: null})
+const lpt = amm_info.result.amm.lp_token
+// XRP is always first if the pool is token←→XRP.
+// For a token←→token AMM, you'd need to figure out which asset is first.
+const pool_drops = amm_info.result.amm.amount
+const pool_tst = amm_info.result.amm.amount2
+const full_trading_fee = amm_info.result.amm.trading_fee
+const discounted_fee = amm_info.result.amm.auction_slot.discounted_fee
+const old_bid = amm_info.result.amm.auction_slot.price.value
+const time_interval = amm_info.result.amm.auction_slot.time_interval
 
-    // Convert values to BigNumbers with the appropriate precision.
-    // Tokens always have 15 significant digits;
-    // XRP is precise to integer drops, which can be as high as 10^17
-    const asset_out_bn = BigNumber(to_amount.value).precision(15)
-    const pool_in_bn = BigNumber(pool_drops).precision(17)
-    const pool_out_bn = BigNumber(pool_tst.value).precision(15)
+// Calculate price in XRP to get 10 TST from the AMM ----------------------
+// Note, this ignores Offers from the non-AMM part of the DEX.
+const to_amount = {
+    "currency": to_asset.currency,
+    "issuer": to_asset.issuer,
+    "value": "10.0"
+}
 
-    if (to_amount.value > pool_out_bn) {
-        console.log(`Requested ${to_amount.value} ${to_amount.currency} ` +
-                    `but AMM only holds ${pool_tst.value}. Quitting.`)
-        client.disconnect()
-        return
-    }
+// Convert values to BigNumbers with the appropriate precision.
+// Tokens always have 15 significant digits;
+// XRP is precise to integer drops, which can be as high as 10^17
+const asset_out_bn = BigNumber(to_amount.value).precision(15)
+const pool_in_bn = BigNumber(pool_drops).precision(17)
+const pool_out_bn = BigNumber(pool_tst.value).precision(15)
 
-    // Use AMM's SwapOut formula to figure out how much XRP we have to pay
-    // to receive the target amount of TST, under the current trading fee.
-    const unrounded_amount = swapOut(asset_out_bn, pool_in_bn, 
-                                     pool_out_bn, full_trading_fee)
-    // Round XRP to integer drops. Round ceiling to make you pay in enough.
-    const from_amount = unrounded_amount.dp(0, BigNumber.ROUND_CEIL)
-    console.log(`Expected cost of ${to_amount.value} ${to_amount.currency}: ` +
-                `${xrpl.dropsToXrp(from_amount)} XRP`)
-
-    // Same calculation, but assume we have access to the discounted trading
-    // fee from the auction slot.
-    const raw_discounted = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, 
-                                   discounted_fee)
-    const discounted_from_amount = raw_discounted.dp(0, BigNumber.ROUND_CEIL)
-    console.log(`Expected cost with auction slot discount: `+
-                `${xrpl.dropsToXrp(discounted_from_amount)} XRP`)
-    
-    // The potential savings is the difference between the necessary input 
-    // amounts with the full vs discounted fee.
-    const potential_savings = from_amount.minus(discounted_from_amount)
-    console.log(`Potential savings: ${xrpl.dropsToXrp(potential_savings)} XRP`)
-
-    // Calculate the cost of winning the auction slot, in LP Tokens -----------
-    const auction_price = auctionDeposit(old_bid, time_interval, 
-                                         full_trading_fee, lpt.value
-                                         ).precision(15)
-    console.log(`Auction price after deposit: ${auction_price} LP Tokens`)
-    
-    // Calculate how much XRP to deposit to receive that many LP Tokens -------
-    const deposit_for_bid = ammAssetIn(pool_in_bn, lpt.value, auction_price, 
-                                       full_trading_fee
-                                       ).dp(0, BigNumber.ROUND_CEIL)
-    console.log(`Auction price as XRP single-asset deposit amount: `+
-                `${xrpl.dropsToXrp(deposit_for_bid)} XRP`)
-
-    // Optional. Allow for costs to be 1% greater than estimated, in case other
-    // transactions affect the same AMM during this time.
-    const SLIPPAGE_MULT = BigNumber(1.01)
-    const deposit_max = deposit_for_bid.multipliedBy(SLIPPAGE_MULT).dp(0)
-
-    // Compare price of deposit+bid with potential savings. -------------------
-    // Don't forget XRP burned as transaction costs.
-    const fee_response = (await client.request({"command":"fee"}))
-    const tx_cost_drops = BigNumber(fee_response.result.drops.minimum_fee
-                                    ).multipliedBy(client.feeCushion).dp(0)
-    const net_savings = potential_savings.minus(
-                            tx_cost_drops.multipliedBy(2).plus(deposit_max)
-                        )
-    if (net_savings > 0) {
-        console.log(`Estimated net savings from the auction slot: ` +
-                    `${xrpl.dropsToXrp(net_savings)} XRP`)
-    } else {
-        console.log(`Estimated the auction slot to be MORE EXPENSIVE by `+
-                    `${xrpl.dropsToXrp(net_savings.negated())} XRP. Quitting.`)
-        client.disconnect()
-        return
-    }
-
-    // Do a single-asset deposit to get LP Tokens to bid on the auction slot --
-    const auction_bid = {
-        "currency": lpt.currency,
-        "issuer": lpt.issuer,
-        "value": auction_price.toString()
-    }
-    const deposit_result = await client.submitAndWait({
-        "TransactionType": "AMMDeposit",
-        "Account": wallet.address,
-        "Asset": from_asset,
-        "Asset2": to_asset,
-        "Amount": deposit_max.toString(),
-        "LPTokenOut": auction_bid,
-        "Flags": xrpl.AMMDepositFlags.tfOneAssetLPToken
-      }, {autofill: true, wallet: wallet}
-    )
-    console.log("Deposit result:")
-    console.dir(deposit_result, {depth: null})
-
-    // Actually bid on the auction slot ---------------------------------------
-    const bid_result = await client.submitAndWait({
-        "TransactionType": "AMMBid",
-        "Account": wallet.address,
-        "Asset": from_asset,
-        "Asset2": to_asset,
-        "BidMax": auction_bid,
-        "BidMin": auction_bid, // So rounding doesn't leave dust amounts of LPT
-      }, {autofill: true, wallet: wallet}
-    )
-    console.log("Bid result:")
-    console.dir(bid_result, {depth: null})
-
-    // Trade using the discount -----------------------------------------------
-    const spend_drops = discounted_from_amount.multipliedBy(SLIPPAGE_MULT
-                                                            ).dp(0).toString()
-    const offer_result = await client.submitAndWait({
-        "TransactionType": "OfferCreate",
-        "Account": wallet.address,
-        "TakerPays": to_amount,
-        "TakerGets": spend_drops
-    }, {autofill: true, wallet: wallet})
-    console.log("Offer result:")
-    console.dir(offer_result, {depth: null})
-    console.log("Offer balance changes summary:")
-    console.dir(xrpl.getBalanceChanges(offer_result.result.meta), {depth:null})
-
-    // Done.
+if (to_amount.value > pool_out_bn) {
+    console.log(`Requested ${to_amount.value} ${to_amount.currency} ` +
+                `but AMM only holds ${pool_tst.value}. Quitting.`)
     client.disconnect()
-} // End of main()
+    process.exit(1)
+}
 
-main()
+// Use AMM's SwapOut formula to figure out how much XRP we have to pay
+// to receive the target amount of TST, under the current trading fee.
+const unrounded_amount = swapOut(asset_out_bn, pool_in_bn, 
+                                    pool_out_bn, full_trading_fee)
+// Round XRP to integer drops. Round ceiling to make you pay in enough.
+const from_amount = unrounded_amount.dp(0, BigNumber.ROUND_CEIL)
+console.log(`Expected cost of ${to_amount.value} ${to_amount.currency}: ` +
+            `${xrpl.dropsToXrp(from_amount)} XRP`)
+
+// Same calculation, but assume we have access to the discounted trading
+// fee from the auction slot.
+const raw_discounted = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, 
+                                discounted_fee)
+const discounted_from_amount = raw_discounted.dp(0, BigNumber.ROUND_CEIL)
+console.log(`Expected cost with auction slot discount: `+
+            `${xrpl.dropsToXrp(discounted_from_amount)} XRP`)
+
+// The potential savings is the difference between the necessary input 
+// amounts with the full vs discounted fee.
+const potential_savings = from_amount.minus(discounted_from_amount)
+console.log(`Potential savings: ${xrpl.dropsToXrp(potential_savings)} XRP`)
+
+// Calculate the cost of winning the auction slot, in LP Tokens -----------
+const auction_price = auctionDeposit(old_bid, time_interval, 
+                                        full_trading_fee, lpt.value
+                                        ).precision(15)
+console.log(`Auction price after deposit: ${auction_price} LP Tokens`)
+
+// Calculate how much XRP to deposit to receive that many LP Tokens -------
+const deposit_for_bid = ammAssetIn(pool_in_bn, lpt.value, auction_price, 
+                                    full_trading_fee
+                                    ).dp(0, BigNumber.ROUND_CEIL)
+console.log(`Auction price as XRP single-asset deposit amount: `+
+            `${xrpl.dropsToXrp(deposit_for_bid)} XRP`)
+
+// Optional. Allow for costs to be 1% greater than estimated, in case other
+// transactions affect the same AMM during this time.
+const SLIPPAGE_MULT = BigNumber(1.01)
+const deposit_max = deposit_for_bid.multipliedBy(SLIPPAGE_MULT).dp(0)
+
+// Compare price of deposit+bid with potential savings. -------------------
+// Don't forget XRP burned as transaction costs.
+const fee_response = (await client.request({"command":"fee"}))
+const tx_cost_drops = BigNumber(fee_response.result.drops.minimum_fee
+                                ).multipliedBy(client.feeCushion).dp(0)
+const net_savings = potential_savings.minus(
+                        tx_cost_drops.multipliedBy(2).plus(deposit_max)
+                    )
+if (net_savings > 0) {
+    console.log(`Estimated net savings from the auction slot: ` +
+                `${xrpl.dropsToXrp(net_savings)} XRP`)
+} else {
+    console.log(`Estimated the auction slot to be MORE EXPENSIVE by `+
+                `${xrpl.dropsToXrp(net_savings.negated())} XRP. Quitting.`)
+    client.disconnect()
+    process.exit(1)
+}
+
+// Do a single-asset deposit to get LP Tokens to bid on the auction slot --
+const auction_bid = {
+    "currency": lpt.currency,
+    "issuer": lpt.issuer,
+    "value": auction_price.toString()
+}
+const deposit_result = await client.submitAndWait({
+    "TransactionType": "AMMDeposit",
+    "Account": wallet.address,
+    "Asset": from_asset,
+    "Asset2": to_asset,
+    "Amount": deposit_max.toString(),
+    "LPTokenOut": auction_bid,
+    "Flags": xrpl.AMMDepositFlags.tfOneAssetLPToken
+    }, {autofill: true, wallet: wallet}
+)
+console.log("Deposit result:")
+console.dir(deposit_result, {depth: null})
+
+// Actually bid on the auction slot ---------------------------------------
+const bid_result = await client.submitAndWait({
+    "TransactionType": "AMMBid",
+    "Account": wallet.address,
+    "Asset": from_asset,
+    "Asset2": to_asset,
+    "BidMax": auction_bid,
+    "BidMin": auction_bid, // So rounding doesn't leave dust amounts of LPT
+    }, {autofill: true, wallet: wallet}
+)
+console.log("Bid result:")
+console.dir(bid_result, {depth: null})
+
+// Trade using the discount -----------------------------------------------
+const spend_drops = discounted_from_amount.multipliedBy(SLIPPAGE_MULT
+                                                        ).dp(0).toString()
+const offer_result = await client.submitAndWait({
+    "TransactionType": "OfferCreate",
+    "Account": wallet.address,
+    "TakerPays": to_amount,
+    "TakerGets": spend_drops
+}, {autofill: true, wallet: wallet})
+console.log("Offer result:")
+console.dir(offer_result, {depth: null})
+console.log("Offer balance changes summary:")
+console.dir(xrpl.getBalanceChanges(offer_result.result.meta), {depth:null})
+
+// Done.
+client.disconnect()

_code-samples/auction-slot/js/package.json

@@ -1,6 +1,7 @@
 {
   "dependencies": {
-    "xrpl": "^4.0.0",
-    "bignumber.js": "^9.0.0"
-  }
+    "xrpl": "^4.6.0",
+    "bignumber.js": "^10.0.2"
+  },
+  "type": "module"
 }

_code-samples/build-a-desktop-wallet/py/requirements.txt

@@ -1,4 +1,4 @@
 xrpl-py>=3.0.0
 wxPython==4.2.1
 toml==0.10.2
-requests==2.32.4
+requests==2.33.0

_code-samples/modular-tutorials/create-conditional-escrow.html

@@ -1,280 +0,0 @@
-<html>
-<head>
-    <title>Create a Conditional Escrow</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <link href="modular-tutorials.css" rel="stylesheet">
-    <script src='https://unpkg.com/xrpl@4.1.0/build/xrpl-latest.js'></script>
-    <script src="account-support.js"></script>
-    <script src="create-time-escrow.js"></script>
-    <script src='create-conditional-escrow.js'></script>
-    <script>
-        if (typeof module !== "undefined") {
-            const xrpl = require('xrpl')
-        }
-    </script>
-</head>
-
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-<body>
-    <h1>Create a Conditional Escrow</h1>
-    <form id="theForm">
-        <span class="tooltip" tooltip-data="Choose the XRPL host server for your account.">
-            Choose your ledger instance:
-        </span>
-        &nbsp;&nbsp;
-        <input type="radio" id="dn" name="server" value="wss://s.devnet.rippletest.net:51233" checked>
-        <label for="dn">Devnet</label>
-        &nbsp;&nbsp;
-        <input type="radio" id="tn" name="server" value="wss://s.altnet.rippletest.net:51233">
-        <label for="tn">Testnet</label>
-        <br /><br />
-        <table>
-            <tr>
-                <td>
-                    <button type="button" onClick="getNewAccount1()">Get New Account 1</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed1()">Get Account 1 From Seed</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getNewAccount2()">Get New Account 2</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed2()">Get Account 2 From Seed</button>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                        <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account."><label for="account1name">Account 1 Name</label>
-                        </span>
-                </td>
-                <td>
-                    <input type="text" id="account1name" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account.">
-                        <label for="account2name">Account 2 Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2name" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account1address">Account 1 Address</label>
-                    </span>
-                </td>
-                <td> 
-                    <input type="text" id="account1address" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account2address">Account 2 Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2address" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account1seed">Account 1 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account1seed" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account2seed">Account 2 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2seed" size="40"></input>
-                </td>
-            </tr>
-            </table>
-            <hr />
-            <table>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Name of the currently selected account.">
-                        <label for="accountNameField">Account Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountNameField" size="40" readonly></input>
-                    <input type="radio" id="account1" name="accounts" value="account1">
-                    <label for="account1">Account 1</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Address of the currently selected account.">
-                        <label for="accountAddressField">Account Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountAddressField" size="40" readonly></input>
-                    <input type="radio" id="account2" name="accounts" value="account2">
-                    <label for="account2">Account 2</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Seed of the currently selected account.">
-                        <label for="accountSeedField">Account Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountSeedField" size="40" readonly></input>
-                    <br>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="XRP balance for the currently selected account.">
-                        <label for="xrpBalanceField">XRP Balance</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="xrpBalanceField" size="40" readonly></input>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Amount of XRP to send.">
-                        <label for="amountField">Amount</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="amountField" size="40"></input>
-                </td>
-            </tr>
-           <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Destination account address where the escrow is sent.">
-                    <lable for="destinationField">Destination</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="destinationField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="createConditionalEscrow()">Create Escrow</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Condition code used to begin the escrow transaction.">
-                    <lable for="escrowConditionField">Escrow Condition</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowConditionField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="getEscrows()">Get Escrows</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Fullfillment code to complete the escrow transaction.">
-                    <lable for="escrowFulfillmentField">Escrow Fulfillment</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowFulfillmentField" size="40"></input>
-                    <br>
-                </td>
-                <td>
-                    <button type="button" onClick="finishConditionalEscrow()">Finish Escrow</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow cancel time, in seconds.">
-                    <lable for="escrowCancelDateField">Escrow Cancel Time</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowCancelDateField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="cancelEscrow()">Cancel Escrow</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow sequence number, used when finishing the escrow.">
-                    <lable for="escrowSequenceNumberField">Escrow Sequence Number</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowSequenceNumberField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                    <button type="button" onClick="getTransaction()">Get Transaction</button>
-                </td>             
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow owner, the account that created the escrow.">
-                    <lable for="escrowOwnerField">Escrow Owner</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowOwnerField" size="40"></input>
-                    <br>
-                </td>             
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Transaction number, used with the Get Transaction button.">
-                    <lable for="transactionField">Transaction</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="transactionField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                </td>              
-            </tr>
-            <tr>
-                <td colspan="2">
-                    <p align="right">
-                        <textarea id="resultField" cols="80" rows="20"></textarea>
-                    </p>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="gatherAccountInfo()">Gather Account Info</button><br/>
-                    <button type="button" onClick="distributeAccountInfo()">Distribute Account Info</button>
-                </td>
-            </tr>
-        </table>
-    </form>
-</body>
-<script>
-    const radioButtons = document.querySelectorAll('input[type="radio"]');
-    radioButtons.forEach(radio => {
-        radio.addEventListener('change', function() {
-            if (this.value === 'account1') {
-                populate1()
-            } else if (this.value === 'account2') {
-                populate2()
-            }
-        });
-    });
-</script>
-</html>

_code-samples/modular-tutorials/create-conditional-escrow.js

@@ -1,86 +0,0 @@
-// *******************************************************
-// ************* Create Conditional Escrow ***************
-// *******************************************************
-
-async function createConditionalEscrow() {
-
-  //------------------------------------------------------Connect to the Ledger
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  const sendAmount = amountField.value
-  let results = `===Connected to ${net}===\n===Creating conditional escrow.===\n\n`
-  resultField.value = results
-  let escrow_cancel_date = new Date()
-  escrow_cancel_date = addSeconds(parseInt(escrowCancelDateField.value))
-
-  // ------------------------------------------------------- Prepare transaction
-  try {
-    const escrowTx = await client.autofill({
-      "TransactionType": "EscrowCreate",
-      "Account": wallet.address,
-      "Amount": xrpl.xrpToDrops(sendAmount),
-      "Destination": destinationField.value,
-      "CancelAfter": escrow_cancel_date,
-      "Condition": escrowConditionField.value
-    })
-
-    // ------------------------------------------------ Sign prepared instructions
-    const signed = wallet.sign(escrowTx)
-
-    // -------------------------------------------------------- Submit signed blob
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results = "\n=== *** Sequence Number (Save!): " + tx.result.tx_json.Sequence 
-    results += "\n\n===Balance changes===\n" + 
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-    resultField.value += results
-  }
-  catch (error) {
-    results += "\n===Error: " + error.message
-    resultField.value = results
-  }
-  finally {
-    // -------------------------------------------------------- Disconnect
-    client.disconnect()
-  }
-} // End of createTimeEscrow()
-
-// *******************************************************
-// ************** Finish Conditional Escrow **************
-// *******************************************************
-
-async function finishConditionalEscrow() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ${net}===\n===Fulfilling conditional escrow.===\n`
-  resultField.value = results
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  try {
-    // ------------------------------------------------------- Prepare transaction
-    const prepared = await client.autofill({
-      "TransactionType": "EscrowFinish",
-      "Account": accountAddressField.value,
-      "Owner": escrowOwnerField.value,
-      "OfferSequence": parseInt(escrowSequenceNumberField.value),
-      "Condition": escrowConditionField.value,
-      "Fulfillment": escrowFulfillmentField.value
-    })
-    const signed = wallet.sign(prepared)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results += "\n===Balance changes===" + 
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    resultField.value = results
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  }
-  catch (error) {
-    results += "\n===Error: " + error.message + ".===\n"
-    resultField.value = results
-  }
-  finally {
-    // -------------------------------------------------------- Disconnect
-    client.disconnect()
-  }
-} // End of finisConditionalEscrow()

_code-samples/modular-tutorials/create-offer.html

@@ -1,249 +0,0 @@
-<html>
-<head>
-    <title>Create Offers</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <link href="modular-tutorials.css" rel="stylesheet">
-    <script src='https://unpkg.com/xrpl@4.1.0/build/xrpl-latest.js'></script>
-    <script src="account-support.js"></script>
-    <script src='send-xrp.js'></script>
-    <script src='create-offer.js'></script>
-    <script>
-        if (typeof module !== "undefined") {
-            const xrpl = require('xrpl')
-        }
-    </script>
-</head>
-
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-<body>
-    <h1>Create Offers</h1>
-    <form id="theForm">
-        <span class="tooltip" tooltip-data="Choose the XRPL host server for your account.">
-            Choose your ledger instance:
-        </span>
-        &nbsp;&nbsp;
-        <input type="radio" id="dn" name="server" value="wss://s.devnet.rippletest.net:51233" checked>
-        <label for="dn">Devnet</label>
-        &nbsp;&nbsp;
-        <input type="radio" id="tn" name="server" value="wss://s.altnet.rippletest.net:51233">
-        <label for="tn">Testnet</label>
-        <br /><br />
-        <table>
-            <tr>
-                <td>
-                    <button type="button" onClick="getNewAccount1()">Get New Account 1</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed1()">Get Account 1 From Seed</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getNewAccount2()">Get New Account 2</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed2()">Get Account 2 From Seed</button>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                        <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account."><label for="account1name">Account 1 Name</label>
-                        </span>
-                </td>
-                <td>
-                    <input type="text" id="account1name" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account.">
-                        <label for="account2name">Account 2 Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2name" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account1address">Account 1 Address</label>
-                    </span>
-                </td>
-                <td> 
-                    <input type="text" id="account1address" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account2address">Account 2 Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2address" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account1seed">Account 1 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account1seed" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account2seed">Account 2 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2seed" size="40"></input>
-                </td>
-            </tr>
-        </table>
-        <hr />
-        <table>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Name of the currently selected account.">
-                        <label for="accountNameField">Account Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountNameField" size="40" readonly></input>
-                    <input type="radio" id="account1" name="accounts" value="account1">
-                    <label for="account1">Account 1</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Address of the currently selected account.">
-                        <label for="accountAddressField">Account Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountAddressField" size="40" readonly></input>
-                    <input type="radio" id="account2" name="accounts" value="account2">
-                    <label for="account2">Account 2</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Seed of the currently selected account.">
-                        <label for="accountSeedField">Account Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountSeedField" size="40" readonly></input>
-                    <br>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="XRP balance for the currently selected account.">
-                        <label for="xrpBalanceField">XRP Balance</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="xrpBalanceField" size="40" readonly></input>
-                </td>
-            </tr>
-        </table>
-        <table>
-            <tr>
-                <td></td>
-                <td>
-                    <h4 align="center">Taker Pays</h4>
-                </td>
-                <td>
-                    <h4 align="center">Taker Gets</h4>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Currency codes for the Pay and Get offers.">
-                    <lable for="payCurrencyField">Currency Code</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="payCurrencyField" size="40"></input>
-                </td>
-                <td>
-                    <input type="text" id="getCurrencyField" size="40"></input>
-                </td> 
-                <td>          
-                    <button type="button" onClick="createOffer()">Create Offer</button>
-                </td>   
-            </tr> 
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Issuers of the offered currencies.">
-                        <lable for="payIssuerField">Issuer</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="payIssuerField" size="40"></input>&nbsp;&nbsp;
-                </td>  
-                <td>
-                    <input type="text" id="getIssuerField" size="40"></input>&nbsp;&nbsp;
-                </td>
-                <td>
-                    <button type="button" onClick="getOffers()">Get Offers</button>
-                </td>
-            </tr>    
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Amounts of offered currencies.">
-                        <lable for="amountField">Amount</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="payAmountField" size="40"></input>
-                </td> 
-                <td>
-                    <input type="text" id="getAmountField" size="40"></input>
-                </td>
-                <td>
-                    <button type="button" onClick="cancelOffer()">Cancel Offer</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Sequence number of the offer.">
-                        <lable for="offerSequenceField">Offer Sequence</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="offerSequenceField" size="40"></input>
-                </td> 
-                <td></td>
-                <td>
-                    <button type="button" onClick="getTokenBalance()">Get Token Balance</button>
-                </td>
-            </tr>  
-            <tr>
-                <td colspan="3">
-                    <p align="right">
-                        <textarea id="resultField" cols="80" rows="20"></textarea>
-                    </p>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="gatherAccountInfo()">Gather Account Info</button><br/>
-                    <button type="button" onClick="distributeAccountInfo()">Distribute Account Info</button>
-                </td>
-            </tr>
-        </table>
-    </form>
-</body>
-<script>
-    const radioButtons = document.querySelectorAll('input[type="radio"]');
-    radioButtons.forEach(radio => {
-        radio.addEventListener('change', function() {
-            if (this.value === 'account1') {
-                populate1()
-            } else if (this.value === 'account2') {
-                populate2()
-            }
-        });
-    });
-</script>
-</html>

_code-samples/modular-tutorials/create-offer.js

@@ -1,121 +0,0 @@
-/***********************************
- *********** Create Offer **********
- **********************************/
-
-async function createOffer() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ${net}, getting wallet....===\n`
-  resultField.value = results
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  try {
-    if (getCurrencyField.value == 'XRP') {
-      takerGets = xrpl.xrpToDrops(getAmountField.value)
-    }
-    else {
-      takerGetsString = '{"currency": "' + getCurrencyField.value + '",\n' +
-        '"issuer": "' + getIssuerField.value + '",\n' +
-        '"value": "' + getAmountField.value + '"}'
-      takerGets = JSON.parse(takerGetsString)
-    }
-
-    if (payCurrencyField.value == 'XRP') {
-      takerPays = xrpl.xrpToDrops(payAmountField.value)
-    } else {
-      takerPaysString = '{"currency": "' + payCurrencyField.value + '",\n' +
-        '"issuer": "' + payIssuerField.value + '",\n' +
-        '"value": "' + payAmountField.value + '"}'
-      takerPays = JSON.parse(takerPaysString)
-    }
-    const prepared = await client.autofill({
-      "TransactionType": "OfferCreate",
-      "Account": wallet.address,
-      "TakerGets": takerGets,
-      "TakerPays": takerPays
-    })
-    const signed = wallet.sign(prepared)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results = '\n\n===Offer created===\n\n' +
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    resultField.value += results
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  } catch (err) {
-    console.error('Error creating offer:', err);
-    results = `\nError: ${err.message}\n`
-    resultField.value += results
-    throw err; // Re-throw the error to be handled by the caller
-  }
-  finally {
-    // Disconnect from the client          
-    client.disconnect()
-  }
-} // End of createOffer()
-
-/***********************************
- ************ Get Offers ***********
- **********************************/
-
-async function getOffers() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ' + ${net}, getting offers....===\n`
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  resultField.value = results
-  results += '\n\n=== Offers ===\n'
-  let offers
-  try {
-    offers = await client.request({
-      method: "account_offers",
-      account: wallet.address,
-      ledger_index: "validated"
-    })
-    results = JSON.stringify(offers, null, 2)
-    resultField.value += results
-  } catch (err) {
-    console.error('Error getting offers:', err);
-    results = `\nError: ${err.message}\n`
-    resultField.value += results
-    throw err; // Re-throw the error to be handled by the caller
-  }
-  finally {
-    client.disconnect()
-  }
-}// End of getOffers()
-
-/***********************************
-*********** Cancel Offer **********
-**********************************/
-async function cancelOffer() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ${net}, canceling offer.===\n`
-  resultField.value = results
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  try {
-    // OfferSequence is the _seq_ value from getOffers.
-    const prepared = await client.autofill({
-      "TransactionType": "OfferCancel",
-      "Account": wallet.address,
-      "OfferSequence": parseInt(offerSequenceField.value)
-    })
-    const signed = wallet.sign(prepared)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results += "\nOffer canceled. Balance changes: \n" +
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    resultField.value = results
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  }
-  catch (err) {
-    console.error('Error canceling offer:', err);
-    results = `\nError: ${err.message}\n`
-    resultField.value += results
-    throw err; // Re-throw the error to be handled by the caller
-  }
-  finally {
-    // Disconnect from the client
-    client.disconnect()
-  }
-}// End of cancelOffer()

_code-samples/modular-tutorials/create-time-escrow.html

@@ -1,269 +0,0 @@
-<html>
-<head>
-    <title>Create a Time-based Escrow</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <link href="modular-tutorials.css" rel="stylesheet">
-    <script src='https://unpkg.com/xrpl@4.1.0/build/xrpl-latest.js'></script>
-    <script src="account-support.js"></script>
-    <script src='create-time-escrow.js'></script>
-    <script>
-        if (typeof module !== "undefined") {
-            const xrpl = require('xrpl')
-        }
-    </script>
-</head>
-
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-<body>
-    <h1>Create a Time-based Escrow</h1>
-    <form id="theForm">
-        <span class="tooltip" tooltip-data="Choose the XRPL host server for your account.">
-            Choose your ledger instance:
-        </span>
-        &nbsp;&nbsp;
-        <input type="radio" id="dn" name="server" value="wss://s.devnet.rippletest.net:51233" checked>
-        <label for="dn">Devnet</label>
-        &nbsp;&nbsp;
-        <input type="radio" id="tn" name="server" value="wss://s.altnet.rippletest.net:51233">
-        <label for="tn">Testnet</label>
-        <br /><br />
-        <table>
-            <tr>
-                <td>
-                    <button type="button" onClick="getNewAccount1()">Get New Account 1</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed1()">Get Account 1 From Seed</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getNewAccount2()">Get New Account 2</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed2()">Get Account 2 From Seed</button>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                        <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account."><label for="account1name">Account 1 Name</label>
-                        </span>
-                </td>
-                <td>
-                    <input type="text" id="account1name" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account.">
-                        <label for="account2name">Account 2 Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2name" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account1address">Account 1 Address</label>
-                    </span>
-                </td>
-                <td> 
-                    <input type="text" id="account1address" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account2address">Account 2 Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2address" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account1seed">Account 1 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account1seed" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account2seed">Account 2 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2seed" size="40"></input>
-                </td>
-            </tr>
-            </table>
-            <hr />
-            <table>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Name of the currently selected account.">
-                        <label for="accountNameField">Account Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountNameField" size="40" readonly></input>
-                    <input type="radio" id="account1" name="accounts" value="account1">
-                    <label for="account1">Account 1</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Address of the currently selected account.">
-                        <label for="accountAddressField">Account Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountAddressField" size="40" readonly></input>
-                    <input type="radio" id="account2" name="accounts" value="account2">
-                    <label for="account2">Account 2</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Seed of the currently selected account.">
-                        <label for="accountSeedField">Account Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountSeedField" size="40" readonly></input>
-                    <br>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="XRP balance for the currently selected account.">
-                        <label for="xrpBalanceField">XRP Balance</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="xrpBalanceField" size="40" readonly></input>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Amount of XRP to send.">
-                        <label for="amountField">Amount</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="amountField" size="40"></input>
-                </td>
-            </tr>
-           <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Destination account address where the escrow is sent.">
-                    <lable for="destinationField">Destination</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="destinationField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="createTimeBasedEscrow()">Create Time-based Escrow</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow finish time, in seconds.">
-                    <lable for="escrowFinishTimeField">Escrow Finish Time</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowFinishTimeField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="getEscrows()">Get Escrows</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow cancel time, in seconds.">
-                    <lable for="escrowCancelTimeField">Escrow Cancel Time</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowCancelTimeField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="finishTimeBasedEscrow()">Finish Time-based Escrow</button>
-
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow sequence number, used when finishing the escrow.">
-                    <lable for="escrowSequenceNumberField">Escrow Sequence Number</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowSequenceNumberField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                    <button type="button" onClick="cancelEscrow()">Cancel Escrow</button>
-                </td>              
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Escrow owner, the account that created the escrow.">
-                    <lable for="escrowOwnerField">Escrow Owner</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="escrowOwnerField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                    <button type="button" onClick="getTransaction()">Get Transaction</button>
-                </td>              
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Transaction number, used with the Get Transaction button.">
-                    <lable for="transactionField">Transaction</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="transactionField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                </td>              
-            </tr>
-            <tr>
-                <td colspan="2">
-                    <p align="right">
-                        <textarea id="resultField" cols="80" rows="20"></textarea>
-                    </p>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="gatherAccountInfo()">Gather Account Info</button><br/>
-                    <button type="button" onClick="distributeAccountInfo()">Distribute Account Info</button>
-                </td>
-            </tr>
-        </table>
-    </form>
-</body>
-<script>
-    const radioButtons = document.querySelectorAll('input[type="radio"]');
-    radioButtons.forEach(radio => {
-        radio.addEventListener('change', function() {
-            if (this.value === 'account1') {
-                populate1()
-            } else if (this.value === 'account2') {
-                populate2()
-            }
-        });
-    });
-</script>
-</html>

_code-samples/modular-tutorials/create-time-escrow.js

@@ -1,177 +0,0 @@
-// *******************************************************
-// ************* Add Seconds to Current Date *************
-// *******************************************************
-
-function addSeconds(numOfSeconds, date = new Date()) {
-  date.setSeconds(date.getSeconds() + numOfSeconds);
-  date = Math.floor(date / 1000)
-  date = date - 946684800
-
-  return date;
-}
-
-// *******************************************************
-// ************* Create Time-based Escrow ****************
-// *******************************************************
-
-async function createTimeBasedEscrow() {
-  //-------------------------------------------- Prepare Finish and Cancel Dates
-  let escrow_finish_date = new Date()
-  let escrow_cancel_date = new Date()
-  escrow_finish_date = addSeconds(parseInt(escrowFinishTimeField.value))
-  escrow_cancel_date = addSeconds(parseInt(escrowCancelTimeField.value))
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ${net}.===\n\n===Creating time-based escrow.===\n`
-  resultField.value = results
-  try {
-    const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-    const sendAmount = amountField.value
-    const escrowTx = await client.autofill({
-      "TransactionType": "EscrowCreate",
-      "Account": wallet.address,
-      "Amount": xrpl.xrpToDrops(sendAmount),
-      "Destination": destinationField.value,
-      "FinishAfter": escrow_finish_date,
-      "CancelAfter": escrow_cancel_date
-    })
-    const signed = wallet.sign(escrowTx)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results += "\n===Success! === *** Save this sequence number: " + tx.result.tx_json.Sequence
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-    resultField.value = results
-  }
-  catch (error) {
-    results += "\n===Error: " + error.message
-    resultField.value = results
-  }
-  finally {
-    client.disconnect()
-  }
-} // End of createTimeEscrow()
-
-// *******************************************************
-// ***************** Finish Time- Based Escrow ***********
-// *******************************************************
-
-async function finishTimeBasedEscrow() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `===Connected to ${net}. Finishing escrow.===\n`
-  resultField.value = results
-  const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-  try {
-    const prepared = await client.autofill({
-      "TransactionType": "EscrowFinish",
-      "Account": accountAddressField.value,
-      "Owner": escrowOwnerField.value,
-      "OfferSequence": parseInt(escrowSequenceNumberField.value)
-    })
-    const signed = wallet.sign(prepared)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results += "\n===Balance changes===" +
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    resultField.value = results
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  }
-  catch (error) {
-    results += "\n===Error: " + error.message + "==="
-    resultField.value = results
-  }
-  finally {
-    client.disconnect()
-  }
-} // End of finishTimeBasedEscrow()
-
-// *******************************************************
-// ******************* Get Escrows ***********************
-// *******************************************************
-
-async function getEscrows() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `\n===Connected to ${net}.\nGetting account escrows.===\n`
-  resultField.value = results
-  try {
-    const escrow_objects = await client.request({
-      "id": 5,
-      "command": "account_objects",
-      "account": accountAddressField.value,
-      "ledger_index": "validated",
-      "type": "escrow"
-    })
-    results += JSON.stringify(escrow_objects.result, null, 2)
-    resultField.value = results
-  }
-  catch (error) {
-    results += "\nError: " + error.message
-    resultField.value = results
-  }
-  finally {
-    client.disconnect()
-  }
-}
-
-// *******************************************************
-// ************** Get Transaction Info *******************
-// *******************************************************
-
-async function getTransaction() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `\n===Connected to ${net}.===\n===Getting transaction information.===\n`
-  resultField.value = results
-  try {
-    const tx_info = await client.request({
-      "id": 1,
-      "command": "tx",
-      "transaction": transactionField.value,
-    })
-    results += JSON.stringify(tx_info.result, null, 2)
-    resultField.value = results
-  }
-  catch (error) {
-    results += "\nError: " + error.message
-    resultField.value = results
-  }
-  finally {
-    client.disconnect()
-  }
-} // End of getTransaction()
-
-// *******************************************************
-// ****************** Cancel Escrow **********************
-// *******************************************************
-
-async function cancelEscrow() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  let results = `\n===Connected to ${net}. Cancelling escrow.===`
-  resultField.value = results
-  try {
-    const prepared = await client.autofill({
-      "TransactionType": "EscrowCancel",
-      "Account": accountAddressField.value,
-      "Owner": escrowOwnerField.value,
-      "OfferSequence": parseInt(escrowSequenceNumberField.value)
-    })
-    const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-    const signed = wallet.sign(prepared)
-    const tx = await client.submitAndWait(signed.tx_blob)
-    results += "\n===Balance changes: " +
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    resultField.value = results
-  }
-  catch (error) {
-    results += "\n===Error: " + error.message
-    resultField.value = results
-  }
-  finally {
-    client.disconnect()
-  }
-}

_code-samples/modular-tutorials/five-bells.cjs

@@ -1,24 +0,0 @@
-const cc = require('five-bells-condition');
-const crypto = require('crypto');
-
-// 1. Generate a random 32-byte seed
-const preimageData = crypto.randomBytes(32);
-
-// 2. Create a PreimageSha256 fulfillment object
-const fulfillment = new cc.PreimageSha256();
-
-// 3. Set the preimage
-fulfillment.setPreimage(preimageData);
-
-// 4. Generate the condition (binary)
-const conditionBinary = fulfillment.getConditionBinary();
-
-// 5. Generate the fulfillment (binary)
-const fulfillmentBinary = fulfillment.serializeBinary();
-
-// Convert to hex for easier use
-const conditionHex = conditionBinary.toString('hex').toUpperCase();
-const fulfillmentHex = fulfillmentBinary.toString('hex').toUpperCase();
-
-console.log('Condition (hex):', conditionHex);
-console.log('Fulfillment (hex):', fulfillmentHex);

_code-samples/modular-tutorials/send-checks.html

@@ -1,247 +0,0 @@
-<html>
-<head>
-    <title>Send Checks</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <link href="modular-tutorials.css" rel="stylesheet">
-    <script src='https://unpkg.com/xrpl@4.1.0/build/xrpl-latest.js'></script>
-    <script src="account-support.js"></script>
-    <script src='send-xrp.js'></script>
-    <script src='send-currency.js'></script>
-    <script src='send-checks.js'></script>
-    <script>
-        if (typeof module !== "undefined") {
-            const xrpl = require('xrpl')
-        }
-    </script>
-</head>
-
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-<body>
-    <h1>Send Checks</h1>
-    <form id="theForm">
-        <span class="tooltip" tooltip-data="Choose the XRPL host server for your account.">
-            Choose your ledger instance:
-        </span>
-        &nbsp;&nbsp;
-        <input type="radio" id="dn" name="server" value="wss://s.devnet.rippletest.net:51233" checked>
-        <label for="dn">Devnet</label>
-        &nbsp;&nbsp;
-        <input type="radio" id="tn" name="server" value="wss://s.altnet.rippletest.net:51233">
-        <label for="tn">Testnet</label>
-        <br /><br />
-        <table>
-            <tr>
-                <td>
-                    <button type="button" onClick="getNewAccount1()">Get New Account 1</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed1()">Get Account 1 From Seed</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getNewAccount2()">Get New Account 2</button>
-                </td>
-                <td>
-                    <button type="button" onClick="getAccountFromSeed2()">Get Account 2 From Seed</button>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                        <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account."><label for="account1name">Account 1 Name</label>
-                        </span>
-                </td>
-                <td>
-                    <input type="text" id="account1name" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Arbitrary human-readable name for the account.">
-                        <label for="account2name">Account 2 Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2name" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account1address">Account 1 Address</label>
-                    </span>
-                </td>
-                <td> 
-                    <input type="text" id="account1address" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Identifying address for the account.">
-                        <label for="account2address">Account 2 Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2address" size="40"></input>
-                </td>
-            </tr>
-            <tr>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account1seed">Account 1 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account1seed" size="40"></input>
-                </td>
-                <td>
-                    <span class="tooltip" tooltip-data="Seed for deriving public and private keys for the account.">
-                        <label for="account2seed">Account 2 Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="account2seed" size="40"></input>
-                </td>
-            </tr>
-            </table>
-            <hr />
-            <table>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Name of the currently selected account.">
-                        <label for="accountNameField">Account Name</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountNameField" size="40" readonly></input>
-                    <input type="radio" id="account1" name="accounts" value="account1">
-                    <label for="account1">Account 1</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Address of the currently selected account.">
-                        <label for="accountAddressField">Account Address</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountAddressField" size="40" readonly></input>
-                    <input type="radio" id="account2" name="accounts" value="account2">
-                    <label for="account2">Account 2</label>
-                </td>
-            </tr>
-            <tr valign="top">
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Seed of the currently selected account.">
-                        <label for="accountSeedField">Account Seed</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="accountSeedField" size="40" readonly></input>
-                    <br>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="XRP balance for the currently selected account.">
-                        <label for="xrpBalanceField">XRP Balance</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="xrpBalanceField" size="40" readonly></input>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Currency code for the check.">
-                    <lable for="currencyField">Currency Code</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="currencyField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                    <button type="button" onClick="sendCheck()">Send Check</button>
-                </td>               
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Issuing account for the currency.">
-                    <lable for="issuerField">Issuer</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="issuerField" size="40"></input>
-                    <br>
-                </td> 
-                <td>
-                    <button type="button" onClick="cashCheck()">Cash Check</button>
-                </td>              
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Amount of XRP to send.">
-                        <label for="amountField">Amount</label>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="amountField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="getChecks()">Get Checks</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Destination account address where XRP is sent.">
-                    <lable for="destinationField">Destination</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="destinationField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="cancelCheck()">Cancel Check</button>
-                </td>
-            </tr>
-            <tr>
-                <td align="right">
-                    <span class="tooltip" tooltip-data="Check ID.">
-                    <lable for="checkIdField">Check ID</lable>
-                    </span>
-                </td>
-                <td>
-                    <input type="text" id="checkIdField" size="40"></input>
-                    <br>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="getTokenBalance()">Get Token Balance</button>
-                </td>
-            </tr>
-            <tr>
-                <td colspan="2">
-                    <p align="right">
-                        <textarea id="resultField" cols="80" rows="20"></textarea>
-                    </p>
-                </td>
-                <td align="left" valign="top">
-                    <button type="button" onClick="gatherAccountInfo()">Gather Account Info</button><br/>
-                    <button type="button" onClick="distributeAccountInfo()">Distribute Account Info</button>
-                </td>
-            </tr>
-        </table>
-    </form>
-</body>
-<script>
-    const radioButtons = document.querySelectorAll('input[type="radio"]');
-    radioButtons.forEach(radio => {
-        radio.addEventListener('change', function() {
-            if (this.value === 'account1') {
-                populate1()
-            } else if (this.value === 'account2') {
-                populate2()
-            }
-        });
-    });
-</script>
-</html>

_code-samples/modular-tutorials/send-checks.js

@@ -1,152 +0,0 @@
-// *******************************************************
-// ***************** Send Check **************************
-// *******************************************************
-async function sendCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  results = `\n===Connected to ${net}.===\n===Sending check.===\n`
-  resultField.value = results
-  try {     
-    const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-    let check_amount = amountField.value
-    if (currencyField.value !=  "XRP") {
-      check_amount = {
-        "currency": currencyField.value,
-        "value": amountField.value,
-        "issuer": wallet.address  	
-      }
-    }
-    const send_check_tx = {
-      "TransactionType": "CheckCreate",
-      "Account": wallet.address,
-      "SendMax": check_amount,
-      "Destination": destinationField.value
-    }
-    const check_prepared = await client.autofill(send_check_tx)
-    const check_signed = wallet.sign(check_prepared)
-    results = '\n===Sending ' + amountField.value + ' ' + currencyField.
-     value + ' to ' +  destinationField.value + '.===\n'
-    resultField.value += results
-    const check_result = await client.submitAndWait(check_signed.tx_blob)
-    if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-      results += '===Transaction succeeded===\n\n'
-      resultField.value += JSON.stringify(check_result.result, null, 2)
-      xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-    }
-  } 
-  catch (error) {
-    results = `Error sending transaction: ${error}`
-    resultField.value += results
-  }
-  finally {
-    client.disconnect()
-  }
-} // end of sendCheck()
-
-// *******************************************************
-// ********************* Get Checks **********************
-// *******************************************************
-
-async function getChecks() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()   
-  let results = `\n===Connected to ${net}.===\n===Getting account checks.===\n\n`
-  resultField.value = results
-  try {
-    const check_objects = await client.request({
-      "id": 5,
-      "command": "account_objects",
-      "account": accountAddressField.value,
-      "ledger_index": "validated",
-      "type": "check"
-    })
-    resultField.value += JSON.stringify(check_objects.result, null, 2)
-  }  catch (error) {
-    results = `Error getting checks: ${error}`
-    resultField.value += results
-  }
-  finally {
-    client.disconnect()
-  }
-} // End of getChecks()
-
-// *******************************************************
-// ********************  Cash Check **********************
-// *******************************************************
-      
-async function cashCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  results = `\n===Connected to ${net}.===\n===Cashing check.===\n`
-  resultField.value = results
-  try {
-    const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-    let check_amount = amountField.value
-    if (currencyField.value !=  "XRP") {
-      check_amount = {
-        "value": amountField.value,
-        "currency": currencyField.value,
-        "issuer": issuerField.value  	
-      }
-    }
-    const cash_check_tx = {
-      "TransactionType": "CheckCash",
-      "Account": wallet.address,
-      "Amount": check_amount,
-      "CheckID": checkIdField.value
-    }
-    const cash_prepared = await client.autofill(cash_check_tx)
-    const cash_signed = wallet.sign(cash_prepared)
-    results = ' Receiving ' + amountField.value + ' ' + currencyField.value + '.\n'
-    resultField.value += results
-    const check_result = await client.submitAndWait(cash_signed.tx_blob)
-    if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-      results = '===Transaction succeeded===\n' + JSON.stringify(check_result.result, null, 2)
-      resultField.value += results
-    }
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  } catch (error) {
-    results = `Error sending transaction: ${error}`
-    resultField.value += results
-  }
-  finally {
-    client.disconnect()
-  }
-} // end of cashCheck()
-
-// *******************************************************
-// **************** Cancel Check *************************
-// *******************************************************
-
-async function cancelCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  results = `\n===Connected to ${net}.===\n===Cancelling check.===\n`
-  resultField.value = results
-  try {
-    const wallet = xrpl.Wallet.fromSeed(accountSeedField.value)
-    const cancel_check_tx = {
-      "TransactionType": "CheckCancel",
-      "Account": wallet.address,
-      "CheckID": checkIdField.value
-    }
-    const cancel_prepared = await client.autofill(cancel_check_tx)
-    const cancel_signed = wallet.sign(cancel_prepared)
-    const check_result = await client.submitAndWait(cancel_signed.tx_blob)
-    if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-      results += `===Transaction succeeded===\n${check_result.result.meta.TransactionResult}`
-      resultField.value = results
-    } 
-    xrpBalanceField.value = (await client.getXrpBalance(wallet.address))
-  } catch (error) {
-    results = `Error sending transaction: ${error}`
-    resultField.value += results
-  }
-  finally {
-    client.disconnect()
-  }
-} // end of cancelCheck()

_code-samples/quickstart/js/1.get-accounts-send-xrp.html

@@ -1,192 +0,0 @@
-<html>
-  <head>
-    <title>Token Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script>
-      if (typeof module !== "undefined") {
-        const xrpl = require('xrpl')
-      }
-
-    </script>
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Token Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="testnet">Testnet</label>
-      &nbsp;&nbsp;
-      <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= "2"></textarea>
-      <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                   <tr>
-                      <td align="right">
-                        Destination
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                  </table>
-                  <p align="right">
-                    <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&#62;</button>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-          <td>
-            <table>
-              <tr>
-                <td>
-                  <table>
-                    <tr>
-                      <td align="center" valign="top">
-                        <button type="button" onClick="oPsendXRP()">&#60;Send XRP</button>
-                        </td>
-                        <td 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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Destination
-                            </td>
-                            <td>
-                              <input type="text" id="operationalDestinationField" size="40"></input>
-                              <br>
-                            </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>

_code-samples/quickstart/js/10.check.html

@@ -1,278 +0,0 @@
-<html>
-  <head>
-    <title>Token Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>    
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex10-check.js'></script>
-
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Token Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="testnet">Testnet</label>
-      &nbsp;&nbsp;
-      <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= "2"></textarea>
-      <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Issuer
-                      </td>
-                      <td>
-                        <input type="text" id="standbyIssuerField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Check ID
-                      </td>
-                      <td>
-                        <input type="text" id="standbyCheckID" size="40"></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>
-                  </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&#62;</button>
-                        <br/><br/>
-                        <button type="button" onClick="sendCheck()">Send Check</button>
-                        <br/>
-                        <button type="button" onClick="getChecks()">Get Checks</button>
-                        <br/>
-                        <button type="button" onClick="cashCheck()">Cash Check</button>
-                        <br/>
-                        <button type="button" onClick="cancelCheck()">Cancel Check</button>
-                        <br/>
-                        <button type="button" onClick="getBalances()">Get Balances</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()">&#60; Send XRP</button>
-                        <br/><br/>
-                        <button type="button" onClick="opSendCheck()">Send Check</button>
-                        <br/>
-                        <button type="button" onClick="opGetChecks()">Get Checks</button>
-                        <br/>
-                        <button type="button" onClick="opCashCheck()">Cash Check</button>
-                        <br/>
-                        <button type="button" onClick="opCancelCheck()">Cancel Check</button>
-                        <br/>
-                        <button type="button" onClick="getBalances()">Get Balances</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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Destination
-                            </td>
-                            <td>
-                              <input type="text" id="operationalDestinationField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Issuer
-                            </td>
-                            <td>
-                              <input type="text" id="operationalIssuerField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Check ID
-                            </td>
-                            <td>
-                              <input type="text" id="operationalCheckIDField" size="40"></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>
-                        </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>

_code-samples/quickstart/js/11.create-amm.html

@@ -1,302 +0,0 @@
-<html>
-  <head>
-    <title>Create AMM Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>    
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex11-create-amm.js'></script>
-    <script>
-      if (typeof module !== "undefined") {
-        const xrpl = require('xrpl')
-      }
-    </script>
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Create AMM Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="testnet">Testnet</label>
-      &nbsp;&nbsp;
-      <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= "2"></textarea>
-      <br/><br/>
-      <table>
-        <tr valign="top">
-          <td>
-            <table style="padding-bottom: 400px;">
-              <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></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"></input>
-                        <br>
-                      </td>
-                    </tr>                    
-                  </table>
-                  <p align="left">
-                    <textarea id="standbyResultField" cols="60" rows="20" style="resize: none;"></textarea>
-                  </p>
-                  <table>
-                    <tr valign="top">
-                      <td align="right">
-                        Asset 1 Currency
-                      </td>
-                      <td>
-                        <input type="text" id="asset1CurrencyField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 1 Issuer
-                      </td>
-                      <td>
-                        <input type="text" id="asset1IssuerField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 1 Amount
-                      </td>
-                      <td>
-                        <input type="text" id="asset1AmountField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Currency
-                      </td>
-                      <td>
-                        <input type="text" id="asset2CurrencyField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Issuer
-                      </td>
-                      <td>
-                        <input type="text" id="asset2IssuerField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Amount
-                      </td>
-                      <td>
-                        <input type="text" id="asset2AmountField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                  </table>
-                </td>
-                </td>
-                <td>
-                  <table>
-                    <tr valign="top">
-                      <td align="center" valign="top"  style="padding-top: 165px;">
-                        <br>
-                        <button type="button" onClick="sendXRP()">Send XRP&#62;</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()" style="margin-bottom: 160px;">Get Balances</button>
-                        <br/>
-                        <button type="button" onClick="checkAMM()">Check AMM</button>
-                        <br/>
-                        <button type="button" onClick="createAMM()">Create AMM</button>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-          <td>
-            <table style="padding-bottom: 350px;">
-              <tr>
-                <td>
-                <td>
-                  <table>
-                    <tr>
-                      <td align="center" valign="top" style="padding-bottom: 100px;">
-                        <button type="button" onClick="oPsendXRP()">&#60; 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>
-                      </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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Destination
-                            </td>
-                            <td>
-                              <input type="text" id="operationalDestinationField" size="40"></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"></input>
-                            </td>
-                          </tr>
-                        </table>
-                        <p align="right">
-                          <textarea id="operationalResultField" cols="60" rows="20" style="resize: none;"></textarea>
-                          <br><br>
-                          <textarea id="ammInfoField" cols="60" rows="20" style="resize: none;"></textarea>
-                        </p>
-                      </td>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-        </tr>
-      </table>
-    </form>
-  </body>
-</html>

_code-samples/quickstart/js/13.trade-with-auction-slot.html

@@ -1,354 +0,0 @@
-<html>
-  <head>
-    <title>Trade with Auction Slot Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>    
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='https://unpkg.com/bignumber.js@9.1.2/bignumber.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex11-create-amm.js'></script>
-    <script src='ripplex12-add-to-amm.js'></script>
-    <script src='ripplex13a-trade-with-auction-slot.js'></script>
-    <script src='ripplex13b-amm-formulas.js'></script>
-    <script>
-      if (typeof module !== "undefined") {
-        const xrpl = require('xrpl')
-      }
-    </script>
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Trade with Auction Slot Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="testnet">Testnet</label>
-      &nbsp;&nbsp;
-      <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= "2"></textarea>
-      <br/><br/>
-      <table>
-        <tr valign="top">
-          <td>
-            <table style="padding-bottom: 400px;">
-              <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></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"></input>
-                        <br>
-                      </td>
-                    </tr>               
-                  </table>
-                  <table>
-                    <tr>
-                      <td align="right">
-                        Taker Pays<br/><br/>
-                        Currency <input type="text" id="standbyTakerPaysCurrencyField" size="15"></input><br/>
-                        Issuer <input type="text" id="standbyTakerPaysIssuerField" size="15"></input><br/>
-                        Amount <input type="text" id="standbyTakerPaysAmountField" size="15"></input>
-                      </td>
-                      <td align="right">
-                        Taker Gets<br/><br/>
-                        Currency <input type="text" id="standbyTakerGetsCurrencyField" size="15"></input><br/>
-                        Issuer <input type="text" id="standbyTakerGetsIssuerField" size="15"></input><br/>
-                        Amount <input type="text" id="standbyTakerGetsAmountField" size="15"></input><br/>
-                      </td>
-                    </tr>
-                  </table>
-                  <p align="left">
-                    <textarea id="standbyResultField" cols="60" rows="20" style="resize: none;"></textarea>
-                  </p>
-                  <table>
-                    <tr valign="top">
-                      <td align="right">
-                        Asset 1 Currency
-                      </td>
-                      <td>
-                        <input type="text" id="asset1CurrencyField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 1 Issuer
-                      </td>
-                      <td>
-                        <input type="text" id="asset1IssuerField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 1 Amount
-                      </td>
-                      <td>
-                        <input type="text" id="asset1AmountField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Currency
-                      </td>
-                      <td>
-                        <input type="text" id="asset2CurrencyField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Issuer
-                      </td>
-                      <td>
-                        <input type="text" id="asset2IssuerField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Asset 2 Amount
-                      </td>
-                      <td>
-                        <input type="text" id="asset2AmountField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>                    
-                    <tr>
-                      <td align="right">
-                        Trading Fee
-                      </td>
-                      <td>
-                        <input type="text" id="standbyFeeField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        LP Tokens
-                      </td>
-                      <td>
-                        <input type="text" id="standbyLPField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                  </table>
-                </td>
-                </td>
-                <td>
-                  <table>
-                    <tr valign="top">
-                      <td align="center" valign="top"  style="padding-top: 450px;">
-                        <br>
-                        <button type="button" onClick="sendXRP()">Send XRP&#62;</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="estimateCost()">Estimate Cost</button>
-                        <br/>
-                        <button type="button" onClick="swapTokens()" style="margin-bottom: 40px;">Swap Tokens</button>
-                        <br/><br/>
-                        <button type="button" onClick="checkAMM()">Check AMM</button>
-                        <br/>
-                        <button type="button" onClick="createAMM()">Create AMM</button>
-                        <br/>
-                        <button type="button" onClick="addAssets()">Add to AMM</button>
-                        <br/>
-                        <button type="button" onClick="voteFees()">Vote on Fee</button>
-                        <br/><br/>
-                        <button type="button" onClick="calculateLP()">Get LP Value</button>
-                        <br/>
-                        <button type="button" onClick="redeemLP()">Redeem LP</button>
-                        <br/>
-                        <button type="button" onClick="bidAuction()">Bid Auction Slot</button>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-          <td>
-            <table style="padding-bottom: 430px;">
-              <tr>
-                <td>
-                <td>
-                  <table>
-                    <tr>
-                      <td align="center" valign="top" style="padding-top: 60px;">
-                        <button type="button" onClick="oPsendXRP()">&#60; 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>
-                      </td>
-                      <td valign="top" align="right" style="padding-bottom: 15px;">
-                        <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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Destination
-                            </td>
-                            <td>
-                              <input type="text" id="operationalDestinationField" size="40"></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"></input>
-                            </td>
-                          </tr>
-                        </table>
-                        <p align="right"  style="padding-top: 170px;">
-                          <textarea id="operationalResultField" cols="60" rows="20" style="resize: none;"></textarea>
-                          <br><br>
-                          <textarea id="ammInfoField" cols="60" rows="20" style="resize: none;"></textarea>
-                        </p>
-                      </td>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-        </tr>
-      </table>
-    </form>
-  </body>
-</html>

_code-samples/quickstart/js/3a.CreateOffer.html

@@ -1,313 +0,0 @@
-<html>
-  <head>
-    <title>Token Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-      body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-      h1{font-weight: bold;}
-      input, button {padding: 6px;margin-bottom: 8px;}
-      button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-      td{vertical-align: middle;}
-    </style>
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex3a-create-offers.js'></script>
-    <script src='ripplex3b-NameFieldSupport.js'></script>
-    <script>
-      if (typeof module !== "undefined") {
-        const xrpl = require('xrpl')
-      }
-    </script>
-  </head>
-  <!-- ************************************************************** -->
-  <!-- ********************** The Form ****************************** -->
-  <!-- ************************************************************** -->
-  <body>
-    <h1>Token Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="testnet">Testnet</label>
-      &nbsp;&nbsp;
-      <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="55" rows= "4"></textarea>
-      <table>
-        <tr valign="top">
-          <td>
-            <table>
-              <tr valign="top">
-                <td>
-                  <button type="button" onClick="getAccount('standby')">Get New Account</button>
-                  <table>
-                    <tr valign="top">
-                      <td align="right">
-                        Account Name
-                      </td>
-                      <td>
-                        <input type="text" id="standbyNameField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr valign="top">
-                      <td align="right">
-                        Account
-                      </td>
-                      <td>
-                        <input type="text" id="standbyAccountField" 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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></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="false"/>
-                        <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">
-                        Offer Sequence
-                      </td>
-                      <td>
-                        <input type="text" id="standbyOfferSequenceField" size="10"></input>                        
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-              <tr>
-                <td>
-                  <table>
-                    <tr>
-                      <td>
-                        Taker Pays:<br/>
-                        Currency: <input type="text" id="standbyTakerPaysCurrencyField" size="10"></input><br/>
-                        Issuer: <input type="text" id="standbyTakerPaysIssuerField" size="35"></input><br/>
-                        Value: <input type="text" id="standbyTakerPaysValueField" size="10"></input>
-                      </td>
-                      <td>
-                        Taker Gets:<br/>
-                        Currency: <input type="text" id="standbyTakerGetsCurrencyField" size="10"></input><br/>
-                        Issuer: <input type="text" id="standbyTakerGetsIssuerField" size="35"></input><br/>
-                        Value: <input type="text" id="standbyTakerGetsValueField" size="10"></input><br/>
-                      </td>
-                    </tr>
-                  </table>
-                  <p align="left">
-                    <textarea id="standbyResultField" cols="80" rows="20" ></textarea>
-                  </p>
-                </td>
-              </tr>
-            </table>
-          </td>
-<!-- Standby Buttons, Column 2 -->
-          <td>
-            <table>
-              <tr valign="top">
-                <td align="center" valign="top">
-                  <button type="button" onClick="sendXRP()">Send XRP&#62;</button>
-                  <br/>
-                  <button type="button" onClick="createTrustline()">Create Trust Line</button>
-                  <br/>
-                  <button type="button" onClick="getTrustLines()">Get Trust Lines</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="createOffer()">Create Offer</button>
-                  <br/>
-                  <button type="button" onClick="getOffers()">Get Offers</button>
-                  <br/>
-                  <button type="button" onClick="cancelOffer()">Cancel Offer</button>
-                </td>
-              </tr>
-            </table>
-          </td>
-<!-- Operational Buttons, Column 3 -->
-          <td>
-            <table>
-              <tr valign="bottom">
-                <td align="center" valign="middle">
-                  <button type="button" onClick="oPsendXRP()">&#60; Send XRP</button>
-                  <br/>
-                  <button type="button" onClick="oPcreateTrustline()">Create Trust Line</button>
-                  <br/>
-                  <button type="button" onClick="oPgetTrustLines()">Get Trust Lines</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="oPcreateOffer()">Create Offer</button>
-                  <br/>
-                  <button type="button" onClick="oPgetOffers()">Get Offers</button>
-                  <br/>
-                  <button type="button" onClick="oPcancelOffer()">Cancel Offer</button>
-                </td>
-              </tr>
-            </table>
-          </td>
-          
-<!-- Operational fields, Column 4 -->
-
-          <td valign="top" align="right">
-            <button type="button" onClick="getAccount('operational')">Get New Account</button>
-            <table>
-              <tr valign="top">
-                <td align="left">
-                  Account Name
-                </td>
-                <td align="left">
-                  <input type="text" id="operationalNameField" size="40"></input>
-                  <br>
-                </td>
-              </tr>
-              <tr valign="top">
-                <td align="right">
-                  Account
-                </td>
-                <td>
-                  <input type="text" id="operationalAccountField" 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"></input>
-                  <br>
-                </td>
-              </tr>
-              <tr>
-                <td align="right">
-                  Destination
-                </td>
-                <td>
-                  <input type="text" id="operationalDestinationField" size="40"></input>
-                  <br>
-                </td>
-              </tr>
-              <tr>
-                <td></td>
-                <td align="right">
-                  <input type="checkbox" id="operationalDefault" checked="false"/>
-                  <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">
-                  Offer Sequence
-                </td>
-                <td>
-                  <input type="text" id="operationalOfferSequenceField" size="10"></input>                        
-                </td>
-              </tr>
-            </table>
-            <table>
-              <tr>
-                <td>
-                  Taker Pays:<br/>
-                  Currency: <input type="text" id="operationalTakerPaysCurrencyField" size="10"></input><br/>
-                  Issuer: <input type="text" id="operationalTakerPaysIssuerField" size="35"></input><br/>
-                  Value: <input type="text" id="operationalTakerPaysValueField" size="10"></input>
-                </td>
-                <td>
-                  Taker Gets:<br/>
-                  Currency: <input type="text" id="operationalTakerGetsCurrencyField" size="10"></input><br/>
-                  Issuer: <input type="text" id="operationalTakerGetsIssuerField" size="35"></input><br/>
-                  Value: <input type="text" id="operationalTakerGetsValueField" size="10"></input><br/>
-                </td>
-              </tr>
-            </table>
-            <p align="right">
-              <textarea id="operationalResultField" cols="80" rows="20" ></textarea>
-            </p>
-          </td>
-        </tr>
-      </table>
-    </form>
-  </body>
-</html>

_code-samples/quickstart/js/8.escrow.html

@@ -1,269 +0,0 @@
-<html>
-  <head>
-    <title>Time-based Escrow Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex8-escrow.js'></script>
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Time-based Escrow Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="tn">Testnet</label>
-      &nbsp;&nbsp;
-      <input type="radio" id="dn" name="server"
-        value="wss://s.devnet.rippletest.net:51233">
-      <label for="dn">Devnet</label>
-      <br/><br/>
-      <button type="button" onClick="getAccountsFromSeeds()">Get Accounts From Seeds</button>
-      <br/>
-      <textarea id="seeds" cols="40" rows= "2"></textarea>
-      <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination Account
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Finish (seconds)
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowFinishDateField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Cancel (seconds)
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowCancelDateField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Sequence Number
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowSequenceNumberField" size="40"></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">
-                        Seed
-                      </td>
-                      <td>
-                        <input type="text" id="standbySeedField" size="40"></input>
-                        <br>
-                      </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 &#62;</button>
-                        <br/><br/>
-                        <button type="button" onClick="getBalances()">Get Balances</button>       
-                        <br/>
-                        <button type="button" onClick="createTimeEscrow()">Create Time-based Escrow</button>
-                        <br/>
-                        <button type="button" onClick="getStandbyEscrows()">Get Escrows</button>
-                        <br/>
-                        <button type="button" onClick="cancelEscrow()">Cancel Escrow</button>
-                      </td>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-          <td>
-            <table>
-              <tr>
-                <td>
-                <td>
-                  <table>
-                    <tr valign="top">
-                      <td align="center" valign="top">
-                        <button type="button" onClick="oPsendXRP()">&#60; Send XRP</button>
-                        <br/><br/>
-                        <button type="button" onClick="getBalances()">Get Balances</button>
-                        <br/>
-                        <button type="button" onClick="finishEscrow()">Finish Time-based Escrow</button>
-                        <br/>
-                        <button type="button" onClick="getOperationalEscrows()">Get Escrows</button>
-                        <br/>
-                        <button type="button" onClick="getTransaction()">Get Transaction</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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Destination
-                            </td>
-                            <td>
-                              <input type="text" id="operationalDestinationField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                          <tr>
-                            <td align="right">
-                              Escrow Sequence Number
-                            </td>
-                            <td>
-                              <input type="text" id="operationalEscrowSequenceField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>                            <td align="right">
-                              Transaction to Look Up
-                            </td>
-                            <td>
-                              <input type="text" id="operationalTransactionField" size="40"></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">
-                              Seed
-                            </td>
-                            <td>
-                              <input type="text" id="operationalSeedField" size="40"></input>
-                              <br>
-                            </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>

_code-samples/quickstart/js/9.escrow-condition.html

@@ -1,270 +0,0 @@
-<html>
-  <head>
-    <title>Conditional Escrow Test Harness</title>
-    <link href='https://fonts.googleapis.com/css?family=Work Sans' rel='stylesheet'>
-    <style>
-       body{font-family: "Work Sans", sans-serif;padding: 20px;background: #fafafa;}
-       h1{font-weight: bold;}
-       input, button {padding: 6px;margin-bottom: 8px;}
-       button{font-weight: bold;font-family: "Work Sans", sans-serif;}
-       td{vertical-align: middle;}
-    </style>    
-    <script src='https://unpkg.com/xrpl@4.0.0/build/xrpl-latest.js'></script>
-    <script src='ripplex1-send-xrp.js'></script>
-    <script src='ripplex2-send-currency.js'></script>
-    <script src='ripplex8-escrow.js'></script>
-    <script src='ripplex9-escrow-condition.js'></script>
-  </head>
-  
-<!-- ************************************************************** -->
-<!-- ********************** The Form ****************************** -->
-<!-- ************************************************************** -->
-
-  <body>
-    <h1>Conditional Escrow Test Harness</h1>
-    <form id="theForm">
-      Choose your ledger instance:  
-      &nbsp;&nbsp;
-      <input type="radio" id="tn" name="server"
-        value="wss://s.altnet.rippletest.net:51233" checked>
-      <label for="tn">Testnet</label>
-      &nbsp;&nbsp;
-      <input type="radio" id="dn" name="server"
-        value="wss://s.devnet.rippletest.net:51233">
-      <label for="dn">Devnet</label>
-      <br/><br/>
-      <button type="button" onClick="getAccountsFromSeeds()">Get Accounts From Seeds</button>
-      <br/>
-      <textarea id="seeds" cols="40" rows= "2"></textarea>
-      <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">
-                        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"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Destination Account
-                      </td>
-                      <td>
-                        <input type="text" id="standbyDestinationField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Condition
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowConditionField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Cancel (seconds)
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowCancelDateField" size="40"></input>
-                        <br>
-                      </td>
-                    </tr>
-                    <tr>
-                      <td align="right">
-                        Escrow Sequence Number
-                      </td>
-                      <td>
-                        <input type="text" id="standbyEscrowSequenceNumberField" size="40"></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">
-                        Seed
-                      </td>
-                      <td>
-                        <input type="text" id="standbySeedField" size="40"></input>
-                        <br>
-                      </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 &#62;</button>
-                        <br/><br/>
-                        <button type="button" onClick="getBalances()">Get Balances</button>       
-                        <br/>
-                        <button type="button" onClick="createConditionalEscrow()">Create Conditional Escrow</button>
-                        <br/>
-                        <button type="button" onClick="getStandbyEscrows()">Get Escrows</button>
-                        <br/>
-                        <button type="button" onClick="cancelEscrow()">Cancel Escrow</button>
-                      </td>
-                      </td>
-                    </tr>
-                    </td>
-                    </tr>
-                  </table>
-                </td>
-              </tr>
-            </table>
-          </td>
-          <td>
-            <table>
-              <tr>
-                <td>
-                <td>
-                  <table>
-                    <tr valign="top">
-                      <td align="center" valign="top">
-                        <button type="button" onClick="oPsendXRP()">&#60; Send XRP</button>
-                        <br/><br/>
-                        <button type="button" onClick="getBalances()">Get Balances</button>
-                        <br/>
-                        <button type="button" onClick="finishConditionalEscrow()">Finish Conditional Escrow</button>
-                        <br/>
-                        <button type="button" onClick="getOperationalEscrows()">Get Escrows</button>
-                        <br/>
-                        <button type="button" onClick="getTransaction()">Get Transaction</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">
-                              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"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Fulfillment Code
-                            </td>
-                            <td>
-                              <input type="text" id="operationalFulfillmentField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                          <tr>
-                            <td align="right">
-                              Escrow Sequence Number
-                            </td>
-                            <td>
-                              <input type="text" id="operationalEscrowSequenceField" size="40"></input>
-                              <br>
-                            </td>
-                          </tr>
-                          <tr>
-                            <td align="right">
-                              Transaction to Look Up
-                            </td>
-                            <td>
-                              <input type="text" id="operationalTransactionField" size="40"></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">
-                              Seed
-                            </td>
-                            <td>
-                              <input type="text" id="operationalSeedField" size="40"></input>
-                              <br>
-                            </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>

_code-samples/quickstart/js/ripplex10-check.js

@@ -1,329 +0,0 @@
-// *******************************************************
-// ************* Standby Send Check **********************
-// *******************************************************
-async function sendCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  standbyResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  var check_amount = standbyAmountField.value
-  
-  if (standbyCurrencyField.value !=  "XRP") {
-  	check_amount = {
-      "currency": standbyCurrencyField.value,
-      "value": standbyAmountField.value,
-      "issuer": standby_wallet.address  	
-  	}
-  }
-  
-  const send_check_tx = {
-    "TransactionType": "CheckCreate",
-    "Account": standby_wallet.address,
-    "SendMax": check_amount,
-    "Destination": standbyDestinationField.value
-  }
-  const check_prepared = await client.autofill(send_check_tx)
-  const check_signed = standby_wallet.sign(check_prepared)
-  results += 'Sending ' + check_amount + ' ' + standbyCurrencyField + ' to ' +
-    standbyDestinationField.value + '...'
-  standbyResultField.value = results
-  const check_result = await client.submitAndWait(check_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${check_signed.hash}'
-    standbyResultField.value = JSON.stringify(check_result.result, null, 2)
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    standbyResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-
-  client.disconnect()
-} // end of sendCheck()
-
-// *******************************************************
-// *************** Standby Get Checks ********************
-// *******************************************************
-
-async function getChecks() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  await client.connect()   
-  results += '\nConnected.'
-  standbyResultField.value = results
-
-  results= "\nGetting standby account checks...\n"
-  const check_objects = await client.request({
-    "id": 5,
-    "command": "account_objects",
-    "account": standbyAccountField.value,
-    "ledger_index": "validated",
-    "type": "check"
-  })
-  standbyResultField.value = JSON.stringify(check_objects.result, null, 2)
-  client.disconnect()
-} // End of getChecks()
-
-// *******************************************************
-// ************* Standby Cash Check **********************
-// *******************************************************
-      
-async function cashCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  standbyResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-
-  var check_amount = standbyAmountField.value
-  
-  if (standbyCurrencyField.value !=  "XRP") {
-  	check_amount = {
-      "value": standbyAmountField.value,
-      "currency": standbyCurrencyField.value,
-      "issuer": standbyIssuerField.value  	
-  	}
-  }
-  const cash_check_tx = {
-    "TransactionType": "CheckCash",
-    "Account": standby_wallet.address,
-    "Amount": check_amount,
-    "CheckID": standbyCheckID.value
-  }
-  const cash_prepared = await client.autofill(cash_check_tx)
-  const cash_signed = standby_wallet.sign(cash_prepared)
-  results += ' Receiving ' + standbyAmountField.value + ' ' + standbyCurrencyField.value + '.\n'
-  standbyResultField.value = results
-  const check_result = await client.submitAndWait(cash_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${cash_signed.hash}'
-    standbyResultField.value = results
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    standbyResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-
-  client.disconnect()
-} // end of cashCheck()
-
-// *******************************************************
-// *************** Standby Cancel Check ******************
-// *******************************************************
-
-async function cancelCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  standbyResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-        
-  const cancel_check_tx = {
-    "TransactionType": "CheckCancel",
-    "Account": standby_wallet.address,
-    "CheckID": standbyCheckID.value
-  }
-  const cancel_prepared = await client.autofill(cancel_check_tx)
-  const cancel_signed = standby_wallet.sign(cancel_prepared)
-  results += ' Cancelling check.\n'
-  standbyResultField.value = results
-  const check_result = await client.submitAndWait(cancel_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${cash_signed.hash}'
-    standbyResultField.value = results
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    standbyResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  client.disconnect()
-} // end of cancelCheck()
-
-// *******************************************************
-// ************ Operational Send Check *******************
-// *******************************************************
-async function opSendCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  operationalResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-
-  const issue_quantity = operationalAmountField.value
-  var check_amount = operationalAmountField.value
-  
-  if (operationalCurrencyField.value !=  "XRP") {
-  	check_amount = {
-      "currency": operationalCurrencyField.value,
-      "value": operationalAmountField.value,
-      "issuer": operational_wallet.address  	
-  	}
-  }  
-  const send_check_tx = {
-    "TransactionType": "CheckCreate",
-    "Account": operational_wallet.address,
-    "SendMax": check_amount,
-    "Destination": operationalDestinationField.value
-  }
-  const check_prepared = await client.autofill(send_check_tx)
-  const check_signed = operational_wallet.sign(check_prepared)
-  results += '\nSending check to ' +
-    operationalDestinationField.value + '...'
-  operationalResultField.value = results
-  const check_result = await client.submitAndWait(check_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${check_signed.hash}'
-    operationalResultField.value = JSON.stringify(check_result.result, null, 2)
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    operationalResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  client.disconnect()
-} // end of opSendCheck()
-
-// *******************************************************
-// ************ Operational Get Checks *******************
-// *******************************************************
-
-async function opGetChecks() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  await client.connect()   
-  results += '\nConnected.'
-  operationalResultField.value = results
-
-  results= "\nGetting standby account checks...\n"
-  const check_objects = await client.request({
-    "id": 5,
-    "command": "account_objects",
-    "account": operationalAccountField.value,
-    "ledger_index": "validated",
-    "type": "check"
-  })
-  operationalResultField.value = JSON.stringify(check_objects.result, null, 2)
-  client.disconnect()
-} // End of opGetChecks()
-
-
-// *******************************************************
-// ************* Operational Cash Check ******************
-// *******************************************************
-      
-async function opCashCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  operationalResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-
-  var check_amount = operationalAmountField.value
-  
-  if (operationalCurrencyField.value !=  "XRP") {
-  	check_amount = {
-      "value": operationalAmountField.value,
-      "currency": operationalCurrencyField.value,
-      "issuer": operationalIssuerField.value  	
-  	}
-  }
-  const cash_check_tx = {
-    "TransactionType": "CheckCash",
-    "Account": operational_wallet.address,
-    "Amount": check_amount,
-    "CheckID": operationalCheckIDField.value
-  }
-  const cash_prepared = await client.autofill(cash_check_tx)
-  const cash_signed = operational_wallet.sign(cash_prepared)
-  results += ' Receiving ' + operationalAmountField.value + ' ' + operationalCurrencyField.value + '.\n'
-  operationalResultField.value = results
-  const check_result = await client.submitAndWait(cash_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${cash_signed.hash}'
-    operationalResultField.value = results
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    operationalResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  client.disconnect()
-}
-// end of opCashCheck()
-
-// *******************************************************
-// ************* Operational Cancel Check ****************
-// *******************************************************
-
-async function opCancelCheck() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  await client.connect()
-  results += '\nConnected.'
-  operationalResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-        
-  const cancel_check_tx = {
-    "TransactionType": "CheckCancel",
-    "Account": operational_wallet.address,
-    "CheckID": operationalCheckIDField.value
-  }
-
-  const cancel_prepared = await client.autofill(cancel_check_tx)
-  const cancel_signed = operational_wallet.sign(cancel_prepared)
-  results += ' Cancelling check.\n'
-  operationalResultField.value = results
-  const check_result = await client.submitAndWait(cancel_signed.tx_blob)
-  if (check_result.result.meta.TransactionResult == "tesSUCCESS") {
-    results += 'Transaction succeeded: https://testnet.xrpl.org/transactions/${cash_signed.hash}'
-    operationalResultField.value = results
-  } else {
-    results += 'Transaction failed: See JavaScript console for details.'
-    operationalResultField.value = results
-    throw 'Error sending transaction: ${check_result.result.meta.TransactionResult}'
-  }
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  client.disconnect()
-} // end of cancelCheck()

_code-samples/quickstart/js/ripplex11-create-amm.js

@@ -1,194 +0,0 @@
-// Create AMM function
-
-async function createAMM() {
-
-  let net = getNet()
-
-  const client = new xrpl.Client(net)
-  results = `\n\nConnecting to ${getNet()} ...`
-  standbyResultField.value = results
-
-  await client.connect()
-  results += '\n\nConnected.'
-  standbyResultField.value = results
-          
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-
-  const asset1_currency = asset1CurrencyField.value
-  const asset1_issuer = asset1IssuerField.value
-  const asset1_amount = asset1AmountField.value
-
-  const asset2_currency = asset2CurrencyField.value
-  const asset2_issuer = asset2IssuerField.value
-  const asset2_amount = asset2AmountField.value
-
-  let ammCreate = null
-  
-  results += '\n\nCreating AMM ...'
-  standbyResultField.value = results
-  
-  // AMMCreate requires burning one owner reserve. We can look up that amount
-  // (in drops) on the current network using server_state:
-  const ss = await client.request({"command": "server_state"})
-  const amm_fee_drops = ss.result.state.validated_ledger.reserve_inc.toString()
-
-  if (asset1_currency == 'XRP') {
-
-    ammCreate = {
-      "TransactionType": "AMMCreate",
-      "Account": standby_wallet.address,
-      "Amount": JSON.stringify(asset1_amount * 1000000), // convert XRP to drops
-      "Amount2": {
-        "currency": asset2_currency,
-        "issuer": asset2_issuer,
-        "value": asset2_amount
-      },
-      "TradingFee": 500, // 500 = 0.5%
-      "Fee": amm_fee_drops
-    }
-
-  } else if (asset2_currency =='XRP') {
-
-    ammCreate = {
-      "TransactionType": "AMMCreate",
-      "Account": standby_wallet.address,
-      "Amount": {
-        "currency": asset1_currency,
-        "issuer": asset1_issuer,
-        "value": asset1_amount
-      },
-      "Amount2": JSON.stringify(asset2_amount * 1000000), // convert XRP to drops
-      "TradingFee": 500, // 500 = 0.5%
-      "Fee": amm_fee_drops
-    }
-
-  } else {
-
-    ammCreate = {
-      "TransactionType": "AMMCreate",
-      "Account": standby_wallet.address,
-      "Amount": {
-        "currency": asset1_currency,
-        "issuer": asset1_issuer,
-        "value": asset1_amount
-      },
-      "Amount2": {
-        "currency": asset2_currency,
-        "issuer": asset2_issuer,
-        "value": asset2_amount
-      },
-      "TradingFee": 500, // 500 = 0.5%
-      "Fee": amm_fee_drops
-    }
-    
-  }
-
-  try {
- 
-    const prepared_create = await client.autofill(ammCreate)
-    results += `\n\nPrepared transaction:\n${JSON.stringify(prepared_create, null, 2)}`
-    standbyResultField.value = results
-    standbyResultField.scrollTop = standbyResultField.scrollHeight  
-  
-    const signed_create = standby_wallet.sign(prepared_create)
-    results += `\n\nSending AMMCreate transaction ...`
-    standbyResultField.value = results
-    standbyResultField.scrollTop = standbyResultField.scrollHeight
-    
-    const amm_create = await client.submitAndWait(signed_create.tx_blob)
-    
-    if (amm_create.result.meta.TransactionResult == "tesSUCCESS") {
-      results += `\n\nTransaction succeeded.`
-    } else {
-      results += `\n\nError sending transaction: ${JSON.stringify(amm_create.result.meta.TransactionResult, null, 2)}`
-    }
-  
-  } catch (error) {
-    results += `\n\n${error.message}`
-  }
-  
-  standbyResultField.value = results
-  standbyResultField.scrollTop = standbyResultField.scrollHeight
-
-  checkAMM()
-      
-  client.disconnect()
-  
-}
-
-// Check AMM function
-
-async function checkAMM() {
-
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  await client.connect()
-  
-  // Gets the issuer and currency code
-  const asset1_currency = asset1CurrencyField.value
-  const asset1_issuer = asset1IssuerField.value
-
-  const asset2_currency = asset2CurrencyField.value
-  const asset2_issuer = asset2IssuerField.value
-
-  let amm_info_request = null
-
-  // Get AMM info transaction
-
-  if (asset1_currency == 'XRP') {
-
-    amm_info_request = {
-      "command": "amm_info",
-      "asset": {
-        "currency": "XRP"
-      },
-      "asset2": {
-        "currency": asset2_currency,
-        "issuer": asset2_issuer
-      },
-      "ledger_index": "validated"
-    }
-
-  } else if (asset2_currency =='XRP') {
-
-    amm_info_request = {
-      "command": "amm_info",
-      "asset": {
-        "currency": asset1_currency,
-        "issuer": asset1_issuer
-      },
-      "asset2": {
-        "currency": "XRP"
-      },
-      "ledger_index": "validated"
-    }
-
-  } else {
-
-    amm_info_request = {
-      "command": "amm_info",
-      "asset": {
-        "currency": asset1_currency,
-        "issuer": asset1_issuer
-      },
-      "asset2": {
-        "currency": asset2_currency,
-        "issuer": asset2_issuer
-      },
-      "ledger_index": "validated"
-    }
-    
-  }
-
-  try {
-    const amm_info_result = await client.request(amm_info_request)
-    ammInfo = `AMM Info:\n\n${JSON.stringify(amm_info_result.result.amm, null, 2)}`
-  } catch(error) {
-    ammInfo = `AMM Info:\n\n${error}`
-  }
-  
-  ammInfoField.value = ammInfo
-      
-  client.disconnect()
-  
-}

_code-samples/quickstart/js/ripplex13a-trade-with-auction-slot.js

@@ -1,365 +0,0 @@
-// Function to estimate cost to swap for specified token value.
-
-async function estimateCost() {
-
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-
-    try {
-
-        const asset1_currency = asset1CurrencyField.value
-        const asset1_issuer = asset1IssuerField.value
-
-        const asset2_currency = asset2CurrencyField.value
-        const asset2_issuer = asset2IssuerField.value
-
-
-        // Look up AMM info
-
-        let asset1_info = null
-        let asset2_info = null
-
-        if ( asset1_currency == 'XRP' ) {
-            asset1_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset1_info = {
-                "currency": asset1_currency,
-                "issuer": asset1_issuer
-            }
-        }
-
-        if ( asset2_currency == 'XRP' ) {
-            asset2_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset2_info = {
-                "currency": asset2_currency,
-                "issuer": asset2_issuer
-            }
-        }
-
-        const amm_info = (await client.request({
-            "command": "amm_info", 
-            "asset": asset1_info,
-            "asset2": asset2_info
-        }))
-
-        // Save relevant AMM info for calculations
-
-        const lpt = amm_info.result.amm.lp_token
-        const pool_asset1 = amm_info.result.amm.amount
-        const pool_asset2 = amm_info.result.amm.amount2
-        const full_trading_fee = amm_info.result.amm.trading_fee
-        const discounted_fee = amm_info.result.amm.auction_slot.discounted_fee
-        const old_bid = amm_info.result.amm.auction_slot.price.value
-        const time_interval = amm_info.result.amm.auction_slot.time_interval
-
-        results += `\n\nTrading Fee: ${full_trading_fee/1000}%\nDiscounted Fee: ${discounted_fee/1000}%`
-
-        // Save taker pays and gets values.
-        
-        const takerPays = {
-            "currency": standbyTakerPaysCurrencyField.value,
-            "issuer": standbyTakerPaysIssuerField.value,
-            "amount": standbyTakerPaysAmountField.value
-        }
-
-        const takerGets = {
-            "currency": standbyTakerGetsCurrencyField.value,
-            "issuer": standbyTakerGetsIssuerField.value,
-            "amount": standbyTakerGetsAmountField.value
-        }
-
-        // Get amount of assets in the pool.
-        // Convert values to BigNumbers with the appropriate precision.
-        // Tokens always have 15 significant digits;
-        // XRP is precise to integer drops, which can be as high as 10^17
-
-        let asset_out_bn = null
-        let pool_in_bn = null
-        let pool_out_bn = null
-        let isAmmAsset1Xrp = false
-        let isAmmAsset2Xrp = false
-
-        if ( takerPays.currency == 'XRP' ) {
-            asset_out_bn = BigNumber(xrpl.xrpToDrops(takerPays.amount)).precision(17)
-        } else {
-            asset_out_bn = BigNumber(takerPays.amount).precision(15)
-        }
-
-        if ( takerGets.currency == 'XRP' && asset1_currency == 'XRP' ) {
-            pool_in_bn = BigNumber(pool_asset1).precision(17)
-            isAmmAsset1Xrp = true
-        } else if ( takerGets.currency == 'XRP' && asset2_currency == 'XRP' ) {
-            pool_in_bn = BigNumber(pool_asset2).precision(17)
-            isAmmAsset2Xrp = true
-        } else if ( takerGets.currency == asset1_currency ) {
-            pool_in_bn = BigNumber(pool_asset1.value).precision(15)
-        } else {
-            pool_in_bn = BigNumber(pool_asset2.value).precision(15)
-        }
-
-        if (takerPays.currency == 'XRP' && asset1_currency == 'XRP' ) {
-            pool_out_bn = BigNumber(pool_asset1).precision(17)
-        } else if ( takerPays.currency == 'XRP' && asset2_currency == 'XRP' ) {
-            pool_out_bn = BigNumber(pool_asset2).precision(17)
-        } else if ( takerPays.currency == asset1_currency ) {
-            pool_out_bn = BigNumber(pool_asset1.value).precision(15)
-        } else {
-            pool_out_bn = BigNumber(pool_asset2.value).precision(15)
-        }
-
-        if ( takerPays.currency == 'XRP' && parseFloat(takerPays.amount) > parseFloat(xrpl.dropsToXrp(pool_out_bn)) ) {
-            results += `\n\nRequested ${takerPays.amount} ${takerPays.currency}, but AMM only holds ${xrpl.dropsToXrp(pool_out_bn)}. Quitting.`
-            standbyResultField.value = results
-            client.disconnect()
-            return
-        } else if ( parseFloat(takerPays.amount) > parseFloat(pool_out_bn) ) {
-            results += `\n\nRequested ${takerPays.amount} ${takerPays.currency}, but AMM only holds ${pool_out_bn}. Quitting.`
-            standbyResultField.value = results
-            client.disconnect()
-            return
-        }
-
-        // Use AMM's SwapOut formula to figure out how much of the takerGets asset
-        // you have to pay to receive the target amount of takerPays asset
-        const unrounded_amount = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, full_trading_fee)
-        // Drop decimal places and round ceiling to ensure you pay in enough.
-        const swap_amount = unrounded_amount.dp(0, BigNumber.ROUND_CEIL)
-
-        // Helper function to convert drops to XRP in log window
-        function convert(currency, amount) {
-            if ( currency == 'XRP' ) {
-                amount = xrpl.dropsToXrp(amount)
-            }
-            return amount
-        }
-
-        results += `\n\nExpected cost for ${takerPays.amount} ${takerPays.currency}: ${convert(takerGets.currency, swap_amount)} ${takerGets.currency}`
-
-        // Use SwapOut to calculate discounted swap amount with auction slot
-        const raw_discounted = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, discounted_fee)
-        const discounted_swap_amount = raw_discounted.dp(0, BigNumber.ROUND_CEIL)    
-        results += `\n\nExpected cost with auction slot for ${takerPays.amount} ${takerPays.currency}: ${convert(takerGets.currency, discounted_swap_amount)} ${takerGets.currency}`
-
-        // Calculate savings by using auction slot
-        const potential_savings = swap_amount.minus(discounted_swap_amount)
-        results += `\nPotential savings: ${convert(takerGets.currency, potential_savings)} ${takerGets.currency}`
-
-        // Calculate the cost of winning the auction slot, in LP Tokens.
-        const auction_price = auctionDeposit(old_bid, time_interval, full_trading_fee, lpt.value).dp(3, BigNumber.ROUND_CEIL)
-        results += `\n\nYou can win the current auction slot by bidding ${auction_price} LP Tokens.`
-
-        // Calculate how much to add for a single-asset deposit to receive the target LP Token amount
-        let deposit_for_bid_asset1 = null
-        let deposit_for_bid_asset2 = null
-
-        if ( isAmmAsset1Xrp == true ) {
-            deposit_for_bid_asset1 = xrpl.dropsToXrp(ammAssetIn(pool_asset1, lpt.value, auction_price, full_trading_fee).dp(0, BigNumber.ROUND_CEIL))
-        } else {
-            deposit_for_bid_asset1 = ammAssetIn(pool_asset1.value, lpt.value, auction_price, full_trading_fee).dp(15, BigNumber.ROUND_CEIL)
-        }
-
-        if ( isAmmAsset2Xrp == true ) {
-            deposit_for_bid_asset2 = xrpl.dropsToXrp(ammAssetIn(pool_asset2, lpt.value, auction_price, full_trading_fee).dp(0, BigNumber.ROUND_CEIL))
-        } else {
-            deposit_for_bid_asset2 = ammAssetIn(pool_asset2.value, lpt.value, auction_price, full_trading_fee).dp(15, BigNumber.ROUND_CEIL)
-        }
-
-        if ( isAmmAsset1Xrp == true ) {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} XRP or ${deposit_for_bid_asset2} ${pool_asset2.currency} to get the required LP Tokens.`
-        } else if ( isAmmAsset2Xrp == true ) {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} ${pool_asset1.currency} or ${deposit_for_bid_asset2} XRP to get the required LP Tokens.`
-        } else {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} ${pool_asset1.currency} or ${deposit_for_bid_asset2} ${pool_asset2.currency} to get the required LP Tokens.`
-        }
-
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}
-
-// Bid on the auction slot
-
-async function bidAuction() {
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-
-    try {
-
-        const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-
-        const asset1_currency = asset1CurrencyField.value
-        const asset1_issuer = asset1IssuerField.value
-
-        const asset2_currency = asset2CurrencyField.value
-        const asset2_issuer = asset2IssuerField.value
-        const valueLPT = standbyLPField.value
-
-        // Look up AMM info
-
-        let asset1_info = null
-        let asset2_info = null
-
-        if ( asset1_currency == 'XRP' ) {
-            asset1_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset1_info = {
-                "currency": asset1_currency,
-                "issuer": asset1_issuer
-            }
-        }
-
-        if ( asset2_currency == 'XRP' ) {
-            asset2_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset2_info = {
-                "currency": asset2_currency,
-                "issuer": asset2_issuer
-            }
-        }
-
-        const amm_info = (await client.request({
-            "command": "amm_info", 
-            "asset": asset1_info,
-            "asset2": asset2_info
-        }))
-
-        // Save relevant AMM info for calculations
-
-        const lpt = amm_info.result.amm.lp_token
-
-        results += '\n\nBidding on auction slot ...'
-        standbyResultField.value = results
-
-        const bid_result = await client.submitAndWait({
-            "TransactionType": "AMMBid",
-            "Account": standby_wallet.address,
-            "Asset": asset1_info,
-            "Asset2": asset2_info,
-            "BidMax": {
-                "currency": lpt.currency,
-                "issuer": lpt.issuer,
-                "value": valueLPT
-            },
-            "BidMin": {
-                "currency": lpt.currency,
-                "issuer": lpt.issuer,
-                "value": valueLPT
-            } // So rounding doesn't leave dust amounts of LPT
-            }, {autofill: true, wallet: standby_wallet})
-    
-        if (bid_result.result.meta.TransactionResult == "tesSUCCESS") {
-            results += `\n\nTransaction succeeded.`
-            checkAMM()
-        } else {
-            results += `\n\nError sending transaction: ${JSON.stringify(bid_result.result.meta.TransactionResult, null, 2)}`
-        }        
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}
-
-// Swap tokens with AMM
-async function swapTokens() {
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-
-    try {
-
-        const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-
-        const takerPaysCurrency = standbyTakerPaysCurrencyField.value
-        const takerPaysIssuer = standbyTakerPaysIssuerField.value
-        const takerPaysAmount = standbyTakerPaysAmountField.value
-
-        const takerGetsCurrency = standbyTakerGetsCurrencyField.value
-        const takerGetsIssuer = standbyTakerGetsIssuerField.value
-        const takerGetsAmount = standbyTakerGetsAmountField.value
-
-        let takerPays = null
-        let takerGets = null
-
-        if ( takerPaysCurrency == 'XRP' ) {
-            takerPays = xrpl.xrpToDrops(takerPaysAmount)
-        } else {
-            takerPays = {
-                "currency": takerPaysCurrency,
-                "issuer": takerPaysIssuer,
-                "value": takerPaysAmount
-            }
-        }
-
-        if ( takerGetsCurrency == 'XRP' ) {
-            takerGets = xrpl.xrpToDrops(takerGetsAmount)
-        } else {
-            takerGets = {
-                "currency": takerGetsCurrency,
-                "issuer": takerGetsIssuer,
-                "value": takerGetsAmount
-            }
-        }
-
-        results += '\n\nSwapping tokens ...'
-        standbyResultField.value = results
-
-        const offer_result = await client.submitAndWait({
-            "TransactionType": "OfferCreate",
-            "Account": standby_wallet.address,
-            "TakerPays": takerPays,
-            "TakerGets": takerGets
-        }, {autofill: true, wallet: standby_wallet})
-        
-        if (offer_result.result.meta.TransactionResult == "tesSUCCESS") {
-            results += `\n\nTransaction succeeded.`
-            checkAMM()
-        } else {
-            results += `\n\nError sending transaction: ${JSON.stringify(offer_result.result.meta.TransactionResult, null, 2)}`
-        }        
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}

_code-samples/quickstart/js/ripplex13b-amm-formulas.js

@@ -1,154 +0,0 @@
-/* Convert a trading fee to a value that can be multiplied
- * by a total to "subtract" the fee from the total.
- * @param tFee int {0, 1000}
- *             such that 1 = 1/100,000 and 1000 = 1% fee
- * @returns BigNumber (1 - fee) as a decimal
- */
-function feeMult(tFee) {
-    return BigNumber(1).minus( feeDecimal(tFee) )
-}
-
-/* Same as feeMult, but with half the trading fee. Single-asset deposits and
- * withdrawals use this because half of the deposit is treated as being
- * "swapped" for the other asset in the AMM's pool.
- * @param tFee int {0, 1000}
- *             such that 1 = 1/100,000 and 1000 = 1% fee
- * @returns BigNumber (1 - (fee/2)) as a decimal
- */
-function feeMultHalf(tFee) {
-    return BigNumber(1).minus( feeDecimal(tFee).dividedBy(2) )
-}
-
-/* Convert a trading fee to a decimal BigNumber value,
- * for example 1000 becomes 0.01
- * @param tFee int {0, 1000}
- *             such that 1 = 1/100,000 and 1000 = 1% fee
- * @returns BigNumber(fee) as a decimal
- */
-function feeDecimal(tFee) {
-    const AUCTION_SLOT_FEE_SCALE_FACTOR = 100000
-    return BigNumber(tFee).dividedBy(AUCTION_SLOT_FEE_SCALE_FACTOR)
-}
-
-/* Implement the AMM SwapOut formula, as defined in XLS-30 section 2.4 AMM 
- * Swap, formula 10. The asset weights WA/WB are currently always 1/1 so 
- * they're canceled out.
- * C++ source: https://github.com/XRPLF/rippled/blob/2d1854f354ff8bb2b5671fd51252c5acd837c433/src/ripple/app/misc/AMMHelpers.h#L253-L258
- * @param asset_out_bn BigNumber - The target amount to receive from the AMM.
- * @param pool_in_bn BigNumber - The amount of the input asset in the AMM's 
- *                               pool before the swap.
- * @param pool_out_bn BigNumber - The amount of the output asset in the AMM's
- *                                pool before the swap.
- * @param trading_fee int - The trading fee as an integer {0, 1000} where 1000 
- *                          represents a 1% fee.
- * @returns BigNumber - The amount of the input asset that must be swapped in 
- *                      to receive the target output amount. Unrounded, because
- *                      the number of decimals depends on if this is drops of 
- *                      XRP or a decimal amount of a token; since this is a
- *                      theoretical input to the pool, it should be rounded 
- *                      up (ceiling) to preserve the pool's constant product.
- */
-function swapOut(asset_out_bn, pool_in_bn, pool_out_bn, trading_fee) {
-    return ( ( pool_in_bn.multipliedBy(pool_out_bn) ).dividedBy(
-                pool_out_bn.minus(asset_out_bn)
-             ).minus(pool_in_bn)
-           ).dividedBy(feeMult(trading_fee))
-}
-
-/* Compute the quadratic formula. Helper function for ammAssetIn.
- * Params and return value are BigNumber instances.
- */
-function solveQuadraticEq(a,b,c) {
-    const b2minus4ac = b.multipliedBy(b).minus( 
-                            a.multipliedBy(c).multipliedBy(4) 
-                       )
-    return ( b.negated().plus(b2minus4ac.sqrt()) ).dividedBy(a.multipliedBy(2))
-}
-
-/* Implement the AMM single-asset deposit formula to calculate how much to
- * put in so that you receive a specific number of LP Tokens back.
- * C++ source: https://github.com/XRPLF/rippled/blob/2d1854f354ff8bb2b5671fd51252c5acd837c433/src/ripple/app/misc/impl/AMMHelpers.cpp#L55-L83
- * @param pool_in string - Quantity of input asset the pool already has
- * @param lpt_balance string - Quantity of LP Tokens already issued by the AMM
- * @param desired_lpt string - Quantity of new LP Tokens you want to receive
- * @param trading_fee int - The trading fee as an integer {0,1000} where 1000
- *                          represents a 1% fee.
- */
-function ammAssetIn(pool_in, lpt_balance, desired_lpt, trading_fee) {
-    // convert inputs to BigNumber
-    const lpTokens = BigNumber(desired_lpt)
-    const lptAMMBalance = BigNumber(lpt_balance)
-    const asset1Balance = BigNumber(pool_in)
-
-    const f1 = feeMult(trading_fee)
-    const f2 = feeMultHalf(trading_fee).dividedBy(f1)
-    const t1 = lpTokens.dividedBy(lptAMMBalance)
-    const t2 = t1.plus(1)
-    const d = f2.minus( t1.dividedBy(t2) )
-    const a = BigNumber(1).dividedBy( t2.multipliedBy(t2))
-    const b = BigNumber(2).multipliedBy(d).dividedBy(t2).minus( 
-                    BigNumber(1).dividedBy(f1)
-              )
-    const c = d.multipliedBy(d).minus( f2.multipliedBy(f2) )
-    return asset1Balance.multipliedBy(solveQuadraticEq(a,b,c))
-}
-
-/* Calculate how much to deposit, in terms of LP Tokens out, to be able to win
- * the auction slot. This is based on the slot pricing algorithm defined in 
- * XLS-30 section 4.1.1, but factors in the increase in the minimum bid as a 
- * result of having new LP Tokens issued to you from your deposit.
- */
-function auctionDeposit(old_bid, time_interval, trading_fee, lpt_balance) {
-    const tfee_decimal = feeDecimal(trading_fee)
-    const lptokens = BigNumber(lpt_balance)
-    const b = BigNumber(old_bid)
-    let outbidAmount = BigNumber(0) // This is the case if time_interval >= 20
-    if (time_interval == 0) {
-        outbidAmount = b.multipliedBy("1.05")
-    } else if (time_interval <= 19) {
-        const t60 = BigNumber(time_interval).multipliedBy("0.05").exponentiatedBy(60)
-        outbidAmount = b.multipliedBy("1.05").multipliedBy(BigNumber(1).minus(t60))
-    }
-
-    const new_bid = lptokens.plus(outbidAmount).dividedBy(
-                            BigNumber(25).dividedBy(tfee_decimal).minus(1)
-                          ).plus(outbidAmount)
-    
-    // Significant digits for the deposit are limited by total LPTokens issued
-    // so we calculate lptokens + deposit - lptokens to determine where the
-    // rounding occurs. We use ceiling/floor to make sure the amount we receive
-    // after rounding is still enough to win the auction slot.
-    const rounded_bid = new_bid.plus(lptokens).precision(15, BigNumber.CEILING
-                              ).minus(lptokens).precision(15, BigNumber.FLOOR)
-    return rounded_bid
-}
-
-/* Calculate the necessary bid to win the AMM Auction slot, per the pricing
- * algorithm defined in XLS-30 section 4.1.1, if you already hold LP Tokens.
- * 
- * NOT USED in the Auction Slot tutorial, which assumes the user does not hold
- * any LP Tokens.
- * 
- * @returns BigNumber - the minimum amount of LP tokens to win the auction slot
- */
-function auctionPrice(old_bid, time_interval, trading_fee, lpt_balance) {
-    const tfee_decimal = feeDecimal(trading_fee)
-    const lptokens = BigNumber(lpt_balance)
-    const min_bid = lptokens.multipliedBy(tfee_decimal).dividedBy(25)
-    const b = BigNumber(old_bid)
-    let new_bid = min_bid
-    
-    if (time_interval == 0) {
-        new_bid = b.multipliedBy("1.05").plus(min_bid)
-    } else if (time_interval <= 19) {
-        const t60 = BigNumber(time_interval).multipliedBy("0.05"
-                    ).exponentiatedBy(60)
-        new_bid = b.multipliedBy("1.05").multipliedBy(
-                      BigNumber(1).minus(t60)
-                  ).plus(min_bid)
-    }
-
-    const rounded_bid = new_bid.plus(lptokens).precision(15, BigNumber.CEILING
-                              ).minus(lptokens).precision(15, BigNumber.FLOOR)
-    return rounded_bid
-}

_code-samples/quickstart/js/ripplex3a-create-offers.js

@@ -1,270 +0,0 @@
-/***********************************
- *********** Create Offer **********
- **********************************/
-
- async function createOffer() {
-  let takerGets = ''
-  let takerPays = ''
-  let net = getNet()
-  let results = 'Connecting to ' + net + '....\n'
-  const client = new xrpl.Client(net)
-  await client.connect()
-      
-  results  += "Connected. Getting wallets.\n"
-  standbyResultField.value = results
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  results += standbyNameField.value + " account address: " + standby_wallet.address + "\n"
-  standbyResultField.value = results
-
-
-  if (standbyTakerGetsCurrencyField.value == 'XRP') {
-    takerGets = standbyTakerGetsValueField.value
-  } else {
-    takerGetsString = '{"currency": "' + standbyTakerGetsCurrencyField.value +'",\n' +
-        '"issuer": "' + standbyTakerGetsIssuerField.value + '",\n' +
-        '"value": "' + standbyTakerGetsValueField.value + '"}'
-    takerGets = JSON.parse(takerGetsString)
-  }
-
-  if (standbyTakerPaysCurrencyField.value == 'XRP') {
-    takerPays = standbyTakerPaysValueField.value
-  } else {
-    takerPaysString = '{"currency": "' + standbyTakerPaysCurrencyField.value + '",\n' +
-      '"issuer": "' + standbyTakerPaysIssuerField.value + '",\n' +
-      '"value": "' + standbyTakerPaysValueField.value + '"}'
-    takerPays = JSON.parse(takerPaysString)
-  }
- 
-   // -------------------------------------------------------- Prepare transaction
-  const prepared = await client.autofill({
-    "TransactionType": "OfferCreate",
-    "Account": standby_wallet.address,
-    "TakerGets": takerGets,
-      "TakerPays": takerPays
-  })   
-  // ------------------------------------------------- Sign prepared instructions
-  const signed = standby_wallet.sign(prepared)
- results += "\nSubmitting transaction...."
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-  results  += "\nBalance changes: " + 
-  JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  standbyResultField.value = results
-
-  standbyBalanceField.value =  (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  getOffers()                 
-  client.disconnect()    
-} // End of createOffer()
-
-/***********************************
- ************ Get Offers ***********
- **********************************/
-
-async function getOffers() {
-  let net = getNet()
-  let results = 'Connecting to ' + net + '....\n'
-  const client = new xrpl.Client(net)
-  await client.connect()
-  results  += "Connected.\n"
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  results += standbyNameField.value + " account: " + standby_wallet.address
-// -------------------------------------------------------- Prepare request
-
-  results += '\n\n*** Offers ***\n'
-  let offers
-  try {
-    const offers = await client.request({
-      method: "account_offers",
-      account: standby_wallet.address,
-      ledger_index: "validated"
-    })
-    results += JSON.stringify(offers,null,2)
-  } catch (err) {
-      results += err
-  }
-  standbyResultField.value = results
-  client.disconnect()
-}// End of getOffers()
-
-/***********************************
-*********** Cancel Offer **********
-**********************************/
-
-  async function cancelOffer() {
-    let results  = "Connecting to the selected ledger.\n"
-    standbyResultField.value = results
-    let net = getNet()
-    results += 'Connecting to ' + net + '....\n'
-    const client = new xrpl.Client(net)
-    await client.connect()
-        
-    results  += "Connected.\n"
-    standbyResultField.value = results
-    const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-    const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-    results += "standby_wallet.address: = " + standby_wallet.address
-    standbyResultField.value = results
-
-  // -------------------------------------------------------- Prepare transaction
-    /* OfferSequence is the Seq value when you getOffers. */
-
-  const prepared = await client.autofill({
-  "TransactionType": "OfferCancel",
-  "Account": standby_wallet.address,
-  "OfferSequence": parseInt(standbyOfferSequenceField.value)
-  })
-
-  // ------------------------------------------------- Sign prepared instructions
-  const signed = standby_wallet.sign(prepared)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-      
-  results  += "\nBalance changes: \n" + 
-    JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  standbyResultField.value = results
-  standbyBalanceField.value =  (await client.getXrpBalance(standby_wallet.address))
-  client.disconnect()    
-  } // End of cancelOffer()
-
-  /*********************************************
-  ************* Reciprocal Functions **********
-  ********************************************/
-
-  /***********************************
-   ********* OP Create Offer *********
-    **********************************/
-
-    async function oPcreateOffer() {
-    let takerGets = ''
-    let takerPays = ''
-
-      operationalResultField.value = ''
-      let net = getNet()
-      let results = 'Connecting to ' + net + '....\n'
-      const client = new xrpl.Client(net)
-      await client.connect()
-          
-      results  += "Connected. Getting wallets.\n"
-      operationalResultField.value = results
-      const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-      const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-      results += operationalNameField.value + " account address: " + operational_wallet.address + "\n"
-      operationalResultField.value = results
-
-
-    if (operationalTakerGetsCurrencyField.value == 'XRP') {
-      takerGets = operationalTakerGetsValueField.value
-    } else {
-      takerGetsString = '{"currency": "' + operationalTakerGetsCurrencyField.value +'",\n' +
-          '"issuer": "' + operationalTakerGetsIssuerField.value + '",\n' +
-          '"value": "' + operationalTakerGetsValueField.value + '"}'
-      takerGets = JSON.parse(takerGetsString)
-    }
-
-    if (operationalTakerPaysCurrencyField.value == 'XRP') {
-      takerPays = operationalTakerPaysValueField.value
-    } else {
-      takerPaysString = '{"currency": "' + operationalTakerPaysCurrencyField.value + '",\n' +
-        '"issuer": "' + operationalTakerPaysIssuerField.value + '",\n' +
-        '"value": "' + operationalTakerPaysValueField.value + '"}'
-      takerPays = JSON.parse(takerPaysString)
-    }
-    
-      // -------------------------------------------------------- Prepare transaction
-    const prepared = await client.autofill({
-      "TransactionType": "OfferCreate",
-      "Account": operational_wallet.address,
-      "TakerGets": takerGets,
-      "TakerPays": takerPays
-    })   
-    // ------------------------------------------------- Sign prepared instructions
-    const signed = operational_wallet.sign(prepared)
-    results += "\nSubmitting transaction...."
-    // -------------------------------------------------------- Submit signed blob
-    const tx = await client.submitAndWait(signed.tx_blob)
-    
-    results  += "\nBalance changes: " + 
-    JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-    operationalResultField.value = results
-
-    standbyBalanceField.value =  (await client.getXrpBalance(standby_wallet.address))
-    operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-    getOffers()                 
-    client.disconnect()    
-  } // End of oPcreateOffer()
-
-  /***********************************
-  ********** OP Get Offers ***********
-  ***********************************/
-
-async function oPgetOffers() {
-  let results  = "Connecting to the selected ledger.\n"
-  operationalResultField.value = results
-  let net = getNet()
-  results = 'Connecting to ' + net + '....\n'
-  const client = new xrpl.Client(net)
-  await client.connect()
-      
-  results  += "Connected.\n"
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  results += operationalNameField.value + " account: " + operational_wallet.address
-  operationalResultField.value = results   
-
-  // -------------------------------------------------------- Prepare request
-
-  results += '\n\n*** Offers ***\n'
-  let offers
-  try {
-    const offers = await client.request({
-      method: "account_offers",
-      account: operational_wallet.address,
-      ledger_index: "validated"
-    })
-    results += JSON.stringify(offers,null,2)
-  } catch (err) {
-      results += err
-  }
-  operationalResultField.value = results
-  client.disconnect()
-}// End of oPgetOffers()
-
-/************************************
- ********** Op Cancel Offer *********
- ***********************************/
-
-async function oPcancelOffer() {
-    let net = getNet()
-    let results = 'Connecting to ' + net + '....\n'
-    const client = new xrpl.Client(net)
-    await client.connect()
-        
-    results  += "Connected.\n"
-    const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-    results += "wallet.address: = " + operational_wallet.address
-    operationalResultField.value = results
-  
-  // -------------------------------------------------------- Prepare transaction
-  
-  /* OfferSequence is the Seq value when you getOffers. */
-  const prepared = await client.autofill({
-  "TransactionType": "OfferCancel",
-  "Account": operational_wallet.address,
-  "OfferSequence": parseInt(operationalOfferSequenceField.value)
-})
-  
-// ------------------------------------------------- Sign prepared instructions
-  const signed = operational_wallet.sign(prepared)
-  
-// -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-      
-  results  += "\nBalance changes: \n" + tx.result + "\n" +
-    JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  operationalResultField.value = results
-
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))                 
-  client.disconnect()    
-} // End of oPcancelOffer()

_code-samples/quickstart/js/ripplex8-escrow.js

@@ -1,240 +0,0 @@
-// *******************************************************
-// ************* Add Seconds to Current Date *************
-// *******************************************************
-
-function addSeconds(numOfSeconds, date = new Date()) {
-  date.setSeconds(date.getSeconds() + numOfSeconds);
-  date = Math.floor(date / 1000)
-  date = date - 946684800
-
-  return date;
-}
-
-// *******************************************************
-// ***************** Create Time Escrow ******************
-// *******************************************************
-
-async function createTimeEscrow() {
-
-  //-------------------------------------------- Prepare Finish and Cancel Dates
-
-  let escrow_finish_date = new Date()
-  let escrow_cancel_date = new Date()
-  escrow_finish_date = addSeconds(parseInt(standbyEscrowFinishDateField.value))
-  escrow_cancel_date = addSeconds(parseInt(standbyEscrowCancelDateField.value))
-
-  //------------------------------------------------------Connect to the Ledger
-  results  = "Connecting to the selected ledger.\n"
-  standbyResultField.value = results
-  let net = getNet()
-  results = "Connecting to " + net + "....\n"
-  const client = new xrpl.Client(net)
-  await client.connect()
-
-  results  += "Connected. Creating time-based escrow.\n"
-  standbyResultField.value = results
-
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  const sendAmount = standbyAmountField.value
-  
-  results += "\nstandby_wallet.address: = " + standby_wallet.address
-  standbyResultField.value = results
-
-  // ------------------------------------------------------- Prepare transaction
-
-  const escrowTx = await client.autofill({
-    "TransactionType": "EscrowCreate",
-    "Account": standby_wallet.address,
-    "Amount": xrpl.xrpToDrops(sendAmount),
-    "Destination": standbyDestinationField.value,
-    "FinishAfter": escrow_finish_date,
-    "CancelAfter": escrow_cancel_date
-  })
-
-  // ------------------------------------------------ Sign prepared instructions
-  const signed = standby_wallet.sign(escrowTx)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-  results += "\nSequence Number (Save!): " + JSON.stringify(tx.result.Sequence)
-  results  += "\n\nBalance changes: " + 
-  JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  standbyResultField.value = results
-
-  // ----------------------------------------------Disconnect from the XRP Ledger
-  client.disconnect()
-
-} // End of createTimeEscrow()
-
-// *******************************************************
-// ***************** Finish Time Escrow ******************
-// *******************************************************
-
-async function finishEscrow() {
-
-  results  = "Connecting to the selected ledger.\n"
-  operationalResultField.value = results
-  let net = getNet()
-  results = 'Connecting to ' + getNet() + '....'
-  const client = new xrpl.Client(net)
-  await client.connect()
-
-  results  += "\nConnected. Finishing escrow.\n"
-  operationalResultField.value = results
-
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const sendAmount = operationalAmountField.value
-  
-  results += "\noperational_wallet.address: = " + operational_wallet.address
-  operationalResultField.value = results
-
-  // ------------------------------------------------------- Prepare transaction
-  // Note that the destination is hard coded.
-  const prepared = await client.autofill({
-    "TransactionType": "EscrowFinish",
-    "Account": operationalAccountField.value,
-    "Owner": standbyAccountField.value,
-    "OfferSequence": parseInt(operationalEscrowSequenceField.value)
-  })
-
-  // ------------------------------------------------ Sign prepared instructions
-  const signed = operational_wallet.sign(prepared)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-  results  += "\nBalance changes: " + 
-    JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  operationalResultField.value = results
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-
-  client.disconnect()
-} // End of finishEscrow()
-
-// *******************************************************
-// ************** Get Standby Escrows ********************
-// *******************************************************
-
-async function getStandbyEscrows() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  
-  await client.connect()   
-  results += '\nConnected.'
-  standbyResultField.value = results
-
-  results= "\nGetting standby account escrows...\n"
-  const escrow_objects = await client.request({
-    "id": 5,
-    "command": "account_objects",
-    "account": standbyAccountField.value,
-    "ledger_index": "validated",
-    "type": "escrow"
-  })
-  results += JSON.stringify(escrow_objects.result, null, 2)
-  standbyResultField.value = results
-
-  client.disconnect()
-} // End of getStandbyEscrows()
-
-// *******************************************************
-// ***************** Get Op Escrows **********************
-// *******************************************************
-
-async function getOperationalEscrows() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  
-  await client.connect()   
-  results += '\nConnected.'
-  operationalResultField.value = results
-
-  results= "\nGetting operational account escrows...\n"
-  const escrow_objects = await client.request({
-    "id": 5,
-    "command": "account_objects",
-    "account": operationalAccountField.value,
-    "ledger_index": "validated",
-    "type": "escrow"
-  })
-  results += JSON.stringify(escrow_objects.result, null, 2)
-  operationalResultField.value = results
-  client.disconnect()
- 
-} // End of getOperationalEscrows()
-
-// *******************************************************
-// ************** Get Transaction Info *******************
-// *******************************************************
-
-async function getTransaction() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  operationalResultField.value = results
-  
-  await client.connect()   
-  results += '\nConnected.'
-  operationalResultField.value = results
-
-  results= "\nGetting transaction information...\n"
-  const tx_info = await client.request({
-    "id": 1,
-    "command": "tx",
-    "transaction": operationalTransactionField.value,
-  })
-  results += JSON.stringify(tx_info.result, null, 2)
-  operationalResultField.value = results
-  client.disconnect()
- 
-} // End of getTransaction()
-
-// *******************************************************
-// ****************** Cancel Escrow **********************
-// *******************************************************
-
-async function cancelEscrow() {
-  let net = getNet()
-  const client = new xrpl.Client(net)
-  results = 'Connecting to ' + getNet() + '....'
-  standbyResultField.value = results
-  
-  await client.connect()   
-  results += '\nConnected.'
-  standbyResultField.value = results
-
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-
-  // ------------------------------------------------------- Prepare transaction
-
-  const prepared = await client.autofill({
-    "TransactionType": "EscrowCancel",
-    "Account": standby_wallet.address,
-    "Owner": standbyAccountField.value,
-    "OfferSequence": parseInt(standbyEscrowSequenceNumberField.value)
-  })
-
-  // ------------------------------------------------ Sign prepared instructions
-  const signed = standby_wallet.sign(prepared)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-
-   results  += "\nBalance changes: " + 
-      JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-   standbyResultField.value = results
-   
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-
-  client.disconnect()
-}

_code-samples/quickstart/js/ripplex9-escrow-condition.js

@@ -1,101 +0,0 @@
-// *******************************************************
-// ************* Create Conditional Escrow ***************
-// *******************************************************
-
-async function createConditionalEscrow() {
-
-  //------------------------------------------------------Connect to the Ledger
-  results  = "Connecting to the selected ledger.\n"
-  standbyResultField.value = results
-  let net = getNet()
-  results = "Connecting to " + net + "....\n"
-  const client = new xrpl.Client(net)
-  await client.connect()
-
-  results  += "Connected. Creating conditional escrow.\n"
-  standbyResultField.value = results
-
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  const sendAmount = standbyAmountField.value
-  
-  results += "\nstandby_wallet.address: = " + standby_wallet.address
-  standbyResultField.value = results
-  
-  let escrow_cancel_date = new Date()
-  escrow_cancel_date = addSeconds(parseInt(standbyEscrowCancelDateField.value))
-
-  // ------------------------------------------------------- Prepare transaction
-
-  const escrowTx = await client.autofill({
-    "TransactionType": "EscrowCreate",
-    "Account": standby_wallet.address,
-    "Amount": xrpl.xrpToDrops(sendAmount),
-    "Destination": standbyDestinationField.value,
-    "CancelAfter": escrow_cancel_date,
-    "Condition": standbyEscrowConditionField.value
-  })
-
-  // ------------------------------------------------ Sign prepared instructions
-  const signed = standby_wallet.sign(escrowTx)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-  results += "\nSequence Number (Save!): " + JSON.stringify(tx.result.Sequence)
-  results  += "\n\nBalance changes: " + 
-  JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-  standbyResultField.value = results
-
-  // ----------------------------------------------Disconnect from the XRP Ledger
-  client.disconnect()
-
-} // End of createTimeEscrow()
-
-// *******************************************************
-// ************** Finish Conditional Escrow **************
-// *******************************************************
-
-async function finishConditionalEscrow() {
-  results  = "Connecting to the selected ledger.\n"
-  operationalResultField.value = results
-  let net = getNet()
-  results += 'Connecting to ' + getNet() + '....'
-  const client = new xrpl.Client(net)
-  await client.connect()
-  results  += "\nConnected. Finishing escrow.\n"
-  operationalResultField.value = results
-
-  const operational_wallet = xrpl.Wallet.fromSeed(operationalSeedField.value)
-  const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-  const sendAmount = operationalAmountField.value
-  
-  results += "\noperational_wallet.address: = " + operational_wallet.address
-  operationalResultField.value = results
-
-  // ------------------------------------------------------- Prepare transaction
-
-  const prepared = await client.autofill({
-    "TransactionType": "EscrowFinish",
-    "Account": operationalAccountField.value,
-    "Owner": standbyAccountField.value,
-    "OfferSequence": parseInt(operationalEscrowSequenceField.value),
-    "Condition": standbyEscrowConditionField.value,
-    "Fulfillment": operationalFulfillmentField.value
-  })
-
-  // ------------------------------------------------ Sign prepared instructions
-  const signed = operational_wallet.sign(prepared)
-
-  // -------------------------------------------------------- Submit signed blob
-  const tx = await client.submitAndWait(signed.tx_blob)
-  results  += "\nBalance changes: " + 
-    JSON.stringify(xrpl.getBalanceChanges(tx.result.meta), null, 2)
-  operationalResultField.value = results
-  standbyBalanceField.value = (await client.getXrpBalance(standby_wallet.address))
-  operationalBalanceField.value = (await client.getXrpBalance(operational_wallet.address))
-
-  client.disconnect()
-
-} // End of finishEscrow()``

_code-samples/quickstart/py/conditions.py

@@ -1,11 +0,0 @@
-from os import urandom
-from cryptoconditions import PreimageSha256
-
-secret = urandom(32)
-
-fulfillment = PreimageSha256(preimage=secret)
-
-print("Condition", fulfillment.condition_binary.hex().upper())
-
-# Keep secret until you want to finish the escrow
-print("Fulfillment", fulfillment.serialize_binary().hex().upper())

_code-samples/quickstart/py/lesson10-check.py

@@ -1,318 +0,0 @@
-import tkinter as tk
-import xrpl
-import json
-
-from mod1 import get_account, get_account_info, send_xrp
-from mod2 import get_balance
-from mod10 import send_check, cash_check, cancel_check, get_checks
-
-#############################################
-## Handlers #################################
-#############################################
-
-## Mod 10 Handlers
-
-def standby_send_check():
-    results=send_check(
-        ent_standby_seed.get(),
-        ent_standby_amount.get(),
-        ent_standby_destination.get(),
-        ent_standby_currency.get(),
-        ent_standby_issuer.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_cash_check():
-    results=cash_check(
-        ent_standby_seed.get(),
-        ent_standby_amount.get(),
-        ent_standby_check_id.get(),
-        ent_standby_currency.get(),
-        ent_standby_issuer.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_cancel_check():
-    results=cancel_check(
-        ent_standby_seed.get(),
-        ent_standby_check_id.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_get_checks():
-    results=get_checks(
-        ent_standby_account.get(),
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_get_balance():
-    results=get_balance(
-        ent_standby_seed.get(),
-        ent_operational_seed.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_send_check():
-    results=send_check(
-        ent_operational_seed.get(),
-        ent_operational_amount.get(),
-        ent_operational_destination.get(),
-        ent_operational_currency.get(),
-        ent_operational_issuer.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_cash_check():
-    results=cash_check(
-        ent_operational_seed.get(),
-        ent_operational_amount.get(),
-        ent_operational_check_id.get(),
-        ent_operational_currency.get(),
-        ent_operational_issuer.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_cancel_check():
-    results=cancel_check(
-        ent_operational_seed.get(),
-        ent_operational_check_id.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_get_checks():
-    results=get_checks(
-        ent_operational_account.get(),
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_get_balance():
-    results=get_balance(
-        ent_operational_seed.get(),
-        ent_standby_seed.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-
-## Mod 8 Handlers
-    
-def operational_get_transaction():
-    results=get_transaction(ent_operational_account.get(),
-                              ent_operational_look_up.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))    
-
-## Mod 1 Handlers
-
-def get_standby_account():
-    new_wallet=get_account(ent_standby_seed.get())
-    ent_standby_account.delete(0, tk.END)
-    ent_standby_seed.delete(0, tk.END)
-    ent_standby_account.insert(0, new_wallet.classic_address)
-    ent_standby_seed.insert(0, new_wallet.seed)
-
-
-def get_standby_account_info():
-    accountInfo=get_account_info(ent_standby_account.get())
-    ent_standby_balance.delete(0, tk.END)
-    ent_standby_balance.insert(0,accountInfo['Balance'])
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def standby_send_xrp():
-    response=send_xrp(ent_standby_seed.get(),ent_standby_amount.get(),
-                       ent_standby_destination.get())
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(response.result, indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-def get_operational_account():
-    new_wallet=get_account(ent_operational_seed.get())
-    ent_operational_account.delete(0, tk.END)
-    ent_operational_account.insert(0, new_wallet.classic_address)
-    ent_operational_seed.delete(0, tk.END)
-    ent_operational_seed.insert(0, new_wallet.seed)
-
-
-def get_operational_account_info():
-    accountInfo=get_account_info(ent_operational_account.get())
-    ent_operational_balance.delete(0, tk.END)
-    ent_operational_balance.insert(0,accountInfo['Balance'])
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def operational_send_xrp():
-    response=send_xrp(ent_operational_seed.get(),ent_operational_amount.get(),
-                        ent_operational_destination.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(response.result,indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-# Create a new window with the title "Conditional Escrow Example"
-window=tk.Tk()
-window.title("Check Example")
-
-# Form frame
-frm_form=tk.Frame(relief=tk.SUNKEN, borderwidth=3)
-frm_form.pack()
-
-# Create the Label and Entry widgets for "Standby Account"
-lbl_standy_seed=tk.Label(master=frm_form, text="Standby Seed")
-ent_standby_seed=tk.Entry(master=frm_form, width=50)
-lbl_standby_account=tk.Label(master=frm_form, text="Standby Account")
-ent_standby_account=tk.Entry(master=frm_form, width=50)
-lbl_standby_balance=tk.Label(master=frm_form, text="XRP Balance")
-ent_standby_balance=tk.Entry(master=frm_form, width=50)
-lbl_standy_amount=tk.Label(master=frm_form, text="Amount")
-ent_standby_amount=tk.Entry(master=frm_form, width=50)
-lbl_standby_destination=tk.Label(master=frm_form, text="Destination")
-ent_standby_destination=tk.Entry(master=frm_form, width=50)
-lbl_standby_issuer=tk.Label(master=frm_form, text="Issuer")
-ent_standby_issuer=tk.Entry(master=frm_form, width=50)
-lbl_standby_check_id=tk.Label(master=frm_form, text="Check ID")
-ent_standby_check_id=tk.Entry(master=frm_form, width=50)
-lbl_standby_currency=tk.Label(master=frm_form, text="Currency")
-ent_standby_currency=tk.Entry(master=frm_form, width=50)
-lbl_standby_results=tk.Label(master=frm_form, text="Results")
-text_standby_results=tk.Text(master=frm_form, height=20, width=65)
-
-# Place fields in a grid.
-lbl_standy_seed.grid(row=0, column=0, sticky="e")
-ent_standby_seed.grid(row=0, column=1)
-lbl_standby_account.grid(row=2, column=0, sticky="e")
-ent_standby_account.grid(row=2, column=1)
-lbl_standby_balance.grid(row=3, column=0, sticky="e")
-ent_standby_balance.grid(row=3, column=1)
-lbl_standy_amount.grid(row=4, column=0, sticky="e")
-ent_standby_amount.grid(row=4, column=1)
-lbl_standby_destination.grid(row=5, column=0, sticky="e")
-ent_standby_destination.grid(row=5, column=1)
-lbl_standby_issuer.grid(row=6, column=0, sticky="e")
-ent_standby_issuer.grid(row=6, column=1)
-lbl_standby_check_id.grid(row=7, column=0, sticky="e")
-ent_standby_check_id.grid(row=7, column=1)
-lbl_standby_currency.grid(row=8, column=0, sticky="e")
-ent_standby_currency.grid(row=8, column=1)
-lbl_standby_results.grid(row=9, column=0, sticky="ne")
-text_standby_results.grid(row=9, column=1, sticky="nw")
-
-###############################################
-## Operational Account ########################
-###############################################
-
-# Create the Label and Entry widgets for "Operational Account"
-
-lbl_operational_seed=tk.Label(master=frm_form, text="Operational Seed")
-ent_operational_seed=tk.Entry(master=frm_form, width=50)
-lbl_operational_account=tk.Label(master=frm_form, text="Operational Account")
-ent_operational_account=tk.Entry(master=frm_form, width=50)
-lbl_operational_balance=tk.Label(master=frm_form, text="XRP Balance")
-ent_operational_balance=tk.Entry(master=frm_form, width=50)
-lbl_operational_amount=tk.Label(master=frm_form, text="Amount")
-ent_operational_amount=tk.Entry(master=frm_form, width=50)
-lbl_operational_destination=tk.Label(master=frm_form, text="Destination")
-ent_operational_destination=tk.Entry(master=frm_form, width=50)
-lbl_operational_issuer=tk.Label(master=frm_form, text="Issuer")
-ent_operational_issuer=tk.Entry(master=frm_form, width=50)
-lbl_operational_check_id=tk.Label(master=frm_form, text="Check ID")
-ent_operational_check_id=tk.Entry(master=frm_form, width=50)
-lbl_operational_currency=tk.Label(master=frm_form, text="Currency")
-ent_operational_currency=tk.Entry(master=frm_form, width=50)
-lbl_operational_results=tk.Label(master=frm_form,text='Results')
-text_operational_results=tk.Text(master=frm_form, height=20, width=65)
-
-#Place the widgets in a grid
-lbl_operational_seed.grid(row=0, column=4, sticky="e")
-ent_operational_seed.grid(row=0, column=5, sticky="w")
-lbl_operational_account.grid(row=2,column=4, sticky="e")
-ent_operational_account.grid(row=2,column=5, sticky="w")
-lbl_operational_balance.grid(row=3, column=4, sticky="e")
-ent_operational_balance.grid(row=3, column=5, sticky="w")
-lbl_operational_amount.grid(row=4, column=4, sticky="e")
-ent_operational_amount.grid(row=4, column=5, sticky="w")
-lbl_operational_destination.grid(row=5, column=4, sticky="e")
-ent_operational_destination.grid(row=5, column=5, sticky="w")
-lbl_operational_issuer.grid(row=6, column=4, sticky="e")
-ent_operational_issuer.grid(row=6, column=5, sticky="w")
-lbl_operational_check_id.grid(row=7, column=4, sticky="e")
-ent_operational_check_id.grid(row=7, column=5, sticky="w")
-lbl_operational_currency.grid(row=8, column=4, sticky="e")
-ent_operational_currency.grid(row=8, column=5)
-lbl_operational_results.grid(row=9, column=4, sticky="ne")
-text_operational_results.grid(row=9, column=5, sticky="nw")
-
-#############################################
-## Buttons ##################################
-#############################################
-
-# Create the Get Standby Account Buttons
-btn_get_standby_account=tk.Button(master=frm_form, text="Get Standby Account",
-                                    command=get_standby_account)
-btn_get_standby_account.grid(row=0, column=2, sticky="nsew")
-btn_get_standby_account_info=tk.Button(master=frm_form,
-                                         text="Get Standby Account Info",
-                                         command=get_standby_account_info)
-btn_get_standby_account_info.grid(row=1, column=2, sticky="nsew")
-btn_standby_send_xrp=tk.Button(master=frm_form, text="Send XRP >",
-                                 command=standby_send_xrp)
-btn_standby_send_xrp.grid(row=2, column=2, sticky="nsew")
-btn_standby_send_check=tk.Button(master=frm_form, text="Send  Check",
-                                 command=standby_send_check)
-btn_standby_send_check.grid(row=4, column=2, sticky="nsew")
-btn_standby_get_checks=tk.Button(master=frm_form, text="Get Checks",
-                                 command=standby_get_checks)
-btn_standby_get_checks.grid(row=5, column=2, sticky="nsew")
-btn_standby_cash_check=tk.Button(master=frm_form, text="Cash  Check",
-                                 command=standby_cash_check)
-btn_standby_cash_check.grid(row=6, column=2, sticky="nsew")
-btn_standby_cancel_check=tk.Button(master=frm_form, text="Cancel  Check",
-                                 command=standby_cancel_check)
-btn_standby_cancel_check.grid(row=7, column=2, sticky="nsew")
-btn_standby_get_balances=tk.Button(master=frm_form, text="Get Balances",
-                            command=standby_get_balance)
-btn_standby_get_balances.grid(row=8, column=2, sticky="nsew")
-
-# Create the Operational Account Buttons
-btn_get_operational_account=tk.Button(master=frm_form,
-                                        text="Get Operational Account",
-                                        command=get_operational_account)
-btn_get_operational_account.grid(row=0, column=3, sticky="nsew")
-btn_get_op_account_info=tk.Button(master=frm_form, text="Get Op Account Info",
-                                    command=get_operational_account_info)
-btn_get_op_account_info.grid(row=1, column=3, sticky="nsew")
-btn_op_send_xrp=tk.Button(master=frm_form, text="< Send XRP",
-                            command=operational_send_xrp)
-btn_op_send_xrp.grid(row=2, column=3, sticky="nsew")
-btn_op_send_check=tk.Button(master=frm_form, text="Send Check",
-                            command=operational_send_check)
-btn_op_send_check.grid(row=4, column=3, sticky="nsew")
-btn_op_get_checks=tk.Button(master=frm_form, text="Get Checks",
-                            command=operational_get_checks)
-btn_op_get_checks.grid(row=5, column=3, sticky="nsew")
-btn_op_cash_check=tk.Button(master=frm_form, text="Cash Check",
-                            command=operational_cash_check)
-btn_op_cash_check.grid(row=6, column=3, sticky="nsew")
-btn_op_cancel_check=tk.Button(master=frm_form, text="Cancel Check",
-                            command=operational_cancel_check)
-btn_op_cancel_check.grid(row=7, column=3, sticky="nsew")
-btn_op_get_balances=tk.Button(master=frm_form, text="Get Balances",
-                            command=operational_get_balance)
-btn_op_get_balances.grid(row=8, column=3, sticky="nsew")
-
-# Start the application
-window.mainloop()

_code-samples/quickstart/py/lesson8-time-escrow.py

@@ -1,251 +0,0 @@
-import tkinter as tk
-import xrpl
-import json
-
-from mod1 import get_account, get_account_info, send_xrp
-from mod8 import create_time_escrow, finish_time_escrow, get_escrows, cancel_time_escrow, get_transaction
-
-
-#############################################
-## Handlers #################################
-#############################################
-
-## Mod 8 Handlers
-
-def standby_create_time_escrow():
-    results = create_time_escrow(
-        ent_standby_seed.get(),
-        ent_standby_amount.get(),
-        ent_standby_destination.get(),
-        ent_standby_escrow_finish.get(),
-        ent_standby_escrow_cancel.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_finish_time_escrow():
-    results = finish_time_escrow(
-        ent_operational_seed.get(),
-        ent_operational_escrow_owner.get(),
-        ent_operational_sequence_number.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_get_escrows():
-    results = get_escrows(ent_operational_account.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_cancel_time_escrow():
-    results = cancel_time_escrow(
-        ent_standby_seed.get(),
-        ent_standby_escrow_owner.get(),
-        ent_standby_escrow_sequence_number.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-    
-def operational_get_transaction():
-    results = get_transaction(ent_operational_account.get(),
-                              ent_operational_look_up.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))    
-
-## Mod 1 Handlers
-
-def get_standby_account():
-    new_wallet = get_account(ent_standby_seed.get())
-    ent_standby_account.delete(0, tk.END)
-    ent_standby_seed.delete(0, tk.END)
-    ent_standby_account.insert(0, new_wallet.classic_address)
-    ent_standby_seed.insert(0, new_wallet.seed)
-
-
-def get_standby_account_info():
-    accountInfo = get_account_info(ent_standby_account.get())
-    ent_standby_balance.delete(0, tk.END)
-    ent_standby_balance.insert(0,accountInfo['Balance'])
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def standby_send_xrp():
-    response = send_xrp(ent_standby_seed.get(),ent_standby_amount.get(),
-                       ent_standby_destination.get())
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(response.result, indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-def get_operational_account():
-    new_wallet = get_account(ent_operational_seed.get())
-    ent_operational_account.delete(0, tk.END)
-    ent_operational_account.insert(0, new_wallet.classic_address)
-    ent_operational_seed.delete(0, tk.END)
-    ent_operational_seed.insert(0, new_wallet.seed)
-
-
-def get_operational_account_info():
-    accountInfo = get_account_info(ent_operational_account.get())
-    ent_operational_balance.delete(0, tk.END)
-    ent_operational_balance.insert(0,accountInfo['Balance'])
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def operational_send_xrp():
-    response = send_xrp(ent_operational_seed.get(),ent_operational_amount.get(),
-                        ent_operational_destination.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(response.result,indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-# Create a new window with the title "Time-based Escrow Example"
-window = tk.Tk()
-window.title("Time-based Escrow Example")
-
-# Form frame
-frm_form = tk.Frame(relief=tk.SUNKEN, borderwidth=3)
-frm_form.pack()
-
-# Create the Label and Entry widgets for "Standby Account"
-lbl_standy_seed = tk.Label(master=frm_form, text="Standby Seed")
-ent_standby_seed = tk.Entry(master=frm_form, width=50)
-lbl_standby_account = tk.Label(master=frm_form, text="Standby Account")
-ent_standby_account = tk.Entry(master=frm_form, width=50)
-lbl_standy_amount = tk.Label(master=frm_form, text="Amount")
-ent_standby_amount = tk.Entry(master=frm_form, width=50)
-lbl_standby_destination = tk.Label(master=frm_form, text="Destination")
-ent_standby_destination = tk.Entry(master=frm_form, width=50)
-lbl_standby_balance = tk.Label(master=frm_form, text="XRP Balance")
-ent_standby_balance = tk.Entry(master=frm_form, width=50)
-
-lbl_standby_escrow_finish = tk.Label(master=frm_form, text="Escrow Finish (seconds)")
-ent_standby_escrow_finish = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_cancel = tk.Label(master=frm_form, text="Escrow Cancel (seconds)")
-ent_standby_escrow_cancel = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_sequence_number = tk.Label(master=frm_form, text="Sequence Number")
-ent_standby_escrow_sequence_number = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_owner = tk.Label(master=frm_form, text="Escrow Owner")
-ent_standby_escrow_owner = tk.Entry(master=frm_form, width=50)                    
-lbl_standby_results = tk.Label(master=frm_form, text="Results")
-text_standby_results = tk.Text(master=frm_form, height = 20, width = 65)
-
-# Place fields in a grid.
-lbl_standy_seed.grid(row=0, column=0, sticky="e")
-ent_standby_seed.grid(row=0, column=1)
-lbl_standby_account.grid(row=2, column=0, sticky="e")
-ent_standby_account.grid(row=2, column=1)
-lbl_standy_amount.grid(row=3, column=0, sticky="e")
-ent_standby_amount.grid(row=3, column=1)
-lbl_standby_destination.grid(row=4, column=0, sticky="e")
-ent_standby_destination.grid(row=4, column=1)
-lbl_standby_balance.grid(row=5, column=0, sticky="e")
-ent_standby_balance.grid(row=5, column=1)
-lbl_standby_escrow_finish.grid(row=6, column=0, sticky="e")
-ent_standby_escrow_finish.grid(row=6, column=1)
-lbl_standby_escrow_cancel.grid(row=7, column=0, sticky="e")
-ent_standby_escrow_cancel.grid(row=7, column=1)
-lbl_standby_escrow_sequence_number.grid(row=8, column=0, sticky="e")
-ent_standby_escrow_sequence_number.grid(row=8, column=1)
-lbl_standby_escrow_owner.grid(row=9, column=0, sticky="e")
-ent_standby_escrow_owner.grid(row=9, column=1)
-lbl_standby_results.grid(row=10, column=0, sticky="ne")
-text_standby_results.grid(row=10, column=1, sticky="nw")
-
-###############################################
-## Operational Account ########################
-###############################################
-
-# Create the Label and Entry widgets for "Operational Account"
-lbl_operational_seed = tk.Label(master=frm_form, text="Operational Seed")
-ent_operational_seed = tk.Entry(master=frm_form, width=50)
-lbl_operational_account = tk.Label(master=frm_form, text="Operational Account")
-ent_operational_account = tk.Entry(master=frm_form, width=50)
-lbl_operational_amount = tk.Label(master=frm_form, text="Amount")
-ent_operational_amount = tk.Entry(master=frm_form, width=50)
-lbl_operational_destination = tk.Label(master=frm_form, text="Destination")
-ent_operational_destination = tk.Entry(master=frm_form, width=50)
-lbl_operational_balance = tk.Label(master=frm_form, text="XRP Balance")
-ent_operational_balance = tk.Entry(master=frm_form, width=50)
-lbl_operational_sequence_number = tk.Label(master=frm_form, text="Sequence Number")
-ent_operational_sequence_number = tk.Entry(master=frm_form, width=50)
-lbl_operational_escrow_owner=tk.Label(master=frm_form, text="Escrow Owner")
-ent_operational_escrow_owner=tk.Entry(master=frm_form, width=50)
-lbl_operational_look_up = tk.Label(master=frm_form, text="Transaction to Look Up")
-ent_operational_look_up = tk.Entry(master=frm_form, width=50)
-lbl_operational_results = tk.Label(master=frm_form,text='Results')
-text_operational_results = tk.Text(master=frm_form, height = 20, width = 65)
-
-
-#Place the widgets in a grid
-lbl_operational_seed.grid(row=0, column=4, sticky="e")
-ent_operational_seed.grid(row=0, column=5, sticky="w")
-lbl_operational_account.grid(row=2,column=4, sticky="e")
-ent_operational_account.grid(row=2,column=5, sticky="w")
-lbl_operational_amount.grid(row=3, column=4, sticky="e")
-ent_operational_amount.grid(row=3, column=5, sticky="w")
-lbl_operational_destination.grid(row=4, column=4, sticky="e")
-ent_operational_destination.grid(row=4, column=5, sticky="w")
-lbl_operational_balance.grid(row=5, column=4, sticky="e")
-ent_operational_balance.grid(row=5, column=5, sticky="w")
-lbl_operational_sequence_number.grid(row=6, column=4, sticky="e")
-ent_operational_sequence_number.grid(row=6, column=5, sticky="w")
-lbl_operational_escrow_owner.grid(row=7, column=4, sticky="e")
-ent_operational_escrow_owner.grid(row=7, column=5, sticky="w")
-lbl_operational_look_up.grid(row=8, column=4, sticky="e")
-ent_operational_look_up.grid(row=8, column=5, sticky="w")
-lbl_operational_results.grid(row=10, column=4, sticky="ne")
-text_operational_results.grid(row=10, column=5, sticky="nw")
-
-#############################################
-## Buttons ##################################
-#############################################
-
-# Create the Get Standby Account Buttons
-btn_get_standby_account = tk.Button(master=frm_form, text="Get Standby Account",
-                                    command = get_standby_account)
-btn_get_standby_account.grid(row = 0, column = 2, sticky = "nsew")
-btn_get_standby_account_info = tk.Button(master=frm_form,
-                                         text="Get Standby Account Info",
-                                         command = get_standby_account_info)
-btn_get_standby_account_info.grid(row = 1, column = 2, sticky = "nsew")
-btn_standby_send_xrp = tk.Button(master=frm_form, text="Send XRP >",
-                                 command = standby_send_xrp)
-btn_standby_send_xrp.grid(row = 2, column = 2, sticky = "nsew")
-
-btn_standby_create_escrow = tk.Button(master=frm_form, text="Create Time-based Escrow",
-                                 command = standby_create_time_escrow)
-btn_standby_create_escrow.grid(row = 4, column = 2, sticky="nsew")
-btn_standby_cancel_escrow = tk.Button(master=frm_form, text="Cancel Time-based Escrow",
-                                 command = standby_cancel_time_escrow)
-btn_standby_cancel_escrow.grid(row=5,column = 2, sticky="nsew")
-
-# Create the Operational Account Buttons
-btn_get_operational_account = tk.Button(master=frm_form,
-                                        text="Get Operational Account",
-                                        command = get_operational_account)
-btn_get_operational_account.grid(row=0, column=3, sticky = "nsew")
-btn_get_op_account_info = tk.Button(master=frm_form, text="Get Op Account Info",
-                                    command = get_operational_account_info)
-btn_get_op_account_info.grid(row=1, column=3, sticky = "nsew")
-btn_op_send_xrp = tk.Button(master=frm_form, text="< Send XRP",
-                            command = operational_send_xrp)
-btn_op_send_xrp.grid(row=2, column = 3, sticky = "nsew")
-btn_op_finish_escrow = tk.Button(master=frm_form, text="Finish Escrow",
-                            command = operational_finish_time_escrow)
-btn_op_finish_escrow.grid(row = 4, column = 3, sticky="nsew")
-btn_op_finish_escrow = tk.Button(master=frm_form, text="Get Escrows",
-                            command = operational_get_escrows)
-btn_op_finish_escrow.grid(row = 5, column = 3, sticky="nsew")
-btn_op_get_transaction = tk.Button(master=frm_form, text="Get Transaction",
-                            command = operational_get_transaction)
-btn_op_get_transaction.grid(row = 6, column = 3, sticky = "nsew")
-
-
-# Start the application
-window.mainloop()

_code-samples/quickstart/py/lesson9-conditional-escrow.py

@@ -1,269 +0,0 @@
-import tkinter as tk
-import xrpl
-import json
-
-from mod1 import get_account, get_account_info, send_xrp
-from mod8 import get_escrows, cancel_time_escrow, get_transaction
-from mod9 import create_conditional_escrow, finish_conditional_escrow, generate_condition
-
-
-#############################################
-## Handlers #################################
-#############################################
-
-## Mod 9 Handlers
-
-def get_condition():
-    results = generate_condition()
-    ent_standby_escrow_condition.delete(0, tk.END)
-    ent_standby_escrow_condition.insert(0, results[0])
-    ent_operational_escrow_fulfillment.delete(0, tk.END)
-    ent_operational_escrow_fulfillment.insert(0, results[1])
-
-def standby_create_conditional_escrow():
-    results = create_conditional_escrow(
-        ent_standby_seed.get(),
-        ent_standby_amount.get(),
-        ent_standby_destination.get(),
-        ent_standby_escrow_cancel.get(),
-        ent_standby_escrow_condition.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-
-def operational_finish_conditional_escrow():
-    results = finish_conditional_escrow(
-        ent_operational_seed.get(),
-        ent_operational_escrow_owner.get(),
-        ent_operational_sequence_number.get(),
-        ent_standby_escrow_condition.get(),
-        ent_operational_escrow_fulfillment.get()
-    )
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-
-## Mod 8 Handlers
-
-def operational_get_escrows():
-    results = get_escrows(ent_operational_account.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))
-
-def standby_cancel_time_escrow():
-    results = cancel_time_escrow(
-        ent_standby_seed.get(),
-        ent_standby_escrow_owner.get(),
-        ent_standby_escrow_sequence_number.get()
-    )
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0", json.dumps(results, indent=4))
-    
-def operational_get_transaction():
-    results = get_transaction(ent_operational_account.get(),
-                              ent_operational_look_up.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0", json.dumps(results, indent=4))    
-
-## Mod 1 Handlers
-
-def get_standby_account():
-    new_wallet = get_account(ent_standby_seed.get())
-    ent_standby_account.delete(0, tk.END)
-    ent_standby_seed.delete(0, tk.END)
-    ent_standby_account.insert(0, new_wallet.classic_address)
-    ent_standby_seed.insert(0, new_wallet.seed)
-
-
-def get_standby_account_info():
-    accountInfo = get_account_info(ent_standby_account.get())
-    ent_standby_balance.delete(0, tk.END)
-    ent_standby_balance.insert(0,accountInfo['Balance'])
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def standby_send_xrp():
-    response = send_xrp(ent_standby_seed.get(),ent_standby_amount.get(),
-                       ent_standby_destination.get())
-    text_standby_results.delete("1.0", tk.END)
-    text_standby_results.insert("1.0",json.dumps(response.result, indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-def get_operational_account():
-    new_wallet = get_account(ent_operational_seed.get())
-    ent_operational_account.delete(0, tk.END)
-    ent_operational_account.insert(0, new_wallet.classic_address)
-    ent_operational_seed.delete(0, tk.END)
-    ent_operational_seed.insert(0, new_wallet.seed)
-
-
-def get_operational_account_info():
-    accountInfo = get_account_info(ent_operational_account.get())
-    ent_operational_balance.delete(0, tk.END)
-    ent_operational_balance.insert(0,accountInfo['Balance'])
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(accountInfo, indent=4))
-
-
-def operational_send_xrp():
-    response = send_xrp(ent_operational_seed.get(),ent_operational_amount.get(),
-                        ent_operational_destination.get())
-    text_operational_results.delete("1.0", tk.END)
-    text_operational_results.insert("1.0",json.dumps(response.result,indent=4))
-    get_standby_account_info()
-    get_operational_account_info()
-
-
-# Create a new window with the title "Conditional Escrow Example"
-window = tk.Tk()
-window.title("Conditional Escrow Example")
-
-# Form frame
-frm_form = tk.Frame(relief=tk.SUNKEN, borderwidth=3)
-frm_form.pack()
-
-# Create the Label and Entry widgets for "Standby Account"
-lbl_standy_seed = tk.Label(master=frm_form, text="Standby Seed")
-ent_standby_seed = tk.Entry(master=frm_form, width=50)
-lbl_standby_account = tk.Label(master=frm_form, text="Standby Account")
-ent_standby_account = tk.Entry(master=frm_form, width=50)
-lbl_standy_amount = tk.Label(master=frm_form, text="Amount")
-ent_standby_amount = tk.Entry(master=frm_form, width=50)
-lbl_standby_destination = tk.Label(master=frm_form, text="Destination")
-ent_standby_destination = tk.Entry(master=frm_form, width=50)
-lbl_standby_balance = tk.Label(master=frm_form, text="XRP Balance")
-ent_standby_balance = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_condition = tk.Label(master=frm_form, text="Escrow Condition")
-ent_standby_escrow_condition = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_cancel = tk.Label(master=frm_form, text="Escrow Cancel (seconds)")
-ent_standby_escrow_cancel = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_sequence_number = tk.Label(master=frm_form, text="Sequence Number")
-ent_standby_escrow_sequence_number = tk.Entry(master=frm_form, width=50)
-lbl_standby_escrow_owner = tk.Label(master=frm_form, text="Escrow Owner")
-ent_standby_escrow_owner = tk.Entry(master=frm_form, width=50)                    
-lbl_standby_results = tk.Label(master=frm_form, text="Results")
-text_standby_results = tk.Text(master=frm_form, height = 20, width = 65)
-
-# Place fields in a grid.
-lbl_standy_seed.grid(row=0, column=0, sticky="e")
-ent_standby_seed.grid(row=0, column=1)
-lbl_standby_account.grid(row=2, column=0, sticky="e")
-ent_standby_account.grid(row=2, column=1)
-lbl_standy_amount.grid(row=3, column=0, sticky="e")
-ent_standby_amount.grid(row=3, column=1)
-lbl_standby_destination.grid(row=4, column=0, sticky="e")
-ent_standby_destination.grid(row=4, column=1)
-lbl_standby_balance.grid(row=5, column=0, sticky="e")
-ent_standby_balance.grid(row=5, column=1)
-lbl_standby_escrow_condition.grid(row=6, column=0, sticky="e")
-ent_standby_escrow_condition.grid(row=6, column=1)
-lbl_standby_escrow_cancel.grid(row=7, column=0, sticky="e")
-ent_standby_escrow_cancel.grid(row=7, column=1)
-lbl_standby_escrow_sequence_number.grid(row=8, column=0, sticky="e")
-ent_standby_escrow_sequence_number.grid(row=8, column=1)
-lbl_standby_escrow_owner.grid(row=9, column=0, sticky="e")
-ent_standby_escrow_owner.grid(row=9, column=1)
-lbl_standby_results.grid(row=10, column=0, sticky="ne")
-text_standby_results.grid(row=10, column=1, sticky="nw")
-
-###############################################
-## Operational Account ########################
-###############################################
-
-# Create the Label and Entry widgets for "Operational Account"
-lbl_operational_seed = tk.Label(master=frm_form, text="Operational Seed")
-ent_operational_seed = tk.Entry(master=frm_form, width=50)
-lbl_operational_account = tk.Label(master=frm_form, text="Operational Account")
-ent_operational_account = tk.Entry(master=frm_form, width=50)
-lbl_operational_amount = tk.Label(master=frm_form, text="Amount")
-ent_operational_amount = tk.Entry(master=frm_form, width=50)
-lbl_operational_destination = tk.Label(master=frm_form, text="Destination")
-ent_operational_destination = tk.Entry(master=frm_form, width=50)
-lbl_operational_balance = tk.Label(master=frm_form, text="XRP Balance")
-ent_operational_balance = tk.Entry(master=frm_form, width=50)
-lbl_operational_escrow_fulfillment = tk.Label(master=frm_form, text="Escrow Fulfillment")
-ent_operational_escrow_fulfillment = tk.Entry(master=frm_form, width=50)
-lbl_operational_sequence_number = tk.Label(master=frm_form, text="Sequence Number")
-ent_operational_sequence_number = tk.Entry(master=frm_form, width=50)
-lbl_operational_escrow_owner=tk.Label(master=frm_form, text="Escrow Owner")
-ent_operational_escrow_owner=tk.Entry(master=frm_form, width=50)
-lbl_operational_look_up = tk.Label(master=frm_form, text="Transaction to Look Up")
-ent_operational_look_up = tk.Entry(master=frm_form, width=50)
-lbl_operational_results = tk.Label(master=frm_form,text='Results')
-text_operational_results = tk.Text(master=frm_form, height = 20, width = 65)
-
-
-#Place the widgets in a grid
-lbl_operational_seed.grid(row=0, column=4, sticky="e")
-ent_operational_seed.grid(row=0, column=5, sticky="w")
-lbl_operational_account.grid(row=2,column=4, sticky="e")
-ent_operational_account.grid(row=2,column=5, sticky="w")
-lbl_operational_amount.grid(row=3, column=4, sticky="e")
-ent_operational_amount.grid(row=3, column=5, sticky="w")
-lbl_operational_destination.grid(row=4, column=4, sticky="e")
-ent_operational_destination.grid(row=4, column=5, sticky="w")
-lbl_operational_balance.grid(row=5, column=4, sticky="e")
-ent_operational_balance.grid(row=5, column=5, sticky="w")
-lbl_operational_escrow_fulfillment.grid(row=6, column=4, sticky="e")
-ent_operational_escrow_fulfillment.grid(row=6, column=5, sticky="w")
-lbl_operational_sequence_number.grid(row=7, column=4, sticky="e")
-ent_operational_sequence_number.grid(row=7, column=5, sticky="w")
-lbl_operational_escrow_owner.grid(row=8, column=4, sticky="e")
-ent_operational_escrow_owner.grid(row=8, column=5, sticky="w")
-lbl_operational_look_up.grid(row=9, column=4, sticky="e")
-ent_operational_look_up.grid(row=9, column=5, sticky="w")
-lbl_operational_results.grid(row=10, column=4, sticky="ne")
-text_operational_results.grid(row=10, column=5, sticky="nw")
-
-#############################################
-## Buttons ##################################
-#############################################
-
-# Create the Get Standby Account Buttons
-btn_get_standby_account = tk.Button(master=frm_form, text="Get Standby Account",
-                                    command = get_standby_account)
-btn_get_standby_account.grid(row = 0, column = 2, sticky = "nsew")
-btn_get_standby_account_info = tk.Button(master=frm_form,
-                                         text="Get Standby Account Info",
-                                         command = get_standby_account_info)
-btn_get_standby_account_info.grid(row = 1, column = 2, sticky = "nsew")
-btn_standby_send_xrp = tk.Button(master=frm_form, text="Send XRP >",
-                                 command = standby_send_xrp)
-btn_standby_send_xrp.grid(row = 2, column = 2, sticky = "nsew")
-btn_standby_get_condition = tk.Button(master=frm_form, text="Get Condition",
-                                      command = get_condition)
-btn_standby_get_condition.grid(row=4, column=2, sticky="nsew")
-btn_standby_create_escrow = tk.Button(master=frm_form, text="Create Conditional Escrow",
-                                 command = standby_create_conditional_escrow)
-btn_standby_create_escrow.grid(row=5, column = 2, sticky="nsew")
-btn_standby_cancel_escrow = tk.Button(master=frm_form, text="Cancel Escrow",
-                                 command = standby_cancel_time_escrow)
-btn_standby_cancel_escrow.grid(row=6,column = 2, sticky="nsew")
-
-# Create the Operational Account Buttons
-btn_get_operational_account = tk.Button(master=frm_form,
-                                        text="Get Operational Account",
-                                        command = get_operational_account)
-btn_get_operational_account.grid(row=0, column=3, sticky = "nsew")
-btn_get_op_account_info = tk.Button(master=frm_form, text="Get Op Account Info",
-                                    command = get_operational_account_info)
-btn_get_op_account_info.grid(row=1, column=3, sticky = "nsew")
-btn_op_send_xrp = tk.Button(master=frm_form, text="< Send XRP",
-                            command = operational_send_xrp)
-btn_op_send_xrp.grid(row=2, column = 3, sticky = "nsew")
-btn_op_finish_escrow = tk.Button(master=frm_form, text="Finish Escrow",
-                            command = operational_finish_conditional_escrow)
-btn_op_finish_escrow.grid(row = 4, column = 3, sticky="nsew")
-btn_op_get_escrows = tk.Button(master=frm_form, text="Get Escrows",
-                            command = operational_get_escrows)
-btn_op_get_escrows.grid(row = 5, column = 3, sticky="nsew")
-btn_op_get_transaction = tk.Button(master=frm_form, text="Get Transaction",
-                            command = operational_get_transaction)
-btn_op_get_transaction.grid(row = 6, column = 3, sticky = "nsew")
-
-
-# Start the application
-window.mainloop()

docs/_snippets/common-links.md

@@ -456,6 +456,7 @@
 [sign method]: /docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign.md
 [sign_for command]: /docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign_for.md
 [sign_for method]: /docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign_for.md
+[simulate method]: /docs/references/http-websocket-apis/public-api-methods/transaction-methods/simulate.md
 [stand-alone mode]: /docs/concepts/networks-and-servers/rippled-server-modes.md#stand-alone-mode
 [standard format]: /docs/references/http-websocket-apis/api-conventions/response-formatting.md
 [String Number]: /docs/references/protocol/data-types/currency-formats#string-numbers

docs/references/protocol/ledger-data/ledger-entry-types/loanbroker.md

@@ -66,7 +66,7 @@ In addition to the [common ledger entry fields][], {% code-page-name /%} entries
 | `ManagementFeeRate`   | Number    | UInt16        | No        | The fee charged by the lending protocol, in units of 1/10th basis points. Valid values are 0 to 100000 (inclusive), representing 0% to 100%. |
 | `OwnerCount`          | Number    | UInt32        | Yes       | The number of active loans issued by the LoanBroker. |
 | `DebtTotal`           | String    | Number        | Yes       | The total asset amount the protocol owes the vault, including interest. |
-| `DebtMaximum`         | String    | Number        | Yes       | The maximum amount the protocol can owe the vault. The default value of `0` means there is no limit to the debt. |
+| `DebtMaximum`         | String    | Number        | No        | The maximum amount the protocol can owe the vault. The default value of `0` means there is no limit to the debt. |
 | `CoverAvailable`      | String    | Number        | Yes       | The total amount of first-loss capital deposited into the lending protocol. |
 | `CoverRateMinimum`    | Number    | UInt32        | Yes       | The 1/10th basis point of the `DebtTotal` that the first-loss capital must cover. Valid values are 0 to 100000 (inclusive), representing 0% to 100%. |
 | `CoverRateLiquidation`| Number    | UInt12        | Yes       | The 1/10th basis point of minimum required first-loss capital that is moved to an asset vault to cover a loan default. Valid values are 0 to 100000 (inclusive), representing 0% to 100%. |

docs/tutorials/defi/dex/trade-with-auction-slot-in-javascript.md

@@ -1,640 +0,0 @@
-# Trade with an AMM Auction Slot in JavaScript
-
-Follow the steps from the [Create an AMM](./create-an-automated-market-maker.md) tutorial before proceeding.
-
-This example shows how to:
-
-1. Calculate the exact cost of swapping one token for another in an [AMM](../../../concepts/tokens/decentralized-exchange/automated-market-makers.md) pool.
-2. Check the difference in trading fees with and without an auction slot.
-3. Bid on an auction slot with LP tokens.
-4. Create an offer to swap tokens with the AMM.
-
-[![Trade with Auction Slot Test Harness](/docs/img/quickstart-trade-auction-slot1.png)](/docs/img/quickstart-trade-auction-slot1.png)
-
-You can download the [Quickstart Samples](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/quickstart/js/) archive to try each of the samples in your own browser.
-
-{% admonition type="info" name="Note" %}
-Without the Quickstart Samples, you will not be able to try the examples that follow.
-{% /admonition %}
-
-
-## Usage
-
-### Get Accounts
-
-1. Open `13.trade-with-auction-slot.html` in a browser.
-2. Select **Testnet** or **Devnet**
-3. Get test accounts.
-   - If you have existing account seeds:
-     1. Paste account seeds in the **Seeds** field.
-     2. Click **Get Accounts from Seeds**.
-   - If you don't have account seeds:
-     1. Click **Get New Standby Account**.
-     2. Click **Get New Operational Account**.
-
-[![Get account results](/docs/img/quickstart-trade-auction-slot2.png)](/docs/img/quickstart-trade-auction-slot2.png)
-
-
-### Get the AMM
-
-Use the information from either the XRP/Token or Token/Token AMM you created in [Create an AMM](./create-an-automated-market-maker.md#3-select-and-acquire-assets).
-
-1. Enter a [currency code](../../../references/protocol/data-types/currency-formats.md#currency-codes) in the **Asset 1 Currency** field. For example, `XRP`.
-2. Enter a second currency code in the **Asset 2 Currency** field. For example, `TST`.
-3. Enter the operational account address in the **Asset 2 Issuer** field.
-4. Click **Check AMM**.
-
-[![Get AMM results](/docs/img/quickstart-trade-auction-slot3.png)](/docs/img/quickstart-trade-auction-slot3.png)
-
-
-### Estimate Costs
-
-Get a new standby account to ensure you aren't using an account with an auction slot already.
-
-1. Click **Get New Standby Account**.
-2. Under the **Taker Pays** column:
-   - Enter a currency code in the **Currency** field. For example, `TST`.
-   - Enter the operational account address in the **Issuer** field.
-   - Enter an **Amount**. For example, `10`.
-3. Under the **Taker Gets** column, enter a currency code in the **Currency** field. For example, `XRP`.
-4. Click **Estimate Cost**.
-5. Save the values given by the estimate.
-
-[![Estimate costs results](/docs/img/quickstart-trade-auction-slot4.png)](/docs/img/quickstart-trade-auction-slot4.png)
-
-
-### Bid for the Auction Slot
-
-Make a single-asset deposit to the AMM to receive the required LP tokens for the auction slot bid. You can deposit either asset from the cost estimator.
-
-1. Enter the estimated deposit amount in either **Asset 1 Amount** or **Asset 2 Amount**. For example, `0.004012` in **Asset 1 Amount**.
-2. Click **Add to AMM**.
-3. Enter the estimated bid amount in the **LP Tokens** field. For example, `6.326`.
-4. Click **Bid Auction Slot**.
-
-[![Bid auction slot results](/docs/img/quickstart-trade-auction-slot5.png)](/docs/img/quickstart-trade-auction-slot5.png)
-
-
-### Swap Tokens with the AMM
-
-Get a new estimate to update the expected cost for swapping tokens.
-
-1. Click **Estimate Cost**.
-2. Under the **Taker Gets Column**, enter an **Amount**. Use the expected cost with an auction slot from the estimate. For example, `1.112113`.
-3. Click **Swap Tokens**.
-
-[![Swap tokens with AMM results](/docs/img/quickstart-trade-auction-slot6.png)](/docs/img/quickstart-trade-auction-slot6.png)
-
-
-## Code Walkthrough (ripplex13a-trade-with-auction-slot.js)
-
-You can open `ripplex13a-trade-with-auction-slot.js` from the [Quickstart Samples](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/quickstart/js/) to view the source code.
-
-
-### Estimate AMM Costs
-
-This function checks the cost of interactions with the AMM, such as deposits, auction slot bids, and token swaps.
-
-```javascript
-async function estimateCost() {
-```
-
-Connect to the XRP Ledger.
-
-```javascript
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-```
-
-Format the `amm_info` command and get the AMM information. This code is wrapped in a `try-catch` block to handle any errors.
-
-```javascript
-    try {
-
-        const asset1_currency = asset1CurrencyField.value
-        const asset1_issuer = asset1IssuerField.value
-
-        const asset2_currency = asset2CurrencyField.value
-        const asset2_issuer = asset2IssuerField.value
-
-
-        // Look up AMM info
-
-        let asset1_info = null
-        let asset2_info = null
-
-        if ( asset1_currency == 'XRP' ) {
-            asset1_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset1_info = {
-                "currency": asset1_currency,
-                "issuer": asset1_issuer
-            }
-        }
-
-        if ( asset2_currency == 'XRP' ) {
-            asset2_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset2_info = {
-                "currency": asset2_currency,
-                "issuer": asset2_issuer
-            }
-        }
-
-        const amm_info = (await client.request({
-            "command": "amm_info", 
-            "asset": asset1_info,
-            "asset2": asset2_info
-        }))
-
-        // Save relevant AMM info for calculations
-
-        const lpt = amm_info.result.amm.lp_token
-        const pool_asset1 = amm_info.result.amm.amount
-        const pool_asset2 = amm_info.result.amm.amount2
-        const full_trading_fee = amm_info.result.amm.trading_fee
-        const discounted_fee = amm_info.result.amm.auction_slot.discounted_fee
-        const old_bid = amm_info.result.amm.auction_slot.price.value
-        const time_interval = amm_info.result.amm.auction_slot.time_interval
-
-        results += `\n\nTrading Fee: ${full_trading_fee/1000}%\nDiscounted Fee: ${discounted_fee/1000}%`
-```
-
-Save the taker pays and taker gets fields; use these values to get the total amount of each asset in the AMM pool, using large significant digits for precise calculations. This also checks if the requested token amount is larger than what is available in the AMM pool, stopping the code if `true`.
-
-```javascript
-        // Save taker pays and gets values.
-        
-        const takerPays = {
-            "currency": standbyTakerPaysCurrencyField.value,
-            "issuer": standbyTakerPaysIssuerField.value,
-            "amount": standbyTakerPaysAmountField.value
-        }
-
-        const takerGets = {
-            "currency": standbyTakerGetsCurrencyField.value,
-            "issuer": standbyTakerGetsIssuerField.value,
-            "amount": standbyTakerGetsAmountField.value
-        }
-
-        // Get amount of assets in the pool.
-        // Convert values to BigNumbers with the appropriate precision.
-        // Tokens always have 15 significant digits;
-        // XRP is precise to integer drops, which can be as high as 10^17
-
-        let asset_out_bn = null
-        let pool_in_bn = null
-        let pool_out_bn = null
-        let isAmmAsset1Xrp = false
-        let isAmmAsset2Xrp = false
-
-        if ( takerPays.currency == 'XRP' ) {
-            asset_out_bn = BigNumber(xrpl.xrpToDrops(takerPays.amount)).precision(17)
-        } else {
-            asset_out_bn = BigNumber(takerPays.amount).precision(15)
-        }
-
-        if ( takerGets.currency == 'XRP' && asset1_currency == 'XRP' ) {
-            pool_in_bn = BigNumber(pool_asset1).precision(17)
-            isAmmAsset1Xrp = true
-        } else if ( takerGets.currency == 'XRP' && asset2_currency == 'XRP' ) {
-            pool_in_bn = BigNumber(pool_asset2).precision(17)
-            isAmmAsset2Xrp = true
-        } else if ( takerGets.currency == asset1_currency ) {
-            pool_in_bn = BigNumber(pool_asset1.value).precision(15)
-        } else {
-            pool_in_bn = BigNumber(pool_asset2.value).precision(15)
-        }
-
-        if (takerPays.currency == 'XRP' && asset1_currency == 'XRP' ) {
-            pool_out_bn = BigNumber(pool_asset1).precision(17)
-        } else if ( takerPays.currency == 'XRP' && asset2_currency == 'XRP' ) {
-            pool_out_bn = BigNumber(pool_asset2).precision(17)
-        } else if ( takerPays.currency == asset1_currency ) {
-            pool_out_bn = BigNumber(pool_asset1.value).precision(15)
-        } else {
-            pool_out_bn = BigNumber(pool_asset2.value).precision(15)
-        }
-
-        if ( takerPays.currency == 'XRP' && parseFloat(takerPays.amount) > parseFloat(xrpl.dropsToXrp(pool_out_bn)) ) {
-            results += `\n\nRequested ${takerPays.amount} ${takerPays.currency}, but AMM only holds ${xrpl.dropsToXrp(pool_out_bn)}. Quitting.`
-            standbyResultField.value = results
-            client.disconnect()
-            return
-        } else if ( parseFloat(takerPays.amount) > parseFloat(pool_out_bn) ) {
-            results += `\n\nRequested ${takerPays.amount} ${takerPays.currency}, but AMM only holds ${pool_out_bn}. Quitting.`
-            standbyResultField.value = results
-            client.disconnect()
-            return
-        }
-```
-
-Implement [AMM formulas](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/misc/detail/AMMHelpers.cpp) to estimate values for:
-
-- Cost to swap token without an auction slot.
-- Cost to swap token with an auction slot.
-- LP tokens to win an auction slot. This value factors the increase in the minimum bid of having new LP tokens issued to you from your deposit.
-- The amount of tokens for single-asset deposits to get the required LP tokens to win the auction slot.
-
-```javascript
-        // Use AMM's SwapOut formula to figure out how much of the takerGets asset
-        // you have to pay to receive the target amount of takerPays asset
-        const unrounded_amount = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, full_trading_fee)
-        // Drop decimal places and round ceiling to ensure you pay in enough.
-        const swap_amount = unrounded_amount.dp(0, BigNumber.ROUND_CEIL)
-
-        // Helper function to convert drops to XRP in log window
-        function convert(currency, amount) {
-            if ( currency == 'XRP' ) {
-                amount = xrpl.dropsToXrp(amount)
-            }
-            return amount
-        }
-
-        results += `\n\nExpected cost for ${takerPays.amount} ${takerPays.currency}: ${convert(takerGets.currency, swap_amount)} ${takerGets.currency}`
-
-        // Use SwapOut to calculate discounted swap amount with auction slot
-        const raw_discounted = swapOut(asset_out_bn, pool_in_bn, pool_out_bn, discounted_fee)
-        const discounted_swap_amount = raw_discounted.dp(0, BigNumber.ROUND_CEIL)    
-        results += `\n\nExpected cost with auction slot for ${takerPays.amount} ${takerPays.currency}: ${convert(takerGets.currency, discounted_swap_amount)} ${takerGets.currency}`
-
-        // Calculate savings by using auction slot
-        const potential_savings = swap_amount.minus(discounted_swap_amount)
-        results += `\nPotential savings: ${convert(takerGets.currency, potential_savings)} ${takerGets.currency}`
-
-        // Calculate the cost of winning the auction slot, in LP Tokens.
-        const auction_price = auctionDeposit(old_bid, time_interval, full_trading_fee, lpt.value).dp(3, BigNumber.ROUND_CEIL)
-        results += `\n\nYou can win the current auction slot by bidding ${auction_price} LP Tokens.`
-
-        // Calculate how much to add for a single-asset deposit to receive the target LP Token amount
-        let deposit_for_bid_asset1 = null
-        let deposit_for_bid_asset2 = null
-
-        if ( isAmmAsset1Xrp == true ) {
-            deposit_for_bid_asset1 = xrpl.dropsToXrp(ammAssetIn(pool_asset1, lpt.value, auction_price, full_trading_fee).dp(0, BigNumber.ROUND_CEIL))
-        } else {
-            deposit_for_bid_asset1 = ammAssetIn(pool_asset1.value, lpt.value, auction_price, full_trading_fee).dp(15, BigNumber.ROUND_CEIL)
-        }
-
-        if ( isAmmAsset2Xrp == true ) {
-            deposit_for_bid_asset2 = xrpl.dropsToXrp(ammAssetIn(pool_asset2, lpt.value, auction_price, full_trading_fee).dp(0, BigNumber.ROUND_CEIL))
-        } else {
-            deposit_for_bid_asset2 = ammAssetIn(pool_asset2.value, lpt.value, auction_price, full_trading_fee).dp(15, BigNumber.ROUND_CEIL)
-        }
-
-        if ( isAmmAsset1Xrp == true ) {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} XRP or ${deposit_for_bid_asset2} ${pool_asset2.currency} to get the required LP Tokens.`
-        } else if ( isAmmAsset2Xrp == true ) {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} ${pool_asset1.currency} or ${deposit_for_bid_asset2} XRP to get the required LP Tokens.`
-        } else {
-            results += `\n\nMake a single-asset deposit to the AMM of ${deposit_for_bid_asset1} ${pool_asset1.currency} or ${deposit_for_bid_asset2} ${pool_asset2.currency} to get the required LP Tokens.`
-        }
-
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-```
-
-Report the estimated values and close the client connection.
-
-```javascript
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}
-```
-
-
-### Bid on the Auction Slot
-
-This function bids on the AMM auction slot, using LP tokens.
-
-```javascript
-async function bidAuction() {
-```
-
-Connect to the ledger.
-
-```javascript
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-```
-
-Format the asset values, depending on if it's `XRP` or a token. Wrap the code in a `try-catch` block to handle any errors.
-
-```javascript
-    try {
-
-        const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-
-        const asset1_currency = asset1CurrencyField.value
-        const asset1_issuer = asset1IssuerField.value
-
-        const asset2_currency = asset2CurrencyField.value
-        const asset2_issuer = asset2IssuerField.value
-        const valueLPT = standbyLPField.value
-
-        // Look up AMM info
-
-        let asset1_info = null
-        let asset2_info = null
-
-        if ( asset1_currency == 'XRP' ) {
-            asset1_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset1_info = {
-                "currency": asset1_currency,
-                "issuer": asset1_issuer
-            }
-        }
-
-        if ( asset2_currency == 'XRP' ) {
-            asset2_info = {
-                "currency": "XRP"
-            }
-        } else {
-            asset2_info = {
-                "currency": asset2_currency,
-                "issuer": asset2_issuer
-            }
-        }
-
-        const amm_info = (await client.request({
-            "command": "amm_info", 
-            "asset": asset1_info,
-            "asset2": asset2_info
-        }))
-
-        // Save relevant AMM info for calculations
-
-        const lpt = amm_info.result.amm.lp_token
-
-        results += '\n\nBidding on auction slot ...'
-        standbyResultField.value = results
-```
-
-Submit the `AMMBid` transaction.
-
-```javascript
-        const bid_result = await client.submitAndWait({
-            "TransactionType": "AMMBid",
-            "Account": standby_wallet.address,
-            "Asset": asset1_info,
-            "Asset2": asset2_info,
-            "BidMax": {
-                "currency": lpt.currency,
-                "issuer": lpt.issuer,
-                "value": valueLPT
-            },
-            "BidMin": {
-                "currency": lpt.currency,
-                "issuer": lpt.issuer,
-                "value": valueLPT
-            } // So rounding doesn't leave dust amounts of LPT
-            }, {autofill: true, wallet: standby_wallet})
-    
-        if (bid_result.result.meta.TransactionResult == "tesSUCCESS") {
-            results += `\n\nTransaction succeeded.`
-            checkAMM()
-        } else {
-            results += `\n\nError sending transaction: ${JSON.stringify(bid_result.result.meta.TransactionResult, null, 2)}`
-        }        
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-```
-
-Report the results.
-
-```javascript
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}
-```
-
-
-### Swap AMM Tokens
-
-This function submits an `OfferCreate` transaction, using precise values to format the transaction and have the AMM completely consume the offer.
-
-```javascript
-async function swapTokens() {
-```
-
-Connect to the XRP Ledger.
-
-```javascript
-    let net = getNet()
-
-    const client = new xrpl.Client(net)
-    results = `\n\nConnecting to ${getNet()} ...`
-    standbyResultField.value = results
-
-    await client.connect()
-    results += '\n\nConnected.'
-    standbyResultField.value = results
-```
-
-Get the taker pays and taker gets fields and format the amounts depending on if it's `XRP` or a custom token. Wrap the code in a `try-catch` block to handle any errors.
-
-```javascript
-    try {
-
-        const standby_wallet = xrpl.Wallet.fromSeed(standbySeedField.value)
-
-        const takerPaysCurrency = standbyTakerPaysCurrencyField.value
-        const takerPaysIssuer = standbyTakerPaysIssuerField.value
-        const takerPaysAmount = standbyTakerPaysAmountField.value
-
-        const takerGetsCurrency = standbyTakerGetsCurrencyField.value
-        const takerGetsIssuer = standbyTakerGetsIssuerField.value
-        const takerGetsAmount = standbyTakerGetsAmountField.value
-
-        let takerPays = null
-        let takerGets = null
-
-        if ( takerPaysCurrency == 'XRP' ) {
-            takerPays = xrpl.xrpToDrops(takerPaysAmount)
-        } else {
-            takerPays = {
-                "currency": takerPaysCurrency,
-                "issuer": takerPaysIssuer,
-                "value": takerPaysAmount
-            }
-        }
-
-        if ( takerGetsCurrency == 'XRP' ) {
-            takerGets = xrpl.xrpToDrops(takerGetsAmount)
-        } else {
-            takerGets = {
-                "currency": takerGetsCurrency,
-                "issuer": takerGetsIssuer,
-                "value": takerGetsAmount
-            }
-        }
-
-        results += '\n\nSwapping tokens ...'
-        standbyResultField.value = results
-```
-
-Submit the `OfferCreate` transaction.
-
-```javascript
-        const offer_result = await client.submitAndWait({
-            "TransactionType": "OfferCreate",
-            "Account": standby_wallet.address,
-            "TakerPays": takerPays,
-            "TakerGets": takerGets
-        }, {autofill: true, wallet: standby_wallet})
-        
-        if (offer_result.result.meta.TransactionResult == "tesSUCCESS") {
-            results += `\n\nTransaction succeeded.`
-            checkAMM()
-        } else {
-            results += `\n\nError sending transaction: ${JSON.stringify(offer_result.result.meta.TransactionResult, null, 2)}`
-        }        
-    } catch (error) {
-        results += `\n\n${error.message}`
-    }
-```
-
-Report the results.
-
-```javascript
-    standbyResultField.value = results
-
-    client.disconnect()
-
-}
-```
-
-
-## Code Walkthrough (ripplex13b-amm-formulas.js) 
-
-You can open `ripplex13b-amm-formulas.js` from the [Quickstart Samples](https://github.com/XRPLF/xrpl-dev-portal/tree/master/_code-samples/quickstart/js/) to view the source code. This code implements several core [AMM formulas](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/misc/detail/AMMHelpers.cpp) defined by the protocol.
-
-
-### swapOut()
-
-The `swapOut()` function calculates how much of an asset you must deposit into an AMM to receive a specified amount of the paired asset. The input asset is what you're adding to the pool (paying), and the output asset is what you're receiving from the pool (buying).
-
-The formula used is based on [AMM Swap](https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0030-automated-market-maker#25-amm-swap), defined in XLS-30.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| asset_out_bn | BigNumber | The target amount to receive from the AMM. |
-| pool_in_bn | BigNumber | The amount of the input asset in the AMM's pool before the swap. |
-| pool_out_bn | BigNumber | The amount of the output asset in the AMM's pool before the swap. |
-| trading_fee | int | The trading fee as an integer {0, 1000} where 1000 represents a 1% fee. |
-
-| Returns | Type | Description |
-|---------|------|-------------|
-| Return Value | BigNumber | The amount of the input asset that must be swapped in to receive the target output amount. Unrounded, because the number of decimals depends on if this is drops of XRP or a decimal amount of a token; since this is a theoretical input to the pool, it should be rounded up (ceiling) to preserve the pool's constant product. |
-
-```javascript
-function swapOut(asset_out_bn, pool_in_bn, pool_out_bn, trading_fee) {
-    return ( ( pool_in_bn.multipliedBy(pool_out_bn) ).dividedBy(
-                pool_out_bn.minus(asset_out_bn)
-             ).minus(pool_in_bn)
-           ).dividedBy(feeMult(trading_fee))
-}
-```
-
-### auctionDeposit()
-
-The `auctionDeposit()` calculates how many LP tokens you need to spend to win the auction slot. The formula assumes you don't have any LP tokens and factors in the increase in LP tokens issued when you deposit assets. If you already have LP tokens, you can use the `auctionPrice()` function instead.
-
-The formula used is based on the [slot pricing algorithm](https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0030-automated-market-maker#411-slot-pricing) defined in XLS-30.
-
-```javascript
-function auctionDeposit(old_bid, time_interval, trading_fee, lpt_balance) {
-    const tfee_decimal = feeDecimal(trading_fee)
-    const lptokens = BigNumber(lpt_balance)
-    const b = BigNumber(old_bid)
-    let outbidAmount = BigNumber(0) // This is the case if time_interval >= 20
-    if (time_interval == 0) {
-        outbidAmount = b.multipliedBy("1.05")
-    } else if (time_interval <= 19) {
-        const t60 = BigNumber(time_interval).multipliedBy("0.05").exponentiatedBy(60)
-        outbidAmount = b.multipliedBy("1.05").multipliedBy(BigNumber(1).minus(t60))
-    }
-
-    const new_bid = lptokens.plus(outbidAmount).dividedBy(
-                            BigNumber(25).dividedBy(tfee_decimal).minus(1)
-                          ).plus(outbidAmount)
-    
-    // Significant digits for the deposit are limited by total LPTokens issued
-    // so we calculate lptokens + deposit - lptokens to determine where the
-    // rounding occurs. We use ceiling/floor to make sure the amount we receive
-    // after rounding is still enough to win the auction slot.
-    const rounded_bid = new_bid.plus(lptokens).precision(15, BigNumber.CEILING
-                              ).minus(lptokens).precision(15, BigNumber.FLOOR)
-    return rounded_bid
-}
-```
-
-### ammAssetIn()
-
-The `ammAssetIn()` function calculates how much to add in a single-asset deposit to receive a specified amount of LP tokens.
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| pool_in | string | The quantity of the input asset the pool already has. |
-| lpt_balance | string | The quantity of LP tokens already issued by the AMM. |
-| desired_lpt | string | The quantity of new LP tokens you want to receive. |
-| trading_fee | int | The trading fee as an integer {0, 1000} where 1000 represents a 1% fee. |
-
-```javascript
-function ammAssetIn(pool_in, lpt_balance, desired_lpt, trading_fee) {
-    // convert inputs to BigNumber
-    const lpTokens = BigNumber(desired_lpt)
-    const lptAMMBalance = BigNumber(lpt_balance)
-    const asset1Balance = BigNumber(pool_in)
-
-    const f1 = feeMult(trading_fee)
-    const f2 = feeMultHalf(trading_fee).dividedBy(f1)
-    const t1 = lpTokens.dividedBy(lptAMMBalance)
-    const t2 = t1.plus(1)
-    const d = f2.minus( t1.dividedBy(t2) )
-    const a = BigNumber(1).dividedBy( t2.multipliedBy(t2))
-    const b = BigNumber(2).multipliedBy(d).dividedBy(t2).minus( 
-                    BigNumber(1).dividedBy(f1)
-              )
-    const c = d.multipliedBy(d).minus( f2.multipliedBy(f2) )
-    return asset1Balance.multipliedBy(solveQuadraticEq(a,b,c))
-}
-```
-
-Compute the quadratic formula. This is a helper function for `ammAssetIn()`. Parameters and return value are `BigNumber` instances.
-
-```javascript
-function solveQuadraticEq(a,b,c) {
-    const b2minus4ac = b.multipliedBy(b).minus( 
-                            a.multipliedBy(c).multipliedBy(4) 
-                       )
-    return ( b.negated().plus(b2minus4ac.sqrt()) ).dividedBy(a.multipliedBy(2))
-}
-```

docs/tutorials/defi/dex/use-amm-auction-slot-for-lower-fees.md

@@ -0,0 +1,313 @@
+# Use the AMM Auction Slot for Lower Fees
+
+Thsi tutorial shows how to use the auction slot of an [Automated Market Maker (AMM)](../../../concepts/tokens/decentralized-exchange/automated-market-makers.md) to save the amount of fees you pay when trading against that AMM.
+
+For a simpler example of trading currencies in the XRP Ledger's DEX, see [Trade in the Decentralized Exchange](./trade-in-the-decentralized-exchange.md).
+
+{% admonition type="warning" name="Caution" %}
+This tutorial does not exhaustively cover all possible market conditions and circumstances. Always exercise caution and trade at your own risk.
+{% /admonition %}
+
+## Goals
+
+By following this tutorial, you should learn how to:
+
+- Estimate the fees that would be charged by an AMM for a particular trade.
+- Estimate the cost of winning an AMM's auction slot.
+- Use the AMM's auction slot to pay lower fees.
+
+## Prerequisites
+
+To complete this tutorial, you should:
+
+- Have a basic understanding of the XRP Ledger.
+- Have an [XRP Ledger client library](../../../references/client-libraries.md), such as **xrpl.js**, installed.
+- Know which AMM you want to trade against: that AMM must already exist in the ledger. For purposes of this tutorial, you can use the following AMM instance that has been set up on the XRP Ledger Testnet in advance:
+
+    | Currency Code | Issuer | Notes |
+    |---|---|---|
+    | XRP | N/A | Testnet XRP is functionally similar to XRP, but holds no real-world value. You can get it for free from a [faucet](/resources/dev-tools/xrp-faucets).
+    | TST | `rP9jPyP5kyvFRb6ZiRghAGw5u8SGAmU4bd` | A test token pegged to XRP at a rate of approximately 10 XRP per 1 TST. The issuer has existing Offers on the XRP Ledger Testnet to buy and sell these tokens. This token has no [transfer fee](../../../concepts/tokens/fungible-tokens/transfer-fees.md) or [Tick Size](../../../concepts/tokens/decentralized-exchange/ticksize.md) set. |
+
+    For instructions on creating an AMM for a different currency pair, see [Create an Automated Market Maker](./create-an-automated-market-maker.md).
+
+## Source Code
+
+See {% repo-link path="_code-samples/auction-slot/" %}Code Samples: Auction Slot{% /repo-link %} for the full source code for this tutorial.
+
+
+## Steps
+
+At a high level, the steps involved in using an AMM auction slot to save money on trading are as follows:
+
+- **Step 1:** Connect to the ledger so can query the current state.
+- **Steps 2-4:** Estimate how much your desired trade would cost in AMM trading fees.
+- **Step 5:** Compare against the cost to win the current auction slot.
+- **Steps 6-7:** If winning the auction slot is cheaper, use AMMDeposit to acquire some LPTokens and then use AMMBid to spend those tokens on winning the auction slot.
+- **Step 8:** Make the intended trade using an OfferCreate transaction.
+
+For simplicity, this tutorial assumes that you have XRP, you want to acquire a fixed amount of TST in a single trade, and that the entire trade will execute using the AMM. Real-life situations are more complicated. For example, part of your trade may execute by consuming Offers rather than using the AMM, or you may want to do a series of trades over a period of time. If one or both of the assets you are trading has a transfer fee or tick size set, those details can also affect the calculations.
+
+### 1. Install dependencies
+
+{% tabs %}
+{% tab label="JavaScript" %}
+For this use case, you need a high-precision number library such as [Bignumber.js](https://mikemcl.github.io/bignumber.js/) for correctly performing calculations on currency amounts you may find in the ledger. The example `package.json` includes the necessary dependencies:
+
+{% code-snippet file="/_code-samples/auction-slot/js/package.json" language="json" /%}
+
+From the code sample folder, use `npm` to install dependencies:
+
+```sh
+npm i
+```
+{% /tab %}
+{% /tabs %}
+
+### 2. Get AMM Formulas
+
+To estimate the costs of various AMM operations, you need implementations of several AMM functions which match the calculations used by the XRP Ledger. See the [Appendix](#appendix-amm-formulas) for the implementations of these functions.
+
+{% tabs %}
+{% tab label="JavaScript" %}
+Along with the other dependencies, import the AMM helper functions from the file `amm-formulas.js`:
+
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" before="// Connect and get account" /%}
+{% /tab %}
+{% /tabs %}
+
+### 3. Connect and get account
+
+Instantiate an API client and a Wallet instance for the account to perform the trade:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Connect and get account" before="// Look up AMM status" /%}
+{% /tab %}
+{% /tabs %}
+
+### 4. Look Up AMM Status
+
+To determine if your trade could benefit from the reduced fees of the AMM auction slot, you must first look up the current state of the AMM. To get the latest information, use the `amm_info` method and query the `current` (pending) ledger version.
+
+{% admonition type="warning" name="Caution" %}The `current` ledger incorporates recently-sent transactions that are likely to be confirmed; it is the most up-to-date picture of the ledger state, but the details may change when the ledger is validated. You can also use the `validated` ledger, which returns only the confirmed data, but the `current` ledger is usually closer to the state the ledger will be in by the time your trade executes.{% /admonition %}
+
+The following code snippet reads the `amm_info` result and saves some of the details for later use:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Look up AMM status" before="// Calculate price in XRP" /%}
+{% /tab %}
+{% /tabs %}
+
+
+### 5. Estimate the cost of AMM trading fees
+
+This tutorial shows how to estimate the cost, in XRP, to buy a fixed amount of TST using the AMM. The calculations are different for other types of trades, such as a "sell" trade that buys as much TST as possible with a fixed amount of XRP, or for assets with other complications such as transfer fees.
+
+First, define the target amount of TST and check that the AMM can even fulfill the trade:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Calculate price in XRP" before="// Use AMM's SwapOut formula" /%}
+{% /tab %}
+{% /tabs %}
+
+Then, you use the AMM _SwapOut_ formula to calculate how much XRP you need to pay to receive the target amount of TST out. See [SwapOut in the Appendix](#swapout) for the implementation of this formula.
+
+To estimate the cost of trading fees, call SwapOut twice: once with the full fee, and once with the discounted fee of the auction slot. The difference between the two represents the maximum possible savings from the auction slot for this trade. The actual savings will be less because of the costs of winning the auction slot.
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Use AMM's SwapOut formula" before="// Calculate the cost of winning" /%}
+{% /tab %}
+{% /tabs %}
+
+{% admonition type="info" name="Note" %}For illustrative purposes, this code assumes that the entire trade will execute using the AMM and not by consuming Offers. In reality, a trade can use both in combination to achieve a better rate. You could also use the [simulate method][] to see how much of a potential trade would use the AMM.{% /admonition %}
+
+
+### 6. Calculate the cost of winning the auction slot
+
+The cost to win the auction slot depends on how long the current holder has held it and how much they paid, but it's always denominated in LP tokens. If you currently only have XRP and you want to win the auction slot, you must first deposit some of your XRP to get LP Tokens.
+
+The price of winning the auction slot is defined in XLS-0030 section 4.1.1. However, the minimum bid scales with the number of LP Tokens issued. If you calculate the auction price and _then_ deposit exactly enough to pay for it, the auction price increases proportionally to the new LP Tokens you gained.
+
+This is similar to cases where you want to deliver exactly $100 after subtracting a 3% fee. If you calculate $100 + (0.03 * $100) = $103, only $99.91 will arrive because the extra $3 is also subject to the fee. Instead, you divide 100 ÷ 0.97 ≈ $103.10 (rounding up to make sure).
+
+The _AuctionDeposit_ formula represents the inverted form of the auction price formula so that you can calulate how much to deposit to match the auction price. See [Appendix: AuctionDeposit](#auctiondeposit) for the implementation.
+
+You use the function like this:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Calculate the cost of winning the auction slot" before="// Calculate how much XRP to deposit" /%}
+{% /tab %}
+{% /tabs %}
+
+
+### 7. Compare the costs and savings
+
+The previous step gives a cost for the auction slot in the form of LP Tokens. To compare against your potential savings, you need to convert this to the XRP cost of the deposit. If the XRP cost of making the deposit and winning the auction slot is greater than your savings, then you should not go through with it.
+
+You use the AMM _AssetIn_ formula to estimate how much XRP you have to deposit to receive the target amount of TST. See [Appendix: AssetIn](#assetin) for the implementation.
+
+The following code uses AssetIn to estimate the cost of the deposit:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Calculate how much XRP to deposit" before="// Optional. Allow for costs" /%}
+{% /tab %}
+{% /tabs %}
+
+Since the XRP Ledger's decentralized exchange is always open to other traders using it too, new transactions can change the current state at the same time that you are doing these calculations and sending your own transactions. You should allow for some amount of _slippage_, the change in rates between when you checked them and when your transaction executes. The following example allows up to 1% slippage:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Optional. Allow for costs" before="// Compare price of deposit+bid" /%}
+{% /tab %}
+{% /tabs %}
+
+Finally, you take the slippage-adjusted cost in XRP, add the transaction costs in XRP burned for sending two transactions, and compare that total to the potential savings calculated back in step 3. If the total cost is higher than the savings, you won't save money using the auction slot, so you stop here.
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Compare price of deposit+bid" before="// Do a single-asset deposit" /%}
+{% /tab %}
+{% /tabs %}
+
+{% admonition type="success" name="Tip" %} You may still be able to save money if you plan to do additional trades for a larger total amount. Also, if the auction slot is currently occupied, the cost of outbidding the current slot holder decreases over 24 hours, so you can wait and try again later.{% /admonition %}
+
+
+### 8. Send an AMMDeposit transaction to get LP Tokens
+
+Assuming you determined that you could make money, it's now time to send actual transactions to the XRP Ledger, starting with an [AMMDeposit transaction][] to get the LP Tokens that you'll bid on the auction slot.
+
+The "One Asset LP Token" deposit type is most convenient here since you can specify exactly how many LP Tokens you want to receive, and you only need to deposit XRP. The following code creates and sends the transaction:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Do a single-asset deposit" before="// Actually bid" /%}
+{% /tab %}
+{% /tabs %}
+
+After the transaction is (or isn't) confirmed by the consensus process, the code displays the results to the console.
+
+
+### 9. Send an AMMBid transaction to win the auction slot
+
+Assuming the previous transaction was successful, the next step is to use the LP Tokens to bid on the auction slot. To do this, you send an [AMMBid transaction][] with the slippage-adjusted bid amount you calculated earlier in the `BidMax` field, as in the following code:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Actually bid" before="// Trade using the discount" /%}
+{% /tab %}
+{% /tabs %}
+
+{% admonition type="success" name="Tip" %}The amounts that LP Tokens get rounded can be surprising. If you don't plan on holding LP Tokens after bidding, you should set `BidMin` to the same as `BidMax` so that you aren't left with a trust line that contains a very tiny amount of LP Tokens that weren't spent on the auction price, and you don't have to meet the XRP reserve for that trust line.{% /admonition %}
+
+
+### 10. Trade using the discount
+
+If your previous transaction was successful, you should now be the auction slot holder until you are outbid or 24 hours have passed, whichever comes first. You can immediately use this opportunity to make the XRP for TST trade that you wanted to make in the first place. There are several ways to make trades in the XRP Ledger, but sending an OfferCreate transaction is the most conventional, as in the following code:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/auction-slot.js" language="js" from="// Trade using the discount" before="// Done" /%}
+{% /tab %}
+{% /tabs %}
+
+{% admonition type="success" name="Tip" %}If you are outbid before the auction slot expires, you'll get some of your LP Tokens refunded based on how much time you had left. You can use an [AMMWithdraw transaction][] to convert those to additional XRP, TST, or both as desired.{% /admonition %}
+
+
+## Appendix: AMM Formulas
+
+The above sample code shows how to use various AMM-related formulas in a particular workflow. Your code must also have implementations of those formulas, which can be in the same file or imported from a separate one as you desire.
+
+{% tabs %}
+{% tab label="JavaScript" %}
+The file {% repo-link path="_code-samples/auction-slot/js/amm-formulas.js" %}`amm-formulas.js`{% /repo-link %} contains the source code for all these formulas.
+{% /tab %}
+{% /tabs %}
+
+### AssetIn
+
+The _AssetIn_ formula calculates how much of an asset must be deposited to receive a target amount of LP Tokens.
+
+The following function implements AssetIn in JavaScript:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Implement the AMM single-asset deposit" before="/* Calculate how much to deposit" /%}
+{% /tab %}
+{% /tabs %}
+
+This function depends on the `feeMult`, `feeMultHalf`, and `solveQuadraticEq` helper functions.
+
+### AuctionDeposit
+
+The _AuctionDeposit_ function is an inverted form of the formula for the AMM's auction price, taking into account how the minimum bid value changes as LP Tokens are issued. AuctionDeposit calculates the total amount of LP Tokens you need to receive in a deposit if you want to match the auction price:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Calculate how much to deposit" before="/* Calculate the necessary bid" /%}
+{% /tab %}
+{% /tabs %}
+
+### AuctionPrice
+
+The _AuctionPrice_ function calculates the cost of the auction slot for current LP Token holders. **It is not used in this tutorial,** which assumes the user does not hold LP Tokens, but is presented here for completeness:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Calculate the necessary bid" /%}
+{% /tab %}
+{% /tabs %}
+
+
+### SwapOut
+
+The _SwapOut_ formula, defined in the XRPL-0030 specification as formula 10, calculates how much of one asset you have to swap in to the AMM to receive a target amount of the other asset out from the AMM.
+
+The following function implements SwapOut in JavaScript:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Implement the AMM SwapOut formula" before="/* Compute the quadratic formula" /%}
+{% /tab %}
+{% /tabs %}
+
+### feeDecimal, feeMult, and feeMultHalf
+
+These helper functions are used in other AMM formulas to convert from a trading fee value in the ledger (integer from 0 to 1000) to a decimal representation that can be multiplied by a total to apply the fee.
+
+The following functions implement `feeMult`, `feeMultHalf`, and `feeDecimal` in JavaScript:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Convert a trading fee to a value that" before="/* Implement the AMM SwapOut formula" /%}
+{% /tab %}
+{% /tabs %}
+
+The `AssetIn` and `SwapOut` functions depend on these helper functions.
+
+### solveQuadraticEq
+
+This helper function implements the quadratic equation in JavaScript:
+
+{% tabs %}
+{% tab label="JavaScript" %}
+{% code-snippet file="/_code-samples/auction-slot/js/amm-formulas.js" language="js" from="/* Compute the quadratic formula." before="/* Implement the AMM single-asset deposit" /%}
+{% /tab %}
+{% /tabs %}
+
+The `AssetIn` formula depends on this.
+
+
+## Conclusion
+
+Trading assets is never risk-free, and Automated Market Makers are no exception. However, the XRP Ledger's fast, low-cost transactions can be helpful in reducing the costs and fees associated with currency exchange. This tutorial demonstrates a minimal approach to using the auction slot to save money, but of course more creative uses are possible.
+
+The details depend on your specific circumstances and the types of trades you are doing, or expect to do in the future, as well as the state of the market, the XRP Ledger network, and the AMM instances in particular. See the [Code Samples](/resources/code-samples) for additional related use cases, and feel free to contribute your own samples as well to show the community what can be done on the XRP Ledger.
+
+
+{% raw-partial file="/docs/_snippets/common-links.md" /%}

docs/tutorials/index.page.tsx

@@ -1,5 +1,52 @@
 import { useThemeHooks } from "@redocly/theme/core/hooks"
 import { Link } from "@redocly/theme/components/Link/Link"
+import { useRef, useState } from "react"
+
+type TutorialLanguagesMap = Record<string, string[]>
+
+interface TutorialMetadataItem {
+  path: string
+  title: string
+  description: string
+  lastModified: string
+  category: string
+}
+
+interface Tutorial {
+  title: string
+  description?: string
+  path: string
+  // External community contribution fields (optional)
+  author?: { name: string; url: string }
+  github?: string
+  externalUrl?: string
+}
+
+interface TutorialSection {
+  id: string
+  title: string
+  description: string
+  tutorials: Tutorial[]
+  showFooter?: boolean
+}
+
+// External community contribution - manually curated with author/repo/demo info
+interface PinnedExternalTutorial {
+  title: string
+  description: string
+  author: { name: string; url: string }
+  github: string
+  url?: string
+}
+
+// Pinned tutorial entry:
+// - string: internal path (uses frontmatter title/description)
+// - object with `path`: internal path with optional description override
+// - PinnedExternalTutorial: external community contribution with author/repo/demo
+type PinnedTutorial = string | { path: string; description?: string } | PinnedExternalTutorial
+
+const MAX_WHATS_NEW = 3
+const MAX_TUTORIALS_PER_SECTION = 6
 
 export const frontmatter = {
   seo: {
@@ -19,242 +66,90 @@ const langIcons: Record<string, { src: string; alt: string }> = {
   xrpl: { src: "/img/logos/xrp-mark.svg", alt: "XRP Ledger" },
 }
 
-// Type for the tutorial languages map from the plugin
-type TutorialLanguagesMap = Record<string, string[]>
-
-interface Tutorial {
-  title: string
-  body?: string
-  path: string
-  icon?: string // Single language icon (for single-language tutorials)
-}
-
-interface TutorialSection {
-  id: string
-  title: string
-  description: string
-  tutorials: Tutorial[]
-}
-
-// Get Started tutorials -----------------
-const getStartedTutorials: Tutorial[] = [
-  {
-    title: "JavaScript",
-    body: "Using the xrpl.js client library.",
-    path: "/docs/tutorials/get-started/get-started-javascript/",
-    icon: "javascript",
+// ── Section configuration -----------------------------------------------------------
+// Categories and their titles are auto-detected by the tutorial-metadata plugin.
+// Use the config to customize the category titles, add descriptions, change the default category order, and pin tutorials.
+const sectionConfig: Record<string, {
+  title?: string
+  description?: string
+  pinned?: PinnedTutorial[]
+  showFooter?: boolean
+}> = {
+  "whats-new": {
+    title: "What's New",
+    description: "Recently added/updated tutorials to help you build on the XRP Ledger.",
   },
-  {
-    title: "Python",
-    body: "Using xrpl.py, a pure Python library.",
-    path: "/docs/tutorials/get-started/get-started-python/",
-    icon: "python",
+  "get-started": {
+    showFooter: true,
+    title: "Get Started with SDKs",
+    description: "These tutorials walk you through the basics of building a very simple XRP Ledger-connected application using your favorite programming language.",
+    pinned: [
+      { path: "/docs/tutorials/get-started/get-started-javascript/", description: "Using the xrpl.js client library." },
+      { path: "/docs/tutorials/get-started/get-started-python/", description: "Using xrpl.py, a pure Python library." },
+      { path: "/docs/tutorials/get-started/get-started-go/", description: "Using xrpl-go, a pure Go library." },
+      { path: "/docs/tutorials/get-started/get-started-java/", description: "Using xrpl4j, a pure Java library." },
+      { path: "/docs/tutorials/get-started/get-started-php/", description: "Using the XRPL_PHP client library." },
+      { path: "/docs/tutorials/get-started/get-started-http-websocket-apis/", description: "Access the XRP Ledger directly through the APIs of its core server." },
+    ],
   },
-  {
-    title: "Go",
-    body: "Using xrpl-go, a pure Go library.",
-    path: "/docs/tutorials/get-started/get-started-go/",
-    icon: "go",
-  },
-  {
-    title: "Java",
-    body: "Using xrpl4j, a pure Java library.",
-    path: "/docs/tutorials/get-started/get-started-java/",
-    icon: "java",
-  },
-  {
-    title: "PHP",
-    body: "Using the XRPL_PHP client library.",
-    path: "/docs/tutorials/get-started/get-started-php/",
-    icon: "php",
-  },
-  {
-    title: "HTTP & WebSocket APIs",
-    body: "Access the XRP Ledger directly through the APIs of its core server.",
-    path: "/docs/tutorials/get-started/get-started-http-websocket-apis/",
-    icon: "http",
-  },
-]
-
-// Other tutorial sections -----------------
-// Languages are auto-detected from the markdown files by the tutorial-languages plugin.
-// Only specify `icon` for single-language tutorials without tabs.
-const sections: TutorialSection[] = [
-  {
-    id: "tokens",
-    title: "Tokens",
+  "tokens": {
     description: "Create and manage tokens on the XRP Ledger.",
-    tutorials: [
-      {
-        title: "Issue a Multi-Purpose Token",
-        body: "Issue new tokens using the v2 fungible token standard.",
-        path: "/docs/tutorials/tokens/mpts/issue-a-multi-purpose-token/",
-      },
-      {
-        title: "Issue a Fungible Token",
-        body: "Issue new tokens using the v1 fungible token standard.",
-        path: "/docs/tutorials/tokens/fungible-tokens/issue-a-fungible-token/",
-      },
-      {
-        title: "Mint and Burn NFTs Using JavaScript",
-        body: "Create new NFTs, retrieve existing tokens, and burn the ones you no longer need.",
-        path: "/docs/tutorials/tokens/nfts/mint-and-burn-nfts-js/",
-        icon: "javascript",
-      },
+    pinned: [
+      { path: "/docs/tutorials/tokens/mpts/issue-a-multi-purpose-token/", description: "Issue new tokens using the v2 fungible token standard." },
+      { path: "/docs/tutorials/tokens/fungible-tokens/issue-a-fungible-token/", description: "Issue new tokens using the v1 fungible token standard." },
+      { path: "/docs/tutorials/tokens/nfts/mint-and-burn-nfts-js/", description: "Create new NFTs, retrieve existing tokens, and burn the ones you no longer need." },
+      "/docs/tutorials/tokens/mpts/sending-mpts-in-javascript/",
     ],
   },
-  {
-    id: "payments",
-    title: "Payments",
+  "payments": {
     description: "Transfer XRP and issued currencies using various payment types.",
-    tutorials: [
-      {
-        title: "Send XRP",
-        body: "Send a direct XRP payment to another account.",
-        path: "/docs/tutorials/payments/send-xrp/",
-      },
-      {
-        title: "Sending MPTs in JavaScript",
-        body: "Send a Multi-Purpose Token (MPT) to another account with the JavaScript SDK.",
-        path: "/docs/tutorials/tokens/mpts/sending-mpts-in-javascript/",
-        icon: "javascript",
-      },
-      {
-        title: "Create Trust Line and Send Currency in JavaScript",
-        body: "Set up trust lines and send issued currencies with the JavaScript SDK.",
-        path: "/docs/tutorials/payments/create-trust-line-send-currency-in-javascript/",
-        icon: "javascript",
-      },
-      {
-        title: "Create Trust Line and Send Currency in Python",
-        body: "Set up trust lines and send issued currencies with the Python SDK.",
-        path: "/docs/tutorials/payments/create-trust-line-send-currency-in-python/",
-        icon: "python",
-      },
-      {
-        title: "Send a Conditional Escrow",
-        body: "Send an escrow that can be released when a specific crypto-condition is fulfilled.",
-        path: "/docs/tutorials/payments/send-a-conditional-escrow/",
-      },
-      {
-        title: "Send a Timed Escrow",
-        body: "Send an escrow whose only condition for release is that a specific time has passed.",
-        path: "/docs/tutorials/payments/send-a-timed-escrow/",
-      },
+    pinned: [
+      "/docs/tutorials/payments/send-xrp/",
+      "/docs/tutorials/payments/create-trust-line-send-currency-in-javascript/",
+      "/docs/tutorials/payments/send-a-conditional-escrow/",
+      "/docs/tutorials/payments/send-a-timed-escrow/",
     ],
   },
-  {
-    id: "defi",
-    title: "DeFi",
+  "defi": {
     description: "Trade, provide liquidity, and lend using native XRP Ledger DeFi features.",
-    tutorials: [
-      {
-        title: "Create an Automated Market Maker",
-        body: "Set up an AMM for a token pair and provide liquidity.",
-        path: "/docs/tutorials/defi/dex/create-an-automated-market-maker/",
-      },
-      {
-        title: "Trade in the Decentralized Exchange",
-        body: "Buy and sell tokens in the Decentralized Exchange (DEX).",
-        path: "/docs/tutorials/defi/dex/trade-in-the-decentralized-exchange/",
-      },
-      {
-        title: "Create a Loan Broker",
-        body: "Set up a loan broker to create and manage loans.",
-        path: "/docs/tutorials/defi/lending/use-the-lending-protocol/create-a-loan-broker/",
-      },
-      {
-        title: "Create a Loan",
-        body: "Create a loan on the XRP Ledger.",
-        path: "/docs/tutorials/defi/lending/use-the-lending-protocol/create-a-loan/",
-      },
-      {
-        title: "Create a Single Asset Vault",
-        body: "Create a single asset vault on the XRP Ledger.",
-        path: "/docs/tutorials/defi/lending/use-single-asset-vaults/create-a-single-asset-vault/",
-      },
-      {
-        title: "Deposit into a Vault",
-        body: "Deposit assets into a vault and receive shares.",
-        path: "/docs/tutorials/defi/lending/use-single-asset-vaults/deposit-into-a-vault/",
-      },
+    pinned: [
+      "/docs/tutorials/defi/dex/create-an-automated-market-maker/",
+      "/docs/tutorials/defi/dex/trade-in-the-decentralized-exchange/",
+      "/docs/tutorials/defi/lending/use-the-lending-protocol/create-a-loan/",
+      "/docs/tutorials/defi/lending/use-single-asset-vaults/create-a-single-asset-vault/",
     ],
   },
-  {
-    id: "best-practices",
-    title: "Best Practices",
+  "best-practices": {
     description: "Learn recommended patterns for building reliable, secure applications on the XRP Ledger.",
-    tutorials: [
-      {
-        title: "API Usage",
-        body: "Best practices for using XRP Ledger APIs.",
-        path: "/docs/tutorials/best-practices/api-usage/",
-      },
-      {
-        title: "Use Tickets",
-        body: "Use tickets to send transactions out of the normal order.",
-        path: "/docs/tutorials/best-practices/transaction-sending/use-tickets/",
-      },
-      {
-        title: "Send a Single Account Batch Transaction",
-        body: "Group multiple transactions together and execute them as a single atomic operation.",
-        path: "/docs/tutorials/best-practices/transaction-sending/send-a-single-account-batch-transaction/",
-      },
-      {
-        title: "Assign a Regular Key Pair",
-        body: "Assign a regular key pair for signing transactions.",
-        path: "/docs/tutorials/best-practices/key-management/assign-a-regular-key-pair/",
-      },
-      {
-        title: "Set Up Multi-Signing",
-        body: "Configure multi-signing for enhanced security.",
-        path: "/docs/tutorials/best-practices/key-management/set-up-multi-signing/",
-      },
-      {
-        title: "Send a Multi-Signed Transaction",
-        body: "Send a transaction with multiple signatures.",
-        path: "/docs/tutorials/best-practices/key-management/send-a-multi-signed-transaction/",
-      },
+    pinned: [
+      "/docs/tutorials/best-practices/api-usage/",
     ],
   },
-  {
-    id: "sample-apps",
-    title: "Sample Apps",
+  "compliance-features": {
+    title: "Compliance",
+    description: "Implement compliance controls like destination tags, credentials, and permissioned domains.",
+  },
+  "programmability": {
+    description: "Set up cross-chain bridges and submit interoperability transactions.",
+  },
+  "advanced-developer-topics": {
+    description: "Explore advanced topics like WebSocket monitoring and testing Devnet features.",
+  },
+  "sample-apps": {
     description: "Build complete, end-to-end applications like wallets and credential services.",
-    tutorials: [
+    pinned: [
       {
-        title: "Build a Browser Wallet in JavaScript",
-        body: "Build a browser wallet for the XRP Ledger using JavaScript and various libraries.",
-        path: "/docs/tutorials/sample-apps/build-a-browser-wallet-in-javascript/",
-        icon: "javascript",
-      },
-      {
-        title: "Build a Desktop Wallet in JavaScript",
-        body: "Build a desktop wallet for the XRP Ledger using JavaScript, the Electron Framework, and various libraries.",
-        path: "/docs/tutorials/sample-apps/build-a-desktop-wallet-in-javascript/",
-        icon: "javascript",
-      },
-      {
-        title: "Build a Desktop Wallet in Python",
-        body: "Build a desktop wallet for the XRP Ledger using Python and various libraries.",
-        path: "/docs/tutorials/sample-apps/build-a-desktop-wallet-in-python/",
-        icon: "python",
-      },
-      {
-        title: "Credential Issuing Service in JavaScript",
-        body: "Build a credential issuing service using the JavaScript SDK.",
-        path: "/docs/tutorials/sample-apps/credential-issuing-service-in-javascript/",
-        icon: "javascript",
-      },
-      {
-        title: "Credential Issuing Service in Python",
-        body: "Build a credential issuing service using the Python SDK.",
-        path: "/docs/tutorials/sample-apps/credential-issuing-service-in-python/",
-        icon: "python",
+        title: "XRPL Lending Protocol Demo",
+        description: "A full-stack web application that demonstrates the end-to-end flow of the Lending Protocol and Single Asset Vaults.",
+        author: { name: "Aaditya-T", url: "https://github.com/Aaditya-T" },
+        github: "https://github.com/Aaditya-T/lending_test",
+        url: "https://lending-test-lovat.vercel.app/",
       },
     ],
   },
-]
+}
+
+// ── Components ──────────────────────────────────────────────────────────────
 
 function TutorialCard({
   tutorial,
@@ -267,12 +162,10 @@ function TutorialCard({
   showFooter?: boolean
   translate: (text: string) => string
 }) {
-  // Get icons: manual icon takes priority, then auto-detected languages, then XRPL fallback
-  const icons = tutorial.icon && langIcons[tutorial.icon]
-      ? [langIcons[tutorial.icon]]
-      : detectedLanguages && detectedLanguages.length > 0
-        ? detectedLanguages.map((lang) => langIcons[lang]).filter(Boolean)
-        : [langIcons.xrpl]
+  // Get icons from auto-detected languages, or fallback to XRPL icon.
+  const icons = detectedLanguages && detectedLanguages.length > 0
+    ? detectedLanguages.map((lang) => langIcons[lang]).filter(Boolean)
+    : [langIcons.xrpl]
 
   return (
     <Link to={tutorial.path} className="card">
@@ -285,13 +178,220 @@ function TutorialCard({
       </div>
       <div className="card-body">
         <h4 className="card-title h5">{translate(tutorial.title)}</h4>
-        {tutorial.body && <p className="card-text">{translate(tutorial.body)}</p>}
+        {tutorial.description && <p className="card-text">{translate(tutorial.description)}</p>}
       </div>
       {showFooter && <div className="card-footer"></div>}
     </Link>
   )
 }
 
+// Inline meta link used in ContributionCard
+function MetaLink({ href, icon, label }: {
+  href: string
+  icon: string
+  label: string
+}) {
+  return (
+    <a href={href} target="_blank" rel="noopener noreferrer" className="meta-link">
+      <i className={`fa fa-${icon}`} aria-hidden="true" />
+      {label}
+    </a>
+  )
+}
+
+// Community Contribution Card
+function ContributionCard({
+  tutorial,
+  translate,
+}: {
+  tutorial: Tutorial
+  translate: (text: string) => string
+}) {
+  const primaryUrl = tutorial.externalUrl || tutorial.github!
+
+  const handleCardClick = (e: React.MouseEvent | React.KeyboardEvent) => {
+    if ((e.target as HTMLElement).closest(".card-meta-row")) return
+    window.open(primaryUrl, "_blank", "noopener,noreferrer")
+  }
+
+  return (
+    <div
+      className="card contribution-card"
+      onClick={handleCardClick}
+      onKeyDown={(e) => { if (e.key === "Enter") handleCardClick(e) }}
+      role="link"
+      tabIndex={0}
+    >
+      <div className="card-header contribution-header">
+        <span className="circled-logo contribution-icon">
+          <i className="fa fa-users" aria-hidden="true" />
+        </span>
+        <div className="card-meta-row">
+          {tutorial.author && (
+            <>
+              <MetaLink href={tutorial.author.url} icon="user" label={tutorial.author.name} />
+              <span className="meta-dot" aria-hidden="true">·</span>
+            </>
+          )}
+          <MetaLink href={tutorial.github!} icon="github" label={translate("GitHub")} />
+        </div>
+      </div>
+      <div className="card-body">
+        <h4 className="card-title h5">
+          {translate(tutorial.title)}
+          <span className="card-external-icon" aria-label={translate("External link")}>
+            <i className="fa fa-external-link" aria-hidden="true" />
+          </span>
+        </h4>
+        {tutorial.description && <p className="card-text">{translate(tutorial.description)}</p>}
+      </div>
+    </div>
+  )
+}
+
+// Reusable section block for rendering tutorial sections
+function TutorialSectionBlock({
+  id,
+  title,
+  description,
+  tutorials,
+  tutorialLanguages,
+  showFooter = false,
+  maxTutorials,
+  className = "",
+  translate,
+}: {
+  id: string
+  title: string
+  description: string
+  tutorials: Tutorial[]
+  tutorialLanguages: TutorialLanguagesMap
+  showFooter?: boolean
+  maxTutorials?: number
+  className?: string
+  translate: (text: string) => string
+}) {
+  const [expanded, setExpanded] = useState(false)
+  const sectionRef = useRef<HTMLElement>(null)
+  const hasMore = maxTutorials ? tutorials.length > maxTutorials : false
+  const displayTutorials = maxTutorials && !expanded ? tutorials.slice(0, maxTutorials) : tutorials
+
+  const handleToggle = () => {
+    if (expanded && sectionRef.current) {
+      const offsetTop = sectionRef.current.getBoundingClientRect().top + window.scrollY
+      setExpanded(false)
+      requestAnimationFrame(() => {
+        window.scrollTo({ top: offsetTop - 20 })
+      })
+    } else {
+      setExpanded(true)
+    }
+  }
+
+  return (
+    <section ref={sectionRef} className={`container-new pt-10 pb-14 ${className}`.trim()} id={id}>
+      <div className="col-12 col-xl-8 p-0">
+        <h3 className="h4 mb-3">{translate(title)}</h3>
+        <p className="mb-4">{translate(description)}</p>
+      </div>
+      <div className="row tutorial-cards">
+        {displayTutorials.map((tutorial) => (
+          <div key={tutorial.path} className="col-lg-4 col-md-6 mb-5">
+            {tutorial.github ? (
+              <ContributionCard tutorial={tutorial} translate={translate} />
+            ) : (
+              <TutorialCard
+                tutorial={tutorial}
+                detectedLanguages={tutorialLanguages[tutorial.path]}
+                showFooter={showFooter}
+                translate={translate}
+              />
+            )}
+          </div>
+        ))}
+      </div>
+      {hasMore && (
+        <div className="explore-more-wrapper">
+          <button
+            className="explore-more-link"
+            onClick={handleToggle}
+          >
+            {expanded ? translate("Show less") : translate("Explore more")} {expanded ? "↑" : "→"}
+          </button>
+        </div>
+      )}
+    </section>
+  )
+}
+
+// Copyable URL component with click-to-copy functionality
+function CopyableUrl({ url, translate }: { url: string; translate: (text: string) => string }) {
+  const [copied, setCopied] = useState(false)
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(url)
+      setCopied(true)
+      setTimeout(() => setCopied(false), 2000)
+    } catch (err) {
+      console.error("Failed to copy:", err)
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      className={`quick-ref-value-btn ${copied ? "copied" : ""}`}
+      onClick={handleCopy}
+      title={copied ? translate("Copied!") : translate("Click to copy")}
+    >
+      <code className="quick-ref-value">{url}</code>
+      <span className="copy-icon">{copied ? "✓" : ""}</span>
+    </button>
+  )
+}
+
+// Quick reference card showing public server URLs and faucet link
+function QuickReferenceCard({ translate }: { translate: (text: string) => string }) {
+  return (
+    <div className="quick-ref-card">
+      <div className="quick-ref-section">
+        <span className="quick-ref-label">{translate("PUBLIC SERVERS")}</span>
+        <div className="quick-ref-group">
+          <span className="quick-ref-key"><strong>{translate("Mainnet")}</strong></span>
+          <div className="quick-ref-urls">
+            <span className="quick-ref-protocol">{translate("WebSocket")}</span>
+            <CopyableUrl url="wss://xrplcluster.com" translate={translate} />
+            <span className="quick-ref-protocol">{translate("JSON-RPC")}</span>
+            <CopyableUrl url="https://xrplcluster.com" translate={translate} />
+          </div>
+        </div>
+        <div className="quick-ref-group">
+          <span className="quick-ref-key"><strong>{translate("Testnet")}</strong></span>
+          <div className="quick-ref-urls">
+            <span className="quick-ref-protocol">{translate("WebSocket")}</span>
+            <CopyableUrl url="wss://s.altnet.rippletest.net:51233" translate={translate} />
+            <span className="quick-ref-protocol">{translate("JSON-RPC")}</span>
+            <CopyableUrl url="https://s.altnet.rippletest.net:51234" translate={translate} />
+          </div>
+        </div>
+        <Link to="/docs/tutorials/public-servers/" className="quick-ref-link">
+          {translate("View all servers")} →
+        </Link>
+      </div>
+      <div className="quick-ref-divider"></div>
+      <div className="quick-ref-section">
+        <Link to="/resources/dev-tools/xrp-faucets/" className="quick-ref-faucet">
+          <span>{translate("Get Test XRP")}</span>
+          <span className="quick-ref-arrow">→</span>
+        </Link>
+      </div>
+    </div>
+  )
+}
+
+// ── Page Component ──────────────────────────────────────────────────────────
+
 export default function TutorialsIndex() {
   const { useTranslate, usePageSharedData } = useThemeHooks()
   const { translate } = useTranslate()
@@ -299,65 +399,160 @@ export default function TutorialsIndex() {
   // Get auto-detected languages from the plugin (maps tutorial paths to language arrays).
   const tutorialLanguages = usePageSharedData<TutorialLanguagesMap>("tutorial-languages") || {}
 
+  // Get tutorial metadata and sidebar categories from the tutorial-metadata plugin.
+  const tutorialMetadata = usePageSharedData<{
+    tutorials: TutorialMetadataItem[]
+    categories: { id: string; title: string }[]
+  }>("tutorial-metadata")
+  const allTutorials = tutorialMetadata?.tutorials || []
+  const sidebarCategories = tutorialMetadata?.categories || []
+
+  // What's New: most recently modified tutorials, excluding Get Started.
+  const whatsNewConfig = sectionConfig["whats-new"]!
+  const getStartedPaths = new Set(
+    (sectionConfig["get-started"]?.pinned || []).map(getPinnedPath)
+  )
+  const whatsNewTutorials: Tutorial[] = allTutorials
+    .filter((tutorial) => !getStartedPaths.has(tutorial.path))
+    .slice(0, MAX_WHATS_NEW)
+    .map((tutorial) => toTutorial(tutorial))
+
+  // Category sections (including Get Started): ordered by sectionConfig, then any new sidebar categories.
+  const sections = buildCategorySections(sidebarCategories, allTutorials)
+
   return (
     <main className="landing page-tutorials landing-builtin-bg">
-      <section className="container-new py-26">
-        <div className="col-lg-8 mx-auto text-lg-center">
-          <div className="d-flex flex-column-reverse">
-            <h1 className="mb-0">
-              {translate("Crypto Wallet and Blockchain Development Tutorials")}
-            </h1>
-            <h6 className="eyebrow mb-3">{translate("Tutorials")}</h6>
-          </div>
-          {/* Table of Contents */}
-          <nav className="mt-4">
-            <ul className="page-toc no-sideline d-flex flex-wrap justify-content-center gap-2 mb-0">
-              <li><a href="#get-started">{translate("Get Started with SDKs")}</a></li>
-              {sections.map((section) => (
-                <li key={section.id}><a href={`#${section.id}`}>{translate(section.title)}</a></li>
-              ))}
-            </ul>
-          </nav>
-        </div>
-      </section>
-
-      {/* Get Started */}
-      <section className="container-new pt-10 pb-20" id="get-started">
-        <div className="col-12 col-xl-8 p-0">
-          <h3 className="h4 mb-3">{translate("Get Started with SDKs")}</h3>
-          <p className="mb-4">
-            {translate("These tutorials walk you through the basics of building a very simple XRP Ledger-connected application using your favorite programming language.")}
-          </p>
-        </div>
-        <div className="row tutorial-cards">
-          {getStartedTutorials.map((tutorial, idx) => (
-            <div key={idx} className="col-lg-4 col-md-6 mb-5">
-              <TutorialCard tutorial={tutorial} showFooter translate={translate} />
+      {/* Hero Section */}
+      <section className="container-new py-20">
+        <div className="row align-items-center">
+          <div className="col-lg-7">
+            <div className="d-flex flex-column-reverse">
+              <h1 className="mb-0">
+                {translate("Crypto Wallet and Blockchain Development Tutorials")}
+              </h1>
+              <h6 className="eyebrow mb-3">{translate("Tutorials")}</h6>
             </div>
-          ))}
+            <nav className="mt-4">
+              <ul className="page-toc no-sideline d-flex flex-wrap gap-2 mb-0">
+                {whatsNewTutorials.length > 0 && (
+                  <li><Link to="#whats-new">{translate(whatsNewConfig.title)}</Link></li>
+                )}
+                {sections.map((section) => (
+                  <li key={section.id}><Link to={`#${section.id}`}>{translate(section.title)}</Link></li>
+                ))}
+              </ul>
+            </nav>
+          </div>
+          <div className="col-lg-5 mt-6 mt-lg-0">
+            <QuickReferenceCard translate={translate} />
+          </div>
         </div>
       </section>
 
-      {/* Other Tutorials */}
+      {/* What's New */}
+      {whatsNewTutorials.length > 0 && (
+        <TutorialSectionBlock
+          id="whats-new"
+          title={whatsNewConfig.title!}
+          description={whatsNewConfig.description!}
+          tutorials={whatsNewTutorials}
+          tutorialLanguages={tutorialLanguages}
+          showFooter
+          className="whats-new-section pb-20"
+          translate={translate}
+        />
+      )}
+
+      {/* Tutorial Sections */}
       {sections.map((section) => (
-        <section className="container-new pt-10 pb-10" key={section.id} id={section.id}>
-          <div className="col-12 col-xl-8 p-0">
-            <h3 className="h4 mb-3">{translate(section.title)}</h3>
-            <p className="mb-4">{translate(section.description)}</p>
-          </div>
-          <div className="row tutorial-cards">
-            {section.tutorials.slice(0, 6).map((tutorial, idx) => (
-              <div key={idx} className="col-lg-4 col-md-6 mb-5">
-                <TutorialCard
-                  tutorial={tutorial}
-                  detectedLanguages={tutorialLanguages[tutorial.path]}
-                  translate={translate}
-                />
-              </div>
-            ))}
-          </div>
-        </section>
+        <TutorialSectionBlock
+          key={section.id}
+          id={section.id}
+          title={section.title}
+          description={section.description}
+          tutorials={section.tutorials}
+          tutorialLanguages={tutorialLanguages}
+          maxTutorials={section.showFooter ? undefined : MAX_TUTORIALS_PER_SECTION}
+          showFooter={section.showFooter}
+          className={section.showFooter ? "pb-20" : "category-section"}
+          translate={translate}
+        />
       ))}
     </main>
   )
 }
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+/** Type guard for external community contributions */
+function isExternalContribution(entry: PinnedTutorial): entry is PinnedExternalTutorial {
+  return typeof entry !== "string" && "github" in entry
+}
+
+/** Get path from pinned tutorial entry*/
+function getPinnedPath(entry: PinnedTutorial): string {
+  return typeof entry === "string" ? entry : isExternalContribution(entry) ? entry.github : entry.path
+}
+
+/** Convert tutorial metadata to the common Tutorial type */
+function toTutorial(t: TutorialMetadataItem, descriptionOverride?: string): Tutorial {
+  return {
+    title: t.title,
+    description: descriptionOverride || t.description,
+    path: t.path,
+  }
+}
+
+/** Build Tutorial objects from pinned entries, resolving metadata for internal paths */
+function buildPinnedTutorials(entries: PinnedTutorial[], allTutorials: TutorialMetadataItem[]): Tutorial[] {
+  return entries
+    .map((entry): Tutorial | null => {
+      if (isExternalContribution(entry)) {
+        return {
+          title: entry.title,
+          description: entry.description,
+          path: entry.url || entry.github,
+          author: entry.author,
+          github: entry.github,
+          externalUrl: entry.url,
+        }
+      }
+      const path = getPinnedPath(entry)
+      const descOverride = typeof entry === "string" ? undefined : entry.description
+      const metadata = allTutorials.find((t) => t.path === path)
+      return metadata ? toTutorial(metadata, descOverride) : null
+    })
+    .filter((t): t is Tutorial => t !== null)
+}
+
+/** Build category sections ordered by sectionConfig, with new sidebar categories appended */
+function buildCategorySections(
+  sidebarCategories: { id: string; title: string }[],
+  allTutorials: TutorialMetadataItem[],
+): TutorialSection[] {
+  const specialIds = new Set(["whats-new"])
+  const sidebarMap = new Map(sidebarCategories.map((category) => [category.id, category]))
+  const allPinnedPaths = new Set(
+    Object.values(sectionConfig).flatMap((config) => (config.pinned || []).map(getPinnedPath))
+  )
+
+  // Sections follow sectionConfig key order. New sidebar categories not in sectionConfig are appended at the end.
+  const configIds = Object.keys(sectionConfig).filter((id) => !specialIds.has(id))
+  const newIds = sidebarCategories
+    .filter((category) => !specialIds.has(category.id) && !sectionConfig[category.id])
+    .map((category) => category.id)
+
+  return [...configIds, ...newIds]
+    .filter((id) => sidebarMap.has(id))
+    .map((id) => {
+      const config = sectionConfig[id]
+      const title = config?.title || sidebarMap.get(id)!.title
+      const description = config?.description || ""
+      const pinned = buildPinnedTutorials(config?.pinned || [], allTutorials)
+      const remaining = allTutorials
+        .filter((t) => t.category === id && !allPinnedPaths.has(t.path))
+        .map((t) => toTutorial(t))
+      return { id, title, description, tutorials: [...pinned, ...remaining], showFooter: config?.showFooter }
+    })
+    .filter((section) => section.tutorials.length > 0)
+}

docs/use-cases/defi/algorithmic-trading.md

@@ -89,7 +89,7 @@ To give yourself as much time as possible to react to profit-taking opportunitie
 The XRP Ledger natively supports Automated Market Makers (AMMs) that work alongside the existing central limit order based (CLOB) decentralized exchange. AMMs are an important factor in trading on the XRP Ledger. You can read more at the following links:
 
 - [Automated Market Makers](../../concepts/tokens/decentralized-exchange/automated-market-makers.md)
-- [Use the AMM Auction Slot for Lower Fees](/docs/tutorials/defi/dex/trade-with-auction-slot-in-javascript.md)
+- [Use the AMM Auction Slot for Lower Fees](/docs/tutorials/defi/dex/use-amm-auction-slot-for-lower-fees.md)
 - [XLS-30 Specification](https://github.com/XRPLF/XRPL-Standards/tree/master/XLS-0030-automated-market-maker#readme)
 
 ## Further Reading

package-lock.json

@@ -12,12 +12,11 @@
         "@codemirror/state": "^6.6.0",
         "@codemirror/view": "^6.22.2",
         "@lezer/highlight": "^1.2.0",
-        "@redocly/realm": "0.131.2",
+        "@redocly/realm": "0.132.0",
         "@uiw/codemirror-themes": "4.21.21",
         "@uiw/react-codemirror": "^4.21.21",
         "@xrplf/isomorphic": "^1.0.0-beta.1",
         "clsx": "^2.0.0",
-        "five-bells-condition": "^5.0.1",
         "lottie-react": "^2.4.0",
         "moment": "^2.29.4",
         "moment-timezone": "^0.6.0",
@@ -34,6 +33,22 @@
         "sass": "1.26.10"
       }
     },
+    "node_modules/@ai-sdk/anthropic": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/anthropic/-/anthropic-3.0.1.tgz",
+      "integrity": "sha512-MOiwKs76ilEmau/WRMnGWlheTUoB+cbvXCse+SAtpW5ATLreInsuYlspLABn12Dxu3w1Xzke1dT+tmEnxhy9SA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.0",
+        "@ai-sdk/provider-utils": "4.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
     "node_modules/@ai-sdk/gateway": {
       "version": "3.0.63",
       "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-3.0.63.tgz",
@@ -96,6 +111,22 @@
         "zod": "^3.25.76 || ^4.1.8"
       }
     },
+    "node_modules/@ai-sdk/openai": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/openai/-/openai-3.0.1.tgz",
+      "integrity": "sha512-P+qxz2diOrh8OrpqLRg+E+XIFVIKM3z2kFjABcCJGHjGbXBK88AJqmuKAi87qLTvTe/xn1fhZBjklZg9bTyigw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.0",
+        "@ai-sdk/provider-utils": "4.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
     "node_modules/@ai-sdk/provider": {
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.0.tgz",
@@ -125,6 +156,88 @@
         "zod": "^3.25.76 || ^4.1.8"
       }
     },
+    "node_modules/@ai-sdk/react": {
+      "version": "3.0.118",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/react/-/react-3.0.118.tgz",
+      "integrity": "sha512-fBAix8Jftxse6/2YJnOFkwW1/O6EQK4DK68M9DlFmZGAzBmsaHXEPVS77sVIlkaOWCy11bE7434NAVXRY+3OsQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider-utils": "4.0.19",
+        "ai": "6.0.116",
+        "swr": "^2.2.5",
+        "throttleit": "2.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "react": "^18 || ~19.0.1 || ~19.1.2 || ^19.2.1"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/@ai-sdk/gateway": {
+      "version": "3.0.66",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-3.0.66.tgz",
+      "integrity": "sha512-SIQ0YY0iMuv+07HLsZ+bB990zUJ6S4ujORAh+Jv1V2KGNn73qQKnGO0JBk+w+Res8YqOFSycwDoWcFlQrVxS4A==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.19",
+        "@vercel/oidc": "3.1.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/@ai-sdk/provider": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.8.tgz",
+      "integrity": "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.19",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.19.tgz",
+      "integrity": "sha512-3eG55CrSWCu2SXlqq2QCsFjo3+E7+Gmg7i/oRVoSZzIodTuDSfLb3MRje67xE9RFea73Zao7Lm4mADIfUETKGg==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.8",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.6"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/react/node_modules/ai": {
+      "version": "6.0.116",
+      "resolved": "https://registry.npmjs.org/ai/-/ai-6.0.116.tgz",
+      "integrity": "sha512-7yM+cTmyRLeNIXwt4Vj+mrrJgVQ9RMIW5WO0ydoLoYkewIvsMcvUmqS4j2RJTUXaF1HphwmSKUMQ/HypNRGOmA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/gateway": "3.0.66",
+        "@ai-sdk/provider": "3.0.8",
+        "@ai-sdk/provider-utils": "4.0.19",
+        "@opentelemetry/api": "1.9.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
     "node_modules/@ampproject/remapping": {
       "version": "2.3.0",
       "resolved": "https://registry.npmjs.org/@ampproject/remapping/-/remapping-2.3.0.tgz",
@@ -2138,15 +2251,16 @@
       }
     },
     "node_modules/@redocly/asyncapi-docs": {
-      "version": "1.8.1",
-      "resolved": "https://registry.npmjs.org/@redocly/asyncapi-docs/-/asyncapi-docs-1.8.1.tgz",
-      "integrity": "sha512-bdGauPRUbkXBFYH8HpUaeBMG3gwR0yDF5ZH3VbHxtEe542WOBVhO79QxQEs4PnErc6sCPxje9nynxKtM/NUWrQ==",
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/@redocly/asyncapi-docs/-/asyncapi-docs-1.9.0.tgz",
+      "integrity": "sha512-/OaVifMuRp5WvxBbGU1SG/a5Sg11Glv7LlsL4bBrqQrQoSWgzYKCKfYpCXWhZF6gTMqi6ic1z6eQgCgXwQxsvA==",
       "license": "SEE LICENSE IN LICENSE",
       "dependencies": {
         "@markdoc/markdoc": "0.5.2",
-        "@redocly/config": "0.44.1",
-        "@redocly/openapi-docs": "3.19.1",
-        "@redocly/theme": "0.63.0",
+        "@redocly/config": "0.48.0",
+        "@redocly/openapi-docs": "3.20.0",
+        "@redocly/redoc-opentelemetry": "0.0.8",
+        "@redocly/theme": "0.64.0",
         "jotai": "^2.11.1",
         "openapi-sampler": "^1.7.2",
         "react-router-dom": "^6.30.3",
@@ -2158,27 +2272,29 @@
       }
     },
     "node_modules/@redocly/config": {
-      "version": "0.44.1",
-      "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.44.1.tgz",
-      "integrity": "sha512-l6/ZE+/RBfNDdhzltau6cbW8+k5PgJbJBMqaBrlQlZQlmGBHMxqGyDaon4dPLj0jdi37gsMQ3yf95JBY/vaDSg==",
+      "version": "0.48.0",
+      "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.48.0.tgz",
+      "integrity": "sha512-8W3wz+Q7y4e9klJWlYOvQWK5r7P2Mo589vcjtlT5coOxsyAdt53k8Vb8iAqnRiGWExbjBQmSbL2XbuU747Nf6Q==",
       "license": "MIT",
       "dependencies": {
         "json-schema-to-ts": "2.7.2"
       }
     },
     "node_modules/@redocly/graphql-docs": {
-      "version": "1.8.0",
-      "resolved": "https://registry.npmjs.org/@redocly/graphql-docs/-/graphql-docs-1.8.0.tgz",
-      "integrity": "sha512-5bMdd1g9HXe1STlcAJxj0Dvgv+Vxe4A0awho4zd77TTD1YMNOt4D7jOrRyP2fW+5GFZm8y3Am9Oj9I3fZ8v2rw==",
+      "version": "1.9.0",
+      "resolved": "https://registry.npmjs.org/@redocly/graphql-docs/-/graphql-docs-1.9.0.tgz",
+      "integrity": "sha512-HtXFUAdg0tC0UqyB8SZIRz0SlcrCMluq6J1TKnFDFe1YKqRLHZzPhLdgIkadHQaDm15sLehVh36P9fzVl9VPIQ==",
       "license": "SEE LICENSE IN LICENSE",
       "dependencies": {
-        "@redocly/config": "0.44.1",
+        "@redocly/config": "0.48.0",
+        "@redocly/openapi-docs": "3.20.0",
+        "@redocly/redoc-opentelemetry": "0.0.8",
         "deepmerge": "^4.2.2",
         "marked": "^4.0.15",
         "web-vitals": "3.3.1"
       },
       "peerDependencies": {
-        "@redocly/theme": "0.63.0",
+        "@redocly/theme": "0.64.0",
         "graphql": "16.12.0",
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
@@ -2187,9 +2303,9 @@
       }
     },
     "node_modules/@redocly/hookstate-core": {
-      "version": "4.2.1",
-      "resolved": "https://registry.npmjs.org/@redocly/hookstate-core/-/hookstate-core-4.2.1.tgz",
-      "integrity": "sha512-9AuP8i8APXgKVimZ8ZxUkPeRQsntIon3Bp+evSriXZU2HgDY6EzOFeIlFcI1ngcpXd5Wgi3GrQ7SGzS/qhNL4g==",
+      "version": "4.2.2",
+      "resolved": "https://registry.npmjs.org/@redocly/hookstate-core/-/hookstate-core-4.2.2.tgz",
+      "integrity": "sha512-9oCdxieKqq/EjYGsFJmq6ot+PuDN/bvcskFYF6huBbDf46QRbTyUpCNalcypJQgjZwxI0Uuc08OpkQECpn4N0A==",
       "license": "MIT",
       "peerDependencies": {
         "react": "^16.8.6 || ^17.0.0 || ^18.0.0 || ^19.0.0"
@@ -2240,16 +2356,16 @@
       }
     },
     "node_modules/@redocly/mock-server": {
-      "version": "0.5.15",
-      "resolved": "https://registry.npmjs.org/@redocly/mock-server/-/mock-server-0.5.15.tgz",
-      "integrity": "sha512-LTnzwB9qLkjmvXFuowMiRbwnwRmTbSMpH25d606o9qcbwS+X7CkZE/Ffu5O8nhZLubYcgxmfQNfnaD/WszusEw==",
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/@redocly/mock-server/-/mock-server-0.6.0.tgz",
+      "integrity": "sha512-HgaQgIWjc/P2GIyGveq05AoErqDAmWQFd1HgUuu3A3ZDtyQ4GXWaDBvBMmnsf8YU+d3arL1SepI0jEURmgI+7w==",
       "license": "SEE LICENSE IN LICENSE",
       "dependencies": {
         "@redocly/ajv": "8.18.0",
-        "@redocly/openapi-core": "2.20.5",
+        "@redocly/openapi-core": "2.25.2",
         "ajv": "8.18.0",
         "ajv-formats": "^3.0.1",
-        "fast-xml-parser": "5.4.1",
+        "fast-xml-parser": "5.5.9",
         "js-yaml": "4.1.1",
         "openapi-sampler": "^1.7.2",
         "punycode": "2.3.0",
@@ -2259,19 +2375,19 @@
       }
     },
     "node_modules/@redocly/openapi-core": {
-      "version": "2.20.5",
-      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.20.5.tgz",
-      "integrity": "sha512-BqYq+QCo9V/fqDxYJtgkPfJBZ8alwbqGg+F+LZz12vylsQlua07D9uEOR8n3jj7U8YaP9aA6YFljnQvoi1AZpA==",
+      "version": "2.25.2",
+      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.25.2.tgz",
+      "integrity": "sha512-HIvxgwxQct/IdRJjjqu4g8BLpCik6I3zxp8JFJpRtmY1TSIZAOZjJwlkoh4uQcy/nCP+psSMgQvzjVGml3k6+w==",
       "license": "MIT",
       "dependencies": {
         "@redocly/ajv": "^8.18.0",
-        "@redocly/config": "^0.44.1",
+        "@redocly/config": "^0.45.0",
         "ajv": "npm:@redocly/ajv@8.18.0",
         "ajv-formats": "^3.0.1",
         "colorette": "^1.2.0",
         "js-levenshtein": "^1.1.6",
         "js-yaml": "^4.1.0",
-        "picomatch": "^4.0.3",
+        "picomatch": "^4.0.4",
         "pluralize": "^8.0.0",
         "yaml-ast-parser": "0.0.43"
       },
@@ -2280,6 +2396,15 @@
         "npm": ">=10"
       }
     },
+    "node_modules/@redocly/openapi-core/node_modules/@redocly/config": {
+      "version": "0.45.0",
+      "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.45.0.tgz",
+      "integrity": "sha512-V+wNusPQUaYV1c5s9iptfKQ2Ggno4bMeiyXdNILxqZS87gttwPfqlqHKHKFyz006voS3JsR295cbpx3GlsIxKg==",
+      "license": "MIT",
+      "dependencies": {
+        "json-schema-to-ts": "2.7.2"
+      }
+    },
     "node_modules/@redocly/openapi-core/node_modules/colorette": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/colorette/-/colorette-1.4.0.tgz",
@@ -2299,19 +2424,20 @@
       }
     },
     "node_modules/@redocly/openapi-docs": {
-      "version": "3.19.1",
-      "resolved": "https://registry.npmjs.org/@redocly/openapi-docs/-/openapi-docs-3.19.1.tgz",
-      "integrity": "sha512-fGOH1292T8D1FkrOasVNqgFevnCDjDoS1dcSNt+fCwkh7+2/hCh8hF9EdIt3J0rqWoKqos1DQw1RKHGseo/dMQ==",
+      "version": "3.20.0",
+      "resolved": "https://registry.npmjs.org/@redocly/openapi-docs/-/openapi-docs-3.20.0.tgz",
+      "integrity": "sha512-24OiElFLVlJJ7kTOJjm2CUGJ8Jxiozd63ugGUNAro4pUTRbu0ajc1NvMSF4phWtN9FGBUv+rDlate0yZeZYr8g==",
       "license": "SEE LICENSE IN LICENSE.md",
       "dependencies": {
         "@markdoc/markdoc": "0.5.2",
-        "@redocly/config": "0.44.1",
-        "@redocly/openapi-core": "2.20.5",
-        "@redocly/replay": "0.22.0",
+        "@redocly/config": "0.48.0",
+        "@redocly/openapi-core": "2.25.2",
+        "@redocly/redoc-opentelemetry": "0.0.8",
+        "@redocly/replay": "0.23.0",
         "deepmerge": "^4.2.2",
         "dompurify": "3.3.3",
         "fast-deep-equal": "^3.1.3",
-        "fast-xml-parser": "5.4.1",
+        "fast-xml-parser": "5.5.9",
         "jotai": "^2.12.5",
         "jotai-family": "1.0.1",
         "json-pointer": "^0.6.2",
@@ -2330,16 +2456,16 @@
         "npm": ">=10.0.0"
       },
       "peerDependencies": {
-        "@redocly/theme": ">=0.63.0-next.0",
+        "@redocly/theme": ">=0.64.0-next.0",
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
         "styled-components": "^4.1.1 || ^5.3.11 || ^6.0.0"
       }
     },
     "node_modules/@redocly/portal-legacy-ui": {
-      "version": "0.14.0",
-      "resolved": "https://registry.npmjs.org/@redocly/portal-legacy-ui/-/portal-legacy-ui-0.14.0.tgz",
-      "integrity": "sha512-jZTfLlthkOsyc9nJsaNqUdmAXYLgK7zmsxNpRnwCgcw/Jfkwds844ILyutiM9u066zvPhQTzzp0QJcmL/o6iPA==",
+      "version": "0.15.0",
+      "resolved": "https://registry.npmjs.org/@redocly/portal-legacy-ui/-/portal-legacy-ui-0.15.0.tgz",
+      "integrity": "sha512-RIICW25YLwV5uiZtU2fmd0Ryakf7JAZmTkVh+dNjE6YF07b3t4IOCioHP+hAS+99bpMpL6Utzw0dY0ghduwQxg==",
       "license": "SEE LICENSE IN LICENSE",
       "peerDependencies": {
         "highlight-words-core": "^1.2.2",
@@ -2350,20 +2476,20 @@
       }
     },
     "node_modules/@redocly/portal-plugin-mock-server": {
-      "version": "0.16.1",
-      "resolved": "https://registry.npmjs.org/@redocly/portal-plugin-mock-server/-/portal-plugin-mock-server-0.16.1.tgz",
-      "integrity": "sha512-aDLqVrSuJtTBxtN6arD/WfuV9RZNvS/m9ZeOnkM/xoOOLWkPAFeGNDY073UYvu8haRaOt+lGdlyKoSY46Ja6PQ==",
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/@redocly/portal-plugin-mock-server/-/portal-plugin-mock-server-0.17.0.tgz",
+      "integrity": "sha512-4vp+Xc4VuqH4iVy39cm9rZRnfnY3lQwpUio7iP7PCmUBqdCnluDwMLtU9ix21LSj1HrnVNQERSNRCDNM6Jf23Q==",
       "license": "SEE LICENSE IN LICENSE",
       "dependencies": {
-        "@redocly/config": "0.44.1",
-        "@redocly/mock-server": "0.5.15",
-        "@redocly/openapi-docs": "3.19.1"
+        "@redocly/config": "0.48.0",
+        "@redocly/mock-server": "0.6.0",
+        "@redocly/openapi-docs": "3.20.0"
       }
     },
     "node_modules/@redocly/realm": {
-      "version": "0.131.2",
-      "resolved": "https://registry.npmjs.org/@redocly/realm/-/realm-0.131.2.tgz",
-      "integrity": "sha512-ig0I+UGQvW1wc1uFCEyJ+sKlleXfZxcDqpaqkYpbJ2wX8g54UGllyrkQSblpdAxUCFy3Y5LB1YLJ6259gltELg==",
+      "version": "0.132.0",
+      "resolved": "https://registry.npmjs.org/@redocly/realm/-/realm-0.132.0.tgz",
+      "integrity": "sha512-bSI0HS13c927GOCIQxQZ1emOIujKUkrd5+gBHQ3kKvre75qQw8nkhBWVou+jfyuDrd06DIIenfgKAL/Per9hTw==",
       "license": "SEE LICENSE IN LICENSE",
       "dependencies": {
         "@babel/core": "7.23.5",
@@ -2381,22 +2507,22 @@
         "@opentelemetry/sdk-trace-web": "2.0.1",
         "@opentelemetry/semantic-conventions": "1.34.0",
         "@redocly/ajv": "8.18.0",
-        "@redocly/asyncapi-docs": "1.8.1",
-        "@redocly/config": "0.44.1",
-        "@redocly/graphql-docs": "1.8.0",
+        "@redocly/asyncapi-docs": "1.9.0",
+        "@redocly/config": "0.48.0",
+        "@redocly/graphql-docs": "1.9.0",
         "@redocly/mcp-typescript-sdk": "1.18.1",
-        "@redocly/openapi-core": "2.20.5",
-        "@redocly/openapi-docs": "3.19.1",
-        "@redocly/portal-legacy-ui": "0.14.0",
-        "@redocly/portal-plugin-mock-server": "0.16.1",
-        "@redocly/realm-asyncapi-sdk": "0.9.0",
-        "@redocly/theme": "0.63.0",
+        "@redocly/openapi-core": "2.25.2",
+        "@redocly/openapi-docs": "3.20.0",
+        "@redocly/portal-legacy-ui": "0.15.0",
+        "@redocly/portal-plugin-mock-server": "0.17.0",
+        "@redocly/realm-asyncapi-sdk": "0.10.0",
+        "@redocly/theme": "0.64.0",
         "@shikijs/transformers": "3.21.0",
         "@tanstack/react-query": "5.62.3",
         "@tanstack/react-table": "8.21.3",
         "@tanstack/react-virtual": "3.13.0",
         "@wojtekmaj/react-datetimerange-picker": "6.0.0",
-        "@xmldom/xmldom": "0.8.10",
+        "@xmldom/xmldom": "0.9.9",
         "ajv-formats": "^3.0.1",
         "anser": "^2.3.2",
         "babel-plugin-styled-components": "2.1.4",
@@ -2422,12 +2548,11 @@
         "minimatch": "10.2.4",
         "mri": "1.2.0",
         "nanoid": "5.0.9",
-        "node-fetch": "3.3.1",
         "nprogress": "0.2.0",
         "openapi-sampler": "^1.7.2",
         "os-browserify": "0.3.0",
         "path-browserify": "1.0.1",
-        "picomatch": "2.3.1",
+        "picomatch": "2.3.2",
         "react": "^19.2.4",
         "react-calendar": "5.1.0",
         "react-date-picker": "11.0.0",
@@ -2465,36 +2590,36 @@
       }
     },
     "node_modules/@redocly/realm-asyncapi-sdk": {
-      "version": "0.9.0",
-      "resolved": "https://registry.npmjs.org/@redocly/realm-asyncapi-sdk/-/realm-asyncapi-sdk-0.9.0.tgz",
-      "integrity": "sha512-uIgSHxLvtjsLoSyKI4VjvFsb+BchCi+VwY9kir6tgqKwnegQu7GpG8vLlvKk1QdLM9i5aVB00o+4CFLbEESPaA==",
+      "version": "0.10.0",
+      "resolved": "https://registry.npmjs.org/@redocly/realm-asyncapi-sdk/-/realm-asyncapi-sdk-0.10.0.tgz",
+      "integrity": "sha512-nVg0XHEKjzyHrV61zQGVuqljQVeB2La1RCDCqE6g8CqWUf+rFcTfnY7tQg7eNBMy2dND7Z5mcDh59D/KZ/sZug==",
       "license": "SEE LICENSE IN LICENSE"
     },
-    "node_modules/@redocly/realm/node_modules/node-fetch": {
-      "version": "3.3.1",
-      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-3.3.1.tgz",
-      "integrity": "sha512-cRVc/kyto/7E5shrWca1Wsea4y6tL9iYJE5FBCius3JQfb/4P4I295PfhgbJQBLTx6lATE4z+wK0rPM4VS2uow==",
+    "node_modules/@redocly/realm/node_modules/@xmldom/xmldom": {
+      "version": "0.9.9",
+      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.9.9.tgz",
+      "integrity": "sha512-qycIHAucxy/LXAYIjmLmtQ8q9GPnMbnjG1KXhWm9o5sCr6pOYDATkMPiTNa6/v8eELyqOQ2FsEqeoFYmgv/gJg==",
       "license": "MIT",
-      "dependencies": {
-        "data-uri-to-buffer": "^4.0.0",
-        "fetch-blob": "^3.1.4",
-        "formdata-polyfill": "^4.0.10"
-      },
       "engines": {
-        "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
-      },
-      "funding": {
-        "type": "opencollective",
-        "url": "https://opencollective.com/node-fetch"
+        "node": ">=14.6"
       }
     },
+    "node_modules/@redocly/redoc-opentelemetry": {
+      "version": "0.0.8",
+      "resolved": "https://registry.npmjs.org/@redocly/redoc-opentelemetry/-/redoc-opentelemetry-0.0.8.tgz",
+      "integrity": "sha512-OPFMA7XdGbm8NnXS/WIs1slCF6zb5setA6CnHWJdDrAvdchMFZDuNhpME7fItIxWHD8mIsxZm1aZPoxXR2Mt3g==",
+      "license": "MIT"
+    },
     "node_modules/@redocly/replay": {
-      "version": "0.22.0",
-      "resolved": "https://registry.npmjs.org/@redocly/replay/-/replay-0.22.0.tgz",
-      "integrity": "sha512-hvRHytajOVL/R/VrQD8BP+6YuocYr4PfVQQJ8+GoaLhiRxGYWq640CGh1o1DzGxd3Os7kSG4Tjt+8tSHoB/LUQ==",
+      "version": "0.23.0",
+      "resolved": "https://registry.npmjs.org/@redocly/replay/-/replay-0.23.0.tgz",
+      "integrity": "sha512-PhVluDksYFKhLaQeBq0AWxSilag+cvrGbEM118fYEebs9/Cvwn3cMVyp7nT4jvLF9sFfPevHvrfXFaCgw+VfRA==",
       "dependencies": {
+        "@ai-sdk/anthropic": "3.0.1",
         "@ai-sdk/google": "3.0.1",
+        "@ai-sdk/openai": "3.0.1",
         "@ai-sdk/provider": "3.0.0",
+        "@ai-sdk/react": "3.0.118",
         "@codemirror/autocomplete": "^6.15.0",
         "@codemirror/lang-html": "^6.4.7",
         "@codemirror/lang-java": "^6.0.2",
@@ -2515,10 +2640,10 @@
         "@lezer/highlight": "^1.1.6",
         "@noble/hashes": "^1.8.0",
         "@opentelemetry/api": "1.9.0",
-        "@redocly/hookstate-core": "^4.2.1",
+        "@redocly/hookstate-core": "4.2.2",
         "@redocly/hookstate-devtools": "^4.2.0",
-        "@redocly/openapi-core": "2.20.5",
-        "@redocly/respect-core": "2.20.5",
+        "@redocly/openapi-core": "2.25.2",
+        "@redocly/respect-core": "2.25.2",
         "@redocly/vscode-json-languageservice": "^3.4.9",
         "@tauri-apps/api": "2.4.1",
         "@tauri-apps/plugin-dialog": "2.0.0-rc.1",
@@ -2529,7 +2654,7 @@
         "ai": "6.0.111",
         "dayjs": "^1.11.7",
         "drizzle-orm": "^0.36.4",
-        "fast-xml-parser": "5.4.1",
+        "fast-xml-parser": "5.5.9",
         "idb": "^8.0.2",
         "js-yaml": "4.1.1",
         "json-pointer": "^0.6.2",
@@ -2542,11 +2667,12 @@
         "react-resizable-panels": "^3.0.6",
         "react-select": "5.10.1",
         "shellwords": "^1.1.1",
+        "ulid": "^2.3.0",
         "usehooks-ts": "^3.1.1",
         "zod": "^3.25.76"
       },
       "peerDependencies": {
-        "@redocly/theme": "0.63.0",
+        "@redocly/theme": "0.64.0",
         "@tanstack/react-query": "5.62.3",
         "react": "^19.2.4",
         "react-dom": "^19.2.4",
@@ -2680,15 +2806,15 @@
       }
     },
     "node_modules/@redocly/respect-core": {
-      "version": "2.20.5",
-      "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.20.5.tgz",
-      "integrity": "sha512-4mN1fNDKXObLuUp57FW4oZg2dLx6x9pNrBQNQMfsts3R8Ov6zFWHNekIxtO/BKVnItmN6FSGmQRpOwpkb9PaRg==",
+      "version": "2.25.2",
+      "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.25.2.tgz",
+      "integrity": "sha512-GpvmjY2x8u4pAGNts7slexuKDzDWHNUB4gey9/rSqvC8IaqY49vkvMuRodIBwCsqXhn2rpkJbar1UK3rAOuy7g==",
       "license": "MIT",
       "dependencies": {
         "@faker-js/faker": "^7.6.0",
         "@noble/hashes": "^1.8.0",
         "@redocly/ajv": "^8.18.0",
-        "@redocly/openapi-core": "2.20.5",
+        "@redocly/openapi-core": "2.25.2",
         "ajv": "npm:@redocly/ajv@8.18.0",
         "better-ajv-errors": "^1.2.0",
         "colorette": "^2.0.20",
@@ -2696,7 +2822,7 @@
         "jsonpath-rfc9535": "1.3.0",
         "openapi-sampler": "^1.7.1",
         "outdent": "^0.8.0",
-        "picomatch": "^4.0.3"
+        "picomatch": "^4.0.4"
       },
       "engines": {
         "node": ">=22.12.0 || >=20.19.0 <21.0.0",
@@ -2716,12 +2842,12 @@
       }
     },
     "node_modules/@redocly/theme": {
-      "version": "0.63.0",
-      "resolved": "https://registry.npmjs.org/@redocly/theme/-/theme-0.63.0.tgz",
-      "integrity": "sha512-43ryxhbuVIUBDjMkwNhQ9enCjNPoOSDrnsWr/EZrvH6Da3jCTg66NCe06qjUX7MUqbz7b9nhzlqlV0EnmPEChQ==",
+      "version": "0.64.0",
+      "resolved": "https://registry.npmjs.org/@redocly/theme/-/theme-0.64.0.tgz",
+      "integrity": "sha512-hZx1pqL77Afl2qu1JGp/3XREwmtcfwuEWycndpgjiYWtAjKuZDhWKRQy6sKV9ozkYstihCAXp6ofJcHitrkcng==",
       "license": "MIT",
       "dependencies": {
-        "@redocly/config": "0.44.1",
+        "@redocly/config": "0.48.0",
         "@tanstack/react-query": "5.62.3",
         "@tanstack/react-virtual": "3.13.0",
         "@xyflow/react": "^12.8.2",
@@ -3506,10 +3632,9 @@
       }
     },
     "node_modules/@xmldom/xmldom": {
-      "version": "0.8.10",
-      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.10.tgz",
-      "integrity": "sha512-2WALfTl4xo2SkGCYRt6rDTFfk9R1czmBvUQy12gK2KuRKIpWEhcbbzy8EZXtz/jkRqHX8bFEc6FC1HjX4TUWYw==",
-      "deprecated": "this version has critical issues, please update to the latest version",
+      "version": "0.8.12",
+      "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.12.tgz",
+      "integrity": "sha512-9k/gHF6n/pAi/9tqr3m3aqkuiNosYTurLLUtc7xQ9sxB/wm7WPygCv8GYa6mS0fLJEHhqMC1ATYhz++U/lRHqg==",
       "license": "MIT",
       "engines": {
         "node": ">=10.0.0"
@@ -3749,17 +3874,6 @@
       "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
       "license": "Python-2.0"
     },
-    "node_modules/asn1.js": {
-      "version": "4.10.1",
-      "resolved": "https://registry.npmjs.org/asn1.js/-/asn1.js-4.10.1.tgz",
-      "integrity": "sha512-p32cOF5q0Zqs9uBiONKYLm6BClCoBCM5O9JfeUSlnQLBTxYdTK+pW+nXflm8UkKd2UYlEbYz5qEi0JuZR9ckSw==",
-      "license": "MIT",
-      "dependencies": {
-        "bn.js": "^4.0.0",
-        "inherits": "^2.0.1",
-        "minimalistic-assert": "^1.0.0"
-      }
-    },
     "node_modules/asynckit": {
       "version": "0.4.0",
       "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
@@ -3782,9 +3896,9 @@
       }
     },
     "node_modules/axios": {
-      "version": "1.14.0",
-      "resolved": "https://registry.npmjs.org/axios/-/axios-1.14.0.tgz",
-      "integrity": "sha512-3Y8yrqLSwjuzpXuZ0oIYZ/XGgLwUIBU3uLvbcpb0pidD9ctpShJd43KSlEEkVQg6DS0G9NKyzOvBfUtDKEyHvQ==",
+      "version": "1.15.0",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.15.0.tgz",
+      "integrity": "sha512-wWyJDlAatxk30ZJer+GeCWS209sA42X+N5jU2jy6oHTp7ufw8uzUTVFBX9+wTfAlhiJXGS0Bq7X6efruWjuK9Q==",
       "license": "MIT",
       "dependencies": {
         "follow-redirects": "^1.15.11",
@@ -3833,9 +3947,9 @@
       }
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.13",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.13.tgz",
-      "integrity": "sha512-BL2sTuHOdy0YT1lYieUxTw/QMtPBC3pmlJC6xk8BBYVv6vcw3SGdKemQ+Xsx9ik2F/lYDO9tqsFQH1r9PFuHKw==",
+      "version": "2.10.19",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.19.tgz",
+      "integrity": "sha512-qCkNLi2sfBOn8XhZQ0FXsT1Ki/Yo5P90hrkRamVFRS7/KV9hpfA4HkoWNU152+8w0zPjnxo5psx5NL3PSGgv5g==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -3884,22 +3998,6 @@
         "url": "https://github.com/sponsors/sindresorhus"
       }
     },
-    "node_modules/bindings": {
-      "version": "1.5.0",
-      "resolved": "https://registry.npmjs.org/bindings/-/bindings-1.5.0.tgz",
-      "integrity": "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ==",
-      "license": "MIT",
-      "optional": true,
-      "dependencies": {
-        "file-uri-to-path": "1.0.0"
-      }
-    },
-    "node_modules/bn.js": {
-      "version": "4.12.3",
-      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.3.tgz",
-      "integrity": "sha512-fGTi3gxV/23FTYdAoUtLYp6qySe2KE3teyZitipKNRuVYcBkoP/bB3guXN/XVKUe9mxCHXnc9C4ocyz8OmgN0g==",
-      "license": "MIT"
-    },
     "node_modules/bootstrap": {
       "version": "4.6.2",
       "resolved": "https://registry.npmjs.org/bootstrap/-/bootstrap-4.6.2.tgz",
@@ -3995,14 +4093,14 @@
       }
     },
     "node_modules/call-bind": {
-      "version": "1.0.8",
-      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.8.tgz",
-      "integrity": "sha512-oKlSFMcMwpUg2ednkhQ454wfWiU/ul3CkJe/PEHcTKuiX6RpbehUiFMXu13HalGZxfUwCQzZG747YXBn1im9ww==",
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/call-bind/-/call-bind-1.0.9.tgz",
+      "integrity": "sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ==",
       "license": "MIT",
       "dependencies": {
-        "call-bind-apply-helpers": "^1.0.0",
-        "es-define-property": "^1.0.0",
-        "get-intrinsic": "^1.2.4",
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "get-intrinsic": "^1.3.0",
         "set-function-length": "^1.2.2"
       },
       "engines": {
@@ -4066,9 +4164,9 @@
       }
     },
     "node_modules/caniuse-lite": {
-      "version": "1.0.30001784",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001784.tgz",
-      "integrity": "sha512-WU346nBTklUV9YfUl60fqRbU5ZqyXlqvo1SgigE1OAXK5bFL8LL9q1K7aap3N739l4BvNqnkm3YrGHiY9sfUQw==",
+      "version": "1.0.30001788",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001788.tgz",
+      "integrity": "sha512-6q8HFp+lOQtcf7wBK+uEenxymVWkGKkjFpCvw5W25cmMwEDU45p1xQFBQv8JDlMMry7eNxyBaR+qxgmTUZkIRQ==",
       "funding": [
         {
           "type": "opencollective",
@@ -4807,22 +4905,10 @@
         "node": ">= 0.4"
       }
     },
-    "node_modules/ed25519": {
-      "version": "0.0.4",
-      "resolved": "https://registry.npmjs.org/ed25519/-/ed25519-0.0.4.tgz",
-      "integrity": "sha512-81yyGDHl4hhTD2YY779FRRMMAuKR3IQ2MmPFdwTvLnmZ+O02PgONzVgeyTWCjs/NCNAr35Ccg+hUd1y84Kdkbg==",
-      "hasInstallScript": true,
-      "license": "BSD-2-Clause",
-      "optional": true,
-      "dependencies": {
-        "bindings": "^1.2.1",
-        "nan": "^2.0.9"
-      }
-    },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.331",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.331.tgz",
-      "integrity": "sha512-IbxXrsTlD3hRodkLnbxAPP4OuJYdWCeM3IOdT+CpcMoIwIoDfCmRpEtSPfwBXxVkg9xmBeY7Lz2Eo2TDn/HC3Q==",
+      "version": "1.5.340",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.340.tgz",
+      "integrity": "sha512-908qahOGocRMinT2nM3ajCEM99H4iPdv84eagPP3FfZy/1ZGeOy2CZYzjhms81ckOPCXPlW7LkY4XpxD8r1DrA==",
       "license": "ISC"
     },
     "node_modules/emoji-regex": {
@@ -5003,9 +5089,9 @@
       "license": "MIT"
     },
     "node_modules/eventsource-parser": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.6.tgz",
-      "integrity": "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg==",
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.7.tgz",
+      "integrity": "sha512-zwxwiQqexizSXFZV13zMiEtW1E3lv7RlUv+1f5FBiR4x7wFhEjm3aFTyYkZQWzyN08WnPdox015GoRH5D/E5YA==",
       "license": "MIT",
       "engines": {
         "node": ">=18.0.0"
@@ -5058,9 +5144,9 @@
       "license": "BSD-3-Clause"
     },
     "node_modules/fast-xml-builder": {
-      "version": "1.1.4",
-      "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz",
-      "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==",
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.5.tgz",
+      "integrity": "sha512-4TJn/8FKLeslLAH3dnohXqE3QSoxkhvaMzepOIZytwJXZO69Bfz0HBdDHzOTOon6G59Zrk6VQ2bEiv1t61rfkA==",
       "funding": [
         {
           "type": "github",
@@ -5073,9 +5159,9 @@
       }
     },
     "node_modules/fast-xml-parser": {
-      "version": "5.4.1",
-      "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.4.1.tgz",
-      "integrity": "sha512-BQ30U1mKkvXQXXkAGcuyUA/GA26oEB7NzOtsxCDtyu62sjGw5QraKFhx2Em3WQNjPw9PG6MQ9yuIIgkSDfGu5A==",
+      "version": "5.5.9",
+      "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz",
+      "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==",
       "funding": [
         {
           "type": "github",
@@ -5084,8 +5170,9 @@
       ],
       "license": "MIT",
       "dependencies": {
-        "fast-xml-builder": "^1.0.0",
-        "strnum": "^2.1.2"
+        "fast-xml-builder": "^1.1.4",
+        "path-expression-matcher": "^1.2.0",
+        "strnum": "^2.2.2"
       },
       "bin": {
         "fxparser": "src/cli/cli.js"
@@ -5132,13 +5219,6 @@
       "integrity": "sha512-P9bmyZ3h/PRG+Nzga+rbdI4OEpNDzAVyy74uVO9ATgzLK6VtAsYybF/+TOCvrc0MO793d6+42lLyZTw7/ArVzA==",
       "license": "MIT"
     },
-    "node_modules/file-uri-to-path": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/file-uri-to-path/-/file-uri-to-path-1.0.0.tgz",
-      "integrity": "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw==",
-      "license": "MIT",
-      "optional": true
-    },
     "node_modules/fill-range": {
       "version": "7.1.1",
       "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
@@ -5157,19 +5237,6 @@
       "integrity": "sha512-NKfW6bec6GfKc0SGx1e07QZY9PE99u0Bft/0rzSD5k3sO/vwkVUpDUKVm5Gpp5Ue3YfShPFTX2070tDs5kB9Ng==",
       "license": "MIT"
     },
-    "node_modules/five-bells-condition": {
-      "version": "5.0.1",
-      "resolved": "https://registry.npmjs.org/five-bells-condition/-/five-bells-condition-5.0.1.tgz",
-      "integrity": "sha512-rmVJAyyTBOBIYTWHGQzxCWKlSobwwuOb3adeHrBANddTs4IH5HDkWsbNFjGtx8LlGRPHN2/UoU/f6iA1QlaIow==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "asn1.js": "^4.9.0",
-        "tweetnacl": "^0.14.1"
-      },
-      "optionalDependencies": {
-        "ed25519": "0.0.4"
-      }
-    },
     "node_modules/flexsearch": {
       "version": "0.7.43",
       "resolved": "https://registry.npmjs.org/flexsearch/-/flexsearch-0.7.43.tgz",
@@ -5177,9 +5244,9 @@
       "license": "Apache-2.0"
     },
     "node_modules/follow-redirects": {
-      "version": "1.15.11",
-      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
-      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+      "version": "1.16.0",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.16.0.tgz",
+      "integrity": "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==",
       "funding": [
         {
           "type": "individual",
@@ -5894,9 +5961,9 @@
       "license": "MIT"
     },
     "node_modules/jotai": {
-      "version": "2.19.0",
-      "resolved": "https://registry.npmjs.org/jotai/-/jotai-2.19.0.tgz",
-      "integrity": "sha512-r2wwxEXP1F2JteDLZEOPoIpAHhV89paKsN5GWVYndPNMMP/uVZDcC+fNj0A8NjKgaPWzdyO8Vp8YcYKe0uCEqQ==",
+      "version": "2.19.1",
+      "resolved": "https://registry.npmjs.org/jotai/-/jotai-2.19.1.tgz",
+      "integrity": "sha512-sqm9lVZiqBHZH8aSRk32DSiZDHY3yUIlulXYn9GQj7/LvoUdYXSMti7ZPJGo+6zjzKFt5a25k/I6iBCi43PJcw==",
       "license": "MIT",
       "engines": {
         "node": ">=12.20.0"
@@ -6434,12 +6501,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/minimalistic-assert": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
-      "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
-      "license": "ISC"
-    },
     "node_modules/minimatch": {
       "version": "10.2.4",
       "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz",
@@ -6497,13 +6558,6 @@
       "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
       "license": "MIT"
     },
-    "node_modules/nan": {
-      "version": "2.26.2",
-      "resolved": "https://registry.npmjs.org/nan/-/nan-2.26.2.tgz",
-      "integrity": "sha512-0tTvBTYkt3tdGw22nrAy50x7gpbGCCFH3AFcyS5WiUu7Eu4vWlri1woE6qHBSfy11vksDqkiwjOnlR7WV8G1Hw==",
-      "license": "MIT",
-      "optional": true
-    },
     "node_modules/nanoid": {
       "version": "5.0.9",
       "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-5.0.9.tgz",
@@ -6709,26 +6763,6 @@
         "json-pointer": "0.6.2"
       }
     },
-    "node_modules/openapi-sampler/node_modules/fast-xml-parser": {
-      "version": "5.5.9",
-      "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz",
-      "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==",
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/NaturalIntelligence"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "fast-xml-builder": "^1.1.4",
-        "path-expression-matcher": "^1.2.0",
-        "strnum": "^2.2.2"
-      },
-      "bin": {
-        "fxparser": "src/cli/cli.js"
-      }
-    },
     "node_modules/os-browserify": {
       "version": "0.3.0",
       "resolved": "https://registry.npmjs.org/os-browserify/-/os-browserify-0.3.0.tgz",
@@ -6821,9 +6855,9 @@
       "license": "MIT"
     },
     "node_modules/path-expression-matcher": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz",
-      "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==",
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz",
+      "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==",
       "funding": [
         {
           "type": "github",
@@ -6857,9 +6891,9 @@
       "license": "ISC"
     },
     "node_modules/picomatch": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
-      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "version": "2.3.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
+      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
       "license": "MIT",
       "engines": {
         "node": ">=8.6"
@@ -6945,9 +6979,9 @@
       }
     },
     "node_modules/protobufjs": {
-      "version": "7.5.4",
-      "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz",
-      "integrity": "sha512-CvexbZtbov6jW2eXAvLukXjXUW1TzFaivC46BpWc/3BpcCysb5Vffu+B3XHMm8lVEuy2Mm4XGex8hBSg1yapPg==",
+      "version": "7.5.5",
+      "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz",
+      "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==",
       "hasInstallScript": true,
       "license": "BSD-3-Clause",
       "dependencies": {
@@ -7302,9 +7336,9 @@
       }
     },
     "node_modules/react-is": {
-      "version": "19.2.4",
-      "resolved": "https://registry.npmjs.org/react-is/-/react-is-19.2.4.tgz",
-      "integrity": "sha512-W+EWGn2v0ApPKgKKCy/7s7WHXkboGcsrXE+2joLyVxkbyVQfO3MUEaUQDHoSmb8TFFrSKYa9mw64WZHNHSDzYA==",
+      "version": "19.2.5",
+      "resolved": "https://registry.npmjs.org/react-is/-/react-is-19.2.5.tgz",
+      "integrity": "sha512-Dn0t8IQhCmeIT3wu+Apm1/YVsJXsGWi6k4sPdnBIdqMVtHtv0IGi6dcpNpNkNac0zB2uUAqNX3MHzN8c+z2rwQ==",
       "license": "MIT",
       "peer": true
     },
@@ -8046,9 +8080,9 @@
       }
     },
     "node_modules/strnum": {
-      "version": "2.2.2",
-      "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz",
-      "integrity": "sha512-DnR90I+jtXNSTXWdwrEy9FakW7UX+qUZg28gj5fk2vxxl7uS/3bpI4fjFYVmdK9etptYBPNkpahuQnEwhwECqA==",
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.3.tgz",
+      "integrity": "sha512-oKx6RUCuHfT3oyVjtnrmn19H1SiCqgJSg+54XqURKp5aCMbrXrhLjRN9TjuwMjiYstZ0MzDrHqkGZ5dFTKd+zg==",
       "funding": [
         {
           "type": "github",
@@ -8219,6 +8253,31 @@
         }
       }
     },
+    "node_modules/swr": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/swr/-/swr-2.4.1.tgz",
+      "integrity": "sha512-2CC6CiKQtEwaEeNiqWTAw9PGykW8SR5zZX8MZk6TeAvEAnVS7Visz8WzphqgtQ8v2xz/4Q5K+j+SeMaKXeeQIA==",
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.3",
+        "use-sync-external-store": "^1.6.0"
+      },
+      "peerDependencies": {
+        "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+      }
+    },
+    "node_modules/throttleit": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/throttleit/-/throttleit-2.1.0.tgz",
+      "integrity": "sha512-nt6AMGKW1p/70DF/hGBdJB57B8Tspmbp5gfJ8ilhLnt7kkr2ye7hzD6NVG8GGErk2HWF34igrL2CXmNIkzKqKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
     "node_modules/to-regex-range": {
       "version": "5.0.1",
       "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
@@ -8329,16 +8388,10 @@
       "integrity": "sha512-C3TaO7K81YvjCgQH9Q1S3R3P3BtN3RIM8n+OvX4il1K1zgE8ZhI0op7kClgkxtutIE8hQrcrHBXvIheqKUUCxw==",
       "license": "MIT"
     },
-    "node_modules/tweetnacl": {
-      "version": "0.14.5",
-      "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-0.14.5.tgz",
-      "integrity": "sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA==",
-      "license": "Unlicense"
-    },
     "node_modules/typescript": {
-      "version": "6.0.2",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.2.tgz",
-      "integrity": "sha512-bGdAIrZ0wiGDo5l8c++HWtbaNCWTS4UTv7RaTH/ThVIgjkveJt83m74bBHMJkuCbslY8ixgLBVZJIOiQlQTjfQ==",
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz",
+      "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==",
       "license": "Apache-2.0",
       "peer": true,
       "bin": {

package.json

@@ -15,12 +15,11 @@
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.22.2",
     "@lezer/highlight": "^1.2.0",
-    "@redocly/realm": "0.131.2",
+    "@redocly/realm": "0.132.0",
     "@uiw/codemirror-themes": "4.21.21",
     "@uiw/react-codemirror": "^4.21.21",
     "@xrplf/isomorphic": "^1.0.0-beta.1",
     "clsx": "^2.0.0",
-    "five-bells-condition": "^5.0.1",
     "lottie-react": "^2.4.0",
     "moment": "^2.29.4",
     "moment-timezone": "^0.6.0",

redirects.yaml

@@ -1,6 +1,7 @@
 # Docs redirects for moved pages -----------------------------------------------
 # (not associated with a major reorg)
-
+/docs/tutorials/defi/dex/trade-with-auction-slot-in-javascript/:
+    to: /docs/tutorials/defi/dex/use-amm-auction-slot-for-lower-fees/
 /resources/contribute-documentation/tutorial-structure/:
     to: /resources/contribute-documentation/tutorial-guidelines/
 /docs/tutorials/how-tos/use-specialized-payment-types/use-escrows/use-an-escrow-as-a-smart-contract:
@@ -279,7 +280,7 @@ xrp-ledger-rpc-tool.html:
 xrp-ledger-toml-checker.html:
     to: /resources/dev-tools/xrp-ledger-toml-checker
 domain-verification-checker.html:
-    to: /resources/dev-tools/domain-verification-checker
+    to: /resources/dev-tools/domain-verifier
 websocket-api-tool.html:
     to: /resources/dev-tools/websocket-api-tool
 xrp-testnet-faucet.html:
@@ -617,7 +618,7 @@ send-payments-using-python.html:
 py-create-accounts-send-xrp.html:
     to: /docs/tutorials/payments/send-xrp/
 py-create-trustline-send-currency.html:
-    to: /docs/tutorials/python/send-payments/create-trustline-send-currency
+    to: /docs/tutorials/payments/create-trust-line-send-currency-in-python/
 py-create-time-based-escrows.html:
     to: /docs/tutorials/payments/send-a-timed-escrow/
 py-mint-and-burn-nfts.html:
@@ -625,11 +626,11 @@ py-mint-and-burn-nfts.html:
 py-transfer-nfts.html:
     to: /docs/tutorials/tokens/nfts/transfer-nfts-py/
 py-broker-sale.html:
-    to: /docs/tutorials/python/nfts/broker-sale
+    to: /docs/tutorials/tokens/nfts/broker-an-nft-sale-py
 py-authorize-minter.html:
-    to: /docs/tutorials/python/nfts/authorize-minter
+    to: /docs/tutorials/tokens/nfts/assign-an-authorized-minter-py
 py-batch-minting.html:
-    to: /docs/tutorials/python/nfts/batch-minting
+    to: /docs/tutorials/tokens/nfts/batch-mint-nfts-py
 build-a-desktop-wallet-in-python.html:
     to: /docs/tutorials/sample-apps/build-a-desktop-wallet-in-python/
 javascript.html:
@@ -651,13 +652,13 @@ send-payments-using-javascript.html:
 create-accounts-send-xrp-using-javascript.html:
     to: /docs/tutorials/payments/send-xrp/
 create-trustline-send-currency-using-javascript.html:
-    to: /docs/tutorials/javascript/send-payments/create-trustline-send-currency
+    to: /docs/tutorials/payments/create-trust-line-send-currency-in-javascript
 create-time-based-escrows-using-javascript.html:
     to: /docs/tutorials/payments/send-a-timed-escrow/
 create-conditional-escrows-using-javascript.html:
     to: /docs/tutorials/payments/send-a-conditional-escrow/
 nfts-using-javascript.html:
-    to: /docs/tutorials/javascript/nfts-using-javascript/
+    to: /docs/tutorials/
 nfts-using-python.html:
     to: /docs/tutorials/
 mint-and-burn-nfts-using-javascript.html:
@@ -737,7 +738,7 @@ use-complex-payment-types.html:
 use-escrows.html:
     to: /docs/tutorials/
 send-a-time-held-escrow.html:
-    to: /docs/tutorials/how-tos/use-specialized-payment-types/use-escrows/send-a-time-held-escrow
+    to: /docs/tutorials/payments/send-a-timed-escrow
 send-a-conditionally-held-escrow.html:
     to: /docs/tutorials/payments/send-a-conditional-escrow/
 cancel-an-expired-escrow.html:
@@ -749,7 +750,7 @@ use-an-escrow-as-a-smart-contract.html:
 use-payment-channels.html:
     to: /docs/tutorials/payments/use-payment-channels/
 open-a-payment-channel-to-enable-an-inter-exchange-network.html:
-    to: /docs/tutorials/how-tos/use-specialized-payment-types/open-a-payment-channel-to-enable-an-inter-exchange-network
+    to: /docs/tutorials/payments/use-payment-channels
 use-checks.html:
     to: /docs/tutorials/how-tos/use-specialized-payment-types/use-checks/use-checks
 send-a-check.html:
@@ -1349,7 +1350,7 @@ tutorial-guidelines.html:
 tutorial-structure.html:
     to: /resources/contribute-documentation/tutorial-guidelines
 report-a-scam.html:
-    to: /contributing/report-a-scam
+    to: /community/report-a-scam
 wallets.html:
     to: /docs/introduction/crypto-wallets
 

resources/contribute-blog/index.md

@@ -23,6 +23,7 @@ The image files used in blog posts are located in the `blog/img` directory.
 
 The blog posts are grouped by year, so all blog posts published in year 2025 are located in the `blog/2025` directory. 
 
+
 ## Steps to Create a New Blog Post
 
 To create a new post, follow these steps:
@@ -39,4 +40,43 @@ To create a new post, follow these steps:
 
 6. When the draft is ready for review, save and commit your updates.
 
-7. Create a new PR to merge your changes to master. 
+7. Create a new PR to merge your changes to master.
+
+
+### Release Notes
+
+We have streamlined the release notes process with the assistance of **Claude** skills. To create new release notes, follow these steps:
+
+1. Load the `generate-release-notes` skill. **Claude** _should_ auto-load it when you set the working directory to the `xrpl-dev-portal` repository. If not, you can explicitly point to the skill located at `.claude/skills/generate-release-notes/SKILL.md`.
+{% admonition type="info" name="Note" %}Although the skill is optimized for **Claude**, you can give this `SKILL.md` file to any coding agent.{% /admonition %}
+
+2. Run the `generate-release-notes` skill.
+    ```bash
+    /generate-release-notes --from <branch-or-tag> --to <branch-or-tag>
+    ```
+
+    The skill accepts these arguments:
+
+    | Arguments  | Description |
+    |:-----------|:------------|
+    | `--from`   | (required) Base ref. Must match the exact [tag or branch](https://github.com/XRPLF/rippled/branches) the current version of `rippled` is building from. |
+    | `--to`     | (required) Target ref. Must match the exact [tag or branch](https://github.com/XRPLF/rippled/branches) the upcoming version of `rippled` will be built from. |
+    | `--date`   | (optional) Release date in `YYYY-MM-DD` format. Defaults to current date. |
+    | `--output` | (optional) Output file path. Defaults to `blog/<year>/rippled-<version>.md`. |
+
+3. The AI executes these steps:
+    - Runs a Python script that fetches all commits and PR details between the two refs and outputs a draft blog post.
+    - Processes all amendment-related changes, keeping, removing, or merging entries based on which amendments are part of the release.
+    - Sorts remaining entries into subsections (Features, Breaking Changes, Bug Fixes, etc.) based on files touched, PR labels, and descriptions.
+    - Reformats each entry to match the release notes style and writes a summary of the release.
+    - Cleans up empty sections and adds the post to the sidebar.
+
+    {% admonition type="info" name="Note" %}Depending on the size of the release, this process can take upwards of ten minutes.{% /admonition %}
+
+4. Review the final output.
+    - Check the descriptions of any entries in **Amendments**, **Features**, or **Breaking Changes**.
+    - Verify the integrity of the package links and add in the SHA-256 hashes.
+    - Verify the commit linked in the **Install / Upgrade** section points to the version bump commit.
+    - If you didn't pass in the correct release date using the `--date` argument, update the `date` field in the frontmatter.
+
+5. Create a new PR to merge the release notes to `master`.

resources/contribute-documentation/_tutorial-template.md

@@ -19,7 +19,7 @@ By following this tutorial, you should learn how to:
 To complete this tutorial, you should:
 
 - Have a basic understanding of the XRP Ledger.
-- Have an XRP Ledger client library, such as **xrpl.js**, installed.
+- Have an [XRP Ledger client library](../../references/client-libraries.md), such as **xrpl.js**, installed.
 - ***TODO: add and adjust prerequisites as required.***
 
 

sidebars.yaml

@@ -220,7 +220,7 @@
                 - page: docs/tutorials/defi/dex/create-an-automated-market-maker.md
                 - page: docs/tutorials/defi/dex/add-assets-to-amm-in-javascript.md
                 - page: docs/tutorials/defi/dex/trade-in-the-decentralized-exchange.md
-                - page: docs/tutorials/defi/dex/trade-with-auction-slot-in-javascript.md
+                - page: docs/tutorials/defi/dex/use-amm-auction-slot-for-lower-fees.md
             - group: Set Up Lending
               groupTranslationKey: sidebar.docs.tutorials.defi.setUpLending
               expanded: false

styles/_cards.scss

@@ -320,128 +320,3 @@ main article .card-grid {
   margin-bottom: 0.25rem;
   margin-top: 0.5rem;
 }
-
-/* Tutorial cards */
-.page-tutorials .tutorial-cards {
-  > div {
-    display: flex;
-  }
-
-  .card {
-    display: flex;
-    flex-direction: column;
-    height: 100%;
-    width: 100%;
-    min-height: 280px;
-    transition: all 0.35s ease-out;
-    cursor: pointer;
-
-    &:hover {
-      transform: translateY(-16px);
-    }
-
-    .card-header {
-      border-bottom: none;
-      background: transparent;
-      padding: 1.5rem 1.5rem 0 2rem;
-    }
-
-    .circled-logo {
-      margin-left: -10px;
-      display: inline-flex;
-      align-items: center;
-      justify-content: center;
-    }
-
-    .card-body {
-      padding: 1rem 1.5rem;
-      flex: 1;
-    }
-
-    .card-title {
-      font-weight: 700;
-      margin-bottom: 1rem;
-    }
-
-    .card-text {
-      font-size: 1rem;
-      margin-bottom: 1.5rem;
-    }
-
-    .card-footer {
-      background-color: transparent;
-      border-top: none;
-      padding: 0;
-      height: 40px;
-      background-size: cover;
-      background-position: bottom;
-      background-repeat: no-repeat;
-      margin-top: auto;
-    }
-  }
-
-  // Apply colored footers to each card
-  > div:nth-child(1) .card .card-footer {
-    background-image: url("../img/cards/3-col-pink.svg");
-  }
-  > div:nth-child(2) .card .card-footer {
-    background-image: url("../img/cards/3col-blue-light-blue.svg");
-  }
-  > div:nth-child(3) .card .card-footer {
-    background-image: url("../img/cards/3-col-light-blue.svg");
-  }
-  > div:nth-child(4) .card .card-footer {
-    background-image: url("../img/cards/3col-blue-green.svg");
-  }
-  > div:nth-child(5) .card .card-footer {
-    background-image: url("../img/cards/3col-magenta.svg");
-  }
-  > div:nth-child(6) .card .card-footer {
-    background-image: url("../img/cards/3-col-orange.svg");
-  }
-}
-
-.light .page-tutorials .tutorial-cards .circled-logo img[alt="HTTP / WebSocket"] {
-  filter: invert(1);
-}
-
-// TOC buttons for tutorials page
-.page-tutorials .page-toc.no-sideline {
-  border-left: none;
-  gap: 0.75rem;
-
-  li {
-    a {
-      border-radius: 100px;
-      padding: 0.5rem 1rem;
-      margin: 0;
-      background-color: $gray-800;
-      color: $gray-200;
-      font-weight: 500;
-      transition: all 0.2s ease;
-
-      &:hover,
-      &:focus,
-      &:active {
-        background-color: $blue-purple-500;
-        color: $white;
-        border-left: none;
-        margin-left: 0;
-      }
-    }
-  }
-}
-
-.light .page-tutorials .page-toc.no-sideline {
-  li a {
-    background-color: $gray-200;
-    color: $gray-800;
-
-    &:hover,
-    &:focus,
-    &:active {
-      background-color: $blue-purple-500;
-      color: $white;
-    }
-  }
-}

styles/_tutorials.scss

@@ -0,0 +1,489 @@
+// Tutorials landing page styles
+
+// Card footer gradient images
+$card-footers: (
+  "3-col-pink",
+  "3col-blue-light-blue",
+  "3-col-light-blue",
+  "3col-blue-green",
+  "3col-magenta",
+  "3-col-orange"
+);
+
+$whats-new-footers: (
+  "3col-green-purple",
+  "3col-purple-blue-green",
+  "3col-green-blue"
+);
+
+// Tutorial cards
+.page-tutorials .tutorial-cards {
+  > div {
+    display: flex;
+  }
+
+  .card {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    width: 100%;
+    min-height: 300px;
+    transition: all 0.35s ease-out;
+    cursor: pointer;
+
+    &:hover {
+      transform: translateY(-16px);
+    }
+
+    .card-header {
+      border-bottom: none;
+      background: transparent;
+      padding: 1.5rem 1.5rem 0 2rem;
+    }
+
+    .circled-logo {
+      margin-left: -10px;
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+    }
+
+    .card-body {
+      padding: 1rem 1.5rem;
+      flex: 1;
+    }
+
+    .card-title {
+      font-weight: 700;
+      margin-bottom: 1rem;
+    }
+
+    .card-text {
+      font-size: 1rem;
+      margin-bottom: 1.5rem;
+    }
+
+    .card-footer {
+      background-color: transparent;
+      border-top: none;
+      padding: 0;
+      height: 40px;
+      background-size: cover;
+      background-position: bottom;
+      background-repeat: no-repeat;
+      margin-top: auto;
+    }
+  }
+
+  // Apply colored footers to each card
+  @for $i from 1 through length($card-footers) {
+    > div:nth-child(#{$i}) .card .card-footer {
+      background-image: url("../img/cards/#{nth($card-footers, $i)}.svg");
+    }
+  }
+}
+
+// Light mode: invert HTTP/WebSocket icon
+.light .page-tutorials .tutorial-cards .circled-logo img[alt="HTTP / WebSocket"] {
+  filter: invert(1);
+}
+
+// Contribution Card - community contribution with meta links
+.page-tutorials .tutorial-cards .contribution-card {
+  .contribution-header {
+    display: flex;
+    align-items: center;
+    gap: 0.6rem;
+  }
+
+  .contribution-icon {
+    background: rgba($blue-purple-500, 0.15);
+    color: $blue-purple-300;
+    font-size: 26px;
+  }
+
+  .card-external-icon {
+    font-size: 0.85rem;
+    margin-left: 0.35rem;
+    color: $gray-500;
+    vertical-align: middle;
+  }
+
+  .card-meta-row {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    font-size: 0.8rem;
+    flex-wrap: wrap;
+    margin-left: auto;
+    margin-top: -4px;
+
+    .meta-link {
+      display: inline-flex;
+      align-items: center;
+      gap: 0.35rem;
+      color: $gray-300;
+      text-decoration: none;
+      transition: color 0.15s ease;
+
+      .fa {
+        font-size: 0.8rem;
+      }
+
+      &:hover {
+        color: $blue-purple-300;
+      }
+    }
+
+    .meta-dot {
+      color: $gray-500;
+      font-weight: bold;
+      user-select: none;
+    }
+  }
+}
+
+// Light mode: Contribution Card
+.light .page-tutorials .tutorial-cards .contribution-card {
+  .contribution-icon {
+    background: rgba($blue-purple-500, 0.1);
+    color: $blue-purple-600;
+  }
+
+  .card-meta-row {
+    .meta-link {
+      color: $gray-600;
+
+      &:hover {
+        color: $blue-purple-600;
+      }
+    }
+
+    .meta-dot {
+      color: $gray-500;
+    }
+  }
+}
+
+// Tutorial category section spacing
+.page-tutorials .category-section + .category-section {
+  margin-top: 2rem;
+}
+
+// Explore more link
+.page-tutorials .explore-more-wrapper {
+  margin-top: -1.5rem;
+  margin-bottom: 1.5rem;
+
+  .explore-more-link {
+    background: none;
+    border: none;
+    padding: 0;
+    cursor: pointer;
+    font-family: inherit;
+    font-size: 1.05rem;
+    color: $blue-purple-300;
+
+    &:hover {
+      text-decoration: underline;
+    }
+  }
+}
+
+.light .page-tutorials .explore-more-wrapper .explore-more-link {
+  color: $blue-purple-600;
+}
+
+// TOC navigation buttons
+.page-tutorials .page-toc.no-sideline {
+  border-left: none;
+  gap: 0.75rem;
+
+  li {
+    a {
+      border-radius: 100px;
+      padding: 0.5rem 1rem;
+      margin: 0;
+      background-color: $gray-800;
+      color: $gray-200;
+      font-weight: 500;
+      transition: all 0.2s ease;
+
+      &:hover,
+      &:focus,
+      &:active {
+        background-color: $blue-purple-500;
+        color: $white;
+        border-left: none;
+        margin-left: 0;
+      }
+    }
+  }
+}
+
+// Light mode: TOC buttons
+.light .page-tutorials .page-toc.no-sideline {
+  li a {
+    background-color: $gray-200;
+    color: $gray-800;
+
+    &:hover,
+    &:focus,
+    &:active {
+      background-color: $blue-purple-500;
+      color: $white;
+    }
+  }
+}
+
+// What's New section
+.whats-new-section {
+  // Gradient underline on section title
+  h3 {
+    display: inline-block;
+    position: relative;
+    padding-bottom: 8px;
+
+    &::after {
+      content: "";
+      position: absolute;
+      bottom: 0;
+      left: 0;
+      width: 60px;
+      height: 3px;
+      background: linear-gradient(90deg, $blue-purple-500, $green-400);
+      border-radius: 2px;
+    }
+  }
+
+  // Different footer colors for What's New cards
+  .tutorial-cards {
+    @for $i from 1 through length($whats-new-footers) {
+      > div:nth-child(#{$i}) .card .card-footer {
+        background-image: url("../img/cards/#{nth($whats-new-footers, $i)}.svg");
+      }
+    }
+  }
+}
+
+// Quick Reference Card
+.page-tutorials .quick-ref-card {
+  background: rgba($gray-800, 0.7);
+  border: 1px solid $gray-700;
+  border-left: 3px solid $blue-purple-500;
+  border-radius: 12px;
+  padding: 1rem 1.5rem;
+  backdrop-filter: blur(8px);
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.2);
+  margin-left: auto;
+  max-width: 480px;
+
+  @media (max-width: 991px) {
+    margin-left: 0;
+    max-width: 100%;
+  }
+
+  .quick-ref-section {
+    padding: 0.25rem 0;
+  }
+
+  .quick-ref-label {
+    display: block;
+    font-size: 0.7rem;
+    font-weight: 700;
+    letter-spacing: 0.08em;
+    color: $blue-purple-300;
+    margin-bottom: 0.75rem;
+  }
+
+  .quick-ref-group {
+    margin-bottom: 0.75rem;
+
+    &:last-of-type {
+      margin-bottom: 0.5rem;
+    }
+  }
+
+  .quick-ref-key {
+    display: block;
+    font-size: 0.85rem;
+    color: $gray-300;
+    margin-bottom: 0.35rem;
+
+    strong {
+      font-weight: 700;
+      color: $white;
+    }
+  }
+
+  .quick-ref-urls {
+    display: grid;
+    grid-template-columns: auto auto;
+    gap: 0.25rem 0.75rem;
+    align-items: center;
+    width: fit-content;
+    max-width: 100%;
+
+    @media (max-width: 576px) {
+      grid-template-columns: 1fr;
+      gap: 0.2rem;
+    }
+  }
+
+  .quick-ref-protocol {
+    font-size: 0.7rem;
+    font-weight: 500;
+    color: $gray-500;
+    letter-spacing: 0.02em;
+  }
+
+  .quick-ref-value {
+    font-size: 0.75rem;
+    color: $blue-purple-300;
+    background: rgba($gray-900, 0.5);
+    padding: 0.2rem 0.5rem;
+    border-radius: 4px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    max-width: 100%;
+  }
+
+  .quick-ref-value-btn {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35rem;
+    background: none;
+    border: none;
+    padding: 0;
+    cursor: pointer;
+    transition: opacity 0.2s ease;
+    max-width: 100%;
+    overflow: hidden;
+
+    &:hover {
+      opacity: 0.8;
+
+      .quick-ref-value {
+        background: rgba($gray-800, 0.8);
+      }
+    }
+
+    &.copied .quick-ref-value {
+      background: rgba($green-500, 0.2);
+      color: $green-400;
+    }
+
+    .copy-icon {
+      font-size: 0.7rem;
+      color: $green-400;
+      min-width: 0.8rem;
+      flex-shrink: 0;
+    }
+
+    @media (max-width: 576px) {
+      margin-bottom: 0.5rem;
+    }
+  }
+
+  .quick-ref-link {
+    display: inline-block;
+    font-size: 0.8rem;
+    color: $blue-purple-300;
+    margin-top: 0.35rem;
+    text-decoration: none;
+
+    &:hover {
+      text-decoration: underline;
+    }
+  }
+
+  .quick-ref-divider {
+    height: 1px;
+    background: $gray-700;
+    margin: 0.5rem 0;
+  }
+
+  .quick-ref-faucet {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    font-size: 0.9rem;
+    font-weight: 500;
+    color: $white;
+    text-decoration: none;
+    padding: 0.25rem 0;
+
+    &:hover {
+      color: $blue-purple-300;
+    }
+
+    .quick-ref-arrow {
+      color: $blue-purple-400;
+    }
+  }
+}
+
+// Light mode: Quick Reference Card
+.light .page-tutorials .quick-ref-card {
+  background: rgba($white, 0.95);
+  border-color: $gray-300;
+  border-left: 3px solid $blue-purple-500;
+  box-shadow: 0 4px 24px rgba(0, 0, 0, 0.1);
+
+  .quick-ref-label {
+    color: $blue-purple-600;
+  }
+
+  .quick-ref-key {
+    color: $gray-700;
+
+    strong {
+      color: $gray-900;
+    }
+  }
+
+  .quick-ref-protocol {
+    color: $gray-500;
+  }
+
+  .quick-ref-value {
+    color: $blue-purple-600;
+    background: rgba($gray-300, 0.6);
+  }
+
+  .quick-ref-value-btn {
+    &:hover .quick-ref-value {
+      background: rgba($gray-400, 0.6);
+    }
+
+    &.copied .quick-ref-value {
+      background: rgba($green-500, 0.15);
+      color: $green-700;
+    }
+
+    .copy-icon {
+      color: $green-600;
+    }
+  }
+
+  .quick-ref-link {
+    color: $blue-purple-600;
+  }
+
+  .quick-ref-divider {
+    background: $gray-200;
+  }
+
+  .quick-ref-faucet {
+    color: $gray-900;
+
+    &:hover {
+      color: $blue-purple-600;
+    }
+
+    .quick-ref-arrow {
+      color: $blue-purple-500;
+    }
+  }
+}

styles/xrpl.scss

@@ -69,6 +69,7 @@ $line-height-base: 1.5;
 @import "_pages.scss";
 @import "_rpc-tool.scss";
 @import "_blog.scss";
+@import "_tutorials.scss";
 @import "_feedback.scss";
 @import "_video.scss";
 @import "_contribute.scss";

tools/generate-release-notes.py

@@ -0,0 +1,697 @@
+"""
+Generate rippled release notes from GitHub commit history.
+
+Usage (from repo root):
+    python3 tools/generate-release-notes.py --from release-3.0 --to release-3.1 [--date 2026-03-24] [--output path/to/file.md]
+
+Arguments:
+    --from      (required) Base ref — must match exact tag or branch to compare from.
+    --to        (required) Target ref — must match exact tag or branch to compare to.
+    --date      (optional) Release date in YYYY-MM-DD format. Defaults to today.
+    --output    (optional) Output file path. Defaults to blog/<year>/rippled-<version>.md.
+
+Requires: gh CLI (authenticated)
+"""
+
+import argparse
+import base64
+import json
+import os
+import re
+import subprocess
+import sys
+from datetime import date, datetime
+
+
+# Emails to exclude from credits (Ripple employees not using @ripple.com).
+# Commits from @ripple.com addresses are already filtered automatically.
+EXCLUDED_EMAILS = {
+    "3maisons@gmail.com",                                   # Luc des Trois Maisons
+    "a1q123456@users.noreply.github.com",                   # Jingchen Wu
+    "bthomee@users.noreply.github.com",                     # Bart Thomee
+    "21219765+ckeshava@users.noreply.github.com",           # Chenna Keshava B S
+    "gregtatcam@users.noreply.github.com",                  # Gregory Tsipenyuk
+    "kuzzz99@gmail.com",                                    # Sergey Kuznetsov
+    "legleux@users.noreply.github.com",                     # Michael Legleux
+    "mathbunnyru@users.noreply.github.com",                 # Ayaz Salikhov
+    "mvadari@gmail.com",                                    # Mayukha Vadari
+    "115580134+oleks-rip@users.noreply.github.com",         # Oleksandr Pidskopnyi
+    "3397372+pratikmankawde@users.noreply.github.com",      # Pratik Mankawde
+    "35279399+shawnxie999@users.noreply.github.com",        # Shawn Xie
+    "5780819+Tapanito@users.noreply.github.com",            # Vito Tumas
+    "13349202+vlntb@users.noreply.github.com",              # Valentin Balaschenko
+    "129996061+vvysokikh1@users.noreply.github.com",        # Vladislav Vysokikh
+    "vvysokikh@gmail.com",                                  # Vladislav Vysokikh
+}
+
+
+# Pre-compiled patterns for skipping version commits
+SKIP_PATTERNS = [
+    re.compile(r"^Set version to", re.IGNORECASE),
+    re.compile(r"^Version \d", re.IGNORECASE),
+    re.compile(r"bump version to", re.IGNORECASE),
+    re.compile(r"^Merge tag ", re.IGNORECASE),
+]
+
+
+# --- API helpers ---
+
+def run_gh_rest(endpoint):
+    """Run a gh api REST command and return parsed JSON."""
+    result = subprocess.run(
+        ["gh", "api", endpoint],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"Error running gh api: {result.stderr}", file=sys.stderr)
+        sys.exit(1)
+    return json.loads(result.stdout)
+
+
+def run_gh_graphql(query):
+    """Run a gh api graphql command and return parsed JSON.
+    Handles partial failures (e.g., missing PRs) by returning
+    whatever data is available alongside errors.
+    """
+    result = subprocess.run(
+        ["gh", "api", "graphql", "-f", f"query={query}"],
+        capture_output=True,
+        text=True,
+    )
+    try:
+        return json.loads(result.stdout)
+    except (json.JSONDecodeError, TypeError):
+        print(f"Error running graphql: {result.stderr}", file=sys.stderr)
+        sys.exit(1)
+
+
+def fetch_commit_files(sha):
+    """Fetch list of files changed in a commit via REST API.
+    Returns empty list on failure instead of exiting.
+    """
+    result = subprocess.run(
+        ["gh", "api", f"repos/XRPLF/rippled/commits/{sha}"],
+        capture_output=True,
+        text=True,
+    )
+    if result.returncode != 0:
+        print(f"  Warning: Could not fetch files for commit {sha[:7]}", file=sys.stderr)
+        return []
+    data = json.loads(result.stdout)
+    return [f["filename"] for f in data.get("files", [])]
+
+
+# --- Data fetching ---
+
+def fetch_version_info(ref):
+    """Fetch version string and version-setting commit info in a single GraphQL call.
+    Returns (version_string, formatted_commit_block).
+    """
+    data = run_gh_graphql(f"""
+    {{
+        repository(owner: "XRPLF", name: "rippled") {{
+            file: object(expression: "{ref}:src/libxrpl/protocol/BuildInfo.cpp") {{
+                ... on Blob {{ text }}
+            }}
+            ref: object(expression: "{ref}") {{
+                ... on Commit {{
+                    history(first: 1, path: "src/libxrpl/protocol/BuildInfo.cpp") {{
+                        nodes {{
+                            oid
+                            message
+                            author {{
+                                name
+                                email
+                                date
+                            }}
+                        }}
+                    }}
+                }}
+            }}
+        }}
+    }}
+    """)
+    repo = data.get("data", {}).get("repository", {})
+
+    # Extract version string from BuildInfo.cpp
+    file_text = (repo.get("file") or {}).get("text", "")
+    match = re.search(r'versionString\s*=\s*"([^"]+)"', file_text)
+    if not match:
+        print("Warning: Could not find versionString in BuildInfo.cpp. Using placeholder.", file=sys.stderr)
+    version = match.group(1) if match else "TODO"
+
+    # Extract version commit info
+    nodes = (repo.get("ref") or {}).get("history", {}).get("nodes", [])
+    if not nodes:
+        commit_block = "commit TODO\nAuthor: TODO\nDate:   TODO\n\n    Set version to TODO"
+    else:
+        commit = nodes[0]
+        raw_date = commit["author"]["date"]
+        try:
+            dt = datetime.fromisoformat(raw_date)
+            formatted_date = dt.strftime("%a %b %-d %H:%M:%S %Y %z")
+        except ValueError:
+            formatted_date = raw_date
+
+        name = commit["author"]["name"]
+        email = commit["author"]["email"]
+        sha = commit["oid"]
+        message = commit["message"].split("\n")[0]
+        commit_block = f"commit {sha}\nAuthor: {name} <{email}>\nDate:   {formatted_date}\n\n    {message}"
+
+    return version, commit_block
+
+
+def fetch_commits(from_ref, to_ref):
+    """Fetch all commits between two refs using the GitHub compare API."""
+    commits = []
+    page = 1
+    while True:
+        data = run_gh_rest(
+            f"repos/XRPLF/rippled/compare/{from_ref}...{to_ref}?per_page=250&page={page}"
+        )
+        batch = data.get("commits", [])
+        commits.extend(batch)
+        if len(batch) < 250:
+            break
+        page += 1
+    return commits
+
+
+def parse_features_macro(text):
+    """Parse features.macro into {amendment_name: status_string} dict."""
+    results = {}
+    for match in re.finditer(
+        r'XRPL_(FEATURE|FIX)\s*\(\s*(\w+)\s*,\s*Supported::(\w+)\s*,\s*VoteBehavior::(\w+)', text):
+        macro_type, name, supported, vote = match.groups()
+        key = f"fix{name}" if macro_type == "FIX" else name
+        results[key] = f"{supported}, {vote}"
+    for match in re.finditer(r'XRPL_RETIRE(?:_(FEATURE|FIX))?\s*\(\s*(\w+)\s*\)', text):
+        macro_type, name = match.groups()
+        key = f"fix{name}" if macro_type == "FIX" else name
+        results[key] = "retired"
+    return results
+
+
+def fetch_amendment_diff(from_ref, to_ref):
+    """Compare features.macro between two refs to find amendment changes.
+    Returns (changes, unchanged) where:
+    - changes: {name: True/False} for amendments that changed status
+    - unchanged: {name: True/False} for amendments with no status change
+    True = include; False = exclude
+    """
+    macro_path = "repos/XRPLF/rippled/contents/include/xrpl/protocol/detail/features.macro"
+
+    from_data = run_gh_rest(f"{macro_path}?ref={from_ref}")
+    from_text = base64.b64decode(from_data["content"]).decode()
+    from_amendments = parse_features_macro(from_text)
+
+    to_data = run_gh_rest(f"{macro_path}?ref={to_ref}")
+    to_text = base64.b64decode(to_data["content"]).decode()
+    to_amendments = parse_features_macro(to_text)
+
+    changes = {}
+    for name, to_status in to_amendments.items():
+        if name not in from_amendments:
+            # New amendment — include only if Supported::yes
+            changes[name] = to_status.startswith("yes")
+        elif from_amendments[name] != to_status:
+            # Include if either old or new status involves yes (voting-ready)
+            from_status = from_amendments[name]
+            changes[name] = from_status.startswith("yes") or to_status.startswith("yes")
+
+    # Removed amendments — include only if they were Supported::yes
+    for name in from_amendments:
+        if name not in to_amendments:
+            changes[name] = from_amendments[name].startswith("yes")
+
+    # Unchanged amendments to also exclude (unreleased work)
+    unchanged = sorted(
+        name for name, to_status in to_amendments.items()
+        if name not in changes and to_status != "retired" and not to_status.startswith("yes")
+    )
+
+    return changes, unchanged
+
+
+def fetch_prs_graphql(pr_numbers):
+    """Fetch PR details in batches using GitHub GraphQL API.
+    Falls back to issue lookup for numbers that aren't PRs.
+    Returns a dict of {number: {title, body, labels, files, type}}.
+    """
+    results = {}
+    missing = []
+    batch_size = 50
+    pr_list = list(pr_numbers)
+
+    # Fetch PRs
+    for i in range(0, len(pr_list), batch_size):
+        batch = pr_list[i:i + batch_size]
+
+        fragments = []
+        for pr_num in batch:
+            fragments.append(f"""
+                pr{pr_num}: pullRequest(number: {pr_num}) {{
+                    title
+                    body
+                    labels(first: 10) {{
+                        nodes {{ name }}
+                    }}
+                    files(first: 100) {{
+                        nodes {{ path }}
+                    }}
+                }}
+            """)
+
+        query = f"""
+        {{
+            repository(owner: "XRPLF", name: "rippled") {{
+                {"".join(fragments)}
+            }}
+        }}
+        """
+
+        data = run_gh_graphql(query)
+        repo_data = data.get("data", {}).get("repository", {})
+
+        for alias, pr_data in repo_data.items():
+            pr_num = int(alias.removeprefix("pr"))
+            if pr_data:
+                results[pr_num] = {
+                    "title": pr_data["title"],
+                    "body": clean_pr_body(pr_data.get("body") or ""),
+                    "labels": [l["name"] for l in pr_data.get("labels", {}).get("nodes", [])],
+                    "files": [f["path"] for f in pr_data.get("files", {}).get("nodes", [])],
+                    "type": "pull",
+                }
+            else:
+                missing.append(pr_num)
+
+        print(f"  Fetched {min(i + batch_size, len(pr_list))}/{len(pr_list)} PRs...")
+
+    # Fetch missing numbers as issues
+    if missing:
+        print(f"  Looking up {len(missing)} missing PR numbers as Issues...")
+        for i in range(0, len(missing), batch_size):
+            batch = missing[i:i + batch_size]
+
+            fragments = []
+            for num in batch:
+                fragments.append(f"""
+                    issue{num}: issue(number: {num}) {{
+                        title
+                        body
+                        labels(first: 10) {{
+                            nodes {{ name }}
+                        }}
+                    }}
+                """)
+
+            query = f"""
+            {{
+                repository(owner: "XRPLF", name: "rippled") {{
+                    {"".join(fragments)}
+                }}
+            }}
+            """
+
+            data = run_gh_graphql(query)
+            repo_data = data.get("data", {}).get("repository", {})
+
+            for alias, issue_data in repo_data.items():
+                if issue_data:
+                    num = int(alias.removeprefix("issue"))
+                    results[num] = {
+                        "title": issue_data["title"],
+                        "body": clean_pr_body(issue_data.get("body") or ""),
+                        "labels": [l["name"] for l in issue_data.get("labels", {}).get("nodes", [])],
+                        "type": "issues",
+                    }
+
+    return results
+
+
+# --- Utilities ---
+
+def clean_pr_body(text):
+    """Strip HTML comments and PR template boilerplate from body text."""
+    # Remove HTML comments
+    text = re.sub(r"<!--.*?-->", "", text, flags=re.DOTALL)
+    # Remove unchecked checkbox lines, keep checked ones
+    text = re.sub(r"^- \[ \] .+$", "", text, flags=re.MULTILINE)
+    # Remove all markdown headings
+    text = re.sub(r"^#{1,6} .+$", "", text, flags=re.MULTILINE)
+    # Convert bare GitHub URLs to markdown links
+    text = re.sub(r"(?<!\()https://github\.com/XRPLF/rippled/(pull|issues)/(\d+)(#[^\s)]*)?", r"[#\2](https://github.com/XRPLF/rippled/\1/\2\3)", text)
+    # Convert remaining bare PR/issue references (#1234) to full GitHub links
+    text = re.sub(r"(?<!\[)#(\d+)(?!\])", r"[#\1](https://github.com/XRPLF/rippled/pull/\1)", text)
+    # Collapse multiple blank lines into one
+    text = re.sub(r"\n{3,}", "\n\n", text)
+    return text.strip()
+
+
+def extract_pr_number(commit_message):
+    """Extract PR number from commit message like 'Title (#1234)'."""
+    match = re.search(r"#(\d+)", commit_message)
+    return int(match.group(1)) if match else None
+
+
+def should_skip(title):
+    """Check if a commit should be skipped."""
+    return any(pattern.search(title) for pattern in SKIP_PATTERNS)
+
+
+def is_amendment(files):
+    """Check if any file in the list is features.macro."""
+    return any("features.macro" in f for f in files)
+
+
+# --- Formatting ---
+
+def format_commit_entry(sha, title, body="", files=None):
+    """Format an entry linked to a commit (no PR/Issue found)."""
+    short_sha = sha[:7]
+    url = f"https://github.com/XRPLF/rippled/commit/{sha}"
+    parts = [
+        f"- **{title.strip()}**",
+        f"  - Link: [{short_sha}]({url})",
+    ]
+    if files:
+        parts.append(f"  - Files: {', '.join(files)}")
+    if body:
+        desc = re.sub(r"\s+", " ", clean_pr_body(body)).strip()
+        if desc:
+            parts.append(f"  - Description: {desc}")
+    return "\n".join(parts)
+
+
+def format_uncategorized_entry(pr_number, title, labels, body, files=None, link_type="pull"):
+    """Format an uncategorized entry with full context for AI sorting."""
+    url = f"https://github.com/XRPLF/rippled/{link_type}/{pr_number}"
+    parts = [
+        f"- **{title.strip()}**",
+        f"  - Link: [#{pr_number}]({url})",
+    ]
+    if labels:
+        parts.append(f"  - Labels: {', '.join(labels)}")
+    if files:
+        parts.append(f"  - Files: {', '.join(files)}")
+    if body:
+        # Collapse to single line to prevent markdown formatting conflicts
+        desc = re.sub(r"\s+", " ", body).strip()
+        if desc:
+            parts.append(f"  - Description: {desc}")
+    return "\n".join(parts)
+
+
+def generate_markdown(version, release_date, amendment_diff, amendment_unchanged, amendment_entries, entries, authors, version_commit):
+    """Generate the full markdown release notes."""
+    year = release_date.split("-")[0]
+    parts = []
+
+    parts.append(f"""---
+category: {year}
+date: "{release_date}"
+template: '../../@theme/templates/blogpost'
+seo:
+    title: Introducing XRP Ledger version {version}
+    description: rippled version {version} is now available.
+labels:
+    - rippled Release Notes
+markdown:
+    editPage:
+        hide: true
+---
+# Introducing XRP Ledger version {version}
+
+Version {version} of `rippled`, the reference server implementation of the XRP Ledger protocol, is now available.
+
+
+## Action Required
+
+If you run an XRP Ledger server, upgrade to version {version} as soon as possible to ensure service continuity.
+
+
+## Install / Upgrade
+
+On supported platforms, see the [instructions on installing or updating `rippled`](../../docs/infrastructure/installation/index.md).
+
+| Package | SHA-256 |
+|:--------|:--------|
+| [RPM for Red Hat / CentOS (x86-64)](https://repos.ripple.com/repos/rippled-rpm/stable/rippled-{version}-1.el9.x86_64.rpm) | `TODO` |
+| [DEB for Ubuntu / Debian (x86-64)](https://repos.ripple.com/repos/rippled-deb/pool/stable/rippled_{version}-1_amd64.deb) | `TODO` |
+
+For other platforms, please [build from source](https://github.com/XRPLF/rippled/blob/master/BUILD.md). The most recent commit in the git log should be the change setting the version:
+
+```text
+{version_commit}
+```
+
+
+## Full Changelog
+""")
+
+    # Amendments section (auto-sorted by features.macro detection with diff guidance for AI)
+    parts.append("\n### Amendments\n")
+    if amendment_diff or amendment_unchanged:
+        included = sorted(name for name, include in amendment_diff.items() if include)
+        excluded = sorted(name for name, include in amendment_diff.items() if not include)
+        comment_lines = ["<!-- Amendment sorting instructions. Remove this comment after sorting."]
+        if included:
+            comment_lines.append(f"Include: {', '.join(included)}")
+        if excluded:
+            comment_lines.append(f"Exclude: {', '.join(excluded)}")
+        if amendment_unchanged:
+            comment_lines.append(f"Other amendments not part of this release: {', '.join(amendment_unchanged)}")
+        comment_lines.append("-->")
+        parts.append("\n".join(comment_lines) + "\n")
+    for entry in amendment_entries:
+        parts.append(entry)
+
+    # Remaining empty subsection headings for manual/AI sorting
+    sections = [
+        "Features", "Breaking Changes", "Bug Fixes",
+        "Refactors", "Documentation", "Testing", "CI/Build",
+    ]
+    for section in sections:
+        parts.append(f"\n### {section}\n")
+
+    # Credits
+    parts.append("\n\n## Credits\n")
+    if authors:
+        parts.append("The following RippleX teams and GitHub users contributed to this release:\n")
+    else:
+        parts.append("The following RippleX teams contributed to this release:\n")
+    parts.append("- RippleX Engineering")
+    parts.append("- RippleX Docs")
+    parts.append("- RippleX Product")
+    for author in sorted(authors):
+        parts.append(f"- {author}")
+
+    parts.append("""
+
+## Bug Bounties and Responsible Disclosures
+
+We welcome reviews of the `rippled` code and urge researchers to responsibly disclose any issues they may find.
+
+For more information, see:
+
+- [Ripple's Bug Bounty Program](https://ripple.com/legal/bug-bounty/)
+- [`rippled` Security Policy](https://github.com/XRPLF/rippled/blob/develop/SECURITY.md)
+""")
+
+    # Unsorted entries with full context (after all published sections)
+    parts.append("<!-- Sort the entries below into the Full Changelog subsections. Remove this comment after sorting. -->\n")
+    for entry in entries:
+        parts.append(entry)
+
+    return "\n".join(parts)
+
+
+# --- Main ---
+
+def main():
+    parser = argparse.ArgumentParser(description="Generate rippled release notes")
+    parser.add_argument("--from", dest="from_ref", required=True, help="Base ref (tag or branch)")
+    parser.add_argument("--to", dest="to_ref", required=True, help="Target ref (tag or branch)")
+    parser.add_argument("--date", help="Release date (YYYY-MM-DD). Defaults to today.")
+    parser.add_argument("--output", help="Output file path (default: blog/<year>/rippled-<version>.md)")
+    args = parser.parse_args()
+
+    args.date = args.date or date.today().isoformat()
+    try:
+        date.fromisoformat(args.date)
+    except ValueError:
+        print(f"Error: Invalid date format '{args.date}'. Use YYYY-MM-DD.", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"Fetching version info from {args.to_ref}...")
+    version, version_commit = fetch_version_info(args.to_ref)
+    print(f"Version: {version}")
+
+    year = args.date.split("-")[0]
+    output_path = args.output or f"blog/{year}/rippled-{version}.md"
+
+    print(f"Fetching commits: {args.from_ref}...{args.to_ref}")
+    commits = fetch_commits(args.from_ref, args.to_ref)
+    print(f"Found {len(commits)} commits")
+
+    # Extract unique PR (in rare cases Issues) numbers and track authors
+    pr_numbers = {}
+    pr_shas = {}       # PR/issue number → commit SHA (for file lookups on Issues)
+    pr_bodies = {}     # PR/issue number → commit body (for fallback descriptions)
+    orphan_commits = []  # Commits with no PR/Issues link
+    authors = set()
+
+    for commit in commits:
+        full_message = commit["commit"]["message"]
+        message = full_message.split("\n")[0]
+        body = "\n".join(full_message.split("\n")[1:]).strip()
+        sha = commit["sha"]
+        author = commit["commit"]["author"]["name"]
+        email = commit["commit"]["author"].get("email", "")
+
+        # Skip Ripple employees from credits
+        login = (commit.get("author") or {}).get("login")
+        if not email.lower().endswith("@ripple.com") and email not in EXCLUDED_EMAILS:
+            if login:
+                authors.add(f"@{login}")
+            else:
+                authors.add(author)
+
+        if should_skip(message):
+            continue
+
+        pr_number = extract_pr_number(message)
+        if pr_number:
+            pr_numbers[pr_number] = message
+            pr_shas[pr_number] = sha
+            pr_bodies[pr_number] = body
+        else:
+            orphan_commits.append({"sha": sha, "message": message, "body": body})
+
+    print(f"Unique PRs after filtering: {len(pr_numbers)}")
+    if orphan_commits:
+        print(f"Commits without PR or Issue linked: {len(orphan_commits)}")
+    # Fetch amendment diff between refs
+    print(f"Comparing features.macro between {args.from_ref} and {args.to_ref}...")
+    amendment_diff, amendment_unchanged = fetch_amendment_diff(args.from_ref, args.to_ref)
+    if amendment_diff:
+        for name, include in sorted(amendment_diff.items()):
+            status = "include" if include else "exclude"
+            print(f"  Amendment {name}: {status}")
+    else:
+        print("  No amendment changes detected")
+
+    print(f"Building changelog entries...")
+
+    # Fetch all PR details in batches via GraphQL
+    pr_details = fetch_prs_graphql(list(pr_numbers.keys()))
+
+    # Build entries, sorting amendments automatically
+    amendment_entries = []
+    entries = []
+    for pr_number, commit_msg in pr_numbers.items():
+        pr_data = pr_details.get(pr_number)
+
+        if pr_data:
+            title = pr_data["title"]
+            body = pr_data.get("body", "")
+            labels = pr_data.get("labels", [])
+            files = pr_data.get("files", [])
+            link_type = pr_data.get("type", "pull")
+
+            # For issues (no files from GraphQL), fetch files from the commit
+            if not files and pr_number in pr_shas:
+                print(f"  Building entry for Issue #{pr_number} via commit...")
+                files = fetch_commit_files(pr_shas[pr_number])
+
+            if is_amendment(files) and amendment_diff:
+                # Amendment entry — add to amendments section (AI will sort further)
+                entry = format_uncategorized_entry(pr_number, title, labels, body, link_type=link_type)
+                amendment_entries.append(entry)
+            else:
+                entry = format_uncategorized_entry(pr_number, title, labels, body, files, link_type)
+                entries.append(entry)
+        else:
+            # Fallback to commit lookup for invalid PR and Issues link
+            sha = pr_shas[pr_number]
+            print(f"  #{pr_number} not found as PR or Issue, building from commit {sha[:7]}...")
+            files = fetch_commit_files(sha)
+            if is_amendment(files) and amendment_diff:
+                entry = format_commit_entry(sha, commit_msg, pr_bodies[pr_number])
+                amendment_entries.append(entry)
+            else:
+                entry = format_commit_entry(sha, commit_msg, pr_bodies[pr_number], files)
+                entries.append(entry)
+
+    # Build entries for orphan commits (no PR/Issue linked)
+    for orphan in orphan_commits:
+        sha = orphan["sha"]
+        print(f"  Building commit-only entry for {sha[:7]}...")
+        files = fetch_commit_files(sha)
+        if is_amendment(files) and amendment_diff:
+            entry = format_commit_entry(sha, orphan["message"], orphan["body"])
+            amendment_entries.append(entry)
+        else:
+            entry = format_commit_entry(sha, orphan["message"], orphan["body"], files)
+            entries.append(entry)
+
+    # Generate markdown
+    markdown = generate_markdown(version, args.date, amendment_diff, amendment_unchanged, amendment_entries, entries, authors, version_commit)
+
+    # Write output
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    with open(output_path, "w") as f:
+        f.write(markdown)
+
+    print(f"\nRelease notes written to: {output_path}")
+
+    # Update blog/sidebars.yaml
+    sidebars_path = "blog/sidebars.yaml"
+    # Derive sidebar path and year from actual output path
+    relative_path = output_path.removeprefix("blog/")
+    sidebar_year = relative_path.split("/")[0]
+    new_entry = f"        - page: {relative_path}"
+    try:
+        with open(sidebars_path, "r") as f:
+            sidebar_content = f.read()
+
+        if relative_path in sidebar_content:
+            print(f"{sidebars_path} already contains {relative_path}")
+        else:
+            # Find the year group and insert at the top of its items
+            year_marker = f"    - group: '{sidebar_year}'"
+            if year_marker not in sidebar_content:
+                # Year group doesn't exist — find the right chronological position
+                new_group = f"    - group: '{sidebar_year}'\n      expanded: false\n      items:\n{new_entry}\n"
+                # Find all existing year groups and insert before the first one with a smaller year
+                year_groups = list(re.finditer(r"    - group: '(\d{4})'", sidebar_content))
+                insert_pos = None
+                for match in year_groups:
+                    existing_year = match.group(1)
+                    if int(sidebar_year) > int(existing_year):
+                        insert_pos = match.start()
+                        break
+                if insert_pos is not None:
+                    sidebar_content = sidebar_content[:insert_pos] + new_group + sidebar_content[insert_pos:]
+                else:
+                    # New year is older than all existing — append at the end
+                    sidebar_content = sidebar_content.rstrip() + "\n" + new_group
+            else:
+                # Insert after the year group's "items:" line
+                year_idx = sidebar_content.index(year_marker)
+                items_idx = sidebar_content.index("      items:", year_idx)
+                insert_pos = items_idx + len("      items:\n")
+                sidebar_content = sidebar_content[:insert_pos] + new_entry + "\n" + sidebar_content[insert_pos:]
+
+            with open(sidebars_path, "w") as f:
+                f.write(sidebar_content)
+            print(f"Added {relative_path} to {sidebars_path}")
+    except FileNotFoundError:
+        print(f"Warning: {sidebars_path} not found, skipping sidebar update", file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()