From 01ba991173ea8f127e4a710e13190f1983586f7d Mon Sep 17 00:00:00 2001
From: Ze0ro99 <146000493+Ze0ro99@users.noreply.github.com>
Date: Sat, 11 Apr 2026 03:32:11 +0000
Subject: [PATCH] =?UTF-8?q?=E2=9A=96=EF=B8=8F=20PR=2015:=20Justice=20Engin?=
 =?UTF-8?q?e=20&=20Dispute=20Resolution=20(228/233)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/PiRC-228-Dispute-Resolution.md           | 16 ++++++++++++++
 ...PiRC-233-Flash-Loan-Resistance-Standard.md | 21 +++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 docs/PiRC-228-Dispute-Resolution.md
 create mode 100644 docs/PiRC-233-Flash-Loan-Resistance-Standard.md

diff --git a/docs/PiRC-228-Dispute-Resolution.md b/docs/PiRC-228-Dispute-Resolution.md
new file mode 100644
index 000000000..d5dde5ca0
--- /dev/null
+++ b/docs/PiRC-228-Dispute-Resolution.md
@@ -0,0 +1,16 @@
+# PiRC-228: Decentralized Dispute Resolution
+
+## 1. Executive Summary
+This standard establishes the "Justice Engine" interface, allowing certified sovereign entities (Judges/Arbitrators) to lock, review, and re-allocate disputed digital assets based on cryptographic consensus.
+
+## 2. Architecture
+- Asset locking mechanism via judicial multisig.
+- Verifiable dispute case tracking.
+- Parity-safe reallocation.
+
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC228JusticeEngine.sol`  
+**Soroban**: `contracts/soroban/src/dispute_resolution.rs`
+
+**Status**: Ready.
+
diff --git a/docs/PiRC-233-Flash-Loan-Resistance-Standard.md b/docs/PiRC-233-Flash-Loan-Resistance-Standard.md
new file mode 100644
index 000000000..2860d5708
--- /dev/null
+++ b/docs/PiRC-233-Flash-Loan-Resistance-Standard.md
@@ -0,0 +1,21 @@
+# PiRC-233: Flash-Loan Resistance Standard
+
+## 1. Executive Summary
+This standard provides mechanisms to protect Pi Network DeFi protocols from flash-loan attacks, utilizing block-delay locks and time-weighted parity checks.
+
+**Dependencies**: PiRC-207
+**Status**: Complete reference implementation
+
+## 2. Architecture
+- Block-delay locks (preventing same-block deposit and borrow/withdraw)
+- Time-Weighted Average Parity (TWAP) checks
+- Reentrancy guards with state-sync validation
+
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC233FlashResistance.sol`
+**Soroban**: `contracts/soroban/src/flash_resistance.rs`
+
+## 4. Implementation Roadmap
+- Phase 1: Same-block execution prevention
+- Phase 2: TWAP integration
+- Phase 3: Ecosystem-wide rollout