@piprail/sdk 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to `@piprail/sdk` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
 versions follow [Semantic Versioning](https://semver.org/).
 
+## [1.2.0] — 2026-06-04
+
+Two new EVM presets — **HyperEVM (Hyperliquid)** and **Monad** — bringing the built-in count to
+**26 chains across 8 families (19 EVM)**. Both reuse the existing EVM driver: one row of
+on-chain-verified data each, no new code path and no new peer dep. Fully backward-compatible.
+
+### Added
+- **HyperEVM (Hyperliquid), `chain: 'hyperevm'`, chainId 999** — native Circle USDC
+  (`0xb88339CB7199b77E23DB6E890353E22632Ba630f`, 6 dp; CCTP V2). The highest-activity EVM venue
+  of 2025–26 (perps DEX + on-chain agent vaults). Pay in USDC or native HYPE. HyperEVM's USDT is
+  USDT0 (LayerZero), not Tether-native, so it's omitted (pass it as a custom `{ address, decimals }`).
+- **Monad, `chain: 'monad'`, chainId 143** — native Circle USDC
+  (`0x754704Bc059F8C67012fEd69BC8A327a5aafb603`, 6 dp; CCTP V2). The biggest new EVM L1 of 2025
+  (parallel EVM, ~10k TPS). Pay in USDC or native MON. USDT0 omitted, as above.
+
+Both addresses were verified on-chain (live `eth_chainId` + `symbol()`/`decimals()`) before
+shipping; `chain: 'hyperevm'` / `chain: 'monad'` work with no setup call.
+
+## [1.1.1] — 2026-06-03
+
+Docs + examples only — **no code change**; the API and every chain behave exactly as 1.1.0.
+
+### Docs
+- **"In the browser — no build, no npm" guide** in the README. `@piprail/sdk` is browser-clean
+  and runs from any npm-mirroring CDN (`esm.sh` / `jsDelivr`), so a plain HTML page can take or
+  make payments with no bundler — the CDN resolves `viem` and any lazily-imported chain lib.
+  Verified end-to-end (gate + client, Node + browser, plus a real on-chain payment made **from a
+  browser**). Includes the injected-wallet pattern and a loud "never ship a raw key in client-side
+  HTML" warning.
+
+### Examples
+- **New `examples/browser/`** — a single self-contained HTML file that loads the SDK from a CDN and
+  runs a live in-browser x402 demo (build a real `402` challenge, quote it), no build step. A hosted,
+  interactive version of the same demo is live at https://piprail.com/demo.
+
 ## [1.1.0] — 2026-06-03
 
 Found by the live-test campaign: **native NEAR + native TRX are now payment assets** (native

package/README.md

@@ -160,6 +160,8 @@ Every token address below was verified on-chain (symbol + decimals) before shipp
 | `'worldchain'` | World Chain | USDC |
 | `'sei'` | Sei | USDC |
 | `'injective'` | Injective | USDC, USDT |
+| `'hyperevm'` | HyperEVM (Hyperliquid) | USDC |
+| `'monad'` | Monad | USDC |
 | `'solana'` | Solana | USDC, USDT |
 | `'ton'` | TON | USDT |
 | `'tron'` | Tron | USDT |
@@ -445,6 +447,27 @@ export async function handler(req: Request): Promise<Response> {
 
 Reuse one gate per route — its in-memory replay guard stops a proof being spent twice. Running multiple instances? Pass your own `isUsed` / `markUsed` (e.g. Redis `SET NX`).
 
+## In the browser — no build, no npm
+
+The SDK is browser-clean (no Node-only globals in the protocol layer), so a plain HTML page can take **or** make payments straight from a CDN — every npm-mirroring CDN serves it automatically:
+
+```html
+<script type="module">
+  import { PipRailClient } from 'https://esm.sh/@piprail/sdk'   // or jsDelivr: .../npm/@piprail/sdk@1/+esm
+  // In a browser, sign with the visitor's wallet — never a raw key (page source is public):
+  import { createWalletClient, custom } from 'https://esm.sh/viem'
+  const walletClient = createWalletClient({ transport: custom(window.ethereum) })
+
+  const client = new PipRailClient({ chain: 'base', wallet: { walletClient } })
+  const res = await client.fetch('https://api.example.com/paid')   // 402 → wallet signs → 200
+</script>
+```
+
+- **Which chains run in the browser.** EVM (viem) works out of the box; **Solana, Sui, and NEAR** load their libs from the CDN too (an [import map](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap) pins each to a browser-ESM build — see [`examples/browser/`](../examples/browser)). A few chains' libraries (**TON, Tron, XRPL, Stellar**) don't ship a clean browser ESM build yet, so use those **server-side** — the identical one line, on Node/Bun/Deno/Workers. The lazy import means a pure-EVM page never downloads any of them.
+- **The merchant gate runs anywhere.** `createPaymentGate` needs only a `payTo` address — no key — so building challenges and verifying proofs works in the browser too (the typical *deployment* is still a server, since a browser can't receive inbound HTTP to gate).
+- **Both halves verified on Node and in a real browser**, against the published package. Runnable showcase: [`examples/browser/`](../examples/browser) — a single HTML file with a live, in-browser 402 demo; or try it hosted at [piprail.com/demo](https://piprail.com/demo).
+- **Keys:** raw `{ privateKey }` wallets belong only in a **server's** environment. In a browser, use an injected `walletClient` as above.
+
 ## Architecture (under the hood)
 
 Two layers, one contract. Worth knowing if you're extending the SDK or auditing it.

package/dist/index.cjs

@@ -82,6 +82,8 @@ var _viem = require('viem');
 
 
 
+
+
 
 var _chains = require('viem/chains');
 var CHAINS = {
@@ -210,6 +212,28 @@ var CHAINS = {
       USDC: { address: "0xa00C59fF5a080D2b954d0c75e46E22a0c371235a", decimals: 6, symbol: "USDC" },
       USDT: { address: "0x88f7F2b685F9692caf8c478f5BADF09eE9B1Cc13", decimals: 6, symbol: "USDT" }
     }
+  },
+  // HyperEVM (Hyperliquid, chainId 999) — native Circle USDC, verified on-chain
+  // 2026-06-04 (eth_chainId 0x3e7; USDC symbol "USDC", decimals 6). HyperEVM's
+  // "USDT" is USDT0 (LayerZero/omnichain), not Circle/Tether-native, so it's
+  // intentionally omitted; pass it as a custom { address, decimals } if needed.
+  // The highest-activity EVM venue of 2025–26 (perps DEX + on-chain agent vaults).
+  hyperevm: {
+    chain: _chains.hyperEvm,
+    tokens: {
+      USDC: { address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f", decimals: 6, symbol: "USDC" }
+    }
+  },
+  // Monad (chainId 143) — native Circle USDC, verified on-chain 2026-06-04
+  // (eth_chainId 0x8f; USDC symbol "USDC", decimals 6; CCTP V2). Monad's "USDT"
+  // is USDT0 (LayerZero/omnichain), not Circle/Tether-native, so it's
+  // intentionally omitted; pass it as a custom { address, decimals } if needed.
+  // The biggest new EVM L1 of 2025 (parallel EVM, ~10k TPS).
+  monad: {
+    chain: _chains.monad,
+    tokens: {
+      USDC: { address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603", decimals: 6, symbol: "USDC" }
+    }
   }
 };
 function isViemChain(input) {

package/dist/index.d.cts

@@ -838,7 +838,7 @@ declare const CHAINS: {
                         gasPrice: bigint;
                         maxFeePerBlobGas?: undefined | undefined;
                         maxFeePerGas?: undefined | undefined;
-                        maxPriorityFeePerGas?: undefined | undefined;
+                        maxPriorityFeePerGas? /** Native coin metadata. Defaults to 18-decimal ETH. */: undefined | undefined;
                         isSystemTx?: undefined | undefined;
                         mint?: undefined | undefined;
                         sourceHash?: undefined | undefined;
@@ -1580,7 +1580,7 @@ declare const CHAINS: {
                         yParity: number;
                         accessList: viem.AccessList;
                         authorizationList?: undefined | undefined;
-                        blobVersionedHashes? /** EVM chain id, e.g. 5000 for Mantle. */: undefined | undefined;
+                        blobVersionedHashes?: undefined | undefined;
                         chainId: number;
                         type: "eip1559";
                         gasPrice?: undefined | undefined;
@@ -2982,7 +2982,7 @@ declare const CHAINS: {
                     } | {
                         blockHash: `0x${string}` | null;
                         blockNumber: bigint | null;
-                        blockTimestamp? /** JSON-RPC endpoint. */: bigint | undefined;
+                        blockTimestamp?: bigint | undefined;
                         from: abitype.Address;
                         gas: bigint;
                         hash: viem.Hash;
@@ -3340,7 +3340,9 @@ declare const CHAINS: {
                         value: bigint;
                         yParity: number;
                         accessList: viem.AccessList;
-                        authorizationList?: undefined | undefined;
+                        authorizationList
+                        /** JSON-RPC endpoint. */
+                        ? /** JSON-RPC endpoint. */: undefined | undefined;
                         blobVersionedHashes?: undefined | undefined;
                         chainId: number;
                         type: "eip2930";
@@ -3614,6 +3616,122 @@ declare const CHAINS: {
             };
         };
     };
+    hyperevm: {
+        chain: {
+            blockExplorers: {
+                readonly default: {
+                    readonly name: "HyperEVMScan";
+                    readonly url: "https://hyperevmscan.io";
+                };
+            };
+            blockTime?: number | undefined | undefined;
+            contracts: {
+                readonly multicall3: {
+                    readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+                    readonly blockCreated: 13051;
+                };
+            };
+            ensTlds?: readonly string[] | undefined;
+            id: 999;
+            name: "HyperEVM";
+            nativeCurrency: {
+                readonly name: "HYPE";
+                readonly symbol: "HYPE";
+                readonly decimals: 18;
+            };
+            experimental_preconfirmationTime?: number | undefined | undefined;
+            rpcUrls: {
+                readonly default: {
+                    readonly http: readonly ["https://rpc.hyperliquid.xyz/evm"];
+                };
+            };
+            sourceId?: number | undefined | undefined;
+            testnet: false;
+            custom?: Record<string, unknown> | undefined;
+            extendSchema?: Record<string, unknown> | undefined;
+            fees?: viem.ChainFees<undefined> | undefined;
+            formatters?: undefined;
+            prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+                runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+            }] | undefined;
+            serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+            verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+        };
+        tokens: {
+            USDC: {
+                address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
+                decimals: number;
+                symbol: string;
+            };
+        };
+    };
+    monad: {
+        chain: {
+            blockExplorers: {
+                readonly default: {
+                    readonly name: "MonadVision";
+                    readonly url: "https://monadvision.com";
+                };
+                readonly monadscan: {
+                    readonly name: "Monadscan";
+                    readonly url: "https://monadscan.com";
+                    readonly apiUrl: "https://api.monadscan.com/api";
+                };
+            };
+            blockTime: 400;
+            contracts: {
+                readonly multicall3: {
+                    readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+                    readonly blockCreated: 9248132;
+                };
+            };
+            ensTlds?: readonly string[] | undefined;
+            id: 143;
+            name: "Monad";
+            nativeCurrency: {
+                readonly name: "Monad";
+                readonly symbol: "MON";
+                readonly decimals: 18;
+            };
+            experimental_preconfirmationTime?: number | undefined | undefined;
+            rpcUrls: {
+                readonly default: {
+                    readonly http: readonly ["https://rpc.monad.xyz", "https://rpc1.monad.xyz"];
+                    readonly webSocket: readonly ["wss://rpc.monad.xyz", "wss://rpc1.monad.xyz"];
+                };
+            };
+            sourceId?: number | undefined | undefined;
+            testnet: false;
+            custom?: Record<string, unknown> | undefined;
+            extendSchema?: Record<string, unknown> | undefined;
+            fees?: viem.ChainFees<undefined> | undefined;
+            formatters?: undefined;
+            prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+                runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+            }] | undefined;
+            serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+            verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+        };
+        tokens: {
+            USDC: {
+                address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603";
+                decimals: number;
+                symbol: string;
+            };
+        };
+    };
 };
 /** A built-in EVM chain name. */
 type ChainName = keyof typeof CHAINS;

package/dist/index.d.ts

@@ -838,7 +838,7 @@ declare const CHAINS: {
                         gasPrice: bigint;
                         maxFeePerBlobGas?: undefined | undefined;
                         maxFeePerGas?: undefined | undefined;
-                        maxPriorityFeePerGas?: undefined | undefined;
+                        maxPriorityFeePerGas? /** Native coin metadata. Defaults to 18-decimal ETH. */: undefined | undefined;
                         isSystemTx?: undefined | undefined;
                         mint?: undefined | undefined;
                         sourceHash?: undefined | undefined;
@@ -1580,7 +1580,7 @@ declare const CHAINS: {
                         yParity: number;
                         accessList: viem.AccessList;
                         authorizationList?: undefined | undefined;
-                        blobVersionedHashes? /** EVM chain id, e.g. 5000 for Mantle. */: undefined | undefined;
+                        blobVersionedHashes?: undefined | undefined;
                         chainId: number;
                         type: "eip1559";
                         gasPrice?: undefined | undefined;
@@ -2982,7 +2982,7 @@ declare const CHAINS: {
                     } | {
                         blockHash: `0x${string}` | null;
                         blockNumber: bigint | null;
-                        blockTimestamp? /** JSON-RPC endpoint. */: bigint | undefined;
+                        blockTimestamp?: bigint | undefined;
                         from: abitype.Address;
                         gas: bigint;
                         hash: viem.Hash;
@@ -3340,7 +3340,9 @@ declare const CHAINS: {
                         value: bigint;
                         yParity: number;
                         accessList: viem.AccessList;
-                        authorizationList?: undefined | undefined;
+                        authorizationList
+                        /** JSON-RPC endpoint. */
+                        ? /** JSON-RPC endpoint. */: undefined | undefined;
                         blobVersionedHashes?: undefined | undefined;
                         chainId: number;
                         type: "eip2930";
@@ -3614,6 +3616,122 @@ declare const CHAINS: {
             };
         };
     };
+    hyperevm: {
+        chain: {
+            blockExplorers: {
+                readonly default: {
+                    readonly name: "HyperEVMScan";
+                    readonly url: "https://hyperevmscan.io";
+                };
+            };
+            blockTime?: number | undefined | undefined;
+            contracts: {
+                readonly multicall3: {
+                    readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+                    readonly blockCreated: 13051;
+                };
+            };
+            ensTlds?: readonly string[] | undefined;
+            id: 999;
+            name: "HyperEVM";
+            nativeCurrency: {
+                readonly name: "HYPE";
+                readonly symbol: "HYPE";
+                readonly decimals: 18;
+            };
+            experimental_preconfirmationTime?: number | undefined | undefined;
+            rpcUrls: {
+                readonly default: {
+                    readonly http: readonly ["https://rpc.hyperliquid.xyz/evm"];
+                };
+            };
+            sourceId?: number | undefined | undefined;
+            testnet: false;
+            custom?: Record<string, unknown> | undefined;
+            extendSchema?: Record<string, unknown> | undefined;
+            fees?: viem.ChainFees<undefined> | undefined;
+            formatters?: undefined;
+            prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+                runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+            }] | undefined;
+            serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+            verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+        };
+        tokens: {
+            USDC: {
+                address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
+                decimals: number;
+                symbol: string;
+            };
+        };
+    };
+    monad: {
+        chain: {
+            blockExplorers: {
+                readonly default: {
+                    readonly name: "MonadVision";
+                    readonly url: "https://monadvision.com";
+                };
+                readonly monadscan: {
+                    readonly name: "Monadscan";
+                    readonly url: "https://monadscan.com";
+                    readonly apiUrl: "https://api.monadscan.com/api";
+                };
+            };
+            blockTime: 400;
+            contracts: {
+                readonly multicall3: {
+                    readonly address: "0xcA11bde05977b3631167028862bE2a173976CA11";
+                    readonly blockCreated: 9248132;
+                };
+            };
+            ensTlds?: readonly string[] | undefined;
+            id: 143;
+            name: "Monad";
+            nativeCurrency: {
+                readonly name: "Monad";
+                readonly symbol: "MON";
+                readonly decimals: 18;
+            };
+            experimental_preconfirmationTime?: number | undefined | undefined;
+            rpcUrls: {
+                readonly default: {
+                    readonly http: readonly ["https://rpc.monad.xyz", "https://rpc1.monad.xyz"];
+                    readonly webSocket: readonly ["wss://rpc.monad.xyz", "wss://rpc1.monad.xyz"];
+                };
+            };
+            sourceId?: number | undefined | undefined;
+            testnet: false;
+            custom?: Record<string, unknown> | undefined;
+            extendSchema?: Record<string, unknown> | undefined;
+            fees?: viem.ChainFees<undefined> | undefined;
+            formatters?: undefined;
+            prepareTransactionRequest?: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | [fn: ((args: viem.PrepareTransactionRequestParameters, options: {
+                client: viem.Client;
+                phase: "beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters";
+            }) => Promise<viem.PrepareTransactionRequestParameters>) | undefined, options: {
+                runAt: readonly ("beforeFillTransaction" | "beforeFillParameters" | "afterFillParameters")[];
+            }] | undefined;
+            serializers?: viem.ChainSerializers<undefined, viem.TransactionSerializable> | undefined;
+            verifyHash?: ((client: viem.Client, parameters: viem.VerifyHashActionParameters) => Promise<viem.VerifyHashActionReturnType>) | undefined;
+        };
+        tokens: {
+            USDC: {
+                address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603";
+                decimals: number;
+                symbol: string;
+            };
+        };
+    };
 };
 /** A built-in EVM chain name. */
 type ChainName = keyof typeof CHAINS;

package/dist/index.js

@@ -71,10 +71,12 @@ import {
   base,
   bsc,
   celo,
+  hyperEvm,
   injective,
   linea,
   mainnet,
   mantle,
+  monad,
   optimism,
   polygon,
   scroll,
@@ -210,6 +212,28 @@ var CHAINS = {
       USDC: { address: "0xa00C59fF5a080D2b954d0c75e46E22a0c371235a", decimals: 6, symbol: "USDC" },
       USDT: { address: "0x88f7F2b685F9692caf8c478f5BADF09eE9B1Cc13", decimals: 6, symbol: "USDT" }
     }
+  },
+  // HyperEVM (Hyperliquid, chainId 999) — native Circle USDC, verified on-chain
+  // 2026-06-04 (eth_chainId 0x3e7; USDC symbol "USDC", decimals 6). HyperEVM's
+  // "USDT" is USDT0 (LayerZero/omnichain), not Circle/Tether-native, so it's
+  // intentionally omitted; pass it as a custom { address, decimals } if needed.
+  // The highest-activity EVM venue of 2025–26 (perps DEX + on-chain agent vaults).
+  hyperevm: {
+    chain: hyperEvm,
+    tokens: {
+      USDC: { address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f", decimals: 6, symbol: "USDC" }
+    }
+  },
+  // Monad (chainId 143) — native Circle USDC, verified on-chain 2026-06-04
+  // (eth_chainId 0x8f; USDC symbol "USDC", decimals 6; CCTP V2). Monad's "USDT"
+  // is USDT0 (LayerZero/omnichain), not Circle/Tether-native, so it's
+  // intentionally omitted; pass it as a custom { address, decimals } if needed.
+  // The biggest new EVM L1 of 2025 (parallel EVM, ~10k TPS).
+  monad: {
+    chain: monad,
+    tokens: {
+      USDC: { address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603", decimals: 6, symbol: "USDC" }
+    }
   }
 };
 function isViemChain(input) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@piprail/sdk",
-  "version": "1.1.0",
-  "description": "Accept x402 crypto payments across 24 chains — every major EVM chain plus Solana, TON, Tron, NEAR, Sui, Stellar & XRPL — in a couple of lines. No backend, no database, no fee; payments settle straight to your wallet.",
+  "version": "1.2.0",
+  "description": "Accept x402 crypto payments across 26 chains — every major EVM chain plus Solana, TON, Tron, NEAR, Sui, Stellar & XRPL — in a couple of lines. No backend, no database, no fee; payments settle straight to your wallet.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",