From 1a55666256b222775eab3f5a8b3a44061ac097e7 Mon Sep 17 00:00:00 2001
From: Ze0ro99 <146000493+Ze0ro99@users.noreply.github.com>
Date: Wed, 8 Apr 2026 12:32:09 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=94=90=20PR=2013:=20Institutional=20Custo?=
 =?UTF-8?q?dy=20&=20Escrow=20Vaults=20(223,=20246)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/PiRC-223-Institutional-Custody.md       |  8 ++++++++
 docs/PiRC-246-Institutional-Escrow-Vaults.md | 21 ++++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 docs/PiRC-223-Institutional-Custody.md
 create mode 100644 docs/PiRC-246-Institutional-Escrow-Vaults.md

diff --git a/docs/PiRC-223-Institutional-Custody.md b/docs/PiRC-223-Institutional-Custody.md
new file mode 100644
index 00000000..5ed48ae4
--- /dev/null
+++ b/docs/PiRC-223-Institutional-Custody.md
@@ -0,0 +1,8 @@
+# PiRC-223: Multi-Signature Institutional Custody
+Defines a secure vault for institutional participants requiring $M$ of $N$ signatures based on PiRC-209 verified DIDs.
+---
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC223InstitutionalCustody.sol`  
+**Soroban**: `contracts/soroban/src/custody.rs`
+
+**Status**: Ready.
diff --git a/docs/PiRC-246-Institutional-Escrow-Vaults.md b/docs/PiRC-246-Institutional-Escrow-Vaults.md
new file mode 100644
index 00000000..9dfd3041
--- /dev/null
+++ b/docs/PiRC-246-Institutional-Escrow-Vaults.md
@@ -0,0 +1,21 @@
+# PiRC-246: Institutional Escrow Vaults
+
+## 1. Executive Summary
+This standard defines secure, multi-signature institutional escrow vaults. It ensures that large-scale wholesale capital transfers are held in trust until predefined cryptographic conditions (e.g., PiRC-245 settlement batching or PiRC-214 Oracle triggers) are met.
+
+**Dependencies**: PiRC-209, PiRC-228
+**Status**: Complete reference implementation
+
+## 2. Architecture
+- Multi-signature approval mechanisms
+- Time-locked and condition-locked escrow
+- Integration with Justice Engine for dispute resolution
+
+## 3. Reference Smart Contracts
+**Solidity**: `contracts/PiRC246EscrowVault.sol`
+**Soroban**: `contracts/soroban/src/escrow_vault.rs`
+
+## 4. Implementation Roadmap
+- Phase 1: Multi-sig and time-lock logic
+- Phase 2: Oracle-based condition triggers
+- Phase 3: Justice Engine dispute integration