Merge pull request #3541 from XRPLF/blog_rippled312

Add 3.1.2 release announcement & update link in 3.1.1 build instructions

CODE-OF-CONDUCT.ja.md

@@ -1,46 +0,0 @@
-# コントリビューター行動規範
-
-## 誓約
-
-私たちコントリビューターとメンテナーは、オープンで友好的な環境を育むために、年齢、体格、身体障害、民族、性的特徴、性自認および性表現、経験の度合い、学歴、社会経済的地位、国籍、容姿、人種、宗教、性的同一性および性的指向などを問わず、誰もが私たちのプロジェクトとコミュニティーに不快な思いをすることなく参加できるよう努めることを誓います。
-
-## 標準
-
-前向きな環境を作り上げることに貢献する行動の例:
-
-* 友好的で差別のない言葉の使用
-* 異なる観点や経験の尊重
-* 建設的な批判の素直な受け入れ
-* コミュニティーにとっての最善への注力
-* 他のコミュニティーメンバーへの共感の表示
-
-前向きな環境を作り上げることに貢献しない行動の例:
-
-* 性的な意味を含む言葉や画像の使用、望まない性的注目や誘いかけ
-* あおり、侮辱的または軽蔑的なコメント、個人攻撃や政治攻撃
-* 公的または私的な嫌がらせ
-* 住所やメールアドレスなどの個人情報の、明確な許可なしでの公開
-* 職場において不適切であると合理的に考えられる、その他の行為
-
-## 責任
-
-プロジェクトのメンテナーは、許容できる行動の基準を明確にする責任があります。また、許容できない行動がなされた場合に、適切かつ公平な是正処置を講じることが期待されます。
-
-プロジェクトのメンテナーは、この行動規範に沿わないコメント、コミット、コード、wiki編集、issueなどの投稿を削除、編集、拒否する権利と義務を有します。また、他の不適切、脅迫的、攻撃的、嫌がらせと考えられる行動を取ったコントリビューターを一時的もしくは恒久的に追放する権利と義務を有します。
-
-## 適用範囲
-
-この行動規範はすべてのプロジェクトスペース内で適用されます。また、個人がパブリックスペースでプロジェクトやコミュニティーを代表する際にも適用されます。プロジェクトやコミュニティーを代表する際の例としては、プロジェクトの公式メールアドレスを使用すること、公式ソーシャルメディアアカウントで投稿すること、もしくはオンラインまたはオフラインのイベントで、任命された代表者を務めることが挙げられます。プロジェクトを代表する行為については、プロジェクトのメンテナーがさらに細かく定義して明確にすることができます。
-
-## 執行
-
-暴言、嫌がらせ、またはその他の許容できない行動は、プロジェクトチーム（<ripplex@ripple.com>）に連絡して報告することができます。すべての申し立ては確認、調査されたうえで、その状況に対して必要かつ適切と判断された対応が取られます。プロジェクトチームは、事象の報告者に関する秘密を保持する義務があります。特定の執行方針の詳細は、別途掲載される場合があります。
-
-この行動規範を誠実に遵守または執行することができないプロジェクトのメンテナーは、プロジェクトを率いる他のメンバーの判断により、一時的または恒久的な措置が執られることがあります。
-
-## 帰属
-
-この行動規範は、[コントリビューター行動規範][ホームページ]バージョン1.4（https://www.contributor-covenant.org/version/1/4/code-of-conduct.html）から抜粋したものです。
-
-[ホームページ]: https://www.contributor-covenant.org
-この行動規範に関するよくある質問と回答については、https://www.contributor-covenant.org/faq をご覧ください。

CODE-OF-CONDUCT.md

@@ -1,5 +1,7 @@
 # Contributor Covenant Code of Conduct
 
+For translated verisons of this document, see the [@l10n folder](@l10n/).
+
 ## Our Pledge
 
 In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of, but not limited to characteristics like age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.

CODE_OF_CONDUCT.es-ES.md

@@ -1,48 +0,0 @@
-# Código de conducta del pacto de contribuidores
-
-## Nuestro compromiso
-
-Con el fin de fomentar un ambiente abierto y acogedor, nosotros, como contribuidores y mantenedores, nos comprometemos a hacer de la participación en nuestro proyecto y nuestra comunidad una experiencia libre de acoso para todos, independientemente de, entre otras, características como la edad, tamaño corporal, discapacidad, origen étnico, características sexuales, identidad y expresión de género, nivel de experiencia, educación, estatus socioeconómico, nacionalidad, apariencia personal, raza, religión o identidad y orientación sexual.
-
-## Nuestros estándares
-
-Ejemplos de comportamiento que contribuyen a crear un ambiente positivo incluyen:
-
-* Utilizar lenguaje acogedor e inclusivo
-* Ser respetuoso con los diferentes puntos de vista y experiencias
-* Saber aceptar las críticas constructivas
-* Centrarse en lo que es lo mejor para la comunidad
-* Mostrar empatía hacia otros miembros de la comunidad
-
-Ejemplos de comportamiento que no contribuyen a crear un ambiente positivo incluyen:
-
-* Utilizar un lenguaje o imágenes sexualizadas y atención o insinuaciones sexuales no deseadas
-* Trolear, comentario insultantes/peyorativos y ataques personales o políticos
-* Acoso público o en privado
-* Publicar información privada de otras personas, así cómo direcciones físicas o electrónicas, sin permiso explícito
-* Cualquier otra conducta que pueda ser razonablemente considerada inapropiada en un sentido profesional
-
-## Nuestras responsabilidades
-
-Los mantenedores del proyecto son responsables de aclarar los estándares de comportamiento aceptable y se espera que tomen acciones correctivas justas y apropiadas en respuesta a cualquier caso de comportamiento inaceptable.
-
-Los mantenedores del proyecto tienen el derecho y la responsaiblidad de eliminar, editar o rechazar comentarios, commits, código, ediciones de wiki, problemas y otras contribuciones que no estén alineadas con este Código de Conducta, o de expulsar temporal o definitivamente a cualquier colaborador por otros comportamientos que consideren inapropiados, amenazantes, ofensivos, dañinos o que viole de cualquier modo este Código de Conducta.
-
-## Alcance
-
-Este Código de Conducta aplica en todos los espacios del proyecto y también aplica cuando un individuo está representando el proyecto o su comunidad en espacios públicos. Ejemplos de representación de un proyecto o la comunidad incluye usar un correo electrónico oficial del proyecto, publicaciones a través de una cuenta oficial de redes sociales o actuar como representante asignado en un evento en línea o en la vida real. La representación de un proyecto debe ser definida y aclarada con más detalle por los mantenedores del proyecto.
-
-## Aplicación
-
-Los casos de comportamiento abusivo, acoso, o de cualquier otro modo inaceptable se pueden informar contactando con el equipo del proyecto al correo <ripplex@ripple.com>. Todas las quejas serán revisadas e investigadas y resultarán en una resupuesta que se considere adecuada y necesaria a las circunstancias. El equipo del proyecto está obligado a mantener la confidencialidad con respecto al informador del incidente. Podría darse el caso de publicar más detalles sobre políticas de comportamiento específicas.
-
-Los mantenedores de proyecto que no sigan o hagan cumplir el Código de conducta de buena fe podrían enfrentarse a repercusiones temporales o definitivas según lo determinen otros miembros que lideren el proyecto.
-
-## Atribución
-
-Este Código de Conducta está adaptado de el [Pacto del Contribuidores][inicio], versión 1.4, disponible en https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
-
-[inicio]: https://www.contributor-covenant.org
-
-Para respuestas a preguntas comunes sobre este código de conducta, visita
-https://www.contributor-covenant.org/faq

CONTRIBUTING.es-ES.md

@@ -1,3 +0,0 @@
-# Contribuir
-
-Para obtener información sobre cómo contribuir a este repositorio, consulta [Contribute Documentation (XRPL.org)](https://xrpl.org/es_ES/contribute-documentation.html).

CONTRIBUTING.ja.md

@@ -1,3 +0,0 @@
-# コントリビューション
-
-コントリビューションの情報には[「ドキュメントへの貢献」](https://xrpl.org/ja/contribute-documentation.html)をご覧ください。

README.md

@@ -1,12 +1,10 @@
 # XRPL Dev Portal
 
-The [XRP Ledger Dev Portal](https://xrpl.org) is the authoritative source for XRP Ledger documentation, including the `rippled` server, client libraries, and other open-source XRP Ledger software.
+The [XRP Ledger Dev Portal](https://xrpl.org) is the authoritative source for XRP Ledger documentation, including the core server, client libraries, and other open-source XRP Ledger software.
 
 The site is built and published using Redocly. 
 
-NOTE: The toolchain used to build and publish the site has recently been migrated from Dactyl to Redocly. 
-
-Before you proceed, make sure you have Node version >= 18 LTS.
+Before you proceed, make sure you have Node.js and NPM installed. The site is tested with the current LTS release of each.
 
 To build the site locally:
 
@@ -26,58 +24,18 @@ To build the site locally:
 
         npm start
 
-For more details, see the [contribution guidelines (EN)](CONTRIBUTING.md) ([日本語](CONTRIBUTING.ja.md)) and the [contributor Code of Conduct (EN)](CODE-OF-CONDUCT.md) ([日本語](CODE-OF-CONDUCT.ja.md)).
-
-## Domain Verification Checker
-
-If you make changes to the [Domain Verification Checker](https://xrpl.org/validator-domain-verifier.html) tool and edit the domain-verifier-checker.js file, you will need to do the following:
-
-1. Install [webpack](https://webpack.js.org/) and required libraries via npm:
-
-        npm install webpack webpack-cli --save-dev
-        npm install ripple-binary-codec ripple-address-codec ripple-keypairs
-
-2. From the project root directory (this step may be different depending on how you installed webpack)
-
-        cd assets/js
-        webpack-cli domain-verifier-checker.js --optimize-minimize -o domain-verifier-bundle.js
-
-3. Build the site:
-
-        npm start
+For more details, see the [contribution guidelines (EN)](CONTRIBUTING.md) ([日本語](@l10n/ja/CONTRIBUTING.md)) and the [contributor Code of Conduct (EN)](CODE-OF-CONDUCT.md) ([日本語](@l10n/ja/CODE-OF-CONDUCT.md)).
 
 
-### Internationalization 
+### Localization / Translations
 
-This repo includes English (en) and Japanese (ja) locales. 
-
-This is done by setting up the internationalization (@l10n) folders, adding the `i18n` configuration to your `redocly.yaml` file, and adding the translated content in the respective language directory under the @l10n directory.
-
-To add support for a new language:
-
-1. Create a new subdirectory in the @l10n directory of the portal. For example, to add support for Spanish, create a new subdirectory "es-ES".
-
-2. Update the i18n configuration in your `redocly.yaml` file defining the display labels for the different languages you support.
-
-        l10n:
-          defaultLocale: en-US
-          locales:
-            - code: en-US
-              name: English
-            - code: ja
-              name: 日本語
-            - code: es-ES
-              name: Spanish
-
-3. Add the translated content in the respective language directory under the @l10n directory. 
-
-    The relative path from the language directory to the translated file must be the same as the relative path from the root of the portal to the file in the default language. For example, if you originally had a file with path `path/to/my/markdown.md`, the file translated to Spanish must be /`@l10n/es-ES/path/to/my/markdown.md`.
+The documentation in this repository is created in English first, then translated into other languages by community contributors. Currently, only the Japanese translations are live on the site; Spanish translation efforts are incomplete and not actively used. For information on the process of adding and maintaining translated files, see [Translations](https://xrpl.org/resources/contribute-documentation/documentation-translations).
 
 ## Issues, Projects, and Project Boards
 
 Use GitHub Issues under the [`xrpl-dev-portal`](https://github.com/XRPLF/xrpl-dev-portal) repository to report bugs, feature requests, and suggestions for the XRP Ledger Documentation or the `xrpl.org` website. 
 
-For issues related to `rippled` or client libraries (`xrpl.js`, `xrpl-py`, and others), use the respective source repository under [`https://github.com/XRPLF`](https://github.com/XRPLF).
+For issues related to `xrpld`/`rippled`, Clio, or client libraries (`xrpl.js`, `xrpl-py`, and others), use the respective source repository under [`https://github.com/XRPLF`](https://github.com/XRPLF).
 
 If you are a contributor, use GitHub Projects and Project Boards to plan and track updates to xrpl.org. 
 

_code-samples/issue-credentials/py/accept_credential.py

@@ -14,7 +14,7 @@ from xrpl.wallet import Wallet, generate_faucet_wallet
 from look_up_credentials import look_up_credentials
 from decode_hex import decode_hex
 
-XRPL_SERVER = "https://s.devnet.rippletest.net:51234/"
+XRPL_SERVER = "https://s.altnet.rippletest.net:51234/"
 
 client = JsonRpcClient(XRPL_SERVER)
 

_code-samples/issue-credentials/py/issuer_service.py

@@ -26,7 +26,7 @@ def init_wallet():
 wallet = init_wallet()
 print("Starting credential issuer with XRPL address", wallet.address)
 
-client = JsonRpcClient("https://s.devnet.rippletest.net:51234/")
+client = JsonRpcClient("https://s.altnet.rippletest.net:51234/")
 
 # Define Flask app ------------------------------------------------------------
 app = Flask(__name__)

_code-samples/issue-credentials/py/requirements.txt

@@ -1,2 +1,2 @@
-Flask==3.0.3
+Flask==3.1.3
 xrpl-py==4.0.0

blog/2026/rippled-3.1.1.md

@@ -92,7 +92,7 @@ On supported platforms, see the [instructions on installing or updating `rippled
 | [RPM for Red Hat / CentOS (x86-64)](https://repos.ripple.com/repos/rippled-rpm/stable/rippled-3.1.1-1.el9.x86_64.rpm) | `c6d028db1e2a4da898df68e5a92a893bebf1d167a0539d15ae27435f2155ccb2` |
 | [DEB for Ubuntu / Debian (x86-64)](https://repos.ripple.com/repos/rippled-deb/pool/stable/rippled_3.1.1-1_amd64.deb) | `cc30c33012bd83ed793b38738870cf931a96ae106fde60b71685c766da1d22e3` |
 
-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:
+For other platforms, please [build from source](https://github.com/XRPLF/rippled/blob/release-3.1/BUILD.md). The most recent commit in the git log should be the change setting the version:
 
 ```text
 commit c5988233d05bedddac28866ed37607f4869855f9

blog/2026/rippled-3.1.2.md

@@ -0,0 +1,61 @@
+---
+category: 2026
+date: "2026-03-12"
+template: '../../@theme/templates/blogpost'
+seo:
+    description: rippled version 3.1.2 is now available. This version contains important security updates.
+labels:
+    - rippled Release Notes
+markdown:
+    editPage:
+        hide: true
+---
+# Introducing XRP Ledger version 3.1.2
+
+Version 3.1.2 of `rippled`, the reference server implementation of the XRP Ledger protocol, is now available. This release contains fixes for security issues that, in the worst case scenario, could cause servers to crash or restart. There are no new features or amendments in this release.
+
+## Action Required
+
+**If you operate a `rippled` server**, then you should update to version 3.1.2 as soon as possible to ensure service continuity.
+
+### Impact of Not Upgrading
+
+If you do not upgrade, your server may experience restarts or outages.
+
+### 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-3.1.2-1.el9.x86_64.rpm) | `a51905bbffe97e714d0c66566e705704dea2783913a54c0fd62253f422d94713` |
+| [DEB for Ubuntu / Debian (x86-64)](https://repos.ripple.com/repos/rippled-deb/pool/stable/rippled_3.1.2-1_amd64.deb) | `0d162a2778f7e1bcd8611bbfd23b9cb6d466a7dd752494a6640a909145446494` |
+
+For other platforms, please [build from source](https://github.com/XRPLF/rippled/blob/release-3.1/BUILD.md). The most recent commit in the git log should be the change setting the version:
+
+```text
+commit 3ba3fcff4c4898a96a57838bb7c67a44a3d2ec5c
+Author: Mayukha Vadari <mvadari@gmail.com>
+Date:   Thu Mar 12 15:01:01 2026 -0400
+
+    release: Bump version to 3.1.2
+```
+
+## Full Changelog
+
+- refactor: Improve exception handling ([#6540](https://github.com/XRPLF/rippled/pull/6540))
+
+## Credits
+
+Thanks to the members of XRPL Commons who found and responsibly reported the issue: Luc Bocahut, Romain Thépaut, and Thomas Hussenet.
+
+The fix was developed in collaboration with the team at RippleX.
+
+## 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)

blog/sidebars.yaml

@@ -10,6 +10,7 @@
     - group: '2026'
       expanded: false
       items:
+        - page: 2026/rippled-3.1.2.md
         - page: 2026/vulnerabilitydisclosurereport-bug-feb2026.md
         - page: 2026/rippled-3.1.1.md
         - page: 2026/gpg-key-rotation.md

package.json

@@ -3,7 +3,7 @@
   "private": true,
   "version": "1.0.0",
   "type": "module",
-  "description": "The XRP Ledger Dev Portal is the authoritative source for XRP Ledger documentation, including the `rippled` server, client libraries, and other open-source XRP Ledger software.",
+  "description": "The XRP Ledger Dev Portal is the authoritative source for XRP Ledger documentation, including the core server, client libraries, and other open-source XRP Ledger software.",
   "scripts": {
     "build-css": "sass --load-path styles/scss styles/xrpl.scss ./static/css/devportal2024-v1.css --style compressed --no-source-map",
     "build-css-watch": "sass --watch --load-path styles/scss styles/xrpl.scss ./static/css/devportal2024-v1.css --style compressed --no-source-map",

redocly.yaml

@@ -6,6 +6,7 @@ ignore:
   - _code-samples/create-amm/ts/tsconfig.json
   - resources/contribute-blog/_blog-template.md
   - resources/contribute-documentation/_tutorial-template.md
+  - CODE-OF-CONDUCT.md
 l10n:
   defaultLocale: en-US
   locales:
@@ -43,6 +44,81 @@ metadataGlobs:
     redocly_category: Community
 seo:
   siteUrl: https://xrpl.org/
+  llmstxt:
+    hide: false
+    title: XRPL Developer Portal & Documentation
+    description: >-
+      Explore XRP Ledger documentation, blogs, and other blockchain
+      developer resources needed to start building and integrating with the ledger.
+    details:
+      content: >-
+        XRP Ledger concepts, use cases, tutorials, references, and other blockchain
+        developer resources. Also, stay up to date with release announcements
+        and more through the XRPL Blog.
+    sections:
+      - title: Introduction
+        description: A high-level introduction to the XRP Ledger.
+        includeFiles:
+          - docs/introduction/**/*.*
+          - about/faq.md
+        excludeFiles:
+          - docs/introduction/index.md
+      - title: Use Cases
+        description: Real-world applications and business scenarios for the XRP Ledger.
+        includeFiles:
+          - docs/use-cases/**/*.*
+        excludeFiles:
+          - docs/use-cases/index.md
+          - docs/use-cases/defi/index.md
+      - title: Concepts
+        description: Core concepts including accounts, tokens, transactions, consensus, and more.
+        includeFiles:
+          - docs/concepts/**/*.*
+        excludeFiles:
+          - docs/concepts/index.md
+          - docs/concepts/decentralized-storage/index.md
+          - docs/concepts/payment-types/index.md
+      - title: Tutorials
+        description: Step-by-step guides for building on the XRP Ledger in JavaScript, Python, Go, and more.
+        includeFiles:
+          - docs/tutorials/**/*.*
+      - title: References
+        description: Protocol specification, transaction types, ledger entries, and API methods.
+        includeFiles:
+          - docs/references/**/*.*
+        excludeFiles:
+          - docs/references/xrp-api.md
+          - docs/references/data-api.md
+          - docs/references/protocol/index.md
+          - docs/references/protocol/ledger-data/ledger-entry-types/index.md
+          - docs/references/protocol/transactions/index.md
+          - docs/references/protocol/transactions/types/index.md
+          - docs/references/http-websocket-apis/api-conventions/index.md
+          - docs/references/http-websocket-apis/public-api-methods/*/index.md
+          - docs/references/http-websocket-apis/admin-api-methods/*/index.md
+      - title: Infrastructure
+        description: Install, configure, and troubleshoot rippled and Clio servers.
+        includeFiles:
+          - docs/infrastructure/**/*.*
+        excludeFiles:
+          - docs/infrastructure/index.md
+          - docs/infrastructure/*/index.md
+          - docs/infrastructure/installation/build-run-rippled-in-reporting-mode.md
+          - docs/infrastructure/configuration/data-retention/index.md
+          - docs/infrastructure/configuration/server-modes/index.md
+      - title: Blog (2023+)
+        description: Recent XRPL Blog posts (showing 2023 and newer).
+        includeFiles:
+          - blog/2023/**/*.*
+          - blog/2024/**/*.*
+          - blog/2025/**/*.*
+          - blog/2026/**/*.*
+      - title: Resources
+        description: Developer resources and contribution guidelines.
+        includeFiles:
+          - resources/**/*.*
+        excludeFiles:
+          - resources/index.md
 analytics:
   gtm:
     includeInDevelopment: true