@reptilianhq/uniswap-sdk 0.8.0 → 0.9.0

package/README.md

@@ -8,7 +8,8 @@ It never owns keys, authorization policy, transaction submission, persistence, o
 ## Capabilities and ownership
 
 - `./v4`: full pool identity, Initialize-log normalization, pool state,
-  exact-input Quoter simulation, ordered quote batches, initialized tick windows.
+  exact-input Quoter simulation, ordered quote batches, initialized tick windows,
+  reviewed Arc infrastructure, and unsigned position-mint material with strict review.
 - `./v3`: Robinhood v3 deployment identity, compatibility checks, unsigned
   position transaction builders, strict calldata review, and receipt evidence.
 - `./deployments`, `./compatibility`, `./transactions`, `./receipts`: stable
@@ -72,8 +73,10 @@ A complete deterministic consumer example is available in
 the published package subpaths and demonstrates a pool observation, a partial
 tick result, and branching on `isUniswapSdkError`.
 
-The v4 `reviewedDeployment` contains chainId, PoolManager, StateView and Quoter addresses.
-There are no implicit v4 Robinhood or Arc deployments. Hosts own endpoint selection,
+Generic v4 reads still require an explicit `reviewedDeployment`. Arc hosts may select
+`arcUniswapV4Mainnet` and must run `verifyArcUniswapV4Compatibility` before relying on
+its pinned shared Uniswap infrastructure. This does not authenticate Argus Portal,
+hook, locker, splitter, tracker, or fee semantics. Hosts own endpoint selection,
 finality, capability policy and secret storage. For multicall consumers, use
 `quoteV4WithBatch`, `v4PoolStateCalls`, `decodeV4PoolState`,
 `readV4PoolStatesWithBatch`, and `readV4TicksWithBatch` from `./batch`.
@@ -84,9 +87,11 @@ the host must check chain/deployment identity and Quoter multicall compatibility
 
 The direct-client RPC operations check chain identity (the `./batch` host owns that check). Pool/tick reads check StateView's
 PoolManager pointer; quotes check the Quoter pointer at the observation block.
-`verifyV4DeploymentWiring` checks both pointers. This proves wiring only: a contract that
-returns the expected pointer is not necessarily the reviewed implementation.
-Source/code verification and hook-specific compatibility remain release gates.
+`verifyV4DeploymentWiring` checks both pointers. This proves wiring only. Arc's stronger
+compatibility check pins the canonical block, exact runtime hashes, and immutable manager
+wiring; the separate retained-artifact verifier validates the official manifest and
+reproduces the generated deployment artifacts. It does not freshly compile Solidity.
+Hook-specific compatibility remains an adapter release gate.
 
 All state calls in an operation use one block number. Quote batches use up to
 four concurrent individual eth_calls by default (maximum 16; at most 256 quotes).
@@ -146,21 +151,20 @@ package-subpath consumer example. `npm run test:fork` additionally executes an
 SDK-built and reviewed full position close against the pinned Anvil fork
 documented in [docs/FORK_TESTING.md](./docs/FORK_TESTING.md).
 
-`npm run test:live-compatibility` rechecks both exported deployments against
-their public RPCs. `UNISWAP_MAINNET_RPC_URL` and `UNISWAP_TESTNET_RPC_URL` may
-override those read-only endpoints.
+`npm run test:live-compatibility` rechecks the two Robinhood deployments and the Arc v4
+deployment against their public RPCs. `UNISWAP_MAINNET_RPC_URL`,
+`UNISWAP_TESTNET_RPC_URL`, and `UNISWAP_ARC_RPC_URL` may override those read-only
+endpoints. Retained-artifact reproduction is documented in
+[docs/ARC_V4_PROVENANCE.md](./docs/ARC_V4_PROVENANCE.md).
 
 Releases use the versioned Reptilian publisher, exact main-ancestry tags,
 immutable archive verification, and retained evidence; see [RELEASING.md](./RELEASING.md).
-The v3 surface is capital-moving protocol support: it prepares unsigned calldata
-and verifies protocol-specific transaction and receipt facts. It does not grant
-authorization or submit transactions. The v4 surface remains read-only and does
-not claim Arc deployment or custom-hook compatibility. Never treat a local test
-or a successful wiring check as source verification.
-
-Next: supply Arc contract/RPC details, verify code and hook/custody semantics,
-then add its adapter and a tested managed-position lifecycle. Existing v3-only
-application capability gates remain appropriate until that adapter is verified.
+The v3 and v4 transaction surfaces prepare unsigned calldata and verify protocol-specific
+facts. They do not grant authorization or submit transactions. Arc shared Uniswap source
+and runtime identity are reviewed; Argus custom-hook, fee, custody, and permanently locked
+launch-principal semantics are not claimed here. Keep application write capability gated
+until the launcher adapter proves those semantics with exact-router simulation and pinned
+fork evidence.
 
 ## Protocol provider composition
 

package/RELEASING.md

@@ -65,8 +65,11 @@ conformance rules. Run `npm run test:fork` separately with an
 archive-capable `SDK_FORK_EIP155_4663_RPC_URL`; it simulates and executes the
 reviewed close path on a pinned Anvil fork, then requires the collected receipt
 amounts to match the simulation. Run `npm run test:live-compatibility` before release to
-recheck both deployment records. Runtime code identity is not source verification or
-custom-hook compatibility. Arc details remain unavailable.
+recheck all three deployment records. Runtime code identity is not source verification or
+custom-hook compatibility. Arc's shared Uniswap deployment is runtime-pinned and its
+official manifest plus retained generated artifacts are reproducible as documented in
+`docs/ARC_V4_PROVENANCE.md`; this is not a fresh source compilation and does not establish
+Argus launcher semantics.
 
 Set one exact version such as `<version>` in package.json and package-lock.json,
 land the source on main, then push its immutable tag `uniswap-sdk-v<version>`.

package/dist/abis.d.ts

@@ -158,6 +158,46 @@ export declare const v4PoolManagerAbi: readonly [{
     }];
 }];
 export declare const v4PositionManagerAbi: readonly [{
+    readonly name: "poolManager";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "permit2";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "WETH9";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "tokenDescriptor";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "unsubscribeGasLimit";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+}, {
     readonly name: "initializePool";
     readonly type: "function";
     readonly stateMutability: "payable";

package/dist/abis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ/B,CAAC;AAEH,cAAc,cAAc,CAAC"}
+{"version":3,"file":"abis.d.ts","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtB,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAEH,cAAc,cAAc,CAAC"}

package/dist/abis.js

@@ -18,6 +18,11 @@ export const v4PoolManagerAbi = parseAbi([
     'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',
 ]);
 export const v4PositionManagerAbi = parseAbi([
+    'function poolManager() view returns (address)',
+    'function permit2() view returns (address)',
+    'function WETH9() view returns (address)',
+    'function tokenDescriptor() view returns (address)',
+    'function unsubscribeGasLimit() view returns (uint256)',
     'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',
     'struct AllowanceTransferDetails { address token; uint160 amount; uint48 expiration; uint48 nonce; }',
     'struct AllowanceTransferPermitBatch { AllowanceTransferDetails[] details; address spender; uint256 sigDeadline; }',

package/dist/abis.js.map

@@ -1 +1 @@
-{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,+CAA+C;IAC/C,qHAAqH;IACrH,wEAAwE;IACxE,2EAA2E;IAC3E,kHAAkH;CACnH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,wGAAwG;IACxG,0GAA0G;IAC1G,gHAAgH;CACjH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACvC,4KAA4K;CAC7K,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,wGAAwG;IACxG,qGAAqG;IACrG,mHAAmH;IACnH,oFAAoF;IACpF,wEAAwE;IACxE,oEAAoE;IACpE,4HAA4H;CAC7H,CAAC,CAAC;AAEH,cAAc,cAAc,CAAC","sourcesContent":["import { parseAbi } from 'viem';\n\n// Standard v4-core/periphery selectors; extracted from the bot's read surface.\n// They do not attest compatibility of a supplied custom deployment.\nexport const v4StateViewAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',\n  'function getLiquidity(bytes32 poolId) view returns (uint128 liquidity)',\n  'function getTickBitmap(bytes32 poolId, int16 word) view returns (uint256)',\n  'function getTickLiquidity(bytes32 poolId, int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet)',\n]);\nexport const v4QuoterAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct QuoteExactSingleParams { PoolKey poolKey; bool zeroForOne; uint128 exactAmount; bytes hookData; }',\n  'function quoteExactInputSingle(QuoteExactSingleParams params) returns (uint256 amountOut, uint256 gasEstimate)',\n]);\nexport const v4PoolManagerAbi = parseAbi([\n  'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',\n]);\nexport const v4PositionManagerAbi = parseAbi([\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct AllowanceTransferDetails { address token; uint160 amount; uint48 expiration; uint48 nonce; }',\n  'struct AllowanceTransferPermitBatch { AllowanceTransferDetails[] details; address spender; uint256 sigDeadline; }',\n  'function initializePool(PoolKey key, uint160 sqrtPriceX96) payable returns (int24)',\n  'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',\n  'function multicall(bytes[] data) payable returns (bytes[] results)',\n  'function permitBatch(address owner, AllowanceTransferPermitBatch permitBatch, bytes signature) payable returns (bytes err)',\n]);\n\nexport * from './v3-abis.js';\n"]}
+{"version":3,"file":"abis.js","sourceRoot":"","sources":["../src/abis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,+CAA+C;IAC/C,qHAAqH;IACrH,wEAAwE;IACxE,2EAA2E;IAC3E,kHAAkH;CACnH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,+CAA+C;IAC/C,wGAAwG;IACxG,0GAA0G;IAC1G,gHAAgH;CACjH,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACvC,4KAA4K;CAC7K,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,+CAA+C;IAC/C,2CAA2C;IAC3C,yCAAyC;IACzC,mDAAmD;IACnD,uDAAuD;IACvD,wGAAwG;IACxG,qGAAqG;IACrG,mHAAmH;IACnH,oFAAoF;IACpF,wEAAwE;IACxE,oEAAoE;IACpE,4HAA4H;CAC7H,CAAC,CAAC;AAEH,cAAc,cAAc,CAAC","sourcesContent":["import { parseAbi } from 'viem';\n\n// Standard v4-core/periphery selectors; extracted from the bot's read surface.\n// They do not attest compatibility of a supplied custom deployment.\nexport const v4StateViewAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'function getSlot0(bytes32 poolId) view returns (uint160 sqrtPriceX96, int24 tick, uint24 protocolFee, uint24 lpFee)',\n  'function getLiquidity(bytes32 poolId) view returns (uint128 liquidity)',\n  'function getTickBitmap(bytes32 poolId, int16 word) view returns (uint256)',\n  'function getTickLiquidity(bytes32 poolId, int24 tick) view returns (uint128 liquidityGross, int128 liquidityNet)',\n]);\nexport const v4QuoterAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct QuoteExactSingleParams { PoolKey poolKey; bool zeroForOne; uint128 exactAmount; bytes hookData; }',\n  'function quoteExactInputSingle(QuoteExactSingleParams params) returns (uint256 amountOut, uint256 gasEstimate)',\n]);\nexport const v4PoolManagerAbi = parseAbi([\n  'event Initialize(bytes32 indexed id, address indexed currency0, address indexed currency1, uint24 fee, int24 tickSpacing, address hooks, uint160 sqrtPriceX96, int24 tick)',\n]);\nexport const v4PositionManagerAbi = parseAbi([\n  'function poolManager() view returns (address)',\n  'function permit2() view returns (address)',\n  'function WETH9() view returns (address)',\n  'function tokenDescriptor() view returns (address)',\n  'function unsubscribeGasLimit() view returns (uint256)',\n  'struct PoolKey { address currency0; address currency1; uint24 fee; int24 tickSpacing; address hooks; }',\n  'struct AllowanceTransferDetails { address token; uint160 amount; uint48 expiration; uint48 nonce; }',\n  'struct AllowanceTransferPermitBatch { AllowanceTransferDetails[] details; address spender; uint256 sigDeadline; }',\n  'function initializePool(PoolKey key, uint160 sqrtPriceX96) payable returns (int24)',\n  'function modifyLiquidities(bytes unlockData, uint256 deadline) payable',\n  'function multicall(bytes[] data) payable returns (bytes[] results)',\n  'function permitBatch(address owner, AllowanceTransferPermitBatch permitBatch, bytes signature) payable returns (bytes err)',\n]);\n\nexport * from './v3-abis.js';\n"]}

package/dist/compatibility.d.ts

@@ -1,5 +1,5 @@
 import { type Address, type Hex, type PublicClient } from 'viem';
-import type { UniswapV3ContractName, UniswapV3Deployment } from './deployments.js';
+import type { ArcUniswapV4ContractName, ArcUniswapV4Deployment, UniswapV3ContractName, UniswapV3Deployment } from './deployments.js';
 export interface UniswapV3CompatibilityReport {
     chainId: number;
     abiRevision: string;
@@ -8,8 +8,28 @@ export interface UniswapV3CompatibilityReport {
     positionManagerFactory: Address;
     positionManagerWrappedNative: Address;
 }
+export interface ArcUniswapV4CompatibilityReport {
+    chainId: number;
+    blockNumber: bigint;
+    blockHash: Hex;
+    contractsWithCode: readonly Address[];
+    runtimeCodeHashes: Readonly<Record<ArcUniswapV4ContractName, Hex>>;
+    stateViewPoolManager: Address;
+    quoterPoolManager: Address;
+    positionManagerPoolManager: Address;
+    positionManagerPermit2: Address;
+    positionManagerWrappedNative: Address;
+    positionManagerTokenDescriptor: Address;
+    positionManagerUnsubscribeGasLimit: bigint;
+}
 /**
  * Checks chain identity, exact runtime code hashes, and position-manager wiring.
  */
 export declare function verifyUniswapV3Compatibility(client: PublicClient, deployment: UniswapV3Deployment): Promise<UniswapV3CompatibilityReport>;
+/**
+ * Rechecks the exact Arc block, runtime bytecode, and v4 immutable wiring.
+ * Retained upstream generated initcode is verified separately by
+ * verify-v4-retained-artifacts.mjs; that check is not a fresh source compilation.
+ */
+export declare function verifyArcUniswapV4Compatibility(client: PublicClient, deployment: ArcUniswapV4Deployment): Promise<ArcUniswapV4CompatibilityReport>;
 //# sourceMappingURL=compatibility.d.ts.map

package/dist/compatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAExF,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGnF,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,sBAAsB,EAAE,OAAO,CAAC;IAChC,4BAA4B,EAAE,OAAO,CAAC;CACvC;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAoCvC"}
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGxF,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,sBAAsB,EAAE,OAAO,CAAC;IAChC,4BAA4B,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,GAAG,CAAC;IACf,iBAAiB,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,0BAA0B,EAAE,OAAO,CAAC;IACpC,sBAAsB,EAAE,OAAO,CAAC;IAChC,4BAA4B,EAAE,OAAO,CAAC;IACtC,8BAA8B,EAAE,OAAO,CAAC;IACxC,kCAAkC,EAAE,MAAM,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,mBAAmB,GAC9B,OAAO,CAAC,4BAA4B,CAAC,CAoCvC;AAED;;;;GAIG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,sBAAsB,GACjC,OAAO,CAAC,+BAA+B,CAAC,CA+F1C"}

package/dist/compatibility.js

@@ -1,4 +1,5 @@
 import { getAddress, keccak256 } from 'viem';
+import { v4PositionManagerAbi, v4QuoterAbi, v4StateViewAbi } from './abis.js';
 import { V3_ABI_REVISION, v3PositionManagerAbi } from './v3-abis.js';
 import { rpc, UniswapSdkError } from './errors.js';
 /**
@@ -43,6 +44,91 @@ export async function verifyUniswapV3Compatibility(client, deployment) {
         };
     });
 }
+/**
+ * Rechecks the exact Arc block, runtime bytecode, and v4 immutable wiring.
+ * Retained upstream generated initcode is verified separately by
+ * verify-v4-retained-artifacts.mjs; that check is not a fresh source compilation.
+ */
+export async function verifyArcUniswapV4Compatibility(client, deployment) {
+    return rpc(async () => {
+        for (const name of ['poolManager', 'stateView', 'quoter']) {
+            if (deployment[name].toLowerCase() !== deployment.contracts[name].toLowerCase()) {
+                mismatch(name, deployment.contracts[name], deployment[name]);
+            }
+        }
+        const chainId = await client.getChainId();
+        if (chainId !== deployment.chainId)
+            mismatch('chainId', deployment.chainId, chainId);
+        const block = await client.getBlock({ blockNumber: deployment.referenceBlock.number });
+        if (block.hash !== deployment.referenceBlock.hash) {
+            mismatch('referenceBlock.hash', deployment.referenceBlock.hash, block.hash);
+        }
+        const contractNames = Object.keys(deployment.contracts);
+        const checked = contractNames.map(name => deployment.contracts[name]);
+        const runtimeCodeHashes = {};
+        for (const name of contractNames) {
+            const address = deployment.contracts[name];
+            const bytecode = await client.getBytecode({ address, blockNumber: deployment.referenceBlock.number });
+            if (!bytecode || bytecode === '0x')
+                mismatch(`contracts.${name}`, 'deployed bytecode', bytecode ?? 'undefined');
+            const runtimeCodeHash = keccak256(bytecode);
+            if (runtimeCodeHash !== deployment.runtimeCodeHashes[name]) {
+                mismatch(`runtimeCodeHashes.${name}`, deployment.runtimeCodeHashes[name], runtimeCodeHash);
+            }
+            runtimeCodeHashes[name] = runtimeCodeHash;
+        }
+        const blockNumber = deployment.referenceBlock.number;
+        const [stateViewPoolManagerValue, quoterPoolManagerValue, positionManagerPoolManagerValue, positionManagerPermit2Value, positionManagerWrappedNativeValue, positionManagerTokenDescriptorValue, positionManagerUnsubscribeGasLimit,] = await Promise.all([
+            client.readContract({ address: deployment.contracts.stateView, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }),
+            client.readContract({ address: deployment.contracts.quoter, abi: v4QuoterAbi, functionName: 'poolManager', blockNumber }),
+            client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'poolManager', blockNumber }),
+            client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'permit2', blockNumber }),
+            client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'WETH9', blockNumber }),
+            client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'tokenDescriptor', blockNumber }),
+            client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'unsubscribeGasLimit', blockNumber }),
+        ]);
+        const stateViewPoolManager = getAddress(stateViewPoolManagerValue);
+        const quoterPoolManager = getAddress(quoterPoolManagerValue);
+        const positionManagerPoolManager = getAddress(positionManagerPoolManagerValue);
+        const positionManagerPermit2 = getAddress(positionManagerPermit2Value);
+        const positionManagerWrappedNative = getAddress(positionManagerWrappedNativeValue);
+        const positionManagerTokenDescriptor = getAddress(positionManagerTokenDescriptorValue);
+        for (const [path, actual] of [
+            ['stateView.poolManager', stateViewPoolManager],
+            ['quoter.poolManager', quoterPoolManager],
+            ['positionManager.poolManager', positionManagerPoolManager],
+        ]) {
+            if (actual !== deployment.contracts.poolManager)
+                mismatch(path, deployment.contracts.poolManager, actual);
+        }
+        if (positionManagerPermit2 !== deployment.contracts.permit2) {
+            mismatch('positionManager.permit2', deployment.contracts.permit2, positionManagerPermit2);
+        }
+        if (positionManagerWrappedNative !== deployment.positionManagerWiring.wrappedNative) {
+            mismatch('positionManager.WETH9', deployment.positionManagerWiring.wrappedNative, positionManagerWrappedNative);
+        }
+        if (positionManagerTokenDescriptor !== deployment.positionManagerWiring.tokenDescriptor) {
+            mismatch('positionManager.tokenDescriptor', deployment.positionManagerWiring.tokenDescriptor, positionManagerTokenDescriptor);
+        }
+        if (positionManagerUnsubscribeGasLimit !== deployment.positionManagerWiring.unsubscribeGasLimit) {
+            mismatch('positionManager.unsubscribeGasLimit', deployment.positionManagerWiring.unsubscribeGasLimit, positionManagerUnsubscribeGasLimit);
+        }
+        return {
+            chainId,
+            blockNumber,
+            blockHash: block.hash,
+            contractsWithCode: checked,
+            runtimeCodeHashes,
+            stateViewPoolManager,
+            quoterPoolManager,
+            positionManagerPoolManager,
+            positionManagerPermit2,
+            positionManagerWrappedNative,
+            positionManagerTokenDescriptor,
+            positionManagerUnsubscribeGasLimit,
+        };
+    });
+}
 async function readAddress(client, address, functionName) {
     const value = await client.readContract({ address, abi: v3PositionManagerAbi, functionName });
     return getAddress(value);

package/dist/compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAddress, keccak256, type Address, type Hex, type PublicClient } from 'viem';\nimport { V3_ABI_REVISION, v3PositionManagerAbi } from './v3-abis.js';\nimport type { UniswapV3ContractName, UniswapV3Deployment } from './deployments.js';\nimport { rpc, UniswapSdkError } from './errors.js';\n\nexport interface UniswapV3CompatibilityReport {\n  chainId: number;\n  abiRevision: string;\n  contractsWithCode: readonly Address[];\n  runtimeCodeHashes: Readonly<Record<UniswapV3ContractName, Hex>>;\n  positionManagerFactory: Address;\n  positionManagerWrappedNative: Address;\n}\n\n/**\n * Checks chain identity, exact runtime code hashes, and position-manager wiring.\n */\nexport async function verifyUniswapV3Compatibility(\n  client: PublicClient,\n  deployment: UniswapV3Deployment,\n): Promise<UniswapV3CompatibilityReport> {\n  return rpc(async () => {\n    if (deployment.abiRevision !== V3_ABI_REVISION) mismatch('deployment.abiRevision', V3_ABI_REVISION, deployment.abiRevision);\n    const chainId = await client.getChainId();\n    if (chainId !== deployment.chainId) mismatch('chainId', deployment.chainId, chainId);\n\n    const contractNames = Object.keys(deployment.contracts) as UniswapV3ContractName[];\n    const checked = contractNames.map(name => deployment.contracts[name]);\n    const runtimeCodeHashes = {} as Record<UniswapV3ContractName, Hex>;\n    for (const name of contractNames) {\n      const address = deployment.contracts[name];\n      const bytecode = await client.getBytecode({ address });\n      if (!bytecode || bytecode === '0x') mismatch(`contracts.${address}`, 'deployed bytecode', bytecode ?? 'undefined');\n      const runtimeCodeHash = keccak256(bytecode);\n      if (runtimeCodeHash !== deployment.runtimeCodeHashes[name]) {\n        mismatch(`runtimeCodeHashes.${name}`, deployment.runtimeCodeHashes[name], runtimeCodeHash);\n      }\n      runtimeCodeHashes[name] = runtimeCodeHash;\n    }\n\n    const [factory, wrappedNative] = await Promise.all([\n      readAddress(client, deployment.contracts.nonfungiblePositionManager, 'factory'),\n      readAddress(client, deployment.contracts.nonfungiblePositionManager, 'WETH9'),\n    ]);\n    if (factory.toLowerCase() !== deployment.contracts.factory.toLowerCase()) mismatch('positionManager.factory', deployment.contracts.factory, factory);\n    if (wrappedNative.toLowerCase() !== deployment.contracts.wrappedNative.toLowerCase()) mismatch('positionManager.WETH9', deployment.contracts.wrappedNative, wrappedNative);\n\n    return {\n      chainId,\n      abiRevision: deployment.abiRevision,\n      contractsWithCode: checked,\n      runtimeCodeHashes,\n      positionManagerFactory: factory,\n      positionManagerWrappedNative: wrappedNative,\n    };\n  });\n}\n\nasync function readAddress(client: PublicClient, address: Address, functionName: 'factory' | 'WETH9'): Promise<Address> {\n  const value = await client.readContract({ address, abi: v3PositionManagerAbi, functionName });\n  return getAddress(value);\n}\n\nfunction mismatch(path: string, expected: unknown, actual: unknown): never {\n  throw new UniswapSdkError('DEPLOYMENT_MISMATCH', `${path} mismatch: expected ${String(expected)}, got ${String(actual)}`, {\n    path,\n    expected: String(expected),\n    actual: String(actual),\n  });\n}\n"]}
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAddress, keccak256, type Address, type Hex, type PublicClient } from 'viem';\nimport { v4PositionManagerAbi, v4QuoterAbi, v4StateViewAbi } from './abis.js';\nimport { V3_ABI_REVISION, v3PositionManagerAbi } from './v3-abis.js';\nimport type {\n  ArcUniswapV4ContractName,\n  ArcUniswapV4Deployment,\n  UniswapV3ContractName,\n  UniswapV3Deployment,\n} from './deployments.js';\nimport { rpc, UniswapSdkError } from './errors.js';\n\nexport interface UniswapV3CompatibilityReport {\n  chainId: number;\n  abiRevision: string;\n  contractsWithCode: readonly Address[];\n  runtimeCodeHashes: Readonly<Record<UniswapV3ContractName, Hex>>;\n  positionManagerFactory: Address;\n  positionManagerWrappedNative: Address;\n}\n\nexport interface ArcUniswapV4CompatibilityReport {\n  chainId: number;\n  blockNumber: bigint;\n  blockHash: Hex;\n  contractsWithCode: readonly Address[];\n  runtimeCodeHashes: Readonly<Record<ArcUniswapV4ContractName, Hex>>;\n  stateViewPoolManager: Address;\n  quoterPoolManager: Address;\n  positionManagerPoolManager: Address;\n  positionManagerPermit2: Address;\n  positionManagerWrappedNative: Address;\n  positionManagerTokenDescriptor: Address;\n  positionManagerUnsubscribeGasLimit: bigint;\n}\n\n/**\n * Checks chain identity, exact runtime code hashes, and position-manager wiring.\n */\nexport async function verifyUniswapV3Compatibility(\n  client: PublicClient,\n  deployment: UniswapV3Deployment,\n): Promise<UniswapV3CompatibilityReport> {\n  return rpc(async () => {\n    if (deployment.abiRevision !== V3_ABI_REVISION) mismatch('deployment.abiRevision', V3_ABI_REVISION, deployment.abiRevision);\n    const chainId = await client.getChainId();\n    if (chainId !== deployment.chainId) mismatch('chainId', deployment.chainId, chainId);\n\n    const contractNames = Object.keys(deployment.contracts) as UniswapV3ContractName[];\n    const checked = contractNames.map(name => deployment.contracts[name]);\n    const runtimeCodeHashes = {} as Record<UniswapV3ContractName, Hex>;\n    for (const name of contractNames) {\n      const address = deployment.contracts[name];\n      const bytecode = await client.getBytecode({ address });\n      if (!bytecode || bytecode === '0x') mismatch(`contracts.${address}`, 'deployed bytecode', bytecode ?? 'undefined');\n      const runtimeCodeHash = keccak256(bytecode);\n      if (runtimeCodeHash !== deployment.runtimeCodeHashes[name]) {\n        mismatch(`runtimeCodeHashes.${name}`, deployment.runtimeCodeHashes[name], runtimeCodeHash);\n      }\n      runtimeCodeHashes[name] = runtimeCodeHash;\n    }\n\n    const [factory, wrappedNative] = await Promise.all([\n      readAddress(client, deployment.contracts.nonfungiblePositionManager, 'factory'),\n      readAddress(client, deployment.contracts.nonfungiblePositionManager, 'WETH9'),\n    ]);\n    if (factory.toLowerCase() !== deployment.contracts.factory.toLowerCase()) mismatch('positionManager.factory', deployment.contracts.factory, factory);\n    if (wrappedNative.toLowerCase() !== deployment.contracts.wrappedNative.toLowerCase()) mismatch('positionManager.WETH9', deployment.contracts.wrappedNative, wrappedNative);\n\n    return {\n      chainId,\n      abiRevision: deployment.abiRevision,\n      contractsWithCode: checked,\n      runtimeCodeHashes,\n      positionManagerFactory: factory,\n      positionManagerWrappedNative: wrappedNative,\n    };\n  });\n}\n\n/**\n * Rechecks the exact Arc block, runtime bytecode, and v4 immutable wiring.\n * Retained upstream generated initcode is verified separately by\n * verify-v4-retained-artifacts.mjs; that check is not a fresh source compilation.\n */\nexport async function verifyArcUniswapV4Compatibility(\n  client: PublicClient,\n  deployment: ArcUniswapV4Deployment,\n): Promise<ArcUniswapV4CompatibilityReport> {\n  return rpc(async () => {\n    for (const name of ['poolManager', 'stateView', 'quoter'] as const) {\n      if (deployment[name].toLowerCase() !== deployment.contracts[name].toLowerCase()) {\n        mismatch(name, deployment.contracts[name], deployment[name]);\n      }\n    }\n\n    const chainId = await client.getChainId();\n    if (chainId !== deployment.chainId) mismatch('chainId', deployment.chainId, chainId);\n\n    const block = await client.getBlock({ blockNumber: deployment.referenceBlock.number });\n    if (block.hash !== deployment.referenceBlock.hash) {\n      mismatch('referenceBlock.hash', deployment.referenceBlock.hash, block.hash);\n    }\n\n    const contractNames = Object.keys(deployment.contracts) as ArcUniswapV4ContractName[];\n    const checked = contractNames.map(name => deployment.contracts[name]);\n    const runtimeCodeHashes = {} as Record<ArcUniswapV4ContractName, Hex>;\n    for (const name of contractNames) {\n      const address = deployment.contracts[name];\n      const bytecode = await client.getBytecode({ address, blockNumber: deployment.referenceBlock.number });\n      if (!bytecode || bytecode === '0x') mismatch(`contracts.${name}`, 'deployed bytecode', bytecode ?? 'undefined');\n      const runtimeCodeHash = keccak256(bytecode);\n      if (runtimeCodeHash !== deployment.runtimeCodeHashes[name]) {\n        mismatch(`runtimeCodeHashes.${name}`, deployment.runtimeCodeHashes[name], runtimeCodeHash);\n      }\n      runtimeCodeHashes[name] = runtimeCodeHash;\n    }\n\n    const blockNumber = deployment.referenceBlock.number;\n    const [\n      stateViewPoolManagerValue,\n      quoterPoolManagerValue,\n      positionManagerPoolManagerValue,\n      positionManagerPermit2Value,\n      positionManagerWrappedNativeValue,\n      positionManagerTokenDescriptorValue,\n      positionManagerUnsubscribeGasLimit,\n    ] = await Promise.all([\n      client.readContract({ address: deployment.contracts.stateView, abi: v4StateViewAbi, functionName: 'poolManager', blockNumber }),\n      client.readContract({ address: deployment.contracts.quoter, abi: v4QuoterAbi, functionName: 'poolManager', blockNumber }),\n      client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'poolManager', blockNumber }),\n      client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'permit2', blockNumber }),\n      client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'WETH9', blockNumber }),\n      client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'tokenDescriptor', blockNumber }),\n      client.readContract({ address: deployment.contracts.positionManager, abi: v4PositionManagerAbi, functionName: 'unsubscribeGasLimit', blockNumber }),\n    ]);\n\n    const stateViewPoolManager = getAddress(stateViewPoolManagerValue);\n    const quoterPoolManager = getAddress(quoterPoolManagerValue);\n    const positionManagerPoolManager = getAddress(positionManagerPoolManagerValue);\n    const positionManagerPermit2 = getAddress(positionManagerPermit2Value);\n    const positionManagerWrappedNative = getAddress(positionManagerWrappedNativeValue);\n    const positionManagerTokenDescriptor = getAddress(positionManagerTokenDescriptorValue);\n\n    for (const [path, actual] of [\n      ['stateView.poolManager', stateViewPoolManager],\n      ['quoter.poolManager', quoterPoolManager],\n      ['positionManager.poolManager', positionManagerPoolManager],\n    ] as const) {\n      if (actual !== deployment.contracts.poolManager) mismatch(path, deployment.contracts.poolManager, actual);\n    }\n    if (positionManagerPermit2 !== deployment.contracts.permit2) {\n      mismatch('positionManager.permit2', deployment.contracts.permit2, positionManagerPermit2);\n    }\n    if (positionManagerWrappedNative !== deployment.positionManagerWiring.wrappedNative) {\n      mismatch('positionManager.WETH9', deployment.positionManagerWiring.wrappedNative, positionManagerWrappedNative);\n    }\n    if (positionManagerTokenDescriptor !== deployment.positionManagerWiring.tokenDescriptor) {\n      mismatch('positionManager.tokenDescriptor', deployment.positionManagerWiring.tokenDescriptor, positionManagerTokenDescriptor);\n    }\n    if (positionManagerUnsubscribeGasLimit !== deployment.positionManagerWiring.unsubscribeGasLimit) {\n      mismatch(\n        'positionManager.unsubscribeGasLimit',\n        deployment.positionManagerWiring.unsubscribeGasLimit,\n        positionManagerUnsubscribeGasLimit,\n      );\n    }\n\n    return {\n      chainId,\n      blockNumber,\n      blockHash: block.hash,\n      contractsWithCode: checked,\n      runtimeCodeHashes,\n      stateViewPoolManager,\n      quoterPoolManager,\n      positionManagerPoolManager,\n      positionManagerPermit2,\n      positionManagerWrappedNative,\n      positionManagerTokenDescriptor,\n      positionManagerUnsubscribeGasLimit,\n    };\n  });\n}\n\nasync function readAddress(client: PublicClient, address: Address, functionName: 'factory' | 'WETH9'): Promise<Address> {\n  const value = await client.readContract({ address, abi: v3PositionManagerAbi, functionName });\n  return getAddress(value);\n}\n\nfunction mismatch(path: string, expected: unknown, actual: unknown): never {\n  throw new UniswapSdkError('DEPLOYMENT_MISMATCH', `${path} mismatch: expected ${String(expected)}, got ${String(actual)}`, {\n    path,\n    expected: String(expected),\n    actual: String(actual),\n  });\n}\n"]}

package/dist/deployments.d.ts

@@ -1,4 +1,5 @@
 import { type Address, type Hex } from 'viem';
+import type { V4Deployment } from './pool.js';
 export type RobinhoodUniswapV3DeploymentId = 'robinhood-mainnet-v3' | 'robinhood-testnet-v3';
 export interface UniswapV3Contracts {
     factory: Address;
@@ -21,7 +22,57 @@ export interface UniswapV3Deployment {
     contracts: UniswapV3Contracts;
     runtimeCodeHashes: UniswapV3RuntimeCodeHashes;
 }
+export type ArcUniswapV4DeploymentId = 'arc-mainnet-v4';
+export interface ArcUniswapV4Contracts {
+    poolManager: Address;
+    stateView: Address;
+    positionManager: Address;
+    quoter: Address;
+    universalRouter: Address;
+    permit2: Address;
+}
+export type ArcUniswapV4ContractName = keyof ArcUniswapV4Contracts;
+export type ArcUniswapV4RuntimeCodeHashes = Readonly<Record<ArcUniswapV4ContractName, Hex>>;
+export type ArcUniswapV4ArtifactBackedContractName = Exclude<ArcUniswapV4ContractName, 'permit2'>;
+export interface ArcUniswapV4RetainedArtifact {
+    repository: 'https://github.com/Uniswap/contracts';
+    sourceCommit: string;
+    sourcePackageCommit: string;
+    deployerArtifactPath: string;
+    sourceContractPath: string;
+    deploymentTransaction: Hex;
+    generatedInitcodeHash: Hex;
+    deploymentManifestInputHash: Hex;
+    proxy: false;
+}
+export interface ArcUniswapV4Deployment extends V4Deployment {
+    id: ArcUniswapV4DeploymentId;
+    chainId: 5_042;
+    network: 'arc-mainnet';
+    reviewedAt: string;
+    referenceBlock: Readonly<{
+        number: bigint;
+        hash: Hex;
+    }>;
+    contracts: Readonly<ArcUniswapV4Contracts>;
+    runtimeCodeHashes: ArcUniswapV4RuntimeCodeHashes;
+    retainedArtifacts: Readonly<Record<ArcUniswapV4ArtifactBackedContractName, ArcUniswapV4RetainedArtifact>>;
+    positionManagerWiring: Readonly<{
+        wrappedNative: Address;
+        tokenDescriptor: Address;
+        unsubscribeGasLimit: bigint;
+    }>;
+    limitations: readonly string[];
+}
 export declare const robinhoodUniswapV3Mainnet: UniswapV3Deployment;
 export declare const robinhoodUniswapV3Testnet: UniswapV3Deployment;
+/**
+ * Official Uniswap v4 infrastructure used by the reviewed Argus Arc flow.
+ *
+ * This proves only the shared Uniswap contracts. Argus Portal, hook, locker,
+ * splitter, and tracker compatibility remains the launcher adapter's gate.
+ */
+export declare const arcUniswapV4Mainnet: ArcUniswapV4Deployment;
 export declare function getRobinhoodUniswapV3Deployment(chainId: number): UniswapV3Deployment;
+export declare function getArcUniswapV4Deployment(chainId: number): ArcUniswapV4Deployment;
 //# sourceMappingURL=deployments.d.ts.map

package/dist/deployments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAI1D,MAAM,MAAM,8BAA8B,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,kBAAkB,CAAC;AAC7D,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,8BAA8B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,yBAAyB,GAAG,yBAAyB,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,GAAG,kBAAkB,CAAC;IAC5C,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,iBAAiB,EAAE,0BAA0B,CAAC;CAC/C;AAID,eAAO,MAAM,yBAAyB,EAAE,mBAwBtC,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,mBAwBtC,CAAC;AAEH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAIpF"}
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,MAAM,CAAC;AAG1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,MAAM,8BAA8B,GAAG,sBAAsB,GAAG,sBAAsB,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B,EAAE,OAAO,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,kBAAkB,CAAC;AAC7D,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,8BAA8B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,yBAAyB,GAAG,yBAAyB,CAAC;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,GAAG,kBAAkB,CAAC;IAC5C,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,iBAAiB,EAAE,0BAA0B,CAAC;CAC/C;AAED,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,qBAAqB,CAAC;AACnE,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC,MAAM,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5F,MAAM,MAAM,sCAAsC,GAAG,OAAO,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC;AAElG,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,sCAAsC,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,GAAG,CAAC;IAC3B,qBAAqB,EAAE,GAAG,CAAC;IAC3B,2BAA2B,EAAE,GAAG,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,EAAE,EAAE,wBAAwB,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IACxD,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC3C,iBAAiB,EAAE,6BAA6B,CAAC;IACjD,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,sCAAsC,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAC1G,qBAAqB,EAAE,QAAQ,CAAC;QAC9B,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC,CAAC;IACH,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAID,eAAO,MAAM,yBAAyB,EAAE,mBAwBtC,CAAC;AAEH,eAAO,MAAM,yBAAyB,EAAE,mBAwBtC,CAAC;AAcH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,sBAyFhC,CAAC;AAEH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAIpF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAGjF"}

package/dist/deployments.js

@@ -52,6 +52,113 @@ export const robinhoodUniswapV3Testnet = deepFreeze({
         multicall3: '0xd5c15df687b16f2ff992fc8d767b4216323184a2bbc6ee2f9c398c318e770891',
     },
 });
+const uniswapContractsRepository = 'https://github.com/Uniswap/contracts';
+const arcV4SourceCommit = '534603a5bc10d41d57a1c9c34417d472f0dbc0d3';
+const arcUniversalRouterSourceCommit = '02fd1760fa7c05096833c03e01a4143f963c350e';
+const arcV4Contracts = {
+    poolManager: getAddress('0x8366a39CC670B4001A1121B8F6A443A643e40951'),
+    stateView: getAddress('0xF3334192D15450CdD385c8B70e03f9A6bD9E673b'),
+    positionManager: getAddress('0x6049c9a0e26405C0985f9E3685C87d0aE917f82B'),
+    quoter: getAddress('0x8dc178efb8111bb0973dd9d722ebeff267c98f94'),
+    universalRouter: getAddress('0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1'),
+    permit2: getAddress('0x000000000022D473030F116dDEE9F6B43aC78BA3'),
+};
+/**
+ * Official Uniswap v4 infrastructure used by the reviewed Argus Arc flow.
+ *
+ * This proves only the shared Uniswap contracts. Argus Portal, hook, locker,
+ * splitter, and tracker compatibility remains the launcher adapter's gate.
+ */
+export const arcUniswapV4Mainnet = deepFreeze({
+    id: 'arc-mainnet-v4',
+    chainId: 5_042,
+    network: 'arc-mainnet',
+    poolManager: arcV4Contracts.poolManager,
+    stateView: arcV4Contracts.stateView,
+    quoter: arcV4Contracts.quoter,
+    reviewedAt: '2026-09-27',
+    referenceBlock: {
+        number: 20889496n,
+        hash: '0xf3fd31df5afb9d37a216dda53ac751a6a6c08a9c7e96ce4c07fb0df18d40810b',
+    },
+    contracts: arcV4Contracts,
+    runtimeCodeHashes: {
+        poolManager: '0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626',
+        stateView: '0x7d9c591e0956fd89d98feb4ffcfe8bf1f7a62bd485edd979fa21d104b49878a6',
+        positionManager: '0x5904204586f0290499c357cfcb99489cdc13740b3cd3f26c735f7ef7f2cff1c5',
+        quoter: '0xd707b1da8cb165e5ea35a3b4450d971eb562ec171e23492aa117036b78a868f6',
+        universalRouter: '0x7f949fe75d3483670e17a9ab398a3dc71f285026bba755b48fffd1e42aefad71',
+        permit2: '0x05a793d6bdba8b8715c8f4cef0725ec3a961f567d33ebb2d360f541f19f70c8f',
+    },
+    retainedArtifacts: {
+        poolManager: {
+            repository: uniswapContractsRepository,
+            sourceCommit: arcV4SourceCommit,
+            sourcePackageCommit: '46c6834698c48bc4a463a86d8420f4eb1d7f3b75',
+            deployerArtifactPath: 'src/briefcase/deployers/v4-core/PoolManagerDeployer.sol',
+            sourceContractPath: 'src/pkgs/v4-core/src/PoolManager.sol',
+            deploymentTransaction: '0x2a3f2686d0dfc0e8bea88ec2dd006d0cb788410a5d24a946c8d638a32868341e',
+            generatedInitcodeHash: '0x1debe8d2bf707a0cea57ce3cdf7b399d61515897a5698b37050d2d5df0a95b2c',
+            deploymentManifestInputHash: '0x3bdcc016bd6b2f8a19e20bdfa136abbf66ffa7904f42dafa1f5c399e9758544c',
+            proxy: false,
+        },
+        stateView: {
+            repository: uniswapContractsRepository,
+            sourceCommit: arcV4SourceCommit,
+            sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+            deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/StateViewDeployer.sol',
+            sourceContractPath: 'src/pkgs/v4-periphery/src/lens/StateView.sol',
+            deploymentTransaction: '0xc98e1282cf14d5e63f1f8040403d476b92a5dca03bc838ba0b28bf9cfd42bd2f',
+            generatedInitcodeHash: '0xd1a3b7780b831fbddf3407643b70cd7fc1af1140b0e41ad5f10ff74aac004a82',
+            deploymentManifestInputHash: '0x0e2e13349f8e16c9ea97b0167f2747efd891690c087723e0a920356d274593d3',
+            proxy: false,
+        },
+        positionManager: {
+            repository: uniswapContractsRepository,
+            sourceCommit: arcV4SourceCommit,
+            sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+            deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/PositionManagerDeployer.sol',
+            sourceContractPath: 'src/pkgs/v4-periphery/src/PositionManager.sol',
+            deploymentTransaction: '0xf3abd73072ecc78cbaa6b23de7c2fb56e69edce1dddefa069155198295b2abd2',
+            generatedInitcodeHash: '0x991742c2de2496144a6f8dce18252393a7d50116b8a3ab320100061d8b6dcca6',
+            deploymentManifestInputHash: '0xb86b0eed6fd57117c2096f57f07f3e2b4644f2c379e1604cab08790aaa9c40bd',
+            proxy: false,
+        },
+        quoter: {
+            repository: uniswapContractsRepository,
+            sourceCommit: arcV4SourceCommit,
+            sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+            deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/V4QuoterDeployer.sol',
+            sourceContractPath: 'src/pkgs/v4-periphery/src/lens/V4Quoter.sol',
+            deploymentTransaction: '0xb8d7a967c1be562fc9de8f5284a110e631f0fea17eef552852fec6ef67e4844a',
+            generatedInitcodeHash: '0xd915642b6f3b5375c0096fd70eb15cc0676651fa7d588accd1c6002936bb19c2',
+            deploymentManifestInputHash: '0xdb731ce141d9e731a17e60e47d1c0582c9c8684bf76430794d47d1d71fac6260',
+            proxy: false,
+        },
+        universalRouter: {
+            repository: uniswapContractsRepository,
+            sourceCommit: arcUniversalRouterSourceCommit,
+            sourcePackageCommit: '999d561c3ad58fb5cab91b602911f3c75591a9c7',
+            deployerArtifactPath: 'src/briefcase/deployers/universal-router/UniversalRouterDeployer.sol',
+            sourceContractPath: 'src/pkgs/universal-router/contracts/UniversalRouter.sol',
+            deploymentTransaction: '0xf07bb4c6eaccb5b7e128625b0c4fc6bc79f727f9b647a6e81a886bde905345b8',
+            generatedInitcodeHash: '0x8f564cfb262952d7d24e1750426672ccf3a72ca9268e2ec6d97cf846eaae179c',
+            deploymentManifestInputHash: '0xe388b0b5ed9c81077f8fcd9a1724fb35b2c5792380dddd3a19fd02f5bc037f77',
+            proxy: false,
+        },
+    },
+    positionManagerWiring: {
+        wrappedNative: getAddress('0x8bcEaA40B9AcdfAedF85AdF4FF01F5Ad6517937f'),
+        tokenDescriptor: getAddress('0x516b8a945700D6bBfDeDaa6dcFc4586bA60B8707'),
+        unsubscribeGasLimit: 300000n,
+    },
+    limitations: [
+        'The retained upstream generated initcode and pinned Arc runtime are verified separately because constructor immutables change deployed runtime bytes; this is not a fresh source compilation.',
+        'The canonical Permit2 predeploy has an exact runtime pin but is not claimed as an Arc deployment produced by the retained Uniswap/contracts manifest.',
+        'Argus Portal, hook, locker, splitter, tracker, fee, custody, and locked-principal semantics are not established by this shared deployment.',
+        'The retained v4 Quoter is official infrastructure; hook-aware Argus execution must simulate the exact router call and sender rather than assuming Quoter equivalence.',
+    ],
+});
 export function getRobinhoodUniswapV3Deployment(chainId) {
     if (chainId === robinhoodUniswapV3Mainnet.chainId)
         return robinhoodUniswapV3Mainnet;
@@ -59,6 +166,11 @@ export function getRobinhoodUniswapV3Deployment(chainId) {
         return robinhoodUniswapV3Testnet;
     throw new UniswapSdkError('CHAIN_MISMATCH', `Unsupported Robinhood Uniswap v3 chain ID ${chainId}`);
 }
+export function getArcUniswapV4Deployment(chainId) {
+    if (chainId === arcUniswapV4Mainnet.chainId)
+        return arcUniswapV4Mainnet;
+    throw new UniswapSdkError('CHAIN_MISMATCH', `Unsupported Arc Uniswap v4 chain ID ${chainId}`);
+}
 function deepFreeze(value) {
     if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {
         for (const child of Object.values(value))

package/dist/deployments.js.map

@@ -1 +1 @@
-{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,MAAM,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA4B9C,MAAM,UAAU,GAAG,UAAU,CAAC,4CAA4C,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAwB,UAAU,CAAC;IACvE,EAAE,EAAE,sBAAsB;IAC1B,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,yBAAyB;IAClC,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,UAAU;IACtB,oBAAoB,EAAE,UAAU;IAChC,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE;QACT,OAAO,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACjE,0BAA0B,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACpF,QAAQ,EAAE,UAAU,CAAC,4CAA4C,CAAC;QAClE,YAAY,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACtE,aAAa,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACvE,UAAU;KACX;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,oEAAoE;QAC7E,0BAA0B,EAAE,oEAAoE;QAChG,QAAQ,EAAE,oEAAoE;QAC9E,YAAY,EAAE,oEAAoE;QAClF,aAAa,EAAE,oEAAoE;QACnF,UAAU,EAAE,oEAAoE;KACjF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAwB,UAAU,CAAC;IACvE,EAAE,EAAE,sBAAsB;IAC1B,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,yBAAyB;IAClC,WAAW,EAAE,eAAe;IAC5B,UAAU,EAAE,kBAAkB;IAC9B,oBAAoB,EAAE,SAAS;IAC/B,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE;QACT,OAAO,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACjE,0BAA0B,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACpF,QAAQ,EAAE,UAAU,CAAC,4CAA4C,CAAC;QAClE,YAAY,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACtE,aAAa,EAAE,UAAU,CAAC,4CAA4C,CAAC;QACvE,UAAU;KACX;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,oEAAoE;QAC7E,0BAA0B,EAAE,oEAAoE;QAChG,QAAQ,EAAE,oEAAoE;QAC9E,YAAY,EAAE,oEAAoE;QAClF,aAAa,EAAE,oEAAoE;QACnF,UAAU,EAAE,oEAAoE;KACjF;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,+BAA+B,CAAC,OAAe;IAC7D,IAAI,OAAO,KAAK,yBAAyB,CAAC,OAAO;QAAE,OAAO,yBAAyB,CAAC;IACpF,IAAI,OAAO,KAAK,yBAAyB,CAAC,OAAO;QAAE,OAAO,yBAAyB,CAAC;IACpF,MAAM,IAAI,eAAe,CAAC,gBAAgB,EAAE,6CAA6C,OAAO,EAAE,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { getAddress, type Address, type Hex } from 'viem';\nimport { V3_ABI_REVISION } from './v3-abis.js';\nimport { UniswapSdkError } from './errors.js';\n\nexport type RobinhoodUniswapV3DeploymentId = 'robinhood-mainnet-v3' | 'robinhood-testnet-v3';\n\nexport interface UniswapV3Contracts {\n  factory: Address;\n  nonfungiblePositionManager: Address;\n  quoterV2: Address;\n  swapRouter02: Address;\n  wrappedNative: Address;\n  multicall3: Address;\n}\n\nexport type UniswapV3ContractName = keyof UniswapV3Contracts;\nexport type UniswapV3RuntimeCodeHashes = Readonly<Record<UniswapV3ContractName, Hex>>;\n\nexport interface UniswapV3Deployment {\n  id: RobinhoodUniswapV3DeploymentId;\n  chainId: number;\n  network: 'robinhood-chain-mainnet' | 'robinhood-chain-testnet';\n  abiRevision: string;\n  provenance: 'official' | 'reviewed-testnet';\n  explorerVerification: 'official' | 'partial';\n  reviewedAt: string;\n  contracts: UniswapV3Contracts;\n  runtimeCodeHashes: UniswapV3RuntimeCodeHashes;\n}\n\nconst multicall3 = getAddress('0xca11bde05977b3631167028862be2a173976ca11');\n\nexport const robinhoodUniswapV3Mainnet: UniswapV3Deployment = deepFreeze({\n  id: 'robinhood-mainnet-v3',\n  chainId: 4_663,\n  network: 'robinhood-chain-mainnet',\n  abiRevision: V3_ABI_REVISION,\n  provenance: 'official',\n  explorerVerification: 'official',\n  reviewedAt: '2026-09-11',\n  contracts: {\n    factory: getAddress('0x1f7d7550B1b028f7571E69A784071F0205FD2EfA'),\n    nonfungiblePositionManager: getAddress('0x73991a25C818Bf1f1128dEAaB1492D45638DE0D3'),\n    quoterV2: getAddress('0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7'),\n    swapRouter02: getAddress('0xcaf681a66d020601342297493863e78c959e5cb2'),\n    wrappedNative: getAddress('0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73'),\n    multicall3,\n  },\n  runtimeCodeHashes: {\n    factory: '0xec72b1abd1f2faee020cfea9c646bd8994f9fb389054f6e574f103a895091739',\n    nonfungiblePositionManager: '0x0a493d1af3d0f25fed8efa205244ebee14114267a08647fc38c515c7cd6ead4f',\n    quoterV2: '0x3db0868d945e9304c9bc6a8b2181948109ea617647142f3c4083e14393496a28',\n    swapRouter02: '0x6f36c378e272c6324c48f045182bcb54bd8ad654cf9ebd42e8893d52c4cb25dc',\n    wrappedNative: '0x5706be52f64875fee65a2cec0d80e47a23d8793cbe85d214b48445e2d05f5353',\n    multicall3: '0xd5c15df687b16f2ff992fc8d767b4216323184a2bbc6ee2f9c398c318e770891',\n  },\n});\n\nexport const robinhoodUniswapV3Testnet: UniswapV3Deployment = deepFreeze({\n  id: 'robinhood-testnet-v3',\n  chainId: 46_630,\n  network: 'robinhood-chain-testnet',\n  abiRevision: V3_ABI_REVISION,\n  provenance: 'reviewed-testnet',\n  explorerVerification: 'partial',\n  reviewedAt: '2026-09-11',\n  contracts: {\n    factory: getAddress('0xdf9e3D6ffaC4513dD7b053212bbECcbCD15ec932'),\n    nonfungiblePositionManager: getAddress('0xFFe6CFc4f759b65f9B62c9D05A9E21a78cE93e12'),\n    quoterV2: getAddress('0xDDcBe4989C8171F721c5e683C9C6339B59718213'),\n    swapRouter02: getAddress('0xb79cB26e90EBBD9bC02c75267c9a86dBa1AFedB7'),\n    wrappedNative: getAddress('0x7943e237c7F95DA44E0301572D358911207852Fa'),\n    multicall3,\n  },\n  runtimeCodeHashes: {\n    factory: '0x75c5bbc7989daa85188d9e4c9f989271d8bcb2abad3d47e6e47d3c0c5bff02c2',\n    nonfungiblePositionManager: '0xe40cd590528ac8b67b428579035fe391e502c38271623777692c50834688e9d5',\n    quoterV2: '0x724c4956e1c61fd13285a92685337df60254bc67f775e7268da2fc5cc79d5343',\n    swapRouter02: '0xdce781dc17d5f98e3ea0b72d88639a5995ccbba6e11bc01f2057a9409dc8c724',\n    wrappedNative: '0x5706be52f64875fee65a2cec0d80e47a23d8793cbe85d214b48445e2d05f5353',\n    multicall3: '0xd5c15df687b16f2ff992fc8d767b4216323184a2bbc6ee2f9c398c318e770891',\n  },\n});\n\nexport function getRobinhoodUniswapV3Deployment(chainId: number): UniswapV3Deployment {\n  if (chainId === robinhoodUniswapV3Mainnet.chainId) return robinhoodUniswapV3Mainnet;\n  if (chainId === robinhoodUniswapV3Testnet.chainId) return robinhoodUniswapV3Testnet;\n  throw new UniswapSdkError('CHAIN_MISMATCH', `Unsupported Robinhood Uniswap v3 chain ID ${chainId}`);\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {\n    for (const child of Object.values(value as Record<string, unknown>)) deepFreeze(child);\n    Object.freeze(value);\n  }\n  return value;\n}\n"]}
+{"version":3,"file":"deployments.js","sourceRoot":"","sources":["../src/deployments.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAddress, type Address, type Hex } from 'viem';\nimport { V3_ABI_REVISION } from './v3-abis.js';\nimport { UniswapSdkError } from './errors.js';\nimport type { V4Deployment } from './pool.js';\n\nexport type RobinhoodUniswapV3DeploymentId = 'robinhood-mainnet-v3' | 'robinhood-testnet-v3';\n\nexport interface UniswapV3Contracts {\n  factory: Address;\n  nonfungiblePositionManager: Address;\n  quoterV2: Address;\n  swapRouter02: Address;\n  wrappedNative: Address;\n  multicall3: Address;\n}\n\nexport type UniswapV3ContractName = keyof UniswapV3Contracts;\nexport type UniswapV3RuntimeCodeHashes = Readonly<Record<UniswapV3ContractName, Hex>>;\n\nexport interface UniswapV3Deployment {\n  id: RobinhoodUniswapV3DeploymentId;\n  chainId: number;\n  network: 'robinhood-chain-mainnet' | 'robinhood-chain-testnet';\n  abiRevision: string;\n  provenance: 'official' | 'reviewed-testnet';\n  explorerVerification: 'official' | 'partial';\n  reviewedAt: string;\n  contracts: UniswapV3Contracts;\n  runtimeCodeHashes: UniswapV3RuntimeCodeHashes;\n}\n\nexport type ArcUniswapV4DeploymentId = 'arc-mainnet-v4';\n\nexport interface ArcUniswapV4Contracts {\n  poolManager: Address;\n  stateView: Address;\n  positionManager: Address;\n  quoter: Address;\n  universalRouter: Address;\n  permit2: Address;\n}\n\nexport type ArcUniswapV4ContractName = keyof ArcUniswapV4Contracts;\nexport type ArcUniswapV4RuntimeCodeHashes = Readonly<Record<ArcUniswapV4ContractName, Hex>>;\nexport type ArcUniswapV4ArtifactBackedContractName = Exclude<ArcUniswapV4ContractName, 'permit2'>;\n\nexport interface ArcUniswapV4RetainedArtifact {\n  repository: 'https://github.com/Uniswap/contracts';\n  sourceCommit: string;\n  sourcePackageCommit: string;\n  deployerArtifactPath: string;\n  sourceContractPath: string;\n  deploymentTransaction: Hex;\n  generatedInitcodeHash: Hex;\n  deploymentManifestInputHash: Hex;\n  proxy: false;\n}\n\nexport interface ArcUniswapV4Deployment extends V4Deployment {\n  id: ArcUniswapV4DeploymentId;\n  chainId: 5_042;\n  network: 'arc-mainnet';\n  reviewedAt: string;\n  referenceBlock: Readonly<{ number: bigint; hash: Hex }>;\n  contracts: Readonly<ArcUniswapV4Contracts>;\n  runtimeCodeHashes: ArcUniswapV4RuntimeCodeHashes;\n  retainedArtifacts: Readonly<Record<ArcUniswapV4ArtifactBackedContractName, ArcUniswapV4RetainedArtifact>>;\n  positionManagerWiring: Readonly<{\n    wrappedNative: Address;\n    tokenDescriptor: Address;\n    unsubscribeGasLimit: bigint;\n  }>;\n  limitations: readonly string[];\n}\n\nconst multicall3 = getAddress('0xca11bde05977b3631167028862be2a173976ca11');\n\nexport const robinhoodUniswapV3Mainnet: UniswapV3Deployment = deepFreeze({\n  id: 'robinhood-mainnet-v3',\n  chainId: 4_663,\n  network: 'robinhood-chain-mainnet',\n  abiRevision: V3_ABI_REVISION,\n  provenance: 'official',\n  explorerVerification: 'official',\n  reviewedAt: '2026-09-11',\n  contracts: {\n    factory: getAddress('0x1f7d7550B1b028f7571E69A784071F0205FD2EfA'),\n    nonfungiblePositionManager: getAddress('0x73991a25C818Bf1f1128dEAaB1492D45638DE0D3'),\n    quoterV2: getAddress('0x33e885ed0ec9bf04ecfb19341582aadcb4c8a9e7'),\n    swapRouter02: getAddress('0xcaf681a66d020601342297493863e78c959e5cb2'),\n    wrappedNative: getAddress('0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73'),\n    multicall3,\n  },\n  runtimeCodeHashes: {\n    factory: '0xec72b1abd1f2faee020cfea9c646bd8994f9fb389054f6e574f103a895091739',\n    nonfungiblePositionManager: '0x0a493d1af3d0f25fed8efa205244ebee14114267a08647fc38c515c7cd6ead4f',\n    quoterV2: '0x3db0868d945e9304c9bc6a8b2181948109ea617647142f3c4083e14393496a28',\n    swapRouter02: '0x6f36c378e272c6324c48f045182bcb54bd8ad654cf9ebd42e8893d52c4cb25dc',\n    wrappedNative: '0x5706be52f64875fee65a2cec0d80e47a23d8793cbe85d214b48445e2d05f5353',\n    multicall3: '0xd5c15df687b16f2ff992fc8d767b4216323184a2bbc6ee2f9c398c318e770891',\n  },\n});\n\nexport const robinhoodUniswapV3Testnet: UniswapV3Deployment = deepFreeze({\n  id: 'robinhood-testnet-v3',\n  chainId: 46_630,\n  network: 'robinhood-chain-testnet',\n  abiRevision: V3_ABI_REVISION,\n  provenance: 'reviewed-testnet',\n  explorerVerification: 'partial',\n  reviewedAt: '2026-09-11',\n  contracts: {\n    factory: getAddress('0xdf9e3D6ffaC4513dD7b053212bbECcbCD15ec932'),\n    nonfungiblePositionManager: getAddress('0xFFe6CFc4f759b65f9B62c9D05A9E21a78cE93e12'),\n    quoterV2: getAddress('0xDDcBe4989C8171F721c5e683C9C6339B59718213'),\n    swapRouter02: getAddress('0xb79cB26e90EBBD9bC02c75267c9a86dBa1AFedB7'),\n    wrappedNative: getAddress('0x7943e237c7F95DA44E0301572D358911207852Fa'),\n    multicall3,\n  },\n  runtimeCodeHashes: {\n    factory: '0x75c5bbc7989daa85188d9e4c9f989271d8bcb2abad3d47e6e47d3c0c5bff02c2',\n    nonfungiblePositionManager: '0xe40cd590528ac8b67b428579035fe391e502c38271623777692c50834688e9d5',\n    quoterV2: '0x724c4956e1c61fd13285a92685337df60254bc67f775e7268da2fc5cc79d5343',\n    swapRouter02: '0xdce781dc17d5f98e3ea0b72d88639a5995ccbba6e11bc01f2057a9409dc8c724',\n    wrappedNative: '0x5706be52f64875fee65a2cec0d80e47a23d8793cbe85d214b48445e2d05f5353',\n    multicall3: '0xd5c15df687b16f2ff992fc8d767b4216323184a2bbc6ee2f9c398c318e770891',\n  },\n});\n\nconst uniswapContractsRepository = 'https://github.com/Uniswap/contracts' as const;\nconst arcV4SourceCommit = '534603a5bc10d41d57a1c9c34417d472f0dbc0d3';\nconst arcUniversalRouterSourceCommit = '02fd1760fa7c05096833c03e01a4143f963c350e';\nconst arcV4Contracts: ArcUniswapV4Contracts = {\n  poolManager: getAddress('0x8366a39CC670B4001A1121B8F6A443A643e40951'),\n  stateView: getAddress('0xF3334192D15450CdD385c8B70e03f9A6bD9E673b'),\n  positionManager: getAddress('0x6049c9a0e26405C0985f9E3685C87d0aE917f82B'),\n  quoter: getAddress('0x8dc178efb8111bb0973dd9d722ebeff267c98f94'),\n  universalRouter: getAddress('0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1'),\n  permit2: getAddress('0x000000000022D473030F116dDEE9F6B43aC78BA3'),\n};\n\n/**\n * Official Uniswap v4 infrastructure used by the reviewed Argus Arc flow.\n *\n * This proves only the shared Uniswap contracts. Argus Portal, hook, locker,\n * splitter, and tracker compatibility remains the launcher adapter's gate.\n */\nexport const arcUniswapV4Mainnet: ArcUniswapV4Deployment = deepFreeze({\n  id: 'arc-mainnet-v4',\n  chainId: 5_042,\n  network: 'arc-mainnet',\n  poolManager: arcV4Contracts.poolManager,\n  stateView: arcV4Contracts.stateView,\n  quoter: arcV4Contracts.quoter,\n  reviewedAt: '2026-09-27',\n  referenceBlock: {\n    number: 20_889_496n,\n    hash: '0xf3fd31df5afb9d37a216dda53ac751a6a6c08a9c7e96ce4c07fb0df18d40810b',\n  },\n  contracts: arcV4Contracts,\n  runtimeCodeHashes: {\n    poolManager: '0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626',\n    stateView: '0x7d9c591e0956fd89d98feb4ffcfe8bf1f7a62bd485edd979fa21d104b49878a6',\n    positionManager: '0x5904204586f0290499c357cfcb99489cdc13740b3cd3f26c735f7ef7f2cff1c5',\n    quoter: '0xd707b1da8cb165e5ea35a3b4450d971eb562ec171e23492aa117036b78a868f6',\n    universalRouter: '0x7f949fe75d3483670e17a9ab398a3dc71f285026bba755b48fffd1e42aefad71',\n    permit2: '0x05a793d6bdba8b8715c8f4cef0725ec3a961f567d33ebb2d360f541f19f70c8f',\n  },\n  retainedArtifacts: {\n    poolManager: {\n      repository: uniswapContractsRepository,\n      sourceCommit: arcV4SourceCommit,\n      sourcePackageCommit: '46c6834698c48bc4a463a86d8420f4eb1d7f3b75',\n      deployerArtifactPath: 'src/briefcase/deployers/v4-core/PoolManagerDeployer.sol',\n      sourceContractPath: 'src/pkgs/v4-core/src/PoolManager.sol',\n      deploymentTransaction: '0x2a3f2686d0dfc0e8bea88ec2dd006d0cb788410a5d24a946c8d638a32868341e',\n      generatedInitcodeHash: '0x1debe8d2bf707a0cea57ce3cdf7b399d61515897a5698b37050d2d5df0a95b2c',\n      deploymentManifestInputHash: '0x3bdcc016bd6b2f8a19e20bdfa136abbf66ffa7904f42dafa1f5c399e9758544c',\n      proxy: false,\n    },\n    stateView: {\n      repository: uniswapContractsRepository,\n      sourceCommit: arcV4SourceCommit,\n      sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',\n      deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/StateViewDeployer.sol',\n      sourceContractPath: 'src/pkgs/v4-periphery/src/lens/StateView.sol',\n      deploymentTransaction: '0xc98e1282cf14d5e63f1f8040403d476b92a5dca03bc838ba0b28bf9cfd42bd2f',\n      generatedInitcodeHash: '0xd1a3b7780b831fbddf3407643b70cd7fc1af1140b0e41ad5f10ff74aac004a82',\n      deploymentManifestInputHash: '0x0e2e13349f8e16c9ea97b0167f2747efd891690c087723e0a920356d274593d3',\n      proxy: false,\n    },\n    positionManager: {\n      repository: uniswapContractsRepository,\n      sourceCommit: arcV4SourceCommit,\n      sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',\n      deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/PositionManagerDeployer.sol',\n      sourceContractPath: 'src/pkgs/v4-periphery/src/PositionManager.sol',\n      deploymentTransaction: '0xf3abd73072ecc78cbaa6b23de7c2fb56e69edce1dddefa069155198295b2abd2',\n      generatedInitcodeHash: '0x991742c2de2496144a6f8dce18252393a7d50116b8a3ab320100061d8b6dcca6',\n      deploymentManifestInputHash: '0xb86b0eed6fd57117c2096f57f07f3e2b4644f2c379e1604cab08790aaa9c40bd',\n      proxy: false,\n    },\n    quoter: {\n      repository: uniswapContractsRepository,\n      sourceCommit: arcV4SourceCommit,\n      sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',\n      deployerArtifactPath: 'src/briefcase/deployers/v4-periphery/V4QuoterDeployer.sol',\n      sourceContractPath: 'src/pkgs/v4-periphery/src/lens/V4Quoter.sol',\n      deploymentTransaction: '0xb8d7a967c1be562fc9de8f5284a110e631f0fea17eef552852fec6ef67e4844a',\n      generatedInitcodeHash: '0xd915642b6f3b5375c0096fd70eb15cc0676651fa7d588accd1c6002936bb19c2',\n      deploymentManifestInputHash: '0xdb731ce141d9e731a17e60e47d1c0582c9c8684bf76430794d47d1d71fac6260',\n      proxy: false,\n    },\n    universalRouter: {\n      repository: uniswapContractsRepository,\n      sourceCommit: arcUniversalRouterSourceCommit,\n      sourcePackageCommit: '999d561c3ad58fb5cab91b602911f3c75591a9c7',\n      deployerArtifactPath: 'src/briefcase/deployers/universal-router/UniversalRouterDeployer.sol',\n      sourceContractPath: 'src/pkgs/universal-router/contracts/UniversalRouter.sol',\n      deploymentTransaction: '0xf07bb4c6eaccb5b7e128625b0c4fc6bc79f727f9b647a6e81a886bde905345b8',\n      generatedInitcodeHash: '0x8f564cfb262952d7d24e1750426672ccf3a72ca9268e2ec6d97cf846eaae179c',\n      deploymentManifestInputHash: '0xe388b0b5ed9c81077f8fcd9a1724fb35b2c5792380dddd3a19fd02f5bc037f77',\n      proxy: false,\n    },\n  },\n  positionManagerWiring: {\n    wrappedNative: getAddress('0x8bcEaA40B9AcdfAedF85AdF4FF01F5Ad6517937f'),\n    tokenDescriptor: getAddress('0x516b8a945700D6bBfDeDaa6dcFc4586bA60B8707'),\n    unsubscribeGasLimit: 300_000n,\n  },\n  limitations: [\n    'The retained upstream generated initcode and pinned Arc runtime are verified separately because constructor immutables change deployed runtime bytes; this is not a fresh source compilation.',\n    'The canonical Permit2 predeploy has an exact runtime pin but is not claimed as an Arc deployment produced by the retained Uniswap/contracts manifest.',\n    'Argus Portal, hook, locker, splitter, tracker, fee, custody, and locked-principal semantics are not established by this shared deployment.',\n    'The retained v4 Quoter is official infrastructure; hook-aware Argus execution must simulate the exact router call and sender rather than assuming Quoter equivalence.',\n  ],\n});\n\nexport function getRobinhoodUniswapV3Deployment(chainId: number): UniswapV3Deployment {\n  if (chainId === robinhoodUniswapV3Mainnet.chainId) return robinhoodUniswapV3Mainnet;\n  if (chainId === robinhoodUniswapV3Testnet.chainId) return robinhoodUniswapV3Testnet;\n  throw new UniswapSdkError('CHAIN_MISMATCH', `Unsupported Robinhood Uniswap v3 chain ID ${chainId}`);\n}\n\nexport function getArcUniswapV4Deployment(chainId: number): ArcUniswapV4Deployment {\n  if (chainId === arcUniswapV4Mainnet.chainId) return arcUniswapV4Mainnet;\n  throw new UniswapSdkError('CHAIN_MISMATCH', `Unsupported Arc Uniswap v4 chain ID ${chainId}`);\n}\n\nfunction deepFreeze<T>(value: T): T {\n  if (value !== null && typeof value === 'object' && !Object.isFrozen(value)) {\n    for (const child of Object.values(value as Record<string, unknown>)) deepFreeze(child);\n    Object.freeze(value);\n  }\n  return value;\n}\n"]}

package/dist/v4.d.ts

@@ -11,4 +11,8 @@ export { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } from './
 export type { V4BatchPermit, V4BatchPermitDetail, V4ExpectedMint, V4MintActionParams, V4MintPositionParams, V4PoolKeyMaterial, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';
 export { buildV4MintPermitBatchTypedData } from './permit2.js';
 export type { V4PermitBatchDetailInput, V4PermitBatchTypedData } from './permit2.js';
+export { arcUniswapV4Mainnet, getArcUniswapV4Deployment } from './deployments.js';
+export type { ArcUniswapV4ArtifactBackedContractName, ArcUniswapV4ContractName, ArcUniswapV4Contracts, ArcUniswapV4Deployment, ArcUniswapV4DeploymentId, ArcUniswapV4RuntimeCodeHashes, ArcUniswapV4RetainedArtifact, } from './deployments.js';
+export { verifyArcUniswapV4Compatibility } from './compatibility.js';
+export type { ArcUniswapV4CompatibilityReport } from './compatibility.js';
 //# sourceMappingURL=v4.d.ts.map

package/dist/v4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpG,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChM,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"v4.d.ts","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACnG,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACpH,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpG,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChM,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAClF,YAAY,EACV,sCAAsC,EACtC,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/v4.js

@@ -5,4 +5,6 @@ export { decodeV4PoolInitialization } from './events.js';
 export { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';
 export { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } from './v4-transactions.js';
 export { buildV4MintPermitBatchTypedData } from './permit2.js';
+export { arcUniswapV4Mainnet, getArcUniswapV4Deployment } from './deployments.js';
+export { verifyArcUniswapV4Compatibility } from './compatibility.js';
 //# sourceMappingURL=v4.js.map

package/dist/v4.js.map

@@ -1 +1 @@
-{"version":3,"file":"v4.js","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { poolKeyFromCurrencies, getV4PoolId, poolReference } from './pool.js';\nexport type { V4Deployment, V4PoolKey, V4PoolReference } from './pool.js';\nexport { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring } from './reads.js';\nexport type { V4ReadClient, V4Observation, V4PoolSnapshot, V4QuoteInput, V4Quote, V4QuoteResult } from './reads.js';\nexport { readV4TickWindow, ticksInWord } from './depth.js';\nexport type { V4Tick, V4TickWindow } from './depth.js';\nexport { decodeV4PoolInitialization } from './events.js';\nexport { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';\nexport type { V4HookPermissions } from './hooks.js';\nexport { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } from './v4-transactions.js';\nexport type { V4BatchPermit, V4BatchPermitDetail, V4ExpectedMint, V4MintActionParams, V4MintPositionParams, V4PoolKeyMaterial, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';\nexport { buildV4MintPermitBatchTypedData } from './permit2.js';\nexport type { V4PermitBatchDetailInput, V4PermitBatchTypedData } from './permit2.js';\n"]}
+{"version":3,"file":"v4.js","sourceRoot":"","sources":["../src/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEnG,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAUlF,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export { poolKeyFromCurrencies, getV4PoolId, poolReference } from './pool.js';\nexport type { V4Deployment, V4PoolKey, V4PoolReference } from './pool.js';\nexport { readV4Pool, quoteV4ExactInput, quoteV4Batch, verifyV4DeploymentWiring } from './reads.js';\nexport type { V4ReadClient, V4Observation, V4PoolSnapshot, V4QuoteInput, V4Quote, V4QuoteResult } from './reads.js';\nexport { readV4TickWindow, ticksInWord } from './depth.js';\nexport type { V4Tick, V4TickWindow } from './depth.js';\nexport { decodeV4PoolInitialization } from './events.js';\nexport { decodeV4HookPermissions, unmodelledV4HookPermissions } from './hooks.js';\nexport type { V4HookPermissions } from './hooks.js';\nexport { buildV4MintPositionTransaction, reviewV4MintPositionCalldata } from './v4-transactions.js';\nexport type { V4BatchPermit, V4BatchPermitDetail, V4ExpectedMint, V4MintActionParams, V4MintPositionParams, V4PoolKeyMaterial, V4PoolState, V4TransactionMaterial } from './v4-transactions.js';\nexport { buildV4MintPermitBatchTypedData } from './permit2.js';\nexport type { V4PermitBatchDetailInput, V4PermitBatchTypedData } from './permit2.js';\nexport { arcUniswapV4Mainnet, getArcUniswapV4Deployment } from './deployments.js';\nexport type {\n  ArcUniswapV4ArtifactBackedContractName,\n  ArcUniswapV4ContractName,\n  ArcUniswapV4Contracts,\n  ArcUniswapV4Deployment,\n  ArcUniswapV4DeploymentId,\n  ArcUniswapV4RuntimeCodeHashes,\n  ArcUniswapV4RetainedArtifact,\n} from './deployments.js';\nexport { verifyArcUniswapV4Compatibility } from './compatibility.js';\nexport type { ArcUniswapV4CompatibilityReport } from './compatibility.js';\n"]}

package/docs/ARC_V4_PROVENANCE.md

@@ -0,0 +1,62 @@
+# Arc Uniswap v4 provenance
+
+`arcUniswapV4Mainnet` records the shared Uniswap v4 infrastructure used by the reviewed
+Argus Arc integration at block `20,889,496` (`0xf3fd31df…d40810b`). The compatibility
+check fails closed on chain ID, canonical block hash, exact runtime bytecode, PoolManager
+pointers, Permit2, wrapped-native placeholder, token descriptor, and unsubscribe gas limit.
+
+The provenance record retains the official `Uniswap/contracts` deployment manifest, its
+SHA-256, each deployment transaction, the generated deployer artifact, referenced source
+contract and package commit, generated creation-code hash, and pinned runtime hash. The
+five artifact-backed contracts are PoolManager, StateView, PositionManager, V4Quoter, and
+Universal Router. Permit2 is retained as a canonical-predeploy runtime pin only.
+
+This evidence reproduces retained upstream generated artifacts; it does not freshly compile
+the referenced Solidity sources. The source paths and package gitlinks establish which source
+Uniswap associated with each generated artifact, not independent compiler reproducibility.
+
+## Reproduce the source/runtime match
+
+Check out `Uniswap/contracts` twice because Arc's Universal Router was retained from an
+earlier source commit:
+
+```sh
+git clone https://github.com/Uniswap/contracts.git /tmp/uniswap-contracts
+git -C /tmp/uniswap-contracts worktree add /tmp/uniswap-contracts-manifest 047d585853f89726c0fdef46bbf633bab8fc9051
+git -C /tmp/uniswap-contracts worktree add /tmp/uniswap-contracts-v4 534603a5bc10d41d57a1c9c34417d472f0dbc0d3
+git -C /tmp/uniswap-contracts worktree add /tmp/uniswap-contracts-router 02fd1760fa7c05096833c03e01a4143f963c350e
+anvil --chain-id 5042 --hardfork cancun --port 8545
+node scripts/verify-v4-retained-artifacts.mjs \
+  --deployment-manifest /tmp/uniswap-contracts-manifest \
+  --uniswap-contracts /tmp/uniswap-contracts-v4 \
+  --universal-router-contracts /tmp/uniswap-contracts-router \
+  --anvil-rpc http://127.0.0.1:8545
+```
+
+The script verifies the exact manifest commit and SHA-256, matches each address, deployment
+transaction, manifest input hash, and proxy flag, then hashes the retained generated initcode
+plus reviewed constructor arguments.
+With `--anvil-rpc`, it then deploys that material using an impersonated local account—no
+private key—and requires the resulting runtime to equal the Arc runtime hash. Solidity
+embeds `address(this)` in these runtimes. PositionManager and Universal Router also cache
+EIP-712 domain separators derived from that address. The verifier explicitly recomputes
+those values for the Arc deployment address and requires reviewed occurrence counts before
+replacement; it does not mask arbitrary byte ranges.
+
+Run `npm run test:live-compatibility` for the independent read-only Arc RPC check. The raw
+record is exported at `@reptilianhq/uniswap-sdk/provenance/arc-mainnet-v4.json`.
+
+## Launcher boundary
+
+This evidence deliberately stops at shared Uniswap infrastructure. The public
+`arguspad/argus-world` source at `c8c3d5fc2b0a4557a535bb4f7e7a3be9301c289e` contains
+explicitly reduced interfaces and simplified logic, with no pinned compiler build capable
+of reproducing deployed Argus bytecode. It is reference documentation, not deployment
+provenance.
+
+Argus Portal, hook, locker, splitter, tracker, fee collection, creator/reward payouts,
+custody, and permanently locked launch-principal semantics remain launcher-adapter gates.
+Their pinned-fork lifecycle belongs in the Argus SDK's capital-moving workflow, where the
+exact router call, sender, approvals, hook data, fee configuration, claims, and
+non-withdrawable principal can be tested together. Do not duplicate that proof in this
+generic SDK or infer it from a successful Quoter call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reptilianhq/uniswap-sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Deployment-explicit Uniswap observations and reviewed transaction material.",
   "license": "MIT",
   "type": "module",
@@ -13,6 +13,8 @@
     "provenance",
     "scripts/check-conformance.mjs",
     "scripts/verify-v3-deployments.mjs",
+    "scripts/verify-v4-deployments.mjs",
+    "scripts/verify-v4-retained-artifacts.mjs",
     "README.md",
     "RELEASING.md",
     "NOTICE",
@@ -73,7 +75,8 @@
       "import": "./dist/permit2.js"
     },
     "./provenance/mainnet.json": "./provenance/mainnet.json",
-    "./provenance/testnet.json": "./provenance/testnet.json"
+    "./provenance/testnet.json": "./provenance/testnet.json",
+    "./provenance/arc-mainnet-v4.json": "./provenance/arc-mainnet-v4.json"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -83,7 +86,7 @@
     "test:run": "vitest run src",
     "test:runtime": "node scripts/runtime-smoke.mjs",
     "test:fork": "vitest run src/v3-mainnet.fork.test.ts",
-    "test:live-compatibility": "npm run build && node scripts/verify-v3-deployments.mjs",
+    "test:live-compatibility": "npm run build && node scripts/verify-v3-deployments.mjs && node scripts/verify-v4-deployments.mjs",
     "test:consumer": "node examples/read-only-consumer.mjs",
     "check:conformance": "node scripts/check-conformance.mjs . && node --test scripts/check-conformance.node-test.mjs",
     "check:publisher": "node scripts/artifacts/check.mjs",
@@ -125,6 +128,6 @@
   "reptilianRelease": {
     "schemaVersion": 1,
     "group": "uniswap-sdk",
-    "sourceSha": "029525e00354cc1bdda7f016f88983dddbe6b911"
+    "sourceSha": "d080edda42054fce10727545c05464fce3f797ae"
   }
 }

package/provenance/arc-mainnet-v4.json

@@ -0,0 +1,111 @@
+{
+  "schemaVersion": 1,
+  "deploymentId": "arc-mainnet-v4",
+  "chainId": 5042,
+  "network": "arc-mainnet",
+  "reviewedAt": "2026-09-27",
+  "referenceBlock": {
+    "number": "20889496",
+    "hash": "0xf3fd31df5afb9d37a216dda53ac751a6a6c08a9c7e96ce4c07fb0df18d40810b",
+    "rpc": "https://rpc.arc-scan.org"
+  },
+  "officialDeploymentManifest": {
+    "repository": "https://github.com/Uniswap/contracts",
+    "commit": "047d585853f89726c0fdef46bbf633bab8fc9051",
+    "path": "deployments/json/5042.json",
+    "sha256": "77b5e8cef3cfe81b723082b0a44918a0c33c039706c80e09dbb702b996fea301"
+  },
+  "contracts": {
+    "poolManager": {
+      "address": "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+      "runtimeCodeHash": "0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626",
+      "runtimeCodeBytes": 24009,
+      "sourceCommit": "534603a5bc10d41d57a1c9c34417d472f0dbc0d3",
+      "sourcePackageCommit": "46c6834698c48bc4a463a86d8420f4eb1d7f3b75",
+      "deployerArtifactPath": "src/briefcase/deployers/v4-core/PoolManagerDeployer.sol",
+      "sourceContractPath": "src/pkgs/v4-core/src/PoolManager.sol",
+      "deploymentTransaction": "0x2a3f2686d0dfc0e8bea88ec2dd006d0cb788410a5d24a946c8d638a32868341e",
+      "generatedInitcodeHash": "0x1debe8d2bf707a0cea57ce3cdf7b399d61515897a5698b37050d2d5df0a95b2c",
+      "deploymentManifestInputHash": "0x3bdcc016bd6b2f8a19e20bdfa136abbf66ffa7904f42dafa1f5c399e9758544c",
+      "proxy": false
+    },
+    "stateView": {
+      "address": "0xF3334192D15450CdD385c8B70e03f9A6bD9E673b",
+      "runtimeCodeHash": "0x7d9c591e0956fd89d98feb4ffcfe8bf1f7a62bd485edd979fa21d104b49878a6",
+      "runtimeCodeBytes": 3531,
+      "sourceCommit": "534603a5bc10d41d57a1c9c34417d472f0dbc0d3",
+      "sourcePackageCommit": "9dafaaecc1e2e1e824eda9d941085f96517d827b",
+      "deployerArtifactPath": "src/briefcase/deployers/v4-periphery/StateViewDeployer.sol",
+      "sourceContractPath": "src/pkgs/v4-periphery/src/lens/StateView.sol",
+      "deploymentTransaction": "0xc98e1282cf14d5e63f1f8040403d476b92a5dca03bc838ba0b28bf9cfd42bd2f",
+      "generatedInitcodeHash": "0xd1a3b7780b831fbddf3407643b70cd7fc1af1140b0e41ad5f10ff74aac004a82",
+      "deploymentManifestInputHash": "0x0e2e13349f8e16c9ea97b0167f2747efd891690c087723e0a920356d274593d3",
+      "proxy": false
+    },
+    "positionManager": {
+      "address": "0x6049c9a0e26405C0985f9E3685C87d0aE917f82B",
+      "runtimeCodeHash": "0x5904204586f0290499c357cfcb99489cdc13740b3cd3f26c735f7ef7f2cff1c5",
+      "runtimeCodeBytes": 23877,
+      "sourceCommit": "534603a5bc10d41d57a1c9c34417d472f0dbc0d3",
+      "sourcePackageCommit": "9dafaaecc1e2e1e824eda9d941085f96517d827b",
+      "deployerArtifactPath": "src/briefcase/deployers/v4-periphery/PositionManagerDeployer.sol",
+      "sourceContractPath": "src/pkgs/v4-periphery/src/PositionManager.sol",
+      "deploymentTransaction": "0xf3abd73072ecc78cbaa6b23de7c2fb56e69edce1dddefa069155198295b2abd2",
+      "generatedInitcodeHash": "0x991742c2de2496144a6f8dce18252393a7d50116b8a3ab320100061d8b6dcca6",
+      "deploymentManifestInputHash": "0xb86b0eed6fd57117c2096f57f07f3e2b4644f2c379e1604cab08790aaa9c40bd",
+      "proxy": false
+    },
+    "quoter": {
+      "address": "0x8dc178efb8111bb0973dd9d722ebeff267c98f94",
+      "runtimeCodeHash": "0xd707b1da8cb165e5ea35a3b4450d971eb562ec171e23492aa117036b78a868f6",
+      "runtimeCodeBytes": 6118,
+      "sourceCommit": "534603a5bc10d41d57a1c9c34417d472f0dbc0d3",
+      "sourcePackageCommit": "9dafaaecc1e2e1e824eda9d941085f96517d827b",
+      "deployerArtifactPath": "src/briefcase/deployers/v4-periphery/V4QuoterDeployer.sol",
+      "sourceContractPath": "src/pkgs/v4-periphery/src/lens/V4Quoter.sol",
+      "deploymentTransaction": "0xb8d7a967c1be562fc9de8f5284a110e631f0fea17eef552852fec6ef67e4844a",
+      "generatedInitcodeHash": "0xd915642b6f3b5375c0096fd70eb15cc0676651fa7d588accd1c6002936bb19c2",
+      "deploymentManifestInputHash": "0xdb731ce141d9e731a17e60e47d1c0582c9c8684bf76430794d47d1d71fac6260",
+      "proxy": false
+    },
+    "universalRouter": {
+      "address": "0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1",
+      "runtimeCodeHash": "0x7f949fe75d3483670e17a9ab398a3dc71f285026bba755b48fffd1e42aefad71",
+      "runtimeCodeBytes": 24546,
+      "sourceCommit": "02fd1760fa7c05096833c03e01a4143f963c350e",
+      "sourcePackageCommit": "999d561c3ad58fb5cab91b602911f3c75591a9c7",
+      "deployerArtifactPath": "src/briefcase/deployers/universal-router/UniversalRouterDeployer.sol",
+      "sourceContractPath": "src/pkgs/universal-router/contracts/UniversalRouter.sol",
+      "deploymentTransaction": "0xf07bb4c6eaccb5b7e128625b0c4fc6bc79f727f9b647a6e81a886bde905345b8",
+      "generatedInitcodeHash": "0x8f564cfb262952d7d24e1750426672ccf3a72ca9268e2ec6d97cf846eaae179c",
+      "deploymentManifestInputHash": "0xe388b0b5ed9c81077f8fcd9a1724fb35b2c5792380dddd3a19fd02f5bc037f77",
+      "proxy": false
+    },
+    "permit2": {
+      "address": "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+      "runtimeCodeHash": "0x05a793d6bdba8b8715c8f4cef0725ec3a961f567d33ebb2d360f541f19f70c8f",
+      "runtimeCodeBytes": 9152,
+      "assurance": "canonical-predeploy-runtime-only"
+    }
+  },
+  "positionManagerWiring": {
+    "poolManager": "0x8366a39CC670B4001A1121B8F6A443A643e40951",
+    "permit2": "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+    "wrappedNative": "0x8bcEaA40B9AcdfAedF85AdF4FF01F5Ad6517937f",
+    "tokenDescriptor": "0x516b8a945700D6bBfDeDaa6dcFc4586bA60B8707",
+    "unsubscribeGasLimit": "300000"
+  },
+  "argusProtocolSourceBoundary": {
+    "repository": "https://github.com/arguspad/argus-world",
+    "commit": "c8c3d5fc2b0a4557a535bb4f7e7a3be9301c289e",
+    "assurance": "documentation-and-reference-source-only",
+    "reason": "The published contracts include explicitly reduced interfaces and simplified logic and provide no pinned compiler/build configuration, so they cannot be represented as bytecode-reproducible sources for the deployed Portal, hooks, lockers, splitters, or trackers."
+  },
+  "limitations": [
+    "Retained upstream generated-initcode provenance is complete for PoolManager, StateView, PositionManager, V4Quoter, and Universal Router; runtime identity is independently pinned at the reference block. This is not a fresh compilation of the referenced Solidity source.",
+    "deploymentManifestInputHash retains the upstream manifest field named initcodeHash; Uniswap/contracts computes it from the deployment transaction input, so it is kept distinct from generatedInitcodeHash.",
+    "Permit2 is an exact runtime pin of the canonical Arc predeploy, not a deployment produced by the retained Uniswap/contracts manifest.",
+    "This record does not establish Argus launcher-contract source equivalence or hook, fee, custody, payout, or locked-principal compatibility.",
+    "The V4Quoter is retained as official infrastructure, but hook-aware Argus quotes and writes require exact-router simulation with the actual sender."
+  ]
+}

package/scripts/verify-v4-deployments.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import { createPublicClient, http } from 'viem';
+import { arcUniswapV4Mainnet, verifyArcUniswapV4Compatibility } from '../dist/v4.js';
+
+const rpcUrl = process.env.UNISWAP_ARC_RPC_URL?.trim() || 'https://rpc.arc-scan.org';
+const client = createPublicClient({ transport: http(rpcUrl) });
+const report = await verifyArcUniswapV4Compatibility(client, arcUniswapV4Mainnet);
+
+process.stdout.write(
+  `ok - ${arcUniswapV4Mainnet.id}: ${Object.keys(report.runtimeCodeHashes).length} runtime hashes, pinned block, and manager wiring verified\n`,
+);

package/scripts/verify-v4-retained-artifacts.mjs

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { concatHex, createPublicClient, encodeAbiParameters, http, keccak256, toHex } from 'viem';
+
+const CORE_COMMIT = '534603a5bc10d41d57a1c9c34417d472f0dbc0d3';
+const ROUTER_COMMIT = '02fd1760fa7c05096833c03e01a4143f963c350e';
+const MANIFEST_COMMIT = '047d585853f89726c0fdef46bbf633bab8fc9051';
+const MANIFEST_SHA256 = '77b5e8cef3cfe81b723082b0a44918a0c33c039706c80e09dbb702b996fea301';
+
+const values = new Map();
+for (let index = 2; index < process.argv.length; index += 2) {
+  const flag = process.argv[index];
+  const value = process.argv[index + 1];
+  if (!flag?.startsWith('--') || !value) usage();
+  values.set(flag, value);
+}
+
+const coreCheckout = values.get('--uniswap-contracts');
+const routerCheckout = values.get('--universal-router-contracts') ?? coreCheckout;
+const manifestCheckout = values.get('--deployment-manifest');
+const anvilRpc = values.get('--anvil-rpc');
+if (!coreCheckout || !routerCheckout || !manifestCheckout) usage();
+
+const coreRoot = resolve(coreCheckout);
+const routerRoot = resolve(routerCheckout);
+const manifestRoot = resolve(manifestCheckout);
+assertCommit(coreRoot, CORE_COMMIT);
+assertCommit(routerRoot, ROUTER_COMMIT);
+assertCommit(manifestRoot, MANIFEST_COMMIT);
+const manifestPath = resolve(manifestRoot, 'deployments/json/5042.json');
+const manifestSource = readFileSync(manifestPath, 'utf8');
+const manifestSha256 = createHash('sha256').update(manifestSource).digest('hex');
+if (manifestSha256 !== MANIFEST_SHA256) {
+  throw new Error(`${manifestPath} SHA-256 mismatch: expected ${MANIFEST_SHA256}, got ${manifestSha256}`);
+}
+const manifest = JSON.parse(manifestSource);
+
+const poolManager = '0x8366a39CC670B4001A1121B8F6A443A643e40951';
+const permit2 = '0x000000000022D473030F116dDEE9F6B43aC78BA3';
+const wrappedNativeUnsupported = '0x8bcEaA40B9AcdfAedF85AdF4FF01F5Ad6517937f';
+const positionManager = '0x6049c9a0e26405C0985f9E3685C87d0aE917f82B';
+
+const records = [
+  {
+    name: 'poolManager', root: coreRoot,
+    manifestName: 'PoolManager',
+    address: poolManager,
+    artifact: 'src/briefcase/deployers/v4-core/PoolManagerDeployer.sol',
+    sourcePackagePath: 'src/pkgs/v4-core', sourcePackageCommit: '46c6834698c48bc4a463a86d8420f4eb1d7f3b75',
+    args: encodeAbiParameters([{ type: 'address' }], ['0x9701fb0aDe1E269c8f64Ec0C7b3cfADB31A13A52']),
+    expected: '0x1debe8d2bf707a0cea57ce3cdf7b399d61515897a5698b37050d2d5df0a95b2c',
+    deploymentTransaction: '0x2a3f2686d0dfc0e8bea88ec2dd006d0cb788410a5d24a946c8d638a32868341e',
+    deploymentManifestInputHash: '0x3bdcc016bd6b2f8a19e20bdfa136abbf66ffa7904f42dafa1f5c399e9758544c',
+    runtimeCodeHash: '0xbd3881180b547f5fe817545743cfb4343e96b1bc6640dcd70c106b0066e95626',
+    selfAddressOccurrences: 1,
+  },
+  {
+    name: 'stateView', root: coreRoot,
+    manifestName: 'StateView',
+    address: '0xF3334192D15450CdD385c8B70e03f9A6bD9E673b',
+    artifact: 'src/briefcase/deployers/v4-periphery/StateViewDeployer.sol',
+    sourcePackagePath: 'src/pkgs/v4-periphery', sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+    args: encodeAbiParameters([{ type: 'address' }], [poolManager]),
+    expected: '0xd1a3b7780b831fbddf3407643b70cd7fc1af1140b0e41ad5f10ff74aac004a82',
+    deploymentTransaction: '0xc98e1282cf14d5e63f1f8040403d476b92a5dca03bc838ba0b28bf9cfd42bd2f',
+    deploymentManifestInputHash: '0x0e2e13349f8e16c9ea97b0167f2747efd891690c087723e0a920356d274593d3',
+    runtimeCodeHash: '0x7d9c591e0956fd89d98feb4ffcfe8bf1f7a62bd485edd979fa21d104b49878a6',
+    selfAddressOccurrences: 0,
+  },
+  {
+    name: 'positionManager', root: coreRoot,
+    manifestName: 'PositionManager',
+    address: positionManager,
+    artifact: 'src/briefcase/deployers/v4-periphery/PositionManagerDeployer.sol',
+    sourcePackagePath: 'src/pkgs/v4-periphery', sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+    args: encodeAbiParameters(
+      [{ type: 'address' }, { type: 'address' }, { type: 'uint256' }, { type: 'address' }, { type: 'address' }],
+      [poolManager, permit2, 300_000n, '0x516b8a945700D6bBfDeDaa6dcFc4586bA60B8707', wrappedNativeUnsupported],
+    ),
+    expected: '0x991742c2de2496144a6f8dce18252393a7d50116b8a3ab320100061d8b6dcca6',
+    deploymentTransaction: '0xf3abd73072ecc78cbaa6b23de7c2fb56e69edce1dddefa069155198295b2abd2',
+    deploymentManifestInputHash: '0xb86b0eed6fd57117c2096f57f07f3e2b4644f2c379e1604cab08790aaa9c40bd',
+    runtimeCodeHash: '0x5904204586f0290499c357cfcb99489cdc13740b3cd3f26c735f7ef7f2cff1c5',
+    selfAddressOccurrences: 0,
+    domainSeparatorOccurrences: 1,
+    eip712DomainName: 'Uniswap v4 Positions NFT',
+  },
+  {
+    name: 'quoter', root: coreRoot,
+    manifestName: 'V4Quoter',
+    address: '0x8dc178efb8111bb0973dd9d722ebeff267c98f94',
+    artifact: 'src/briefcase/deployers/v4-periphery/V4QuoterDeployer.sol',
+    sourcePackagePath: 'src/pkgs/v4-periphery', sourcePackageCommit: '9dafaaecc1e2e1e824eda9d941085f96517d827b',
+    args: encodeAbiParameters([{ type: 'address' }], [poolManager]),
+    expected: '0xd915642b6f3b5375c0096fd70eb15cc0676651fa7d588accd1c6002936bb19c2',
+    deploymentTransaction: '0xb8d7a967c1be562fc9de8f5284a110e631f0fea17eef552852fec6ef67e4844a',
+    deploymentManifestInputHash: '0xdb731ce141d9e731a17e60e47d1c0582c9c8684bf76430794d47d1d71fac6260',
+    runtimeCodeHash: '0xd707b1da8cb165e5ea35a3b4450d971eb562ec171e23492aa117036b78a868f6',
+    selfAddressOccurrences: 0,
+  },
+  {
+    name: 'universalRouter', root: routerRoot,
+    manifestName: 'UniversalRouter',
+    address: '0x4fcA4a51Ab4F23A7447b3284fBd7D73289A89Fb1',
+    artifact: 'src/briefcase/deployers/universal-router/UniversalRouterDeployer.sol',
+    sourcePackagePath: 'src/pkgs/universal-router', sourcePackageCommit: '999d561c3ad58fb5cab91b602911f3c75591a9c7',
+    args: encodeAbiParameters([{
+      type: 'tuple',
+      components: [
+        { name: 'permit2', type: 'address' },
+        { name: 'weth9', type: 'address' },
+        { name: 'v2Factory', type: 'address' },
+        { name: 'v3Factory', type: 'address' },
+        { name: 'pairInitCodeHash', type: 'bytes32' },
+        { name: 'poolInitCodeHash', type: 'bytes32' },
+        { name: 'v4PoolManager', type: 'address' },
+        { name: 'v3NFTPositionManager', type: 'address' },
+        { name: 'v4PositionManager', type: 'address' },
+        { name: 'spokePool', type: 'address' },
+      ],
+    }], [{
+      permit2,
+      weth9: wrappedNativeUnsupported,
+      v2Factory: '0x89e5DB8B5aA49aA85AC63f691524311AEB649eba',
+      v3Factory: '0xf0db7b58379503491d857dB50AC9ece64c653918',
+      pairInitCodeHash: '0x96e8ac4277198ff8b6f785478aa9a39f403cb768dd02cbee326c3e7da348845f',
+      poolInitCodeHash: '0xe34f199b19b2b4f47f68442619d555527d244f78a3297ea89325f843f87b8b54',
+      v4PoolManager: poolManager,
+      v3NFTPositionManager: '0x39654A85A4C05127f5Fd6ED22CAeC077A0fB1377',
+      v4PositionManager: positionManager,
+      spokePool: wrappedNativeUnsupported,
+    }]),
+    expected: '0x8f564cfb262952d7d24e1750426672ccf3a72ca9268e2ec6d97cf846eaae179c',
+    deploymentTransaction: '0xf07bb4c6eaccb5b7e128625b0c4fc6bc79f727f9b647a6e81a886bde905345b8',
+    deploymentManifestInputHash: '0xe388b0b5ed9c81077f8fcd9a1724fb35b2c5792380dddd3a19fd02f5bc037f77',
+    runtimeCodeHash: '0x7f949fe75d3483670e17a9ab398a3dc71f285026bba755b48fffd1e42aefad71',
+    selfAddressOccurrences: 1,
+    domainSeparatorOccurrences: 1,
+    eip712DomainName: 'UniversalRouter',
+    eip712DomainVersion: '2',
+  },
+];
+
+let failed = false;
+const creations = [];
+for (const record of records) {
+  assertGitlink(record.root, record.sourcePackagePath, record.sourcePackageCommit);
+  assertManifestRecord(manifest, record);
+  const initcode = extractInitcode(resolve(record.root, record.artifact));
+  const creationCode = concatHex([initcode, record.args]);
+  const actual = keccak256(creationCode);
+  if (actual !== record.expected) {
+    process.stderr.write(`not ok - ${record.name}: expected ${record.expected}, got ${actual}\n`);
+    failed = true;
+    continue;
+  }
+  creations.push({ ...record, creationCode });
+  process.stdout.write(`ok - ${record.name}: ${actual}\n`);
+}
+if (failed) {
+  process.exitCode = 1;
+} else if (anvilRpc) {
+  await verifyRuntimeReproduction(anvilRpc, creations);
+}
+
+function assertCommit(root, expected) {
+  const actual = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: root, encoding: 'utf8' }).trim();
+  if (actual !== expected) throw new Error(`${root} must be checked out at ${expected}; got ${actual}`);
+}
+
+function assertGitlink(root, path, expected) {
+  const entry = execFileSync('git', ['ls-tree', 'HEAD', path], { cwd: root, encoding: 'utf8' }).trim();
+  const actual = entry.split(/\s+/)[2];
+  if (actual !== expected) throw new Error(`${root}:${path} must point to ${expected}; got ${actual ?? 'nothing'}`);
+}
+
+function extractInitcode(path) {
+  const source = readFileSync(path, 'utf8');
+  const match = source.match(/function initcode\(\)[\s\S]*?return hex'([0-9a-f]+)'/i);
+  if (!match) throw new Error(`Unable to extract generated initcode from ${path}`);
+  return `0x${match[1]}`;
+}
+
+function assertManifestRecord(source, record) {
+  const candidates = [source.latest, ...source.history.map(entry => entry.contracts ?? {})]
+    .map(contracts => contracts[record.manifestName])
+    .filter(Boolean);
+  const entry = candidates.find(candidate => candidate.address.toLowerCase() === record.address.toLowerCase());
+  if (!entry) throw new Error(`Manifest has no ${record.manifestName} entry for ${record.address}`);
+  const expected = {
+    deploymentTxn: record.deploymentTransaction.toLowerCase(),
+    initcodeHash: record.deploymentManifestInputHash.slice(2).toLowerCase(),
+    proxy: false,
+  };
+  for (const [field, value] of Object.entries(expected)) {
+    const actual = typeof entry[field] === 'string' ? entry[field].toLowerCase() : entry[field];
+    if (actual !== value) {
+      throw new Error(`Manifest ${record.manifestName}.${field} mismatch: expected ${value}, got ${actual}`);
+    }
+  }
+}
+
+async function verifyRuntimeReproduction(rpcUrl, creationRecords) {
+  const client = createPublicClient({ transport: http(rpcUrl) });
+  const chainId = await client.getChainId();
+  if (chainId !== 5_042) throw new Error(`Anvil chain ID must be 5042; got ${chainId}`);
+
+  const account = '0x0000000000000000000000000000000000005042';
+  await client.request({ method: 'anvil_setBalance', params: [account, '0x56bc75e2d63100000'] });
+  await client.request({ method: 'anvil_impersonateAccount', params: [account] });
+  try {
+    for (const record of creationRecords) {
+      const hash = await client.request({
+        method: 'eth_sendTransaction',
+        params: [{ from: account, data: record.creationCode, gas: '0x1c9c380' }],
+      });
+      const receipt = await client.waitForTransactionReceipt({ hash });
+      if (receipt.status !== 'success' || !receipt.contractAddress) {
+        throw new Error(`${record.name} local reproduction deployment failed`);
+      }
+      const bytecode = await client.getBytecode({ address: receipt.contractAddress });
+      const normalizedBytecode = bytecode
+        ? normalizeDeploymentImmutables(
+          bytecode,
+          receipt.contractAddress,
+          record.address,
+          record.eip712DomainName,
+          record.eip712DomainVersion,
+          record.selfAddressOccurrences,
+          record.domainSeparatorOccurrences ?? 0,
+        )
+        : null;
+      const actual = normalizedBytecode ? keccak256(normalizedBytecode) : null;
+      if (actual !== record.runtimeCodeHash) {
+        throw new Error(`${record.name} runtime hash mismatch: expected ${record.runtimeCodeHash}, got ${actual}`);
+      }
+      process.stdout.write(`ok - ${record.name} runtime: ${actual}\n`);
+    }
+  } finally {
+    await client.request({ method: 'anvil_stopImpersonatingAccount', params: [account] });
+  }
+}
+
+function normalizeDeploymentImmutables(
+  bytecode,
+  localAddress,
+  deployedAddress,
+  eip712DomainName,
+  eip712DomainVersion,
+  expectedSelfAddressOccurrences,
+  expectedDomainSeparatorOccurrences,
+) {
+  const local = localAddress.slice(2).toLowerCase();
+  const deployed = deployedAddress.slice(2).toLowerCase();
+  assertOccurrences(bytecode, local, expectedSelfAddressOccurrences, 'deployment address');
+  let normalized = bytecode.slice(2).toLowerCase().replaceAll(local, deployed);
+  if (eip712DomainName) {
+    const localDomain = eip712DomainSeparator(
+      eip712DomainName,
+      localAddress,
+      eip712DomainVersion,
+    ).slice(2);
+    const deployedDomain = eip712DomainSeparator(
+      eip712DomainName,
+      deployedAddress,
+      eip712DomainVersion,
+    ).slice(2);
+    assertOccurrences(`0x${normalized}`, localDomain, expectedDomainSeparatorOccurrences, 'EIP-712 domain separator');
+    normalized = normalized.replaceAll(localDomain, deployedDomain);
+  } else if (expectedDomainSeparatorOccurrences !== 0) {
+    throw new Error('Expected EIP-712 domain occurrences without a domain name');
+  }
+  return `0x${normalized}`;
+}
+
+function assertOccurrences(bytecode, value, expected, label) {
+  const actual = bytecode.slice(2).toLowerCase().split(value).length - 1;
+  if (actual !== expected) throw new Error(`${label} occurrence mismatch: expected ${expected}, got ${actual}`);
+}
+
+function eip712DomainSeparator(name, verifyingContract, version) {
+  const hasVersion = version !== undefined;
+  const typeHash = keccak256(toHex(hasVersion
+    ? 'EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'
+    : 'EIP712Domain(string name,uint256 chainId,address verifyingContract)'));
+  return keccak256(encodeAbiParameters(
+    hasVersion
+      ? [{ type: 'bytes32' }, { type: 'bytes32' }, { type: 'bytes32' }, { type: 'uint256' }, { type: 'address' }]
+      : [{ type: 'bytes32' }, { type: 'bytes32' }, { type: 'uint256' }, { type: 'address' }],
+    hasVersion
+      ? [typeHash, keccak256(toHex(name)), keccak256(toHex(version)), 5_042n, verifyingContract]
+      : [typeHash, keccak256(toHex(name)), 5_042n, verifyingContract],
+  ));
+}
+
+function usage() {
+  process.stderr.write('Usage: node scripts/verify-v4-retained-artifacts.mjs --deployment-manifest <047d585 checkout> --uniswap-contracts <534603a checkout> --universal-router-contracts <02fd176 checkout> [--anvil-rpc http://127.0.0.1:8545]\n');
+  process.exit(2);
+}