epistery 1.4.0 → 1.4.1

package/README.md

@@ -201,38 +201,28 @@ url=https://rootz.digital/api/v0
 [cli]
 default_domain=localhost
 
-# Legacy single provider (still supported):
-[default.provider]
-chainId=137
-name=Polygon Mainnet
-rpc=https://polygon-rpc.com
+# Which chain the claim-page dropdown selects by default.
+[default]
+defaultChainId=137
+
+# Private RPC overrides, keyed by chainId. Only needed when the chain's
+# built-in public RPC isn't sufficient (rate-limited, needs an API key).
+# Everything else — name, public RPC, currency, fee policy — lives in
+# the chain classes (src/chains/) and doesn't need to be configured.
+
+[default.rpc.137]
+privateRpc=https://polygon-mainnet.infura.io/v3/YOUR_KEY
+
+[default.rpc.1]
+privateRpc=https://mainnet.infura.io/v3/YOUR_KEY
+```
 
-# Preferred: array of providers with public/private RPC separation.
-# epistery-host uses this to populate the network selection dropdown
-# and to inject private (API-key) RPCs for server-side calls.
+Legacy single-provider format is also supported:
 
-[[default.providers]]
+```ini
+[default.provider]
 chainId=137
-name=Polygon Mainnet
-publicRpc=https://polygon-rpc.com
-privateRpc=https://polygon-mainnet.g.alchemy.com/v2/YOUR_KEY
-nativeCurrencyName=POL
-nativeCurrencySymbol=POL
-nativeCurrencyDecimals=18
-
-[[default.providers]]
-chainId=81
-name=Japan Open Chain
-publicRpc=https://rpc-2.japanopenchain.org:8545
-nativeCurrencyName=JOC
-nativeCurrencySymbol=JOC
-nativeCurrencyDecimals=18
-
-# Optional per-chain policy overrides (defaults are in code):
-[default.providers.policy]
-minPriorityFeeGwei=25
-maxFeeMultiplier=2
-gasLimitMultiplier=1.3
+privateRpc=https://polygon-mainnet.infura.io/v3/YOUR_KEY
 ```
 
 ### Domain Config (`~/.epistery/mydomain.com/config.ini`)
@@ -334,22 +324,26 @@ See [Architecture.md](Architecture.md) for detailed architecture documentation.
 
 ### Chain Support
 
-Each EVM chain epistery talks to is represented by a `Chain` object that owns the JSON-RPC provider, fee policy, and gas estimation strategy. Built-in chains:
+Each EVM chain epistery talks to is represented by a `Chain` object that owns the JSON-RPC provider, fee policy, gas estimation strategy, and default public RPC. No configuration is needed to use a built-in chain — every detail is in the class itself.
 
-| Chain | ID | Fee Model |
-|-------|----|-----------|
-| Polygon Mainnet | 137 | EIP-1559 with 25 gwei priority floor |
-| Polygon Amoy | 80002 | EIP-1559 with 25 gwei priority floor |
-| Ethereum Mainnet | 1 | Standard EIP-1559 |
-| Sepolia Testnet | 11155111 | Standard EIP-1559 |
-| Japan Open Chain | 81 | Legacy gasPrice with 30 gwei floor |
+| Chain | ID | Fee Model | Default RPC |
+|-------|----|-----------|-------------|
+| Polygon Mainnet | 137 | EIP-1559, 25 gwei priority floor | polygon-rpc.com |
+| Polygon Amoy | 80002 | EIP-1559, 25 gwei priority floor | rpc-amoy.polygon.technology |
+| Ethereum Mainnet | 1 | Standard EIP-1559 | eth.llamarpc.com |
+| Sepolia Testnet | 11155111 | Standard EIP-1559 | eth-sepolia.public.blastapi.io |
+| Japan Open Chain | 81 | Legacy gasPrice, 30 gwei floor | rpc-2.japanopenchain.org |
 
-Use `chainFor()` to get a chain instance from a provider config:
+Use `chainFor()` to get a chain instance. Only `chainId` is required — everything else comes from the chain class defaults:
 
 ```javascript
-import { chainFor } from 'epistery';
+import { chainFor, registeredChains } from 'epistery';
 
-const chain = chainFor(domainConfig.provider);
+// Minimal — chain class supplies name, RPC, currency, fee policy
+const chain = chainFor({ chainId: 137 });
+
+// Or with an override — privateRpc for server-side calls with an API key
+const chain = chainFor({ chainId: 137, privateRpc: 'https://polygon-mainnet.infura.io/v3/KEY' });
 
 // Provider with explicit network info (no "could not detect network" errors)
 const wallet = ethers.Wallet.fromMnemonic(mnemonic).connect(chain.provider);
@@ -359,6 +353,9 @@ const feeData = await chain.getFeeData();
 // → Polygon: { maxPriorityFeePerGas: 25 gwei, maxFeePerGas: 50 gwei }
 // → JOC:     { gasPrice: 30 gwei }
 // → Ethereum: { maxPriorityFeePerGas: <network>, maxFeePerGas: <network> }
+
+// Get the full built-in chain list (for UI dropdowns, etc.)
+const chains = registeredChains();
 ```
 
 Adding a new chain is a single file — extend `Chain`, override the fee hooks that differ, and call `registerChain()`. No edits to existing code. See [src/chains/README.md](src/chains/README.md) for details.

package/dist/chains/Chain.d.ts

@@ -46,6 +46,13 @@ export interface ChainConfig extends ProviderConfig {
  *   - domain config storage
  */
 export declare class Chain {
+    /**
+     * Subclasses override `defaults` to carry the canonical network details.
+     * `chainFor({chainId: 137})` merges caller config on top of these defaults
+     * so only the chainId is required — name, public RPC, currency etc. are
+     * all built in.
+     */
+    static defaults: Partial<ChainConfig>;
     readonly chainId: number;
     readonly name: string;
     readonly rpc: string;

package/dist/chains/Chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chain.d.ts","sourceRoot":"","sources":["../../src/chains/Chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAE1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,OAAO,CAAC,SAAS,CAAiD;gBAEtD,MAAM,EAAE,WAAW;IAgB/B;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAQ/C;IAED,2EAA2E;IAC3E,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAczC;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,GAC7C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;IAQ5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;IAmChF;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO;IAgBzC,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS;CAG5C"}
+{"version":3,"file":"Chain.d.ts","sourceRoot":"","sources":["../../src/chains/Chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAE1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK;IAChB;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAM;IAE3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,OAAO,CAAC,SAAS,CAAiD;gBAEtD,MAAM,EAAE,WAAW;IAgB/B;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAQ/C;IAED,2EAA2E;IAC3E,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAczC;;;;;;OAMG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,kBAAkB,GAC7C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;IAQ5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC;IAmChF;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO;IAgBzC,wCAAwC;IACxC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS;CAG5C"}

package/dist/chains/Chain.js

@@ -24,7 +24,7 @@ class Chain {
             throw new Error(`Chain config missing chainId: ${JSON.stringify(config)}`);
         }
         this.chainId = Number(config.chainId);
-        this.name = config.name;
+        this.name = config.name || '';
         this.rpc = config.privateRpc || config.rpc;
         this.publicRpc = config.publicRpc || config.rpc;
         this.currency = {
@@ -172,4 +172,11 @@ class Chain {
     }
 }
 exports.Chain = Chain;
+/**
+ * Subclasses override `defaults` to carry the canonical network details.
+ * `chainFor({chainId: 137})` merges caller config on top of these defaults
+ * so only the chainId is required — name, public RPC, currency etc. are
+ * all built in.
+ */
+Chain.defaults = {};
 //# sourceMappingURL=Chain.js.map

package/dist/chains/Chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"Chain.js","sourceRoot":"","sources":["../../src/chains/Chain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Chain.js","sourceRoot":"","sources":["../../src/chains/Chain.ts"],"names":[],"mappings":"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"}

package/dist/chains/EthereumChain.d.ts

@@ -8,11 +8,25 @@ import { Chain } from './Chain';
  */
 export declare class EthereumChain extends Chain {
     static chainId: number;
+    static defaults: {
+        name: string;
+        rpc: string;
+        nativeCurrencyName: string;
+        nativeCurrencySymbol: string;
+        nativeCurrencyDecimals: number;
+    };
 }
 /**
  * Sepolia testnet (chainId 11155111). Same behavior as Ethereum mainnet.
  */
 export declare class SepoliaChain extends Chain {
     static chainId: number;
+    static defaults: {
+        name: string;
+        rpc: string;
+        nativeCurrencyName: string;
+        nativeCurrencySymbol: string;
+        nativeCurrencyDecimals: number;
+    };
 }
 //# sourceMappingURL=EthereumChain.d.ts.map

package/dist/chains/EthereumChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EthereumChain.d.ts","sourceRoot":"","sources":["../../src/chains/EthereumChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,CAAC,OAAO,SAAK;CACpB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAC,OAAO,SAAY;CAC3B"}
+{"version":3,"file":"EthereumChain.d.ts","sourceRoot":"","sources":["../../src/chains/EthereumChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,MAAM,CAAC,OAAO,SAAK;IACnB,MAAM,CAAC,QAAQ;;;;;;MAMb;CACH;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAC,OAAO,SAAY;IAC1B,MAAM,CAAC,QAAQ;;;;;;MAMb;CACH"}

package/dist/chains/EthereumChain.js

@@ -14,6 +14,13 @@ class EthereumChain extends Chain_1.Chain {
 }
 exports.EthereumChain = EthereumChain;
 EthereumChain.chainId = 1;
+EthereumChain.defaults = {
+    name: 'Ethereum Mainnet',
+    rpc: 'https://eth.llamarpc.com',
+    nativeCurrencyName: 'Ether',
+    nativeCurrencySymbol: 'ETH',
+    nativeCurrencyDecimals: 18,
+};
 /**
  * Sepolia testnet (chainId 11155111). Same behavior as Ethereum mainnet.
  */
@@ -21,6 +28,13 @@ class SepoliaChain extends Chain_1.Chain {
 }
 exports.SepoliaChain = SepoliaChain;
 SepoliaChain.chainId = 11155111;
+SepoliaChain.defaults = {
+    name: 'Sepolia Testnet',
+    rpc: 'https://eth-sepolia.public.blastapi.io',
+    nativeCurrencyName: 'Ether',
+    nativeCurrencySymbol: 'ETH',
+    nativeCurrencyDecimals: 18,
+};
 (0, registry_1.registerChain)(EthereumChain.chainId, EthereumChain);
 (0, registry_1.registerChain)(SepoliaChain.chainId, SepoliaChain);
 //# sourceMappingURL=EthereumChain.js.map

package/dist/chains/EthereumChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"EthereumChain.js","sourceRoot":"","sources":["../../src/chains/EthereumChain.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,yCAA2C;AAE3C;;;;;;GAMG;AACH,MAAa,aAAc,SAAQ,aAAK;;AAAxC,sCAEC;AADQ,qBAAO,GAAG,CAAC,CAAC;AAGrB;;GAEG;AACH,MAAa,YAAa,SAAQ,aAAK;;AAAvC,oCAEC;AADQ,oBAAO,GAAG,QAAQ,CAAC;AAG5B,IAAA,wBAAa,EAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACpD,IAAA,wBAAa,EAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC"}
+{"version":3,"file":"EthereumChain.js","sourceRoot":"","sources":["../../src/chains/EthereumChain.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAChC,yCAA2C;AAE3C;;;;;;GAMG;AACH,MAAa,aAAc,SAAQ,aAAK;;AAAxC,sCASC;AARQ,qBAAO,GAAG,CAAC,CAAC;AACZ,sBAAQ,GAAG;IAChB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,0BAA0B;IAC/B,kBAAkB,EAAE,OAAO;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAGJ;;GAEG;AACH,MAAa,YAAa,SAAQ,aAAK;;AAAvC,oCASC;AARQ,oBAAO,GAAG,QAAQ,CAAC;AACnB,qBAAQ,GAAG;IAChB,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,wCAAwC;IAC7C,kBAAkB,EAAE,OAAO;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAGJ,IAAA,wBAAa,EAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACpD,IAAA,wBAAa,EAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC"}

package/dist/chains/JapanOpenChain.d.ts

@@ -14,6 +14,13 @@ import { Chain, ChainFeeData } from './Chain';
  */
 export declare class JapanOpenChain extends Chain {
     static chainId: number;
+    static defaults: {
+        name: string;
+        rpc: string;
+        nativeCurrencyName: string;
+        nativeCurrencySymbol: string;
+        nativeCurrencyDecimals: number;
+    };
     supportsEIP1559(): boolean;
     protected minGasPrice(): ethers.BigNumber;
     getFeeData(): Promise<ChainFeeData>;

package/dist/chains/JapanOpenChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JapanOpenChain.d.ts","sourceRoot":"","sources":["../../src/chains/JapanOpenChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,CAAC,OAAO,SAAM;IAEpB,eAAe,IAAI,OAAO;IAI1B,SAAS,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS;IAInC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAO1C"}
+{"version":3,"file":"JapanOpenChain.d.ts","sourceRoot":"","sources":["../../src/chains/JapanOpenChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;;;;;;GAWG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,MAAM,CAAC,OAAO,SAAM;IACpB,MAAM,CAAC,QAAQ;;;;;;MAMb;IAEF,eAAe,IAAI,OAAO;IAI1B,SAAS,CAAC,WAAW,IAAI,MAAM,CAAC,SAAS;IAInC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAO1C"}

package/dist/chains/JapanOpenChain.js

@@ -32,5 +32,12 @@ class JapanOpenChain extends Chain_1.Chain {
 }
 exports.JapanOpenChain = JapanOpenChain;
 JapanOpenChain.chainId = 81;
+JapanOpenChain.defaults = {
+    name: 'Japan Open Chain',
+    rpc: 'https://rpc-2.japanopenchain.org:8545',
+    nativeCurrencyName: 'JOC',
+    nativeCurrencySymbol: 'JOC',
+    nativeCurrencyDecimals: 18,
+};
 (0, registry_1.registerChain)(JapanOpenChain.chainId, JapanOpenChain);
 //# sourceMappingURL=JapanOpenChain.js.map

package/dist/chains/JapanOpenChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"JapanOpenChain.js","sourceRoot":"","sources":["../../src/chains/JapanOpenChain.ts"],"names":[],"mappings":";;;AACA,mCAA8C;AAC9C,yCAA2C;AAE3C;;;;;;;;;;;GAWG;AACH,MAAa,cAAe,SAAQ,aAAK;IAGvC,eAAe;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAES,WAAW;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;;AAjBH,wCAkBC;AAjBQ,sBAAO,GAAG,EAAE,CAAC;AAmBtB,IAAA,wBAAa,EAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC"}
+{"version":3,"file":"JapanOpenChain.js","sourceRoot":"","sources":["../../src/chains/JapanOpenChain.ts"],"names":[],"mappings":";;;AACA,mCAA8C;AAC9C,yCAA2C;AAE3C;;;;;;;;;;;GAWG;AACH,MAAa,cAAe,SAAQ,aAAK;IAUvC,eAAe;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAES,WAAW;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,IAAI,KAAK,CAAC;QAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/D,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;;AAxBH,wCAyBC;AAxBQ,sBAAO,GAAG,EAAE,CAAC;AACb,uBAAQ,GAAG;IAChB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,uCAAuC;IAC5C,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAmBJ,IAAA,wBAAa,EAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC"}

package/dist/chains/PolygonChain.d.ts

@@ -15,6 +15,13 @@ import { Chain, ChainFeeData } from './Chain';
  */
 export declare class PolygonChain extends Chain {
     static chainId: number;
+    static defaults: {
+        name: string;
+        rpc: string;
+        nativeCurrencyName: string;
+        nativeCurrencySymbol: string;
+        nativeCurrencyDecimals: number;
+    };
     protected minPriorityFee(): ethers.BigNumber;
     getFeeData(): Promise<ChainFeeData>;
 }
@@ -27,5 +34,12 @@ export declare class PolygonChain extends Chain {
  */
 export declare class AmoyChain extends PolygonChain {
     static chainId: number;
+    static defaults: {
+        name: string;
+        rpc: string;
+        nativeCurrencyName: string;
+        nativeCurrencySymbol: string;
+        nativeCurrencyDecimals: number;
+    };
 }
 //# sourceMappingURL=PolygonChain.d.ts.map

package/dist/chains/PolygonChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PolygonChain.d.ts","sourceRoot":"","sources":["../../src/chains/PolygonChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAC,OAAO,SAAO;IAErB,SAAS,CAAC,cAAc,IAAI,MAAM,CAAC,SAAS;IAItC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAc1C;AAED;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,MAAM,CAAC,OAAO,SAAS;CACxB"}
+{"version":3,"file":"PolygonChain.d.ts","sourceRoot":"","sources":["../../src/chains/PolygonChain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,MAAM,CAAC,OAAO,SAAO;IACrB,MAAM,CAAC,QAAQ;;;;;;MAMb;IAEF,SAAS,CAAC,cAAc,IAAI,MAAM,CAAC,SAAS;IAItC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;CAc1C;AAED;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,MAAM,CAAC,OAAO,SAAS;IACvB,MAAM,CAAC,QAAQ;;;;;;MAMb;CACH"}

package/dist/chains/PolygonChain.js

@@ -34,6 +34,13 @@ class PolygonChain extends Chain_1.Chain {
 }
 exports.PolygonChain = PolygonChain;
 PolygonChain.chainId = 137;
+PolygonChain.defaults = {
+    name: 'Polygon Mainnet',
+    rpc: 'https://polygon-rpc.com',
+    nativeCurrencyName: 'POL',
+    nativeCurrencySymbol: 'POL',
+    nativeCurrencyDecimals: 18,
+};
 /**
  * Polygon Amoy testnet (chainId 80002).
  *
@@ -45,6 +52,13 @@ class AmoyChain extends PolygonChain {
 }
 exports.AmoyChain = AmoyChain;
 AmoyChain.chainId = 80002;
+AmoyChain.defaults = {
+    name: 'Polygon Amoy Testnet',
+    rpc: 'https://rpc-amoy.polygon.technology',
+    nativeCurrencyName: 'POL',
+    nativeCurrencySymbol: 'POL',
+    nativeCurrencyDecimals: 18,
+};
 (0, registry_1.registerChain)(PolygonChain.chainId, PolygonChain);
 (0, registry_1.registerChain)(AmoyChain.chainId, AmoyChain);
 //# sourceMappingURL=PolygonChain.js.map

package/dist/chains/PolygonChain.js.map

@@ -1 +1 @@
-{"version":3,"file":"PolygonChain.js","sourceRoot":"","sources":["../../src/chains/PolygonChain.ts"],"names":[],"mappings":";;;AACA,mCAA8C;AAC9C,yCAA2C;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAa,YAAa,SAAQ,aAAK;IAG3B,cAAc;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEpC,MAAM,eAAe,GAAG,EAAE,CAAC,oBAAoB,IAAI,KAAK,CAAC;QACzD,MAAM,oBAAoB,GAAG,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC;QAEjF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,IAAI,SAAS,CAAC;QAChD,MAAM,YAAY,GAAG,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;IAChD,CAAC;;AApBH,oCAqBC;AApBQ,oBAAO,GAAG,GAAG,CAAC;AAsBvB;;;;;;GAMG;AACH,MAAa,SAAU,SAAQ,YAAY;;AAA3C,8BAEC;AADQ,iBAAO,GAAG,KAAK,CAAC;AAGzB,IAAA,wBAAa,EAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAClD,IAAA,wBAAa,EAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"PolygonChain.js","sourceRoot":"","sources":["../../src/chains/PolygonChain.ts"],"names":[],"mappings":";;;AACA,mCAA8C;AAC9C,yCAA2C;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAa,YAAa,SAAQ,aAAK;IAU3B,cAAc;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEpC,MAAM,eAAe,GAAG,EAAE,CAAC,oBAAoB,IAAI,KAAK,CAAC;QACzD,MAAM,oBAAoB,GAAG,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC;QAEjF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,IAAI,SAAS,CAAC;QAChD,MAAM,YAAY,GAAG,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;IAChD,CAAC;;AA3BH,oCA4BC;AA3BQ,oBAAO,GAAG,GAAG,CAAC;AACd,qBAAQ,GAAG;IAChB,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,yBAAyB;IAC9B,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAsBJ;;;;;;GAMG;AACH,MAAa,SAAU,SAAQ,YAAY;;AAA3C,8BASC;AARQ,iBAAO,GAAG,KAAK,CAAC;AAChB,kBAAQ,GAAG;IAChB,IAAI,EAAE,sBAAsB;IAC5B,GAAG,EAAE,qCAAqC;IAC1C,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,EAAE;CAC3B,CAAC;AAGJ,IAAA,wBAAa,EAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAClD,IAAA,wBAAa,EAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC"}

package/dist/chains/index.d.ts

@@ -15,7 +15,7 @@
  * happens exactly once.
  */
 export { Chain, ChainConfig, ChainFeeData, ChainPolicy } from './Chain';
-export { chainFor, registerChain, hasRegisteredChain, registeredChainIds } from './registry';
+export { chainFor, registerChain, hasRegisteredChain, registeredChainIds, registeredChains } from './registry';
 export { PolygonChain, AmoyChain } from './PolygonChain';
 export { EthereumChain, SepoliaChain } from './EthereumChain';
 export { JapanOpenChain } from './JapanOpenChain';

package/dist/chains/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAK7F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK/G,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/chains/index.js

@@ -16,7 +16,7 @@
  * happens exactly once.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JapanOpenChain = exports.SepoliaChain = exports.EthereumChain = exports.AmoyChain = exports.PolygonChain = exports.registeredChainIds = exports.hasRegisteredChain = exports.registerChain = exports.chainFor = exports.Chain = void 0;
+exports.JapanOpenChain = exports.SepoliaChain = exports.EthereumChain = exports.AmoyChain = exports.PolygonChain = exports.registeredChains = exports.registeredChainIds = exports.hasRegisteredChain = exports.registerChain = exports.chainFor = exports.Chain = void 0;
 // Public API
 var Chain_1 = require("./Chain");
 Object.defineProperty(exports, "Chain", { enumerable: true, get: function () { return Chain_1.Chain; } });
@@ -25,6 +25,7 @@ Object.defineProperty(exports, "chainFor", { enumerable: true, get: function ()
 Object.defineProperty(exports, "registerChain", { enumerable: true, get: function () { return registry_1.registerChain; } });
 Object.defineProperty(exports, "hasRegisteredChain", { enumerable: true, get: function () { return registry_1.hasRegisteredChain; } });
 Object.defineProperty(exports, "registeredChainIds", { enumerable: true, get: function () { return registry_1.registeredChainIds; } });
+Object.defineProperty(exports, "registeredChains", { enumerable: true, get: function () { return registry_1.registeredChains; } });
 // Built-in chains — imported for their registerChain() side effect.
 // Re-exported so callers that want a concrete subclass (e.g. for instanceof
 // checks or to subclass it themselves) can import from the barrel.

package/dist/chains/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,aAAa;AACb,iCAAwE;AAA/D,8FAAA,KAAK,OAAA;AACd,uCAA6F;AAApF,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAExE,oEAAoE;AACpE,4EAA4E;AAC5E,mEAAmE;AACnE,+CAAyD;AAAhD,4GAAA,YAAY,OAAA;AAAE,yGAAA,SAAS,OAAA;AAChC,iDAA8D;AAArD,8GAAA,aAAa,OAAA;AAAE,6GAAA,YAAY,OAAA;AACpC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chains/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,aAAa;AACb,iCAAwE;AAA/D,8FAAA,KAAK,OAAA;AACd,uCAA+G;AAAtG,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAE1F,oEAAoE;AACpE,4EAA4E;AAC5E,mEAAmE;AACnE,+CAAyD;AAAhD,4GAAA,YAAY,OAAA;AAAE,yGAAA,SAAS,OAAA;AAChC,iDAA8D;AAArD,8GAAA,aAAa,OAAA;AAAE,6GAAA,YAAY,OAAA;AACpC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA"}

package/dist/chains/registry.d.ts

@@ -1,5 +1,7 @@
 import { Chain, ChainConfig } from './Chain';
-type ChainCtor = new (config: ChainConfig) => Chain;
+type ChainCtor = (new (config: ChainConfig) => Chain) & {
+    defaults: Partial<ChainConfig>;
+};
 /**
  * Register a Chain subclass for a given chainId. Overwrites any existing
  * entry — last write wins, so a downstream app can override a built-in if it
@@ -7,12 +9,25 @@ type ChainCtor = new (config: ChainConfig) => Chain;
  */
 export declare function registerChain(chainId: number, ctor: ChainCtor): void;
 /**
- * Get a Chain instance for the given provider config. If no subclass is
- * registered for the chainId, returns a generic Chain — which uses pure
- * EIP-1559 with no floors and the standard estimateGas. That works for any
- * well-behaved EVM chain; misbehaving chains need their own subclass.
+ * Get a Chain instance for the given provider config. The caller's config
+ * is merged ON TOP of the subclass's built-in defaults, so only chainId is
+ * strictly required — everything else (name, rpc, currency) comes from the
+ * chain class if not explicitly overridden.
+ *
+ * This means a host installation only needs to set `privateRpc` in
+ * `~/.epistery/config.ini` for chains where the public RPC is insufficient;
+ * all other details live in the chain class.
+ *
+ * If no subclass is registered for the chainId, returns a generic Chain —
+ * which uses pure EIP-1559 with no floors and the standard estimateGas.
  */
 export declare function chainFor(config: ChainConfig): Chain;
+/**
+ * Return the built-in chain list — one entry per registered chain, using
+ * each subclass's defaults. This is the authoritative network list for
+ * UI dropdowns. No root config needed.
+ */
+export declare function registeredChains(): ChainConfig[];
 /** Visible for tests / debug. Returns true if a chainId has a registered subclass. */
 export declare function hasRegisteredChain(chainId: number): boolean;
 /** Visible for tests / debug. Returns the list of registered chainIds. */

package/dist/chains/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/chains/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,SAAS,GAAG,KAAK,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAmBpD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAMnD;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/chains/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,SAAS,GAAG,CAAC,KAAK,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC;AAmB3F;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAanD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAShD;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C"}

package/dist/chains/registry.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerChain = registerChain;
 exports.chainFor = chainFor;
+exports.registeredChains = registeredChains;
 exports.hasRegisteredChain = hasRegisteredChain;
 exports.registeredChainIds = registeredChainIds;
 const Chain_1 = require("./Chain");
@@ -30,17 +31,46 @@ function registerChain(chainId, ctor) {
     REGISTRY.set(Number(chainId), ctor);
 }
 /**
- * Get a Chain instance for the given provider config. If no subclass is
- * registered for the chainId, returns a generic Chain — which uses pure
- * EIP-1559 with no floors and the standard estimateGas. That works for any
- * well-behaved EVM chain; misbehaving chains need their own subclass.
+ * Get a Chain instance for the given provider config. The caller's config
+ * is merged ON TOP of the subclass's built-in defaults, so only chainId is
+ * strictly required — everything else (name, rpc, currency) comes from the
+ * chain class if not explicitly overridden.
+ *
+ * This means a host installation only needs to set `privateRpc` in
+ * `~/.epistery/config.ini` for chains where the public RPC is insufficient;
+ * all other details live in the chain class.
+ *
+ * If no subclass is registered for the chainId, returns a generic Chain —
+ * which uses pure EIP-1559 with no floors and the standard estimateGas.
  */
 function chainFor(config) {
     if (config.chainId == null) {
         throw new Error(`chainFor: provider config missing chainId: ${JSON.stringify(config)}`);
     }
     const Ctor = REGISTRY.get(Number(config.chainId)) || Chain_1.Chain;
-    return new Ctor(config);
+    // Subclass defaults fill in anything the caller didn't specify.
+    const merged = { ...Ctor.defaults, ...config };
+    // If caller provided only `rpc` but chain has a default public RPC,
+    // preserve the public one for UI display.
+    if (!config.publicRpc && Ctor.defaults.rpc) {
+        merged.publicRpc = Ctor.defaults.rpc;
+    }
+    return new Ctor(merged);
+}
+/**
+ * Return the built-in chain list — one entry per registered chain, using
+ * each subclass's defaults. This is the authoritative network list for
+ * UI dropdowns. No root config needed.
+ */
+function registeredChains() {
+    const chains = [];
+    for (const [chainId, Ctor] of REGISTRY) {
+        chains.push({
+            ...Ctor.defaults,
+            chainId,
+        });
+    }
+    return chains;
 }
 /** Visible for tests / debug. Returns true if a chainId has a registered subclass. */
 function hasRegisteredChain(chainId) {

package/dist/chains/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/chains/registry.ts"],"names":[],"mappings":";;AA0BA,sCAEC;AAQD,4BAMC;AAGD,gDAEC;AAGD,gDAEC;AApDD,mCAA6C;AAI7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,IAAe;IAC5D,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,MAAmB;IAC1C,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,aAAK,CAAC;IAC3D,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,sFAAsF;AACtF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,0EAA0E;AAC1E,SAAgB,kBAAkB;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/chains/registry.ts"],"names":[],"mappings":";;AA0BA,sCAEC;AAeD,4BAaC;AAOD,4CASC;AAGD,gDAEC;AAGD,gDAEC;AAlFD,mCAA6C;AAI7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE9C;;;;GAIG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,IAAe;IAC5D,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ,CAAC,MAAmB;IAC1C,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,aAAK,CAAC;IAC3D,gEAAgE;IAChE,MAAM,MAAM,GAAgB,EAAE,GAAI,IAAI,CAAC,QAAwB,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7E,oEAAoE;IACpE,0CAA0C;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QAC3C,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC;YACV,GAAI,IAAI,CAAC,QAAwB;YACjC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sFAAsF;AACtF,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,0EAA0E;AAC1E,SAAgB,kBAAkB;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/index.mjs

@@ -5,7 +5,7 @@ import { fileURLToPath } from "url";
 import { Epistery } from "./dist/epistery.js";
 import { Utils } from "./dist/utils/Utils.js";
 import { Config } from "./dist/utils/Config.js";
-import { chainFor, registerChain, Chain } from "./dist/chains/index.js";
+import { chainFor, registerChain, registeredChains, Chain } from "./dist/chains/index.js";
 import createRoutes from "./routes/index.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -627,4 +627,4 @@ class EpisteryAttach {
   }
 }
 
-export { EpisteryAttach as Epistery, Config, chainFor, registerChain, Chain };
+export { EpisteryAttach as Epistery, Config, chainFor, registerChain, registeredChains, Chain };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epistery",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Epistery brings blockchain capabilities to mundane web tasks like engagement metrics, authentication and commerce of all sorts.",
   "author": "Rootz Corp.",
   "license": "MIT",

package/src/chains/Chain.ts

@@ -53,6 +53,14 @@ export interface ChainConfig extends ProviderConfig {
  *   - domain config storage
  */
 export class Chain {
+  /**
+   * Subclasses override `defaults` to carry the canonical network details.
+   * `chainFor({chainId: 137})` merges caller config on top of these defaults
+   * so only the chainId is required — name, public RPC, currency etc. are
+   * all built in.
+   */
+  static defaults: Partial<ChainConfig> = {};
+
   readonly chainId: number;
   readonly name: string;
   readonly rpc: string;                       // private/server-side RPC (with API key if any)
@@ -67,7 +75,7 @@ export class Chain {
       throw new Error(`Chain config missing chainId: ${JSON.stringify(config)}`);
     }
     this.chainId = Number(config.chainId);
-    this.name = config.name;
+    this.name = config.name || '';
     this.rpc = config.privateRpc || config.rpc;
     this.publicRpc = config.publicRpc || config.rpc;
     this.currency = {

package/src/chains/EthereumChain.ts

@@ -10,6 +10,13 @@ import { registerChain } from './registry';
  */
 export class EthereumChain extends Chain {
   static chainId = 1;
+  static defaults = {
+    name: 'Ethereum Mainnet',
+    rpc: 'https://eth.llamarpc.com',
+    nativeCurrencyName: 'Ether',
+    nativeCurrencySymbol: 'ETH',
+    nativeCurrencyDecimals: 18,
+  };
 }
 
 /**
@@ -17,6 +24,13 @@ export class EthereumChain extends Chain {
  */
 export class SepoliaChain extends Chain {
   static chainId = 11155111;
+  static defaults = {
+    name: 'Sepolia Testnet',
+    rpc: 'https://eth-sepolia.public.blastapi.io',
+    nativeCurrencyName: 'Ether',
+    nativeCurrencySymbol: 'ETH',
+    nativeCurrencyDecimals: 18,
+  };
 }
 
 registerChain(EthereumChain.chainId, EthereumChain);

package/src/chains/JapanOpenChain.ts

@@ -16,6 +16,13 @@ import { registerChain } from './registry';
  */
 export class JapanOpenChain extends Chain {
   static chainId = 81;
+  static defaults = {
+    name: 'Japan Open Chain',
+    rpc: 'https://rpc-2.japanopenchain.org:8545',
+    nativeCurrencyName: 'JOC',
+    nativeCurrencySymbol: 'JOC',
+    nativeCurrencyDecimals: 18,
+  };
 
   supportsEIP1559(): boolean {
     return false;

package/src/chains/PolygonChain.ts

@@ -17,6 +17,13 @@ import { registerChain } from './registry';
  */
 export class PolygonChain extends Chain {
   static chainId = 137;
+  static defaults = {
+    name: 'Polygon Mainnet',
+    rpc: 'https://polygon-rpc.com',
+    nativeCurrencyName: 'POL',
+    nativeCurrencySymbol: 'POL',
+    nativeCurrencyDecimals: 18,
+  };
 
   protected minPriorityFee(): ethers.BigNumber {
     return this.gwei(this.policy.minPriorityFeeGwei ?? 25);
@@ -47,6 +54,13 @@ export class PolygonChain extends Chain {
  */
 export class AmoyChain extends PolygonChain {
   static chainId = 80002;
+  static defaults = {
+    name: 'Polygon Amoy Testnet',
+    rpc: 'https://rpc-amoy.polygon.technology',
+    nativeCurrencyName: 'POL',
+    nativeCurrencySymbol: 'POL',
+    nativeCurrencyDecimals: 18,
+  };
 }
 
 registerChain(PolygonChain.chainId, PolygonChain);

package/src/chains/index.ts

@@ -17,7 +17,7 @@
 
 // Public API
 export { Chain, ChainConfig, ChainFeeData, ChainPolicy } from './Chain';
-export { chainFor, registerChain, hasRegisteredChain, registeredChainIds } from './registry';
+export { chainFor, registerChain, hasRegisteredChain, registeredChainIds, registeredChains } from './registry';
 
 // Built-in chains — imported for their registerChain() side effect.
 // Re-exported so callers that want a concrete subclass (e.g. for instanceof

package/src/chains/registry.ts

@@ -1,6 +1,6 @@
 import { Chain, ChainConfig } from './Chain';
 
-type ChainCtor = new (config: ChainConfig) => Chain;
+type ChainCtor = (new (config: ChainConfig) => Chain) & { defaults: Partial<ChainConfig> };
 
 /**
  * Registry of chainId → Chain subclass.
@@ -29,17 +29,47 @@ export function registerChain(chainId: number, ctor: ChainCtor): void {
 }
 
 /**
- * Get a Chain instance for the given provider config. If no subclass is
- * registered for the chainId, returns a generic Chain — which uses pure
- * EIP-1559 with no floors and the standard estimateGas. That works for any
- * well-behaved EVM chain; misbehaving chains need their own subclass.
+ * Get a Chain instance for the given provider config. The caller's config
+ * is merged ON TOP of the subclass's built-in defaults, so only chainId is
+ * strictly required — everything else (name, rpc, currency) comes from the
+ * chain class if not explicitly overridden.
+ *
+ * This means a host installation only needs to set `privateRpc` in
+ * `~/.epistery/config.ini` for chains where the public RPC is insufficient;
+ * all other details live in the chain class.
+ *
+ * If no subclass is registered for the chainId, returns a generic Chain —
+ * which uses pure EIP-1559 with no floors and the standard estimateGas.
  */
 export function chainFor(config: ChainConfig): Chain {
   if (config.chainId == null) {
     throw new Error(`chainFor: provider config missing chainId: ${JSON.stringify(config)}`);
   }
   const Ctor = REGISTRY.get(Number(config.chainId)) || Chain;
-  return new Ctor(config);
+  // Subclass defaults fill in anything the caller didn't specify.
+  const merged: ChainConfig = { ...(Ctor.defaults as ChainConfig), ...config };
+  // If caller provided only `rpc` but chain has a default public RPC,
+  // preserve the public one for UI display.
+  if (!config.publicRpc && Ctor.defaults.rpc) {
+    merged.publicRpc = Ctor.defaults.rpc;
+  }
+  return new Ctor(merged);
+}
+
+/**
+ * Return the built-in chain list — one entry per registered chain, using
+ * each subclass's defaults. This is the authoritative network list for
+ * UI dropdowns. No root config needed.
+ */
+export function registeredChains(): ChainConfig[] {
+  const chains: ChainConfig[] = [];
+  for (const [chainId, Ctor] of REGISTRY) {
+    chains.push({
+      ...(Ctor.defaults as ChainConfig),
+      chainId,
+    });
+  }
+  return chains;
 }
 
 /** Visible for tests / debug. Returns true if a chainId has a registered subclass. */