epistery 1.3.8 → 1.4.0

package/README.md

@@ -198,13 +198,41 @@ email=you@example.com
 [ipfs]
 url=https://rootz.digital/api/v0
 
-[default.provider]
-chainId=420420422
-name=polkadot-hub-testnet
-rpc=https://testnet-passet-hub-eth-rpc.polkadot.io
-
 [cli]
 default_domain=localhost
+
+# Legacy single provider (still supported):
+[default.provider]
+chainId=137
+name=Polygon Mainnet
+rpc=https://polygon-rpc.com
+
+# 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.
+
+[[default.providers]]
+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
 ```
 
 ### Domain Config (`~/.epistery/mydomain.com/config.ini`)
@@ -298,11 +326,43 @@ Epistery follows a plugin architecture that integrates seamlessly with Express.j
 - **Client Libraries** (`/client/*.js`): Browser-side authentication and data wallet tools
 - **CLI** (`/cli/epistery.mjs`): Command-line interface for authenticated requests
 - **Utils** (`/src/utils/`): Configuration, crypto operations, and Aqua protocol implementation
+- **Chains** (`/src/chains/`): Per-chain provider, fee policy, and gas estimation
 
 All endpoints follow RFC 8615 well-known URIs standard for service discovery.
 
 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:
+
+| 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 |
+
+Use `chainFor()` to get a chain instance from a provider config:
+
+```javascript
+import { chainFor } from 'epistery';
+
+const chain = chainFor(domainConfig.provider);
+
+// Provider with explicit network info (no "could not detect network" errors)
+const wallet = ethers.Wallet.fromMnemonic(mnemonic).connect(chain.provider);
+
+// Per-chain fee data for transaction overrides
+const feeData = await chain.getFeeData();
+// → Polygon: { maxPriorityFeePerGas: 25 gwei, maxFeePerGas: 50 gwei }
+// → JOC:     { gasPrice: 30 gwei }
+// → Ethereum: { maxPriorityFeePerGas: <network>, maxFeePerGas: <network> }
+```
+
+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.
+
 ## Use Cases
 
 - **Decentralized Wikis**: User authentication and content ownership without central accounts

package/dist/chains/Chain.d.ts

@@ -0,0 +1,117 @@
+import { ethers } from 'ethers';
+import { ProviderConfig } from '../utils/types';
+/**
+ * Per-chain fee data, returned in the shape ethers v5 expects on a transaction.
+ * EIP-1559 chains return maxFeePerGas/maxPriorityFeePerGas.
+ * Legacy chains return gasPrice.
+ */
+export interface ChainFeeData {
+    maxFeePerGas?: ethers.BigNumber;
+    maxPriorityFeePerGas?: ethers.BigNumber;
+    gasPrice?: ethers.BigNumber;
+}
+/**
+ * Optional per-chain knobs that root config can override without editing code.
+ * Each subclass reads only what it cares about.
+ */
+export interface ChainPolicy {
+    minPriorityFeeGwei?: number;
+    maxFeeMultiplier?: number;
+    minGasPriceGwei?: number;
+    gasLimitMultiplier?: number;
+}
+/**
+ * Extended provider config that may carry per-chain policy + a private RPC URL.
+ * The plain `ProviderConfig` from utils/types stays the wire/storage shape;
+ * `ChainConfig` is what the Chain object actually holds in memory.
+ */
+export interface ChainConfig extends ProviderConfig {
+    publicRpc?: string;
+    privateRpc?: string;
+    policy?: ChainPolicy;
+}
+/**
+ * Base class for an EVM chain. Subclasses override only the policy hooks
+ * that are actually different from the EIP-1559 default.
+ *
+ * The Chain object owns:
+ *   - the JsonRpcProvider (with explicit network info, fixing "could not detect network")
+ *   - per-chain fee policy (getFeeData)
+ *   - the contract Proxy that injects fee data into write calls
+ *   - gas-limit estimation with a per-chain safety multiplier
+ *
+ * The Chain object does NOT own:
+ *   - wallets / private keys
+ *   - contract ABIs
+ *   - domain config storage
+ */
+export declare class Chain {
+    readonly chainId: number;
+    readonly name: string;
+    readonly rpc: string;
+    readonly publicRpc: string | undefined;
+    readonly currency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    readonly policy: ChainPolicy;
+    private _provider;
+    constructor(config: ChainConfig);
+    /**
+     * Lazily-built provider with explicit network info.
+     * Passing `{ name, chainId }` to the JsonRpcProvider constructor avoids
+     * ethers' "could not detect network" error when the RPC is briefly
+     * unreachable at startup — ethers will skip its eth_chainId probe.
+     */
+    get provider(): ethers.providers.JsonRpcProvider;
+    /** EIP-1559 by default. Subclasses override for legacy gasPrice chains. */
+    supportsEIP1559(): boolean;
+    /**
+     * Default fee policy: pass through whatever the network reports via
+     * eth_feeHistory / eth_gasPrice. Subclasses override to apply per-chain
+     * floors (Polygon's 25 gwei priority floor, JOC's gasPrice floor, etc.).
+     */
+    getFeeData(): Promise<ChainFeeData>;
+    /**
+     * Estimate gas limit with this chain's safety multiplier.
+     * Used by callers that need to populate gasLimit explicitly (e.g. for
+     * pre-funding calculations). Most write calls will let ethers estimate
+     * automatically; this is for the cases where ethers' estimate is unsafe
+     * (Polygon Amoy, JOC) and a multiplier is required.
+     */
+    estimateGas(populated: ethers.providers.TransactionRequest): Promise<ethers.BigNumber>;
+    /**
+     * Wrap an ethers.Contract so every state-mutating method automatically
+     * receives this chain's fee data as the transaction overrides argument.
+     *
+     * Uses Object.create (prototype chain) — the wrapper object gets its own
+     * writable properties for the write methods while reads of everything else
+     * (.address, .signer, view functions, .interface, etc.) fall through to
+     * the original contract via the prototype.
+     *
+     * Why not a Proxy: ethers v5 defines ABI methods with defineReadOnly
+     * (non-writable, non-configurable). V8's proxy invariant requires get
+     * traps to return the *original* value for such properties — returning a
+     * wrapped function throws TypeError. Object.create avoids this because
+     * the own properties on the child shadow the prototype's frozen ones.
+     *
+     * NOTE: epistery-host's DomainChain does NOT use this because all its
+     * write call sites already pass feeData explicitly. This method exists
+     * for other consumers (e.g. CLI tools, agents) that want automatic fee
+     * injection without threading overrides through every call.
+     *
+     * @param contract - the ethers.Contract instance
+     * @param abi - the same ABI used to construct the contract; needed to
+     *              identify which methods are state-mutating.
+     */
+    wrapContract<T extends ethers.Contract>(contract: T, abi: ReadonlyArray<any>): T;
+    /**
+     * Recognize a transaction-overrides object so we don't mistake it for a
+     * positional argument. Excludes BigNumbers and arrays explicitly.
+     */
+    static isOverridesObject(x: any): boolean;
+    /** Convenience: gwei → BigNumber wei */
+    protected gwei(n: number): ethers.BigNumber;
+}
+//# sourceMappingURL=Chain.d.ts.map

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

@@ -0,0 +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"}

package/dist/chains/Chain.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Chain = void 0;
+const ethers_1 = require("ethers");
+/**
+ * Base class for an EVM chain. Subclasses override only the policy hooks
+ * that are actually different from the EIP-1559 default.
+ *
+ * The Chain object owns:
+ *   - the JsonRpcProvider (with explicit network info, fixing "could not detect network")
+ *   - per-chain fee policy (getFeeData)
+ *   - the contract Proxy that injects fee data into write calls
+ *   - gas-limit estimation with a per-chain safety multiplier
+ *
+ * The Chain object does NOT own:
+ *   - wallets / private keys
+ *   - contract ABIs
+ *   - domain config storage
+ */
+class Chain {
+    constructor(config) {
+        this._provider = null;
+        if (config.chainId == null) {
+            throw new Error(`Chain config missing chainId: ${JSON.stringify(config)}`);
+        }
+        this.chainId = Number(config.chainId);
+        this.name = config.name;
+        this.rpc = config.privateRpc || config.rpc;
+        this.publicRpc = config.publicRpc || config.rpc;
+        this.currency = {
+            name: config.nativeCurrencyName || '',
+            symbol: config.nativeCurrencySymbol || '',
+            decimals: config.nativeCurrencyDecimals || 18,
+        };
+        this.policy = config.policy || {};
+    }
+    /**
+     * Lazily-built provider with explicit network info.
+     * Passing `{ name, chainId }` to the JsonRpcProvider constructor avoids
+     * ethers' "could not detect network" error when the RPC is briefly
+     * unreachable at startup — ethers will skip its eth_chainId probe.
+     */
+    get provider() {
+        if (!this._provider) {
+            this._provider = new ethers_1.ethers.providers.JsonRpcProvider(this.rpc, {
+                name: this.name,
+                chainId: this.chainId,
+            });
+        }
+        return this._provider;
+    }
+    /** EIP-1559 by default. Subclasses override for legacy gasPrice chains. */
+    supportsEIP1559() {
+        return true;
+    }
+    /**
+     * Default fee policy: pass through whatever the network reports via
+     * eth_feeHistory / eth_gasPrice. Subclasses override to apply per-chain
+     * floors (Polygon's 25 gwei priority floor, JOC's gasPrice floor, etc.).
+     */
+    async getFeeData() {
+        const fd = await this.provider.getFeeData();
+        if (this.supportsEIP1559() && fd.maxFeePerGas && fd.maxPriorityFeePerGas) {
+            return {
+                maxFeePerGas: fd.maxFeePerGas,
+                maxPriorityFeePerGas: fd.maxPriorityFeePerGas,
+            };
+        }
+        if (fd.gasPrice) {
+            return { gasPrice: fd.gasPrice };
+        }
+        throw new Error(`Chain ${this.name} (${this.chainId}) returned no usable fee data`);
+    }
+    /**
+     * Estimate gas limit with this chain's safety multiplier.
+     * Used by callers that need to populate gasLimit explicitly (e.g. for
+     * pre-funding calculations). Most write calls will let ethers estimate
+     * automatically; this is for the cases where ethers' estimate is unsafe
+     * (Polygon Amoy, JOC) and a multiplier is required.
+     */
+    async estimateGas(populated) {
+        const estimate = await this.provider.estimateGas(populated);
+        const multiplier = this.policy.gasLimitMultiplier ?? 1.3;
+        // Multiply via integer math to stay in BigNumber-land.
+        const num = Math.round(multiplier * 100);
+        return estimate.mul(num).div(100);
+    }
+    /**
+     * Wrap an ethers.Contract so every state-mutating method automatically
+     * receives this chain's fee data as the transaction overrides argument.
+     *
+     * Uses Object.create (prototype chain) — the wrapper object gets its own
+     * writable properties for the write methods while reads of everything else
+     * (.address, .signer, view functions, .interface, etc.) fall through to
+     * the original contract via the prototype.
+     *
+     * Why not a Proxy: ethers v5 defines ABI methods with defineReadOnly
+     * (non-writable, non-configurable). V8's proxy invariant requires get
+     * traps to return the *original* value for such properties — returning a
+     * wrapped function throws TypeError. Object.create avoids this because
+     * the own properties on the child shadow the prototype's frozen ones.
+     *
+     * NOTE: epistery-host's DomainChain does NOT use this because all its
+     * write call sites already pass feeData explicitly. This method exists
+     * for other consumers (e.g. CLI tools, agents) that want automatic fee
+     * injection without threading overrides through every call.
+     *
+     * @param contract - the ethers.Contract instance
+     * @param abi - the same ABI used to construct the contract; needed to
+     *              identify which methods are state-mutating.
+     */
+    wrapContract(contract, abi) {
+        const writeFns = new Set();
+        for (const item of abi) {
+            if (item.type !== 'function')
+                continue;
+            if (item.stateMutability === 'view' || item.stateMutability === 'pure')
+                continue;
+            if (typeof item.name === 'string')
+                writeFns.add(item.name);
+        }
+        const chain = this;
+        const wrapped = Object.create(contract);
+        for (const name of writeFns) {
+            const original = contract[name];
+            if (typeof original !== 'function')
+                continue;
+            Object.defineProperty(wrapped, name, {
+                value: async function (...args) {
+                    let overrides;
+                    const last = args[args.length - 1];
+                    if (Chain.isOverridesObject(last)) {
+                        const fee = await chain.getFeeData();
+                        overrides = { ...fee, ...last };
+                        args[args.length - 1] = overrides;
+                    }
+                    else {
+                        overrides = await chain.getFeeData();
+                        args.push(overrides);
+                    }
+                    return original.apply(contract, args);
+                },
+                writable: true,
+                configurable: true,
+            });
+        }
+        return wrapped;
+    }
+    /**
+     * Recognize a transaction-overrides object so we don't mistake it for a
+     * positional argument. Excludes BigNumbers and arrays explicitly.
+     */
+    static isOverridesObject(x) {
+        if (!x || typeof x !== 'object')
+            return false;
+        if (Array.isArray(x))
+            return false;
+        if (ethers_1.ethers.BigNumber.isBigNumber(x))
+            return false;
+        return ('gasPrice' in x ||
+            'maxFeePerGas' in x ||
+            'maxPriorityFeePerGas' in x ||
+            'gasLimit' in x ||
+            'nonce' in x ||
+            'value' in x ||
+            'from' in x ||
+            'type' in x);
+    }
+    /** Convenience: gwei → BigNumber wei */
+    gwei(n) {
+        return ethers_1.ethers.utils.parseUnits(String(n), 'gwei');
+    }
+}
+exports.Chain = Chain;
+//# sourceMappingURL=Chain.js.map

package/dist/chains/Chain.js.map

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

package/dist/chains/EthereumChain.d.ts

@@ -0,0 +1,18 @@
+import { Chain } from './Chain';
+/**
+ * Ethereum mainnet (chainId 1).
+ *
+ * Standard EIP-1559 behavior — ethers' getFeeData is accurate here.
+ * No floors, no special multipliers. The base class default works as-is;
+ * this subclass exists for the registry and for future overrides.
+ */
+export declare class EthereumChain extends Chain {
+    static chainId: number;
+}
+/**
+ * Sepolia testnet (chainId 11155111). Same behavior as Ethereum mainnet.
+ */
+export declare class SepoliaChain extends Chain {
+    static chainId: number;
+}
+//# sourceMappingURL=EthereumChain.d.ts.map

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

@@ -0,0 +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"}

package/dist/chains/EthereumChain.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SepoliaChain = exports.EthereumChain = void 0;
+const Chain_1 = require("./Chain");
+const registry_1 = require("./registry");
+/**
+ * Ethereum mainnet (chainId 1).
+ *
+ * Standard EIP-1559 behavior — ethers' getFeeData is accurate here.
+ * No floors, no special multipliers. The base class default works as-is;
+ * this subclass exists for the registry and for future overrides.
+ */
+class EthereumChain extends Chain_1.Chain {
+}
+exports.EthereumChain = EthereumChain;
+EthereumChain.chainId = 1;
+/**
+ * Sepolia testnet (chainId 11155111). Same behavior as Ethereum mainnet.
+ */
+class SepoliaChain extends Chain_1.Chain {
+}
+exports.SepoliaChain = SepoliaChain;
+SepoliaChain.chainId = 11155111;
+(0, registry_1.registerChain)(EthereumChain.chainId, EthereumChain);
+(0, registry_1.registerChain)(SepoliaChain.chainId, SepoliaChain);
+//# sourceMappingURL=EthereumChain.js.map

package/dist/chains/EthereumChain.js.map

@@ -0,0 +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"}

package/dist/chains/JapanOpenChain.d.ts

@@ -0,0 +1,21 @@
+import { ethers } from 'ethers';
+import { Chain, ChainFeeData } from './Chain';
+/**
+ * Japan Open Chain (chainId 81).
+ *
+ * Why this class exists: JOC is a legacy gasPrice chain. Its base fee is
+ * effectively zero, but the RPC enforces a high *minimum* gas price (around
+ * 30 gwei). EIP-1559 fields are not honored — submitting a transaction with
+ * maxFeePerGas/maxPriorityFeePerGas instead of gasPrice gets rejected.
+ *
+ * The base class would happily try to use EIP-1559; we override
+ * supportsEIP1559() to false and return only `gasPrice`, clamped to the
+ * configured floor.
+ */
+export declare class JapanOpenChain extends Chain {
+    static chainId: number;
+    supportsEIP1559(): boolean;
+    protected minGasPrice(): ethers.BigNumber;
+    getFeeData(): Promise<ChainFeeData>;
+}
+//# sourceMappingURL=JapanOpenChain.d.ts.map

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

@@ -0,0 +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"}

package/dist/chains/JapanOpenChain.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JapanOpenChain = void 0;
+const Chain_1 = require("./Chain");
+const registry_1 = require("./registry");
+/**
+ * Japan Open Chain (chainId 81).
+ *
+ * Why this class exists: JOC is a legacy gasPrice chain. Its base fee is
+ * effectively zero, but the RPC enforces a high *minimum* gas price (around
+ * 30 gwei). EIP-1559 fields are not honored — submitting a transaction with
+ * maxFeePerGas/maxPriorityFeePerGas instead of gasPrice gets rejected.
+ *
+ * The base class would happily try to use EIP-1559; we override
+ * supportsEIP1559() to false and return only `gasPrice`, clamped to the
+ * configured floor.
+ */
+class JapanOpenChain extends Chain_1.Chain {
+    supportsEIP1559() {
+        return false;
+    }
+    minGasPrice() {
+        return this.gwei(this.policy.minGasPriceGwei ?? 30);
+    }
+    async getFeeData() {
+        const fd = await this.provider.getFeeData();
+        const floor = this.minGasPrice();
+        const networkPrice = fd.gasPrice ?? floor;
+        const gasPrice = networkPrice.gt(floor) ? networkPrice : floor;
+        return { gasPrice };
+    }
+}
+exports.JapanOpenChain = JapanOpenChain;
+JapanOpenChain.chainId = 81;
+(0, registry_1.registerChain)(JapanOpenChain.chainId, JapanOpenChain);
+//# sourceMappingURL=JapanOpenChain.js.map

package/dist/chains/JapanOpenChain.js.map

@@ -0,0 +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"}

package/dist/chains/PolygonChain.d.ts

@@ -0,0 +1,31 @@
+import { ethers } from 'ethers';
+import { Chain, ChainFeeData } from './Chain';
+/**
+ * Polygon mainnet (chainId 137).
+ *
+ * Why this class exists: Polygon enforces a hard 25 gwei minimum priority fee
+ * at the RPC level. Transactions submitted with a lower priority fee are
+ * rejected with "max fee per gas less than block base fee" or simply silently
+ * dropped. ethers v5's getFeeData() does NOT know about this floor and will
+ * happily return ~1.5 gwei from eth_feeHistory.
+ *
+ * The fix: clamp maxPriorityFeePerGas to at least 25 gwei (overridable via
+ * policy.minPriorityFeeGwei in root config) and ensure maxFeePerGas >=
+ * 2 * maxPriorityFeePerGas.
+ */
+export declare class PolygonChain extends Chain {
+    static chainId: number;
+    protected minPriorityFee(): ethers.BigNumber;
+    getFeeData(): Promise<ChainFeeData>;
+}
+/**
+ * Polygon Amoy testnet (chainId 80002).
+ *
+ * Same fee floor concerns as Polygon mainnet — Amoy is the canonical Polygon
+ * PoS testnet and the RPC enforces an identical 25 gwei priority floor.
+ * Subclassing PolygonChain keeps the policy in one place.
+ */
+export declare class AmoyChain extends PolygonChain {
+    static chainId: number;
+}
+//# sourceMappingURL=PolygonChain.d.ts.map

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

@@ -0,0 +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"}

package/dist/chains/PolygonChain.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmoyChain = exports.PolygonChain = void 0;
+const Chain_1 = require("./Chain");
+const registry_1 = require("./registry");
+/**
+ * Polygon mainnet (chainId 137).
+ *
+ * Why this class exists: Polygon enforces a hard 25 gwei minimum priority fee
+ * at the RPC level. Transactions submitted with a lower priority fee are
+ * rejected with "max fee per gas less than block base fee" or simply silently
+ * dropped. ethers v5's getFeeData() does NOT know about this floor and will
+ * happily return ~1.5 gwei from eth_feeHistory.
+ *
+ * The fix: clamp maxPriorityFeePerGas to at least 25 gwei (overridable via
+ * policy.minPriorityFeeGwei in root config) and ensure maxFeePerGas >=
+ * 2 * maxPriorityFeePerGas.
+ */
+class PolygonChain extends Chain_1.Chain {
+    minPriorityFee() {
+        return this.gwei(this.policy.minPriorityFeeGwei ?? 25);
+    }
+    async getFeeData() {
+        const fd = await this.provider.getFeeData();
+        const floor = this.minPriorityFee();
+        const networkPriority = fd.maxPriorityFeePerGas ?? floor;
+        const maxPriorityFeePerGas = networkPriority.gt(floor) ? networkPriority : floor;
+        const multiplier = this.policy.maxFeeMultiplier ?? 2;
+        const minMaxFee = maxPriorityFeePerGas.mul(multiplier);
+        const networkMax = fd.maxFeePerGas ?? minMaxFee;
+        const maxFeePerGas = networkMax.gt(minMaxFee) ? networkMax : minMaxFee;
+        return { maxPriorityFeePerGas, maxFeePerGas };
+    }
+}
+exports.PolygonChain = PolygonChain;
+PolygonChain.chainId = 137;
+/**
+ * Polygon Amoy testnet (chainId 80002).
+ *
+ * Same fee floor concerns as Polygon mainnet — Amoy is the canonical Polygon
+ * PoS testnet and the RPC enforces an identical 25 gwei priority floor.
+ * Subclassing PolygonChain keeps the policy in one place.
+ */
+class AmoyChain extends PolygonChain {
+}
+exports.AmoyChain = AmoyChain;
+AmoyChain.chainId = 80002;
+(0, registry_1.registerChain)(PolygonChain.chainId, PolygonChain);
+(0, registry_1.registerChain)(AmoyChain.chainId, AmoyChain);
+//# sourceMappingURL=PolygonChain.js.map

package/dist/chains/PolygonChain.js.map

@@ -0,0 +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"}

package/dist/chains/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chains module barrel.
+ *
+ * Exports the public API and pulls in the built-in chain subclasses for
+ * their side-effect (each subclass calls registerChain() at module load).
+ *
+ * Adding a new built-in chain: drop a `MyChain.ts` next to this file that
+ * extends Chain and calls `registerChain(MyChain.chainId, MyChain)` at the
+ * bottom, then add one `import './MyChain';` line below. No edits to
+ * Chain.ts or registry.ts.
+ *
+ * Adding a chain from outside this package: write the same kind of file in
+ * your own codebase and `import 'your-package/dist/chains/MyChain';` at app
+ * startup. The Map in registry.ts is module-scoped, so the registration
+ * happens exactly once.
+ */
+export { Chain, ChainConfig, ChainFeeData, ChainPolicy } from './Chain';
+export { chainFor, registerChain, hasRegisteredChain, registeredChainIds } from './registry';
+export { PolygonChain, AmoyChain } from './PolygonChain';
+export { EthereumChain, SepoliaChain } from './EthereumChain';
+export { JapanOpenChain } from './JapanOpenChain';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}