@wireio/stake 2.7.3 → 3.0.0

package/src/networks/{ethereum → evm}/contract.ts

@@ -1,71 +1,71 @@
 /**
- * @module EthereumContractService
+ * @module EvmContractService
  *
  * Provides a unified service for interacting with Ethereum smart contracts using ethers.js.
  */
 
 // Mainnet artifacts
-import MainnetAccountingArtifact from '../../assets/ethereum/mainnet/liqEth/v1/accounting.sol/Accounting.json';
-import MainnetDepositManagerArtifact from '../../assets/ethereum/mainnet/liqEth/v1/DepositManager.sol/DepositManager.json';
-import MainnetLiqEthArtifact from '../../assets/ethereum/mainnet/liqEth/v1/liqEth.sol/LiqEthToken.json';
-import MainnetStakingModuleArtifact from '../../assets/ethereum/mainnet/liqEth/v1/stakingModule.sol/StakingModule.json';
-import MainnetWithdrawalQueueArtifact from '../../assets/ethereum/mainnet/liqEth/withdrawalQueue.sol/WithdrawalQueue.json';
-import MainnetWithdrawalVaultArtifact from '../../assets/ethereum/mainnet/liqEth/withdrawalVault.sol/WithdrawalVault.json';
-import MainnetBeaconStateArtifact from '../../assets/ethereum/mainnet/liqEth/BeaconState.sol/BeaconState.json';
-import MainnetYieldOracleArtifact from '../../assets/ethereum/mainnet/liqEth/Yield.sol/YieldOracle.json';
-import MainnetDepositorArtifact from '../../assets/ethereum/mainnet/outpost/Depositor.sol/DepositorV2.json';
-import MainnetReceiptNFTArtifact from '../../assets/ethereum/mainnet/outpost/ReceiptNFT.sol/ReceiptNFT.json';
-import MainnetOutpostManagerArtifact from '../../assets/ethereum/mainnet/outpost/OutpostManager.sol/OutpostManagerV2.json';
-import MainnetBARArtifact from '../../assets/ethereum/mainnet/outpost/BAR.sol/BARV2.json';
-import MainnetOPPArtifact from '../../assets/ethereum/mainnet/outpost/OPP.sol/OPP.json';
-import MainnetOPPCommonArtifact from '../../assets/ethereum/mainnet/outpost/OPPCommon.sol/OPPCommon.json';
-import MainnetOPPInboundArtifact from '../../assets/ethereum/mainnet/outpost/OPPInbound.sol/OPPInbound.json';
-import MainnetPretokenArtifact from '../../assets/ethereum/mainnet/outpost/Pretoken.sol/PretokenV2.json';
-import MainnetEthUsdPriceConsumerArtifact from '../../assets/ethereum/mainnet/outpost/EthUsdPriceConsumer.sol/EthUsdPriceConsumer.json';
-import MainnetPoolArtifact from '../../assets/ethereum/mainnet/outpost/Pool.sol/PoolV2.json';
-import MainnetOutpostManagerAuthorityArtifact from '../../assets/ethereum/mainnet/outpost/OutpostManagerAuthority.sol/OutpostManagerAuthority.json';
-import MainnetIodataArtifact from '../../assets/ethereum/mainnet/common/iodata.sol/iodata.json';
-import MainnetBase58Artifact from '../../assets/ethereum/mainnet/common/Base58.sol/Base58.json';
-import MainnetSysioMerkleArtifact from '../../assets/ethereum/mainnet/common/sysio_merkle.sol/sysio_merkle.json';
-import MainnetSysioWriteArtifact from '../../assets/ethereum/mainnet/common/sysio_write.sol/sysio_write.json';
-import MainnetERC20Artifact from '../../assets/ethereum/mainnet/token/ERC20Token.sol/ERC20Token.json';
-import MainnetERC721Artifact from '../../assets/ethereum/mainnet/token/ERC721Token.sol/ERC721Token.json';
-import MainnetERC1155Artifact from '../../assets/ethereum/mainnet/token/ERC1155Token.sol/ERC1155Token.json';
-
-// Hoodi artifacts
-import HoodiAccountingArtifact from '../../assets/ethereum/mainnet/liqEth/v1/accounting.sol/Accounting.json';
-import HoodiDepositManagerArtifact from '../../assets/ethereum/mainnet/liqEth/v1/DepositManager.sol/DepositManager.json';
-import HoodiLiqEthArtifact from '../../assets/ethereum/mainnet/liqEth/v1/liqEth.sol/LiqEthToken.json';
-import HoodiStakingModuleArtifact from '../../assets/ethereum/mainnet/liqEth/v1/stakingModule.sol/StakingModule.json';
-import HoodiWithdrawalQueueArtifact from '../../assets/ethereum/mainnet/liqEth/withdrawalQueue.sol/WithdrawalQueue.json';
-import HoodiWithdrawalVaultArtifact from '../../assets/ethereum/mainnet/liqEth/withdrawalVault.sol/WithdrawalVault.json';
-import HoodiBeaconStateArtifact from '../../assets/ethereum/mainnet/liqEth/BeaconState.sol/BeaconState.json';
-import HoodiYieldOracleArtifact from '../../assets/ethereum/mainnet/liqEth/Yield.sol/YieldOracle.json';
-import HoodiDepositorArtifact from '../../assets/ethereum/mainnet/outpost/Depositor.sol/DepositorV2.json';
-import HoodiReceiptNFTArtifact from '../../assets/ethereum/mainnet/outpost/ReceiptNFT.sol/ReceiptNFT.json';
-import HoodiOutpostManagerArtifact from '../../assets/ethereum/mainnet/outpost/OutpostManager.sol/OutpostManagerV2.json';
-import HoodiBARArtifact from '../../assets/ethereum/mainnet/outpost/BAR.sol/BARV2.json';
-import HoodiOPPArtifact from '../../assets/ethereum/mainnet/outpost/OPP.sol/OPP.json';
-import HoodiOPPCommonArtifact from '../../assets/ethereum/mainnet/outpost/OPPCommon.sol/OPPCommon.json';
-import HoodiOPPInboundArtifact from '../../assets/ethereum/mainnet/outpost/OPPInbound.sol/OPPInbound.json';
-import HoodiPretokenArtifact from '../../assets/ethereum/mainnet/outpost/Pretoken.sol/PretokenV2.json';
-import HoodiEthUsdPriceConsumerArtifact from '../../assets/ethereum/mainnet/outpost/EthUsdPriceConsumer.sol/EthUsdPriceConsumer.json';
-import HoodiPoolArtifact from '../../assets/ethereum/mainnet/outpost/Pool.sol/PoolV2.json';
-import HoodiOutpostManagerAuthorityArtifact from '../../assets/ethereum/mainnet/outpost/OutpostManagerAuthority.sol/OutpostManagerAuthority.json';
-import HoodiIodataArtifact from '../../assets/ethereum/mainnet/common/iodata.sol/iodata.json';
-import HoodiBase58Artifact from '../../assets/ethereum/mainnet/common/Base58.sol/Base58.json';
-import HoodiSysioMerkleArtifact from '../../assets/ethereum/mainnet/common/sysio_merkle.sol/sysio_merkle.json';
-import HoodiSysioWriteArtifact from '../../assets/ethereum/mainnet/common/sysio_write.sol/sysio_write.json';
-import HoodiERC20Artifact from '../../assets/ethereum/mainnet/token/ERC20Token.sol/ERC20Token.json';
-import HoodiERC721Artifact from '../../assets/ethereum/mainnet/token/ERC721Token.sol/ERC721Token.json';
-import HoodiERC1155Artifact from '../../assets/ethereum/mainnet/token/ERC1155Token.sol/ERC1155Token.json';
+import MainnetAccountingArtifact from '../../assets/evm/mainnet/liqEth/v1/accounting.sol/Accounting.json';
+import MainnetDepositManagerArtifact from '../../assets/evm/mainnet/liqEth/v1/DepositManager.sol/DepositManager.json';
+import MainnetLiqEthArtifact from '../../assets/evm/mainnet/liqEth/v1/liqEth.sol/LiqEthToken.json';
+import MainnetStakingModuleArtifact from '../../assets/evm/mainnet/liqEth/v1/stakingModule.sol/StakingModule.json';
+import MainnetWithdrawalQueueArtifact from '../../assets/evm/mainnet/liqEth/withdrawalQueue.sol/WithdrawalQueue.json';
+import MainnetWithdrawalVaultArtifact from '../../assets/evm/mainnet/liqEth/withdrawalVault.sol/WithdrawalVault.json';
+import MainnetBeaconStateArtifact from '../../assets/evm/mainnet/liqEth/BeaconState.sol/BeaconState.json';
+import MainnetYieldOracleArtifact from '../../assets/evm/mainnet/liqEth/Yield.sol/YieldOracle.json';
+import MainnetDepositorArtifact from '../../assets/evm/mainnet/outpost/Depositor.sol/DepositorV2.json';
+import MainnetReceiptNFTArtifact from '../../assets/evm/mainnet/outpost/ReceiptNFT.sol/ReceiptNFT.json';
+import MainnetOutpostManagerArtifact from '../../assets/evm/mainnet/outpost/OutpostManager.sol/OutpostManagerV2.json';
+import MainnetBARArtifact from '../../assets/evm/mainnet/outpost/BAR.sol/BARV2.json';
+import MainnetOPPArtifact from '../../assets/evm/mainnet/outpost/OPP.sol/OPP.json';
+import MainnetOPPCommonArtifact from '../../assets/evm/mainnet/outpost/OPPCommon.sol/OPPCommon.json';
+import MainnetOPPInboundArtifact from '../../assets/evm/mainnet/outpost/OPPInbound.sol/OPPInbound.json';
+import MainnetPretokenArtifact from '../../assets/evm/mainnet/outpost/Pretoken.sol/PretokenV2.json';
+import MainnetEthUsdPriceConsumerArtifact from '../../assets/evm/mainnet/outpost/EthUsdPriceConsumer.sol/EthUsdPriceConsumer.json';
+import MainnetPoolArtifact from '../../assets/evm/mainnet/outpost/Pool.sol/PoolV2.json';
+import MainnetOutpostManagerAuthorityArtifact from '../../assets/evm/mainnet/outpost/OutpostManagerAuthority.sol/OutpostManagerAuthority.json';
+import MainnetIodataArtifact from '../../assets/evm/mainnet/common/iodata.sol/iodata.json';
+import MainnetBase58Artifact from '../../assets/evm/mainnet/common/Base58.sol/Base58.json';
+import MainnetSysioMerkleArtifact from '../../assets/evm/mainnet/common/sysio_merkle.sol/sysio_merkle.json';
+import MainnetSysioWriteArtifact from '../../assets/evm/mainnet/common/sysio_write.sol/sysio_write.json';
+import MainnetERC20Artifact from '../../assets/evm/mainnet/token/ERC20Token.sol/ERC20Token.json';
+import MainnetERC721Artifact from '../../assets/evm/mainnet/token/ERC721Token.sol/ERC721Token.json';
+import MainnetERC1155Artifact from '../../assets/evm/mainnet/token/ERC1155Token.sol/ERC1155Token.json';
+
+// Wiredev artifacts
+import WiredevAccountingArtifact from '../../assets/evm/wiredev/liqEth/v1/accounting.sol/Accounting.json';
+import WiredevDepositManagerArtifact from '../../assets/evm/wiredev/liqEth/v1/DepositManager.sol/DepositManager.json';
+import WiredevLiqEthArtifact from '../../assets/evm/wiredev/liqEth/v1/liqEth.sol/LiqEthToken.json';
+import WiredevStakingModuleArtifact from '../../assets/evm/wiredev/liqEth/v1/stakingModule.sol/StakingModule.json';
+import WiredevWithdrawalQueueArtifact from '../../assets/evm/wiredev/liqEth/withdrawalQueue.sol/WithdrawalQueue.json';
+import WiredevWithdrawalVaultArtifact from '../../assets/evm/wiredev/liqEth/withdrawalVault.sol/WithdrawalVault.json';
+import WiredevBeaconStateArtifact from '../../assets/evm/wiredev/liqEth/BeaconState.sol/BeaconState.json';
+import WiredevYieldOracleArtifact from '../../assets/evm/wiredev/liqEth/Yield.sol/YieldOracle.json';
+import WiredevDepositorArtifact from '../../assets/evm/wiredev/outpost/Depositor.sol/Depositor.json';
+import WiredevReceiptNFTArtifact from '../../assets/evm/wiredev/outpost/ReceiptNFT.sol/ReceiptNFT.json';
+import WiredevOutpostManagerArtifact from '../../assets/evm/wiredev/outpost/OutpostManager.sol/OutpostManager.json';
+import WiredevBARArtifact from '../../assets/evm/wiredev/outpost/BAR.sol/BAR.json';
+import WiredevOPPArtifact from '../../assets/evm/wiredev/outpost/OPP.sol/OPP.json';
+import WiredevOPPCommonArtifact from '../../assets/evm/wiredev/outpost/OPPCommon.sol/OPPCommon.json';
+import WiredevOPPInboundArtifact from '../../assets/evm/wiredev/outpost/OPPInbound.sol/OPPInbound.json';
+import WiredevPretokenArtifact from '../../assets/evm/wiredev/outpost/Pretoken.sol/Pretoken.json';
+import WiredevEthUsdPriceConsumerArtifact from '../../assets/evm/wiredev/outpost/EthUsdPriceConsumer.sol/EthUsdPriceConsumer.json';
+import WiredevPoolArtifact from '../../assets/evm/wiredev/outpost/Pool.sol/Pool.json';
+import WiredevOutpostManagerAuthorityArtifact from '../../assets/evm/wiredev/outpost/OutpostManagerAuthority.sol/OutpostManagerAuthority.json';
+import WiredevIodataArtifact from '../../assets/evm/wiredev/common/iodata.sol/iodata.json';
+import WiredevBase58Artifact from '../../assets/evm/wiredev/common/Base58.sol/Base58.json';
+import WiredevSysioMerkleArtifact from '../../assets/evm/wiredev/common/sysio_merkle.sol/sysio_merkle.json';
+import WiredevSysioWriteArtifact from '../../assets/evm/wiredev/common/sysio_write.sol/sysio_write.json';
+import WiredevERC20Artifact from '../../assets/evm/wiredev/token/ERC20Token.sol/ERC20Token.json';
+import WiredevERC721Artifact from '../../assets/evm/wiredev/token/ERC721Token.sol/ERC721Token.json';
+import WiredevERC1155Artifact from '../../assets/evm/wiredev/token/ERC1155Token.sol/ERC1155Token.json';
 
 import { AddressBook, ContractName } from './types';
 import { Contract, ethers, providers, Signer } from 'ethers';
 import { JsonFragment } from '@ethersproject/abi';
 import { ErrorDescription } from '@ethersproject/abi/lib/interface';
 import { EvmChainID } from '@wireio/core';
-import { SupportedEvmChainID } from '../../types';
+import { EVM_WIRE_DEVNET_CHAIN_ID, type SupportedEvmContractChainID } from '../../chains';
 
 export const ERC20Abi = MainnetERC20Artifact.abi;
 export const ERC721Abi = MainnetERC721Artifact.abi;
@@ -131,35 +131,41 @@ const MAINNET_ARTIFACTS: ArtifactBundle = {
     ERC1155: MainnetERC1155Artifact as AbiArtifact,
 };
 
-const HOODI_ARTIFACTS: ArtifactBundle = {
-    Accounting: HoodiAccountingArtifact as AbiArtifact,
-    DepositManager: HoodiDepositManagerArtifact as AbiArtifact,
-    LiqEthToken: HoodiLiqEthArtifact as AbiArtifact,
-    StakingModule: HoodiStakingModuleArtifact as AbiArtifact,
-    WithdrawalQueue: HoodiWithdrawalQueueArtifact as AbiArtifact,
-    WithdrawalVault: HoodiWithdrawalVaultArtifact as AbiArtifact,
-    BeaconState: HoodiBeaconStateArtifact as AbiArtifact,
-    YieldOracle: HoodiYieldOracleArtifact as AbiArtifact,
-    Depositor: HoodiDepositorArtifact as AbiArtifact,
-    ReceiptNFT: HoodiReceiptNFTArtifact as AbiArtifact,
-    OutpostManager: HoodiOutpostManagerArtifact as AbiArtifact,
-    BAR: HoodiBARArtifact as AbiArtifact,
-    OPP: HoodiOPPArtifact as AbiArtifact,
-    OPPCommon: HoodiOPPCommonArtifact as AbiArtifact,
-    OPPInbound: HoodiOPPInboundArtifact as AbiArtifact,
-    Pretoken: HoodiPretokenArtifact as AbiArtifact,
-    EthUsdPriceConsumer: HoodiEthUsdPriceConsumerArtifact as AbiArtifact,
-    Pool: HoodiPoolArtifact as AbiArtifact,
-    OutpostManagerAuthority: HoodiOutpostManagerAuthorityArtifact as AbiArtifact,
-    iodata: HoodiIodataArtifact as AbiArtifact,
-    Base58: HoodiBase58Artifact as AbiArtifact,
-    sysio_merkle: HoodiSysioMerkleArtifact as AbiArtifact,
-    sysio_write: HoodiSysioWriteArtifact as AbiArtifact,
-    ERC20: HoodiERC20Artifact as AbiArtifact,
-    ERC721: HoodiERC721Artifact as AbiArtifact,
-    ERC1155: HoodiERC1155Artifact as AbiArtifact,
+const WIREDEV_ARTIFACTS: ArtifactBundle = {
+    Accounting: WiredevAccountingArtifact as AbiArtifact,
+    DepositManager: WiredevDepositManagerArtifact as AbiArtifact,
+    LiqEthToken: WiredevLiqEthArtifact as AbiArtifact,
+    StakingModule: WiredevStakingModuleArtifact as AbiArtifact,
+    WithdrawalQueue: WiredevWithdrawalQueueArtifact as AbiArtifact,
+    WithdrawalVault: WiredevWithdrawalVaultArtifact as AbiArtifact,
+    BeaconState: WiredevBeaconStateArtifact as AbiArtifact,
+    YieldOracle: WiredevYieldOracleArtifact as AbiArtifact,
+    Depositor: WiredevDepositorArtifact as AbiArtifact,
+    ReceiptNFT: WiredevReceiptNFTArtifact as AbiArtifact,
+    OutpostManager: WiredevOutpostManagerArtifact as AbiArtifact,
+    BAR: WiredevBARArtifact as AbiArtifact,
+    OPP: WiredevOPPArtifact as AbiArtifact,
+    OPPCommon: WiredevOPPCommonArtifact as AbiArtifact,
+    OPPInbound: WiredevOPPInboundArtifact as AbiArtifact,
+    Pretoken: WiredevPretokenArtifact as AbiArtifact,
+    EthUsdPriceConsumer: WiredevEthUsdPriceConsumerArtifact as AbiArtifact,
+    Pool: WiredevPoolArtifact as AbiArtifact,
+    OutpostManagerAuthority: WiredevOutpostManagerAuthorityArtifact as AbiArtifact,
+    iodata: WiredevIodataArtifact as AbiArtifact,
+    Base58: WiredevBase58Artifact as AbiArtifact,
+    sysio_merkle: WiredevSysioMerkleArtifact as AbiArtifact,
+    sysio_write: WiredevSysioWriteArtifact as AbiArtifact,
+    ERC20: WiredevERC20Artifact as AbiArtifact,
+    ERC721: WiredevERC721Artifact as AbiArtifact,
+    ERC1155: WiredevERC1155Artifact as AbiArtifact,
 };
 
+/**
+ * Hoodi currently shares the same ABI artifact surface as mainnet. When Hoodi
+ * artifacts diverge, replace this alias with imports from `assets/evm/hoodi`.
+ */
+const HOODI_ARTIFACTS: ArtifactBundle = MAINNET_ARTIFACTS;
+
 // -----------------------------------------------------------------------------
 // Address books (per-chain)
 // -----------------------------------------------------------------------------
@@ -202,45 +208,128 @@ export const MAINNET_ADDRESSES: AddressBook = {
 };
 
 /**
- * HOODI TESTNET LATEST
- * 3/25/26
+ * Hoodi currently reuses the mainnet address/artifact shape in this SDK layer.
+ * Replace this alias with a Hoodi deployment address book when one diverges.
  */
-export const HOODI_ADDRESSES: AddressBook = {
+export const HOODI_ADDRESSES: AddressBook = MAINNET_ADDRESSES;
+
+/**
+ * ---WIREDEV TESTNET LATEST
+ * ---3/25/26
+ * 
+ * TEMPORARILY LOCAL ETH WIRE DEVNET ADDRESSES 
+ * 4/10/26
+ * 
+ */
+export const WIREDEV_ADDRESSES: AddressBook = {
+    // WIRE ETH DEVNET - AWS deployment 4/23/26
     // LiqETH contracts
-    LiqEthAuthority: '0x3Eb66Bb91F7a022FbABc1619Cb6acce7025Bc41F',
-    BeaconState: '0x08F879c6D0964E0A17bF688Af23168f654DF372e',
-    WithdrawalQueue: '0x74aDeD940369baDDb0F36426F23B08499e45Fe18',
-    LiqEthToken: '0x8C974517D038e2e3b8a1da7b1A026bC8132A4b2e',
-    Accounting: '0x766CE996B8132b927988c5b2ECAE8108fB1a9307',
-    DepositManager: '0xEd391dB5DB11B5eDBE08e69A51D16e84293C09a3',
-    WithdrawalVault: '0xbaBc0D5997283ab9886696A0dEaB8A8093436b48',
-    StakingModule: '0x4998fBb6Ca5Ee3Db6c339e2962A34791Af643fEa',
-    // YieldOracle: '0x61Fe311C57dd9a38Fb7B0c5A8ec521452dB25378',
+    LiqEthAuthority: "0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9",
+    BeaconState: "0x5FC8d32690cc91D4c39d9d3abcBD16989F875707",
+    WithdrawalQueue: "0xa513E6E4b8f2a923D98304ec87F64353C4D5C853",
+    LiqEthToken: "0x8A791620dd6260079BF849Dc5567aDC3F2FdC318",
+    Accounting: "0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e",
+    DepositManager: "0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82",
+    WithdrawalVault: "0x0B306BF915C4d645ff596e518fAf3F9669b97016",
+    StakingModule: "0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE",
+    // YieldOracle: "0x3Aa5ebB10DC797CAC828524e59A333d0A371443c"
 
     // Outpost contracts
-    OutpostManagerAuthority: '0x3B8705Ba1195AF632b3bd9E46F19348BC828FA3D',
-    iodata: '0x4aCABbC74a1cA9B0058d9ADAa0E00Af0f4f73212',
-    Base58: '0x1241F36ff30065deD52d51f0d6524EF971259A12',
-    sysio_merkle: '0x58ca9b5515266Fd6bF94D5F1268C505b2eC9679c',
-    ReceiptNFT: '0x03d6bD46cA9F54B8F8bbA21CfAfe717b36cB8593',
-    EthUsdPriceConsumer: '0xdC2DD993A13b3DD6D255B52285625694bd967c9A',
-    Pool: '0xd4742757AA61B1Fd3Fcd87980D7D460B12Cd9275',
-    OutpostManager: '0x38ec2B56cBCeCaFFe28b535517de1a102C3D74E3',
-    sysio_write: '0x0Ec4C1BaB772958aa3Db27459643bfbE7d92E305',
-    Pretoken: '0x8c97a51A71640fa411DEfab8feC3401eFfd1a2E4',
-    BAR: '0xbAFac13ffd3Aa9aEabaaeb6e4C2cF3dFf3479DC0',
-    OPPCommon: '0x12283a6d4E6cE4A0e8AdB319Fc161c7F4f91EA8F',
-    OPP: '0x87CE3Fe2CDca39C04aa2c14bbF1E1d9DB6358C4A',
-    Depositor: '0x5351B30EA4b75bD9be9Fc0048e88F675f7b3Ac2b',
-    OPPInbound: '0x0B1f7FB1c7f01A9cf490a1387E1E100F2bEA6C6d',
+    OutpostManagerAuthority: "0x172076E0166D1F9Cc711C77Adf8488051744980C",
+    iodata: '0x4aCABbC74a1cA9B0058d9ADAa0E00Af0f4f73212',   // not provided in outpost-addrs.json, re-using previous value
+    Base58: '0x1241F36ff30065deD52d51f0d6524EF971259A12',   // not provided in outpost-addrs.json, re-using previous value
+    OPPCommon: "0x4EE6eCAD1c2Dae9f525404De8555724e3c35d07B",
+    sysio_merkle: "0xBEc49fA140aCaA83533fB00A2BB19bDdd0290f25",
+    OPP: "0x2B0d36FACD61B71CC05ab8F3D2355ec3631C0dd5",
+    ReceiptNFT: "0x46b142DD1E924FAb83eCc3c08e4D46E82f005e0E",
+    // MockAggregator: "0x1c85638e118b37167e9298c2268758e058DdfDA0",
+    Pool: "0x4C2F7092C2aE51D986bEFEe378e50BD4dB99C901",
+    // WireYieldHubAttestations: "0x7A9Ec1d04904907De0ED7b6839CcdD59c3716AC9",
+    // LiqEthBridge: "0x4631BCAbD6dF18D94796344963cB60d44a4136b6",
+    BAR: "0xA4899D35897033b927acFCf422bc745916139776",
+    // OperatorRegistry: "0xAA292E8611aDF267e563f334Ee42320aC96D0463",
+    OutpostManager: "0x720472c8ce72c2A2D711333e064ABD3E6BbEAdd3",
+    sysio_write: '0x0Ec4C1BaB772958aa3Db27459643bfbE7d92E305',    // not provided in outpost-addrs.json, re-using previous value
+    OPPInbound: "0x5067457698Fd6Fa1C6964e416b3f42713513B3dD",
+    EthUsdPriceConsumer: "0x18E317A7D70d8fBf8e6E893616b52390EbBdb629",
+    Pretoken: "0xCace1b78160AE76398F486c8a18044da0d66d86D",
+    Depositor: "0xF8e31cb472bc70500f08Cd84917E5A1912Ec8397"
+    
+
+
+    // LiqETH contracts
+    // LiqEthAuthority: '0x3Eb66Bb91F7a022FbABc1619Cb6acce7025Bc41F',
+    // BeaconState: '0x08F879c6D0964E0A17bF688Af23168f654DF372e',
+    // WithdrawalQueue: '0x74aDeD940369baDDb0F36426F23B08499e45Fe18',
+    // LiqEthToken: '0x8C974517D038e2e3b8a1da7b1A026bC8132A4b2e',
+    // Accounting: '0x766CE996B8132b927988c5b2ECAE8108fB1a9307',
+    // DepositManager: '0xEd391dB5DB11B5eDBE08e69A51D16e84293C09a3',
+    // WithdrawalVault: '0xbaBc0D5997283ab9886696A0dEaB8A8093436b48',
+    // StakingModule: '0x4998fBb6Ca5Ee3Db6c339e2962A34791Af643fEa',
+    // // YieldOracle: '0x61Fe311C57dd9a38Fb7B0c5A8ec521452dB25378',
+
+    // // Outpost contracts
+    // OutpostManagerAuthority: '0x3B8705Ba1195AF632b3bd9E46F19348BC828FA3D',
+    // iodata: '0x4aCABbC74a1cA9B0058d9ADAa0E00Af0f4f73212',
+    // Base58: '0x1241F36ff30065deD52d51f0d6524EF971259A12',
+    // sysio_merkle: '0x58ca9b5515266Fd6bF94D5F1268C505b2eC9679c',
+    // ReceiptNFT: '0x03d6bD46cA9F54B8F8bbA21CfAfe717b36cB8593',
+    // EthUsdPriceConsumer: '0xdC2DD993A13b3DD6D255B52285625694bd967c9A',
+    // Pool: '0xd4742757AA61B1Fd3Fcd87980D7D460B12Cd9275',
+    // OutpostManager: '0x38ec2B56cBCeCaFFe28b535517de1a102C3D74E3',
+    // sysio_write: '0x0Ec4C1BaB772958aa3Db27459643bfbE7d92E305',
+    // Pretoken: '0x8c97a51A71640fa411DEfab8feC3401eFfd1a2E4',
+    // BAR: '0xbAFac13ffd3Aa9aEabaaeb6e4C2cF3dFf3479DC0',
+    // OPPCommon: '0x12283a6d4E6cE4A0e8AdB319Fc161c7F4f91EA8F',
+    // OPP: '0x87CE3Fe2CDca39C04aa2c14bbF1E1d9DB6358C4A',
+    // Depositor: '0x5351B30EA4b75bD9be9Fc0048e88F675f7b3Ac2b',
+    // OPPInbound: '0x0B1f7FB1c7f01A9cf490a1387E1E100F2bEA6C6d',
 
     // Test-only mock aggregator
     // MockAggregator: '0xFCfc3ddd4CBd9Ad3b3af3A374B8bdA1b66eE6FFF',
+
+    // TEMPORARY WIRE ETH DEVNET ADDRESSES - 4/21/26
+    // LiqETH contracts
+    // LiqEthAuthority: '0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512',
+    // BeaconState: '0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9',
+    // WithdrawalQueue: '0x5FC8d32690cc91D4c39d9d3abcBD16989F875707',
+    // LiqEthToken: '0xa513E6E4b8f2a923D98304ec87F64353C4D5C853',
+    // Accounting: '0x8A791620dd6260079BF849Dc5567aDC3F2FdC318',
+    // DepositManager: '0xB7f8BC63BbcaD18155201308C8f3540b07f84F5e',
+    // WithdrawalVault: '0x0DCd1Bf9A1b36cE34237eEaFef220932846BCD82',
+    // StakingModule: '0x0B306BF915C4d645ff596e518fAf3F9669b97016',
+    // // YieldOracle: '0x9A9f2CCfdE556A7E9Ff0848998Aa4a0CFD8863AE',
+
+    // // Outpost contracts
+    // OutpostManagerAuthority: '0x202CCe504e04bEd6fC0521238dDf04Bc9E8E15aB',
+    // iodata: '0x4aCABbC74a1cA9B0058d9ADAa0E00Af0f4f73212',
+    // Base58: '0x1241F36ff30065deD52d51f0d6524EF971259A12',
+    // sysio_merkle: '0x172076E0166D1F9Cc711C77Adf8488051744980C',
+    // ReceiptNFT: '0x2B0d36FACD61B71CC05ab8F3D2355ec3631C0dd5',
+    // EthUsdPriceConsumer: '0xe8D2A1E88c91DCd5433208d4152Cc4F399a7e91d',
+    // Pool: '0x1c85638e118b37167e9298c2268758e058DdfDA0',
+    // OutpostManager: '0xAA292E8611aDF267e563f334Ee42320aC96D0463',
+    // sysio_write: '0x0Ec4C1BaB772958aa3Db27459643bfbE7d92E305',
+    // Pretoken: '0x18E317A7D70d8fBfE6E893616b52390EbBdb629',
+    // BAR: '0x4631BCAbD6dF18D94796344963cB60d44a4136b6',
+    // OPPCommon: '0xf4B146FbA71F41E0592668ffbF264F1D186b2Ca8',
+    // OPP: '0xBEc49fA140aCaA83533fB00A2BB19bDdd0290f25',
+    // Depositor: '0xCace1b78160AE76398F486c8a18044da0d66d86D',
+    // OPPInbound: '0x720472c8ce72c2A2D711333e064ABD3E6BbEAdd3',
+
+
+    // MockDepositContract: '0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0',
+    // LiqEthBridge: '0x7A9Ec1d04904907De0ED7b6839CcdD59c3716AC9', internal
+    // WireYieldHubAttestations: '0x367761085BF3C12e5DA2Df99AC6E1a824612b8fb', internal
+
+    // Test-only mock aggregator
+    // MockAggregator: '0x46b142DD1E924FAb83eCc3c08e4D46E82f005e0E',
 };
 
-export const ADDRESS_BOOK_BY_CHAIN: Record<SupportedEvmChainID, AddressBook> = {
+export const ADDRESS_BOOK_BY_CHAIN: Record<SupportedEvmContractChainID, AddressBook> = {
     [EvmChainID.Ethereum]: MAINNET_ADDRESSES,
     [EvmChainID.Hoodi]: HOODI_ADDRESSES,
+    [EVM_WIRE_DEVNET_CHAIN_ID]: WIREDEV_ADDRESSES,
 };
 
 // Old name kept as a mainnet default (optional convenience)
@@ -366,9 +455,10 @@ function buildContracts(addresses: AddressBook, artifacts: ArtifactBundle): Cont
     };
 }
 
-export const CONTRACTS_BY_CHAIN: Record<SupportedEvmChainID, Contracts<ContractName>> = {
+export const CONTRACTS_BY_CHAIN: Record<SupportedEvmContractChainID, Contracts<ContractName>> = {
     [EvmChainID.Ethereum]: buildContracts(MAINNET_ADDRESSES, MAINNET_ARTIFACTS),
     [EvmChainID.Hoodi]: buildContracts(HOODI_ADDRESSES, HOODI_ARTIFACTS),
+    [EVM_WIRE_DEVNET_CHAIN_ID]: buildContracts(WIREDEV_ADDRESSES, WIREDEV_ARTIFACTS),
 };
 
 // -----------------------------------------------------------------------------
@@ -377,22 +467,23 @@ export const CONTRACTS_BY_CHAIN: Record<SupportedEvmChainID, Contracts<ContractN
 
 export interface ContractOptions {
     /** EVM chain id to select the correct address/contract set */
-    chainId: EvmChainID;
+    chainId: SupportedEvmContractChainID;
     /** RPC endpoint or injected EIP-1193 provider */
     provider?: ethers.providers.Provider;
     /** Only required if you need to send txns */
     signer?: Signer;
 }
 
-const ARTIFACTS_BY_CHAIN: Record<SupportedEvmChainID, ArtifactBundle> = {
+const ARTIFACTS_BY_CHAIN: Record<SupportedEvmContractChainID, ArtifactBundle> = {
     [EvmChainID.Ethereum]: MAINNET_ARTIFACTS,
     [EvmChainID.Hoodi]: HOODI_ARTIFACTS,
+    [EVM_WIRE_DEVNET_CHAIN_ID]: WIREDEV_ARTIFACTS,
 };
 
-export class EthereumContractService {
+export class EvmContractService {
     private provider?: providers.Provider;
     private signer?: Signer;
-    private readonly chainId: EvmChainID;
+    private readonly chainId: SupportedEvmContractChainID;
     private readonly contractsConfig: Contracts<ContractName>;
 
     public readonly contract: { [N in ContractName]: ethers.Contract } = {} as any;