@magnaflow/chain-provider 1.0.2 → 1.1.0

package/README.md

@@ -48,6 +48,57 @@ const balances = await provider.getBalances('0x1234...', [
 
 ## Notes
 
+### Polygon Mainnet
+
+Only the exact `polygon_mainnet` key enables Polygon (137 / `0x89`, POL / 18,
+Polygonscan). Aliases and Polygon testnets are not supported. Supply runtime
+configuration from the API; the provider does not supply token or payout addresses.
+
+```ts
+const polygonConfig = apiChainConfigs.find((config) => config.chain === 'polygon_mainnet');
+if (!polygonConfig) throw new Error('Polygon is not enabled');
+const polygonProvider = createChainProvider(polygonConfig);
+const nativeBaseUnits = await polygonProvider.getNativeBalance(merchantAddress);
+```
+
+Polygon uses nonempty `rpc_url`, falling back to `rest_url` only when empty.
+Optional `chain_id` and `chainId` must both identify 137 when supplied. A supplied
+native symbol must be `POL`, not `MATIC`. Public and wallet transports validate
+`eth_chainId`, including direct client access and a fresh check before broadcasting.
+Existing chains retain their RPC and fallback behavior. Balances remain raw base
+units; consumers use runtime token decimals and POL's 18 native decimals.
+
+Polygon support starts in `@magnaflow/chain-provider@1.1.0`. Keep application
+dependencies, Bun overrides and lockfiles aligned with that release for CI installs.
+
+For unreleased changes, build this workspace and pack/link this package locally.
+
+For the current Kit checkout, its Bun overrides select the registry version even
+after a link. Install the built tarball into that checkout's existing node_modules
+for local integration, leaving its manifest and lockfile unchanged. Start in the
+SDK repository root, with the Kit checkout in a sibling directory:
+
+```bash
+polygon_pack_dir=$(mktemp -d "${TMPDIR:-/tmp}/polygon-provider-pack.XXXXXX")
+bunx nx run chain-provider:build
+cd packages/chain-provider
+polygon_provider_version=$(bun -p 'require("./package.json").version')
+bun pm pack --destination "$polygon_pack_dir"
+
+cd ../../../merchant-tools-v2
+polygon_backup=$(mktemp -d "${TMPDIR:-/tmp}/polygon-provider-backup.XXXXXX")
+cp -R node_modules/@magnaflow/chain-provider "$polygon_backup/chain-provider"
+tar -xzf "$polygon_pack_dir/magnaflow-chain-provider-$polygon_provider_version.tgz" --strip-components=1 -C node_modules/@magnaflow/chain-provider
+bun -e 'import {createViemChainFromConfig} from "@magnaflow/chain-provider"; const chain = createViemChainFromConfig({chain:"polygon_mainnet",rpc_url:"https://rpc.example",rest_url:""}); console.log(chain.id, chain.nativeCurrency.symbol);'
+bun run validate
+bun run build
+```
+
+The check prints `137 POL`. This package uses the workspace's bundler-style ESM
+output; run this check with Bun, as used by Kit. A later dependency install can
+replace the local package, so repeat the unpack and resolution check afterward.
+The `rpc.example` value only verifies resolution and makes no network request.
+
 - The default EVM chain resolver is currently tuned for BSC and BSC testnet style configs.
 - `TronProvider` supports native transfers and balance queries. Advanced Tron contract interaction lives outside this package.
 

package/dist/evm-chain-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evm-chain-utils.d.ts","sourceRoot":"","sources":["../src/evm-chain-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,EAAE,uBAyC5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAAwD,CAAC"}
+{"version":3,"file":"evm-chain-utils.d.ts","sourceRoot":"","sources":["../src/evm-chain-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,KAAK,CAAC;AAErE;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,EAAE,uBAsD5C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAAwD,CAAC"}

package/dist/evm-chain-utils.js

@@ -1,4 +1,5 @@
 import { bscTestnet, bsc } from 'viem/chains';
+import { getPolygonRpcUrl, isPolygonMainnet, POLYGON_MAINNET } from './polygon';
 /**
  * Implementation layer: default resolver that normalizes ChainConfig
  * into a viem Chain definition.
@@ -9,6 +10,18 @@ import { bscTestnet, bsc } from 'viem/chains';
  * - scan_url, if present, is used as the default block explorer URL.
  */
 export const defaultEvmChainRuntimeResolver = (chainConfig) => {
+    if (isPolygonMainnet(chainConfig.chain)) {
+        const rpc = getPolygonRpcUrl(chainConfig);
+        return {
+            ...POLYGON_MAINNET.preset,
+            nativeCurrency: POLYGON_MAINNET.nativeCurrency,
+            rpcUrls: { default: { http: [rpc] } },
+            blockExplorers: {
+                default: { name: 'Polygonscan', url: POLYGON_MAINNET.explorerUrl },
+            },
+            testnet: false,
+        };
+    }
     const isBscTestnet = chainConfig.rest_url.includes('prebsc') ||
         chainConfig.rest_url.includes('bsc-testnet') ||
         chainConfig.chain?.toLowerCase() === 'bsc_test';

package/dist/evm-provider.d.ts

@@ -33,9 +33,8 @@ export declare class EvmProvider implements ChainProvider {
      */
     getBlock(blockNumber?: bigint): Promise<{
         number: bigint;
-        nonce: `0x${string}`;
         hash: `0x${string}`;
-        gasUsed: bigint;
+        nonce: `0x${string}`;
         logsBloom: `0x${string}`;
         baseFeePerGas: bigint | null;
         blobGasUsed: bigint;
@@ -43,6 +42,7 @@ export declare class EvmProvider implements ChainProvider {
         excessBlobGas: bigint;
         extraData: import("viem").Hex;
         gasLimit: bigint;
+        gasUsed: bigint;
         miner: import("viem").Address;
         mixHash: import("viem").Hash;
         parentBeaconBlockRoot?: `0x${string}` | undefined;
@@ -64,129 +64,129 @@ export declare class EvmProvider implements ChainProvider {
      * Get transaction (using viem)
      */
     getTransaction(txHash: string): Promise<{
+        type: "legacy";
+        value: bigint;
+        yParity?: undefined | undefined;
         from: import("viem").Address;
         gas: bigint;
+        hash: import("viem").Hash;
+        input: import("viem").Hex;
         nonce: number;
-        to: import("viem").Address | null;
-        type: "legacy";
-        value: bigint;
         r: import("viem").Hex;
         s: import("viem").Hex;
+        to: import("viem").Address | null;
+        typeHex: import("viem").Hex | null;
         v: bigint;
-        yParity?: undefined | undefined;
+        accessList?: undefined | undefined;
+        authorizationList?: undefined | undefined;
         blobVersionedHashes?: undefined | undefined;
+        chainId?: number | undefined;
         gasPrice: bigint;
         maxFeePerBlobGas?: undefined | undefined;
         maxFeePerGas?: undefined | undefined;
         maxPriorityFeePerGas?: undefined | undefined;
-        chainId?: number | undefined;
-        accessList?: undefined | undefined;
-        authorizationList?: undefined | undefined;
-        hash: import("viem").Hash;
-        input: import("viem").Hex;
-        typeHex: import("viem").Hex | null;
-        blockNumber: bigint;
         blockHash: `0x${string}`;
+        blockNumber: bigint;
         transactionIndex: number;
     } | {
+        type: "eip2930";
+        value: bigint;
+        yParity: number;
         from: import("viem").Address;
         gas: bigint;
+        hash: import("viem").Hash;
+        input: import("viem").Hex;
         nonce: number;
-        to: import("viem").Address | null;
-        type: "eip2930";
-        value: bigint;
         r: import("viem").Hex;
         s: import("viem").Hex;
+        to: import("viem").Address | null;
+        typeHex: import("viem").Hex | null;
         v: bigint;
-        yParity: number;
+        accessList: import("viem").AccessList;
+        authorizationList?: undefined | undefined;
         blobVersionedHashes?: undefined | undefined;
+        chainId: number;
         gasPrice: bigint;
         maxFeePerBlobGas?: undefined | undefined;
         maxFeePerGas?: undefined | undefined;
         maxPriorityFeePerGas?: undefined | undefined;
-        chainId: number;
-        accessList: import("viem").AccessList;
-        authorizationList?: undefined | undefined;
-        hash: import("viem").Hash;
-        input: import("viem").Hex;
-        typeHex: import("viem").Hex | null;
-        blockNumber: bigint;
         blockHash: `0x${string}`;
+        blockNumber: bigint;
         transactionIndex: number;
     } | {
+        type: "eip1559";
+        value: bigint;
+        yParity: number;
         from: import("viem").Address;
         gas: bigint;
+        hash: import("viem").Hash;
+        input: import("viem").Hex;
         nonce: number;
-        to: import("viem").Address | null;
-        type: "eip1559";
-        value: bigint;
         r: import("viem").Hex;
         s: import("viem").Hex;
+        to: import("viem").Address | null;
+        typeHex: import("viem").Hex | null;
         v: bigint;
-        yParity: number;
+        accessList: import("viem").AccessList;
+        authorizationList?: undefined | undefined;
         blobVersionedHashes?: undefined | undefined;
+        chainId: number;
         gasPrice?: undefined | undefined;
         maxFeePerBlobGas?: undefined | undefined;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        chainId: number;
-        accessList: import("viem").AccessList;
-        authorizationList?: undefined | undefined;
-        hash: import("viem").Hash;
-        input: import("viem").Hex;
-        typeHex: import("viem").Hex | null;
-        blockNumber: bigint;
         blockHash: `0x${string}`;
+        blockNumber: bigint;
         transactionIndex: number;
     } | {
+        type: "eip4844";
+        value: bigint;
+        yParity: number;
         from: import("viem").Address;
         gas: bigint;
+        hash: import("viem").Hash;
+        input: import("viem").Hex;
         nonce: number;
-        to: import("viem").Address | null;
-        type: "eip4844";
-        value: bigint;
         r: import("viem").Hex;
         s: import("viem").Hex;
+        to: import("viem").Address | null;
+        typeHex: import("viem").Hex | null;
         v: bigint;
-        yParity: number;
+        accessList: import("viem").AccessList;
+        authorizationList?: undefined | undefined;
         blobVersionedHashes: readonly import("viem").Hex[];
+        chainId: number;
         gasPrice?: undefined | undefined;
         maxFeePerBlobGas: bigint;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        chainId: number;
-        accessList: import("viem").AccessList;
-        authorizationList?: undefined | undefined;
-        hash: import("viem").Hash;
-        input: import("viem").Hex;
-        typeHex: import("viem").Hex | null;
-        blockNumber: bigint;
         blockHash: `0x${string}`;
+        blockNumber: bigint;
         transactionIndex: number;
     } | {
+        type: "eip7702";
+        value: bigint;
+        yParity: number;
         from: import("viem").Address;
         gas: bigint;
+        hash: import("viem").Hash;
+        input: import("viem").Hex;
         nonce: number;
-        to: import("viem").Address | null;
-        type: "eip7702";
-        value: bigint;
         r: import("viem").Hex;
         s: import("viem").Hex;
+        to: import("viem").Address | null;
+        typeHex: import("viem").Hex | null;
         v: bigint;
-        yParity: number;
+        accessList: import("viem").AccessList;
+        authorizationList: import("viem").SignedAuthorizationList;
         blobVersionedHashes?: undefined | undefined;
+        chainId: number;
         gasPrice?: undefined | undefined;
         maxFeePerBlobGas?: undefined | undefined;
         maxFeePerGas: bigint;
         maxPriorityFeePerGas: bigint;
-        chainId: number;
-        accessList: import("viem").AccessList;
-        authorizationList: import("viem").SignedAuthorizationList;
-        hash: import("viem").Hash;
-        input: import("viem").Hex;
-        typeHex: import("viem").Hex | null;
-        blockNumber: bigint;
         blockHash: `0x${string}`;
+        blockNumber: bigint;
         transactionIndex: number;
     }>;
     /**

package/dist/evm-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evm-provider.d.ts","sourceRoot":"","sources":["../src/evm-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAElB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAItD;;GAEG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAC,CAAU;gBAEd,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU;IAgBjF,YAAY,IAAI,KAAK;IAIf,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB1F,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCjF,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAmCvB,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,kBAAkB,CAAC;IAmBxB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAoBzE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3F;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC;;OAEG;IACG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOnC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMnC;;OAEG;IACG,UAAU;IAIhB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA6B;IAClD,eAAe,IAAI,YAAY,GAAG,IAAI;CAavC"}
+{"version":3,"file":"evm-provider.d.ts","sourceRoot":"","sources":["../src/evm-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,KAAK,YAAY,EAEjB,KAAK,YAAY,EAElB,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD;;GAEG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,OAAO,CAAC,CAAU;gBAEd,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU;IAkBjF,YAAY,IAAI,KAAK;IAIf,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOlD,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB1F,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCjF,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,iBAAiB,CAAC;IAmCvB,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,kBAAkB,CAAC;IAmBxB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAuBzE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3F;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvC;;OAEG;IACG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOnC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMnC;;OAEG;IACG,UAAU;IAIhB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA6B;IAClD,eAAe,IAAI,YAAY,GAAG,IAAI;CAevC"}

package/dist/evm-provider.js

@@ -5,6 +5,7 @@ import { createPublicClient, createWalletClient, http, } from 'viem';
 import { mnemonicToAccount } from 'viem/accounts';
 import { DERIVATION_PATH_BASE, buildDerivationPath } from '@magnaflow/eoa-wallet';
 import { createViemChainFromConfig } from './evm-chain-utils';
+import { createPolygonTransport, isPolygonMainnet, isPolygonConfigurationError } from './polygon';
 /**
  * EVM chain provider
  */
@@ -19,7 +20,9 @@ export class EvmProvider {
         this.chain = createViemChainFromConfig(chainConfig);
         this.publicClient = createPublicClient({
             chain: this.chain,
-            transport: http(chainConfig.rest_url),
+            transport: isPolygonMainnet(chainConfig.chain)
+                ? createPolygonTransport(chainConfig)
+                : http(chainConfig.rest_url),
         });
         if (mnemonic) {
             const path = buildDerivationPath(DERIVATION_PATH_BASE.evm, accountIndex);
@@ -155,7 +158,10 @@ export class EvmProvider {
                 effectiveGasPrice: receipt.effectiveGasPrice,
             };
         }
-        catch {
+        catch (error) {
+            if (isPolygonMainnet(this.chainConfig.chain) && isPolygonConfigurationError(error)) {
+                throw error;
+            }
             return null;
         }
     }
@@ -210,7 +216,9 @@ export class EvmProvider {
             this._walletClient = createWalletClient({
                 account: this.account,
                 chain: this.chain,
-                transport: http(this.chainConfig.rest_url),
+                transport: isPolygonMainnet(this.chainConfig.chain)
+                    ? createPolygonTransport(this.chainConfig)
+                    : http(this.chainConfig.rest_url),
             });
         }
         return this._walletClient;

package/dist/index.d.ts

@@ -7,5 +7,7 @@ export type { ChainProvider } from './chain-provider';
 export { EvmProvider } from './evm-provider';
 export { TronProvider } from './tron-provider';
 export { createViemChainFromConfig } from './evm-chain-utils';
+export { POLYGON_MAINNET, PolygonConfigurationError, isPolygonMainnet, assertPolygonChainId, getPolygonRpcUrl, createPolygonTransport, isPolygonConfigurationError, } from './polygon';
+export type { PolygonRuntimeConfig } from './polygon';
 export { getChainType, createChainProvider, createEvmProvider, createTronProvider, } from './chain-factory';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAGtD,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -6,5 +6,6 @@
 export { EvmProvider } from './evm-provider';
 export { TronProvider } from './tron-provider';
 export { createViemChainFromConfig } from './evm-chain-utils';
+export { POLYGON_MAINNET, PolygonConfigurationError, isPolygonMainnet, assertPolygonChainId, getPolygonRpcUrl, createPolygonTransport, isPolygonConfigurationError, } from './polygon';
 // Factory
 export { getChainType, createChainProvider, createEvmProvider, createTronProvider, } from './chain-factory';

package/dist/polygon.d.ts

@@ -0,0 +1,74 @@
+import { type HttpTransportConfig, type Transport } from 'viem';
+export declare const POLYGON_MAINNET: {
+    readonly key: "polygon_mainnet";
+    readonly id: 137;
+    readonly hexId: "0x89";
+    readonly preset: {
+        blockExplorers: {
+            readonly default: {
+                readonly name: "PolygonScan";
+                readonly url: "https://polygonscan.com";
+                readonly apiUrl: "https://api.etherscan.io/v2/api";
+            };
+        };
+        blockTime: 2000;
+        contracts: {
+            readonly multicall3: {
+                readonly address: "0xca11bde05977b3631167028862be2a173976ca11";
+                readonly blockCreated: 25770160;
+            };
+        };
+        ensTlds?: readonly string[] | undefined;
+        id: 137;
+        name: "Polygon";
+        nativeCurrency: {
+            readonly name: "POL";
+            readonly symbol: "POL";
+            readonly decimals: 18;
+        };
+        experimental_preconfirmationTime?: number | undefined | undefined;
+        rpcUrls: {
+            readonly default: {
+                readonly http: readonly ["https://polygon.drpc.org"];
+            };
+        };
+        sourceId?: number | undefined | undefined;
+        testnet?: boolean | undefined | undefined;
+        custom?: Record<string, unknown> | undefined;
+        extendSchema?: Record<string, unknown> | undefined;
+        fees?: import("viem").ChainFees<undefined> | undefined;
+        formatters?: undefined;
+        prepareTransactionRequest?: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<import("viem").PrepareTransactionRequestParameters>) | [fn: ((args: import("viem").PrepareTransactionRequestParameters, options: {
+            phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+        }) => Promise<import("viem").PrepareTransactionRequestParameters>) | undefined, options: {
+            runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+        }] | undefined;
+        serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+        verifyHash?: ((client: import("viem").Client, parameters: import("viem").VerifyHashActionParameters) => Promise<import("viem").VerifyHashActionReturnType>) | undefined;
+    };
+    readonly nativeCurrency: {
+        readonly name: "POL";
+        readonly symbol: "POL";
+        readonly decimals: 18;
+    };
+    readonly explorerUrl: "https://polygonscan.com/";
+    readonly testnet: false;
+};
+export interface PolygonRuntimeConfig {
+    chain: string;
+    rpc_url?: string;
+    rest_url?: string;
+    chain_id?: number | string;
+    chainId?: number | string;
+}
+export declare class PolygonConfigurationError extends Error {
+    constructor(message: string);
+}
+export declare const isPolygonMainnet: (chain: unknown) => chain is "polygon_mainnet";
+export declare function assertPolygonChainId(value: unknown): void;
+export declare function getPolygonRpcUrl(config: PolygonRuntimeConfig): string;
+export declare function isPolygonConfigurationError(error: unknown): boolean;
+export declare function createPolygonTransport(config: PolygonRuntimeConfig, options?: HttpTransportConfig): Transport;
+//# sourceMappingURL=polygon.d.ts.map

package/dist/polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../src/polygon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,MAAM,CAAC;AAGtE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlB,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAED,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,iBAC5B,CAAC;AAEhC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CASzD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAkCrE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASnE;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,SAAS,CAwCX"}

package/dist/polygon.js

@@ -0,0 +1,115 @@
+import { http } from 'viem';
+import { polygon } from 'viem/chains';
+export const POLYGON_MAINNET = {
+    key: 'polygon_mainnet',
+    id: 137,
+    hexId: '0x89',
+    preset: polygon,
+    nativeCurrency: { name: 'POL', symbol: 'POL', decimals: 18 },
+    explorerUrl: 'https://polygonscan.com/',
+    testnet: false,
+};
+export class PolygonConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PolygonConfigurationError';
+    }
+}
+export const isPolygonMainnet = (chain) => chain === POLYGON_MAINNET.key;
+export function assertPolygonChainId(value) {
+    const validNumber = typeof value === 'number' && value === POLYGON_MAINNET.id;
+    const validString = typeof value === 'string' &&
+        /^(?:[0-9]+|0[xX][0-9a-fA-F]+)$/.test(value.trim()) &&
+        BigInt(value.trim()) === BigInt(POLYGON_MAINNET.id);
+    if (!validNumber && !validString) {
+        throw new PolygonConfigurationError('Polygon requires chain ID 137 (0x89).');
+    }
+}
+export function getPolygonRpcUrl(config) {
+    if (!isPolygonMainnet(config.chain)) {
+        throw new PolygonConfigurationError('Unsupported Polygon chain key.');
+    }
+    if (config.chain_id !== undefined)
+        assertPolygonChainId(config.chain_id);
+    if (config.chainId !== undefined)
+        assertPolygonChainId(config.chainId);
+    const symbol = config.symbol;
+    if (symbol !== undefined && symbol !== 'POL') {
+        throw new PolygonConfigurationError('Polygon native symbol must be POL.');
+    }
+    if (config.rpc_url !== undefined &&
+        config.rpc_url !== null &&
+        typeof config.rpc_url !== 'string') {
+        throw new PolygonConfigurationError('Polygon runtime RPC URL is invalid.');
+    }
+    const primaryRpc = config.rpc_url?.trim();
+    if (!primaryRpc &&
+        config.rest_url !== undefined &&
+        config.rest_url !== null &&
+        typeof config.rest_url !== 'string') {
+        throw new PolygonConfigurationError('Polygon runtime RPC URL is invalid.');
+    }
+    const rpc = primaryRpc || config.rest_url?.trim() || '';
+    try {
+        const url = new URL(rpc);
+        if (url.protocol !== 'https:' && url.protocol !== 'http:')
+            throw new Error();
+    }
+    catch {
+        throw new PolygonConfigurationError('Polygon runtime RPC URL is missing or invalid.');
+    }
+    return rpc;
+}
+export function isPolygonConfigurationError(error) {
+    const visited = new Set();
+    let current = error;
+    while (current && typeof current === 'object' && !visited.has(current)) {
+        visited.add(current);
+        if ('name' in current && current.name === 'PolygonConfigurationError')
+            return true;
+        current = 'cause' in current ? current.cause : undefined;
+    }
+    return false;
+}
+export function createPolygonTransport(config, options) {
+    const rpc = getPolygonRpcUrl(config);
+    return (parameters) => {
+        const transport = http(rpc, options)(parameters);
+        let verified = false;
+        let pending;
+        const verify = (force = false) => {
+            if (pending)
+                return pending;
+            if (verified && !force)
+                return Promise.resolve();
+            pending = transport
+                .request({ method: 'eth_chainId' })
+                .then((value) => {
+                assertPolygonChainId(value);
+                verified = true;
+            })
+                .catch((error) => {
+                verified = false;
+                throw error;
+            })
+                .finally(() => {
+                pending = undefined;
+            });
+            return pending;
+        };
+        return {
+            ...transport,
+            request: (async (args, requestOptions) => {
+                const method = args.method;
+                // Recheck before broadcasting, including direct wallet-client requests.
+                await verify(method === 'eth_chainId' ||
+                    method === 'eth_sendRawTransaction' ||
+                    method === 'eth_sendTransaction' ||
+                    method === 'wallet_sendCalls');
+                if (method === 'eth_chainId')
+                    return POLYGON_MAINNET.hexId;
+                return transport.request(args, requestOptions);
+            }),
+        };
+    };
+}

package/dist/types.d.ts

@@ -12,6 +12,8 @@ export interface ChainConfig {
     rest_url: string;
     payout_contract: string;
     scan_url?: string;
+    chain_id?: number | string;
+    chainId?: number | string;
     tokens?: TokenConfig[];
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magnaflow/chain-provider",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Chain provider abstraction library for unified blockchain interactions",
   "type": "module",
   "main": "./dist/index.js",