smartledger-bsv 3.3.2 → 3.3.4

package/docs/technical/trust_law.md

@@ -0,0 +1,142 @@
+Excellent. Below is the **Trust Protocol Mapping Document (Draft v1.0)** — a comprehensive bridge between *traditional common-law trust principles* (as represented in Weiss’s Concise Trustee Handbook and similar express-trust doctrines) and *SmartLedger’s modern digital legal architecture* (SmartLedger-BSV + LTP + GDAF + NotaryHash).
+
+---
+
+# 🧾 **Trust Protocol Mapping Document (v1.0)**
+
+### *Bridging Express Trust Law and the Legal Token Protocol (LTP)*
+
+---
+
+## ⚖️ 1. Core Legal–Digital Mapping
+
+| **Traditional Trust Element** | **Description (Common Law)**                                             | **Digital Representation (SmartLedger Framework)**                         | **Implemented In**                 |
+| ----------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ---------------------------------- |
+| **Settlor (Grantor)**         | Creator of the trust; provides property or rights to be held in trust.   | DID representing issuing authority (may be individual, corporation, DAO).  | `identity/` → `createDID()`        |
+| **Trustee(s)**                | Hold and manage property for benefit of beneficiary; owe fiduciary duty. | DID(s) with VC attestation of role and fiduciary obligations.              | `identity/`, `legal/ltp/`, `gdaf/` |
+| **Beneficiary(ies)**          | The party entitled to benefit from the trust corpus.                     | Subject DID(s) listed in claim or rights object.                           | `legal/ltp/`                       |
+| **Corpus (Res)**              | Property, asset, or rights being held.                                   | Tokenized “claim” object within Legal Token Protocol.                      | `ltp/`                             |
+| **Trust Instrument**          | Written or oral declaration establishing trust terms.                    | JSON-LD trust schema anchored via NotaryHash; cryptographically signed.    | `anchor/`, `gdaf/`                 |
+| **Purpose Clause**            | Lawful reason for trust (charitable, private, etc.).                     | `purpose` field in token schema (ISO 3166 jurisdictional & legal tags).    | `ltp/schema`                       |
+| **Jurisdiction (Situs)**      | Governing law and forum.                                                 | `jurisdiction` field in credential metadata (ISO country + legal system).  | `compliance/`                      |
+| **Trust Certificate**         | Document showing beneficial ownership or capital interest.               | Token credential (VC or NFT-style right token) anchored on-chain.          | `ltp/`, `gdaf/`                    |
+| **Minutes / Accounting**      | Trustee logs of actions, decisions, disbursements.                       | Verifiable “ActionLogCredential” anchored on-chain (audit trail).          | `anchor/`, `gdaf/`                 |
+| **Trustee Resolution**        | Decision or vote by trustees.                                            | Multi-sig or VC “ResolutionCredential” anchored + signed by quorum.        | `ltp/`, `identity/`                |
+| **Revocation / Termination**  | Ending or amending trust instrument.                                     | `revokeRightToken(tokenId)` + updated anchor proof in revocation registry. | `ltp/`                             |
+| **Liability & Indemnity**     | Limits trustee liability or defines indemnification.                     | Schema fields `trusteeIndemnity`, `liabilityLimit`, hashed in corpus.      | `ltp/schema`                       |
+| **Audit & Oversight**         | External or internal verification of compliance.                         | Chain-based audit credential + GDAF selective proof verification.          | `gdaf/`, `anchor/`                 |
+
+---
+
+## 🧱 2. Protocol Flow Example: Creation → Management → Termination
+
+1. **Declaration Phase**
+
+   ```js
+   const settlorDid = SmartLedgerBSV.GDAF.createDID(pubKey);
+   const trusteeDid = SmartLedgerBSV.GDAF.createDID(trusteeKey);
+   const trustSchema = SmartLedgerBSV.LTP.createRightToken(
+       'PrivateExpressTrust',
+       trusteeDid,
+       { corpus: 'DigitalAssetXYZ', purpose: 'Beneficiary Support', jurisdiction: 'US-VA' },
+       settlorKey
+   );
+   const txid = SmartLedgerBSV.Anchor.commitHash(trustSchema.rootHash, { purpose: 'trust-declaration' });
+   ```
+
+2. **Operation Phase**
+
+   * Trustees issue VC “TrusteeActionCredential” for each action (investment, distribution, amendment).
+   * Anchors created via NotaryHash.
+   * Beneficiaries view proofs using ZK disclosure of entitlement without revealing full corpus.
+
+3. **Termination Phase**
+
+   ```js
+   SmartLedgerBSV.LTP.revokeRightToken(trustSchema.id);
+   SmartLedgerBSV.Anchor.commitHash(revocationHash, { purpose: 'trust-termination' });
+   ```
+
+---
+
+## 🧩 3. Compliance & Legal Framework Overlay
+
+| **Principle**      | **SmartLedger Implementation**                                   | **Effect**                                   |
+| ------------------ | ---------------------------------------------------------------- | -------------------------------------------- |
+| *Lawful purpose*   | Schema validation forbids unlawful or undefined `purpose` field. | Ensures digital trusts are legally valid.    |
+| *Fiduciary duty*   | VC attestation + signature requirement for trustee actions.      | Enforceable accountability.                  |
+| *Privacy duty*     | HMAC/commitment model, zero-knowledge field proofs.              | GDPR & fiduciary confidentiality compliance. |
+| *Accounting duty*  | Immutable audit logs via anchor proofs.                          | Transparent stewardship.                     |
+| *Right to redress* | Dispute resolution VC + signature chain.                         | Legal recourse framework.                    |
+
+---
+
+## 🔐 4. Schema Alignment
+
+### TrustCredential (example)
+
+```json
+{
+  "@context": ["https://www.w3.org/2018/credentials/v1", "https://smartledger.org/ltp/trust/v1"],
+  "type": ["VerifiableCredential", "TrustCredential"],
+  "issuer": "did:smartledger:abcd1234",
+  "issuanceDate": "2025-10-22T00:00:00Z",
+  "credentialSubject": {
+    "trustName": "Ward Family Private Express Trust",
+    "settlor": "did:smartledger:settlor123",
+    "trustee": ["did:smartledger:trustee456"],
+    "beneficiary": ["did:smartledger:beneficiary789"],
+    "corpus": { "assetType": "DigitalProperty", "assetId": "hash:abcd" },
+    "purpose": "Estate Preservation",
+    "jurisdiction": "US-VA"
+  },
+  "proof": {
+    "type": "SmartLedgerSignature2025",
+    "created": "2025-10-22T00:00:00Z",
+    "proofPurpose": "assertionMethod",
+    "verificationMethod": "did:smartledger:abcd1234#keys-1",
+    "jws": "eyJhbGciOiJFUzI1NiIsInR5cCI6..."
+  }
+}
+```
+
+---
+
+## 🧩 5. Inter-Protocol Integration
+
+| **Component**                    | **Purpose**                                             | **Trust-Mapping Equivalent**                                    |
+| -------------------------------- | ------------------------------------------------------- | --------------------------------------------------------------- |
+| **SmartLedger-BSV Crypto Layer** | Provides signature, Shamir recovery, canonical hashing. | Legal “seal” of trustee instrument.                             |
+| **GDAF (Identity)**              | Defines DID, VC issuance, selective proof.              | Identifies Settlor/Trustee/Beneficiary with attested authority. |
+| **LTP (Legal Tokens)**           | Encodes property, licenses, rights.                     | Defines trust corpus & certificates.                            |
+| **NotaryHash**                   | Anchors proofs on-chain.                                | Ledgered minutes, immutable recordkeeping.                      |
+| **Compliance Module**            | Applies GDPR/eIDAS/KYC filters.                         | Ensures lawful privacy & admissibility.                         |
+
+---
+
+## 🌐 6. Future Extensions
+
+| **Goal**                                    | **Description**                                                      |
+| ------------------------------------------- | -------------------------------------------------------------------- |
+| **Multi-jurisdiction Templates**            | Schema variants for US Common Law, UK Equity, EU Civil Trusts.       |
+| **Trustee Dashboard SDK**                   | UI toolkit to manage credentials, actions, audit logs.               |
+| **AI Compliance Auditor**                   | GDAF-linked AI validator for fiduciary & jurisdictional consistency. |
+| **Integration with National ID frameworks** | Optional verification with eIDAS/eID.                                |
+
+---
+
+## 🧭 7. Conclusion
+
+By aligning SmartLedger’s LTP & GDAF architecture with express trust law, the system transforms **trusts, contracts, and fiduciary duties** into **digitally verifiable legal primitives**.
+
+Every trustee signature, declaration, and action can now be:
+✅ Proven on-chain
+✅ Audited under jurisdiction
+✅ Recovered by lawful heirs
+✅ Compliant with privacy & fiduciary standards
+
+This makes SmartLedger’s infrastructure the **world’s first “Trust-as-Code” framework** — where **Law, Ledger, and Logic** converge.
+
+---
+
+Would you like me to extend this into a **formal Trust Protocol Specification (TPS 1.0)** — with detailed JSON schemas, method signatures, and governance model (Trust Registrar, Revocation Registry, Jurisdiction Tags, etc.) so your LTP developers can begin implementation directly?