@reptilianhq/uniswap-sdk 0.7.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))