@the_library/web3-registry-addresses 1.0.0

package/LICENCE

@@ -0,0 +1,104 @@
+# D-CODE SOVEREIGN LICENCE (v1.2)
+
+### PROPRIETARY PUBLIC SOURCE | D-SAFE COMPLIANT
+
+**COPYRIGHT:** © 2026 DATAPOND PUBLIC LIBRARY TRUST - Australia
+**TECHNICAL GUARDIAN:** POND ENTERPRISE PTY LTD - Australia
+
+---
+
+## 1. PREAMBLE & DEFINITIONS
+
+This software is a fundamental component of the DataPond Ecosystem, designed to build a decentralized, indestructible public library. Unlike standard open-source licenses, this **D-Open Sovereign Licence** is a conditional grant of rights tied strictly to the ethical and technical preservation of the Public Domain.
+
+**Definitions:**
+* **"The Software"**: The source code, data models (ORM generated), and Web3 utilities contained in this package.
+* **"D-Licence Compliance"**: Usage that is strictly Non-Commercial, Free of Paywalls, Free of User Account Requirements (Login Walls), Free of Advertising, Free of Political Campaigning or Agendas, and Free of Social Media mechanisms.
+* **"The Canonical Config"**: The dynamic blockchain configuration hosted at `https://datapond.earth/web3-config`.
+* **"The Guardian"**: Pond Enterprise Pty Ltd, the mandated commercial entity responsible for technical certification and liability management.
+
+---
+
+## 2. GRANT OF RIGHTS (CONDITIONAL)
+
+The Trust hereby grants you a worldwide, royalty-free, non-exclusive license to use, copy, modify, and distribute The Software, SUBJECT TO the following strict conditions:
+
+1.  **Public Access (Anti-Enclosure):** You may not use this Software in any application that restricts access to the underlying public data via payment (Paywalls), mandatory registration (Login Walls), or requires viewing advertisements.
+2.  **Strict Neutrality:** The Software cannot be integrated into platforms driven by political agendas or social media algorithms designed for engagement framing.
+3.  **D-SAFE Integrity:** Any content served, managed, or trained upon by this Software must strictly adhere to the **D-SAFE Specification** (detailed in Section 8).
+4.  **Viral AI Training (The "Copyleft" AI Clause):** Usage of this data for Artificial Intelligence training is conditionally permitted. The resulting AI model must itself be published strictly under this **D-CODE SOVEREIGN LICENCE**. Because this license enforces D-SAFE Integrity, the AI model cannot be legally trained if its broader dataset includes non-DSAFE materials (e.g., hate speech, explicit content). Any AI model that trains on this data but fails to release under this license and adhere to D-SAFE standards is operating illegally and is in material breach of this license.
+
+---
+
+## 3. TECHNICAL ANCHORS & HARD-FORK RESILIENCE
+
+To ensure the permanence and provenance of the library:
+
+1.  **Immutable Addresses:** You are prohibited from manually modifying the hard-coded Smart Contract addresses or D-SAFE Source URLs embedded in this package to point to non-certified ledgers.
+2.  **Dynamic Synchronization:** Your implementation must utilize the **Canonical Config** API endpoint to resolve the current, active Smart Contract addresses. This ensures resilience against blockchain hard-forks or contract migrations initiated by The Guardian.
+3.  **Prohibited Forking:** You may not "fork" this package to redirect the DataPond models to a private, centralized database. Doing so constitutes a material breach of this license.
+
+---
+
+## 4. OFFLINE & SNAPSHOT RESILIENCE
+
+Acknowledging the goal of "Indestructible" access:
+
+1.  **Snapshot Rights:** You are permitted to download, cache, and deploy The Software in **100% Offline Environments** (e.g., air-gapped schools, bunkers, remote field operations) where a connection to the Canonical Config or Blockchain is impossible.
+2.  **Static Validity:** In such offline cases, the hard-coded addresses at the time of the "Snapshot" shall be deemed valid, provided the snapshot was originally sourced from a D-SAFE certified release.
+
+---
+
+## 5. THE "KUKRI" LIABILITY SHIELD
+
+**WARNING:** BY USING THIS SOFTWARE, YOU AGREE TO THE FOLLOWING LIABILITY STRUCTURE:
+
+1.  **The Sanctuary (Trust) Disclaimer:** The DataPond Public Library Trust is a non-profit entity holding the assets. It provides this Software "AS IS" and holds **ZERO LIABILITY** for any damages, gas fees, or data loss arising from its use.
+2.  **The Shield (Guardian) Direction:** Any and all claims regarding technical performance, patent infringement, or professional indemnity related to the core architecture of The Software must be directed exclusively to **Pond Enterprise Pty Ltd**.
+3.  **User Indemnity:** You agree to indemnify and hold harmless The Trust and The Guardian against any claims arising specifically from **your specific implementation**, modification, or misuse of The Software (e.g., if you build an illegal interface using our models).
+
+---
+
+## 6. BREACH & CURE PERIOD
+
+1.  **Automatic Termination:** If you violate any term of this license (specifically Section 2 or 3), your rights under this license terminate automatically.
+2.  **30-Day Cure Period:** Before commencing legal action for Intellectual Property infringement, The Trust or The Guardian will provide public or private notice of the breach. You have **thirty (30) days** from the date of such notice to correct the breach (e.g., remove the paywall or restore the correct Smart Contract addresses).
+3.  **Permanent Revocation:** Failure to cure the breach within 30 days results in permanent revocation of rights and potential legal action.
+
+---
+
+## 7. SOVEREIGN OVERRIDE & NON-SEVERABILITY
+
+This license is an indivisible whole. There is no severability clause. This license is **VOID** and usage of The Software is unconditionally **PROHIBITED** in any jurisdiction where:
+1.  Decentralized data storage or blockchain technology is illegal.
+2.  The usage of uncensored public domain data is prohibited by law.
+3.  Any clause within this license is deemed legally unenforceable by that state.
+
+The Trust will not conduct business or facilitate infrastructure in such restrictive jurisdictions. It is up to the restrictive state to block the DNS or network routing of DataPond.
+
+---
+
+## 8. D-SAFE SPECIFICATION
+
+To qualify for D-Licence Compliance, the data and its surrounding implementation must maintain **D-SAFE Integrity**. A prerequisite for the D-SAFE designation is that all associated content must adhere to the four pillars of the D-Licence:
+
+*   **Decentralized:** The content must live on permanent, distributed infrastructure (such as the Arweave Permaweb), ensuring guaranteed access free from corporate kill-switches.
+*   **Integral:** There must be zero money flow attached to the data—no ads, no sponsorships, and no paywalls. It is a pure exchange of ideas.
+*   **Common:** Rooted in CC BY-NC-ND 4.0; the content demands attribution, must strictly be Non-Commercial, and permits no derivatives.
+
+Building upon that foundation, the network and the application utilizing The Software must adhere to strict zero-tolerance policies and be entirely free from the following:
+
+1.  **No Ecological Harm:** Strictly prohibits content that advocates for, or condones, environmental degradation, including but not limited to deforestation, pollution, and the endangerment of species.
+2.  **No AI Generation:** Restricted exclusively to human-authored content; materials generated by artificial intelligence are expressly prohibited.
+3.  **No Explicit/Violence:** Content must be universally suitable for all ages and compliant with all applicable laws, strictly prohibiting explicit material and depictions of violence.
+4.  **No Stolen Content:** Mandates original authorship; all content must be free of plagiarism and must not infringe upon the intellectual property rights or copyrights of third parties.
+5.  **No Politics:** Expressly prohibits materials related to political campaigning, partisan debate, or the promotion of political affiliations.
+6.  **No Spirituality:** Excludes the dissemination of spiritual doctrines, religious proselytization, and non-empirical theological claims.
+7.  **No History:** Prohibits the inclusion of historical claims, historiographical disputes, or speculative historical narratives.
+8.  **No Medicine:** Strictly forbids the provision of medical advice, clinical diagnoses, treatment recommendations, or suggested remedies.
+9.  **No Fiction:** Restricted entirely to factual, real-world information; all works of fiction or fabricated narratives are excluded.
+10. **No Psychological Profiling:** Prohibits studies or materials that engage in psychological profiling or the broad generalization of human behavior based on demographic factors such as race, culture, or identity.
+
+---
+
+**GOVERNING LAW:** This Licence is governed by the laws of **South Australia**.

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { Tech, AddressRegistryReadAPI } from '@the_library/web3-core';
+
+interface CacheEntry {
+    address: string;
+    abi: any;
+    txId: string;
+    originalName: string;
+}
+interface RegistryCache {
+    timestamp: number;
+    entries: {
+        [contractName: string]: CacheEntry;
+    };
+}
+declare class RegistryAddressLoader {
+    private memoryCache;
+    private getCacheKey;
+    private getFromLocalStorage;
+    private saveToLocalStorage;
+    private fetchAbiFromArweave;
+    Initialize(tech: Tech, chainId: number | string, registry: AddressRegistryReadAPI): Promise<Record<string, string>>;
+    getAddress(tech: string, chainId: string | number, name: string): string | undefined;
+    getAbi(tech: string, chainId: string | number, name: string): any;
+}
+declare const registryAddressLoader: RegistryAddressLoader;
+
+export { type CacheEntry, RegistryAddressLoader, type RegistryCache, registryAddressLoader };

package/dist/index.js

@@ -0,0 +1,3 @@
+var u="dcode_registry_cache_v2_",R=1440*60*1e3,d=class{constructor(){this.memoryCache=new Map;}getCacheKey(t,e){return `${u}${t}_${e}`}getFromLocalStorage(t){let e=localStorage.getItem(t);if(!e)return null;try{return JSON.parse(e)}catch(s){return console.error(`[RegistryLoader] Failed to parse cache for ${t}`,s),null}}saveToLocalStorage(t,e){localStorage.setItem(t,JSON.stringify(e));}async fetchAbiFromArweave(t){if(!t)return null;try{let e=await fetch(`https://arweave.net/${t}`);if(e.ok){let s=await e.json();return `${t}`,s}console.error(`[RegistryLoader] Arweave fetch failed for ${t}: ${e.status} ${e.statusText}`);}catch(e){console.warn(`[RegistryLoader] Failed to fetch ABI from Arweave (${t}):`,e);}return null}async Initialize(t,e,s){let a=this.getCacheKey(t,e),c=Date.now(),o=this.memoryCache.get(a)||this.getFromLocalStorage(a);if(o&&c-o.timestamp<R){this.memoryCache.set(a,o);let r={};return Object.values(o.entries).forEach(n=>{let i=n.originalName.charAt(0).toLowerCase()+n.originalName.slice(1);r[i]=n.address;}),r}let l=await s.getAllContractNames();`${l.length}${t}${e}`;let h={},y={};for(let r of l)try{let[n,i]=await s.getLatestContract(r),g=r.toLowerCase(),C=r.charAt(0).toLowerCase()+r.slice(1),m=null;o&&o.entries[g]&&o.entries[g].txId===i?m=o.entries[g].abi:i?(`${r}${i}`,m=await this.fetchAbiFromArweave(i)):console.warn(`[RegistryLoader] No ABI URL found for ${r} on ${t}:${e}`),h[g]={address:n,abi:m,txId:i,originalName:r},y[C]=n;}catch(n){console.warn(`[RegistryLoader] Failed to load contract ${r} for ${t}:${e}:`,n);}let f={timestamp:c,entries:h};return this.memoryCache.set(a,f),this.saveToLocalStorage(a,f),y}getAddress(t,e,s){let a=this.getCacheKey(t,e);return this.memoryCache.get(a)?.entries[s.toLowerCase()]?.address}getAbi(t,e,s){let a=this.getCacheKey(t,e);return this.memoryCache.get(a)?.entries[s.toLowerCase()]?.abi}},$=new d;
+export{d as RegistryAddressLoader,$ as registryAddressLoader};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts"],"names":["CACHE_KEY_PREFIX","CACHE_DURATION_MS","RegistryAddressLoader","tech","chainId","key","data","e","cache","abiUrl","res","abi","registry","cacheKey","now","addresses","entry","camelCaseName","contractNames","newEntries","name","address","normalizedName","newCache","registryAddressLoader"],"mappings":"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","file":"index.js","sourcesContent":["import { ReadOnlyDomainAPI, Tech, AddressRegistryReadAPI } from '@the_library/web3-core';\n\nconst CACHE_KEY_PREFIX = 'dcode_registry_cache_v2_';\nconst CACHE_DURATION_MS = 24 * 60 * 60 * 1000; // 24 hours\n\nexport interface CacheEntry {\n    address: string;\n    abi: any;\n    txId: string;\n    originalName: string;\n}\n\nexport interface RegistryCache {\n    timestamp: number;\n    entries: {\n        [contractName: string]: CacheEntry;\n    };\n}\n\nexport class RegistryAddressLoader {\n    private memoryCache: Map<string, RegistryCache> = new Map();\n\n    private getCacheKey(tech: string, chainId: string | number): string {\n        return `${CACHE_KEY_PREFIX}${tech}_${chainId}`;\n    }\n\n    private getFromLocalStorage(key: string): RegistryCache | null {\n        const data = localStorage.getItem(key);\n        if (!data) return null;\n        try {\n            return JSON.parse(data);\n        } catch (e) {\n            console.error(`[RegistryLoader] Failed to parse cache for ${key}`, e);\n            return null;\n        }\n    }\n\n    private saveToLocalStorage(key: string, cache: RegistryCache): void {\n        localStorage.setItem(key, JSON.stringify(cache));\n    }\n\n    private async fetchAbiFromArweave(abiUrl: string): Promise<any> {\n        if (!abiUrl) return null;\n        try {\n            const res = await fetch(`https://arweave.net/${abiUrl}`);\n            if (res.ok) {\n                const abi = await res.json();\n                console.log(`[RegistryLoader] Successfully fetched ABI for ${abiUrl}`);\n                return abi;\n            }\n            console.error(`[RegistryLoader] Arweave fetch failed for ${abiUrl}: ${res.status} ${res.statusText}`);\n        } catch (e) {\n            console.warn(`[RegistryLoader] Failed to fetch ABI from Arweave (${abiUrl}):`, e);\n        }\n        return null;\n    }\n\n    public async Initialize(tech: Tech, chainId: number | string, registry: AddressRegistryReadAPI): Promise<Record<string, string>> {\n        const cacheKey = this.getCacheKey(tech, chainId);\n        const now = Date.now();\n\n        let cache = this.memoryCache.get(cacheKey) || this.getFromLocalStorage(cacheKey);\n\n        // Time Check: Has it been less than 24 hours?\n        if (cache && (now - cache.timestamp < CACHE_DURATION_MS)) {\n            console.log(`[RegistryLoader] Cache valid for ${tech}:${chainId}`);\n            this.memoryCache.set(cacheKey, cache);\n            const addresses: Record<string, string> = {};\n            Object.values(cache.entries).forEach(entry => {\n                const camelCaseName = entry.originalName.charAt(0).toLowerCase() + entry.originalName.slice(1);\n                addresses[camelCaseName] = entry.address;\n            });\n            return addresses;\n        }\n\n        console.log(`[RegistryLoader] Cache expired or missing for ${tech}:${chainId}. Performing Full Sync...`);\n\n        const contractNames = await registry.getAllContractNames();\n        console.log(`[RegistryLoader] Retrieved ${contractNames.length} contract names for ${tech}:${chainId}:`, contractNames);\n        const newEntries: { [name: string]: CacheEntry } = {};\n        const addresses: Record<string, string> = {};\n\n        for (const name of contractNames) {\n            try {\n                const [address, abiUrl] = await registry.getLatestContract(name);\n                const normalizedName = name.toLowerCase();\n                const camelCaseName = name.charAt(0).toLowerCase() + name.slice(1);\n\n                let abi = null;\n                // Try to reuse ABI from old cache if txId matches\n                if (cache && cache.entries[normalizedName] && cache.entries[normalizedName].txId === abiUrl) {\n                    abi = cache.entries[normalizedName].abi;\n                } else if (abiUrl) {\n                    console.log(`[RegistryLoader] Fetching new ABI for ${name} (${abiUrl})...`);\n                    abi = await this.fetchAbiFromArweave(abiUrl);\n                } else {\n                    console.warn(`[RegistryLoader] No ABI URL found for ${name} on ${tech}:${chainId}`);\n                }\n\n                newEntries[normalizedName] = {\n                    address,\n                    abi,\n                    txId: abiUrl,\n                    originalName: name\n                };\n                addresses[camelCaseName] = address;\n            } catch (e) {\n                console.warn(`[RegistryLoader] Failed to load contract ${name} for ${tech}:${chainId}:`, e);\n            }\n        }\n\n        const newCache: RegistryCache = {\n            timestamp: now,\n            entries: newEntries\n        };\n\n        this.memoryCache.set(cacheKey, newCache);\n        this.saveToLocalStorage(cacheKey, newCache);\n        return addresses;\n    }\n\n    public getAddress(tech: string, chainId: string | number, name: string): string | undefined {\n        const cacheKey = this.getCacheKey(tech, chainId);\n        const cache = this.memoryCache.get(cacheKey);\n        return cache?.entries[name.toLowerCase()]?.address;\n    }\n\n    public getAbi(tech: string, chainId: string | number, name: string): any {\n        const cacheKey = this.getCacheKey(tech, chainId);\n        const cache = this.memoryCache.get(cacheKey);\n        return cache?.entries[name.toLowerCase()]?.abi;\n    }\n}\n\nexport const registryAddressLoader = new RegistryAddressLoader();\n"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+    "name": "@the_library/web3-registry-addresses",
+    "version": "1.0.0",
+    "description": "Common package for handling Web3 AddressRegistry sessions and caching",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "typecheck": "tsc --noEmit"
+    },
+    "keywords": [
+        "web3",
+        "registry",
+        "address",
+        "session",
+        "cache"
+    ],
+    "sideEffects": false,
+    "author": "Med Pond",
+    "license": "SEE LICENSE IN LICENCE",
+    "devDependencies": {
+        "@types/node": "^22.10.0",
+        "tsup": "^8.0.1",
+        "typescript": "^5.3.3"
+    },
+    "dependencies": {
+        "@the_library/web3-contracts": "workspace:*",
+        "@the_library/web3-core": "workspace:*"
+    }
+}